5 Service Sets ToC Previous Next

5.10 Attribute Service Set ToC Previous Next

5.10.5 HistoryUpdate ToC Previous Next

5.10.5.1 Description ToC

This Service is used to update historical values or Events of one or more Nodes. Several request parameters indicate how the Server is to update the historical value or Event. Valid actions are Insert, Replace or Delete.

5.10.5.2 Parameters ToC

Table 62 defines the parameters for the Service.

Table 62 – HistoryUpdate Service Parameters

Name Type Description
Request    
   requestHeader RequestHeader Common request parameters (see 7.28 for RequestHeader definition).
   historyUpdateDetails [] Extensible Parameter
HistoryUpdate
Details
The details defined for this update. The HistoryUpdateDetails parameter type is an extensible parameter type formally defined in OPC 10000-11. It specifies the types of history updates that can be performed. The ExtensibleParameter type is defined in 7.12.
Response    
   responseHeader ResponseHeader Common response parameters (see 7.29 for ResponseHeader definition).
   results [] HistoryUpdate Result List of update results for the history update details. The size and order of the list matches the size and order of the details element of the historyUpdateDetails parameter specified in the request. This structure is defined in-line with the following indented items.
      statusCode StatusCode StatusCode   for the update of the Node (see 7.34 for StatusCode definition).
      operationResults [] StatusCode List of StatusCodes for the operations to be performed on a Node. The size and order of the list matches the size and order of any list defined by the details element being reported by this result entry.
      diagnosticInfos [] DiagnosticInfo List of diagnostic information for the operations to be performed on a Node (see 7.8 for DiagnosticInfo definition). The size and order of the list matches the size and order of any list defined by the details element being reported by this results entry. This list is empty if diagnostics information was not requested in the request header or if no diagnostic information was encountered in processing of the request.
   diagnosticInfos [] DiagnosticInfo List of diagnostic information for the history update details. The size and order of the list matches the size and order of the details element of the historyUpdateDetails parameter specified in the request. This list is empty if diagnostics information was not requested in the request header or if no diagnostic information was encountered in processing of the request.

5.10.5.3 Service results ToC

Table 63 defines the Service results specific to this Service. Common StatusCodes are defined in Table 177.

Table 63 – HistoryUpdate Service Result Codes

Symbolic Id Description
Bad_NothingToDo See Table 177 for the description of this result code.
Bad_TooManyOperations See Table 177 for the description of this result code.

5.10.5.4 StatusCodes ToC

Table 64 defines values for the statusCode and operationResults parameters that are specific to this Service. Common StatusCodes are defined in Table 178. History access specific StatusCodes are defined in OPC 10000-11.

Table 64 – HistoryUpdate Operation Level Result Codes

Symbolic Id Description
Bad_NotWritable See Table 178 for the description of this result code.
Bad_HistoryOperationInvalid See Table 178 for the description of this result code.
Bad_HistoryOperationUnsupported See Table 178 for the description of this result code.
Bad_UserAccessDenied See Table 177 for the description of this result code.
The current user does not have permission to update the history.

Previous Next