PK70285: SAMPLIB MEMBER ARY#VOLS IS INCORRECT AND NOT DOCUMENTED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• There isn't much documentation for samplib member ARY#VOLS.
  This program (ARY#VOLS) obtains the backup volumes associated
  with a particular backup.  It takes as input a DB2 SSID and an
  RBA and finds the backup closest to that RBA and returns the
  volumes associated with that backup in a file.
  
  In addition the following DD statements in the job are not
  correct:
  
  //RBRSBACK DD DISP=SHR,DSN=DATALVL.SYSBACK
  //RBRSBVOL DD DISP=SHR,DSN=DATALVL.SYSBACK.VOLS
  //RBRSBSSD DD DISP=SHR,DSN=DATALVL.SYSBACK.SSIDS
  
  The statements should be:
  
  //ARYSBACK DD DISP=SHR,DSN=DATALVL.SYSBACK
  //ARYSBVOL DD DISP=SHR,DSN=DATALVL.SYSBACK.VOLS
  //ARYSBSSD DD DISP=SHR,DSN=DATALVL.SYSBACK.SSIDS
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of DB2 Recovery Expert Z/OS.           *
  ****************************************************************
  * PROBLEM DESCRIPTION: There isn't much documentation for      *
  *                      samplib member ARY#VOLS. This program   *
  *                      (ARY#VOLS) obtains the backup volumes   *
  *                      associated with a particular backup.    *
  *                      It takes as input a DB2 SSID and an     *
  *                      RBA and finds the backup closest to     *
  *                      that RBA and returns the volumes        *
  *                      associated with that backup in a file.  *
  *                      In addition the following DD            *
  *                      statements in the job are not           *
  *                      correct:                                *
  *                      //RBRSBACK DD DISP=SHR,                 *
  *                       DSN=DATALVL.SYSBACK                    *
  *                      //RBRSBVOL DD DISP=SHR,                 *
  *                       DSN=DATALVL.SYSBACK.VOLS               *
  *                      //RBRSBSSD DD DISP=SHR,                 *
  *                       DSN=DATALVL.SYSBACK.SSIDS              *
  *                      The statements should be:               *
  *                      //ARYSBACK DD DISP=SHR,                 *
  *                       DSN=DATALVL.SYSBACK                    *
  *                      //ARYSBVOL DD DISP=SHR,                 *
  *                       DSN=DATALVL.SYSBACK.VOLS               *
  *                      //ARYSBSSD DD DISP=SHR,                 *
  *                       DSN=DATALVL.SYSBACK.SSIDS              *
  ****************************************************************
  * RECOMMENDATION: APPLY the PTF.                               *
  ****************************************************************
  Code has been changed to correct this condition.
  

Problem conclusion

• APPLY the PTF.
  

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

•    ARY$MAIN
  

Fix information

• Fixed component name

  DB2 REC EXPERT

• Fixed component ID

  5697H7400

Applicable component levels

• R210 PSY UK39495

     UP08/09/10 P F809

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.