PI14950: PROVIDE A NEW CONTROL STATEMENT 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 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 IBM IMS High Performance Load   *
  *                 for z/OS Version 2 Release 1 (FMID=H1IM210). *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides a new control        *
  *                      statement 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 to check if an input
  unloaded data set is empty and if so, set a return code.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = Documentation Change =
  ========================
  IMS High Performance Load for z/OS Version 2 Release 1 User's
  Guide SC18-9222-05 ( SC18922205 ) should be changed as follows:
  ================================================================
    2.1.5   Control statements
  |  2.1.5.x 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".
  |
      :
    6.0     Reference
    6.1     Setting installation default options
    6.1.3   HPSROPT macro statements
       :
     ____________________________________________________________
    |                                                            |
    | RELOAD:                                                    |
    |          <_,_____________________________________________  |
    | |__RELOAD_______________________________________________ |_|
    |            |_ ________________________________________ _|  |
    |            |            _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:

  UI17325

Modules/Macros

• HPSRFCA0 HPSRHALA HPSRHALB HPSRHAL2 HPSRHAL3 HPSRHAL7 HPSRHAL8
  HPSRHAL9 HPSRHDLA HPSRHDLB HPSRHDL2 HPSRHDL3 HPSRHDL7 HPSRHDL8
  HPSRHDL9 HPSRHRPA HPSRHRPB HPSRHRP2 HPSRHRP3 HPSRHRP7 HPSRHRP8
  HPSRHRP9 HPSRHTBL HPSROPT  HPSROPTA HPSROPTS HPSRRPRA HPSRRPRB
  HPSRRPR2 HPSRRPR3 HPSRRPR7 HPSRRPR8 HPSRRPR9 HPSRRRI0 HPSRRRI9
  HPSRSTMT
  

Fix information

• Fixed component name

  IMS HIGH PERF L

• Fixed component ID

  5655E0700

Applicable component levels

• R210 PSY UI17325

     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.