DELFILE command

The DELFILE command is used to drop one physical data store file from a file group's queue of files. It can be issued any time after persistent data store initialization has completed in the Tivoli Enterprise Monitoring Server.

Important: The content in this section was created for and applies to the original persistent data store, referred to as PDS V1. A new PDS version (referred to as PDS V2) now exists. PDS V1 will eventually be deprecated.

The file to be dropped must be full, partially full, or empty; it cannot be the “active” (output) file for its group (if it is, the DELFILE command is rejected).

The DELFILE command is conceptually the opposite of the ADDFILE command, and is intended to be used to manually drop a file that was originally introduced by a GROUP or ADDFILE command. After a file has been dropped by DELFILE, it is no longer allocated to the Tivoli Enterprise Monitoring Server task and can be allocated by other tasks. Note that DELFILE does not physically delete a file or alter it in any way. To physically delete and uncatalog a file, use the REMOVE command.

Syntax

DELFILE       FILE=DSN:dsname

where

dsname: Specifies the fully qualified (without quotation marks) name of the file that is to be dropped.