ADDFILE command

The ADDFILE command is used to dynamically assign a new physical data store file to an existing file group. The command can be issued any time after the persistent data store initialization has completed in the Tivoli Enterprise Monitoring Server. It can be used to increase the number of files assigned to a group or to bring old data back online. It cannot, however, be used to define a new file group ID. It can be used to add files only to groups that already exist as the result of GROUP commands in the RKPDIN input file.

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.

Syntax

ADDFILE  GROUP=groupid  FILE=DSN:dsname  [ RO ]  [ BACKUP ] 
                                           [ ARCHIVE ]

where

groupid: Specifies the unique group ID of the file group to which a file is to be added.
dsname: Specifies the fully qualified name (no quotation marks) of the physical data set that is to be added to the group specified by groupid.
RO: Specifies that the file is to be read-only (that is, that no new data can be recorded to it). By default, files are not read-only (that is, they are modifiable). This parameter can also be specified as READONLY.
BACKUP: Specifies that the file is to be copied to disk or tape before being reallocated by the automatic maintenance task. (Whether the copy is to disk or tape is a maintenance process customization option.) By default, files are not backed up during maintenance.
ARCHIVE: Specifies that the file is to be exported before being reallocated by the automatic maintenance task. By default, files are not exported during maintenance.