PM39839: TRACE ENTRIES AP 0492 AND AP 0493 WHEN FC IS SET TO 1-2 NEED TO RETURN THE RECORD KEY AND THIS APAR IS TO ADD THAT FIELD.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The trace entry AP 0492 and AP 0493 should contain the record
  key when FC level is set to 1-2. This APAR will result in the
  RECORD KEY being part of the trace entry when 1-2 is turned on
  for FC.
  .
  Additional Symptom(s) Search Keyword(s):
  KIXREVCTC
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Add the VSAM RIDFLD to trace entries    *
  *                      AP 0492 and AP 0493 as field Data 3     *
  *                      when FC level 2 trace is active.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  To help customers to debug VSAM File Control problems, the
  RIDFLD value has been added as Data 3 to trace entries AP 0492
  and AP 0493 when they are formatted by DFHTU410 as FULL, or by
  DFHPD410 as TR=2 or TR=3.
  
  The RIDFLD is the KEY for a KSDS or PATH, the RBA for ESDS and
  the RRN for RRDS.
  
  To activate these trace entries, either set FC=1-2 using CETR,
  or use SIT OVERRIDE STNTRFC=(1,2).
  
  CICS will only add Data 3 to the AP 0492 entry if it is a:
  
  . DELETE
  . READ
  . STARTBR
  . WRITE
  
  CICS will also limit a KEY to the size specified in KEYLENGTH().
  If KEYLENGTH(0) is used, CICS will change it to KEYLENGTH(1)
  as VSAM requires a minimum of 1 byte.
  
  CICS will only add Data 3 to the AP 0493 entry if there is no
  error and the type of request is:
  
  . READ for ESDS, KSDS, PATH or RRDS
  . WRITE for a new ESDS record
  

Problem conclusion

• DFHFCVR has been changed to produce the enhanced trace entries.
  
  Manual SX33-6108-06 CICS Transaction Server for VSE/ESA Trace
  Entries Release 1 Table 35 File Control Trace Points on
  page 33 has been changed:
  
  Point ID Module  Lvl   Type              Data
  AP 0492  DFHFCVR FC 2  Before VSAM call  1 RPL
                                           2 Address of RPL
                                           3 RIDFLD
  AP 0493  DFHFCVR FC 2  After VSAM call   1 RPL
                                           2 Address of RPL
                                           3 RIDFLD
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK80481

Modules/Macros

•    DFHFCVR
  

Fix information

• Fixed component name

  CICSTS FOR VSE

• Fixed component ID

  564805400

Applicable component levels

• RB0P PSY UK80481

     UP12/07/30 P E512

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.