PI14951: PROVIDE A NEW CONTROL STATEMENT FOR IPR RELOAD UTILITY TO CHECK IF AN INPUT UNLOADED DATA SET IS EMPTY.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Provide a new control statement for IPR Reload utility to check
  if an input unloaded data set is empty and if so, set a return
  code.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Database Reorganization     *
  *                 Expert for z/OS Version 4 Release 1          *
  *                 (FMID=H25N410).                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides a new control        *
  *                      statement for IPR Reload utility to     *
  *                      check if an input unloaded data set is  *
  *                      empty and if so, set a return code.     *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides a new control statement for IPR Reload
  utility to check if an input unloaded data set is empty
  and if so, set a return code.
  
  To use the new function, the following maintenance is required:
   - APAR PI14950 for IMS High Performance Load (FMID=H1IM210)
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS Database Reorganization Expert for z/OS Version 4 Release 1
  User's Guide SC19-1137-03 ( SC19113703 ) should be changed as
  follows:
  ================================================================
  
  > Reloading a database
  >> IPR Reload JCL statements
  >>> Control statements
  
  |  CHKEMPTYUL control statement
  |
  |  Specifies whether to check if the unloaded data set contains
  |  segment data. Also, specifies the return code that is set
  |  when no segment data is found in the unloaded data set.
  |
  |  If DUMMY is specified on the DFSUINPT DD statement, this
  |  check is not applicable.
  |
  |  This control statement is optional. If you do not explicitly
  |  specify this control statement, CHKEMPTYUL=YES,WARN,4 will
  |  be used.
  |     _________________________________________________________
  |    |                                                         |
  |    |                   __ YES,WARN,4_____________            |
  |    |                  |                _,4___    |           |
  |    |                  |        _,WARN_|______|_  |           |
  |    |                  |       |       |_,n___| | |           |
  |    | >>__CHKEMPTYUL=__|__ YES_|________________|_|________>< |
  |    |                  |___NO_____________________|           |
  |    |_________________________________________________________|
  |
  |    YES
  |       Specifies to check if segment data exists in the
  |       unloaded data set.
  |
  |       WARN,n
  |          Sets the job step return code to n when the unloaded
  |          data set contains no segment data. For n, specify a
  |          left-aligned decimal number in the range of 1 - 4.
  |
  |       If you specify CHKEMPTYUL=YES or CHKEMPTYUL=YES,WARN
  |       , CHKEMPTYUL=YES,WARN,4 is assumed.
  |
  |    NO
  |       Specifies not to check if segment data exists in the
  |       unloaded data set. The return code is not changed even
  |       if no segment data exists in the unloaded data set.
  |
  |    The return code that you specify with CHKEMPTYUL can be
  |    overridden by a higher return code set for some other
  |    reason.
  |
  |  Tip: The default value of the CHKEMPTYUL control statement
  |  can be changed. For details, see "Setting installation
  |  default options".
  |
  
  > Reference
  >> Setting installation default options
  >>> How to code HPSCOPT macro statements
      :
     ____________________________________________________________
    |                                                            |
    | RELOAD:                                                    |
    |            <_,__________________________________________   |
    | |__RELOAD__ ___________________________________________ |  |
    |            |_ _________________________________________|   |
    |            | |             _(_YES,WARN_)_______  |     |   |
    |            | |            |        _,WARN__    | |     |   |
    |            | |_CHKTRAIL=__|_(_YES_|_,ERROR_|_)_|_|     |   |
    |            |              |___NO_______________|       |   |
    |            |_ _______________________________________ _|   |
    |            | |            _NO______________________  | |   |
    |            | |           |             _ABEND_     | | |   |
    |            | |_CHKUPDT=__|_(__YES__,__|_WARN__|__)_|_| |   |
  | |            |_ _________________________________________|   |
  | |            | |               _(_YES,WARN,4_)__         |   |
  | |            | |_CHKEMPTYUL=__|_(_YES,WARN,n_)__|________|   |
  | |            |                |___NO____________|            |
  
                       :
  ======================= End of Doc-Change ======================
  

APAR Information

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

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

  UI17326

Modules/Macros

• HPSCOPT  HPSCOPTS HPSGOPTR
  

Fix information

• Fixed component name

  IMS DB REORG EX

• Fixed component ID

  5655F7400

Applicable component levels

• R410 PSY UI17326

     UP14/04/26 P F404

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.