Micro Focus Visual COBOL 2.3 for Eclipse (UNIX)
Welcome
The Micro Focus Community
Overview of application development in Eclipse
Introduction to Eclipse
Eclipse Basics
Workspaces
IDE Preferences
Projects
Using the Windows and Menus
The Eclipse Welcome Page
Views
Perspectives
Menus and Toolbars
Controlling Views and Editors
Navigation Shortcuts
The Eclipse Resource System
Resources
Linked Resources
Configuring Projects
Properties
Project Build Path
Build Precedence
Inter-Project Dependencies
Copybooks
Including Files and Folders
Working Sets
Remote Projects
Development Life Cycle
Project Types
Adding Projects to Your Workspace
Adding Existing Source Files into a Project
Compiler Directives and Project Settings
Editing
Building
Running and Debugging
Additional Eclipse Functionality
Managing Licenses
To activate Visual COBOL Personal Edition
To request and activate a 30-day trial license for Visual COBOL
To buy and activate a full license
To obtain more licenses
New Features
New Features in Visual COBOL 2.3
Integration with the Eclipse IDE
General Enhancements and Updates
Building JVM COBOL Projects Incrementally
COBOL Editor
Code Analysis
Code Coverage
Compiler Directives
Data File Structure Command Line Utility
Data File Tools (Technology Preview)
Database Access
File Handling
File Locking
Library Routines
Managed COBOL Syntax
Micro Focus Unit Testing Framework
Personal Edition Licensing
Preprocessors
Profiler
Remote Connections
REST service interfaces
RM/COBOL Compatibility
RPM Installer
Single File Support
Tunables
Updated Run-time System
Features Added in Visual COBOL 2.2 Update 2
Enhancements in the Eclipse IDE
Character set enhancements
Code Analysis
Database Access
Language Environment (LE) Support
Micro Focus COBOL enhancements
External Security Facility (ESF)
New tunables
Features Added in Visual COBOL 2.2 Update 1
ACUCOBOL-GT Compatibility
Compiler Directives
Database Access
Enterprise Server Integration in the IDE
Fileshare Recovery
Micro Focus Heartbleed Update
Interface Mapping Toolkit
Line Numbering for COBOL Programs
Managed COBOL
Project and Item Templates
Remote Connections
Run-time Support
New Terminfo files
Features Added in Visual COBOL 2.2
ACUCOBOL-GT Compatibility
RM/COBOL Compatibility
COBOL Source Information (CSI)
Compiler Directives
Consolidated Tracing Facility
Enhanced ACCEPT and DISPLAY Statements
File Handling
Interface Mapping Toolkit
Managed COBOL
Problems View
Support for SOA
XML Extensions
Features Added in Visual COBOL 2.1 Update 1
Compiler Directives
Features Added in Visual COBOL 2.1
ACUCOBOL-GT Data Types in Managed Code
ACUCOBOL-GT Library Routines in Managed Code
Automatic Directives Detection and Setting
Compiler Directives
.int, .gnt and .lbr File Types Support
Just-in-time debugging
JVM Class Library
Managed COBOL Enhancements
OpenESQL
UNIX Platforms Support
Features Added in Visual COBOL 2.0
Automatic Directives Detection and Setting
COBOL Explorer View
COBOL File Search
Compiler Directives
Compiling Single Files
Enhancements to Developing Applications on a Remote Machine
Copybook Context
Debugging Enhancements
Eclipse 3.7
JVM COBOL File Handler
Library Routines
Managed COBOL Language Features
Data Access
Remote COBOL JVM Projects - Early Release
Run-Time Tunables
Samples
Vision Data File Searching
Features Added in Visual COBOL 2010 R4 Update 2
New Platforms Support
OO COBOL Class Library Reference
Features Added in Visual COBOL 2010 R4
ACUCOBOL-GT Compatibility
COBOL for Java Virtual Machine (JVM) Support
Embedded HTML
Improved Usability
Language Improvements
Renamed Color Preferences
Reporting of Linker Errors
RM/COBOL Compatibility
XML Extensions
Features Added in Visual COBOL 2010 R3
.NET COBOL Syntax Improvements
Creating Projects from Existing Code
Add Existing COBOL Items Wizard
Override Class Members Dialog
Smart Tag for Implementing Interfaces
Snippet for Implements
Navigate To
Find All References
Web Application Projects
Debugging
Samples Browser
ACUCOBOL-GT Compatibility and RM/COBOL
XML Support
Features Added in Visual COBOL 2010 R2
File Handler
Go To Procedure Division
Samples
Snippets
SQL Support
XML Parse/Generate
Features Added in Visual COBOL 2010 R1
Visual Studio as the Core Integrated Development Environment
COBOL 2010
COBOL Language Extensions
Visual COBOL Tutorials
Product Information
Installing Visual COBOL for Eclipse (UNIX)
System Requirements for Visual COBOL for Eclipse (UNIX)
Hardware Requirements for Visual COBOL for Eclipse
Operating Systems Supported
Software Requirements
Additional Software Requirements
Installing Visual COBOL for Eclipse (UNIX)
Downloading the Product
Installing
Installing the software
Setting up the environment
Starting the product
Installing as an upgrade
Installing Visual COBOL into other instances of Eclipse
UNIX and Linux Installer Issues
Installing silently
RPM Installer
Using the RPM Installer
Other RPM Installer Options
Uninstalling Using the RPM Installer
After Installing
Configuring the Environment for Developing RDBMS Applications on UNIX
Repairing
Uninstalling
Installing Micro Focus Visual COBOL Development Hub
System Requirements for Visual COBOL Development Hub
Hardware Requirements for Micro Focus Visual COBOL Development Hub
Operating Systems Supported
Software Requirements
Additional Software Requirements for Micro Focus Visual COBOL Development Hub
Installing Visual COBOL Development Hub
Downloading the Product
Installing
Installing as an Upgrade
Installing silently
UNIX and Linux Installer Issues
RPM Installer
Using the RPM Installer
Other RPM Installer Options
Uninstalling Using the RPM Installer
Configuring the Remote System Explorer Support
Repairing on UNIX
Uninstalling
Managing Licenses
Overview
To start Micro Focus License Administration
Installing licenses
If you have a license file
If you have an authorization code
Authorizing your product when you have an Internet connection
Authorizing your product when you don't have an Internet connection
Configuring your machine to use a network license server
Installing licenses silently
Viewing installed licenses
Uninstalling licenses
Removing licenses
Revoking licenses when you have an Internet connection
Revoking licenses when you do not have an Internet connection
Trial licenses
Commuter licenses
To obtain a commuter license
To return a commuter license
Usage log
Licensing Error Messages
Initialization error - Initializing: Cannot communicate with licensing daemon
Error - Initalizing: Cannot find initialization file
Error - Unable to manage licenses in license manager that is not running on localhost
Error [5]: Cannot talk to the license server on host "xxx.x.x.x". Server not running
Error authorizing... Remote request error - The authorization code is invalid
Error [26] - Request Denied due to clock tamper detection
Error[18]: No license code is available for feature (component)
Unable to authorize (cause)
Updates and Product Support
Micro Focus End User License Agreement
Backward Compatibility with Earlier Micro Focus Products
Known Issues and Restrictions
COBOL Programming
Boolean Data Items
CBL2XML Utility
Interface Mapping Toolkit
Enhanced ACCEPT/DISPLAY Syntax (Adis)
Filenames
IDXFORMAT 8 File Size Limits
Unsupported Features
XML Extensions
XML Support and Syntax Extensions
Compatibility
Coexisting with earlier Micro Focus products
Installation
Data Access
OpenESQL
DB2
COBSQL
File Handling
DB2
JVM Code
JVM COBOL support
Adding Projects to a COBOL JVM Project's Java Build Path
Editing Remote JRE Settings
OpenESQL
Using Java and JVM COBOL Together
Problem Determination and Diagnostic Tools
Debugging in Eclipse
Development Remote Connection
Error markers
Language Service
Remote Debugging
Test Coverage
Just-in-time debugging
Eclipse IDE
Background Parsing
Eclipse Help Viewer
Java Support Considerations for the Eclipse IDE
Leaking File Handles
Remote Development using Remote System Explorer
Single COBOL Files Support
WTP Tools
Issues with Application Workflow Manager
UNIX and Linux Installer Issues
Contacting Micro Focus
Further Information and Product Support
Information We Need
Contact information
Getting Started
Native COBOL Tutorials
Tutorial: Creating COBOL Applications in Eclipse
Create a Local COBOL Project
Create a File and Build Your Project
Run your Application
Create a build configuration
Launch a Debug Session
Tutorials: Interface Mapping Toolkit
Set Build and Interface Mapper Preferences
Tutorial: EJB Service Interface
Prerequisites
Demonstration Application
Create a Project
Create a Service Interface
Define Service Interface Operations
Configure ESDEMO
Deploy a Service Interface
Generate and Deploy a JSP Client
Deploy the Resource Adapter to JBoss
Run the JSP Client
Tutorial: REST Service Interface
Prerequisite
Demonstration Application
Create a Project
Create a Service Interface
Define Service Interface Operations
Configure ESDEMO
Deploy a Service Interface
Generate and Build a COBOL Client
Run the Service and the Client
Managed COBOL Tutorials
Tutorial: Creating COBOL JVM Applications in Eclipse
Create a COBOL JVM Project
Create a Class and Build Your Project
Run your JVM Application
Launch a debug session
Tutorial: Deploying JVM COBOL to an Application Server
Run-time Considerations
Restrictions
Install and Configure an Application Server
Configuring JBoss
Configuring WebLogic
Configuring WebSphere
Tutorial: Deploying an Enterprise JavaBean Containing JVM COBOL to a JBoss Application Server
Tutorial Prerequisites
Copying the Tutorial Files
Creating the Workspace
Importing the Project Files
Stepping through the Projects
The COBOL Project - TemperatureConverter
The EJB Project - TemperatureConverterEJB
The Dynamic Web Project - TemperatureConverterPrj
Deploying the JVM COBOL Run-time System within the Application
Deploying the Application
Showing the Server Status
Running the Application
Debugging the Application
Web Services Tutorials
Tutorial: Reusing Existing COBOL Programs in a Java Web Services Environment
Introduction
Tutorial Project Goals
Setting Up the Tutorial Environment
Installing Apache Tomcat
Installing JBoss Application Server
Installing the IBM WebSphere Plug-in
Installing the Oracle WebLogic Plug-in
Copying the Tutorial Files
Creating the COBOL Components
Creating the JVM COBOL Project
Creating the Copybook File
Creating the COBOL Program
Setting the COBOL Compiler Directives
Adding the Data File
Creating the Java Components
Understanding Run Units and Sessions
Creating the Dynamic Web Project
Creating a JSP View
Creating the Java Bean
Converting Status Codes to Exceptions
Creating a Session Management Class
Creating the Servlet
The Servlet Deployment Descriptor
Running and debugging
Summary
Procedural COBOL Compared with Managed COBOL
Sample Programs
Demonstrations of COBOL
Using the Command Line Demonstrations
Command Line Demonstrations of COBOL for JVM
Command Line Demonstrations of Native COBOL
Command Line Demonstrations of COBOL used with SQL
Command Line Demonstrations of COBOL used with Business Information Server (BIS)
Cheat Sheets
Upgrading to Visual COBOL for Eclipse
Licensing Changes
Resolving conflicts between reserved keywords and data item names
Importing Existing COBOL Code into Visual COBOL
Recompile all source code
Differences between Visual COBOL and Net Express, Server Express
Summary of Differences
Backward Compatibility with Earlier Micro Focus Products
Compiling and Building Differences
Output File Formats
Compiler directives
Linking
Called Programs and Dependencies
File Handler
Makefile Conversion
SQL Compiler Directive Options
XML PARSE Statement
Run-time System Differences
OpenESQL
Single-Threaded Run-Time System
Static-Linked Run-Time System
Setting the environment on UNIX
Visual COBOL Co-existing with Earlier Micro Focus Products
Restrictions and Unsupported Features
CBL2XML Utility
Character-Mode Dialog System
DBMS Preprocessors
Dialog System
Form Designer
FSView
GNT Analyzer
Host Compatibility Option (HCO)
INTLEVEL Support
NSAPI
Online Help System
OO Class and Method Wizards
OpenESQL
Solo Web Server
SQL Option for DB2
Type Library Assistant
UNIX Publish
Run-Time Technology Differences
COM Interop
File Handling
Java and COBOL
Test Coverage
Editing and Debugging Differences
Data Tools
Debugging Native Object-Oriented COBOL
Mixed Language Debugging
Program Breakpoints
Remote Debugging
Source Pool View
Tips: Eclipse IDE Equivalents to IDE Features in Net Express
Upgrading from ACUCOBOL-GT
Upgrading from RM/COBOL®
Native COBOL compared with managed COBOL
Help on Help
Developing Applications in the IDE
Using Eclipse for COBOL Development
Overview of Creating COBOL applications in Eclipse
COBOL Perspectives and Projects
The COBOL Editor
Customizing the Editor
Configuring Background Parsing
Configuring Smart Edit Mode
Editing Assistance in the COBOL Editor
Configuring Content Assist for COBOL Programming
Inserting and Removing Line Numbers (Renumber and Unnumber)
To specify line numbering options
To number or renumber lines in source code
To remove line numbers from source code
Using COBOL Code Templates
Searching for Files using COBOL File Search
Using the copybook project type to manage large projects
Viewing copybooks in the required context, and seeing their usage
Creating COBOL Projects
Creating and importing COBOL projects
To create a COBOL project
To import an existing Eclipse project
Creating service interface projects
Creating and importing resources
To create a new file
To create a new file from a custom template
To import a file into a project
To import a copybooks into a virtual folder
To associate a file extension with COBOL
Using source files from outside your project
To create project dependencies
To remove project dependencies
To link to copybooks or sources outside the project
To create a project or a file from a custom template
Using custom project and file templates
To create a custom project template
To create a custom file template
To configure the IDE to use custom templates
Indicating Whether a File is a Copybook or a COBOL Program
Project and file properties and configurations
Project Properties
Build Paths
Build Settings
COBOL Builder
Compile Single File
File Extensions
Run-Time Configuration Properties
File Properties
To set file properties using directive scanning
Developing applications on remote machines
Creating connections to remote hosts
To create a connection to a remote host
To diagnose client-side problems when connecting to a remote host
Client-side connection tests
To diagnose server-side problems when connecting to a remote host
Server-side connection tests
To launch a server on the remote host
To launch a server on the remote host using a daemon process
To launch a server on the remote host without a daemon process
To launch a server on the remote host using a Secure Shell daemon process
Working with file systems on remote machines
Using Remote System Explorer (RSE)
Remote System Explorer logging
Using NFS
To verify that NFS is running
To set up an NFS server
To set up an NFS client
Using Samba
Creating remote projects
To create a COBOL remote project
To create a remote COBOL copybook project
To change the connection type of a remote project
To convert a COBOL local project to a COBOL remote project
Building COBOL applications
Compiling COBOL Applications
Compiling COBOL code
Compiled File Types
Compiling JVM COBOL
To build a project using Apache Ant
Setting Compiler Directives for COBOL
Setting Project-Wide Build Properties and Compiler Directives
Setting Compiler Directives on Individual Files
Setting Compiler Directives from the Command Line
Setting Compiler Directives in Source Code
Setting Compiler Directives in a Directives File
Order in which copybooks are searched for
Temporary Files Used when Compiling Native COBOL
Techniques for Compiling Quickly
Using Preprocessors
SQL Preprocessors
Additional Preprocessors
Specifying an additional preprocessor
Editing an additional preprocessor
Specifying the order of execution for multiple preprocessors
Removing an additional preprocessor
Linking
Introduction to Linking
Linking and Linked File Types
Linking and Binding
Dynamic Loading
Specifying non-default link options in the IDE
To clean a project
Tips: Building COBOL projects
To set Compiler directives on a COBOL file
Code Analysis
Micro Focus Code Analysis Window
COBOL Source Information
Introduction
To run a CSI query
CSI Query Results
Query Information
Data Items
Complex Data Item Queries
Qualified Names
Example Data Item Queries
Procedures Paragraphs and Sections
Called Subprograms
Finding COBOL Verbs
Examples of COBOL Verb Queries
Special Queries
CALL - Special Queries
COPY - Special Queries
DEADDATA - Special Queries
LABEL - Special Queries
TIMES - Special Queries
UNDECL - Special Queries
UNEXEC - Special Queries
UNREF - Special Queries
Wildcards
Debugging COBOL applications
Preparing a Project for Debugging
Compile for Debugging
Creating a Debug Configuration
COBOL Application, COBOL Attach to Process, and COBOL Wait for Application Attachment
COBOL Core Dump
COBOL JVM Application and COBOL JVM Remote Application
Projects developed on a remote UNIX machine
Debugging a COBOL Application
Views in the Debug Perspective
Debugging Features in Eclipse
Using Breakpoints and Watchpoints
Debugging COBOL Projects Using a Remote Machine
Debugging in COBOL Copy View
Starting the Debugger automatically using library routines
Starting the debugger automatically using just-in-time debugging
Debugging Windows Services
Debugging Using a Core Dump
To create a core dump
To debug a core dump
Debugging Mixed Language Applications
Debugging Applications and Services on Enterprise Server
How Debugging on Enterprise Server Works
To prepare for debugging on Enterprise Server
To debug on Enterprise Server
To debug on a remote Enterprise Server
Debugging using a temporary enterprise server
Error Messages for Web Services
Debugging with Character Animator
Overview of Character Animator Functions
Working With Character Animator
The Character Animator Screen
Character Animator Screen Overview
The Information Line
Moving the Cursor and Text During Animation
Entering Text on Menus
Using the Character Animator Windows
Viewing Data
Key Functions for Updating Queried Data Items
Obtaining Help
Menus
Animator Main Menu
Breakpoints Menu
Environment Menu
Go Menu
Locate-declaration Menu
Perform-level Menu
Query Menu
Query Data-name Menu
Reset-execution Menu
Text Menu
Functions
Function Access
Function Descriptions
0-9
Align
Alter Path
Breakpoints
Cancel All Breakpoints
Cancel Program Break
Child Data
Clear
Cursor-name Locate
Cursor-name Query
Cursor-position Reset
Detach from application
Do
Do At Breakpoint
Down-table
Enter
Enter-name Locate
Enter-name Query
Environment
Escape
Examine Breakpoints
Exchange
Exit Perform
Find String
Go
Hex
Hex/ASCII
Hide Monitors
If Breakpoint
Join Text
Look-up
Monitor
Monitor-off
Next Reset
On Count Breakpoint
Organize Monitors
Parent Data
Perform-level
Perform-view
Query
Query Data-name
Quit-perform
Refresh
Reset-execution
Same Level
Scroll Up/Down (continuously)
Scroll Up/Down (one line)(Ctrl+<left-arrow>/<right-arrow>)
Select Program Break
Set Breakpoint
Split Text
Start
Step
Step Perform
Text
This Program Break
Thread-local Breakpoint
Un-set Breakpoint
Up Table
View
View Programs
View Threads
Where
Word Left
Word Right
Zoom
Zoom Breakpoint
Run-time System Error Messages
Directives for Character Animator
Directive Descriptions
COBAIF
END
MIXEDLANGDEBUG
MULTITHREAD
RESEQ
ZEROSEQ
Using COBANIMOPT
Cross-session Debugging
Using cobesdebug to Debug Services and Applications on Enterprise Server
How it works
How Enterprise Server finds a match
How to debug services and applications with Enterprise Server Dynamic Debugging
Running COBOL Applications
Configuring the Run-Time Behavior
To run a COBOL application on your local machine
To run an application on a remote machine
Code Coverage (Native COBOL)
Enabling Code Coverage
Running an Application with Code Coverage
Code Coverage Reports
Configuring the Code Coverage Reports
Programming
COBOL Programming
Embedded HTML
Enabling CGI support
EXEC HTML statement
Substitution Markers
EHTML Preprocessor
EHTML Preprocessor Directives
AUTOFORMAT (AF)
CONFIRM
DEBUG (D)
DEBUGFILE
OUT
PREPROCESS (P)
STEPEXEC
STEPHTML
TRACE
WARN
Deploying a CGI Application with Embedded HTML
Debugging a CGI Application
Internationalization Support
National Locale Support
Compiling Programs with NLS
Setting Up the National Locale Environment
Using the LANG Environment Variable
Running Your NLS Program
NLS Initialization
NLS Operations
String Comparisons
Class Condition Tests
SORT and MERGE Key Comparisons
Case Conversion
Collating Sequence Operations
Editing and De-editing Moves
Intrinsic Functions Numval and Numval-c
Using NLS Library Routines in Your Programs
Mixing Programs With and Without NLS
Message Files
Format of a Message File
Example Error Message File
Unicode Support
UTF-16 Byte Ordering
National Literals
National Hexadecimal Literals
National Data Items
Mixed Language Programming
Ordering Parameters to Pass to Non-COBOL Programs
Removing Parameters from the Stack
Storage Representation of Parameters
Aligning Parameters on Word and Double Word Boundaries
Handling Return Codes in Mixed Language Applications
Call Conventions for Interfacing with Mixed Languages
Building a Mixed Language Application
Interfacing with Assembler Subprograms
Interfacing with C Programs
Passing Data between C and COBOL
Error Messages when Calling Non-COBOL Programs
Signal Handling
Signal Handling Overview
Posting Signal Handlers
Writing Signal Handlers
More than One Handler for the Same Signal
Converting Signal Handlers Written for the signal() Function
Third Party Software that Uses Signals
Examples of Mixed Language Programming
Example of Calling C functions from COBOL
Example of Calling an Assembler Subprogram
Example of Posting a Signal Handler
Interface Mapping using the IMTK
Interface Mapping Toolkit (IMTK)
Configuring an Enterprise Server for a COBOL Program service
Managing service interface projects
Defining Service Interfaces
Layout of the Interface Mapper
Operations
Creating COBOL Program-based Operations
Defining Operation Details
Interface Fields
Mappings
COBOL Assignments
Reusable Fields
Deploying Service Interfaces to Enterprise Server
Service Interface Deployment Package
Service Interface Deployment Process
Deploying Java Service Interfaces
Clients
Generating Clients
EJB and Client Generation
EJB Jar File
Client War File
Application Ear File
Editing Clients
Running Clients
How to...
Manage IMTK Projects
To add or remove application files to deploy
To create a service interface
To modify the classpath property for Java-based service interfaces
To set Interface Mapper preferences
To validate a service interface
Define Service Interfaces
To start the Interface Mapper
To create a COBOL program-based operation
To create an interface field
To create a reusable field
To map an interface field
To edit field properties
To assign a value to a COBOL field
To group interface or reusable fields
Deploy Service Interfaces to Enterprise Server
To add or remove application files to deploy
To associate an enterprise server with a project
To generate and deploy a service interface from the IDE
To deploy to a remote enterprise server
To generate and deploy a service interface using imtkmake
To generate clients
To install a deployment package using the mfdepinst command
To redeploy a service interface
To set deployment properties
Reference
imtkmake command
mfdepinst command
COBOL to Service Interface Data Type Matches
User Interface Reference
Service Interface Projects
Mapping Properties - General Tab
Mapping Properties - Deployment Server Tab
Mapping Properties - Application Files Tab
Mapping Properties - EJB Generation Tab
Mapping Properties - J2SE Generation Tab
Mapping Properties - Mapping Properties Tab
COBOL Mapping Wizard
Username/Password
Interface Mapper
COBOL Assignment
Field Properties
Group Properties
Mappings
Subscripts
Operation Properties - General tab
Operation Properties - HTTP tab
Operation Properties - User Exits tab
Using COBOL and XML together
XML Extensions
Installation and introduction
Before you start
System requirements
XML Extensions components
Development components
Deployment components
Installing XML Extensions
Installing on Windows or UNIX
Introducing XML Extensions
What is XML?
COBOL as XML
XML as COBOL
Getting started with XML Extensions
Overview
Typical development process example
Design the COBOL data structure and program logic
Compile the program
Execute the program
Making a program skeleton
Making a program that exports an XML document
Populating the XML document with data values
Deploy the application
How XML Extensions locates files
XML Extensions statements reference
Memory management with XML Extensions
Searching for files
Document processing statements
XML EXPORT FILE
XML EXPORT TEXT
XML IMPORT FILE
XML IMPORT TEXT
XML TEST WELLFORMED FILE
XML TEST WELLFORMED TEXT
XML TRANSFORM FILE
XML TRANSFORM TEXT
XML VALIDATE FILE
XML VALIDATE TEXT
Document management statements
XML COBOL FILE-NAME
XML FREE TEXT
XML GET TEXT
XML PUT TEXT
XML REMOVE FILE
XML RESOLVE DOCUMENT NAME
XML RESOLVE SCHEMA-FILE
XML RESOLVE STYLESHEET-FILE
XML RESOLVE MODEL-NAME
Directory management statements
XML FIND FILE
XML GET UNIQUEID
State management statements
XML INITIALIZE
XML TERMINATE
XML DISABLE ALL-OCCURRENCES
XML ENABLE ALL-OCCURRENCES
XML DISABLE ATTRIBUTES
XML ENABLE ATTRIBUTES
XML DISABLE CACHE
XML ENABLE CACHE
XML FLUSH CACHE
XML GET FLAGS
XML TRACE
XML GET STATUS-TEXT
XML SET ENCODING
XML SET FLAGS
XML SET XSL-PARAMETERS
XML SET XSL-PARAMETERS-NEW
XML CLEAR XSL-PARAMETERS
COBOL considerations
File management
File naming conventions
External XSLT Stylesheet File Naming External XSLT stylesheet file naming conventions
Other input file naming conventions
Other output file naming conventions
Data conventions
Data representation
COBOL and character encoding
MF_XMLEXT_LOCAL_ENCODING environment variable
Windows character encoding
UNIX character encoding
FILLER data items
Missing intermediate parent names
Unique element names
Unique identifier
Sparse COBOL records
Copybooks
Statement definitions
REPLACE statement considerations
Displaying status information
Application termination
Anonymous COBOL data structures
Limitations
Data items (data structures)
Edited data items
Wide and narrow characters
Data item size
Data naming
OCCURS restrictions
Reading, writing, and the Internet
Optimizations
OCCURS DEPENDING
Empty occurrences
Cached XML documents
Managed code considerations
Compilation options
New XML statement
XML statement restrictions
XML considerations
XML and character encoding
Document type definition support
XSLT stylesheet files
Handling space and whitespace in XML
Schema files
Appendix A XML Extensions examples
Example 1 Import file and export file
Development for example 1
Batch file for example 1
Program description for example 1
Data item for example 1
Other definitions for example 1
Program structure for example 1
Execution results for example 1
Example 2 Export file and import file with XSLT stylesheets
Development for example 2
Batch file for example 2
Program description for example 2
Data item for example 2
Other definitions for example 2
Program structure for example 2
Execution results for example 2
Example 3 Export file and import file with OCCURS DEPENDING
Development for example 3
Batch file for example 3
Program description for example 3
Data item for example 3
Other definitions for example 3
Program structure for example 3
Execution results for example 3
Example 4 Export file and import file with sparse arrays
Development for example 4
Batch file for example 4
Program description for example 4
Data item for example 4
Other definitions for example 4
Program structure for example 4
Execution results for example 4
Table1.xml
Table2.xml
Table3.xml
Table4.xml
Table5.xml
Table6.xml
Example 5 Export and import text
Development for example 5
Batch file for example 5
Program description for example 5
Data item for example 5
Other definitions for example 5
Program structure for example 5
Execution results for example 5
Example 6 Export file and import file with directory polling
Development for example 6
Batch file for example 6
Program description for example 6
Data item for example 6
Other definitions for example 6
Program structure for example 6
Execution results for example 6
Example 7 Export file, test well-formed file, and validate file
Development for example 7
Batch file for example 7
Program description for example 7
Data item for example 7
Other definitions for example 7
Program structure for example 7
Execution results for example 7
Example 8 Export text, test well-formed text, and validate text
Development for example 8
Batch file for example 8
Program description for example 8
Data item for example 8
Other definitions for example 8
Program structure for example 8
Execution results for example 8
Example 9 Export file, transform file, and import file
Development for example 9
Batch file for example 9
Program description for example 9
Data item for example 9
Other definitions for example 9
Program structure for example 9
Execution results for example 9
Example 10 Diagnostic messages
Development for example 10
Batch file for example 10
Program description for example 10
Data item for example 10
Other definitions for example 10
Program structure for example 10
Execution results for example 10
Example 11 Import file with missing intermediate parent names
Development for example 11
Batch file for example 11
Program description for example 11
Data item for example 11
Other definitions for example 11
Program structure for example 11
Execution results for example 11
Example batch files
Cleanup.bat
Example.bat
Examples.bat
Appendix B: XML Extensions sample application programs
Appendix C: XML Extensions error messages
Summary of error messages
XML Syntax Extensions
XML Implementation
Syntax for Handling XML in COBOL
SELECT Paragraph
XML Description Paragraph (XD)
IDENTIFIED BY and IS ATTRIBUTE Clauses
PROCESSING-INSTRUCTION Clause
COUNT IN Clause
NAMESPACE Clause
COBOL Verbs
Compiling XML-enabled COBOL
Building XML-enabled COBOL from Visual COBOL
Compiling XML-enabled COBOL from the Command Line
Generating COBOL Structures with XML Syntax from the Command Line
CBL2XML Utility
Generating a Copybook and Schema
Generating XML-enhanced COBOL from an XML Schema
Mapping COBOL Data to XML Elements
Accessing an XML-enabled Record
Validate an XML Document
XML PARSE
Special Registers
User Routine
Glossary of terms
Creating 64-bit Native COBOL Programs
Overview of Creating 64-bit Native COBOL Programs
Creating 64-bit Programs from 32-bit Programs
Compiling Programs for 64-Bit
Pointers and Compiling Programs for 64-Bit
Single Sourcing and Compiling Programs for 64-Bit
Library Routine Prototypes and Compiling Programs for 64-Bit
File and FCD Handling and 64-bit Programs
Single Sourcing and Dual FCD Support in 64-Bit Programs
The cobmode Utility
Setting the Effective Working Mode
Displaying the Effective Working Mode
Scan64
Introduction to Scan64
Preparing to Use Scan64
Starting Scan64
Examples of Using Scan64
Modification of Pointers by Implicit Redefinition
Possible Pointer Modification Via CALL Statements and Prototypes
Explicit and Implicit Definitions of Pointers in Call Prototypes
Constant and Variable Indexing
Constant and Variable Reference Modification
Scan64 Error Messages
SCAN64: Old int code with D4 operations not supported
SCAN64: Old int code with D7 operations not supported
SCAN64: Cobol COMMS not checked
SCAN64: File records are not checked
SCAN64: Adis accept/display not checked
Calling COBOL Programs
Specifying the Program to Be Called
Naming a Program in its PROGRAM-ID Paragraph
Entry Point Mapping for COBOL Programs
Calling a Program Using an Implicit Program Name
Calling a Program Using an Explicit Program Name
Calling Entry Points in Subprograms
Calling Programs According to How They Are Linked
State of the Data when a Program is Called Again
Search Conventions Used for Calling Programs
Passing Parameters to a Called Program
Passing Return Codes Back to the Calling Program
Call Prototypes
About Call Prototypes
The ANY Keyword
Relaxed Type-checking
Using Type Definitions
Using the Library Routine Type Definitions and Call Prototypes
UNIX Program Development Guide
Generating a Client from a WSDL or JSON File
Compatibility
Compatibility with ACUCOBOL-GT
Converting ACUCOBOL-GT Applications
Enabling ACUCOBOL-GT Compatibility
Compiler Directives for ACUCOBOL-GT Compatibility
Compiler Option Support
Setting Compiler Options
Supported ACUCOBOL-GT Compiler Options
Standard Options
Native Object Code Options
Listing Options
Internal Table Options
Compatibility Options
Source Options
Reserved Word Options
Data Storage Options
Truncation Options
Video Options
Warning and Error Options
Debugging Options
Miscellaneous Options
32- and 64-Bit Code Generation
ACUCOBOL-GT Conversion Issues
Complementary ACUCOBOL-GT Technologies
Configuration Files and Configuration Variables
Multi-threading Implementation
Screen Descriptions
Truncation Options in Managed Code
Unsupported Library Routines
Using Pipes to Assign Filenames When Using the Vision File Handler
ACUCOBOL-GT File Handling
Configuring Access to Vision Files
File Limits
Vision Related Utilities
Converting Vision Files
Configuring Access to Data Files Through AcuServer
ACUCOBOL-GT Library Routines
C$CALLEDBY
C$CALLERR
C$CHDIR
C$COPY
C$DELETE
C$FILEINFO
C$GetLastFileOp
C$JUSTIFY
C$LIST-DIRECTORY
C$LOCKPID
C$MAKEDIR
C$MEMCPY (Dynamic Memory Routine)
C$MYFILE
C$NARG
C$PARAMSIZE
C$RERR
C$RERRNAME
C$RUN
C$SLEEP
C$TOUPPER and C$TOLOWER
I$IO
M$ALLOC (Dynamic Memory Routine)
M$COPY (Dynamic Memory Routine)
M$FILL (Dynamic Memory Routine)
M$FREE (Dynamic Memory Routine)
M$GET (Dynamic Memory Routine)
M$PUT (Dynamic Memory Routine)
RENAME
WIN$VERSION
ACUCOBOL-GT Windowing Syntax
Windowing Syntax Summary
Enabling Windowing Support
Windowing Support Syntax
The ACCEPT Statement
The CLOSE WINDOW Statement
The DISPLAY Statement
Windowing Restrictions
Windowing Error Messages
Windowing Supplementary Information
Compatibility with DG Interactive COBOL
Introduction
Compatibility Directives
DG
Compatibility with DG Interactive COBOL
Overview
DG Interactive COBOL Source Programs
Enhancing your Converted Application
Compatibility with DG Interactive COBOL Source
The DG Directive
Reserved Words
DG International Character Set
DG File Status and other Exception Values
Calls
Linkage Section Access
Arithmetic of Group Level Items
Run-time Switches
Program Identification and Data-names
Reformatting a DG COBOL Source File
Reformatting Rules
Compatibility with RM/COBOL
Converting RM/COBOL Applications
Configuring Your Application for Eclipse
Create a native Visual COBOL project
Set the DIALECT RM Compiler Directive for the Project
Import your RM/COBOL Source Code
Customizing the Reserved Words List
Add Adis Support to the Project
Add the RM/COBOL Keyboard Configuration
Build and Run the Project
Appendices
Appendix A - RM/COBOL Source File
Appendix B - ADISCTRL Settings for RM2VCOB
Appendix C - Adis Key Mappings for RM2VCOB
Appendix D - Adis Key Function Mapping for RM2VCOB
Compiler Directives for RM/COBOL Compatibility
Compiling RM/COBOL Programs Without DIALECT"RM"
RM/COBOL Data Types
RM/COBOL Conversion Issues
Producing Executable Code
Perform Statements
ACCEPT FROM CENTURY-DATE and FROM CENTURY-DAY
CURSOR phrase not available in ACCEPT statement
Nested COPY statements with REPLACING phrase
Duplicate Paragraph-names
Figurative Constants and the USING Phrase
File Not Found Errors
Indexed File Error on Open
LIKE Relational-operator Not Available
Linkage Section in Main Program
Nested OCCURS DEPENDING Clauses
Numbering of Segments
Program Identification and Data Names
REMARKS Paragraph
Reserved Words
SAME AS Clause Not Available When Defining Data Structures
Source Code in Columns 73 to 80
START WHILE LIKE Not Available
Undeclared Data Items in Clauses
User-names Longer than 127 Bytes are Truncated
Using Relative Path Names
Running the Code
Table Bound Checking
ACCEPT Fields at the Edge of the Screen
C$CARG Not Supported
Display of Input Data in Concealed ACCEPT Fields
Embedded Control Sequences in DISPLAY Statements
End of File Notification
Field Wrap-Around
File and Record Locking
Initialization of Working Storage
Numeric Fields Containing Illegal Characters When Using a DEPENDING ON Phrase of an OCCURS Clause
ON SIZE ERROR Phrase
Open EXTEND of Nonexistent File
Printer Output is Written to Disk
Screen Column Number Specification
Trailing Blanks in Line Sequential Files
Undefined Results of MOVE and Arithmetic Operations
Using the Correct Calling Convention
RM/COBOL Library Routines
C$Century
C$ConvertAnsiToOem
C$ConvertOemToAnsi
C$DARG
C$Delay
C$GetEnv
C$GetLastFileName
C$GetLastFileOp
C$GetNativeCharset
C$LogicalAnd
C$LogicalComplement
C$LogicalOr
C$LogicalXor
C$LogicalShiftLeft
C$LogicalShiftRight
C$NARG
C$OSLockInfo
C$SecureHash
C$SetEnv
C$RERR
DELETE
RENAME
SYSTEM
RM/COBOL File Handling
Configuring Access to RM/COBOL Indexed Data Files
File Limits
RM/COBOL File Status Codes
Debugging JVM COBOL Using RM/COBOL Indexed Files
Enabling CTF to Trace RM/COBOL Data Files
Data File Utilities
Indexed File Recovery (recover1) utility
Recovery command
Recovery command options
Recovery process description
The four phases of processing
Recovery support module version errors
Recovery example
Recovery program error messages
Compatibility with XML Extensions
Additional Parameter Required with XML Extensions Processing Statements
COBOL programs using BIS
Conflicts Between Model File-names and XML Data Files
Creating an XML Model File
Displaying the Status of XML Extensions Statements
Importing and Exporting Ambiguous Data-names
Invalid Characters in Condition Names
Restricted data items with XML Extensions
Unable to Use Data Items Declared in Nested Programs
User-names Longer than 127 Bytes are Truncated
Using the Correct Calling Convention
OO COBOL Class Library Reference
Data Access
Database Access
Accessing Databases from COBOL
Database Access Features
Database Access Preprocessors
Developing SQL Applications
Embedded SQL
Host Variables
Simple Host Variables
Host Arrays
Indicator Variables
Indicator Arrays
COBOL to SQL Data Type Mapping
SQL TYPEs
Cursors
Declaring a Cursor
Opening a Cursor
Using a Cursor to Retrieve Data
Closing a Cursor
Positioned UPDATE and DELETE Statements
Using Cursors
Data Structures
SQL Communications Area (SQLCA)
Using the SQLCA
The SQLCODE Variable
The SQLSTATE Variable
The Warning Flags
The WHENEVER Statement
SQLERRM
SQLERRD
COBSQL
DB2 LUW
The SQL Descriptor Area (SQLDA)
COBSQL
Oracle
Sybase
Informix
OpenESQL
Using the SQLDA
The PREPARE and DESCRIBE Statements
The FETCH Statement
The OPEN or EXECUTE Statements
The DESCRIBE Statement
Dynamic SQL
Dynamic SQL Statement Types
Execute a Statement Once
Execute a Statement More Than Once
Select a Given List of Data
Select any Amount of Data
Preparing Dynamic SQL Statements
Place Holders
Physical Location of PREPARE Statement
Executing Dynamic SQL Statements
EXECUTE IMMEDIATE Statement
FREE Statement (COBSQL Informix)
Dynamic SQL Statements and Cursors
CALL Statements
Example
Compiling SQL Applications
Specifying an SQL Preprocessor and Compiler Directive Options
Compiling Multiple Program Modules
Creating Debug Files
OpenESQL
OpenESQL Preprocessor Options
Setting the OpenESQL Preprocessor and Compiler Directive Options
Scope - OpenESQL SQL Compiler Directive Options
OpenESQL DBMAN Use Case Scenarios
OpenESQL Datetime Data Type Handling
OpenESQL Embedded SQL Cursor Behavior and Performance
Embedded SQL Cursors in Older Applications
OpenESQL Configuration Utility for Default SQL Cursor Behavior
Optimize for performance and mainframe compatibility
ANSI compliance
No change in default behavior and no optimization
Issue a warning at compile time
Issue an error at compile time
Database Connections
Programming for OpenESQL
Working With OpenESQL Cursors and Result Sets
Working With OpenESQL Stored Procedures and Result Sets
Unicode Support in OpenESQL
OpenESQL Globalization Best Practices
Keywords
ODBC
Demonstration Applications
ODBC Drivers and Data Source Names
Using OpenESQL with ODBC
Managing Transactions
Positioned Update
XML Support
JDBC
JDBC Process
JDBC Resources
JNDI DataSource Objects
Database Connections
Connect Using a JNDI DataSource Object
Connect Using a JDBC Connection String
Sharing Database Connections Between Java and COBOL
Using OpenESQL with JDBC
Compiling JDBC Applications from the Command Line
Configuring the JDBC Run-time Environment
JVM Host Variables in Managed Code
DB2
DB2 External Compiler Module
Demonstration Applications
Compound SQL
Extensions to Embedded SQL Support
The INCLUDE Statement
The DECLARE Statement
Qualified Host Variables
Host Variable Groups and Indicator Arrays
The NOT Operator (¬)
The Concat Operator (|)
SQL Communications Area
Support for Object Oriented COBOL Syntax
Support for Nested COBOL programs
Compiling
Setting the DB2 ECM Preprocessor and Compiler Directive Options
DB2 Compiler Directive
Error Codes
Building Applications
Stand-alone DB2 Applications
Client DB2 Applications and Stored Procedures
Building DB2 Applications with Eclipse
Binding
COBOL DB2 Stored Procedures
Working with Stored Procedures
Writing and Preparing Stored Procedures
Preparing Stored Procedures
How an Application Works With a Stored Procedure
Writing and Preparing Applications to Use Stored Procedures
Executing the SQL Statement CALL
Parameter Conventions
Using Indicator Variables to Speed Processing
Declaring Data Types for Passed Parameters
Limitations
Defining Stored Procedures under DB2 LUW
Compiling and Linking Stored Procedures under DB2 LUW
Testing Stored Procedures under DB2 LUW
COBSQL
Preparation
Setting the COBSQL Preprocessor and Compiler Directive Options
Building COBSQL Applications with Eclipse
Using the CP Preprocessor to Expand Copybooks
Troubleshooting
Common Problem Areas
Oracle Considerations
Oracle 8 (and later) Directives for COBSQL
Migration and Development
Oracle 8 and Micro Focus COBOL
Sybase Considerations
Informix Considerations
How to...
OpenESQL Configuration Utility
To start the OpenESQL Configuration utility
To set a default for SQL(BEHAVIOR)
JDBC
To create a JVM COBOL project for JDBC
To install and configure Simple-JNDI
To create a JNDI DataSource object
To add JDBC resources to the JVM Build Path
To create a user library for JDBC resources
To import a user library
To export a user library
Reference
OpenESQL
Embedded SQL Statements
BEGIN DECLARE SECTION
BEGIN TRAN
BIND CONNECTION
CALL
CLOSE
COMMIT
CONNECT
DECLARE CURSOR
DECLARE DATABASE
DECLARE STATEMENT
DELETE (Positioned)
DELETE (Searched)
DESCRIBE
DISCONNECT
END DECLARE SECTION
EXECSP
EXECUTE
EXECUTE IMMEDIATE
FETCH
GET CONNECTION
GET HDBC
GET HENV
GET NEXT RESULT SET
INCLUDE
INSERT
INTO
OPEN
PERSIST
PREPARE
QUERY ODBC
QUERY ODBC - Column Query
QUERY ODBC - Data Type Query
QUERY ODBC - Table Query
RESET CONNECTION
ROLLBACK
SAVEPOINT
SELECT DISTINCT (using DECLARE CURSOR)
SELECT INTO
SET AUTOCOMMIT
SET CONCURRENCY
SET CONNECTION
SET OPTION
SET SCROLLOPTION
SET TRACELEVEL
SET TRANSACTION ISOLATION
SYNCPOINT
UNBIND CONNECTION
UPDATE (Positioned)
UPDATE (Searched)
WHENEVER
SQL Compiler Directive Options
ALLOWNULLCHAR
ANSI92ENTRY
ARRAYCHECK
AUTOCOMMIT
AUTOFETCH
BEHAVIOR
Primitive Directives
DEF_CURSOR
IC_FH_ISOLATION
PF_RO_CURSOR
PF_UPD_CURSOR
RO_CURSOR
TRANSACTION
UPD_CONCURRENCY
UPD_CURSOR
CHECK
CHECKDUPCURSOR
CHECKSINGLETON
CONCAT
CONNECTIONPOOL
CTRACE
CURSORCASE
DATE
DATEDELIM
DB
DBMAN
DECDEL
DESCRIBEDTCHAR
DESCRIBEDTREC
DESCRIBEVARCHAR49
DESCRIBEVARCHARPICX
DETECTDATE
ESQLVERSION
FIPSFLAG
GEN-CC2
GEN-CLASS-VAR
GEN-HV-FROM-GROUP
GEN-INIT-FLAG
HSFTRACE
IGNORE-NESTED
IGNORESCHEMAERRORS
INIT
ISOLATION
JIT
JNDI
JNDIENC
MARS
NIST
NOT
ODBCTRACE
ODBCV3
OPTPER
PARAMARRAY
PASS
PRE
PREFETCH
QUALFIX
RESULTARRAY
SAVE-RETURN-CODE
SPDISPLAY
STMTCACHE
TARGETDB
TESTSQLSTATE
THREAD
TIME
TIMEDELIM
TRACELEVEL
TSTAMPSEP
USECURLIB
USER-SQLDA
XAID
JDBC Driver Classes
JDBC URLs
Sample DataSource Object Files
SQL/COBOL Data Type Mappings
OpenESQL Messages
SQLSTATE Values
SQLCODE Values
OpenESQL Preprocessor Error Messages
COBES0002 token is badly defined.
COBES0003 Program contains more than one definition of token
COBES0004 Nested or multi-source programs not allowed.
COBES0005 An error occurred when processing the internal dictionary.
COBES0006 No DB engine could be found.
COBES0007 Source file name is invalid.
COBES0010 OESQL rejected an unspecified option.
COBES0022 The directive SQL(DBMAN=ODBC) is not supported under Personal Edition.
COBES0023 The SQL(DBMAN) directive option is not supported with native applications.
COBES0024 The SQL(DBMAN) directive option is not supported with JDBC applications.
COBES0100 SQL incompatible with MAINFRAME
COBES0101 Statement is too long.
COBES0102 Statement contains too many host variables.
COBES0103 token does not have a suitable definition to be used as a host variable.
COBES0104 Bad SQL data declaration.
COBES0105 Syntax error.
COBES0106 Filename too long.
COBES0107 File token not found.
COBES0108 token is not unique and should be qualified.
COBES0109 token is not a data item.
COBES0110 Statement contains more than one SQLDA.
COBES0111 token is not a table of null indicator variables.
COBES0112 variable should not be defined with an OCCURS clause.
COBES0113 token should not be a subordinate to an item defined with an OCCURS clause.
COBES0114 Statement only allowed in the Procedure Division.
COBES0115 Statement not allowed in the Procedure Division.
COBES0116 An error occurred when processing the trace file.
COBES0118 Mismatched DECLARE.
COBES0119 Host variable name is too long.
COBES0120 Internal error - dictionary handle is too big.
COB ES0121 Compiler directive SQL (token1=token2) is invalid or badly sequenced - all SQL statements ignored.
COBES0123 Invalid ILTARGET - cannot use ILTARGET(ANYCPU) - must specify ILTARGET(X86) or ILTARGET(X64).
COBES0124 Host or Indicator Variable varname should not be defined in EXEC SQL statement using a subscript.
COBES0125 variable should be defined with an OCCURS clause.
COBES0201 BEHAVIOR directive not valid unless TARGETDB directive of DB2, ORACLE, or MSSQLSERVER set first.
COBES0202 BEHAVIOR directive not set.
COBES0203 PREFETCH and BEHAVIOR directives are mutually exclusive - cannot set both.
COBES0205 Cannot set directive PF_RO_CURSOR > 1 if RO_CURSOR directive is set to IC_FH.
COBES0206 Cannot set directive PF_RO_CURSOR > 1 if RO_CURSOR directive is set to FORWARD and TARGETDB is MSSQLSERVER.
COBES0207 Cannot set directive PF_UPD_CURSOR > 1 if UPD_CURSOR directive is set to FORWARD.
COBES0208 Cannot set UPD_CURSOR directive to DYNAMIC if TARGETDB directive is set to ORACLE.
COBES0209 Cannot set UPD_CURSOR directive to STATIC if TARGETDB directive is set to MSSQLSERVER.
COBES0211 DBRMLIB name is too long, max 44 characters.
COBES0212 Simple name in DBRMLIB name is too long, max 8 characters.
COBES0213 Simple name in DBRMLIB name starts with invalid character.
COBES0214 Invalid character in DBRMLIB name.
COBES0215 MEMBER name is too long, max 8 characters.
COBES0216 MEMBER name cannot begin with a numeric digit.
COBES0217 Invalid character in MEMBER name.
COBES0218 MEMBER directive not valid unless DBRMLIB directive set.
COBES0219 VERSION directive not valid unless DBRMLIB directive set.
COBES0220 VERSION is too long, max 64 characters.
COBES0221 Invalid character in VERSION.
COBES0222 Invalid Framework target - SQL applications must be built to target the 4.0 .NET Framework.
COBES0223 TARGETDB directive not set.
COBES0900 An internal error occurred.
COBES0901 This error prevents SQL processing from continuing - further EXEC SQL statements will be ignored.
COBES1000W Use of EXEC SQL INCLUDE SQLCA END-EXEC
COBES1002 Statement is not in area B.
COBES1004 token directive is not supported and has been ignored.
DSNTIAR and DSNTIAC
esqlconfig command
DB2
DB2 Compiler Directive Options
ACCESS
ACTION
ALEBRA
APREUSE
BIND
BINDDIR
BGP
BLOCK
CALL_RESOLUTION
CASE
CCSIDG
CCSIDM
CCSIDS
CHARSUB
COLLECTION
COMMIT
CONCAT
CONCURRENTACCESSRESOLUTION
CONNECT
COPY
CTRACE
DB
DBPROTOCOL
DEC
DECDEL
DEFERRED_PREPARE
DEGREE
DISCONNECT
DYNAMICRULES
ENCODING
EXPLAIN
EXPLSNAP
EXTENDEDINDICATOR
FEDERATED
FEDERATED_ASYNCHRONY
FOR
FORMAT
FUNCPATH
GENERIC
GEN-HV-FROM-GROUP
GEN-INIT-FLAG
GEN-SQLCA
HCO
HOSTVAR
HSFTRACE
IGNORE-NESTED
IMMEDIATE
IMMEDWRITE
INIT
INSERT
ISOLATION
KEEPDYNAMIC
LANGLEVEL
LEVEL
MSGAREA
MULTI-NESTED
NOT
OPTPROFILE
OPTHINT
OPTPER
OS400NAMING
OWNER
PASS
PRE
QUALFIX
QUALIFIER
QUERYOPT
RELEASE
REOPT
REPLVER
RETAIN
SAVE-RETURN-CODE
SORTSEQ
SQLERROR
SQLFLAG
SQLRULES
SQLWARN
STATICREADONLY
STRDEL
SYNCPOINT
SYNTAX
TEMPORAL-HISTORY
TEXT
TRANSFORM-GROUP
UDB-VERSION
VALIDATE
VERSION
XAID
DB2 Environment Variables
HCOBND environment variable
DB2 ECM Error Messages
COBDB0002 - COBDB0013
COBDB0002 token is badly defined.
COBDB0003 Program contains more than one definition of field-name
COBDB0004 Nested or multi-source programs not allowed.
COBDB0005 An error occurred when processing the internal dictionary.
COBDB0006 Required DB software token could not be found.
COBDB0007 Source file name is invalid.
COBDB0008 MF DB2 Connect program missing or invalid.
COBDB0009 MF DB2 Connect program reported error condition token.
COBDB0010 DB2 rejected an unspecified option.
COBDB0011 No database name was specified.
COBDB0012 Functionality only supported in 32-bit mode
COBDB0013 Invalid directive token. IBM supports only precompiled code running as native code.
COBDB0100 - COBDB0115
COBDB0100 SQL error description
COBDB0101 Statement is too long.
COBDB0102 Statement contains too many host variables.
COBDB0103 host-var definition does not match the column type associated with it.
COBDB0104 Bad SQL data declaration.
COBDB0105 Syntax error.
COBDB0106 Filename too long.
COBDB0107 File filename not found.
COBDB0108 host-var is non-unique and should be qualified.
COBDB0109 host-var is not a data item.
COBDB0110 Statement contains more than one SQLDA.
COBDB0111 token is not a table of null indicator variables.
COBDB0112 host-var should not be defined with an OCCURS clause.
COBDB0113 host-var should not be a subordinate to an item defined with an OCCURS clause.
COBDB0114 Statement only allowed in the Procedure Division.
COBDB0115 Statement not allowed in the PROCEDURE DIVISION.
COBDB0116 - COBDB0137
COBDB0116 An error occurred when processing the trace file.
COBDB0117 Invalid format of compound SQL statement.
COBDB0118 Mismatched DECLARE.
COBDB0119 Host variable name is too long.
COBDB0120 Internal error - dictionary handle is too big.
COBDB0121 Package name is too long.
COBDB0122 Nested INCLUDEs not supported
COBDB0127 Parentheses are illegal in the INTO clause.
COBDB0131 SQLCA or SQLCODE not found.
COBDB0137 Indicator variable ind-var is not SMALLINT type.
COBDB0501 - COBDB0503
COBDB0501 Found variable expected END-EXEC in nested include.
COBDB0502 Found variable expected INCLUDE in nested EXEC SQL statement.
COBDB0503 Found variable expected SQL in nested EXEC statement.
COBDB0900 - COBDB1004
COBDB0900 An internal error occurred.
COBDB0901 SQL processing cannot continue.
COBDB1000 Use of EXEC SQL INCLUDE SQLCA END-EXEC.
COBDB1001 MF DB2 Connect program produced the warning token.
COBDB1002 Statement is not in area B.
COBDB1004 INVALID SQL STATEMENT - statement ignored.
COBSQL
PREPROCESS(cobsql)
COBOL Directives
COBSQL Compiler Directive Options
COBSQLTYPE, CSQLT
CSTART, CST
CSTOP, CSP
DEBUGFILE, DEB
DISPLAY, DIS
END-COBSQL, END-C, END
HSFTRACE
KEEPCBL
KEEPCOMP
MAKESYN
SQLDEBUG
STOPCHK
TRACE
VERBOSE
XAID
COBSQL Messages
CSQL-I-001 to CSQL-E-023
CSQL-I-001: COBSQL has finished returning to the Checker
CSQL-I-003: COBSQLTYPE is incorrect defaulting to Oracle
CSQL-I-004: Accepted COBSQL-directive
CSQL-I-005: Passing precompiler-directive
CSQL-I-006: Rejected COBSQL-directive
CSQL-F-007: COBSQL/Checker incompatible -- Terminating
CSQL-I-008: Invoking integrated-preprocessor Preprocessor
CSQL-F-009: Irrecoverable error in integrated-preprocessor -- Terminating
CSQL-F-010: Irrecoverable error writing STK record
CSQL-F-011: Environment unsupported by COBSQL/Informix
CSQL-F-012: INFORMIXDIR must be set for Informix Support
CSQL-F-013: Unable to access: filename
CSQL-F-015: DOS Exec error Return Code is return-code
CSQL-F-016: UNIX Exec error Return Code is Return-Code
CSQL-I-017: Creating filename
CSQL-I-018: Invoking precompiler Precompiler/Translator
CSQL-F-019: Irrecoverable error Opening STK file
CSQL-I-020: Processing output of precompiler Precompiler
CSQL-F-021: Precompiler did not complete -- Terminating
CSQL-F-022: Irrecoverable error Reopening ORG file
CSQL-E-023: File Status file-status
CSQL-E-024 to CSQL-F-050
CSQL-E-024: Encountered an I/O on file filename
CSQL-F-025: Unable to Create virtual-heap
CSQL-F-026: Premature end of expanded source.
CSQL-I-027: Detected Working Section, now processing it
CSQL-I-028: Now processing through Procedure Division
CSQL-I-029: Found an EXEC SQL Statement, processing it
CSQL-E-036: Unable to open the precompiler file: filename
CSQL-F-037: Wrong Version of COBOL used, please upgrade
CSQL-I-038: The following directive is now Obsolete: COBSQL-directive
CSQL-I-039: The ORG & the CBL files were out of synch
CSQL-W-040: Pro*COBOL commented out the following line: source-line
CSQL-F-041: Cannot read the COBOL runtime switches
CSQL-F-042: Cannot set the COBOL runtime switches
CSQL-F-046: Command line is too large. Maximum length is 1140 characters
CSQL-F-047: Cobsql cannot be used with the SOURCEFORMAT directive.
CSQL-F-048: Cobsql is not supported for use with managed code.
SQL Data Types
Integer Data Types
Tiny Integer
Small Integer
Integer
Big Integer
Character Data Types
Fixed-length Character Strings
Variable-length Character Strings
Large Character Strings (CLOB)
Unicode Character Strings
Unicode Variable-length Character Strings
Unicode Large Character Strings (DBCLOB)
DBCS Character Strings
DBCS Variable-length Character Strings
DBCS Large Character Strings
XML
Numeric Data Types
Approximate Numeric Data Types
Exact Numeric Data Types
Binary Data Types
Fixed-length Binary Strings
Variable-length Binary Strings
Large Binary Strings (BLOB)
Date and Time Data Types
DATE
TIME
TIMESTAMP
TIMESTAMPOFFSET
Locator Data Types
BLOB-LOCATOR Data Type
CLOB-LOCATOR Data Type
DBCLOB-LOCATOR Data Type
File Data Types
BLOB-FILE Data Type
CLOB-FILE Data File
DBCLOB-FILE Data Type
Miscellaneous Data Types
PIC X VARYING
ROWID Data Type
SQL TYPEs
BINARY
BLOB
BLOB-FILE
BLOB-LOCATOR
CHAR
CHAR-VARYING
CLOB
CLOB-FILE
CLOB-LOCATOR
DATE
DATE-RECORD
DBCLOB
DBCLOB-FILE
DBCLOB-LOCATOR
LONG-VARBINARY
LONG-VARCHAR
ROWID
TIME
TIME-RECORD
TIMESTAMP
TIMESTAMP-RECORD
TIMESTAMP-OFFSET
TIMESTAMP-OFFSET-RECORD
VARBINARY
XML
Data Structures
The SQLCA Data Structure
The SQLDA Data Structure
Keywords
Data Files
Data File Tools (Technology Preview)
Restrictions
Accessing Data File Tools (Technology Preview)
Launching Data File Tools (Technology Preview) from a Shell Prompt
Using the Data File Editor
Creating Data Files
Create a Non-indexed Data File
Create an Indexed Data File
Editing Data Files
Editing Data Sets in Enterprise Server
Opening a Data Set in Enterprise Server
Insert a Record
Edit an Unformatted Record
Edit a Formatted Record
Edit a Record Using Hexadecimal Values
Delete a record
Viewing, Filtering, and Searching Data Files
View File Information
Searching a Data File
Search the Data File
Search Operators
Navigate a Data File
Show the Contents of a Data File in Hexadecimal
Select the Encoding for a Data File
Order a Data File using Indexed Keys
Backing Up Data Files
Back up a data file
Using the Structure File Editor
Creating Structure Files and Layouts
Create a Structure File
Editing Structure Files and Layouts
Edit a Structure File
Rebuild
Overview
Command Line
Option Files
Redirection of Information
Rebuild Options
Reorganizing Indexed Files
Rebuilding a Corrupt Indexed File
Converting a File
Validating an Indexed File
Rebuild through Fileshare
Callable Rebuild
Rebuild Examples
Configurable Codesets
The Codecomp Utility
The Codeset Mapping File Format
Supported Country Codes
How to...
To customize character set conversion
To change the current character set for command-line utilities
File Handling
File Handling Examples
Example of Data and Key Compression
External Files
Example External Files
File Handler
Example Configuration File
Example of Creating a New Index File
Example of Accessing the FCD
Example of Setting Up the Record Area
Example of Setting up the Filename Area
File Names
Examples of static filename assignment
Example of dynamic filename assignment
Example of external filename assignment
Examples of device name assignment
Example of Forced Filename Mapping
Example of Connecting a File to Standard Output
Example of Connecting a File to Standard Input
Example of Setting up a Two-way Pipe
Example of using the External File Mapper
Example of Specifying a Fileshare Client User ID and Password
Example Fileshare Client Configuration File
File Status
Example of Displaying File Status Codes
Example of Checking File Status Codes
Example of Extended File Status Codes
Indexed Files
Example of Indexed File Definition
Example of Primary Key Definition
Example of Alternate Key Definition
Example of Duplicate Key Definition
Example of Sparse Key Definition
Example of Indexed File Access Definition
Example of Creating Fixed-length Records
Example of Creating Variable Length Records
MFSORT
Example Mfsort Command Line
Example Mfsort Fields Instruction
Example Mfsort Key Instruction
Example Mfsort Instruction File
Rebuild
Example of Reorganizing an Indexed File
Example of recovering a corrupt indexed file
Example of using Rebuild to convert a file
Example of validating the structure of an indexed file
Example of a Rebuild options file
Example of calling Rebuild from a COBOL program
Example Relative File Definition
Sequential Files
Example Record Sequential File Definition - Fixed-length Records
Example Record Sequential File Definition - Variable Length Records
Example Line Sequential File Definition
Example Printer Sequential File Definition
File Handling Guide
Introduction
Overview
Micro Focus File Handler
File Organizations
Overview
Sequential Files
Record Sequential Files
Line Sequential Files
Printer Sequential Files
Relative Files
Indexed Files
Primary Keys
Alternate Keys
Duplicate Keys
Sparse Keys
Indexed File Access
Fixed-length and Variable-length Records
File Headers
Filenames
Filename Conventions
Assigning Filenames
Static Filename Assignment
Dynamic Filename Assignment
External Filename Assignment
Library Names in Paths
Filename Mapping
Multiple Paths
Library Names
Assigning Device Names
Setting Up Pipes
Output Pipes
Input Pipes
Two-way Pipes
File Status
What is File Status?
Defining a File Status Data Item
File Status Conventions
ANSI'85 File Status
ANSI'74 File Status
File Status Conversions
Extended File Status Codes
Sharing Files
Sharing mode
Record Locking
Manual and Automatic Record Locking
Manual Record Locking
Automatic Record Locking
Single and Multiple Record Locking
Single Record Locking
Multiple Record Locking
Handling Record Locks
Releasing Record Locks
File Status Codes
File Handler Configuration
Configuration File
Configurable Behavior
Large Indexed Files
File Striping
Headers in Striped Files
Options
MAXSTRIPEDIGITS
MAXSTRIPEFILES
MAXSTRIPESIZE
STRIPE-X
STRIPENAMETYPE
STRIPING
Examples
Performance
File Handler and Sort APIs
Calling the File Handler
Overview
Data Structures
File Control Description (FCD)
Record Area
Filename Area
Key Definition Block
Global Information Area
Key Definition Area
Component Definition Area
Accessing the FCD
Operation Codes
Relative Byte Addressing
Read a Record
Rewrite a Record
Delete a Record
Creating Your Own File Handler
Dynamic Redirection to a Custom File Handler
Redirection Using Configurable DYNREDIR
Specifying a List of Custom File Handlers
Specifying Configurable Custom File Handlers
Writing a Custom File Handler
Restrictions
Creating a New Index File
Sort Module
Compression Routines
Sort Module
Sort Utilities
Introduction
Invoking Mfsort
Instructions
FIELDS Instruction
Field Types
Defining Input and Output Files
RECORD Instruction
ORG Instruction
KEY Instruction
Creating a Statistics Report
Example Commands
Sorting Using More Than One File
Character Sort in Ascending Order
Numeric Sort in Descending Order
Omitting Records
Single File Sort Using INCLUDE and a Sub-string Comparison
Single File Sort Using Environment Variables
Transforming Records Using OUTREC
Sort Using OUTFIL for Complex Reporting
Input Data
Mfsort Command
Output
Workfile
Error Messages
Data and Key Compression
Data Compression
Key Compression
Compression of Trailing Nulls
Compression of Trailing Spaces
Compression of Leading Characters
Compression of Duplicate Keys
Example of Using Data and Key Compression
Compression Routines
Micro Focus Compression Routines
Calling a Micro Focus Compression Routine
User-supplied Compression Routines
Tracing File Operations
Introduction
Configuring Tracing and Logging
Dynamic Tracing
Using the FCD to Control Tracing
Using Library Routines to Control Tracing
Trace Player
Run the Trace Player from the Command Line
Examples
File Systems
32-bit file systems
64-bit file systems
File systems and FILEMAXSIZE
Fileshare Guide
Introduction
Overview
How Fileshare Works
Standard Operation
Fileshare Client
Specifying the Fileshare Server
As a Filename
In a Configuration File
Specifying the Communications Protocol
Configuring Your Fileshare Client
Fileshare Client Configuration Options
Example Client Configuration File
Using the File Handling Redirector Module
FHREDIR Return Codes
Fileshare Server
Configuring the Fileshare Server
Specifying a Fileshare Server Name
Specifying the Communications Protocol
Fileshare Server Configuration Options
Example Server Configuration File
Starting the Fileshare Server
Stopping the Fileshare Server
Configuring CCI Communications for Fileshare
About Fileshare Communications
Specifying the Communications Protocol
Using CCITCP
Using UNIX named pipes: ccinampu
Logging Fileshare Messages: CCI Trace
Using Multiple Protocols with Test Programs
Configuring the CCI Timeout
Database Integrity
Transaction Processing
Automatic Record Lock Timeout
Transaction Processing - Fileshare Client
Transaction Processing - Fileshare Server
Recovery Logging
Basic Recovery Logging
Advanced Recovery Logging
Enabling Advanced Recovery Logging
Fileshare Exit Procedure - fsexitproc.cbl
Viewing the Log Files
Fileshare Recovery
Basic Rollforward Recovery
Advanced Rollforward Recovery
Advanced Rollback Recovery
Database Sequence Numbering
Database Sequence Numbers - Fileshare Server
Database Backup and Recovery
Automatic Database Backup and Rollforward Recovery
Hot Backups
Running a Hot Backup
Database Reference File Maintenance
Recovery Log File Records
Disk Space Warning (/p)
Flushing the Log File (/lc)
Erasing a Log File Record (/e)
Example
Filename Record
Alternative Filename (/af)
Virtual File Handler (/ap)
Data and Key Compression (/k)
Disable Logging (/o l)
Disable Database Sequence Numbering (/o s)
Disable Transaction Processing (/o t)
Erasing a Filename Record
Examples
File String Record
Erasing a File String Record
Example
Backup Folder Record
Best Practices for Backup and Recovery
Best Practices Basic Logging
Best Practices Advanced Logging
Security
Password System
Fileshare Client
Fileshare Server
Writing Your Own FHRdrPwd Module
Logon Validation Module
File Access Validation Module
Password File Maintenance
User-ID Groups
Supervisor Mode
Advanced Operation
Running Fileshare as a Background Process
The NFILES Setting
Single User Mode
Filename Mapping
Fileshare Server
Data and Key Compression
Data and Key Compression - Fileshare Server
Virtual File Handler Interface
Fileshare Server
Monitoring Fileshare
Fileshare Manager
Fileshare Manager Configuration
Byte-stream I/O Calls
FS_LOCATE_FILE
FS_SPLIT_FILENAME and FS_JOIN_FILENAME
Performance Considerations
Fileshare Performance on UNIX
Large File Support with Fileshare
Error Handling
Fileshare Extended Status Codes
Communications Errors
Transaction Processing Errors
Fileshare Server Messages
Messages from FS001-S to FS050-W
FS001-S The parameter "text " is not recognized as a valid parameter.
FS004-S The parameter "text " specifies a time-out value that is invalid.
FS005-S The parameter "text " is too long or invalid.
FS006-S The parameter "text " has already been specified.
FS007-S Invalid parameter combination.
FS008-S Communications Initialization Failure.
FS009-S The required communications module cannot be found.
FS011-W Communications send failure.
FS012-W Communications disconnect failure.
FS013-W Communications receive error.
FS014-W Communications data length not as expected.
FS015-W Request from unknown user - request rejected.
FS016-S The parameter "text " is invalid.
FS017-S Unable to open the file : filename.
FS018-S Log file corrupt - unrecognizable record in file.
FS019-S Log file corrupt - can't read header.
FS020-S The log file does not match the database sequence numbers - recovery aborted.
FS021-S There is no log filename specified in the database reference file.
FS022-S The log filename given cannot be found in the database reference file.
FS024-S Failed to open log file : filename.
FS025-S Write failure to the log file, Fileshare Server is closing down.
FS026-W Failed to close the log file.
FS027-S A second log file parameter has been found.
FS028-W The log file shows the last session was not shut down successfully.
FS029-S The log filename is already specified in the database reference file.
FS030-S Insufficient disk space to continue logging to log file.
FS031-I Record lock time-out failure on user : user.
FS034-S A filename or log file parameter must be specified.
FS035-S A database reference file must be specified.
FS037-I The file filename does not have a file header record. Sequence checking is switched off for this file.
FS038-S A matching sequence number not found in filename.
FS039-S Improperly closed file - filename.
FS040-S Unable to read the file header record in the file filename.
FS041-S Unable to update the sequence number in the file filename.
FS042-S Unable to open the database reference file: filename.
FS043-S The database reference file contains an invalid entry.
FS044-S Error reading the database reference file.
FS045-W Duplicate filename specified in the database reference file.
FS050-W A log file is not specified in the database reference file.
Messages from FS051-W to FS099-W
FS051-W Failure to allocate a larger buffer, the I-O request failed.
FS052-S Failure to allocate required memory. The Fileshare Server is closing down.
FS055-S The parameter "text " specifies a configuration file that does not exist.
FS056-S The parameter "text " specifies a data compression value that is not within the range 0-255.
FS057-S The parameter "text " specifies a key compression value that is not within the range 0-7.
FS058-S Failure to allocate memory for the decompression of the log file.
FS059-S Failure to allocate the memory required for processing the database reference file.
FS062-S Failure creating the password file filename.
FS063-S Failure opening the password file filename.
FS064-S Failure reading the password file filename.
FS065-S The password file is not of a recognized format.
FS066-S The specified user name already exists in the password file.
FS068-I The password file is now empty and has been deleted.
FS069-S The specified entry could not be found in the password file.
FS070-S Failure writing to the password file.
FS071-W Unable to load the module FHXSCOMP to decompress the data area.
FS072-S The parameter "text " contains a wild card which is not allowed with this parameter.
FS073-S Failure to allocate memory to process the password file.
FS074-S The Fileshare Server (NLM) failed to log on to NetWare with the login id specified.
FS075-W Unable to load the module FSSECLOG - LOGON has been denied.
FS076-W Unable to load the module FSSECOPN - OPEN has been denied.
FS077-S A Fileshare Server of the same name has already been defined - the Fileshare Server is closing down.
FS078-S No password file has been specified for the use of background mode.
FS079-S A supervisor password entry must exist for the use of background mode.
FS080-S No password file has been specified for the use of the synchronous communications mode.
FS081-S A supervisor password must be specified in the password file for the synchronous communications mode.
FS082-S The Netbios communications protocol is not responding. Ensure the requester software is loaded and functional.
FS083-S Incompatible CCIIPX.NLM version.
FS084-I Fileshare Server is starting.
FS085-I Fileshare Server is active.
FS086-I Fileshare Server is closing down.
FS087-I Fileshare Server has closed down.
FS089-I Database Reference File Maintenance Utility.
FS090-I Database Reference File installation completed successfully.
FS091-I Rollforward Recovery Utility
FS092-I Rollforward Recovery has completed.
FS094-I Password File Maintenance Utility.
FS096-I Password File installation has completed.
FS097-I Are you sure that you wish to close down the Fileshare Server ? (Y/N)
FS099-W File I/O status was not as expected. Returned status: status Expected status: status Action code: text File: filename.
Messages from FS101-I to FS149-I
FS101-I text -- parameter has been accepted.
FS103-I The log filename has been added to the database reference file.
FS104-I The log file cannot be found, creating a new recovery log file.
FS105-W The disk free space for the log file is below acceptable limits.
FS106-I filename - added to database reference file.
FS107-I filename - removed from the database reference file.
FS108-I Processing the files specified in the database reference file.
FS109-W The file filename does not exist.
FS110-I filename - OK.
FS111-W Files are still open. Continue to close down the Fileshare Server (Y/N) ?
FS114-W Waiting for the old log file to be removed.
FS118-I The database sequence number matches the sequence number in the log file, no recovery is needed.
FS122-I Communications too busy on CCI SEND - retrying.
FS123-I Communications too busy on CCI RECEIVE - retrying.
FS124-I Checking the validity of the log file, please wait.
FS125-I Recovery possible to last valid recovery log file record.
FS126-I Performing recovery, please wait.
FS127-S Invalid name mapping command.
FS128-W Fileshare Server closedown invoked by Stop Run processing.
FS129-I The Fileshare Server is still active.
FS130-I Reading database reference file, please wait.
FS131-W Invalid communications mode - parameter ignored.
FS132-I The Fileshare Server is running with the following communication protocol(s):
FS133-I Processing the password file, please wait.
FS134-I The password file cannot be found - creating a new password file.
FS135-I Fileshare Server security is active.
FS136-I Fileshare Server security is not active.
FS138-W The log file has been backed up and a new one has been created.
FS139-I A matching date and time entry has been found in the log file.
FS140-I No matching date and time entry has been found in the log file.
FS142-W The Operating System does not permit the log file to be flushed to disk.
FS143-W The Operating System does not allow free disk space information to be obtained.
FS144-W More than one communications protocol has been specified - synchronous communications mode not active.
FS145-W Fileshare Client disconnected, cannot contact user: text.
FS146-W Unexpected action code, action-code - discarded.
FS147-I A duplicate network message was received and discarded.
FS148-I CCI return-code (function func) = code.
FS149-I CCI SEND not complete, status will be checked later.
Messages from FS151-I to FS200-W
FS151-I CCI message size received = text. Indicated send message size = text
FS153-I The Fileshare Server name has been reregistered on the network.
FS154-I Please enter the FSVIEW supervisor password to enable the use of CCI Trace.
FS155-I Password accepted - CCI Trace is enabled. Do you want CCI Trace active immediately? (Y/N)
FS156-W Incorrect password - CCI Trace is disabled.
FS158-I CCI Trace activated.
FS159-I CCI Trace switched off.
FS160-I Fileshare trace activated.
FS161-I Fileshare trace switched off.
FS163-I Input useropcode [filename-1] [ filename-2].
FS170-I Input- Logon.
FS171-I Input- Logoff user.
FS172-I Input- Find File userfilename.
FS173-I Output- userstatus.
FS176-W There is no backup directory specified in the database reference file.
FS177-S The backup directory specified cannot be found in the database reference file.
FS178-I The backup directory has been added to the database reference file.
FS179-S A backup directory is already specified in the database reference file.
FS180-W The log filename specified has an extension. The name of the log file has been changed to "filename".
FS182-W Output- Access Denied
FS188-W Fileshare Server database reference file installation completed with errors.
FS189-W The backup directory does not exist.
FS190-W The backup directory specifies the name of an existing file.
FS191-W An error occurred accessing the backup directory.
FS192-S More than one log file exists in the log file directory.
FS193-S Unable to open the log file.
FS194-I The log file "filename-1" has been backed up successfully to "filename-2".
FS195-I The Fileshare Server is using the log file "filename".
FS196-W Unable to create the log file "filename".
FS197-S Unable to create the log file "filename".
FS198-W The attempt to backup the log file failed because the backup file "filename" already exists.
FS199-S The attempt to backup the log file failed because the backup file "filename" already exists.
FS200-W The attempt to backup the log file to "filename" failed.
Messages from FS201-S to FS252-S
FS201-S The attempt to backup the log file to "filename" failed.
FS202-I The Fileshare Server will continue logging to the log file "filename".
FS203-I The Fileshare Server is appending to the log file "filename".
FS204-W The Fileshare Server is unable to log to the log file "filename". Rollforward recovery logging is disabled.
FS205-W Unable to remove the old recovery log file "filename".
FS206-S There is more than one starter log file. The Recovery Utility is unable to determine which one to use.
FS207-I There is no starter log file in the log file directory.
FS208-S There is no starter log file in the backup directory.
FS209-I A starter log file has been located in the backup directory.
FS210-S There is more than one starter log file in the backup directory.
FS211-S An error occurred checking the header on the log file "filename".
FS212-I The Rollforward Recovery Utility is processing the log file "filename".
FS213-W Unable to locate the continuation log file "filename" in the log file directory.
FS214-I Searching for a backed up log file in the log file directory.
FS215-I Searching for a backed up log file in the backup directory.
FS216-I No backed up starter log file can be found in the log file directory.
FS217-I No backed up starter log file can be found in the backup directory.
FS218-I No backed up continuation log file can be found in the log file directory.
FS219-I No backed up continuation log file can be found in the backup directory.
FS220-I A backed up starter log file has been found in the log file directory.
FS221-I A backed up starter log file has been found in the backup directory.
FS222-I A backed up continuation log file has been found in the log file directory.
FS223-I A backed up continuation log file has been found in the backup directory.
FS224-S The log file directory contains more than one backed up starter log file.
FS225-S The backup directory contains more than one backed up starter log file.
FS227-W Failure to set Fileshare Server's access rights.
FS228-I CCI SEND status checked.
FS229-I Unrecognized CCI session ID - could not disconnect user.
FS230-I User : user-IDuser-name
FS231-S The parameter "nnn" is not numeric.
FS232-I Date : date.
FS233-W Unable to set the maximum amount of dynamic memory to the limit specified.
FS234-W The parameter "text " specifies a memory limit below the minimum of 6 Mbytes allowed.
FS235-W Failure to allocate memory for incomplete CCI SEND processing.
FS236-I The log file name has been removed from the database reference file.
FS237-S The next log file to use filename already exists, unable to back up current log file.
FS237-W The next log file to use filename already exists, unable to back up current log file.
FS238-I Terminating communications with this user.
FS239-I Output - user Record locked. Retry operation.
FS240-I Output - user File locked. Retry operation.
FS241-I Output - user Insufficient log file disk space. Retry operation.
FS243-S Failure backing up the file filename1 to filename2.
FS244-S Failure restoring the backed up file filename1 to filename2.
FS245-S Failure deleting the log file filename.
FS246-I Backing up database files to directory backup directory. Please wait.
FS247-I Restoring database files from directory backup directory. Please wait.
FS248-I Commencing automatic Fileshare Recovery.
FS249-I Restarting Fileshare Server.
FS250-I Deleting all unwanted log files.
FS251-S Logging must be activated for all files when specifying a backup directory.
FS252-S Failure deleting the file filename.
Messages from FS301 - FS400
FS302-S Unable to continue - A log file already exists
Using COBOL and Java Together
Java and COBOL Interoperability Options
Setting Up the Environment for Native COBOL Applications
Setting Up the Environment for Java and COBOL
Compiling
Compiling COBOL Programs that Call Java
Compiling COBOL Programs that Are Used from the CobolBean interface
Java/COBOL Application Launcher
Using the Java/COBOL Application Launcher from the Command Line
Using the Java/COBOL Application Launcher from the Eclipse IDE
Linking to the Multi-threaded Run-time System
Deploying a Java Service Interface and Using Resource Adapters
EJB and Client Generation
Application Ear File
Client War File
EJB Jar File
Deployment Descriptors that Are Generated
Manifest Files
CustomRecord and Other Java Support
Calling the Generated EJB or Java Bean
Using Java Beans under J2SE
Overview of Using an Unmanaged Connection under J2SE
Using an Unmanaged Connection under J2SE
Writing a Simple CCI Program
Sample Program to Connect to a Resource Adapter
Sample Service
Sample Initialize Method
Sample Custom Record
Sample Calculator COBOL Program
Calling Procedural COBOL from Java
Overview - Calling Procedural COBOL from Java
Coding Your Java Program
Multi-threading Considerations
Loading a COBOL Program or Library
Using the cobcall() Methods
Examples of Calling COBOL from Java
Changing Data Members in a Java Object
Using CobolBean for Instance Data
Canceling a COBOL Program
Handling Strings from a Java Program
Pointer Class
mfjstring
CobolNational Class
Using Custom Records to Pass Group Items
Using JNI with COBOL
Example of Throwing an Exception
Calling Java from OO COBOL
Overview of Calling Java from OO COBOL
Before You Start
Declaring Java Classes
Instantiating Java Objects
Calling Java Methods
Accessing Java Variables
Handling Java Exceptions
Accessing Native Java Objects
Finalizing Java Objects
Calling OO COBOL from Java
Overview - Calling OO COBOL from Java
Before You Start
Writing a Java Class in OO COBOL
Importing the COBOL Support
The Wrapper Class
Adding and Removing Methods
Throwing Exceptions from COBOL
Using BY REFERENCE Parameters
Working with Java Programs
Java Data Types
Overview
Java Data Type Conversion Rules
Java Typedefs
Using the Jarray Class
Adding Parameters Using ParameterList()
Using Structures
Creating Custom Records using com.microfocus.cobol.lang.CustomRecord Interface
JVM COBOL Interoperating with Java
Java Calling JVM COBOL
Example of Java Calling JVM COBOL
JVM COBOL Calling Java
Example of JVM COBOL Calling Java
JVM COBOL Passing Java Instances to Native Procedural COBOL
JVM COBOL Passing Java Instances to Native Object COBOL
Managed COBOL Programming
Managed COBOL Programming
Introduction to Object-Oriented Programming for COBOL Developers
Native COBOL compared with managed COBOL
64-bit applications in the Java environment
Multiple user COBOL applications in Java
Background to multiple run units and Java
Developing an application for multiple run units in Java
Moving Native COBOL Applications to Managed COBOL
What is Managed Code?
Why Move to Managed Code?
Considerations When Moving to Managed Code
Writing Multi-User Applications
Using Java Managed Beans to Manage and Monitor COBOL Applications
Accessing Procedural COBOL From Managed Code
Example of Using a Managed COBOL Wrapper Class
Example of Using the ILSMARTLINKAGE Compiler Directive
Interoperability
Data Marshaling and Type Conversion for Managed Code Interoperation
Type Compatibility in Interoperation with Managed Code
Exposing COBOL Linkage Data as Managed Types
Type Mappings from Native COBOL to Managed Code
Write a Proxy or Edit the COBOL for Managed Interoperation?
JVM COBOL Interoperating with Native COBOL
Calling Native COBOL from JVM COBOL
Passing Parameter Modes for JVM COBOL Calling Native COBOL
Pointers from Native Code to JVM COBOL
Strings in JVM COBOL Interoperation
Arrays of Bytes in JVM COBOL Interoperation
Limitations in JVM COBOL Interoperability
Example of JVM COBOL Interoperation with Native Code
JVM COBOL Interoperating with Java
Java Calling JVM COBOL
Example of Java Calling JVM COBOL
JVM COBOL Calling Java
Example of JVM COBOL Calling Java
JVM COBOL Passing Java Instances to Native Procedural COBOL
JVM COBOL Passing Java Instances to Native Object COBOL
Mixed Language Programming
Storage Representation of Parameters
Handling Return Codes in Mixed Language Applications
Call Conventions for Interfacing with Mixed Languages
Avoiding data name conflicts
Multi-threaded Programming
Introduction to multi-threading
Multi-threading and the Operating System
Multi-threading and the Application
Multi-threading and the Command Line
Synchronizing Execution and Resolving Contention
Introduction
Multi-threaded Program Attributes
Specifying No Multi-threading
Serial Programs
Reentrant Programs
Use of Data Attributes
Using Synchronization Primitives
Using a Mutex
Using a Monitor
Using a Semaphore
Using an Event
Writing Multi-threaded Applications
Overview
Run-time System for Multi-threaded Applications
Considerations When Creating Reentrant Programs
Multi-threading Library Routines
Thread-control Routines
Thread-synchronization Routines
Routines for Handling Thread-specific Data
Initializing Applications
Manipulating Threads
Thread Handles
Creating and Terminating a Thread
Canceling a Thread
Suspending a Thread
Identifying a Thread
Threads in Other Languages
Canceling Called Programs
Optimizations and Programming Tips
Multi-threading Compiler Directives
Directives for Serial and Reentrant Programs
Directives that Optimize Performance
Problem Determination and Diagnostic Tools
Protection Violations
Overview - Protection Violations
What Are Protection Violations?
General Protection Violations
COBOL Protection Violations
Unflagged Protection Violations
Correcting Protection Violations
Errors in Non-COBOL Portions of an Application
Parameter Mismatches in a CALL Statement
Stack Overflow
Illegal Reference Modification
Illegal Values for Pointers
Subscript Out of Range
Incorrect Linking Options or Procedures
Debugging Techniques
Consolidated Tracing Facility
To enable CTF tracing
To enable CTF tracing of a web application
CTF Trace File Formats
CTF Viewer
Annotation Files for CTF Events
Bookmarks in the CTF viewer
To create and load a binary trace file into the CTF Viewer
To search in the CTF Viewer
To enable your annotation files in the CTF Viewer
CTF Perspective
Components Traced by CTF
mf.cci Properties
mf.idmr Properties
mf.mffh.fs Properties
mf.mffh.xfh Properties
mf.mffh.xsm Properties
mf.rts Properties
CTF Configuration File
mftrace.application
mftrace.comp.component-name#property
mftrace.dest
mftrace.dest.component-name
mftrace.emitter.emitter-name#property
mftrace.level
mftrace.level.component-name
mftrace.time
Example CTF Configuration Files
CTF Emitter List
BINFILE Emitter Properties
JAVALOGGER Emitter Properties
TEXTFILE Emitter Properties
CTF Tracing Examples
Profiler
Enabling Profiler
Configuring the Profiler Reports
Running Your Application with Profiler
Profiler Output
Time Spent in Called Programs
The Micro Focus Unit Testing Framework
Writing Tests
Elements of a Test Fixture
Determining a Test Outcome
Examples - Writing Tests
Simple Test Case Example
Advanced Test Case Example
Restrictions
Compiling Tests
Running Tests
Test Runner Syntax Options
Test Fixture Files
Test Fixture File Configuration Options
Example Test Fixture File
Examples
Viewing Test Results
Example - text file results
Example - junit results
Using the Results on a Jenkins CI Server
Dealing with Errors in Your Tests
Glossary of Terms
Hints and Tips
Performance Programming
Benchmarking your Application
Troubleshooting Performance Issues
Optimizing COBOL Syntax
Optimizing Data Definitions
Speed of Processing of Different Data Types
COMP-5 Performance
COMP-X Performance
COMP Performance
COMP-3 Performance
DISPLAY Performance
Aligning Data Items for Efficiency
Optimizing Arithmetic Statements
Optimizing IF Statements
Optimizing Decimal Point Alignment
Optimizing Exponential Operations
Initializing Data Items
Optimizing Data Manipulation and Reference Modification
Optimizing Data Structures
Optimizing Table Handling
Optimizing Conditional Statements
Optimizing Logical Operations
Optimizing PERFORM Statements
Optimizing CALL Statements
Optimizing Parameter Handling
Optimizing File Sorting
Aligning Bit Data Items
Compiler Directives for Optimizing Code
Examples
Example of Inefficient Use of the PERFORM Statement
Example of Optimized Subscripts to Table Elements
Example of Optimizing USAGE DISPLAY Subscripts
Optimizing Other Areas
Database Access
File Handling
Design Considerations
Optimizing File Selection
Optimizing Your Application Using the File Handler Configuration File
Programming Tips
Accessing Data on the Command Line from COBOL
Accessing Environment Variables from COBOL
Manipulating Data with Reference Modification and STRING
Writing Recursive Routines
Coding an Intrinsic Function
Manipulating Bits
Examples
Example of Recursion
Example of Recursive Routines
Example of Intrinsic Functions
Example of Bit Manipulation
General Reference
C Functions for Calling COBOL
cobaddch
cobaddstr
cobaddstrc
cobcall
cobcancel
cobclear
cobcols
cobcommandline
cobexit
cobfunc
cobget
cobgetch
cobgetenv
cobgetfuncaddr
cobinit
cobkeypad
coblines
coblongjmp
cobmove
cobpostsighandler
cobprintf
cobput
cobputenv
cobremovesighandler
cobrescanenv
cobscroll
cobsetjmp
cobtermmode
cobthreadtidy
cobtidy
SYSTEM
COBOL Language Reference
COBOL Language Supported and Copyrights
Notations
Part 1. Concepts
Introduction to the COBOL Language
The COBOL Language
Source Format
Fixed Format
Sequence Number
Indicator Area
Areas A and B
Sample Program
Free Format
Variable Format
Concepts of the COBOL Language
Character Set
Language Structure
Separators
Character-strings
COBOL Words
Scope of Names
Conventions for Program-names
Conventions for Condition-names, Data-names, File-names, Record-names, Report-names and Typedef-names
Conventions for Index-names
Conventions for Class-names (for Object Orientation) and Interface-names
Conventions for Method-names
Conventions for Function-prototype-names
Conventions for Program-prototype-names
Literals
Nonnumeric Literals
Numeric Literals
National Literals
Figurative Constant Values
Constant-names
Concatenation Expressions
Special Registers
Predefined Object Identifiers
PICTURE Character-Strings
Comment-entries
Formats and Rules
General Format
Syntax Rules
General Rules
Elements
Concept of Computer-independent Data Description
Concept of Levels
Level-Numbers
Class and Category of Data
Algebraic Signs
Standard Alignment Rules
Item Alignment for Increased Object-code Efficiency
Selection of Character Representation and Radix
DISPLAY Format
COMPUTATIONAL, BINARY, or COMPUTATIONAL-4 Format
Computer Memory Natural Boundaries
Synchronization
Implicit Synchronization
Example of Implicit FILLER Assignments
Truncation
Example of Truncation
COMPUTATIONAL-1, COMPUTATIONAL-2,FLOAT-SHORT and FLOAT-LONG Formats
COMPUTATIONAL-3 or PACKED-DECIMAL Format
COMPUTATIONAL-X and COMPUTATIONAL-5 Formats
POINTER Format
PROCEDURE-POINTER Format
Uniqueness of Reference
Qualification
Subscripting
Indexing
Function-identifier
Reference Modification
Identifier
Condition-name
Object property
Inline method invocation
Object-view
Data-address-identifier
Type of identifier
Program-address-identifier
Explicit and Implicit Specifications
Explicit and Implicit Procedure Division References
Explicit and Implicit Transfers of Control
Explicit and Implicit Attributes
Explicit and Implicit Scope Terminators
Language Fundamentals
Optional Division, Section and Paragraph Headings
Reserved Words
External Repository
Call Prototypes
Files
File Connector
Sequential Input/Output
Record Sequential Input/Output
Line Sequential Input/Output
Organization of Line and Record Sequential Files
Access Mode
Relative Input/Output
Organization of Relative Files
Access Mode
Indexed Input/Output
Organization of Indexed Files
Access Mode
Sharing Mode
Object-oriented COBOL Concepts
Objects and Classes
Object References
Predefined Object References
Methods
Method Invocation
Conformance and Interfaces
Conformance for Object Orientation
Interfaces
Conformance between Interfaces
Conformance for Parameterized Classes and Parameterized Interfaces
Polymorphism
Class Inheritance
Interface Inheritance
Interface Implementation
Parameterized Classes
Parameterized Interfaces
Object Life Cycle
Life Cycle of Factory Objects
Life Cycle of Objects
Life Cycle of Parameterized Classes
Life Cycle of Parameterized Interfaces
Managed Code Concepts
Attributes, Custom Attributes
Delegates and Events
Enumerations and Enum types
Extension Methods in Managed COBOL
Nested Classes in Managed COBOL
Data Types in Managed COBOL
Specifying Type Names
Simplified Class Layout
Run Unit Communication
Common, Initial and Recursive Attributes
Sharing Data
Sharing File Connectors
Data Division
Overview
Automatic, Initial and Static
State of a Function, Method, Object or Program
State of a Function, Method or Program
Active State
Initial and Last-used States of Data
Initial State
Last-used State
Initial State of an Object
Global Names and Local Names
External and Internal Items
Procedure Division
Execution
Statements and Sentences
Conditional Statement
Conditional Sentence
COBOL System-Directing Statement
COBOL System-Directing Sentence
Compiler Directives
Imperative Statement
Imperative Sentence
Delimited Scope Statements
Categories of Statements
Reference Format
Reference Format Representation
Sequence Numbers
Continuation of Lines
Blank Lines
Pseudo-text
Division, Section and Paragraph Formats
Division Header
Section Header
Paragraph Header, Paragraph-name and Paragraph
Data Division Entries
Declaratives
Comment Lines
In-line Comments
Part 2. Program Definition
Compilation Group
Compilation Groups
End Markers
Identification Division
Identification Division - General Description
The Program-ID Paragraph
The Class-ID Paragraph
The Factory Paragraph
The Object Paragraph
The Method-ID Paragraph
The Interface-ID Paragraph
The Function-ID Paragraph
The Date-Compiled Paragraph
The Delegate-ID Paragraph
The Enum-ID Paragraph
The Iterator-ID Paragraph
The Operator-ID Paragraph
The Valuetype-ID Paragraph
Environment Division
General Description
Configuration Section
The Source-Computer Paragraph
The Object-Computer Paragraph
The Special-Names Paragraph
The Repository Paragraph
The Constraints Paragraph
The Class-Attributes Paragraph
The Assembly-Attributes Paragraph
Input-Output Section
The File-Control Paragraph
The File Control Entry
The I-O-Control Paragraph
Data Division
General Description
File Section
Working-Storage Section
Thread-Local-Storage Section
Object-Storage Section
Local-Storage Section
Linkage Section
Screen Section
File and Data Description
File Description Entry Skeleton
The BLOCK CONTAINS Clause
The CODE-SET Clause
The DATA RECORDS Clause
The EXTERNAL Clause
The GLOBAL Clause
The LABEL RECORDS Clause
The LINAGE Clause
The RECORD Clause
The THREAD-LOCAL Clause
The VALUE OF Clause
The RECORDING MODE Clause
Data Description Entry Skeleton
The ANY LENGTH Clause
The BLANK WHEN ZERO Clause
The ATTRIBUTE, CUSTOM-ATTRIBUTE Clause
The Data-name or FILLER Clause
The GROUP-USAGE Clause
The JUSTIFIED Clause
Level Number
The OCCURS Clause
The PICTURE Clause
The PROPERTY Clause
The REDEFINES Clause
The RENAMES Clause
The SIGN Clause
The SYNCHRONIZED Clause
The TYPEDEF Clause
The USAGE Clause
The VALUE Clause
Screen Section
Screen Section Entry Skeleton
The AUTO Clause
The BACKGROUND-COLOR Clause
The BELL Clause
The BLANK Clause
The BLANK WHEN ZERO Clause in the Screen Section
The BLINK Clause
The COLUMN Clause
The CONTROL Clause
The ERASE Clause
The FOREGROUND-COLOR Clause
The FROM Clause
The FULL Clause
The GRID Clause
The HIGHLIGHT Clause
The JUSTIFIED Clause in the Screen Section
The LEFTLINE Clause
The LINE Clause
The LOWLIGHT Clause
The OCCURS Clause in the Screen Section
The OVERLINE Clause
The PICTURE Clause in the Screen Section
The PROMPT Clause
The REQUIRED Clause
The REVERSE-VIDEO Clause
The SECURE Clause
The SIGN Clause in the Screen Section
The SIZE Clause
The TO Clause
The UNDERLINE Clause
The USAGE Clause in the Screen Section
The USING Clause
The VALUE Clause in the Screen Section
The ZERO-FILL Clause
Procedure Division
Procedure Division General Description
The PROCEDURE DIVISION Header
Arithmetic Expressions
Arithmetic Operators
Bitwise Operators
Permissible Combinations of Symbols
Formation and Evaluation Rules
Intermediate Results
Conditional Expressions
Simple Conditions
Relation Condition
Comparison of Numeric Operands (Relation Condition)
Comparison of Nonnumeric Operands (Relation Condition)
Comparisons Involving Index-Names and/or Index Data Items (Relation Condition)
Comparisons Involving Data Items with USAGE POINTER (Relation Condition)
Comparisons Involving Data Items with USAGE PROCEDURE-POINTER (Relation Condition)
Comparisons Involving Data Items with USAGE OBJECT (Relation Condition)
Class Condition
Condition-name Condition (Conditional Variable)
Switch-Status Condition
Sign Condition
Omitted-argument Condition
Instance-of Condition
Complex Condition
Negated Simple Condition
Combined and Negated Combined Condition
Abbreviated Combined Relation Conditions
Condition Evaluation Rules
Common Phrases
Arithmetic Statements
Overlapping Operands
Multiple Results in Arithmetic Statements
Incompatible Data
Signed Receiving Items
The ROUNDED Phrase
The ON SIZE ERROR Phrase and NOT ON SIZE ERROR Phrase
ON SIZE ERROR Phrase Not Specified
ON SIZE ERROR Phrase Specified
The NOT ON SIZE ERROR Phrase
The CORRESPONDING Phrase
File I/O Concepts
File Position Indicator
I-O Status
Status Key 1
Successful Completion
Successful Completion
AT END Condition with Unsuccessful Completion
INVALID KEY Condition with Unsuccessful Completion
Permanent Error Condition with Unsuccessful Completion
Logic Error Condition with Unsuccessful Completion
Run-Time System Error Message
Valid Combinations of Status Keys 1 And 2
The AT END Condition
The INVALID KEY Condition
Sharing Files on Multi-user Systems
Single Record Locking
Multiple Record Locking
Default Record Locking
Conformance for Parameters and Returning Items
Parameters
Group Items
Elementary Items
Elementary Items Passed by Reference
Elementary Items Passed by Content or by Value
Returning Items
Group Items
Elementary Items
Intrinsic Functions
Arguments
Function Types
Data Item Functions
Date Conversion Functions
Trigonometric Functions
Definitions of Functions
The ABS Function
The ACOS Function
The ANNUITY Function
The ASIN Function
The ATAN Function
The BOOLEAN-OF-INTEGER Statement
The CHAR Function
The CHAR-NATIONAL Function
The COS Function
The CURRENT-DATE Function
The DATE-OF-INTEGER Function
The DATE-TO-YYYYMMDD Function
The DAY-OF-INTEGER Function
The DAY-TO-YYYYDDD Function
The DISPLAY-OF Function
The E Function
The EXP Function
The EXP10 Function
The FACTORIAL Function
The FRACTION-PART Function
The INTEGER Function
The INTEGER-OF-BOOLEAN Statement
The INTEGER-OF-DATE Function
The INTEGER-OF-DAY Function
The INTEGER-PART Function
The LENGTH Function
The LENGTH-AN Function
The LOG Function
The LOG10 Function
The LOWER-CASE Function
The MAX Function
The MEAN Function
The MEDIAN Function
The MIDRANGE Function
The MIN Function
The MOD Function
The NATIONAL-OF Function
The NUMVAL Function
The NUMVAL-C Function
The ORD Function
The ORD-MAX Function
The ORD-MIN Function
The PI Function
The PRESENT-VALUE Function
The RANDOM Function
The RANGE Function
The REM Function
The REVERSE Function
The SIGN Function
The SIN Function
The SQRT Function
The STANDARD-DEVIATION Function
The SUM Function
The TAN Function
The ULENGTH Function
The UPOS Function
The USUBSTR Function
The USUPPLEMENTARY Function
The UVALID Function
The UWIDTH Function
The UPPER-CASE Function
The VARIANCE Function
The WHEN-COMPILED Function
The YEAR-TO-YYYY Function
Statements
The ACCEPT Statement
The ADD Statement
The ALTER Statement
The ATTACH Statement
The CALL Statement
The CANCEL Statement
The CHAIN Statement
The CLOSE Statement
The COMMIT Statement
The COMPUTE Statement
The CONTINUE Statement
The CREATE Collection Statement
The DECLARE Statement
The DELETE Statement
The DELETE FILE Statement
The DETACH Statement
The DISPLAY Statement
The DIVIDE Statement
The ENTER Statement
The ENTRY Statement
The EVALUATE Statement
The EXAMINE Statement
The EXEC(UTE) Statement
The EXHIBIT Statement
The EXIT Statement
The GOBACK Statement
The GO TO Statement
The IF Statement
The INITIALIZE Statement
The INSPECT Statement
The INVOKE Statement
The MERGE Statement
The MOVE Statement
The MULTIPLY Statement
The NEXT SENTENCE Statement
The NOTE Statement
The ON Statement
The OPEN Statement
The PERFORM Statement
The RAISE Statement
The READ Statement
The RELEASE Statement
The RESET Collection Statement
The RETURN Statement
The REWRITE Statement
The ROLLBACK Statement
The SEARCH Statement
The SERVICE Statement
The SET Statement
The SORT Statement
The START Statement
The STOP Statement
The STRING Statement
The SUBTRACT Statement
The SYNC Statement
The TRANSFORM Statement
The TRY Statement
The UNLOCK Statement
The UNSTRING Statement
The USE Statement
The WAIT Statement
The WRITE Statement
The XML GENERATE Statement
The XML PARSE Statement
Compiler-directing Statements
Source Text Manipulation
The COPY Statement
The REPLACE Statement
The BASIS Mechanism
The BASIS Statement
The DELETE Statement - BASIS Control
The INSERT Statement - BASIS Control
The ++INCLUDE and -INC Mechanisms
The -INC Statement
The ++INCLUDE Statement
Conditional Compilation
$DISPLAY Statement
$ELSE Statement
$END Statement
$IF Statement
The Listing Control Statements
The EJECT Statement
The SKIP1, SKIP2 and SKIP3 Statements
The TITLE Statement
Compiler Directives Specific to Your COBOL System
Examples
Call Prototypes
Calling and Setting a Procedure-Pointer
Call Returning a Dynamically Allocated Data Area from a Subprogram
Compilation Group
COPY (ANSI'68 or LANGLVL(1) Variation)
COPY (Partial Word Replacement)
CRT STATUS Clause of the SPECIAL-NAMES Paragraph
$IF Statement (Conditional Compilation)
INSPECT Statement (Tallying, Replacing, and Converting)
NEXT Phrase of CONSTANT-NAMES
SEARCH statement
SORT a File Using Input and Output Procedures
SORT Table Entries
Split Key
Typedef - User Defined USAGE or Structure
Part 3. Additional Topics
XML Syntax Extensions
XML File Status Codes
XML Preprocessor Restrictions
XML Syntax - CLOSE Statement
XML Syntax - COUNT IN Clause
XML Syntax - DELETE Statement
XML Syntax - IDENTIFIED BY Clause
XML Syntax - NAMESPACE clause
XML Syntax - PROCESSING-INSTRUCTION Clause
XML Syntax - OPEN Statement
XML Syntax - READ Statement
XML Syntax - REWRITE Statement
XML Syntax - SELECT Clause
XML Syntax - START Statement
XML Syntax - WRITE Statement
XML Syntax - XD File Description
Report Writer
Report Section
Report Structure
Vertical Spacing
Horizontal Spacing
Data Manipulation
Report Subdivisions
Physical Subdivision of a Report
Logical Subdivisions of a Report
Procedure Division Report Writer Statements
Language Concepts
Report File
Special Register PAGE-COUNTER
Special Register LINE-COUNTER
Special Register PRINT-SWITCH
Subscripting
Environment Division
Input-Output Section
The File-Control Paragraph
The I-O-Control Paragraph
Data Division
The File Description Entry (Report Writer)
The REPORT Clause
Report Section
The Report Description Entry
PAGE-COUNTER Rules
LINE-COUNTER Rules
The CODE Clause
The CONTROL Clause
The PAGE Clause
The Report Group Description Entry
Presentation Rules Tables
Organization
Line Number Clause Notation
Line Number Clause Sequence Substitutions
Saved Next Group Integer Description
Report Heading Group Presentation Rules
Page Heading Group Presentation Rules
Body Group Presentation Rules
Page Footing Presentation Rules
Report Footing Presentation Rules
The COLUMN NUMBER Clause (Report Writer)
Data-name (Report Writer)
The GROUP INDICATE Clause
Level-Number (Report Writer)
The LINE NUMBER Clause (Report Writer)
The NEXT GROUP Clause
The SIGN Clause (Report Writer)
The SOURCE Clause (Report Writer)
The SUM Clause (Report Writer)
The TYPE Clause
The USAGE Clause
The VALUE Clause (Report Writer)
Procedure Division
General Description
The CLOSE Statement
The GENERATE Statement
The INITIATE Statement
The OPEN Statement (Report Writer)
The SUPPRESS Statement
The TERMINATE Statement
The USE BEFORE REPORTING Statement
Debug Module
Standard ANSI COBOL Debug
Object-time Switch
COBOL Debug RTS Switch
Debugging Lines
Environment Division
The WITH DEBUGGING MODE Clause
Procedure Division
The READY TRACE Statement
The RESET TRACE Statement
The USE FOR DEBUGGING Statement
Segmentation
General Description of Segmentation
Organization
Program Segments
Fixed Portion
Independent Segments
Segmentation Classification
Segmentation Control
Structure of Program Segments
Segment-Numbers
The SEGMENT-LIMIT Clause
Restrictions on Program Flow
The ALTER Statement
The PERFORM Statement
The MERGE Statement
The SORT Statement
Double-Byte Character Set Support
DBCS Data
Roman Script in DBCS
Multivendor Integration Architecture Support
Source Programs
Language Extensions
Comments and Comment-entries
User-defined Words
Spaces
Data Items
DBCS Data Items
Mixed Data Items
Literals
DBCS Literals
Category of DBCS Literals
Mixed Literals
Figurative Constants
The "N" literal
Program Structure
The END PROGRAM Header (DBCS)
Identification Division
The PROGRAM-ID Paragraph (DBCS)
Environment Division
The SOURCE-COMPUTER Paragraph (DBCS)
The OBJECT-COMPUTER Paragraph (DBCS)
The SPECIAL-NAMES Paragraph (DBCS)
The FILE-CONTROL Paragraph (DBCS)
Data Division
The JUSTIFIED Clause (DBCS)
The PICTURE Clause (DBCS)
The REDEFINES Clause (DBCS)
The RENAMES Clause (DBCS)
The USAGE Clause (DBCS)
The VALUE Clause (DBCS)
Procedure Division
Conditional Expressions (DBCS)
Relation Conditions
Class Condition
Statements that Involve Moving Data
The ACCEPT Statement (DBCS)
The CALL Statement (DBCS)
The CANCEL Statement (DBCS)
The INITIALIZE Statement (DBCS)
The INSPECT Statement (DBCS)
The MOVE Statement (DBCS)
The SEARCH Statement (DBCS)
The STOP Statement (DBCS)
The STRING Statement (DBCS)
The UNSTRING Statement (DBCS)
Micro Focus Extensions for Double-Byte Character Support
Environment Division
The OBJECT-COMPUTER Paragraph
The SPECIAL-NAMES Paragraph
The FILE-CONTROL Paragraph
Data Division
The JUSTIFIED Clause
The PICTURE Clause (DBCS)
The USAGE Clause
The VALUE Clause
Procedure Division
Conditional Expressions
Condition-name
Relation Conditions
Class Condition
The ACCEPT Statement
The INITIALIZE Statement
The INSPECT Statement
The MOVE Statement
The SEARCH Statement
The STRING Statement
The UNSTRING Statement
Micro Focus OO COBOL Extensions
Directives
Class Definition
Class Extension
Class-body
Class-object
Object-program
Method
Method Interface Definition
Summary of Obsolete Language Elements
Additional Dialect Support
ACUCOBOL-GT Syntax Extensions
Program Structure
Identifiers
Numeric Literals
Nonnumeric Literals
Source Formats
Identification Division
PROGRAM-ID Paragraph
Environment Division
The File-Control Paragraph
Data Division
SYNCHRONIZED Clause
USAGE Clause
Procedure Division
Procedure Division Statements
ACCEPT FROM
ACCEPT FROM ENVIRONMENT
INSPECT
OPEN Statement
SET ENVIRONMENT
Data General Interactive COBOL V1.3 Syntax Support
Environment Division
Switch-Names
File-Name on Disk
The DATA SIZE Clause
The INDEX SIZE Clause
Duplicate Alternate Keys
Alternate Keys
I-O-Control Paragraph
Data Division
VALUE Clause
The Screen Section
Procedure Division
The CALL Statement
The COPY INDEXED Statement
The DISPLAY Statement
File Sharing Syntax
The OPEN Statement
The READ Statement
DOS/VS COBOL Support
Microsoft COBOL V1.0 and V2.0 Syntax Support
Special Registers LIN and COL
Environment Division
The Special-Names Paragraph
Data Division
The USAGE Clause
Procedure Division
The Position-Specification Phrase
The ACCEPT Statement
The DISPLAY Statement
The EXHIBIT Statement
Microsoft V2.0 Additional Syntax Support
Record LOCKING
OPEN LOCKING Statement
READ Statement (in Manual Mode)
START Statement
RM/COBOL Syntax Support
Environment Division
The ASSIGN Clause
The CODE-SET Clause
The ORGANIZATION Clause
The RECORD DELIMITER Clause
Data Division
Default Sign Representation
Empty Groups
The CONTROL Clause
The USAGE Clause
Procedure Division
Bound Checking
I-O Status Codes
Literals as Call Parameters
Locked Records
Non-standard Operations on Alphanumeric Data Items
OPEN and CLOSE on Sequential Files
Procedure Names
REWRITE on LINE SEQUENTIAL Files
Size Allocation for Index Data Items
The ACCEPT Statement
The DISPLAY Statement
The EXIT PROGRAM Statement
The PERFORM Statement
The STOP RUN Statement
Siemens BS2000 COBOL Syntax Support
Concepts
Indicator Area
Areas A and B
Special Registers
Nonnumeric Literals
Floating-point Literals
Function-Identifier
Representation of Numeric Items
The BINARY, COMPUTATIONAL and COMPUTATIONAL-5 phrases
File Concepts
Subscripts
Object Views
Identification Division
Identification Division Header
Identification Division Structure
The Class-ID Paragraph
The Factory Paragraph
The Interface-ID Paragraph
The Method-ID Paragraph (Siemens BS2000 COBOL)
The Object Paragraph
Environment Division
The Special-Names Paragraph
The File Control Entry
The Repository Paragraph
Data Division
The File Description Entry
The Sort-Merge File Description Entry
The Working-Storage Section
The DYNAMIC Clause
The OCCURS Clause
The PICTURE Clause
The REDEFINES Clause
The SYNCHRONIZED Clause
The USAGE Clause
The VALUE Clause
Procedure Division
Class Condition
Intrinsic Functions
The ADDR Function
The ACCEPT Statement
The CALL Statement
The CLOSE Statement
Record Sequential Files
Line Sequential Files
The DISPLAY Statement
The ENTRY Statement
The EVALUATE Statement
The EXIT PERFORM Statement
The GOBACK Statement
The INSPECT Statement
The INVOKE Statement
The MERGE Statement
The MOVE Statement
The OPEN Statement
The READ Statement
Relative and Indexed Files
The REWRITE Statement
The SEARCH Statement
The SET Statement
The SORT Statement
Sorting of Tables
Sorting Two-digit Years with a Century Window
The START Statement
Relative and Indexed Files
The STRING Statement
The USE Statement
The WRITE Statement
Sequential Files
Compiler Directing Statements
The COPY Statement
VS COBOL II Compatibility
Part 4: Appendices
Character Sets and Collating Sequences
ANSI File Status Summary
ANSI'74 File Status Codes
ANSI'85 File Status Codes
Reserved Words
Reserved Words Table
Context-sensitive Words Table
XML-CODE Exception Codes
Glossary
Command line reference
Setting Directives Outside the IDE
The Order in which Compiler Directives are Processed
System-wide Directives File, cobol.dir
$SET Statements in the Source Code
User Directives File
Compiling and Linking from the Command Line
Introduction to the cob command
cob (cob32 or cob64) Command
cob Options Syntax
cob Option Processing and Search Order
cobopt File
COBOPT Environment Variable
Creating Different Types of Files
Simple Default Linking
Resolving Unresolved References in System Executables
Creating Intermediate Code Files
Creating Generated Code Files
Callable Shared Objects
Creating Callable Shared Objects
Entry Points
Resolving Unresolved References in Callable Shared Objects
Advanced Uses
Creating Executables that Use Library Files
Creating Shared Libraries
Creating an Executable Run-time System (RTS)
Creating Executables that Use the Dynamic Loader
Creating Dynamically Loadable Files
cob Flags
Pass Option to Assembler (-A as_option)
Compile for Animation (-a)
Pass Syntax-check Phase Directive to the Compiler (-C directive)
Pass Option to the C Compiler (-CC cc_option)
Pass Option to the C++ Compiler (+CC cc_option)
Compile No Further Than Linkable Object Module (-c)
Dynamically Load Symbol (-d symb)
Set Initial Entry Point (-e epsym)
Create Information for Symbolic Debugger (-g)
Include Symbol in Executable File (-I symb)
Compile to Intermediate Code for Unlinked Environment (-i)
Compile to JVM Byte Code (-j)
Recognize COBOL Source File with Non-standard Filename Extensions (-k cobol-file)
Pass Option to System Linker Changing Search Algorithm and Maintaining Relative Ordering (-L dir)
Pass Option to System Linker After All Other Options Changing the Search Algorithm (+L dir)
Pass Option to System Linker Maintaining Relative Ordering (-l lib)
Pass Option to System Linker After All Other Options (+l lib)
Map Symbol to New Symbol (-m symb=newsym)
Pass Generate Phase Directive (-N directive)
Enable Optimization (-O)
Specify Output File-name (-o filename)
Produce Listing File (-P)
Pass Flag to C Compiler to Use Profiling Routines (-p)
Pass Option to System Linker (-Q ld_option or -Q,1 ld_option or -Q,2ld_option)
Create Multi-threading Program (-t)
Dynamically Load Unresolved Reference (-U)
Compile to Generated Code for Unlinked Environment (-u)
Report Version Number (-V)
Set Verbose Module (-v)
Control Error Level for cob Termination (-W err-level)
Exclude Symbol from the Executable Output File (-X symb)
Process to System Executable File (-x[,CC])
Produce a Shared Library for non-COBOL Applications (-Y[,CC])
Produce a Callable Shared Object for non-COBOL Applications (-y[,U][,CC])
Produce a Shared Library File for COBOL Applications (-Z[,CC])
Produce a Callable Shared Object for COBOL Applications (-z[,U][,CC])
Flags Reserved for Future Use
cob Error Messages
argument expected: option-name
cobol version number invalid - Call Technical Support
entry defined: entryname-1 conflicting "main" found in entrypoint-2
entry: entryname does not have "main" defined
I see no use for file-name
I see no work
invalid entry point name: entryname
options clash: option-names
cob Command Examples
Converting Header Files Using the H2cpy Utility
Service Interfaces
imtkmake command
mfdepinst command
Debugging from the Command Line
cobdebugremote32
cobdebugremote64
Running an Application from the Command Line
Command to Run a Linked System Executable Program
cobrun Command
Enhanced ACCEPT/DISPLAY Syntax
Overview
Accepting Elementary Data Items from Single Fields
Accepting Single Fields
Alphanumeric Fields
Numeric and Numeric-edited Fields
Fixed-format Data Entry
Free-format Data Entry
RM-style Data Entry
Displaying Elementary Data Items in Single Fields
Displayed Data Format - Examples