PI26090: ADD ERROR MESSAGE ADB5263E IN JOB LOG DD SYSPRINT FOR APF FAILURE.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Add error message ADB5263E / msgadb5263e in the job log DD
  SYSPRINT to provide more information to the user regarding the
  reason for APF failure:
  ADBT015I  Failure attempting to execute   ADB2UTIL  with parm
  DSNR,IC000001,,
                       1888
  Authority problem with  ADB2UTIL
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of the DB2 Administration Tool for     *
  *                 z/OS and DB2 Object Comparison Tool for      *
  *                 z/OS who use the Batch Restart Program       *
  *                 ADBTEP2 to execute utility commands.         *
  ****************************************************************
  * PROBLEM DESCRIPTION: The error message and User Response     *
  *                      information in the DB2 Administration   *
  *                      Tool for z/OS User's Guide and          *
  *                      Reference are not sufficient to         *
  *                      troubleshoot the problem when a         *
  *                      user's job fails due to an Authorized   *
  *                      Program Facility (APF) authorization    *
  *                      error ADBT0151I / msgadbt0151i:         *
  *                                                              *
  *                      ADBT015I  Failure attempting to         *
  *                      execute ADB2UTIL with parm              *
  *                      DSNR,IC000001,,                         *
  *                                  1888                        *
  *                              Authority problem with          *
  *                              ADB2UTIL                        *
  *                              Ensure                          *
  *                              SYS1.PARMLIB(IKJTSOxx)          *
  *                              has entries for  ADB2UTIL       *
  *                              and the program resides in      *
  *                              an APF authorized library.      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The error message and User Response information in the DB2
  Administration Tool for z/OS User's Guide and Reference are
  not sufficient to troubleshoot the problem when a user's job
  fails due to an Authorized Program Facility (APF) authorization
  error ADBT0151I / msgadbt0151i:
  
  ADBT015I  Failure attempting to execute   ADB2UTIL  with parm
  DSNR,IC000001,,
          1888
    Authority problem with ADB2UTIL
    Ensure SYS1.PARMLIB(IKJTSOxx)
    has entries for  ADB2UTIL and the program resides in
    an APF authorized library.
  

Problem conclusion

• In addition to the informational message ADBT015I, error
  message ADB5263E / msgadb5263e will be displayed.
  
  Error message ADB5263E / msgadb5263e in the DB2 Administration
  Tool for z/OS User's Guide and Reference has been updated with
  possible check points to review the APF settings.
  
  ADB5263E
  The program program_name invocation was not from an authorized
  program facility (APF) library.
  
  Explanation
  Only load modules from an APF task can invoke the APF
  protected supervisor calls (SVCs).
  
  System action
  Processing stops.
  
  User response
  Ensure that the program is APF authorized by making changes
  to meet the following conditions:
  - The steplib data set name matches the data set name in the
    APF list.
  - Each data set in the concatenation is APF authorized.
  - The APF list specifies the correct volid.
  - When SMS is specified as the volid in the APF list, the
    volume shown in the LISTC output is SMS managed.
  - The required module names are listed in the output from
    PARMLIB.
  

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:

Modules/Macros

•    ADBTEP2  ADB5000
  

Fix information

• Fixed component name

  DB2 ADMIN TOOL

• Fixed component ID

  568851500

Applicable component levels

• RB10 PSY UI22966

     UP14/11/18 P F411

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.