PI90966: ENABLE IMS MANAGED ACBS SUPPORT FOR SPMN

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR enables SPMN to use the database definitions (DBD)
  from the IMS catalog instead of DBD libraries when IMS
  management of ACBs is enabled.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  
  * USERS AFFECTED: IBM IMS High Performance Pointer Checker for *
  
  *                 z/OS Version 3 Release 1 (FMID=HPC2310)      *
  
  *                 users who run Space Monitor (SPMN) when the  *
  
  *                 FABKCTL data set is used and IMS managed     *
  
  *                 ACBs is enabled.                             *
  
  ****************************************************************
  
  * PROBLEM DESCRIPTION: This APAR enables SPMN to use the       *
  
  *                      database definitions (DBD) from the IMS *
  
  *                      catalog instead of DBD libraries when   *
  
  *                      the FABKCTL data set is used and IMS    *
  
  *                      managed ACBs is enabled.                *
  
  ****************************************************************
  
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  
  ****************************************************************
  
  This APAR adds new keyword IMSCATHLQ= to the PROC statement in
  the FABKCTL data set and enables SPMN to use the database
  definitions (DBD) from the IMS catalog instead of DBD libraries
  specified in the IMS DD statements when the FABKCTL data set is
  used and IMS managed ACBs is enabled.
  The SGLXLOAD library of IBM IMS Tools Base for z/OS, Version 1
  Release 6 or later needs to be specified to the STEPLIB DD
  statements when using the new keyword.
  

Problem conclusion

• IMSMGDACBS/K
  

Temporary fix

Comments

• Documentation Changes:
  Note: The Part, Chapter, and Table numbers are those of the PDF
  file.
  The documentation is modified as follows:
  ================================================================
  
  IMS High Performance Pointer Checker for z/OS, V3R1,
  User's Guide (SC19240103)
  ================================================================
  
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  
  Part 1. Introduction and product setup
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  
  ----------------------------------------------------------------
  
  Chapter 2. Configuring IMS HP Pointer Checker
  - Processing environment
  ----------------------------------------------------------------
  
  Software requirements
  Space Monitor utility
  << The following requirement is added >>
  |- To provide control statements through the FABKCTL data set
  |  when the IMS management of ACBs is enabled, IBM IMS Tools
  |  Base for z/OS, Version 1 Release 6 or later must be
  |  installed.
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  
  Part 5. Space Monitor utility
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  
  ----------------------------------------------------------------
  
  Chapter 25. Using Space Monitor
  ----------------------------------------------------------------
  
  - Job control language
   - FABKSPMN JCL
  ----------------------------------------------------------------
  
  << The descriptions for STEPLIB DD and IMS DD have been updated
    as follows >>
  STEPLIB DD
  This DD defines the following input data sets:
   -IMS HP Pointer Checker production library (required)
   -IMS Tools Online System Interface load module library
    (optional)
   -IMS MDA library (optional)
   -IMS RESLIB (optional)
  | -IMS Tools Base library (SGLXLOAD)  (optional)
   Requirements:
    -If you want to monitor the latest VSAM statistics about the
     IMS online full-function database data sets, you must
     specify the IMS Tools Online System Interface load module
     library in the STEPLIB concatenations, and the libraries
     that are specified in the STEPLIB DD statement must be
     APF-authorized.
    -If you use the FABKCTL data set, you must specify the IMS
     RESLIB. In addition, specify the MDA library that has the
     definitions for the database and the data sets to be
     monitored in the STEPLIB or the IMSDALIB.
  |  -If you specify the IMSCATHLQ= keyword on the PROC statement,
  
  |   specify the SGLXLOAD library of IMS Tools Base Version 1
  |   Release 6 or later.
  IMS DD
  This optional input data set defines the IMS DBD library.
  If you use the FABKCTL data set, you must specify the IMS
  DBDLIB that contains the DBD load module specified in the
  |DATABASE statements. However, you can omit this DD statement
  |when you specify the IMSCATHLQ= keyword. When the IMSCATHLQ=
  |keyword is specified, Space Monitor ignores this DD statement.
  ----------------------------------------------------------------
  
  - Input
   - FABKCTL data set
  ----------------------------------------------------------------
  
  << This topic has been updated as follows >>
  This optional input data set contains control statements that
  specify the name of the IMS database to monitor.
  With FABKCTL, you can use keyword-style control statements to
  specify Space Monitor control statements. In addition, you do
  not need to specify data set names but only the database name.
  Therefore, compared to using SPMNMBR or SPMNIN, FABKCTL
  simplifies the coding of Space Monitor control statements.
  |When the IMS management of ACBs is not enabled, Space Monitor
  retrieves the data set names from the IMS resources, which are
  the IMS DBDLIB library, the MDA library, and RECON data sets.
  Therefore, you must specify these IMS resources in Space
  Monitor JCL.
  |When the IMS management of ACBs is enabled, Space Monitor
  |retrieves the data set names from the IMS directory, the MDA
  |library, and RECON data sets. You must specify the MDA library
  |and RECON data sets in Space Monitor JCL, but because the IMS
  |directory is dynamically allocated during the Space Monitor
  |job, you do not need to explicitly specify the IMS directory in
  
  |Space Monitor JCL.
  ----------------------------------------------------------------
  
  - Input
   - FABKCTL data set
     - PROC statement
  ----------------------------------------------------------------
  
  << New keyword IMSCATHLQ has been added >>
  |IMSCATHLQ=
  | This optional keyword specifies the high level qualifier of
  | the bootstrap data set (BSDS), which is one of the
  | system-managed data sets that is associated with the IMS
  | catalog. When IMS managed ACBs is enabled, specify the high
  | level qualifier of the BSDS.
  | bsdshlq
  |  Reads DBDs from the IMS directory instead of DBD libraries by
  
  |  using IMS Tools Catalog Interface. bsdshlq specifies the high
  
  |  level qualifier of the BSDS.
  | *NO
  |  Reads DBDs from the DBD library that is specified in the IMS
  |  DD statement. IMSCATHLQ=*NO is the default value.
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  
  Part 8. Troubleshooting
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  
  ----------------------------------------------------------------
  
  Chapter 37. Messages and codes
  - Space Monitor messages and codes
   - Space Monitor messages
  ----------------------------------------------------------------
  
  << The following new messages have been added >>
  |FABK0139I THE IMSCATHLQ= PARAMETER IS IGNORED BECAUSE
  |UNSUPPORTED IMS VERSION IS USED
  |Explanation: Space Monitor found the IMSCATHLQ=bsdshlq keyword
  |parameter in the PROC statement of the FABKCTL data set or the
  |SPMN site default table (FABKCTL0). However, Space Monitor
  |ignored the IMSCATHLQ keyword parameter because the version of
  |IMS RESLIB that is identified by the STEPLIB DD statement is
  |version 13 or lower. The IMSCATHLQ keyword is supported for IMS
  
  |Version 14 or later.
  |System action: Space Monitor ignores the IMSCATHLQ keyword
  |parameter and continues processing.
  |User response: None.
  
  |FABK3563E ERROR RETURNED FROM IMS TOOLS CATALOG INTERFACE
  |(text)
  |Explanation: Space Monitor received an error return code from
  |IMS Tools Catalog Interface. text provides one of the following
  
  |additional information:
  | - FUNC=OPEN RC=return_code RSN=reason_code
  | - FUNC=CLOSE RC=return_code RSN=reason_code
  | - FUNC=GET DBD=dbdname RC=return_code RSN=reason_code
  |The return code and reason code from IMS Tools Catalog
  |Interface are shown in return_code and reason_code,
  |respectively.
  |System action: Space Monitor ends with an abend code of 3563.
  |User response: See IMS Tools Catalog Interface messages
  |(GEX3xxxx) to determine the cause of the error.
  |The following list provides possible causes and recommended
  |actions:
  |-If the function is OPEN, ensure that the SGLXLOAD library of
  | IMS Tools Base Version 1 Release 6 or later is specified on
  | the STEPLIB DD statements and the correct high level qualifier
  
  | of the bootstrap data set is specified on the IMSCATHLQ
  | keyword. Then rerun the job.
  |-If the function is GET, ensure that the correct DBD name is
  | specified on the DB keyword and the correct high level
  | qualifier of the bootstrap data set is specified on the
  | IMSCATHLQ keyword. Then rerun the job.
  |-If the function is CLOSE or if the problem persists, contact
  | IBM Software Support.
  
  |FABK3564E DBD dbdname IS NOT FOUND IN THE IMS DIRECTORY DATA
  |SETS
  |Explanation: Space Monitor could not obtain the indicated DBD
  |from the IMS directory data sets.
  |System action: Space Monitor ends with an abend code of 3564.
  |User response: Ensure that the correct high level qualifier of
  |the bootstrap data set is specified on the IMSCATHLQ keyword,
  |the correct DBD name is specified on the DB keyword, and that
  |the DBD identified by dbdname exists in the IMS directory data
  |sets. Then rerun the job.
  

APAR Information

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

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

  UI53526

Modules/Macros

•    FABKACTL FABKADBS FABKADEF FABKAOPS FABKAPRS
  FABKMGTB FABKSPMN FABKTGEN FABKURTO
  

Fix information

• Fixed component name

  IMS POINTER CHE

• Fixed component ID

  5655E0900

Applicable component levels

• R310 PSY UI53526

     UP18/01/31 P F801

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.