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. You can also view the sample MJEENV00 member.

The following table describes the environmental parameters: 

Parameter

Default value

Description

_BPX_JOBNAME=jobName

No default

Specifies the MJEJVM job name

Important

The jobName cannot include the following special characters:

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

_BPX_SHAREAS=[YES|NO]

NO

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

Valid values are as follows:

  • YES—Creates the child process on a subtask in the parent's address space
    If the request cannot be honored, the child process is created in another address space.
  • (Default) NO—Creates the child process in a new address space

_BPXK_MDUMP=jvmDumpDirectory

No default

Specifies the directory to which Java dumps are written

Important

The directory must already exist.

COREMJETHREADS=minNumThreads

No default

Specifies the minimum number of threads in the thread pool

You can calculate this value as follows:

<numberOfMonitoredJMX> * 3


Important

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

HCTMPDIR=directory

/tmp

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

Important

The directory must already exist. If you do not specify HCTMPDIR, 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 which are waiting for execution while all threads are busy

We recommend using the MAXMJETHREADS value for the HOLDZSIZE value.

JAVA_HOME=location

No default

Specifies the location of Java 8.0 64-bit

KEEPALIVESEC=maxTime

No default

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

Important

This value must be greater than the COREMJETHREADS value

You can calculate this value as follows:

<valueOfCOREMJETHREADS> * 2

MJEPATH=directory

No default

Specify the mount point for mounting BMC AMI OpsMJE ZFS files

Important

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

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

MONINT=monitoringInterval

No default

Specifies the self-monitoring interval time in seconds

The recommended time is 60 seconds.

OUTPATH=directoryPath

No default

Specifies the directory to which to write BMC AMI OpsMJE messages

Important

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

Important

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

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) directoryThe product uses this directory 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

Important

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

XMX=maximumHeapSize

4096

Specifies the maximum MJEJVM heap size in MB

Important

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

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 using the HCCHILDIP IP address to collect Health Center data.

 x.x.x.x must have a decimal value between 0 and 255. For example: 192.240.0.36

Tip

Consider adjusting your HCCHILDIP 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*