rep Command [PREP/:P]
Converts the object code in a USL file into a “program file”. USL files are produced by compilers. Program files are what you execute in the :Run command.
REP[ uslfile ] [ ,progfile ] [ ; ]
[ STACK words ]
[ MAXDATA words ]
[ DLSIZE words ]
[ RL rlfile ]
[ CAP caplist ]
[ PMAP ]
[ QMAP ]
[ LP ] {map to printer}
[ PATCH words ]
[ ZERODB ]
[ FPMAP ]
[ NOFPMAP ]
[ YES ]
[ NO ]
[ NOSYM ]
[ CHECKSUM]
(Defaults: uslfile = $oldpass,
progfile = $newpass;
see Set MAXDATA for default;
see Set RL for rlfile)
The parameters to rep are the same as in MPE. Keyword parameters can, of course, occur in any order. In Qedit, all parameters including file names are optional. Most of the parameters may be shortened to a single letter.
uslfile | USL file produced by the compiler (default = $oldpass). |
progfile | PROG file produced by the rep (default = $newpass). |
STACK | specifies starting dynamic stack (seldom needed). |
MAXDATA | specifies largest stack size (MPE expands). |
CAP | specifies capabilities (example: CAP IA BA PH MR). |
PMAP | causes a procedure map to be printed. |
QMAP | causes the PMAP to be reorganized into a more readable report; procedures are put into alphabetical order and a segment-size histogram is added. QMAP;LP directs the QMAP to the line printer (QMAPLIST). The program Qmap.Pub.Robelle must be on the system. |
LP | causes the PMAP or QMAP to appear on the printer. |
PATCH | reserves a specified number of words at the end of each code segment for patches. |
ZERODB | sets uninitialized global stack locations to zero. |
FPMAP | writes a copy of the PMAP into the program file for debugging. |
NOFPMAP | does not write a copy of the PMAP into the program file for debugging. |
YES | purge any existing program without asking permission. |
NO | do not purge any existing program file. |
NOSYM | does not write the symbol table into the program file. |
CHECKSUM | writes checksum information to the program file. |
Examples
/open src {open source file} /modify ... {make some changes} /cobol * {compile it, with code to $newpass} /prep {prep $oldpass,$newpass} /run {run $oldpass and see if it still works!} /prep ,pf {prep $oldpass into the file pf} /prep;c mr lp {prep with cap=mr and send pmap to printer}
Notes
If the program file already exists and it has CODE of “PROG”, Qedit asks whether you want to purge it. If you answer NO, Qedit cancels the rep. After the rep, Qedit saves the program file, even if a nonfatal error occurs.
To send the QMAP to a disc file, use these commands:
/purge discfile /build discfile;rec=-80,16,f,ascii /file qmaplist=discfile,old;dev=disc /prep uslfile,progfile;qmap {do not use LP} /list discfile