Distributed Systems Network Management (DSNM) Subsystem Interface Development Guide

DSNM Library Services
Distributed Systems Network Management (DSNM) Subsystem Interface Development
Guide—109759 A-81
_OPEN^CI
_OPEN^CI
_OPEN^CI opens a CI for communication.
error returned value
INT
If > 0, is the file system error returned from the FILE_OPEN_ procedure. File
system errors are described in the Guardian Procedure Errors and Messages
Manual.
If < 0, is a ZDSN error. See Appendix B, “DSNM Error Codes,” for ZDSN error
code definitions.
ci-config input
is the extended pointer (declared in globals). It points to the _CI^DEF-defined CI
configuration structure, containing CI configuration parameters.
ciid input
is the CIID structure (declared with _CI^ID), identifying an open CI.
processname input
STRING .EXT
is the name of an existing CI process. The process name is in external format and
must be terminated with a null or a blank.
nowait-depth input
INT:value
is the maximum number of concurrent _SEND^CI operations that can be executed
against this CI by this thread. The default is 1, if nowait-depth is omitted or
specified as a value < 1.
Considerations
•
Your _STARTUP procedure must call _ADD^CI to fill the _CI^DEF-defined CI
configuration structure for each CI class opened by the command thread.
•
ci-config and ciid play a role in command-thread CI communication that is
analogous to file name and file number in Tandem NonStop Kernel interprocess
communications. A CI is identified by its ci-config; a ciid refers to a
particular instance of an open CI.
error := _OPEN^CI ( ci-config
,ciid
,[ processname ]
,[ nowait-depth ])