PM52290: DOCUMENTATION UPDATE FOR IMPROVEMENTS TO JAVA 7 API FOR ZFILE.OBTAINDSN()
Closed as program error.
In Java 5 and Java 6, the ZFile.obtainDSN() API, a dummy value would be returned if the VSAM clusters did not have VTOC entries. Starting in Java 6.0.1 and Java 7, per the API, the function may return null: Returns: Format1DSCB an object which maps the fields in the Format1 VTOC entry for the dataset. Return null if dsn is on an EAV VTOC, or the DSCB is not on the VTOC. This APAR addresses a documentation change for the "Considerations" section of the documentation for Java 6.0.1 and Java 7 to document this new behavior.
In Java 5 and Java 6, the ZFile.obtainDSN() API would return a dummy DSCB value if VSAM clusters (which do not have DSCBs in the VTOC) are passed. Starting in Java 6.0.1 and Java 7, per the API, the function returns null for datasets which do not have DSCBs in the VTOC.
This defect will be fixed in: 7.0.0 SR1 (z/OS 31-bit) . The Java on z/OS online documentation has been updated to reflect this change in the JZOS ZFile.obtainDSN() API. In the "Compatibility" section for Java 7: http://www-03.ibm.com/systems/z/os/zos/tools/java/products/sdk7_ 31.html http://www-03.ibm.com/systems/z/os/zos/tools/java/products/sdk7_ 64.html In the "Version 6.0.1 Considerations" section for Java 6.0.1: http://www-03.ibm.com/systems/z/os/zos/tools/java/services/j6res trict31.html http://www-03.ibm.com/systems/z/os/zos/tools/java/services/j6res trict64.html
Reported component name
JAVA Z/OS 31
Reported component ID
Last modified date
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Fixed component name
JAVA Z/OS 31
Fixed component ID
Applicable component levels