Using NS3000/iX Network Services (36920-90008)

116 Chapter 6
Intrinsics for Node and Environment Status
NSSTATUS Intrinsic
NSSTATUS Intrinsic
The NSSTATUS intrinsic returns information about services, servers,
and NS users on local or remote nodes. This information is equivalent
to the data displayed by NSCONTROL STATUS.
Syntax
BA IV BA IV I
NSSTATUS ([name], [namelength], {nodename], {nodelenth], status
(IV) (BA)
[,itemnum1, item1]
[,itemnum2, item2]
[,itemnum3, item3]
[,itemnum4, item4]
[,itemnum5, item5]);
where: BA = Byte array
I = Integer
IV = Integer value
Parameters
name (Input) 26-byte character array, by reference. Service
name, server name, or user name, depending on which
items are specified. May be omitted for certain items.
namelength
(Input) 16-bit integer, by value. Length of name in bytes. May
be omitted for certain items.
nodename
(Input) 52-byte character array, by reference. Name of a
remote node from which information will be obtained. If
omitted, NSSTATUS information will be obtained from
the local node.
nodelength
(Input) 16-bit integer, by value. Length of nodename in bytes.
If omitted, NSSTATUS information will be obtained from
the local node.
status (Output) Required 16-bit integer, by reference. 0 is returned
if call is successful; otherwise an error number is
returned.