Control Statements › INPUT Statement › Parameters

Parameters

B=n

describes the block length of the input file records. This is only used when the block length is different from the definition specified for the file in the glossary.

BF=n

describes the blocking factor of the input file records. This is only used when the block length is different from the definition specified for the file in the glossary.

CARDS

indicates that the input file is a card file.

FILE

indicates that the input file is on tape or disk.

filename

must be the name of the glossary for the primary file for the run. The file can be any of the product files that are defined for CA JARS Wizard.

Note: For more information, see the CA JARS Installation Guide for a list of file names defined for your system.

KEY=fCCa-b

identifies the location of the key field in the secondary file records. A value of 2CCa-b applies to the second input file (first secondary file); 3CCa-b applies to the third; and 4CCa-b applies to the fourth, if any. The key field must not exceed 64 characters in length.

For example, KEY=2CC1-2 means that the key field is in the first two positions of the second input file records. KEY=3CC1-2 applies to the first two positions of the third input file. Records can be of any size, but a and b must not exceed the record length of the file.

LIST

instructs CA JARS Wizard to display the complete secondary file in the report listing.

MATCH =

identifies the key field in the primary file and other secondary files. A match exists when this field contains the same data value as the KEY field in the secondary file. All files must have the same sort order for their key fields if the table function is not used. Primary input records can be processed regardless of whether they are matched, depending on the criteria in the selection statements.

member-name

identifies the name under which the file is cataloged in the Source Statement Library, CAIJWCP.

NORWD

is required in addition to the VOL parameter when the input is from two or more files on a single tape reel. NORWD suppresses the automatic tape rewind after the first file. For example:

INPUT CAJCICS VOL = 3  NORWD

This example tells CA JARS Wizard that the primary input file occupies three files on a single tape reel and that the automatic tape rewind is to be suppressed.

Note: This parameter applies to VSE only.

R=n

describes the record length of the input file records. This is only used when the record length is different from the definition specified for the file in the glossary.

RECFM

is required whenever the record format for the file is incorrect. For example, nonglossary files are assumed to have fixed-length, unblocked, 80-byte records.

SWLR

suppresses abnormal termination when the input file block length is not equal to the expected input block size.

Note: This parameter applies to VSE only.

TABLE=fCCa-b

This parameter serves two purposes.

• It identifies a table file. The entire file is read before the start of processing.
• It defines data fields in the secondary file that are retained and thereby referenced. The position specification can be used in other CA JARS Wizard statements as a data field name, or a more meaningful name can be assigned in a DEFINE statement. For example, 3CC15-22 can be used in any statement as the name of the data field in positions 15-22 of the current record from the third input file.

UNL

specifies that the input file resides on an unlabeled magnetic tape.

Note: This parameter applies to VSE only.

VOL=n

is required when an input file occupies two or more files on one or more volumes. A maximum of 27 can be used.

n specifies the number of volumes or files to be processed. Without this, CA JARS Wizard assumes end of input on reaching the end of the first file. (See the "Sample Usage" chapter for the required JCL for multiple files/volumes.)

Note: This parameter applies to VSE only.

The KEY and MATCH parameters apply whenever the run includes a secondary file. They give the information necessary to match records from the two different files. TABLE initiates a binary lookup procedure of data that resides in main storage. TABLE can be applied only when the secondary file is limited and can fit in main storage. When TABLE is used, CA JARS Wizard reads the entire secondary file into memory at the start of the run and sorts it. Without it, the secondary file must somehow be sorted in the same sequence as the primary input file, and matching is performed by reading one record at a time from the primary and secondary files.