JMX_COMPOSITE_ADD

Combines values for one parameter

Syntax

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

Syntax

Description/Format

NAME=

Parameter name.

KEY=

Keyword.

The description depends on the MBean to which the parameter should be assigned.

VALUE=

Value to be stored for the keyword.

Comments

Many MBeans require a list of values instead of just one for their parameters. JMX_COMPOSITE_ADD stores several values in one parameter name. These values can only be used within a particular job.

Parameter values exist until the end of a job and can be used for any MBean of your choice.

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, these must be separated with ";".

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

";" can also be used within a value. Add an additional "\" in front of the semicolon in this case. It is not interpreted as a separator.

Areas indicating minimum and maximum values are also separated with ";".

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"

Values of type Boolean are used with "true" or "false".

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

Values of type currency only require the numerical value.

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

Enter this multi-line value directly in the Process tab. This line should no longer be edited in the Form tab because it does not support multi-line texts and only the first line would be processed in this case.

Avoid using special characters and 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 specified by the administrator in the variable UC_SYSTEM_SETTINGS in the key XML_ENCODING. The agent acts on the assumption that "ISO-8859-15" has been specified.

Example

The following example fills the parameter "report" of the MBean for Crystal Reports. It contains values for the date format, the sender and an e-mail 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: