5.8.15 PlaceInService2 Method
The PlaceInService2 Method extends the PlaceInService Method, by adding an optional Comment. For other functionality see the PlaceInService Method definition.
Signature
PlaceInService2(
[in] LocalizedText Comment
);The parameters are defined in Table 68.| Argument | Description |
| Comment | A localized text that shall be applied to the Condition. |
If the Comment argument is NULL (both locale and text are empty) it shall be ignored and any existing comments will remain unchanged. To reset the comment an empty text with a locale shall be provided.
Method result codes in Table 69 (defined in Call Service)
| Result Code | Description |
| Bad_MethodInvalid | The MethodId provided does not correspond to the ObjectId provided. See 10000-4 for the general description of this result code. |
| Bad_NodeIdInvalid | Used to indicate that the specified ObjectId is not valid or that the Method was called on the AlarmConditionType Node. See 10000-4 for the general description of this result code. |
| Bad_InvalidArgument | The Comment string provided exceeds the allowed length for the comment or is invalid in some other manner. |
Comments
The PlaceInService2 Method applies to an Alarm instance, even if it is not currently in the Active State.
Table 70 specifies the AddressSpace representation for the PlaceInService2 Method.
| Attribute | Value | ||||
| BrowseName | PlaceInService2 | ||||
| References | NodeClass | BrowseName | DataType | TypeDefinition | ModellingRule |
|---|---|---|---|---|---|
| HasProperty | Variable | InputArguments | Argument[] | PropertyType | Mandatory |
| AlwaysGeneratesEvent | ObjectType | AuditConditionOutOfServiceEventType | Defined in 5.10.12 | ||
| ConformanceUnits | |||||
|---|---|---|---|---|---|
| A & C OutOfService2 |
If Auditing is supported, this Method shall generate an Event of AuditConditionOutOfServiceEventType for all invocations of the Method.