Reviewing the startup JCL procedures

Follow these steps to review and configure the startup JCL procedures:

1. Copy the following members from hlq.RSMSAMP into your production hlq.PROCLIB:
   • RSVGJCL for the gateway
   • RSVAJCL for the agents
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 the gateway and agent address spaces. The EXEC PARM supports multiple parameters://RSSSTEP EXEC PGM=RSS,PARM='RSSID=rssId,CONFIG=configMember,START=startType'
    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	WARM or COLD start WARM restarts the checkpoint data set with available previous data. COLD deletes the data from the checkpoint data set and restarts it without previous data. Error Warning A COLD start is not recommended, but if it is required, you must delete and re-allocate the VSAM cluster.

   Information

   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. 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. Add the BMCPSWD DD statement to the started task JCL, pointing to the BMC password data set:
   //BMCPSWD DD DISP=SHR,DSN=hlq.BMCPSWD.S0W1

The following example shows gateway and agent startup JCL procedures for BMC AMI Enterprise Connector for Venafi :

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.