PM96199: IMPROVE ERROR HANDLING IN CLIST ADBR WITH "SYSTEM PROGRAMMER RESPONSE" INFORMATION WHEN RC=20 IS ISSUED AGAINST ADB2INC.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The following Dialog Error/Message was received from the
  initialization process upon invocation of DB2 Admin Tool via
  ADBL->ADB->ADBR:
  Function: ADBR SELECT CMD(ADB2INC ,AUTH,,SSID(DBU1)) MODE(FSCR)
  Retcode: 20
  Zerrmsg:
  Zerrsm:  DSN3@ATH failed
  Zerrlm:  The call to DSN3@ATH failed
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of the DB2 Administration Tool for     *
  *                 z/OS and IBM Tools Customizer for z/OS.      *
  ****************************************************************
  * PROBLEM DESCRIPTION: If the following conditions are met:    *
  *                                                              *
  *                      1. CA ACF2 security product is used     *
  *                         instead of RACF.                     *
  *                                                              *
  *                      2. The following settings are used on   *
  *                      panel CCQPPRD 'Product Parameters':     *
  *                                                              *
  *                      Type of DB2 security exit  . . AUTH     *
  *                      DB2 Admin APF library .  _ <==blank     *
  *                                                              *
  *                      then the invocation of DB2 Admin        *
  *                      will display the following erroneous /  *
  *                      misleading error message:               *
  *                                                              *
  *                      Function: ADBR SELECT                   *
  *                      CMD(ADB2INC ,AUTH,,SSID(DBU1))          *
  *                      MODE(FSCR)                              *
  *                      Retcode: 20                             *
  *                      Zerrmsg:                                *
  *                      Zerrsm:  DSN3@ATH failed                *
  *                      Zerrlm:  The call to DSN3@ATH failed    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  If the following conditions are met:
  
  1. CA ACF2 security product is used instead of RACF.
  
  2. The following settings are used on panel CCQPPRD 'Product
  Parameters':
  
  Type of DB2 security exit  . . AUTH
  DB2 Admin APF library . . . . _____ <=== blank
  
  then the invocation of DB2 Admin will display the following
  erroneous / misleading error message:
  
  Function: ADBR SELECT
  CMD(ADB2INC ,AUTH,,SSID(DBU1))
  MODE(FSCR)
  Retcode: 20
  Zerrmsg:
  Zerrsm:  DSN3@ATH failed
  Zerrlm:  The call to DSN3@ATH failed
  

Problem conclusion

• Problem has been resolved.
  The following error message will now be issued:
  
  Function : ADBR SELECT CMD(ADB2INC ,STD,SY4A,SSID(DSNB))
             MODE(FSCR)
  Retcode  : 20
  Zerrmsg  :
  Zerrsm   : RACF security product is not available or not
             installed.
  Zerrlm   : DB2 Admin Tool administrator response: Check
             security product.
             If CA ACF2 security is used, follow the steps
             from this link:
             http://www-01.ibm.com/support/
             docview.wss?uid=swg2142
  

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:

  UI29948

Modules/Macros

• ADBEDIAG ADBR
  

Fix information

• Fixed component name

  DB2 ADMIN TOOL

• Fixed component ID

  568851500

Applicable component levels

• RB10 PSY UI29948

     UP15/08/06 P F508

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.