The PlaceInService2 Method extends the PlaceInService Method, by adding an optional Comment. For other functionality see the PlaceInService Method definition.
Signature
PlaceInService2(
[in] LocalizedTextComment
);
The parameters are defined in Table 6868.
Table 6868 – PlaceInService2 Method parameters
|
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 6969 (defined in Call Service)
Table 6969 – PlaceInService2 result codes
|
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 7070 specifies the AddressSpace representation for the PlaceInService2 Method.
Table 7070 – PlaceInService2 Method AddressSpace definition
|
Attribute |
Value |
||||
|
BrowseName |
PlaceInService2 |
||||
|
References |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
ModellingRule |
|
HasProperty |
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.