Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Library Services
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 A-25
_CI^ID
_CI^ID
_CI^ID declares a structure (referred to as a “CIID” structure) in which _OPEN^CI
stores information about an open CI.
ciid user-provided identifier
is the name (a valid TAL identifier) given to the CIID structure with which an open
CI can be accessed.
The CIID structure plays a role in command-thread CI communication analogous to a
file number in Tandem NonStop Kernel interprocess communications. A particular
instance of an open CI is identified by its ciid in CI communications.
The following defines extract information from the CIID structure about the
communication just completed:
Example
The following example opens a CI:
_CI^ID (pm);
INT .EXT ci^config (_CI^DEF);
IF (error := _OPEN^CI (ci^config, pm)) THEN ...;
_CI^ID ( ciid );
_CI^LASTERROR ( ciid ) INT file-system error of last operation
_CI^REPLYLENGTH ( ciid ) INT length of reply
_CI^REPLYADDRESS ( ciid ) INT(32) extended address of reply
_CI^REPLYTAG ( ciid ) INT(32) tag of last operation
_CI^FILENUM ( ciid ) INT Guardian file number of CI