HP 3000 Manuals HP 3000 Manuals
How to Compile Files There are three ways to compile COBOL and Pascal source files. You can use the: Compile function key, COMPILE command, or the Go function key. The COMPILE command and function key accomplish the same objective. When executed, they activate a process that manages the compile process. All of this occurs in background mode and is not apparent from looking at your terminal screen. Therefore, you are free to perform other functions while this process is taking place. The compile process runs in the priority queue that is specified in the SET WORKSPACE command. When you use the Compile command, you need not specify the object file into which you want the compiled code files placed. By default, source files which are owned or used by the current Workspace will be put into the Workspace object file. Source files that are not so owned or used will be put into $OLDPASS by default. The Go function key performs three functions. It allows you to compile, prepare, and run your program by pressing a single function key. Every 75 seconds or every time you press return, TOOLSET/XL will check to see if your compile has completed. When it is finished, a message will be displayed on your screen, giving you a summary of compile errors and warnings. Auxiliary KSAM Files When a Workspace is created, TOOLSET/XL creates an auxiliary KSAM file that is associated with the Workspace. This is the Listing Directory file named in the SET WORKSPACE menu. This file is used by TOOLSET/XL to associate the source files with the listing and program files. The Compiler Listing As the source file is compiled, a listing is created through a message file. If the source file is owned by the current Workspace, this listing will be put into a TSAM file. The Compiler listing can be displayed through the use of the LISTING command. If you want a hard copy of this listing, you should type PRINT ON before doing the compile or press the Print Key while the listing is displayed on your screen. If the source file was not owned by the current Workspace, only the hard copy listing can be generated. The hard copy listings will be sent to the line printer unless a file equation has been set up for the formal designator TOOLLIST. The LISTING command or key is used to view the TSAM listing files that were created during the compile. The listing can be displayed in Visual or Command Mode. When displaying the listing in Visual Mode, function keys are available which allow you to locate and correct compile errors easily. These keys are the FIND ERR and the EDIT keys. Since COBOL groups the error messages together at the end of the listing, the Find Err key will position you at the end of the file. If you want to view a line which contains an error, you should mark the error by positioning the cursor at the error line, and pressing the Mark key twice. Then press the Listing key. The compile listing would be displayed on your terminal screen at the line that caused the error. Similarly, if you wish to edit a line that contains an error, position the cursor at the error, mark it by pressing the MARK key twice, and then press the Edit key. Your edit file will be displayed at the point in your file where the error or warning occurred. Pascal has the error messages merged into the listing where they occurred. The FIND ERR key will sequentially locate compile errors and position you five lines before the error message. If you wish to correct the mistake in your source file, simply press the Edit key. Your file will be displayed at the point where the error occurred. After correcting the error in your edit file, you can return to the listing by pressing the Listing key. Ending Compiles If you want to end a source compile before it has completed, type END COMPILE following the >> prompt on your screen. The compile will end and you will be returned to TOOLSET/XL. You can also type END without parameters and be prompted for which of the ongoing TOOLSET/XL activities, including compiles, you wish to end. TOOLSET/XL does not allow you to EXIT while you are compiling. If you enter the EXIT command during a compile, you will be asked if you want to terminate all compiles. A 'yes' response will end your compiles, terminate TOOLSET/XL and return you to MPE XL. If you answer 'no', your compile will continue and you will remain in TOOLSET/XL.
NOTE If you terminate your compile with either the END COMPILE or EXIT command, you may need to recover your source file. The RECOVER command in Chapter 4 of this Reference Manual will provide the necessary information.