Environmental parameters


Default values are assigned to the environmental parameters during installation and customization of BMC AMI Ops Monitor for Java Environments. For more information about changing the default values, see Reviewing and defining BMC AMI OpsMJE PAS parameters and the sample MJEENV00 member.

Warning
Important

Some environmental parameters, such as those with the prefix BPX, are defined by IBM. Those with the prefix XMS or XMX
 are defined by OpenJ9 JVM -X options. 

The following table describes the environmental parameters: 

Parameter

Default value

Description

_BPX_JOBNAME=jobName

No default

Specifies the MJEJVM job name

Do not use the following special characters:

! ” # % ’ : ; < = > ? [ \ ] ^ ` { | } $ @

This is an IBM parameter. For more information see the IBM documentation.

_BPX_SHAREAS=[YES|NO]

NO

Specifies whether the spawned child process should run in a separate address space from the shell address space

This is an IBM parameter. For more information see the IBM documentation.

_BPX_USERID=<userID>OpsMJE PAS USER ID

Specifies whether the child process is created with the specified MVS user identity.

This is an IBM parameter. For more information see the IBM documentation.

COREMJETHREADS=minNumThreads

No default

Specifies the minimum number of threads in the thread pool

This value must be greater than zero but less than the MAXMJETHREADS value.

You can calculate this value as follows:

This value must be at least
<numberOfMonitoredJVMs> * 3

HCTMPDIR=directory

/tmp

(Optional) Specifies the directory for routing IBM Health Center temporary generated files and Strobe measurements JSON files

The directory must already exist. If you don't specify this parameter, the files are routed to the /tmp directory.

HOLDQSIZE=numThreads

No default

Specifies the maximum number of threads that can be held in the queue that are waiting for execution while all threads are busy

Success
Tip

We recommend that you use the MAXMJETHREADS value.

JAVA_HOME=location

No default

(BMC.AMIOPS.SPE2604) Specifies the location of the Java version 17.0 or 21.0

KEEPALIVESEC=maxTime

90

Specifies the maximum time in seconds to retain inactive threads in the thread pool

The recommended time is 90 seconds.

MAXMJETHREADS=maxNumThreads

No default

Specifies the maximum number of threads allowed in the thread pool

This value must be greater than the COREMJETHREADS value

You can calculate this value as follows:

This value must be at least
<valueOfCOREMJETHREADS> * 2

MJEPATH=directory

/var/bmc/mje/

Specifies the mount point for mounting OpsMJE ZFS files

The directory path or linked directory path cannot include the following special characters:

! ” # % ’ : ; < = > ? [ \ ] ^ ` { | } $ @

MONINT=monitoringInterval

60

Specifies the self-monitoring interval time in seconds

The recommended time is 60 seconds.

OUTPATH=directoryPath

/tmp

Specifies the directory to which to write OpsMJE messages

The directory must already exist.

TCPMJEPORT=portNumber

20334 

Specifies the number of the port through which the product communicates with the MJEJVM and Strobe systems

If the default value is omitted and you need to change the value, you must explicitly enter TCPMJEPORT=portNumber in the MJEENVxx BBPARM member by using the ISPF editor.

Success

Tip

You can get this port number from the TCP/IP port assigners.

WLP_DIR=directory

No default

Specifies the IBM WebSphere Application Server Liberty profile bin (wlp) directory, which the product uses to locate the client's subdirectory. The subdirectory contains the restConnector.jar file, which is used to gather JMX data from Liberty servers.

XMS=initialHeapSize

4096

Specifies the MJEJVM initial heap size in MB

If the default value is omitted and you need to change the value, you must explicitly enter XMS=initialHeapSize in the MJEENVxx BBPARM member by using the ISPF editor.

This is an OpenJ9 JVM -X option. For more information, see the IBM documentation. 

XMX=maximumHeapSize

4096

Specifies the maximum MJEJVM heap size in MB

If the default value is omitted and you need to change the value, you must explicitly enter XMX=maximumHeapSize in the MJEENVxx BBPARM member by using the ISPF editor.

This is an OpenJ9 JVM -X option. For more information, see the IBM documentation. 

HCCHILDIP=x.x.x.x

localhost

(Optional) Specifies the primary TCP/IP address (ipv4) associated with MJESTACK

MJEJVM child connects to the Health Center agent by using the HCCHILDIP IP address to collect Health Center data

 x.x.x.x must have a decimal value from 0 to 255. For example: 192.240.0.36

Success

Tip

Consider adjusting this parameter accordingly if you change the TCP/IP stack name for the MJESTACK parameter.

 

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

BMC AMI Ops Monitor for Java Environments 4.1