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

COB74XLG

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Compiles, links, and executes an HP COBOL II/iX program using the ANSI 1974 standard entry point. HP COBOL II/iX is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. This command is recognized only if HP COBOL II/iX is installed on your system. (Native Mode)

Syntax

COB85XLG[textfile] 
[ ,[ listfile] [ ,[ masterfile] [ ,newfile] ] ] ]
[ ;INFO=quotedstring] [ ;WKSP=workspacename] 
[ ;XDB=xdbfilename]
NOTE: This command follows the optional MPE/iX command line syntax. Refer to "Optional Format for MPE/iX Commands" at the beginning of this chapter.

Parameters

textfile

The name of the file that contains the source file that is to be compiled. This can be any ASCII or toolset access method (TSAM) file. The formal file designator is COBTEXT.

If you are running HP COBOL II/iX from your terminal, you will probably specify a disk textfile. If you do not specify textfile, the default file is $STDIN. $STDIN is the current input device, usually your terminal.

listfile

The name of the file to which the compiler writes the program listing. This can be any ASCII file. The formal file designator is COBLIST. If you do not specify listfile, the default is $STDLIST. $STDLIST is usually the terminal in a session or the printer in a batch job.

masterfile

Actual file designator of the master 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 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 quoted string of no more than 255 characters, including the single or double quotation marks that enclose it, that specifies compile time options.

The quotedstring string may be used to pass dollar sign ($) commands to the compiler: "$command1$command2$command3...". The $ must be the first character in the string, and it must be used to separate multiple commands. To extend the quotedstring string over more than one physical line make an ampersand (&) the last character of one line and continue the quotedstring string onto the next physical line. Each $ command is limited in length to the same size as in the source file:

 COB74XLG SALARIES;INFO="$CONTROL &
BOUNDS,MAP,VERBS$SET&$X9=ON" &
COB74XLG ACCOUNTS;INFO="$DEFINE %A=5#"
workspacename

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

xdbfilename

Actual file designator for the file to be used by the symbolic debugger (XDB). This is a permanent file created by the compiler that contains the listing of the source files. The formal file designator is COBXDB.

If this file exists, then it must be in a special format created by a previous compile using this option. In this case, it is first purged. If the file is of the wrong type, the compile is not attempted. The user must either use a different name or purge the file.

Once the file is created, XDB expects the fully qualified name of the file to be unchanged. A FILE equation could be used if the file is renamed.

Operation Notes

The COB74XLG command compiles, links, and executes a program using the ANSI 1974 standard entry point. If you do not specify textfile, HP COBOL II/iX expects the source program to be entered from your standard input device. If you do not specify listfile, HP COBOL II/iX sends the output to your standard list device.

The object file created during compilation is a system-defined temporary file, $NEWPASS, which is passed directly to the Link Editor as $OLDPASS. The Link Editor purges the object file and writes the linked program to $OLDPASS, which is then executed and may be executed repeatedly.

You cannot backreference the formal file designators used in this command (COBTEXT, COBOBJ, 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.

NOTE: This command is implemented as a command file. If you set the HPPATH variable to null (SETVAR HPPATH ""), the command file is not executed, and the command fails.

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.

Examples

To compile, link, and execute an HP COBOL II/iX program entered from your standard input device and send the program listing to your standard list device, enter:

 COB74XLG

To compile, link, and execute an HP COBOL II/iX program from the disk file TEXTFL and send the program listing to the disk file LISTFL, enter:

 COB74XLG TEXTFL,LISTFL

Related Information

Commands

COB74XL, COB74XLK, LINK, RUN, XEQ, LINKEDIT Utility

Manuals

HP COBOL II/XL Reference Manual

HP COBOL II/XL Programmer's Guide

HP Link Editor/iX Reference Manual

Feedback to webmaster