User Manual

Preparing Programs
HP NonStop AutoTMF Software User’s Guide429952-014
3-2
Preparing Programs
Preparation does not invalidate object-file acceleration or SQL compilation, nor does
preparation change binder or linker attributes such as HIGHPIN, HIGHREQUESTERS,
INSPECT, and so on, or the Binder time stamp or the size of the object file.
However, preparation removes LICENSE attribute of an object file, unless one of 2
conditions are met:
the PREPARE is performed by SUPER.SUPER, or
the Escort CI procedure CALLABLE^SET^LICENSE is made callable, as described
in Preserving License Attribute when Preparing Privileged Programs below.
The NonStop AutoTMF runtime user library or DLL contains routines that intercept the
retargeted system calls. User libraries or DLLs do not increase the size of the object
file and are shared in virtual memory by all processes that use them. To upgrade
versions of NonStop AutoTMF software, the runtime library or DLL may be replaced
whenever the program is not running.
If your application programs have user libraries, you should prepare these user
libraries first, then prepare the application programs. The preparation of a program will
fail if the referenced user library has not been prepared; this arrangement eliminates
many errors that might occur if you could prepare a program that referenced an
unprepared user library.
Preparing Programs
Using the PREPARE Command
The PREPARE command processes an object file and updates the procedure identifier
lists to rename references to selected system procedures, such as READ and
FILEINFO, and to NonStop AutoTMF runtime library procedures, such as R^^D and
F^L^^NFO. Renamed procedure names are the same length as the corresponding file
system procedure name, but have all internal vowels changed to the caret (^)
character. Use INFO PREPARE to display a complete list of names.
The PREPARE
command will process collections (that is, file sets) of object files. To
use PREPARE, you must have write access to the object files. The command changes
the object files, so you may wish to retain backup copies of the object files until you
have tested the prepared programs.
The following sample terminal session shows PREPARE
used on a single object file:
9> escort
HP Nonstop(tm) AutoTMF(tm) Command Interpreter(T0581V03) - System \RDF10
Copyright Hewlett-Packard Company 2000-2004
Copyright Carr Scott Software Incorporated 1996-2004
AutoTMF 1? prepare data.myobj.batchobj;
--- $DATA.MYOBJ.BATCHOBJ preparation complete
--- AutoTMF runtime library $SYSTEM.ESCORT.ESCRUNTM
AutoTMF 2?