Image Copy Stacking Process report

The Image Copy Stacking Process report contains information about the result of stacked image copy processing.

This report consists of several sections.

Stacking Process Summary section
STACK DD Summary section
STACK DD Detail section
Bypassed Databases section

Stacking Process Summary section

The Stacking Process Summary section shows a list of STACK DD statements that are processed in the job step of IMS HP Image Copy. It also shows whether the tape volume on the STACK DD statement is to be replaced or not for the restart processing of the Checkpoint Restart function.

The following figure is an example of the Stacking Process Summary section.

Figure 1. Stacking Process Summary section

IMS HIGH PERFORMANCE IMAGE COPY               "IMAGE COPY STACKING PROCESS REPORT"                                       PAGE:     1
5655-N45                                                   DATE: 05/12/2020  TIME: 01.10.28                         FABJMAIN - V4.R2
*** STACK DD SUMMARY ***
    STACK     TO BE      PRIMARY/
    DD NAME   RESTARTED  SECONDARY  RELATED DD
    --------  ---------  ---------  --------------------------------------------------
  # STACKDD1  YES        PRIMARY    STK2, STACKDD3
  # STK2      NO         SECONDARY  STACKDD1
  # STACKDD3  YES        SECONDARY  STACKDD1
 NOTE:
 --------
 "#" INDICATES THAT THE DD CONTAINS IMAGE COPY DATA SET(S) WITCH HAVE ALREADY PROCESSED SUCCESSFULLY.
     PLEASE CHANGE TAPE VOLUME(S) WITH MARKED # PRIOR TO NEXT RESTART PROCESS. OTHERWISE, THE IMAGE COPY DATA SET(S) WILL BE
     OVERWRITTEN.

The report fields are as follows:

STACK DD NAME

The DD name for the STACK keyword where the image copies are stacked.

TO BE RESTARTED

This field indicates whether the stack DD is reprocessed or not by the Checkpoint Restart function.

PRIMARY/SECONDARY

This field indicates whether the stacked image copy data set is registered as a primary image copy or a secondary image copy.

PRIMARY: The stack DD is used for the primary image copy.
SECONDARY: The stack DD is used for the secondary image copy.

N/A is shown for the Create Image Copy function.

RELATED DD

A list of DD statements that are related to the DD statement.

If the DD statement is used for the primary image copy, DD statements for its secondary image copies are shown. If the DD statement is used for the secondary image copy, DD statement for its primary DD statement is shown.

The following figure shows an example of the ICEIN statements that are used for the STACK DD Report Summary section of Figure 1.

Figure 2. Sample ICEIN statements for stack processing

//ICEIN

  IC  DBD=DB1,DDN=DBDD1 STACK=(STACKDD1,STK2)
  IC  DBD=DB1,DDN=DBDD1 STACK=(STACKDD1,STACKDD3)
  IC  DBD=DB1,DDN=DBDD1 STACK=STACKDD1
  IC  DBD=DB1,DDN=DBDD1 STACK=(STACKDD1,STACKDD3)

/*

STACK DD Summary section

The STACK DD Summary section shows general information about the STACK DD. This section is provided for each of STACK DD statements processed.

The following figure is an example of the STACK DD Summary section.

Figure 3. STACK DD Summary section

IMS HIGH PERFORMANCE IMAGE COPY               "IMAGE COPY STACKING PROCESS REPORT"                                       PAGE:     1
5655-N45                                                   DATE: 05/12/2020  TIME: 01.10.28                         FABJMAIN - V4.R2
     **************************
     *                        *      
     *   DD NAME : STACKDD1   *
     *                        *
     **************************
     NOTE:  PLEASE CHANGE THE FOLLOWING TAPE VOLUME(S) PRIOR TO NEXT RESTART PROCESS.
            OTHERWISE, THE IMAGE COPY DATA SET(S) WILL BE OVERWRITTEN.
     VOLUME INFORMATION FOR THIS DD
     ------------------------------
       UNIT     = 3490
       VOLSER   = TAPE01

The report fields are as follows:

DD NAME: The DD name on the STACK keyword, where the image copies are stacked.
UNIT: The unit name that is used for stacked image copy processing.
VOLSER: The volume serial name that is used for stacked image copy processing.

STACK DD Detail section

The STACK DD Detail section shows detail information about the STACK DD. This section is provided for each of the STACK DD statements processed.

When an IMS HP Image Copy job is run several times by the Checkpoint Restart function, the tape specified on the STACK DD statement will contain several image copies of databases. However, this section of the report lists only the databases that are processed in one job step, which means the list of databases provided in this section does not include all the databases that are stacked in the tape. If you want to see a complete list of the databases, you must use DITTO or see information about databases that are registered to DBRC.

The following figure is an example of the STACK DD Detail section.

Figure 4. STACK DD Detail section

IMS HIGH PERFORMANCE IMAGE COPY               "IMAGE COPY STACKING PROCESS REPORT"                                       PAGE:     2
5655-N45                                                   DATE: 05/12/2020  TIME: 01.10.28                         FABJMAIN - V4.R2
STACK DD = STACKDD1  (PAGE:     2)
******* STACKED IMAGE COPY DATA SET(S) *******
  DB       PART     DD                                                             CATALOG   TO BE
  NAME     AREA     NAME      IMAGE COPY DATA SET NAME                     FILESEQ STATUS    RESTARTED
  -------- -------- --------  -------------------------------------------- ------- --------- ---------
  DBHDAM10          HDAMDD10  ICSMS1.UGTEST.DBHDAM10.HDAMDD10.IC1                1 CATALOGED
  PHDV0100 PHDV01A  PHDV01AA  ICSMS1.UGTEST.PHDV0100.PHDV01AA.IC1                2 CATALOGED
  DEDBJN23 DB23AR0            ICSMS1.UGTEST.DEDBJN23.DB23AR0.IC1                 3 CATALOGED
  DBHDAM20          HDAMDD20  ICSMS1.UGTEST.DBHDAM20.HDAMDD20.IC1                4 CATALOGED
  HISAM000          HISAM000  ICSMS1.UGTEST.HISAM000.HISAM000.IC1                5 CATALOGED
  HISAM000          HISAM001  ICSMS1.UGTEST.HISAM000.HISAM001.IC1                6 CATALOGED
  DEDBJN23 DB23AR1            ICSMS1.UGTEST.DEDBJN23.DB23AR1.IC1                 7 FAILED    YES

The report fields are as follows:

STACK DD: The DD name on the STACK keyword, where the image copies are stacked.
DB NAME: The name of the processed DBD.
PART AREA: The name of the processed partition name of HALDB or area name of DEDB.
DD NAME: The DD name of the processed database data set.
IMAGE COPY DATA SET NAME: The name of the image copy data set
FILESEQ: The file sequence number of the image copy data set in the tape volume of the STACK DD.
CATALOG STATUS: This field indicates whether the image copy data set is successfully cataloged or not.
TO BE RESTARTED: This field indicates whether the stack DD is reprocessed or not by the Checkpoint Restart function.

Bypassed Databases section

The Bypassed Databases section shows a list of the databases that were not processed in the job.

The following figure is an example of the Bypassed Database section.

Figure 5. Bypassed Databases section

IMS HIGH PERFORMANCE IMAGE COPY               "IMAGE COPY STACKING PROCESS REPORT"                                       PAGE:     3
5655-N45                                                   DATE: 05/12/2020  TIME: 01.10.28                         FABJMAIN - V4.R2
STACK DD = STACKDD1  (PAGE:     3)
******* THE FOLLOWING DATABASE DATA SET(S) WERE TO BE PROCESSED BUT THE PROCESS WAS BYPASSED *******
  DB       PART     DD
  NAME     AREA     NAME
  -------- -------- --------
  DEDBJN23 DB23AR2
  DBHDAM30          HDAMDD30
  PHDV0100 PHDV01B  PHDV01BA

The report fields are as follows:

STACK DD: The DD name on the STACK keyword, where the image copies are stacked.
DB NAME: The name of the processed DBD.
PART AREA: The name of the processed partition name of HALDB or area name of DEDB.
DD NAME: The DD name of the processed database data set.