Output Target Override - File (-OF)

Use the Output Target Override - File execution command (-OF) to override data destination specifications for a specific output card in a compiled map file for a single execution of a map.

-OFcard_num[+|!+][M['filename']]
[X|X0][Rcount:interval][B][EN][EA][EF][ES][EW][AF][AI][U][!U] [K['filename']|[+'filename']|[U'filepath']|[U]| [1'filename']|[1+'filename']|[U1'filepath']|[U1]] {target|.}
Option
Description
card_num
This is the card number of the output to override.
+
If the map, burst, or card completes successfully, the output data is appended to an existing data file. If the data file does not exist, it is created.
!+
The data file is created at the start of map execution. If the file exists, it is overwritten. If more than one burst occurs, data is appended to the same data file.
M'filename'
This is the metadata (XML schema or DTD) file location of the output card to override.
Specify filename as an absolute path along with the file name and enclosed in single quotes, for the metadata when parsing output XML. An example is:
M'k:\my_project_folder\myschema.xml'
Use this command option to override the Metadata location setting for the root type specified on an output card in the Map Designer GUI.
Rcount:interval
Specify Retry settings. If the target is unavailable, the adapter attempts to access the target as many times as specified by the count setting at the interval specified by the interval setting.

count number of attempts to access the file

interval number of seconds to wait between attempt. If this option is not specified, the Retry settings compiled into the map are used. To eliminate adapter retry, specify R0:0.

B
If the map, burst, or card does not complete successfully, roll back any changes made to this data target. If this option is not specified, the OnFailure setting compiled into the map is used.
EN
Use this command option to never call the external parser for document verification.
EA
Use this command option to always call the external parser for document verification.
EF
Use this command option to call the external parser for document verification only if validation fails.
ES
Use this command option to call the external parser for document verification only if validation is successful.
EW
Use this command option to call the external parser for document verification only for the well-formed document.
AF
Use this command option to fail on adapter warnings.
AI
Use this command option to ignore adapter warnings.
U
Use this command option to apply the burst setting.
!U
Use this command option to not burst (integral mode).
K
When the map, burst, or card runs, no backup file will be created.
K'filename'
When the map, burst, or card runs, a backup file will always be created to filename. If 'filename' is not an absolute path, the map directory will be appended as a prefix to it.
K+'filename'
When the map, burst, or card runs, a backup file will always be appended to filename. If 'filename' is not an absolute path, the map directory will be appended as a prefix to it.
KU'filepath'
When the map, burst, or card runs, a backup file will always be created using a unique backup name in the directory filepath. If 'filepath' is not an absolute path, the map directory will be appended as a prefix to it.
KU
When the map, burst, or card runs, a backup file will always be created using a unique backup name in the map directory.
K1'filename'
If the map, burst, or card does not successfully complete, a backup file will be created to filename. If 'filename' is not an absolute path, the map directory will be appended as a prefix to it.
K1+'filename'
If the map, burst, or card does not successfully complete, a backup file will be appended to filename. If 'filename' is not an absolute path, the map directory will be appended as a prefix to it.
KU1'filepath'
If the map, burst, or card does not successfully complete, a backup file will be created using a unique backup name in the directory filepath. If 'filepath' is not an absolute path, the map directory will be appended as a prefix to it.
KU1
If the map, burst, or card does not successfully complete, a backup file will be created using a unique backup name in the map directory.
target
Specify the name of the output file. If the output file is not located in the same directory as the map file, the full path must be specified using the platform-specific syntax.
.
Use the FilePath in the compiled map file.