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
- The results of the verb are indicated by the value returned in
RCODE. The valid return codes are listed in the following
section.
- See Return Conditions for the return conditions relating to the CNOSC macro in
general.
- The following table contains a list of the primary and secondary return
codes that can be returned to the program that issued the DISPLAY verb.
A complete list of return codes and their definitions can be found in Table 3 and in Table 4.
Symbolic Name
| Primary Code
| Secondary Code
|
CNOSRC_OK
| 0000
|
|
CNOSRC_PARAMETER_ERROR
| 0004
|
|
CNOSRC_INVALID_LU
| ....
| 00000014
|
CNOSRC_INVALID_MODE
| ....
| 00000018
|
CNOSRC_INVALID_REQ
| 0020
|
|
CNOSRC_INVALID_STATE
| ....
| 00000030
|
Programming Considerations
- If you specify a register for a keyword value, the register must be
enclosed in parentheses and in the range R1-R7.
- See Programming Considerations for programming considerations relating to the CNOSC macro
in general.
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.