Install ERO

The ERO (Expanded Retention Option) option allows you to specify particular SYSOUTs as having expanded retention, beyond the expiration for selected reports. These SYSOUTs can be given separate retention criteria. Read these instructions thoroughly before installing the option.

Step 1: Set the ERO Initialization Parameters

For more information about the instructions and a discussion of the initialization parameters available for the ERO, see the following chapters in the Reference Guide:

"Initialization Parameters"
"Configuring"
"Expanded Retention Option"

Record the expanded retention initialization parameter values on the Initialization Parameter Worksheet in the appendix "Installation Worksheets."

Step 2: (Optional) Create the ERO Table Statements

The ERO table is a PDS member with multiple control statements.

If you want selective permanent archival of SYSOUT, place the control statements in a card image data set and include a SARPATAB DD statement for the data set in the archival started task JCL.

Record the name of your expanded retention control statement data set next to the SARPATAB ddname on the Archival Started Task Worksheet.

Install the VTAM Print Option

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

Define the application program to VTAM.
(Optional) Verify the CICS table entries for printers shared with CICS.
Set the VTAM print option initialization parameters.

Configuration Requirements

The VTAM print option is designed for an IBM 3287 printer configuration with LU type = 3. Consult your VTAM systems programmer if necessary.

Step 1: Define the Application Program to VTAM

Add the following application program definition to SYS1.VTAMLST:

name     VBUILD   TYPE=APPL
CCCC0001 APPL     AUTH=(ACQ)
CCCC0002 APPL     AUTH=(ACQ)
CCCC0003 APPL     AUTH=(ACQ)
CCCC0004 APPL     AUTH=(ACQ)
    .
    .
CCCCnnnn APPL     AUTH=(ACQ)

where CCCCnnnn values are as follows:

CCCC: Is the value in the VPRTAPPL initialization parameter
nnnn: Is a sequential number starting at 0001 which specifies the total number of printers being used simultaneously by all concurrent online users and batch jobs

Step 2: (Optional) Verify the CICS Table Entries

Ensure that you have the proper CICS table entries for printers shared with CICS. If you are sharing a printer with CICS, the CICS TCT must have a parameter of the following:

RELREQ=(YES,YES)

or an equivalent RDO setting:

RELREQ ---->YES
DISCREQ --->YES

Step 3: Set the VTAM Print Option Initialization Parameters

If the default VTAM print option initialization parameters are not suitable for your site, you can define your own specifications.

Note: For information about the initialization parameters, see the chapters "Configuring" and "Initialization Parameters" in the Reference Guide.

VTAM print option parameters have the prefix VPRT.

Record the VTAM print option initialization parameter values on the Initialization Parameter Worksheet in the appendix "Installation Worksheets."

Install the Interface with Print Management

The CA View-to-CA Spool interface allows you to output data directly into the CA Spool database rather than having to pass it through the JES SPOOL, which reduces processing time significantly.

The CA Spool interface option is installed during SMP/E RECEIVE and APPLY.

CA Spool Requirement

For the interface to work properly, you must have installed CA Spool 11.7 or later.

Initialization Parameters

Follow these steps:

Specify the initialization parameter CMASPOOL.
If you want to route print requests to CA Spool automatically, specify the initialization parameter PRINTTO SARINIT.
Evaluate all other initialization parameters that begin with CMA.

Record the CA Spool initialization parameter values on the Initialization Parameter Worksheet.

Note: For information to configure initialization parameters, see the Reference Guide.

Install the Interface with ACIF (AFP Report Archival)

The following steps are required to install the CA View ACIF Interface Option. Each step is explained in detail in the following sections.

Define JES2 initialization statements, for JES2 sites.
Define JES3 initialization statements, for JES3 sites.
Define a CA View ACIF archiver PROC.
Define CA View FSA device control statements.

Note:

For more information about archiving AFP reports to CA View, ACIF control statements, and a complete example of the process, see the "Archival" chapter in the Reference Guide.
ACIF indexing on AFP reports requires a functional subsystem definition (FSS).
FSS printers can be installed under JES2, JES3, or CA Spool. If you are planning to use CA Spool to host the ACIF FSS collector, see the CA Spool documentation for information about how to install and operate FSS printers under CA Spool.

After you have defined the CA View FSS printer to CA Spool, skip Step 1 and Step 2 and continue with Step 3.

Step 1: Define JES2 Initialization Statements

This step provides a sample FSS definition, JES2 initialization statements, and a JES2 print statement.

Use the sample FSS definition as a guide and place the JES2 initialization statements in the JES2 PARMLIB or in a SYS1.PARMLIB.

Note: For more information about JES2 statements and a description of all of the FSSDEF parameters, see the IBM JES2 Initialization and Tuning Reference for your operating system.

Sample FSS Definition

This example shows JES2 statements for a CA View ACIF archiver:

FSSDEF(VBRMFSSS)PROC=CBRMSFSS, AUTOSTOP=Y PRINTER(10)FSS=VBRMFSSS,

    PRMODE=(ACIF),                 
    MODE=FSS,                      
    CLASS=AJQ,                     
    DRAIN,                         
    ROUTECDE=(R10),                
    NOSEP,                         
    WS=(PRM,Q,R)

A sample PROC for this procedure is in CAI.CVDEPROC.

JES2 Initialization Statements

The FSSDEF initialization statement defines an FSS to JES2. The following explanations of the JES2 initialization statements are used in the definition of a CA View ACIF archiver. The syntax is as follows:

FSSDEF Statement

The FSSDEF statement is associated with one or more PRTnnnn statements that define each archiver FSA. The FSSDEF initialization parameter is optional, but recommended. If it is omitted, JES2 generates a default for that archiver.

The FSSDEF statement contains the following parameters:

FSSNAME

Defines the unique 1- to 8-character name of an FSS.

When you start the first CA View ACIF archiver that has an FSA definition for that FSS, an FSS address space is created for the archiver. The CA View ACIF interface manages this FSS and the archival FSA for the first CA View ACIF archiver. If you start a second archiver with an FSA definition for the same FSS, the CA View ACIF interface manages a separate FSA for the second archival FSA in that FSS.

Under JES2, each FSS can support a maximum of 24 FSAs. The actual number of FSAs per FSS depends on several factors, such as the size of resources used in the print jobs and the available virtual storage.

This parameter is required.

PROC

Specifies a procedure for starting the CA View ACIF FSS.

The procedure (which must be defined before this FSS is started) is a member of either SYS1.PROCLIB or a library concatenated to SYS1.PROCLIB. Different FSSDEF initialization parameters can refer to the same startup procedure.

HASPFSSM

Defines the 1- to 8-character name of the load module that is loaded into the PSF FSS address space.

This load module contains the various JES2-supplied FSI service routines. For CA View ACIF, specify the default value (HASPFSSM = HASPFSSM).

JES2 PRINTER(nnnn) Statement

A PRINTER(nnnn) statement (required to define each FSA) is associated with an FSSDEF statement. Each archival FSA must have a unique PRINTER(nnnn) name. This unique PRINTER(nnnn) must match the label on the device parameter DD statement in the procedure for starting the CA View ACIF FSS.

PRINTER(nnnn)

The PRINTER(nnnn) parameters define JES2 default values. The PRINTER(nnnn) statement contains the following parameters:

CLASS

Specifies the output class used for selecting data sets to be archived.

This parameter is only needed when Q is specified as the work selection (WS) criterion.

DRAIN|START

One of the following options:

DRAIN: Specifies that the archiver can be started by operator command.
START: Specifies that the archiver is started automatically when JES2 begins processing.

FSS

Defines the FSS for the archiver.

This value must match the value coded for an FSSNAME parameter for the corresponding FSSDEF statement. This parameter is required.

MODE

Specifies that the printer is managed by an FSS (MODE=FSS).

This parameter is required.

PRMODE

Defines the processing mode used for selecting data sets to be archived

This parameter is only needed when PRM is specified as the work selection (WS) criterion.

NOSEP

Indicates that no separator pages are to be produced.

TRKCELL=YES

Indicates that track-cell de-spooling is used with this printer.

ROUTECDE

Defines the route code used for selecting data sets to be archived.

This parameter is only needed when R is specified as the work selection (WS) criterion.

FORMS

Defines the form identifier used for selecting data sets for archival.

This parameter is only needed when F is specified as the work selection (WS) criterion.

WRITER

Defines the writer name used for selecting data sets for archival.

This parameter is only needed when W is specified as the work selection (WS) criterion.

WS

Defines the work selection criteria for archival.

Examples of WS are:

WS=(PRM),PRMODE=ACIF: Selects all data sets having a process mode of ACIF.
WS=(Q),CLASS=S: Selects all data sets having a SYSOUT class of S.

Step 2: Define JES3 Initialization Statements

This step provides a sample FSS definition, JES3 initialization statements, and a JES3 device statement.

Use the sample FSS definition as a guide and place the JES3 initialization statements in a SYS1.PARMLIB.

Note: For more information about JES3 statements, see the IBM JES3 Initialization and Tuning Reference for your operating system.