HP 3000 Manuals HP 3000 Manuals
-PREPARE
Prepares the active Relocatable Binary Modules (RBMs) in the
currently-managed User Subprogram Library (USL) file into a program file.
SYNTAX
-PREPARE progfile
[;ZERODB]
[;PMAP]
[;MAXDATA=segsize] [;PATCH=patchsize]
[;STACK=stacksize]
[;DL=dlsize] [{;FPMAP }]
{;NOFPMAP}
[;CAP=caplist]
[;RL=filename]
[;FPMAP]
[;NOSYM]
PARAMETERS
progfile The name of the program file on which the prepared
program segments are to be written. If the named
program file does not exist, the Segmenter will build a
job temporary file for you.
_______________________________________________________
NOTE Code segments in a program file cannot cross disc
extent boundaries. Thus, all segments in such
files must be constructed within one extent. See
the MPE File System Reference Manual (30000-90236)
for a discussion of disc extents.
_______________________________________________________
ZERODB Request to initialize to zero the initially-defined,
user-managed (DL-DB) area of the stack, and
uninitialized portions of the DB-Q (initial) area of the
stack. Default is that these areas are not affected.
stacksize The size of the user's initial local data area (Z to Q
initial) in the stack, in words. This overrides the
stacksize estimated by the Segmenter, which applies if
the stacksize parameter is omitted. (The default is a
function of estimated stack requirements for each
program unit in the program.) Since it is difficult for
the system to predict the behavior of the stack at run
time, you may want to override the default by supplying
your own estimate with stacksize. A value of -1 denotes
the default, which is equivalent to omitting the
parameter.
dlsize The DL-DB area to be initially assigned to the stack.
This area is of interest mainly in programmatic
applications. Due to system logging considerations, the
DL-DB area is always rounded upward so that the distance
from the beginning of the stack data segment to the
DB-address is a multiple of 128 words. The value you
specify must be within -1 and 32,767 words. The default
is estimated by the MPE Segmenter.
PMAP Request to produce a descriptive listing of the prepared
program on file whose formal designator is SEGLIST. If
no :FILE equation is found referencing SEGLIST, listing
is produced on $STDLIST. Default is no listing. See
Appendix G for a listing of a prepared program.
segsize Maximum stack area (Z-DL) size permitted, in words.
This parameter is included if you expect to change the
size of the DL-DB or Z-DB areas during process
execution. If omitted, MPE assumes that these areas
will not be changed. A value of -1 denotes the default,
which is equivalent to omitting the parameter.
Regardless what you specify, MPE may change the segsize
to accommodate table overflow conditions.
If you prepare your program with segsize less than the
configured minimum, the value is rounded up to the
minimum or the amount needed by the program (as
calculated by the Segmenter). The maximum actual
segsize permitted a program is 32,767 words. You may
prepare your program with a segsize larger than
necessary so long as this maximum is not exceeded. If
the specified segsize does exceed the maximum, it will
be rounded down to 32,767 words.
patchsize Specifies the size of the patch area. This size will
apply to all segments within the program file. The
value you specify must be within -1 and 16,380 words.
FPMAP or Includes or excludes the internal PMAP information.
NOFPMAP FPMAP is a request to have internal PMAP information
included in the program. NOFPMAP excludes PMAP
information from the program when the system FPMAP or
job/session FPMAP is on. If the symbolic debug option
is invoked, default is FPMAP. Otherwise the default is
NOFPOMAP.
caplist Capability-class attributes associated with program,
specified as two-character mnemonics. If more than one
mnemonic is specified, each must be separated from its
neighbor by a comma. The mnemonics are:
IA Interactive access
BA Local batch access
PH Process handling
DS Data segment management
MR Multiple resource management
PM Privileged mode
Users who issue the -PREPARE command can only specify
capabilities that they possess (through assignment by
the Account Manager). If the user does not specify any
capabilities, only IA and BA (if the user possesses
them) will be assigned to this program.
filename The name of a Relocatable Library (RL) file to be
searched to satisfy external references during
preparation. This can be any permanent file of type RL.
It need not belong to the log-on group, nor does it have
a reserved, local name. This file yields a single
segment that is incorporated into the segments of the
program file prepared. If filename is omitted, no
library is searched. READ and LOCK access to the RL
file are necessary during PREPARE.
NOSYM Suppresses the symbolic debug option. Refer to the HP
Toolset Reference Manual (32350-90001).
EXAMPLE
-USL OURUSL Opens the USL file OURUSL for management.
-PREPARE PFILE;PMAP; Prepares the active Relocatable Binary Modules
STACK=10;CAP=IA,PM; (RBMs) in the USL file OURUSL into a program
RL=MYRL;FPMAP
file called PFILE. The file does not exist
prior to preparation. We have requested a PMAP
describing the prepared program. The initial
local data area will be 10 words (STACK=10).
PFILE will have two capabilities associated
with it: interactive access and privileged
mode.
During preparation, the Segmenter will search
the RL file MYRL to satisfy external references
within the source code. In addition to asking
for a display of information about the prepared
program file (;PMAP), we have used the ;FPMAP
parameter to request that PMAP information be
made a part of the program file.