Using NS3000/iX Network Services (36920-90008)

128 Chapter 6
Intrinsics for Node and Environment Status
NSSTATUS Intrinsic
NSSTATUS (Name, NameLength, , , Status, ItemNum,
InitiatorInfo);
If the intrinsic returns without an error then the following
information will be in the InitiatorInfo record.
InitiatorInfo.JobType --- 1 { indicates Session}
InitiatorInfo.JobNum --- 1 { session num }
InitiatorInfo.Ldev --- 20 { logical device numb of #S1 }
InitiatorInfo.LocRem --- 1 { local session. not a VT session}
InitiatorInfo.Logon --- 'MANAGER.SYS'
InitiatorInfo.NodeLen --- 8
InitiatorInfo.NodeName--- 'A.IND.HP'
6. Consider the above example. The same information can be obtained
by running the following NSSTATUS intrinsic on Node C, which is on
the same network.
Name := ‘#S5’ {or logon string of #S5}
NameLength:=3;
ItemNum:=21;
NodeName :=‘B’,
NodeLength :=1;
NSSTATUS (Name, NameLength, NodeName,NodeLength,
Status, ItemNum, InitiatorInfo);
In this case, the intrinsic on Node C first goes to Node B and gets
#S5’s information. From this information, it gets the initiator’s SID
and node name and then goes to that node--in this case Node ‘A’. It
then gets the initiator’s session information based on the SID — in
this case #S1. Note: all the three systems involved in this scenario
must have this fix.
See Table 6-2 for NSINFO Errors.
Table 6-2 NSINFO Errors
Error
Number
Meaning
0
Successful completion of NSSTATUS intrinsic.
1
Required parameter missing.
2
Invalid item number. Item number must be an integer in
the range 1 to 18.
3
Item number specified without corresponding item
array.
4
Item array specified without corresponding item.
5
Name length too large.
6
Name length too small.