Micro Focus Enterprise Developer for Visual Studio 2010

Create and Configure ESSOAP

Generate Clients

Run the WPF Client

Tutorial: EJB Service Interface

Configure ESDEMO

Generate and Deploy a JSP Client

Deploy the Resource Adapter to JBoss

Run the JSP Client

Tutorial: REST Service Interface

Create and Configure ESREST

Generate Clients

Run the WPF Client

Tutorial: CORS Service Interface

Create and Configure ESCORS

Reconfigure and Redeploy the Service Interface

Send an AJAX Request

Resend an AJAX Request

Tutorial: Data File Editor

Import and Build the Sample Project

Start Data File Tools

View the Data File Unformatted

Create a Record Layout

View the Data File Formatted

Filter the Data File

Edit a Record

Create a New Data File

Create a New Record

Insert a Record

Delete a Record

Tutorial: Classic Data File Tools

Copy and Build the Visual Studio Solution

Convert a File

View a Data File Unformatted

Create a Record Layout File

Create the Default Record Layout

Create the Conditional Record Layouts

Save the Record Layout File

View a Data File Formatted

Access Information about a Record Layout File

View Files in Hexadecimal

Print a Data File

Edit Multiple Data Files

Create a New Data File

Convert a File's Character Set

View the EBCDIC File

Managed COBOL Tutorials

Tutorial: Developing .NET COBOL

Tutorial: Creating Windows Forms in COBOL

Tutorial: Developing Web Application Projects

Tutorial: Creating Web Forms in COBOL

Tutorial: Creating and Accessing WCF COBOL Services

Tutorial: Publishing Hello COBOL World to the Cloud

Tutorials: OpenESQL Managed Code

Tutorial: WCF COBOL Service using SQL

Tutorial: Object-Oriented WCF COBOL Service using SQL

Tutorial: Web Application using SQL

Tutorial: Object-Oriented Web Application using SQL

Tutorials: OpenESQL Assistant

Tutorial: Create a SQL Server Database

Tutorial: Create and Configure a Visual Studio Project

Tutorial: Set OpenESQL Assistant Configuration Options

Tutorial: Catalog a Connection

Tutorial: Build and Test a Query

Tutorial: Generate and Embed an SQL Program

Tutorial: Provide Additional Code

Tutorial: Build and Debug the Application

Tutorials: SQL Server COBOL Stored Procedures

Tutorial: Enable SQL CLR Integration

Tutorial: Create a Sample Database

Tutorial: Create and Configure a Database Project

Tutorial: Create, Run, and Call a SQL CLR Stored Procedure

Tutorial: Debug a SQL CLR Stored Procedure in a Development Environment

Tutorial: Generate a COBOL Wrapper for a SQL CLR Stored Procedure

Procedural COBOL Compared with Managed COBOL

Moving Existing Native COBOL Applications to Visual COBOL

Technology Preview Features

Samples Browser

To start the Samples Browser

To build the Samples Browser demonstration

Demonstrations of .NET COBOL

Demonstrations of Native COBOL

Product Information

Installation

Before Installing

Downloading the Product

System Requirements

Hardware Requirements

Operating Systems Supported

Software Requirements

Additional Software Requirements

Product Co-Existence

Installation Restrictions and Requirements

Basic Installation

Installing

Advanced Installation Tasks

Installing as an Upgrade

Visual COBOL Installation Options

Installing from a Server

Windows Compatibility Mode

Installing on Microsoft Terminal Server and Citrix

Customizing the Installation and the Projects

Enterprise Server Installation Options

Configuring SQL Option for DB2 (XDB) for Multi-User Environments

Creating a Private XDB Configuration File in a Multi-User Environment

Changing the Main XDB Server Configuration File

Changing the Private XDB Server Configuration Files in Batch

Configuring Other Components

After Installing

Starting the Product

Viewing the Product Help

Repairing

Uninstalling

Managing Licenses

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 central 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

Installing License Manager

Installing a local license server

Installing a standalone network license server

Installing on Windows

Standard installation

Silent installation

Installing License Manager without Sentinel RMS

Standard installation

Silent installation

Setting up network licensing with COBOL server

Trial licenses

Commuter licenses

To obtain a commuter license

To return a commuter license

Usage log

Updates and Product Support

Micro Focus End User License Agreement

Backward Compatibility with Earlier Micro Focus Products

Backward Compatibility with Previous Versions of Visual Studio

Known Issues and Restrictions

Calling COBOL Programs from C

COBOL Programming

Boolean Data Items

CBL2XML Utility

Interface Mapping Toolkit

Enhanced ACCEPT/DISPLAY Syntax (Adis)

Filenames

IDXFORMAT 8 and 12 File Size Limits

Unsupported Features

XML Extensions

Compatibility

Coexisting with earlier Micro Focus products

Installation

Data Access

Classic Data File Tools

Records with Alternate Keys

Documentation

Application Server JCA Support

.NET Code

ASP.NET

Compiler

File Handler

Language Service and IntelliSense

OpenESQL

Remote Debugging

Security

Web Reference Generation

XML Extensions

Problem Determination and Diagnostic Tools

Debugging

Error markers

Test Coverage

Visual Studio IDE

Background Syntax Checking

Building Applications

Code Analysis

Dialog System

Examples and Demonstrations

Expanded Copybook View

Find All References

Fonts and Colors Dialog Box

Importing Net Express Projects

IntelliSense Support for COBOL

Language Service

Licensing

Micro Focus Unit Testing Framework

Visual Studio Help Viewer

Visual Studio Team System

Windows Communication Foundation (WCF)

Contacting Micro Focus

Further Information and Product Support

Information We Need

Contact information

The Micro Focus Community

Help on Help

Developing Applications in the IDE

Creating Applications Using Visual COBOL for Visual Studio

Using Visual Studio for COBOL Development

Introduction to COBOL Development in Visual Studio

Differences between Visual COBOL and Earlier Micro Focus Products

Overview of the Differences

Tips: Visual Studio IDE Equivalents to IDE Features in Net Express

Tips and Tricks with the IDE

To start Visual COBOL

To start Visual COBOL as an administrator

To start a Visual COBOL command prompt

To start a Visual COBOL command prompt as an administrator

Making the Most of The COBOL Editor

COBOL Toolbar

Using IntelliSense to Write COBOL Code Efficiently

Configuring the Editor

Configuring IntelliSense for COBOL - Completion

Configuring IntelliSense for COBOL - Insertion

Configuring the COBOL Margins

Configuring the Indentation

Configuring the Ruler

Configuring Word Wrap with Smart Edit Mode

Customizing the Behavior of Home and End Keys

Customizing the Text Fonts and Colors

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

Inserting Code Snippets

To insert a snippet in your code

Shortcuts for the COBOL Snippets

To create a custom COBOL snippet

Using Quick Actions (Light Bulbs) in COBOL

Overriding the Members of an Inherited Class

Tips on Building COBOL

Tips on Debugging COBOL

Creating COBOL Solutions and Projects

Types of COBOL Project Templates

Converting Additional Directives to Project Properties

To add files to a COBOL project

To add a folder to the project's Copybook Paths

Creating Copybooks from Selected Lines of Code

To associate file extensions with COBOL

To specify that a file extension is a copybook

Grouping Files in Solution Explorer

To toggle Virtual View

To create a custom virtual folder

To add files to a new virtual folder

To modify a virtual folder

To delete a virtual folder

Editing COBOL Projects with Different Versions of Visual Studio (Project Round-Tripping)

Tips and Tricks on Editing COBOL

Making the Most of The COBOL Editor

Using IntelliSense to Write COBOL Code Efficiently

Inserting Code Snippets

To insert a snippet in your code

Shortcuts for the COBOL Snippets

To create a custom COBOL snippet

Configuring the Editor

Configuring IntelliSense for COBOL - Completion

Configuring IntelliSense for COBOL - Insertion

Configuring the COBOL Margins

Configuring the Indentation

Configuring the Ruler

Configuring Word Wrap with Smart Edit Mode

Customizing the Behavior of Home and End Keys

Customizing the Text Fonts and Colors

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

Overriding the Members of an Inherited Class

Using Quick Actions (Light Bulbs) in COBOL

Exploring Your COBOL Projects and Solutions

Solution Explorer

Project Details Window

Object Browser

Configuring the IDE, the Project and File Properties

Overview of COBOL Project Properties

Configuring Visual Studio

AutoCorrect

Build Directives for Standalone Editing

COBOL Debugging Options

Code Coverage - Report Generation Options

Code Coverage - Results Options

Customizing the BMS Editor in the IDE

BMS Text Editor General Page

BMS Editor Margins Options

BMS Editor Scroll Bars

BMS Text Editor Tab Page

Data File Tools

Configuring IntelliSense for COBOL - Completion

Configuring IntelliSense for COBOL - Insertion

Enterprise Server Configuration Options

Indentation

Line Numbering Options

General Directives for Standalone Editing

General Product Options

Options for Setting Compiler Directives on Files

Text Editor Advanced Options

Text Editor Formatting Options

Text Editor General Options

General Project Options

Program Symbols

Profiler - Report Generation Options

Scroll Bars

Text Editor Tabs Options

Text Editor Margins Options

Quick Actions

Project Properties

Application Properties for .NET Managed COBOL

Application properties for native COBOL

Preprocessor Properties

SQL Properties

To set COBOL project properties

To specify file properties

To reset the file properties

To configure how the IDE determines the Compiler directives of files

To automatically determine and set directives on COBOL files

To add references to a managed project

Expanded Copybook View

Creating Projects from Existing Code

Converting Net Express Projects to Visual Studio Projects

To import a Net Express project into the Visual Studio IDE

Restrictions and Limitations to Converting Net Express Projects

Create Projects from Existing Code Wizard

To create a COBOL project from existing code

Creating a New Project From Files in an Existing Project

To create a new COBOL project from selected files in an existing project

Creating Projects from Standalone Files

Creating and Distributing Custom COBOL Project Templates

Building COBOL applications

Tips on Building COBOL

Build Configuration

Compiling COBOL Applications

Compiling COBOL code

Compiled File Types

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 a Response to a Prompt

Setting Compiler Directives in Source Code

Setting Compiler Directives in a Directives File

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 Native COBOL Code

Overview of Linking Native COBOL Applications and Run-time Systems

Shared Run-time System for Running Native COBOL Applications

Dynamically Binding Run-time Systems to Your Native COBOL Applications

Order of Program Loading and Run-time System Usage for Native COBOL

Loading a Dynamic Link Library Built as Native COBOL Code

Application Performance with Dynamic Binding for Native COBOL

To build a COBOL project

To embed resources in a native COBOL application

To add an application configuration file

To add a resource script file to your native COBOL project

To edit a resource-definition script file for a native COBOL project

To set an entry point for a native COBOL project

To set Compiler directives on a COBOL file

To compile individual files

To link a native COBOL project to the run-time system

Code Analysis

Micro Focus Code Analysis Window

Rule-Based Analysis

Performing Code Analysis when Building a Project

Performing Code Analysis Manually

Performing Code Analysis from the Command Line

Performing Code Analysis as Part of a CI Process

Configuring Rule Sets

Importing Rule Sets in the IDE

Importing Code Analysis Reports

COBOL Source Information

Introduction

To run a CSI query

Unreferenced Data

Undeclared Procedures

Copybook Structure

Program Statistics

Unexecuted Procedures

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

Code Refactoring

Rename Refactoring

Creating Copybooks from Selected Lines of Code

Refactoring Using Quick Actions

Debugging COBOL Applications

Overview of Debugging Applications

Debugging Features and Techniques in Visual Studio

Tips on Debugging COBOL

Debugging Scenarios in Native COBOL

Just-In-Time Debugging

Overview - Just-In-Time Debugging and Native COBOL

To enable just-in-time debugging for when the application fails for Native COBOL

Troubleshooting - Just-In-Time Debugging and Native COBOL

Debugging Using a Core Dump

core_on_error

core_filename

Remote Debugging of Native COBOL Applications

To set up remote debugging for native COBOL applications

To debug a native COBOL program running remotely

cobdebugremote

cobdebugremote64

Troubleshooting - Communications Issues when Debugging Native COBOL

Debugging Native COBOL Link Libraries

Wait for Debuggable Attachment and Native COBOL

Break on Data Change

How To

To configure the symbol path for native COBOL applications

To set a COBOL watchpoint in native COBOL code

Using program breakpoints in native COBOL

To attach to a native running process and debug

To debug standalone files

To debug a native COBOL project that compiles to multiple executables

Debugging Multi-Project Solutions

Debugging Scenarios in .NET COBOL

Displaying Debug Information for Managed COBOL

Debugging Applications and Services on Enterprise Server

How Debugging on Enterprise Server Works

To prepare for debugging on Enterprise Server

Configuring an Enterprise Server to Produce a Core Dump

To debug on Enterprise Server

Debugging using a temporary enterprise server

Error Messages for Web Services

Running Applications (Native COBOL)

Configuring the Run-time Behavior for Native Applications

Application Configuration File

Run-time Configuration for Intermediate and Generated Code

To configure the run-time behavior for native applications

Code Coverage (Native COBOL)

Enabling Code Coverage

Running an Application with Code Coverage

Viewing the Code Coverage Information

Code Coverage HTML Reports

Configuring the Code Coverage HTML Reports

Code Coverage - Report Generation Options

Code Coverage - Results Options

Code Coverage and Profiling (.NET COBOL)

Developing COBOL Applications for Microsoft Azure

Introduction to COBOL on Microsoft Azure

Microsoft Azure System Requirements and Levels of Support

Tutorial: Publishing Hello COBOL World to the Cloud

Demonstration Programs for COBOL on Microsoft Azure

Preparing a COBOL Application for Microsoft Azure

Cloud Template and Skeleton Roles and Projects

Copying Data to Microsoft Azure

How to Create and Publish a COBOL Service for Microsoft Azure

To Create a COBOL Microsoft Azure Service and Roles

To Develop a COBOL Azure Service

To Configure a Service and Storage for Microsoft Azure

To transfer files to the Azure storage

To Debug a COBOL Microsoft Azure Service Locally

To Publish a COBOL Service to Microsoft Azure

To Run Visual Studio as Administrator

Using the Consolidated Tracing Facility on Microsoft Azure

Specifying Microsoft Azure-specific Emitters

BINSTORAGE Emitter Properties

TEXTSTORAGE Emitter Properties

Updating Microsoft Azure Role Configuration Files

Adding References to Tracing-related .dll Files

Downloading Trace Information

Viewing Trace Information

Microsoft Information on Microsoft Azure and the Cloud

Using Enterprise Server from within the IDE

Specifying IDE Configuration Options for Enterprise Server

Enterprise Server Templates

Using Server Explorer with Enterprise Server

To access Enterprise Server Administration

To view the available servers

To export an enterprise server instance

To import an enterprise server

To connect to a remote enterprise server

To create a new enterprise server

To delete an enterprise server

To display an enterprise server log inside the IDE

To refresh the list of the available servers

To set a run-time environment variable

To show the JCL catalog

To show the JCL spool queues

To start, stop, or restart an enterprise server from the IDE

Using Solution Explorer with Enterprise Server

To show the catalog

To copy a catalog entry for a data set

To create a catalog entry for a data set

To delete a catalog entry for a data set

To update a catalog entry for a data set

To view the contents of a data set

To view the details of a catalog entry

To show the spool

To delete a job

To delete all jobs in a queue

To hold or release a job

To update control information for a job

To view details of a job output file

To view details of a job's execution

To view the step condition codes for a job

To view the contents of a job output file

To create a new enterprise server

Programming

COBOL Programming

Getting Started with COBOL

Calling COBOL Programs

Specifying the Program to Be Called

Naming a Program in its PROGRAM-ID Paragraph

Entry Point Mapping for COBOL Programs

.NET Entry Point Mapping

Calling programs from .NET COBOL projects

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

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

Compiling and Deploying a Message File

Unicode Support

UTF-16 Byte Ordering

National Literals

National Hexadecimal Literals

National Data Items

Preparing Applications for Enterprise Server

The Application Container

Short-running Requests

Long-running Requests

Resource Management

Application-managed Services

Container-managed Services

Restrictions on the COBOL application

User Interaction for COBOL Program Services

Run-time Errors and Completion

Object-oriented COBOL

Interface Mapping Toolkit (IMTK)

Managing IMTK Projects

Defining Service Interfaces

Interface Mapper

Operations

Deploying Service Interfaces

Deployment Configuration Requirements

Service Interface Deployment Methods

Deploying Java Service Interfaces

Deploying to 64-bit Platforms

Deploying to an Enterprise Server under UNIX

Service Interface Deployment Package

Clients

How to

Manage IMTK Projects

To create a project for COBOL program-based service interfaces

To create a COBOL program-based service interface

To import a COBOL program service interface

To modify the CLASSPATH property for an EJB service interface

To update service interfaces with source code changes

To set client generation options

To validate a service interface

Define Service Interfaces

To assign a value to a COBOL field

To create a COBOL program-based operation

To create a reusable field

To create an interface field

To edit field properties

To group interface or reusable fields

To map an interface field

To start the Interface Mapper

Deploy Service Interfaces to Enterprise Server

To add or remove application files to deploy

To associate an enterprise server with a project

To compile a service driver program on a remote UNIX machine

To generate and deploy a service interface from a project

To deploy to a remote enterprise server

To deploy a service interface using imtkmake

To generate clients

To build an ASP.NET client

To install a deployment package using mfdepinst

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

Add/Remove Items

Options - Service Interface

Properties - COBOL Program Service Interfaces

Interface Mapper

Operation Properties - General tab

Operation Properties - User Exits tab

Operation Reorder

Mixed Language Programming with Native COBOL

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 Windows API Routines

Interfacing with C Programs

Passing Data between C and COBOL

Header-to-COPY Utility

Overview

H2cpy command-line options

Converting Header Files Using the H2cpy Utility

H2cpy Translations

Translating Names

Using the Headers Preprocessor

Translating Directives

Preprocessor Directives

Expanding Macros and Creating String Literals

Translating Conditional Directives

Translating Other Directives

Translating Statements

External Data Declarations

Example - Translating External Data Declarations

Type Definitions

Example - Translating Type Definitions

Structure, Union and Enumerator Declarations

Example - Translating Named Declarations

Example - Translating Unnamed Declarations

Example - Translating Enumerator Declarations

Function Prototype Declarations

Example - Translating Function Prototype Declarations

Example - Translating C Calling Conventions

Call Parameters

Example 1 - Parameter Passing in C and in COBOL

Example 2 - Parameter Passing in C and in COBOL

H2cpy Limitations

Overview - H2cpy Messages

Warning Messages

* Warning, other return already defined for: name

* Warning, float has been evaluated as zero

* Warning, expression buffer overflow - ignored

* Warning, macro too long, ignored: name

* Warning, macro has too many parameters

* Warning, macro parameters too long - ignored

* Warning, neither whitespace nor ( after #define. Ignoring the line.

*Warning, redefinition ignored for #define

* Warning, struct/union 4 bytes (or 8) and passed by value cannot be directly accessed from COBOL

Error Messages - Command Line Errors

Error, command line too long

Error, no input C header file given

Error, too many input filenames

Error, macro name already defined

Error, exceeded max number of include directories, max=14

Error, unknown C type: name

Error, no C type alignment value

Error, no C type size value

Error, no call convention value provided

Error, unknown environment (not 16 or 32)

Error, unknown option - flag

Error Messages - Invalid C Source

Error, type expected, found name: name

Error, type expected

Error, typedef found at inner level; check brackets

Unexpected token token

Error, type expected

Error, type expected, found name

Error, no unique typedef name!

Error, already declared this name

Error, undeclared enum name

Error, already defined name: name

Error, already defined struct/union as: name

Error, other params already defined for : name

Error, declaration buffer overflow

Error, no unique declarator name!

Error, no unique parameter name!

Error, invalid C code (missing token)

Error, too many digits for 4 bytes in name

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 Calling a Win32 API Routine

Example of Posting a Signal Handler

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

Design the COBOL data structure and program logic

Typical development process example

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 TEST WELLFORMED FILE

XML TEST WELLFORMED TEXT

Document management statements

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 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 definitions and 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

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

Embedded HTML

EHTML Preprocessor Directives

Deploying a CGI Application with Embedded HTML

Debugging a CGI Application

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$MEMCPY (Dynamic Memory Routine)

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 CLOSE WINDOW Statement

Windowing Supplementary Information

Windowing Restrictions

Windowing Error Messages

Compatibility with DG Interactive COBOL

DG Interactive COBOL Source Programs

Compatibility Directives

Compatibility with DG Interactive COBOL

Overview

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 Visual Studio

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

File Status Codes

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

RM/COBOL File Handling

Configuring Access to RM/COBOL Indexed Data Files

File Limits

RM/COBOL File Status Codes

Debugging .NET 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

RM/Panels

Restrictions and Limitations

Converting RM/Panels Applications

Conversion Example: Using Visual Studio

Creating a Visual Studio Project for the RM/Panels Application

Set the DIALECT RM Compiler Directive for the Project

Download the Tutorial Files

Import the RM/Panels Source Code

Configure Adis Support for RM/Panels

Configure the Supported Copybook Extensions

Build and Run the Application

Writing Programs

Standard Runtime Function Basics

Setting Runtime Parameters

Executing Standard Runtime

Required Copy Files

Error Detection

Screen Handling

Individual Field Method

Entire Screen Method

Event Loop Method

Using Multiple Panels

Standard Runtime Functions

DISABLE FIELD FOR INPUT

ENABLE FIELD FOR INPUT

ENABLE MENU OPTION

EXECUTE EVENT

INITIALIZE ALL FIELDS

Utility Functions

DELETE TEMPORARY FILE

END MODELESS OPERATION

START MODELESS OPERATION

START POLLING

Appendix A: Master Copy File RMPANELS.WS

Contents of RMPANELS WS

RMPANELS WS Field Definitions

Appendix B Standard Utility, and Extended Runtime Functions and Parameters

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

User Interface Programming

Modernizing Dialog System Applications

Overview of Modernizing Dialog System Applications

Dialog System information and restrictions

Migrating a Dialog System Application to Visual COBOL

Enabling Microsoft's Visual Styles in Dialog System Applications

Changes to Existing Dialog System Applications that Use the Visual Styles

Modernizing a Dialog System Application

Samples of Modernizing Dialog System Applications

Sample: Windows Forms Replacing Dialog System Dialogs

Sample: Windows Forms Control as ActiveX for a Dialog System Application

Sample: WPF User Control in a Dialog System Application

Sample: Managed Dialog System Application

Sample: Managed Application and Windows Forms

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

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

Specifying an ESQL Preprocessor and Compiler Directive Options

Compiling SQL Applications

Compiling Multiple Program Modules

Creating Debug Files

OpenESQL

OpenESQL Preprocessor Options

Setting the OpenESQL Preprocessor and Compiler Directive Options

SQL Code Generation Options

Scope - OpenESQL SQL Compiler Directive Options

OpenESQL DBMAN Use Case Scenarios

OpenESQL Datetime Data Type Handling

OpenESQL Fixed-length Character Strings Handling

SQL Syntax Checking with OpenESQL

SQL(CHECK) and Schema Objects

SQL(CHECK) Command-line Options

SQL Statement Prefixes for SQL(CHECK)

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

Setting OpenESQL Background Syntax Checking Options

Programming for OpenESQL

OpenESQL Assistant

Setting OpenESQL Assistant Options

Using OpenESQL Assistant

Starting the OpenESQL Assistant

Connecting to a data source

Building Queries

Generating initial query code

Selecting Columns

Specifying Aggregate Functions for Columns

Specifying Search Criteria

Specifying the Order in which Data is Retrieved

Creating a Table Join

Working with Queries

Display Column Details

Disconnect from a Data Source

Close a Query

Remove a Table from a SELECT Query

Changing a SELECT (cursor) query to do an Array FETCH

Testing Your SQL Queries

Embedding SQL into a program

Auxiliary Code

Generating EXEC SQL Auxiliary Code

Embedding Auxiliary Code

Generating EXEC ADO Auxiliary Code

Generated EXEC ADO Statements

Disconnected Model Statements

Connected Model Statements

EXEC ADO Wizards

Stored Procedures

Generating a TSQL Stored Procedure Query

Testing a TSQL Stored Procedure Query

Embedding a TSQL Stored Procedure into a Program

Generating a SQL CLR Stored Procedure Query

Testing a SQL CLR Stored Procedure Query

Working With OpenESQL Cursors and Result Sets

Working with Stored Procedures and Result Sets

Unicode Support in OpenESQL

OpenESQL Globalization Best Practices

Keywords

Compiling Azure Applications

ODBC

Demonstration Applications

ODBC Drivers and Data Source Names

To start the ODBC Data Source Administrator

Using OpenESQL with ODBC

Managing Transactions

Positioned Update

XML Support

Using OpenESQL with Web and Application Servers

Thread Safety

Connection Management

Transactions

User Accounts, Schemas and Authentication

Transaction Wrapper Sample

ADO.NET

Demonstration Applications

ADO.NET Data Providers and Data Sources

ADO.NET Connection Editor

Connection Terminology

Cataloging an ADO.NET or ODBC Connection

Exporting and Importing Connections

Example Connection Settings

SqlClient Data Provider

DB2 ADO.NET

ADO.NET Connection Strings

Using OpenESQL with ADO.NET

Using Embedded EXEC ADO Statements

Disconnected Model Statements

Connected Model Statements

ADO.NET Cursor Statements

Sharing ADO.NET Objects Statements

.NET Host Variables in Managed Code

Disconnected and Offline DataSets

Compiling Native Applications as Managed Code

Migrating Pro*COBOL Applications to OpenESQL with ADO.NET

Stored Procedures with ADO.NET

XML Support

SQL Server COBOL Stored Procedures

Prerequisites for SQL CLR Integration

SQL CLR Integration Process

SQL Server Database Project Template

Working with Multiple COBOL Managed Projects

Data Type Parameters in COBOL and SQL CLR Stored Procedures

Stored Procedure Definition (SPD) File

COBOL Wrapper Programs

Transaction Support for SQL CLR Stored Procedures

Issuing COBOL Calls from within SQL CLR Stored Procedures

Optimizing Read-only Cursor Performance for SQL CLR stored procedures

Working with SQL CLR Stored Procedures on a Remote SQL Server Machine

Post-deployment Script Requirements

COBOL Program Migration Support

DB2

Demonstration Applications

DB2 External Compiler Module

Compound SQL

User Defined Functions

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

Setting DB2 Background Syntax Checking Options

Connecting to a DB2 Database

DB2 Compiler Directive

Error Codes

Binding

Linking

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

Setting the COBSQL Preprocessor and Compiler Directive Options

Building COBSQL Applications

Using the CP Preprocessor to Expand Copybooks

National Locale Support (NLS)

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)

OpenESQL Assistant

To add a column to a query

To add all columns in a table to a query

To add an XML data source

To add or update a SQL CLR Stored Procedure

To change a SELECT (cursor) query to do an array FETCH

To close a query

To close the OpenESQL Assistant

To connect to a data source

To connect to a different data source

To create a table join

To create an SQL query

To create a SQL CLR stored procedure query

To create a TSQL stored procedure query

To disconnect from a data source

To display column details

To embed an SQL query into a program

To generate a DCLGEN copybook

To generate a DELETE statement

To generate a SELECT (cursor) statement

To generate a SELECT (singleton) statement

To generate a SELECT DISTINCT (cursor) statement

To generate a SELECT DISTINCT (singleton) statement

To generate a DECLARE DATATABLE statement

To generate an INSERT statement

To generate an UPDATE statement

To generate and embed auxiliary code

To perform an aggregate function

To refresh the list of data sources

To remove a table from a SELECT query

To run a query

To set OpenESQL Assistant options

To sort returned data (an ORDER BY clause)

To specify search criteria (a WHERE clause)

To start the OpenESQL Assistant

To view data source properties

ADO.NET Connection Editor

To add a connection

To export connections

To import connections

To remove a connection

To start the ADO.NET Connection Editor as an administrator

To start the ADO.NET Connection Editor as a user

To test a connection

SQL Server COBOL Stored Procedures

To create a SQL Server database project

To add a project reference to a .Publish project

To create a SQL CLR stored procedure query

To generate a SQL CLR stored procedure

To add or update a SQL CLR Stored Procedure

To create a stored procedure definition (SPD) file

To add a post-deployment script

To set project properties to build verifiable code

To generate a COBOL wrapper for a SQL CLR stored procedure

Reference

OpenESQL

Embedded SQL Statements

BEGIN DECLARE SECTION

QUERY ODBC

QUERY ODBC - Column Query

QUERY ODBC - Data Type Query

QUERY ODBC - Table Query

RESET CONNECTION

ROLLBACK

SAVEPOINT

SELECT DISTINCT (using DECLARE CURSOR)

SET TRANSACTION ISOLATION

Embedded ADO Statements

SQL Compiler Directive Options

BEHAVIOR

Primitive Directives

DBMAN Directive Settings

SQL/COBOL Data Type Mappings

OpenESQL Date and Time Environment Variables

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.

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.

COBES0129 Unrecognized SQLDA in SQL statement - try compiling with SQL(USER-SQLDA=option) directive

COBES0130 Host variable host-var.group-var is part of a group variable expansion that is not supported in this type of SQL statement.

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.

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

MFImportConn command

User Interface Reference

OpenESQL Assistant

OpenESQL Assistant - Options

OpenESQL Assistant - Main Window

Select Type of Query to Create dialog box

Literal Value dialog box

Sort tab

Auxiliary Code tab

Data Source Properties dialog box

ADO.NET Connection Editor

ADO.NET Connection Editor - Main Window

Settings Menu

Add an ADO.NET Connection wizard - start page

Name Your Connection page

.NET Data Providers page

OLE DB Data Providers page

ODBC System DSNs page

Provider Connection Details page

Add ADO.NET Connection Finished page

Export ADO.NET Connections - start page

Select Connections to Export page

Specify an Export File page

Export Connections Wizard Finished page

Import ADO.NET Connections - start page

Select a File to Import page

Select Connections to Import page

Import Connections Wizard Finished page

DB2

DB2 Compiler Directive Options

CONCURRENTACCESSRESOLUTION

DB2 Environment Variables

HCOBND environment variable (deprecated)

SQLPASS.TXT environment variable (deprecated)

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

END-COBSQL, END-C, END

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

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 Data Type

Numeric Data Types

Approximate Numeric Data Types

Exact Numeric Data Types

Unicode Numeric Data Types

Binary Data Types

Fixed-length Binary Strings

Variable-length Binary Strings

Large Binary Strings (BLOB)

Date and Time Data Types

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 Type

DBCLOB-FILE Data Type

Miscellaneous Data Types

SQL TYPEs

TIMESTAMP-OFFSET-RECORD

VARBINARY

XML

Data Structures

The SQLCA Data Structure

The SQLDA Data Structure

Keywords

Data Files

Data File Tools

Data File Editor

Current Restrictions

Accessing Data File Editor

Launching Data File Editor from a Command Line Prompt

Launching Data File Editor from the Start Menu

Preferences

Set the Editor Preferences

Using the Data File Editor

Creating Data Files

Create a Non-indexed Data File

Create an Indexed Data File

Editing Data Files

Working with Data Sets in Enterprise Server

Opening a Data Set in Enterprise Server

Enterprise Server Error Messages

Insert a Record

Edit an Unformatted Record

Edit a Formatted Record

Layout and Field Validation

Fix Validation Warnings

Edit a Record Using Hexadecimal Values

Delete a record

Profile Files

Viewing and Filtering Data Files

View File Information

Filtering a Data File

Filter the Data File

Filter 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 Classic Record Layout Editor

Create a Structure File and Record Layouts

File Conversion Utilities

DFCONV Batch File Conversion

Operation

Command Line Batch Interface

The DFCONV call batch interface

Using the Data File Converter

File Format and Data Conversion

EBCDIC to ANSI Conversion

Mainframe to PC Print Conversion

Indexed File Reorganization

Defining File Conversion with a Profile File

Specifying the Conversion Operation

Specifying the Input File Parameters

Output File Specifications

General Conversion Information

Data File Converter Error Messages

Data File Structure Command Line Utility

DFSTRCL Prerequisites and Restrictions

DFSTRCL Inputs

DFSTRCL Command Line Syntax

DFSTRCL Examples

Example 1

Example 2

Example 3

Classic Data File Tools

Configuring Classic Data File Tools

Data File Converter

Input File Specifications

Output File Specifications

Character Set Conversion

Record Layout Editor

Data File Editor

Configuring the Data File Editor

Creating Data Files

Data File Types

Data File Profiles

Key Definitions for Indexed Files

Opening a Data File

Loading and Saving Data Files

Determining File Organization

Determining Record Lengths

Applying Record Layouts

Navigating Data Files

Searching a Data File

Creating and Editing Data

Editing Data

Cutting, Copying, and Pasting Data

Adding Records

Deleting Records

Changing the Key in an Indexed File

Initializing Data Records and Fields

Printing from a Data File

How to

To start the Classic Data File Tools IDE

To set Classic Data File Tools options

Data File Converter

To convert a data file

To define or change file details

To define record keys for an indexed data file

To apply a record layout to a file conversion

Record Layout Editor

To create a debug information (.idy) file for layout file input

To start the Record Layout Editor

To create a new record layout file

To load program information

To define record layouts

To define or edit a condition for a conditional layout

To edit an existing record layout file

To view layout information in the Layout Editor window

Data File Editor

To configure edit warnings

To create a data file

To define record keys for an indexed data file

To open a data file

To apply record layouts to a data file

To associate a record layout file with a data file

To view information

To select an alternate key

To search within a data file

To initialize a record

To initialize a field

To insert records

To cut, copy, and paste data

To undo a record edit

To append an ESDS record

To change a record length

To delete records

To print from a data file

To preview a data file

Reference

File Formats and Organizations

The Classic Data File Tools Command Line Utility

Using the Data File Editor Command Line Utility

Using the IMS Database Editor Command Line Utility

Command Line Examples

User Interface Reference

Data Tools Options dialog box

Data File Converter

Data File Convert dialog box

File Details dialog box

Key Information dialog box

Select Layout for Conversion dialog box

Record Layout Editor

Record Layout Editor window

New Record Layout wizard

Field Properties dialog box

Data File Editor

Data File Editor window

File Information dialog box

Create file dialog box

Key Information dialog box

Data File Editor dialog box

Print and Preview dialog boxes

Data File Find And Replace dialog box

Find on Current Key dialog box

Goto dialog box

Locate Field dialog box

Set record length dialog box

Rebuild

Redirection of Information

Command Line

Option Files

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

To install a CCSID table

Database Connectors for Visual COBOL

Database Connectors User's Guide

Database Connectors Overview

Relational Database Management Systems Support

Accessing Data

Database Concepts

How Database Connectors Works

What Is a Transparent Interface?

XFDs and Mapping

Summary

Getting Started

Licensing

The Demonstration Program

XFDs

XFD Files

How XFDs are Formed

Defaults Used in XFD Files

KEY IS Phrase

REDEFINES Clause

Summary of XFD Fields

Identical Field Names

Long Field Names

Naming the XFD File

Forming the Final XFD Name

Mapping Other Files to an XFD

Using XFD Directives

Line Continuation for Complex XFDs

XFD Directive Syntax

Supported XFD Directives

Invalid Data

Illegal COBOL Data

Invalid Key Data

Invalid Data Other Than Keys

Invalid Database Data

Working with COBOL

Examples of Preparing and Compiling a Program

Example 1 - Compiling with just the CREATEXFD directive

Example 2 - Compiling with the WHEN XFD Directive

Example 3 - Using Additional XFD Directives

New and Existing Databases

Default Behavior

Accessing Existing Database Files

How Do I Match Existing Text Fields?

How Do I Match Existing Numeric Fields?

Field Names

Resolving Name Conflicts

File Handling Configuration

Configuring the File Handler

Run Time System Configuration

ACUFH Configuration Variables

Database Connectors for DB2

DB2 Concepts Overview

Transactions

Record-locking Issues in Transactions

Database Connectors and Record Locking

Client Configuration

Setting Up the User Environment

Designating the Host Data Source

Configuring the File Handler

Filename Translation

Decimal Points

ACUFH Configuration File Variables for DB2

Record and Table Locking

Limits and Ranges

Data Type Mapping

Run-Time System Errors

Common Questions and Answers

Database Connectors for Oracle

Oracle Concepts Overview

Transactions

Record Locking Issues in Transactions

Database Connectors and Record Locking

The open_cursors Parameter

Table Ownership

Security

Client Configuration

Oracle's Instant Client

Checking System Parameters

Setting Up a User Account

Setting Up the User Environment

Configuring the File Handler

Setting Up the Search Path

Handling Transactions

Filename Translation

ACUFH Configuration File Variables for Oracle

Using the Database Table

Unsupported Features

Limits and Ranges

Data Type Mapping

Run-Time System Errors

Common Questions and Answers

Database Connectors for Microsoft SQL Server

Microsoft SQL Server Concepts Overview

Client Configuration

Installing the Server and Client Machine

Setting Up a User Login

Setting Up the User Environment

Configuring the File Handler for

Filename Translation

ACUFH Configuration File Variables for MSSQL

Using the Database Table

Table Locking

Stored Procedures

Developer- or Site-supplied Stored Procedures

Built-in Stored Procedures

Limits and Ranges

Supported Data Types for SQL Server

Run-Time System Errors

Common Questions and Answers

Performance and Troubleshooting

Performance Issues

Guidelines

Guideline 1 - Database Administrator

Guideline 2 - Understand COBOL Operations and Database Operations

Guideline 3 - Program and Database Interaction

Guideline 4 - Plan for Growth

The WHERE Constraint

Troubleshooting

Setting External Variables

Compiler Errors

Run-Time System Errors

Using the FILE_TRACE ACUFH Configuration Variable

Questions and Answers

Database Connectors Tasks

To Configure a Login

To create an error map

To enable tracing for Database Connectors connections

To install Database Connectors for Microsoft SQL Server

To prepare your program for execution using Database Connectors

To set the system parameters

To Set Up a Service Name for an Oracle Database

To Set Up The DB2 User Environment

To compile and run the demo program

To Test the Installation of Oracle's Instant Client

To use the WHERE constraint from COBOL

Database Connectors Reference

Configuration Variables

4GL_2000_CUTOFF configuration variable

4GL_8_DIGIT_CUTOFF configuration variable

4GL_COLUMN_CASE configuration variable

4GL_COMMIT_COUNT configuration variable

4GL_CONVERT_DATE_ZERO configuration variable

4GL_DB_MAP configuration variable

4GL_EXTRA_DB_COLS_OK configuration variable

4GL_FULL_DATA_TEST configuration variable

4GL_IGNORED_SUFFIX_LIST configuration variable

4GL_ILLEGAL_DATA configuration variable

4GL_JULIAN_BASE_DATE configuration variable

4GL_USEDIR_LEVEL configuration variable

4GL_WHERE_CONSTRAINT configuration variable

A_DB2_ALTERNATE_COMMIT_LOGIC configuration variable

A_DB2_CATALOG configuration variable

A_DB2_DATASOURCE configuration variable

A_DB2_ERROR_MAP_FILE configuration variable

A_DB2_ISOLATION_LEVEL configuration variable

A_DB2_LOCK_METHOD configuration variable

A_DB2_LOGIN configuration variable

A_DB2_PASSWD configuration variable

A_DB2_STRICT_EQUAL configuration variable

A_DB2_TABLE_TYPES configuration variable

A_DB2_USE_CATALOG configuration variable

A_DB2_USE_CHAR_FOR_BINARY configuration variable

A_DB2_USE_SQLCOLUMNS configuration variable

A_DB2_USE_SQLTABLES configuration variable

A_MSSQL_ADD_IDENTITY configuration variable

A_MSSQL_ADD_TIMESTAMP configuration variable

A_MSSQL_APPROLE_NAME configuration variable

A_MSSQL_APPROLE_PASSWD configuration variable

A_MSSQL_CURSOR_OPTION_1,2,3 configuration variables

A_MSSQL_DATABASE configuration variable

A_MSSQL_DEADLOCK_LOOPS configuration variable

A_MSSQL_DEFAULT_CONNECTION configuration variable

A_MSSQL_DEFAULT_OWNER configuration variable

A_MSSQL_FAST_ACCESS configuration variable

A_MSSQL_LIMIT_DROPDOWN configuration variable

A_MSSQL_LOCK_DB configuration variable

A_MSSQL_LOGIN configuration variable

A_MSSQL_MAX_CHARACTERS configuration variable

A_MSSQL_MAX_COLUMNS configuration variable

A_MSSQL_NO_23_ON_START configuration variable

A_MSSQL_NO_CACHED_READ configuration variable

A_MSSQL_NO_COUNT_CHECK configuration variable

A_MSSQL_NO_DBID configuration variable

A_MSSQL_NO_RECORD_LOCKS configuration variable

A_MSSQL_NO_TABLE_LOCKS configuration variable

A_MSSQL_NT_AUTHENTICATION configuration variable

A_MSSQL_PACKETSIZE configuration variable

A_MSSQL_PASSWD configuration variable

A_MSSQL_ROWCOUNT configuration variable

A_MSSQL_SELECT_KEY_ONLY configuration variable

A_MSSQL_SEPARATE_LOCK_CONN configuration variable

A_MSSQL_SKIP_ALTERNATE_KEYS configuration variable

A_MSSQL_TRANSLATE_TO_ANSI configuration variable

A_MSSQL_UNLOCK_ON_EXECUTE configuration variable

A_MSSQL_USE_DROPDOWN_QUERIES configuration variable

A_ORA_DATABASE configuration variable

A_ORA_HINTS configuration variable

A_ORA_MAX_FILE_CURSORS configuration variable

A_ORA_NLS_SORT configuration variable

A_ORA_WAIT_LOCK configuration variable

A_ORACLE_ERROR_FILE configuration variable

COMMIT_COUNT configuration variable

FILE_TRACE configuration variable

FILE TRACE FLUSH

ORA_LOGIN configuration variable

ORA_PASSWD configuration variable

USER_PATH (for Oracle) configuration variable

USER_PATH (for DB2) configuration variable

XFD_DIRECTORY configuration variable

XFD_MAP configuration variable

XFD_MAP_RESETS configuration variable

XFD_PREFIX configuration variable

Error Messages

Run Time - File Status Errors

01 Read error on dictionary file

02 Corrupt dictionary file

04 Open error

04 Too many fields in the key

05 (no message associated with this error)

05 Too many fields in the key (more than 16 for Oracle)

11 Stored procedures not found

12 A column of a key is of data type TEXT or IMAGE, which is illegal

12 DB2 library function returned an unexpected error

13 Illegal size or type of data for variable xxx

13 Internal error

14 More than one table with the same name

16 Trying to rename a table across databases

17 Cache error

18 Primary Key error

09/19 Table Size Error

20 (no message associated with this error)

21 (no message associated with this error)

1001 Invalid Cursor

22007 Invalid Character value for Cast Specification

Compiler Errors

Bad picture for DATE: keyname

Data missing from key segment keyname

Directive word too long: keyname

Field xxx causes duplicate database data

GROUP expected after USE

Missing '=' in XFD directive

Missing field name after WHEN

Visual COBOL lock table missing

Value should be a literal: xxx

Value should be a name: xxx

Value should be numeric: xxx

Variable file name requires FILE directive

WHEN variable xxx not found in record

xxx not unique in first 30 characters

xxx: unknown XFD directive

Stored Procedures

Sample XFD

sp_AcuInit stored procedure

sp_AcuRemoveUnusedLocks_1 stored procedure

sp_AcuTableReport_1 stored procedure

sp_AcuUserCount_1 stored procedure

sp_AcuZeroUserCount_1 stored procedure

tablename_delete stored procedure

tablename_insert stored procedure

tablename_read stored procedure

tablename_startnnn stored procedure

tablename_update stored procedure

XFD Directives

ALPHA XFD directive

BINARY XFD directive

COBOL-TRIGGER XFD directive

COMMENT XFD directive

NUMERIC XFD directive

SECONDARY_TABLE XFD directive

USE GROUP XFD directive

VAR_LENGTH XFD directive

WHEN XFD directive

WHEN Complex Expressions

XSL XFD directive

Compiler Directives Affecting XFD Creation

CREATEXFD XFD directive

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

Locking Files and Records

Example of Locking a File

Examples of Manual Record Locking

Examples of Automatic Record Locking

Examples of Single Record Locking

Examples of Multiple Record Locking

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

Micro Focus File Handler

File Organizations

Fixed-length and Variable-length Records

Sequential Files

Record Sequential Files

Line Sequential Files

Printer Sequential Files

Indexed Files

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

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 (deprecated)

Headers in Striped Files (deprecated)

Options (deprecated)

MAXSTRIPEDIGITS (deprecated)

MAXSTRIPEFILES (deprecated)

MAXSTRIPESIZE (deprecated)

STRIPE-X (deprecated)

STRIPENAMETYPE (deprecated)

STRIPING (deprecated)

Examples (deprecated)

Performance

File Handler and Sort APIs

Calling the File Handler

File Control Description (FCD)

Data Structures

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 Utilities

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

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

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

File systems and FILEMAXSIZE

File Systems

32-bit file systems

64-bit file systems

Fileshare Guide

Introduction

Specifying the Communications Protocol

How Fileshare Works

Standard Operation

Fileshare Client

Specifying the Fileshare Server

As a Filename

In a Configuration File

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

About CCISMEM

Using CCISMEM

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)

Alternative Filename (/af)

Filename Record

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

Erasing a File String Record

File String Record

Best Practices Basic Logging

Backup Folder Record

Best Practices for Backup and Recovery

Best Practices Advanced Logging

Security

Password System

Fileshare Client

Fileshare Server

Writing Your Own FHRdrLngPwd Module

Logon Validation Module

File Access Validation Module

Password File Maintenance

Advanced Operation

Filename Mapping

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

Running Fileshare as a Windows Service

Fileshare Server Configuration

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

Considerations

Setting Up the Environment for Java and COBOL

Compiling COBOL Programs that Call Java

Compiling COBOL Programs that Are Used from the CobolBean interface

Linking to the Multi-threaded Run-time System

Deploying a Java Service Interface and Using Resource Adapters

JSP Client

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

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

Managed COBOL Programming

Introduction to Object-Oriented Programming for COBOL Developers

Background to .NET

Native COBOL compared with managed COBOL

64-bit applications in the .NET environment

Multiple user COBOL applications in .NET

Background to multiple run units and .NET

Demonstration of a Multiple Run Units Application

Run the MultiRunUnits Demonstration

Walkthrough the MultiRunUnits Demonstration

Developing an application for multiple run units in .NET

To call managed COBOL in a multiple user environment

Code Page Conflicts in .NET COBOL

Avoiding Code Page Conflicts in .NET COBOL

Example of Code Page Conflicts in .NET COBOL

To Avoid Code Page Conflicts in .NET COBOL

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

Accessing Procedural COBOL From Managed Code

Example of Using a Managed COBOL Wrapper Class

Example of Using the ILSMARTLINKAGE Compiler Directive

Interoperability

Overview of 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?

Examples of Compatible Types for Native and Managed COBOL

Compatible Types Example in .NET COBOL Interoperation

Group Items Example in .NET COBOL Interoperation

Occurs Clause Example in .NET COBOL Interoperation

Calling a .NET Class from Native COBOL, Using CCW

Calling a Native COBOL COM Object, Using RCW

Platform Invoke and Calling Native COBOL

PInvoke Example

Callable Attribute in .NET COBOL Interoperation

Mixed Language Programming with Native COBOL

Storage Representation of Parameters

Handling Return Codes in Mixed Language Applications

Call Conventions for Interfacing with Mixed Languages

Avoiding data name conflicts

Web Application Development with COBOL

Building Service-Oriented Applications with WCF and COBOL

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

Specifying No Multi-threading

Multi-threaded Program Attributes

Serial Programs

Reentrant Programs

Use of Data Attributes

Using Synchronization Primitives

Writing Multi-threaded Applications

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 in the .NET Framework

Multi-threading Compiler Directives

Directives for Serial and Reentrant Programs

Directives that Optimize Performance

Performance Programming

Benchmarking your Application

Troubleshooting Performance Issues

Optimizing COBOL Syntax

Optimizing Data Definitions

Speed of Processing of Different Data Types

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

Using Visual COBOL in Modern Application Development

Introduction to Modern Application Development

What is Modern Application Development?

Key Concepts in Modern Application Development

Steps Involved in Modern Application Development

Agile Methods

Introduction to Agile Methods

Agile Development Workflow

Agile Development and Micro Focus Development Tools

Continuous Integration

Introduction to Continuous Integration

Continuous Integration Workflow

Continuous Integration and Micro Focus Development Tools

Continuous Delivery

Introduction to Continuous Delivery

Continuous Delivery Workflow

Continuous Delivery and Micro Focus Development Tools

Continuous Improvement

Using Visual COBOL with Jenkins

Scenarios for Using Jenkins

Terminology

Software Requirements

Installing and Configuring Jenkins

Advanced Configuration

Configuring Email Reporting

Using Sources from Source Control

Triggering Builds Automatically

Creating Environment Variables

Using Agents

Using Jenkins to Build COBOL Applications

Setting up the Environment

Examples

Example - Building COBOL Programs

Example - Integrating Code Analysis

Example - Running MFUnit Tests

Best Practices When Using Jenkins

Using Jenkins With Source Control

Specifying any Environment Variables in a Project's Configuration

Creating Separate Projects for Building and Testing Your Code

Using Pipelines to Build Your Applications

Troubleshooting

Ant Error "Can't find mfant.jar" When Building COBOL Projects

COBOL Projects Don't Build

A Build Failure isn't Reported as a Failure

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

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

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

IDEDBG Emitter Properties

TEXTFILE Emitter Properties

WINEVENT Emitter Properties

CTF Tracing Examples

Profiler

Enabling Profiler

Configuring the Profiler Reports

Profiler - Report Generation Options

Running Your Application with Profiler

Profiler Output

Time Spent in Called Programs

The Micro Focus Unit Testing Framework

Unit Testing from the Command Line

Writing Tests

Elements of a Test Fixture

Using Dynamic Metadata

Examples of using Metadata

Determining a Test Outcome

Examples - Writing Tests

Simple Test Case Example

Advanced Test Case Example

Compiling Tests

Running Tests

Configuring the Run-Time System Environment

Test Runner Syntax Options

Test Fixture Files

Example Test Fixture File

Example Ant Project

Example - text file results

Viewing Test Results

Example - test results NUnit format

Using the Results in Silk Central

Using the Results on a Jenkins CI Server

Dealing with Errors in Your Tests

Unit Testing in the IDE

Organizing your projects

Creating Tests

Create a Unit Test Project and Test Program

Create a Unit Test Project

Writing Tests

Elements of a Test Case

Unit Testing Code Snippets

Determining a Test Outcome

Test Output Examples

Example - Creating a Test Case

Running Tests in the IDE

Running Unit Tests

Debugging Test Cases

Micro Focus Unit Testing Framework

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

COBOL Language Reference

COBOL Language Supported and Copyrights

Notations

Part 1. Concepts

Introduction to the COBOL Language

The COBOL Language

Source Format

Fixed 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

Figurative Constant Values

Constant-names

Concatenation Expressions

Special Registers

Predefined Object Identifiers

PICTURE Character-Strings

Formats and Rules

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

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

Files

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

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 SYNCHRONIZED Clause

The TYPEDEF Clause

Screen Section Entry Skeleton

The VALUE Clause

Screen Section

The AUTO Clause

The BACKGROUND-COLOR Clause

The BELL Clause

The BLANK Clause

The BLANK WHEN ZERO Clause in the Screen Section

The FOREGROUND-COLOR 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

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

Intrinsic Functions

Function Types

Date Conversion Functions

Trigonometric Functions

Definitions of Functions

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 PRESENT-VALUE Function

The STANDARD-DEVIATION 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 CREATE Collection Statement

The ADD Statement

The ALLOCATE Statement

The COMPUTE Statement

The CONTINUE Statement

The DECLARE Statement

The DELETE Statement

The DELETE FILE Statement

The DETACH Statement

Appendix A - JSON GENERATE Source Items

The DIVIDE Statement

The ENTER Statement

The ENTRY Statement

The EVALUATE Statement

The EXAMINE Statement

The EXEC(UTE) Statement

The EXHIBIT Statement

The INITIALIZE Statement

The INSPECT Statement

The INVOKE Statement

The JSON GENERATE Statement

Appendix B - JSON Output Text

Appendix C - Elementary Data Format Conversions

Appendix D - Trimming of Generated JSON Data

Appendix E - JSON Name Formation

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 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

Editor Control

$REGION 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

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 Structure

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

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 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

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)

Method Interface Definition

The VALUE Clause

Procedure Division

Conditional Expressions

The INITIALIZE Statement

The INSPECT Statement

The MOVE Statement

The SEARCH Statement

The STRING Statement

The UNSTRING Statement

Micro Focus OO COBOL Extensions

Summary of Obsolete Language Elements

Additional Dialect Support

ACUCOBOL-GT Syntax Extensions

Program Structure

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

Special Registers LIN and COL

Microsoft COBOL V1.0 and V2.0 Syntax Support

Environment Division

The Special-Names Paragraph

Data Division

The Position-Specification Phrase

Procedure Division

READ Statement (in Manual Mode)

The EXHIBIT Statement

Microsoft V2.0 Additional Syntax Support

Record LOCKING

OPEN LOCKING Statement

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

Procedure Division

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 EXIT PROGRAM Statement

The PERFORM Statement

The STOP RUN Statement

Siemens BS2000 COBOL Syntax Support

Concepts

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 SYNCHRONIZED Clause

Procedure Division

Intrinsic Functions

The CLOSE Statement

Record Sequential Files

Line Sequential Files

The EXIT PERFORM Statement

The ENTRY Statement

The EVALUATE Statement

The GOBACK Statement

The INSPECT 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

JSON-CODE Exception Codes

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 from the Command Line

The cobol command

cobol Command Examples

Compiling Using Response Files Example

Compiler Prompts

Compiler Prompts Example

Filenames

Response Files

Error Codes Returned by the Compiler

Linking from the Command Line

cbllink Options

Converting Header Files Using the H2cpy Utility

Service Interfaces

imtkmake command

mfdepinst command

Running an Application from the Command Line

Command to Run a Linked System Executable Program

run Command

run Command Examples

Enhanced ACCEPT/DISPLAY Syntax

Displayed Data Format - Examples

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

Displaying Single Fields

Control Sequences in Displayed Data

Displaying Highlighted Text

Accepting and Displaying Group Items

Accepting into Group Items

Displaying Group Items

MODE IS BLOCK Clause

Accepting and Displaying Screen Section Items

Positioning the Cursor for ACCEPT Statements

Accepting and Displaying Data on Large Screens

CONTROL Clause

Keyboard Handling Via Adis

Types of Adis Keys

Function Key Handling

The CRT STATUS Clause

Normal termination of an ACCEPT operation

Default User Function Keys

Enabling and Disabling User Function Keys

Detecting User Function Keys

Using the Compatibility Key List for Adis Keys

The User Function Keys and Validation Clauses

Using the Adis Keys

Key Mappings for Standard Adis Functions

Standard Adis Key Functions

Mapping the Adis Keys to the Functions

Special Mapping Functions in Adis

Key Mappings for Special Adis Functions

Changing Adis Key Mappings from a Program

Conflict With the x"B0" COBOL System Library Routine

Enabling and Disabling Adis Keys

Detecting Adis Function Keys

Defining a Key in Both the User and Adis Key Lists

Data Key Handling

Controlling the Data Keys

Detecting Data Keys Set Up to Act as Function Keys

Shift Key Handling

Determining Available Shift Keys

Detecting the Current State of the Shift Keys

Enabling or Disabling Shift Keys to Terminate an ACCEPT

Lock Key Handling

Determining Available Lock Keys

Detecting the Current State of the Lock Keys

Enabling or Disabling Lock Keys to Terminate an ACCEPT

Converting Accepted Characters to Uppercase

Configuring Enhanced ACCEPT and DISPLAY

Invoking the Adis Configuration Utility

Menus

The Adis Configuration Utility Main Menu

The Adis Key Control Menu

The Alter Accept/Display Options Menu

The Alter All Messages Menu

The Alter All ACCEPT/DISPLAY Options Menu

The Alter Configuration Menu

The Alter Crt-Under Highlighting Menu

The Alter Function Mappings Menu

The Alter Indicators Menu

The Alter Individual Messages Menu

The Alter Individual Options Menu

The Alter Message/Indicator Positions Menu

The Alter Messages Menu

The Alter Tab Stops Menu

The Choose Configuration Menu

The Delete Configuration Menu

The Enable/Disable Adis Keys Menu

The Load Configuration Menu

The Save Menu

Adiscf Functions

Keyboard Configuration Utility (Keybcf)

Overview

The Key Lists

cobkeymp Tables

Invoking the Keyboard Configuration Utility

Using the Keyboard Configuration Utility

Reviewing Existing Function Key Definitions

Altering Function Key Definitions

Saving Function Key Definitions

Exiting From the Keyboard Configuration Utility

Example of Using the Keyboard Configuration Utility

Standard Adis Key Functions

Special Mapping Functions in Adis

Profiler

Introduction to Profiler

Running Profiler from the Command Line

Profiler Output

Time Spent in Called Programs

Directives for Profiler

Test Coverage (Native COBOL)

Overview - Test Coverage

Test Coverage Configuration File

Test Coverage Report Files

Format of a Test Coverage Report

Recompiling Programs

Reporting on Tagged Lines

Test Coverage Tag File

Test Coverage Utility Program (tcutil)

How To...

To use test coverage from the command line

To create test coverage reports

To use test coverage in a production system

To report on tagged lines

Including Code Coverage in a Continuous Integration Process

Restrictions when Using Test Coverage

Troubleshooting Test Coverage

Test Coverage Error Messages

Compiler Directives

Language Features

Language Features - Dialect

DIALECT

Language Features - Mainframe Compatibility

DIALECT

Language Features - Multi-threading

REENTRANT

SERIAL

Language Features - Reserved Word Control

Language Features - Speed

Language Features - Additional Features

Compiler Control

Compiler Control - Compile/Link Files

IDYSRCPATH (deprecated)

Compiler Control - Directives Control

COBOLDIR

CONFIRM

DIALECT

ACU DIALECT setting

OPT (Intel x86 platforms)

DIRECTIVES, DIR

DIRECTIVES-IN-COMMENTS

SETTING, SETTINGS

SHOW-DIR

USE

Compiler Control - Error and Flag Messages

Compiler Control - Listing

Compiler Control - Screen

Compiling for Debugging and Analysis

File Handling

WRITELOCK, WRITE-LOCK

WRITETHROUGH, WRITETHRU

Managed COBOL Command Line Compiler Directives

Application Directives

Code Generation Directives

ILOBJECTIFY (deprecated)

Reference, Resource and Namespace Directives

Strong Naming Directives

ILDELAYSIGN

ILKEYFILE

ILKEYNAME

Identity, Information and Manifest Directives

Object Code, Size, and Optimization

Object Code - External Handlers

CALLFH

CALLMCS

CALLSORT

Object Code - File Handling

WRITETHROUGH, WRITETHRU

Object Code - Interprogram Communication

Object Code - Size and Speed

OPT (Non-Intel x86 platforms)

Report Writer

Reserved Directives

Run-time Behavior

Run-time Behavior - General

CONVERTRET (deprecated)

Run-time Behavior - Arithmetic

NATIVE-FLOATING-POINT

SIGNDISCARD

TRUNC

Run-time Behavior - Mainframe Compatibility

DIALECT

Key to Compiler Directives

MAINFRAME-FLOATING-POINT

MAPNAME

NATIVE-FLOATING-POINT

Run-time Behavior - Compatibility with Older Micro Focus Products

WRITELOCK, WRITE-LOCK

Run-time Behavior - Compatibility with Other COBOL Dialects

Run-time Behavior - Speed or Size

Compiler Directives - Alphabetical List

CONVERTRET (deprecated)

DIALECT

OPT (Intel x86 platforms)

DIRECTIVES, DIR

DIRECTIVES-IN-COMMENTS

IDYSRCPATH (deprecated)

ILOBJECTIFY (deprecated)

MAINFRAME-FLOATING-POINT

NATIVE-FLOATING-POINT

OPT (Non-Intel x86 platforms)

WRITELOCK, WRITE-LOCK

WRITETHROUGH, WRITETHRU

Environment variables

Error Messages

Syntax Checking Error Messages

Key to Syntax Checking Error Messages

COBCH0001 - COBCH0100

COBCH0001 - COBCH0020

COBCH0001 Undefined error. Inform Technical Support

COBCH0002 Unexpected SQL error. Inform Technical Support

COBCH0003 Illegal format : Literal

COBCH0004 Illegal character

COBCH0005 User-name user-name not unique

COBCH0007 $ specified in indicator area of otherwise blank line

COBCH0008 Unknown COPY file filename specified

COBCH0009 '.' missing

COBCH0010 Word starts or is continued in wrong area of...

COBCH0011 Reserved word missing or incorrectly used

COBCH0012 Operand data-name is not declared

COBCH0013 User-name required

COBCH0014 Invalid operand

COBCH0015 Procedure Division too large

COBCH0016 Data space too large

COBCH0017 Incorrect use of reserved word word

COBCH0018 Preprocessor error on initialization

COBCH0019 BASIS line number sequencing error

COBCH0020 Numeric literal expected

COBCH0021 - COBCH0040

COBCH0021 Too many qualifiers

COBCH0022 SKIP1/2/3, EJECT and TITLE must be alone on line

COBCH0023 Nonnumeric literal expected

COBCH0024 Illegal qualifier

COBCH0025 Qualification not permitted

COBCH0026 Literal too long

COBCH0027 Number too large

COBCH0028 Data item too long

COBCH0029 Not a data-name

COBCH0030 Should be a group

COBCH0031 Should be elementary

COBCH0032 Should be unitary

COBCH0033 Should be procedure name

COBCH0034 Operand operand should be numeric

COBCH0035 Integer required

COBCH0036 Should be alphanumeric

COBCH0037 Should have USAGE DISPLAY

COBCH0038 Paragraph or phrase repeated illegally

COBCH0039 Too many COPY ... REPLACING statements

COBCH0040 Missing or illegal file name

COBCH0041 - COBCH0060

COBCH0041 ZERO is an invalid value for an index-name

COBCH0042 Must be nonzero

COBCH0043 Literal or figurative constant expected

COBCH0044 Literal expected

COBCH0045 Operand data-name has wrong size

COBCH0046 Alphabet name required

COBCH0047 Numeric literal or ZERO expected

COBCH0048 Missing or extra right parenthesis

COBCH0049 Illegal use of Index-name or Index Data item

COBCH0050 Illegal use of POINTER data item, ADDRESS OF or NULL

COBCH0051 Not a report name

COBCH0052 Only allowed with SEQUENTIAL files

COBCH0053 Directive directive invalid or not allowed here

COBCH0054 Class name required

COBCH0055 Index-name set to value greater than table size

COBCH0056 COPY is recursive

COBCH0057 Not a report group

COBCH0058 Not a report name or a report group

COBCH0059 Cannot GENERATE this report name

COBCH0060 Not a detail group

COBCH0061 - COBCH0080

COBCH0061 Pseudo text incorrectly specified

COBCH0062 Nested COPY replacement causes termination of parent COPY replacement...

COBCH0063 Cannot be used in nested program

COBCH0064 If file is EXTERNAL, then PADDING CHARACTER must be also

COBCH0065 Unsigned integer required

COBCH0066 Data item must have fixed location

COBCH0068 SQL error

COBCH0069 Error code code during SQL Remote Precompile. Cannot continue.

COBCH0070 Invalid argument

COBCH0071 PROCEDURE DIVISION missing or unknown statement

COBCH0072 Invalid FUNCTION name

COBCH0073 Missing left parenthesis

COBCH0074 Numeric argument expected

COBCH0075 Alphanumeric argument expected

COBCH0076 Illegal combination of argument types

COBCH0077 Unexpected end of source within EXEC

COBCH0078 Numeric function not allowed

COBCH0079 Argument must have length 1

COBCH0080 Prompt character incompatible for ACCEPT

COBCH0081 - COBCH0100

COBCH0081 Please recompile using a larger value for LOCALCOUNT directive...

COBCH0082 COBOL Division or Section header encountered in incorrect order...

COBCH0083 Reserved word missing - word expected

COBCH0084 SQL statement only allowed in the Procedure Division

COBCH0085 SQL statement only allowed in the Data Division

COBCH0086 Constant-name data-name same as reserved word

COBCH0087 SIZE must be a positive integer

COBCH0088 A SQL host variable name contains an underscore - illegal COBOL character.

COBCH0089 SQL statement contains more than one SQLDA.

COBCH0090 Too many errors

COBCH0091 Syntax not compatible with FILETYPE(11)

COBCH0092 Redefinition causes ambiguity in location of sliding data-item

COBCH0093 User-name not unique. Assumed qualified by current 01 level record

COBCH0094 Name is not a COBOL word

COBCH0095 Literal used as COPY name

COBCH0096 Lower case used (future occurrences not flagged)

COBCH0097 Both single and double quotes used (future occurrences not flagged)

COBCH0098 Single quotes (apostrophe) used (future occurrences not flagged)

COBCH0099 Nested COPY file

COBCH0100 Sequence number out of order

COBCH0101 - COBCH0200

COBCH0101 - COBCH0120

COBCH0101 Assignment-name is data-name

COBCH0102 RELATIVE KEY clause should immediately follow ACCESS clause

COBCH0103 RECORD missing

COBCH0104 IDENTIFICATION missing

COBCH0105 PROGRAM-ID missing

COBCH0106 PROGRAM-ID has illegal format

COBCH0107 Second status area

COBCH0108 OPTIONAL not permitted on non-sequential file

COBCH0109 Paragraphs or phrases in non-standard order or repeated

COBCH0110 ENVIRONMENT missing

COBCH0111 CONFIGURATION missing

COBCH0112 SOURCE-COMPUTER missing

COBCH0113 SPECIAL-NAMES clause error

COBCH0114 OBJECT-COMPUTER missing

COBCH0115 OBJECT-COMPUTER clause not recognized

COBCH0116 Character specified twice in alphabet

COBCH0117 SWITCH clause error or system name/mnemonic name error

COBCH0118 COMMA expected

COBCH0119 CRT expected

COBCH0120 Illegal currency symbol

COBCH0121 - COBCH0140

COBCH0121 Cannot specify DYNAMIC or EXTERNAL with literal file name...

COBCH0122 Cannot use Double Byte characters in alphabet or class...

COBCH0123 I-O-CONTROL missing

COBCH0124 INPUT-OUTPUT missing

COBCH0125 FILE-CONTROL missing

COBCH0126 ASSIGN missing

COBCH0127 [LINE] SEQUENTIAL, RELATIVE or INDEXED missing

COBCH0128 ACCESS missing on indexed/relative file

COBCH0129 Too many keys or key components

COBCH0130 Illegal ORGANIZATION/ACCESS/KEY combination

COBCH0131 Unrecognized phrase in SELECT clause

COBCH0132 Repeated "condition-name TO TRUE/FALSE" in SET statement

COBCH0133 SAME AREA clause syntax error

COBCH0134 FILE SECTION missing

COBCH0135 DATA DIVISION missing

COBCH0136 Illegal use of phrase for National Locale operation

COBCH0137 Program collating sequence not defined

COBCH0138 "EXCLUSIVE", "AUTOMATIC" or "MANUAL" missing

COBCH0139 Illegal LOCK MODE/file type combination

COBCH0140 For indexed file, PASSWORD phrase must follow KEY

COBCH0141 - COBCH0160

COBCH0141 File name appears in more than one SAME clause...

COBCH0142 Can only be used in nested program

COBCH0143 Unknown Identification Division paragraph

COBCH0144 OCCURS DEPENDING subsidiary to OCCURS only allowed with ODOSLIDE...

COBCH0145 "SET condition-name TO" syntax used

COBCH0146 Condition-name set to FALSE

COBCH0147 Data item must be unsigned

COBCH0148 Status condition missing

COBCH0149 No SQL directives have been set

COBCH0154 COPY REPLACING nested within COPY

COBCH0155 Numeric item should be an integer and without a...

COBCH0156 Period found in wrong area of source line

COBCH0161 - COBCH0180

COBCH0161 Can only be used within a Paragraph

COBCH0162 Can only be used within a Section

COBCH0163 DISPLAY ... UPON SYSERR can only have one operand

COBCH0164 More than 250 USE statements

COBCH0165 NEXT SENTENCE followed by non-executable imperative/conditional statements

COBCH0166 Source and target lengths do not match (integer1 <> integer2)

COBCH0167 WRITE ... ADVANCING and POSITIONING syntax used on same file

COBCH0168 DEPENDING ON item in RECORD VARYING clause not in...

COBCH0170 Invalid argument in directive

COBCH0172 Qualifying name name not unique. Discarded.

COBCH0173 Space invalid here.

COBCH0174 A RECORDING MODE of 'S' was assumed for the above file

COBCH0175 A VALUE clause was specified for a sliding item...

COBCH0176 'RENAMES' object object is an 01 level item

COBCH0177 'RENAMES' object object is not present in the preceeding record

COBCH0178 DEPENDING missing. Fixed length assumed.

COBCH0179 Number of subscripts in VALUE clause does not match...

COBCH0180 One or more subscripts in a VALUE clause is...

COBCH0181 - COBCH0200

COBCH0181 FROM subscript in VALUE clause must not be greater...

COBCH0182 Limit exceeded - too many literals in VALUE clause

COBCH0183 VALUE clause would result in initialisation of elements beyond...

COBCH0184 In-line comment

COBCH0185 END-EXEC missing, or unexpected EXEC

COBCH0186 EXEC too large or END-EXEC missing/misspelled

COBCH0187 Program is nested in a program defined with the...

COBCH0188 Key file %1_s not found

COBCH0189 Directives file filename not found

COBCH0190 Zero is an invalid value for an index-name. 1 assumed.

COBCH0191 OCCURS DEPENDING ON phrase bisected by additional clause!

COBCH0192 CALL parameter is group at level other than 01...

COBCH0193 Use of Z literals

COBCH0194 CALL procedure pointer

COBCH0195 ASCENDING/DESCENDING KEY clause must appear before INDEXED BY clause

COBCH0196 Redefinition of item containing an 'OCCURS DEPENDING ON' clause

COBCH0197 Qualification refers to invalid REDEFINES item - qualification ignored

COBCH0199 LINE clause also specified in containing group

COBCH0200 Empty paragraph

COBCH0201 - COBCH0300

COBCH0201 - COBCH0220

COBCH0201 Sort file cannot have ACCESS or ORGANIZATION clauses

COBCH0202 Too many levels of OCCURS

COBCH0203 CODE must be specified for all reports or no...

COBCH0204 REDEFINES on incorrect field

COBCH0205 RECORD missing or has zero size

COBCH0206 01 or 77 level required

COBCH0207 FD, CD or SD qualification syntax error

COBCH0208 WORKING-STORAGE missing

COBCH0209 PROCEDURE DIVISION missing or unknown statement

COBCH0210 Unrecognized data description qualifier or "." missing

COBCH0211 PICTURE clause not compatible with qualifiers

COBCH0212 Illegal data item used with BLANK clause

COBCH0213 Item is longer than USAGE allows or contains more...

COBCH0214 VALUE too long for data item or has too...

COBCH0215 VALUE in error or illegal for PICTURE type

COBCH0216 Non-elementary item has JUSTIFIED or BLANK clause

COBCH0217 Preceding item at this level has zero length

COBCH0218 Illegal arithmetic operator

COBCH0219 Illegal level number

COBCH0220 Literal type does not match data type

COBCH0221 - COBCH0240

COBCH0221 Data description qualifier inappropriate or repeated

COBCH0222 REDEFINES data-name not declared

COBCH0223 Unknown USAGE

COBCH0224 SIGN must be LEADING or TRAILING

COBCH0225 Level hierarchy wrong

COBCH0226 Variable length group not unitary

COBCH0227 ZERO missing

COBCH0228 Group VALUE truncated

COBCH0229 Incompatible qualifiers

COBCH0230 PICTURE string has illegal precedence or illegal character

COBCH0231 INDEXED data-name missing or already declared

COBCH0232 Edited PICTURE string is too large

COBCH0233 Unknown data description qualifier data-name

COBCH0234 DEPENDING missing

COBCH0235 Record size size1 < minimum size given in FD statement size2

COBCH0236 Record > maximum size given in FD statement

COBCH0237 Cannot have more than one initial CD

COBCH0238 RENAMES missing

COBCH0239 First data-name does not precede second

COBCH0240 Only allowed at 01 level

COBCH0241 - COBCH0260

COBCH0241 Only allowed in Working-Storage Section

COBCH0242 Only allowed in WORKING-STORAGE and FILE sections

COBCH0243 VALUE of group item must be nonnumeric or figurative...

COBCH0244 FD missing for file filename

COBCH0245 DEPENDING ON item data-name missing or illegal

COBCH0246 KEY key-name missing or illegal

COBCH0247 Index-name has been declared explicitly

COBCH0248 ISAM key key-name too long

COBCH0249 Alternate keys have same reference

COBCH0250 STATUS field data-name missing or illegal

COBCH0251 CURSOR field data-name missing or illegal

COBCH0252 PASSWORD field data-name missing or illegal

COBCH0253 LABEL RECORD or DATA RECORD record-name missing or illegal

COBCH0254 'VALUE OF' field data-name missing or illegal

COBCH0255 User name data-name same as special register

COBCH0256 Preceding record has zero length

COBCH0257 KEY data-name missing or already declared

COBCH0258 ASSIGN data-name data-name illegal

COBCH0259 Illegal report-name or bad RD clause

COBCH0260 Inconsistent page specification

COBCH0261 - COBCH0280

COBCH0261 Only allowed in Report Section

COBCH0262 Not a CONTROL for this report

COBCH0263 Not allowed when PAGE not specified in RD

COBCH0264 Only one report group with this TYPE allowed per...

COBCH0265 Not allowed with this TYPE

COBCH0266 No TYPE specified

COBCH0267 LINE specification missing or inconsistent

COBCH0268 REPORT specified in more than one FD

COBCH0269 Duplicate CONTROL field

COBCH0270 COLUMN specification overlapping or not left to right

COBCH0271 Only allowed with DETAIL groups

COBCH0272 Only allowed with CONTROL FOOTING groups

COBCH0273 Non-elementary item has invalid qualifier, or PICTURE missing

COBCH0274 GROUP INDICATE without COLUMN

COBCH0275 NEXT GROUP not allowed with this group TYPE

COBCH0276 NEXT GROUP NEXT PAGE not allowed with this group...

COBCH0277 LINE NEXT PAGE not allowed with this group TYPE...

COBCH0278 RESET item is lower CONTROL level than group

COBCH0279 Report line too long

COBCH0280 THRU phrase not allowed with DBCS field

COBCH0281 - COBCH0300

COBCH0281 Illegal use of DBCS field

COBCH0282 Number of BLL cells incorrect

COBCH0283 An EXTERNAL file cannot be subject of SAME RECORD...

COBCH0284 Not allowed in Report Section

COBCH0285 First LINE NUMBER clause in PAGE FOOTING group is...

COBCH0286 Not specified in CONTROL clause of RD

COBCH0287 Data record specified for Report file

COBCH0288 SYNC with USAGE IS INDEX

COBCH0289 SYNC at group level

COBCH0290 Index key key-name not alphanumeric

COBCH0291 Group FILLER

COBCH0292 SIGN different from that at group level

COBCH0293 SYNC on non-01 level group

COBCH0295 VALUE clause in File or Linkage Section. Clause processed as comment

COBCH0296 BLANK WHEN ZERO with zero suppression

COBCH0297 OCCURS .. DEPENDING clause without "integer TO". "1 TO" assumed

COBCH0298 OCCURS at level 01 or 77

COBCH0299 FILLER omitted

COBCH0300 LABEL RECORDS clause omitted

COBCH0301 - COBCH0400

COBCH0301 - COBCH0320

COBCH0301 Unrecognized verb

COBCH0302 IF....ELSE or scope-delimiter mismatch

COBCH0303 Operand has wrong data-type

COBCH0304 Procedure name name not unique

COBCH0305 Procedure name name same as data-name

COBCH0306 Entry name not unique

COBCH0307 Wrong combination of data-types

COBCH0308 Conditional statement not allowed in this context

COBCH0309 Malformed subscript

COBCH0310 ACCEPT/DISPLAY syntax incorrect

COBCH0311 Illegal syntax used with I-O verb

COBCH0312 Invalid arithmetic statement

COBCH0313 Invalid arithmetic expression

COBCH0314 Illegal key

COBCH0315 Invalid conditional expression

COBCH0316 Too many AFTERs in PERFORM statement

COBCH0317 Incorrect structure of Procedure Division

COBCH0318 File must have ACCESS SEQUENTIAL

COBCH0319 Only index-names allowed with this format

COBCH0320 Too many operands in one statement

COBCH0321 - COBCH0340

COBCH0321 Repeated INDEXED BY phrase

COBCH0322 Cannot reference DEBUG-ITEM outside declaratives

COBCH0323 More than one USE procedure on same file

COBCH0324 More than one USE procedure for same open mode...

COBCH0325 Illegal combination of debugging procedures

COBCH0326 Literal cannot be receiving field

COBCH0327 Index item not permitted

COBCH0328 Not allowed with OPTIONAL file

COBCH0329 WHEN phrase missing from SEARCH statement

COBCH0330 Not a record name

COBCH0332 AFTER phrase not allowed with in-line perform

COBCH0333 Not an alterable paragraph

COBCH0334 Cannot follow WHEN OTHER

COBCH0335 Selection object does not match selection subject

COBCH0336 Variable length group not allowed

COBCH0337 Cannot repeat same category

COBCH0338 REPORT not specified in an FD

COBCH0339 Not allowed with SEQUENTIAL files

COBCH0340 Not allowed with RANDOM ACCESS files

COBCH0341 - COBCH0360

COBCH0341 Not allowed with LINE SEQUENTIAL files

COBCH0342 Not allowed with LINAGE files

COBCH0343 Can only be used in inline PERFORM

COBCH0344 Should be level 01 or 77

COBCH0345 USING parameter used twice in parameter list

COBCH0346 Only one WHEN phrase allowed with SEARCH ALL

COBCH0347 MERGE needs at least two USING files

COBCH0348 Procedure name procedure-name undeclared, first used on line line-number

COBCH0349 "LOCK" clause expected

COBCH0350 Illegal use of "NO LOCK"

COBCH0351 "LOCK" clause specified for "EXCLUSIVE" file

COBCH0352 "KEPT" specified for file with single record locking

COBCH0353 Cannot reference a Report Section item that is not...

COBCH0354 Multiple receiving fields in MOVE CORRESPONDING

COBCH0355 Only "=" and "NOT =" allowed for pointer data items

COBCH0356 Not allowed with REPORT files

COBCH0357 Screen is display-only

COBCH0358 Missing comma

COBCH0359 Mismatch of table dimensions

COBCH0360 File must have ACCESS DYNAMIC

COBCH0361 - COBCH0380

COBCH0361 Operation exceeds COMP subset

COBCH0362 data-name not declared for file or wrong type for CODE-SET

COBCH0363 data-name not in same record as first item in CODE-SET clause

COBCH0364 data-name overlaps another item in CODE-SET clause

COBCH0365 Variable size table not last in group or subsidiary...

COBCH0366 Variable length delimiter not allowed

COBCH0367 Description of operand does not contain the INDEXED BY...

COBCH0368 Exception phrase inappropriate

COBCH0369 OPEN EXTEND on file with LINAGE clause

COBCH0370 Operand must be a table

COBCH0371 Data size is too large

COBCH0372 Illegal use of SORT file

COBCH0373 PICTURE string contains more than 18 numeric positions

COBCH0374 Illegal use of floating-point item

COBCH0375 Literal includes repeated characters

COBCH0376 Table superordinate to operand is not indexed

COBCH0377 SORT table does not support complex OCCURS DEPENDING ON...

COBCH0378 More than seven AFTER phrases

COBCH0379 Non-DISPLAY numeric data cannot be compared with alphanumeric data

COBCH0380 Parameter count in CALL different from that in PROCEDURE...

COBCH0381 - COBCH0400

COBCH0381 TALLYING option has ALL etc. distributed over multiple identifiers

COBCH0382 Only one Procedure-name in GO TO ... DEPENDING

COBCH0383 Missing ALSO

COBCH0384 NEXT SENTENCE does not follow ON, IF, ELSE or SEARCH WHEN

COBCH0385 Order of initialization changed

COBCH0386 No section or paragraph at start of Procedure Division...

COBCH0387 AFTER and BEFORE options used together

COBCH0388 Key is right hand side of condition

COBCH0389 EXIT not in separate paragraph

COBCH0390 OPEN EXTEND on non-sequential file

COBCH0391 MF format Accept/Display

COBCH0392 More than two AFTER phrases

COBCH0393 Inline PERFORM

COBCH0394 No section header after END DECLARATIVES

COBCH0395 FROM literal

COBCH0396 No suitable conditional phrase and no applicable declarative

COBCH0397 No preceding section

COBCH0398 Offset only allowed with Index-names

COBCH0399 Index-name belongs to different table

COBCH0400 Cannot use index data item as subscript

COBCH0401 - COBCH0500

COBCH0401 - COBCH0420

COBCH0401 Limit exceeded - number of source statements > limit

COBCH0402 Limit exceeded - number of files > limit

COBCH0404 Limit exceeded - number of pairs of REPLACING operands > limit

COBCH0406 Limit exceeded - length of file/copy/library name > limit

COBCH0408 Limit exceeded - number of sections/paragraphs/labels > 64k

COBCH0409 Limit exceeded - number of SELECT filenames > limit

COBCH0410 Limit exceeded - number of SAME RECORD AREA clauses > limit

COBCH0411 Limit exceeded - number of MULTIPLE FILE filenames > limit

COBCH0412 Limit exceeded - number of ALTERNATE RECORD KEY clauses in a file > limit

COBCH0413 Limit exceeded - length of RECORD KEY > limit characters

COBCH0414 Limit exceeded - length of Data Division > limit

COBCH0415 Limit exceeded - length of Data Section > limit

COBCH0419 Limit exceeded - BLOCK size > limit characters

COBCH0420 Limit exceeded - RECORD length > limit characters

COBCH0421 - COBCH0440

COBCH0421 Limit exceeded - number of FD filenames > limit

COBCH0422 Limit exceeded - number of SD filenames > limit

COBCH0424 Limit exceeded - number of 01 &77 items in Linkage Section > limit

COBCH0425 Limit exceeded - length of File Section group item > limit characters

COBCH0426 Limit exceeded - length of group item > limit characters

COBCH0427 Limit exceeded - length of data item > limit characters

COBCH0428 Limit exceeded - length of edited item > limit characters

COBCH0429 Limit exceeded - length of variable length table > limit characters

COBCH0430 Total length of VALUE literals > integer - possible problem on mainframe

COBCH0431 Limit exceeded - length of PICTURE string > limit characters

COBCH0432 Limit exceeded - length of PICTURE replication > limit

COBCH0433 Limit exceeded - length of sort record > limit characters

COBCH0434 Limit exceeded - length of table > limit characters

COBCH0435 Limit exceeded - length of table element > limit characters

COBCH0436 Limit exceeded - number of ASC/DESC KEY clauses > limit

COBCH0437 Limit exceeded at limit - length of ASC/DESC KEYs > limit characters

COBCH0438 Limit exceeded - number of INDEXED BY clauses > limit

COBCH0440 Limit exceeded - number of paragraph labels > limit

COBCH0441 - COBCH0460

COBCH0441 Limit exceeded - number of PERFORMs > limit

COBCH0442 Limit exceeded - OCCURS nesting > limit

COBCH0443 Limit exceeded - number of GO TO DEPENDING ON names > limit

COBCH0444 Limit exceeded - number of IF nesting levels > limit

COBCH0445 Limit exceeded - number of CALL parameters > limit

COBCH0446 Limit exceeded - number of SORT/MERGE input files > limit

COBCH0447 Limit exceeded - number of SORT/MERGE keys > limit

COBCH0448 Limit exceeded - number of conditions in a SEARCH ALL > limit

COBCH0449 Limit exceeded - number of UNSTRING delimiters > limit

COBCH0450 Limit exceeded - number of operands in INSPECT TALLYING/REPLACING > limit

COBCH0451 Limit exceeded - length of SORT/MERGE keys > limit characters

COBCH0452 Limit exceeded - number of PROCEDURE DIVISION USING parameters > limit

COBCH0453 Limit exceeded - number of ENTRY USING parameters > limit

COBCH0460 Previous item crosses 64K boundary. Segment checking code produced

COBCH0461 - COBCH0480

COBCH0461 Table crosses 64K boundary. Segment checking code produced

COBCH0462 COBCH0462 Directive use(filename.dir) used causes recursion

COBCH0463 Parameter to call-by-number routine not contained in first 64K of WS

COBCH0465 File Section exceeds 64K. Recompile with CALLFH directive

COBCH0466 KEY-YY not supported; assumed KEY

COBCH0467 Overlapping data-items

COBCH0468 No valid data for xml generation

COBCH0469 %1_s must be a NATIONAL data-item

COBCH0470 No next sentence found for NEXT SENTENCE statement_

COBCH0471 ASSIGN name %1_s in THREAD-LOCAL, but no THREAD-LOCAL clause on FD

COBCH0473 SORT key not within the first %1_s bytes of the file record_

COBCH0474 A duplicate "RECORD" clause was found in an "FD" or "SD" entry_

COBCH0475 A FUNCTION cannot be the subject of an INSPECT...

COBCH0477 More than 18 numeric positions in extended ACCEPT/DISPLAY syntax

COBCH0481 - COBCH0500

COBCH0498 Procedure name %1_s undeclared, line %2_s

COBCH0499 DISPLAY ALL figurative constant syntax used

COBCH0500 DISPLAY ALL literal syntax used

COBCH0501 - COBCH0600

COBCH0501 - COBCH0520

COBCH0501 Feature is part of an optional module - module-name

COBCH0502 This entire section is part of an optional module...

COBCH0503 USAGE COMP used at other than 01 level

COBCH0504 ORGANIZATION clause in SELECT statement of sort file

COBCH0505 VALUE OF clause in SD or CD

COBCH0506 REDEFINES does not immediately follow data-name

COBCH0507 Numeric literal VALUE on edited item

COBCH0508 NEXT used in READ of sequential file

COBCH0509 SET operation on non-index data item

COBCH0510 ZEROS or ZEROES in BLANK WHEN clause. Treated as ZERO

COBCH0511 FILE STATUS data-name is not alphanumeric

COBCH0512 Data-name is qualified

COBCH0513 Flag refers to entire section

COBCH0514 "CHANGED" and/or "NAMED" missing

COBCH0515 Phrases repeated

COBCH0516 Only 1 file specified in SAME AREA clause

COBCH0517 Jump out of inline PERFORM

COBCH0518 > or < followed by THAN or THEN, or = followed by TO

COBCH0519 More than 5 levels of qualification

COBCH0520 "INVALID KEY" phrase used with sequential file

COBCH0521 - COBCH0540

COBCH0521 USING literal/LENGTH OF identifier. (BY CONTENT implied for this item)

COBCH0522 BY CONTENT literal/LENGTH OF identifier

COBCH0523 Declarative Section without USE statement

COBCH0524 ALPHABET IS ASCII

COBCH0525 EOP or END-OF-PAGE used on file which has no LINAGE

COBCH0526 Phrases are not in the correct order

COBCH0527 REDEFINES at 01 in File Section

COBCH0528 Data-name data-name in ASC/DESC key clause is not uniquely identified

COBCH0529 Clause treated as documentary

COBCH0530 Data item used as index file key is not...

COBCH0531 Too many subscripts

COBCH0532 INTO data-name is group item

COBCH0533 START ... LESS/NOT GREATER THAN ...

COBCH0534 Entry treated as documentary

COBCH0535 ALPHABET is EBCDIC

COBCH0537 BASIS mechanism (BASIS, DELETE or INSERT)

COBCH0538 Picture string is continued

COBCH0539 This item is obsolete in 1985 standard

COBCH0540 Source field is edited

COBCH0541 - COBCH0560

COBCH0541 Comparison between edited field and COMP field

COBCH0542 VALUE clause on group COMP

COBCH0543 VALUE clause on variable length group

COBCH0544 VALUE clause with OCCURS or subsidiary to group OCCURS...

COBCH0545 ALTERNATE RECORD KEY is not in SAA

COBCH0546 PICTURE symbol P not allowed in RELATIVE KEY

COBCH0547 END-IF used with NEXT SENTENCE

COBCH0548 Program is nested

COBCH0549 USING identifier must not be a redefinition

COBCH0550 Pseudo-text consists entirely of a separator comma or semicolon

COBCH0551 Second status field does not comply with VSC2_BS2000 specifications...

COBCH0552 Comment lines precede IDENTIFICATION DIVISION

COBCH0553 syntax : non-conforming standard ANS85

COBCH0554 Syntax is non-conforming non-standard ANS85

COBCH0555 syntax : marked as obsolete in the ANS85 standard

COBCH0556 Multiple program source

COBCH0557 Multiple GIVING files

COBCH0558 Comparison between index-name and arithmetic expression

COBCH0559 Statement cannot be reached

COBCH0560 Alphabet declared without ALPHABET keyword

COBCH0561 - COBCH0580

COBCH0561 A "NOT" phrase did not have a matching verb and was discarded

COBCH0562 An "ELSE" phrase did not have a matching IF and was discarded

COBCH0563 A "WHEN" phrase did not have a matching verb and was discarded

COBCH0564 A scope-delimiter did not have a matching verb and was discarded

COBCH0565 RECORDING MODE used with INDEXED or RELATIVE file

COBCH0566 This release does not support floating point in this...

COBCH0567 USAGE DISPLAY-1 missing

COBCH0568 Sign condition in EVALUATE statement

COBCH0569 Data item does not have fixed location

COBCH0570 Insufficient space in area B for SO/SI insertion

COBCH0571 Mixed literal is continued

COBCH0572 INITIALIZE operand does not have fixed location

COBCH0573 More than one REPLACING phrase

COBCH0574 Conditional statement not terminated by its scope-delimiter

COBCH0575 Zero suppression follows floating insertion

COBCH0576 Preceding statement is not imperative

COBCH0577 Group level USAGE does not match PICTURE type - USAGE ignored

COBCH0578 PROGRAM-ID specified as literal

COBCH0579 PROGRAM-ID is DBCS name

COBCH0580 User-defined word as DBCS name

COBCH0581 - COBCH0600

COBCH0581 END-SEARCH used with NEXT SENTENCE

COBCH0582 Redefined item has OCCURS phrase

COBCH0583 EXIT PROGRAM in GLOBAL declarative

COBCH0584 Inline PERFORM statement not terminated by END-PERFORM

COBCH0585 Imperative statement missing

COBCH0586 Smallest record size size1 > minimum in RECORD clause size2

COBCH0587 Largest record size size1 < maximum in RECORD clause size2

COBCH0588 Operand does not have USAGE DISPLAY

COBCH0589 Procedure Division does not finish with complete sentence

COBCH0590 USING/GIVING file does not have ORGANIZATION SEQUENTIAL

COBCH0591 USING/GIVING file has ACCESS RANDOM

COBCH0592 USING/GIVING file has ACCESS DYNAMIC

COBCH0593 Sequence number contains nonnumeric characters

COBCH0594 Variable length group is operand of INITIALIZE statement

COBCH0595 SORT file has FILE STATUS clause

COBCH0596 01 level record in Report Section is elementary

COBCH0597 Object of SUM clause belongs to different report

COBCH0598 Assignment-name is alphanumeric literal

COBCH0599 Literal form of CODE phrase

COBCH0600 Name is implicitly qualified

COBCH0601 - COBCH0700

COBCH0601 - COBCH0620

COBCH0601 USE BEFORE REPORTING on DETAIL group

COBCH0602 Neither LINE nor LINES specified

COBCH0603 SIGN phrase in Report Section

COBCH0604 GLOBAL specified for entry without data-name

COBCH0605 More than one SUM for single item

COBCH0606 Program does not contain Procedure Division

COBCH0607 PROCEDURE DIVISION header missing

COBCH0608 Pseudo-text delimiter preceded / followed by illegal character

COBCH0609 Apostrophe found with QUOTE directive (future occurrences not flagged)

COBCH0610 Quote found with APOST directive (future occurrences not flagged)

COBCH0611 Line: line-no Column: column-no

COBCH0612 EXIT PROGRAM not in separate paragraph

COBCH0613 Invalid program name

COBCH0614 Previous LINE clause specified same number

COBCH0615 Floating point data item

COBCH0616 This EXIT statement format is an MF extension

COBCH0617 Data item is defined at level 66

COBCH0618 Data item is not declared in Linkage Section

COBCH0619 User-name mixes single-byte and double-byte characters

COBCH0620 DBCS user-name exceeds 14 characters in length

COBCH0621 - COBCH0640

COBCH0621 DBCS user-name begins with DBCS equivalent of SBCS "-" character

COBCH0622 DBCS name contains illegal character

COBCH0623 DBCS name contains only DBCS characters equivalent to SBCS...

COBCH0624 Belongs to Linkage record not specified in PROCEDURE DIVISION...

COBCH0625 Alphabetic edited item treated as alphabetic

COBCH0626 Edited field not allowed

COBCH0627 Section header not followed by paragraph name or other...

COBCH0628 Use of symbolic literal defined in level 78 or...

COBCH0629 Use of signed or non-integer numeric literal

COBCH0630 INTO not legal for this file

COBCH0631 GLOBAL specified in Linkage Section

COBCH0632 A FUNCTION cannot be a receiving item

COBCH0633 REPORT HEADING extends beyond first detail_ NEXT GROUP NEXT...

COBCH0634 Feature not supported in selected dialect

COBCH0635 VALUE specified for external floating point data item

COBCH0636 Level 88 defined on external floating point data item...

COBCH0637 ACCEPT references internal floating point data item

COBCH0638 Floating point data illegal in DIVIDE with REMAINDER clause...

COBCH0639 Reserved word OR missing

COBCH0640 Floating point data item used in SEARCH ALL statement...

COBCH0641 - COBCH0660

COBCH0641 '_' missing following procedure name declaration, or unrecognized verb

COBCH0642 Source and target start at same location

COBCH0643 Source and target overlap, and source is at a higher address than target

COBCH0644 Significand has more than 16 numeric positions

COBCH0645 Floating-point value out of range

COBCH0647 CURSOR/CRT STATUS data item may not be in LOCAL-STORAGE/LINKAGE

COBCH0648 Illegal use of Local-Storage item

COBCH0649 Record length exceeds system limit

COBCH0650 No matching $IF - ignored

COBCH0651 SORT key cannot have, or be subsidiary to item with, OCCURS clause

COBCH0652 BY CONTENT numeric literal

COBCH0654 NEXT GROUP specified for group with no LINE NUMBER...

COBCH0655 NEXT GROUP NEXT PAGE specified for report without PAGE...

COBCH0656 Source and target overlap, and source is at lower address than target

COBCH0657 Should be declared in Linkage Section

COBCH0658 NUMERIC class test on ALPHABETIC item

COBCH0659 Screen name mandatory at 01 level in Screen Section...

COBCH0660 Positive signed integer used in relative subscripting

COBCH0661 - COBCH0680

COBCH0661 Superfluous TO found in MOVE statement. Ignored

COBCH0662 Figurative constant or ALL not allowed here

COBCH0663 LENGTH function in non-standard context

COBCH0664 INPUT-OUTPUT SECTION precedes CONFIGURATION SECTION

COBCH0665 Communications syntax incorrect

COBCH0666 Reserved word used as data-name or unknown data description qualifier

COBCH0667 ODO object object must have fixed location

COBCH0668 JUSTIFIED specified on edited field

COBCH0669 EVALUATE statement using partial conditional expressions

COBCH0670 Selection object does not correspond to selection subject

COBCH0671 PERFORM UNTIL EXIT

COBCH0672 COPY nested in COPY REPLACING

COBCH0673 Incompatible options specified

COBCH0674 Subscripting and indexing used for the same identifier

COBCH0675 Numeric FUNCTION used as source of MOVE statement

COBCH0676 THEN used instead of THAN

COBCH0677 Value of previous expression may not be the same...

COBCH0678 Too many CONTROLS specified for report

COBCH0679 QUOTE character must be double in an N literal...

COBCH0680 N" format literal

COBCH0681 - COBCH0700

COBCH0681 Function argument must be positive

COBCH0682 Function argument must be positive or zero

COBCH0683 Function argument must be nonzero

COBCH0684 Function argument must be between -1 and +1

COBCH0685 Function argument must be greater than -1

COBCH0686 Function argument must be between 1 and collating sequence...

COBCH0687 Use of PROCEDURE-POINTER data item

COBCH0688 Use of "C" or "R" as currency sign

COBCH0689 Condition-name cannot be set to FALSE (no FALSE value specified)

COBCH0690 Illegal use of floating-point literal

COBCH0691 Simple COPY and qualified COPY both used in the...

COBCH0692 REPORT specified in more than two FDs

COBCH0693 Cannot be an external item

COBCH0694 Identifier is reference modified

COBCH0695 EXTERNAL program

COBCH0696 Data-name must be specified with TYPEDEF

COBCH0697 Data item is redefinition of KEY, rather than the key itself

COBCH0698 Use of positive literal in AFTER ADVANCING phrase

COBCH0699 ADVANCING PAGE and END-OF-PAGE used in same WRITE statement

COBCH0700 Function argument is wrong format

COBCH0701 - COBCH0800

COBCH0701 - COBCH0720

COBCH0701 Alphabet-name must be preceded by ALPHABET

COBCH0702 Alphabetic class expanded to include lower-case letters

COBCH0703 ON OVERFLOW will execute under more conditions

COBCH0704 Comparison between scaled integer and nonnumeric is different

COBCH0705 ":" treated as a separator

COBCH0706 Non-COBOL character character found. Results might be different

COBCH0707 An implicit EXIT PROGRAM will be executed at end...

COBCH0708 PICTURE consists of A's and B's. Treated as alphanumeric-edited

COBCH0709 Order of initialization different for PERFORM... VARYING.. . AFTER

COBCH0710 The maximum length of receiver receiver will be used...

COBCH0711 RECORD CONTAINS with one integer is supported differently

COBCH0712 The file status values are different

COBCH0713 Subscripting and ODO for UNSTRING evaluated at start of...

COBCH0714 Non-space characters following "." are ignored

COBCH0715 EXIT not followed by "."

COBCH0716 EXIT PROGRAM not followed by "."

COBCH0717 Shift out character not followed by valid DBCS character...

COBCH0718 Shift out character not matched with shift in, or vice versa

COBCH0719 I-O CONTROL paragraph contains multiple sentences

COBCH0720 SEQUENTIAL file used as CALL parameter

COBCH0721 - COBCH0740

COBCH0721 Non-SEQUENTIAL file used as CALL parameter

COBCH0722 Data item too small (must be at least 16 characters long)

COBCH0723 USE...GIVING option

COBCH0724 Period follows SKIP1/ 2/ 3 or EJECT

COBCH0725 Function argument invalid, year must be greater than 1600

COBCH0726 Function argument invalid, month must be an integer between 1 and 12

COBCH0727 Function argument invalid, day must be an integer between 1 and 31

COBCH0728 Function argument invalid, day must be an integer between 1 and 366

COBCH0729 OO: parameter-name not specified in USING

COBCH0730 OO: Definition too long

COBCH0731 OO: Syntax matches multiple signatures of signature - first assumed

COBCH0732 OO: Signature signature does not match or data name data-name not declared

COBCH0733 OO: FUNCTION not permitted - no RETURNING/GIVING phrase specified

COBCH0734 OO: FUNCTION cannot use RETURNING/GIVING parameter parameter-name

COBCH0735 OO: Invalid verb/function signature signature

COBCH0736 OO: CLASS class-name not declared

COBCH0737 OO: Object types do not conform (type-1,type-2)

COBCH0738 OO: Signature must contain or exactlyonce

COBCH0739 OO: Signature includes IN, OF or "(" after parameter. May be ambiguous.

COBCH0740 OO: Sorry, too many use signatures of signature to consider

COBCH0741 - COBCH0760

COBCH0741 OO: Only allowed in an instance method

COBCH0742 OO: Implicit use of SELF only allowed in a METHOD

COBCH0743 Expressions in SQL statements not affected by ARITHMETIC directive...

COBCH0744 BY VALUE not allowed in nested programs

COBCH0745 END DECLARATIVES missing

COBCH0746 WHEN OTHER must follow other WHEN phrase

COBCH0747 Object of SUM...UPON phrase is not a detail group for this report

COBCH0748 Index name set to negative value

COBCH0749 Index name set to +0

COBCH0750 Index name set to 0

COBCH0751 Index name augmented by 0

COBCH0752 Complex arithmetic expression used as subscript

COBCH0753 OR phrase in INSPECT BEFORE/AFTER

COBCH0754 Negative integer not allowed

COBCH0755 Special register used with ACCEPT/DISPLAY/EXHIBIT or CALL statement

COBCH0756 TYPEDEF name missing

COBCH0757 POINTER name required

COBCH0758 POINTER item has incorrect type

COBCH0759 Illegal use of logical operator

COBCH0760 INITIALIZE TO VALUE statement

COBCH0761 - COBCH0780

COBCH0761 DELIMITED BY SIZE omitted

COBCH0762 Must be a typed pointer

COBCH0763 RETURNING phrase cannot be used on an ENTRY statement...

COBCH0764 ENTRY statement in a program with a PROCEDURE DIVISION...

COBCH0765 Failed to create directory %1_s

COBCH0766 Failed to create class file (%1_s) %2_s_

COBCH0770 OO: Signature includes IN, OF or "(" after parameter.

COBCH0771 OO: Required or Optional word must not be a verb.

COBCH0772 Illegal combination of ALLOW clauses

COBCH0773 CLASS clause cannot be used with numeric item

COBCH0774 COBOL word contains 31 characters.

COBCH0775 Data item too small - must have at least 4 digits.

COBCH0776 Partial word replacement.

COBCH0777 Only one word allowed with partial word replacement.

COBCH0778 Additional messages suppressed

COBCH0779 The intermediate code may not be portable at the...

COBCH0781 - COBCH0800

COBCH0781 01 Group item must have the EXTERNAL-FORM clause

COBCH0782 Call by number routine x"%1_s" does not exist_

COBCH0789 Pre-compiled header %1_s is incompatible with this compiler

COBCH0790 OO: Invalid method name.

COBCH0791 Pre-compiled header header not found.

COBCH0792 MOVE used with pointer item.

COBCH0793 No PICTURE specified for elementary alphanumeric item.

COBCH0794 KEY specification uses SOURCE syntax.

COBCH0795 END PROGRAM value missing.

COBCH0796 SYNC would cause re-alignment of redefined group - not allowed

COBCH0797 Non-COBOL character character found.

COBCH0799 COLUMN clause requires a SOURCE/SUM/VALUE clause also.

COBCH0800 Bad task request from External Compiler Module

COBCH0801 - COBCH0900

COBCH0801 - COBCH0820

COBCH0801 External Compiler Module message

COBCH0802 Data name defined using SQL syntax too long to...

COBCH0803 Integrated preprocessor message

COBCH0804 Source limit of integer lines exceeded

COBCH0805 Bad directive or option in _IF

COBCH0806 Too many items in CODE-SET FOR clause

COBCH0807 VALUE clause requires a table declaration_

COBCH0808 Maximum number of data items exceeded

COBCH0809 Pseudo-text delimiter missing_

COBCH0810 Reserved word missing - OF expected_

COBCH0811 Number of WHEN phrases _ %1_s

COBCH0812 USAGE NATIONAL - need to compile with NSYMBOL(NATIONAL) directive_

COBCH0813 Feature not yet supported when compiling for _NET

COBCH0814 Feature not supported

COBCH0815 Cannot have an abstract method in a non-abstract class

COBCH0816 CUSTOM-ATTRIBUTE must derive from System_Attribute class

COBCH0817 Exception-name must derive from System_Exception class

COBCH0818 '%1_s' not found or is not an interface

COBCH0819 Interface member '%1_s' or one of its overloads not implemented or not public

COBCH0820 Class '%1_s' not found or is not a delegate class

COBCH0821 - COBCH0840

COBCH0821 Not a valid iterator

COBCH0824 RAISE must specify exception object when not in CATCH...

COBCH0825 Cannot inherit from FINAL class '%1_s'

COBCH0826 Illegal parameter to delegate constructor

COBCH0827 Method has different signature from delegate

COBCH0828 Illegal cast or test - object types do not conform (%1_s, %2_s)

COBCH0829 Could not find method new with this signature

COBCH0830 Attribute class does not have constructor with this signature...

COBCH0831 Illegal specification of named parameter

COBCH0832 Attribute class does not have property '%1_s'

COBCH0833 Invalid value for property '%1_s'

COBCH0834 Property can not be a sending item

COBCH0835 Property cannot be a receiving item

COBCH0836 Method in interface definition must be public

COBCH0837 Procedural code not allowed here

COBCH0838 System limit - Data Division too large _ 256Mbytes_

COBCH0839 System limit - Procedure Division or segment too large_ _ 16Mbytes_

COBCH0840 RETURNING item is incompatible with method return type

COBCH0841 - COBCH0860

COBCH0841 RETURNING item requires implicit cast

COBCH0842 Method has multiple definitions with same signature

COBCH0843 SET PROPERTY must have USING parameter and no RETURNING...

COBCH0844 GET PROPERTY must have a RETURNING parameter

COBCH0845 Unknown class "class-name"

COBCH0846 Invalid use of ANY LENGTH clause

COBCH0847 OBJECT REFERENCE can only have OCCURS at 01 level...

COBCH0848 Can only be used on native data item with...

COBCH0849 Too many types specified for generic class

COBCH0850 Too many constraints specified for generic type

COBCH0851 Methods cannot be nested - END METHOD missing

COBCH0852 System error - unexpected error while generating IL code

COBCH0853 System error - evaluation stack mismatch

COBCH0854 System error - evaluation stack negative

COBCH0855 System error - evaluation stack exceeded limit

COBCH0856 System error - evaluation stack non-empty

COBCH0857 System error - failure during ILASM phase

COBCH0859 System error - peverify has determined that this program is not verifiable

COBCH0858 No static method found - cannot be a main program

COBCH0860 Object references must be specified at 01 level

COBCH0861 - COBCH0880

COBCH0861 Object references must not be redefined

COBCH0862 Object references must not have REDEFINES clause

COBCH0863 Operand must be an ENUM

COBCH0864 All operands in an ENUM expression must be of...

COBCH0865 Failed to find system program '%1_s'

COBCH0866 Illegal combination of visibility attributes

COBCH0867 Cannot jump out of a FINALLY block

COBCH0868 Inherited class '%1_s' not found

COBCH0869 Cannot create an instance of abstract class '%1_s'

COBCH0870 ABSTRACT method cannot be PRIVATE

COBCH0871 ABSTRACT class or method cannot be FINAL

COBCH0872 ABSTRACT method cannot be static

COBCH0873 Program or method name missing

COBCH0874 Interface methods cannot be FINAL

COBCH0875 Property '%1_s' not implemented or not public

COBCH0876 Only one field may be declared in ENUM

COBCH0877 ENUM field must be a numeric field of native...

COBCH0878 ENUM literal must a numeric integer

COBCH0879 ENUM literals must follow ENUM field

COBCH0880 VALUETYPE programs cannot inherit

COBCH0881 - COBCH0900

COBCH0881 OCCURS format can only be used with native _NET...

COBCH0882 Only one visibility attribute allowed

COBCH0883 Attribute repeated

COBCH0884 Cannot use ADDRESS OF operator on _NET native type...

COBCH0885 Visibility attributes can only be used with native _NET...

COBCH0886 EVENT can only be specified with objects of delegate...

COBCH0887 Class class-name has multiple definitions

COBCH0888 Illegal comparison for this type

COBCH0889 Illegal operator

COBCH0890 Operator already defined

COBCH0891 '_' operator is defined without matching '__' operator

COBCH0892 '__' operator is defined without matching '_' operator

COBCH0893 '_' operator is defined without matching '_' operator

COBCH0894 '_' operator is defined without matching '_' operator

COBCH0895 '__' operator is defined without matching '__' operator

COBCH0896 '__' operator is defined without matching '__' operator

COBCH0897 Cannot specify reference modification on an object reference

COBCH0898 Ambiguous match for method '%1_s' with this signature

COBCH0899 Class constructors cannot have parameters

COBCH0900 Internal error - Stack overflow_ Inform Technical Support_

COBCH0901 - COBCH1000

COBCH0901 - COBCH0920

COBCH0901 Internal error - Enlarge Memory overflow_ Inform Technical Support_

COBCH0902 Internal error - Restore String invalid_ Inform Technical Support_

COBCH0903 Internal error - Dictionary corruption_ Inform Technical Support_

COBCH0904 Internal error - Stack underflow_ Inform Technical Support_

COBCH0905 Internal error - Invalid tree node_ Inform Technical Support_

COBCH0906 Internal error - Subscript count overflow_ Inform Technical Support_

COBCH0907 Internal error - Debug info buffer overflow_ Inform Technical Support_

COBCH0908 Internal error - Verb processing error_ Inform Technical Support_

COBCH0909 Internal error - Bad numeric descriptor_ Inform Technical Support_

COBCH0910 Internal error - Int code buffer overflow_ Inform Technical Support_

COBCH0911 Internal error - Dictionary heap failure %1_s Inform Technical Support_

COBCH0912 Internal error - Dictionary invalid r_w %1_s Inform Technical Support_

COBCH0913 Internal error - Dictionary open_close failure_ Inform Technical Support_

COBCH0914 Internal error - Dictionary literal size error_ Inform Technical Support_

COBCH0915 Internal error - Error during repository processing_ Inform Technical Support_

COBCH0916 Internal error - Error opening cdi2 handle_

COBCH0917 Internal error - CTF failed_

COBCH0918 Unknown attribute '%1_s'

COBCH0919 An AS expression cannot be used as a receiving...

COBCH0920 Can only INVOKE a method or a constructor

COBCH0921 - COBCH0940

COBCH0921 Comparison operator must return a condition-value

COBCH0922 Comparison operator must have two parameters that belong to...

COBCH0923 Conversion operator must have one parameter and one return...

COBCH0924 Either the parameter or the return type must belong...

COBCH0925 Referenced non-managed module '%1_s' not found

COBCH0926 Array initializer has non-uniform structure_

COBCH0927 Table dimensions are different from original declaration_

COBCH0928 Must be interface implemented by current class_

COBCH0929 Operator must have one parameters

COBCH0930 Operator must have two parameters

COBCH0931 Operator must have one or two parameters

COBCH0932 At least one parameter must be of current class...

COBCH0933 Operator is not defined for operands of this type...

COBCH0934 Only native _NET types are allowed in Valuetype instances...

COBCH0935 Operator parameters must be passed BY VALUE

COBCH0936 Number of operands does not match dimensions of table...

COBCH0937 CUSTOM-ATTRIBUTE %1_s not allowed in this context

COBCH0938 Only native _NET types are allowed to have custom...

COBCH0939 CUSTOM-ATTRIBUTE %1_s is only allowed once

COBCH0940 PROPERTY and EVENT must be specified before CUSTOM-ATTRIBUTE

COBCH0941 - COBCH0960

COBCH0941 Source file %1_s not found

COBCH0942 Could not load assembly '%1_s'

COBCH0943 %1_s is not the name of a generic parameter

COBCH0944 Generic class '%1_s' has wrong number of type arguments

COBCH0945 One or more of the type arguments for '%1_s' violates constraints

COBCH0946 Class, method, property or field is marked as obsolete

COBCH0947 ANY LENGTH item cannot be RETURNING item when compiling...

COBCH0948 Invalid type name

COBCH0949 Cannot use PROPERTY on an item that is subject...

COBCH0950 Too many generic arguments

COBCH0951 System limit - number of multiple inheritance _ 10_

COBCH0952 Method '%1_s' must have the REDEFINE clause_

COBCH0953 Method '%1_s' must have the OVERRIDE or REDEFINE clause_

COBCH0954 Method '%1_s' cannot OVERRIDE a non-virtual method in inherited class_

COBCH0955 Method '%1_s' cannot OVERRIDE a FINAL method in inherited class_

COBCH0956 Method '%1_s' not found in inherited class - must not have the OVERRIDE or REDEFINE clause_

COBCH0957 Explicit interface implementations cannot have visibility attributes_

COBCH0958 Property '%1_s' has multiple definitions

COBCH0959 Invalid _line directive_

COBCH0960 Too many _line directives_

COBCH0961 - COBCH0980

COBCH0961 Overriding method '%1_s' must have visibility 'PRIVATE'_

COBCH0962 Overriding method '%1_s' must have visibility 'INTERNAL'_

COBCH0963 Overriding method '%1_s' must have visibility 'PROTECTED'_

COBCH0964 Overriding method '%1_s' must have visibility 'PROTECTED INTERNAL'_

COBCH0965 Overriding method '%1_s' must have visibility 'PUBLIC'_

COBCH0966 Either all or no dimensions must be specified using...

COBCH0967 Class '%1_s' inherits from itself (directly or indirectly)_

COBCH0968 Collection element has incompatible type

COBCH0969 Cannot access object data from a static method

COBCH0970 Class '%1_s' inherits from more than one base class

COBCH0971 EXTERNAL not allowed with instance data

COBCH0972 Linkage item data-item-1 (or subordinate item) is referenced but has no addressability

COBCH0973 Must specify at least one CATCH or FINALLY clause_...

COBCH0974 Inherited class does not have a default constructor_

COBCH0975 An anonymous method can only be used as a...

COBCH0976 SET CONTENT syntax cannot be used with jagged arrays_...

COBCH0977 Anonymous method signature does not match that of delegate_...

COBCH0978 Anonymous method returning item does not match that of...

COBCH0979 Anonymous method parameter must be new item specified with...

COBCH0980 YIELDING phrase can only be used in the context...

COBCH0981 - COBCH1000

COBCH0981 YIELDING phrase must be used in the context of...

COBCH0982 Statement can only be used in the context of...

COBCH0983 Cannot initialize MicroFocus_COBOL_Compiler_dll_

COBCH0984 Could not find suitable '%1_s' method_

COBCH0985 Attribute class has multiple constructors with equally valid signature...

COBCH0986 A method invoke cannot be a receiving item

COBCH0987 Could not find method '%1_s' with this signature - will generate dynamic call

COBCH0988 Operand must be Boolean

COBCH0989 GROUP-USAGE must be NATIONAL or BIT

COBCH0990 No period following EXEC SQL INCLUDE END-EXEC_ DB2 coprocessor will fail

COBCH0991 A readonly field cannot be a receiving item

COBCH0992 Program requires setting of INTLEVEL(4)

COBCH0993 Number of parameters in CALL (%1_s) different from number in target method (%2_s)

COBCH0994 Illegal function argument

COBCH0995 Iterator parameters must be passed BY VALUE

COBCH0996 A class can only be PUBLIC or INTERNAL

COBCH0997 Feature not yet supported when compiling for _NET - statement ignored

COBCH0998 Can only be PUBLIC or INTERNAL

COBCH0999 PROFILE directive ignored for nested programs

COBCH1000 Open fail _ %1_s

COBCH1001 - COBCH1100

COBCH1001 - COBCH1020

COBCH1001 Character other than *, D, /, -, or $ found in column 7. Blank assumed

COBCH1002 Continuation character invalid at this point. Blank assumed

COBCH1003 First character of a continued literal not a quote...

COBCH1004 Continuation character expected. End of literal assumed

COBCH1005 Name ends in hyphen. Processed as written

COBCH1006 COBOL word contains more than 31 characters. Word truncated

COBCH1007 VALUE literal size size1 > data item size size2. Literal truncated

COBCH1008 DBCS literal must contain an even number of characters...

COBCH1009 Closing delimiter for DBCS literal not found. Delimiter assumed

COBCH1010 Nonnumeric literal has length of zero. One SPACE assumed

COBCH1011 DBCS literal has length of zero. Length of one DBCS character assumed

COBCH1012 DIVISION missing or misspelled. DIVISION assumed

COBCH1013 SECTION missing or misspelled. SECTION assumed

COBCH1014 Period missing. Period assumed

COBCH1015 OCCURS integer-1 exceeds OCCURS integer-2. Zero is assumed for integer-1

COBCH1016 Expected SEPARATE before CHARACTER in SIGN clause. SEPARATE assumed

COBCH1017 REDEFINES ignored for 01 level item in File or...

COBCH1018 VALUE clause not allowed here. Clause processed as comment

COBCH1019 Unsigned numeric literal expected. Sign ignored

COBCH1020 Unsigned numeric field. Sign in VALUE clause ignored

COBCH1021 - COBCH1040

COBCH1021 Slack bytes added in conversion of COMP-6 to COMP

COBCH1022 Table item not subscripted or indexed. First occurrence assumed

COBCH1023 WORKING-STORAGE SECTION expected. Start of Working-Storage assumed

COBCH1024 VALUE clause literal does not conform to PICTURE. Changed to blanks.

COBCH1025 MOVE edited field to edited field - treated as alphanumeric move

COBCH1026 Source literal is nonnumeric - substituting zero

COBCH1027 Literal is numeric - treated as nonnumeric

COBCH1028 Statement should not reference an alphabetic data item

COBCH1029 A non-integer is being moved to an alphanumeric data item

COBCH1030 Cannot SORT or MERGE USING or GIVING two files...

COBCH1031 SORT file appears in more than one SAME SORT...

COBCH1032 Filenames illegally specified in same SAME RECORD AREA clause...

COBCH1033 Filenames illegally specified in same SAME SORT (-MERGE) AREA clause

COBCH1034 Source item is ALPHABETIC or ALPHANUMERIC-EDITED - treated as alphanumeric

COBCH1035 Key is not wholly contained within minimum record length...

COBCH1036 External name illegal

COBCH1037 Data-name must be specified for an EXTERNAL record - EXTERNAL ignored

COBCH1038 RECORD key or ALTERNATE key has same starting position...

COBCH1039 Error in structure information. No structure diagram created

COBCH1040 ALL not allowed here - ALL ignored

COBCH1041 - COBCH1060

COBCH1041 Data item has zero size, or group not yet completed. Value of 0 assumed

COBCH1042 A numeric item is being moved to an ALPHABETIC...

COBCH1043 PERFORM may be recursive

COBCH1044 Load failure on SLOAD - STRUCT ignored

COBCH1045 Capacity of POINTER may be exceeded

COBCH1046 Host variable name might cause problems

COBCH1047 Phrase ignored - unsuccessful chain will cause program termination

COBCH1048 DBCS literal includes invalid data

COBCH1049 KEY clause not allowed with sequential READ - clause ignored

COBCH1050 Invalid condition in $IF

COBCH1051 Value evaluated left to right, differs from normal arithmetic precedence

COBCH1052 ALL specified more than once - repeated occurrences ignored

COBCH1053 Multiple 01 level EXTERNAL records with same name - treated as same record

COBCH1054 Variable length group redefines or is redefined

COBCH1055 Requested SQLSTDLVL incompatible with your version of DBM. Directive ignored

COBCH1056 CALL-CONVENTION does not match that specified in prototype

COBCH1057 REFERENCE/ CONTENT/ VALUE phrase does not match that specified in prototype

COBCH1058 Number of parameters is greater than in prototype

COBCH1059 Parameter is not consistent with that defined in prototype...

COBCH1060 Can only use DELIMITED with alphanumeric items

COBCH1061 - COBCH1080

COBCH1061 Number of parameters is less than in prototype

COBCH1062 Not allowed in EXTERNAL program

COBCH1063 EXTERNAL not allowed with nested, INITIAL or COMMON programs - ignored

COBCH1064 Illegal use of literal

COBCH1065 OO: SELF only allowed in CLASS program

COBCH1066 OO: SUPER not allowed - CLASS has no INHERITING phrase

COBCH1067 OO: RETURNING phrase not allowed in METHOD

COBCH1068 OO: Class name class-name missing in SPECIAL-NAMES - assumed

COBCH1069 Identifier in area A assumed procedure name. Period missing before it

COBCH1070 OO: Incorrect structure of CLASS program

COBCH1071 OO: Missing OBJECT-STORAGE SECTION, required for inheritance

COBCH1072 OO: Not allowed in PROGRAM-ID. OBJECT

COBCH1073 LOCAL-STORAGE should be used with PERFORM-TYPE(MF).

COBCH1074 OO: INVOKE data-item not yet supported by OOPS run-time

COBCH1075 Invalid combination of RECORD and RECORDING MODE clauses

COBCH1076 Reference modified length should not be > 8191 at run-time

COBCH1077 Host variable name longer than permitted by database engine...

COBCH1078 Setting of directives inline / conditional compilation

COBCH1079 Expected positive integer, positive integer assumed

COBCH1080 Odd number of hexadecimal digits

COBCH1081 - COBCH1100

COBCH1081 More than 255 BLL Cells

COBCH1082 Source line is too long

COBCH1083 RECORDING MODE IS F specified for a variable length...

COBCH1084 OO: Missing OBJECT-STORAGE SECTION, required for class extension

COBCH1085 Created subordinate data item item

COBCH1090 Literal contains SBCS Katakana characters

COBCH1091 Literal contains DBCS or SBCS Katakana characters

COBCH1092 SBCS Katakana character usage in source is not portable...

COBCH1094 NOPRESERVECASE not supported with ILGEN. Consider removing NOPRESERVECASE.

COBCH1101 - COBCH1200

COBCH1101 - COBCH1120

COBCH1101 No COBOL statement between periods

COBCH1102 Blank continuation source line. Line ignored

COBCH1103 Sequence number out of order or missing

COBCH1104 77 level item in File Section. Processed as 01 level

COBCH1105 No CORRESPONDING items were found. Statement has no effect

COBCH1106 ZERO value for BY operand. Statement processed as written

COBCH1107 Statement exceeds COMP subset

COBCH1108 Signed numeric compared with group. Processed as alphanumeric compare

COBCH1109 WITH DEBUGGING MODE not specified. Section ignored

COBCH1110 First literal is greater than second. Processed as written

COBCH1111 Boundary violation. Processed as written

COBCH1112 Compatibility directive forcing non standard behaviour

COBCH1113 Imperative statement missing - CONTINUE assumed

COBCH1114 Clause treated as documentary

COBCH1115 SAME AREA treated as SAME RECORD AREA

COBCH1116 ACCEPT qualifier used with display-only field - qualifier ignored

COBCH1117 Zero suppression follows floating insertion - treated as floating insertion

COBCH1118 Index-name belongs to different table

COBCH1119 Record size size1 < minimum size given in FD statement size2

COBCH1120 Record size size1 > maximum size given in FD statement size2

COBCH1121 - COBCH1140

COBCH1121 VALUE in File, Linkage, or Local-Storage Section - processed as comment

COBCH1122 Period must be followed by a space

COBCH1123 Neither NAMED nor CHANGED specified. Will be treated as formatted DISPLAY.

COBCH1124 CALL parameter is literal (or LENGTH OF). BY CONTENT assumed

COBCH1125 Punctuation character not followed by a space. Assume space

COBCH1126 Punctuation character not preceded by a space. Assume space

COBCH1127 Double-Byte character(s) might be corrupted by use of this move

COBCH1128 No STOP RUN, GOBACK, or EXIT PROGRAM statements encountered in source

COBCH1129 Statement cannot be reached

COBCH1130 Prefix of filename treated as documentary

COBCH1131 Statement generated no executable code

COBCH1132 Unable to validate contents of DBCS literals

COBCH1133 SQL warning/ recoverable error

COBCH1134 Entry name has been converted following OS/VS COBOL and VS COBOL II rules

COBCH1135 No OPEN statement was found for file

COBCH1136 No CLOSE statement was found for file

COBCH1137 "KEPT" omitted for file with multiple record locking

COBCH1138 Name truncated to characters characters

COBCH1139 Operand operand does not have suitable data type

COBCH1140 VALUE in FILE or LINKAGE SECTION - only used with INITIALIZE statement

COBCH1141 - COBCH1160

COBCH1141 Name longer than 8 characters

COBCH1142 Name includes characters that would be changed by OS...

COBCH1143 Name includes characters that would be illegal for OS...

COBCH1144 String will be null terminated when returned by SQL...

COBCH1145 DUPLICATES phrase with keys generates slower sort; remove if possible

COBCH1146 procedure-name lies in more than one PERFORM THRU range

COBCH1147 End precedes start in PERFORM procedure-name THRU procedure-name

COBCH1148 Segmentation specified in nested program.

COBCH1149 Operand data-name ambiguous in corresponding target

COBCH1150 Redefinition of internal floating-point item. Might not be portable

COBCH1151 Forward overlapping move might produce unpredictable results

COBCH1152 Comparison involving floating point data might not be portable...

COBCH1153 Some mainframe values for this data-type cannot be handled on PC

COBCH1154 PC allows values for this data-type that cannot be handled on mainframes

COBCH1155 Both PANVALET and LIBRARIAN specified - not mainframe compatible

COBCH1156 BLOCK or LABEL clause in SD not allowed. Ignored

COBCH1157 JUSTIFIED specified on edited field

COBCH1158 CBL PROCESS *CBL or *CONTROL record encountered. Directives ignored

COBCH1159 Portion of name following first "-" treated as documentary.

COBCH1160 Changes before first statement cannot be checked. Ignored

COBCH1161 - COBCH1180

COBCH1161 Paragraph/section definition has changed. Ignored

COBCH1162 Attempt to define item as procedure. Ignored

COBCH1163 Animator restriction - can't check this statement

COBCH1164 Too many basic blocks for TESTCOVER to work

COBCH1165 GIVING option treated as documentary

COBCH1166 BLANK WHEN ZERO phrase ignored

COBCH1167 Use of COMP-5 data type

COBCH1168 COMP-5 redefinition

COBCH1169 Reference modification on a COMP-5 item

COBCH1170 A non-integer operand cannot be compared with a nonnumeric operand

COBCH1171 Numeric class test on a group containing a signed...

COBCH1172 Improper BLL Cell List item

COBCH1173 BLL Cell Addressability invalid

COBCH1174 Comparison of numeric literal with numeric literal

COBCH1175 Synchronization non-optimal

COBCH1176 SLiteral is greater in length than data item

COBCH1181 - COBCH1200

COBCH1181 Operand "%1_s" should be numeric

COBCH1182 Comparison between two ALL literals is not allowed

COBCH1183 EXAMINE TALLYING requires the TALLY special register_

COBCH1184 CBL PROCESS record invalid here

COBCH1201 - COBCH1300

COBCH1201 - COBCH1220

COBCH1201 Zero suppression PICTURE string overrides the BLANK WHEN ZERO...

COBCH1202 Original item is larger than redefinition (size1 > size2)

COBCH1203 LABEL clause processed as comment

COBCH1204 BLOCK CONTAINS clause processed as comment

COBCH1205 Previous paragraph or section contains no statements

COBCH1206 Procedure Division does not start with a section

COBCH1207 Original item is smaller than redefinition (size1 < size2)

COBCH1208 USE clause omitted

COBCH1209 COMP-5 is machine specific format. (Future occurrences not indicated)

COBCH1210 COMP processed as usage (future occurrences not indicated)

COBCH1211 COMP-6 processed as COMP (future occurrences not indicated)

COBCH1212 COMP-1 processed as PIC S9(4) COMP (future occurrences not indicated)

COBCH1213 COMP-0 field exceeds S9(5), converted to USAGE DISPLAY

COBCH1214 COMP-0 processed as PIC S9(4) COMP (future occurrences not indicated)

COBCH1215 UNIT phrase processed as comment

COBCH1216 Literal exceeds 160 characters

COBCH1217 procedure-name same as level 78 name

COBCH1218 RERUN clause processed as comment

COBCH1219 No REPLACE currently in effect

COBCH1220 COMP-4 processed as PIC S9(9) COMP (future occurrences not indicated)

COBCH1221 - COBCH1240

COBCH1221 COMP-4 field exceeds S9(10), converted to USAGE DISPLAY

COBCH1222 COMP-3 unsigned, converted to signed COMP-3

COBCH1223 BLANK WHEN ZERO clause overrides the zero suppression PICTURE...

COBCH1224 MEMORY SIZE clause processed as comment

COBCH1225 MULTIPLE FILE TAPE clause processed as comment

COBCH1226 COMMON can only be used in nested program - processed as comment

COBCH1227 Scope terminator value generated implicitly

COBCH1228 Word non-portable; reserved in OS/400

COBCH1229 Word non-portable; reserved in VSC2(3)

COBCH1230 Word non-portable; reserved in OS/2 COBOL

COBCH1231 Syntax is non-conforming SAA

COBCH1232 Use of early-release MF syntax

COBCH1233 item directive or parameter is early-release

COBCH1234 item is CORRESPONDING item in statement

COBCH1235 Conflicting definition of level 78 item item

COBCH1236 Duplicate, equivalent definition of level 78 item

COBCH1237 File handling used with REENTRANT directive

COBCH1238 Conflict with REENTRANT directive and user code or other...

COBCH1241 - COBCH1260

COBCH1241 Results incompatible with BS2000 if src table length > dest table length

COBCH1242 USAGE must be DISPLAY for entries in a group...

COBCH1243 Non-positive value changed to 1

COBCH1244 WITH NO ADVANCING phrase has no effect for CONSOLE...

COBCH1245 Should be in upper case

COBCH1246 One or more operands are missing and have taken...

COBCH1247 Truncated MOVE. Source length (length) exceeds target length (length)

COBCH1248 Function argument invalid, date YYYYMMDD must be greater than 15821014

COBCH1249 Function argument invalid, date YYYYDDD must be greater than 1582287

COBCH1250 Use of intrinsic funtion module or function not in...

COBCH1252 Requires an abstract machine level of 4 or greater...

COBCH1253 THRU not allowed with boolean items

COBCH1254 Job variable name is too long

COBCH1255 Literal exceeds 180 characters

COBCH1259 GO TO target outside current section

COBCH1300 Expected Interface name.

COBCH1261 - COBCH1280

COBCH1261 Conversion operator must have mutually incompatible parameter and return...

COBCH1262 A method without a returning item cannot be a...

COBCH1263 PARAMS may only be specified for a single dimensional...

COBCH1264 Only '_' and 'NOT _' allowed for comparisons with NULL

COBCH1265 Cannot compare a value type with NULL

COBCH1266 Incompatible options specified, %1_s and %2_s

COBCH1267 Can only INVOKE self__new or super__new as first statement...

COBCH1268 A static file cannot reference instance items

COBCH1269 Visibility attributes cannot be used with local data

COBCH1270 SIZE OF operator can only be used with single...

COBCH1301 - COBCH1400

COBCH1301 - COBCH1320

COBCH1301 Expected Class name.

COBCH1302 Expected Class or Interface name.

COBCH1303 PROPERTY clause only allowed in Object or Factory.

COBCH1304 Method not found in the repository.

COBCH1305 Universal Object Reference is not allowed.

COBCH1306 Redefintion of an Object Reference is illegal.

COBCH1307 Object Reference with REDEFINES clause is illegal.

COBCH1308 VALUE clause is illegal with Object Reference or Pointer...

COBCH1309 INPUT-OUTPUT section not allowed.

COBCH1310 Not allowed in a FACTORY or OBJECT definition.

COBCH1311 Not allowed in a METHOD definition.

COBCH1312 Not allowed in the outer level of a Class...

COBCH1313 Not allowed in an INTERFACE definition.

COBCH1314 LOCK MODE clause must be specified in the File...

COBCH1315 Illegal use of floating-point item %1_s

COBCH1316 Non-integer moved to alphanumeric item %1_s

COBCH1317 Method '%1_s' not found in this class_

COBCH1318 Cannot resolve forward reference of method in an inline...

COBCH1319 Clause from the REPOSITORY paragraph expected_

COBCH1320 HOSTNUMCOMPARE(1)_HOSTNUMMOVE(1) may be removed in future releases

COBCH1321 - COBCH1340

COBCH1321 Cannot have REFERENCE to a value type - omit OBJECT REFERENCE_

COBCH1322 Cannot specify BEFORE or AFTER with TRAILING option_

COBCH1323 Cannot mix TRAILING option with other INSPECT phrases_

COBCH1324 Invalid HANDLE field_

COBCH1325 WHEN OTHER follows other WHEN clause_

COBCH1326 Level 78 literal too long_

COBCH1327 Cannot specify PROPERTY subsidiary to PROPERTY ALL_

COBCH1401 - COBCH1500

COBCH1401 - COBCH1420

COBCH1401 OO_ Class '%1_s' can not inherit from itself_

COBCH1402 OO_ Class '%1_s' directly or indirectly inherits class '%2_s'_

COBCH1403 OO_ External name is illegal_

COBCH1404 OO_ Repository information for externalised class name '%1_s' not found_

COBCH1405 OO_ Externalised class name '%1_s' has FINAL clause and can not be inherited_

COBCH1406 OO_ Class name '%1_s' is not defined in the REPSOITORY paragraph_

COBCH1407 OO_ Interface name '%1_s' is not defined in the REPSOITORY paragraph_

COBCH1408 OO_ Class or Interface name '%1_s' is not defined in the REPSOITORY paragraph_

COBCH1409 OO_ EXPANDS phrase is illegal in a parameterised Class...

COBCH1410 OO_ The number of Actual parameters and Formal paramters...

COBCH1411 OO_ Expanded Class or Interface name '%1_s' is invalid_

COBCH1412 OO_ Expanded Class or Interface parameter name '%1_s' is invalid_

COBCH1413 OO_ Number of Expanded Class or Interface parameters do...

COBCH1414 OO_ Class or Interface name expected_

COBCH1415 OO_ Reserved word USING expected_

COBCH1416 OO_ There must be USING parameters_

COBCH1417 OO_ Method '%1_s' must not have the OVERRIDE clause_

COBCH1418 OO_ Method '%1_s' must have the OVERRIDE clause_

COBCH1419 OO_ Inherited method '%1_s' must not have the FINAL clause_

COBCH1420 OO_ Parameters of method '%1_s' do not conform _

COBCH1421 - COBCH1440

COBCH1421 OO_ Parameters of Method '%1_s' do not conform to Repository_

COBCH1422 OO_ Call Convention of '%1_s' does not match that in the Repository_

COBCH1423 OO_ Number of parameters of '%1_s' does not match Repository entry_

COBCH1424 OO_ The Prototype for Method '%1_s' was not found_

COBCH1425 OO_ Duplicated Internal Method name '%1_s'_

COBCH1426 OO_ Duplicated External Method name '%1_s'_

COBCH1427 OO_ Method_Function '%1_s" does not have a RETURNING clause defined_

COBCH1428 OO_ Method %1_s in interface %2_s not implemented_

COBCH1429 OO_ Method %1_s does not conform to that in class_interface %2_s

COBCH1441 - COBCH1460

COBCH1450 PIC 1 with CHARSET(EBCDIC) not supported

COBCH1451 Boolean with reference modification not supported

COBCH1452 MOVE of boolean to and from national not supported...

COBCH1453 PIC 1 with VALUE FROM not supported

COBCH1454 PIC 1 with JUSTIFIED clause not supported

COBCH1455 Sliding items after PIC 1 table not supported

COBCH1456 Sliding PIC 1 items not supported

COBCH1457 PIC 1 fields > not supported

COBCH1458 PIC 1 fields > not supported. (Group-usage size: )

COBCH1459 Only '=' and 'NOT=' allowed for boolean data items

COBCH1460 Arithmetic operator not allowed in boolean expression

COBCH1461 - COBCH1480

COBCH1461 To enable boolean literals BINLIT(BOOLEAN) must be specified

COBCH1462 KEY may not be of type boolean

COBCH1463 Boolean argument required

COBCH1464 Boolean argument not allowed

COBCH1465 Function BOOLEAN-OF-INTEGER, bit length needs to be an integer constant

COBCH1466 Boolean parameter must be aligned on a byte boundary...

COBCH1467 Cannot pass boolean BY VALUE

COBCH1468 RETURNING boolean not supported

COBCH1480 Illegal use of condition name

COBCH1481 - COBCH1500

COBCH1481 Boundary violation_ Processed as maximum value (%1_s)

COBCH1492 Ambiguous type name '%1_s, could refer to either '%2_s' or '%3_s'

COBCH1498 Preprocessor file logic error

COBCH1500 Memory allocation failure - module_ '%1_s'

COBCH1501 - COBCH1600

COBCH1501 - COBCH1520

COBCH1501 Insufficient memory

COBCH1502 Open fail _ '%1_s'

COBCH1503 Read error_ '%1_s'

COBCH1504 I-O error _ %1_s %2_s

COBCH1505 I-O error _ IDY file

COBCH1506 Checker _ pointer or index invalid - module_ '%1_s'

COBCH1507 Illegal command line

COBCH1508 Unknown XFD directive_ '%1_s'

COBCH1509 Missing '_' in XFD directive

COBCH1510 XFD value should be a name_ %1_s

COBCH1511 XFD value should be numeric_ %1_s

COBCH1512 XFD value should be a literal_ %1_s

COBCH1513 GROUP expected after USE

COBCH1514 Date format missing

COBCH1515 Missing field name after WHEN

COBCH1516 Condition value too long (%1_s max)

COBCH1517 Invalid date format

COBCH1518 Field %1_s causes duplicate data data

COBCH1519 Too many AND_OR conditions (50 max)

COBCH1520 Error - duplicate file name

COBCH1521 - COBCH1540

COBCH1521 Error - when field not found

COBCH1522 Error - internal XFD error 23

COBCH1523 Internal error - occurs inconsistency

COBCH1524 Error - invalid directive combination

COBCH1525 Error - XSL information too long

COBCH1526 Error - insufficient memory

COBCH1527 Internal error - not enough attributes (NO LONGER USED)

COBCH1528 File %1_s _ no matching field for condition %2_s

COBCH1529 Warning - directive word too long _ %1_s

COBCH1530 File %1_s _ variable filename requires "File" directive

COBCH1531 Warning - field %1_s causes duplicate database data

COBCH1532 Warning - field %1_s causes duplicate data

COBCH1533 Warning - %1_s not unique in first 30 characters

COBCH1534 File %1_s _ data missing from key segment %2_s

COBCH1535 File %1_s _ bad picture for date field %2_s

COBCH1536 XFD directive line continuation error - XFD directive ignored

COBCH1537 XFD WHEN directive mismatched parentheses

COBCH1538 XFD WHEN directive syntax error

COBCH1539 VALUE clause not allowed in conjunction with OCCURS ANY...

COBCH1540 Only available with XMLPARSE(XMLSS) compiler option

COBCH1541 - COBCH1560

COBCH1541 XML-SCHEMA %1_s missing or illegal

COBCH1542 ACU threading syntax is not supported

COBCH1543 This ACU syntax is not supported

COBCH1544 ACU ACCEPT_DISPLAY extension is not supported

COBCH1545 Feature not yet supported when compiling for JVM

COBCH1546 Not allowed with DELEGATE programs

COBCH1547 Constructors cannot have a RETURNING item

COBCH1548 A concatenation expression cannot be used as a receiving...

COBCH1549 Concatenation expression has too many operands

COBCH1550 FOR interface not implemented by this class

COBCH1551 Recursive use of TYPEDEF name

COBCH1552 Perform range too large or complex

COBCH1553 Warning - JVM classpath %1_s is ignored

COBCH1554 Error - More than 65535 statements in a paragraph. Cannot produce debugging information

COBCH1555 Cannot access object data declared in a containing class...

COBCH1556 Invalid JVM runtime: Possibly due to mixing 32 and 64 bit support

COBCH1557 Failed to find JVM type subsystem

COBCH1558 Failed to start JVM

COBCH1559 JVM type support failed: Unexpected failure of operation during operation of type support

COBCH1560 JVM support not loaded: the mfjvmlib library could not be loaded

COBCH1561 - COBCH1580

COBCH1562 $ statement not recognized

COBCH1563 Directive %1$s is deprecated and may be removed in future releases

COBCH1564 First parameter to an extension method must be passed...

COBCH1565 NULL value set on non-included field %1s

COBCH1566 NULL value set on key fields %1$s

COBCH1567 VALUETYPE definition must have at least one instance field...

COBCH1568 VALUETYPE instance field cannot have circular reference

COBCH1569 Could not load ILPINVOKE file '%1$s'

COBCH1570 END name '%1$s' does not match corresponding header name

COBCH1571 ILREF directive failed - file not found or access error

COBCH1572 ILREF directive has invalid type name

COBCH1573 ILREF directive failed - incorrect or corrupt class file format

COBCH1574 Reserved word missing - FROM or THROUGH expected

COBCH1575 SELF and SUPER cannot be receiving items

COBCH1576 REFERENCE parameters not supported for functions in Managed COBOL...

COBCH1577 ILPINVOKE not supported with JVMGEN

COBCH1578 VALUETYPE instance field cannot have VALUE

COBCH1579 VALUETYPE cannot have an explicit parameter-less constructor

COBCH1580 Too many END markers

COBCH1581 - COBCH1600

COBCH1581 Could not load dependent assembly '%1$s'

COBCH1582 ACU DESTROY statement is not supported

COBCH1583 ACU INQUIRE statement is not supported

COBCH1584 ACU MODIFY statement is not supported

COBCH1585 Could not find peverify.exe, required for ILVERIFY(CHECK)

COBCH1600 Property must define at least one of GETTER or...

COBCH1601 - COBCH1700

COBCH1601 - COBCH1620

COBCH1601 Property cannot have parameters

COBCH1602 Indexer must have at least one parameter

COBCH1603 No indexer found for class '%1$s'

COBCH1604 Cannot inherit from interface '%1$s'

COBCH1605 Entry name '%1$s' reserved for use by Micro Focus

COBCH1606 Syntax can only be used with LIST and DICTIONARY...

COBCH1607 Syntax can only be used with DICTIONARY items

COBCH1608 Illegal USAGE in this context

COBCH1609 Property accessor visibility must be stricter than property visibility...

COBCH1610 Cannot specify visibility on both GETTER and SETTER

COBCH1611 Can only specify accessor visibility if property has both...

COBCH1612 ACU picture string not supported

COBCH1613 Syntax error error not allowed

COBCH1614 INSPECT TRAILING match item must be single character item...

COBCH1615 ACU statement COPY RESOURCE not supported; statement ignored

COBCH1616 Can only be used in nested class

COBCH1617 WITH COMPRESSION or WITH ENCRYPTION are only supported in...

COBCH1618 WITH COMPRESSION or WITH ENCRYPTION are only valid for...

COBCH1619 Must specify one generic parameter

COBCH1620 Must specify two generic parameters

COBCH1621 - COBCH1640

COBCH1621 Must specify a method invoke expression with no parameters...

COBCH1622 A SIZE OF expression cannot be used as a...

COBCH1623 Anonymous method or method group cannot be cast to...

COBCH1624 Cannot implicitly convert type1 to type2.

COBCH1625 Cannot convert type1 to type2.

COBCH1626 Invalid test: type1 cannot be instance of type2.

COBCH1627 Preferred syntax uses pseudo-text delimiters (==) instead of quotes

COBCH1628 Cannot determine type of local variable

COBCH1629 REPLACING assumed

COBCH1631 ATTACH and DETACH statements can only be applied to...

COBCH1632 Cannot specify ALL numeric literal

COBCH1633 Procedure division too large or complex - try using performtype(mf)

COBCH1634 Extended ACCEPT/DISPLAY not allowed with a Windows GUI executable (ILSUBSYSTEM"2")

COBCH1635 Interface does not include member

COBCH1636 When compiling for managed code, this feature is supported only in procedural COBOL

COBCH1637 Illegal use of method invoke expression - Use INVOKE verb

COBCH1638 Start key ambiguous; using key key-name-1 (key key-name-2 has same offset)

COBCH1639 Required parameters must be specified before any optional ones...

COBCH1640 Optional parameters cannot be specified with BY REFERENCE OUTPUT...

COBCH1641 - COBCH1660

COBCH1641 Period in source filename or PROGRAM-ID in native code

COBCH1642 Positional parameters must be specified before any named parameters...

COBCH1643 Parameter name specified more than once

COBCH1644 Cannot use KEY phrase with WRITE statement applied to...

COBCH1645 KEY phrase missing

COBCH1646 Cannot DISPLAY a void method

COBCH1647 Resolution of type failed dependent type not found

COBCH1648 LEFT, RIGHT, or CENTERED expected; output phrase ignored

COBCH1649 Quoted PICTURE character-string is an ACUCOBOL extension

COBCH1650 Indicator column contains $ or >, but no directive follows; line ignored

COBCH1651 Operand must be a constant value

COBCH1652 Property initializers must be specified after parameters

COBCH1653 Can only specify property in attribute specification and new...

COBCH1654 Should be elementary; MODE IS BLOCK assumed

COBCH1655 Word var1 is not allowed here; ignoring word for ACUCOBOL compatibility

COBCH1656 Incorrect syntax, VARYING expected; assuming CONTAINS

COBCH1657 ACU file syntax extension is not supported

COBCH1658 VALUE OF FILE-ID overriding ASSIGN

COBCH1659 VALUE clause literal does not conform to PICTURE. Changed to zero.

COBCH1660 Type is not disposable

COBCH1661 - COBCH1680

COBCH1661 Must specify an initial value

COBCH1662 Can only specify a single expression without a local variable definition

COBCH1663 Overlapping Perform Range <n> Entries

COBCH1664 Overlapping Perform Start <section name>

COBCH1665 Cannot use OCCURS DEPENDING ON with object type

COBCH1666 Iterators properties and indexers cannot have reference parameters

COBCH1667 Perform range end before start

COBCH1668 Paragraph procedure-name-1 in perform range contains a GO TO procedure-name2 which causes overlap

COBCH1669 Cannot construct an instance of abstract class class1

COBCH1670 TYPE missing preceding class name class1 - assumed

COBCH1671 Not a valid dictionary iterator

COBCH1672 Dictionary key has incompatible type

COBCH1673 Dictionary value has incompatible type

COBCH1674 Internal dictionary overflow. Program too large

COBCH1675 Could not find event event1

COBCH1676 Anonymous method code cannot include GO TO or out-of-line PERFORM

COBCH1677 Anonymous method code cannot include another anonymous method

COBCH1678 Two parameters have same external name param1

COBCH1679 PIC N (USAGE DISPLAY-1 or no USAGE) only allowed with runtime-encoding set to OEM

COBCH1680 Badly formatted XML comment for name. XML loader message follows

COBCH1681 - COBCH1700

COBCH1681 XML Loader output

COBCH1682 XML comment has cref attribute name that could not be resolved.

COBCH1683 Repeated information for parameter param-name in XML comment for name

COBCH1684 Missing information for parameter param-name in XML comment for name

COBCH1685 Unknown parameter name param-name in XML comment for name

COBCH1686 Ambiguous match for method method-name with this signature - will generate dynamic call

COBCH1687 Only value NULL allowed here

COBCH1688 Level 88 not allowed with value type

COBCH1689 Only valid with ODOSLIDE

COBCH1690 Invalid use of UNBOUNDED group

COBCH1691 Internal literal pool overflow Program too large

COBCH1692 Too many DETAIL groups specified for report

COBCH1699 A constant item cannot be a receiving item

COBCH1700 A CONSTANT item must have a VALUE clause

COBCH1701 - COBCH1800

COBCH1701 - COBCH1720

COBCH1701 A CONSTANT item cannot be a group

COBCH1702 The value of CONSTANT item field1 involves circular definition

COBCH1703 CLSCompliant(false) not needed for <element> as assembly does not have CLSCompliant attribute

COBCH1704 CLSCompliant(true) not allowed for <element> as assembly does not have CLSCompliant attribute

COBCH1705 Parameter type <param1> of <param2> is not CLS compliant

COBCH1706 Member type <member1> of <member2> is not CLS compliant

COBCH1707 Member <member1> is not CLS compliant because it differs from another member only by case

COBCH1708 More than one method method-name exists in class-name requiring parameter truncation

COBCH1710 class-name has no member with name member-name

COBCH1711 class-name has no visible method method-name with param-nos parameter(s)

COBCH1712 class-name has no visible instance method method-name with number parameter(s)

COBCH1713 class-name has no visible static method method-name with number parameter(s)

COBCH1714 class-name has no visible constructor with number parameter(s)

COBCH1715 Best visible overload found in typr-name is member-name which has invalid parameter param-name

COBCH1716 Best visible instance overload found in type-name is method-name which has invalid parameter param-num

COBCH1717 Best visible static overload found in type-name is member-name which has invalid parameter param-num

COBCH1718 Best visible constructor in <type-name> is <member-name> which has invalid parameter <param-num>

COBCH1719 Must specify an EVENT

COBCH1721 - COBCH1740

COBCH1721 type-name has no visible member member-name with no parameters

COBCH1722 class-name has no visible instance member member-name with no parameters

COBCH1723 type-name has no visible static member member-name with no parameters

COBCH1724 With JVMGEN static method 'main' with single string array parameter cannot have a returning item

COBCH1726 ILSMARTLINKAGE class class-name has multiple definitions

COBCH1728 type-name1 does not have public implementation of method method-name of interface type-name2

COBCH1729 type-name1 does not have a public implementation of property property-name of interface type-name2

COBCH1730 type-name1 does not have a public implementation of event event-name of interface type-name2

COBCH1731 type-name1 does not define method method-name of abstract class type-name2

COBCH1732 object-name does not define property property-name of abstract class class-name

COBCH1733 object-name does not define event event-name of abstract class class-name

COBCH1734 object-name has reference to type type-name which was not found

COBCH1735 For UNSTRING on string objects the DELIMITED phrase must be used

COBCH1736 Cannot have both VALUE and KEY phrases

COBCH1737 CREATE can only be used on lists dictionaries and types with a parameter-less constructor

COBCH1738 ILSMARTLINKAGE class class-name-1 has inconsistent definitions

COBCH1739 Identifier is not subordinate to the XML GENERATE identifier

COBCH1740 Subscripted item invalid in this context

COBCH1741 - COBCH1760

COBCH1744 Source line number truncated after max bytes

COBCH1758 A static method or property cannot have the OVERRIDE clause

COBCH1759 Static method or property object-name should have the REDEFINE clause assumed

COBCH1760 REDEFINE on instance method or property is not supported when compiling for JVM

COBCH1761 - COBCH1780

COBCH1761 Feature not yet supported for managed COBOL - ignored

COBCH1762 A parameter with open type cannot be passed by reference or output

COBCH1763 Field or property item1 is more visible than its type type1

COBCH1764 Method method1 is more visible than return type type1

COBCH1765 Method method1 is more visible than parameter type type1

COBCH1766 Reference modification of objects is only allowed on strings and single dimensional arrays

COBCH1767 NLS-CURRENCY-LENGTH directive requires NLS directive

COBCH1768 NLS is not supported with JVMGEN or ILGEN

COBCH1769 Nested Program-id name is not unique

COBCH1770 type1 has no visible method method1

COBCH1771 type1 has no visible instance method method1

COBCH1772 type1 has no visible static method method1

COBCH1773 ORGANIZATION and RECORD DELIMITER clauses have incompatible options RECORD DELIMITER ignored

COBCH1775 The alphabet-name clause referenced by the CODE-SET clause must not specify the literal phrase

COBCH1776 PROPERTY ignored for JVM attributes

COBCH1777 Methods and constructors ignored for JVM attributes

COBCH1778 '%1$s' has no visible method '%2$s' with specified parameter name(s)

COBCH1779 '%1$s' has no visible instance method '%2$s' with specified parameter name(s)

COBCH1780 '%1$s' has no visible static method '%2$s' with specified parameter name(s)

COBCH1781 - COBCH1800

COBCH1781 '%1$s' has no visible constructor with specified parameter name(s)

COBCH1782 '%1$s' has no visible method '%2$s' for which generic parameter type(s) could be inferred

COBCH1783 '%1$s' has no visible instance method '%2$s' for which generic parameter type(s) could be inferred

COBCH1784 '%1$s' has no visible static method '%2$s' for which generic parameter type(s) could be inferred

COBCH1785 For inline signature, parameters must be followed immediately by optional RETURNING or YIELDING

COBCH1787 Data-name '%1$s' at line %2$s in the %3$s is not declared implicit definition created

COBCH1788 Exception: %1$s

COBCH1789 Matching member in inherited '%1$s' is non-virtual

COBCH1790 Illegal use of 'void' type

COBCH1791 ILOUTPUT name '%1$s' does not exist or is not a valid directory

COBCH1792 '%1$s' has no visible method '%2$s' for which generic parameter type(s) conform to constraints

COBCH1793 '%1$s' has no visible instance method '%2$s' for which generic parameter type(s) conform to constraints

COBCH1794 '%1$s' has no visible static method '%2$s' for which generic parameter type(s) conform to constraints

COBCH1795 Found non-static 'main' method with string array parameter - cannot be a main program

COBCH1796 A get/set property cannot override a get property

COBCH1797 A get/set property cannot override a set property

COBCH1798 A get property in a non-abstract class cannot override an abstract get/set property

COBCH1799 A get property cannot override a set property

COBCH1800 A set property in a non-abstract class cannot override an abstract get/set property

COBCH1801 - COBCH1900

COBCH1801 - COBCH1820

COBCH1801 A set property cannot override a get property

COBCH1802 A table initializer expression cannot be a receiving item

COBCH1803 USAGE BINARY Length specifier cannot be less than 1 or greater than 16

COBCH1804 A non-BINARY usage should not have a length specifier

COBCH1814 The RETURNING phrase is not allowed with PROPERTY-ID and INDEXER-ID

COBCH1821 - COBCH1840

COBCH1839 type-name1 does not implement get accessor for property property-name of abstract class type-name2

COBCH1840 type-name1 does not implement set accessor for property property-name of abstract class type-name2

COBCH1881 - COBCH1900

COBCH1900 Internal error - Code generation of SCREEN SECTION exceeded 65535 bytes

COBCH2000 and above

COBCH2nnn directive incompatible with flagging dialect

Code Generation Error Messages

Key to Code Generation Error Messages

COBOP001 - COBOP080

COBOP001 Internal error. Contact Technical Support. (Recoverable)

COBOP002 Attempted to redefine symbol name (Recoverable)

COBOP003 Ran out of memory during optimization. Generate program using NOOPT. (Recoverable)

COBOP006 Read failure on input file, not intermediate code or wrong version (Recoverable)

COBOP012 Dictionary or dynamic paging error (Fatal)

COBOP013 Illegal intermediate code (at nnnnnn in seg mm) (Recoverable)

COBOP014 Too many IF levels (Recoverable)

COBOP019 Program checked with non-optimal alignment. Optimal alignment is opt-align (Cautionary)

COBOP028 Segmented program - GNTANIM ignored (Cautionary)

COBOP035 INT code not produced with ANIM (Cautionary)

COBOP039 Errors detected during creation of intermediate code (Recoverable)

COBOP040 Bad program-id or entry name (Recoverable)

COBOP054 Parameter type cannot be passed by value (Recoverable)

COBOP055 Opcodes file corrupt or unknown machine type (Recoverable)

COBOP056 Option not implemented: "option name" (Recoverable)

COBOP066 Write failure on .IDY file (Recoverable)

COBOP068 IDY file not found - SOURCEASM ignored (Cautionary)

COBOP069 Source file not found - SOURCEASM ignored (Cautionary)

COBOP075 Call-convention not supported (Recoverable)

COBOP076 Inefficient code produced for this statement (Cautionary)

COBOP077 Generated code module too large (limit = limit bytes) (Recoverable)

COBOP078 Too many code relocations (limit = limit, actual = limit (Recoverable)

COBOP079 Too many data relocations (limit = limit, actual = limit (Recoverable)

COBOP080 Too many symbol table entries (limit = limit, actual = limit (Recoverable)

Run-time System Error Messages

Key to Run-Time System Error Messages

COBRT001 - COBRT020

COBRT001 Insufficient buffer space (Recoverable)

COBRT002 File not open when access attempted (Recoverable)

COBRT003 Serial mode error (Recoverable)

COBRT004 Illegal file name (Recoverable)

COBRT005 Illegal device specification (Recoverable)

COBRT006 Index structure corrupt (Recoverable)

COBRT007 Disk space exhausted (Fatal)

COBRT008 Attempt to input from a file opened for OUTPUT (Recoverable)

COBRT009 Directory not found (Recoverable)

COBRT010 File name not supplied (Recoverable)

COBRT011 Process limit reached (Fatal)

COBRT012 Attempt to open a file which is already open (Recoverable)

COBRT013 File not found (Recoverable)

COBRT014 Too many files open simultaneously (Recoverable)

COBRT015 Too many indexed files open (Recoverable)

COBRT016 Too many device files open (Recoverable)

COBRT017 Record error: probably zero length (Recoverable)

COBRT018 Read part record error: EOF before EOR or file open in wrong mode (Recoverable)

COBRT019 Rewrite error: open mode or access mode wrong (Recoverable)

COBRT020 Device or resource busy (Recoverable)

COBRT021 - COBRT040

COBRT021 File is a directory (Fatal)

COBRT022 Illegal or impossible access mode for OPEN (Recoverable)

COBRT023 Illegal or impossible access mode for CLOSE (Recoverable)

COBRT024 Disk input-output error (Recoverable)

COBRT025 Operating system data error (Fatal)

COBRT026 Block I-O error (Fatal)

COBRT027 Device not available (Recoverable)

COBRT028 No space on device (Fatal)

COBRT029 Attempt to delete open file (Recoverable)

COBRT030 File system is read-only (Recoverable)

COBRT031 Not owner of file (Recoverable)

COBRT032 Too many indexed files, or no such process (Recoverable)

COBRT033 Physical I-O error (Fatal)

COBRT034 Incorrect mode or file descriptor (Recoverable)

COBRT035 Attempt to access a file with incorrect permission (Recoverable)

COBRT036 File already exists (Recoverable)

COBRT037 File access denied (Fatal)

COBRT038 Disk not compatible (Fatal)

COBRT039 File not compatible (Fatal)

COBRT040 National Language initialization not set up correctly (Fatal)

COBRT041 - COBRT060

COBRT041 Corrupt index file (Recoverable)

COBRT042 Attempt to write on broken pipe (Recoverable)

COBRT043 File information missing for indexed file (Fatal)

COBRT044 Attempt to OPEN an NLS file in a non-NLS program (Fatal)

COBRT045 Attempt to OPEN an NLS file using incompatible language definition (Fatal)

COBRT047 Indexed structure overflow (Fatal)

COBRT048 Attempt to divide by zero (Fatal)

COBRT051 (message text is intentionally blank)

COBRT055 Routine table overflow (Fatal)

COBRT061 - COBRT080

COBRT064 Incompatible file locking mode (Recoverable)

COBRT065 File locked (Recoverable)

COBRT066 Attempt to add duplicate record key to indexed file (Fatal)

COBRT067 Indexed file not open (Recoverable)

COBRT068 Record locked (Recoverable)

COBRT069 Illegal argument to isam module (Fatal)

COBRT070 Too many indexed files open (Recoverable)

COBRT071 Bad indexed file format (Fatal)

COBRT072 End of indexed file (Fatal)

COBRT073 No record found in indexed file (Fatal)

COBRT074 No current record in indexed file (Fatal)

COBRT075 Indexed data file name too long (Fatal)

COBRT076 Can't create lock file in /isam directory (Fatal)

COBRT077 Internal ISAM module error (Fatal)

COBRT078 Illegal key description in indexed file (Fatal)

COBRT079 COBCONFIG syntax error (Fatal)

COBRT080 Can't convert to/from Unicode codeset (Fatal)

COBRT081 - COBRT100

COBRT081 Key already exists in indexed file (Fatal)

COBRT082 CALL convention not supported (Fatal)

COBRT086 Remote file system failure (Fatal)

COBRT097 Acu library routine is and will remain unimplemented

COBRT098 The library routine is not available in Visual COBOL (<routine-name>) Please contact Micro Focus Customer Care for information

COBRT099 Illegal operation in SORT/MERGE module (Fatal)

COBRT100 Invalid file operation (Fatal)

COBRT101 - COBRT120

COBRT101 Illegal operation on an indexed file (Fatal)

COBRT102 Sequential file with non-integral number of records (Fatal)

COBRT103 Parameter cannot be passed BY VALUE (Fatal)

COBRT104 Null file name used in a file operation (Fatal)

COBRT105 Memory allocation error (Fatal)

COBRT106 Dictionary error (Fatal)

COBRT107 Operation not implemented in this run-time system (Fatal)

COBRT108 Failure to initialize data division (Fatal)

COBRT109 Invalid checksum in run-time system (Recoverable)

COBRT110 Generated code not supported by this RTS (Fatal)

COBRT111 Incompatible Class Library and Run-Time Environment versions (Fatal)

COBRT112 Unable to locate/access the required security key (Recoverable)

COBRT114 Attempt to access item beyond bounds of memory (Fatal)

COBRT115 Unexpected signal (Fatal)

COBRT116 Cannot allocate memory (Fatal)

COBRT117 Bad collating sequence (Fatal)

COBRT118 Symbol not found (Fatal)

COBRT119 Symbol redefined (Fatal)

COBRT120 Symbol string table of zero size (Fatal)

COBRT121 - COBRT140

COBRT121 Symbol is not in TEXT section (Fatal)

COBRT122 Coblongjmp() called below level of cobsavenv() (Fatal)

COBRT123 Unknown relocation type (Fatal)

COBRT124 Communication failure during I/O request to the central file handler

COBRT125 All locks/ current transactions canceled due to exceeding time limit

COBRT126 Record size exceeds system limit (Fatal)

COBRT127 coblongjmp() called from a different thread to cobsetjmp() (Fatal)

COBRT128 Connection to Fileshare Server refused

COBRT129 Attempt to access record zero of relative file (Recoverable)

COBRT130 Connection to Fileshare Server re-established (Recoverable)

COBRT135 File not found (Recoverable)

COBRT136 Corrupt or invalid executable file (Fatal)

COBRT137 Illegal device specification - not mass storage

COBRT138 File closed with lock - cannot be opened (Recoverable)

COBRT139 Record length or key data inconsistency (Recoverable)

COBRT141 - COBRT160

COBRT141 File already open - cannot be opened (Recoverable)

COBRT142 File not open - cannot be closed (Recoverable)

COBRT143 Rewrite/delete in sequential mode not preceded by successful read (Recoverable)

COBRT144 Boundary violation (Recoverable)

COBRT146 No current record defined for sequential read (Recoverable)

COBRT147 Wrong open mode or access mode for read/start (Recoverable)

COBRT148 Wrong open mode or access mode for write (Recoverable)

COBRT149 Wrong open mode or access mode for rewrite/delete (Recoverable)

COBRT151 Random read on sequential file (Recoverable)

COBRT152 REWRITE on file not opened I-O (Recoverable)

COBRT153 Subscript out of range (Fatal)

COBRT154 PERFORM nested too deeply (Fatal)

COBRT155 Illegal command line (Fatal)

COBRT156 Too many parentheses in compute statement (Fatal)

COBRT157 Not enough program memory: object file too large to load (Recoverable)

COBRT158 Attempt to REWRITE to a line-sequential file (Recoverable)

COBRT159 Malformed line-sequential file (Recoverable)

COBRT160 Overlay loading error (Recoverable)

COBRT161 - COBRT180

COBRT161 Illegal intermediate code (Fatal)

COBRT162 Arithmetic overflow or underflow (Fatal)

COBRT163 Illegal character in numeric field (Fatal)

COBRT164 Run-Time subprogram not found (Fatal)

COBRT165 Version number incompatibility (Fatal)

COBRT166 Recursive COBOL CALL is illegal (Fatal)

COBRT167 Too many USING items (Fatal)

COBRT168 Stack overflow (Fatal)

COBRT169 Illegal configuration information (Fatal)

COBRT170 System program not found (Fatal)

COBRT171 Japanese operations illegal with this RTS (Fatal)

COBRT173 Called program file not found in drive/directory (Fatal)

COBRT174 Imported file not found (Fatal)

COBRT175 Attempt to run intermediate code program which had severe errors in it (Fatal)

COBRT176 Illegal intersegment reference (Fatal)

COBRT177 Attempt to cancel program failed (Fatal)

COBRT179 Error during chain (program not found) (Fatal)

COBRT180 End-of-file marker error (Fatal)

COBRT181 - COBRT200

COBRT181 Invalid parameter error (Fatal)

COBRT182 Console input or console output open in wrong direction (Fatal)

COBRT183 Attempt to open line sequential file for I-O (Fatal)

COBRT184 ACCEPT/DISPLAY I-O error (Fatal)

COBRT185 File malformed (Recoverable)

COBRT186 Attempt to open stdin, stdout or stderr with incorrect mode (Recoverable)

COBRT187 Run-time system not found on $COBDIR path (Fatal)

COBRT188 Filename too large (Fatal)

COBRT189 Intermediate code load error (Fatal)

COBRT190 Too many arguments to CALL (Fatal)

COBRT191 Terminal type not defined (Fatal)

COBRT192 Required terminal capability description missing (Fatal)

COBRT193 Error in variable length count (Fatal)

COBRT194 File size too large (Fatal)

COBRT195 DELETE/REWRITE not preceded by a read (Fatal)

COBRT196 Record number too large in relative or indexed file (Fatal)

COBRT197 Screen handling system initialization error (Fatal)

COBRT198 Load failure (Fatal)

COBRT199 Operating System error code lies outside expected range (Fatal)

COBRT200 Run-time system internal logic error (Fatal)

COBRT201 - COBRT220

COBRT201 I-O error in paging system (Fatal)

COBRT203 CALL parameter not supplied (Fatal)

COBRT205 Invalid mainframe pointer value (Fatal)

COBRT206 Reading unwritten data from memory (Fatal)

COBRT207 Machine does not exist (Recoverable)

COBRT208 Error in multi-user system (Fatal)

COBRT209 Network communication error (Recoverable)

COBRT210 File is closed with lock (Fatal)

COBRT211 Program not executable by Run-Time System (Fatal)

COBRT212 Run-Time System version incompatible with object-oriented program (Fatal)

COBRT213 Too many locks (Recoverable)

COBRT214 GO TO has not been ALTERed (Fatal)

COBRT215 Cannot DEBUG a program running COMMUNICATIONS (Fatal)

COBRT216 Cannot initialize the named communications device (Fatal)

COBRT217 Incompatible host for native code file (Fatal)

COBRT218 Malformed MULTIPLE REEL/UNIT file (Fatal)

COBRT219 Operating system shared file limit exceeded (Recoverable)

COBRT220 Attempt to execute more than one SORT or MERGE simultaneously (Fatal)

COBRT221 - COBRT240

COBRT221 Internal sort error (Fatal)

COBRT222 Merge files out of sequence (Fatal)

COBRT223 NLS language expansion error (Fatal)

COBRT224 External Language Initialization failure

COBRT225 Dynamic load error - program component missing (Fatal)

COBRT226 EXTERNAL file definition inconsistent

COBRT227 EXTERNAL data definition inconsistent (Fatal)

COBRT228 Could not allocate memory for EXTERNAL item (Fatal)

COBRT229 SORT/MERGE module does not support EXTERNAL using/giving files (Recoverable)

COBRT230 SORT RETURN attempted after the at end condition was returned

COBRT231 GENERATE encountered before corresponding INITIATE in report (Fatal)

COBRT232 Reference modification out of bounds

COBRT235 Error in debugger communications channel (Fatal)

COBRT236 Debugged program has terminated unexpectedly (Fatal)

COBRT237 Unable to initialize debugged process (Fatal)

COBRT238 STOP RUN encountered during GNT animation (Informational)

COBRT239 Shared run-time system initialization failure (Informational)

COBRT240 Object reference not valid (Fatal)

COBRT241 - COBRT260

COBRT241 Cannot instantiate an abstract class (Fatal)

COBRT242 Could not resolve DoesNotUnderstand message (Fatal)

COBRT243 Class could not be loaded (Fatal)

COBRT244 Licensing initialization error (Fatal)

COBRT245 There are no valid product licenses (Fatal)

COBRT246 Maximum number of product licenses exceeded (Fatal)

COBRT247 Licensing error (Fatal)

COBRT250 Not enough mainframe address space to load or run the program (Fatal)

COBRT251 Attempt to load AMODE(24) program when current setting is AMODE(31) only (Fatal)

COBRT252 Memory corruption detected (Fatal)

COBRT253 Cannot load file - unsupported format (Fatal)

COBRT254 Keyboard interrupt to ANIMATOR during ACCEPT (Fatal)

COBRT255 CODESET cannot open double byte conversion table

COBOL Preprocessor Error Messages

COBCP001 Undefined internal error - contact Technical Support

COBCP101 Illegal command line

COBCP103 Open fail: filename

COBCP104 Open fail: filename

COBCP105 Call to stacked preprocessor name failed

COBCP106 Stacked preprocessor returned an error

COBCP107 Unable to open a heap

COBCP200 Internal stack full - contact your support representative

COBCP201 File error - contact Technical Support

COBCP202 Copybook filename not found

COBCP203 Nested REPLACING is not allowed

COBCP204 Statement begins in wrong area of source

COBCP205 HTML splitter error err-code

COBCP206 Bad format of COPY statement - COPY ignored

IDE Information Messages

COBQA0001 - COBQA0003

COBQA0001: Name can be simplified

COBQA0002 - Use portable COBOL syntax instead

COBQA0003 - Extract selected code to a new copybook

Explanation of Error Codes

File Handling Reference

Compiler Directives - File Handling

File Handler

Configuration File

Format of the Configuration File

Path and filename tag

File Control Description (FCD)

Configuration File Options

Data Structures

Global Information Area

Key Definition Area

Component Definition Area

Operation Codes

Standard Operation Codes

Standard Operation Codes - Overview

Special Operation Codes

Special Operation Codes - Overview

FSView

FSVIEW API

FSV-C-add-to-dbase-list

FSV-C-add-to-user-list

FSV-C-add-to-file-list

FSV-C-auto-rename-logfile

FSV-C-shutdown-server

FSV-C-change-server

FSV-C-check-password

FSV-C-close-file

FSV-C-close-user-file

FSV-C-get-comms-info

FSV-C-get-database-info

FSV-C-get-files-users

FSV-C-get-log-file-info

FSV-C-get-open-files

FSV-C-get-open-user-files

FSV-C-get-server-info

FSV-C-shutdown-server

FSV-C-toggle-open-trace

FSV-C-toggle-trace

FSV-C-toggle-XFH-trace

FSVIEW-C-TERM

FSVIEW

Redirection of Information

Command Files

FSVIEW Command Line Syntax

File Status

Extended File Status Codes

Microsoft COBOL V2 File Status Codes

File Structures

Files without Headers

Line Sequential File Structure

Printer Sequential File Structure

Fixed Format Record Sequential File

Fixed Format Relative File

Files with Headers

Standard File Header

Standard Record Header

Variable Format Record Sequential File

Variable Format Relative Structure

Indexed Files

Types of Indexed File

Index File

Index Files - Overview

Index File - File Header

Index File - Free Space Record

Index File - Key Information Record

Index File - Index Node Record

Data File

Indexed File - Data File Structure

Library Routines

Limits

Limits - Overview

File Handling - COBOL Compiler Limits

File Handling - Run-time Limits

File Size Limits - General

Indexed File Size Limits

Sequential and Relative File Size Limits

File Handling - Operating System Limits

Rebuild Command Line Options

Rebuild Options - Overview

Rebuild Options - //q

Rebuild Options - //v

Rebuild Error, Information and Warning Messages

Syntax Errors

Key positions must be specified using /k option

Data compression out of range

Data compression specified more than once

Input file same as output file

Index compression out of range

Index compression specified more than once

Invalid command line

Invalid compression choice - must be 'd' or 'i'

Invalid format

Invalid key length - cannot be zero

Invalid key specification - key not contained in record

Invalid key start - cannot be zero

Invalid key structure - '+' expected

Invalid option

Invalid organization

Invalid organization - must be indexed for index rebuild

Invalid record length - cannot be zero

Invalid record lengths - maximum must not be less than minimum

Invalid record parameter - '-' expected

Invalid record type - 'F' or 'V' expected

Invalid format

No output file specified for /t option to refer to

No output file specified for data compression

Number expected

Output organization was specified but not output file name

Options file not found

Execution Errors

***Error on input file - disk space exhausted

***Error on input file - duplicate key - record not written:

***Rebuild aborted - file is not as specified in s option (s option not required)

***Error on input file - File locked

***Error on input file - file not found

***Error on input file - illegal filename specified

***Error on input file - invalid key of reference specified in x option

***Error on input file - status xx, and ***Error on input file - status 9/yyy

***Error on output file - record length << min or >> max

***Error on output file - status xx, and ***Error on output file - status 9/yyy

Information Messages

Rebuild successful

Records processed

Warning Messages

Option ignored - k option not needed with n option

Option ignored - x option not needed for index rebuild

Run-time Switches

Sorting Files

Callable Sort Module

Sort Module Function Codes

Sort File Control Description

SORT Environment Variables

Mfsort Error Messages

Messages 0001 to 0099

SORT014U Status = value

SORT015U Command statement error(s) detected

SORT019I Key length truncated to 4096 bytes

SORT020U SORT(EXTSM) failed - sort engine status = Value

SORT032I Number records sorted

SORT033I Number records merged

SORT034I Number records copied

SORT036U SORTIN record length missing or invalid

SORT037U SYSIN RECFM value invalid

SORT038U SORTIN RECFM value invalid

SORT039U SORTOUT RECFM value invalid

SORT040U SORT terminated by E15 Operator

SORT041U SORT terminated by E35 Operator

SORT042U Memory allocation failure

SORT043U Too many OUTFIL files specified

SORT044U Too many USE files specified

SORT045U Too many GIVE files specified

SORT050U ICETOOL input file not found

SORT051U ICETOOL output file not found

SORT093U SORT terminated - missing SORTIN or SORTIN01

SORT094U SORT terminated - missing SORTOFvalue

SORT095U SORT terminated - Bad data in CHANGE field

SORT096U SORT terminated - missing FNAMES dataset value

Messages 0100 to 0199

SORT100E Missing operator

SORT101E Malformed operator

SORT102E Expected operand missing

SORT103E Invalid operator operator

SORT104E Invalid operand keyword keyword

SORT105E Expected continuation not present

SORT106E Field formats improperly specified

SORT107E Field format field-format invalid

SORT108E Sequence sequence invalid

SORT109E Too many fields specified

SORT110E Non-numeric data detected

SORT111E operator operator already processed

SORT112E exit exit not supported

SORT114E Expected '(' not found

SORT115E Boolean operator operator invalid

SORT118E SORT / MERGE conflict

SORT119E INCLUDE / OMIT conflict

SORT120E SORT statement missing FIELDS operand

SORT121E MERGE statement missing FIELDS operand

SORT122E INCLUDE statement missing COND operand

SORT123E OMIT statement missing COND operand

SORT124E FIELD position field-position invalid

SORT125E FIELD length field-length invalid

SORT126E RECORD length record-length invalid

SORT127E Missing SORT/MERGE/COPY command statement

SORT128E Expected ')' not found

SORT129E Expected '=' not found

SORT130E Expected 'F' OR 'V' not found

SORT131E Expected 'IX', 'RL', 'SQ', or 'LS' not found

SORT132E Prime key must be specified first

SORT133E Expected 'P', 'AD', 'A', or 'C' not found

SORT134E Keyword/value value invalid for DFSORT emulation

SORT135E Keyword/value value invalid for SYNCSORT emulation

SORT136E No GIVE file specified for OUTFIL group

SORT137E No USE file specified

SORT138E Target literal literal too long in CHANGE

SORT139E Substring comparison must be with character literal

SORT140E Invalid binary digit detected

SORT141E Cannot specify SAVE with either INCLUDE or OMIT

SORT142E Repeated FILE= or FNAMES=

SORT191I Operator operator ignored

SORT192I Operand operand ignored

SORT193E Invalid hex digit detected

SORT194 I No ALTSEQ command specified for 'AQ' SORT field formats; 'CH' assumed

SORT196E SUM / COPY conflict

SORT197E INREC / MERGE conflict

SORT198E Non-numeric data detected in 'ZD' SUM field

SORT199E Too many OUTFIL statements

Messages 0200 to 0399

SORT200E Bad or unknown symbol

SORT201E No previous offset defined for symbols

SORT202E No previous length defined for symbols

SORT203E No previous format defined for symbols

SORT204I *********************Sort Statistics*********************

SORT205I INPUT file filename

SORT206I OUTPUT file filename

SORT207I OUTFIL file filename

SORT214I Format operand ignored

SORT215E Reformatting field error

SORT216I Record type is V - Data starts at position 5

SORT217I Record length L1 or L3 overridden

SORT232E Field length exceeds maximum allowed

SORT399I End of Micro Focus MFJSORT Utility

Integrated Preprocessor Interface

Overview - Integrated Preprocessor Interface

Invoking a Preprocessor

Writing a Preprocessor

Writing a preprocessor - overview

Definition of the Interface Between the Compiler and a Preprocessor

Preprocessor Response Codes

Inserting Source Lines

Generating Preprocessor Error Messages

Querying Directive Settings

Handling COPY Statements

Source Modification

Multiple Preprocessors

Considerations When Writing a Preprocessor

CP Preprocessor

CP Directives

Example Integrated Preprocessor

COBOL Preprocessor Error Messages

Java Artifacts

Micro Focus Resource Adapters

COBOL Resource Adapter

COBOL Connector Class Usage Scenarios

COBOL Resource Adapter Utility

COBOL Connector Class Library

Package com.microfocus.cobol.connector.cci

Interface MFCobolConnection

Class CobolConnection

Class CobolConnectionFactory

Class CobolConnectionMetaData

Class CobolConnectionSpec

Class Cobolnteraction

Class CobolInteractionSpec

Class CobolInteractionSpecMetaData

Class CobolLocalTransaction

Class CobolRecordFactory

Class CobolResourceAdapterMetaData

Class CustomRecord

Class IndexedRecord

Package com.microfocus.cobol.connector.spi

Class CobolConnectionEventListener

Class CobolConnectionManager

Class CobolConnectionRequestInfo

Class CobolLocalTxManagedConnectionFactory

Class CobolManagedConnection

Class CobolManagedConnectionFactory

Class CobolManagedConnectionMetaData

Class CobolNoTxManagedConnectionFactory

Class CobolPrincipal

Class CobolResourceAdapter

Class SpiLocalTransaction

Language Environment (LE) Support

Enable Language Environment (LE) Support

LE Callable Services

Bit Manipulation Services

Condition-Handling Services

Date and Time Services

Dynamic-Storage Services

Dynamic File Allocation Services

General Services

Initialization and Termination Services

Locale Services

Math Services

Message-Handling Services

National Locale Support Services

LE Run-Time Options

Supported LE Run-time Options

Unsupported LE Run-time Options

Specifying LE Run-time Options

LE Error Conditions

LE Run-Time Options Error Messages

MFX9999I The run-time option option is not supported in this release

CEE3601I The string string was found where a delimiter was expected following a quoted suboption for the run-time option option

CEE3602I An end quote delimiter did not occur before the end of the run-time option string

CEE3603I The character character is not a valid run-time option delimiter

CEE3605I The string string was found where a delimiter was expected following the suboptions for the run-time option option

CEE3606I The string string was too long and was ignored

CEE3607I The end of the suboption string did not contain a right parenthesis

CEE3608I The following messages pertain to the invocation command run-time options

CEE3610I The run-time option old-option was mapped to the run-time option le-option

CEE3611I The run-time option option was an invalid run-time option

CEE3612I Too many suboptions were specified for the run-time option option

CEE3614I An invalid character occurred in the numeric string string of the run-time option option

CEE3615I The installation default for the run-time option option could not be overridden

CEE3616I The string string was not a valid suboption of the run-time option option

CEE3617I The number number of the run-time option option exceeded the range of -2147483648 to 2147483647

CEE3618I The run-time option option was not valid from the invocation command

CEE3619I The value value was not a valid MSGQ number

CEE3622I The option option quoted suboption string string was not one character long

CEE3623I The UPSI option suboption string string was not eight characters long

CEE3633W The total length of the combined ENVAR strings exceeded 250 characters

CEE3634I The number number of the run-time option option exceeded the range of -32768 to 32767

CEE3635I The string string was not a valid RECFM suboption specification for run-time option option

CEE3636I The value number exceeded the maximum allowable LRECL or BLKSIZE of 32760 bytes

CEE3637I The number number specified in the suboption suboption of the run-time option option is not a valid hexadecimal number in the range 0 to FFFFFFFF

CEE3638I The table size of size, specified in the TRACE run-time option, exceeds the maximum allowed value of 16777215

LE Country Codes

Library Routines

Library Routines - Key

Application Subsystem Routines

CBL_SUBSYSTEM

Bit-packing Routines

X"F4"

X"F5"

Byte-stream File Routines

Byte-stream File Handling Routines - Example

Character Set Conversion Routines

_CODESET

CBL_CODESET_SET_MAPPING

Consolidated Tracing Facility Routines

CBL_CTF_COMP_PROPERTY_GET

CBL_CTF_COMP_PROPERTY_SET

CBL_CTF_DEST

CBL_CTF_EMITTER_PROPERTY_GET

CBL_CTF_EMITTER_PROPERTY_SET

CBL_CTF_LEVEL

CBL_CTF_TRACE

CBL_CTF_TRACER_GET

CBL_CTF_TRACER_LEVEL_GET

CBL_CTF_TRACER_NOTIFY

Consolidated Tracing Facility Return Codes

Container-Managed Services Routines

CBL_SRV_SERVICE_FLAGS_GET

CBL_SRV_SERVICE_FLAGS_SET

Debugging Routines

CBL_DEBUGBREAK

CBL_DEBUG_START

CBL_DEBUG_STOP

Display Attribute Routines

CBL_SCR_ALLOCATE_COLOR

CBL_SCR_ALLOCATE_VC_COLOR

CBL_SCR_CREATE_VC

CBL_SCR_DESTROY_VC

CBL_SCR_GET_ATTR_INFO

CBL_SCR_GET_ATTRIBUTES

CBL_SCR_NAME_TO_RGB

CBL_SCR_QUERY_COLORMAP

CBL_SCR_RESTORE

CBL_SCR_RESTORE_ATTRIBUTES

CBL_SCR_SAVE

CBL_SCR_SAVE_ATTRIBUTES

CBL_SCR_SET_ATTRIBUTES

X"A7" functions 6 and 7

X"A7" function 16

X"A7" functions 20 and 21

Enhanced ACCEPT and DISPLAY Syntax Routines

Exit and Error Procedure Routines

File and Filename Routines

CBL_FILENAME_MAX_LENGTH

Interpreting the return code as a file status code

Filename Routines - Example

Keyboard Routines

Keyboard Routines - Example

Logical Operator Routines

Memory Allocation Routines

Mouse Routines

CBL_GET_MOUSE_POSITION

Multi-threading Routines

Thread-control Routines

CBL_THREAD_IDDATA_ALLOC

CBL_THREAD_IDDATA_GET

CBL_THREAD_KILL

CBL_THREAD_LIST_END

CBL_THREAD_LIST_NEXT

CBL_THREAD_LIST_START

CBL_THREAD_LOCK

CBL_THREAD_PROG_LOCK

CBL_THREAD_PROG_UNLOCK

RETURN-CODE Values For Thread-control Routines

Using the Program Thread-locking Routines

Using CBL_THREAD_SELF to Check Operating System

Synchronization routines

Synchronization routines - monitors

Monitors - General Notes

CBL_MONITOR_BROWSE

CBL_MONITOR_BROWSE_TO_READ

CBL_MONITOR_BROWSE_TO_WRITE

CBL_MONITOR_CLOSE

CBL_MONITOR_OPEN_INTRA

CBL_MONITOR_WRITE_TO_BROWSE

Synchronization routines - semaphores

Semaphores - General Notes

CBL_SEMAPHORE_ACQUIRE

CBL_SEMAPHORE_CLOSE

CBL_SEMAPHORE_OPEN_INTRA

CBL_SEMAPHORE_RELEASE

Synchronization routines - mutexes

Mutexes - General Notes

Synchronization routines - events

Events - General Notes

RETURN-CODE Values For Synchronization Routines

Routines for Handling Thread-specific Data

CBL_TSTORE_CLOSE

CBL_TSTORE_CREATE

CBL_TSTORE_GET

Thread-specific Data Handling Routines - Example

RETURN-CODE Values For Thread-specific Data Handling Routines

NLS Message-file Handling Routines

CBL_NLS_COMPARE

CBL_NLS_INFO

Operating System Information Routines

CBL_GET_OS_INFO

Portability Routines

CBL_SCR_SET_PC_ATTRIBUTES

Printer Routines

PC_PRINT_FILE

PC_PRINTER_CLOSE

PC_PRINTER_CONTROL

PC_PRINTER_DEFAULT_FONT

PC_PRINTER_DEFAULT_NAME

PC_PRINTER_DEFAULT_PROPERTIES

PC_PRINTER_DRAW_RECTANGLE

PC_PRINTER_ENUM_CLOSE

PC_PRINTER_ENUM_NEXT

PC_PRINTER_ENUM_START

PC_PRINTER_FREE_BMP

PC_PRINTER_GET_BMP_INFO

PC_PRINTER_GET_COLOR

PC_PRINTER_GET_FONT

PC_PRINTER_INFO

PC_PRINTER_INFO_DOTNET

PC_PRINTER_LINE_FROM_TO

PC_PRINTER_LOAD_BMP

PC_PRINTER_OPEN

PC_PRINTER_REDIRECTION_PROC

PC_PRINTER_SET_BACKGROUND_MIX_MODE

PC_PRINTER_SET_COLOR

PC_PRINTER_SET_DEFAULT

PC_PRINTER_SET_FONT

PC_PRINTER_SET_PEN

PC_PRINTER_SET_POSITION

PC_PRINTER_WRITE

PC_PRINTER_WRITE_BMP

Printer Handling Routines Return Codes

Program Canceling Routines

CBL_CANCEL

CBL_CANCEL_PROC

Program Information Routines

CBL_GET_PROGRAM_INFO

Run unit handling routines

CBL_MANAGED_SESSION_GET_USERDATA

CBL_MANAGED_SESSION_SET_USERDATA

Screen Routines

CBL_GET_SCR_LINE_DRAW

CBL_WRITE_SCR_CHARS_ATTR

CBL_WRITE_SCR_CHATTRS

CBL_WRITE_SCR_N_ATTR

CBL_WRITE_SCR_N_CHAR

CBL_WRITE_SCR_N_CHATTR

State Maintenance Routines

MF_CLIENT_STATE_ALLOCATE

MF_CLIENT_STATE_DELETE

MF_CLIENT_STATE_EXPIRY

MF_CLIENT_STATE_FILE

MF_CLIENT_STATE_PURGE

MF_CLIENT_STATE_RESTORE

MF_CLIENT_STATE_SAVE

State Maintenance Routines Status

Text Routines

CBL_TOLOWER

CBL_TOUPPER

PC_WIN_SET_CHARSET

Unit Testing Routines

Virtual Heap Routines

Windows Routines

Miscellaneous Routines

X"91" function 16 (deprecated)

X"91" function 35

X"91" function 69 (deprecated)

X"E5"

Alphabetical List of Library Routines

CBL_CODESET_SET_MAPPING

CBL_COPY_FILE

CBL_CREATE_DIR

CBL_CREATE_FILE

CBL_CTF_COMP_PROPERTY_GET

CBL_CTF_COMP_PROPERTY_SET

CBL_CTF_DEST

CBL_CTF_EMITTER_PROPERTY_GET

CBL_CTF_EMITTER_PROPERTY_SET

CBL_CTF_LEVEL

CBL_CTF_TRACE

CBL_CTF_TRACER_GET

CBL_CTF_TRACER_LEVEL_GET

CBL_CTF_TRACER_NOTIFY

CBL_FILENAME_MAX_LENGTH

CBL_GET_MOUSE_POSITION

CBL_GET_SCR_LINE_DRAW

CBL_MANAGED_SESSION_GET_USERDATA

CBL_MANAGED_SESSION_SET_USERDATA

CBL_MEM_STRATEGY

CBL_MEM_VALIDATE

CBL_MONITOR_BROWSE

CBL_MONITOR_BROWSE_TO_READ

CBL_MONITOR_BROWSE_TO_WRITE

CBL_MONITOR_CLOSE

CBL_MONITOR_OPEN_INTRA

CBL_MONITOR_WRITE_TO_BROWSE

CBL_NLS_CLOSE_MSG_FILE

CBL_NLS_COMPARE

CBL_NLS_INFO

CBL_NLS_OPEN_MSG_FILE

CBL_SCR_ALLOCATE_COLOR

CBL_SCR_ALLOCATE_VC_COLOR

CBL_SCR_CREATE_VC

CBL_SCR_DESTROY_VC

CBL_SCR_GET_ATTR_INFO

CBL_SCR_GET_ATTRIBUTES

CBL_SCR_NAME_TO_RGB

CBL_SCR_QUERY_COLORMAP

CBL_SCR_RESTORE

CBL_SCR_RESTORE_ATTRIBUTES

CBL_SCR_SAVE

CBL_SCR_SAVE_ATTRIBUTES

CBL_SCR_SET_ATTRIBUTES

CBL_SCR_SET_PC_ATTRIBUTES

CBL_SEMAPHORE_ACQUIRE

CBL_SEMAPHORE_CLOSE

CBL_SEMAPHORE_OPEN_INTRA

CBL_SEMAPHORE_RELEASE

CBL_SRV_SERVICE_FLAGS_GET

CBL_SRV_SERVICE_FLAGS_SET

CBL_THREAD_IDDATA_ALLOC

CBL_THREAD_IDDATA_GET

CBL_THREAD_KILL

CBL_THREAD_LIST_END

CBL_THREAD_LIST_NEXT

CBL_THREAD_LIST_START

CBL_THREAD_LOCK

CBL_THREAD_PROG_LOCK

CBL_THREAD_PROG_UNLOCK

CBL_WRITE_SCR_CHARS_ATTR

CBL_WRITE_SCR_CHATTRS

CBL_WRITE_SCR_N_ATTR

CBL_WRITE_SCR_N_CHAR

CBL_WRITE_SCR_N_CHATTR

MF_CLIENT_STATE_ALLOCATE

MF_CLIENT_STATE_DELETE

MF_CLIENT_STATE_EXPIRY

MF_CLIENT_STATE_FILE

MF_CLIENT_STATE_PURGE

MF_CLIENT_STATE_RESTORE

PC_PRINTER_DEFAULT_FONT

PC_PRINTER_DEFAULT_NAME

PC_PRINTER_DEFAULT_PROPERTIES

PC_PRINTER_DRAW_RECTANGLE

PC_PRINTER_ENUM_CLOSE

PC_PRINTER_ENUM_NEXT

PC_PRINTER_ENUM_START

PC_PRINTER_FREE_BMP

PC_PRINTER_GET_BMP_INFO

PC_PRINTER_GET_COLOR

PC_PRINTER_GET_FONT

PC_PRINTER_INFO

PC_PRINTER_INFO_DOTNET

PC_PRINTER_LINE_FROM_TO

PC_PRINTER_LOAD_BMP

PC_PRINTER_OPEN

PC_PRINTER_REDIRECTION_PROC

PC_PRINTER_SET_BACKGROUND_MIX_MODE

PC_PRINTER_SET_COLOR

PC_PRINTER_SET_DEFAULT

PC_PRINTER_SET_FONT

PC_PRINTER_SET_PEN

PC_PRINTER_SET_POSITION

X"91" function 16 (deprecated)

X"91" function 69 (deprecated)

X"A7" functions 6 and 7

X"A7" function 16

X"A7" function 17

X"A7" function 18

X"A7" functions 20 and 21

Restrictions, Compiler Limits, and System Limits

ALTER and ACCEPT Statement Restrictions

Command Line Length

Data Item Size and Number Restrictions

ENTRY Statement Restrictions

Filename Restrictions

Floating-point Numbers

Hardware or Operating System Limits

Methods in a Class

Names, Literals and PICTURE Character Strings

Nested Statement Restrictions

Number of DETAIL Groups

Numbers Restrictions

PERFORM Ranges

Program Source File Limits

Size of Programs, Divisions and Sections

Sort and Merge Restrictions

Table Dimension Limits

USE Statements

USING Phrase Parameters

Managed COBOL Restrictions

COBOL Syntax Restrictions in Managed COBOL

Compiler Directives Restrictions in Managed COBOL

File Handling Restrictions in Managed COBOL

COBOL Services as Java Interfaces and Web Services

Mixed-language Implications in Managed COBOL

Object-Oriented (OO) COBOL Restrictions in Managed Code

SQL Restrictions in Managed COBOL

Unsupported Functionality in Managed COBOL

Managed COBOL

Managed COBOL Reference

Program Structure

Types

Structural Syntax Elements - Alphabetic List

Procedure Division Header

Properties

Type Members

ValueTypes

Common Syntax Elements

Access Modifiers

Assembly-Attributes Paragraph

Attributes

Constraints Paragraph

Method Signature

Expressions

Generic Using Phrase

Local Data Item Declaration

Type Specifier

Statements - Alphabetic List

CREATE Collection Statement

COMPUTE Statement

CONTINUE Statement

DECLARE Statement

DELETE Collection Statement

READ Collection Statement

RESET Collection Statement

REWRITE Collection Statement

WRITE Collection Statement

Concepts - Managed COBOL

Extension Methods and Operators

Invoking a Method

Method Overloading in Managed COBOL

Operator Overloading in Managed COBOL

String Handling in Managed COBOL

Types and Type Conversion

Type Compatibility of Managed COBOL with Other Managed Languages

Type Mappings from Native COBOL to Managed Code

Comparison of COBOL with Other Managed Languages

Arrays - in COBOL and C# and VB.NET

Attributes - in COBOL and C#

Comments - in COBOL and C# and VB.NET

Conditionals - in COBOL and C# and VB.NET

Constants - in COBOL and C# and VB.NET

Constructors and Destructors - in COBOL and C# and VB.NET

Data Types - in COBOL and C# and VB.NET

Delegates and Events - in COBOL and C# and VB.NET

Enumeration - in COBOL and C# and VB.NET

Exception Handling - in COBOL and C# and VB.NET

Functions, Methods - in COBOL and C# and VB.NET

Generics, Consuming - in COBOL and C#

Generics, Defining - in COBOL and C#

Interfaces - in COBOL and C# and VB.NET

Iterators - in COBOL and C#

Loops - in COBOL and C# and VB.NET

Namespaces - in COBOL and C# and VB.NET

Objects - in COBOL and C# and VB.NET

Operators - in COBOL and C# and VB.NET

Program Structure - in COBOL and C# and VB.NET

Properties - in COBOL and C# and VB.NET

Strings - in COBOL and C# and VB.NET

Structures, Value Types - in COBOL and C# and VB.NET

Synchronization - in COBOL and C#

Type Compatibility of Managed COBOL with Other Managed Languages

MicroFocus.COBOL.RuntimeServices

Panels

What is a Panel?

Using Panels

Calling Panels

Text and Attributes for a Panel

To Specify Text for a Panel

To Specify Attributes for a Panel

To Specify Attributes Without Specifying Text

Clipping a Panel

Panels Parameter Block

Panels Parameter Block Listing

Panels Parameter Block Fields

PPB-Buffer-Offset

PPB-Fill-Attribute

PPB-Fill-Character

PPB-First-Visible-Col

PPB-First-Visible-Row

PPB-Function

PPB-Panel-Height

PPB-Panel-ID

PPB-Panel-Start-Column

Panels Functions

PF-Create-Panel (Value 3)

PF-Create-Panel-With-Shadow (Value 19)

PF-Delete-Panel (Value 6)

PF-Disable-Panel (Value 8)

PF-Enable-Panel (Value 7)

PF-Flush-Panel (Value 9)

PF-Get-First-Panel (Value 15)

PF-Get-Next-Panel (Value 16)

PF-Get-Panel-At-Position (Value 13)

PF-Get-Panel-Info (Value 5)

PF-Get-Panel-Stack (Value 17)

PF-Get-Screen-Info (Value 0)

PF-Read-Panel (Value 12)

PF-Redraw-Screen (Value 2)

PF-Scroll-Panel (Value 10)

PF-Set-Panel-Name (Value 14)

PF-Set-Panel-Stack (Value 18)

PF-Set-Screen-Backdrop (Value 1)

PF-Shift-Panel (Value 4)

PF-Write-Panel (Value 11)

Using Adis Functions with Panels

Calling Adis Functions

Adis Functions

x"AF" Function 1 - Disable or Enable Adis Indicators

x"AF" Function 49 - Initialize Adis to Use Panels

x"AF" Function 56 - Specify Panel for ACCEPT/DISPLAY

x"AF" Function 57 - Enable or Disable Delayed DISPLAY

x"AF" Function 62 - Suspend Use of Panels by Adis

x"AF" Function 63 - Return Status of Panels Used by Adis

Panels Error Codes

PE-No-Error (Value 0)

PE-Not-Created (Value 1)

PE-Invalid-ID (Value 2)

PE-Invalid-Parameters (Value 3)

PE-Invalid-Function (Value 4)

PE-No-Room-For-Panel (Value 5)

PE-Panel-Too-Large (Value 6)

PE-Invalid-Direction (Value 7)

PE-Invalid-Scroll-Count (Value 8)

PE-Cannot-Initialise (Value 9)

Frequently Used Terms in Panels

Run-time System Configuration

Run-time configuration settings available in the IDE

ANSI Display Settings in the IDE

Command Line Handling Settings in the IDE

Console Size Settings in the IDE

Screen I/O Settings in the IDE

Error Handling Settings in the IDE

File Handling Settings in the IDE

Memory Strategy Settings in the IDE

Non-Shared Memory Settings in the IDE

Sort/Merge Memory Settings in the IDE

Program Loading Settings in the IDE

Testing Settings in the IDE

Deployment Characteristics Settings in the IDE

Program Execution Settings in the IDE

Run-time Switches

Introduction to Switches

Setting Run-time Switches

Syntax for Setting Switches

List of General Run-time Switches

0, 1, 2, 3, 4, 5, 6, 7 and 8 run-time switches

A run-time switch

A1 run-time switch

B, B1 run-time switches

List of Run-time Switches for OO Programs

d OO run-time switch

f OO run-time switch

g1 OO run-time switch

g2 OO run-time switch

l OO run-time switch

t OO run-time switch

Key to Run-time Switches

Run-time Tunables

Run-time Configuration Tunables - Overview

Format of a Configuration File for Native COBOL

Format of a Configuration File for .NET COBOL

List of Run-time Tunables

acu_library

ansi_input_mode

arguments_are_initial

cobconfig_error_report

command_line_accept

command_line_linkage (deprecated)

dbcs_text_enable_clip

debug_on_error

debugger_command

default_cancel_mode

device_name_detection

entry_point_mapper

entry_point_mapper_alias_exists_error

entry_point_mapper_search_order

environment_mapper

error_on_duplicate_entry_point

filename_escape_char

filename_quote_char

lock_mode

mainframe_floating_point

memory_free_check_size

memory_strategy

mfpm_access_cancelled_data

printer_raw_redirection

shared_memory_segment_size

signal_regime

subsystem_cancel_mode

timewarp_dynamic

Service Interfaces

imtkmake command

mfdepinst command

COBOL to Service Interface Data Type Matches

Deployment

Deploying COBOL Applications

Overview of Deploying Your Applications

Deploying the Micro Focus Run-Time System

COBOL Server Installation Options

COBOL Server Deployment Toolkit

Introduction to the COBOL Server Deployment Toolkit

Merge Modules and Installer Packages

License Manager

Shipping Selected Files from COBOL Server

.int and .gnt support files to ship

OO COBOL Files to Ship

Run-time System Files to Ship

Run-time Launch Configuration Files

Run-time Launch Configuration File Options

Examples of a Run-time Launch Configuration File

Deploying Native Applications

Writing Your Own Setup Program

To set up an application with a shared COBOL Server

To set up an application with its own COBOL Server

To run a native COBOL application from a network server

Deploying COBOL Applications to the .NET Environment

Deploying to the .NET Environment

Deploying Web and ASP.NET Applications

To deploy a Windows application to the .NET environment

To deploy a Web Application to the .NET environment

To deploy a COBOL Web site to the .NET environment

To run a .NET COBOL application from a network server

Deploying to Enterprise Server

Enterprise Server configuration and administration

Overview and Architecture

Enterprise Server Overview

Enterprise Server Architecture

Enterprise Server Instance Architecture

The Micro Focus Directory Server

Directory Server Information

Repository Statistics

Service Execution Process (SEP)

Request Handlers

Communications Processes

Listeners

Implementation Packages

XA Resources

Enterprise Server Processes

Configuration and Administration User Interface

About the Enterprise Server Administration User Interface

User Interface Tables

Navigation

Accessing the Enterprise Server Administration UI

Displaying Server Information

Refreshing a Page

Securing the Repository Files

Planning your Configuration

About Securing an Enterprise Server Installation

Security Options

Enterprise Server Execution Control Under Windows

Firewall configuration

About Communications Processes

Deployment Services and Listeners

Deployment Services

Deployment Listeners

Enterprise Server Instance Configuration Issues

Shared Memory Area

Shared Memory Cushion

Number of Service Execution Processes

Performance Considerations

I/O-bound Services

CPU-bound Services

Short-running Client Requests

Long-running Client Requests

Configuring the Server Instance Environment

Configuring Environment Variables

How Enterprise Server uses Environment Variables

Setting Environment Variables

Setting Environment Variables for Micro Focus Directory Server

To Set Environment Variables from the User Interface

To Set Environment Variables from the Command Line

To Specify Dataset Allocation Using Environment Variables

Environment Variables by Groups

CCI Environment Variables

Enterprise Server Communications Environment Variables

File Handling and Dataset Environment Variables

Input, output and display environment variables

Security and Auditing Environment Variables

SORT Engine Environment Variables

Tracing and Debugging Environment Variables

Reserved Environment Variables

Environment variables in alphabetical order

Reserved Environment Variables

About Communications Processes

Configuring Fileshare

Using XA-compliant Resources (XARs)

Planning and Designing XARs

RM Switch Module Registration

Working with Multiple XARs

SQL xa_open string Configuration Options

Defining XA Resource Entry

To define an XA resource (XAR) for an enterprise server region

SQL Server xa_open string

EDB PostgreSQL xa_open string

Generic one-phase commit for ODBC xa_open string

IBM DB2 xa_open string

Oracle xa_open string

To Delete an XA Resource

To Edit an XA Resource

To Enable or Disable an XA Resource

RM Switch Modules

Building RM Switch Modules

SQL Server RM Switch Module

EDB PostgreSQL RM Switch Module

Generic One-phase Commit for ODBC RM Switch Module

IBM DB2 RM Switch Module

Oracle RM Switch Module

XA Logging and Recovery of in-doubt Transactions

XA Troubleshooting

XA Return Codes

XA Switch Module Diagnostics

Handling XA Connection Errors

Configuring and Administering Enterprise Server Instances

Creating and Configuring Enterprise Server Instances

To Add an Enterprise Server Instance

To Change the Number of ES licenses

To Copy an Enterprise Server Instance

To Delete an Enterprise Server Instance

To Delete a CCI Server

To Export Server Information

Connecting to a Server Instance

To start an enterprise server instance

To stop a server Instance

To Edit an Enterprise Server Instance

To Log On to Enterprise Server Administration

To Log Off from Enterprise Server Administration

Using Start and Stop Scripts

Administering Enterprise Server Instances using ESMAC

To Start ESMAC for an enterprise server instance

To Shut Down a Server from ESMAC

Viewing Enterprise Server Instance Details

The ESMAC User Interface

Defining Enterprise Server Instance Administrators

Managing an Enterprise Server Instance's SEPs

About Service Execution Processes

To Change the Number of SEPs

Interacting with Services

To Reply to an ACCEPT FROM CONSOLE Statement

Stopping and Restarting an Installation

Using the Command-line Interface

Configuring Client-Server Communications

About Communications Processes

Considerations When Configuring Communications Processes

Displaying Communications Process and Listener Information

Securing Communications

Configuring Communications Processes

Editing Communications Settings

[CCI] section

[ezasoket] Section

[HTTP] Section

maximum header value length

[listeners] Section

[MFCC] Section

[tasks] Section

wait queue sweep interval

[threading] Section

limit

To Edit a Communications Process

To Copy a Communications Process

To Delete a Communications Process

To Start a Communications Process

To Stop a Communications Process

To View Communications Processes and Listeners for an Enterprise Server Instance

To View Statistics for a Communications Process

Configuring Listener Conversation Types

Fileshare conversation type

SOAP /J2EE (legacy) conversation type

Web conversation type

logging

default

element in [virtual paths] Section

element in [allow] Section

Web Services and J2EE conversation type

Configuring Listeners

To Add a Service Listener to an Enterprise Server Instance

To Edit a Listener

To Associate a Listener with a Service

To delete a listener

To Disassociate a Listener from a Service

To Start a Listener

To Stop a Listener

Configuring Enterprise Server for IBM WebSphere MQ

Non-Mainframe Programs and WebSphere MQ

Resource Classes for WebSphere MQ

WebSphere MQ-Specific Environment Variables

Monitoring Enterprise Server

Server Instance Statuses

Monitoring the Directory Server

Starting and Stopping the Directory Server

To Start the Directory Server

To Start the Directory Server from the Command Line

To Stop the Directory Server

To stop the Directory Server when not running as a service

To Delete the Repository

To Import a Repository

To Restore the Repository

To Export the Repository

Displaying Server Information

Accessing Remote MF Directory Servers

To View and Use Remote Directory Server Instances

Monitoring Facilities

The Directories Page

Viewing a MF Directory Server's Statistics

To View Directory Server Statistics

Viewing a MF Directory Server's Sessions List

To View the Sessions List

Viewing the Journal

To View the Journal

To export the journal as a text file

To Delete Journal Entries

Collecting and Viewing Data on Transactions

Configuring and Starting Transaction Data Collection

Viewing HSF Information in ESMAC

Viewing HSF Information as a .csv File

Analyzing Aggregated HSF Data in .csv Files

Windows Event Log

To Enable Windows Event Logging

To Use Windows Event Logging

Performance Counters

To Enable Performance Counters

To Use Performance Counters

Management Packs for System Center Operations Manager

Monitors

Monitor Category: Availability

Monitor Category: Configuration

Monitor Category: Micro Focus Server Operation

Monitor Category: Performance

Rules

Discovery

Enterprise Server Tasks

To import Server Management Packs into Operations Manager

To View Server Instances and Properties in Operations Manager

Extending and Overriding Management Packs

User Exits for Request Handlers

User Exit Points Provided

Structure Definitions and Type Definitions

Linkage Section Field Names

Deploying a User Exit Program

Web Service exits exit-soap-request exit-soap-response and exit-http-headers

Implementing exit-soap-request and exit-soap-response

Implementing exit-http-headers user exits

Troubleshooting

Determining the Failure Type

Incorrect Output

Unexpected System Termination

Loops

System Hangs

One Type Of Request is Failing

All client requests are failing

Invalid Credentials Error

Collecting Information

Directory Server Journal

To View the Journal

Enterprise Server Log Files

Communications Process Log Files

Enterprise Server Log Files

To View the Enterprise Server Log Files

Enterprise Server System Directory

To Change the System Directory

Dumps and Traces

Producing a core dump for run-time errors

Data Capture

Checking the Communications Process

Using a Diagnostics Server

Configuring a Diagnostics Server

Moving the Diagnostics Data

Viewing the Diagnostic Server Console Log

Viewing a System Trace: Diagnostics Example

Viewing a Dump

What You Can Do with Dumps and Traces

To Change the Trace Dataset

To Configure Dumps

To initiate a system dump

To specify what information is traced

To View a Dump

To View a Local Trace for a Client Process

To View a Local Trace for a SEP

To View a System Trace

To Configure Run-time Core Dumps

Enterprise Server Administration Console Help Pages

Enterprise Server Administration Side Bar Menu

Export

Import Server Information (Page 1 of 4)

Configure Repository Options

Enterprise Server Administration Home Page

Add Server instance

Delete Server instance

Start Server confirmation

Stop Server Confirmation

Edit Server Instance Properties

Server Instance Properties: General

Server Instance Properties: XA Resources

Server Instance Properties: Add XA Resource

Server Instance Properties: Scripts

Server Instance Properties: Permissions

Server Instance Control

Server Instance Control Settings

Server Instance Diagnostics

Server Instance Diagnostics: Trace

Server Instance Diagnostics: Dump

Server Instance Diagnostics: ES Console

Server Instance Diagnostics: CS Console

Server Instance Properties: Security

Enterprise Server Monitor and Control (ESMAC)

Enterprise Server Monitor and Control - S2 Sidebar Help

Server

Monitor (1, 15)

HSF

HSF (summary)

HSF (transaction name)

Diagnostics

Resources

Services

Lists of Services

Services

Service Packages

Request Handlers

Details of Individual Services

iFileshare

Active

Lists of Active Resources

Details of an Active Resource

XAT

PIPELINE Entry (pipeline_name)

WEBSERVICE Entry (webservice_name)

RNL (RNL_sequence_number)

Users

Listeners

Copy Communications Process

Edit Communications Process

Delete Communications Process

Services

Edit Service

Delete Service

Delete Service Operation

Handlers

Packages

Security Configuration Screen Help

MF Directory Server Users, Add or Edit

Add Resource Class

Add Resource Entity

Add Security Manager

Add to Default ES Security Manager List

Add to ES Security Manager List

Add to MF Directory Server Security Manager List

Configure General Options

Confirm Password

Configure Journal Options

Configure Monitor Options

Configure Repository Options

Default ES Security Configuration

Directory Server Users

Edit Resource Class

Edit resource entity

Edit Security Manager

Left Pane Menu Items

MF Directory Server Security

Remove Security Manager Reference Confirmation

Security Managers Pool

SSL Options

Shut Down the MF Directory Server

Update User

User Group Members

User Groups

User Import: another user registry

User Import: previous version

Deploying and Configuring Modernized Applications

About Modernized Applications

Service Names and Operations

The Services Table

Configuring Services

Types of Services Supported

Managing Resources

Application-managed Services

Container-managed Services

Mixing Container-managed and Application-managed Services

Adding and Deleting Services

Creating Services Manually

To Add a Service to an Enterprise Server Instance

To Associate a Package with a Service

Configuring and Monitoring Services

Services and Permissions

To Monitor Services

To Record Service Input and Output

To Add a Service for Integration with the Micro Focus Development Tools

To Change the Status of a Service

To Delete a Simple Service or an Operation

To Delete a Service with Operations

To Edit a Service

To Switch Logging On for a Service

To View Services for an Enterprise Server Instance

Configuring Implementation Packages

The Packages Table

Configuring Packages

To Add a Package to an Enterprise Server Instance

To Delete a Package

To Edit a Package

To Disassociate a Package from a Service

To View Packages for an Enterprise Server Instance

To Delete Old Deployed Package Files

Configuring Request Handlers

The Request Handlers Table

Configuring Handlers

To Add a Request Handler to an Enterprise Server Instance

To Edit a Request Handler

To Associate a Request Handler with a Service

To Disassociate a Request Handler from a Service

To Delete a Request Handler

To View Request Handlers for an Enterprise Server Instance

Deploying Interfaces Created Using the Interface Mapping Toolkit

Deploying EJBs and Resource Adapters

Enterprise Server Acting as a Resource Manager

Deploying EJBs Overview

Deploying EJBs

To Add Micro Focus Support for EJBs

To Create an .ear File for your EJB

To Deploy to WebLogic

To Deploy to WebSphere

To Deploy to JBoss

Resource Adapters Supplied by Micro Focus

To Add Support for Micro Focus Resource Adapters

To Deploy a Micro Focus Resource Adapter to a Java Application Server

Deployment Descriptors that Are Required

To Create Deployment Descriptors Manually

CustomRecord and the RuntimeProperties Support

Third Party Application Server Deployment

Troubleshooting

Enterprise Server Task Index

Accessing the Enterprise Server Administration UI

Accessing the ESMAC User Interface

Administer a Server Using ESMAC

To Change the Trace Dataset

To Configure Dumps

To Create an ESMAC User

To initiate a system dump

To stop or kill a SEP

To Monitor Services

To Record Service Input and Output

To Reply to an ACCEPT FROM CONSOLE Statement

To Shut Down a Server from ESMAC

To specify what information is traced

To Start ESMAC for an enterprise server instance

To Transfer the In-memory Trace Data to the Auxiliary Dataset at Rollover

To View a Dump

To View a Local Trace for a Client Process

To View a Local Trace for a SEP

To View a System Trace

Configure the Directory Server

To Configure the MF Directory Server

Deploy Service Interfaces to Enterprise Server

To add or remove application files to deploy

To associate an enterprise server with a project

To compile a service driver program on a remote UNIX machine

To generate and deploy a service interface from a project

To deploy to a remote enterprise server

To deploy a service interface using imtkmake

To generate clients

To build an ASP.NET client

To install a deployment package using mfdepinst

To redeploy a service interface

To set deployment properties

Deploy to Java EE Application Servers

To Deploy to WebSphere

To Deploy to WebLogic

To Deploy to JBoss

To Create Deployment Descriptors Manually

To Create an .ear File for your EJB

To Add Micro Focus Support for EJBs

To Add Support for Micro Focus Resource Adapters

To Deploy a Micro Focus Resource Adapter to a Java Application Server

Log On and Off

To Log On to Enterprise Server Administration

To Log Off from Enterprise Server Administration

Monitor Directory Server

To View the Sessions List

To View the Journal

To View and Use Remote Directory Server Instances

To View Directory Server Statistics

To export the journal as a text file

To Delete Journal Entries

To Configure Run-time Core Dumps

Monitor and Manage Enterprise Server

To View Server Instances and Properties in Operations Manager

To import Server Management Packs into Operations Manager

To Use Performance Counters

To Enable Performance Counters

To Use Windows Event Logging

To Enable Windows Event Logging

Start and Stop the Directory Server

To Start the Directory Server

To Start the Directory Server from the Command Line

To Stop the Directory Server

To stop the Directory Server when not running as a service

Work with Communication Processes and Service Listeners

To Add a Service Listener to an Enterprise Server Instance

To Associate a Listener with a Service

To set a fixed port in a listener endpoint address

To Start a Communications Process

To Stop a Communications Process

To Copy a Communications Process

To Edit a Communications Process

To Delete a Communications Process

To Start a Listener

To Stop a Listener

To Edit a Listener

To Disassociate a Listener from a Service

To delete a listener

To View Communications Processes and Listeners for an Enterprise Server Instance

To View Statistics for a Communications Process

Work with Packages

To Add a Package to an Enterprise Server Instance

To Edit a Package

To Associate a Package with a Service

To Disassociate a Package from a Service

To View Packages for an Enterprise Server Instance

To Delete a Package

To Delete Old Deployed Package Files

Work with Request Handlers

To Add a Request Handler to an Enterprise Server Instance

To Edit a Request Handler

To Associate a Request Handler with a Service

To Disassociate a Request Handler from a Service

To View Request Handlers for an Enterprise Server Instance

To Delete a Request Handler

Work with Servers

To Add an Enterprise Server Instance

To define an XA resource (XAR) for an enterprise server region

To Change the Number of ES licenses

To Change the Number of SEPs

To Change the System Directory

To Copy an Enterprise Server Instance

To Create and View a Diagnostic Dump for an Enterprise Server Instance

To Delete an Enterprise Server Instance

To Delete an XA Resource

To Delete a CCI Server

To Edit an Enterprise Server Instance

To Edit an XA Resource

To Enable Dynamic Debugging

To Enable or Disable an XA Resource

To Export Server Information

To start an enterprise server instance

To stop a server Instance

To View the Communications Console Log for an Enterprise Server Instance

To View the Enterprise Server Log Files

To View the Control Page for an Enterprise Server Instance

Work with Services

To View Services for an Enterprise Server Instance

To Add a Service to an Enterprise Server Instance

To Edit a Service

To Change the Status of a Service

To Switch Logging On for a Service

To Add a Service for Integration with the Micro Focus Development Tools

To Delete a Service with Operations

To Delete a Simple Service or an Operation

Work with the Directory Server Repository

To Import a Repository

To Export the Repository

To Restore the Repository

To Delete the Repository

Enterprise Server Reference

Administration and Configuration Commands

Error Messages

Directory Server Error Messages

Messages 0 to 20

MDS0000I OK

MDS0001I Logged on OK

MDS0002E Logon failed

MDS0003I Logged off OK

MDS0004I Repository cleared OK

MDS0005I Network search complete

MDS0006I All objects copied successfully

MDS0007E Duplicate server exists

MDS0008E Duplicate server name already exists

MDS0009E Invalid server specified.

MDS0010E Invalid endpoint specified

MDS0012E Duplicate service name exists

MDS0013E Duplicate listener exists

MDS0014E Duplicate user already exists

MDS0015E Schema Administrators cannot reduce their own permission level

MDS0016E Invalid endpoint specified

MDS0017E Object must have a name

MDS0018I New server session

MDS0019I Client session has timed out: please log on again

MDS0020E Minimum client timeout is 60 seconds

Messages 21 to 40

MDS0021E Minimum page size is 5 entries

MDS0022E Minimum journal size is 32 KB

MDS0023E Insufficient memory for this operation

MDS0024E Password mismatch

MDS0025E Confirmation password mismatch

MDS0026E Old password required

MDS0027E New password required

MDS0028E Invalid characters in password

MDS0029E Selected object does not exist

MDS0030W Some or all objects not copied: see journal for details

MDS0031E Maximum port value is 65535

MDS0032E Object could not be added

MDS0035E Minimum object limit is 64

MDS0036E Maximum object limit is 9999

MDS0037E Operation would breach the configured object limit

MDS0038E Minimum object limit is smaller than the current number of objects

Messages 41 to 60

MDS0043I Journal exported as text into file journal.txt OK

MDS0044E Server name missing

MDS0045E Duplicate request handler or package name exists

MDS0047E Package must have an IDT path

MDS0048E Server refused state change request

MDS0049E Server refused state change request reason code:

MDS0050E Server instance count must be at least 1

MDS0051I Value change request accepted

MDS0052I Diagnostic dump request accepted

MDS0053E Diagnostic dump request failed

MDS0054I Configuration saved

MDS0055I Configuration defaults restored

MDS0056E Insufficient permission level for request

MDS0057E Resource manager ID field must have a value

MDS0058E Resource manager name field must have a value

MDS0059E Resource manager module field must have a value

MDS0060E MFRHBINP cannot be deleted

Messages 61 to 80

MDS0061I Stopping and deleting all servers...

MDS0062E Entry range invalid

MDS0063E Cannot delete a listener which is associated with a service

MDS0064E Cannot delete a package which is associated with a service

MDS0065E Requested new listener status not possible when server is stopped

MDS0066E There are no servers to delete

MDS0067E less than greater than ampersand characters are not allowed in object names

MDS0068I Schema updated

MDS0069I All servers deleted

MDS0070I Data imported

MDS0071E Data import failed

MDS0072I Server data saved

MDS0073E Server data save failed

MDS0074E User name required

MDS0075E Too many multi-byte characters in name

MDS0076E Too many multi-byte characters in path

MDS0077E Too many multi-byte characters in type

MDS0078E Too many multi-byte characters in ID

MDS0079E Too many multi-byte characters in module

MDS0080E Too many multi-byte characters in string

Messages 81 to end

MDS0081W A duplicate port value has been used: this may cause server startup errors

MDS0082E Requested license value invalid, minimum value is 0

MDS0083W Cannot set auto-refresh period if web browser timeout is set

MDS0084E Cannot restore from current repository path

MDS0085W Value changed but not saved

MDS0086I At least one Communications Process must auto-start

MDS0087E MFRHBINP cannot be renamed

MDS0091E ISC listener port must have a valid value

MDS0095E Duplicate group name exists

MDS0096I Server configuration updated

MDS0097E Duplicate initiator name exists

MDS0098W Cannot over-write existing repository data

MDS0099I Server already in requested state

MDS0100E Duplicate printer name exists

MDS0101E The maximum number of Communications Processes per server is 32

MDS0102W Passwords must contain alphanumeric characters only

MDS0103E Security Manager already referenced in list

MDS0104E There must be at least one Security Manager in list

MDS0105E Both certificate and keyfile required

MDS0106E Duplicate Security Manager name exists

MDS0107E Security Managers cannot use a reserved module name

MDS0108E Users must be a member of #AllUsrs group

MDS0109E Cannot copy deployed services or packages if server working mode is changed

MDS0110W The specified configuration change may not take effect until the server is restarted

MDS0111W Update request failure message CASRD1006E detected in the ES console log

MDS0112I Update success message CASRD1001I detected for this object in the ES console log

MDS0113W Users who are members of the #System user group cannot log on interactively

MDS1003E LDAP server connection error

Enterprise Server Error Messages

CASCD Error Messages

CASCD0001 - CASCD0015

CASCD0016 - CASCD0031

CASCD0016W

CASCD0017I cascd: cascd-message

CASCD0050 - CASCD0099

CASCD0100 - CASCD0117

CASCD0120 - CASCD0139

CASCD0141 - CASCD0159

CASCD0160 - CASCD0175

CASCD1001 - CASCD1056

CASCD1052I JES Initiator for Service execution process service execution process-name has terminated normally

CASCD1053S JES Initiator for Service execution process service execution process-name exited with value exit-value

CASCD1054I JES Printer for Service execution process service execution process-name has terminated normally

CASCD1055S JES Printer for Service execution process service execution process-name exited with value exit-value

CASCD1057 - CASCD1069

CASCD1070 - CASCD1200

CASCD1087I Cobdebugremote process created for Server server-name, process-id = pid

CASCD1088S Cobdebugremote process for Server server-name abended by signal signal-value

CASCD1089I Cobdebugremote process for Server server-name has terminated normally

CASCD1090S Cobdebugremote process for Server server-name exited with value exit-value

CASCD1095I ES TRC Service Process created for Server server-name, process-id = pid

CASCD1096I ES TRC Service Process for Region server-name has terminated normally

CASCD1097S ES TRC Service Process for Region server-name exited with value exit-value

CASCD1098S ES TRC Service Process for Region server-name abended by signal signal-value

CASCD1105I ES MQB Service Process created for Server server-name, process-id = pid

CASCD1106I ES MQB Service Process for Region server-name has terminated normally

CASCD1107S ES MQB Service Process for Region server-name exited with value exit-value

CASCD1108S ES MQB Service Process for Region server-name abended by signal signal-value

CASCD1109I ES SNA Communications Process created for Server server-name, process-id = pid

CASCD1110I ES SNA Communications Process for Region server-name has terminated normally

CASCD1111S ES SNA Communications Process for Region server-name exited with value exit-value

CASCD1112S ES SNA Communications Process for Region server-name abended by signal signal-value

CASCD1200I

CASCD4002 - CASCD4007

CASCF Error Messages

CASCF0001 - CASCF0015

CASCF0016 - CASCF0030

CASCF0031 - CASCF0045

CASCF0046 - CASCF0064

CASCF0064W config-module: Region region-name has already been stopped

CASCL Error Messages

CASCL0000 - CASCL0012

CASCL0000S Auto-install error, NETNAME netname busy

CASCL0001S Auto-install error, ENQ on NETNAME netname error

CASCL0002S Auto-install error, NETNAME netname already in use

CASCL0003S Auto-install error, TERMTYPE termtype locate error

CASCL0004S Auto-install rejected by user exit

CASCL0005S Auto-install error, TCT rechain error = tmp-return

CASCL0006S Auto-install error, netname delete error = tmp-return

CASCL0007S Auto-install, error calling user exit

CASCL0008S Auto-install error, MODEL model locate error

CASCL0009S Auto-install error, NETNAME netname out of service

CASCL0010S Auto-install error, NETNAME netname definition not client type

CASCL0011S Auto-install error, NETNAME netname TCTUA allocation failure

CASCL0012S Auto-install error: Error calling exit "exit-name"

CASCL0020 - CASCL0027

CASCL0020I Printer term-id initialized successfully

CASCL0021I Printer term-id disconnected successfully

CASCL0022W Printer auto-install failure, RC: terminal-id

CASCL0023W Printer registration failure, return code = return-code

CASCL0024S Printer memory allocation failure, return code = malloc-return-code

CASCL0025I Terminal disconnected successfully

CASCL0026S Auto-install error, hash table processing, NETNAME = netname

CASCL0027E Auto-install error, LU1 NETNAME(netname) MODEL(), device does not support SCS

CASDU Error Messages

CASDU0001W Error return-code deleting dump/trace file dump-filename

CASDU0002W Error return-code deleting dump/trace file dump-filename

CASDU0003W Error return-code deleting diagnostic file diagnostic-filename

CASDU0004I Switched diagnostic output to diagnostic-filename

CASDU0005I AUX Trace stopped and flushed to diagnostic-filename

CASFC Error Messages

CASFC0001I Fileshare services initialized

CASFC0002I Fileshare terminated

CASFC0003S Fileshare initialization terminated abnormally

CASFC0004S Critical Fileshare storage error

CASFC0005I Fileshare services message fileshare-message

CASFC0006I Fileshare current directory set to current-directory

CASFC0007I Fileshare services recovery initiated

CASFC0008I Error accessing file () group () - status=(,). File marked as closed and disabled.

CASFC0009I User (user-id) requested (request type) on file (filename) group (file group name) from Tran (trans-id) Program (terminal-id) Terminal ().

CASFC0010I Transaction (Transaction id) task number (Task number) user (User name) waiting for shared use of dataset (Dataset name).

CASFC0011I Transaction (Transaction id) task number (Task number) user (User name) required datasets have been acquired. Execution resumed.

CASFD Error Messages

CASFD0001 - CASFD0014

CASFF Error Messages

CASFF0001I Searching 'Search-path' for the location of 'file-name'

CASFF0002I Searching for the location of 'file-name'

CASFF0003I 'file-name' was found file-name-path

CASFF0004I Searched 'Search-path' path and failed to find 'file-name'

CASFF0005I Failed to find 'file-name'

CASFF0006S Invalid parameter on command line : command-line

CASFS Error Messages

CASFS5001I Fileshare Control Process initialization started

CASFS5002S Fileshare Control Process is not running in multi-threaded mode

CASFS5003I Fileshare Control Process initialization complete; Role is node-type

CASFS5004S Fileshare Control Process registration failed, reason = reason-code

CASFS5005S Fileshare Control Process storage allocation error

CASFS5006I fs-control-message

CASFS5007I Fileshare Control Process termination started

CASFS5008I Fileshare Control Process termination complete

CASFS5011I Fileshare Control Process restart in progress

CASFS5012I Fileshare Control Process current directory set to current-directory

CASFS5013S Fileshare Control Process user user-id signon error-text

CASFS5039I Fileshare process generated a dump to dump dataset dump-dataset

CASFS5054I Fileshare control process (PID:process-id) recovery initiated

CASFS5059I Fileshare process generated a dump to dump dataset dump-dataset

CASFS5060S Fileshare Control Process engine failed to initialize, reason = reason-code

CASFS5061I Fileshare control HA VSAM Primary node preparation complete

CASFS5062I Fileshare control HA VSAM Hot Standby node preparation complete

CASFS5063E Fileshare control HA VSAM assignment as role failed. Return code = return-code

CASFS5064S Fileshare control HA VSAM replication has failed. RC=return-code

CASFS5065W Fileshare Control Process initialization failed. HA VSAM is disabled.

CASFS5066I Fileshare internal control process initialized

CASMG Error Message

CASMG9999E message-number, message-insert , message-insert ...

CASMG0001I application display text

CASPI Error Messages

CASPI0100 - CASPI0600

CASPI0110E Date Time Applid An attempt to start transaction CPIH by something other than an attach request from web domain has been made. This is not allowed.

CASPI0111E Date Time Applid Tranid Call to WebSphere MQ function MQ function returned with reason code MQ reason code. Transaction abended.

CASPI0112E Date Time Applid Tranid Unable to locate URIMAP to match HOST Hostname and PATH Pathname. Unable to process inbound MQ message.

CASPI0113E Date Time Applid Tranid URIMAP urimap_name has been located for HOST hostname and PATH pathname, but does not have USAGE(PIPELINE). Unable to process inbound MQ message.

CASPI0114E Date Time Applid Tranid The pipeline MQ transport mechanism failed because a call to WebSphere MQ function MQ function returned with reason code MQ reason_code.

CASPI0115I Date Time Applid Tranid The service provider pipeline has returned a response message to the MQ transport, but the inbound request did not expect a response. The response message is ignored.

CASPI0300E Date Time Applid CICS could not invoke WEBSERVICE WebService because it was unable to find container container_name.

CASPI0400E Date Time Applid Tranid The CICS pipeline HTTP transport mechanism failed to send a request because Reason Error. Problem occurred for URI URI.

CASPI0403E Date Time Applid Tranid The CICS pipeline HTTP transport mechanism failed to receive a response because Reason Error. Problem occurred for URI URI.

CASPI0404E Date Time Applid Tranid A failure occurred in the CICS pipeline HTTP transport mechanism for PIPELINE Pipeline WEBSERVICE Web Service Name.

CASPI0453E Date Time Applid Tranid The CICS transport manager encountered an error while trying to use URIMAP urimap_name.

CASPI0454E Date Time Applid Tranid The CICS transport manager encountered an error while trying to use provider pipeline pipeline_name.

CASPI0500E Date Time Applid Tranid The CICS Pipeline Manager DFHPIPM encountered an error while trying to link to program Program. reason. PIPELINE: Pipeline.

CASPI0501E Date Time Applid Tranid The CICS Pipeline Manager cannot proceed as the pipeline is unusable. reason. PIPELINE: Pipeline.

CASPI0504E Date Time Applid Tranid The CICS Pipeline Manager has failed to communicate with a service provider due to an error in the underlying transport. TRANSPORT: Transport, PIPELINE: Pipeline.

CASPI0506E Date Time Applid Tranid The CICS Pipeline Manager has failed to communicate with a remote server due to an invalid URI scheme being specified. URI: Uri, PIPELINE: Pipeline.

CASPI0601 - CASPI0899

CASPI0703I Date Time Applid Userid PIPELINE Pipeline is about to scan the WSDIR directory.

CASPI0704I Date Time Applid Userid PIPELINE Pipeline Implicit scan has completed. Number of wsbind files found in the WSDIR directory:...

CASPI0710I Date Time Applid userid PIPELINE (pipeline) was successfully discarded.

CASPI0900 - CASPI0999

CASPI0901I Date Time Applid Userid New WEBSERVICE Webservice is being created during a scan against PIPELINE Pipeline.

CASPI0902I Date Time Applid Userid New WEBSERVICE Webservice is being updated during a scan against PIPELINE Pipeline.

CASPI0903I Date Time Applid Userid New URIMAP Pipeline is being created during a scan against PIPELINE Webservice for WEBSERVICE .

CASPI0904I Date Time Applid Userid URIMAP Urimap could not be created for WEBSERVICE Webservice in PIPELINE Pipeline. The URI that could not be allocated is: 'Uri'.

CASPI0910I Date Time Applid Userid WEBSERVICE Webservice within PIPELINE Pipeline has been created.

CASPI0912I Date Time Applid userid WEBSERVICE (webservice) was successfully discarded.

CASPI0913I Date Time Applid userid WEBSERVICE (webservice) is being discarded.

CASPI0914E Date Time Applid Userid WEBSERVICE Webservice is UNUSABLE because: Reason.

CASPI0915I Date Time Applid Userid WEBSERVICE Webservice is now INSERVICE and is ready for use.

CASPI0916E Date Time Applid Userid WEBSERVICE Webservice within PIPELINE Pipeline was not created because it clashes with another WEBSERVICE of the same name in PIPELINE Pipeline.

CASPI0950W Date Time Applid userid Attempt to discard URIMAP (urimap) failed. RC:

CASPI0951W Date Time Applid userid Attempt to discard WEBSERVICE (urimap) failed. RC:

CASPI0952W Date Time Applid userid Attempt to discard PIPELINE (urimap) failed. RC:

CASPI0997E Date Time Applid Tranid Pipeline The CICS pipeline manager has encountered an error: reason.

CASPI9640I Date Time Applid WEBSERVICE WebService should be installed into a PIPELINE soap version that uses SOAP version .

CASPI1000 - CASPI9999

CASPI1570I Date Time Applid userid URIMAP (urimap) was successfully discarded.

CASPI1010E Date Time Applid TaskId XML or JSON generation failed. A conversion error (Cause of error) occurred when converting field Error Qualifier for WEBSERVICE or BUNDLE Webservice or Bundle name.

CASPI1009E Date Time Applid TaskId XML or JSON to data transformation failed. A conversion error (Cause of error) occurred when converting field Error Qualifier for WEBSERVICE or BUNDLE Webservice or Bundle name.

CASPI1008E Date Time Applid TaskId XML generation failed because of incorrect input (Cause of error Error Qualifier) for WEBSERVICE Webservice.

CASPI1007E Date Time Applid TaskId XML or JSON to data transformation failed because of incorrect input (Cause of error Error Qualifier) for WEBSERVICE or BUNDLE Webservice or Bundle name.

CASRM Error Messages

CASRM0001I ODBC resource manager initialized

CASRM0002S ODBC resource manager initialization terminated abnormally, RC=return-code

CASRM0003I ODBC resource manager terminated

CASRM0004W ODBC resource manager warning warning-message

CASRM0005S ODBC resource manager error error-message

CASSP Error Messages

CASSP0001 - CASSP0017

CASSP0001W Failed to inform region manager of process death, reason = failure-code

CASSP0002I Region informed of process termination, pinfo = process-type, process-id

CASSP0003E Process process-id termination recovery initiation failed: errno = error-number

CASSP0004E Process process-id termination recovery initiation failed: RC = return-code

CASSP0010S Syncpoint failure - resource state unpredictable

CASSP0011S Syncpoint COMMIT failure - resource state unpredictable

CASSP0013S Syncpoint ROLLBACK failure - resource state unpredictable

CASSP0014S Process termination due to RTS error RTS-error-message

CASSP0015S Syncpoint PREPARE failure - resource state unpredictable

CASSP0016S Syncpoint OTHER failure - resource state unpredictable

CASSP0017S Process thread hung with shared memory locked (this simulates an ES failure)

CASST Error Messages

CASST0000 - CASST0010

CASST0011 - CASST0023

CASST0021W Server manager termination delayed waiting for ES communications to terminate

CASST0022W Server manager termination delayed waiting for ES service processes to terminate

CASST0023W Server manager termination delayed waiting for ES core processes to terminate

CASST4000 - CASST4111

CASST5000 - CASST6002

CASXO Error Messages

CASXO0001 - CASXO0015

CASXO0016 - CASXO0034

CASXO0027I XA recovery committed in-doubt transaction XID transaction number branch XID transaction branch number on RM Resource manager

CASXO0028I XA recovery rolled back in-doubt transaction XID transaction number branch XID transaction branch number on RM Resource manager

CASXO0029I XA log reported in-doubt transaction XID transaction number branch XID transaction branch number

CASXO0030S XA Automated recovery disabled for XA Switch Resource manager ID. The xa_recovery call returned rc XA return code.

CASXO0031W ES has lost connection to the RM XA RM Name, attempting to reconnect

CASXO0032I ES has regained connection to XA RM Name

CASXO0034E ES has failed to disconnect all SEPs from XA RM Name. Monitoring disabled

COBEC Error Messages

COBEC1244S use of SOAPFAULT API requires ECM SPFAULT directive to be set

User Exits

Exit Points

Exit Interface Definition

External Data Value Modification - Input Parameter (Exit Point 1)

Internal Data Value Modification - Input Parameter (Exit Point 2)

Unmapped Named External Input Parameter (Exit Point 3)

End of Input Request Processing (Exit Point 4)

Start of Response Processing (Exit Point 5)

Internal Data Value Modification - Output Parameter (Exit Point 6)

External Data Value Modification - Output Parameter (Exit Point 7)

End of Response Processing (Exit Point 8)

End of Request Processing (Exit Point 9)

Configuring Whether a Message Shows in the Console

Support Functions

PFI

PFI_IDPES_FN_DISPLAY_TO_UTF16

PFI_IDPES_FN_UTF16_TO_DISPLAY

PFV_IDPES_FN_ALLOC_MEM

PFV_IDPES_FN_FREE_MEM

Structures

IDP_EXIT_INFO

IDP_EXIT_SERVICE_FUNCS

REQHAND_RESPONSE

REQUEST_CONTEXT

Enterprise Server Security

Securing an Enterprise Server Installation

Architecture and Overview

About Securing an Enterprise Server Installation

Threat Models

Security Architecture

System Components and Process Flows

About the External Security Facility (ESF)

About Security Managers

About Security Queries

Designing the Security Policy

Configuring Enterprise Server Security

Security Configuration Stages

Adding a Security Manager to the Pool

To Add or Remove a Security Manager in the Pool

To Edit a Security Manager's Properties

Enabling a Security Manager

To Enable or Disable a Security Manager

Defining a Security Manager List

To Add a Security Manager to the Default ES Security Manager List

To Set Default Enterprise Server Security Configuration

Setting MF Directory Server Security Configuration

Customizing the Security Settings for an Enterprise Server Instance

To Set Security Configuration Options for an Enterprise Server

Security Configuration Custom Configuration Information

Implementing Security Manager Changes

To Update using the Enterprise Server Administration Interface

To Update Security Manager Changes Using esfupdate

Configuring External Security Facility (ESF) from the Command Line

About the esfadmin Command

esfadmin Command Syntax

esfadmin Usage Notes

Setting User Passwords with esfadmin

esfadmin Sub-commands

ADDACE, ALTACE, and DELACE

ADDCLASS and ALTCLASS

ADDGROUP and ALTGROUP

ADDMEMBER and DELMEMBER

ADDRESOURCE and ALTRESOURCE

Using the MFDS Internal Security Module

Working with Users, Groups and Resources

Application Access and Administration Access

Understanding Users and Groups

Understanding Permissions

Directory Server Permissions

Server Permissions

Managing Users and Groups

Setting Permissions

Best Practice

MLDAP ESM Module

LDAP Client and Server Software

The Micro Focus LDAP Schema

Wildcards for Resource, User, and Group Names

Username Substitution

Nested Groups

Resource Access Control

Matching Rules and ACEs

Compatibility Rule Matching

Resource Rules, Search Order, and Precedence

Match Rank

Resource Access Control Lists

Users and Groups

"Use all groups" Mode

Access Levels and Permissions

ACE Precedence

Processing ACLs

Module Configuration

MLDAP ESM Module Configuration Fields

MLDAP ESM Module Custom Configuration Information

Using All Groups to Which a User Belongs

Federation in the MLDAP ESM Module

Configuring Operating System Security: osesm

How osesm Works

osesm Module Configuration

Configuring Security using Active Directory

Setting Up Security with AD LDS

ldifde Notes

Installing Active Directory Lightweight Directory Service (AD LDS)

Creating the AD LDS Server Instance

Running the Setup Script

The es-ldap-setup AD Setup Script

Configuring Microsoft Users

To Configure a Security Manager's Environment

Configuring Enterprise Server to use the MLDAP ESM

Configuring the AD LDS Repository

Browsing the AD LDS Repository

Adding Repository Objects using ADSIEdit

Enabling MFDS Administration for LDAP and User Password Changes

Preparing Active Directory for Enterprise Server Security

Establishing a Work Directory and Copying Files

Command Window and PATH

Extend the AD Schema

Create LDAP Objects

Containers

Final User Tasks

Enabling ES Predefined Users

Disable Password Expiration for ES Users

Remove Predefined Users

Configuring the Default ESMAC User

Configure ES Security

Configuring Windows Users as Enterprise Server Administrators

Overview

The OS ESM Module

The MLDAP ESM Module

The Security Manager Stack

Objects and Attributes in Active Directory

Configuring ES and AD

Micro Focus User Groups and Resource Rules

Active Directory

Configuring Operating System Security: osesm

Configuring mldap_esm Security Manager for an LDAP

An ES Server Security Configuration

Testing

Default Server and MFDS Configuration

Restrictions

User Administration with MFDS

User Search Order

Windows Groups Not Used by ESF

For More Information

Configuring Active Directory Users as Enterprise Server Administrators

Connect to Active Directory

Giving a User ES Administration Authority

Start ADSI Edit

Create ES Security Managers

MFDS Security Configuration Screen

LDAP Security Manager

Setting the Default ES and MFDS Security Configuration

Set the Default ES Security Configuration

Setting the MFDS Security Configuration

Verify the Security Configuration

Verify that the ESDEMO Server Starts

Verify MFDS Restricted Access

Configuring Security Using OpenLDAP

Using an LDAP client library

About OpenLDAP for the Micro Focus Environment

Installing the Required Schema Extensions

Adding default MFDS users, user groups and resources

Configuring the OpenLDAP server

Confirming Extension Installation

Creating Standard Micro Focus application containers

Configuring mldap_esm Security Manager for an LDAP

Examples

Defining a User with LDIF

Defining a Group with LDIF

Defining CAS Resources with LDIF

Defining Files with LDIF

Managing LDAP Security Manager from the Enterprise Server UI

About Managing an LDAP

Changing User Passwords Stored in an LDAP

About Users, Groups and Resources

Managing User Access

To Add a User

To Edit a User

To Delete a User

To View Permissions for a User

Managing Groups

To Add a Group

To Edit a Group

To Delete a Group

To View Permissions for a Group

Assigning Resource Permissions

About Resource Security

To Enable Resource Security

To Add a Resource Class

To Add a Resource Entity

To Assign Resource Permissions

To Edit a Resource Class

To Edit a Resource Entity

To Assign Resource Permissions When Using MFDS Internal Security

To Delete a Resource Class

To Delete a Resource Entity

Security Configuration Screen Help

MF Directory Server Users, Add or Edit

Add Resource Class

Add Resource Entity

Add Security Manager

Add to Default ES Security Manager List

Add to ES Security Manager List

Add to MF Directory Server Security Manager List

Configure General Options

Confirm Password

Configure Journal Options

Configure Monitor Options

Configure Repository Options

Default ES Security Configuration

Directory Server Users

Edit Resource Class

Edit resource entity

Edit Security Manager

Left Pane Menu Items

MF Directory Server Security

Remove Security Manager Reference Confirmation

Security Managers Pool

SSL Options

Shut Down the MF Directory Server

Update User

User Group Members

User Groups

User Import: another user registry

User Import: previous version

ESF LDAP Security Administration Web Interface

Configuring the ESF LDAP Security Administration Web Interface

Operation

Managing Users

Managing Groups

Managing Resource

To Add a Resource Class

To Add a Resource Entity

To Edit a Resource Class

To Edit a Resource Entity

To Delete a Resource Class

To Delete a Resource Entity

ESF LDAP Properties

Migrating from Enterprise Server Early Versions

Integrating Security from Early Releases: casesm

Exporting MFDS Internal Security Definitions

To Export Micro Focus LDAP Schema Extensions

To Export Users and Groups to an LDIF File

To store the directory server repository in an LDAP server

AD LDS Migration Tasks

To extend an AD LDS repository to support Enterprise Server configuration objects

To update an extended AD LDS repository to support changes to Enterprise Server configuration objects

To migrate Directory Server users to an AD LDS repository

To Migrate Enterprise Server Users to an AD LDS Repository

To configure the security facility to use the MLDAP ESM

Implementing Enterprise Server Security with Active Directory

Security Reference Information

Environment Variables used in Enterprise Server Security

Enterprise Server Default Users and Associated Environment Variables

Resource Classes used by Enterprise Server

Resource Classes for ESF Features

Resource Classes for ESMAC and Operator Command Security

Resource Classes for MF Directory Server

Class - Enterprise Server Administration

Class - Servers

Solutions, Restrictions, and Changes in Behavior

Service Deployment and Security

Configuring Credentials for Starting and Stopping Enterprise Servers

Sign-on Disabled for Default Users

Configuring Sun Java System Directory as a Security Manager

Using External Security Facility (ESF) Features

OS ESM Module

Resource Access Control

Module Configuration

OS ESM Module Custom Configuration Information

ESF Caching

What is Cached?

Caching and Side Effects

Using Flush on Change

Enabling and Configuring Caching

Advanced Configuration

External Administrative Update Notification

Using Update Notification Requests

Making an Update Notification Request

Handling Update Notifications in an ESM Module

ESF Passtokens

Access to Passtokens

Passtoken Options for ESF Manager

Passtoken Options for the MLDAP ESM Module

ESM Module Configuration

LDAP Attributes

Typical Passtoken Configurations

Using Passtokens

Passtoken API

Security Federation

What Federation Does

Configuring Federation

ESF Manager Messages and Logging

Manager Interface Messages

ESF API Processing Messages

103W Admin "type" request failed: "value"

104W Update ("type") request failed: "value"

105W ESM Module number ("name") returned error code value ("description") from Update (type)

110E ESM Module number ("name") returned error code value ("description") from Verify

111E ESM Module number ("name") returned error code value ("description") from Auth

112E ESM Module number ("name") returned error code value ("description") from XAuth

113E ESM Module number ("name") returned error code value ("description") from Admin

114E ESM Module number ("name") returned error code value ("description") from Update

ESM Module Interface Messages

200I Loaded ESM Module "name"

201C Unable to load ESM Module "name": reason

202C ESM Module "name" returned invalid procedure table

203C ESM Module "name" initialization failed

204W ESM Module index returned error code value from Exit

Processing Environment Messages

301W Unable to open log file "name": ("value") description

320C CAS support function "name" is not available

321E Unable to allocate ACEE (error code)

322E Unable to allocate named shared memory (error code)

Cache Messages

User Exit Messages

Auditing Messages

601C Auditing subsystem startup failed: ("value") description

602C Auditing: cobaudit_event failed: ("value") description

ESM Module Messages

Temporary Messages

ESF User Exit

ESF User Exit File Names

Enabling an ESF User Exit

To enable the ESF user exit through configuration

To enable a mandatory ESF User Exit

Configuring an ESF User Exit

Configuration options for the Referential Integrity User Exit

The Referential Integrity Sample User Exit

Configuration options for the Referential Integrity User Exit

Source Code for the Sample User Exit

Rules Enforced by the Referential Integrity User Exit

Result Codes in the ESF API Parameter Block

Typical Result Codes for Verify

Typical Result Codes for Auth and XAuth

Typical Result Codes for Admin

Long Usernames and Passwords

Long Passwords

Long Usernames

Permitted Characters for Short Names

Name Mapping

Short-to-long Mapping

Short-to-long Mapping for Verify

Verify Request Throttling

Glossary

Enterprise Server Auditing

Configuring Enterprise Server Auditing

Audit Event Codes

Creating Custom Audit Events

Using the Security Audit Manager (deprecated)

About the Audit Manager (deprecated)

Audit Manager Architecture (deprecated)

About Audit Emitters (deprecated)

Audit Setup Configuration File (deprecated)

Default Audit Configuration (deprecated)

Getting Started with Auditing (deprecated)

Starting and Stopping the Audit Process (deprecated)

To Start the Audit Manager (deprecated)

To stop the Audit Manager (deprecated)

Configuring the AUDITFILE Emitter (deprecated)

Setting AUDITFILE Emitter Properties (deprecated)

Setting the Audit Output Type (deprecated)

Specifying a User-defined Emitter (deprecated)

Configuring the SNMP Emitter (deprecated)

Using the SNMP Audit Emitter (deprecated)

Using the SNMP Emitter with a Net-SNMP Agent (deprecated)

Configuring the emitter (deprecated)

Specifying the location of management tools (deprecated)

Configuring logging for problem diagnosis (deprecated)

Working with SNMP v3 (deprecated)

The SNMP V3 Specific Configuration Options (deprecated)

Configuring the Micro Focus Audit Emitter for SNMP V3 (deprecated)

Accessing Audit Data (deprecated)

mfauditadm command (deprecated)

To List Audit Event Consolidator Configuration Details (deprecated)

To Generate a Report for an Audit File (deprecated)

To Generate a Report for All Audit Files in a Collection (deprecated)

To Dump and Generate a Report for an Audit File (deprecated)

To Dump and Generate Reports for All Audit Files in a Collection (deprecated)

To Make the Active Audit File Available for Dumping (deprecated)

To Dump All Audit Files in a Collection (deprecated)

To Dump an Audit File (deprecated)

Using the Audit Manager as a Windows Service (deprecated)

To Install the Audit Event Consolidator as a Service (Windows only) (deprecated)

To Uninstall the Audit Event Consolidator as a Service (Windows only) (deprecated)

Audit Manager Errors (deprecated)

AUD0002E: Failed to start server (deprecated)

AUD0003E: Failed to connect to server (deprecated)

AUD0004E :Failed to initialise audit facility (deprecated)

AUD0005E: Failed to allocate memory (deprecated)

AUD0006E: File does not exist (deprecated)

AUD0007E: File is not available for dumping (deprecated)

AUD0008E: No file is available for dumping (deprecated)

AUD0009E: Invalid file format (deprecated)

AUD0010E: Invalid file name (deprecated)

AUD0011E: File not dumped (deprecated)

AUD0012E: Operation failed (deprecated)

AUD0013E: Failed to create output file (deprecated)

AUD0029E: Failed to initialise CTF (deprecated)

AUD0030E: You are not authorised to stop the server (deprecated)

AUD0031E: Failed to install service (deprecated)

AUD0032E: Failed to uninstall service (deprecated)

AUD0033E: File is not active (deprecated)

AUD0034E: You are not authorised to perform this operation (deprecated)

AUD0036E: Semaphore fault (deprecated)

Configuring a User Exit (deprecated)

AUDITFILE User Exit (deprecated)

Sample file auditfile_exit.c (deprecated)

Audit Manager APIs (deprecated)

API Return Codes (deprecated)

Audit Events (deprecated)

Audit Event Codes

Audit Configuration APIs (deprecated)

CBL_AUDIT_CONFIG_PROPERTY_GET (deprecated)

CBL_AUDIT_CONFIG_PROPERTY_SET (deprecated)

Audit Event Generation APIs (deprecated)

CBL_AUDIT_EVENT (deprecated)

CBL_AUDIT_HANDLE_GET (deprecated)

cobaudit_event (deprecated)

Audit Event Consolidator APIs (deprecated)

CBL_AUDIT_EMITTER_PROPERTY_GET (deprecated)

CBL_AUDIT_EMITTER_PROPERTY_SET (deprecated)

Audit File Processing APIs (deprecated)

CBL_AUDIT_FILE_CLOSE (deprecated)

CBL_AUDIT_FILE_OPEN (deprecated)

CBL_AUDIT_FILE_READ (deprecated)

cobaudit_file_read (deprecated)

Audit Emitter Interface (deprecated)

Audit Emitter Interface Overview (deprecated)

PFI_AUD_EMITTER_DEINIT (deprecated)

PFI_AUD_EMITTER_INIT (deprecated)

PFV_AUD_EMITTER_NOTIFY (deprecated)

PFI_AUD_EMITTER_OUTPUT (deprecated)

Structure and Typedefs (deprecated)

Structures and Typedefs for AUDIT_EMITTER_FUNCS (deprecated)

Structures and Typedefs - AUDIT_EVENT (deprecated)

Structures and Typedefs - AUDIT_EMITTER_EVENT (deprecated)

Structures and Typedefs - AUDIT_RECORD (deprecated)

Structures and Typedefs - EMITTER_NOTIF_PROP_CHANGE (deprecated)

Securing Communications

Introduction to Securing Communications

Configuring Secure Communications for Client Applications

Securing Peer to Peer Communications

Installing a Client Certificate for Enterprise Server

Adding a CA Root Certificate to your Client Application

Installing a CA Root Certificate in a Client Browser

Installing server certificates for secure communication

Installing a CA Root Certificate in a Client Browser

Setting Up Secure Communications

To enable secure communications with SSL

To configure an HTTPS listener

To Create a Secure Listener

To Start a Secure Listener and Set the Pass Phrase

To Configure the Pass Phrase in a File

Troubleshooting a Secure Connection

Accessing the Communications Server Console

To enable logging for listener startup

Troubleshooting Certificate Problems

Using the Demonstration Certificate Authority

About the Demo CA

OpenSSL and Micro Focus Demo CA

Installing Micro Focus Demo CA

Contents of the Demonstration CA

Your CA Certificate, Key and Password

Your Distinguished Name and Policy

Is the Demonstration CA a Real CA?

Tutorial: Requesting and Issuing Server Certificates

Requesting a Server Certificate

Issuing a Server Certificate

Tutorial: Configuring SSL Security in the Server