PI45877: DB2 ADMIN TOOL PANEL ADB2UPA, USER SETS THE MAXERRORS TO 0 BUT THE VALUE FOR MAXERRORS 0 DOES NOT APPEAR IN ADBTEP2 PARM

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The default value for Maxerrors in ADBTEP2 is 0, but the manual
  and help panel do not mention any default value for Maxerrors.
  And when the user sets the Maxerrors to 0 on the panel ADB2UPA
  the value for Maxerrors does not appear in ADBTEP2 MAXE parm.
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of the DB2 Administration Tool for     *
  *                 z/OS who use the Batch Restart Program       *
  *                 ADBTEP2.                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: When setting the 'Maxerrors' value      *
  *                      to 0 for ADBTEP2 on panel ADB2UPA       *
  *                      'Batch Job Utility Parameters', the     *
  *                      Maxerrors=0 value does not appear in    *
  *                      the ADBTEP2 MAXE parameter list         *
  *                      causing users to think the default      *
  *                      value for Maxerrors is -1. The DB2      *
  *                      Administration Tool for z/OS User's     *
  *                      Guide and Reference does not mention    *
  *                      a default value for the Maxerrors       *
  *                      option.                                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When setting the 'Maxerrors' value to 0 for ADBTEP2 on panel
  ADB2UPA 'Batch Job Utility Parameters', the Maxerrors=0 value
  does not appear in the ADBTEP2 MAXE parameter list causing
  the user to think the default value for 'Maxerrors' is -1.
  The DB2 Administration Tool for z/OS User's Guide and
  Reference does not mention a default value for the 'Maxerrors'
  option.
  

Problem conclusion

• The problem has been resolved. The help panel ADBHUPA 'DB2
  Batch Job Utility Parameters' has been updated to specify
  the default value:
  
  The value for maxerrors specifies the number of DSN commands
  that can fail before the ADBTEP2 processing is stopped:
  
      -1  All DSN errors are ignored.  The job is not stopped
          for any error.
       0  No DSN errors are ignored. The job is stopped on the
          first error.  This is the default value.
  
  The DB2 Administration Tool for z/OS User's Guide and
  Reference for Version 10, Release 2, and Version 11,
  Release 1 has been updated:
  
  Chapter 15:  Running DB2 utilities
                  >Using table space utilities>
                      Changing batch job utility parameters
  
  ADBTEP2: Maxerrors
  The number of DSN commands that can fail before the batch
  restart job ADBTEP2 is stopped:
  -1
  All errors are ignored. The batch job is not stopped for any
  error.
  0
  No errors are allowed. The batch job is stopped on the first
  error.  This is the default value.
  

Temporary fix

Comments

APAR Information

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

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

  UI31530 UI31531

Modules/Macros

• ADBHUPA
  

Fix information

• Fixed component name

  DB2 ADMIN TOOL

• Fixed component ID

  568851500

Applicable component levels

• RA20 PSY UI31530

     UP15/10/01 P F509

• RB10 PSY UI31531

     UP15/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.