HP 3000 Manuals HP 3000 Manuals
Table of Contents
COBOL/HP-UX Operating Guide for the Series 700 and 800
COBOL/HP-UX Operating Guide for the Series 700 and 800 : COPYRIGHT NOTICE
Ch 1. Part I COBOL Program Development Introduction to Program Development
The Program Development Part
Program Development Cycle
Program Source Conventions
Ch 2. COBOL System Interface (cob)
Overview
Operation
Invoking the cob Command
Specifying cob Options
cob File Processing
Locating the COBOL System Components
cob Flags
Command Line Conventions
Command Line Examples
Ch 3. Compiling
Overview
Operation
Directives
Directives Syntax
Setting Directives
The Compiling Process
Listing Format
Compiler Error Messages
Redirection of Compiler Output
COPY Libraries
Copy Path-name
Search Sequence
Ch 4. Animating
Overview
Operation
Preparing for Animation
Invoking Animator
Copy File and Information File Location
Screen Description and Operation
The Information Line
Moving the Cursor and Text During Animation
Entering Text on Menus
Using the Animator Windows
Specifying Animator Directives
Menus
Alter-window Menu
Animator Main Menu
Breakpoints Menu
Environment Menu
Go Menu
Locate-declaration Menu
Perform-level Menu
Query Menu
Query-Data Menu
Reset-execution Menu
Text Menu
Functions
Function Access
Function Descriptions
Default Animator Function Keys
Error Messages
Ch 5. Generating
Overview
Operation
Directives
Directives Syntax
Setting Directives
The Generating Process
Generating Segmented Programs
Ch 6. Linking
Overview
Dynamic Linking
Static Linking
Dynamic Loading
Operation
Creating Dynamically Linked Executable Modules
Creating Statically Linked Executable Modules
Creating Dynamically Loadable Executable Files
Statically Linking the Compiler
Ch 7. Running
Overview
Operation
Invoking Your Program
Statically linked module
Dynamically linked module
Dynamically loadable program
Switch Parameters
Setting
Switches Available
TMPDIR Environment Variable
Accessing Command Line Parameters
Run Time System Error Messages
The COBOL Profiler
Invoking the Profiler Program
Profiler Output
Ch 8. Library Routines (Call-by-Name)
Overview
Portability of Call-by-Name Routines
Routines by Category
Application Subsystems
Byte-Stream Files
Closedown Procedure
Error Procedure
File-names
Files
Keyboard
Logic Operators
Mouse
Multiple Run-Units
National Language Support
Operating System Information
Screen
Text
Virtual Heaps
Operation
Descriptions of Routines
Operation (cont.)
Operation (cont.)
Ch 9. Library Routines (Call-by-Number)
Overview
Routines Available
Operation
Descriptions of Routines
Put a Character to the Screen
Read a Character from the Keyboard
Split a File-name
Join a File-name
Interprogram Function Calls
Control the Screen
Modify ACCEPT/DISPLAY Behavior
Disable Interrupt Key
Control Screen I/O
Test Keyboard Status
Sound the Beep
Move the Cursor to a Defined Position
Pack Byte
Unpack Byte
Ch 10. Writing Programs
Overview
Choosing Intermediate or Native Code
Operation
Performance Programming
Environment Division Considerations
Data Division Considerations
Procedure Division Considerations
Compiler Directives
Implementation of Floating-Point
Range
Accuracy
Handling Large Programs
Operation (cont.)
Calling Subprograms
Calling COBOL Subprograms
Calling Non-COBOL Subprograms
Calling Operating System Functions
Recursion
Ch 11. Part II File Handling Introduction to File Handling
The File Handling Part
Ch 12. COBOL File Handling
Overview
Operation
COBOL Data File Organizations
COBOL File Naming Conventions
COBOL Data-File Assignment
Fixed File Assignment
Dynamic File Assignment
External File Assignment
File-Name Mapping
Global File-Name Mapping
Multiple Reel Files
Multiple Reel File Header Record
File Usage
File Compression
Data Compression
Key Compression
Example of Setting Compression
Duplicate Keys
Btrieve Call Conversion Module
BTR2XFH Call Converter
Compatibility
Key Lengths
Key Types
Record Size
Page Size
Indices
Data Compression
File Operations
The Stat Operation
Ch 13. File Handler Utilities
Overview
Operation
Invoking the File Handler Utilities
Command Line
Calling the File Handler Utilities from COBOL
File Types Supported by the File Handler Utilities
Record Delimiters
Default File Type Parameters
Default Indexed Block Size
Use of Keys in Indexed Files
Error Handling
Error Conditions
Creating Statically Linked Executable Files
fhconvert Utility
fhconvert Parameter File Format
fhconvert Error Messages
fhcreate Utility
fhcreate Parameter File Format
fhcreate Error Handling
fhedit Utility
fhedit Parameter File Format
fhedit Error Handling
fhinfo Utility
fhinfo Parameter File Format
fhinfo Error Handling
fhrebuild Utility
fhrebuild Parameter File Format
fhrebuild Error Handling
fhreorg Utility
fhreorg Parameter File Format
fhreorg Error Handling
fhreorg Restrictions
fhvalidate Utility
fhvalidate Parameter File Format
Validation Information Messages
fhvalidate Error Handling
Demonstrating the File Handler Utilities
File Handler Utilities Demonstration Programs
Demo1 Demonstration Program
info1 Demonstration Program
info1.inf Parameter File
info1a Demonstration Program
info2 Demonstration Proram
info2.inf Parameter File
info2a Demonstration Program
Demo2 Demonstration Program
create.cre Parameter File
create.inf Parameter File
create Demonstration Program
edit.edi Parameter File
edit Demonstration Program
edit2 Demonstration Program
Demo3 Demonstration Program
validate Demonstration Program
validate.val Parameter File
validate2 Demonstration Program
rebuild Demonstration Program
validate.inf Parameter File
Demo4 Demonstration Program
convert Demonstration Program
convert.inf Parameter File
convert.rel Parameter File
convert.seq Parameter File
convert.lsq Parameter File
convert.ind Parameter File
Demo5 Demonstration Program
reorg1 Demonstration Program
reorg.reo Parameter File
reorg2 Demonstration Program
reorg3 Demonstration Program
Ch 14. Callable File Handler
Overview
Features of the Callable File Handler
Operation
Your Own File Handler
Calling the File Handler from Other Languages
Opening a File More Than Once
Accessing the FCD from a Program
Sparse Keys
Creating a New Index
File Status Conversion
File Compression Routines
Data Compression
Calling a Micro Focus Data Compression Routine
Data Compression using a $SET Statement
Key Compression
Relative Byte Addressing
Obtaining the Relative Address
Using the Relative Address
Callable File Handler Call Interface
Step Operations
Action Codes
Special Action Codes
File Control Description
Record Area
File-name Area
Key Definition Block
FCD Fields Input to the File Handler
FCD Fields Returned by the File Handler
C-ISAM Programming Features
Ch 15. Callable Sort Module (EXTSM)
Overview
Operation
CALL Interface
Function Codes
SORT File Control Descriptor
Key Definition Block
File Definition Block
Ch 16. Multi-User File Handling
Overview
Using the Demonstration Programs
Running the Demonstration Programs
Including Multi-User Syntax in Your Program
Facilities in Multi-User Micro Focus COBOL
Data Locking
Record Sequential and Line Sequential Files
Relative Files
Indexed Sequential Files
All File Types
Procedure Division Entry for Multi-User Environments
File Status
Handling a File or Record Lock
Ch 17. File Formats
Overview
Operation
Fixed and Variable Format
Fixed Structure
Variable Structure
Structure of Each File Organization
Sequential Organization
Fixed Format Sequential Structure
Variable Format Sequential Structure
Record Sequential Files
Record Sequential Structure
Line Sequential Organization
Line Sequential Structure
Relative Organization
Fixed Format Relative Structure
Variable Format Relative Structure
Micro Focus Indexed Sequential Organization
Micro Focus Indexed Sequential Index File Structure
Micro Focus Indexed Sequential Data File Structure
Ch 18. File Status
Overview
Operation
Alternate File Status Table
Globally Altering File Status Values
Altering File Status Values for Individual Run-Time Systems
USE Procedures
Ch 19. Part III Screen, Keyboard and Device Handling Introduction to Screen Hand
Overview
Screen Handling Methods
ANSI ACCEPT/DISPLAY
Enhanced ACCEPT/DISPLAY
Screen Section
Windowing Syntax
Low Level - COBOL System Library Routines
Panels
Dialog System
Screen Handling Comparison Table
Ch 20. ADIS
Overview
Enhanced ACCEPT/DISPLAY
Screen Section
Configuration
Operation
Single Field ACCEPT and DISPLAY Statements
DISPLAY Statements
ACCEPT Statements
Displaying or Accepting Group Items
Displaying Group Items
Accepting into Group Items
The MODE IS BLOCK Clause
Screen Section ACCEPT and DISPLAY Statements
The CURSOR IS Clause
Large Screens
ADIS Configuration
Altering the ADIS Configuration from a Program
ADIS Run Time Configuration
Select Timeout Units
Timeout Reset Control
Allow Screen Read on Non-FED Terminal
Control Clause In ACCEPT/DISPLAY Statements
Data Division Size
Keyboard Handling Via ADIS
Function Key Handling
Types of Keys on the Keyboard
The CRT STATUS Clause
Normal Termination of an ACCEPT
Using the User Function Keys
Default User Function Keys
Using the ADIS Keys
The ADIS Keys
Defining a Key in Both the User and ADIS Key Lists
Function Keys and the COBKEYTIMEOUT variable
Data Key Handling
The Alt And Ctrl Keys
Get Single Character Routine
Program Sample
Solutions to Common Problems
Ch 21. ADIS Configuration Utility (ADISCF)
Overview
Operation
Invoking the ADISCF Utility
Using the ADISCF Utility
The Alter Option
The Load Option
The Save Option
The Delete Option
The Choose Option
Ch 22. Device Handling and Terminfo
Overview
Operation
Devices
Printing
The DISPLAY UPON PRINTER Statement
Controlling Terminal Printers
Terminal Handling
Control and Alt Key Support
Wide Terminal Mode
Wyse Terminal Support
Terminfo Entries
Essential Entries
Optional Entries
Ch 23. Forms-2
Overview
Operation
Operation (cont.)
Outputs
Phases
Operator Interface
Forms-2 Validation
Initialization Phase
Initialization Screen I01
Initialization Screen I02
Work Phase
Screen W01
Work Screen
Work Phase Completion
Operation (cont.)
Data Descriptions
Record Name and Data Name Generation
Picture Generation
Editing the DDS File
Incorporation of DDS File Contents
The Checkout Program
Checkout Program Generation
Compiling Your Checkout Program
Running Your Checkout Program
Screen Image File
Screen Image File Generation
Forms-2 Maintenance
Printed Forms
Form Images in the Design Process
Forms-2 User Screen Generation Example
Index Program
Index Program Generation
Files Generated
Producing an Executable Index Program
Running Your Index Program
User Index Program Example
Ch 24. Keyboard Configuration Utility (KEYBCF)
Overview
The Key Lists
Operation
Invoking KEYBCF
Using KEYBCF
List of Standard ADIS Key Functions
Special Mapping Functions
Ch 25. Panels
Overview
Frequently Used Terms
Operation
Call Interface
Text and Attributes for the Panel
Panels Parameter Block
Clipping Window Height and Width
Panels Functions
Using Panels with ADIS
Some Considerations
CALL Syntax
ADIS Functions for Panels
Panels Status Values
Ch 26. Windowing Support
Overview
Operation
The CLOSE WINDOW Statement
The DISPLAY Statement
General Rules
Windowing Restrictions
Windowing Error Messages
Windowing Supplementary Information
Demonstration Programs:
Ch 27. Part IV Additional COBOL System Features/Communications Module (MCS)
Overview
The Message Control System
Operation
Creating an Initialization File
Defining a Console
Defining the Queue
System Initialization
Updating an Initialization File
Using the Initialization File
Communicating with other Consoles
Sending a Message
Receiving a Message
Ch 28. H2CPY
Overview
Operation
H2CPY Syntax
H2CPY Options
The Multiple-Files (/M) Option
Using Split78
Converting C Statements
Translating ##define Statements
Typedef Statements for Simple Types
Typedef Statements for Structures
COMP-5 Redefinition for Pointers
Other C Constructs Recognized
H2CPY Limitations
Ch 29. Integrated Preprocessor
Overview
Operation
Limitations
Invoking a Preprocessor
Testing a Preprocessor
Invoking Multiple Preprocessors
Writing a Preprocessor
Definition of the Interface
Preprocessor Parameters
The Initial Call
Subsequent Calls
Marking Source Lines
Source modification
COPY-files
Generating Error Messages
Multiple Preprocessors
Writing a Stackable Preprocessor
Ch 30. National Language Support (NLS)
Overview
Operation
Compiling Programs with NLS
Setting up the National Language Environment
Running Your NLS Program
String Comparisons
Class Condition Tests
Indexed Sequential File Operations
Comparisons During SORT or MERGE Operations
User Interfaces
Mixing Programs With and Without NLS
Ch 31. Run-Time Configuration
Overview
Operation
Run-Time Configuration File
Setting Environment Variables
Setting Run-Time Tuneables
Run-Time Tuneables
cobconfig_error_report
command_line_accept
dynamic_memory_limit
dynamic_dictionary_limit
isam_block_size
isam_open_key_check
lock_mode
same_proc_excl_detection
Environment Variables
Ap A. Part V Appendices Advanced Programming Features
Mixing C and COBOL Programs
C Functions
Name Function
Cobcall Function
Cobcancel Function
Cobexit Function
Cobfunc Function
Cobkeypad Function
Cobtidy Function
Example Program
Library Routines
Cobsavenv and Coblongjmp
Screen Handling from C
Screen Handling Example
Configuring the _CODESET Program
Ap B. Compatibility Issues
Making Applications Portable
Assumed User Environment
Introduction to Portability
Creating Portable Intermediate Code
Using INTLEVEL"2"
Using INTLEVEL"1"
Portable Syntax
Using INTLEVEL"2"
Using INTLEVEL"1"
Restrictions
COBOL System Library Routines
COMP-5
ACCEPT and DISPLAY
RM COBOL Semantics
Fixed File Attribute Conflicts
Files with no FILE STATUS Item
Other Directives
Portability Guidelines
Operating System Specific Features
The User Attribute Byte
Case Sensitivity
Paths
Extended Character Sets
The Alt and Ctrl Keys
USAGE COMP-5
$SET and .GNT Code Directives
The ROLLBACK Phrase
Creating Portable Source Code
Features for Backward Compatibility
Calling Non-COBOL Subprograms
Incorporating Non-COBOL Subprograms into the RTS
Modifying the Run-Time Subprogram Table
Non-COBOL Programs Calling COBOL Subprograms
COBOL Capabilities File (cobcap)
COBCTRLCHAR Environment Variable
Commands to Invoke the Micro Focus COBOL System Components
Optimizing Intermediate Code
Ap C. Descriptions of cob Error Messages
Ap D. Descriptions of cob Flags
Descriptions of Flags
Ap E. Descriptions of Run-Time Switches
Programmable Switches
Run-Time Switches
Ap F. Directives for Animator
Animator Directives Summary
Descriptions of Directives
Descriptions of Directives (cont.)
Key
Ap G. Directives for Compiler/Generator
Directives by Category
Allowing Language Features
Choosing Run-Time Behavior
Compiler Control
Compiling for Debugging
Format of Your Data Files
Object Code, Size and Optimization
Reserved Directives
Descriptions of Directives
Descriptions of Directives (cont.)
Key
Descriptions of Directives (cont.)
Descriptions of Directives (cont.)
Directives for Compiler/Generator (cont.)
Directives for Compiler/Generator (cont.)
Directives for Compiler/Generator (cont.)
Ap H. Directives for Profiler
Descriptions of Directives
Ap I. Environment Variables
Environment Variables
CCITCP2
COBAIF
COBANIMOPT
COBATTR
COBCONFIG
COBCPY
COBDATA
COBDIR
COBIDY
COBKEYTIMEOUT
COBLPFORM
COBNOFED
COBOPT
COBPATH
COBPRINTER
COBSW
COBTERMINFO
LD_LIBRARY_PATH
TERMINFO
TMPDIR
Ap J. File Handler Utility Error Messages
Utility Error Messages
File Specific Error Codes
Errors Associated with C-ISAM and X/Open Files
Errors for Remaining File Types
When status1 is Set to 5
When status1 is Set to 9
Ap K. Example fhconvert Parameter File
Ap L. Sample Programs
Ap M. System Limits and Programming Restrictions
COBOL System Limits
Specifications
Programming Restrictions
COBOL Syntax Not Implemented
Areas to Avoid
PERFORM Nesting
Parameters in USING Clause
Size of Numbers
The ENTRY Statement
Local-Storage Section
Ap N. UNIX Key Usage Chart
INDEX
Index A-E
Index F-Z