PH59343: THE JZOS ZFILE.LOCATE AND LOCATEUNLOCKED METHODS RETURN DO NOT DISTINGUISH BETWEEN A RECORD NOT FOUND IN DATASET AND DATA SET IS

APAR status

• Closed as program error.

Error description

• Error Message: When the JZOS ZFile.locate() or
  ZFile.locate_unlocked() methods are called to locate a record in
  a data set the method returns 'false' in the case where the data
  set was searched and the record was not found, and also returns
  'false' when the data set could not be searched because it was
  closed prior to being searched for the record.
  .
  Stack Trace: N/A
  .
  

Local fix

Problem summary

• The JZOS ZFile.locate and locateUnlocked methods return do not
  distinguish between a record not found in dataset and data set
  is closed. The methods call the underlying C library APIs. In
  both cases, when the record being searched for is not found in
  the data set or when the data set is closed and cannot be
  searched, the APIs return a value of -1, which does not allow
  the caller to distinguish between the two failure causes. In the
  case where the data set cannot be searched because it is closed
  the C APIs sets an EBADF errno, but JZOS does not propagate that
  back to the user.
  

Problem conclusion

• The fix is to throw a Java ErrnoException in the case where the
  the C APIs sets an EBADF errno when the locate or locateUnlocked
  call fails because the data set cannot be searched because it is
  closed.
  .
  This APAR will be fixed in the following Releases:
  .
  IBM Semeru Runtimes
     11              11.0.23.0
     17              17.0.11.0
  IBM SDK, Java Technology Edition
     8    SR8 FP25  (8.0.8.25)
  .
  Downloads and supplementary documentation can be found at the
  following locations:
  - For the z/OS operating system:
    - Java SDK Products on z/OS
      https://www.ibm.com/support/pages/java-sdk-products-zos
  

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:

Fix information

• Fixed component name

  JAVA Z/OS 64

• Fixed component ID

  620700104

Applicable component levels