HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 6 Command Definitions P-R

PREP

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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

Feedback to webmaster