A fix is available
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:
APAR is sysrouted TO one or more of the following:
UK54301
Modules/Macros
DFHFCFS DFHUEFDS
SC34700100 | GC34701400 |
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