Input Dataset Override (-I)

Use the Input Dataset Override execution command (-I) to override the specified input card source with a dataset for this execution only. Use this command to override data source specifications that are in the compiled map file for a single execution of a map.

Use this command to override the name for a specific input data source, work file behavior, or rollback.

You can also specify storage medium, record separator delimiters, behavior for data with variable length records, and so on. See Specifying Storage Medium and Variable Length Records for more information about specifying these options.

        -I[F]card_num[W|!W][B][[@storage_code][:{W|P[delimiter_list]}]] [name]
Option
Description
F
Optional for compatibility with previous versions
card_num
The number of the input card to override
W
Reuse the existing work file for this data source. If the work file does not exist at execution time, a work file is created.
!W
Do not use the existing work file but create a new work file each time the map is run.
B
If map execution is not successful, roll back any changes made to the file and reinstate the file to the original state prior to map execution.
storage_code
Specify one of the following codes, which represent the type of storage medium to be used for input data. The default is a temporary storage queue with the name defined for the input card with the path and file extension removed.

T = Specify a temporary storage queue.
D = Specify a transient data queue.
R = Specify VSAM relative-record dataset.
K = Specify VSAM key-sequenced dataset.
E = Specify VSAM entry-sequenced dataset.
B = Specify storage buffer.

Note: If the storage buffer option (B) is selected, then specifying an override name is not applicable.
:W
Specify for a file consisting of variable length records to copy data from the input file into fixed format workspace before mapping begins. The map will take its input not from the file but from workspace. For details see The :W Option .
:P
Specify that the data will be profiled, that is, a table will be built in memory which cross-references record identifiers to corresponding file offsets. For details, see The :P Option .
Delimiter_list
Specify a comma-delimited list of character or hex values. (Xnn is the syntax for indicating a hexadecimal value.) The default delimiter is a single byte with the value hex 15, decimal 21.
name
Specify the name of the storage entity (source) containing the data for the specified input card. If name is omitted, the name used is the name defined for the input card with the PC-based path information and file extension removed.
Note: name must be preceded by one or more spaces.