A fix is available
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
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