Output Target Override - Application (-OA)
Use the Output Target Override - Application execution command (-OA) to override specifications in the compiled map file for a specific output card for a single execution of a map.
-OA[alias]card_num[M['filename']] [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]]
[library],[function],[application_command_line]|
{target-adptr-cmd|.}
- Option
- Description
- alias
- This is the adapter alias for the specific application adapter. For example, FTP is the adapter alias for the FTP adapters. If the alias option is not used, you must use library, function, and application_command_line. If alias is used, you must use target-adptr-cmd or ".".
- card_num
- This is the card number of the output to override.
- M'filename'
- This is the metadata (XML schema or DTD) file location of the output card to override.
- 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 application
interval number of seconds to wait between attempts. If this option is not specified, 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.
- library
- This command option specifies the user library name for the adapters when using an application adapter as a target and should be followed by the function name and application command line, separated by commas. This option, along with the function name and application command line, must be used when alias is not specified.
- function
- This command option specifies the function name for the adapters when using an application adapter as a target and should be prefaced by the user library name and followed by the application command line, separated by commas.
- application_command_line
- This command option specifies the application command line for the adapters when using an application adapter as a target and should be prefaced by the user library name and the function name, separated by commas.
- target-adptr-cmd
- This command option provides the adapter-specific commands that connect to the data target and process the output data. Either this option or "." must be used if the alias option is specified. See the adapter-specific documentation in the Resource Adapters documentation.
- .
- Use Command in the compiled map file. Either this option or target-adptr-cmd must be used if the alias option is specified.