JMX_COMPOSITE_ADD

Many MBeans require a list of values for their parameters instead of just one value. The JMX_COMPOSITE_ADD script element stores several values in one parameter name. These values can only be used within a job. The parameter values exist until the job has ended and can be used for any MBean of your choice.

Important! Enter multi-line values directly in the Process page. Make sure that you do not edit this line in the Form page as this page does not support multiple lines. Only the first line would be processed in such a case.

Syntax

JMX_COMPOSITE_ADD

    NAME=...
    , KEY=...
    , VALUE=...

Parameters

  • JMX_COMPOSITE_ADD
    Combines several values in one parameter name

  • NAME=
    Parameter name

  • KEY=
    Keyword. The term you can select here depends on the MBEAN to which the parameter should be assigned.

  • VALUE=
    Value that should be stored for the keyword

Examples

The following line defines an individual value:

JMX_COMPOSITE_ADD NAME="parameter",KEY="CUSTOMERSTATE",VALUE="Partner"

If a keyword consists of more than one value, you must separate these values with a semicolon (;).

JMX_COMPOSITE_ADD NAME="parameter",KEY="COUNTRY",VALUE="USA;India"

You can use a semicolon (;) within a value. Add an additional backslash (\) in front of the semicolon in this case. It is not interpreted as a separator.

Areas that indicate minimum and maximum values are also separated by a semicolon.

JMX_COMPOSITE_ADD NAME="parameter",KEY="ID",VALUE="33333;44444"

The date format is YYYYMMDD, time format is HHMMSS, and date plus time is specified with YYYYMMDDHHMMSS.

JMX_COMPOSITE_ADD NAME="parameter",KEY="TIME",VALUE="121516"

JMX_COMPOSITE_ADD NAME="parameter",KEY="DATEOPENED",VALUE="19990616120000"

Boolean type values are used with the values true or false.

JMX_COMPOSITE_ADD NAME="parameter",KEY="REQUEST",VALUE="true"

Currency type values only require the numerical value.

JMX_COMPOSITE_ADD NAME="parameter",KEY="CURRENCY",VALUE="1000.00"

Example

The following example fills the report parameter of the MBean for Crystal Reports. It contains values for the date format, the sender, and an email subject.

JMX_COMPOSITE_ADD NAME="report",KEY="FORMAT",VALUE="EXCEL"
JMX_COMPOSITE_ADD NAME="report",KEY="MAIL_SUBJECT",VALUE="Customers in L.A."
JMX_COMPOSITE_ADD NAME="report",KEY="MAIL_FROM",VALUE="Smith@automic.com"

See also: