PM34138: ZFILE.EXISTS() THROWS AN EXCEPTION WHEN GIVEN A RECFM=U PDSE DAT ASET

APAR status

• Closed as program error.

Error description

• Error Message: When testing for the existence of a load module
  using ZFile.exists(), an exception is generated. The dataset
  used is a RECFM=U PDSE.
  Exception in thread "main" java.lang.IllegalArgumentException:
  JRIO
     parameter <OSB>String recordFormat<CSB> must be FB or VB.
  recordFormat=U
     at
  com.ibm.recordio.os390nonvsam.DataSetName.setInternalRecordInfo(
  DataSetName.java:700)
     at
  com.ibm.recordio.os390nonvsam.RecordFile.checkForExistingFile(Re
  cordFile.java:198)
     at
  com.ibm.recordio.os390nonvsam.RecordFile.<init>(RecordFile.java:
  94)
     at
  com.ibm.recordio.os390vsam.RecordFile.<init>(RecordFile.java:41)
     at
  com.ibm.recordio.os390vsam.FileFactory.getRecordFile(FileFactory
  .java:111)
     at
  com.ibm.recordio.driver.Configuration.getRecordFile(Configuratio
  n.java:226)
     at
  com.ibm.recordio.driver.Configuration.getRecordFile(Configuratio
  n.java:191)
             at
  com.ibm.recordio.RecordFile.getInstanceOf(RecordFile.java:84)
             at
  com.ibm.recordio.RecordFile.<init>(RecordFile.java:372)
     at
  com.ibm.jzos.JrioInterface.datasetOrMemberExists(JrioInterface.j
  ava:39)
             at com.ibm.jzos.ZFile.dsExists(ZFile.java:139)
             at com.ibm.jzos.ZFile.exists(ZFile.java:169)
             at DSExists2.main(DSExists2.java:5).
  .
  Stack Trace: N/A
  .
  

Local fix

Problem summary

• ZFile.exists() prior to JZOS version 2.4.0 only supports
  RECFM=FB and RECFM=VB datasets.
  

Problem conclusion

• This defect will be fixed in:
  5.0.0 SR12 FP4 (z/OS 31-bit)
  .
  Update the JZOS javadoc API and add a note to state that
  ZFile.exists() support is only limited to RECFM=FB and RECFM=VB
  for JZOS versions prior to version 2.4.0.
  .
  To obtain the fix:
  Install build 20101208 or later
  

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 5 Z/OS 31

• Fixed component ID

  620500105

Applicable component levels

• R500 PSN

     UP