Installing the Online Interfaces › How to Complete Configuration of the XMS Online Interfaces with CA MSM › Define Security Requirements › Installation Steps

Installation Steps

The following steps are required to install the VTAM online retrieval option. Each step is explained in detail in the sections that follow.

1. Define the APPL definition statement to VTAM.
2. (Optional) Create a USS definition table.

Step 1: Define the Application Program to VTAM

Add this application program definition to SYS1.VTAMLST:

* SYS1.VTAMLST(sarmajor)
sarmajor VBUILD TYPE=APPL
sarvtam  APPL  ACBNAME=sarvtam,AUTH=(PASS,ACQ),EAS=nn

where:

sarmajor

Specifies the application program major node name.

Use the SYS1.VTAMLST member name. The member name must be unique and must not be the same as the names on the APPL statement.

AUTH=(PASS,ACQ)

Is required when the cross-memory parameter VTAMPASS=YES is used to support multiple cross-memory regions.

If VTAMPASS=NO, you can specify AUTH=(ACQ). For more information about the VTAMPASS parameter, see the topic, Add the Start Procedure for the Cross-Memory Online Task, later in this chapter.

EAS=nn

Specifies the approximate number of concurrent sessions.

sarvtam

Specifies the application program minor node name.

• This name must be unique within the network domain; it is the APPLID referenced in the USS definition table or LOGON command.
• This name is also specified on the cross-memory SARAPPL parameter.
• If not specified, the network-unique name (the name of the APPL definition statement) is used.

Step 2: (Optional) Create a USS Table Definition

To simplify the manner in which a user logs on to VTAM online retrieval, you can create a USS definition table for CA View.

Example

Assume that two CA View systems have been created. The databases for the two systems have high-level names of VIEW.SYSTEM1 and VIEW.SYSTEM2, and you want a user to simply enter one of the following to log on to VTAM online retrieval for the respective systems:

VIEW1
VIEW2

Create a USS definition table as follows:

USSTAB
*
*    ENTRY FOR VIEW1
*
USSCMD  CMD=VIEW1,REP=LOGON,FORMAT=PL1
USSPARM PARM=APPLID,DEFAULT=SARVTAM
USSPARM PARM=LOGMODE

USSPARM PARM=DATA,DEFAULT=VIEW.SYSTEM1
*
*    ENTRY FOR VIEW2
*
USSCMD  CMD=VIEW2,REP=LOGON,FORMAT=PL1
USSPARM PARM=APPLID,DEFAULT=SARVTAM
USSPARM PARM=LOGMODE
USSPARM PARM=DATA,DEFAULT=VIEW.SYSTEM2
USSEND