Defining specific CICS APPL statements to VTAM

To define a CICS® region to VTAM®, specify the minor node name to be used for the CICS region on the VTAM APPL definition statement.

For example, you could use the following definition for the CICS region to be identified as CICSHTH1:

**********************************************************************
* Specific APPL definition for CICS region CICSHTH1
**********************************************************************
CICSHTH1 APPL  AUTH=(ACQ,VPACE,PASS),VPACING=0,EAS=5000,PARSESS=YES    X
               SONSCIP=YES,LUAPFX=XX
********************************************************************

Notes:
  1. Code CICSHTH1 on the CICS system initialization parameter APPLID, to define the VTAM application identifier to CICS.
  2. See Naming conventions for information about the naming convention that is used for the CICSHTH1 applid.

VTAM APPL parameters for CICS regions

When you define your CICS system to ACF/VTAM, include the following parameters on the VTAM APPL statement:

ACBNAME=acbname
Specifies the minor node name (acbname) that is assigned to this application. This name must be unique within the domain. If you do not specify this parameter, the name of the VTAM APPL statement is taken.
AUTH=(ACQ,VPACE[,PASS])
ACQ allows CICS to acquire LUTYPE 6 sessions. VPACE allows pacing of the intersystem flows. You need PASS if you intend using the EXEC CICS ISSUE PASS command to pass existing terminal sessions to other VTAM applications.
EAS=number
Specifies the number of network-addressable units. The number must include the total number of parallel sessions for this CICS system.
HAVAIL=YES
Indicates that the application supports XRF sessions and can initiate XRF sessions.
LOGMODE=name
(For CICS-to-CICS APPC systems.) Defines the name of the MODE table that contains the LU6.2 MODEENT for the secondary sessions.
LUAPFXstring
specifies the prefix characters of the LU alias to be assigned when a dynamically generated cross-network CDRSC (with NQNMODE=NQNAME) is created for a session with CICS. VTAM concatenates the characters specified with the next sequential number available to form a VTAM-generated LUALIAS name for the cross-network dynamic CDRSC.
string
indicates the two characters to be used as the prefix for all dynamically generated LUALIAS names for dynamic cross-network CDRSCs in session with the CICS region defined by the APPL statement. Remember to take into account the VTAM naming conventions when choosing this prefix. For CICS considerations when specifying the LU alias string, see Choosing an LUAPFX value.
Note:
VTAM deletes a dynamically-generated LU alias after a terminal session is closed, or the last session of an APPC parallel sessions connection is closed, and the CDRSCTI-specified timeout interval has expired. The permitted range of timeout values is 1 second to 7 days, but generally the default of 8 minutes is acceptable in most situations. The CDRSCTI timer doesn't start until there are no more sessions involving the resource represented by a CDRSC.

For more information about CICS support for the VTAM dynamic LU alias facility, see VTAM LU alias facility.

PARSESS=YES
Specifies LUTYPE 6 parallel session support.
PERSIST=MULTI
Indicates that the application supports Multi Node Persistent Sessions (MNPS). For further information, see the z/OS Communications Server: SNA Network Implementation.
SONSCIP=YES
Specifies session outage notification (SON) support. SON enables CICS, in certain cases, to recover a session after session failure without operator intervention.
VPACING=number
Specifies the maximum number of normal-flow requests that another logical unit can send on an intersystem session before waiting to receive a pacing response. Start with a value of 5.
[[ Contents Previous Page | Next Page Index ]]