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

COBOLII

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Compiles 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 COB74XL.

For information on the 85 entry point, refer to the HP COBOL II/XL Reference Manual (31500-90001)

Syntax

COBOLII[ textfile] 
[ ,[ uslfile] [ ,[ listfile] [ ,[ masterfile] [ ,newfile] ] ] ]
[ ;INFO=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.

uslfile

Actual file designator of the user subprogram library (USL) on which the object program is written. This can be any binary output file with a file code of USL or 1024. Its formal file designator is COBUSL. If the uslfile parameter is omitted, the object code is saved to the temporary file $OLDPASS. If this parameter is entered, it indicates that the file was created in one of four ways:

  • By using the SAVE command to save the default USL file created during a previous compilation.

  • By building the USL with the segmenter command -BUILDUSL. Refer to the MPE Segmenter Reference Manual (30000-90011).

  • By creating a new USL file with the MPE/iX BUILD command and specifying a file code of USL or 1024.

  • By specifying a nonexistent uslfile parameter, thereby creating a permanent file of the correct size and type.

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 master file with which textfile is merged to produce a composite source. This can be any ASCII input file. The formal 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 merged 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 quotes in a row or two double quotes 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

Actual file designator of an HPToolset workspace. The formal designator is COBWKSP.

Operation Notes

The COBOLII command compiles a compatibility mode COBOLII program into a USL file on disk. If you do not specify textfile, COBOLII expects the source text to be entered from your standard input device. If you do not specify listfile, COBOLII sends the program listing to the current list device.

You cannot backreference the formal file designators used in this command (COBTEXT, COBLIST, COBMAST, COBNEW, COBWKSP, and COBXDB) 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 but not in BREAK. Pressing Break suspends the execution of this command. Entering the RESUME command continues the execution.

Example

To compile a COBOLII program stored in the file SOURCE into an object program on the USL file OBJECT and send the listing to the disk file LISTFL, enter:

 BUILD OBJECT;CODE=USL
COBOLII SOURCE,OBJECT,LISTFL

Related Information

Commands

COBOLIIGO, COBOLIIPREP, LINK, RUN, XEQ, LINKEDIT Utility

Manuals

HP COBOL II/XL Reference Manual

Feedback to webmaster