gtpg2m10General Macros

CNOSC RESET

Use the CNOSC general macro with the RESET verb specified to reset the LU 6.2 session limit for parallel or single session connections to 0.

Format




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

RESET
Directs the CNOSC macro to perform the RESET 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 session limit and contention-winner polarity reset 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 limit and polarities are to be reset.

You can specify a user-defined mode name or one of the following values:

ALL
Specifies that the session limit for all mode names that apply to the target LU are reset to 0, except the SNA-defined mode SNASVCMG, which remains unchanged. This is the default value.

singmode
Specifies the mode name for single sessions as defined by the SINGMODE parameter of the SNAKEY macro. See TPF ACF/SNA Network Generation for more information about the SNAKEY macro.

SNASVCMG
Specifies the SNA-defined mode name used to exchange CNOS verbs between the source and target LUs connected by parallel sessions.

RESP
Specifies which LU is responsible for deactivating the session as a result of resetting the session limit for parallel sessions. This parameter is not applicable to single session connections or the SNASVCMG session. The allowed values are:

SOURCE
Specifies that the source LU is responsible for deactivating sessions as a result of resetting the session limit. The target LU cannot negotiate this argument. This is the default value.

TARGET
Specifies that the target LU is responsible for deactivating sessions as a result of resetting the session limit. The target LU can negotiate this argument to make the source LU responsible.

DRAIN
Specifies which LU (or both) can drain its allocation requests. If you do not code this parameter, no draining is allowed for either LU, and all outstanding and subsequent allocation requests will be rejected. This parameter is not valid for SNASVCMG connections. The allowed values are:

SOURCE
Specifies that the source LU can drain its allocation requests. The target LU cannot negotiate this argument. The source LU continues to allocate conversations to the sessions until no requests are waiting for allocation, at which time its draining ends. Allocation requests subsequent to the completion of draining are rejected.

TARGET
Specifies that the target LU can drain its allocation requests. The target LU can reject this argument; in this case no draining takes place.

The target LU continues to allocate conversations to the sessions until no requests are waiting for allocation, at which time its draining ends. Allocation requests subsequent to the completion of draining are rejected. This value is not valid for single session connections.

BOTH
Specifies that both the source and target LUs can drain their allocation requests. This value is not valid for single session connections.

FORCE
Specifies whether the source LU should force the resetting of its session limit upon the unsuccessful completion of the CNOS request or reply exchange. This parameter does not apply to SNASVCMG or single session connections. The allowed values are:

Y
Specifies that a reset should be forced. In this case, RESP defaults to SOURCE and no draining by either source or target LU takes place.

N
Specifies that a reset should not be forced. The session limit is reset only upon successful completion of the CNOS request or reply exchange. This value is the default.

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 RESET,                             X
                LUNAME=(R1),                       X
                MODE=ALL,                          X
                RESP=SOURCE,                       X
                DRAIN=BOTH,                        X
                FORCE=Y,                           X
                RCODE=(R4)