Communications Access Methods for SAS/CONNECT and SAS/SHARE Software

System Configuration for the APPC Access Method

VTAM Systems Personnel

To configure resources for the VSE system that enable it to behave as either a local or a remote host in a SAS/CONNECT session or as a SAS/SHARE client and server with the APPC access method, perform the following tasks:

Configure the VSE APPC environment with an application (APPL) definition statement.
Add entries to the logon mode table.

This section highlights the general tasks that you must perform to configure the VSE system for use with the APPC access method. For full details about configuring the APPC subsystem, see References for a list of related documents.

Using an APPL Definition Statement to Configure the VSE Environment

Specify an APPL definition statement to configure the VSE environment. Use a comma to separate each entry. Here is an example. This APPL statement allows for 32,767 sessions (16,384 contention winners and 16,383 contention losers) per LU/MODE pair.

SASAPPC  APPL   APPC=YES,
ACBNAME=SASAPPC,
AUTH=(ACQ,NOCNM),
AUTOSES=1,
DDRAINL=NALLOW,
DMINWNL=16384,
DMINWNR=16383,
DRESPL=NALLOW,
DSESLIM=32767,
MODETAB=SASAPPC,
PARSESS=YES,
SECACPT=CONV

An explanation of each entry follows:

APPL: declares an APPL definition statement.
APPC=YES: tells APPC that the application program can issue APPCCMD macros.
ACBNAME=SASAPPC: is the application name, which must be identical to the value assigned to the APPCAPPL option. See SAS/CONNECT and SAS/SHARE Options for information about the APPCAPPL option.
AUTH=(ACQ,NOCNM): specifies that the program can use the OPNDST macro instruction with the ACQUIRE option. The NOCNM argument means that the program cannot use (NO) the Communication Network Management (CNM) interface.
AUTOSES=1: tells the APPC subsystem how many sessions to start automatically after CNOS (Change Number of Sessions) negotiation.
DDRAINL=NALLOW: does not allow the application to drain its allocation requests during shutdown.
DMINWNL=16384: specifies the minimum number of parallel sessions of which the local LU is guaranteed to be the contention winner.
DMINWNR=16383: specifies the minimum number of parallel sessions of which the remote LU is guaranteed to be the contention winner.
DRESPL=NALLOW: requires the remote partner to deactivate sessions.
DSESLIM=32767: defines the maximum session limits.
MODETAB=SASAPPC: defines the session logon mode table.
PARSESS=YES: indicates support for parallel session capability.
SECACPT=CONV: indicates that FMH5 security subfield information is accepted.

See VTAM Installation and Resource Definition (SC23-0111) for more information about these parameters.

Defining the Logon Mode Table Entries

A logon mode table contains one or more sets of session properties, which contain session protocols that describe how the session will be conducted. These entries support session binding to a secondary LU that resides within the local VTAM domain.

Refer to the BIND LU description in Technical Reference 3, SNA Formats and the MODEENT discussion in Technical Reference 5, VTAM Customization for complete information. Contact IBM for information about this documentation.

The following example shows a typical logon mode table that contains two sets of entries.

The first entry is a reserved mode name that is used by VTAM for control operator functions.

The second entry is the mode that defines the parameters for sessions between VSE and its partner LUs. The value for the mode name (SASAPPC in this example) must be identical to the value assigned to the APPCLOGM option. See SAS/CONNECT and SAS/SHARE Options for information about the APPCLOGM option.

SNASVCMG MODEENT LOGMODE=SNASVCMG,
                 FMPROF=X'13',
                 TSPROF=X'07',
                 PRIPROT=X'B0',
                 SECPROT=X'B0',
                 COMPROT=X'50B3',
                 PSERVIC=X'060200000000000000000300',
                 TYPE=X'00'

SASAPPC MODEENT  LOGMODE=SASAPPC,
                 FMPROF=X'13',
                 TSPROF=X'07',
                 PRIPROT=X'B0',
                 SECPROT=X'B0',
                 COMPROT=X'50B1',
                 PSERVIC=X'060200000000000000100F00',
                 TYPE=X'00'

Note: The SNASVCMG entry is required to support SNA services that are initiated through a boundary NCP. [cautionend]

SNASVCMG is a reserved mode name that is used by VTAM for control operator functions. SASAPPC is the mode name that defines the session parameters that exist between the local and remote applications.

After you add these entries to the logon mode table, you must re-assemble and link edit the table so that it resides in the VSE librarian sublibrary that contains the VTAM configuration definitions. This sublibrary is usually named PRD2.CONFIG.

You have completed the VSE host configuration process.

References

For complete details about how to install and configure the APPC system, see the following documents:

SNA Technical Overview (GC30-3073)

SNA Formats (GA27-3136)

VTAM Programming for LU6.2 (SC31-6410)

VTAM Installation and Resource Definition (SC23-0111)

Contact IBM for information about obtaining this documentation.

Chapter Contents
Previous
Next
Top of Page

	SNA Technical Overview (GC30-3073)
	SNA Formats (GA27-3136)
	VTAM Programming for LU6.2 (SC31-6410)
	VTAM Installation and Resource Definition (SC23-0111)