PI38789: FPO OPC DOES NOT SUPPORT MDA FOR RECON DATA SETS WHEN SENSOR=YESIS SPECIFIED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When FPO Online Pointer Checker (OPC) runs with DBRC=YES and
  SENSOR=YES, the RECON data set must be specified in the JCL.
  Therefore, even if the DFSMDA member for the RECON data sets
  are defined in the STEPLIB DD, OPC does not use the DFSMDA
  members to allocate the RECON data sets.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of HPFPU Fast Path Online Tools    *
  *                 (FPO) in Fast Path Solution Pack Version 1   *
  *                 Release 3 (FMID: HAHQ130) who use the IMS    *
  *                 Tools Knowledge Base.                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: Online Pointer Checker utility (OPC)    *
  *                      and Online Expert Reorganization        *
  *                      utility (OER) of FPO do not support MDA *
  *                      for RECON data sets when DBRC=YES,      *
  *                      ITKBSRVR=servername and SENSOR=YES are  *
  *                      specified.                              *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  When DBRC=YES, ITKBSRVR=servername and SENSOR=YES are specified
  in the utility control statement and RECON1 DD statement is not
  specified in the OPC or OER JCL, the OPC or OER issues HFPO1007W
  message and does not store the sensor data in the sensor data
  repository. The HFPO1007W message is issued even though the
  library that contains DFSMDA dynamic allocation member for the R
  ECON data set is specified in the OPC or OER JCL.
  

Problem conclusion

• FPO OPC and OER support to use DFSMDA member to allocate RECON
  data sets dynamically. When DBRC=YES, ITKBSRVR=servername and
  SENSOR=YES are specified and RECON1, RECON2, and RECON3 data
  sets are not specified, the data set is allocated dynamicaly by
  using a DFSMDA member. The library that contains DFSMDA dynamic
  allocation member can be specified in the STEPLIB or IMSDALIB DD
  statement.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS Fast Path Solution Pack for z/OS Version 1 Release 3
  IMS High Performance Fast Path Utilities User's Guide
  (SC19-4010-01).
  
  Part 4. IMS Fast Path Online Tools
    Chapter 26. Analyzing a DEDB online with FPO
      DD statements for OPC
  (Revision bar shows the part of change)
  
  The IMSDALIB DD is added in the table 111.
  
    Table 111. DD statements for OPC
    ---------------------------------------------------
    DDNAME      Use      Format   Required or optional
    ---------------------------------------------------
  | IMSDALIB    Input    PDS      Optional
    ---------------------------------------------------
  
  The description of STEPLIB DD is changed as follows.
  
    STEPLIB DD
    Defines the library that contains the OPC utility.
    - The load library of IMS HP Image Copy must be concatenated
      if you specify the comprtn parameter on the IC keyword or
      the IC=(YES,ICEIN) keyword.
    - The Tools Base library (SHKTLOAD) is required if you specify
      the ADXCFGRP keyword, the ITKBSRVR keyword, or the
      SENSOR=YES option.
  | - The library that contains DFSMDA dynamic allocation members
  |   for the RECON data sets.
  
  The IMSDALIB DD is added in the input DD statements
  
  | IMSDALIB DD
  | This DD statement is an optional DD statement that defines the
  | library that contains DFSMDA dynamic allocation members for
  | the RECON data sets.
  
  The description of RECON1/RECON2/RECON3 DD is changed as follows
  (Revision bar shows the part of change)
  
    RECON1/RECON2/RECON3 DD
    Defines the DBRC RECON data sets. It is required when both the
  | ICNOTIFY=YES or ITKBSRVR=servername and DBRC=YES keywords are
    specified. The RECONn data set must be the same data set that
  | is used in the IMS control region. When ICNOTIFY=YES is
  | specified, OPC updates RECONn data sets because OPC registers
  | the image copy data set to DBRC. When ITKBSRVR=servername is
  | specified, OPC retrieves a RECON ID from RECON data sets.
    If this statement is not specified in the JCL statement when
    the data set is necessary, the data set is allocated
    dynamically by using a DFSMDA member.
  
  Part 4. IMS Fast Path Online Tools
    Chapter 29. Reorganizing a DEDB online with FPO
      DD statements for OER
  (Revision bar shows the part of change)
  
  The IMSDALIB DD is added in the table 131.
  
    Table 131. DD statements for OER
    ---------------------------------------------------
    DDNAME      Use      Format   Required or optional
    ---------------------------------------------------
  | IMSDALIB    Input    PDS      Optional
    ---------------------------------------------------
  
  The description of STEPLIB DD is changed as follows.
  
    STEPLIB DD
    Defines the library that contains the OER utility.
    - The load library of IMS HP Image Copy must be concatenated
      if you specify the PTRCHK=YES keyword with either of the
      following specifications:
      -- IC=(YES,comprtn) option
      -- IC=(YES,ICEIN) option
    - The Tools Base library (SHKTLOAD) is required if you specify
      the ADXCFGRP keyword, the ITKBSRVR keyword, or the
      SENSOR=YES option.
  | - The library that contains DFSMDA dynamic allocation members
  |   for the RECON data sets.
  
  The IMSDALIB DD is added in the input DD statements
  | IMSDALIB DD
  | This DD statement is an optional DD statement that defines the
  | library that contains DFSMDA dynamic allocation members for
  | the RECON data sets.
  
  The description of RECON1/RECON2/RECON3 DD is changed as follows
  
    RECON1/RECON2/RECON3 DD
    Defines the DBRC RECON data sets. It is required when both the
  | ICNOTIFY=YES or ITKBSRVR=servername and DBRC=YES keywords are
    specified. The RECONn data set must be the same data set that
  | is used in the IMS control region. When ICNOTIFY=YES is
  | specified, OER updates RECONn data sets because OER registers
  | the image copy data set to DBRC. When ITKBSRVR=servername is
  | specified, OER retrieves a RECON ID from RECON data sets.
    If this statement is not specified in the JCL statement when
    the data set is necessary, the data set is allocated
    dynamically by using a DFSMDA member.
  
  Part 8. Troubleshooting
    Chapter 59. Messages and codes of IMS HP Fast Path Utilities
      Messages
        FPX messages
  
  The following messages are added.
  
  FPX0351E  BLDL failed for dynamic allocation member: membername
  Explanation: The BLDL macro is issued for the dynamic allocation
  member membername that was specified in the STEPLIB. The macro
  failed.
  System action: Processing ends with a return code of 8.
  User response: To determine the cause of the error, see DFSMS
  Macro Instructions for Data Sets. Correct any errors, and rerun
  the job. If this situation persists, contact IBM Software
  Support.
  
  FPX0352E  DFSMDA member membername was not found.
  Explanation: DFSMDA member membername was not found in the
  STEPLIB.
  System action: Processing ends with a return code of 8.
  User response: Make sure the specified member exists in the
  STEPLIB. Correct any errors, and rerun the job. If this
  situation persists, contact IBM Software Support.
  
  FPX0353E  Incorrect dynamic allocation member:membername
  Explanation: The dynamic allocation member membername does not
  conform to the expected DFSMDA structure.
  System action: Processing ends with a return code of 8.
  User response: Verify the integrity of the dynamic allocation
  member. Correct the problem, then rerun the job.
  
  FPX0354E  Dynamic allocation failed for DDNAME:ddname,
  DSNAME:dsname, RC=code, RSN=eeeeiiii
  Explanation: Dynamic allocation for ddname and dsname failed.
  code is the return code from SVC99. eeee is the S99 ERROR
  contents. iiii is the S99 INFO contents.
  System action: Processing ends with a return code of 8.
  User response: Look up the dynamic allocation (SVC99) code in
  the MVS Programming: Assembler Services Reference. Correct the
  problem, then rerun the job.
  

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:

  UI28364

Modules/Macros

• FPXALIC0 FPXALIF0 FPXATA00 FPXATO00 FPXAUCS0
  FPXA0000 FPXDEXE0 FPXDMDA0 FPXDYER0 FPXDYNA0 FPXMODE0 FPXMSG00
  FPXUCIO0 FPXUCOP0 FPXUITO0 FPXUITW0 FPXULRH0 FPXUMDA0 FPXUMOD0
  FPXUPSR0 FPXUSNB0 FPXXRGE0 FPXXRG00 HAHQ130J
  

Fix information

• Fixed component name

  IMS FP SOLUTION

• Fixed component ID

  5655W1400

Applicable component levels

• R130 PSY UI28364

     UP15/06/11 P F506

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.