Validate File Process

Command File Syntax

The command file contains parameters that identify the files to be validated. A command can appear several times in a command file. A single command can span multiple lines for ease of maintenance (except where noted otherwise). A group of commands followed by a RUN command represents a “process block.” Except for the RUN command, all commands in a process block can appear in any order.

A command file can contain one or more process blocks in the following format:

[// comment ]
[ OPTIMDIR optimdirectory ]
[ AF | XF | { severname | (local) }  filename1[,filenamen ]
[ COLLECTION collection1[,collectionn]]
[ AFEXCLUDE archivefilename1[,archivefilenamen]]
[ LEVEL 1 ]
[ ONERROR{ CONTINUE | QUITPROCESS | QUITALL }]
RUN VALIDATE

//

At the beginning of a line, indicates that the text that follows the slashes is a comment. Enter comment text on one line, anywhere in the command file.

OPTIMDIR

The directory for the files to be validated. The directory provides complete file names in case a wildcard name is specified. For archive files, the directory is used in conjunction with the AF and COLLECTION parameters. For extract files, it is used in conjunction with the XF parameter. The specified AF, XF or COLLECTION must be in the directory specified by OPTIMDIR. (The default is the current directory.)

AF | XF

The files to be processed. You can specify either XF or AF in a process block, but not both. You can use AF and COLLECTION together in a process block.

{ servername | (local) } filename1,filenamen

Server name followed by a comma-separated list of file names or patterns with wildcards. Use the wildcard % for any number of characters. If a file name contains spaces, enclose the name in quotations. An archive file must be registered to be validated. You can use multiple occurrences of this command to process files on multiple servers.

COLLECTION

The collection for archive files to be processed. If both AF and COLLECTION are specified, the final list of files to be processed contains only unique files.

collection

Comma-separated list of collection names or patterns with wildcards (% for any number of characters). If a collection name contains spaces, enclose the name in quotations.

AFEXCLUDE

Archive files to be excluded from validation. If both AF and COLLECTION are specified, the final list of files to be processed contains only unique files. This parameter is valid only for archive files.

archivefilename

Comma-separated list of archive file names to exclude from the validation list. If a file name contains spaces, enclose the name in quotations.

.

LEVEL 1

Specify this parameter to validate the file. Performs these actions:

• Opens the file
• Reads and validates header and trailer blocks
• Checks and validates table and column structures
• Closes the file

ONERROR

Indicates the action taken when an error occurs:

CONTINUE

Processing continues with the next file, if possible.

QUITPROCESS

Processing ends with the current process and proceeds to the next.

QUITALL

Processing ends immediately. (Default)

RUN

Identifies operation to run. The RUN command and its value indicate the end of a process block. Any commands that follow the RUN command are part of the next process block. (Required.)

VALIDATE

Validates specified files.