The TimedShelve Method extends the TimedShelve Method, by adding an optional Comment. For other functionality see the TimedShelve Method definition.
Signature
TimedShelve2(
[in] Duration ShelvingTime
[in] LocalizedTextComment
);
The parameters are defined in Table 8484.
Table 8484 – TimedShelve2 parameters
|
Argument |
Description |
|
ShelvingTime |
Specifies a fixed time for which to shelve the Alarm. The Server may refuse the provided duration. If a MaxTimeShelved Property exist on the Alarm than the Shelving time shall be less than or equal to the value of this Property. |
|
Comment |
A localized text that shall be applied to the Condition. |
Method Result Codes in Table 8585 (defined in Call Service)
Table 8585 – TimedShelve2 result codes
|
Result Code |
Description |
|
Bad_ConditionAlreadyShelved |
See Table 137137 for the description of this result code. The Alarm is already in TimedShelved state and the system does not allow a reset of the shelved timer. |
|
Bad_ShelvingTimeOutOfRange |
See Table 137137 for the 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
Shelving for some time is quite often used to block nuisance Alarms. For example, an Alarm that occurs more than 10 times in a minute can get shelved for a few minutes.
In some systems the length of time covered by this duration can be limited and the Server can generate an error refusing the provided duration. This limit can be exposed as the MaxTimeShelved Property.
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.
Table 8686 specifies the AddressSpace representation for the TimedShelve2 Method.
Table 8686 – TimedShelve2 Method AddressSpace definition
|
Attribute |
Value |
||||
|
BrowseName |
TimedShelve2 |
||||
|
References |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
ModellingRule |
|
HasProperty |
Variable |
InputArguments |
Argument[] |
PropertyType |
Mandatory |
|
AlwaysGeneratesEvent |
ObjectType |
AuditConditionShelvingEventType |
Defined in 5.10.7 |
||
|
ConformanceUnits |
|||||
|
A & C Shelving2 |
|||||
If Auditing is supported, this Method shall generate an Event of AuditConditionShelvingEventType for all invocations of the Method.