Post-installation procedures

IMS HP Change Accumulation Utility requires specific customization procedures following installation.

Before you begin

Review the APF-authorization information in the IMS Recovery Solution Pack: Overview and Customization.

About this task

After completing the SMP/E install process, you must:
  1. Modify your skeletal JCL, if this member has one or more job steps following the CA step.
  2. Ensure that the userid/group that is assigned to the started tasks has ALTER authority to the IMS/CA master data.

    This requirement is necessary because the change accumulation address spaces can run as started tasks. The names of the started task procedures are determined by IMS HP Change Accumulation Utility using the HPCA-ID. You can define generic profiles hpca-id *.** for the RACF® class STARTED.

    Alternately, you can define a generic '**' entry for the STARTED class of RACF and the generic '*' in the ICHRIN03 started procedures table.

  3. Verify that IMS HP Change Accumulation Utility modules are installed in an APF-authorized library.
    Note: This step is not necessary if you are using only the single address space mode for invoking IMS HP Change Accumulation Utility.
  4. Ensure that the TSO user ID that runs ISPF has CONTROL access to the RECON data sets.

    The userid on the batch JOB JCL statement (SET opt 2) also requires ALTER access to the IMS change accumulation data sets and READ access to the IMS log data sets.

  5. For IMS HP Change Accumulation Utility in batch mode, the user ID on the batch JOB JCL statement must have the following permissions:
    • CONTROL access to the RECON data sets
    • ALTER access to the IMS change accumulation data sets
    • READ access to the IMS log data sets
  6. If the IEFJOBS feature is used, ensure that the user ID that is assigned to the submitted job has the following permissions:
    • CONTROL access to the RECON data sets
    • ALTER access to the IMS change accumulation data sets
    • READ access to the IMS log data sets

    If you use the custom procedure method to store and process procedures of JOBs, the following two steps are required:

  7. A PROCLIB with a record length of 80 and a fixed block attribute must be defined to either the IEFPDSI DD of the master scheduler JCL or to the PROCxx DDs of the started JES procedure.

    This PROCLIB is a partitioned data set that IMS HP Change Accumulation Utility allocates for writing members into and for starting IMS HP Change Accumulation Utility and its associated subordinate address spaces.

  8. Optionally, add a JCL JOBS library, and make it accessible through the IEFJOBS DD of the master scheduler JCL.

    The record length and block size of this partitioned data set must conform to z/OS® requirements.

    When the IEFJOBS library is used to start IMS HP Change Accumulation Utility address spaces, the PROCLIB data set is not required to be in the IEFPDSI or PROC00 concatenation.

    If you use the standard procedure method, complete the following step:

  9. The standard procedure or standard JOB JCL must be installed into a procedure library.

    For JOB JCL, the library must be in the IEFJOBS DD concatenation of the master scheduler JCL.

    PROCEDURE JCL can be in the IEFPDSI DD concatenation of the master scheduler or PROC00 DD of the started JES system.

    Users will require READ authority for the library.

    The members HPCSPROC and HPCSJOB in the IMS HP Change Accumulation Utility samples library (SHPCSAMP) describe the JCL and necessary modifications.

    If you use the started task method, complete the following step:

  10. The started task JCL must be installed into a library in the IEFPDSI DD or IEFJOBS DD concatenation of the master scheduler JCL.

    The member HPCSSTC in the IMS HP Change Accumulation Utility samples library (SHPCSAMP) describes the JCL and necessary modifications.

Note: Each time IMS HP Change Accumulation Utility is processed, the PROCLIB and the JCL JOBS libraries might be updated. Over time, the libraries will need to be compressed. It is recommended that you define the JCL JOBS and PROCLIB libraries as PDSE data sets. By doing so, you eliminate the need to compress the libraries. If the libraries are not defined as PDSE data sets, then you must include a periodic compress run in your job schedule.