Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Library Services
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 A-109
_SEND^CI
context-boolean input
INT:value
indicates whether the send is context-free, meaning it does not depend on any
previous communication with this ciid. Specifically:
•
If context-boolean is 0 (FALSE), the send is context-free, which means it
may be sent to a new instance of the same CI if an error occurs.
•
If context-boolean is nonzero (TRUE) or omitted, the command is
assumed to be contextually dependent on earlier commands sent to this CI, and
the frame will not send the command to a new instance of the CI if an error
occurs.
tag input
INT(32):value
uniquely identifies this _SEND^CI operation. tag is used to distinguish among
sends if more than one operation is outstanding at the same time (whether to the
same or to separate CIs). Normally, a tag is the address of a list member in which
the user places identifying information about the operation.
timeout input
INT(32):value
is the time in .01-second units that this I/O operation is allowed to remain
outstanding without a response. If the CI does not respond within this time, the I/O
operation completes with file system error 40 (cannot be retried).
If timeout is omitted or less than or equal to 0D, an indefinite wait is indicated.
Considerations
•
If the communication is an SPI message containing a context token from a previous
communication, the message is contextually dependent on the previous message,
even though the CI is context-free. In this case, context-boolean must be true.
•
The frame dispatches the thread with an _EV^IODONE event when a _SEND^CI
operation completes. At that time:
_CI^LASTERROR ( ciid ) Is the INT file system error of the operation.
_CI^REPLYLENGTH ( ciid ) Is the INT length of the reply.
_CI^REPLYADDRESS ( ciid ) Is the INT(32) extended address of the reply.
_CI^REPLYTAG ( ciid ) Is the INT(32) tag of the operation.
_CI^FILENUM ( ciid ) Is the INT Guardian file number of the CI.