SET EVENTPROCESS

Set the status of event processing.

SET EVENTPROCESS

Read syntax diagramSkip visual syntax diagramSET EVENTPROCESSEPSTATUS( cvda)STARTEDDRAINSTOPPED

Conditions: INVREQ, NOTAUTH

This command is threadsafe.

Description

Use the SET EVENTPROCESS command to change the status of event processing.
Note: Do not change the status of event processing (that is, set to start, drain, or stop) while a unit of work that captures synchronous transactional events is in progress because you might cause the events to be backed out and the transaction to end abnormally.

Options

EPSTATUS( cvda )
a CVDA value changing the current status of event processing.
STARTED
The EVENTPROCESS state is changed to STARTED. For in-flight transactions, the capture of non-transactional events starts immediately and the capture of transactional events starts at the next sync point.
DRAIN
The EVENTPROCESS state is changed to DRAIN, and event capture is stopped immediately.

Any transactional events on the dispatcher queue will be deleted. Transactional events are not considered captured until a syncpoint occurs and a syncpoint event will not now be captured.

Any non-transactional events will be emitted. When the last event on the queue is emitted, the EVENTPROCESS state changes to STOPPED.

STOPPED
The EVENTPROCESS state is changed to STOPPED, and event capture is stopped immediately.

All events on the dispatcher queue are deleted.

Conditions

INVREQ
RESP2 values are:
4
Event processing cannot be started while it is draining.
5
EPSTATUS has an invalid CVDA value.
NOTAUTH
RESP2 values are:
100
The user associated with the issuing task is not authorized to use this command.