gtpo1masOperations

ZNCNS CHANGE-Change Session Limit

Use this command to change the TPF Advanced Program-to-Program Communications (TPF/APPC) session limit from one nonzero value to another. You can also change the contention-winner polarities for parallel session connections.

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

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-modename
is the 1- to 8-character mode name for which the session limit and polarities are to be changed.  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

LImit-totsess
specifies the maximum number of sessions that are allowed between the source LU and the target LU for the specified mode name, where totsess is a decimal number greater than 0 and greater than or equal to the sum of the numbers specified for the CONW and CONL parameters.

CONW-winners
specifies the minimum number of sessions for which the source LU is designated to be the contention winner, where winners is a decimal number greater than or equal to 0.
Note:
The sum of this parameter and the CONL parameter cannot exceed the value specified for the LIMIT parameter.

CONL-losers
specifies the minimum number of sessions for which the source LU is designated to be the contention loser, where losers is a decimal number greater than or equal to 0.
Note:
The sum of this parameter and the CONW parameter cannot exceed the value specified for the LIMIT parameter.

Resp
specifies the LU that is responsible for selecting and deactivating sessions when the session limit decreases or the maximum number of contention winners for the source or target LUs cannot be reached, where:

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

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

Additional Information

Examples

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

In the following example, a request is made from the TPF system to change the session limit and the contention-winner polarities.

The new session limit is 4. The minimum number of contention-winner sessions for the TPF system is 4. The minimum number of contention-loser sessions for the TPF system is 0. The target (remote) LU is responsible for selecting and deactivating sessions if necessary.

+--------------------------------------------------------------------------------+
|User:   ZNCNS CH LU-APPC MODE-HATESNOW LIMIT-4 CONW-4 CONL-0 RESP-TARGET        |
|                                                                                |
|System: NCNS0003I 12.48.47 REQUEST ACCEPTED FOR LU-APPC MODE-HATESNOW           |
|        NCNS0001I 12.48.47 REQUEST COMPLETED FOR LU-APPC MODE-HATESNOW          |
+--------------------------------------------------------------------------------+

In the following example, a request is made from the remote system to change the session limit and the contention-winner polarities. The command is entered from the remote system and an informational message is displayed on the TPF system.

The new session limit is 4. The minimum number of contention-winner sessions for the remote side is 4. (The number of contention-loser sessions for the TPF system is 4.) The minimum number of contention-loser sessions for the remote side is 0. (The number of contention-winner sessions for the TPF system is 0.) The target (TPF) LU is responsible for selecting and deactivating sessions if necessary.

Note:
Message CHNX0001I displays only on the RO; it does not display on the prime CRAS.
+--------------------------------------------------------------------------------+
|User:   ZNCNS CH LU-APPA MODE-HATESNOW LIMIT-4 CONW-4 CONL-0 RESP-TARGET        |
|                                                                                |
|System: CHNX0001I 14.02.16 CNOS CHANGE RECEIVED, MODENAME - HATESNOW,           |
|         REMOTE LU - APPC, LOCAL LU - APPA,                                     |
|         SESSION LIMIT - 4, MIN CONWINNER - 0, MIN CONLOSER - 4                 |
+--------------------------------------------------------------------------------+

In the following example, a request is made from the TPF system to change the session limit and the contention-winner polarities.

The new session limit is 300. The minimum number of contention-winner sessions for the TPF system is 100. The minimum number of contention-loser sessions for the TPF system is 50. The source (TPF) LU is responsible for selecting and deactivating sessions if necessary.

+--------------------------------------------------------------------------------+
|User:   ZNCNS C LU-APPC  MODE-SAM  LIMIT-300  CONW-100  CONL-50                 |
|                                                                                |
|System: NCNS0003I 12.53.18 REQUEST ACCEPTED FOR LU-APPC MODE-SAM                |
|        NCNS0001I 12.53.18 REQUEST COMPLETED FOR LU-APPC MODE-SAM               |
+--------------------------------------------------------------------------------+

In the following example, a request is made from the remote system to change the session limit and the contention-winner polarities. In this example, the command is entered from the remote system and an informational message is displayed on the TPF system.

The new session limit is 300. The minimum number of contention-winner sessions for the remote side is 100. (The number of contention-loser sessions for the TPF system is 100.) The minimum number of contention-loser sessions is 50. (The number of contention-winner sessions for the TPF system is 50.) The source (remote) LU is responsible for selecting and deactivating sessions if necessary.

+--------------------------------------------------------------------------------+
|User:   ZNCNS C LU-TPFNET.APPA  MODE-SAM  LIMIT-300  CONW-100  CONL-50          |
|                                                                                |
|System: CHNX0001I 12.53.20 CNOS CHANGE RECEIVED, MODENAME - SAM,                |
|         REMOTE LU - APPC, LOCAL - APPA,                                        |
|         SESSION LIMIT - 300, MIN CONWINNER - 50, MIN CONLOSER - 100            |
+--------------------------------------------------------------------------------+

Related Information

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