Adjusting GENMAX when it is reached or it is too high

Prior to image copy utility execution, verification exit processing may determine that one of the following situations is true when image copy data sets are being reused. In such cases, the GENMAX value is either too high or too low. In either case, a command must be issued to correct the problem.

  • Situation 1: GENMAX value is too low
    • The GENMAX value was reached.
    • The oldest image copy cannot be reused because it is within the recovery period.
    • No available image copies exist that can be used.
    • Message DSP0063I was displayed.
    • Increase GENMAX and define additional image copy data sets.
    • Change the recovery period to allow the oldest image copy data set to be used.

    Issue the CHANGE.DBDS command to increase the GENMAX and INIT.IC parameters to define the additional image copy data sets:

    1. Create a JCL job similar to one of the following jobs. These examples assume that your DBD name is THISDB, that your area name is AREA1, and that your previous GENMAX value was 2.
      //CHNGDBDS JOB
       
      //SYSIN DD *
           CHANGE.DBDS DBD(THISDB) AREA(AREA1) -
                       GENMAX(4)
      /*//INITIC JOB
       
      //SYSIN DD *
           INIT.IC DBD(THISDB) DDN(DDN1) -
                   ICDSN(IMS.*.NEWICDSN)
           INIT.IC DBD(THISDB) DDN(DDN1) -
                   ICDSN(IMS.*.NEWICDSN2)
      /*

      Issue CHANGE.DBDS RECOVPD to reduce the recovery period.

      //CHNGDBDS JOB
      //SYSIN DD *
            CHANGE.DBDS DBD(THISDB) AREA(AREA1) RECOVPD(10)
      /*
    2. Run the job.
    3. Check the JES log to ensure that the job ran successfully.
    4. Run a LIST command to see the new GENMAX value (optional).
    5. Run your image copy job.
  • Situation 2: GENMAX value is too high
    • GENMAX has not been reached so the in use image copy data sets cannot be used.
    • No available image copy data sets exist that can be used.
    • Message DSP0084I was displayed.
    • No recovery period is defined.
    • Issue an INIT.IC command to define a new image copy data set for the identified database data set or area data set

      Or, you can perform the following task:

    • Issue a CHANGE.DBDS command to lower the GENMAX value.
    Attention: If GENMAX is lowered using the CHANGE.DBDS command, the new GENMAX value is recorded regardless of whether the oldest image copies are able to be deleted or not, because they are within the recovery period.