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 the multi-line value directly in the Process page. Make sure that you do not edit this line in the Form page as this page does not support multi-line texts. Only the first line would be processed in such a case.

  • Do not use special characters or German Umlauts in parameter names and values. The JMX agent sends all Web Service Requests in UTF-8. Whether or not JCL conversion is successful depends on the encoding that your administrator has defined in the UC_SYSTEM_SETTINGS variable in the XML_ENCODING parameter. The agent assumes that ISO-8859-15 is specified.

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:

seealso

About JMX JCL