gtpg2m0wGeneral Macros

CNOSC-TPF/APPC Change Number of Sessions Macro

Use this general macro to provide the communication interface between the control operator and the TPF application programs that are written to connect to remote nodes using the TPF/APPC session interface using LU 6.2 protocols.

Note:
TPF does not support the DEFINE control operator verb defined in the LU 6.2 architecture. The CNOSC DISPLAY verb provides a subset of the parameters for the DISPLAY_MODE verb defined by the LU 6.2 architecture.

This section contains a description of the CNOSC macro in its general form, followed by a separate section for each of the valid verbs.

Format




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

verbname
Specifies the name of the TPF/APPC verb to be executed. The valid verbnames are shown in Table 2.

KEYWORDi=valuei
Specifies the one or more valid keyword parameters and the associated values.

Each macro call begins with CNOSC, followed by the positional parameter verbname, which specifies the verb to be executed. This is followed by one or more keyword parameters and values for those parameters. The values specify either a keyword option or a main storage location of a field.

The main storage location of a field can be specified as either the symbolic name of the field or as a register that points to the field. If you specify a register, the register name must be enclosed in parentheses and must be in the range of R1-R7.

Throughout the descriptions of the CNOSC macros, the phrase source LU refers to the TPF LU and the target LU refers to the remote LU.

Table 2 is a summary of the supported verb names and their associated parameters. The table also contains:

More detailed information for each parameter is provided in the individual verb descriptions later in this chapter.

Table 2. TPF/APPC Change Number of Session Verbs and Valid Keywords

Verb Name Keyword Parameter Passed or Returned Description Architecture Equivalent
CHANGE LUNAME Passed This specifies the name of the remote partner LU. LU_NAME
  MODE Passed This specifies the mode name for which the session limit and polarities are to be changed. MODE_NAME
  LIMIT Passed This specifies the maximum number of sessions to be allowed between the source (TPF) LU and the target (remote) LU for the specified mode name. LU_MODE_SESSION_LIMIT
  CONW Passed This specifies the minimum number of sessions of which the source LU is designated to be the contention winner. MIN_CONWINNERS_SOURCE
  CONL Passed This specifies the minimum number of sessions of which the target LU is designated to be the contention winner. (Or the minimum number of sessions of which the source LU is designated to be the contention loser.) MIN_CONWINNERS_TARGET
  RESP Passed This specifies which LU is responsible for selecting and deactivating sessions as a result of a change that decreases the session limit. RESPONSIBLE
  RCODE Returned This specifies where the return code is to be returned. RETURN_CODE
DISPLAY LUNAME Passed This specifies the name of the remote partner LU. FULLY_QUALIFIED_LU_NAME
  MODE Passed This specifies the mode name for which the session limit and polarities are to be displayed. MODE_NAME
  LIMIT Returned This specifies the maximum number of sessions to be allowed between the source (TPF) LU and the target (remote) LU for the specified mode name. LU_MODE_SESSION_LIMIT
  CONW Returned This specifies the minimum number of sessions of which the source LU is designated to be the contention winner. MIN_CONWINNERS
  CONL Returned This specifies the minimum number of sessions of which the target LU is designated to be the contention winner. (Or the minimum number of sessions of which the source LU is designated to be the contention loser.) MIN_CONLOSERS
  RESP Returned This specifies which LU is responsible for selecting and deactivating sessions as a result of a change that decreases the session limit. related to TERMINATION_COUNT
  DRAIN Returned This specifies whether the source LU or the target LU or both can drain its allocation requests. DRAIN_LOCAL_LU
DRAIN_REMOTE_LU
  RCODE Returned This specifies where the return code is to be returned. RETURN_CODE
INITIALIZE LUNAME Passed This specifies the name of the remote partner LU. LU_NAME
  MODE Passed This specifies the mode name for which the session limit and polarities are to be initialized. MODE_NAME
  LIMIT Passed This specifies the maximum number of sessions to be allowed between the source (TPF) LU and the target (remote) LU for the specified mode name. LU_MODE_SESSION_LIMIT
  LOCAL Passed This specifies the local TPF/APPC LU. Not applicable
  CONW Passed This specifies the minimum number of sessions of which the source LU is designated to be the contention winner. MIN_CONWINNERS_SOURCE
  CONL Passed This specifies the minimum number of sessions of which the target LU is designated to be the contention winner. (Or the minimum number of sessions of which the source LU is designated to be the contention loser.) MIN_CONWINNERS_TARGET
  CDRM Passed This specifies the name of the remote cross-domain resource manager (CDRM) that owns the specified remote LU. Not applicable
  CP Passed This specifies the control point (CP) name of the adjacent APPN node where the specified remote LU resides. Not applicable
  RCODE Returned This specifies where the return code is to be returned. RETURN_CODE
RESET LUNAME Passed This specifies the name of the remote partner LU. LU_NAME
  MODE Passed This specifies the mode name for which the session limit and polarities are to be reset. MODE_NAME
  RESP Passed This specifies which LU is responsible for selecting and deactivating sessions. RESPONSIBLE
  DRAIN Passed This specifies whether the source LU or the target LU or both can drain its allocation requests. DRAIN_SOURCE
  FORCE Passed This specifies whether the source LU is to force the resetting of its session limit when certain error conditions occur that prevent successful exchange of the CNOS request and reply. FORCE
  RCODE Returned This specifies where the return code is to be returned. RETURN_CODE
Note:

Passed
Indicates that the value or option is passed from the transaction program to the verb processing component.

Returned
Indicates that the value or option is returned to the transaction program from the verb processing component.

Entry Requirements

Return Conditions

Programming Considerations

Examples

See the individual verb sections for examples.