PM01013: LONG-RUNNING FAST PATH TRANSACTIONS HAVE PROCESS TIMES THAT EXCEED THE COUNTER IN THE IMS LOG RECORD

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Processing time is kept in a 16-bit field in the x'5936' or
  x'5937' log record. Customer has raised User Marketing Field
  Requirement MR1022094529 to request another means of reporting
  process time.  We'll look to compute process time from event
  timestamps in IMS x'5901', x'5903', x'5936' and x'5937' log
  records when FLOMPRTM (x'5937') or FLDQPRTM (x'5936') = x'FFFF'
  indicating overflow.
  
  Two additional requirements being added via this APAR:
  1)  Provide the ability to store log reports in IMS Tools
      Knowledge Base ( ITKB ).
      IMSPA will provide updated ITKB "Product Definition Table"
      and sample job to load it into ITKB repository.
      We'll update IMSPA to use this new PDT and enable ITKB
      support on dialog panels.
  2)  Provide the ability to filter on PROGRAM in form-based
      reports for DBCTL logs.IMSPA does filter on TRANCODE,
      but that makes no sense in a DBCTL environment.
      Add code to form-based reports to allow for filtering on
      field PROGRAM.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IMS Performance Analyzer V4.2       *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1.Customer has long-running Fast Path   *
  *                       transactions whose process times       *
  *                       exceed the counter in the IMS log      *
  *                       record.                                *
  *                      2.Customers require ability to store    *
  *                       log reports in IMS Tools Knowledge     *
  *                       Base.                                  *
  *                      3.Customer requires ability to filter   *
  *                       on PROGRAM in form-based reports       *
  *                       for DBCTL logs.                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  1.Processing time is kept in a 16-bit field in the x'5936' or
   x'5937' log record. Customer has raised User Marketing Field
   Requirement MR1022094529 to request another means of
   reporting process time.
  2.IMS PA does not fully support storage of log reports in ITKB.
  3.IMS PA will filter on TRANCODE, but that makes no sense in a
   DBCTL environment.
  

Problem conclusion

Temporary fix

Comments

• 1.Compute process time from event timestamps in IMS x'5901' ,
  x'5903', x'5936' and x'5937' log records when FLOMPRTM (x'5937')
  FLDQPRTM (x'5936') = x'FFFF' indicating overflow.
  2.Provide updated ITKB "Product Definition Table" and sample job
  to load it into ITKB repository.  Update IMS PA to use this new
  PDT and enable ITKB support on dialog panels.
  3.You must run IPIDITKB sample to load new PDT after
  installing PTF if you wish to use ITKB.
  4.Add code to form-based reports to allow for filtering on
  field PROGRAM.
  

APAR Information

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

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

  UK52844

Modules/Macros

• H23K420J IPICPROC IPIDITKB IPIFPROC IPIGCEXF
  IPIGDISP IPIGDSPF IPIIPROC IPIITKB  IPIPLGAR IPISAPAR IPISBMPC
  IPISDLOC IPISFPIR IPISFPTR IPISIRUR IPISLGAR IPISRESP IPISTS00
  IPIZSJCL IPI4DMGR IPI4QMGR
  

Fix information

• Fixed component name

  IMS PERF ANALYZ

• Fixed component ID

  5655E1500

Applicable component levels

• R420 PSY UK52844

     UP09/12/18 P F912

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.