gtpo1mauOperations

ZNCNS RESET-Reset Session Limit

Use this command to reset the TPF Advanced Program-to-Program Communications (TPF/APPC) session limit for single or parallel session connections to 0.

Note:
Throughout the description of this command, the phrase source LU refers to the TPF LU and target LU refers to the remote LU, unless otherwise noted.

Requirements and Restrictions

The TPF system must be in CRAS state or higher.

Format




LUname-netid.luname
is the 1- to 17-character name of the remote partner LU.  The network ID and name of a resource must both begin with a letter (A-Z), @, #, or $. The remaining characters can be letters (A-Z), numbers (0-9), @, #, or $. 
Note:
 To specify an SNA network ID or resource name that contains dollar signs ($), you must type two consecutive dollar signs ($$) for each dollar sign in the network ID or resource name. For example, if the SNA resource name is $SNANAME, you must type $$SNANAME

Mode
specifies the mode name for which the session limit and polarities are to be reset, which can be one of the following:

ALL
resets to 0 the session limit for all mode names that apply to the target LU, except for the SNA-defined mode, SNASVCMG, which remains unchanged.

modename
resets the specified 1- to 8-character user-defined mode name to 0.  Mode names must begin with a letter (A-Z), @, #, or $. The remaining characters can be letters (A-Z), numbers (0-9), @, #, or $. 
Note:
 To specify a mode name that contains dollar signs ($), you must type two consecutive dollar signs ($$) for each dollar sign in the name. For example, if the mode name is $MODNAME, you must type $$MODNAME

singmode
resets to 0 the specified single session mode name, which is defined by the SINGMODE parameter of the SNAKEY macro. Enter ZNKEY SINGMODE to display the mode name.

SNASVCMG
resets to 0 the SNA-defined mode name, which is used to exchange CNOS requests between the source and target LUs connected by parallel sessions.

Resp
specifies the LU that is responsible for deactivating sessions when the session limit for parallel session connections is reset.
Note:
This parameter is not valid for single session connections or the SNASVCMG session.

SOURCE
specifies that the source LU is responsible for deactivating sessions. The target LU cannot negotiate this argument.

TARGET
specifies that the target LU is responsible for deactivating sessions. The target LU can negotiate this argument to make the source LU responsible.

Drain
specifies whether the source or target LU can drain its allocation requests. If you do not specify the DRAIN parameter, draining is not performed and all outstanding and subsequent allocation requests are rejected.
Note:
This parameter is not valid for SNASVCMG connections.

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 awaiting allocation, at which time its draining has ended. Allocation requests subsequent to the completion of the CNOS exchange are rejected. Allocation requests that were queued before the CNOS RESET request are allowed to drain.

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 awaiting allocation, at which time its draining ends. Allocation requests subsequent to the completion of the CNOS exchange are rejected. Allocation requests that were queued before to the CNOS RESET request are allowed to drain.
Note:
This value is not valid for the single session connections.

BOTH
specifies that both the source LU and the target LU can drain their allocation requests.
Note:
This value is not valid for the single session connections.

Force
resets the session limit of the source LU by force if the CNOS exchange is not completed successfully. If you performed a forced reset, the RESP parameter defaults to SOURCE and no draining by either the source or target LU takes place. If you do not specify the FORCE parameter, the session limit is reset when the CNOS exchange is completed successfully.
Note:
This parameter is not valid for SNASVCMG or single session connections.

Additional Information

Examples

The session limits are reset by both a TPF user and a remote user in the following examples.

The session limit is reset from the TPF system in the following example. Both LUs are allowed to drain their queued allocation requests. The target (remote) LU is responsible for deactivating the sessions.

+--------------------------------------------------------------------------------+
|User:   ZNCNS RE LU-APPC MODE-ICEPICK DRAIN-BOTH RESP-TARGET                    |
|                                                                                |
|System: NCNS0003I 13.43.07 REQUEST ACCEPTED FOR LU-APPC MODE-ICEPICK            |
|        NCNS0001I 13.43.07 REQUEST COMPLETED FOR LU-APPC MODE-ICEPICK           |
+--------------------------------------------------------------------------------+

In the following example, the session limit is reset from the remote system. In this example, the command is entered from the remote system and an informational message is displayed on the TPF system. Both LUs are allowed to drain their queued allocation requests. The target (TPF) LU is responsible for deactivating the sessions.

+--------------------------------------------------------------------------------+
|User:   ZNCNS RE LU-APPA MODE-ICEPICK DRAIN-BOTH RESP-TARGET                    |
|                                                                                |
|System: CHNX0001I 13.43.09 CNOS RESET RECEIVED, MODENAME - ICEPICK              |
|         REMOTE LU - APPC, LOCAL LU - APPA                                      |
+--------------------------------------------------------------------------------+

Related Information

See TPF ACF/SNA Data Communications Reference for more information about SNA communications.