z/OS - Event Monitor

system=

Name of the AE system.

This entry must comply with the entry that has been specified in the Automation Engine's INI file.

name=

Name of the Event Monitor
This name must be unique.

Language in which the logging is made. 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.

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

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

helplib=

Name of the message file.

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

EventCheckIntervall=

Periodical event check in seconds.

Default value: 3600

In order to avoid a high Server workload, do not specify a value that is too low.

(TRACE)

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

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

Number of stored trace files.

Agent's trace flags for TCP/IP communication

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

Trace flags must only be used in close cooperation with Automic Support.

trcmode=

Method that should be 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.

(TCP/IP)

ex=

Address of the agent to which the Event Monitor should connect.

Allowed formats:
DNS name:port number
TCP/IP address:port number

connect=

Time interval in seconds in which the Event Monitor tries (cyclically) to establish a re-connection to the agent.

Default value: 120 seconds

The Console command "MODIFY ..., EX=<addr>,:<port> serves to facilitate a new connection immediately. In this case, the attempt to re-connect to the specified agent is made immediately. A reconnection is established, even if the Event Monitor already has a connection to another agent. A new connection is then established. The old connection is ended if the new connection has successfully been established.

ex2=

Alternative agent address to which the Event Monitor should connect if the primary agent (parameter ex=) is not available.

exn=

An additional alternative agent address to which the Event Monitor should connect if the primary agent (parameter ex=) is not available.

Size of the TCP/IP input buffer for messages to be sent (Byte).

Default value: 262144 Byte

Size of the TCP/IP input buffer for messages to be received (Byte).

Default value: 262144 Byte

Setting of keep-alive packets in order to maintain the connection between the agent and the Event Monitor.

Allowed values: "n" and "y" (default value)

"y" - Keep-alive packets are sent.
"n" - Keep-alive packets are not sent.

For Console events:

console=

Console analysis.

Allowed values: "0" (default value), "1"

"0" = The console is not used.
"1" = The console is analyzed.

buffersize=

Size of the input buffer for Console events.

Default value: 1 MB

For SMF-based events (e.g. Job ends, FileSystem events etc.):

smfwrite=

Evaluation of SMF records.

Allowed values: "0" (default value), "1"

"0" = SMF records are not used.
"1" = SMF records are analyzed.

To be able to monitor the closing of files and especially for using Generation Data Groups, this parameter must be activated.

ModulName=

Name of the SMF Exit.

Default value: "UC4EXIT"

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

CADSEyeCatcher=

Eyecatcher name that should be used as a parameter to call the utility  CADSDEL.

Maximum 8 characters

Default value: LPAR name

smfStepFilter=

Analyzes SMF records in automated FileSystem events.

Allowed values: "0" (default value) and "1"

"0" - The Event Monitor only analyzes the SMF records of job ends. Normal and abnormal endings are distinguished.
"1" - The Event Monitor also analyzes the SMF records for STEP endings. The highest return code is assumed. The disadvantage of this specification lies in increased performance usage.

SMFJob=

Message about a Job or STEP end.

Allowed values: "0" (default value) and "1"

"0" - The job end is exclusively monitored by the Job Messenger.
"1" - The job end is identified by SMF records.

Make sure that the SMF module logs the SMF record 30 and that your system permits the Exit IEFU84.

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*