HP 3000 Manuals HP 3000 Manuals
NRJELUStatus
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.
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.
InfoArray Structure.
------------------------------------------------------------------------------------------
| |
| Word Contents and Meaning |
| |
| 0-3 LU name |
| |
| 4 LU Entry State. |
| Values are as follows: |
| |
| |
| * 1 = active |
| |
| * 2 = stop pending |
| |
| * 4 = protocol shut down pending |
| |
| * %10 = monitor request pending |
| |
| * %20 = LU activation pending |
| |
| * %40 = inactive |
| |
| 5 Chain size, in number of RUs. |
| |
| 6 LU number. |
| |
| 7 Reserved. |
| |
------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------
| |
| Word Contents and Meaning |
| |
| 8 Data Flow Control state. |
| |
| Upper byte values are as follows: |
| |
| |
| * %000000, (0) = Normal |
| |
| * %000400, (1) = SHUTD received |
| |
| * %001000, (2) = SHUTC received |
| |
| * %001400, (3) = Quiescing |
| |
| * %002000, (4) = Quiescent |
| |
| Data Flow Control Line State. |
| |
| Lower byte values are as follows: |
| |
| |
| * 0 = Inbound flow |
| |
| * 1 = Outbound flow |
| |
| * 2 = Contention mode |
| |
| 9 Reserved. |
| |
| 10 Session Control Status. |
| Values are as follows: |
| |
| |
| * 0 = reset |
| |
| * 1 = waiting for Start Data Traffic |
| |
| * 2 = normal flow |
| |
| * 3 = UNBIND received |
| |
| * 4 = terminate state |
| |
------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------
| |
| Word Contents and Meaning |
| |
| 11 Monitor Request Status. Values are as follows: |
| |
| |
| * 0 = reset |
| |
| * 1 = init-self requested |
| |
| * 2 = term-self requested |
| |
| 12 Reserved. |
| |
| 13 Network Service Status. |
| Values are as follows: |
| |
| |
| * 0 = reset |
| |
| * 1 = init-self sent |
| |
| * 2 = active |
| |
| * 3 = quiesce pending |
| |
| * 4 = term-self sent |
| |
| 14 Secondary LU status. |
| Values are as follows: |
| |
| |
| * 0 = reset |
| |
| * 1 = initiation state |
| |
| * 2 = normal flow |
| |
| * 3 = quiesce shut down |
| |
| * 4 = terminate state |
| |
| 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.