PI89811: LIU FOR IMS ADMINISTRATION TOOL PROVIDES IMS SPUFI ENHANCEMENT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR enables LIU to provide enhancement of IMS SPUFI
  program view when LIU runs under IMS Administration Tool.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS Library Integrity Utilities for z/OS,    *
  *                 Version 2 Release 2 (FMID=H27P220) users     *
  *                 who use IBM IMS Administration Tool.         *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables LIU which runs under  *
  *                      IMS Administration Tool to provide      *
  *                      enhancements for IMS Administration     *
  *                      Tool. These are effective with IMS      *
  *                      Administration APAR PI88592, PI90085    *
  *                      and PI90728.                            *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR enables LIU which runs under IMS Administration Tool
  to provide the enhancements for IMS Administration Tool.
  
  All of the features are effective when three PTFs for IMS
  Administration Tool's APAR PI88592, PI90085 and PI90728 are
  applied to IMS Administration Tool.
  
  The details are as follows.
  
  The terminologies and several messages are improved to match
  with terminologies described in IMS user's guide.
  
  IMS SPUFI program view is improved. DB PCB EXTERNALNAME is
  displayed on DB Schema prior to PCB label or DB PCB NAME when
  it is defined. EXTERNALNAME defined in DBD SEGM statement is
  displayed on Table prior to PCB SENSEG name.
  If no SENFLD is defined for DB PCB SENSEG, all of the FIELDs
  defined for DBD SEGM statement are listed on Column.
  Authority is displayed for each Field.
  
  Existing restriction of IMS catalog analysis is removed.
  When the following condition met, IMS catalog analysis is
  performed for IMS systems running in a different LPAR.
  IMS data sharing group of IMS Administration Tool is created
  and IMS systems is registered to the group. The IRLM of one of
  the IMS systems in the group is defined to the LPAR where the
  IMS Tools Base Distributed Access Infrastructure (DAI) server
  is running.
  

Problem conclusion

Temporary fix

Comments

• The following modules and macros have been modified to fix the
  problem:
  FABLMSG FABNDMY0 FABXACT FABXCAMT FABXCA60 FABXCTB FABXDTL
  FABLLINK H27P220J FABLACB0 FABLCOMP FABNDCTL FABNMSGS FABNPCTL
  FABXAAC0 FABXAAC1 FABXAAX0 FABXACAD FABXACA0 FABXACT0 FABXADSC
  FABXAEXP FABXAPI0 FABXATY0 FABXATY1 FABXCALC FABXCAPL FABXCAP1
  FABXCAP2 FABXCAP3 FABXCAP4 FABXCAP5 FABXCAST FABXCATM FABXCAX5
  FABXCA6D FABXCA6E FABXCA6F FABXCBLD FABXCC00 FABXCGMN FABXCLOD
  FABXCLS0 FABXCMRG FABXCOPN FABXCTB0 FABXCTC0 FABXCTM0 FABXSTMD
  FABXWMT
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The documentation "IBM IMS Library Integrity Utilities for z/OS
  V2R2, User's Guide (SC19-3979-03)" is changed.
  ================================================================
  
  14.0 Troubleshooting
  14.4 IMS Library Integrity Utilities messages
  14.4.7 FABX messages
  
  <<The following messages have been updated>>
  
  FABX0007W
  | FABX0007W ONE OR MORE INVALID DBD OR PSB RESOURCES FOUND
  | DURING THE DECODE PROCESS.
  
  FABX0512E
  | FABX0512E THERE ARE NO DBD OR PSB RESOURCES IN IMS DIRECTORY
  | ims_directory_data_set.
  |
  | Explanation
  |  This message indicates that the IMS directory data sets are
  |  empty. ims_directory_data_set is either of the following:
  |  ACTIVE: The IMS directory data sets for storing active
  |  resources are empty.
  |  STAGING: The IMS directory staging data set is empty.
  
  FABX0532E
  | FABX0532E THE RESOURCE resouce IN THE  ACBLIB|IMS CATALOG|IMS
  | DIRECTORY  IS NOT  DBD|PSB .
  
  FABX0533W
    FABX0533W THE SPECIFIED  DBD|PSB  RESOURCE resource DOES NOT
  | EXIST IN THE  ACBLIB|IMS CATALOG|IMS DIRECTORY .
   Explanation
    The specified DBD or PSB resource was not found in the ACBLIB
  | or IMS catalog or IMS directory.
  
  FABX0535E
  | FABX0535E ACCESS TO THE IMS DIRECTORY FAILED WITH RC=rc AND
  | RSN=rsn. FUNCTION=func
  
  FABX0537E
    FABX0537E IMS CATALOG IS NOT DEFINED TO THE IMS.
  | FABX0537E THE IMS MANAGEMENT OF ACBS IS NOT ENABLED. IMS
  | DIRECTORY IS NOT DEFINED TO THE IMS.
  | FABX0537E ACBLIB IS NOT DEFINED TO THE IMS.
  |
  | Explanation
  | The requested function requires the IMS catalog, IMS
  | directory, or ACB library. However, none of these were
  | found in the specified IMS subsystem.
  
  FABX0550W
  | FABX0550W THERE ARE NO DBD OR PSB RESOURCES IN IMS DIRECTORY
  | ims_directory_data_set.
   Explanation
    IMS Library Integrity Utilities did not export any DBD or PSB
  | resources because the indicated IMS directory data set is
  | empty. ims_directory_data_set is either of the following:
  | ACTIVE: The IMS directory data sets for storing active
  | resources are empty.
  | STAGING: The IMS directory staging data set is empty.
  
  <<The following messages have been added>>
  
  | FABX0544E
  | FABX0544E IMS CATALOG ANALYSIS CANNOT BE PERFORMED FOR NON
  | DATA SHARING IMS SYSTEMS.
  |
  | Explanation
  | IMS catalog analysis cannot be performed because a data
  | sharing group is not defined to the Administration Tool.
  |
  | IMS catalog analysis issues DL/I calls to the IMS catalog
  | database. Therefore, to run IMS catalog analysis, data sharing
  | must be configured for the IMS systems so that they can
  | communicate with the LPAR where the IMS Tools Base Distributed
  | Access Infrastructure (DAI) server is running.
  |
  | System action
  | IMS Library Integrity Utilities ends with a return code of 99.
  |
  | User response
  | Use the IRLM to configure data sharing for the IMS systems.
  | Then create an IMS data sharing group of IMS Administration
  | Tool and register the IMS systems to the group. The IRLM of
  | one of the IMS systems in the group must be defined to the
  | LPAR where the DAI server is running.
  
  
  |FABX0551E
  | FABX0551E THERE ARE NO DBD OR PSB RESOURCES IN THE ACB
  | LIBRARY.
  |
  | Explanation
  | The ACB library data set is empty.
  |
  | System action
  | IMS Library Integrity Utilities ends with a return code of 8.
  |
  | User response
  | Run the Application Control Block Maintenance utility
  | (DFSUACB) to store ACBs in the ACB library.
  
  |FABX0552E
  | FABX0552E IMS CATALOG ANALYSIS CANNOT BE PERFORMED FOR IMS
  | SYSTEMS RUNNING IN A DIFFERENT LPAR.
  |
  | Explanation
  | IMS catalog analysis cannot be performed for an IMS control
  | region that is active in an LPAR where the IMS Tools Base
  | Distributed Access Infrastructure (DAI) server is not running.
  | To perform IMS catalog analysis, the PTF for APAR PI90085 must
  | be applied to IMS Administration Tool.
  |
  | System action
  | IMS Library Integrity Utilities ends with a return code of 99.
  |
  | User response
  | Complete the following steps:
  |  1. Apply the PTF for APAR PI90085 to IMS Administration Tool.
  |  2. Use the IRLM to configure data sharing for the IMS systems
  |  3. Create an IMS data sharing group of IMS Administration Too
  |     and register the IMS systems to the group. The IRLM of one
  |     of the IMS systems in the group must be defined to the LPA
  |     where the DAI server is running.
  

APAR Information

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

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

  UI52691

Modules/Macros

•    FABLACB0 FABLCOMP FABLLINK FABNDCTL FABNMSGS
  FABNPCTL FABXAAC0 FABXAAC1 FABXAAX0 FABXACAD FABXACA0 FABXACT0
  FABXADSC FABXAEXP FABXAPI0 FABXATY0 FABXATY1 FABXCALC FABXCAPL
  FABXCAP1 FABXCAP2 FABXCAP3 FABXCAP4 FABXCAP5 FABXCAST FABXCATM
  FABXCAX5 FABXCA6D FABXCA6E FABXCA6F FABXCBLD FABXCC00 FABXCGMN
  FABXCLOD FABXCLS0 FABXCMRG FABXCOPN FABXCTB0 FABXCTC0 FABXCTM0
  FABXSTMD FABXWMT  H27P220J
  

Fix information

• Fixed component name

  IMS LIBR INTEG

• Fixed component ID

  5655I4200

Applicable component levels

• R220 PSY UI52691

     UP17/12/15 P F712

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.