External Monitoring Interface Configuration

Structure of the File emi.ini

Section/Parameter Description
[GLOBAL]  
system= Name of the AE system
client= Client number which is monitored.
user= User name of the monitoring user, i.e., the user whose context the monitoring will run under.
password=

User's password.

Can also be provided encrypted. To encrypt passwords use ucybcryp.exe.

language=

Language, which will be used for message translations.

Value: D, E or F

In version 11.2 the messages are available in English only, regardless of the values defined here. Other languages will be available in future versions.

cp=

The address of the communication process in the AE system to which the agent should connect.

Allowed formats:
DNS Name:Port number
TCP/IP Address:Port number

reconnect=

Reconnect interval.
When a connection to the AE cannot be established, the EMI will retry in periodic intervals defined by this parameter.

Unit: seconds

Format: integer

logcount= Number of stored log files
logging=

Path and file name of the log file

The number characters serve as placeholders for a series in numerical order.

When starting the EMI, the log files are renamed so that the most current log file is always the one with the number "00".

[COLLECTIONS]

This section contains poll intervals for specific monitoring areas. The intervals are defined in seconds.

Format: integer

Example: 5 means, the status of all agents in EMI is refreshed every 5 seconds.

agents=

Polling interval for the Agents section in SystemOverview.

Default: 15

cache=

Polling interval for Cache section in the System Overview.

Default: 10

client=

Polling interval for Clients section in System Overview.

Default: 60

database=

Polling interval for Database section in System Overview and MQs.

Default: 10

licenses=

Polling interval for Licenses section in System Overview.

Default: 60

queues=

Polling interval for Queues section in System Overview.

Default: 5

servers=

Polling interval for Automation EngineDiese Komponente steuert ein Automation Engine-System. Besteht aus verschiedenen Serverprozessen. servers section in System Overview.

Default: 5

tasks=

Polling interval for activities. If set to 0, activities are not monitored. If greater 0, the TASKS section is used to filter activities.

Default: 0

usage=

Polling interval for system Usage section in System Overview.

Default: 1500

users=

Polling interval for Users section in System Overview.

60

[TASKS]

Filter criteria for activities to be monitored.

Polling of activities can be turned on or off with the parameter tasks= in the section [COLLECTIONS]

state=

Comma separated list of ranges of states in the format [from-to[,from-to[...]]].

Default: 1560-1564,1800-1899

object=

Sets the filter for the object name. With the default entry "*", all objects are listed. Use the wild card characters "*" and "?" to set a filter. "*" stands for any number of characters, "?" for exactly one character.

Default: *

type=

Comma separated list of object types. The "*" is not allowed. E.g., JOBS,JOBP,SCRI

Default: JOBP

user=

Sets the filter for the user name. The wildcard character "*" matches all users

Default: *

queue=

Sets a filter for a QueueObjekttyp in der Automation Engine. Legt die maximale Anzahl parallel laufender Aufgaben, deren Prioritäten und somit die Reihenfolge von auszuführenden Objekten fest.. Has no effect in client zero.

Default: All Queues

[TRACE]

In version 11.2 the following four parameters are not yet considered, as the EMI creates a log file only.
Traces will be available in future versions.

file=

Path and file name of the trace file

The number signs serve as placeholders for a series in numerical order.

When starting a trace, the trace files will be renamed so that the most current trace file is always the one with the number "00".

Default: ./temp/trace_##.log

trccount=

Number of stored trace files

Default: 10

tcp/ip=

Trace flags of the EMI

Allowed values: "0" (default value) to "9"

Set trace flags only in close cooperation with our support team.

emi=

Trace options for EMI processing

Allowed values: "0" to "9"

Default: "0"

[JMX] This section contains basic settings relevant for the MBeanServer.
usePlatformBeanServer=

Indicates, whether the MBeanServer is visible for local connections.

Allowed values: "1" or "0" (or "Y" or "N")

Default: "1"

jxmPort=

TCP-port for RMI connection

You may reach the MBeanServer on this default address:

service:jmx:rmi:///jndi/rmi://hostname:jmxPort/Automic

Default port value (jmxPort): 9091

[CP_LIST] This section is maintained automatically by the EMI. The list of known CPs is stored here.

Comments

The user needs these privileges in the respective User object to be able to access the monitoring functions of the EMI:

See also:

EMI - External Monitoring Interface