IBM Support

PI50095: DBD/PSB/ACB REVERSAL PROVIDES SEVERAL NEW OPTIONS FOR DECODE FUNCTION

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • This APAR provides a new options of DBD/PSB/ACB Reversal:
    
        Decode option to check DBD or PSB and issue a message if DBD
    or PSB size is unexpected.
        Decode option to print DBDGEN date in VERSION= parameter.
    
    This enhancement is being implemented as a result of the
    following RFE requirements.
    
        RFE 32522
        RFE 68980
        RFE 68981
    

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 new DECOPT options   *
    *                      CHECK_LEN and VERSION_GENDATE           *
    *                      in the DBD/PSB/ACB Reversal utility.    *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    This APAR enhances the DBD/PSB/ACB Reversal utility to support
    the following new options:
    - DECOPT CHECK_LEN
        This option detects DEDB DBD and PSB that are generated by
        non-IMS standard DBDGEN and PSBGEN macros by checking
        the DBD and PSB control blocks conforming to the
        control block length of standard IMS.
        This option is effective for DBDLIB and PSBLIB members,
        but it is not effective for ACBLIB members.
    - DECOPT VERSION_GENDATE
        This option set the IMS DBDGEN date in the VERSION= control
        statement in the decoded DBD source.
        This option is effective for DBDLIB members, but it is not
        effective for ACBLIB members.
    

Problem conclusion

Temporary fix

Comments

  • The following modules and macros have been modified.
    FABNDMY0 FABNSDT FABNWORK FABNDCOD FABNMSGS FABNPDBD FABNPPSB
    FABNREAD FABNTGEN FABNDEDB FABNPCTL
    
    ========================
    = 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
    >>Control statements for the DBD/PSB/ACB Reversal utility
    >>>Runtime option control statements
    
    >>>>DECOPT (DO)
    
    |   CHECK_LEN=
    |    Specifies to detects DEDB DBD and PSB that has not been
    |    generated by IMS standard DBDGEN and PSBGEN.
    |    In case of DBD and PSB being generated by non-IMS macro,
    |    the length of control block does not conform to the
    |    IMS standard control block length.
    |    The CHECK_LEN option checks the control block length to
    |    detect the non-IMS standard DEDB DBD and PSB.
    |    The CHECK_LEN is effective for DBD and PSBLIB members,
    |    but it is not effective for ACBLIB.
    |
    |     YES   Specifies to detect the DBD and PSB was generated
    |           by non-IMS standard macro.
    |           When the non-IMS standard DBD or PSB is detected,
    |           the DBD/PSB/ACB Reversal utility generates only IMS
    |           standard DBD or PSB source code (without non-IMS
    |           MACRO), and notifies a FABN0084W message and
    |           return code 04.
    |           The FABN0084W message is printed in the "Messages"
    |           report in the SYSOUT data set. And, the message is
    |           printed in the comment line in the decoded DBD or
    |           PSB source code if you specify DECOPT COMMENT=YES.
    |
    |     NO    Specified not to check the DBD and PSB control block
    |           length. It is the default value.
    
    |   VERSION_GENDATE=
    |    Specifies to put the DBDGEN date and time in the VERSION=
    |    control statement in the decoded DBD source.
    |    At the time of DBDGEN, a character string could be
    |    specified to the VERSION= control statement, however, if
    |    any character string is not specified, a 13-character time
    |    stamp (GENDATE time stamp) is generated by DBDGEN.
    |    It represents the date and time the DBDGEN was completed.
    |    When VERSION_GENDATE=YES is specified, the GENDATE time
    |    stamp is set in the VERSION= control statement in the
    |    decoded DBD source.
    |
    |    This option is effective only for DBDLIB members, but it
    |    is not effective for ACBLIB.
    |
    |     YES   Specifies to print the GENDATE time stamp to
    |           the VERSION control statement in the decoded DBD
    |           source. The format of time stamp is MM/DD/YYHH.MM.
    |
    |     NO    Specifies not to print the GENDATE time stamp to
    |           the VERSION= control statement in the decoded DBD
    |           source. It is the default value.
    |           When NO is specified, the GENDATE is printed in the
    |           comment area in the VERSION statement.
    |
    |    Note: If you once get the GENDATE time stamp in the VERSION
    |    statement in the DBD source, next time when you perform
    |    DBDGEN, the GENDATE time stamp is not updated to the
    |    latest DBDGEN date and time. It is because IMS DBDGEN
    |    recognizes the 13-character time stamp as a character
    |    string, and does not update the character string.
    |    If you would like to store the latest DBDGEN time stamp
    |    in the DMB, do not specify VERSION_GENDATE=YES.
    
    >>DBD/PSB/ACB Reversal Site Default Generation utility
    
    >>>Control statements for the Reversal Site Default Generation
     utility
    
     available for these control statement keywords.
    
     Table 30. Options for the site default in the SYSIN control
     statement.
      Keyword         Option(abbreviations)    Operand
    
    | DECOPT    CHECK_LEN                      YES or NO
    | DECOPT    VERSION_GENDATE                YES or NO
    
    >Chapter 14. Troubleshooting
    
    >>IMS Library Integrity Utilities messages
    >>>FABN messages
    
    | FABN0084W MEMBER xxxxxxxx WAS NOT GENERATED BY THE IMS
    | STANDARD DBD OR PSB GENERATION MACRO
    |
    | Explanation:
    | The indicated DBD or PSB member does not conform to
    | the non-IMS standard control block length. It means that
    | it was generated by non-IMS standard DBD or PSBGEN.
    | System action: The DBD/PSB/ACB Reversal utility continues
    |                processing and ends with return code 04.
    | User response: None.
    

APAR Information

  • APAR number

    PI50095

  • Reported component name

    IMS LIBR INTEG

  • Reported component ID

    5655I4200

  • Reported release

    220

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2015-10-07

  • Closed date

    2015-11-18

  • Last modified date

    2015-12-03

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

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

    UI33077

Modules/Macros

  • FABNDCOD FABNDEDB FABNMSGS FABNPCTL FABNPDBD
    FABNPPSB FABNREAD FABNTGEN
    

Publications Referenced
SC19397901    

Fix information

  • Fixed component name

    IMS LIBR INTEG

  • Fixed component ID

    5655I4200

Applicable component levels

  • R220 PSY UI33077

       UP15/11/20 P F511

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.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"220","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89N","label":"IMS Library Integrity Utilities"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"220","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 December 2015