PI15697: GRAPHICAL DBD MAP GENERATOR ENHANCEMENT OF DBD MAP VIEWER FOR SUPPORTING LOGICAL DBDS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides the graphical DBD Map generator to support
  Logical DBDs on DBD Map Viewer.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS Library Integrity Utilities for z/OS,    *
  *                 Version 2 Release 2 (FMID=H27P220) users who *
  *                 use DBD Map Viewer in IBM Tools Base         *
  *                 Administration Console and DBD/PSB/ACB       *
  *                 Reversal utility.                            *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR includes the following        *
  *                      enhancements.                           *
  *                                                              *
  *                      - Graphical DBD Map generator(FABXGMAP) *
  *                        enhancement to display a logical DBD  *
  *                        information in DBD Map Viewer         *
  *                                                              *
  *                      - DBD/PSB/ACB Reversal can decode the   *
  *                        real DBD names of the INDICES         *
  *                        parameter and the real segment name   *
  *                        and the real database name of the     *
  *                        SOURCE parameter for virtually        *
  *                        paired logical relationship.          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR includes the following enhancements.
  
  - Graphical DBD Map generator(FABXGMAP) processes
    a logical DBD to display the DBD Map, source, and XML
    document in DBD Map Viewer.
  
  - DBD/PSB/ACB Reversal can decode the following information
    from ACBLIB members that had been generated by IMS Version 12
    or higher.
  
    - The real DBD names of the INDICES parameter of the SENSEG
      statement.
    - The PAIR parameter of the LCHILD statement for virtually
      paired logical relationship.
    - The real segment names and the real database names of the
      SOURCE parameter of the SEGM statement for virtually paired
      logical relationship.
  
  Apply PI15698 with this APAR to display the logical DBD Map in
  DBD Map Viewer.
  

Problem conclusion

Temporary fix

Comments

• The following modules and macros have been modified.
  
  FABLLINK,FABNDBLC,FABNDBLD,FABNDCNC,FABNDCND,FABNDCVD,
  FABNDEDB,FABNDMY0,FABNDST0,FABNICB ,FABNPARM,FABNPBLC,
  FABNPBLD,FABNPCNC,FABNPCND,FABNPDBD,FABNPPSB,FABNREAC,
  FABNREAX,FABNTLES,FABNWORK,FABXASTD,FABXASTP,FABXAST0,
  FABXGHMC,FABXGMAP,FABXGNX0,FABXGNX1,FABXWMT ,FABXWM0 ,
  FABXXDB0,FABXXFL0,FABXXMP0,FABXXPB0,FABXXPS0,FABXXSG0,
  H27P220J
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  Note: The Part and Chapter numbers are those of the PDF file.
  
   The documentation "IMS Library Integrity Utilities for z/OS
   V2R2, User's Guide" (SC19397900) is changed.
   The documentation is modified as follows:
   ==============================================================
   IMS Library Integrity Utilities for z/OS V2R2,
   User's Guide" (SC19397900)
   ==============================================================
   --------------------------------------------------------------
   > Chapter 8. DBD/PSB/ACB Reversal utility
   >> SYSPUNCH data set
   --------------------------------------------------------------
   Restrictions on the generated control statements
  
   When the IMS DBDGEN utility processes the control statements
   issued by the ACB reversal function of DBD/PSB/ACB Reversal,
   the following restrictions apply:
  
   -Because DBD/PSB/ACB Reversal cannot obtain paired segment
    name information on the LCHILD statement for virtually paired
    logical relationship, the program cannot decode the PAIR
  | parameter. This restriction applies when ACBs were generated
  | by IMS Version 11 or earlier.
   -Because DBD/PSB/ACB Reversal cannot obtain segment name
   information and database name information of the SOURCE
   parameter for virtually paired logical relationship, the
   program decodes these names as follows:
    SOURCE=(($SEGMnnn,DATA,$DBDnnn)) (nnn is a sequential number
    in a DBD)
   Then the program writes message FABN0065W to both the SYSOUT
  |and the SYSPUNCH data set. This restriction applies when ACBs
  |were generated by IMS Version 11 or earlier.
  
   When IMS PSBGEN utility processes the control statements
   issued by the ACB reversal function of the DBD/PSB/ACB
   Reversal, the following restrictions apply:
  
  |-When ACBs were generated by IMS Version 11 or earlier,
    DBD/PSB/ACB Reversal decodes the INDICES parameter of the
    SENSEG statement into the following format:
     INDICES=($DBD0001,$DBD0002)
  
   --------------------------------------------------------------
   > Chapter 15. Troubleshooting
   >> IMS Library Integrity Utilities messages
   >>> FABN messages
   --------------------------------------------------------------
  <<The following message is added:>>
  
  |FABN0077W VERSION PARAMETER DBD STATEMENT IS NOT DECODED. EXIT
  |PARAMETERS OF DBD AND SEGM STATEMENTS ARE NOT DECODED
  |Explanation: The VERSION parameter of DBD statement is not
  |decoded. The EXIT parameters of DBD and SEGM statements are
  |not decoded.
  |System Action: DBD/PSB/ACB Reversal utility continues
  |processing.
  |User Response: None.
  
   --------------------------------------------------------------
   > Chapter 15. Troubleshooting
   >> IMS Library Integrity Utilities messages
   >>> FABX messages
   --------------------------------------------------------------
  <<The following message is deleted:>>
  
  |FABX3906E THE DATABASE ORGANIZATION (organization) OF
  |DATABASE dbdname IS NOT SUPPORTED
  |Explanation: The indicated database organization type is not
  |supported by DBD Map Viewer.
  |System action: Processing terminates with job return code 8.
  |User response: None.
  &#215;**** PE14/11/13 PTF IN ERROR. SEE APAR PI29558  FOR DESCRIPTION
  

APAR Information

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

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

  UI17053

Modules/Macros

• FABLLINK FABNDBLC FABNDBLD FABNDCNC FABNDCND FABNDCVD FABNDEDB
  FABNPARM FABNPBLC FABNPBLD FABNPCNC FABNPCND FABNPDBD FABNPPSB
  FABNREAC FABNREAX FABNTLES FABXASTD FABXASTP FABXAST0 FABXGMAP
  FABXGNX0 FABXGNX1 FABXWMT  FABXWM0  FABXWM1  FABXXDB0 FABXXFL0
  FABXXMP0 FABXXPB0 FABXXPS0 FABXXSG0 H27P220J
  

Fix information

• Fixed component name

  IMS LIBR INTEG

• Fixed component ID

  5655I4200

Applicable component levels

• R220 PSY UI17053

     UP14/04/17 P F404

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.