Utilities › CA JARS File Utility Commands Coding Conventions › DUMP Command

DUMP Command

The DUMP command is optional. When specified, it can be used to dump an entire data set or only those records that meet the FIND criteria, if specified. The dump command can be modified by one or more parameters:

   Command    Operands
DUMP=ON,START=nn|1,STOP=nn|9999999,RESET,FILE=nn

where:

ON

(required) specifies that the File Utility is to initiate DUMP processing.

START=nn|1

(optional) a 1- to 7-digit numeric value specifying the starting record in the input file to begin processing. If omitted, the CA JARS File Utility defaults to one (1).

STOP=nn|999999

(optional) a 1- to 7-digit numeric value that specifies the number of records (past the start) that terminates processing.

RESET=

(optional) only valid if STOP= is specified. Indicates to the File Utility that you have multiple input files, and that you want the STOP= value RESET after processing each input file. If omitted, the File Utility terminates DUMP processing only when the STOP= value has been satisfied, which, depending upon the value, could be in any of the input files.

Note: If FIND criteria is specified for a given input file, then both the START= and STOP= values apply to the records that meet the FIND criteria.

FILE=nn

(optional) specifies a 1- to 7-digit numeric value corresponding to the sequence of a specified INPUT file. When specified, this parameter tells the File Utility which input file is to participate in dump processing. The corresponding INPUT file and only that file is DUMPed. If omitted, the File Utility assumes all INPUT files participate in dump processing.

Note: If FILE is specified with RESET, RESET is ignored.