PH11257: SUPPORT OF CONCATENATING MULTIPLE ADMINISTRATION TOOL LOADLIBS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Currently, when the administration tool sub-task works in the
  DAI SOT address space, only one LOADLIB data set can be used as
  TASKLIB. This APAR addresses a requirement for separating the
  customized load module members from the product SMP/E target
  library.  This APAR enhances Administration Tool  back-end
  modules run in DAI SOT and ISPF to support multiple ATY LOADLIB
  data set concatenations.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS Administration Tool for     *
  *                 z/OS (FMID=HALC110)                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: Enhancement of IMS Administration Tool  *
  *                      ISPF and z/OS back-end to separate      *
  *                      a user customized load module library   *
  *                      from a product library, and             *
  *                      concatenate them at runtime.            *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Before this APAR, only one loadlib data set is referred when
  IMS Administration Tool runs in the IBM Tools Base (ITB)
  DAI TAS SOT. It is because the loadlib is defined to SATYLOAD
  DDNAME in the product registration in the IMS Tools Knowledge
  Base repository, and one data set can be defined to SATYLOAD.
  As the result, customized modules ATY#OPTS and ATYSTFWD must
  be stored in the same data set as IMS Administration Tool
  product load modules.
  
  This APAR PH11257 enhances IMS Administration Tool to separate
  a user customized load module library from a product library,
  and concatenate them at runtime.
  
  
  This APAR PH11257 changes the z/OS back-end modules that run
  in the ITB DAI SOT and the ISPF UI. The users who use the Web
  interface must apply APAR PH11245 and this APAR PH11257.
  
  To separate the customized module from the product load
  modules, do the following steps:
   1) Store the customized modules to a different data set from
      the product loadlib
   2) Register the customized loadlib name to the SYSLOAD DD
      name variable with SCOPE=SYSTEM in the IMS Tools
      Knowledge Base repository. The product loadlib must be
      defined to the SATYLOAD DD as same as before.
      When IMS Administration runs in the IMS Tools Base DAI
      SOT address space, the SYSLOAD data set is referred
      before the SATYLOAD data set.
  
   3) Update the IMS control region and OM region JCLs by adding
      the SYSLOAD library to the STEPLIB concatenation, and
      restart the IMS system.
  
  After this APAR PH11257 applied, IMS Administration Tool
  still supports the single SATYLOAD loadlib. If users already
  have customized the SAYTLOAD loadlib and does not want to
  separate into SYSLOAD and SATYLOAD, they do not need take any
  action.
  
  This APAR PH11257 changes the following SATYSAMP sample JCLs
  to refer the SYSLOAD data set.
   ATY$TSTA, ATY$TSTP, ATYASMOP, ATYASMSF, ATYBATCH, ATYBATRX,
   ATYBMP, ATYBMPR, ATYDLI
  If you have customized the JCLs before, change them again after
  applying PH11257.
  
  
  Apply PTFs of the following APARs with this APAR PH11257:
  - Apply PH11245 to IMS Administration Tool web interface.
  - Apply PH11976 to IBM Tools Base to customize SYSLOAD by
    Setup.
  
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The documentation "IBM IMS Administration Tool for z/OS
  V1R1, User's Guide (SC27-9011-01)" is changed as follows:
  --------------------------------------------------------------
  >Product configuration
  >>Additional and optional product configuration
  >>>Configure VSAM options data set
   and
  >>>Command store/forward: Configure
  
  Procedure
  
  |3. Specify the loadlib to the SYSLOAD variable
  |
  | Specify the loadlib data set containing the module to
  | the SYSLOAD DDNAME variable with SCOPE=SYSTEM.
  | To specify the SYSLOAD variable, follow the instruction of
  | SETUP, or use either ISPF or Management Console user
  | interface:
  | - ISPF interface
  |  Setup and Administration > Update Product Registry >
  |   Variable Management > DDNAME Variables
  | - Management Console interface
  |  Setup and Admin > Variable Management
  |
  | When IMS Administration runs in the IMS Tools Base DAI SOT
  | address space, the SYSLOAD data set is referred before
  | the SATYLOAD data set. The SATYLOAD is the product loadlib
  | which is registered in the IMS Administration Tool product
  | registration.
  |
  |4. Specify the loadlib to IMS
  | Update the IMS control region and OM region JCLs by adding
  | the SYSLOAD library to the STEPLIB concatenation, and restart
  | the IMS system.
  

Problem conclusion

Temporary fix

Comments

APAR Information

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

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

  UI63964

Modules/Macros

• ATY#CLNT ATY#EMSG ATY$APRQ ATY$LOAD ATY$MAIN ATY$TSTA ATY$TSTP
  ATY@OBJU ATY@SKEL ATYASMOP ATYASMSF ATYBATCH ATYBATRX ATYBMP
  ATYBMPR  ATYDLI   ATYZ04
  

Fix information

• Fixed component name

  IMS ADMIN TOOL

• Fixed component ID

  5655CAT00

Applicable component levels

• R110 PSY UI63964

     UP19/06/29 P F906  

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.