Installing 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 Table Definition.

Step 1: Define the Application Program to VTAM

Add this application program definition to SYS1.VTAMLST:

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

where:

rmomajor

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 Add the Start Procedure for the Cross‑Memory Online Task step in this chapter.

EAS=nn

Specifies the approximate number of concurrent sessions.

rmovtam

Specifies the minor node name of the application program.

• 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 RMOAPPL 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 Deliver.

Example

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

RMO1
RMO2

Create a USS definition table as follows:

USSTAB
*
*    ENTRY FOR RMO1
*
USSCMD  CMD=RMO1,REP=LOGON,FORMAT=PL1
USSPARM PARM=APPLID,DEFAULT=RMOVTAM
USSPARM PARM=LOGMODE
USSPARM PARM=DATA,DEFAULT=RMO.SYSTEM1
*
*    ENTRY FOR RMO2
*
USSCMD  CMD=RMO2,REP=LOGON,FORMAT=PL1
USSPARM PARM=APPLID,DEFAULT=RMOVTAM
USSPARM PARM=LOGMODE
USSPARM PARM=DATA,DEFAULT=RMO.SYSTEM2
USSEND