Defining specific APPL definitions and APPL parameters to SNA

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

Defining specific CICS APPL statements to SNA

For example, you might 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
********************************************************************

Code CICSHTH1 on the CICS system initialization parameter APPLID to define the SNA application identifier to CICS.
See Data set naming conventions for information about the naming convention that is used for the CICSHTH1 applid.

SNA APPL parameters for CICS regions

ACBNAME=acbname

Specifies the minor node name (acbname) that is assigned to this application. This name must be unique in the domain. If you do not specify this parameter, the name of the SNA APPL statement is taken.

AUTH=(ACQ,VPACE[,PASS])

Allows CICS to acquire LUTYPE 6 sessions. VPACE allows pacing of the intersystem flows. Specify PASS if you intend to use the EXEC CICS ISSUE PASS command to pass existing terminal sessions to other SNA 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.

LUAPFX=string

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. SNA concatenates the characters specified with the next sequential number available to form an SNA-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. Take into account the SNA naming conventions when choosing this prefix. For CICS information about specifying the LU alias string, see Choosing an LUAPFX value.

SNA 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 does not start until no more sessions that involve the resource represented by a CDRSC remain.

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

PARSESS=YES

Specifies LUTYPE 6 parallel session support.

PERSIST=MULTI

Indicates that the application supports Multi Node Persistent Sessions. For further information, see z/OS Communications Server: SNA Network Implementation Guide.

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.