COB74XLG


COB74XLG


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 900 Series HP 3000 computer system
fundamental operating software and must be purchased separately.

SYNTAX

     COB74XLG [TEXTFILE][,[LISTFILE][,[MASTERFILE][,NEWFILE]]]
[;INFO=QUOTEDSTRING]
[;WKSP=WORKSPACENAME]
[;XDB=XDBFILENAME]

PARAMETERS

TEXTFILE            THE NAME OF THE FILE THAT CONTAINS THE SOURCE FILE
THAT IS TO BE COMPILED. THIS CAN BE ANY ASCII OR
TOOLSET 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 PARAMETER SPECIFYING COMPILE TIME OPTIONS FOR THE
COMPILER. IT IS A QUOTED STRING OF NO MORE THAN 255
CHARACTERS (INCLUDING THE SINGLE OR DOUBLE QUOTE
MARKS THAT ENCLOSE IT).

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. YOU MAY EXTEND THE
QUOTEDSTRING STRING OVER MORE THAN ONE PHYSICAL LINE
BY MAKING AN AMPERSAND (&) THE LAST CHARACTER OF ONE
LINE AND CONTINUING 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
XDB. THIS WILL BE 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, 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
THEN 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.

NOTE

THE FORMAL FILE DESIGNATORS USED IN THIS COMMAND (COBTEXT, COBOBJ,
COBLIST, COBMAST, COBNEW, AND COBWKSP, COBXDB) CANNOT BE BACKREFERENCED
AS ACTUAL FILE DESIGNATORS IN THE COMMAND PARAMETER LIST. FOR FURTHER
INFORMATION, REFER TO THE SUBENTRY IMPLICIT IN THE FILE ENTRY OF THE
HELP FACILITY.

OPERATION

     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 LINKEDITOR AS $OLDPASS. THE LINKEDITOR PURGES THE
OBJECT FILE AND WRITES THE LINKED PROGRAM TO $OLDPASS, WHICH
IS THEN EXECUTED AND MAY BE EXECUTED REPEATEDLY.

THIS COMMAND IS RECOGNIZED ONLY IF HP COBOL II/iX IS
INSTALLED ON YOUR SYSTEM. THIS COMMAND MAY BE ISSUED FROM A
SESSION OR JOB, BUT NOT IN BREAK OR FROM A PROGRAM. PRESSING
[BREAK] SUSPENDS THE EXECUTION OF THIS COMMAND. ENTERING
RESUME CONTINUES THE EXECUTION.

THIS COMMAND MAY BE ISSUED FROM A SESSION, JOB, OR
PROGRAM. IT MAY NOT BE USED IN BREAK. PRESSING [BREAK]
SUSPENDS THE EXECUTION OF THIS COMMAND. ENTERING RESUME
CONTINUES THE EXECUTION.

NOTE

THIS COMMAND IS IMPLEMENTED AS A COMMAND FILE. IF YOU SET THE HPPATH
VARIABLE TO NULL (SETVAR HPPATH ""), THE COMMAND FILE WILL NOT BE
EXECUTED, AND THE COMMAND WILL FAIL.

EXAMPLE(S)

     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

ADDITIONAL INFORMATION

COMMANDS:   COB74XL, COB74XLK, LINK

MANUALS :   HP COBOL II/XL REFERENCE MANUAL (31500-90001)
            HP COBOL II/XL PROGRAMMER'S GUIDE (31500-90002)
            HP Link Editor/iX Reference Manual (32650-90030)