Copying and configuring the JCL procedures


After you install the product or products, you copy the the JCL procedures from the hlq.RSSSAMP data set to the hlq.RSSPARM data set.

Warning

The hlq.RSSSAMP library is overwritten after you upgrade the product. Rename the hlq.RSSPARM library or create a backup of the file before you upgrade your system.


To copy and configure the JCL procedures

  1. From the hlq.RSSSAMP library, copy the required members for your product or products into your hlq.RSSPARM library.
    Refer to the RSSSAMP contents table for details about the data set members.
  2. Update all the data sets with your high-level qualifier.
  3. Apply the license key data set (from Creating-the-BMC-license-data-set) to the started task JCL:
    //BMCPSWD DD DISP=SHR,DSN=hlq.BMCPSWD
  4. Copy the procedures to your production environment that runs the procedure library.
  5. Make sure that the RSSPARM DD statement refers to the RSS configuration member that you copied to the hlq.RSSPARM data set.
  6. Configure the EXEC PARM for RSS and agent address spaces as in one of the following syntax examples:

    • //RSSSTEP EXEC PGM=RSS,PARM='RSSID=rssId,CONFIG=configMember,START=startType,SCOPE=scope'
    • For BMC AMI Security Policy Manager use the following JCL:

      //RSS EXEC PGM=RSSPMHLM,REGION=0M,TIME=1440, 
      //PARM='RSSID=rssId,CONFIG=configMember,START=startType,MSTR=masterAddressSpace'

    The following table describes the parameter values:

    Parameter

    Description

    RSSID

    ID of the target Resident Security Server (RSS)

    CONFIG

    Name of the parameter library configuration member

    START

    Restarts RSS and RSS-based products

    • COLD deletes the data from the checkpoint data set and restarts it without previous data.
    Warning

    (For 

    BMC AMI Enterprise Connector for Venafi

    ) A COLD start is not recommended, but if it is required, you must delete and re-allocate the KSDS VSAM cluster.

    • WARM restarts the checkpoint data set with available previous data.
    • NEWDB deletes the data from the checkpoint data set and deletes existing DASD-database information, and restarts without previous data.

    SCOPE

    (Optional) Controls the block of configuration parameters processed by this product instance

    For more information, see Configuring-the-Scope-parameter

    MSTR (for SPM)

    Master address space instance

RSSSAMP contents

The following table lists the contents of the hlq.RSSSAMP data set, which contains members such as sample JCL procedures, configuration files, and exits for the product suite. You can either copy the contents of the sample members into your configuration member, or you can specify INCLUDE commands in your configuration member.

RSS data sets

Data set

Description

hlq.KNOWBASE

Knowledge-based rules for RSS products, drop-down menu, and bar reports in the user interface

hlq.PTFLIB

Additional PTFs that are applied to the environment after the initial installation

This is the data set where the APPLYPTF member in the hlq.INSTALL library points to in its DD statement.

hlq.RSSDOCS

Members required for the browser-based user interface

hlq.RSSEXEC

BMC AMI Enterprise Connector for Venafi REXX execs

hlq.RSSLOAD

Load modules for all products in the BMC AMI Resident Security Server product suite

hlq.RSSPARM

Startup and configuration parameter members for all products in the BMC AMI Resident Security Server product suite

hlq.RSSRULE

Compliance rules for BMC AMI Security Policy Manager

hlq.RSSSAMP

Sample JCL scripts and startup parameters for all products in the BMC AMI Resident Security Server product suite

SMP/E data sets

Your system also includes the following standard SMP/E installation data sets and distribution libraries:

Data set

Description

hlq.SMPE.GLOBAL.CSI

Standard SMP/E global CSI VSAM data set

hlq.SMPE.GLOBAL.CSI.DATA

Standard SMP/E global CSI data set

hlq.SMPE.GLOBAL.CSI.INDEX

Standard SMP/E global CSI index

hlq.SMPE.RSSAEXEC

SMP/E BMC AMI Enterprise Connector for Venafi REXX execs

hlq.SMPE.RSSALOAD

SMP/E load modules for all products in the BMC AMI Resident Security Server product suite

hlq.SMPE.RSSASAMP

SMP/E sample JCL and startup parameters for all products in the BMC AMI Resident Security Server product suite

hlq.SMPE.SMPLOGA

Standard SMP/E log data set backup LOG data set

hlq.SMPE.SMPMTS

Standard SMP/E MTS target library containing macros that are found only in a distribution library

hlq.SMPE.SMPSCDS

Standard SMP/E source control data set (SCDS)

hlq.SMPE.RSSADOCS

SMP/E RSS graphical user interface members

hlq.SMPE.RSSAKNOB

SMP/E data set that contains all RSS knowledge base entries

hlq.SMPE.RSSARULE

SMP/E data set that contains all of the compliance rules for BMC AMI Security Policy Manager

hlq.SMPE.SMPLOG

Standard SMP/E LOG data set

hlq.SMPE.SMPLOGA

Standard SMP/E LOG data set alternate or backup

hlq.SMPE.SMPLTS

Standard SMP/E LTS library that contains base load modules and program object versions for which SYSLIB allocations have been specified

hlq.SMPE.SMPPTS

Standard SMP/E SYSMOD repository data set

hlq.SMPE.SMPSTS

Standard SMP/E data set target library for a source that exists only in a distribution library

To store user interface information (PAM only)

To store user session information for the BMC AMI Security Privileged Access Manager product user interface, such as table sizes and column sorting preferences, update the PAMUENT DD in the PAMMPROC JCL procedure.

For example:

//PAMUENT DD DISP=SHR,DSN=hlq.PAMUENT

You define the following attributes in the data set library:
•    LRECL=80
•    RECFM=FB
•    BLOCKSIZE=32720

Where to go from here

After you copy and configure the JCL procedures, see Authorizing-the-load-library.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*