NetBatch Management Programming Manual

Event Messages
NetBatch Management Programming Manual—522462-003
6-3
Enabling and Disabling NetBatch Event-Message
Generation
Enabling and Disabling NetBatch Event-
Message Generation
You can enable NetBatch event-message generation when starting a scheduler or
while the scheduler is running.
•
To enable event-message generation when starting a scheduler, include the EMS
parameter in the RUN NETBATCH command. For example:
5> NETBATCH /NAME $ZBAT, NOWAIT/ $NB.ZBAT EMS
6> BATCHCOM $ZBAT; INFO SCHEDULER, EMS
SCHEDULER ATTRIBUTES
ems: On
•
To enable event-message generation while the scheduler is running, use the
ALTER SCHEDULER command to set the scheduler’s EMS attribute to ON or
ERROR.
•
To disable event-message generation, use the ALTER SCHEDULER command to
set the EMS attribute to OFF.
How EMS Handles NetBatch Event Messages
With event-message generation enabled, the scheduler sends a message to the EMS
collector ($0) when an event listed in Table 6-1 on page 6-2 occurs. On receiving the
message, EMS stores it in a disk file called the EMS event log. EMS distributors then
collect and filter messages from the log and route the selected messages to the
appropriate destination. Selection of scheduler event messages from a distributor is by
an EMS filter loaded into the distributor. For more information, see the EMS Manual.
Creating an EMS Filter
You can create an EMS filter that selects all scheduler event messages or specific
messages only. To write and compile the filter, use EMF, the EMS filter language.
500 ZBAT-EVT-
SCHEDULER-
ABENDED
The scheduler called the ABEND or
PROCESS_STOP_ (with ABEND option)
system procedure because of a system
resource or scheduler problem.
Critical
501 ZBAT-EVT-LOGON-
FAILURE
The scheduler could not log on to the log
file owner's user ID.
Critical
502 ZBAT-EVT-LOGFILE-
CREATE-ERROR
The scheduler could not create the
scheduler log file.
Critical
Table 6-1. NetBatch Event Messages (page 2 of 2)
Message
Number Symbolic Name Cause Emphasis