PK45811: INITIAL REPOSITORY REPORT SUPPORT FOR HPPC

APAR status

• Closed as program error.

Error description

• Initial Repository Report support for HPPC
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS Database Recovery Facility for z/OS  *
  *                 Version 3 Release 1 users who will store     *
  *                 HPPC reports in the ITKB Output repository   *
  *                 of IBM IMS Tools Knowledge Base for z/OS     *
  *                 (ITKB).                                      *
  ****************************************************************
  * PROBLEM DESCRIPTION: By this APAR, IMS Database Recovery     *
  *                      Facility for z/OS Version 3 Release 1   *
  *                      supports functions supplied by the IBM  *
  *                      IMS Tools Knowledge Base for z/OS to    *
  *                      store report outputs generated by the   *
  *                      IBM IMS High Performance Pointer        *
  *                      Checker tool.                           *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  By this APAR, DRF supports the IBM IMS Tools Knowledge Base for
  z/OS for HPPC.  Pointer Checker (HDPC) and Space Monitor (SPMN)
  reports can be stored in the IMS Tools KB Output repository.
  

Problem conclusion

•  AIDS: RIDS/UTIL RIDS/DBS DBS/UTIL
    DEP: NONE
    GEN:
  
  *** END IMS KEYWORDS ***
  FRXEDRF,FRXEWSP, FRXRWCE, FRXRWSP, FRXVWSP, and FRXEDRF0 are
  changed to recognize the ITKBLOAD and ITKBSRVR parameters on
  the UTILGBL SYSIN control statement for ITKB support.
  
  FRXMTC and FRXBDMG0 are changed to add two new messages
  (MSGFRD1013E and MSGFRD9007E) and update MSGFRD9000I for ITKB
  support.
  
  FRXIAUX, FRXIDYN0, FRXIOCN0, FRXIOSM0, FRXIRTH0, FRXIVCN0,
  FRXIVSM0, FRXMSTR0, FRXUAPI0, FRXVRCV0, and FRXVSTA0 are
  changed to invoke the ITKB API macros to initialize the
  environment and terminate when required.  They are also changed
  to pass the ITKB server name to HPPC through the HPPC API.
  
  FRXMDDL0 is a new module added to handle the allocation of the
  ITKB product load library.
  
  FRXCON,FRXMNP, FRXRVGB, FRXMINI0, FRXMINI1, FRXSDR00 are change
  to support the load of the new module, FRXMDDL0.
  
  FRXVSTA2 is changed to fix a bug where unallocated storage was
  being accessed.
  
  FRXADF00, FRXADM20, FRXCBDM0, FRXDDCD0, FRXDDCR0, FRXEPSS0,
  FRXGAPI0, FRXGRPT0, FRXLBLD0, FRXPDSS0, FRXPSDR0, FRXPSDS0,
  FRXRLRA0, FRXTAPI0, FRXTAS00, FRXTAU00, FRXTPIB0, FRXTSIB0,
  FRXTSPR0, FRXVADD0, FRXVASD0, FRXVSTA1, FRXVVER0, and
  FRXWRTN0 are recompiled to pick up changes made to macros in
  this apar.
  
  The following DOC change is made in this apar:
  --------------------------------------------------------------
  IBM IMS Database Recovery Facility for z/OS  (SC18-9407-01)
  User's Guide and Reference Version 3 Release 1
  
  Chapter 3. Defining and tailoring the IMS Database Recovery
             Facility environment
  
  Under "UTILGBL(<subparameters>)" added descriptions for two
  new parameters:
  
  ITKBSRVR(servername)
    This is an optional parameter.
    servername
      Specify the ITKB server name to store the reports generated
      under DRF in the ITKB repository.  The ITKB server must be
      running.  The ITKB client load library must be provided
      via the ITKBLOAD parameter described below, or provided
      on STEPLIB in both the DRF Master address space and subtask
      JCL procedures.
  
  ITKBLOAD(dsn)
    This is an optional parameter and only valid when a server
    name is provided on the ITKBSRVR parameter.
    dsn
      Specify the ITKB load module library name.  If it is
      specified, DRF will load the ITKB from the data set.
      Otherwise, DRF will attempt to load ITKB from the STEPLIB
      concatenation in the DRF Master address space and subtask
      JCL procedures.
  
  ---------
  Chapter 7. Messages and Codes of IMS Database Recovery Facility
  
  FRD1013E vartxt ERROR RC=rc
  Explaination:  IMS Database Recovery Facility has failed on an
                 attempt to process a load library data set.
  
  vartxt  Identifies the reason for the failure.
          * OPEN - Load library data set failed on open.
          * LOAD - Load library data set failed on load.
  
  System action:  DRF may continue processing.
  
  System programmer respose:  Identify the load library data
  set that failed and determine its availability.
  
  Module:  FRXMDDL0
  
  ---
  FRD9000I utiltype IS NOW PROCESSING name1 {name2}
  Explaination:  IMS Database Recovery Facility has invoked the
                 utility utiltype.  The value for utiltype can be
                 one of the following utilities:
  
    * IB   - Index Builder or DFSPREC0
    * IC   - High Performance Image Copy
    * PC   - High Performance Pointer Checker
    * DP   - DEDB Pointer Checker
    * ITKB - IMS Tools Knowledge Base
  
    If the utility is IB, IC, PC, or DP then name1 identifies the
    database name and name2 identifies the database DD name.
    If the utility is ITKB then name1 will identify ITKBSRVR and
    name2 will be the ITKB server name.
  
  System action:  Processing continues.
  
  Module:  FRXIOCN0, FRXIVCN0, FRXIOSM0, FRXIVSM0, FRXVSTA0
  
  ---
  FRD9007E ITKB vartxt ERROR RC=rc RSN=rsn
  Explaination:  A failure was encountered while processing ITKB.
  
  vartxt
    * PROGRAM LOAD   - The ITKB client code failed to load.
    * PROGRAM UNLOAD - The ITKB client code failed to unload.
    * INIT           - ITKB failed on initialization.
    * TERM           - ITKB failed on termination.
  
  Module:  FRXMSTR0, FRXUAPI0, FRXVSTA0
  

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:

  UK26224

Modules/Macros

•    FRXADF00 FRXADM20 FRXBDMG0 FRXCBDM0 FRXCON
  FRXDDCD0 FRXDDCR0 FRXEDRF  FRXEDRF0 FRXEPSS0 FRXEWSP  FRXGAPI0
  FRXGRPT0 FRXIAUX  FRXIDYN0 FRXIOCN0 FRXIOSM0 FRXIRTH0 FRXIVCN0
  FRXIVSM0 FRXLBLD0 FRXMDDL0 FRXMINI0 FRXMINI1 FRXMNP   FRXMSTR0
  FRXMTC   FRXPDSS0 FRXPSDR0 FRXPSDS0 FRXRLRA0 FRXRVGB  FRXRWCE
  FRXRWSP  FRXSDR00 FRXTAPI0 FRXTAS00 FRXTAU00 FRXTPIB0 FRXTSIB0
  FRXTSPR0 FRXUAPI0 FRXVADD0 FRXVASD0 FRXVRCV0 FRXVSTA0 FRXVSTA1
  FRXVSTA2 FRXVVER0 FRXVWSP  FRXWRTN0 H27L310J
  

Fix information

• Fixed component name

  IMS DB RECOVERY

• Fixed component ID

  5655I4400

Applicable component levels

• R310 PSY UK26224

     UP07/06/20 P F706