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

Previous Topic: CA JARS File Utility Commands Coding Conventions

Next Topic: FIND Command

INPUT Command

This command is required. It defines the File Utility's input file. Since the File Utility accepts multiple input files, the only limitation on the number of INPUT commands you enter is your storage availability. This command has optional keywords that allow you to qualify the input file attributes. Each INPUT command must precede FIND and/or CHANGE commands associated with that particular INPUT command.

Command     Operands
INPUT=ddname,START=nn|1,STOP=nn|9999999,SKIP=nn|0,DISP=REJ|SEL,COPY,COUNT

where:

ddname

(required) specifies a 1- to 8-character name as found on an OS DD JCL statement or a CMS FILEDEF command.

START=nn|1

(optional) a 1- to 7-digit numeric value that specifies the record (relative to 1) within the input file, to initiate File Utility processing. One (1) is the File Utility default. Zero (0) is invalid.

STOP=nn|9999999

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

Note: If FIND commands have been entered with a given input, then the STOP= value refers to the records that met the FIND criteria, not the records read from input.

SKIP=nn|0

(optional) a 1- to 7-digit numeric value that instructs the File Utility to process every nn records. Zero (0) is the default.

DISP=REJ|SEL

(optional) SEL is the default disposition signifying that records that meet the associated FIND criteria are selected for further processing. Conversely, REJ signifies that those records be rejected from further processing. The option chosen governs the disposition for all records in the input file.

COPY

(optional) specifies that all records, whether selected or rejected, are to be written to the output file. This option is only valid if you have included an OUTPUT command. If COPY is not specified, then File Utility defaults to writing only selected records to the output file.

COUNT

(optional) specifies that only a count of the records in the input file is to be produced. All record selection/rejection logic and output processing is ignored.