gtpo1matOperations

ZNCNS INITIALIZE-Initialize Session Limit

Use this command to initialize the TPF Advanced Program-to-Program Communications (TPF/APPC) session limit and contention-winner polarities for single or 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

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 initialized, which can be one of the following:

modename
is a 1- to 8-character user-defined parallel session mode name.  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
is the mode name for single sessions as defined by the SINGMODE parameter of the SNAKEY macro. Enter ZNKEY SINGMODE to display the mode name.

SNASVCMG
specifies the SNA-defined mode name used to exchange CNOS requests between the source and target LUs that are connected by parallel sessions.

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.

Notes:

  1. When you specify MODE-singmode, do not specify the LIMIT parameter; the value is set to 1.

  2. When you specify MODE-SNASVCMG, do not specify the LIMIT parameter; the value is set to 2.

LOcal-luname
specifies the 1- to 8-character local TPF/APPC 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 $. 

Notes:

  1. If you are using SLU threads, you must specify the LOCAL parameter for each initialization, specifying different thread names each time.

  2. If you are not using secondary LU (SLU) threads, use the LOCAL parameter only when the first mode is initialized for a particular remote LU. If you omit the LOCAL parameter, the TPF system uses the default local TPF/APPC LU, which is defined using the MSGRTA macro. For subsequent initializations of this LU, the same local TPF/APPC LU is used regardless of the value specified for this parameter. After all modes are reset for this remote LU, a different local TPF/APPC LU can be used.

  3.  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

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.

Notes:

  1. The sum of this parameter and the CONL parameter cannot exceed the value specified for the LIMIT parameter.

  2. When you specify MODE-singmode, do not specify the CONW parameter; the value is set to 0.

  3. When you specify MODE-SNASVCMG, do not specify the CONW parameter; the value is set to 1.

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.

Notes:

  1. The sum of this parameter and the CONW parameter cannot exceed the value specified for the LIMIT parameter.

  2. When you specify MODE-singmode, do not specify the CONL parameter; the value is set to 0.

  3. When you specify MODE-SNASVCMG, do not specify the CONL parameter; the value is set to 1.

CDRM-netid.cdrmname
specifies the 1- to 17-character name of the remote cross-domain resource manager (CDRM) that owns the specified remote 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

CP-netid.cpname
specifies the 1- to 17-character control point (CP) name of the adjacent APPN node where the remote LU resides.  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

Additional Information

Examples

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

The session limit and the contention-winner polarities are initialized from the TPF system in the following example.

The session limit is 2. The minimum number of contention-winner sessions for the TPF system is 1. The minimum number of contention-loser sessions for the TPF system is 1.

+--------------------------------------------------------------------------------+
|User:   ZNCNS INIT LU-VTAMNET1.APPA MODE-SNASVCMG                               |
|                                                                                |
|System: NCNS0003I 13.07.09 REQUEST ACCEPTED FOR LU-VTAMNET1.APPA MODE-SNASVCMG  |
|        NCNS0001I 13.07.09 REQUEST COMPLETED FOR LU-VTAMNET1.APPA MODE-SNASVCMG |
+--------------------------------------------------------------------------------+

The session limit and the contention-winner polarities are initialized from the TPF system in the following example.

The session limit is 255. The minimum number of contention-winner sessions for the TPF system is 250. The minimum number of contention-loser sessions for the TPF system is 5.

+--------------------------------------------------------------------------------+
|User:   ZNCNS I LU-SVCA  LOCAL-SVCB  MODE-SAM  LIMIT-255  CONW-250  CONL-5      |
|                                                                                |
|System: NCNS0003I 13.29.16 REQUEST ACCEPTED FOR LU-SVCA MODE-SAM                |
|        NCNS0001I 13.29.17 REQUEST COMPLETED FOR LU-SVCA MODE-SAM               |
+--------------------------------------------------------------------------------+

The session limit and the contention-winner polarities are initialized from the remote system in the following example. In this example, the command is entered from the remote system and an informational message is displayed on the TPF system.

The session limit is 255. The minimum number of contention-winner sessions for the remote side is 250. (The number of contention-loser sessions for the TPF system is 250.) The minimum number of contention-loser sessions for the remote side is 5. (The number of contention-winner sessions for the TPF system is 5.)

+--------------------------------------------------------------------------------+
|User:   ZNCNS I LU-APPA  LOCAL-APPC  MODE-SAM  LIMIT-255  CONW-250  CONL-5      |
|                                                                                |
|System: CHNX0001I 13.29.19 CNOS INITIALIZE RECEIVED, MODENAME - SAM,            |
|         REMOTE LU - APPC, LOCAL LU - APPA,                                     |
|         SESSION LIMIT - 255, MIN CONWINNER - 5, MIN CONLOSER - 250             |
+--------------------------------------------------------------------------------+

Related Information

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