opget/7—retrieve a policy operation of an event
The opget/7 function retrieves a policy operation of an event. The syntax for this function is as follows:
opget/7 arguments
Argument | Mode | Type | Description |
---|---|---|---|
$EVENT | Input | OBJECT | Specifies the event for which to retrieve an operation |
$SEQNR | Input | INTEGER | Specifies the sequence number of the desired operation |
$TIME | Output | INTEGER | Time stamp of the operation |
$AUTHOR | Output | STRING | Author of the operation |
$POLICY | Output | STRING | Policy name of the operation |
$ACTION | Output | STRING | Action name of the operation |
$ARGS | Output | STRING | Arguments for the operation action |
Use the opget/7 to obtain operation $SEQNR that is attached to event $EVENT. The time stamp is returned in $TIME, the author is returned in $AUTHOR, the policy name is returned in $POLICY, the action name is returned in $ACTION, and the argument list is returned in $ARGS.
Operations are numbered, starting from 1 for the oldest operation. The most recent operation can be obtained by indicating 0 as the sequence number $SEQNR.
To determine the number of operations attached to an event, see opcnt-2-count-the-operations-of-an-event.
opget/7 example