gtpg2m0yGeneral Macros

CNOSC DISPLAY

Use the CNOSC general macro with the DISPLAY verb specified to return the session limit, contention-winner polarities, drain status, and responsible LU status for a particular (LU,modename) pair.

Format




label
A symbolic name can be assigned to the macro statement.

DISPLAY
Directs the CNOSC macro to perform the DISPLAY1 verb function.

LUNAME
Specifies the symbolic name of a field or a register pointing to a field. This is a 16-byte field that contains the network name of the partner (remote) LU to which the display applies. The first 8 bytes contain the left-justified network name, which is padded with blanks, or all blanks if the LU name is unqualified. The second 8 bytes contain the left-justified LU name, which is padded with blanks.

MODE
Specifies the symbolic name of a field or a register pointing to a field. This is an 8-byte field that contains the mode name for which the session information is to be returned.

LIMIT
Specifies the symbolic name of a field or a register pointing to a field. Upon return, this 2-byte field contains the session limit for the specified mode name. (The session limit is the maximum number of sessions to be allowed between the source (TPF) LU and the target (remote) LU.)

CONW
Specifies the symbolic name of a field or a register pointing to a field. Upon return, this 2-byte field contains the minimum number of sessions for which the local LU is designated to be the contention winner.

CONL
Specifies the symbolic name of a field or a register pointing to a field. Upon return, this 2-byte field contains the minimum number of sessions for which the local LU is designated to be the contention loser.

RESP
Specifies a symbolic name of a field or a register pointing to a field. Upon return, this 1-byte field contains a value indicating whether the local TPF LU or the remote LU is responsible for deactivating sessions for an outstanding CHANGE or RESET verb. The possible values are:

X'00'
No CHANGE or RESET verb pending.

X'01'
The remote LU is the responsible LU.

X'16'
The TPF LU is the responsible LU.

DRAIN
Specifies a symbolic name of a field or a register pointing to a field. Upon return, this 1-byte field contains a value indicating whether the local TPF LU, the remote LU, both LUs, or neither LU can drain its allocation requests while there is a CNOSC RESET pending. The possible values are:

X'00'
No RESET verb pending, or neither LU can drain.

X'01'
The remote LU can drain its allocation requests.

X'16'
The TPF LU can drain its allocation requests.

X'17'
Both LUs can drain their allocation requests.

RCODE
Specifies the symbolic name of a field or a register that points to a field. This is a 6-byte field in which the return code is placed. The return code consists of a 2-byte primary return code followed by a 4-byte secondary return code. The actual values returned are listed in Return Conditions.

Entry Requirements

See Entry Requirements for the entry requirements relating to the CNOSC macro in general.

Return Conditions

Programming Considerations

Examples

SYMB100   CNOSC DISPLAY,                           X
                LUNAME=(R1),                       X
                MODE=(R3),                         X
                RESP=EBW020,                       X
                DRAIN=EBW021,                      X
                LIMIT=EBW030,                      X
                CONW=(R2),                         X
                CONL=(R5),                         X
                RCODE=(R4)

Footnotes:

1
This macro provides a subset of the parameters defined by the LU 6.2 architecture's DISPLAY_MODE verb.