HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 3  Command Definitions C-E

COBOLIIPREP

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Compiles and prepares a compatibility mode COBOLII program on the COBOL 74 compiler. COBOLII is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. The native mode equivalent of this command is COB74XLK.

For information on the 85 entry point, refer to the COBOL/II 3000 Reference Manual

Syntax

COBOLIIPREP[ textfile] 
[ ,] progfile] ,[ listfile] [ ,[ masterfile] [ ,newfile] ] ] 
[ ;INFOR=quotedstring] [ ;WKSP=workspacename]

Parameters

textfile

Actual file designator of the input file from which the source program is read. This can be any ASCII input file. Formal file designator is COBTEXT. Default is $STDIN.

progfile

Actual file designator of the program file to which the prepared program segments are written. If progfile is omitted, the MPE segmenter creates the program file, which resides in the temporary file domain as $OLDPASS. If entered, progfile indicates that the file was created in one of two ways:

  • By specifying a file code of 1029 or PROG, and a numextents value of 1. This file is then used by the PREP command.

  • By specifying a nonexistent file in the progfile parameter. A temporary job file of the correct size and type is created.

listfile

Actual file designator of the file to which the program listing is written. This can be any ASCII output file. Formal file designator is COBLIST. Default is $STDLIST.

masterfile

Actual file designator of the file which is merged against textfile to produce a composite source. This can be any ASCII input file. Formal file designator is COBMAST. Default is that the master file is not read; input is read from textfile, or from $STDIN if textfile is not specified.

newfile

Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal file designator is COBNEW. Default is that no file is written.

quotedstring

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

INFO=quotedstring is used in the COBOLII programming language to pass compiler options to a program. These options appear before the first line of source code in the text file.

workspacename

This parameter is the actual file designator of an HPToolset workspace used with HPToolset. The formal file designator created by the compiler is COBWKSP.

Operation Notes

The COBOLIIPREP command compiles and prepares a compatibility mode COBOLII program into a program file on disk. If you do not specify textfile, COBOLII expects your input from your standard input device. If you do not specify listfile, COBOLII sends the listing output to your current list device.

The USL file created during compilation is a system-defined temporary file, $OLDPASS, which is passed directly to the MPE segmenter. The segmenter overwrites the USL file and writes the prepared program to $OLDPASS, if progfile is omitted, which can then be executed.

You cannot backreference the formal file designators used in this command (COBTEXT, COBLIST, COBMAST, COBNEW, and COBWKSP) as actual file designators in the command parameter list. For further information, refer to the "Implicit FILE Commands for Subsystems" discussion of the FILE command.

Use

This command may be issued from a session, job, or program. It is not available in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution.

Examples

To compile and prepare a COBOLII program entered from your standard input device ($STDIN), with the listing printed on the standard list device ($STDLIST), enter:

 COBOLIIPREP

To compile and prepare a COBOLII source program input from the text file SFILE into a program file named MYPROG, with the listing sent to the current list device, enter:

 COBOLIIPREP SFILE,MYPROG

Related Information

Commands

COBOLII, COBOLIIGO

Manuals

HP COBOL II Reference Manual (31500-90001)

Feedback to webmaster