Object Code Accelerator Manual

OCA Syntax and Option Summary
Object Code Accelerator Manual—528144-003
5-3
Translating a System Library
Translating a System Library
In the TNS/E environment, the non-native portion of a system library is explicitly
accelerated by the system building process. When you invoke OCA and specify the SL
option, this identifies the code undergoing translation as the system library.
OCA assumes if you do not use the SL option:
•
That a TNS object file that contains a main program is a user code file
•
That a TNS object file that does not contain a main programs is a user library file
SL Usage Considerations
•
OCA does not permit incremental module accelerations before binding them
together. You must first use Binder to combine pieces of the system library before
using OCA to accelerate the library.
•
Developers who build system library modules may perform trial accelerations using
OCA.
•
System library components do not require translation before OSBuild.
Translating a User Library
The UL option allows you to explicitly identify a file undergoing translation as a user
library. Specifying the UL options directs OCA to suppress the warning that appears in
the listing file when it finds an inferred user library.
INHERITSCC
<proc-name>
Directs OCA to complete its translation without
issuing a warning when it determines a condition
code is passed into and used by the routine.
INHERITSCC on
page 5-8
RETURNSRn Tells OCA which TNS registers are used for
implicitly passing parameters from the named
procedure
Determining TNS
Register Usage
on page 5-5
RETURNVALSIZE
<proc-name> <n>
Directs OCA to assume that the named procedure
returns the named number of 16-bit words as its
return value
Correcting a
Function’s
Return Values
Size on page 5-5
oca [/ run-options/] input-file, SL
oca [/ run-options/] input-file, UL
Table 5-1. OCA Options (page 2 of 2)
Option Purpose See