 |
» |
|
|
|
Reports the status and state of an LU session of a given LU
name. Syntax | |
BA BA IA IA
NRJELUStatus ( Wsid, LUName, InfoArray, Result ) |
Parameters | |
- Wsid
An eight-character input byte array.
The Wsid parameter identifies your workstation. It must contain a
left-justified alphanumeric name beginning with a letter. If the
workstation identifier is less than eight characters long, it must
be followed by blanks. - LUName
An input byte array. In MPE
V, this refers to an LU class name configured in the MPE V Configuration: Classes
screen. For MPE XL, this is the host name (not the NAU) of an LU.
An LUName begins with a letter and may be up to eight alphanumeric
characters long. If an LUName is less than eight characters, it must be filled with
trailing blanks. - InfoArray
An output integer array.
For each LU session, the InfoArray contains status and state information such as termination
reason, session status, session state, and LU state. The structure
of this array is given in the description below. - Result
An eight-element integer output array
(required). The Result array contains error codes that occurred during execution
of this intrinsic. The first element of the Result array is set to zero if no errors took place. The structure
of the Result array is described in "Parameters Common to
NRJE Intrinsics" in the introduction to Chapter 5 “User Intrinsics” Always test the first element of Result immediately after you call this intrinsic. If the first
element of Result is not zero, test the other elements of Result to determine the nature of the problem that has occurred.
Description | |
The NRJELUStatus intrinsic reports the status and states of an
LU session of a given LUName in InfoArray (a description of InfoArray is given below). Transmission chain size is also reported.
Obtain the LUName of a Wsid by calling NRJELUList. When NRJELUStatus returns control to your routine, test the first
element of Result. Table 6-3 InfoArray Structure Word | Contents and Meaning |
|---|
0-3 | LU name | | 4 | LU Entry State. Values are
as follows: | | | 4
= protocol shut down pending
| %10
= monitor request pending
| %20
= LU activation pending
| | 5 | Chain size, in number of RUs. | 6 | LU number. | 7 | Reserved. | | 8 | Data Flow Control state. | Upper byte values are as
follows: | | %000400,
(1) = <F255P255>SHUTD received
| %001000,
(2) = <F255P255>SHUTC received
| %001400,
(3) = <F255P255>Quiescing
| %002000,
(4) = <F255P255>Quiescent
| Data Flow Control Line State.
Lower byte values are as follows: | | | | 9 | Reserved. | | 10 | Session Control Status.
Values are as follows: | | 1
= waiting for Start Data Traffic
| | | | | 11 | Monitor Request Status.
Values are as follows: | | | | 12 | Reserved. | 13 | Network Service Status.
Values are as follows: | | | | | | 14 | Secondary LU status. Values
are as follows: | | | | | | 15 | LU process identification number (pin) | 16-49 | Reserved. |
Text Reference | |
The STATUS command also reports the status and state of an LU session.
See the SNA NRJE Node Manager's Guide for
more information on this command. |
