Micro Focus Enterprise Developer for Eclipse

Import Files from the Demonstration Program

Create an Enterprise Server

Configure the Enterprise Server

Start the AACT Enterprise Server

Run the AACT Transaction

Tutorials: CICS

Tutorial: CICS

Create a project

Import Sample Application Files

Create a Build Configuration

Specify Project Properties

Create and Start an Enterprise Server Region

Run the ACCT Application

Debug the Application

Set Enterprise Server Options

Create a Debug Configuration

Debug the ACCT Application

Tutorial: Web-enabled CICS Acting as a Web Server

Create and Configure a Project

Create the ACCTWEB Project

Import the ACCTWEB Sample Application

Set Project Properties

Create and Configure an Enterprise Server Region

Create an Enterprise Server Region

Configure and Start the ACCTWEB Region

Run the ACCTWEB Application in TN3270 Mode

Run the ACCTWEB Application in a Web Browser

Debug the Application

Create a Debug Configuration for Your Project

Debug ACCTWEB

Tutorial: Web-enabled CICS Acting as a Web Client

Create and Configure a Project

Create the ACCTCLNT Project

Import the ACCTCLNT Sample Application

Set Project Properties

Create and Configure an Enterprise Server Region

Create an Enterprise Server Region

Configure the ACCTCLNT Region

Run the ACCTCLNT Application

Debug the Application

Create a Debug Configuration for Your Project

Debug ACCTCLNT

Tutorials: CICS Web Services

Demonstration Applications

Tutorial: CICS Web Service Provider from WSDL, Top-down Method

Tutorial: CICS Web Service Requester from WSDL, Top-down Method

Tutorial: CICS Web Service Provider from WSDL, Bottom-up Method

Tutorial: CICS Web Service Provider from JSON, Request-Response Top-down Method

Tutorial: CICS Web Service Requester from JSON, Linkable Interface Top-down Method

Tutorial: CICS Web Service Provider from JSON, Request-Response Bottom-up Method

Tutorial: CICS Web Service Provider from JSON, RESTful

Tutorials: IMS

Tutorial: IMS Support

Create and Configure a Project

Configure IMS

Create and Configure an IMS Enterprise Server

Run MFDEMO

Debug MFDEMO

Tutorials: IMS Data Tools

Tutorial: IMS Segment Layout Editor

Tutorial: IMS Database Editor

Tutorial: JCL

Configure an Enterprise Server for JCL Support

Create an MSS-enabled Enterprise Server

Edit the MSS-enabled Enterprise Server

Configure JES Support

Configure the Program Paths

Define a Batch Initiator SEP

Create and Build a JCL Application

Import the Files from the Demonstration Program

Specify the Project Properties

Build the Application

Associate your Project with the JCL Enterprise Server

Start your Enterprise Server

Deploy to Enterprise Server

Submit and Run a JCL Job

View the Spool Queues

View the Catalog

Debug Dynamically under Enterprise Server

Set Enterprise Server Preferences

Start Debugging

View the List of Attached Debuggers

Tutorial: DSNREXX

Tutorials: PL/I

Creating Your First Hello PL/I World Application

Debug the Hello PL/I World Application

Tutorial: Developing a PL/I application using Eclipse

Eclipse PL/I tutorial overview

Create a PL/I Project

Create a PL/I source file, opdemo.pli

Create a build configuration

Create a PL/I source file, opdemo2.pli

Create a JCL file

Configure an enterprise server to run PLI programs under JCL

Configure an MSS-enabled enterprise server

Enable JES

Configure program paths

Add an initiator

Enable PL/I Support

Associate your project with the enterprise server

Start the enterprise server

Submit and run a JCL job

View the spool queues

Debug the program

Stop the Enterprise Server (Eclipse JCL)

Tutorials: AppMaster Builder

Demonstration Application

Main Menu Program and Screen

Customer Record Maintenance Program and Screen

Part Inventory List Program and Screen

Tutorial: Start AppMaster Builder in Enterprise Developer for Eclipse

Tutorial: Create a User Area

Tutorial: Create Projects

Tutorial: Add Objects to the AMB Project

Tutorial: Set Preferences and View Properties

Tutorial: Learn Screen Painter Techniques

Tutorial: Paint a Screen

Tutorial: Assign Screen Field Edits

Tutorial: Code a User Rule

Tutorial: Map Screen Fields

Tutorial: Define Program Actions

Tutorial: Define Database Access

Tutorial: Generate and Compile the Application

Native COBOL Tutorials

Tutorial: Creating a Native COBOL Application

Creating a Project

Adding Source Code and Building the Project

Create a build configuration

Importing the AirportDemo Sample

Launch a Debug Session

Tutorial: Running Unit Tests in the IDE

Create a Workspace

Creating a Unit Test Project

Creating a Test Fixture

Running the Test

Running the Test Under Code Coverage

Enhancing the Test

Debugging the Failed Test

Fixing and Rerunning the Failed Test

Tutorials: Interface Mapping Toolkit

Set Build and Interface Mapper Preferences

Tutorial: SOAP Service Interface

Prerequisite

Create a Service Interface

Define Service Interface Operations

Create and Configure ESSOAP

Deploy a Service Interface

Generate a COBOL Client

Run the MakeCheckAppt Web Service

Tutorial: EJB Service Interface

Create a Service Interface

Define Service Interface Operations

Configure ESDEMO

Deploy a Service Interface

Generate and Deploy a JSP Client

Deploy the Resource Adapter to JBoss

Run the JSP Client

Tutorial: REST Service Interface

Prerequisite

Create a Service Interface

Define Service Interface Operations

Create and Configure ESREST

Deploy a Service Interface

Generate a COBOL Client

Run the MakeCheckAppt Web Service

Tutorials: OpenESQL Assistant

Tutorial: Create a SQL Server Database

Tutorial: Create and Configure an Eclipse 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: Debug the Application

Tutorial: Data File Editor

Import and Build 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

Import and Build an Eclipse Project

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

Tutorial: Using the Callable File Handler

Tutorial

Create a Native COBOL Project

Set the Project Properties

Define the Operation Codes and FCD

Define the Filename Area

Define the Key Definition Block

Define the Record Area

Set up the FCD

Call the Callable File Handler and Check the File Status

Create, Write To, and Close an Indexed File

Read From and Rewrite To the File

Run the Application

Appendices

Appendix A - the source code

Managed COBOL Tutorials

Tutorial: Creating a Basic JVM COBOL Application

Create a COBOL JVM Project

Create a Class and Build Your Project

Run the JVM Application

Debug the Application

Tutorial: Deploying JVM COBOL to an Application Server

Run-time Considerations

Restrictions

Install and Configure an Application Server

Configuring JBoss

Configuring WebLogic

Configuring WebSphere

Tutorial: Deploying an Enterprise JavaBean Containing JVM COBOL to a JBoss Application Server

Tutorial Prerequisites

Copying the Tutorial Files

Creating the Workspace

Importing the Project Files

Stepping through the Projects

The COBOL Project - TemperatureConverter

The EJB Project - TemperatureConverterEJB

The Dynamic Web Project - TemperatureConverterPrj

Deploying the JVM COBOL Run-time System within the Application

Deploying the Application

Showing the Server Status

Debugging the Application

Tutorial: SQL - Deploying an Enterprise JavaBean Containing JVM COBOL to a JBoss Application Server

Install and Configure a JDBC Driver

Create and Load a SQL Server Database

Modify COBOL Source

Deploy the COBOL JVM Runtime

Run the JSP Application

Tutorial: Calling JVM COBOL programs as part of an Axis Web service

About the Web service description

Create a Web Service Description Language document

Create the WSDL document using the editor

Setting the service endpoint

Create the addBook operation with parameters

Create the BookDetail type

Create the BookReturn type

Add the rest of the operations

Binding information

Validate the WSDL

Create the JVM project

Create the wrapper project

Create the dynamic Web project

Create a new project

Generate the server-side code

Add the bridge code

Configure the project

Update the BookLegacySkeleton class

Using JBoss

Configure for deployment

Include the class files

Export the content

Run the application

Use the Web Service Explorer

Debug the Web service

Tutorial: Creating a JVM COBOL Application Using a JavaFX Interface

Customizing the COBOL Perspective

Creating a COBOL JVM Project

Importing Native COBOL Procedural Code

Creating a COBOL JVM Unit Test Project

Configuring Project Dependencies

Importing Source Code into the COBOL JVM Unit Test Project

Running the Tests

Creating a Project to Expose the Record Functions

Configuring Project Dependencies

Creating a New COBOL JVM Package

Creating a New COBOL JVM Class

Creating a COBOL JVM Interface

Creating an Implementation of the IWrapper Interface

Creating a Java JUnit Testing Project

Creating a Project to Handle the User Interface

Customizing the COBOL Perspective

Tutorial: Packaging JVM COBOL

Importing the Projects

Creating a JAR File Output Folder

Building the AddressBookJVM and AddressBookWrapper Projects

Updating the addressBookFX Project to use .jar Files and COBOL JVM Runtime

Packaging the JVM COBOL Application from the Command Line

Tutorial: Compiling a COBOL Program to JVM Byte Code

Customizing the COBOL Perspective

Creating a COBOL JVM Project

Creating a New Package

Creating a COBOL Program

Creating a Java Project to Use the Application From

Updating the Project's Dependencies

Creating a New Class to Contain the Main Method

Using the COBOL Program from Java

Web Services Tutorials

Tutorial: Reusing Existing COBOL Programs in a Java Web Services Environment

Installing JBoss Enterprise Application Platform

Tutorial Project Goals

Setting Up the Tutorial Environment

Installing Apache Tomcat

Installing the IBM WebSphere Plug-in

Installing the Oracle WebLogic Plug-in

Copying the Tutorial Files

Creating the COBOL Components

Creating the JVM COBOL Project

Creating the Copybook File

Creating the COBOL Program

Setting the COBOL Compiler Directives

Adding the Data File

Creating the Java Components

Understanding Run Units and Sessions

Creating the Dynamic Web Project

Creating a JSP View

Creating the Java Bean

Converting Status Codes to Exceptions

Creating a Session Management Class

Creating the Servlet

The Servlet Deployment Descriptor

Running and debugging

Summary

Tutorial: Reusing Existing SQL Programs in a Java Environment

Install and Configure a JDBC Driver

Create a SQL Server Database and Connection

Modify COBOL Source

Modify Java Source

Add and Modify XML

Run the JSP Application

Modifications for DB2 LUW

Modifications for Oracle

Procedural COBOL Compared with Managed COBOL

Technology Preview Features

Enterprise Developer Editions and Licenses

To buy and activate a full license

To obtain more licenses

Product Information

Installation

Before Installing

Downloading the Product

On Windows

System Requirements

Hardware Requirements

Operating Systems Supported

Software requirements

Additional Software Requirements on Windows

Product Co-Existence

Installation Restrictions and Requirements

On UNIX

System Requirements

Hardware Requirements

Operating Systems Supported

Software Requirements on UNIX

Additional Software Requirements on UNIX

Enterprise Developer Installation Options

Basic Installation

Installing on Windows

Installing on UNIX

Advanced Installation Tasks

On Windows

Installing as an Upgrade

Installing and Licensing Micro Focus Rumba

Installing into other instances of Eclipse

On UNIX

Installing as an Upgrade

UNIX Installation Options

RPM Installer

Using the RPM Installer

Other RPM Installer Options

Uninstalling Using the RPM Installer

Installing on Microsoft Terminal Server and Citrix

Customizing the Installation, the Workspace 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

Mainframe Access Installation Guide

Introduction

Dependent Address Space Services

Mainframe Access Services

z/Server Feature

Migration information

General migration actions

Migration actions for MFA Started Task JCL procedure

Migration actions for MFAS Started Task JCL procedure

Migration actions for MFAAS Started Task JCL Procedure

Migration to use the XML configuration file

Migrating old configurations to new XML configuration

Migration actions for MFA Started Task JCL procedure

Migration actions for MFAAS Started Task JCL Procedure

Additional migration for z/Server feature support

Installation requirements

Machine requirements

Software requirements

Mainframe Access Configuration Utility

Starting the Mainframe Access Configuration Utility

Operation

Creating a new XML configuration file

To upload your XML configuration file to a mainframe

Downloading an existing XML configuration file

Edit Configuration page

Configuration parameters reference

MFA Server parameters

Data Connect Application Server parameters

Endevor Application Server parameters

ChangeMan Application Server Parameters

AMS Application Server Parameters

MFA Data Connect Service parameters

RIMS Service Parameters

MCO Service Parameters

ES-MTO Service Parameters

z/Server feature Parameters

z/Server Scheduler Application Server Parameters

Host Installation

Preparing the Installation

Before you begin

SVC Routine

Installation procedure

Upload the software

Receive the software

Configuration overview

Mainframe Access Data Sets

Mainframe Access Samples

Quick Configuration

MFA Started Task JCL Procedure

MFAAS Started Task JCL Procedure

MFAS Started Task JCL Procedure

MFAAMS Started Task JCL Procedure

Mainframe Access MFAXML

VTAMLST Definitions

Add Started Task JCL Procedures to Proclib

APF-Authorize the Load Module Libraries

Define Mainframe Access to the Security Subsystem

Starting Mainframe Access

Stopping Mainframe Access

Advanced Configuration Activities

Editing Mainframe Access Parameters

Editing Mainframe Access Application Server Parameters

Application Servers

Application Server Parameters for the Mainframe Access Data Connect Server

Application Server Parameters for Endevor support

Application Server Parameters for AMS/IDCAMS support

Application Server Parameters for ChangeMan support

Application Server Parameters for z/Server Scheduler support

Services

Service Parameters for ES/MSS

Service Parameters for Mainframe Access Data Connect Server

Service Parameters for IMS Option (Remote IMS)

Service Parameters for CICS

Editing Access List Definitions

Permission and Rejection Lists

Example 1

Example 2

Allocating and Initializing an Audit Log Data Set

Adding Mainframe Access to TCP/IP's Autolog List

Setting Up a Mainframe Access GTF Procedure

Adding the GTF Procedure to a System Procedure Library

Testing the Mainframe Access GTF Procedure

Defining RACF Profiles for JES Spool Access

Running Multiple Instances of Mainframe Access Server

Troubleshooting

Abend Codes

System Abend Codes

Mainframe Access User Abend Codes

LU6.2 Diagnostic Information

RTNCD and FDB2 Return Values for LU6.2 APPCCMD Calls

RCPRI and RCSEC Return Values for LU6.2 APPCCMD Calls

Mainframe Access Host Error Codes

Mainframe Access Remote IMS Error Codes

IBM SAF and RACF Error Codes

Error Codes for VERIFY Requests

Error Codes for AUTH Requests

Mainframe Access Audit Report Program

Running the Audit Report Program

Audit Report Abend Codes

Audit Report Diagnostic Messages

Obtaining a VTAM Buffer Trace

Starting GTF

Activating the VTAM Trace

Deactivating the VTAM Trace

Stopping GTF

Formatting VTAM GTF Trace Records

Obtaining an SVC Dump of Mainframe Access

Packaging and Transmitting Diagnostic Data

Customizing Data Connect

Samples for Configuration

JCL Change for Data Connect

Configuring Access to External Library Management Systems

About External Library Management

Panvalet

About Panvalet

References

Panvalet Suffix Table

Suffix Table Override

Panvalet Security Exit

Librarian

Endevor

Endevor Dependent Regions

Endevor C1DEFLTS File

Endevor Setup Errors

ChangeMan ZMF

About ChangeMan ZMF

Customization

Control Region Startup Parameters

Control Region Started Task JCL

CMNOPTS

CMNLIB$

CMNJOB$

Dependent Region Started Task JCL

References

AppMaster Builder Support using APS Components

Configuring Access to Enterprise Server Mainframe Subsystem Support

Define the Target z/OS CICS System

MFA Server Configuration for ES/MSS

Enable ES/MSS Support

Define the Target ES/MSS Server

Restart MFA Server

Technical Details

How ES/MSS Understands the Connection

How z/OS CICS Understands the Connection

Configuring z/Server feature support

Introduction

z/Server overview

The z/Server configuration file

Program materials

Configuration overview

Preparing for configuration

Steps to activate z/Server

Defining a client connection to z/Server

Define Started Tasks to z/OS

Define started tasks to RACF and ACF2

APF authorizations

Define started tasks to WLM

Customizing the MFA Server address space JCL (MFA)

Customizing an STC scheduler address space JCL (TAURISPF)

Customizing a user server address space JCL (IVPUSRT)

Optional: Customizing a CEA-launched TSO user address space JCL (CEAPROC)

Configuring z/Server

General configuration

Scheduler configuration

Troubleshooting the z/Server configuration

Customizing GTF tracing

User authorizations

Enable model configuration

Optional customization

ISPF user profile

Usage in a parallel sysplex

z/Server startup and installation verification

Verifying z/Server feature support startup

Verifying scheduler startup

Verifying user server startup

Verifying CEA user servers (optional)

Optional: Adaptations to the IBM Developer for System z RSED installation

ISPF Client Gateway

Master configuration

Host installation verification

Console Commands

Starting and stopping the z/Server feature

Console Commands

General Mainframe Access Server commands

Start

Stop

TRACE ON and TRACE SHORT

Mainframe Access z/Server feature commands

Starting and stopping a z/Server scheduler address space

Stopping a specific user server address space

Stopping all user servers for a Specific user ID

Stopping all user servers for a Specific Scheduler address space

Display commands for TSO information

Display TSO statistics

Display VPOOL

Diagnostic commands

Configuration Dump

SVC Dump

Important storage areas

Selected storage areas

Display data space information

Setting IPTRACE level

Turn Off LE Error Handling

REXX commands

Administrative commands

Delete a TSO User in user administration

Releasing the SPFEDIT serialization ENQ

Port skip

Refresh a load module

Mainframe Access Messages

Mainframe Access Server Messages

Mainframe Access Operational Messages Format

Mainframe Access Messages

Data Set Services Messages

MFMDS001I DSS Server Ready

MFMDS002I DSS Initialization failed

MFMDS003I Cell pool build failed

MFMDS004I Public File non-VSAM

MFMDS005I DSS Server shutdown

MFMDS006I DSS Server unidentified request

MFMDS007I

MFMDS008I Online ITEM LIBRARY=data-set-name

MFMDS009I Offline ITEM LIBRARY=data-set-name

MFMDS010I DAIR reas/info DSN=data-set-name

MFMDS011I TIOT ENQ INTERFERENCE

MFMDS012I M=member ENQ FAILURE RC=nnn

MFMDS013E OPEN FAILED FOR SNAP | READER | SYSOUT

MFMDS020E Invalid z/OS file format

MFMDS021E LRECL too high

MFMDS022E Invalid file handle

MFMDS024E Invalid file name

MFMDS026E LRECL EXCEEDS DEFINITION FOR DSN=dsname

MFMDS029E RECALL FAILURE=nnnnn FOR DSN=dsname

MFMDS030E STOW error RC=nn Reason=nnnn M=member

MFMDS031I DSN=data-set-name

MFMDS032E FIND error RC=nn Reason=nnnM=member

MFMDS033E BLDL error RC=nnReason=nnn M=member

MFMDS034E Directory error RC=nn Reason=nnnn

MFMDS035E QSAM abend Sxxx-yy

MFMDS040E VSAM error DD=ddname RC=nn FB=nnn REQ=verb

MFMDS041E VSAM open error DD-ddname RC=nnFB=nnn

MFMDS050E DSS services not available

MFMDS052I CAPANVALET READY

MFMDS053I CAENDEVOR API REL Brrvvv ESI

MFMDS054I Librarian Exit Table active

MFMDS055I MCGRPC feature (in)active

MFMDS056I ChangeMan DD=CMNxxxx Open failure

MFMDS057I CAPANVALET member security exit loaded

MFMDS058I Librarian ELIPSGEN not found

MFA Direct Messages

MFA0101I LOGON USER=userid TIME=hhmm DAY=nnn ID=nnnnnnn VER=nn

MFA0102I LOGOFF USER=userid ID=nnnnnnn

MFA0103I AUTH FAIL USER=userid RC=rc RACF=rr/ss

MFA0105I {AUTH or FAIL} USER=userid INTENT=action AM=method DSN=dsname

MFA0111E MFA INVALID DISPATCHING VERB

MFA0112E MFA MCB Environment failure

MFA0113E MFA TSA already in use

MFA0801E JES/SAPI RC=xx REASON=yy

MFA0802E I/O ERROR ON INTERNAL READER

MFA0803E JES SSI ERROR FUNC=xx RC=yy

MFA0804E JES STATUS RC=xx REASON=yy

MFA1034I CSI CATALOG ERROR nn RC=nnn REASON=nnn (ID) filter

MFA1035I CATALOG ERROR RC=nnn VOL=volid DSN=dsname

MFA1036I CSI VSAM ERROR RC=nnn REASON=nnn DSN=dsname

MFA1037I CSI GDGB ERROR RC=nnn REASON=nnn DSN=dsname

MFA4001E CA/LIBRARIAN ERROR REQ=aaaa RC=nnn

MFA4002E OPEN FAILED ON LIBRARIAN UPDATE

MFA4003E WRITE ERROR ON LIBRARIAN UPDATE

MFA5001E CA/PANVALET ERROR REQ=aaaa RC=nnn MSG=PVnnn

MFA5002E CA/PANVALET LICENSE FAILURE: access quiesced

MFA5003E CA/PANVALET PAN#1 error RC=nnnnn

MFA5004E I/O ERROR on PANVALET Temporary file

MFA6001E ENDEVOR API ERROR REQ=aaaa RC=nnn/rrrr/msgid

MFA6002E I/O ERROR ON ENDEVOR TEMPORARY FILE

MFA6003E SYNTAX ERROR ON ENDEVOR ENVIRONMENT STRING

MFA6004E ENDEVOR INTERFACE ABEND: abend-reason userid session-id

Data Connect Messages

MFA100E ESTAE ENTERED ABEND CODE Uxxx/Sxxx

MFA101E LIMIT OF 256 PROCESSES EXCEEDED

MFA110I VTAM PROCESSOR ACTIVE USING VTAMAPPL applid

MFA111W VTAM ACB CLOSE FAILURE

MFA112I VTAM PROCESSOR HAS TERMINATED

MFA113E USING VTAMAPPL applid ACB OPEN ERROR X"xx"

MFA114E APPC SESSION REJECTED PRI=xxxxxxxx SEC=xxxxxxxx

MFA115E MFA DOES NOT SUPPORT 3270 DATASTREAMS

MFA201W ERROR OPENING DDNAME=VSAMCTL

MFA202I ERROR READING VSAMCTL FOR membername

MFA299E ADDRESS SPACE NOT AUTHORIZED

MFA301E JCL PARM INVALID OR OMITTED

MFA302I ATTACHING VTAM PROCESSOR

MFA303I MFA/DATACONNECT V4.00 - vers

MFA310E INVALID OPERATOR REQUEST IGNORED

MFA311W PROCESS ALREADY RUNNING

MFA317I jobname HAS BEEN TERMINATED

Drag and Drop Error Messages

MFDAS01: Mainframe access problem.

MFDAS02: Cannot import multiple files to a single file.

MFDAS03: Cannot export multiple files to a single file.

MFDAS04: Module 'MFLSC' is missing or inaccessible.

MFDAS05: File had no length, or does not exist.

MFDAS06: Call to module 'DFCONV' failed. Unable to convert the VSAM/QSAM file.

MFDAS07: Value is not a valid number.

MFDAS08: For VSAM/QSAM files, extensions of PRO, DAT, or IDX are reserved.

MFDAS09: Rename to file failed.

MFDAS10: The allocation of failed with message number.

MFDAS11: The allocation of differs from the mainframe.

MFDAS12: One or more of the fields have not been properly entered.

MFDAS13: The PC file name cannot have more than 4 subdirectory levels.

MFDAS14: Mismatch between new and repeat passwords.

MFDAS15: Unable to make the directory.

MFDAS16: Unable to remove directory.

MFDAS17: Call to module 'PCIMS' failed. Unable to convert the IMS database.

MFDAS18: A catalog search criteria must be entered.

MFDAS19: A real workstation drive must be used.

MFDAS22: Call to module 'SQL-Wizard' failed. Unable to convert the XDB table.

MFDAS23: Cannot establish connection to the mainframe server.

MFDAS24: Network communication problems with blocks of size.

MFDAS25: CCI module was not found.

MFDAS26: Module is not a CCI module.

MFDAS27: Unable to delete file.

MFDAS28: Either recall this dataset or assign a type.

MFDAS29: Assign a type to this dataset.

MFDAS30: The workstation dataset is connected to the mainframe

MFDAS31: Copy of file failed.

MFDAS32: Paste of file failed.

MFDAS33: PCIMS is not available. Unable to convert the IMS database

Status Codes and Error Messages

Status Codes Returned by the MVS Server

File Status Comparisons

Cross Reference of File Status Setting

Configuration reference

Mainframe Access Server configuration parameters

Configuration parameters - quick reference

Configuration parameters - alphabetical list

CHANGEMAN_COMMON_BUILD

CHANGEMAN_DSNQUALIFIER

CHANGEMAN_INTERFACE

CHANGEMAN_SSID

CHANGEMAN_TEST_OPTION

MFA_ACCEPT_EMPTY_FILES

MFA_ENDEVOR_HISTORY

MFA_ENDEVOR_INTERFACE

MFA_GUI_ACCEPT_PASSPHRASES

MFA_GUI_BLANKPASSWORD

MFA_GUI_IGNORUSERCTO

MFA_JOBNAME_CHECK

MFA_LIBRARIAN_DIR_INFO

MFA_LIBRARIAN_HISTORY

MFA_LIBRARIAN_INTERFACE

MFA_LIBRARIAN_UPD_MODULE

MFA_MCG_DB2CONNECTION

MFA_PANVALET_HISTORY

MFA_PANVALET_INTERFACE

MFA_PANVALET_UPD_MODULE

TIMEOUT_FOR_CONNECTION

TIMEOUT_FOR_INITIAL_RECEIVE

Mainframe Access Server z/Server feature configuration parameters

Configuration parameters - quick reference

Configuration parameters - alphabetical list

After Installing

Configuring Enterprise Developer

On Windows

Installing X Windows on Windows

Repairing on Windows

Uninstalling

On UNIX

Configuring the Remote System Explorer Support

Repairing on UNIX

Uninstalling

Installing Enterprise Developer Development Hub

Before Installing

Downloading the Product

Operating Systems Supported

System Requirements

Hardware Requirements

Software Requirements

Additional Software Requirements on UNIX

Basic Installation

Installing on UNIX

Advanced Installation Tasks

Installing as an Upgrade

UNIX Installation Options

RPM Installer

Using the RPM Installer

Other RPM Installer Options

Uninstalling Using the RPM Installer

After Installing

Setting up the product

Configuring the Remote System Explorer Support

Repairing on UNIX

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

Setting up network licensing with COBOL server

Installing License Manager without Sentinel RMS

Standard installation

Silent installation

Trial licenses

Commuter licenses

To obtain a commuter license

To return a commuter license

Usage log

Licensing Error Messages

Initialization error - Initializing: Cannot communicate with licensing daemon

Error - Initalizing: Cannot find initialization file

Error - Unable to manage licenses in license manager that is not running on localhost

Error [5]: Cannot talk to the license server on host "xxx.x.x.x". Server not running

Error authorizing... Remote request error - The authorization code is invalid

Error [26] - Request Denied due to clock tamper detection

Error[18]: No license code is available for feature (component)

Unable to authorize (cause)

Updates and Product Support

Micro Focus End User License Agreement

Known Issues and Restrictions

Application Server JCA Support

Application Workflow Manager

AppMaster Builder

Analysis Option

COBOL

Distributed Generation Server

Project Explorer

Workgroups

Calling COBOL Programs from C

COBOL Programming

Boolean Data Items

CBL2XML Utility

Interface Mapping Toolkit

Enhanced ACCEPT/DISPLAY Syntax (Adis)

Filenames

Gateway Profile Utility

IDXFORMAT 8 and 12 File Size Limits

Unsupported Features

XML Extensions

Compatibility

Coexisting with earlier Micro Focus products

Installation on Windows

Records with Alternate Keys

Data Access

Classic Data File Tools

Debugging, Problem Determination and Diagnostic Tools

Debugging in Eclipse

Development Remote Connection

Error markers

Language Service

Remote Debugging

Reverse Debug and Live Recording

Test Coverage

Just-in-time debugging

Docker

Documentation

Eclipse IDE

Background Parsing

Building Applications

Code Analysis

Eclipse Help Viewer

Eclipse Projects

Editing Symbolically Linked Files

Enterprise Server sign on credentials

Java Support

Leaking File Handles

Micro Focus Unit Testing Framework

JVM Code

Adding Projects to a COBOL JVM Project's Java Build Path

Editing Remote JRE Settings

OpenESQL

Using Java and JVM COBOL Together

COBCH0015S Procedure division too large

Mainframe Programming and Management

HCO for SQL Server (HCOSS)

Historical Statistics Facility (HSF)

IMS Support

JCL

Mainframe Call Generator

Mainframe Subsystem Support (MSS)

PL/I Support

Run-time Behavior

SQL Option for DB2

Remote Mainframe Development

Resource Adapters

Contacting Micro Focus

Further Information and Product Support

Information We Need

Contact information

Sample Programs

To start the Samples Browser

Demonstrations of Mainframe Subsystem Support

Demonstrations of COBOL

Using the Command Line Demonstrations

Command Line Demonstrations of COBOL for JVM

Command Line Demonstrations of Native COBOL

Command Line Demonstrations of COBOL used with SQL

Command Line Demonstrations of COBOL used with Business Information Server (BIS)

Cheat Sheets

The Micro Focus Community

Help on Help

Developing Applications in the IDE

Starting Eclipse

To start Enterprise Developer

To start Enterprise Developer as an administrator

To start an Enterprise Developer command prompt

To start an Enterprise Developer command prompt as an administrator

Introduction to Eclipse

Eclipse Basics

Workspaces

IDE Preferences

Projects

Selecting a Project Template

Remote Projects

Using the Windows and Menus

The Eclipse Welcome Page

Views

COBOL Views

PL/I Views

Team Perspective Views

Perspectives

Menus and Toolbars

Controlling Views and Editors

Navigation Shortcuts

Creating Your First Hello COBOL World Application

Creating Your First Hello PL/I World Application

Advanced Details

The Eclipse Resource System

Configuring Projects

Inter-Project Dependencies

Dependency Paths

Including Files and Folders

Working Sets

Configuring the Hello COBOL World Application

Development Life Cycle

Adding Projects to Your Workspace

Adding Existing Source Files into a Project

Specifying Compiler Directives and Project Settings

Editing

Building

Running and Debugging

Debug the Hello COBOL World Application

Debug the Hello PL/I World Application

Additional Eclipse Functionality

Configuring Eclipse

Micro Focus Builder Preferences

Build Directives for Standalone Editing

File Extensions

Using Eclipse for COBOL Development

Overview of Creating COBOL applications in Eclipse

Tips and Tricks with the IDE

COBOL Perspectives and Projects

Writing Code Efficiently in the COBOL Editor

Configuring AutoCorrect

Customizing the Editor

Configuring Background Parsing

Configuring Syntax Coloring

Configuring Smart Edit Mode

Editing Assistance in the COBOL Editor

Configuring Content Assist for COBOL Programming

Inserting and Removing Line Numbers (Renumber and Unnumber)

To specify line numbering options

To number or renumber lines in source code

To remove line numbers from source code

Using COBOL Code Templates

Searching using Micro Focus Search

Viewing Copybooks in Context

Working With a Large Code Base

Working with Projects and a Large Code Base

Accessing Source Code Without a Project

Optimizing the Performance of the IDE

Configuring Large Projects

Large Projects and Remote Development

Building Applications in Eclipse

Building Applications Outside of Eclipse

Best Practice When Upgrading a Legacy Application

Steps to Upgrading Your Application

Creating COBOL Projects

Creating and importing COBOL projects

To create a COBOL project

To import an existing Eclipse project

Creating service interface projects

Converting Net Express projects to Eclipse projects

To load projects into the Team Developer perspective

Creating and importing resources

To create a new file

To create a new file from a custom template

To import a file into a project

To import a copybooks into a virtual folder

To associate a file extension with COBOL

Extracting COBOL code to a copybook

To create a COBOL JVM Enum type

To create a COBOL JVM Delegate

To create a COBOL JVM Value type

Using source files from outside your project

To create project dependencies

To remove project dependencies

To link to copybooks or sources outside the project

To link to mainframe locations

To create a project or a file from a custom template

Using custom project and file templates

To create a custom project template

To create a custom file template

To configure the IDE to use custom templates

Indicating Whether a File is a Copybook or a COBOL Program

Configuring the Project, Build Configuration and File Properties

Project Properties

Build Paths

Build Settings

BMS Properties

Build Directives for Standalone Editing

File Extensions

Run-Time Configuration Properties

File Properties

To set file properties using directive scanning

Developing applications on remote machines

Creating connections to remote hosts

To create a connection to a remote host

To diagnose client-side problems when connecting to a remote host

Client-side connection tests

To diagnose server-side problems when connecting to a remote host

Server-side connection tests

To create a connection to a remote UNIX host running behind a firewall

To launch a server on the remote host

To launch a server on the remote host using a daemon process

To launch a server on the remote host without a daemon process

To launch a server on the remote host using a Secure Shell daemon process

Working with file systems on remote machines

Using Remote System Explorer (RSE)

Remote System Explorer logging

Using NFS

To verify that NFS is running

To set up an NFS server

To set up an NFS client

Using Samba

Creating remote projects

To create a remote COBOL project

To create a remote mainframe project

To create a remote COBOL copybook project

To change the connection type of a remote project

To convert a local COBOL project to a remote COBOL project

Building COBOL applications

Compiling COBOL Applications

Compiling COBOL code

Compiled File Types

Compiling JVM COBOL

To Build a Project Using Apache Ant

Setting Compiler Directives for COBOL

Setting Project-Wide Build Properties and Compiler Directives

Setting Compiler Directives on Individual Files

Setting Compiler Directives from the Command Line

Setting Compiler Directives in a Response to a Prompt

Setting Compiler Directives in Source Code

Setting Compiler Directives in a Directives File

Using Environment Variables

To specify environment variables for an application

Editing variables in the build environment

Removing variables in the build environment

To specify environment variables in a run configuration

Order in Which Copybooks are Searched For

Temporary Files Used when Compiling Native COBOL

Techniques for Compiling Quickly

Using Preprocessors

SQL Preprocessors

Additional Preprocessors

Specifying an additional preprocessor

Editing an additional preprocessor

Specifying the order of execution for multiple preprocessors

Removing an additional preprocessor

Linking Native COBOL Code (Windows)

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

Specifying non-default link options in the IDE

Linking (UNIX)

Introduction to Linking

Linking and Linked File Types

Linking and Binding

Dynamic Loading

Specifying non-default link options in the IDE

To clean a project

Tips: Building COBOL projects

How To in the IDE

To set Compiler directives on a COBOL file

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

CSI Query Results

Query Information

Data Items

Complex Data Item Queries

Qualified Names

Example Data Item Queries

Procedures Paragraphs and Sections

Called Subprograms

Finding COBOL Verbs

Examples of COBOL Verb Queries

Special Queries

CALL - Special Queries

COPY - Special Queries

DEADDATA - Special Queries

LABEL - Special Queries

TIMES - Special Queries

UNDECL - Special Queries

UNEXEC - Special Queries

UNREF - Special Queries

Wildcards

Debugging COBOL applications

Overview of the process of debugging

Preparing a Project for Debugging

Compile for Debugging

Creating a Debug Configuration

COBOL Application, COBOL Attach to Process, and COBOL Wait for Application Attachment

COBOL Core Dump

COBOL Live Recording

COBOL JVM Application and COBOL JVM Remote Application

Preparing Remote Projects for Debugging

Debugging Features and Techniques in Eclipse

Views in the Debug Perspective

Using Breakpoints and Watchpoints

Debugging Commands and Options

Debugging in COBOL Copy View

Debugging Scenarios

Starting the Debugger Automatically

Starting the Debugger automatically using library routines

Starting the debugger automatically using just-in-time debugging

Debugging Windows Services

Debugging Using a Core Dump

Preparing for a core dump

To create a core dump

To debug a core dump

Debugging Using a Live Recording

To create a live recording

To debug a live recording

Debugging Using a Remote Machine

Remote debug of projects developed locally

Projects developed on a remote UNIX machine

Debugging CICS Channels and Containers

CICS Channels View

To modify data in a container

Debugging Mixed Language Applications

Debugging Mainframe Applications and Services on Enterprise Server

How Debugging on Enterprise Server Works

To prepare for debugging on Enterprise Server

To debug on Enterprise Server

To debug on a remote Enterprise Server

Debugging using a temporary enterprise server

Error Messages for Web Services

Debugging Enterprise Server Services and Applications Using a Live Recording

How It Works

How Enterprise Server Finds a Match

To Create a Live Recording with Enterprise Server Dynamic Debugging

Debugging with Character Animator

Overview of Character Animator Functions

Working With Character Animator

The Character Animator Screen

Character Animator Screen Overview

The Information Line

Moving the Cursor and Text During Animation

Entering Text on Menus

Using the Character Animator Windows

Viewing Data

Key Functions for Updating Queried Data Items

Menus

Locate-declaration Menu

Query Menu

Functions

Function Descriptions

Cancel All Breakpoints

Cursor-position Reset

Detach from application

Scroll Up/Down (continuously)

Scroll Up/Down (one line)(Ctrl+<left-arrow>/<right-arrow>)

Thread-local Breakpoint

Run-time System Error Messages

Directives for Character Animator

Directive Descriptions

Cross-session Debugging

Using cobesdebug to Debug Services and Applications on Enterprise Server

How it works

How Enterprise Server finds a match

How to debug services and applications with Enterprise Server Dynamic Debugging

Code Refactoring

Rename Refactoring

Rename Refactoring JVM COBOL

Extracting COBOL code to a copybook

Extracting PL/I code to an include file

Running COBOL Applications

Configuring the Run-Time Behavior

To run a COBOL application on your local machine

To run an application on a remote machine

Using Eclipse for PL/I development

PL/I Perspective and Projects

The PL/I Editor

Word wrapping and indentation in Smart Edit Mode

Customizing the Behavior of Home, End, and Tab Keys

Configuring Which Preprocessor Statements are Ignored by the PL/I Parser

Configuring the Ruler in the PL/I Editor

Configuring Background Parsing in the PL/I Editor

Creating a PL/I project

Creating Remote PL/I Projects

To create a remote PL/I project

To create a remote mainframe PL/I project

To create a remote PL/I include project

To convert a PL/I local project to a PL/I remote project

Setting PL/I Project, File and Build Configuration Settings

Configuring PL/I project's properties

Configuring the Build Configuration of a PL/I Project

Setting Properties on PL/I Files

Indicating That a .pli File is a Source File

Extracting PL/I code to an include file

Compiling and building a PL/I project

Linking PL/I programs

Debugging PL/I projects

To debug a PL/I project

PL/I debug configurations

Debugging commands and options (PL/I)

Views in the debug perspective

Using breakpoints

Debugging projects developed on a remote UNIX machine

Troubleshooting

Debug session hangs (ES)

Debug session hangs

Remote debug session hangs

CTF tracing

Running a PL/I application

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 export an enterprise server instance

To import an enterprise server

To associate an enterprise server with a Mainframe Subsystem application

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 set a run-time environment variable

To submit a JCL file

To show the JCL catalog

To show the JCL spool queues

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

Modern Development Practices

Using Enterprise Developer 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 Enterprise Developer 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

Making mfant.jar Available to Enable Building

Specifying the Location of Linked Folders

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

Enterprise Developer Build Tools for Windows

Introduction to Enterprise Developer Build Tools for Windows

Prerequisites for Using Enterprise Developer Build Tools for Windows

Licensing Considerations

Installing Enterprise Developer Build Tools for Windows

Restrictions

Using Enterprise Developer Build Tools for Windows

Starting an Enterprise Developer Build Tools for Windows Command Prompt

Building Using Enterprise Developer Build Tools for Windows

Compiling and Linking Using Enterprise Developer Build Tools for Windows

Running Using Enterprise Developer Build Tools for Windows

Debugging Using Enterprise Developer Build Tools for Windows

Deploying Using Enterprise Developer Build Tools for Windows

Using Enterprise Developer with Docker

Introduction to Docker

Benefits of Using Docker

Docker Terminology

Getting Ready to Use Enterprise Developer with Docker

Key Concepts When Using Docker with COBOL Applications

Key Concepts When Using Docker for COBOL Application Development

Create Different Images for Different Development Tasks

Make Use of Enterprise Developer Build Tools for Windows

Overview of Creating Images to Use in the Development Process

Additional Information on Using Docker for COBOL Application Development

Key Concepts When Using Docker for COBOL Application Deployment

Create Different Images for Different Deployment Tasks

Overview of Creating Images to Use in the Deployment Process

Additional Information on Using Docker for COBOL Application Deployment

Building Images for COBOL Applications

Building a Base Image Containing Enterprise Developer Build Tools for Windows

Building an Image Containing an Application to use with Enterprise Developer Build Tools for Windows

Debugging COBOL Applications Running in Containers

Building a COBOL Application that is to be Debugged in a Container

Running a Container that is to be Debugged

Finding the Details of a Container that is to be Debugged

Starting to Debug a COBOL Application in a Container

To start debugging a COBOL application that is not yet running in a container

To start debugging a COBOL application that is already running in a container

Using Character Animator to Debug COBOL Applications Running in Containers

Debugging PL/I Applications Running in Containers

Docker Demonstrations

Supplied Docker Demonstrations

Using the Docker Demonstrations

The Docker Demonstration for the Enterprise Developer Base Image

Introduction to the Docker Demonstration for the Enterprise Developer Base Image

Running the Docker Demonstration for the Enterprise Developer Base Image

Files in the Docker Demonstration for the Enterprise Developer Base Image

Dockerfiles in the Docker Demonstration for the Enterprise Developer Base Image (for Enterprise Developer for Eclipse)

The Dockerfile File in the Docker Demonstration for the Enterprise Developer Base Image

The Dockerfile.nojava File in the Docker Demonstration for the Enterprise Developer Base Image

The Dockerfile.oraclejava File in the Docker Demonstration for the Enterprise Developer Base Image

The Dockerfile.x64 File in the Docker Demonstration for the Enterprise Developer Base Image

The Dockerfile.x86 File in the Docker Demonstration for the Enterprise Developer Base Image

Dockerfiles in the Docker Demonstration for the Enterprise Developer Base Image (for Enterprise Developer UNIX Components)

The CICS Docker Demonstration

Introduction to the CICS Docker Demonstration

Running the CICS Docker Demonstration

Files in the CICS Docker Demonstration

Dockerfiles in the CICS Docker Demonstration (for Enterprise Developer for Eclipse)

Dockerfiles in the CICS Docker Demonstration (for Enterprise Developer UNIX Components)

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

Web Services Support for Native COBOL

Interface Mapping Toolkit (IMTK)

Managing IMTK Projects

Defining Service Interfaces

Interface Mapper

Operations

Deploying Service Interfaces

Deployment Configuration Requirements

Service Interface Deployment Methods

Security Considerations for Service Interface Deployment

Deploying Java Service Interfaces

Deploying to 64-bit Platforms

Deploying to an Enterprise Server under UNIX

Service Interface Deployment Package

Clients

COBOL Console Client

JSP Client

How to

Manage IMTK Projects

To create a COBOL program-based service interface

To modify the CLASSPATH property for an EJB service interface

To update service interfaces with source code changes

To set Interface Mapper preferences

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 client applications from a service interface file

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

Advanced Settings

Mapping Properties - General Tab

Mapping Properties - Deployment Server Tab

Mapping Properties - Application Files Tab

Mapping Properties - EJB Generation Tab

Mapping Properties - J2SE Generation Tab

Mapping Properties - Mapping Properties Tab

New Java Interface Wizard

New REST Web Service Wizard

New SOAP Web Service Wizard

Interface Mapper

Operation Properties - General tab

Operation Properties - HTTP tab

Operation Properties - User Exits tab

Operation Reorder

Mixed Language Programming

Ordering Parameters to Pass to Non-COBOL Programs

Removing Parameters from the Stack

Storage Representation of Parameters

Aligning Parameters on Word and Double Word Boundaries

Handling Return Codes in Mixed Language Applications

Call Conventions for Interfacing with Mixed Languages

Building a Mixed Language Application

Interfacing with Assembler Subprograms

Interfacing with Windows API Routines

Interfacing with C Programs

Passing Data between C and COBOL

Header-to-COPY Utility

Overview

Examples

Converting Header Files Using the H2cpy Utility

H2cpy command-line options

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

XMLGEN Compiler directive

Model files

Typical development process example

Design the COBOL data structure and program logic

Compile the program

Execute the program

Making a program skeleton

Making a program that exports an XML document

Populating the XML document with data values

Deploy the application

How XML Extensions locates files

XML Extensions statements reference

Memory management with XML Extensions

Searching for files

Document processing statements

XML 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 GET WHITESPACE-FLAGS

XML SET WHITESPACE-FLAGS

XML SET XSL-PARAMETERS

XML SET XSL-PARAMETERS-NEW

XML CLEAR XSL-PARAMETERS

COBOL considerations

File management

File naming conventions

External XSLT Stylesheet File Naming External XSLT stylesheet file naming conventions

Other input file naming conventions

Other output file naming conventions

Data conventions

Data representation

COBOL and character encoding

MF_XMLEXT_LOCAL_ENCODING environment variable

Windows character encoding

UNIX character encoding

FILLER data items

Missing intermediate parent names

Unique element names

Unique identifier

Sparse COBOL records

Copybooks

Statement definitions

REPLACE statement considerations

Displaying status information

Application termination

Anonymous COBOL data structures

Limitations

Data items (data structures)

Edited data items

Wide and narrow characters

Data item 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 spaces 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 in XML Extensions

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

Compiling XML-enabled COBOL from the Command Line

Generating COBOL Structures with XML Syntax from the Command Line

CBL2XML Utility

Generating a Copybook and Schema

Generating XML-enhanced COBOL from an XML Schema

Mapping COBOL Data to XML Elements

Accessing an XML-enabled Record

Validate an XML Document

XML PARSE

Special Registers

User Routine

Glossary of terms

64-bit Native COBOL Programming

Compiling Native COBOL Programs for 64-bit

Transitioning Native COBOL Programs to 64-bit

Programs Using Pointers

Programs with a Directly Coded File Control Description

Programs Migrating from the Mainframe

Single Sourcing and Compiling Native COBOL Programs for 64-Bit

Single Sourcing and Dual FCD Support in Native COBOL Programs

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

The CLOSE WINDOW Statement

The DISPLAY Statement

Windowing Restrictions

ACUCOBOL-GT Windowing Error Messages

Windowing Supplementary Information

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 Eclipse

Create a native Visual COBOL project

Set the DIALECT RM Compiler Directive for the Project

Import your RM/COBOL Source Code

Customizing the Reserved Words List

Add Adis Support to the Project

Add the RM/COBOL Keyboard Configuration

Build and Run the Project

Appendices

Appendix A - RM/COBOL Source File

Appendix B - ADISCTRL Settings for RM2VCOB

Appendix C - Adis Key Mappings for RM2VCOB

Appendix D - Adis Key Function Mapping for RM2VCOB

Compiler Directives for RM/COBOL Compatibility

Compiling RM/COBOL Programs Without DIALECT"RM"

RM/COBOL Data Types

RM/COBOL Conversion Issues

Producing Executable Code

Perform Statements

ACCEPT FROM CENTURY-DATE and FROM CENTURY-DAY

CURSOR phrase not available in ACCEPT statement

Nested COPY statements with REPLACING phrase

Duplicate Paragraph-names

Figurative Constants and the USING Phrase

File Not Found Errors

Indexed File Error on Open

LIKE Relational-operator Not Available

Linkage Section in Main Program

Nested OCCURS DEPENDING Clauses

Numbering of Segments

Program Identification and Data Names

REMARKS Paragraph

Reserved Words

SAME AS Clause Not Available When Defining Data Structures

Source Code in Columns 73 to 80

START WHILE LIKE Not Available

Undeclared Data Items in Clauses

User-names Longer than 127 Bytes are Truncated

Using Relative Path Names

Running the Code

Table Bound Checking

ACCEPT Fields at the Edge of the Screen

C$CARG Not Supported

Display of Input Data in Concealed ACCEPT Fields

Embedded Control Sequences in DISPLAY Statements

End of File Notification

The EXCEPTION STATUS Clause

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 JVM COBOL Using RM/COBOL Indexed Files

Enabling CTF to Trace RM/COBOL Data Files

Data File Utilities

Indexed File Recovery (recover1) utility

Recovery command

Recovery command options

Recovery process description

The four phases of processing

Recovery support module version errors

Recovery example

Recovery program error messages

RM/Panels

Restrictions and Limitations

Converting RM/Panels Applications

Conversion Example: Using Eclipse

Creating an Eclipse Project for the RM/Panels Application

Set the Dialect RM 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

Configure the Library File for Run Time

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

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

SQLWARN 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

Example

Compiling SQL Applications

Specifying an SQL Preprocessor and Compiler Directive Options

Compiling Multiple Program Modules

Creating Debug Files

OpenESQL

OpenESQL Preprocessor Options

Setting the OpenESQL Preprocessor and Compiler Directive Options

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

Managing Transactions

Programming for OpenESQL

OpenESQL Assistant

Setting OpenESQL Assistant Options

Using 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

Creating Temporary Files

Embedding SQL into a program

Auxiliary Code

Generating EXEC SQL Auxiliary Code

Embedding Auxiliary Code

Stored Procedures

Generating a TSQL Stored Procedure Query

Testing a TSQL Stored Procedure Query

Embedding a TSQL Stored Procedure into a Program

Working With OpenESQL Cursors and Result Sets

Working with Stored Procedures and Result Sets

Unicode Support in OpenESQL

OpenESQL Globalization Best Practices

Keywords

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

JDBC

Connect Using a JNDI DataSource Object

JDBC Process

JDBC Resources

JNDI DataSource Objects

Database Connections

Connect Using a JDBC Connection String

Sharing Database Connections Between Java and COBOL

Using OpenESQL with JDBC

Compiling JDBC Applications from the Command Line

Configuring the JDBC Run-time Environment

JVM Host Variables in Managed Code

COBOL Program Migration Support

COBSQL

Setting the COBSQL Preprocessor and Compiler Directive Options

Building COBSQL Applications

Building COBSQL Applications with Eclipse

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 close a query

To close the OpenESQL Assistant

To connect to a data source

To connect to a different data source

To create a complete program in a temporary file

To create a table join

To create a temporary file

To create an SQL 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 enable PL/I SQL query generation

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 an INSERT statement

To generate an UPDATE statement

To generate and embed auxiliary code

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 a temporary file

To view data source properties

JDBC

To create a JVM COBOL project for JDBC

To install and configure Simple-JNDI

To create a JNDI DataSource object

To add JDBC resources to the JVM Build Path

To create a user library for JDBC resources

To import a user library

To export a user library

Reference

OpenESQL

Embedded SQL Statements

ALLOCATE CURSOR

ASSOCIATE LOCATORS

BEGIN DECLARE SECTION

QUERY ODBC

QUERY ODBC - Column Query

QUERY ODBC - Data Type Query

QUERY ODBC - Table Query

RESET CONNECTION

ROLLBACK

SAVEPOINT, SAVE TRANSACTION, RELEASE [TO] SAVEPOINT

SELECT DISTINCT (using DECLARE CURSOR)

SET TRANSACTION ISOLATION

SQL Compiler Directive Options

BEHAVIOR

Primitive Directives

DBMAN Directive Settings

JDBC Driver Classes

JDBC URLs

Sample DataSource Object Files

SQL/COBOL Data Type Mappings

OpenESQL Messages

SQLSTATE Values

SQLCODE Values

OpenESQL Preprocessor Error Messages

COBES0002 token is badly defined.

COBES0003 Program contains more than one definition of token

COBES0004 Nested or multi-source programs not allowed.

COBES0005 An error occurred when processing the internal dictionary.

COBES0006 No DB engine could be found.

COBES0007 Source file name is invalid.

COBES0010 OESQL rejected an unspecified option.

COBES0022 The directive SQL(DBMAN=ODBC) is not supported under Personal Edition.

COBES0023 The SQL(DBMAN) directive option is not supported with native applications.

COBES0024 The SQL(DBMAN) directive option is not supported with JDBC applications.

COBES0100 SQL incompatible with MAINFRAME

COBES0101 Statement is too long.

COBES0102 Statement contains too many host variables.

COBES0103 token does not have a suitable definition to be used as a host variable.

COBES0104 Bad SQL data declaration.

COBES0105 Syntax error.

COBES0106 Filename too long.

COBES0107 File token not found.

COBES0108 token is not unique and should be qualified.

COBES0109 token is not a data item.

COBES0110 Statement contains more than one SQLDA.

COBES0111 token is not a table of null indicator variables.

COBES0112 variable should not be defined with an OCCURS clause.

COBES0113 token should not be a subordinate to an item defined with an OCCURS clause.

COBES0114 Statement only allowed in the Procedure Division.

COBES0115 Statement not allowed in the Procedure Division.

COBES0116 An error occurred when processing the trace file.

COBES0118 Mismatched DECLARE.

COBES0119 Host variable name is too long.

COBES0120 Internal error - dictionary handle is too big.

COB ES0121 Compiler directive SQL (token1=token2) is invalid or badly sequenced - all SQL statements ignored.

COBES0123 Invalid ILTARGET - cannot use ILTARGET(ANYCPU) - must specify ILTARGET(X86) or ILTARGET(X64).

COBES0124 Host or Indicator Variable varname should not be defined in EXEC SQL statement using a subscript.

COBES0125 variable should be defined with an OCCURS clause.

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.

COBES0211 DBRMLIB name is too long, max 44 characters.

COBES0212 Simple name in DBRMLIB name is too long, max 8 characters.

COBES0213 Simple name in DBRMLIB name starts with invalid character.

COBES0214 Invalid character in DBRMLIB name.

COBES0215 MEMBER name is too long, max 8 characters.

COBES0216 MEMBER name cannot begin with a numeric digit.

COBES0217 Invalid character in MEMBER name.

COBES0218 MEMBER directive not valid unless DBRMLIB directive set.

COBES0219 VERSION directive not valid unless DBRMLIB directive set.

COBES0220 VERSION is too long, max 64 characters.

COBES0221 Invalid character in VERSION.

COBES0222 Invalid Framework target - SQL applications must be built to target the 4.0 .NET Framework.

COBES0223 TARGETDB directive not set.

COBES0900 An internal error occurred.

COBES0901 This error prevents SQL processing from continuing - further EXEC SQL statements will be ignored.

COBES1000W Use of EXEC SQL INCLUDE SQLCA END-EXEC

COBES1002 Statement is not in area B.

COBES1004 token directive is not supported and has been ignored.

DSNTIAR and DSNTIAC

esqlconfig command

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

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

RESULT-SET-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 or Shell 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

Error Messages When Using Data File Editor with Enterprise Server

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

VRECGEN

VRECGEN2

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 Classic Data File Tools

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

File Handling

File Handling Examples

Btrieve

Example Xfh2btr Configuration File

Example Btrieve Trace Output

Example Btrieve Trace Option Settings

Example of Btrieve Record Lengths

Example of Data and Key Compression

External Files

Example External Files

File Handler

Example Configuration File

Example of Creating a New Index File

Example of Accessing the FCD

Example of Setting Up the Record Area

Example of Setting up the Filename Area

File Names

Examples of static filename assignment

Example of dynamic filename assignment

Example of external filename assignment

Examples of device name assignment

Example of Forced Filename Mapping

Example of Connecting a File to Standard Output

Example of Connecting a File to Standard Input

Example of Setting up a Two-way Pipe

Example of using the External File Mapper

Example of Specifying a Fileshare Client User ID and Password

Example Fileshare Client Configuration File

File Status

Example of Displaying File Status Codes

Example of Checking File Status Codes

Example of Extended File Status Codes

Indexed Files

Example of Indexed File Definition

Example of Primary Key Definition

Example of Alternate Key Definition

Example of Duplicate Key Definition

Example of Sparse Key Definition

Example of Indexed File Access Definition

Example of Creating Fixed-length Records

Example of Creating Variable Length Records

MFSORT

Example Mfsort Command Line

Example Mfsort Fields Instruction

Example Mfsort Key Instruction

Example Mfsort Instruction File

Rebuild

Example of Reorganizing an Indexed File

Example of recovering a corrupt indexed file

Example of using Rebuild to convert a file

Example of validating the structure of an indexed file

Example of a Rebuild options file

Example of calling Rebuild from a COBOL program

Example Relative File Definition

Sequential Files

Example Record Sequential File Definition - Fixed-length Records

Example Record Sequential File Definition - Variable Length Records

Example Line Sequential File Definition

Example Printer Sequential File Definition

File Handling Guide

Introduction

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

Output Pipes

Input Pipes

Two-way Pipes

External File Mapper (Mfextmap)

Mapper File Structure

Mapper File Location

Activating the External File Mapper

Disabling The External File Mapper

File Status

What is File Status?

Defining a File Status Data Item

File Status Conventions

ANSI'85 File Status

ANSI'74 File Status

File Status Conversions

Extended File Status Codes

Sharing Files

Sharing mode

Record Locking

Manual and Automatic Record Locking

Manual Record Locking

Automatic Record Locking

Single and Multiple Record Locking

Single Record Locking

Multiple Record Locking

Handling Record Locks

Releasing Record Locks

File Status Codes

File Handler Configuration

Configuration File

Configurable Behavior

Large Indexed Files

File Striping (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

DFSORT and ICETOOL Emulation

DFSORT EXEC PARM Options Emulation

PARM

DFSORT Program Control Emulation

ICETOOL Emulation

SYNCSORT Emulation

SYNCSORT EXEC PARM Options Emulation

PARM

SYNCSORT Program Control Emulation

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

Btrieve

Xfh2btr Call Conversion Module

Calling Xfh2btr

CALLFH Compiler Directive

FILETYPE Compiler Directive

Btrieve Environment Variables

BTRPAGE Environment Variable

BTRMAXREC Environment Variable

Xfh2btr Configuration File

Page Size

Maximum Record Size

Btrieve File Open Mode

Example Xfh2btr Configuration File

Trace Option

Example Trace Option Settings

Example Trace Output

Xfh2btr Differences

Keys

Locked Record Detection

OPEN OUTPUT Operation

Record Lengths

Example of Btrieve Record Lengths

Current Record Pointer (CRP)

Sequential READ Operations After WRITE Operations

Sequential READ Operations After DELETE Operations

Sequential READ Operations After REWRITE Operations

Transaction Processing

WRITELOCK Compiler Directive

Calling Btrieve in Non-ANSI Mode

Btrieve Error Messages

Data and Key Compression

Data Compression

Key Compression

Compression of Trailing Nulls

Compression of Trailing Spaces

Compression of Leading Characters

Compression of Duplicate Keys

Example of Using Data and Key Compression

Compression Routines

Micro Focus Compression Routines

Calling a Micro Focus Compression Routine

User-supplied Compression Routines

Tracing File Operations

Configuring Tracing and Logging

Dynamic Tracing

Using the FCD to Control Tracing

Using Library Routines to Control Tracing

Trace Player

Run the Trace Player from the Command Line

Examples

File Systems

32-bit file systems

64-bit file systems

File systems and FILEMAXSIZE

Fileshare Guide

Introduction

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)

Example

Filename Record

Alternative Filename (/af)

Virtual File Handler (/ap)

Data and Key Compression (/k)

Disable Logging (/o l)

Disable Database Sequence Numbering (/o s)

Disable Transaction Processing (/o t)

Erasing a Filename Record

Examples

File String Record

Erasing a File String Record

Example

Backup Folder Record

Best Practices for Backup and Recovery

Best Practices Basic Logging

Best Practices Advanced Logging

Security

Password System

Fileshare Client

Fileshare Server

Writing Your Own FHRdrLngPwd Module

Logon Validation Module

File Access Validation Module

Password File Maintenance

User-ID Groups

Supervisor Mode

Advanced Operation

Running Fileshare as a Background Process

The NFILES Setting

Single User Mode

Filename Mapping

Fileshare Server

Data and Key Compression

Data and Key Compression - Fileshare Server

Virtual File Handler Interface

Fileshare Server

Monitoring Fileshare

Fileshare Manager

Fileshare Manager Configuration

Byte-stream I/O Calls

FS_LOCATE_FILE

FS_SPLIT_FILENAME and FS_JOIN_FILENAME

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

Java/COBOL Application Launcher

Using the Java/COBOL Application Launcher from the Command Line

Using the Java/COBOL Application Launcher from the Eclipse IDE

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