Using default JVM profiles to collect JMX data


If BMC AMI Ops Monitor for Java Environments discovers an active JVM that doesn't match a specific profile, when Health Center connects, BMC AMI OpsMJE requests JMX data by using one of the following default profiles:

  • Default JVM profile (non-Liberty JVMs)
  • _DEFREST (default REST) profile (Liberty JVMs)

These default profiles are shipped in the MJETGT00 member. If you are using a customized MJETGT00 member you can create a _DEFREST profile as described in Setting up a _DEFREST profile.

Important

  • For BMC AMI OpsMJE to use default profiles, JMXSEARCH=YES must be defined in MJEINI00. JMXSEARCH=YES is the default value.
  • For BMC AMI OpsMJE to use the _DEFREST profile for Liberty JVMs, you must create a MJESSLMV member. You can use the ADDSEC primary command to create SSL members. 
    • In the MJESSLMV member, specify the KeyRing for the MVJE PAS.
    • Make sure that RACF is set up and that a CERTAUTH (CA) exists for the MVJE PAS. For more information, see Create a certificate for the MVJE PAS.

Setting up a _DEFREST profile

  1. Type ADDJ on the command line.
  2. In the JVM Add Targets Dialog, specify the following values: 

    +-------------------------- JVM Add Targets Dialog ---------------------------+
    | COMMAND ===>                                              SCROLL ===> CSR   |
    |                                                                             |
    |                                                                             |
    |                                                                             |
    |                                                                             |
    | JOB Information                                                             |
    |                                                                             |
    | Job Name           _DEFREST                   Jobname for JVMs              |
    |                                                                             |
    | JMX Information                                                             |
    |                                                                             |
    | Description        Default REST profile       JVM Description               |
    | JMX Port           0                          JMX Listener Port             |
    | Security Suffix    MV                       N Create MJESSL Member?         |
    | JMX Protocol       REST                       REST, JRMP or IIOP            |
    | Debug Level        00                         Debug Level Control           |
    | JVM History        D                          Capture JVM History           |
    |                                                                             |
    |                    Collect                                                  |
    | GC Events          Y (Y|N)                                                  |
    | GC Threshold       Y (Y|N)   * 90 % of memory in use *                      |
    |                                                                             |
    | Health Center Information  (ACTIVE    AUTO)                                 |
    |                                                                             |
    | Health Center Port SCAN    HC Listener Port                                 |
    | HC Security Suffix NO      Only valid with Port                             |
    |                            nnnnn                                            |
    |                    Collect                                                  |
    | Garbage Collection Y (Y|N)                                                  |
    | Classes            Y (Y|N)                                                  |
    | Class Histogram    Y (Y|N)   * Interval 15 Minutes *                        |
    | Object Allocation  O (Y|N|O) * between 0          and 0          bytes *    |
    | Event Only Mode    Y                                                        |
    |                                                                             |
    | z/OS Connect EE                                                             |
    | Information                                                                 |
    |                                                                             |
    | HTTP Port          0     Used if MJESSL suffix is NO                        |
    | HTTPS Port         0     requires MJESSL value                              |
    | Security Suffix    NO    MJESSL suffix for this connection                  |
    |                                                                             |
    | End to add this target                                                      |
    | Cancel to exit without adding                                               |
    | HELP to display help                                                        |
    |                                                                             |
    +-----------------------------------------------------------------------------+
  3. On the command line, enter E (End).
  4. In the Save Current Targets dialog, take the following actions:
    1. In the Member Suffix field, define a two-character number or alphanumeric suffix.
    2. In the Overwrite field, define one of the following values:
      • Y to overwrite existing members with the specified suffix
      • N to retain the existing member 

        Important

        If no member exists with the defined suffix, specify N.

    3. On the command line, enter Persist.

 

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