434 Chapter 6
Command Definitions P-R
PREP
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.
