Reviewing the startup JCL procedure

1. In the sample library, locate the following sample startup procedure:
   • RSSPROC for the server address space
   • RSSMPROC for the master address space
   • RSSTPROC for the TSO address space
2. Copy the procedures to your production environment that runs the procedure library, and change the data set names to reflect those built during installation.
3. Make sure that the RSSPARM DD statement refers to the RSS configuration member that you prepared in Reviewing-the-product-configuration.

4. Configure the EXEC PARM for RSS and agent address spaces. The EXEC PARM supports multiple parameters://RSSSTEP EXEC PGM=RSS,PARM='RSSID=rssId,CONFIG=configMember,START=startType,SCOPE=scope'
   
   The following table describes the parameter values:

   Parameter	Description
   RSSID	ID of the target BMC AMI Resident Security Server (RSS)
   CONFIG	Name of the parmlib configuration member
   START	WARM or COLD start COLD deletes the data from the checkpoint data set and restarts it without previous data. WARM restarts the checkpoint data set with available previous data.
   SCOPE	(Optional) Controls the block of configuration parameters processed by this product instance For more information, see Configuring the Scope parameter.

   For the started task procedure, use the CONFIG option on the EXEC statement for greater control over the parmlib:
   //ECYZBGL PROC MBR=MYRSS,START=COLD
   ...
   //RSS EXEC PGM=RSS,REGION=0M,TIME=1440,PARM='RSSID=BMCSEC,CONFIG=BMCSEC1'

   
   

   You can concatenate multiple PARMLIB PDSes in the RSSPARM DD statement, as follows:

   //RSSPARM DD DISP=SHR,DSN=BMCSEC.RSS.PARMLIB// DD DISP=SHR,DSN=BMCSEC.RSS.USER.PARMLIB

   In this way, you can differentiate PARMLIB access for users.

   When an RSS address space needs to interact with a product server address space (such as an agent or RSS TSO address spaces), assign the same product ID to each address space.

   If you need multiple product server address spaces in the same sysplex, give each one a unique product ID.

   For product TSO address spaces, the syntax to define RSSID is different because of the need to include the IKJEFT01 entry point:
   //RSSTSO EXEC PGM=IKJEFT01, 
   // PARM='CALL *(RSSTSO) ''RSSID=rssId'' '

5. (SPE2107) To obtain a product key, send an email to customer_support@bmc.com or open a support case at BMC Support.

   When you receive the key, you also receive an email with the sample JCL to build the key in the BMC password data set. Substitute the data set names as follows:
   //STEPLIB DD DISP=SHR,DSN=hlq.RSMLOAD
   //SYSLIB  DD DISP=SHR,DSN=hlq.BMCPSWD

6. (SPE2107) Add the BMCPSWD DD statement to the started task JCL, pointing to the BMC password data set:
   //BMCPSWD DD DISP=SHR,DSN=hlq.BMCPSWD

7. (SPE2304) To store user session information, such as UI table sizes and column sorting preferences, you must specify the PAMUENT DD in the started task JCL. For example:
   //PAMUENT DD DISP=SHR,DSN=hlq.PAMUENT
   You must have previously defined the following attributes in the data set library:
   • LRECL=80
   • RECFM=FB
   • BLOCKSIZE=32720

Where to go from here

After you complete this step, the product is fully installed and configured and ready to be started. See Verifying-the-installation.