CL Command Reference - OVRTAPF
CL Command List > OVRTAPF Reference
Description:
The Override with Tape File (OVRTAPF) command is used to (1) override (replace) a file named in a program, (2) override certain attributes of a file that are used by a program, or (3) override the file named in a program and override certain attributes of the file processed. Parameters overridden by this command are specified in the file description, in the program, or in other called file override commands.
If a file named in the program is overridden, the name of that file is specified in the FILE parameter and the name of the overriding file is specified in the TOFILE parameter. The OVRTAPF command can also specify parameters to override values contained in the file description of the overriding file. If the file named in the program is not replaced, but certain parameters of the file are overridden, the name of the file is specified in the FILE parameter and *FILE is specified in the TOFILE parameter. The parameters overridden are then specified by the other parameters of the OVRTAPF command. Parameters that are not specified do not affect the parameters specified in the file description, in the program, or in other called file override commands.
Note: Using this command does not cause a file to be overridden immediately. Information provided on this command is stored until the file is used, at which time the file is overridden.
Examples:
Example 1: Overriding a File
OVRTAPF FILE(OUT) VOL(DPT706) LABEL(STATUSR)
This command overrides a file named OUT in the program using the data file STATUSR on tape volume DPT706.
Example 2: Allowing DBCS Data
OVRTAPF FILE(IGCLIB/IGCTAP) IGCDTA(*YES)
This command overrides the tape device file named IGCTAP, which is stored in the library IGCLIB, so the file may contain double-byte character set data.
Example 3: Using Data Density of 1600 Bits Per Inch
OVRTAPF FILE(OUT) DENSITY(1600)
This command overrides a file named OUT to use a data density of 1600 bits per inch when writing to the tape volume.
Example 4: Using a Conversion Table to Process a Tape with EBCDIC Labels.
OVRTAPF FILE(FILE1) REELS(*SL) CODE(*EBCDIC) TBL(LIB1/TABLE1)
This command overides a tape device file named FILE1 to specify that a conversion table named LIB1/TABLE1 is to be used to convert all data read from, or written to, the tape volume.
Example 5: Using Specified CCSIDs to Process a Non-labeled Tape.
OVRTAPF FILE(FILE2) REELS(*NL) TBL(*CCSID)
FROMCCSID(819) TOCCSID(37)
This command overides a tape device file named FILE2 to specify that any data read from, or written to, the tape volume is to be converted from CCSID 819 to CCSID 37.