Tivoli Header

Administrator's Reference

DELETE EVENT (Delete Event Records)

Use this command to delete event records from the database. An event record is created whenever processing of a scheduled command is started or missed.

This command only deletes the event records that exist at the time the command is processed. An event record will not be found:

Privilege Class

To issue this command, you must have system privilege or unrestricted policy privilege.

Syntax

                       .-00:00-.
>>-DELete EVent--date--+-------+-------------------------------->
                       '-time--'
 
   .-TYPE--=--Client-------------.
>--+-----------------------------+-----------------------------><
   '-TYPE--=--+-Client---------+-'
              +-ADministrative-+
              '-ALl------------'
 
 

Parameters

date (Required)
Specifies the date used to determine which event records to delete. The maximum number of days you can specify is 9999.

Use this parameter in conjunction with the TIME parameter to specify a date and time for deleting event records. Any record whose scheduled start occurs before the specified date and time is deleted. However, records are not deleted for events whose startup window has not yet passed.

You can specify the data by using one of the values below:

Value Description Example
MM/DD/YYYY A specific date 09/15/1998
TODAY The current date TODAY
TODAY-days or -days The current date minus days specified TODAY-3 or -3.

time
Specifies the time used to determine which event records to delete. Use this parameter in conjunction with the DATE parameter to specify a date and time for deleting event records. Any record whose scheduled start occurs before the specified date and time is deleted. However, records are not deleted for events whose startup window has not yet passed. The default is 00:00.

You can specify the data by using one of the values below:

Value Description Example
HH:MM:SS A specific time 10:30:08
NOW The current time NOW
NOW+HH:MM or +HH:MM The current time plus hours and minutes specified NOW+03:00 or +03:00
Note:
If you issue this command at 9:00 using NOW+03:00 or +03:00, TSM deletes records with a time of 12:00 or later on the date you specify.
NOW-HH:MM or -HH:MM The current time minus hours and minutes specified NOW-03:00 or -03:00

TYPE
Specifies the type of events to be deleted. This parameter is optional. The default is CLIENT. Possible values are:

Client
Specifies to delete event records for client schedules.

ADministrative
Specifies to delete event records for administrative command schedules.

ALl
Specifies to delete event records for both client and administrative command schedules.

Examples

Task

Delete records for events with scheduled start times prior to 08:00 on May 26, 1998 (05/26/1998), and whose startup window has passed. Records for these events are deleted regardless of whether the retention period for event records, as specified with the SET EVENTRETENTION command, has passed.

Command:
delete event 05/26/1998 08:00

Related Commands

Table 76. Commands Related to DELETE EVENT

Command Description
QUERY EVENT Displays information about scheduled and completed events for selected clients.
SET EVENTRETENTION Specifies the number of days to retain records for scheduled operations.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]