Output Dataset Override (-O)

Use the Output Dataset Override (-O) execution command to override the specified output card target with a dataset for this execution of the map only. For example, use this command to override the name for a specific output data target or to specify the appending of data files, file deletion, or rollback.

You can also specify the storage medium, record length, delimiters to use for record separators, and so on. See Specifying Storage Medium , Specifying Output Fixed Format Record Length and Variable Length Records for more information about specifying these options.

When using an input or output override execution command (-I) or (-O), the source or target name must be preceded by one or more spaces. If the override specifies a storage buffer, using an override name is not applicable. Names for the data and execution audit, trace, and problem resolution information are not separated from the command by spaces.

-O[F]card_num[+|!+][B][[@storage_code][#record_length] 
[:{W|P[delimiter_list]}]] [name]

Option

Description

F

Optional for compatibility with previous versions.

card_num

The number of the output card to override.

+

Append the current map execution data to an existing data file.

!+

Do not append the data to an existing data file, but create a file each time the map is run.

B

If map execution is not successful, rollback any changes made to the file and reinstate the file to the original state prior to map execution.

@storage_code

One of the following codes that represent the type of storage medium to be used for output data. The default is a temporary storage queue with the output card name defined without its path and file extension.

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.

If the storage buffer option (B) is specified, then specifying an override name is not applicable.

record_length

The fixed output record length specified for writing the data that is less than or equal to 32768. The default is to write the data as 4096-byte fixed length records.

For VSAM, the record length is the record length defined for the dataset.

:W

The data is mapped into workspace and then copied from workspace to its final target after mapping completes. Variable length records are separated out during the copy operation based on a defined record separator. See The :W Option .

:P

The data profiled, that is, a table is built in memory that cross-references record identifiers to corresponding file offsets. For details, see The :P Option .

delimiter_list

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

The name for the temporary storage entity (target) where data for the specified output card will be written. If name is omitted, the name used will be the name defined for the output card without the PC-based path information and file extension.

name must be preceded by one or more spaces.