delcat - Delete entries from the pass catalog

SYNOPSIS

delcat  [ parameter=value ... ]

Parameters are:  tape_labelpass_numbersatellitestart_timeconfirm_each.

DESCRIPTION

delcat deletes records from the archive pass catalog. Records to delete can be identified using any combination of the following criteria: tape label, position of pass on tape, satellite name, and start time. These criteria were chosen to make it easy to delete

- catalog records for all data on a tape - the catalog record for a specific pass on a tape - duplicate catalog records for a particular pass - catalog records for passes on unknown tapes

Candidate records can be shown to the user to confirm each deletion. No candidate records are deleted until each has been examined. Pressing the break key during confirmation halts the function and causes no records to be deleted.

Note that catalog records are not actually deleted; they are simply marked internally as deleted. The packcat function can be used to physically remoted records marked as deleted. It is recommended that packcat be used sparingly.

PARAMETERS

tape_label

This is the name of the external tape label. The name cannot exceed 12 characters in length and is case sensitive. If tape_label is left blank, tape_label is not used as a search criteria.

The default is [ ].

pass_number

This is the pass number on tape. The first frame is 1. If 0 is entered the position on tape is not used as a search criteria.

Valid range is [ >=0 ].

The default is [ 0 ].

satellite

This is the satellite name. It must be entered in lower case. If satellite is left blank it is not used as a selection criteria.

The default is [ ].

start_time

This is the start time for data selection. Only data after this date will be a candidate for deletion. If the start time is 00:00:00, the start time is not used as a search criteria.

The default is [ 00:00:00 ].

confirm_each

This determines if the user will be prompted to confirm each deletion.

Valid responses are [ yes or no ].

The default is [ yes ].

EXAMPLES

Delete the catalog entry for the pass collected on August 10, 1989 and archived on the tape named hawaii.01.

[1] % delcat
tape_label     : char(11) ? [] hawaii.01
pass_number    : int      ? [0] 1
satellite      : char(75) ? []
start_time     : char(15) ? [00:00:00]
confirm_each   : char( 3) ? [no] yes

label         #  satel    telem   date   day    time    durat  lines orbit
hawaii.01     1  noaa-10  hrpt  89/08/10 222  17:45:30  11:06   3607     0

Delete from catalog ? y

FILES

passcat

SEE ALSO

catcover, listcat

NOTES

Must be used with caution when using defaults.


Last Update: $Date: 1999/05/10 20:13:23 $