IBM Support

PH11831: JAVA.LANG.UNSATISFIEDLINKERROR CAUSED BY INCORRECT HOME DIRECTORY IN OMVS SEGMENT

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as user error.

Error description

  • Users running sdk for Java on z/OS PTFs from JCL after:
    Java 8 SR5 FP15
    might encounter a
      java.lang.UnsatifiedLinkError
    Exception documenting that the jvm is unable to load a Java
    native method. Here follows an example Exception:
    
    java.lang.UnsatisfiedLinkError:
    com/ibm/jzos/ZFile.fopen(Ljava/lang/String;Ljava/lang/String;)J
        at com.ibm.jzos.ZFile.doZFileOpen(ZFile.java:613)
        at com.ibm.jzos.ZFile.<init>(ZFile.java:476)
        at com.ibm.jzos.ZUtil$1.run(ZUtil.java:702)
        ...
    
    There are a number of possible reasons for an
      java.lang.UnsatisfiedLinkError
    such as mismatched maintenance and incorrect file permissions.
    In this case, the root cause is an issue with the HOME directory
    in the OMVS segment of the User Profile. It might be that the
    HOME diredctory zfs doesn't exist, that the file system is not
    mounted, that the directory permissions make it inaccessable for
    this user or a similar reason.
    Please review this and correct.
    
    To confirm that this is the issue please check that you are
    using an sdk for Java PTF later than Java 8 SR5 FP15.
    (1) Run "omvs" from TSO.
    If the HOME directory in the OMVS segment is incorrectly
    set, "omvs" will fail with an explanation.
    The root cause of "omvs" failing is the same as for
    java.lang.UnsatisfiedLinkError.
    (2) Also, you might find that some ids work whereas other(s)
    don't.
    This indicates that the root cause is a configuration issue with
    the account.
    

Local fix

  • Add valid HOME directory to the omvs segment of the user
    profile.
    

Problem summary

Problem conclusion

Temporary fix

Comments

  • Please correct HOME directory in omvs segment of the user
    profile
    

APAR Information

  • APAR number

    PH11831

  • Reported component name

    JAVA Z/OS 64

  • Reported component ID

    620700104

  • Reported release

    800

  • Status

    CLOSED USE

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-05-08

  • Closed date

    2019-05-08

  • Last modified date

    2019-06-25

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"800","Edition":"","Line of Business":{"code":"LOB16","label":"Mainframe HW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"800","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
09 August 2022