Recovering lost dataset events from SMF

In case of a Control-O outage, BMC provides a process for recovering the DSNEVENTs that were not handled.

The process involves two utilities, one (CTMEVRT) to retrieve the missing dataset events and a second (CTMEVEX) to execute the matching DO actions (DO COND and DO FORCEJOB). The output file of CTMEVRT is first manually edited by the user, who then provides the edited file as an input to CTMEVEX.

Note that only DSNEVENTs are processed; all other non-dataset events are ignored. Similarly, only the DO COND and DO FORCEJOB actions are processed, and all other DO actions are commented in CTMEVRT with (*) Unsupported action - not executed.

In addition, certain rule statements, scheduling criteria, or missing IN conditions could prevent the execution of DO actions that CTMEVRT retrieves. The user should consider these factors while editing the CTMEVRT output. Such actions are commented as follows:

• Actions for rules that have scheduling criteria and/or IN conditions are commented with (!) Sched / IN conditions in the rule.
• Actions that have a preceding IF, WHILE, or TERMINAT statement are commented with (?) Conditional-IF/WHILE/TERM precedes.

The CTMEVRT utility uses SMF records written by z/OS and z/OS Communications Server to identify events that occurred during the Control-O outage. The user must specify the start and end times that define the approximate duration of the Control-O outage. The user can also specify include and exclude statements so that only the relevant events will be listed.

The output of CTMEVRT, the DAEVENTS file, is a list of events, identified as most probably requiring handling. BMC recommends that the user review the DAEVENTS file and edit it if necessary (for example, by removing events that are no longer relevant or might have already been processed by Control-O before the outage).

The CTMEVEX utility processes the edited DAEVENTS file, converting the DO actions of the events listed in DAEVENTS to IOACND commands (for adding or deleting conditions) and CTMJOB commands (to order jobs to the Control-M Active Jobs File using the FORCE option).

CTMEVEX can be run in simulation mode for displaying the statements that could be used as the input to the IOACND and CTMJOB utilities. The user can review the statements and decide if any adjustments are required before actually running CTMEVEX in execution mode.

For more information, see the INCONTROL for z/OS Utilities Guide.