PK42387: COMPARE UTILITY SUPPORTS A NEW OPTION: REPORT=SOURCE

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This functional enhancement to the Compare utility provides a
  new option to generate a source level compare report.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS Library Integrity Utilities for z/OS,    *
  *                 Version 1 Release 1 (FMID=H27P110) users     *
  *                 who use the DBD/PSB/ACB Compare utility or   *
  *                 the DBD/PSB/ACB Reversal utility.            *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides a new option to      *
  *                      generate a source level compare report. *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR includes the following enhancement and fixes:
  
  1. This APAR provides a new option 'REPORT=SOURCE'. If
     'REPORT=SOURCE' is specified in the SYSIN DD, the DBD/PSB/ACB
     Compare utility generates a source level compare report into
     the SYSPRINT DD.
  
  2. DBD/ACB Reversal does not decode a LCHILD statement which
     follows a SEGM statement followed by no FIELD statements.
  
  3. PSB/ACB Reversal does not decode the GSROLBOK parameter in a
     PSB or an ACB.
  
  4. DBD/ACB Reversal gets ABENDS0C4 in the FABNPDBD module around
     offset +X'1DE4' when the string length of the VERSION
     parameter of a DBD or an ACB to be decoded is 48 bytes and
     DECOPT COMPRESS=NO,COMMENT=NO is not specified in the SYSIN
     DD.
  
  5. When the number of lines of IMS DBDGEN or PSBGEN utility
     control statements to be decoded exceeds about 12,500,
     Reversal does not release storage space.
  
  6. ACB Compare gets ABENDS0C4 in the FABLCMPR module around
     offset +X'03DE' when the types of ACB members to be compared
     are different.
  
  7. DBD Compare does not compare the fields related to the DEVICE
     parameter of DBD members that were generated by IMS version 3
     or the former version when NOCOMP=IMSREL is specified in the
     SYSIN DD.
  

Problem conclusion

Temporary fix

Comments

• 1. DBD/PSB/ACB Compare has been modified to generate a source
     level compare report into the SYSPRINT DD if 'REPORT=SOURCE'
     is specified in the SYSIN DD.
  
  2. DBD/ACB Reversal has been modified to decode a LCHILD
     statement correctly even if it follows a SEGM statement which
     is followed by no FIELD statements.
  
  3. PSB/ACB Reversal has been modified to decode the GSROLBOK
     parameter correctly.
  
  4. DBD/ACB Reversal has been modified to decode the VERSION
     parameter correctly even if the string length of VERSION
     parameter is 48 bytes.
  
  5. DBD/PSB/ACB Reversal has been modified to release storage
     area properly even if the number of lines of IMS DBDGEN or
     PSBGEN utility control statements to be decoded exceeds about
     12,500.
  
  6. ACB Compare has been modified not to compare an ACB member
     if the types of ACB members to be compared are different.
  
  7. DBD Compare has been modified to compare DBD members
     correctly when NOCOMP=IMSREL is specified in the SYSIN DD.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS Library Integrity Utilities for z/OS Version 1 Release 1
  User's Guide (Document Number: SC18-7025-02) should be changed
  as follows.
  ================================================================
  4.0 DBD/PSB/ACB Compare
  4.6.2 Input--SYSIN data set
  4.6.2 Format
  << The following new option is added. >>
  |REPORT=SOURCE
  | This statement specifies that this program generates the
  | source level compare reports in the SYSPRINT data set.
  
  4.7.2 SYSPRINT data set
  << Explanation for a source level compare report is added. >>
  |The sources of DBD/PSB/ACB in LIBRARY 1 are taken as the basis
  |for the comparisons if a source level compare report is
  |generated.
  |
  |The headings of DBD, PSB, and ACB Compare reports contain the
  |following items in common;
  |TYPE Function type (DBD, PSB, or ACB) specified with the
  |     control statement.
  |NAME Name of the member to be compared.
  |LIBRARY 1 Data set name and volume serial number of the library
  |          containing the member. Corresponds to DBDLIB, PSBLIB,
  |          or ACBLIB DD statements.
  |LIBRARY 2 Data set name and volume serial number of the library
  |          containing the member. Corresponds to DBDLIB2,
  |          PSBLIB2, or ACBLIB2 DD statements.
  |
  |NUMBER OF DIFFERENT STATEMENTS
  | This part contains summary information about statements which
  | were inserted, deleted, or changed.
  | INSERTED
  |  The number of statements which were contained only in
  |  DBD/PSB/ACB in LIBRARY 2.
  | DELETED
  |  The number of statements which were contained only in
  |  DBD/PSB/ACB in LIBRARY 1.
  | CHANGED
  |  The number of statements which were found in both DBD/PSB/ACB
  |  in LIBRARY 1 and DBD/PSB/ACB in LIBRARY 2 but were different.
  |
  |DBDGEN
  | The date and time when the DBD/PSB/ACB was generated.
  |IMSREL
  | The IMS version and release that generated the DBD/PSB/ACB.
  |
  |CHK
  | The following characters appear if any difference is found in
  | DBDs/PSBs/ACBs between LIBRARY 1 and LIBRARY 2;
  | I - It appears if a statement is inserted into DBD/PSB/ACB in
  |     LIBRARY 2.
  | D - It appears if a statement is deleted from DBD/PSB/ACB in
  |     LIBRARY 1.
  | C - It appears if a statement in DBD/PSB/ACB in LIBRARY 1 is
  |     different from that in LIBRARY 2. Additionally an asterisk
  |     (*) is shown on the row of each data which is
  |     determined as different.
  |LIBRARY 1 SOURCE LINES
  | The IMS DBDGEN or PSBGEN utility control statements which were
  | decoded from DBD/PSB/ACB in LIBRARY 1.
  |LIBRARY 2 SOURCE LINES
  | The IMS DBDGEN or PSBGEN utility control statements which were
  | decoded from DBD/PSB/ACB in LIBRARY 2.
  |
  |Notes:  When comparing DBDs/PSBs/ACBs by a source level compare
  |report, the same restrictions as the DBD/PSB/ACB Reversal
  |utility apply. For details about the restrictions, please see
  |"6.6.2 SYSPUNCH data set".
  |Because DBD/PSB/ACB Compare cannot obtain segment name
  |information and database name information of the SOURCE
  |parameter for virtually paired logical relationship, the
  |program does not compare these names.
  |Because DBD/PSB/ACB Compare cannot obtain information on the
  |INDICES parameter of the SENSEG statement, the program does not
  |compare the field of the parameter.
  |Because DBD/PSB/ACB Compare cannot obtain label information of
  |the DATASET statement, the program does not compare the label
  |field.
  
  
  B.4 Messages
  B.4.1 FABL messages
  |FABL0022I COMPARE MODE IS NOCOMP=xxxxxxxx/(REPORT=xxxxxxxx)
  
   Explanation: DBD/PSB/ACB Compare proceeds with NOCOMP mode
  |xxxxxxxx or REPORT mode xxxxxxxx.
   System action: None.
   Problem determination: None.
   Programmer response: None.
  
  << The following three new messages are added. >>
  |FABL0029E DECODE DBD/(PSB) PROCESSING FAILED WITH RC=yy
  |
  |Explanation: Reversal utility returned a non-zero return code.
  |The return code was yy.
  |System Action: DBD/PSB/ACB Compare ends with a return code
  |of 08.
  |Problem Determination: Read the preceding messages that explain
  |the error conditions.
  |Programmer Response: Correct the error, and rerun the job.
  
  |FABL0030E UNSUPPORTED IMS VERSION: x.x FOR ACB SOURCE COMPARE
  |
  |Explanation: The ACB member generated by IMS version x.x is not
  |supported for the ACB Source Compare.
  |System Action: ACB Compare ends with a return code of 08.
  |Problem Determination: None
  |Programmer Response: Check the ACB member and the ACB library
  |version.
  
  |FABL0031W UNSUPPORTED DBD member IN DBDLIB/(DBDLIB2)
  |
  |Explanation: The specified DBD member in the DBD library is not
  |supported for the DBD Source Compare.
  |System Action: DBD Compare ends with a return code of 04.
  |Problem Determination: None
  |Programmer Response: Check the DBD member.
  

APAR Information

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

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

  UK23788

Modules/Macros

•    FABLACB0 FABLAPI0 FABLCMPD FABLCMPP FABLCOMP
  FABLDBD0 FABLICB  FABLINT0 FABLIVP1 FABLLINK FABLMSG  FABLPRTS
  FABLPSB0 FABLREAD FABNCOM0 FABNDBD0 FABNDCOD FABNDEDB FABNDST0
  FABNGSAM FABNINDX FABNLOG0 FABNMSDB FABNPCNA FABNPCN6 FABNPCN7
  FABNPCN8 FABNPCN9 FABNPCTL FABNRDNL GETBLOCK H27P110J MMPSBD
  

Fix information

• Fixed component name

  IMS LIBR INTEG

• Fixed component ID

  5655I4200

Applicable component levels

• R110 PSY UK23788

     UP07/04/11 P F704

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.