Filelist

You can use the filelist option with the expire command.

The IBM® client opens the file you specify with this option and processes the list of files within according to the specific command. When you use the filelist option, IBM Spectrum Protect™ ignores all other file specifications on the command line.

The files (entries) listed in the filelist must adhere to the following rules:

• Each entry must be a fully-qualified or a relative path to a file or directory. Note that if you include a directory in a filelist entry, the directory is backed up, but the contents of the directory are not.
• Each path must be specified on a single line. A line can contain only one path.
• Paths must not contain control characters, such as 0x18 (CTRL-X), 0x19 (CTRL-Y) and 0x0A (newline).
• The filelist can be an MBCS file or a Unicode file with all Unicode entries.
• Any IBM Spectrum Protect filelist entry that does not comply with these rules is ignored.

The following are examples of valid paths in a filelist:

   c:\myfiles\directory\file1
   c:\tivoli\mydir\yourfile.doc
   ..\notes\avi\dir1
   ..\fs1\dir2\file3
   "d:\fs2\Ha Ha Ha\file.txt"
   "d:\fs3\file.txt"

You can use the filelist option during an open file support operation. In this case, IBM Spectrum Protect processes the entries in the filelist from the virtual volume instead of the real volume.

If an entry in the filelist indicates a directory, only that directory is processed and not the files within the directory.

If the file name (the filelistspec) you specify with the filelist option does not exist, the command fails. IBM Spectrum Protect skips any entries in the filelist that are not valid files or directories. IBM Spectrum Protect logs errors and processing continues to the next entry.

The entries in the list are processed in the order they appear in the filelist. For optimal processing performance, pre-sort the filelist by file space name and path.

For example, your filelist includes the entries c:\dir0\myfile and c:\dir0. If the \dir0 directory does not exist on the server, the c:\dir0 directory is sent to the server a second time.

Parameters

filelistspec

Specifies the location and name of the file that contains the list of files to process with the command.

Note: When you specify the filelist option on the command line, the subdir option is ignored.