PI74209: PARAMETER IGNORED AND NOT FLAGGED IF INCORRECTLY PLACED UNDER DD ADBTEPIN

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• If a parameter that belongs under SYSTSIN DD (such as
  Maxerrors) is placed instead under ADBTEPIN DD, the job ends
  with RC=0 (and the parameter is ignored), instead of ending
  with RC>4.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of DB2 Administration Tool for z/OS    *
  *                 who execute the Batch Restart job ADBTEP2.   *
  ****************************************************************
  * PROBLEM DESCRIPTION: When invalid parameters are specified   *
  *                      or an invalid value is specified for    *
  *                      parameter BINDERROR under the ADBTEPIN  *
  *                      DD card, the Batch Restart job ADBTEP2  *
  *                      fails and the message issued is not     *
  *                      helpful.                                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When invalid parameters are specified or an invalid value is
  specified for parameter BINDERROR under the ADBTEPIN DD card,
  the Batch Restart job ADBTEP2 fails with RC=12 / RC12 and the
  message issued is not helpful, for example:
  
     8 returned from DSN
     Treating as severe error, possible ABEND: 8
  

Problem conclusion

• 1. The ADBTEP2 batch job will issue a new error message
  ADB5700E / msgadb5700e and stop processing with a return
  code RC=8 / RC8 when an invalid parameters are specified
  under the ADBTEPIN DD card:
  
  ADB5700E Unrecognized parameter in the
           ADBTEPIN DD card:
           parameter_name
  
  Explanation: An invalid parameter name was specified
               in the ADBTEPIN DD card.
  System action: Processing stops.
  User response: Remove or correct the invalid parameter
                 name and resubmit the job.
  
  2. The ADBTEP2 batch job will issue a new error message
  ADB5701E / msgadb5701e and stop processing with a
  return code RC=8 / RC8 when an invalid value is specified
  for parameter BINDERROR under the ADBTEPIN DD card:
  
  ADB5701E Invalid value for parameter BINDERROR
           in the ADBTEPIN DD card: parameter_value.
           Valid values are MAXE, SAVE and IGNORE.
           If MAXE is specified, the value n that is
           specified for MAXE(n) parameter in the
           PARMS field of the DB2 RUN statement
           determines the number of DSN commands
           that can fail before the batch job is
           terminated.
  Explanation: An invalid value was specified for parameter
               BINDERROR in the ADBTEPIN DD card.
  System action: Processing stops.
  User response: Correct the invalid value and resubmit the
                 job.
  3. ADBTEP2 batch job will issue the existing message
  ADB5000E and stop processing with a return code RC=8 / RC8
  when an invalid value is specified for other parameters except
  BINDERROR under the ADBTEPIN DD card:
  
  ADB5000E An invalid value was specified for parameter
           parameter_name=parameter_value.
  System action: Processing stops.
  User response: Specify a valid value for the parameter.
  
  The following technote contains updated information to
  the DB2 Administration Tool for z/OS, User's Guide:
  
  http://www-01.ibm.com/support/docview.wss?uid=swg22003878
  

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:

  UI47550 UI47551 UI47552

Modules/Macros

•    ADBTEP2  ADB5000
  

Fix information

• Fixed component name

  DB2 ADMIN TOOL

• Fixed component ID

  568851500

Applicable component levels

• RB10 PSY UI47550

     UP17/06/06 P F706

• RB20 PSY UI47551

     UP17/06/06 P F706

• RC10 PSY UI47552

     UP17/06/06 P F706

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.