IBM Support

PM52290: DOCUMENTATION UPDATE FOR IMPROVEMENTS TO JAVA 7 API FOR ZFILE.OBTAINDSN()

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

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

Local fix

  • N/A
    

Problem summary

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

Problem conclusion

Temporary fix

Comments

APAR Information

  • APAR number

    PM52290

  • Reported component name

    JAVA Z/OS 31

  • Reported component ID

    620700105

  • Reported release

    700

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-11-15

  • Closed date

    2011-11-21

  • Last modified date

    2011-11-21

  • 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 31

  • Fixed component ID

    620700105

Applicable component levels

  • R700 PSY

       UP



Document information

More support for: Runtimes for Java Technology
z/OS Exensions

Software version: 700

Reference #: PM52290

Modified date: 21 November 2011