MPE/iX Commands Reference Manual (32650-90877)

374 Chapter10
Command List VIII
Commands PASCAL thru PURGEUSER
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