IBM Support

PM06627: THE XFCSREQC GLOBAL USER EXIT'S UEFACBCP POINTER MAY POINT TO UNPREDICTABLE DATA FOR UMDTS AFTER THE INITIAL OPEN.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • The XFCSREQC exit supplies the UEFACBCP field that contains an
    address of a read-only copy of the ACB for a VSAM file.  If the
    file is a User Maintained Data Table and it is opened again
    after the initial data table load designated by a DFHFC0941I
    message, the UEFACBCP will point to unpredictable data.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All.                                         *
    ****************************************************************
    * PROBLEM DESCRIPTION: UEFACBCP takes a copy of low core       *
    *                      rather than of an ACB for User          *
    *                      Maintained Data Table files.            *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    When using global user exit XFCSREQC, the value in UEFACBCP
    is not always valid.
    If exit XFCSREQC has run for a UMDT file then an ACB will only
    be valid for the duration of the load. If XFCSREQC is driven
    after the load completes, the storage addressed by the ACB is
    reset to nulls. As such when UEFACBCP is created, it can take a
    copy of low core storage. This can lead to unpredictable results
    if UEFACBCP is used.
    

Problem conclusion

  • DFHUEFDS has been altered to create two new access method
    indicators called UEFDTBL and UEFDTUM.
    DFHFCFS has been altered to set UEFDTBL and UEFDTUM both on if
    the file being used is a user maintained data table.
    These flags can now be tested before using UEFACBCP.
    
    The CICS Transaction Server for z/OS, Version 4 Release 1,
    Customization Guide, SC34-7001-00, Chapter 1. Global user exit
    programs, section Global user exit points by functional area,
    subsection File control file state program exits XFCSREQ and
    XFCSREQC has been altered in the following three ways.
    1. Section EXIT XFCSREQ, Exit-specific parameters, UEFDSACC has
    two new possible values -
    UEFDSACC
     One byte indicating the access method of the file. The
     possible values are:
     UEFVSAM
      VSAM file
     UEFBDAM
      BDAM file.
     UEFDTBL
      Data table file.
     UEFDTUM
      User data table file.
    
    2. Section EXIT XFCSREQC, Exit-specific parameters, UEFDSACC has
    two new possible values -
    UEFDSACC
     One byte indicating the access method of the file. The
     possible values are:
     UEFVSAM
      VSAM file
     UEFBDAM
      BDAM file.
     UEFDTBL
      Data table file.
     UEFDTUM
      User data table file.
    
    3. Section EXIT XFCSREQC, Exit-specific parameters, UEFACBCP has
    been altered.
    UEFACBCP
     Address of a read-only copy of the ACB for a VSAM file, or
     the DCB for a BDAM file. Set only after completion of a
     successful open.
     If UEFDTBL and UEFDTUM have been set on, then the storage
     addressed by UEFACBCP is undefined. This pointer should not be
     used.
    
    The CICS Transaction Server for z/OS, Version 4 Release 1,
    Data Areas, GC34-7014-00, Section UEFD User exit file and
    dataset information has been altered in the following two ways.
    1. There are two more access method indicators.
    Offset Hex | Type      | Len | Name (dim) |  Description
    ----------------------------------------------------------
                     Access Method Indicator
    ----------------------------------------------------------
    (38)       | BITSTRING | 1   | UEFDSACC   | Access Method
    (38)       | BITSTRING | 0   | UEFVSAM    | "X"80"" Vsam
    (38)       | BITSTRING | 0   | UEFBDAM    | "X"40"" Bdam
    (38)       | BITSTRING | 0   | UEFDTBL    | "X"20"" Data table
    (38)       | BITSTRING | 0   | UEFDTUM    | "X"10"" User data
                                                              table
    
    2. Comment associated with UEFACBCP has been updated.
    Offset Hex | Type      | Len | Name (dim) |  Description
    ----------------------------------------------------------
     Address of read only copy of ACB
     This address is only set up when calling the XFCSREQC user exit
     after the completion of a successful OPEN request.
     This field contains zero in all other cases.
     Note: If UEFDTBL and UEFDTUM has been set on, then the
     storage addressed by UEFACBCP is undefined.
    ----------------------------------------------------------
    (64)       | ADDRESS   | 4   | UEFACBCP   | Address of copy of
                                                                 ACB
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM06627

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    600

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2010-02-03

  • Closed date

    2010-02-12

  • Last modified date

    2010-03-01

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

    PM00494

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

    UK54301

Modules/Macros

  • DFHFCFS  DFHUEFDS
    

Publications Referenced
SC34700100GC34701400   

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R600 PSY UK54301

       UP10/02/17 P F002

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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
01 March 2010