JMX_COMPOSITE_ADD

Use the JMX_COMPOSITE_ADD script element to store several values under one parameter name. Many MBeans require a list of values for a parameter instead of a single value. The stored values exist only within the job, remain available until the job ends, and can be used for any MBean.

Important! Enter multi-line values directly on the Process page. Do not edit this line on the Form page, because that page does not support multiple lines — only the first line would be processed.

Syntax

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

Parameters

Parameter Description
NAME= Parameter name
KEY= Keyword. The term you can select depends on the MBean to which the parameter is assigned.
VALUE= Value to store 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, separate the values with a semicolon (;):

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

To use a semicolon (;) within a value, add a backslash (\) in front of it so that it is not interpreted as a separator. Ranges 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, the time format is HHMMSS, and date plus time is specified as YYYYMMDDHHMMSS:

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

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

Boolean values use true or false:

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

Currency values require only the numerical value:

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

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

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: