External Monitoring Interface
Structure of the INI File emi.ini
Parameter Name | Description |
---|---|
[ GLOBAL ] | |
system = |
AE system name The name can consist of a maximum of 8 characters. Allowed are the upper-case letters A to Z, numbers and "_". System names must not contain the character "_" if you use a z/OS agent in combination with the SMF technique. By default, the job Includes convert "_" to "#". Should you intend to use "_" despite of this fact, you can bypass this situation by specifying the system name in the Event Monitor with "#". Default: AUTOMIC |
language = |
The Language(s) in which the log messages are displayed.Always a pair of languages separated by comma enclosed in brackets. if a message text is not available in the primary language the secondary language will be taken. Values
Default: (E,D) |
logging = |
Full file name pattern for log file names $$ is replaced by the purpose of a Process (CP or WP or JWP or DBSERVICE). No replacements in other components * is replaced by the 3 digit number of a Worker Process. ## is replaced by the log file sequence number after the existing log files' corresponding numbers have been raised by one during startup of the component. z/OS components only: If you comment this parameter, this log file is stored in JES. Also refer to the parameter logpurgeclass= which is described below. The following parameters can be added if the log is written to a dataset (after the dataset name and separated by semicolons): "recfm" = (all 27 z/OS plus * and A record formats are valid) "lrecl" = (0, each positive number up to 32760 and X for each reclen) "blksize" = (0, each positive number up to 32760) "space" = ([CYL,TRK],(prim,sec,directory)) AE and Java components only: Logging to standard output can be enabled by setting the value to CON: For relative path indications the system uses the installation directory when creating files. For BS2000/OSD Operation System the name may be specified with or without User ID. If without User ID the log file is written to the user ID under which the component has been started Default: ../temp/log_##.log |
logCount = |
number of log files being kept on disk Default: 10 |
password = |
password for External Monitoring Interface: password for the login into the Automation Engine Default: |
reconnect = |
Reconnect interval. When a connection to the AE cannot be established, the EMI will retry in periodic intervals defined here. Default: 10 |
client = |
Client number of the AE system which will be monitored. Default: 0 |
user = |
User name, whose context the monitoring will run in. Default: MONITORING |
connection = |
Connection Parameter: Address of the endpoint used to connect to the AE system. Default: jcphost:8443 |
connectionPollInterval = |
Interval in seconds in which the EMI will poll available JCPs and store their endpoints in the JCPLIST section. Default: 10 |
trustedCertFolder = |
The path to the folder where additional trusted certificates are stored (optional). Certificates must be PEM encoded. Default: |
[ TRACE ] | |
file = |
The path and the file name of the trace file. Any file name for a text file with several place holders for current system information: $$ is replaced by server process type (WP or CP) in the context of a server process. * is replaced by the three-digit process number in the context of a server process. ## is replaced by 00 after the available trace files' corresponding numbers have been raised by one during startup of a trace. xxx is replaced by the three-digit abbreviation of the respective unix version (unix agent only). z/OS components only: The following parameters can be added (after the dataset name and separated by semicolons) if the log is written to a dataset: "recfm" = (all 27 record formats of z/OS plus * and A are valid) "lrecl" = (0, each positive number up to 32760 and X for each reclen) "blksize" = (0, each positive number up to 32760) "space" = ([CYL,TRK],(prim,sec,directory)) AE and Java components only: Tracing to standard output can be enabled by setting the value to CON: Currently the External Monitoring Interface (EMI) does not produce any trace regardless of the settings here. For BS2000/OSD the name might be specified with or without user ID. If without the trace file is written to the user ID under which the component has been started. Default: ../temp/trace_##.txt |
trccount = |
Number of stored trace files Default: 10 |
tcp/ip = |
traceflag Default: 0 |
emi = |
traceflag Default: 0 |
[ COLLECTIONS ] | |
agents = |
polling interval in seconds for the agents section. Default: 300 |
cache = |
polling interval in seconds for the cache section. Default: 600 |
client = |
polling interval in seconds for the client section. Default: 3600 |
database = |
polling interval in seconds for the database section. Default: 600 |
licences = |
polling interval in seconds for the licenses section. Default: 3600 |
queues = |
polling interval in seconds for the queues section. Default: 120 |
servers = |
polling interval in seconds for the servers section. Default: 300 |
tasks = |
polling interval in seconds for the tasks Values
Default: 0 |
usage = |
polling interval in seconds for the usage section. Default: 1800 |
users = |
polling interval in seconds for the users section. Default: 300 |
[ JMX ] | |
JmxPort = |
TCP Port for RMI connection you can reach the MBeanServer on the address service:jmx:rmi:///jndi/rmi://Host:JmxPort/Automic Default: 9091 |
usePlatformBeanServer = |
indicate whether MBeanServer is visible for local connections Values
Default: 0 |
[ TASKS ] | |
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 Queue. Has no effect in client zero. Allowed characters are: 'ABCDEFGHIJKLMNOPQRSTUVWXYZ.$_@#-', maximal allowed length is: 200. Wildcards are not allowed. Default: |