Archive Events

Event Notification Facility › Archive Events

Archive Events

To prevent the CAIENF database from filling all available disk space, CAIENF database recorded instances of events can be automatically archived and purged. Purging is performed when an event instance exceeds its retention period, archiving is optional. Event is the ENF control option statement that is used to designate whether to archive expired event instances or only purge them. ARCHIVE is the ENF control option statement that is used to designate when the event instance purge and archive occurs.

Upon completion of the archive, CAIENF displays event archiving information for each event. More detailed information is available to administrators by executing batch job CASQL005 located in the CAW0JCL data set. The archive includes information useful for performing a restore. The information includes:

The archive date and time
The events included in the archive
Identification of the first and last events that are archived for each event
The tape or DASD volser for the archive
The archive data set name

Examples:

EVENT(JOBFAIL,RP=7)

RP is the number of days the specified event remains in the database.

EVENT(JOBTERM,PURGE=N)

PURGE indicates whether the event instances are purged and not archived (Y) or purged and archived (N).

ARCHIVE(hhmm)

The purging and optionally archiving process is performed each day at the specified time; hour and minute.

ARCHIVE(NOW)

The purging and optionally archiving process is performed immediately.

ARCHIVE(OFF)

The purging and optionally archiving process is not performed.

Archiving can be specified to write to tape or disk. The configured ENF UNIT and SPACE control options determine the type of archive data set. In addition, other ENF control options determine the archive data set name, space, volser, retention period, label, and cataloging of the data set.

The ENF archive data set control options are:

DSNAME: Controls dynamically allocated archive data sets. The data set name that is specified is used as a prefix (16 characters in length including periods). The default is ENF.ARCHIVE.
LABEL: Specifies standard (SL) or Nonstandard (NL) when the archived backup data set is to tape.
RETPD: Specifies the retention period of the archive data sets. CAIENF keeps track of these allocated archive data set within its database.
SPACE: Controls the primary and secondary space allocation for the archive data set.
UNIT: Specifies TAPE or 3390 as the unit type to be used for the allocated archive data set.