PK12257: HP LOAD CHECKS IF DATABASE WAS UPDATED BETWEEN UNLOAD AND RELOAD

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• A new option is provided to let HP Load do a check against
  DBRC to see whether an update of the database has been done
  between unload and reload.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM IMS High Performance        *
  *                 Load for OS/390 Version 2 Release 1          *
  *                 (FMID=H1IM210)                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: A new option CHKUPDT= is provided to    *
  *                      let HP Load do a check against DBRC to  *
  *                      see whether an update of the database   *
  *                      has been done between unload and        *
  *                      reload.                                 *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides HP Load with the capability to do a check
  against DBRC to see whether an update of the database has been
  done between unload and reload. This would prevent accidental
  reorg back-leveling.
  

Problem conclusion

Temporary fix

Comments

• A new control statement CHKUPDT= is added to let HP Load to do
  a check against DBRC to see whether an update of the database
  has been done between unload and reload. With this control
  statement you can also specify to let the HP Load job continue
  processing or abnormally terminate after finding the update
  between unload and reload.
  
  The check for an update requires an unload time stamp in the
  unloaded data set. You need to use High Performance Unload
  FABHURG1 utility with the CHECKREC YES option to create a
  time stamp in the unloaded data set. To use the CHECKREC YES
  option in High Performance Unload FABHURG1 jobs, you need
  High Performance Unload APAR PK11534.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  High Performance Load for z/OS Version 2 Release 1 User's Guide
  (Document Number:SC18-9222-00) should be updated with following
  changes:
  
  ---------------------------------------
  Part2. High Performance Load
    Chapter 3 Operating instructions.
      Control Statements
  ---------------------------------------
  
  (The following section should be added.)
  
  CHKUPDT Control Statement
    Specifies whether you want to make HP Load check against DBRC
    to see if an update of the database has been done between
    unload and reload.
  
    The control statement is optional. If you do not explicitly
    specify this control statement, CHKUPDT=NO will be used.
  
    +---------------------------------------------------------+
    |                                                         |
    |                  +--NO------------------+               |
    |                  |                      |               |
    |                  |       +-,ABEND-+     |               |
    |                  |       |        |     |               |
    |  >>-CHKUPDT= ----+--YES--+-,WARN--+-----+----------><   |
    |                                                         |
    +---------------------------------------------------------+
     NO
        Specifies that update not be checked.
  
     YES
        Specifies that update between unload and reload be
        checked.
  
        ABEND
          Specifies that High Performance Load to abnormally
          end when an update is found. If you specify
          CHKUPDT=YES only, CHKUPDT=YES,ABEND is assumed.
  
        WARN
          Specifies that High Performance Load to continue
          processing with setting the job step return code
          to 4 when an update is found.
  
     The CHKUPDT control statement is not valid when you use
     the Load API.
  
     The check against DBRC for an update is activated when
     all of the following conditions are met:
  
        - DBRC is active
        - Database and Database data sets are registered to
          DBRC
        - The unloaded data set was created by the High
          Performance Unload FABHURG1 utility with the CHECKREC
          YES option.
  
  ---------------------------------------
  Appendix C. Message and Codes
    Return Codes
      High Performance Load Return Codes
  ---------------------------------------
  
  (The following description for the return code 4, the reason
  code X'0400' should be added.)
  
     Return code: 4 Reason code: X'0400'
     Meaning:
       An update between unload and reload was found, but
       processing continued by the specification of
       CHECKUPDT=YES,WARN.
  
  ---------------------------------------
  Appendix C. Message and Codes
    Messages
      High Performance Load Messages
  ---------------------------------------
  
  (The following description for four new messages should be
  added.)
  
  HPSR3746I ALLOC RECORD FOUND FOR DBD: dbdname DDN: ddname
            TIMESTAMP: yyyydddhhmmsst
  
  Explanation:
    An ALLOC record was found for the database dbdname DD name
    ddname with the time stamp yyyydddhhmmsst which was newer
    than that of the unloaded data set creation.
  System Action:
    Processing continues.
  Programmer Response:
    None
  Problem Determination:
    None
  
  HPSR3747E ABEND REQUESTED BY UPDATE CHECK PROCESS
  
  Explanation:
    An ALLOC record was found for the database with the time
    stamp newer than that of the unloaded data set creation.
    The job step ended abnormally as requested by the CHKUPDT
    control statement.
  System Action:
    HP Load issues a user 3747 dump and a dump.
  Programmer Response:
    Check if you use a back level unloaded data set mistakenly.
    Correct the error and rerun the job.
  Problem Determination:
    None
  
  HPSR3748I UPDATE CHECK NOT PROCESSED. REASON CODE: rr
  
  Explanation:
    A check against DBRC for an update between unload and reload
    will not be processed. Reason code is rr:
  
    Reason Code Explanation
    ----------- -------------------------------------------------
    01          DBRC is not active
    02          DBDS record is not registered to DBRC RECON
    03          Format of unloaded data set is not either of HD,
                SH, or PHD
    04          Times tamp was not found in the unloaded data set
  
  System Action:
    Processing continues. No check will be performed for
    an update between unload and reload.
  Programmer Response:
    If you want to check for an update, correct the error and
    rerun the job.
  Problem Determination:
    None
  
  HPSR3749E AN INTERNAL dbrccmd  COMMAND FAILURE OCCURRED. RC: rr
  
  Explanation:
    An internal DBRC command dbrccmd failed with return code rr.
  System Action:
    HP Load issues a user 3749 dump and a dump.
  Programmer Response:
    Correct the error and rerun the job.
  Problem Determination:
    None
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK07730

Modules/Macros

•    FABFLINK FABFLIST FABSPE15 FABSRT15 FABULIST
  FABUPREF HPSCOPTD HPSRDSCT HPSRHDB7 HPSRHDB8 HPSRHDB9 HPSRHDLD
  HPSRHDL7 HPSRHDL8 HPSRHDL9 HPSRHRPT HPSRHRP7 HPSRHRP8 HPSRHRP9
  HPSRHSLD HPSRHSL7 HPSRHSL8 HPSRHSL9 HPSRHTBL HPSRMSGT HPSROCAT
  HPSRRLDM HPSRRLD7 HPSRRLD8 HPSRRLD9 HPSRRRIN HPSRRRI0 HPSRRRI9
  HPSRRXRT HPSRSRT0 HPSRSTMT H1IM210J
  

Fix information

• Fixed component name

  IMS HIGH PERF L

• Fixed component ID

  5655E0700

Applicable component levels

• R210 PSY UK07730

     UP05/10/01 P F509

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.