Reporting Facility Commands › FILE Command › DISK File Definition

DISK File Definition

This format of the FILE command defines the physical attributes of an input disk file. The DISK File Definition command is coded as follows:

►►─ filename: ─┬─ INPUT ─┬─ DISK ─┬──────────┬─ RECORD=recsize ───────────────►
               └─ FILE ──┘        └─ device ─┘

 ►─┬─────────────────┬─┬────────────┬─┬──────────────┬─┬──────────────┬───────►◄
   └─ BLOCK=blksize ─┘ ├─ VARIABLE ─┤ └─ SEQUENTIAL ─┘ └─ KEY=string ─┘
                       └─ FIXED ────┘

filename:

Is a unique file name within the Reporting Facility program. You must terminate the file name with a colon, with no intervening blanks. CA Datacom/DB Reporting Facility automatically generates an alphanumeric field with the same name as the file name (without the colon). It is to be used as a return code in conjunction with the GET command.

device

Indicates the device type on which the input file resides. When this parameter is coded, it must immediately follow the disk keyword. If you omit this parameter, the Reporting Facility assumes that the file resides on either of the following:

• Default device type selected during installation
• Device type specified by OPTION DISK= parameter for this run

Valid device type codes are 3350, 3375, 3380, 3390 and 9345 (and FBA for z/VSE).

RECORD&equals.recsize

Specifies the length of each logical record in the input file. The coded value must be equal to or less than track capacity of the device.

BLOCK&equals.blksize

Specifies the length of each physical block in the input file. If specified, it must be an even multiple of the record size. When this parameter is omitted, the Reporting Facility assumes the block size to be the same as the record size.

FIXED|VARIABLE

FIXED indicates that each record on the file is of equal length, as specified in the RECORD= parameter.

VARIABLE indicates that each record on the file can be of different lengths, but not exceeding the value coded in the RECORD= parameter. When a variable length file is defined, you must allow for the standard record descriptor word (four bytes) that is always returned in the first four positions of the I/O buffer.

SEQUENTIAL

Specifies the physical organization of the file as a sequential data set.

INDEXED(n)

Specifies the physical organization of the file as an indexed sequential (ISAM) data set. The length of the key defined for the file must either be coded in n or using the KEY= parameter. When n is specified, it must be a positive integer less than or equal to the value specified in the RECORD= parameter or 255, whichever is smaller.

KEY=string

Specifies the sequence in which the file is to be presented to the Reporting Facility. The string consists of the field names defined as comprising the key to the file.

Note the following:

• In a z/OS environment, at execution time, the appropriate values in the JCL can override the record size and block size.
• In a single run, you can define and access any number of disk files.
• The file name must match the file name in the JCL (in a z/OS environment, DDNAME; in a z/VSE environment, the DLBL name).