z/OS External Job Monitor

Name of the agent (or proxy agent)

The agent name is limited to 32 of the following characters: A-Z, 0-9, _, ., $, @, - and #.

Hyphens ("-") are only allowed in agent names. They must not be used in the names of any other objects.

The host name is used instead if this parameter remains undefined. Lowercase letters are converted to uppercase letters.

Default: EM01

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

• E: english
• D: german
• F: french

Default: (E,D)

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: 'UC4.WORK.EJMLOG##'

number of log files being kept on disk

Default: 10

name of the message text library

may have different names dependent on platform rules.

Default: 'UC4.UCX.MSL'

Availability of the messages and language dependent strings.

Values

• ALL: The complete message file is held in the RAM.
• NONE: Always read from the hard drive.
• CONTROLS: All language dependant strings that are necessary in order to display the dialog program are held in the RAM (not relevant for the Automation Engine).

Default: ALL

Name of the job table dataset.

The job table dataset is written if the external Job Monitor has been ended with the option END. It is used to store the states of active jobs. The SMF Exit continues and checks whether an active job that is part of the job table dataset has ended. The job table dataset is deleted whenever the external Job Monitor starts.

Each external Job Monitor on an LPAR requires its own job table dataset. In contrast, all EJMs within a sysplex can use the job filter dataset.

Default:

Writes the logging of all the system's jobs to the log file of the external Job Monitor.

Values

• 0: Job logging is not written to the log file.
• 1: Job logging is written to the log file.

Default:

MVS Sysout class for log files.

This parameter can be used to route log files to the specified MVS Sysout class.

The parameter logcount= is important when you route log files. The number of log files that has been defined in this parameter is created. The oldest log file is routed to the Sysout class if this number is exceeded.

Example:

The parameter logcount= is set to 3. The first log file is routed to the Sysout class when the fourth log file is created.

The Sysout class is only considered if the parameter logging= has been commented using ";".

Values

• A..Z:
• 0..9:

Default: A

Name of the filter file (job filter dataset)

Default:

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: 'UC4.WORK.EJMTRC##';space=(CYL,(50,50))

Number of stored trace files

Default: 10

traceflag

Default: 0

traceflag

Default: 0

traceflag

Default: 0

traceflag

Default: 0

traceflag

Default: 0

traceflag

Default: 0

Method used for the trace files.

Values

• 0: The trace file is normally written.
• 1: All file buffers are written to the disk after each trace line.
• 2: Close/Open is used for the trace file after each trace line. Do not use this option in combination with FILE Events because it causes an event for each line which can lead to recursive endless loops.
• 3: Trace outputs are also written to the log file.

Default: 0

Number of allowed SMF Exit abnormal ends.

The agent deactivates the SMF Exit if it aborts more often than is defined here. A message is sent to the Console.

Message filter: *CSVDYNEX DELETE(EN=*,ROUTINE=*)*

This message is also sent if the agent has ended because in this case, the SMF Exit has also been deactivated.

Further messages and filters for the SMF Exit:

Ordered SMF Exit abend: *UC4 IEFU83 EXIT ABENDED*

System message if the SMF Exit fails: *CSV430I MODULE * FOR EXIT * HAS BEEN MADE INACTIVE*

Default: 2

Eyecatcher name that should be used as a parameter to call the utility CADSDEL. The default is the LPAR name.

Default:

Name of the SMF Exit

The selected name must be unique if several Event Monitors are used per LPAR.

Default: UC4EXIT

Size of the Common Area Data Space (CADS) in which the SMF Exit stores events (in MB).

About 65000 events can be stored with 10 MB.

Values

• 1..2048:

Default: 10