PI53117: DBD/PSB/ACB REVERSAL PROVIDES DBD OR PSB LIBRARY MEMBER LIST REPORT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides a new function keyword to generate DBD or PSB
  library member list report of DBD/PSB/ACB Reversal.
  
  This enhancement is being implemented as a result of the
  following RFE requirements.
  
   RFE 32445
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS Library Integrity Utilities for z/OS,    *
  *                 Version 2 Release 2 (FMID=H27P220) users     *
  *                 who use the DBD/PSB/ACB Reversal utility.    *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides a new function       *
  *                      keyword to generate DBD or PSB library  *
  *                      member list report of the DBD/PSB/ACB   *
  *                      Reversal utility.                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR enhances the DBD/PSB/ACB Reversal utility to support
  LISTLIB new function control statement. The supported operand
  for this keyword is DBD or PSB. No function keyword options are
  supported for this keyword.
  This keyword specifies to generate the DBD library member list
  report or PSB library member list report in the SYSPRINT data
  set.
  The report lists information for the members found in the data
  sets that are concatenated to DBDLIB DD or PSBLIB DD.
  The information contains IMS version of the DBD or PSB, the
  creation date, time and the size of the member record.
  

Problem conclusion

Temporary fix

Comments

• The following modules and macros have been modified.
  FABNDMY0 FABNWORK FABNCNTL FABNMSGS FABNPDBD FABNPPSB FABNREAD
  FABNTLES
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The documentation "IBM IMS Library Integrity Utilities for z/OS
  V2R2, User's Guide (SC19-3979-01)" is changed.
  ================================================================
  >Chapter 8. DBD/PSB/ACB Reversal utility
  >>DBD/PSB/ACB Reversal utility overview
   The DBD/PSB/ACB Reversal program also generates the following
   reports. These reports represent the information about IMS DBD,
   PSB, and ACB libraries such as DBD/PSB/ACB organization, PCB
   PROCOPT, and relation among members.
  ...
          Unreferenced ACB(DBD) report
  |       DBD library member list report
  |       PSB library member list report
  
  >>Control statements for the DBD/PSB/ACB Reversal utility
  >>>Control statement example
  Figure xx. Control statements for DBD/PSB/ACB Reversal
   //SYSIN DD *
  ...
        UNREF ACB
  |     LISTLIB DBD
  |     LISTLIB PSB
   EOJ
  
  >>>Function control statements
  |  LISTLIB
  |   This keyword specifies to generate the DBD or PSB library
  |   member list report in the SYSPRINT data set. The report
  |   lists information for the members found in the data sets
  |   that are concatenated to DBDLIB DD or PSBLIB DD.
  |   The report contains IMS version of the DBD or PSB, the
  |   creation date, time and the size of the member record.
  
  >>>Quick reference for control statements and DD statements
  Table xx. DBD/PSB/ACB Reversal functions, control statements,
  and DD statements
  
   Function    Control Control Required and optional DD statements
               keyword operand SYS   SYS SYS   DBD PSB DBD PSB ACB
                               PRINT OUT PUNCH SRC SRC LIB LIB LIB
   ----------- ------- ------- ----- --- ----- --- --- --- --- ---
  |DBD library LISTLIB DBD     R     R                 R
  |member list
  |PSB library LISTLIB PSB     R     R                     R
  |member list
  
   MAP SYS OPT
   OUT IN  PRT
   --- --- ---
  |    R
  |
  |    R
  |
  
  >>Output from the DBD/PSB/ACB Reversal utility
  >>> SYSPRINT data set
  |DBD library member list report
  |PSB library member list report
  |
  | If a LISTLIB DBD control statement is specified, DBD library
  | member list report is generated. If a LISTLIB PSB control
  | statement is specified, PSB library member list report is
  | generated.
  | The report lists information for the members found in the
  | data sets that are concatenated to DBDLIB DD or PSBLIB DD.
  | The information contains IMS version of the DBD or PSB,
  | the creation date, time and the size of the member record.
  
  >Chapter 14. Troubleshooting
  >> IMS Library Integrity Utilities messages
  >>> FABN messages
  | FABN0083W NO OPTIONS ALLOWED FOR control statement
  |
    Explanation: Function keyword options, such as ALL, INCLUDE=,
                 EXCLUDE=, and so on, are not supported for the
  |              UNREF ACB, LISTLIB DBD or LISTLIB PSB statement.
    System action: The DBD/PSB/ACB Reversal utility ignores the
  |              UNREF ACB, LISTLIB DBD or LISTLIB PSB control
                 statement and continues processing.
    User response:  Remove the function keyword options from the
  |              UNREF ACB, LISTLIB DBD or LISTLIB PSB control
                 statement and rerun the utility.
  

APAR Information

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

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

  UI34295

Modules/Macros

• FABNCNTL FABNMSGS FABNPDBD FABNPPSB FABNREAD
  FABNTLES
  

Fix information

• Fixed component name

  IMS LIBR INTEG

• Fixed component ID

  5655I4200

Applicable component levels

• R220 PSY UI34295

     UP16/01/09 P F601

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.