PH60383: JCICS READ REQUEST RETURNS A RECORD FROM A VSAM KSDS INSTEAD OF A NOTFND RESPONSE

Obtain the fix for this APAR.

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 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.