Output File report

The Output File report provides segment counts and area totals by the output file ddname.

File totals of each area and a database file total are also provided.

For UNLOAD commands, the area totals should match the area totals in the Reloaded report. The database file total should match the two preceding database file totals in the Unloaded report and the Reloaded report.

If FILECTL statements are not used (that is, ddnames default to area numbers), there is only one area per file. Conversely, if FILECTL statements are used, a file might contain data for more than one area.

This report is generated by the following commands:

  • EXTRACT
  • UNLOAD

This report is not printed if you make one of the following specifications:

  • GLOBAL SCAN=YES
  • GLOBAL SCAN=SITE_CREATE
  • GLOBAL SCAN=SITE_REPORT

The following figure is a sample of the Output File report for Unload.

Figure 1. Output File report for Unload
IMS HPFP UTILITIES - FPA UNLOAD                           "Output file report"                                         PAGE:       7
5698-FPP V2R1                                                                                                    2021-11-22 17:26:45
    
    
 SEGMENT TOTALS BY OUTPUT FILE:
    
   - FILE DDNAME: OAREA001  DSNAME: HPFP.FFPUSR.DB21AR0
          (JCL DD ALLOCATION)
   - AREA NO:     1  AREANAME: DB21AR0

           SEGMENT  SEGMENT   SEGMENT          SEGMENTS
           CODE     NAME      HIERARCHY        WRITTEN
           -------  --------  ---------------- -----------
                 1  ROOTSEG1  1                    250,000
                 2  SDEPSEG1   2                   500,000  (SDEP=LOGICAL)
                 3  DD102      2                   250,000
                 4  DD202      2                   750,000
                 5  DD302      2                   500,000
                 6  DD303       3                  500,000
    
           -----------------------------------------------------
           **  TOTAL  **                         2,750,000
    
   - FILE DDNAME: OAREA001 TOTAL
    
           SEGMENT  SEGMENT   SEGMENT          SEGMENTS
           CODE     NAME      HIERARCHY        WRITTEN
           -------  --------  ---------------- -----------
                 1  ROOTSEG1  1                    250,000
                 2  SDEPSEG1   2                   500,000  (SDEP=LOGICAL)
                 3  DD102      2                   250,000
                 4  DD202      2                   750,000
                 5  DD302      2                   500,000
                 6  DD303       3                  500,000
    
           -----------------------------------------------------
           **  TOTAL  **                         2,750,000

           -----------------------------------------------------
           *** FILE TOTAL ***                    2,750,000

The following figure is a sample of the Output File report for Unload when ACBCHK=YES is specified.

Figure 2. Output File report for Unload when ACBCHK=YES is specified
IMS HPFP UTILITIES - FPA UNLOAD                           "Output file report"                                         PAGE:       4
5698-FPP V2R1                                                                                                    2021-11-22 18:07:59
 SEGMENT TOTALS BY OUTPUT FILE:

   - FILE DDNAME: OAREA001  DSNAME: FPTL02.DBTJIE1.PM23240.OAREA001
          (JCL DD ALLOCATION)
   - AREA NO:     1  AREANAME: DB23AR1

           SEGMENT  SEGMENT   SEGMENT          SEGMENTS
           CODE     NAME      HIERARCHY        WRITTEN
           -------  --------  ---------------- -----------
                 1  ROOTSEG1  1                         62
                 2  SDEPSEG1   2                        18  (SDEP=LOGICAL)
                 3  DD1        2                        64
                 4  DD11        3                       44
                 5  DD2        2                        60
                 6  DD21        3                      102
                 7  DD211        4                     106
                 8  DD212        4                      14
                 9  DD2121        5                    126
           -----------------------------------------------------
           **  TOTAL  **                               596
   - FILE DDNAME: OAREA001 TOTAL

           DBD INFORMATION RECORDS:      4

           SEGMENT  SEGMENT   SEGMENT          SEGMENTS
           CODE     NAME      HIERARCHY        WRITTEN
           -------  --------  ---------------- -----------
                 1  ROOTSEG1  1                         62
                 2  SDEPSEG1   2                        18  (SDEP=LOGICAL)
                 3  DD1        2                        64
                 4  DD11        3                       44
                 5  DD2        2                        60
                 6  DD21        3                      102
                 7  DD211        4                     106
                 8  DD212        4                      14
                 9  DD2121        5                    126
           -----------------------------------------------------
           **  TOTAL  **                               596
           -----------------------------------------------------
           *** FILE TOTAL ***                          596

The following figure is a sample of the Output File report for Extract.

Figure 3. Output File report for Extract
IMS HPFP UTILITIES - FPA EXTRACT                          "Output file report"                                         PAGE:       5
5698-FPP V2R1                                                                                                    2021-11-22 18:59:40
    
    
 SEGMENT TOTALS BY OUTPUT FILE:
    
   - FILE DDNAME: OAREA001  DSNAME: HPFP.FFPUSR.DB21AR0
          (JCL DD ALLOCATION)
   - AREA NO:     1  AREANAME: DB21AR0

           SEGMENT  SEGMENT   SEGMENT          SEGMENTS
           CODE     NAME      HIERARCHY        WRITTEN
           -------  --------  ---------------- -----------
                 1  ROOTSEG1  1                    250,000
                 2  SDEPSEG1   2                   500,000  
                 3  DD102      2                   250,000
                 4  DD202      2                   750,000
                 5  DD302      2                   500,000
                 6  DD303       3                  500,000
    
           -----------------------------------------------------
           **  TOTAL  **                         2,750,000
    
   - FILE DDNAME: OAREA001 TOTAL
    
           SEGMENT  SEGMENT   SEGMENT          SEGMENTS
           CODE     NAME      HIERARCHY        WRITTEN
           -------  --------  ---------------- -----------
                 1  ROOTSEG1  1                    250,000
                 2  SDEPSEG1   2                   500,000  
                 3  DD102      2                   250,000
                 4  DD202      2                   750,000
                 5  DD302      2                   500,000
                 6  DD303       3                  500,000
    
           -----------------------------------------------------
           **  TOTAL  **                         2,750,000
    
           -----------------------------------------------------
           *** FILE TOTAL ***                    2,750,000
FILE DDNAME
The output file DDNAME with the following information:
  • (DYNAMIC ALLOCATION): DDNAME is allocated dynamically.
  • (JCL DD ALLOCATION): DDNAME is specified in the JCL statement.
DSNAME
The DSNAME of the output file DDNAME.
AREA NO
The area number.
AREANAME
The area name.
SEGMENT CODE
The segment code.
SEGMENT NAME
The segment name.
SEGMENT HIERARCHY
The segment hierarchy.
SEGMENTS WRITTEN
The number of segments that were written into the output file.
SDEP PROCESS
The SDEP process option. This item is not printed for the EXTRACT command.
  • (SDEP=PHYSICAL) is printed after the number when SDEP=PHYSICAL is specified.
  • (SDEP=LOGICAL) is printed after the number when SDEP=LOGICAL is specified.
  • (SDEP=NO) is printed after the number when SDEP=NO is specified.
FILE DDNAME TOTAL
The total number of segments that were written into the output file for the database.
DBD INFORMATION RECORDS
The number of DBD information records that were written into the USR file by the Unload process when ACBCHK=YES is specified.