z/OS Java module is not program controlled

If, after starting your application in z/OS, you see the Not Marked Program Controlled messages or errors with the return code 139:

BPXP015I HFS PROGRAM /tmp/libdynatrace-oneagent-odin-java5848811742465559217.so
IS NOT MARKED PROGRAM CONTROLLED.

You need to enable program control for the z/OS Java module. To do so

  1. Expand dynatrace-oneagent-zos-java.jarthat you downloaded into a program controlled folder.

  2. Mark the appropriate .so file (31 or 64-bit) in the lib/zos-s390/ directory as program-controlled

    1. Switch to the path that contains the .sofiles.

    2. Issue the following command using the 31- or 64-bit file:

      extattr +p libdynatrace-oneagent-odin-java_64.so​
      
  3. Add zos-native-library-override to your JVM argument.

    -javaagent:/PATH_TO/dynatrace-oneagent-zos-java.jar=zos-native-library-override=<PATH_TO_SO>/libdynatrace-oneagent-odin-java_64.so
    

    Where:
    <PATH_TO_SO> is the path to your JAR file.
    <PATH_TO_SO> is the absolute path to the .so file that you want to control.

  4. Restart your application server.

1 Like