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
- Online help information is available for this command. To display
the help information, enter one of the following:
ZNCNS HELP
ZNCNS ?
- This function in no way forces the deallocation of active
conversations.
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.