PM79336: ENHANCEMENT TO STORE THE SENSOR DATA WHEN USING AN IMAGE COPY DATASET AS INPUT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Enhancement to store the sensor data when an image copy dataset
  is specified as input in FPA functions.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of HPFPU Fast Path Advanced Tool   *
  *                 and Fast Path Online Tools in Fast Path      *
  *                 Solution Pack Version 1 Release 2            *
  *                 (FMID: HAHQ120)                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR supports the following        *
  *                      new functions:                          *
  *                      1.Store the sensor data in the Sensor   *
  *                      Data repository of IMS Tools KB even    *
  *                      though the input data set is image      *
  *                      copy for an area.                       *
  *                      2.Support a new keyword SENSOR_PTRERR.  *
  *                      3.Provide DSNAME, DDNAME, DSTYPE, and   *
  *                      IC TIMESTAMP(if any) at the header of   *
  *                      LARGEST DATABASE RECORDS REPORT.        *
  *                      This APAR also addressed the following  *
  *                      problems:                               *
  *                      4.FPA ANALYZE abended with 0C1 when     *
  *                      the length of the root key is a         *
  *                      multiple of 4, a server name is         *
  *                      specified for the ITKBSRVR keyword,     *
  *                      and the second parameter, the number    *
  *                      of reporting entries in the             *
  *                      Consolidated Largest Database Records   *
  *                      report, is specified for the            *
  *                      LARGEREC_COUNT keyword.                 *
  *                      5.FPO could not issue FPX0258E          *
  *                      correctly.                              *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  1.FPA Analyze and FP stand-alone DB Sensor store the sensor
  data in the Sensor Data repository of IMS Tools KB even
  though the input data set is image copy for an area.
  2.FPA Analyze and OPC provide a new keyword SENSOR_PTRERR
  to allow the user to specify whether to sotre the sensor data
  in the Sensor Data repository when the pointer errors are
  detected in the area.
  3.FPA Analyze and OPC provide DSNAME, DDNAME, DSTYPE, and IC
  TIMESTAMP(if any) at the header of LARGEST DATABASE RECORDS
  REPORT.
  4.HFPGULM0 has been modified to process the root key correctly
  when its length is a multiple of 4.
  5.FPO has been modified to issue FPX0258E correctly.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS Fast Path Solution Pack for z/OS Version 1 Release 2
  IMS High Performance Fast Path Utilities User's Guide
  (SC19-3287-00).
  2.4.6 Utility control statements for the Reload process
  Table 10. RELOAD command keywords
  2.5.6 Utility control statements for the Change process
  Table 18. CHANGE command keywords
  2.6.7 Utility control statements for the Reorg process
  Table 27. REORG command keywords
  2.7.6 Utility control statements for the Analyze process
  Table 34. ANALYZE command keywords
  Add the following new keyword and its description after
  SENSOR_DBREC:
  SENSOR_PTRERR  An optional keyword that specifies whether to
                 store the sensor data in the Sensor Data
                 repository of IMS Tools KB when the pointer
                 errors are detected in the area.
  2.11.2.1 ANALYZE
  2.11.2.2 CHANGE
  2.11.2.8 RELOAD
  2.11.2.9 REORG
  Add the new keyword SENSOR_PTRERR after SENSOR_DBREC.
  2.11.4.91 SENSOR
  Add the new keyword SENSOR_PTRERR in the Related keywords after
  SENSOR_DBREC.
  Modify the following description as follows:
  Before:
   Sensor data from the following areas is not stored:
     .Areas that have pointer errors
  After:
   Sensor data from the following areas is not stored:
     .Areas that have pointer errors, and SENSOR_PTRERR=YES is
      not specified
  Add the description of the new keyword SENSOR_PTRERR as follows:
  2.11.4.X SENSOR_PTRERR
  Use the SENSOR_PTRERR keyword to specify whether to
  store the sensor data in the Sensor Data repository of IMS
  Tools KB when the pointer errors are detected in the area.
  SENSOR_PTRERR is an optional keyword for the following commands:
   .ANALYZE
   .CHANGE
   .RELOAD
   .REORG
  Related keywords:SENSOR
    Format:
     SENSOR_PTRERR=parameter
    parameter
      parameter can be one of the following values:
      NO      Does not store the sensor data in the Sensor Data
              repository of IMS Tools KB when the pointer errors
              are detected in the area.
      YES     Store the sensor data in the Sensor Data
              repository of IMS Tools KB even though the pointer
              errors are detected in the area.
    Default:NO
      Site default support: Supported.
  2.12.3 Processing report
  Figure 125, 126, 128, 129
  Add SENSOR_PTRERR: NO in the PROCESSING OPTION after
  SENSOR_DBREC: NO.
  2.12.5 Largest Database Records report
  Figure 159
  Add DSNAME, DDNAME, DSTYPE, and IC TIMESTAMP(if any)
  at the header of LARGEST DATABASE RECORDS REPORT.
  2.12.17
  Figure 177, 178
  Add SENSOR_PTRERR after SENSOR_DBREC with the same values of
  SENSOR_DBREC.
  2.13.1
  Table 53
  ANALYZE
  Add SENSOR_PTRERR after SENSOR_DBREC
  CHANGE
  Add SENSOR, SENSOR_DBREC, SENSOR_PTRERR, SENSOR_UOW,
  SENSOR_UOW_REPORT before SSP
  RELOAD
  Add SENSOR, SENSOR_DBREC, SENSOR_PTRERR, SENSOR_UOW,
  SENSOR_UOW_REPORT before SORT
  REORG
  Add SENSOR, SENSOR_DBREC, SENSOR_PTRERR, SENSOR_UOW,
  SENSOR_UOW_REPORT at the end
  4.2.8 Utility control statements for OPC
  Table 101. ANALYZE statement keywords
  4.5.7 Utility control statements for OER
  Table 122. PTRCHK statement keywords
  Add the following new keyword and its description after
  SENSOR_DBREC:
  SENSOR_PTRERR  An optional keyword that specifies whether to
                 store the sensor data in the Sensor Data
                 repository of IMS Tools KB when the pointer
                 errors are detected in the area.
  4.7.2.1 ANALYZE
  4.7.2.9 PTRCHK
  Add the new keyword SENSOR_PTRERR after SENSOR_DBREC.
  4.7.3.81 SENSOR
  Modify the following description as follows:
  Before:
   Sensor data from the following areas is not stored:
     .Areas that have pointer errors
  After:
   Sensor data from the following areas is not stored:
     .Areas that have pointer errors, and SENSOR_PTRERR=YES is
      not specified
  Add the description of the new keyword SENSOR_PTRERR as follows:
  4.7.3.x    SENSOR_PTRERR
  SENSOR_PTRERR
    The SENSOR_PTRERR specifies whether to store the sensor data
    in the Sensor Data repository of IMS Tools KB when the
    pointer errors are detected in the area.
    SENSOR_PTRERR is an optional keyword for the following
    statements:
      . ANALYZE statement of OPC
      . PTRCHK statement of OER
    Related keywords:SENSOR
    Format:
     +---------------------------------------------------------+
     |                                                         |
     |  >>---SENSOR_PTRERR=---NO------><                       |
     |                      |_YES_|                            |
     +---------------------------------------------------------+
      The variable fields are defined as follows:
      NO      Does not store the sensor data in the Sensor Data
              repository of IMS Tools KB when the pointer errors
              are detected in the area.
      YES     Store the sensor data in the Sensor Data
              repository of IMS Tools KB even though the pointer
              errors are detected in the area.
    Default:NO, if the SENSOR_PTRERR keyword is not specified.
    Site default support: Supported.
    Restriction: The SENSOR PTRERR keyword can be specified only
    in FPXIN.
  The IMS Fast Path Solution Pack for z/OS Version 1 Release 2
  IMS Solution Packs Database Sensor User's Guide
  (SC19-3283-00).
  3.4.1 EXEC and DD statements for FP Stand-alone DB Sensor
  area ddname
  Delete the following description:
    Restriction: You cannot specify an image copy data set
    for this DD.
  

APAR Information

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

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

  UK92969

Modules/Macros

• FPXUAL0A FPXUAL0B FPXUAL0C FPXUAL0D FPXUCAR0
  FPXUCA00 FPXUCKE0 FPXUCPR0 FPXUSNB0 HFPA5LR0 HFPA5T10 HFPCCDT0
  HFPCDEF0 HFPFAAL0 HFPGULM0 HFPLCC40 HFPLSNC0 HFPOSNW0 HFPQMCC0
  HFPTAAL0
  

Fix information

• Fixed component name

  IMS FP SOLUTION

• Fixed component ID

  5655W1400

Applicable component levels

• R120 PSY UK92969

     UP13/03/29 P F303

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.