gtpg2m0zGeneral Macros

CNOSC INITIALIZE

Use the CNOSC general macro with the INITIALIZE verb specified to initialize the LU 6.2 session limit and the contention-winner polarities for parallel or single session connections.

Format




label
A symbolic name can be assigned to the macro statement.

INITIALIZE
Directs the CNOSC macro to perform the INITIALIZE verb function.

LUNAME
Specifies the symbolic name of a field or a register pointing to a field. This is a 16-byte field that contains the network name of the partner (remote) LU to which the session limit and contention-winner polarity initialization applies. The first 8 bytes contain the left-justified network name, which is padded with blanks, or all blanks if the LU name is unqualified. The second 8 bytes contain the left-justified LU name, which is padded with blanks.

MODE
Specifies the symbolic name of a field or a register pointing to a field. This is an 8-byte field that contains the mode name for which the session limit and polarities are to be initialized. You can specify a user-defined mode name or one of the following values:

singmode
Specifies the mode name for single sessions as defined by the SINGMODE parameter of the SNAKEY macro. See TPF ACF/SNA Network Generation for more information about the SNAKEY macro.

SNASVCMG
Specifies the SNA-defined mode name used to exchange CNOS verbs between the source and target LUs connected by parallel sessions.

LIMIT
Specifies the symbolic name of a field or a register pointing to a field. This is a 2-byte field that contains the session limit for the specified mode name. (The session limit is the maximum number of sessions to be allowed between the source (TPF) LU and the target (remote) LU.)

The specified limit must be greater than zero and greater than or equal to the sum of the numbers specified in the CONW and CONL parameters. If you do not specify LIMIT, the value defaults to 2.

If you specify MODE=SNASVCMG, do not specify LIMIT; the value is set to 2.

If you specify MODE=singmode, do not specify LIMIT; the value is set to 1.

LOCAL
Specifies the symbolic name of a field or a register pointing to a field. This is an 8-byte field that contains the network name of the local TPF/APPC LU, which is left-justified and padded with blanks.

If you do not specify LOCAL, the value is the default local TPF/APPC LU. The default local TPF/APPC LU is defined using the MSGRTA macro. See TPF System Generation for more information about the MSGRTA macro.

CDRM
Specifies the symbolic name of a field or a register pointing to a field. This is a 16-byte field that contains the network name of the remote cross-domain resource manager (CDRM) that owns the specified remote LU. The first 8 bytes contain the left-justified network name, which is padded with blanks, or all blanks if the CDRM name is unqualified. The second 8 bytes contain the left-justified CDRM name, which is padded with blanks.

CONW
Specifies the symbolic name of a field or a register pointing to a field. This is a 2-byte field that contains the minimum number of sessions for which the source LU is designated to be the contention winner.

The specified number must be zero or greater and the sum of this number and the number specified for CONL cannot exceed the number specified with LIMIT. If you do not specify CONW, the value defaults to 0.

If you specify MODE=SNASVCMG, do not specify CONW; the value is set to 1.

If you specify MODE=singmode, do not specify CONW; the value is set to 0.

CONL
Specifies the symbolic name of a field or a register pointing to a field. This is a 2-byte field that contains the minimum number of sessions for which the source LU is designated to be the contention loser.

The specified number must be zero or greater and the sum of this number and the number specified for CONW cannot exceed the number specified with LIMIT. If you do not specify CONL, the value defaults to 0.

If you specify MODE=SNASVCMG, do not specify CONL; the value is set to 1.

If you specify MODE=singmode., do not specify CONL; the value is set to 0.

CP
Specifies the symbolic name of a field or a register pointing to a field. This is a 16-byte field that contains the control point (CP) name of the adjacent APPN node where the specified remote LU resides. The first 8 bytes contain the left-justified network name, which is padded with blanks, or all blanks if the CP name is unqualified. The second 8 bytes contain the left-justified CP name, which is padded with blanks.

RCODE
Specifies the symbolic name of a field or a register that points to a field. This is a 6-byte field in which the return code is placed. The return code consists of a 2-byte primary return code followed by a 4-byte secondary return code. The actual values returned are listed in Return Conditions.

Entry Requirements

See Entry Requirements for the entry requirements relating to the CNOSC macro in general.

Return Conditions

Programming Considerations

Examples

SYMB100   CNOSC INITIALIZE,                        X
                LUNAME=EBX024,                     X
                MODE=EBW080,                       X
                LIMIT=EBW020,                      X
                CONW=(R4),                         X
                CONL=(R3),                         X
                RCODE=EBX000