A fix is available
APAR status
Closed as program error.
Error description
The customer has a Java application running inside of Liberty that is called via a REST API. The request includes the key of a record to read from a VSAM KSDS. If the incoming request includes a key that doesn't exist in any of the records in the file, they find that in CICS 6.1 the first record in the file is returned instead of a NOTFND response. The ksds.read request in their application includes the EQUALS condition yet a CICS trace shows KEY_COMPARISON(GTEQ) : AP 0B71 FCRS ENTRY - FUNCTION(READ_SET) FILE_NAME(xxxxxxx) ENVIRONMENT_IDENTIFIER(00000000) FCTE_POINTER(xxxxxxxx) RECORD_ID_ADDRESS(xxxxxxxx) WORK_ELEMENT_ADDRESS(xxxxxxxx) RECORD_ID_LENGTH(A) GENERIC(NO) KEY_COMPARISON(GTEQ) READ_INTEGR1TY(FCT_VALUE) RECORD_ID_TYPE(KEY) CONDITIONAL(NO) BYPASS_SECURITY_CHECK(NO)
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users. * **************************************************************** * PROBLEM DESCRIPTION: Using a KSDS read within a JCICS * * application returns a record instead * * of giving a RecordNotFoundException. * **************************************************************** A Java application attempts to use a KSDS command to read a record. The passed in key does not exist within the file and a RecordNotFoundException is not returned as expected. Unexpected responses may be received instead.
Problem conclusion
CICS has been updated to return a RecordNotFoundException when the record attempting to be read through a JCICS application does not exist.
Temporary fix
Comments
APAR Information
APAR number
PH60383
Reported component name
CICS TS Z/OS V6
Reported component ID
5655YA100
Reported release
400
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2024-03-15
Closed date
2024-06-18
Last modified date
2024-07-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI97369
Modules/Macros
DFJ@H608 DFJ@H609
Fix information
Fixed component name
CICS TS Z/OS V6
Fixed component ID
5655YA100
Applicable component levels
R400 PSY UI97369
UP24/06/19 P F406 ¢
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":"BU048","label":"IBM Software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"6.1","Line of Business":{"code":"LOB70","label":"Z TPS"}}]
Document Information
Modified date:
02 July 2024