Micro Focus Enterprise Developer 7.0 for Eclipse
Welcome
Product Overview
Existing Customers: Updating from an Earlier Release
New Features
New Features in Enterprise Developer 7.0
Micro Focus COBOL Extension for Visual Studio Code
Application Workflow Manager
Assembler Support
CICS Support
COBOL Language
Code Analysis
Code Set Support
Compiler Directives
Database Access - HCOSS Manage Connections Tool
Database Access - MBDT Utilities
Database Access - OpenESQL
Data File Tools
Developing Applications on Remote Machines
Eclipse Integration
Enterprise Server
Enterprise Server Common Web Administration (ESCWA)
Enterprise Server Security
IMS Support
Library Routines
Licensing
Mainframe Access (MFA)
The Micro Focus Database File Handler
The Micro Focus Unit Testing Framework
Micro Focus Rumba
PL/I Support
New Platform Support
Features Added in Enterprise Developer 6.0
Application Workflow Manager
Building Applications
COBOL Application Console Size
COBOL Language Enhancements
Code Analysis
Code Analyzer Refactoring
Compiler Directives
Containers
Database Access - HCO for DB2 LUW
Database Access - XA Switch Modules
Data File Tools
Debugging
Deploying Applications
Eclipse Integration
Enterprise Server
Enterprise Server Security
Enterprise Server Common Web Administration (ESCWA)
File Handling
IMS Support
Interface Mapping Toolkit
JCL Support
Library Routines
The Micro Focus Database File Handler
The Micro Focus Unit Testing Framework
The Microsoft Build Tools and Windows SDK Configuration Utility
Multi-Threaded Applications
PL/I Support
Problem Determination
Product Documentation
What was New in Enterprise Developer 5.0
Amazon Web Services Quick Start for Enterprise Server
COBOL Formatting
Code Analysis
Enterprise Server and Scale Out Architecture
Enterprise Server Common Web Administration
Application Workflow Manager
AppMaster Builder
CICS Support
COBOL Language Enhancements
Compiler Directives
Consolidated Trace Facility (CTF)
Data File Tools
Database Access
Debugging
Eclipse Integration
Enterprise Server Security
IMS Support
JCL Support
Mainframe Access
Micro Focus Native Database File Handler
Micro Focus Rumba
Micro Focus Unit Testing Framework
PL/I Support
Platform Support
Product Documentation
Features Added in Enterprise Developer 4.0
Features Added in Enterprise Developer 3.0
Features Added in Enterprise Developer 2.3 Update 2
Features Added in Enterprise Developer 2.3 Update 1
Features Added in Enterprise Developer 2.3
Features Added in Enterprise Developer 2.2 Update 2
Features Added in Enterprise Developer 2.2 Update 1
Features Added in Enterprise Developer 2.2
Features Added in Enterprise Developer 2.1 Update 1
Features Added in Enterprise Developer 2.1
Features Added in Enterprise Developer 2.0
Significant Changes in Behavior or Usage
New Customers: Where do I start?
New to Eclipse
Where do I start: Developer Tasks
Where do I start: Developing Mainframe Applications in Enterprise Developer
Developer: My Application Uses CICS
Developer: My Application Uses JCL
Developer: My Application Uses DB2
Developer: My Application Uses IMS
Developer: My Application Uses PL/I
Developer: My Application Uses Assembler Support
Where do I start: Deploying Mainframe Applications to Enterprise Server
Deployer: Deploying a CICS Application
Deployer: Deploy a JCL Application
Deployer: Deploy and Debug a Mainframe Application with IMS Support
Deployer: Deploy a Mainframe Application with Assembler Support
New to COBOL
New to PL/I
New to Micro Focus Enterprise Developer UNIX Components
Upgrading from Mainframe Express
Upgrading from Net Express
Upgrading from Server Express
Upgrading from Studio Enterprise Edition
Want to deploy an application
Upgrading to Enterprise Developer
Licensing Changes
Resolving conflicts between reserved keywords and data item names
Importing Existing COBOL Code into Enterprise Developer
Recompile all source code
Upgrading from Mainframe Express to Enterprise Developer
Advantages to upgrading to Enterprise Developer
Approaches to upgrading your applications
Considerations when upgrading to Enterprise Developer
How to upgrade an application created with Mainframe Express to Enterprise Developer
Further Information and Assistance
Mainframe Express Functionality That Works Differently in Enterprise Developer for Eclipse
Emulating workgroups in Eclipse
Upgrading from Studio Enterprise Edition (Windows)
Upgrading from Server Express and Studio Enterprise Edition (UNIX)
Advantages of Upgrading to Enterprise Developer
Upgrading Your COBOL Application
Compile Your Existing Programs without a Project
Create a Project and Import Your Sources
Best Practice in Development Using Eclipse
Modernize Your Applications and Processes
Differences between Enterprise Developer and Net Express, Server Express and Mainframe Express
Summary of Differences
Backward Compatibility with Earlier Micro Focus Products
Compiling and Building Differences
Output File Formats
Compiler directives
Linking
Called Programs and Dependencies
File Handler
Makefile Conversion
OpenESQL Assistant
SQL Compiler Directive Options
XML PARSE Statement
Run-time System Differences
OpenESQL
Single-Threaded Run-Time System
Static-Linked Run-Time System
Setting the environment on UNIX
Enterprise Developer Co-existing with Earlier Micro Focus Products
Restrictions and Unsupported Features
CBL2XML Utility
DBMS Preprocessors
Dialog System
Form Designer
GNT Analyzer
Host Compatibility Option (HCO)
INTLEVEL Support
NSAPI
Online Help System
OpenESQL
SQL Option for DB2
Run-Time Technology Differences
File Handling
Java and COBOL
Test Coverage
Editing and Debugging Differences
Interface Mapping Toolkit
Mixed Language Debugging
Program Breakpoints
Remote Debugging
Source Pool View
Tips: Eclipse IDE Equivalents to IDE Features in Earlier Products
Upgrading from ACUCOBOL-GT
Upgrading from RM/COBOLĀ®
Overview of application development in Eclipse
Overview of Remote Mainframe Development
Enterprise Developer Tutorials Guide
Mainframe Tutorials
Getting started with Enterprise Developer
Starting Eclipse
Creating a Project
Editing Source Files
Compiling the Source Code
Unit Testing the Batch Application
Unit Testing the Online Application
Debugging the Batch Application
Debugging the Online Application
Tutorial: AppMaster Builder
Create a User Area
Set Up AMB and COBOL Projects
Add Objects to the BLDRAPPL Project
Set BLDRAPPL Preferences and View Properties
Paint the BLDRCU Screen
Assign Screen Field Edits
Code the CALCINV User Rule
Map BLDRCU Screen Fields to BLDRUPD
Define BLDRUPD Program Actions
Define APSUPD Data View Access
Generate and Compile the BLDRAPPL Application
Tutorial: Assembler Support
Set Up the AACT Project
Set Up the ESAACT Enterprise Server Region
Run the AACT Transaction
Tutorials: CICS
Tutorial: CICS Support
Set up the ACCT Project
Set up the ESACCT Enterprise Server Region
Run the ACCT Application
Debug the ACCT Application
Tutorial: Web-enabled CICS Acting as a Web Server
Set up the ACCTWEB Project
Set Up the ESACCTSV Enterprise Server Region
Run the ACCTWEB Application in TN3270 Mode
Run the ACCTWEB Application in a Web Browser
Debug the ACCT Transaction
Tutorial: Web-enabled CICS Acting as a Web Client
Set up the ACCTCLNT Project
Set Up the ESACCTCL Enterprise Server Region
Run the ACCTCLNT Application in TN3270 Mode
Debug the ACCT Transaction
Tutorials: CICS Web Services
Tutorial: CICS Web Service Provider from WSDL, Top-down Method
Set Up the Reverse Project
Generate Reverse Web Service Provider Components
Add Operation Logic to reverse.cbl
Set Up the CWSPROV Enterprise Server Region, WSDL
Test the Reverse Web Service Provider
Tutorial: CICS Web Service Requester from WSDL, Top-down Method
Set Up the InvokeReverse Project
Generate InvokeReverse Requester Components
Add Operation Logic to invkRev.cbl
Set Up the CWSREQ Enterprise Server Region
Test the InvokeReverse WebService Requester
Tutorial: CICS Web Service Provider from WSDL, Bottom-up Method
Set Up the LoanDemo Project
Generate loanPaym Web Service Components
Update the CWSPROV Enterprise Server Region
Test the loanPaym Web Service Provider
Tutorial: CICS Web Service Provider from JSON, Request-Response Top-down Method
Set Up the ReverseJSON Project
Generate the Reverse CICS Web Service Provider Components
Add Reverse Operation Logic
Set Up the JSONPROV Enterprise Server Region
Test the ReverseJSON Web Service Provider
Tutorial: CICS Web Service Requester from JSON, Linkable Interface Top-down Method
Set Up the InvokeReverseJSON Project
Generate InvokeReverseJSON Requester Components
Analyze the invkRevJ.cbl Program
Set Up the JSONREQ Enterprise Server Region
Test the invkRevJ Web Service Requester
Tutorial: CICS Web Service Provider from JSON, Request-Response Bottom-up Method
Set Up the LoanDemoJSON Project
Generate loanPaym Web Service Components
Update the JSONPROV Enterprise Server Region
Test the loanPaym Web Service Provider
Tutorial: CICS Web Service Provider from JSON, RESTful
Set Up the filmsREST Project
Generate filmsREST Web Service Components
Add Operation Logic to filmREST.cbl
Set Up the CWSREST Enterprise Server Region
Test the films Web Service Provider
Tutorial: DSNREXX
Tutorials: HCO for SQL Server (HCOSS)
Tutorial: DB2 Database Migration using HCOSS
Set Up HCO_TEST SQL Server Database Access
Start HCO for SQL Server from Eclipse
Create the mainframeDB2 DB2 Database Connection
Extract and Review an XML Representation of a DB2 Schema
Create a Transfer List
Generate DDL and Verify the SQL Server Database Structure
Transfer Data and Verify
Compare DB2 vs. SQL Data
Tutorials: Application Migration using HCOSS
Tutorial: Prepare for Application Migration
Create the HCO_Test Database
Create the HCODemo SQL Server Connection
Tutorial: Application Migration - Switching Package Sets
Analyze the TwoPackageSet Project
Build and Bind the TwoPackageSet Program
Run the TwoPackageSet Application
Tutorial: Application Migration - Converting Labeled Duration Calculations
Analyze the LBLDURATION Project
Define and Verify a Post-Build Event that Binds the Application
Run the LBLDURATION Application
Tutorial: Application Migration - Adding Function Emulation
Create and Map User-defined Functions
Analyze the FunctionEmulation Project
Define and Verify a Post-Build Event that Binds the Application
Run the FunctionEmulation Application
Tutorials: IMS
Tutorial: IMS Support
Set Up the IMSSupport Project
Configure IMS
Set Up the IMSDEMO Enterprise Server Region
Run MFDEMO
Debug MFDEMO
Tutorial: IMS Segment Layout Editor
Create Default Segment Layouts for DEMOHDRS and DEMOELES
Create a Conditional Segment Layout for DEMOELES
Tutorial: IMS Database Editor
IMS Database Editor Basics
Add the DEMOHDRS Twin Segment Occurrence
Delete a DEMOELES Segment Occurrence
Search and Bookmark the Database
Set up a Segment Search Argument (SSA) for DEMOHDRS
Tutorial: JCL
Set Up the JCLDEMO Project
Set Up the ESJCL Enterprise Server Region
Run the ESJCL Job
Debug JCLDEMO
Tutorial: Mainframe Batch Database Tools (MBDT)
Set Up the HCO_Test SQL Server Database
Prepare Mainframe Data
Build the ODBC XA Switch Module
Set Up the JCL1 Project
Set Up the DSNUTILS Enterprise Server Region
Download and Catalog DB2 Data
Migrate the Database
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 and Configure JES
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
View the catalog
Debug the program
Debug Configuration
Start debugging
Debug opdemo.pli
Stop the Enterprise Server (Eclipse JCL)
Tutorial: Remote mainframe development
Installing the BankDemo Application
Installing the Application on the Mainframe
Customizing the Application on the Mainframe
Validating the Installation
Running the BankDemo Application
Creating a Filter to View Jobs
Creating a Filter to View Datasets
Creating a Filter to View USS Files
Submitting a Job from the MVS Explorer
Opening a Mainframe Application
Displaying and Editing COBOL Code from the Mainframe
Checking the Syntax Remotely (COBOL)
Checking the syntax remotely (Assembler)
Transferring a Mainframe Source to a Local Workspace
Using the Rumba Screen Designer
Native COBOL Tutorials
Tutorial: Creating a Native COBOL Application
Creating a Project
Adding Source Code and Building the Project
Create a build configuration
Running the Application
Launch a Debug Session
Tutorial: Running Unit Tests in the IDE
Create a Workspace
Importing the AirportDemo Sample
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
Tutorial: SOAP Web Service
Set Up the ProgramSOAP Project
Create the MakeCheckAppt Service Interface
Define MakeCheckAppt Operations
Set Up the ESSOAP Enterprise Server Instance
Deploy the MakeCheckAppt Web Service
Generate a COBOL Client
Debug the COBOL Console Client
Tutorial: EJB Service Interface
Set Up the ProgramEJB Project
Create the AccessBooks Service Interface
Define AccessBooks Operations
Configure the ESDEMO Enterprise Server Instance
Deploy the AccessBooks Java Interface
Generate and Deploy a JSP Client
Run the JSP Client
Tutorial: REST Web Service
Set Up the ProgramREST Project
Create the MakeCheckAppt Service Interface
Define MakeCheckAppt Operations
Set Up the ESREST Enterprise Server Instance
Deploy the MakeCheckAppt Web Service
Generate a COBOL Client
Debug the COBOL Client
Tutorial: OpenESQL Assistant
Create the OESQLDemo SQL Server Database
Set Up the OESQLAsst Project
Set the OpenESQL Assistant Type COBOL Variable
Catalog the OESQLDemo Connection as an ODBC Data Source
Define and Test a Query
Generate and Embed an SQL Program and Query
Generate and INCLUDE the EMP.cpy Copybook
Debug the SQL COBOL 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
JVM 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: Compiling a COBOL Program to JVM Byte Code
Customizing the COBOL Perspective
Configuring the COBOL JVM Project
Configuring the Java Project
Using the COBOL Program from Java
Running the Application
Tutorial: Packaging JVM COBOL
Customizing the COBOL perspective
Packaging the JVM COBOL output
Building the project
Copying the packaged output
Updating the Calc project to use the packaged JAR file
Running the application
Technology Preview Features
EAP Features
Enterprise Developer Editions and Activating Licenses
To buy and activate a full license
To obtain more licenses
Product Information
Supported Operating Systems and Third-party Software
Additional Software Requirements
AIX
Application Server JCA support for Enterprise Server
Application Servers for JVM COBOL
AppMaster Builder
Browsers
CICS Web Services
Code Analysis
Database Management Systems (DBMSs)
Interface Mapping Toolkit (IMTK)
JCL
Mainframe Access - Endevor Support
Mainframe Terminal Emulation
MFFTP Utility
Performance Availability Clusters (PACs)
Installation
Before Installing
Downloading the Product
On Windows
System Requirements
Hardware Requirements
Operating Systems Supported
Software requirements
Additional Software Requirements
Product Co-Existence
Installation Restrictions and Requirements
Basic Installation
Installing on Windows
Advanced Installation Tasks
On Windows
Installing as an Upgrade
Enterprise Developer Installation Options
Microsoft Package Dependencies
Installing and Licensing Micro Focus Rumba+ Desktop
Installing Enterprise Developer for Eclipse in an Offline Environment
Installing into other instances of Eclipse
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
Communications
Security
Data Set Services
Administration
Dependent Address Space Services
Mainframe Access Services
Migration information
Migrating from z/Server Scheduler to MFA TSO Application Server
General Migration Actions
Update Customized TAUZCAPP
Update MFA Started Task JCL Procedure
Update MFAAS Started Task JCL Procedure
Update MFAAMS Started Task JCL
Update MFATSO Started Task JCL
Installation requirements
Machine requirements
Software requirements
Mainframe Access Configuration Utility
Prerequisites
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
TSO Application Server Parameters
MFA Data Connect Service parameters
RIMS Service Parameters
MCO Service Parameters
ES-MTO Service Parameters
Host Installation
Preparing the Installation
Before you begin
Installation procedure
Upload the software
Receive the software
Configuration overview
Mainframe Access Data Sets
Mainframe Access Samples
Quick Configuration
MFA Started Task JCL Procedure
MFATSO Started Task JCL Procedure
Optional customization
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
Add MFATSOIN to System Link List
Customize AWM master configuration file
APF-Authorize the Load Module Libraries
Define Mainframe Access to the Security Subsystem
Define Mainframe Access Web API to the Security Subsystem
Define started tasks to WLM
Starting Mainframe Access
Stopping Mainframe Access
Advanced Configuration Activities
Editing Mainframe Access Parameters
Enabling Passphrase Support
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 TSO Command support
Application Server Parameters for ChangeMan 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
Obtaining an MFA Server Trace
Dynamic Tracing
Configuration File
Customizing Data Connect
Introduction
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
About Librarian
References
Librarian Exit Table
Endevor
About Endevor
References
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
Prerequisites
MFA Server Configuration for ES/MSS
Enable ES/MSS Support
Define the Target z/OS CICS System
Define the Target ES/MSS Server
Restart MFA Server
Technical Details
How ES/MSS Understands the Connection
How z/OS CICS Understands the Connection
Console Commands
Introduction
Console Commands
General Mainframe Access Server commands
C CONV=id
DISPLAY CONVERSATION
DISPLAY LU
DISPLAY TCPSTATUS
FLUSH XDBOUT
REFRESH ACCESSLIST
RESET TIMEOUT=n
SDUMP
SET TIMEOUT=n
Start
Stop
TRACE OFF
TRACE ON and TRACE SHORT
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
MFMDS015E AMS/TSO DR failure - TRX aborted
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
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
ACBNAME
ACCESS_LIST_CHECK
APPLID_PASSWORD
AUDIT_LOG
BACK_LOG
BIND_NETADDR
BUFFER_SIZE
CHANGEMAN_COMMON_BUILD
CHANGEMAN_DSNQUALIFIER
CHANGEMAN_INTERFACE
CHANGEMAN_SSID
CHANGEMAN_TEST_OPTION
CHANGEMAN_XMS_SIZE
COMPRESSION
COMPRESSION_TYPE
CONSOLE_NAME
DSS_SCAN_INTERVAL
EID
ENDEVOR_DSNQUALIFIER
ES-MTO_MAXTASKS
ID
IMSLINK_MAXTASKS
IPADDRESS
JES_BUFFER_TRACE
JES_CONCHAR
JOBNAME
LIST_DB2
LIST_PARAMETERS
LU62_APPLID
LUNAME
MAX_DS_ALLOCATIONS
MAX_PUBLIC_FILES
MAXIMUM
MCOLINK_MAXTASKS
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_LISTING_DATA_CLASS
MFA_MCG_DB2CONNECTION
MFA_PANVALET_HISTORY
MFA_PANVALET_INTERFACE
MFA_PANVALET_UPD_MODULE
MFA_SAF_HISTORY
MFA_SYSOUT_CLASS
MFA_SYSOUT_DEST
MFADIRECT
MFADIRECT_MAXTASKS
MFALINK_MAXTASKS
MINIMUM
MODENAME
NETWORK_ID
ORGANIZATION
PEM_FEATURE
PORT
PROCEDURE
RACF_APPLID
REST_API
REST_BUFFER_SIZE
REST_INACTIVITY_TIMEOUT
REST_MAXTASKS
REUSE_ASID
ROUTE
SCLM_WARN_LEVEL
SECURITY
SESSIONS
SMF_RECORDID
SOCKETS
SYNCLEVEL
SYSOUT
TCP_PORT
TCPLINK_MAXTASKS
TIMEOUT_FOR_CONNECTION
TIMEOUT_FOR_INITIAL_RECEIVE
TPNAME
TRACE
TRACING
TSO_INITMOD
TSO_JOBCHAR
TSO_JOBCHAR_PREFIX
TSO_MSGCLASS
TSO_NOTIFY
TSO_PCNAME
TSO_PROCEDURE
VIO_FOR_ENDEVOR_LOG
After Installing
Configuring Enterprise Developer
On Windows
Using an X Server on Windows
Managing the Microsoft Build Tools and Windows SDK Packages
The Microsoft Build Tools and Windows SDK Configuration Utility
Viewing the Product Help
Repairing on Windows
Uninstalling
Installing Enterprise Developer Development Hub
Before Installing
Downloading the Product
Installing on UNIX and Linux
System Requirements
Hardware Requirements
Operating Systems Supported
Software Requirements
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
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
Communications
Security
Data Set Services
Administration
Dependent Address Space Services
Mainframe Access Services
Migration information
Migrating from z/Server Scheduler to MFA TSO Application Server
General Migration Actions
Update Customized TAUZCAPP
Update MFA Started Task JCL Procedure
Update MFAAS Started Task JCL Procedure
Update MFAAMS Started Task JCL
Update MFATSO Started Task JCL
Installation requirements
Machine requirements
Software requirements
Mainframe Access Configuration Utility
Prerequisites
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
TSO Application Server Parameters
MFA Data Connect Service parameters
RIMS Service Parameters
MCO Service Parameters
ES-MTO Service Parameters
Host Installation
Preparing the Installation
Before you begin
Installation procedure
Upload the software
Receive the software
Configuration overview
Mainframe Access Data Sets
Mainframe Access Samples
Quick Configuration
MFA Started Task JCL Procedure
MFATSO Started Task JCL Procedure
Optional customization
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
Add MFATSOIN to System Link List
Customize AWM master configuration file
APF-Authorize the Load Module Libraries
Define Mainframe Access to the Security Subsystem
Define Mainframe Access Web API to the Security Subsystem
Define started tasks to WLM
Starting Mainframe Access
Stopping Mainframe Access
Advanced Configuration Activities
Editing Mainframe Access Parameters
Enabling Passphrase Support
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 TSO Command support
Application Server Parameters for ChangeMan 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
Obtaining an MFA Server Trace
Dynamic Tracing
Configuration File
Customizing Data Connect
Introduction
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
About Librarian
References
Librarian Exit Table
Endevor
About Endevor
References
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
Prerequisites
MFA Server Configuration for ES/MSS
Enable ES/MSS Support
Define the Target z/OS CICS System
Define the Target ES/MSS Server
Restart MFA Server
Technical Details
How ES/MSS Understands the Connection
How z/OS CICS Understands the Connection
Console Commands
Introduction
Console Commands
General Mainframe Access Server commands
C CONV=id
DISPLAY CONVERSATION
DISPLAY LU
DISPLAY TCPSTATUS
FLUSH XDBOUT
REFRESH ACCESSLIST
RESET TIMEOUT=n
SDUMP
SET TIMEOUT=n
Start
Stop
TRACE OFF
TRACE ON and TRACE SHORT
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
MFMDS015E AMS/TSO DR failure - TRX aborted
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
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
ACBNAME
ACCESS_LIST_CHECK
APPLID_PASSWORD
AUDIT_LOG
BACK_LOG
BIND_NETADDR
BUFFER_SIZE
CHANGEMAN_COMMON_BUILD
CHANGEMAN_DSNQUALIFIER
CHANGEMAN_INTERFACE
CHANGEMAN_SSID
CHANGEMAN_TEST_OPTION
CHANGEMAN_XMS_SIZE
COMPRESSION
COMPRESSION_TYPE
CONSOLE_NAME
DSS_SCAN_INTERVAL
EID
ENDEVOR_DSNQUALIFIER
ES-MTO_MAXTASKS
ID
IMSLINK_MAXTASKS
IPADDRESS
JES_BUFFER_TRACE
JES_CONCHAR
JOBNAME
LIST_DB2
LIST_PARAMETERS
LU62_APPLID
LUNAME
MAX_DS_ALLOCATIONS
MAX_PUBLIC_FILES
MAXIMUM
MCOLINK_MAXTASKS
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_LISTING_DATA_CLASS
MFA_MCG_DB2CONNECTION
MFA_PANVALET_HISTORY
MFA_PANVALET_INTERFACE
MFA_PANVALET_UPD_MODULE
MFA_SAF_HISTORY
MFA_SYSOUT_CLASS
MFA_SYSOUT_DEST
MFADIRECT
MFADIRECT_MAXTASKS
MFALINK_MAXTASKS
MINIMUM
MODENAME
NETWORK_ID
ORGANIZATION
PEM_FEATURE
PORT
PROCEDURE
RACF_APPLID
REST_API
REST_BUFFER_SIZE
REST_INACTIVITY_TIMEOUT
REST_MAXTASKS
REUSE_ASID
ROUTE
SCLM_WARN_LEVEL
SECURITY
SESSIONS
SMF_RECORDID
SOCKETS
SYNCLEVEL
SYSOUT
TCP_PORT
TCPLINK_MAXTASKS
TIMEOUT_FOR_CONNECTION
TIMEOUT_FOR_INITIAL_RECEIVE
TPNAME
TRACE
TRACING
TSO_INITMOD
TSO_JOBCHAR
TSO_JOBCHAR_PREFIX
TSO_MSGCLASS
TSO_NOTIFY
TSO_PCNAME
TSO_PROCEDURE
VIO_FOR_ENDEVOR_LOG
After Installing
Setting up the product
Configuring the Remote System Explorer Support
Configuring the firewall
To configure the firewall settings
Enabling SHIFT-JIS
Repairing on UNIX
Uninstalling
Managing Licenses
Overview
To start Micro Focus License Administration
Configuring 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
Restarting SafeNet on Linux Using SystemD
Enable Automatic Restart of the AutoPass License Daemons on Linux Using SystemD
Installing a standalone network license server
Installing on Windows
Standard installation
Silent installation
Installing on UNIX and Linux
Installing License Manager without Sentinel RMS or AutoPass
Installation
Silent installation
Setting up network licensing with COBOL server
Trial licenses
Commuter licenses
To obtain a commuter license
To return a commuter license
Usage Logging
License Usage Logging with AutoPass License Server
Prerequisites for Integration with an AutoPass License Server
Integrating with an AutoPass License Server
Configuring AutoPass License Server for Custom Reports
Working with Custom Reports
Create a Custom Report
Run a Custom Report
Licensing Error Messages
Initialization error - Initializing: Cannot communicate with licensing daemon
Error - Initializing: 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
Additional License Authorizations for Visual COBOL & Enterprise software products
Known Issues and Restrictions
Application Server JCA Support
Application Workflow Manager
AppMaster Builder
Analysis Option
COBOL
AMB Data Views
Distributed Generation Server
Project Explorer
Issues with Audit Manager
Calling COBOL Programs from C
COBOL Programming
Boolean Data Items
CBL2XML Utility
Interface Mapping Toolkit
Enhanced ACCEPT/DISPLAY Syntax (Adis)
Filenames
IDXFORMAT 8 and 12 File Size Limits
Unsupported Features
XML Extensions
Code Analysis - Known Issues and Restrictions
Compatibility
Coexisting with earlier Micro Focus products
MFA Server v9.00 Enterprise Developer 7.0
Installation on Windows
Containers
Installing on UNIX and Linux
Data Access
Classic Data File Tools
COBSQL
HCO for DB2 LUW
File Handling
Issues with OpenESQL
Records with Alternate Keys
Debugging, Problem Determination and Diagnostic Tools
Debugging in Eclipse
Language Service
Remote Debugging - Known Issues
Issues with Reverse Debug and Live Recording
Test Coverage
Just-in-time debugging
Documentation Considerations
Issues with Enterprise Server
Eclipse IDE
Background Parsing
Building Applications
Eclipse Help Viewer
Eclipse Projects and Files
Editing Symbolically Linked Files
Enterprise Server sign on credentials
Error markers
Java Support
Language Servers
Leaking File Handles
Remote Development
Restrictions in Refactoring
Standalone Files
WTP Tools
JVM COBOL Applications - Known Issues and Restrictions
Application Servers - Known Issues
COBOL JVM Projects - Known Issues
Java Virtual Machine - Known Issues
OpenESQL
Using Java and JVM COBOL Together
Licensing
Mainframe Programming and Management
Assembler Emulation
CICS
CICS Web Interface
CICS Web Services
DOCUMENT APIs
Enterprise Server
HCO for DB2 LUW
Issues with HCO for SQL Server (HCOSS)
Historical Statistics Facility (HSF)
IMS Support
Issues with JCL and VSE
Mainframe Call Generator
Issues with Mainframe Subsystem Support (MSS)
MFDS
PL/I Support
Run-time Behavior
Issues with SQL Option for DB2
Restrictions in the Micro Focus Unit Testing Framework
Remote Mainframe Development
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 Enterprise Developer
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
Project templates
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
Resources
Linked resources
Configuring projects
Properties
Project build path
Build precedence
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
Builder Preferences
Background Parsing
Builder Preferences
Content Assist
COBOL editor
COBOL Formatter preferences
File extensions
Project Builder preferences
Smart Edit mode
Syntax coloring
Standalone editing
Using Eclipse for COBOL Development
Overview of Creating COBOL applications in Eclipse
Tips and Tricks with the IDE
Perspectives and Projects for COBOL Development
Writing Code Efficiently in the COBOL Editor
Editing Assistance in the COBOL Editor
Using COBOL Code Templates
Formatting COBOL code
To format COBOL source code
Formatter profiles
Creating a formatting profile
COBOL Formatter preferences
Editing a formatting profile
Deleting a formatting profile
Clean Up profiles[2]
Creating a clean up profile
Clean up preferences
Editing a clean up profile
Deleting a clean up profile
Importing and exporting profiles
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
Searching using Micro Focus Search
Micro Focus Find/Replace
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 remote projects
To create a remote native COBOL project
To create a remote COBOL JVM project
To create a remote mainframe project
To create a remote COBOL copybook project
To change the connection details of a remote project
To convert a local COBOL project to a remote COBOL 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
Remove project dependencies
To link to copybooks or sources outside the project
To link to mainframe locations
Using custom project and file templates
To configure the IDE to use custom templates
To create a custom project template
To create a custom file template
To create a project or a file from a custom template
Identifying COBOL copybooks and programs
Configuring the project, build configuration, folder and file properties
Project Properties
Build Paths
Build Settings
BMS Properties
Standalone editing
File extensions
Run-Time Configuration Properties
Build Configurations
Managing Build Configurations
Configuring Build Configuration Settings
Folder and File Properties
Viewing overridden settings
Setting the file properties using directive scanning
Building COBOL applications
Compiling COBOL Applications
Compiling COBOL code
Executable file formats
Compiling JVM COBOL
Building a project using Apache Ant
Setting Compiler directives for COBOL
Setting project-wide Compiler directives
Setting Compiler directives within a build configuration
Setting Compiler directives on folders or individual files
Setting Compiler directives from the command line
Setting Compiler directives using a response file
Setting Compiler directives in source code
Setting Compiler directives in a directives file
Configuring directive sets
Configuring directive set references
Creating an .mfdirset file
Using environment variables
Specifying environment variables for an application
Editing variables in the build environment
Removing variables in the build environment
Specifying environment variables in a run configuration
Copybook search order
Temporary files used when compiling native COBOL
Techniques for quicker compilation
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 systems for running native COBOL applications
Dynamically binding run-time systems to your native COBOL applications
Program loading order 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
Cleaning a project
Tips: Building COBOL projects
Developing applications on remote machines
Remote host connections
To create a connection to a remote host
Securing a remote SSH connection
Remote connection troubleshooting
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
Remote server configuration
Configuring the firewall
To configure the firewall settings
To launch a server on the remote host using the 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
Preparing files for deployment
Copy deployment files to a specific folder
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 in the IDE
Performing Code Analysis on Demand
Performing Code Analysis from the Command Line
Including Code Analysis in a Continuous Integration Process
Configuring Rules and Rule Sets
Importing Rule Sets into the IDE
Importing Existing Code Analysis Reports
Analysis Services
Data Flow Analysis
To run Data Flow Analysis
The Data Flow Analysis Tree
Configure the Data Flow Preferences
Program Flow Graph
To display a Program Flow Graph
Using the Program Flow Graph
Configure the Program Flow Graph Preferences
Using COBOL Source Information
Introduction to COBOL Source Information
To run a CSI query
CSI Query Results
CSI Queries
Data Items
Complex Data Item Queries
Qualified Names
Examples of Data Item Queries
Procedures (Paragraphs and Sections)
Called Subprograms
COBOL Verbs
Examples of COBOL Verb Queries
Special Queries
CALL
COPY
DEADDATA
LABEL
TIMES
UNDECL
UNEXEC
UNREF
Wildcards
Application Analysis Server
To set up an Application Analysis Server connection
Getting Direct References
Debugging COBOL Applications
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 enable a core dump using a library routine
To enable core dumps using run-time tunables
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 applications that run on Ubuntu (ptrace restriction)
Debugging CICS channels and containers
CICS Channels View
To modify data in a container
Debugging mixed language applications
Debugging on Enterprise Server Scenarios
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
To debug 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 outside of Eclipse
The Character Animator
Overview of Character Animator Functions
Working With Character Animator
The Character Animator Screen
Character Animator Screen Overview
The Information Line
Moving the Cursor and Text During Animation
Entering Text on Menus
Using the Character Animator Windows
Viewing Data
Key Functions for Updating Queried Data Items
Obtaining Help
Menus
Animator Main Menu
Breakpoints Menu
Environment Menu
Go Menu
Locate-declaration Menu
Perform-level Menu
Query Menu
Query Data-name Menu
Reset-execution Menu
Text Menu
Functions
Function Access
Function Descriptions
0-9
Align
Alter Path
Breakpoints
Cancel All Breakpoints
Cancel Program Break
Child Data
Clear
Cursor-name Locate
Cursor-name Query
Cursor-position Reset
Detach from application
Do
Do At Breakpoint
Down-table
Enter
Enter-name Locate
Enter-name Query
Environment
Escape
Examine Breakpoints
Exchange
Exit Perform
Find String
Go
Hex
Hex/ASCII
Hide Monitors
If Breakpoint
Join Text
Look-up
Monitor
Monitor-off
Next Reset
On Count Breakpoint
Organize Monitors
Parent Data
Perform-level
Perform-view
Query
Query Data-name
Quit-perform
Refresh
Reset-execution
Same Level
Scroll Up/Down (continuously)
Scroll Up/Down (one line)(Ctrl+<left-arrow>/<right-arrow>)
Select Program Break
Set Breakpoint
Split Text
Start
Step
Step Perform
Text
This Program Break
Thread-local Breakpoint
Un-set Breakpoint
Up Table
View
View Programs
View Threads
Where
Word Left
Word Right
Zoom
Zoom Breakpoint
Run-time System Error Messages
Directives for Character Animator
Directive Descriptions
COBAIF
END
FASTEXIT
FASTLOAD
MIXEDLANGDEBUG
MULTITHREAD
PROGBPALLENTRY
RESEQ
ZEROSEQ
Using COBANIMOPT
Cross-session Debugging
Using cobesdebug to Debug Services and Applications on Enterprise Server
How it works
How Enterprise Server finds a match
How to debug services and applications with Enterprise Server Dynamic Debugging
Overview of the debugging process
Preparing projects for debugging
Compiling for debug
Creating a debug configuration
COBOL Application, COBOL Attach to Process, and COBOL Wait for Application Attachment
COBOL Core Dump
COBOL Enterprise Server
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
Setting conditional breakpoints and watchpoints
Reverse debugging
Debugging commands and options
Debugging in COBOL Copy view
Enabling Just-in-Time debugging
Enable Just-in-Time debugging in Eclipse
Code Refactoring
Rename Refactoring
Rename Refactoring JVM COBOL
Extracting COBOL code to a copybook
Extracting PL/I code to an include file
Extracting a section or paragraph from a COBOL program to a new program
Creating a program from a section or paragraph (COBOL)
Creating a program from computation (COBOL)
Creating a program from condition
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
Working with Apache Maven
Create a Maven-based project
Adding Maven support to an existing project
Micro Focus-related Maven goals
Using Eclipse for PL/I development
PL/I Perspective and Projects
The PL/I Editor
Configuring 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
Configuring the Build Path for PL/I Projects
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
Code Coverage (PL/I)
Enabling Code Coverage
Running an Application with Code Coverage
Viewing the Code Coverage Information (PL/I)
Debugging PL/I projects
To debug a PL/I project
PL/I debug configurations
PL/I Application
PL/I Attach to Process
PL/I Enterprise Server
PL/I Wait for Application Attachment
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
Managing enterprise servers from Server Explorer
To sign on to a Micro Focus directory server
To export an enterprise server
To import an enterprise server
To start, stop, or restart an enterprise server from the IDE
To display an enterprise server log inside the IDE
To connect to a remote enterprise server
To create a new enterprise server
To delete an enterprise server
To select an enterprise server to run an application on
To associate an enterprise server with a project
To open the ESCWA UI from the IDE
To create an Enterprise Server Common Web Administration (ESCWA) connection
Managing the JCL spool queues and catalog
To submit a JCL file
Catalog tasks[1]
Display and filter the catalog
Create a catalog item
View the contents of a catalog item
Edit a data set from the catalog
Duplicate a catalog item
Delete an item from the catalog
Spool queue tasks[1]
Display job details
Hold or release a job in the queue
Update control information for a job
Delete a job from the queue
Filter the spool queue
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
Overview
Terminology
Scenarios for Using Jenkins
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 Mainframe Applications
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 Containers
Introduction to Containers
Benefits of Using Containers
Container Terminology
Getting Ready to Use Enterprise Developer with Containers
Installing Container Tools on Red Hat Enterprise Linux
Installing Docker on Linux
Installing Docker on Windows
Key Concepts When Using Containers 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 Containers for COBOL Application Development
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 and Running COBOL Applications in Containers
Debugging and Running Native COBOL Applications in Containers
Overview of Debugging and Running Native COBOL Applications in Containers
Different Ways of Building a Native COBOL Application in a Container
Using Character Animator to Debug Native COBOL Applications Running in Containers
How to work with native COBOL applications in containers
To add a Dockerfile to a native COBOL project
To specify project properties for containers
To specify container information in debug and run configurations
To specify the type of container to use
To debug or run a native COBOL application in a container
To prepare a containerized native COBOL application for debugging on Enterprise Server
To debug or run a containerized native COBOL application running on Enterprise Server
To debug or run a containerized native COBOL application running under Kubernetes
To build an image for deployment
Debugging and Running JVM COBOL Applications in Containers
Building a JVM 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 JVM COBOL Application in a Container
Debugging and Running PL/I Applications in Containers
Container Demonstrations
Supplied Container Demonstrations
Using the Container Demonstrations
The Container Demonstration for the Enterprise Developer Base Image
Introduction to the Container Demonstration for the Enterprise Developer Base Image
Running the Container Demonstration for the Enterprise Developer Base Image
Files in the Container Demonstration for the Enterprise Developer Base Image
The CICS Container Demonstration
Introduction to the CICS Container Demonstration
Running the CICS Container Demonstration
Files in the CICS Container Demonstration
Programming
COBOL Programming
What is COBOL?
History of COBOL
Learn COBOL
Glossary
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
JVM COBOL Programming
Native COBOL Compared to JVM COBOL
Introduction to Object-Oriented Programming for COBOL Developers
Moving Native COBOL Applications to JVM COBOL
Why Move to JVM COBOL Code?
Considerations When Moving to JVM COBOL
Writing Multi-User Applications
Using Java Managed Beans to Manage and Monitor COBOL Applications
Accessing Procedural COBOL From JVM COBOL Code
Example of Using a JVM COBOL Wrapper Class
Example of Using the ILSMARTLINKAGE Compiler Directive
Compiling and Calling JVM COBOL Applications as Part of a Package
Producing a Java Property File
Example 1: Locating the Java Property File on the CLASSPATH
Example 2: Locating the Java Property File Directly from COBOL
64-bit applications in the Java environment
Using a File Handler in JVM COBOL
Multiple user COBOL applications in Java
Background to multiple run units and Java
Developing an application for multiple run units in JVM COBOL
Interoperability
Data Marshaling and Type Conversion for JVM COBOL Interoperation
Type Compatibility in Interoperation with Managed Code
Exposing COBOL Linkage Data as Managed Types
Type Mappings from Native COBOL to JVM COBOL Code
Write a Proxy or Edit the COBOL for Java Interoperation?
JVM COBOL Interoperating with Native COBOL
Calling Native COBOL from JVM COBOL
Passing Parameter Modes for JVM COBOL Calling Native COBOL
Pointers from Native Code to JVM COBOL
Strings in JVM COBOL Interoperation
Arrays of Bytes in JVM COBOL Interoperation
Limitations in JVM COBOL Interoperability
Example of JVM COBOL Interoperation with Native Code
JVM COBOL Interoperating with Java
Java Calling JVM COBOL
Example of Java Calling JVM COBOL
JVM COBOL Calling Java
Example of JVM COBOL Calling Java
JVM COBOL Passing Java Instances to Native Procedural COBOL
JVM COBOL Passing Java Instances to Native Object COBOL
Exposing COBOL as Web Services
Using COBOL and Java Together
Java and COBOL Interoperability Options
Considerations
Linking to the Multi-threaded Run-time System
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
Migrating Applications between JDK 8 and JDK 11
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 Native OO COBOL
Overview of Calling Java from Native 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 Native OO COBOL from Java
Overview - Calling Native OO COBOL from Java
Before You Start
Writing a Java Class in Native OO COBOL
Importing the COBOL Support
The Wrapper Class
Adding and Removing Methods
Throwing Exceptions from COBOL
Using BY REFERENCE Parameters
Working with Java Programs
Java Data Types
Overview
Java Data Type Conversion Rules
Java Typedefs
Using the Jarray Class
Adding Parameters Using ParameterList()
Using Structures
Creating Custom Records using com.microfocus.cobol.lang.CustomRecord Interface
JVM COBOL Interoperating with Java
Java Calling JVM COBOL
Example of Java Calling JVM COBOL
JVM COBOL Calling Java
Example of JVM COBOL Calling Java
JVM COBOL Passing Java Instances to Native Procedural COBOL
JVM COBOL Passing Java Instances to Native Object COBOL
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
National Literals
National Hexadecimal Literals
National Data Items
UTF-8 Data
UTF-16 Byte Ordering
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
Multithreading
Preserving State
File Handling
Releasing Resources
Object-oriented COBOL
Interface Mapping Toolkit (IMTK)
Managing IMTK Projects
Defining Service Interfaces
Interface Mapper
Operations
Deploying Service Interfaces
Deployment Configuration Requirements
Service Interface Deployment Methods
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 configure the run-time environment
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 edit operation 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 delete a deployed service
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
Username/Password
Interface Mapper
COBOL Assignment
Field Properties
Group Properties
Mappings
Operation Properties - General tab
Operation Properties - Path/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
Avoiding data name conflicts
Calling a COBOL Entry Point Directly
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
Calling COBOL Programs from C
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
Introducing XML Extensions
What is XML?
COBOL as XML
XML as COBOL
Getting started with XML Extensions
Overview
Model files
XMLGEN Compiler directive
Typical development process example
Design the COBOL data structure and program logic
Compile the program
Execute the program
Making a program skeleton
Making a program that exports an XML document
Populating the XML document with data values
Deploy the application
How XML Extensions locates files
XML Extensions statements reference
Memory management with XML Extensions
Searching for files
Document processing statements
XML EXPORT FILE
XML EXPORT TEXT
XML IMPORT FILE
XML IMPORT TEXT
XML TEST WELLFORMED-FILE
XML TEST WELLFORMED-TEXT
XML TRANSFORM FILE
XML TRANSFORM TEXT
XML VALIDATE FILE
XML VALIDATE TEXT
Document management statements
XML COBOL FILE-NAME
XML FREE TEXT
XML GET TEXT
XML PUT TEXT
XML REMOVE FILE
XML RESOLVE DOCUMENT-NAME
XML RESOLVE SCHEMA-FILE
XML RESOLVE STYLESHEET-FILE
XML RESOLVE MODEL-NAME
Directory management statements
XML FIND FILE
XML GET UNIQUEID
State management statements
XML INITIALIZE
XML TERMINATE
XML DISABLE ALL-OCCURRENCES
XML ENABLE ALL-OCCURRENCES
XML DISABLE ATTRIBUTES
XML ENABLE ATTRIBUTES
XML DISABLE CACHE
XML ENABLE CACHE
XML FLUSH CACHE
XML GET FLAGS
XML GET WHITESPACE-FLAGS
XML TRACE
XML GET STATUS-TEXT
XML SET ENCODING
XML SET 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
JVM COBOL code considerations
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
Table1.xml
Table2.xml
Table3.xml
Table4.xml
Table5.xml
Table6.xml
Example 5 Export and import text
Development for example 5
Batch file for example 5
Program description for example 5
Data item for example 5
Other definitions for example 5
Program structure for example 5
Execution results for example 5
Example 6 Export file and import file with directory polling
Development for example 6
Batch file for example 6
Program description for example 6
Data item for example 6
Other definitions for example 6
Program structure for example 6
Execution results for example 6
Example 7 Export file, test well-formed file, and validate file
Development for example 7
Batch file for example 7
Program description for example 7
Data item for example 7
Other definitions for example 7
Program structure for example 7
Execution results for example 7
Example 8 Export text, test well-formed text, and validate text
Development for example 8
Batch file for example 8
Program description for example 8
Data item for example 8
Other definitions for example 8
Program structure for example 8
Execution results for example 8
Example 9 Export file, transform file, and import file
Development for example 9
Batch file for example 9
Program description for example 9
Data item for example 9
Other definitions for example 9
Program structure for example 9
Execution results for example 9
Example 10 Diagnostic messages
Development for example 10
Batch file for example 10
Program description for example 10
Data item for example 10
Other definitions for example 10
Program structure for example 10
Execution results for example 10
Example 11 Import file with missing intermediate parent names
Development for example 11
Batch file for example 11
Program description for example 11
Data item for example 11
Other definitions for example 11
Program structure for example 11
Execution results for example 11
Example batch files
Cleanup.bat
Example.bat
Examples.bat
Appendix B: XML Extensions sample application programs
Appendix C: XML Extensions error messages
Summary of error messages 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
Enabling CGI support
EXEC HTML statement
Substitution Markers
EHTML Preprocessor
EHTML Preprocessor Directives
AUTOFORMAT (AF)
CONFIRM
DEBUG (D)
DEBUGFILE
OUT
PREPROCESS (P)
STEPEXEC
STEPHTML
TRACE
WARN
Deploying a CGI Application with Embedded HTML
Debugging a CGI Application
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 JVM COBOL Code
Unsupported Library Routines
Using Pipes to Assign Filenames When Using the Vision File Handler
ACUCOBOL-GT File Handling
Configuring Access to Vision Files
File Limits
Vision Related Utilities
Converting Vision Files
Configuring Access to Data Files Through AcuServer
ACUCOBOL-GT Library Routines
C$CALLEDBY
C$CALLERR
C$CHDIR
C$COPY
C$DELETE
C$FILEINFO
C$GetLastFileOp
C$JUSTIFY
C$LIST-DIRECTORY
C$LOCKPID
C$MAKEDIR
C$MEMCPY (Dynamic Memory Routine)
C$MYFILE
C$NARG
C$PARAMSIZE
C$REGEXP
C$RERR
C$RERRNAME
C$RUN
C$SLEEP
C$SYSTEM
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
Introduction
Compatibility Directives
DG
Compatibility with DG Interactive COBOL
Overview
DG Interactive COBOL Source Programs
Enhancing your Converted Application
Compatibility with DG Interactive COBOL Source
The DG Directive
Reserved Words
DG International Character Set
DG File Status and other Exception Values
Calls
Linkage Section Access
Arithmetic of Group Level Items
Run-time Switches
Program Identification and Data-names
Reformatting a DG COBOL Source File
Reformatting Rules
Compatibility with RM/COBOL
Converting RM/COBOL Applications
Configuring Your Application for Eclipse
Create a native Visual COBOL project
Set the DIALECT RM Compiler Directive for the Project
Import your RM/COBOL Source Code
Add Adis Support to the Project
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
C$Century
C$ConvertAnsiToOem
C$ConvertOemToAnsi
C$DARG
C$Delay
C$GetEnv
C$GetLastFileName
C$GetLastFileOp
C$GetNativeCharset
C$LogicalAnd
C$LogicalComplement
C$LogicalOr
C$LogicalXor
C$LogicalShiftLeft
C$LogicalShiftRight
C$NARG
C$OSLockInfo
C$SecureHash
C$SetEnv
C$RERR
DELETE
RENAME
SYSTEM
RM/COBOL File Handling
Configuring Access to RM/COBOL Indexed Data Files
File Limits
RM/COBOL File Status Codes
Debugging JVM COBOL Using RM/COBOL Indexed Files
Enabling CTF to Trace RM/COBOL Data Files
Data File Utilities
Indexed File Recovery (recover1) utility
Recovery command
Recovery command options
Recovery process description
The four phases of processing
Recovery support module version errors
Recovery example
Recovery program error messages
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 Run-Time Function Basics
Setting Run-Time Parameters
Executing Standard Run-Time Functions
Required Copy Files
Error Detection
Screen Handling
Individual Field Method
Entire Screen Method
Event Loop Method
Using Multiple Panels
Standard Run-Time Functions
Configurable Keys
ACCEPT FIELD
CHANGE PANEL PALETTE
CHECK MENU OPTION
CLEAR ALL FIELDS
DISABLE ALL FIELDS
DISABLE FIELD FOR INPUT
DISABLE MENU OPTION
DISPLAY ALL FIELDS
DISPLAY FIELD
DISPLAY PANEL
ENABLE ALL FIELDS
ENABLE FIELD FOR INPUT
ENABLE MENU OPTION
EXECUTE EVENT
INITIALIZE ALL FIELDS
INITIALIZE FIELD
POPUP MENU
REMOVE PANEL
SET FIELD ATTRIBUTE
SET SCROLL BAR RANGE
SHOW FIELD ERROR
SHOW FIELD HELP
SHOW PANEL ERROR
SHOW PANEL HELP
UNCHECK MENU OPTION
VALIDATE ALL FIELDS
VALIDATE FIELD
Utility Functions
DELETE TEMPORARY FILE
END MODELESS OPERATION
END POLLING
HIDE MOUSE CURSOR
SET COLOR
SET MONOCHROME
SHOW MOUSE CURSOR
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 Run-time 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
Native 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
Oracle
Sybase
Informix
OpenESQL
Using the SQLDA
The PREPARE and DESCRIBE Statements
The FETCH Statement
The OPEN or EXECUTE Statements
The DESCRIBE Statement
Dynamic SQL
Dynamic SQL Statement Types
Execute a Statement Once
Execute a Statement More Than Once
Select a Given List of Data
Select any Amount of Data
Preparing Dynamic SQL Statements
Place Holders
Physical Location of PREPARE Statement
Executing Dynamic SQL Statements
EXECUTE IMMEDIATE Statement
FREE Statement (COBSQL Informix)
Dynamic SQL Statements and Cursors
CALL Statements
Example
Compiling SQL Applications
Specifying an SQL Preprocessor and Compiler Directive Options
Compiling Multiple Program Modules
Creating Debug Files
OpenESQL
OpenESQL Preprocessor Options
Setting the OpenESQL Preprocessor and Compiler Directive Options
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
Generating Code with MDCLGEN
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
SQL Error Mapping[6]
XML Support
Using OpenESQL with Web and Application Servers
Thread Safety
Connection Management
Transactions
User Accounts, Schemas and Authentication
Transaction Wrapper Sample
JDBC
Demonstration Application
JDBC Process
JDBC Resources
JNDI DataSource Objects
Database Connections
Connect Using a JNDI DataSource Object
Connect Using a JDBC Connection String
Sharing Database Connections Between Java and COBOL
Using OpenESQL with JDBC
Compiling JDBC Applications from the Command Line
Configuring the JDBC Run-time Environment
JVM Host Variables in Managed Code
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
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
EXEC SQL Statement
OpenESQL
Embedded SQL Statements
ALLOCATE CURSOR
ASSOCIATE LOCATORS
BEGIN DECLARE SECTION
BEGIN TRAN
BIND CONNECTION
CALL
CLOSE
COMMIT
CONNECT
DECLARE CURSOR
DECLARE DATABASE
DECLARE STATEMENT
DELETE (Positioned)
DELETE (Searched)
DESCRIBE
DISCONNECT
END DECLARE SECTION
EXECSP
EXECUTE
EXECUTE IMMEDIATE
FETCH
GET CONNECTION
GET DIAGNOSTICS
GET HDBC
GET HENV
GET NEXT RESULT SET
INCLUDE
INSERT
INTO
OPEN
PERSIST
PREPARE
QUERY ODBC
QUERY ODBC - Column Query
QUERY ODBC - Data Type Query
QUERY ODBC - Table Query
RESET CONNECTION
ROLLBACK
SAVEPOINT, SAVE TRANSACTION, RELEASE [TO] SAVEPOINT
SELECT DISTINCT (using DECLARE CURSOR)
SELECT INTO
SET AUTOCOMMIT
SET CONCURRENCY
SET CONNECTION
SET ERRORMAP[6]
SET host_variable
SET OPTION
SET SCROLLOPTION
SET TRACELEVEL
SET TRANSACTION ISOLATION
SYNCPOINT
UNBIND CONNECTION
UPDATE (Positioned)
UPDATE (Searched)
WHENEVER
SQL Compiler Directive Options
ACCESS
ALLOWNULLCHAR
ALLOWSERVERSELECT
ANSI92ENTRY
ARRAYCHECK
AUTOCOMMIT
AUTOFETCH
BEHAVIOR
Primitive Directives
DEF_CURSOR
IC_FH_ISOLATION
PF_RO_CURSOR
PF_UPD_CURSOR
RO_CURSOR
UPD_CONCURRENCY
UPD_CURSOR
BIND
CHECK
CHECKDUPCURSOR
CHECKSINGLETON
CLOSE_ON_COMMIT
CLOSE_ON_ROLLBACK
CONCAT
CONNECTIONPOOL
CTRACE
CURSORCASE
DATE
DATEDELIM
DB
DBMAN
DECDEL
DESCRIBEDTCHAR
DESCRIBEDTREC
DESCRIBEVARCHAR49
DESCRIBEVARCHARPICX
DETECTDATE
ERRORMAP[6]
ESQLVERSION
FIPSFLAG
GEN-CC2
GEN-CLASS-VAR
GEN-HV-FROM-GROUP
GEN-INIT-FLAG
GEN-SQLCA
HSFTRACE
IGNORE-NESTED
IGNORESCHEMAERRORS
INIT
ISOLATION
JIT
JNDI
JNDIENC
MARS
NIST
NOT
ODBCTRACE
ODBCV3
ODBCVER
OPTIMIZECURSORS
OPTION (deprecated)
OPTPER
PARAMARRAY
PASS
PICXBINARY
PICXBINDING
PRE
PREFETCH
QUALFIX
RESULTARRAY
SAVE-RETURN-CODE
SPDISPLAY
STMTCACHE
TARGETDB
TESTSQLSTATE
THREAD
TIME
TIMEDELIM
TRACELEVEL
TRANSACTION
TSTAMPSEP
USECURLIB
USER-SQLDA
WHERECURRENT
XAID
DBMAN Directive Settings
JDBC Driver Classes
JDBC URLs
Sample DataSource Object Files
SQL/COBOL Data Type Mappings
MF_ERRORMAP_PATH[6]
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.
COBES0121 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
MDCLGEN command-line tool
User Interface Reference
OpenESQL Assistant
OpenESQL Assistant - Options
OpenESQL Assistant - Main Window
Select Type of Query to Create dialog box
Query tab
Results tab
Details tab
Search Criteria tab
Literal Value dialog box
Sort tab
Auxiliary Code tab
Data Source Properties dialog box
COBSQL
PREPROCESS(cobsql)
COBOL Directives
COBSQL Compiler Directive Options
COBSQLTYPE, CSQLT
CSTART, CST
CSTOP, CSP
DEBUGFILE, DEB
DISPLAY, DIS
END-COBSQL, END-C, END
HSFTRACE
KEEPCBL
KEEPCOMP
MAKESYN
SQLBGP
SQLDEBUG
STOPCHK
TRACE
VERBOSE
XAID
COBSQL Messages
CSQL-I-001 to CSQL-E-023
CSQL-I-001: COBSQL has finished returning to the Checker
CSQL-I-003: COBSQLTYPE is incorrect defaulting to Oracle
CSQL-I-004: Accepted COBSQL-directive
CSQL-I-005: Passing precompiler-directive
CSQL-I-006: Rejected COBSQL-directive
CSQL-F-007: COBSQL/Checker incompatible -- Terminating
CSQL-I-008: Invoking integrated-preprocessor Preprocessor
CSQL-F-009: Irrecoverable error in integrated-preprocessor -- Terminating
CSQL-F-010: Irrecoverable error writing STK record
CSQL-F-011: Environment unsupported by COBSQL/Informix
CSQL-F-012: INFORMIXDIR must be set for Informix Support
CSQL-F-013: Unable to access: filename
CSQL-F-015: DOS Exec error Return Code is return-code
CSQL-F-016: UNIX Exec error Return Code is Return-Code
CSQL-I-017: Creating filename
CSQL-I-018: Invoking precompiler Precompiler/Translator
CSQL-F-019: Irrecoverable error Opening STK file
CSQL-I-020: Processing output of precompiler Precompiler
CSQL-F-021: Precompiler did not complete -- Terminating
CSQL-F-022: Irrecoverable error Reopening ORG file
CSQL-E-023: File Status file-status
CSQL-E-024 to CSQL-F-050
CSQL-E-024: Encountered an I/O on file filename
CSQL-F-025: Unable to Create virtual-heap
CSQL-F-026: Premature end of expanded source.
CSQL-I-027: Detected Working Section, now processing it
CSQL-I-028: Now processing through Procedure Division
CSQL-I-029: Found an EXEC SQL Statement, processing it
CSQL-E-036: Unable to open the precompiler file: filename
CSQL-F-037: Wrong Version of COBOL used, please upgrade
CSQL-I-038: The following directive is now Obsolete: COBSQL-directive
CSQL-I-039: The ORG & the CBL files were out of synch
CSQL-W-040: Pro*COBOL commented out the following line: source-line
CSQL-F-041: Cannot read the COBOL runtime switches
CSQL-F-042: Cannot set the COBOL runtime switches
CSQL-F-046: Command line is too large. Maximum length is 1140 characters
CSQL-F-047: Cobsql cannot be used with the SOURCEFORMAT directive.
CSQL-F-048: Cobsql is not supported for use with JVM COBOL code.
SQL Data Types
Integer Data Types
Tiny Integer
Small Integer
Integer
Big Integer
Character Data Types
Fixed-length Character Strings
Variable-length Character Strings
Large Character Strings (CLOB)
Unicode Character Strings
Unicode Variable-length Character Strings
Unicode Large Character Strings (DBCLOB)
DBCS Character Strings
DBCS Variable-length Character Strings
DBCS Large Character Strings
XML 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
DATE
DATETIMEOFFSET
TIME
TIMESTAMP
TIMESTAMPOFFSET
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
PIC X VARYING
ROWID Data Type
SQL TYPEs
BINARY
BLOB
BLOB-FILE
BLOB-LOCATOR
CHAR
CHAR-VARYING
CLOB
CLOB-FILE
CLOB-LOCATOR
DATE
DATE-RECORD
DBCLOB
DBCLOB-FILE
DBCLOB-LOCATOR
LONG-VARBINARY
LONG-VARCHAR
RESULT-SET-LOCATOR
ROWID
TIME
TIME-RECORD
TIMESTAMP
TIMESTAMP-RECORD
TIMESTAMP-OFFSET
TIMESTAMP-OFFSET-RECORD
VARBINARY
XML
Data Structures
The SQLCA Data Structure
The SQLDA Data Structure
Keywords
Data Files
Data File Tools
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
Open an Enterprise Server Data Set through ESMAC
Open an Enterprise Server Data Set through ESCWA
Error Messages When Using Data File Editor with Enterprise Server
Insert a Record
Edit an Unformatted Record
Edit a Formatted Record
Duplicate a Record
Layout and Field Validation
Fix Validation Warnings
Edit a Record Using Hexadecimal Values
Delete a Record
Profile Files
Working with Different Character Sets
Viewing and Filtering Data Files
View File Information
Filtering a Data File
Filter the Data File
Filter the Data File (Deprecated)
Filter Data Types
Filter Operators
Load and Unload a Structure File
Navigate a Data File
Show the Contents of a Data File in Hexadecimal
Find and Replace Information in a Data File
Select the Encoding for a Data File
Order a Data File using Indexed Keys
Comparing Data Files
Compare Two Data Files
Viewing Merged Spool Files
Open a Merged Spool File
Backing Up Data Files
Back up a data file
Using the Structure File Editor
Creating Structure Files and Layouts
Create a Structure File
Editing Structure Files and Layouts
Edit a Structure File
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
Installing VRECGEN
Running VRECGEN
VRECGEN2
Installing VRECGEN2
Running 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
Input
Record Layout Types
Record Layout Names
Output
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 Classic 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
Overview
Command Line
Option Files
Redirection of Information
Rebuild Options
Reorganizing Indexed Files
Rebuilding a Corrupt Indexed File
Converting a File
Validating an Indexed File
Rebuild through Fileshare
Callable Rebuild
Rebuild Examples
File Handling
File Handling Examples
Btrieve Examples
Example Xfh2btr Configuration File
Example Btrieve Trace Output
Example Btrieve Trace Option Settings
Example of Btrieve Record Lengths
Data and Key Compression Example
External Files Example
File Handler Examples
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
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 Examples
Example of Displaying File Status Codes
Example of Checking File Status Codes
Example of Extended File Status Codes
Indexed File Examples
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 Examples
Example Mfsort Command Line
Example Mfsort Fields Instruction
Example Mfsort Key Instruction
Example Mfsort Instruction File
Rebuild Examples
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
Relative File Definition Example
Sequential File Examples
Example Record Sequential File Definition - Fixed-length Records
Example Record Sequential File Definition - Variable Length Records
Example Line Sequential File Definition
Example Printer Sequential File Definition
File Handling Guide
Introduction
Overview
Micro Focus File Handler
File Organizations
Overview
Sequential Files
Record Sequential Files
Line Sequential Files
Printer Sequential Files
Relative Files
Indexed Files
Primary Keys
Alternate Keys
Duplicate Keys
Sparse Keys
Indexed File Access
Fixed-length and Variable-length Records
File Headers
File names
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
Overview
Data Structures
File Control Description (FCD)
Record Area
Filename Area
Key Definition Block
Global Information Area
Key Definition Area
Component Definition Area
Accessing the FCD
Operation Codes
Relative Byte Addressing
Read a Record
Rewrite a Record
Delete a Record
Creating Your Own File Handler
Dynamic Redirection to a Custom File Handler
Redirection Using Configurable DYNREDIR
Specifying a List of Custom File Handlers
Specifying Configurable Custom File Handlers
Writing a Custom File Handler
Restrictions
Creating a New Index File
Sort Module
Compression Routines
Sort Module
Sort Utilities
Introduction
DFSORT and ICETOOL Emulation
DFSORT EXEC PARM Options Emulation
PARM
DFSORT Program Control Emulation
ALTSEQ
DEBUG
END
INCLUDE
INREC
MERGE
MODS
OMIT
OPTION
OUTFIL
OUTREC
RECORD
SORT
SUM
ICETOOL Emulation
COPY
COUNT
DISPLAY
OCCUR
RANGE
SELECT
SPLICE
SORT
STATS
UNIQUE
SYNCSORT Emulation
SYNCSORT EXEC PARM Options Emulation
PARM
SYNCSORT Program Control Emulation
ALTSEQ
DEBUG
END
INCLUDE
INREC
MERGE
MODS
OMIT
OPTION
OUTFIL
OUTREC
RECORD
SORT
SUM
Invoking Mfsort
Instructions
FIELDS Instruction
Field Types
Defining Input and Output Files
RECORD Instruction
ORG Instruction
KEY Instruction
Creating a Statistics Report
Example Commands
Sorting Using More Than One File
Character Sort in Ascending Order
Numeric Sort in Descending Order
Omitting Records
Single File Sort Using INCLUDE and a Sub-string Comparison
Single File Sort Using Environment Variables
Transforming Records Using OUTREC
Sort Using OUTFIL for Complex Reporting
Input Data
Mfsort Command
Output
Workfile
Error Messages
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
Introduction
Configuring Tracing and Logging
Dynamic Tracing
Using the FCD to Control Tracing
Using Library Routines to Control Tracing
Trace Player
Run the Trace Player from the Command Line
Examples
File Systems
32-bit file systems
64-bit file systems
File systems and FILEMAXSIZE
Fileshare Guide
Introduction
Overview
How Fileshare Works
Standard Operation
Fileshare Client
Specifying the Fileshare Server
As a Filename
In a Configuration File
Specifying the Communications Protocol
Configuring Your Fileshare Client
Fileshare Client Configuration Options
Example Client Configuration File
Using the File Handling Redirector Module
FHREDIR Return Codes
Fileshare Server
Configuring the Fileshare Server
Specifying a Fileshare Server Name
Specifying the Communications Protocol
Fileshare Server Configuration Options
Example Server Configuration File
Starting the Fileshare Server
Stopping the Fileshare Server
Configuring CCI Communications for Fileshare
About Fileshare Communications
Specifying the Communications Protocol
Using CCITCP
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 to FS300
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
MQSeries
Passing user credentials when connecting to an MQSeries queue manager
Mainframe Programming
Mainframe Subsystem Support Developer Introduction
What is Mainframe Subsystem Support?
Migrating the Application
About CICS applications
Micro Focus BMS Painter
Invoking CICS Programs Externally
IBM CICS Transaction Gateway
Micro Focus External Call Interface
CICS Application Programming Interface (API)
File and Database Support
CICS ECM Preprocessor
About IMS applications
About JCL applications
Configuring Enterprise Server to Run the Application
CICS, IMS and JCL Resources
Data Conversion
CICS Intersystem Communication
Terminal Emulation
Running Applications in a TN3270 Mainframe Display
Choosing a TN3270 Mainframe Display
Embedded Rumba Mainframe Display View
Connecting to the host
Disconnecting from the host
Connecting to secure servers
Importing and exporting connections
Running Applications in a TN3270 Mainframe Display
Launching the Display When Running Applications
Connecting the Display to an Enterprise Server When Running Applications
Debugging using a TN3270 Mainframe Display
Launching the TN3270 Mainframe Display When Debugging Applications
Connecting the Display to an Enterprise Server when Debugging Applications
Debugging Using the Embedded Rumba Mainframe Display View
Debugging using Rumba+ Desktop
Debugging using Other TN3270 Emulators
AppMaster Builder
Introducing AppMaster Builder
Scenario for Using AppMaster Builder
The AppMaster Builder Tool Set
AppMaster Builder User Areas
AppMaster Builder Preferences
AppMaster Builder in Eclipse IDE vs. AppMaster Builder in Mainframe Express IDE
Developing Applications in the AppMaster Builder Perspective
AppMaster Builder Projects
Object Types
Project Explorer Tree View
Object Properties
Workgroups
Specifying a Workgroup
Using Workgroup Objects
Screen Painter
Screen Painter Basics
Defining Screen Attributes
CICS
IMS
DLG
Designing a Screen
Painting Fields
Field Attributes
Rules for Defining Field Attributes
CICS Data Transmission
Defining Data Representation
Arranging Fields
Duplicating Fields
Painting Program Fields
Defining Field Edits
Edit Masks
Error Processing Messages
Values and Conversions
Specifying Values
Specifying Conversions
Fields and Flags for Edit Routines
Testing Screen Behavior
Online Express
Events
Actions
Field Mapping
Database Access
Define the Call
Execute DB Calls at Events
Coding Nested Loops
Nested Loop Example
Overriding Nesting Levels
Executing Multiple Database Actions
Qualifying VSAM Multiple-Field Keys
Overriding Error Processing
Writing Custom Logic
Customizing Database Calls
Types of Custom Code
Local Program Code
Global Program Code
Paragraphs
User-Defined Rules
Commarea and Savekey Storage
Commarea Storage
Savekey Storage
Store on your Screen
Suppressing Savekey Generation
Global Commarea Size
Control Points
Program Painter
Program Templates
Program Template for Online Applications
Program Template for Batch Applications
Coding Programs
Coding Options
Sample Online Program
Sample Batch Program
Customizer/Micro Focus Generator (MFG)
Defining Customizer User Rules
Calling AMB and Customizer User Rules
MFG/FMP Compatibility
MFG Subsystems
Data Views
Data View Explorer
Data Source Files
Coding DDI VSAM Sources
Coding DDI IMS DB Sources
Coding SQL Schema Sources
Adding Data Views
Setting Data View Properties
Defining Data Views
Importing Data Views
Generating Data Views
Using the DB2 Catalog
Customizing Data Views
Data Structure Editor
Report Painter
Paint Report Layouts
Painting Report Mock-Ups
Report Mock-Up Rules
Sample Report Mock-Up
Creating Report Programs
Define Report Logic
Code Working-Storage
Code Report Logic
Multiple SUM or SOURCE Statements
Suffixed Data Elements
Array Items
Report Mapping Rules
Structure Summary
Sample Programs
Report Writer Structures - Sample Program
Iterative Expressions - Sample Program
Application Reports
Application Definition Report
Screen HardcopyField Attribute Report
Component List Report
Field/Screen Cross Reference Report
Macro/Program Cross Reference Report
Program DB/DC Report
Analysis Option
Generating the Analysis
Browsing the Analysis
Analysis Browser Features and Options
Handling Changes
Developing Applications in the Team Developer Perspective (Technology Preview)
AMB Endevor Interface (Technology Preview)
Generating Code
Generating from the IDE
Generating from the Command Line
Using the Batch Server
Job Queue Log Management
Compiling in a COBOL project
Administration
Managing Workgroups
Distributed Generation Server
AMBCOMP Program
The WebSphere MQ DGS Interface
Software Requirements
Installing DGS Components
Installing WebSphere MQ
Setting DGS Options
Copy Properties Utilities
How to
Administration
To change the administration password
To copy program properties
To copy application properties
To create a new project
To create a workgroup
To delete a project
To modify a workgroup
To install or update DGS mainframe files
To configure DGS mainframe execution
To set DGS PC options
To start Distributed Generation Server
AMB Endevor Interface (Technology Preview)
To add a single AMB element to Endevor (Technology Preview)
To add all AMB project elements to Endevor (Technology Preview)
To add all AMB folder elements to Endevor (Technology Preview)
To add multiple selected AMB elements to Endevor (Technology Preview)
To retrieve a single AMB element from Endevor (Technology Preview)
To retrieve all AMB project elements from Endevor (Technology Preview)
To retrieve all AMB folder elements from Endevor (Technology Preview)
To retrieve multiple selected AMB elements from Endevor (Technology Preview)
Analysis Option
To generate a project analysis
To generate an application analysis
To generate a rule definition file for an analysis
To set options for the analysis browser
Application Reports
To run an application report
To run the Component List report
To run the DDIFILE report
To run the Field/Screen Cross Reference report
To run the Macro Cross Reference report
To run the Program DB/DC report
To view an application report
Code Generation
To create a configuration XML file
To delete jobs from the Batch Server
To generate an application, all programs, or all screens
To generate from the command line
To generate multiple-map mapsets for CICS applications
To generate a single program or screen
To start the AppMaster Builder console
To start and stop the Batch Server
To use the Job Queue
To view generated code
Data Views
To add a new data view
To add IMS data sources from a PSB file
To browse a generated DDISYMB file
To change the DB2 connection
To create a DB2 connection
To create new data source files in AppMaster Builder
To define a data view
To define or modify a SQL Schema file
To delete a data source file from the project\group subdirectory
To delete a data view
To edit data source files
To edit the SQL objects included in a data view
To filter the data view list
To generate a single data view
To generate multiple data views
To import generated data views
To preview the contents of a data view
To refresh data view sources
To remove a data source type from a data view
To rename a data source file
To set data view properties
To switch to DB2 catalog objects
Online Express
To activate or deactivate Online Express comments
To assign actions to function fields
To assign actions to PF keys
To assign actions to screen events
To create Working-Storage fields in Online Express
To customize database calls in Online Express
To customize predefined actions in Online Express
To define a Savekey
To define a VSAM call in Online Express
To define an explicit Join specification
To define an IMS call in Online Express
To define an SQL call in Online Express
To define Savekey storage
To finalize a Union call in Online Express
To map screen fields in Online Express
To qualify VSAM multiple-key fields in Online Express
To specify an isolation level
To start Online Express
Preferences and Properties
To set AppMaster Builder preferences
To set application properties
To set program properties
To set screen, data structure, and user rule properties
Program Painter
To begin the Procedure Division for batch programs
To begin the Procedure Division for online programs
To code an Environment Division Special-Names statement
To code Identification Division comments in the Program Painter
To code Linkage Section structures
To code Procedure Division comments
To code the Procedure Division
To code Working-Storage structures
To create a User Rule
To customize the Program Painter
To define a DB2 table declaration and cursor declarations
To define a Declaratives section
To define data structures in COBOL format
To define data structures in Data Editor format
To define or redefine the Commarea
To define the Input-Output Section
To include a copyfile
To include a global or local data structure
To specify a report mock-up
To specify multiple reports
To start the Program Painter
To update a User Rule
Projects
To add an existing object to an application
To change projects
To copy an object
To create a data structure
To create a Program Painter program
To create a program stub
To create a User Rule
To create an AMB project
To create an application
To create an Online Express program
To filter programs
To remove or delete an object
To rename an object
To reorder objects under a parent program
To set debug options for an application
To sort programs in the Project Explorer
To specify a workgroup
To update a data structure
To update a User Rule
To view project files
Report Painter
To code a report page description
To code control breaks in reports
To code input-output statements for reports
To code report logic
To code Working-Storage entries for reports
To customize the Report Painter
To define non-printing detail items
To identify a report in Working-Storage
To identify report groups
To map report fields
To map report lines
To paint a report mock-up
To specify a report mock-up
To specify multiple reports
To start the Report Painter
To sum data items in a report
Screen Painter
To align screen fields
To define field attributes
To define screen attributes
To bypass field edits
To change repeated record blocks
To create repeated record blocks
To create system message fields
To define a global error message
To define field edits
To delete a field in a repeated record block
To define a field-specific error message
To delete field edits
To delete repeated record blocks
To delete screen fields
To duplicate screen fields
To modify attributes for a field in a record block
To move repeated record blocks
To paint a Savekey field
To paint a screen
To select multiple fields
To start the Screen Painter
To test screens and fields
To turn off the MDT tag
To use sticky mode
User Areas
To create a user area
To delete a user area
To clean a user area
Reference
cmdgen command
Configuration XML File
XML Header
Configuration XML File Elements
application Element
application Element
applications Element
cmdgen Element
dd Element
dds Element
globals Element
multiple-map-mapset Element
multiple-map-mapset-screen Element
multiple-map-mapsets Element
parm Element
parms Element
program Element
programs Element
screen Element
screens Element
Examples
Control (CNTL) Files
APCICSIN
APDB2IN
APDLGIN
APFEIN
APHLPIN
APIMSIN
APSDBDC
APSPROJ
APVSAMIN
Customizer/Micro Focus Generator (MFG)
Customizer Symbols
Customizer Statements
Customizer Rule Examples
Example - Invoking Rules
Example - % IF Structure
Example - Looping
Example - MFG Structures
Example - Program Location Statements
Example - Rule Compilation Report
MFG command
CARDin
CHARacterS
CompilationDATA
CompilationRePorT
DataDefinition
ERRorOPTion
Help
LANGuage
LeftMARgin
LOGfile
macro
mainIN
MCS
MDB
MDC Option
NewBuiltinWarning
NOoption
PARMin
postsOUT
PREServe
ProjectGroup
PSB
RePorT
RightMARgin
RunMode
SearchMode
TarGeTCOMPiler
TRACE
VERbose
MFG Structures
% * (comments)
% BEGIN
% DECLARE
% DEFINE
% ESCAPE
% IF/ELSE-IF/ELSE
% INCLUDE
% LOOKUP
% REPEAT
% SET BLANK or NOBLANK
% SET COMMUNICATION
% SET DATA
% SET EPILOGUE
% SET ERROR FATAL WARNING INFO
% SET FILE
% SET FILE-CONTROL
% SET LAST-STATUS
% SET LINKAGE
% SET LOCATION structure
% SET LOOP-LIMIT
% SET NORMAL-OUTPUT
% SET OUTPUT-FILE
% SET PROCEDURE
% SET RETAIN-LINE-SUFFIX
% SET RETAIN-LINE-SUFFIX-LEVELS
% SET SECTION
% SET SPECIAL-NAMES
% SET TRACE
% SET TRACEBACK
% SET WATCH
% SET WORKING-STORAGE
% SET WRITE-CONTROL
% UNTIL/WHILE
&columnnumber+source
&variable+suffix
&ABS
&APS-BLANK-STATUS
&APS-ELAPSED-SECONDS
&APS-EPILOGUE
&APS-FULL
&APS-HALF
&APS-INDENT
&APS-LAST-STATUS
&APS-LOOP-LIMIT
&APS-MCS
&APS-MDB
&APS-MDC
&APS-OUTPUT-FILE
&APS-OUTPUT-LOCATION
&APS-PROGRAM-ID
&APS-PSB-NAME
&APS-STATUS
&APS-TASK-MILLISECONDS
&AS-HEX
&CAT
&COMPILETIME
&CONCAT
&DEFINED
&DEFVAL
&ENCODING
&ENTRY
&HEX-AS-NUMBER
&HEX-AS-SIGNED
&HEX-AS-STRING
&HEX-AS-UNSIGNED
&IG-DEBUG-TYPE
&IG-MAJOR-VER
&IG-MINOR-VER
&IG-RELEASE
&IG-TYPE
&IG-VER
&INDEX
&IS-ALPHA
&IS-ALPHANUMERIC
&IS-DECIMAL
&IS-DIGITS
&IS-HEX
&IS-LOWER
&IS-NUMERIC
&IS-PRINTABLE
&IS-UPPER
&LENGTH
&LOW-CASE
&LOWER
&MAX
&MIN
&MOD
&NUM
&NUMERIC
&OPSYS-MAJOR|MINOR-VER
&OPSYS-TYPE
&PARSE
&RANDOM
&SEED
&STRING
&STRLWR
&STRUPR
&SUBST
&SUBST-ALL
&SUBSTR
&TO-LOWER
&TO-UPPER
&UP-CASE
&UPPER
Data Communication Calls
DLG Compatibility with IMS DC, CICS
Program Control Blocks, IO
Program Specification Blocks (PSBs)
ATTR
CIC-ADDRESS
CIC-ASSIGN
CIC-CANCEL
CIC-DELAY
CIC-DELETEQ-TD
CIC-FREEMAIN
CIC-GETMAIN
CIC-LOAD
CIC-READQ-TD
CIC-READQ-TS
CIC-RELEASE
CIC-SCHEDULE-PSB
CIC-SEND-TEXT
CIC-SERVICE-RELOAD
CIC-START
CIC-TERM-PSB
CIC-WRITEQ-TD
CIC-WRITEQ-TS
CLEAR
CLEAR-ATTRS
DLG-ISPEXEC
DLG-ISREDIT
DLG-SETMSG
DLG-VCOPY
DLG-VDEFINE
DLG-VDELETE
DLG-VREPLACE
DLG-VRESET
LINK
MSG-SW
RESET-PFKEY
SCRNLIST
SEND
TERM
TP-BACKOUT
TP-COMMAREA
TP-LINKAGE
TP-NULL
TP-PERFORM
XCTL
Data Structures
66 ...RENAMES
88
OCCURS
REDEFINES
VALUE
Edit Mask Characters
Picture Formats
Database Access Statements
CREATE SUBSCHEMA
DDI Statements
DDI statements - IMS DB
DDI statements - VSAM
D2 Statements
SQL Functions
SQL Column Functions
SQL Scalar Functions
SQL Expressions
Example - Mixed Target
Database Calls
DB-CLOSE
DB-COMMIT
DB-DECLARE
DB-ERASE
DB-FETCH
DB-FREE
DB-MODIFY
DB-OBTAIN
DB-OPEN
DB-PROCESS
DB-ROLLBACK
DB-STORE
DB-SUBSCHEMA
GSAM Calls
GROUP BY HAVING
IMS command codes
Joining Tables
NULL Indicator Field
Special Registers
Subselect Clause
UNION
Date Field Formats
Distributed Generation Server
AMBCOMP Step Return Codes
AMBCOMP SYSIN Cards
AMBCOMP SYSIN Parameter Cards
AMBCOMP Input DD cards
AMBCOMP Input CNTL File DD Descriptions
AMBCOMP Output DD Descriptions
JCL SYSIN Parameters
JCL Example
Output Files and Directories
AppMaster Builder Error Messages
IG- Micro Focus Generator Messages
15 - IG-IGDRVR
15002 INTEGER OVERFLOW EXCEPTION
15202 MEMORY ACCESS VIOLATION EXCEPTION
15203 CTRL+BREAK or CTRL+C EXCEPTION
15204 INTEGER DIVIDE BY ZERO EXCEPTION
15210 EXCEPTION DATATYPE MISALIGNMENT EXCEPTION
15211 EXCEPTION ARRAY BOUNDS EXCEEDED EXCEPTION
15212 EXCEPTION FLOATING POINT DENORMAL OPERAND EXCEPTION
15213 EXCEPTION FLT DIVIDE BY ZERO EXCEPTION
15214 EXCEPTION FLT INVALID OPERATION EXCEPTION
15216 EXCEPTION FLT STACK CHECK EXCEPTION
15217 EXCEPTION FLT UNDERFLOW EXCEPTION
15218 EXCEPTION PRIV INSTRUCTION EXCEPTION
15219 EXCEPTION IN PAGE ERROR EXCEPTION
15220 EXCEPTION ILLEGAL INSTRUCTION EXCEPTION
15221 EXCEPTION STACK OVERFLOW EXCEPTION
16 - IG-PARSE
16100 ERR SYNTAX ERROR
16101 ERR SYNTAX ERROR NEWLINE
16201 ERR INVALID SYN ERROR TYPE
16202 ERR INVALID TYPE FOR DECL VAR
16203 ERR INVALID ARITH OP
16204 ERR MAX OPCODES EXCEEDED
16205 ERR INVALID RELATIONAL OP
16208 ERR INVALID SET
16209 ERR INVALID EVAL BRACKET
16210 ERR INVALID EVAL BRACKET AUX
16211 ERR EVAL BRACKETS NOT SET
16212 ERR EVAL BRACKETS AUX NOT SET
16213 ERR INVALID LEFT MARGIN
16214 ERR INVALID RIGHT MARGIN
16215 ERR INVALID SET MSG
16216 ERR DUPLICATE FORMAL ARG
16217 ERR UNABLE ALLOC PCODE
16218 ERR INVALID ASSIGN OP
16219 ERR UNSUPPORTED SET
16220 ERR FOOLMAC NOT SPECIFIED
16221 ERR NEW BUILTIN WARNING
16300 ERR STMT STACK NOT EMPTY
16301 ERR HEAD STACK NOT EMPTY
16302 ERR TAIL STACK NOT EMPTY
16303 ERR EXPR STACK NOT EMPTY
16304 ERR ARG STACK NOT EMPTY
16305 ERR STACK UNDERFLOW
16306 ERR IP TREE INIT FAILED
16400 ERR INVALID SYMBOL TYPE
16401 ERR TOO MANY SOURCE SYMBOLS
16500 ERR INDIR TAB MAX EXCEEDED
16600 ERR OPENING REPORT DATA FILE OUTPUT
16601 ERR OPENING REPORT DATA FILE INPUT
16602 ERR OPENING REPORT PRINT FILE
16603 ERR EMPTY REPORT DATA FILE
16604 ERR NOT ENOUGH MEMORY FOR REPORT
16605 ERR IND TAB MAX REACHED
16700 ERR SYNTAX ERRORS FOUND
17 - IG-PARM
17000 ERR INVALID PARM OPTION
17001 ERR DUPLICATE PARM OPTION