Using NS3000/iX Network Services (36920-90008)

108 Chapter 6
Intrinsics for Node and Environment Status
NSINFO Intrinsic
NSINFO Intrinsic
This intrinsic is used to programmatically obtain information about NS
environments that have been created in your session. These are
environments created by either a DSLINE envID, or a REMOTE
HELLO...;DSLINE=envID command. This intrinsic also allows you to
obtain some information about your local node (such as the local node
name).
Syntax
BA I
NSINFO ( [envID], [envIDlength],
II
[envnum], status
(IV) (BA)
[,itemnum1, item1]
[,itemnum2, item2]
[,itemnum3, item3]
[,itemnum4, item4]
[,itemnum5, item5])
where: BA = Byte array
I = Integer
IV = Integer value
Parameters
envID
(input/output) 52-byte character array. Specifies environment with
matching environment identifier. See the discussion for
an explanation of the use of envID, envIDlength, and
envnum.
envIDlength
(input/output) 16-bit integer, by reference. Length of environment
ID in bytes. See the discussion for an explanation of the
use of envID, envIDlength, and envnum.