Defining the repository and configuring the ISPF CLIST

IMS Recovery Expert provides a comprehensive metadata repository to record backup information. You must define this repository and configure the ISPF CLIST. All of the jobs that are required for these tasks are included as library members. Instructions on how to update the jobs for your environment are included in the members.

Procedure

  1. Update the BSYCNTL member in the SBSYSAMP library and submit the job.
    This job creates the VSAM control file used by IMS Recovery Expert, which contains setup information for each IMS subsystem. Instructions are contained in the member.
  2. Update the BSYREPO member in the SBSYSAMP library and submit the job. This job creates the VSAM KSDS repository files needed by the product to save control and execution information. Detailed instructions are contained in the member.
    Note: In a data sharing environment, the IMS Recovery Expert repository must be on shared DASD that is seen by all members of the data sharing group.
  3. If you plan to use the checkpoint restart capability for local application recovery, update the BSYCHKPT member in the SBSYSAMP library and submit the job.
    This job creates the VSAM KSDS repository file that is needed to save job execution information for checkpoint restart. Detailed instructions are contained in the member.
  4. Add the program BSY$TSOC to the AUTHPGM and AUTHTSF sections of member IKJTSO00 in SYS1.PARMLIB. You can use MVS operator command SET IKJTSO=xx or TSO/E command PARMLIB UPDATE(xx) to make the change to IKJTSO00 effective dynamically. For more information on IKJTSO00, refer to the IBM® for z/OS®: Initialization and Tuning Guide.
  5. Update the BSYV22 and BSYV220 members in the SBSYSAMP library. These members are used when launching the ISPF interface to IMS Recovery Expert. Detailed instructions are contained in the members.
  6. Copy the following members from the SBSYSAMP library to your site's CLIST library:
    • BSYV22
    • BSYV220
    • BSYTSOC
    • BSYCAPS
  7. Update the BSYGDG member in the SBSYSAMP library and submit the job. This job creates the GDG bases used to hold backups of the product's VSAM repository files. Detailed instructions are contained in the member.
  8. Optional: Update the BSY#PARM member. This member contains default values used when building backup, restore, recovery, and disaster recovery preparation jobs. The default values provided in this member may be sufficient; however, you can edit the parameters as described in the topic (Optional) Configuring the PARMLIB member.
  9. The target load library SBSYLOAD must be APF authorized. Include the highlvl.SBSYLOAD library as part of your system APF authorized list.

    User access to certain functions can be regulated by security settings. The following table describes the profiles needed to control the IMS Recovery Expert functions for either a RACF® or ACF2 environment:

    Table 1. RACF profiles for authorization
    Function Description of Authority Profile Access Type Required
    Access Grants a user the authority to use IMS Recovery Expert BSY.ACCESS.ssid where ssid is a four-character IMS subsystem name, group name, or *. READ
    Table 2. ACF2 definitions for authorization
    $KEY TYPE ACCESS
    BSY FAC ACCESS.* UID userid ALLOW

    A user cannot run a IMS Recovery Expert backup or restore utility if they are not granted READ access to the corresponding profile, or if the profile does not exist. If the specific Facility Class Profile does not exist, then the most granular generic Facility Class Profile will be applied in its place. For example, if BSY.ACCESS.ssid does not exist for an IMS Recovery Expert subsystem or group, but a generic Facility Class Profile name BSY.ACCESS.* exists, then the generic profile is used. Only authorization IDs with READ access to the profile is cleared by security checking.

  10. Run the BSYV22 CLIST to access the ISPF interface.