Limited supportBMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Ops Monitor for Java Environments 4.1.

Using default JVM profiles to collect JMX data


(BMC.AMIOPS.SPE2110)

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           |
    |                                                                             |
    | 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*