HP 3000 Manuals HP 3000 Manuals
PREP
Prepares a compatibility mode program from a user subprogram library
(USL) file onto a program file.
Syntax
PREP uslfile,progfile [;ZERODB][;CAP=capabilitylist][;PMAP]
[;RL=filename][;MAXDATA=segsize] [;PATCH=patchsize][;STACK=stacksize]
[;DL=dlsize][;NOSYM][{;FPMAP }]
[{;NOFPMAP}]
Parameters
uslfile Actual file designator of user subprogram library
(USL) file into which the program has been
compiled.
progfile Actual file designator of program file onto which
prepared program segments are written. This can be
any binary output file created in one of two ways:
* By using the MPE/iX BUILD command to create
a new file and specifying a file code of
PROG or 1029, and one extent.
* By specifying a nonexistent file in the
progfile parameter, in which case a file of
the correct size and type is created. This
file is a temporary file.
ZERODB Request to initialize to zero the initially
defined, user-managed (DL-DB) area of the stack, as
well as the uninitialized portions of the DB-Q
(initial). Default is that these areas are not
affected.
PMAP Request to produce a descriptive listing of the
prepared program to a file whose formal file
designator is $SEGLIST. If no FILE command is found
referencing $SEGLIST, the listing is produced on
$STDLIST. Default is no listing.
segsize Maximum permitted stack area (Z-DL) in words. This
parameter should be included when it is expected
that the size of DL-DB or Z-DB areas will be
changed during program preparation or execution.
Regardless of what you specify, MPE/iX 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 MPE segmenter). The maximum
actual segsize permitted a program is 31,232 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 is rounded down to 31,232 words.
stacksize Size of initial local data area (Z-Q initial)
stack, in words. This value, if specified, must be
between 511 and 32767 words. This parameter
overrides the default stacksize estimated by the
MPE segmenter.
dlsize DL-DB area to be initially assigned to
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. Specify a value between -1
and 32767 words. The default is estimated by the
MPE segmenter.
capabilitylist Capability class attributes associated with a
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 = Extra Data Segments
MR = Multiple RINs
PM = Privileged Mode
You can only specify those capabilities assigned by
the account manager or system manager. Default is
IA and BA.
filename Actual file designator of the relocatable library
(RL) file to be searched to satisfy external
references during preparation. This can be any
permanent binary file of type RL. It need not
belong to your logon group, nor have a reserved
local name. This file, to which you must have READ
and LOCK access, yields a single segment that is
incorporated into the segments of the program file.
For more information, refer to the MPE Segmenter
Reference Manual (30000-90011). Default is that no
library is searched.
patchsize Specifies the size of the patch area. This size
applies to all segments within the program file.
The value you specify must be within -1 and 16380
words.
NOSYM Suppresses the symbolic DEBUG option. Refer to the
HPToolset/V Reference Manual (32350-90001).
FPMAP or NOFPMAP Includes or excludes the internal PMAP information.
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 NOFPMAP.
Operation Notes
The PREP command prepares a compiled source program for execution.
Unless you prepare the program into a previously created program file,
PREP creates a temporary program file for you. It is a good idea to
specify a nonexistent program file when you issue the PREP command. This
way, MPE/iX creates a file of the optimum size and characteristics.
(Refer to the "Examples" section.)
A compiled program is prepared by searching a relocatable library (RL) to
satisfy references to external procedures required by the program. When
the program is prepared, such procedures are linked to the program in the
resulting program file. To use a relocatable library (RL), you must have
READ and LOCK access to it.
NOTE The MPE segmenter employs temporary files named T999SYM, SEGTMP01,
and SEGTMP00. If you have created temporary files having these
names, the segmenter attempts to purge them.
Use
This command may be issued from a session, job, or program. It may not
be used in BREAK. Pressing Break suspends the execution of this command.
Entering the RESUME command continues the execution.
Examples
In the following example, you use the PREP command to prepare a program
from the USL file USLX and the MPE segmenter stores it in the program
file PROGX. Since the MPE segmenter creates PROGX for you, it is a
temporary file, and you must subsequently save it in the permanent file
domain.
PREP USLX,PROGX
SAVE PROGX
Although you will get the best results by having the MPE segmenter create
the program file for you, you can also use the BUILD command to create
your own permanent program file. When you do so, be sure to specify a
file code of PROG or 1029 and a numextents parameter value of 1, as shown
below:
BUILD PROGX;CODE=PROG;DISC=,1
PREP USLX,PROGX
To prepare a program from the USL file named USLZ and store it in a
program file named PROGZ, list the prepared program, assign a stacksize
of 511 words, and limit access to PROGZ to those users having IA, BA, PH,
and DS capability enter:
PREP USLZ,PROGZ;PMAP;STACK=511;CAP=IA,BA,PH,DS
Related Information
Commands PREPRUN, RUN
Manuals MPE Segmenter Reference Manual (32650-60026)