beautypg.com

Preparing programs, Using the prepare command – HP Integrity NonStop H-Series User Manual

Page 34

background image

Preparing Programs

HP NonStop AutoTMF Software User’s Guide429952-013

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?

This manual is related to the following products: