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:
- When you specify MODE-singmode, do not specify the LIMIT
parameter; the value is set to 1.
- 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:
- If you are using SLU threads, you must specify the LOCAL parameter for
each initialization, specifying different thread names each time.
- 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.
- 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:
- The sum of this parameter and the CONL parameter cannot exceed the value
specified for the LIMIT parameter.
- When you specify MODE-singmode, do not specify the CONW
parameter; the value is set to 0.
- 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:
- The sum of this parameter and the CONW parameter cannot exceed the value
specified for the LIMIT parameter.
- When you specify MODE-singmode, do not specify the CONL
parameter; the value is set to 0.
- 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.