Accelerator Manual (G06.27+, H06.04+, J06.03+)

Using the Accelerator
Accelerator Manual—527303-003
4-11
Accelerating Programs With Embedded SQL
If you change the interface to any non-extensible routines in a library, both the library
and the user code programs that call it must reaccelerate. If you only change the
routine internals, only the library must reaccelerate. This is analogous to the
recompilation that you must perform when the interface between your source program
and its library changes.
Accelerating Programs With Embedded SQL
To accelerate programs that contain embedded NonStop SQL/MP statements, you
must perform the following steps in sequence:
1. Compile
2. Bind
3. Accelerate
4. SQLCOMP
If you reaccelerate a program, you must follow by rerunning SQLCOMP.
In the OSS environment, the c89 utility performs these steps in sequence for you by
default.
Only versions of SQLCOMP (and dependent software) dated 15JUN91 or later can be
used with accelerated programs; the use of earlier versions results in the loss of the
accelerated code in the object file.
The Accelerator outputs an accelerated object file that does not have the same file
label as the input TNS object file. The file label contains the PROGID attribute that
determines the ownership of an executing process for NonStop SQL/MP. The
Accelerator turns off the PROGID attribute of the accelerated object file. To set the
PROGID value, use the SQL ALTER PROGRAM statement or the Safeguard security
subsystem interface. Refer to the NonStop SQL/MP Reference Manual or the
Safeguard Reference Manual for details.
Using Obey Files
In the Guardian environment, you can give the Accelerator options on the AXCEL
command line itself, in a text file whose name is given as a command-line option, or
both. In the OSS environment, you can give the Accelerator options by specifying a -
Waxcel flag to the c89 utility, in a text file whose name is given as a-Waxcel flag, or
both.
The text file is referred to as an “obey file.” An obey file can include any option that can
be given on the command line, including other obey file invocations. Any number of
obey files may be invoked within an AXCEL command.