Troubleshooting the BMC AMI Ops user interface


Important

The information in this topic is relevant for version 1.1.00 of the BMC AMI Ops User Interface. If you are running version 2.0.00 of BMC AMI Ops User Interface, seeBMC AMI Ops UI 2.0.

To make sure that BMC AMI Ops User Interface receives and displays data, confirm the data collection configuration and the Java folder configuration.

Troubleshooting data collection configuration

To make sure that BMC AMI Ops User Interface receives expected data, configure the following for BMC AMI Ops User Interface and the BMC AMI Ops products:


Troubleshooting Java configuration

Issue

Your BMC AMI Ops UI job STDOUT log shows the following error message:

CEE3501S The module libjvm.so was not found.                                   
         From entry point JzosVM::initializeVMArgs() at compile unit offset +000 00094 at entry offset +00000094 at
         address 4310620C. 

Explanation

The error message indicates that the BMC AMI Ops UI environment is not correctly pointing to the Java 8 (31-bit or 64-bit) for one of the following reasons:

  1. You applied BP00471 and the IBM SDK Java 8.0 (31-bit or 64-bit) is not in the default /usr/lpp/java/J8.0 directory.
  2. Your server is pointing to the correct Java directory, but updates to the Java package changed the Java SDK library location in your mainframe.

Resolution

To resolve this error if you have not yet applied PTF BP00471, apply the PTF and restart the server.

If you still see the error, your server is probably not in the default directory. Perform the following steps:

  1. Open the MUXSYMLK job and update the installation path for the BMC AMI Ops UI.
    Use the absolute path to the Java 8 (31-bit or 64-bit) directory in your environment.
  2. Run the MUXSYMLK job and make sure it executes with return code 0.
  3. Restart the started task for the BMC AMI Ops UI.

Troubleshooting Java Virtual Machine heap size

Issue

You get the following error when working on a view:

AMI OPS UI / MUXTC: "java/lang/OutOfMemoryError" at 2022/11/23 12:48:21 - please wait.

Explanation

The parameter for Java Virtual Machine (JVM) heap size is set to a min of 256m and a max of 512m as the default memory. When MUXTC runs out of memory the error message is displayed.

Resolution

Increase the JVM heap size that is located in the BMCSAMP dataset in MUXTCENV member.

  1. To increase the JVM heap size, in the following default parameter:

    IJO="$IJO -Xms256m -Xmx512m"
    • Replace -Xms256m with Xms512m
    • Replace -Xmx512m with -Xmx1048m
  2. Now stop the MUXTCJCL started task and restart.
    This restarts the server.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*