PREPRUN

Actual file designator of the USL file to which the program has been compiled.

Contains a character string, terminated by a blank, specifying the entry point (label) in the program where execution is to begin when the program is executed. The entrypoint parameter may be the primary entry point or any secondary entry point in the program's outer block. Default is primary entry point.

Declaration that the program segments are to be placed in nonprivileged (user) mode. This parameter is for programs prepared with privileged mode (PM) capability and makes them accessible to nonprivileged users. Normally, program segments containing privileged instructions are executed in privileged mode only if the program was prepared with privileged mode capability class. (A program containing legally compiled privileged code, placed in nonprivileged mode, may abort when an attempt is made to execute it.) If NOPRIV is specified, all segments are placed in nonprivileged mode. (Library segments are not affected because their mode is determined independently.) Default is that segments of a privileged mode program remain in privileged mode.

Request to produce a descriptive listing of the prepared program to a file whose formal file designator is $SEGLIST. If $SEGLIST is not found in a FILE command, the listing is produced on the current list device. Default is no listing.

Request to issue a DEBUG call before the first executable instruction of the program. Unless the user has READ and EXECUTE access to the program file, this parameter is ignored. If privileged mode (PM) capability has been assigned, the user is put into privileged mode debug. If not, the user is put into user mode debug. Default is that the DEBUG call is not issued.

Request to produce a descriptive listing of the allocated (loaded) program to a file whose formal file designator is LOADLIST. If no FILE command referencing LOADLIST is found, the listing is produced on $STDLIST. Default is no listing.

Request to initialize to zero the initially defined user-managed (DL-DB) area and uninitialized portions of the DB-Q (initial) area. Default is that these areas are not affected.

Maximum permitted stack area (Z-DL) in words. This parameter should be included when you expect 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 a 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 will be rounded down to 31,232 words.

An integer containing a parameter to be passed to the new program (accessed through Q-4 of the outer block).

Size of local data area, Z-Q (initial), in the stack, in words. If it is specified, this value must be between 511 and 32,767 words. The default is estimated by the MPE segmenter.

DL-DB area to be initially assigned to stack. 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 between -1 and 32,767 words. The default is estimated by the MPE segmenter.

Searches the segmented procedure libraries of the program file's group and account. The G option searches the group library, the account library, and then the system library. The P option searches the account library then the system library. The S option searches the system library for external references to segmented procedures. Default is S.

Capability class attributes associated with the program, specified in 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 specify only those attributes that you possess through assignment by the account manager or the system manager. Default is IA and BA.

Actual file designator of the relocatable library (RL) file to be searched to satisfy external references during preparation of the program. This can be any permanent file of type RL, to which you must have READ and LOCK access. It need not belong to the logon group, nor does it require a reserved, local name. This file yields a single segment that is incorporated into the segments of the program file. Refer to the MPE Segmenter Reference Manual (30000-90011) for a description of RL files. Default is that no library is searched.

Request that the file system not use stack segment (PCBX) for its control blocks, even if sufficient space is available. This permits you to expand your stack (with the DLSIZE or ZSIZE intrinsics) to the maximum possible limit at a later time. It does, however, cause the file management system to operate more slowly for this program.

A sequence of characters between two single quotation marks (apostrophes) or two double quotation marks. You may use the delimiting character as part of the string so long as the delimiter appears twice. Any occurrence of two single quotation marks, or two double quotation marks in a row, is considered part of the string, and, therefore, not the terminating delimiter.

The INFO=quotedstring parameter is used in some programming languages (for example, COBOLII, Pascal) to pass compiler options to a program. These options appear before the first line of source code in the text file.

This parameter allows the user to specify the file to be used as $STDIN by the program being executed. If omitted, or if nothing is specified after the equal sign, such as $STDIN=, then $STDIN defaults to the job or session's standard input device. You may use one of the following subparameters with $STDIN=:

This parameter allows the user to specify the file to be used as $STDLIST by the program being executed. If $STDLIST is omitted, or if nothing is specified after the equal sign, such as $STDLIST=, then $STDLIST defaults to the job or session's standard list device. This parameter has the same subparameters as $STDIN, but you may also specify the keyword NEW.

Specifies the size of the patch area. This size applies to all segments within the program file. The value specified must be within -1 and 16,380 words.

Suppresses the symbolic DEBUG option. Refer to the HPToolset/V Reference Manual for more information.

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.

PREP, RUN, XEQ

MPE Segmenter Reference Manual