Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Library Services
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 A-27
_CI^LASTERROR
_CI^LASTERROR
_CI^LASTERROR is the type INT file-system error of the last CI operation.
fserror output
INT
is the file-system error of the last CI operation.
ciid input
is the CIID structure (declared with _CI^ID) identifying an open CI.
Considerations
If _CI^LASTERROR is not 0, the following actions occurred:
•
Retriable errors were retried unsuccessfully.
•
If the context flag of _SEND^CI was false (the send was context-free), an attempt
was made to reestablish communication with the CI process and to send the request
again.
If communication is reestablished, the file number returned by _CI^FILENUM can
be different from earlier CI communications.
If any of these actions results in a successful communication, _CI^LASTERROR
is 0; otherwise, it is the last error that occurred. File system errors are documented
in the Guardian Procedure Errors and Messages Manual.
Example
_CI^IDPOINTER (pm); !pointer to a CIID structure
IF _ON (_LAST^EVENTS, _EV^IODONE)
THEN
BEGIN
@pm := _LAST^CI^ID; !pm gets address of CIID struct
IF _CI^LASTERROR (pm) !check for errors
THEN ... ;
END;
fserror := _CI^LASTERROR ( ciid )