Object Code Accelerator Manual

OCA Syntax and Option Summary
Object Code Accelerator Manual528144-003
5-4
Specifying an Output File Name
UL Usage Considerations
If you do not supply the UL option, OCA interprets any ready-to-run object file
containing no main program as a user library.
You can accelerate a user library explicitly without specifying the UL option.
Specifying an Output File Name
Use the OUTPUT_FILE option to specify an output code file name whose location is
different from the input code file location. When you use the OUTPUT_FILE option,
OCA does not modify or replace the input-file unless the input-file name is the same as
the output-file name.
output-file
is the name of the file to which the OCA will write its output: that is, the accelerated
object file. input-file and output-file can be the same. If you specify an
output file that already exists, OCA attempts to delete it to make room for a file of
the same name. If it cannot delete that older file, it creates a file with a name of the
form “ZZZZnnnn” to use instead, and tells you in the listing that it did so.
Specifying an Obey File
You can specify additional command line options in a text file called an obey file and
then specify the obey file on the OCA command line using the OBEY option.
obey-file-name
is the name of the text file that contains additional OCA command line options.
OBEY Usage Considerations
An obey file can contain any options that can appear on the command line,
including a nested OBEY option and each obey file can contain an unlimited
number of OCA options.
The list of options in an obey file can be as long as you need and contain any
number of comma-separated options on each line. Each option and all of its
arguments must appear on a single line; it may not be continued on a separate
line.
You can insert comments into an obey file to annotate OCA commands. A
comment can be on any line of an obey file, even if that line contains an option. A
oca [/ run-options/] input-file, OUTPUT_FILE output-file
oca [/ run-options/] input-file, OBEY obey-file