Administration Guide > Configuration > Structure of the Configuration Files > z/OS External Job Monitor

z/OS - External Job Monitor

Structure of the INI File UC4EJM.INI

Description of the INI file of the external Job Monitor which is operated as an independent task (started task).

Default values have been specified for most parameters. They can be changed if required. Parameters that must be adjusted to your system environment are written in red letters.

Section/Parameter Description
(GLOBAL)  

name=

Name of the external Job Monitor.
This name must be unique.

language=

Language in which the logging is carried out. Specification of primary and secondary language.

Allowed values: "E", "D" and "F"

Default: "E,D" (primary language English, secondary German)

If the message is not available in the primary language, the system searches for it in the secondary language.

 

logging=

Name of the log file. 

The number signs serve as placeholders for a series in numerical order. When you start the agent, the log files are renamed so that the most current log file always has the number "00".

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 when 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))

logcount= Number of stored log files.

logpurgeclass=

MVS Sysout class for log files

Allowed values: A-Z and 0-9
Default value: "A"

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

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

The parameter logcount= is important if 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.

For 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.

helplib=

Name of the message file.

helpcache=

Availability of messages and language dependent strings.

Allowed values: "ALL" (default value), "NONE", "CONTROLS"

"ALL" = The complete message file is held in the RAM.
"NONE" = Always read message file from the hard drive.
"CONTROLS" = All language dependent strings that are necessary in order to display a dialog program are held in the RAM (does not apply to agents).

JobFilter=

Name of the filter file (job filter dataset).

JobTable=

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.

logJobProtocol=

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

Allowed values: "0", "1"
Default value: "1"

"0" – Job logging is not written to the log file.
"1" – Job logging is written to the log file.

(TRACE)

 

file=

Path and file name of the trace file.

The number signs serve as placeholders for ascending numbering. The log files are renamed when a trace is activated. The latest trace file is always the one with the number "00".

event=

TraceFlag of the external Job Monitor.

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

Set trace flags only in close cooperation with Automic Support.

trcmode=

Method used for the trace files

Allowed values: "0" to "3"
Default value: "1"

"0" - Trace file is written normally.
"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 FileSystem events as it causes an event for each line which can lead to recursive endless loops.
"3" - Trace outputs are also written to the log file.

trccount= Number of trace files that are kept.

(SMFExit)

 

Modulname=

Name of the SMF Exit module for the external Job Monitor.

SMF_Buffersize=

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

Allowed values: "1" - "2048"
Default value: 10

About 65000 events can be stored with 10 MB.

ABENDNUM=

Number of allowed SMF Exit abnormal ends.

Default value: 2

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*

CADSEyeCatcher=

Eyecatcher name that should be used as a parameter for calling the utility  CADSDEL.

Maximum 8 characters

Default value: LPAR name

 

Example of an INI File

(GLOBAL)
name=UC4EJM
;lpar=LPAR1

language=(D,E)
;logging='UC4.EJM.LOG##'
logcount=2
logPurgeClass=9
helplib='UC4.UCX.MSL'
helpcache=ALL
jobfilter='UC4.EJM.JOBFLTR'
jobtable='UC4.EJM.JOBTABLE'

(TRACE)
;file='UC4.EJM.TRC##';space=(CYL,(10,5))
trccount=10
event=0
trcmode=3

(CONSOLE)
modulname=UC4EJM
smf_buffersize=10
;AbendNum=2
CADSEyeCatcher=UC4EJM

 

See also: