Running the INSTALL procedure

Before you begin

Perform the tasks in Preparing-for-installation to obtain the installation package and unload the data set.

Make sure that you run the installation job under a user ID that has the authority to create the z/OS data sets. For more information, see Roles-and-permissions.

To run the INSTALL procedure

To generate the job control that builds the SMP/E environment and installs the product, you run the INSTALL procedure in the installation data set unloaded by the TSO RECEIVE.

From the ISPF command shell, run the INSTALL command.
The following example continues the process after unloading the installation data set that you defined in Preparing-for-installation:
ex 'BMC.fileName.INSTALL(install)'
Tip
If you are already in the data set, edit member mode (3.4), you can open the installation panel by typing the EX command to the left of the INSTALL member name.
The BMC AMI Security installation panel opens:
-------------------------- RSS Software Installation -------------------------
Command ===> __________________________________________________________________

HLQ for runtime datasets   : <hlq>________________________
HLQ for install datasets   : <hlq>.SMPE___________________
HLQ for L/E     datasets   : CEE__________________________

Unit for runtime datasets : SYSDA___   Volume: ______ (Leave blank for SMS)
Unit for SMP datasets      : SYSDA___   Volume: ______ (Leave blank for SMS)

Jobcard for install jobs:
//<xxxxxx> JOB(),CLASS=A,MSGCLASS=X,REGION=0M,NOTIFY=&SYSUID__

Press Enter to generate installation JCL.
Press PF3 to terminate
Change the default values to reflect your installation naming conventions and standards:
- High-level qualifier: Prefix qualifiers that are added to RSS data sets
  For example, if you replace <hlq> with PROD.RSSV230, you will have PROD.RSSV230.RSSLOAD.
- Unit (the default is SYSDA)
- Volume (the default is SMS)
Change the default job card, as required, for the generated job control and press Enter.
The $INSTALL JCL member is built, and you are in an ISPF edit session.
Review the $INSTALL JCL member and make any changes or deletions required before submission. The following image shows the start of the deck:
Important
The following changes are required in the $INSTALL JCL member:
- Under the SMP/E Dataset Allocation block, for the RSSADOCS data set DD statement, change the space value to SPACE=(TRK,(800,100,155)).
- Under Runtime Dataset Allocation block, for the RSSDOCS data set DD statement, change the space value to SPACE=(TRK,(800,100,155)).
After modifying the contents for your environment, you can save the job for later submission or submit it immediately.

During the installation process, all job steps end with return code 0. If you see a return code other than 0 that you cannot resolve, contact BMC Support and have the output from the installation process available.

Data sets on your system after running the installation process

After you run the installation process, the following runtime data sets are created on your system.

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 For a list of the contents, see Contents of the RSSSAMP data set later in this topic.

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

Contents of the RSSSAMP data set

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:

Where to go from here

After you run the INSTALL procedure, see Creating-ESM-resources.