IBM Support

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.

A fix is available

Subscribe

You can track all active APARs for this component.

 

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 number

    PM39839

  • Reported component name

    CICSTS FOR VSE

  • Reported component ID

    564805400

  • Reported release

    B0P

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-05-23

  • Closed date

    2012-07-23

  • Last modified date

    2013-04-23

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

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

    UK80481

Modules/Macros

  •    DFHFCVR
    

Publications Referenced
SX33610806    

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.

[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.1","Edition":""}]

Document Information

Modified date:
23 April 2013