Compaq COBOL AAQ2G1FTK - Manual (Page 3)

Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii
1 Developing Compaq COBOL Programs
1.0.1 Files Installed on Your System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–1
1.1 Compaq COBOL and Alpha Architecture System Resources . . . . . . . . . . . 1–2
1.1.1 Compilation Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2
1.1.2 Tuning OpenVMS Alpha for Large Compaq COBOL Compiles . . . . . . 1–3
1.1.2.1 Optimizing Virtual Memory Usage . . . . . . . . . . . . . . . . . . . . . . . . . 1–3
1.1.2.2 Optimizing Physical Memory Usage . . . . . . . . . . . . . . . . . . . . . . . . 1–4
1.1.2.3 Improving Compile Performance with Separate Compilation
(OpenVMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1–6
1.1.3 Choosing a Reference Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–6
1.1.3.1 Terminal Reference Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–6
1.1.3.2 ANSI Reference Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–7
1.1.3.3 Converting Between Reference Formats . . . . . . . . . . . . . . . . . . . . 1–7
1.2 Developing Programs on Tru64 UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–7
1.2.1 Creating a Compaq COBOL Program on Tru64 UNIX . . . . . . . . . . . . . 1–7
1.2.2 Compiling a Compaq COBOL Program on Tru64 UNIX . . . . . . . . . . . . 1–10
1.2.2.1 Format of the COBOL Command on Tru64 UNIX . . . . . . . . . . . . . 1–10
1.2.2.2 COBOL Command Flags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–11
1.2.2.3 External File Handler Support . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–15
1.2.2.4 Specifying Multiple Files and Flags . . . . . . . . . . . . . . . . . . . . . . . . 1–15
1.2.2.5 Compiling Multiple Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–15
1.2.2.6 Debugging a Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–16
1.2.2.7 Output Files: Object, Executable, Listing, and Temporary
Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1–16
1.2.2.8 Naming Output Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–17
1.2.2.9 Temporary Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–17
1.2.2.10 Examples of the COBOL Command . . . . . . . . . . . . . . . . . . . . . . . . 1–17
1.2.2.11 Other Compilers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–18
1.2.2.12 Interpreting Messages from the Compiler . . . . . . . . . . . . . . . . . . . 1–18
1.2.3 Linking a Compaq COBOL Program on Tru64 UNIX . . . . . . . . . . . . . 1–19
1.2.3.1 Specifying Object Libraries for Linking . . . . . . . . . . . . . . . . . . . . . 1–19
1.2.3.2 Specifying Additional Object Libraries . . . . . . . . . . . . . . . . . . . . . . 1–20
1.2.3.3 Specifying Types of Object Libraries . . . . . . . . . . . . . . . . . . . . . . . 1–21
1.2.3.4 Creating Shared Object Libraries . . . . . . . . . . . . . . . . . . . . . . . . . 1–21
1.2.3.5 Shared Library Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–22
1.2.3.6 Installing Shared Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–22
1.2.3.7 Interpreting Messages from the Linker . . . . . . . . . . . . . . . . . . . . . 1–22
1.2.4 Running a Compaq COBOL Program on Tru64 UNIX . . . . . . . . . . . . . 1–23
1.2.4.1 Accessing Command-Line Arguments . . . . . . . . . . . . . . . . . . . . . . 1–23
1.2.4.2 Accessing Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . 1–24
1.2.4.3 Errors and Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–25
iii