A fix is available
APAR status
Closed as program error.
Error description
If VSAM requires additional storage when a request is issued from an L9 TCB the request is rejected with an 0878 response code. CICS will switch to the QR and retry. Whilst this normally works, VSAM can schedule ASY work on a TCB other than the one from which the request was made. can schedule ASY work on a TCB This means than it could schedule the retry which was issued on the QR TCB on an L9 TCB. This could therefore get another 0878. The solution proposed is to retry the work on QR with options SYN WTX. This would therefore prevent an 0878. The is an additional problem resulting from this solution which occurs if the file is NSR. NSR request cannot be SYN. Therefore we need to prevent NSR from causing the 0878 in the first place. The solution proposed is to run ALL NSR requests on the QR if storage protect is on.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users * **************************************************************** * PROBLEM DESCRIPTION: Transaction abends 0c4 with * * STGPROT=YES running on an open tcb * * against a file defined for NSR. * **************************************************************** * RECOMMENDATION: * **************************************************************** When running with STGPROT=YES a program running on an open TCB issuing a file control API request against a local NSR VSAM file can occasionally get an abend0c4 or an ILLOGIC response with an 0878 VSAM return code. If this isn't handled the transaction will abend AEIU. addition keywords offset X'FFFF' DFHFCVR AKEA s0c4 abends0c4 abendaeiu rc0878 FC0001 abendfc0001 RETRY_KEY9_REQUEST 0499 FCVR ED080078
Problem conclusion
VSAM returns an 0878 response if it is trying to get subpool 0 storage whilst in key 9. As L9, J9 etc TCBs don't support subpool 0 VSAM rejects the request. CICS will then retry on the QR TCB. For performance reasons VSAM can execute ASY requests on any available TCB, irrespective of the TCB on which they were issued. This means that a request issued on a QR TCB could be executed on a key 9 TCB and rejected 0878. To fix this when the system is defined with STGPROT=YES requests are issued with the SYN option. DFHFCVR has therefore been amended to run all NSR requests for STGPROT=YES on the QR TCB.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK51293
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2007-08-21
Closed date
2007-10-16
Last modified date
2007-11-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK30252
Modules/Macros
DFHFCFR DFHFCVR DFHFCVS
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R500 PSY UK30252
UP07/10/19 P F710
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":"3.2","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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 November 2007