Input File report

Edit online

The Input File report provides segment counts and area totals by the input file ddname.

File totals of each area and a database file total are also provided. The area totals should match the area totals in the Reloaded report. The database file total should match the preceding database total in the Reloaded report.

In the Unload process, 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 RELOAD command.

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 an example of the Input File report.

Figure 1. Input File report for Reload 
IMS HPFP UTILITIES - FPA RELOAD                           "Input file report"                                          PAGE:       5
5698-FPP V2R1                                                                                                    2021-11-22 18:59:47
    
    
 SEGMENT TOTALS BY INPUT FILE :
    
   - FILE DDNAME: IAREA001  DSNAME: HPFP.HFPUSR.DB21AR0
          (JCL DD ALLOCATION)
   - AREA NO:     1  AREANAME: DB21AR0
    
           SEGMENT  SEGMENT   SEGMENT          SEGMENTS    SEGMENTS    SKIPPED BY
           CODE     NAME      HIERARCHY        READ        RELOADED    KEY ERROR
           -------  --------  ---------------- ----------- ----------- -----------
                 1  ROOTSEG1  1                    250,000     250,000           0
                 2  SDEPSEG1   2                   500,000     500,000           0 (SDEP=LOGICAL)
                 3  DD102      2                   250,000     250,000           0
                 4  DD202      2                   750,000     750,000           0
                 5  DD302      2                   500,000     500,000           0
                 6  DD303       3                  500,000     500,000           0
    
           -----------------------------------------------------------------------
           **  TOTAL  **                         2,750,000   2,750,000           0
   
   - FILE DDNAME: IAREA001 TOTAL
    
           SEGMENT  SEGMENT   SEGMENT          SEGMENTS    SEGMENTS    SKIPPED BY
           CODE     NAME      HIERARCHY        READ        RELOADED    KEY ERROR
           -------  --------  ---------------- ----------- ----------- -----------
                 1  ROOTSEG1  1                    250,000     250,000           0
                 2  SDEPSEG1   2                   500,000     500,000           0 (SDEP=LOGICAL)
                 3  DD102      2                   250,000     250,000           0
                 4  DD202      2                   750,000     750,000           0
                 5  DD302      2                   500,000     500,000           0
                 6  DD303       3                  500,000     500,000           0
    
           -----------------------------------------------------------------------
           **  TOTAL  **                         2,750,000   2,750,000           0
    
           -----------------------------------------------------------------------
           *** FILE TOTAL ***                    2,750,000   2,750,000           0
FILE DDNAME
The input file DDNAME with the following information:
  • (DYNAMIC ALLOCATION): DDNAME is allocated dynamically.
  • (JCL DD ALLOCATION): DDNAME is specified on the JCL statement.
DSNAME
The DSNAME of the input file DDNAME.

When USR files are specified as concatenated in a Reload process, only the name of the first data set of all that are concatenated is printed in DSNAME.

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 READ
The number of segments read.
SEGMENTS RELOADED
The number of segments reloaded.
SKIPPED BY KEY ERROR
The number of segments skipped by the key sequence error.
SDEP PROCESS
  • (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.

In addition, the following four lines of text might be printed in FILE DDNAME TOTAL.

  • (SDEP=LOGICAL,PHYSICAL,NO) is printed after the number when the USR file consists of files that are processed with SDEP=LOGICAL, SDEP=PHYSICAL, and SDEP=NO.
  • (SDEP=LOGICAL,PHYSICAL) is printed after the number when the USR file consists of files that are processed with SDEP=LOGICAL and SDEP=PHYSICAL.
  • (SDEP=LOGICAL,NO) is printed after the number when the USR file consists of files that are processed with SDEP=LOGICAL and SDEP=NO.
  • (SDEP=PHYSICAL,NO) is printed after the number when the USR file consists of files that are processed SDEP=PHYSICAL and SDEP=NO.
FILE DDNAME TOTAL
The total number of segments that were read from the input file for the database.
NO RECORDS FOR RELOAD AREAS SPECIFIED BY OAREA= KEYWORD ARE FOUND
Records for the area that is specified by the OAREA keyword are not found in the USR file.
NO RECORDS FOR RELOAD AREAS ARE PROCESSED (THE SAME INPUT FILE WAS PROCESSED BY ANOTHER INPUT DD)
The USR file was specified and has been processed by another DD statement. No records for the reloaded areas are processed for the USR file.
RECORDS FOR SAME RELOAD AREA WERE ALREADY PROCESSED BY DIFFERENT UNLOADED SEGMENT RECORD FILE
The USR file was specified for reloading a specific area, but the area was already reloaded by different USR files.
NO AREA INFORMATION RECORD WAS FOUND IN THIS USR FILE
The first record of the USR file is not an area information record.
UNLOADED SEGMENT RECORDS WITH SDEP=PHYSICAL ACCOMPANIED BY DBD CHANGE DETECTED
The USR file was created with SDEP=PHYSICAL and in a different DBD structure.