PM50736: NEW FUNCTION FOR FPSP V1.2 AS DESCRIBED IN THE ERROR DESCRIPTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides the following new functionality:
  1) FPA Analyze and OPC store historical records with UOW
     information in Statistics History2 data set.
  2) FPA Analyze and OPC store sensor data with UOW or UOW Group
     information in IMS Tools KB Sensor Data Repository.
  3) OPC and OER store sensor data in IMS Tools KB Sensor Data
     Repository.
  4) FP DB sensor printing utility generates SENSOR DATA
     STATISTICS REPORT including UOW or UOW group data.
  5) OPC and OER generate LARGEST DATABASE RECORDS REPORT.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS FP Solution Pack Version 1  *
  *                 Release 2 (HAHQ120)                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: GA PTF of IMS FP Solution Pack Version  *
  *                      1 Release 2                             *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  1. FPA Analyze and OPC store historical records with UOW Group
  information in Statistics History2 data set.
  
  2. FPA Analyze and FP Stand-alone DB Sensor with SENSOR_UOW=YES
  keyword store sensor data with UOW or UOW Group information in
  IMS Tools KB Sensor Data Repository.
  
  3. OPC and OER store sensor data in IMS Tools KB Sensor Data
  Repository when following conditions are met:
    1. FULLSTEP=YES, TYPRUN=RPT, and SENSOR=YES are all specified.
    2. ITKBSRVR is specified correctly.
    3. ITKB product library is specified at STEPLIB DD.
    4. PTRCHK=YES and CHKUOW=ALL is specified (for OER only).
  
  4. FP DB sensor printing utility generates SENSOR DATA
  STATISTICS REPORT from information in IMS Tools KB Sensor Data
  Repository. Specify UOW_REPORT=YES when Sensor Data with UOW or
  UOW Group information on SENSOR DATA STATISTICS REPORT is needed
  
  5. OPC and OER generate LARGEST DATABASE RECORDS REPORT.
  In case OPC generates LARGEST DATABASE RECORDS REPORT,
  the new keyword LARGEREC_REPORT=YES must be specified with
  REPORT control statement, TYPERUN=RPT and FULLSTEP=YES keywords
  must be specified with ANALYZE control statement.
  In case OER generates LARGEST DATABASE RECORDS REPORT,
  the new keyword LARGEREC_REPORT=YES must be specified with
  REPORT control statement, TYPERUN=RPT, FULLSTEP=YES and
  CHKUOW=ALL keywords with PTRCHK control statement.
  
  6. Sample JCLs, HFPOJCL1 and HFPSCTL0 provide a user a
  jumpstart to using FP Stand-alone DB Sensor.
  
  * Must have following APAR in order to use HPIC Sensor function:
  IMS High Performance Image Copy Version 4 Release 2 (5655-N45):
  PM50159
  
  * This APAR supports the forward fit for the following IMS
  Fast Path Solution Pack V1R1 APARs:
      1. FPSI Analyze enhancement (PM47338)
      2. /CK in SRCH field (PM49526)
      3. HD Unload file data truncated (PM52138)
  

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).
  
  Chapter 5. Reloading a DEDB offline with FPA
  5.5 DD statements for the Reload process
  
  The following information is added at HFPAUOWC DD:
    Notes that a range of UOW numbers of an area can be in any
    order but area number must be in the ascending order.
  
  Chapter 6. Changing a DEDB offline with FPA
  6.5 DD statements for the Change process
  
  The following information is added at HFPAUOWC DD:
    Notes that a range of UOW numbers of an area can be in any
    order but area number must be in the ascending order.
  
  Chapter 7. Reorganizing a DEDB offline with FPA
  7.6 DD statements for the Reorg process
  
  The following information is added at HFPAUOWC DD:
    Notes that a range of UOW numbers of an area can be in any
    order but area number must be in the ascending order.
  
  Chapter 8. Analyzing a DEDB offline with FPA
  8.5 DD statements for the Analyze process
  
  The following information is added at HFPAUOWC DD:
    Notes that a range of UOW numbers of an area can be in any
    order but area number must be in the ascending order.
  
  Chapter 12. Command reference for FPA
  12.4 FPA keywords
  
  IAREA
   The following description is added as the description of Format
   areaname must be in the ascending order of area number when
   HFPAUOWC DD is specified.
  
  SENSOR_DBREC
   The following description is deleted as the description for YES
    SENSOR_DBREC=YES is mutually exclusive with SENSOR=NO or
    PTRCHKLVL=QUICK.
   The following description is added as the description for YES
    SENSOR=YES and PTRCHKLVL=FULL are required when
    SENSOR_DBREC=YES is specified.
    SENSOR_DBREC=YES is required when SENSOR_UOW=YES is specified.
  
  SENSOR_UOW
   The following description is deleted as the description for YES
    SENSOR_UOW=YES is mutually exclusive with SENSOR=NO.
   The following descriptiona are added as the description for YES
    SENSOR=YES and SENSOR_DBREC=YES are required when
    SENSOR_UOW=YES is specified.
    SENSOR_UOW=YES is required when SENSOR_UOW_REPORT=YES is
    specified.
  
  SENSOR_UOW_REPORT
   The following description is deleted as the description for YES
    SENSOR_UOW_REPORT=YES is mutually exclusive with SENSOR_UOW=NO
   The following description is deleted as the description for YES
    SENSOR_UOW=YES is required when SENSOR_UOW_REPORT=YES is
    specified.
  
  Chapter 24. Analyzing a DEDB online with FPO
  Figure 295. Running cross-reference validation of pointers,
  generating analysis reports, and storing sensor data in the
  IMS Tools KB repository
  
    DBRC=YES, RECON DD, and STEPLIB DD are added in sample JCL.
  
    //ANALYZE     EXEC FPUTIL,DBD=DEDBJN23,IMSID=IMS1
    //*
    //FPU.STEPLIB DD DISP=SHR,DSN=HPFP.SHFPLMD0
    //            DD DISP=SHR,DSN=IMSVS.SDFSRESL
  | //            DD DISP=SHR,DSN=ITB.SHKTLOAD
    //FPXMFILE    DD SYSOUT=*
    //FPXRPTS     DD SYSOUT=*
    //FPXSPRT     DD SYSOUT=*
  | //RECON1      DD DISP=SHR,DSN=IMSVS.RECON1
  | //RECON2      DD DISP=SHR,DSN=IMSVS.RECON2
  | //RECON3      DD DISP=SHR,DSN=IMSVS.RECON3
    //FPXIN       DD *
      GLOBAL
  |     DBRC=YES,
        ITKBSRVR=FPQSVR01,
        ADXCFGRP=ADSVR01
      ANALYZE
        AREA=ALL,
        TYPRUN=RPT,
        FULLSTEP=YES,
        SENSOR=YES,
        SENSOR_DBREC=YES
    /*
  
  Chapter 27. Reorganizing a DEDB online with FPO
  Figure 337. Running OER with OPC and storing sensor data in
  the IMS Tools KB repository
  
    DBRC=YES, RECON DD, and STEPLIB DD are added in sample JCL.
  
    //REORG       EXEC FPUTIL,DBD=DEDBJN23,IMSID=IMS1
    //*
    //FPU.STEPLIB DD DISP=SHR,DSN=HPFP.SHFPLMD0
    //            DD DISP=SHR,DSN=IMSVS.SDFSRESL
  | //            DD DISP=SHR,DSN=ITB.SHKTLOAD
    //FPXMFILE    DD SYSOUT=*
    //FPXRPTS     DD SYSOUT=*
    //FPXSPRT     DD SYSOUT=*
  | //RECON1      DD DISP=SHR,DSN=IMSVS.RECON1
  | //RECON2      DD DISP=SHR,DSN=IMSVS.RECON2
  | //RECON3      DD DISP=SHR,DSN=IMSVS.RECON3
    //FPXIN       DD *
      GLOBAL
  |     DBRC=YES,
        ITKBSRVR=FPQSVR01,
        ADXCFGRP=ADSVR01
      REORG
        AREA=ALL,
        PTRCHK=YES
      PTRCHK
        TYPRUN=RPT,
        CHKUOW=ALL,
        FULLSTEP=YES,
        SENSOR=YES,
        SENSOR_DBREC=YES
    /*
  
  Chapter 29. Keyword reference for FPO
  29.3 FPO keywords
  
  LARGEREC_REPORT
   The abbreviations for YES and NO are added as follows.
    YES Generate the Largest Database Records report.
  |     You can specify just Y rather than YES.
    NO  Do not generate the Largest Database Records report.
  |     You can specify just N rather than NO.
  
  SENSOR_DBREC
   The following restriction is deleted:
   - SENSOR_DBREC=YES is mutually exclusive with SENSOR=NO.
   The following new restrictions are added:
   - SENSOR=YES is required when SENSOR_DBREC=YES is specified.
   - SENSOR_DBREC=YES is required when SENSOR_UOW=YES is specified
  
  SENSOR_UOW
   The following restrictions are deleted:
   - SENSOR_UOW=YES is mutually exclusive with SENSOR=NO.
   - SENSOR_UOW=NO is mutually exclusive with
     SENSOR_UOW_REPORT=YES.
   The following new restrictions are added:
   - SENSOR=YES and SENSOR_DBREC=YES are required when
     SENSOR_UOW=YES is specified.
   - SENSOR_UOW=YES is required when SENSOR_UOW_REPORT=YES is
   specified.
  
  SENSOR_UOW_REPORT
   The following restriction is deleted:
   - SENSOR_UOW_REPORT=YES is mutually exclusive with
     SENSOR_UOW=NO.
   The following new restriction is added:
   - SENSOR_UOW=YES is required when SENSOR_UOW_REPORT=YES is
     specified.
  
  Chapter 46. DEDB monitoring and tuning guide
  Figure 513. Online Expert Reorganization example 7: Generating
  reports to obtain large database records information
  
    FULLSTEP=YES is added in PTRCHK subcommand.
  
  //FPXIN DD *
    REORG AREA=(DB22AR0,DB22AR1),
       PTRCHK=YES
    PTRCHK
       TYPRUN=RPT,
  |    FULLSTEP=YES,
       CHKUOW=ALL
     REPORT LARGEREC_REPORT=YES
  /*
  
  The IMS Fast Path Solution Pack Database Sensor User's
  Guide (SC19-3283-00).
  
  Chapter 13. FP Stand-alone DB Sensor JCL and control
  statements
  13.1 EXEC and DD statements for FP Stand-alone DB Sensor
  
  The following description is added at HFPAUOWC DD:
    Each record must be in the ascending order of area number.
  
  13.3 GLOBAL command keywords for FP Stand-alone DB Sensor
  
  The following description is added as the description for
  SENSOR_UOW=YES.
   SENSOR_DBREC=YES is required when SENSOR_UOW=YES is specified.
  The following description is added as the description for
  SENSOR_UOW_REPORT=YES.
   SENSOR_UOW=YES is required when SENSOR_UOW_REPORT=YES is
   specified.
  
  13.4 DATABASE command keywords for FP Stand-alone DB Sensor
  
  The following description is added in the description of IAREA=.
   area_name must be in the ascending order of area number when
   HFPAUOWC DD is specified.
  
  Chapter 15. Setting site default values for FP Stand-alone DB
     Sensor
  The following description in Figure 39 prolog should be
  modified:
  
   Description:
               This JCL generate a site default module HFPSCTL0
               which can be used by FP Stand-alone DB Sensor.
  
   1. The job statement should be modified to suit your
      environment.
  
   2. Substitute your dsname high level qualifier (HLQ)
      for IMS FP Solution Pack data sets for the
      string "$hfphlq.SHFPLMD0".
      change  $hfphlq.SHFPLMD0 to your_hfp_hlq.SHFPLMD0
  
   B) Specify commands and keywords to define the site
      default values on HFPCRE.HFPSYSIN DD statement.
  

APAR Information

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

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

Modules/Macros

• FABAHEXT FPXADBR0 FPXANAL0 FPXAPRCA FPXAPRCB
  FPXAPRCC FPXASCP0 FPXATA00 FPXATO00 FPXAUCS0 FPXAURT0 FPXAWMV1
  FPXMBLK0 FPXMSG00 FPXOPEN1 FPXSADB0 FPXUCA00 FPXUCIO0 FPXUCKE0
  FPXUCM00 FPXUCPR0 FPXUGBB0 FPXUGBD0 FPXUGBK0 FPXUGRP0 FPXUGRS0
  FPXUIOB0 FPXUSNB0 FPXXRGE0 HAHQ120J HFPASCP0 HFPASNB0 HFPASNF0
  HFPAS1D0 HFPAS1R0 HFPA1TR0 HFPA5CC0 HFPA5GU0 HFPA5H20 HFPA5IN0
  HFPA5PF0 HFPA5T10 HFPA5T20 HFPA5T30 HFPA5W00 HFPA5000 HFPBRCP0
  HFPBRDC0 HFPBRDI0 HFPBRDO0 HFPBRMN0 HFPCCCT0 HFPCCDS0 HFPCCDT0
  HFPCDDT0 HFPCDEF0 HFPCFNL0 HFPCITKB HFPEREC0 HFPFADC0 HFPFANA0
  HFPFSNC0 HFPLCC20 HFPLMAN0 HFPLSIM0 HFPLSIN0 HFPLSNC0 HFPMTRM0
  HFPOA500 HFPOJCL1 HFPOSNI0 HFPOSNR0 HFPOSNT0 HFPOSNW0 HFPQACT0
  HFPQADA0 HFPQA1I0 HFPQA1T0 HFPQA5I0 HFPQA500 HFPQFAD0 HFPQFAH0
  HFPQFAN0 HFPQFSN0 HFPQMAI0 HFPQMCC0 HFPQMLO0 HFPRCDB0 HFPSCTL0
  HFPSGIMC HFPSPANA HFPSPMST HFPSPPRT HFPSPRDF HFPSPRNT HFPSPSDD
  HFPSPSDS HFPSPSTD HFPUMVT0 HFPUROB0 HFPUSNC0 HFPWMTA0 HFPWMTO0
  

Fix information

• Fixed component name

  IMS FP SOLUTION

• Fixed component ID

  5655W1400

Applicable component levels

• R120 PSY UK74826

     UP11/12/21 P F112

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.