Micro Focus Enterprise Developer 7.0 for Visual Studio 2017
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
.NET Core Support
Assembler Support
CICS Support
COBOL Language
Code Analysis
Code Set Support
Compiler Directives
Containers Support
Database Access - HCOSS Manage Connections Tool
Database Access - MBDT Utilities
Database Access - OpenESQL
Data File Tools
Enterprise Server
Enterprise Server Common Web Administration (ESCWA)
Enterprise Server for .NET
Enterprise Server Security
IMS Support
JCL Support
Library Routines
Licensing
Mainframe Access (MFA)
The Micro Focus Database File Handler
The Micro Focus Unit Testing Framework
PL/I Support
Visual Studio Integration
Features Added in Enterprise Developer 6.0
.NET Core
Building Applications
CICS Support
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
Enterprise Server
Enterprise Server for .NET
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
Visual Studio Integration
What was New in Enterprise Developer 5.0
.NET Core Support
Amazon Web Services Quick Start for Enterprise Server
COBOL Formatting
Code Analysis
Enterprise Server and Scale Out Architecture
Enterprise Server Common Web Administration
CICS Support
COBOL Language Enhancements
Compiler Directives
Consolidated Trace Facility (CTF)
Data File Tools
Database Access
Debugging
Enterprise Server for .NET
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
Visual Studio Integration
Features Added in Enterprise Developer 4.0
Features Added in Enterprise Developer 3.0
Significant Changes in Behavior or Usage
New Customers: Where do I start?
New to Visual Studio
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
Want to deploy an application
Upgrading from Mainframe Express
Upgrading from Net Express
Upgrading from Server Express
Upgrading from Studio Enterprise Edition
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
Differences between Enterprise Developer and Earlier Micro Focus Products
Overview of the Differences
Tips: Visual Studio IDE Equivalents to IDE Features in Earlier Products
Upgrading from Net Express to Enterprise Developer
An introduction to the process of upgrading your COBOL applications
Compile at the Command Line Using Existing Build Scripts
Debugging Without a Project
Create a project and import source
Using Enterprise Developer for Visual Studio
Change the Defaults to Replicate Your Existing Project Structure
Best Practice in Enterprise Developer Development
Modernize Your Applications and Processes
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
Mainframe Express Functionality That Works Differently in Enterprise Developer for Visual Studio
Upgrading from Studio Enterprise Edition (Windows)
Best Practice in Enterprise Developer Development
Modernize Your Applications and Processes
Upgrading from Server Express and Studio Enterprise Edition (UNIX)
Differences between Enterprise Developer and Net Express and Mainframe Express
Summary of Differences
Backward Compatibility with Earlier Micro Focus Products
Backward Compatibility with Previous Versions of Visual Studio
Compiling and Building Differences
Output File Formats
Compiler directives
Linking
Called Programs and Dependencies
File Handler
OpenESQL Assistant
SQL Compiler Directive Options
XML PARSE Statement
Run-time System Differences
OpenESQL
Single-Threaded Run-Time System
Static-Linked Run-Time System
Enterprise Developer Co-existing with Earlier Micro Focus Products
Restrictions and Unsupported Features
CBL2XML Utility
DBMS Preprocessors
Form Designer
Host Compatibility Option (HCO)
INTLEVEL Support
NSAPI
Online Help System
OpenESQL
SQL Option for DB2
Run-Time Technology Differences
Dialog System
File Handling
Test Coverage
Editing and Debugging Differences
Interface Mapping Toolkit
Mixed Language Debugging
Program Breakpoints
Remote Debugging
Source Pool View
Tips: Visual Studio IDE Equivalents to IDE Features in Earlier Products
Upgrading from ACUCOBOL-GT
Upgrading from RM/COBOLĀ®
Getting Started
Enterprise Developer Editions and Activating Licenses
To buy and activate a full license
To obtain more licenses
Enterprise Developer Tutorials Guide
Mainframe Tutorials
Getting started with Enterprise Developer
Starting the Visual Studio Integrated Development Environment
Adding files to your Visual Studio project
File, Project and IDE Properties and Settings
Editing COBOL, JCL, BMS, and Data Files
Compiling the Source Code
Unit Testing the Batch Application
Unit Testing the Online Application
Debugging the Batch Application
Debugging the Online 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 CWSDEMO Enterprise Server Region, WSDL
Test the Reverse Web Service Provider
Tutorial: CICS Web Service Requester from WSDL, Top-down Method
Generate InvokeReverse Requester Components
Add Operation Logic to invkRev.cbl
Build the invkRevCICSClientApp Project
Update the CWSDEMO 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 CWSDEMO 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 CWSJSON Enterprise Server Region
Test the ReverseJSON Web Service Provider
Tutorial: CICS Web Service Requester from JSON, Linkable Interface Top-down Method
Generate InvokeReverseJSON Requester Components
Add Operation Logic to the invkRevJ.cbl Program
Update the CWSJSON Enterprise Server Region
Test the invkRevJ Web Service Requester
Tutorial: CICS Web Service Provider from JSON, Request-Response Bottom-up Method
Set Up the LoanJSON Project
Generate LOANPAYM Web Service Components
Update the CWSJSON Enterprise Server Region
Test the loanPaym Web Service Provider
Tutorial: CICS Web Service Provider from JSON, RESTful
Set Up the BookREST Project
Generate BookREST Web Service Components
Add Operation Logic to BookREST
Set Up the CWSREST Enterprise Server Region
Test the Book 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 Visual Studio
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
Bind the TwoPackageSet Program
Run the TwoPackageSet Application
Duplicate the Process for the MTwoPackageSet Project
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
Duplicate the Process for the MLBLDURATION Project
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
Duplicate the Process for the MFunctionEmulation Project
Tutorials: Calling SQL CLR Stored Procedures in an SPD File
Tutorial: Prepare the SQL CLR Environment
Enable SQL CLR Integration
Create the SQLCLR_Test Database
Create an ODBC 32-bit System Connection
Build the ODBC XA Switch Module
Import 32-bit JCL Enterprise Server Regions
Tutorial: SQL CLR Stored Procedures - Call a Stored Procedure Defined in an SPD File
Set Up the SQLCLRTutorialSPCall Solution - Call from SPD File
Set Up the JCLSP Enterprise Server Region
Debug the Program and Stored Procedure - SQLCLRTutorialSPCall
View JCL Execution Results - SQLCLRTutorialSPCall
Tutorial: SQL CLR Stored Procedures - Call a Stored Procedure Defined in an SPD File using Group Variables
Set Up the SQLCLRTutorialSPGroupCall Solution - Call from SPD File using Group Variables
Set Up the JCLSPG Enterprise Server Region
Debug the Program and Stored Procedure - SQLCLRTutorialSPGroupCall
View JCL Execution Results - SQLCLRTutorialSPGroupCall
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
Tutorials: Interface Mapping Toolkit (IMTK) - Mainframe
Tutorial: CICS Screen Web Service
Create and Configure CICSEXT
Set Up and Run the ACCT Application
Create and Populate the CICSScreenWS Project
Create the ACCTWS Service Interface
Define ACCTWS Operations
Create and Configure a deploy Directory
Deploy the ACCTWS Service Interface
Generate Console and Windows Forms Clients
Run the ACCTWSWinApp and ACCTWSClientApp Clients
Tutorial: CICS COMMAREA Web Service
Create and Build the CICSCommareaWS Project
Create and Configure the CICSCA Enterprise Server Region
Create the COMMWS Service Interface
Define COMMWS Operations
Deploy the COMMWS Service Interface
Generate Console and Windows Forms Clients
Run the COMMWSWinApp and COMMWSClientApp Clients
Tutorial: IMS Screen Web Service
Configure IMSDEMO for an IMS Web Service
Create the IMSScreenWS Service Interface
Deploy the IMSScreenWS Service Interface
Generate Console and Windows Forms Clients
Register the Proxy Library
Run the Clients
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: Open PL/I
Creating Your First Hello PL/I World Application
Tutorial: Debug the Hello PL/I World Application
Tutorial: Developing an Open PL/I Application Using Visual Studio
Overview
Create a Solution and a Project
Change the Fonts and Colors
Add a Program to the Project
View the Project and Source File Properties
Build the Project
Run the Program
View errors and warnings
Add Include Files
Rebuild the project
Tutorial: Accessing IBM WebSphere MQ features using PL/I programs
Overview
Prerequisites
WebSphere MQ and PL/I installation and usage notes
Import and Configure the Enterprise Server instance
Create a test queue
Start the enterprise server
Build and execute the sample application
Using the Rumba Screen Designer
Native COBOL Tutorials
Tutorial: Creating Your First Hello COBOL World Application
Tutorial: Configuring the Hello COBOL World Application
Tutorial: Debugging the Hello COBOL World Application
Tutorial: Creating a Native COBOL Application
Tutorial: Debugging COBOL Applications Remotely
Tutorial: Running Unit Tests in the IDE
Tutorial Getting Started
Creating a Unit Test Library Project
Running the Test
Running the Test Under Code Coverage
Enhancing the Test
Debugging the Failed Test
Fixing and Rerunning the Failed Test
Running the Enhanced Test Under Code Coverage
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 COBOL and WPF Clients
Run the WPF 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 COBOL and WPF Clients
Run the WPF Client
Tutorial: REST Web Service using CORS and AJAX
Set Up the ProgramCORS Project
Create the AccessBooks Service Interface
Define AccessBooks Operations
Set Up the ESCORS Enterprise Server Region
Deploy the AccessBooks Web service
Access the AccessBooks Web Service via an AJAX Request
Tutorial: JSON RESTful Web Service using API Resources
Set Up the ProgramRESTAPI Project
Create the CarTracker Service Interface
Generate CarTracker Operations
Set Up the ESRSTAPI Enterprise Server Instance
Deploy the CarTracker Web Service
Generate the CarTrackerClientApp COBOL Client
Run the CarTrackerClientApp Client
Tutorial: Data File Editor
Import and Build the Sample Project
Start Data File Tools
View the Data File Unformatted
Create a Record Layout
View the Data File Formatted
Filter the Data File
Edit a Record
Create a New Data File
Create a New Record
Insert a Record
Delete a Record
Tutorial: Classic Data File Tools
Copy and Build the Visual Studio Solution
Convert a File
View a Data File Unformatted
Create a Record Layout File
Create the Default Record Layout
Create the Conditional Record Layouts
Save the Record Layout File
View a Data File Formatted
Access Information about a Record Layout File
View Files in Hexadecimal
Print a Data File
Edit Multiple Data Files
Create a New Data File
Convert a File's Character Set
View the EBCDIC File
Tutorial: Using the Callable File Handler
Tutorial
Create a Test 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
Tutorials: SQL CLR Stored Procedures Called via COBOL and JCL
Tutorial: Prepare the SQL CLR Stored Procedures Environment
Enable SQL CLR Integration
Create the SQLCLR_Test Database
Create an ODBC 32-bit System Connection
Build the ODBC XA Switch Module
Import 32-bit JCL Enterprise Server Regions
Tutorial: Call a SQL CLR Stored Procedure Single-project by Literal
Set Up the SQLCLRTutorialSPCall Solution - Single-project Literal
Set Up the JCLSPSL Enterprise Server Region
Debug the SPCall Program and SP1 Stored Procedure - Single-project Literal
Tutorial: Call a SQL CLR Stored Procedure Single-project by Data Name
Set Up the SQLCLRTutorialSPCall Solution - Single Project by DataName
Set Up the JCLSPSDN Enterprise Server Region
Debug the SPCall Program and Stored Procedure - Single Project by DataName
Tutorial: Call a SQL CLR Stored Procedure Multi-project by Literal
Set Up the SQLCLRTutorialSPCall Solution - Multi-project Literal
Set Up the JCLSPML Enterprise Server Region
Debug the SPCall Program and Stored Procedure - Multi-project Literal
Tutorial: Call a SQL CLR Stored Procedure Multi-project by Data Name
Set Up the SQLCLRTutorialSPCall Solution - Multi-project Data Name
Set Up the JCLSPMDN Enterprise Server Region
Debug the SPCall Program and Stored Procedure - Multi-project Data Name
.NET COBOL Tutorials
Tutorial: Developing .NET COBOL Applications
Tutorial: Creating Windows Forms in COBOL
Tutorial: Developing Web Application Projects
Tutorial: Creating and Accessing WCF COBOL Services
Tutorial: Publishing Hello COBOL World to the Cloud
Tutorials: OpenESQL .NET Code
Tutorial: Prepare the SQL Server Environment
Set Up the BookDemo Database
Create an ADO.NET Connection to BookDemo
Tutorial: WCF COBOL Service using SQL
Set Up the SqlBookWCF Solution
Configure and Test the WCF Service Library
Add the SqlClientWCF Client Project
Configure and Run the SqlClientWCF Client
Tutorial: Object-Oriented WCF COBOL Service using SQL
Set Up the OOSqlBookWCF Solution
Configure and Test the OO WCF Service Library
Add the OOSqlClientWCF Client Project
Configure and Run theOOSqlClientWCF Client
Tutorial: Web Application using SQL
Set Up the SqlBookDemoWebApplication Solution
Code the Web Page
Build and Run the Web Application
Tutorial: Object-Oriented Web Application using SQL
Set Up the OOSqlBookDemoWebApplication Solution
Code the OO Web Page
Build and Run the OO Web Application
Tutorial: OpenESQL Assistant
Create the OESQLDemo SQL Server Database
Set Up the OESQLAsst Project
Set the OpenESQL Assistant Type COBOL Variable
Catalog a Connection using the ADO.NET Connection Editor
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
Tutorials: SQL Server COBOL Stored Procedures
Tutorial: Prepare the SQL Server COBOL Environment
Enable SQL CLR Integration
Create the SQLCLR_Test Database
Set Up the SQLServerSP Database Project
Tutorial: Construct and Execute a SQL Server COBOL Stored Procedure
Construct a SQL Server COBOL Stored Procedure
Publish the LookupEMP Stored Procedure to SQL Server
Debug and Execute the LookupEMP Stored Procedure
Call the LookupEMP Stored Procedure from COBOL
Prepare to Debug LookupEMP in a Development Environment
Debug LookupEMP in a Development Environment
Tutorial: Generate a COBOL Wrapper for a SQL Server COBOL Stored Procedure
Technology Preview Features
EAP Features
Samples Browser
To start the Samples Browser
To build the Samples Browser demonstration
Demonstrations of .NET COBOL
Demonstrations of Native COBOL
Product Information
Supported Operating Systems and Third-party Software
Additional Software Requirements
.NET COBOL Applications
.NET Core
Application Server JCA support for Enterprise Server
CICS Web Services
COBOL on Microsoft Azure
Code Analysis
Database Management Systems (DBMSs)
Interface Mapping Toolkit (IMTK)
JCL
Mainframe Access - Endevor Support
Mainframe Terminal Emulation
MFFTP Utility
Performance Availability Clusters (PACs)
Windows Forms
Installation
Supported Operating Systems and Third-party Software
Additional Software Requirements
.NET COBOL Applications
.NET Core
Application Server JCA support for Enterprise Server
CICS Web Services
COBOL on Microsoft Azure
Code Analysis
Database Management Systems (DBMSs)
Interface Mapping Toolkit (IMTK)
JCL
Mainframe Access - Endevor Support
Mainframe Terminal Emulation
MFFTP Utility
Performance Availability Clusters (PACs)
Windows Forms
Before Installing
Downloading the Product
On Windows
System Requirements
Hardware Requirements
Operating Systems Supported
Software Requirements
Product Co-Existence
Installation Restrictions and Requirements
On UNIX
Hardware Requirements
Operating Systems Supported
Software Requirements on UNIX
Installing on UNIX and Linux
Basic Installation
Installing
Installing on UNIX
Advanced Installation Tasks
On Windows
Installing as an Upgrade
Enterprise Developer Installation Options
Microsoft Package Dependencies
Installing into Several Editions of Visual Studio
Installing Enterprise Developer in an Offline Environment
Installing from a Server
Windows Compatibility Mode
Installing and Licensing Micro Focus Rumba+ Desktop
On UNIX
Installing as an Upgrade
UNIX Installation Options
Installing Without Superuser Credentials
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
Installing on Microsoft Terminal Server and Citrix
Customizing the Installation and the Projects
Enterprise Server Installation Options
Configuring SQL Option for DB2 (XDB) for Multi-User Environments
Creating a Private XDB Configuration File in a Multi-User Environment
Changing the Main XDB Server Configuration File
Changing the Private XDB Server Configuration Files in Batch
Configuring Other Components
After Installing
On Windows
Starting the Product
Managing the Microsoft Build Tools and Windows SDK Packages
The Microsoft Build Tools and Windows SDK Configuration Utility
Viewing the Product Help
Repairing
Uninstalling
On UNIX
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
Installing a standalone network license server
Installing on Windows
Standard installation
Silent installation
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
Updates and Product Support
Micro Focus End User License Agreement
Additional License Authorizations for Visual COBOL & Enterprise software products
Known Issues and Restrictions
.NET Core
Application Server JCA Support
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
Containers
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 Visual Studio
Test Coverage
Documentation Considerations
Issues with Enterprise Server
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
Micro Focus Rumba
PL/I Support
Run-time Behavior
Issues with SQL Option for DB2
Restrictions in the Micro Focus Unit Testing Framework
.NET COBOL Applications - Known Issues and Restrictions
ASP.NET
Issues with File Handler
Language Service
OpenESQL
Security Considerations
Printer Redirection
Web Reference Generation
XML Extensions
Visual Studio Integration
Background Syntax Checking (Known Issues)
Issues with Building Applications
Dialog System
Expanded Copybook View
Issues with Find All References
Issues With the Fonts and Colors Dialog Box
Formatting COBOL Code (Known Issues)
Importing Net Express Projects
Issues with the IntelliSense Support for COBOL
Open Folder Support - Restrictions
Service Interfaces - Restrictions
Restrictions in Refactoring
Standalone Files
Visual Studio
Issues with the Visual Studio Help Viewer
Issues With Visual Studio Team System
Windows Communication Foundation (WCF) - Limitations
Contacting Micro Focus
Further Information and Product Support
Information We Need
Contact information
The Micro Focus Community
Help on Help
Developing Applications in the IDE
Starting Enterprise Developer
To start Visual Studio
To start Enterprise Developer as an administrator
To start an Enterprise Developer command prompt
To start an Enterprise Developer command prompt as an administrator
Overview of Creating Applications
COBOL Development
Introduction to COBOL Development in Visual Studio
To install missing features from the IDE
Quick Tips on Editing, Building and Debugging
Document Your Types, Members, and Namespaces with Comments in the Code
Editing COBOL Applications
Projects Created with Earlier Enterprise Developer Releases
Moving Existing Native COBOL Applications to Enterprise Developer
Converting Additional Directives to Project Properties
Relink Applications
Working with Projects
Types of COBOL Project Templates
To add files to a COBOL project
To add a folder to the project's Dependency Paths
Exploring Your COBOL Projects and Solutions
Solution Explorer
Project Details Window
Object Browser
Expanded Copybook View
Viewing the Copybook Graph
Creating Projects from Existing Code
Converting Net Express Projects to Visual Studio Projects
To import a Net Express project into the Visual Studio IDE
Create Projects from Existing Code Wizard
To create a COBOL project from existing code
Creating a New Project From Files in an Existing Project
To create a new COBOL project from selected files in an existing project
Creating Projects from Standalone Files
Creating and Distributing Custom COBOL Project Templates
Editing COBOL Projects with Different Versions of Visual Studio (Project Round-Tripping)
Configuring Properties
Overview of COBOL Project Properties
Configuring Visual Studio
AutoCorrect
COBOL Debugging Options
Code Analysis Options
Code Analysis - Data Flow Analysis Options
Code Analysis - Program Flow Graph Options
Code Cleanup Options
Code Coverage General Options
Code Coverage - Report Content Options
Code Coverage - Results File Options
Customizing the BMS Editor in the IDE
BMS Text Editor General Page
BMS Editor Margins and Text Casing Options
BMS Editor Scroll Bars
BMS Text Editor Tab Page
Data File Tools
Configuring IntelliSense for COBOL - Completion Lists
Configuring IntelliSense for COBOL - Insertion
Enterprise Server Configuration Options
Indentation - Environment Division
Formatting Options - Data Division
Formatting Options - Identification Division
Formatting Options for the Indentation in the Procedure Division
Line Numbering Options
Compiler Directives For COBOL Files
Text Editor Advanced Options
Text Editor Formatting Options
Text Editor General Options
Text Editor Snippets Options
General Project Options
Configuring the Profiler Reports
Quick Actions
Scroll Bars
Standalone editing
Standalone Editing - General Directives
Standalone Editing - Program Symbols
Text Casing Options
Text Editor Tabs Options
Text Editor Margins Options
TN3270 Display Options
Web Service Clients Options
Transferring Visual Studio Settings
Sharing Code Style Settings with an EditorConfig File
Project Properties
Application Properties for .NET COBOL
Application properties for native COBOL
Assembler Properties
BMS Properties
COBOL Link Page
COBOL Properties
Micro Focus Code Analysis
Dependency Paths
Container Project Properties
Debug Properties
Enterprise Server Folder Properties
Enterprise Server Debug Folder Properties
IMS Properties
Namespaces
Preprocessor Properties
SQL Properties
To set COBOL project properties
To specify file properties
To reset the file properties
To configure how the IDE determines the Compiler directives of files
To automatically determine and set directives on COBOL files
To add references to a .NET COBOL project
Working with the Editor
COBOL Editor Features
Configuring the Editor
Configuring IntelliSense for COBOL - Completion Lists
Configuring IntelliSense for COBOL - Insertion
Configuring the COBOL Margins
Configuring the Indentation
Configuring the Ruler
Configuring Word Wrap with Smart Edit Mode
Customizing the Behavior of Home and End Keys
Customizing the Text Fonts and Colors
IntelliSense for Efficient Coding
Inserting Code Snippets
To insert a snippet in your code
Shortcuts for the COBOL Snippets
Shortcuts for the Mainframe Subsystem Code Snippets
To create a custom COBOL snippet
CodeLens
Applying Code Style Preferences
Formatting COBOL code
To specify COBOL formatting options
To format COBOL source code
To format COBOL source code with Code Cleanup
Line Numbers (Renumber and Unnumber)
To specify line numbering options
To number or renumber lines in source code
To remove line numbers from source code
Overriding the Members of an Inherited Class
Quick Actions for Efficient Coding
Editor Quick Action: Converting .NET Types to Portable COBOL Syntax
Editor Quick Action: Creating a Copybook from Selected Lines of Code
Editor Quick Action: Creating or Finding a Missing Copybook
Editor Quick Action: End of Scope Termination
Editor Quick Action: Extract to Section
Editor Quick Action: Generate Missing Section or Paragraph
Editor Quick Action: Implementing Unimplemented Interfaces
Editor Quick Action: Import a Namespace with $SET ILUSING
Editor Quick Action: Sort the ILUSING Statements
Editor Quick Action: Remove or Comment Out Dead Code
Editor Quick Action: Rename Refactoring
Editor Quick Action: Simplifying the Names of Types
Working with Files
To associate file extensions with COBOL
To specify that a file extension is a copybook
Grouping Files in Solution Explorer
To toggle Virtual View
To create a custom virtual folder
To add files to a new virtual folder
To modify a virtual folder
To delete a virtual folder
Working in Open Folder Mode
Opening a Folder in Visual Studio
Specifying Compiler Directives for the Open Folder Mode
Compiling Files in Open Folder Mode
Debugging Files in Open Folder Mode
Using Source Control in Open Folder Mode
Moving to Projects From Open Folder Mode
Building COBOL applications
Tips on building COBOL
Build Configuration
Compiling COBOL Applications
Compiling COBOL code
Executable file formats
Setting Compiler directives for COBOL
Setting project-wide build properties and Compiler directives
Setting Compiler directives on individual files
Setting Compiler directives from the command line
Setting Compiler directives using a response file
Setting Compiler directives in source code
Setting Compiler directives in a directives file
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
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
How To in the IDE
To build a COBOL project
To embed resources in a native COBOL application
To add an application configuration file
To add a resource script file to your native COBOL project
To edit a resource-definition script file for a native COBOL project
To set an entry point for a native COBOL project
To Set Compiler Directives on a COBOL File
To compile individual files
To link a native COBOL project to the run-time system
Code Analysis
Micro Focus Code Analysis Window
Rule-Based Analysis
Performing Code Analysis when Building a Project 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 and Graph
Code Analysis - Data Flow Analysis Options
Program Flow Graph
To display a Program Flow Graph
Using the Program Flow Graph
Code Analysis - Program Flow Graph Options
Using COBOL Source Information
Introduction to COBOL Source Information
To run a CSI query
Unreferenced Data
Undeclared Procedures
Copybook Structure
Program Statistics
Unexecuted Procedures
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
Code Refactoring
Rename Refactoring
Creating Copybooks from Selected Lines of Code
Refactoring Using Quick Actions
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
Debugging COBOL Applications
Debugging Native COBOL Scenarios
Starting the debugger automatically
Starting the debugger automatically using library routines
Starting the debugger automatically using just-in-time debugging
Debugging Using a Core Dump
Debugging Using COBOL Watchpoints
Debugging Native COBOL Link Library Projects
Debugging CICS Channels and Containers
Debugging Windows Services
Remote Debugging
Debugging .NET COBOL Scenarios
Debugging Asynchronous .NET COBOL Code
Debugging .NET COBOL Applications Remotely
Debugging on Enterprise Server Scenarios
Dynamic Debugging on Enterprise Server
Additional Debugging Features with Enterprise Server
Debugging Features and Techniques in Visual Studio
Tips on Debugging COBOL
Debug Profiles
Autos Window
COBOL Visualizer
Debug Tooltips
Memory Window
Watch Window
CICS Channels Window
How To
To attach to a running native COBOL process and debug
To attach to a native COBOL process running remotely
To configure the symbol path for native COBOL applications
To configure an enterprise server instance to produce a core dump
To debug files without a project
To debug a native COBOL project that compiles to multiple executables
To debug using a core dump
To debug a multi-project solution
To debug a native COBOL program running remotely
To debug on Enterprise Server
To debug on a remote Enterprise Server
To debug using a temporary enterprise server
To edit data in a writable CICS container while debugging
To enable a core dump using a library routine
To enable core dumps using run-time tunables
To enable just-in-time debugging
To launch a debug process using Wait for debuggable attachment
To prepare for debugging
To prepare for debugging on Enterprise Server
To set a COBOL watchpoint in native COBOL code
To set program breakpoints in native COBOL
To set up remote debugging for native COBOL applications
Reference
cblcored utility
cobdebugremote
cobdebugremote64
Running Applications (Native COBOL)
Configuring the Run-time Behavior for Native Applications
Application Configuration File
Run-time Configuration for Intermediate and Generated Code
To configure the run-time behavior for native applications
Code coverage (native COBOL)
Enabling code coverage
Running an application with code coverage
Viewing the code coverage information
Code coverage HTML reports
Configuring the code coverage HTML reports
Code Coverage and Profiling (.NET COBOL)
COBOL Applications for Microsoft Azure
Introduction to COBOL on Microsoft Azure
Microsoft Azure System Requirements and Levels of Support
Tutorial: Publishing Hello COBOL World to the Cloud
Demonstration Programs for COBOL on Microsoft Azure
Preparing a COBOL Application for Microsoft Azure
Cloud Template and Skeleton Roles and Projects
Copying Data to Microsoft Azure
How to Create and Publish a COBOL Service for Microsoft Azure
To Create a COBOL Microsoft Azure Service and Roles
To Develop a COBOL Azure Service
To Configure a Service and Storage for Microsoft Azure
To transfer files to the Azure storage
To Debug a COBOL Microsoft Azure Service Locally
To Publish a COBOL Service to Microsoft Azure
To Run Visual Studio as Administrator
Using the Consolidated Tracing Facility on Microsoft Azure
Specifying Microsoft Azure-specific Emitters
BINSTORAGE Emitter Properties
TEXTSTORAGE Emitter Properties
Updating Microsoft Azure Role Configuration Files
Adding References to Tracing-related .dll Files
Downloading Trace Information
Viewing Trace Information
Microsoft Information on Microsoft Azure and the Cloud
COBOL Applications for .NET Core
Introduction to Developing COBOL Applications for .NET Core
Introduction to .NET Core project files
Upgrading .NET Core project files from versions of Enterprise Developer before 7.0
Comparing .NET Core and .NET Framework
Creating a .NET Core Project
Building a .NET Core Project
Debugging a .NET Core Project
To debug a .NET Core application running on Linux
Publishing a .NET Core Project
Different Types of .NET Core Deployment
To publish a .NET Core project using the IDE
Building COBOL Applications for .NET Core Using the Command Line
Before Creating a .NET Core Project Using the Command Line
Installing the .NET Core Project Templates
Creating a .NET Core Project Using the Command Line
Building a .NET Core Project Using the Command Line
Running a .NET Core Project Using the Command Line
To publish a .NET Core project using the dotnet command line
To publish a .NET Core project using the msbuild command line
SQL Support for .NET Core Projects
Configuring a .NET Core Project for SQL Support
Supported .NET Core Providers
Sample SQL ADO Connection Strings for .NET Core
Working with a Large Code Base
Benefits of Using Visual Studio Projects
Accessing Source Code Without a Project
Configuring Visual Studio Projects
Optimizing the Performance of the IDE
Specifying Build Settings
Building Applications in the IDE
Building From the Command Line Using a Project File
Best Practice When Upgrading a Legacy Application
Steps to Upgrading Your Application
Using Enterprise Server from within the IDE
Specifying IDE configuration options for Enterprise Server
Enterprise Server templates
Managing Enterprise Server Regions from Server Explorer
To provide and manage the credentials of enterprise server regions
To view the available servers and their credentials
To export an enterprise server instance
To import an enterprise server
To start, stop, or restart an enterprise server from the IDE
To filter the servers
To refresh the list of the available servers
To display an enterprise server log inside the IDE
To configure the run-time environment
To connect to a remote enterprise server
To create a new enterprise server
To delete an enterprise server
To associate an enterprise server with a project
To open the ESCWA UI from the IDE
Viewing CICS Resources
To view the CICS Resources
Accessing CICS Resources in the IDE
Viewing the Spool and Catalog
To show the JCL spool queues
Spool Window
To show the JCL catalog
Catalog Window
To open a file from the local catalog
Using Solution Explorer with Enterprise Server
To create a new Enterprise Server for a project
To view the CICS Resources
To create a new PCT resource for a COBOL program
To submit a JCL file
PL/I Development
Tips and Tricks with the IDE for PL/I
To start Visual Studio
To start Enterprise Developer as an administrator
Making the Most Out of the PL/I Editor
Configuring the IDE for PL/I Development
Options for Setting Compiler Directives on PL/I Files
Transferring Micro Focus Settings
PL/I Text Editor Advanced Page
PL/I Text Editor General Page
PL/I Text Editor Margins Page
PL/I Text Editor Scroll Bars Page
PL/I Text Editor Tab Page
Working with PL/I Solutions, Projects and Files
To create a new PL/I project
To open an existing PL/I project
To specify PL/I project properties
To create a new file and add it to a project
To add an existing file to a PL/I project
To edit a PL/I file
Making the Most Out of the PL/I Editor
Linking PL/I Programs
Building PL/I Projects
To configure the build output
To build a PL/I application
To compile individual PL/I files
Debugging PL/I Projects
To prepare a PL/I application for debugging
To debug using Visual Studio
To debug a PL/I Mainframe Subsystem Application running on Enterprise Server
Tips on Debugging PL/I
Known Issues and Restrictions
Catching signals and PL/I conditions using environment variables
Running PL/I Applications
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
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 Build Tools for Windows to Build .NET Core Projects
Using Enterprise Developer with Containers
Introduction to Containers
Benefits of Using Containers
Container Terminology
Getting Ready to Use Enterprise Developer with Containers
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
How to work with native COBOL applications in containers
To add a Dockerfile to a native COBOL project
To debug or run a native COBOL application in a container
To build an image for deployment
Debugging and Running .NET COBOL Applications in Containers
Building a .NET 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 .NET COBOL Application in a Container
To start debugging a .NET COBOL application that is not yet running in a container
To start debugging a .NET COBOL application that is already running in a container
Debugging .NET COBOL Applications Running in Containers
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 programs from .NET COBOL projects
Calling a Program Using an Implicit Program Name
Calling a Program Using an Explicit Program Name
Calling Entry Points in Subprograms
Calling Programs According to How They Are Linked
State of the Data when a Program is Called Again
Search Conventions Used for Calling Programs
Passing Parameters to a Called Program
Passing Return Codes Back to the Calling Program
Call Prototypes
About Call Prototypes
The ANY Keyword
Relaxed Type-checking
Using Type Definitions
Using the Library Routine Type Definitions and Call Prototypes
.NET COBOL Programming
Native COBOL Compared to .NET COBOL
Introduction to Object-Oriented Programming for COBOL Developers
Moving Native COBOL Applications to .NET COBOL
Why Move to .NET COBOL Code?
Considerations When Moving to .NET COBOL
Writing Multi-User Applications
Accessing Procedural COBOL From .NET COBOL Code
Example of Using a .NET COBOL Wrapper Class
Example of Using the ILSMARTLINKAGE Compiler Directive
64-bit applications in the .NET environment
Multiple user COBOL applications in .NET
Background to multiple run units and .NET
Demonstration of a Multiple Run Units Application
Run the MultiRunUnits Demonstration
Walkthrough the MultiRunUnits Demonstration
Developing an application for multiple run units in .NET COBOL
Printing Performance for .NET Deployed COBOL Applications
Code Page Conflicts in .NET COBOL
Avoiding Code Page Conflicts in .NET COBOL
Example of Code Page Conflicts in .NET COBOL
Interoperability
Overview of Interoperability
Data Marshaling and Type Conversion for .NET COBOL Interoperation
Type Compatibility in Interoperation with Managed Code
Exposing COBOL Linkage Data as Managed Types
Type Mappings from Native COBOL to .NET COBOL Code
Write a Proxy or Edit the COBOL for .NET Interoperation?
Examples of Compatible Types for Native and .NET COBOL
Compatible Types Example in .NET COBOL Interoperation
Group Items Example in .NET COBOL Interoperation
Occurs Clause Example in .NET COBOL Interoperation
Calling a .NET Class from Native COBOL, Using CCW
Calling a Native COBOL COM Object, Using RCW
Platform Invoke and Calling Native COBOL
Calling Native Code Dynamically
PInvoke Example
Callable Attribute in .NET COBOL Interoperation
Web Application Development with COBOL
Building Service-Oriented Applications with WCF and 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
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
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
Generating Web Services and Clients from WSDL or JSON
Generated Web Service Components
Generated COBOL Client Components
Handling Variable Arrays in WSDL and JSON - Native COBOL
Clients
Generating Clients
Working with Clients
COBOL Console Client
WPF Client
Windows Forms Client
ASP.NET Client
JSP Client
How to
Manage IMTK Projects
To configure the run-time environment
To create a project for COBOL program-based service interfaces
To create a COBOL program-based service interface
To import a COBOL program service interface
To modify the CLASSPATH property for an EJB service interface
To update service interfaces with source code changes
To set client generation options
To validate a service interface
Define Service Interfaces
To assign a value to a COBOL field
To create a COBOL program-based operation
To create a reusable field
To create an interface field
To edit field properties
To 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 build an ASP.NET client
To install a deployment package using mfdepinst
To redeploy a service interface
To set deployment properties
Generate Web Services from WSDL and JSON
To generate a Web service from WSDL
To generate a RESTful Web Service from JSON Schema or OpenAPI (Swagger)
To generate a RESTful Web Service from request-response JSON
Generate Clients
To generate client applications from a service interface file
To generate a COBOL console client from WSDL
To generate a COBOL console client from JSON Schema or OpenAPI (Swagger)
To generate a COBOL console client from request-response JSON Schemas
To generate a Web service client application project from WSDL or JSON
Reference
imtkmake command
mfdepinst command
COBOL to Service Interface Data Type Matches
User Interface Reference
Service Interface Projects
Add/Remove Items
Options - Service Interface
Properties - COBOL Program Service Interfaces
Refresh Annotations
Service Interface
Username/Password
Interface Mapper
COBOL Assignment
Field Properties
Group Properties
Mapping
Operation Properties - General tab
Operation Properties - Path/HTTP tab
Operation Properties - User Exits tab
Operation Properties - API Resources tab
Operation Reorder
Generate Web Service dialog box - Native COBOL
Runtime Environment Configuration
Runtime Environment Configuration - Deployment Characteristics tab
Runtime Environment Configuration - Program Execution tab
Runtime Environment Configuration - File Handling tab
Runtime Environment Configuration - Memory Management tab
Runtime Environment Configuration - COBOL Switches tab
Runtime Environment Configuration - Environment Variables tab
Mixed Language Programming with Native COBOL
Ordering Parameters to Pass to Non-COBOL Programs
Removing Parameters from the Stack
Storage Representation of Parameters
Aligning Parameters on Word and Double Word Boundaries
Handling Return Codes in Mixed Language Applications
Call Conventions for Interfacing with Mixed Languages
Building a Mixed Language Application
Interfacing with Assembler Subprograms
Interfacing with Windows API Routines
Interfacing with C Programs
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
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
.NET COBOL code considerations
Compilation options
New XML statement
XML statement restrictions
XML considerations
XML and character encoding
Document type definition support
XSLT stylesheet files
Handling spaces and whitespace in XML
Schema files
Appendix A XML Extensions examples
Example 1 Import file and export file
Development for example 1
Batch file for example 1
Program description for example 1
Data item for example 1
Other definitions for example 1
Program structure for example 1
Execution results for example 1
Example 2 Export file and import file with XSLT stylesheets
Development for example 2
Batch file for example 2
Program description for example 2
Data item for example 2
Other definitions for example 2
Program structure for example 2
Execution results for example 2
Example 3 Export file and import file with OCCURS DEPENDING
Development for example 3
Batch file for example 3
Program description for example 3
Data item for example 3
Other definitions for example 3
Program structure for example 3
Execution results for example 3
Example 4 Export file and import file with sparse arrays
Development for example 4
Batch file for example 4
Program description for example 4
Data item for example 4
Other definitions for example 4
Program structure for example 4
Execution results for example 4
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 .NET 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$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 Visual Studio
Create a Native Enterprise Developer 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 .NET COBOL Using RM/COBOL Indexed Files
Enabling CTF to Trace RM/COBOL Data Files
Data File Utilities
Indexed File Recovery (recover1) utility
Recovery command
Recovery command options
Recovery process description
The four phases of processing
Recovery support module version errors
Recovery example
Recovery program error messages
RM/Panels
Restrictions and Limitations
Converting RM/Panels Applications
Conversion Example: Using Visual Studio
Creating a Visual Studio Project for the RM/Panels Application
Set the DIALECT"RM" Compiler Directive for the Project
Download the Tutorial Files
Import the RM/Panels Source Code
Configure Adis Support for RM/Panels
Configure the Supported Copybook Extensions
Build and Run the Application
Writing Programs
Standard 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
User Interface Programming
Modernizing Dialog System Applications
Overview of Modernizing Dialog System Applications
Dialog System information and restrictions
Migrating a Dialog System Application to Enterprise Developer
Enabling Microsoft's Visual Styles in Dialog System Applications
Changes to Existing Dialog System Applications that Use the Visual Styles
Modernizing a Dialog System Application
Samples of Modernizing Dialog System Applications
Sample: Windows Forms Replacing Dialog System Dialogs
Sample: Windows Forms Control as ActiveX for a Dialog System Application
Sample: WPF User Control in a Dialog System Application
Sample: .NET COBOL Dialog System Application
Sample: .NET COBOL Application and Windows Forms
Data Access
Database Access
Accessing Databases from COBOL
Database Access Features
Database Access Preprocessors
Developing SQL Applications
Embedded SQL
Host Variables
Simple Host Variables
Host Arrays
Indicator Variables
Indicator Arrays
COBOL to SQL Data Type Mapping
SQL TYPEs
Cursors
Declaring a Cursor
Opening a Cursor
Using a Cursor to Retrieve Data
Closing a Cursor
Positioned UPDATE and DELETE Statements
Using Cursors
Data Structures
SQL Communications Area (SQLCA)
Using the SQLCA
The SQLCODE Variable
The SQLSTATE Variable
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 ESQL 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
Setting OpenESQL Background Syntax Checking Options
Programming for OpenESQL
OpenESQL Assistant
Setting OpenESQL Assistant Options
Generating Code with MDCLGEN
Using OpenESQL Assistant
Starting the OpenESQL Assistant
Connecting to a data source
Building Queries
Generating initial query code
Selecting Columns
Specifying Aggregate Functions for Columns
Specifying Search Criteria
Specifying the Order in which Data is Retrieved
Creating a Table Join
Working with Queries
Display Column Details
Disconnect from a Data Source
Close a Query
Remove a Table from a SELECT Query
Changing a SELECT (cursor) query to do an Array FETCH
Testing Your SQL Queries
Embedding SQL into a program
Auxiliary Code
Generating EXEC SQL Auxiliary Code
Embedding Auxiliary Code
Generating EXEC ADO Auxiliary Code
Generated EXEC ADO Statements
Disconnected Model Statements
Connected Model Statements
EXEC ADO Wizards
Stored Procedures
Generating a TSQL Stored Procedure Query
Testing a TSQL Stored Procedure Query
Embedding a TSQL Stored Procedure into a Program
Generating a SQL CLR Stored Procedure Query
Testing a SQL CLR Stored Procedure Query
Working With OpenESQL Cursors and Result Sets
Working with Stored Procedures and Result Sets
Unicode Support in OpenESQL
OpenESQL Globalization Best Practices
Keywords
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
ADO.NET
Demonstration Applications
ADO.NET Data Providers and Data Sources
ADO.NET Connection Editor
Connection Terminology
Cataloging an ADO.NET or ODBC Connection
Exporting and Importing Connections
Example Connection Settings
SqlClient Data Provider
DB2 ADO.NET
ADO.NET Connection Strings
Using OpenESQL with ADO.NET
Using Embedded EXEC ADO Statements
Disconnected Model Statements
Connected Model Statements
ADO.NET Cursor Statements
Sharing ADO.NET Objects Statements
Data Table Support in ADO.NET
.NET Host Variables in Managed Code
Disconnected and Offline DataSets
Compiling Native Applications as .NET COBOL Code
Migrating Pro*COBOL Applications to OpenESQL with ADO.NET
Stored Procedures with ADO.NET
XML Support
SQL Server COBOL Stored Procedures
Prerequisites for SQL CLR Integration
SQL CLR Integration Process
SQL Server Database Project Template
Working with .NET COBOL Projects
Data Type Parameters in COBOL and SQL CLR Stored Procedures
Stored Procedure Definition (SPD) File
COBOL Wrapper Programs
Transaction Support for SQL CLR Stored Procedures
Issuing COBOL Calls from within SQL CLR Stored Procedures
Optimizing Read-only Cursor Performance for SQL CLR stored procedures
Working with SQL CLR Stored Procedures on a Remote SQL Server Machine
Post-deployment Script Requirements
COBOL Program Migration Support
COBSQL
Setting the COBSQL Preprocessor and Compiler Directive Options
Building COBSQL Applications
Using the CP Preprocessor to Expand Copybooks
National Locale Support (NLS)
Troubleshooting
Common Problem Areas
Oracle Considerations
Migration and Development
Oracle 8 and Micro Focus COBOL
Sybase Considerations
Informix Considerations
How to
OpenESQL Configuration Utility
To start the OpenESQL Configuration utility
To set a default for SQL(BEHAVIOR)
OpenESQL Assistant
To add a column to a query
To add all columns in a table to a query
To add an XML data source
To add or update a SQL CLR Stored Procedure
To change a SELECT (cursor) query to do an array FETCH
To close a query
To close the OpenESQL Assistant
To connect to a data source
To connect to a different data source
To create a table join
To create an SQL query
To create a SQL CLR stored procedure query
To create a TSQL stored procedure query
To disconnect from a data source
To display column details
To embed an SQL query into a program
To enable PL/I SQL query generation
To generate a DCLGEN copybook
To generate a DELETE statement
To generate a SELECT (cursor) statement
To generate a SELECT (singleton) statement
To generate a SELECT DISTINCT (cursor) statement
To generate a SELECT DISTINCT (singleton) statement
To generate a DECLARE DATATABLE statement
To generate an INSERT statement
To generate an UPDATE statement
To generate and embed auxiliary code
To perform an aggregate function
To refresh the list of data sources
To remove a table from a SELECT query
To run a query
To set OpenESQL Assistant options
To sort returned data (an ORDER BY clause)
To specify search criteria (a WHERE clause)
To start the OpenESQL Assistant
To view data source properties
ADO.NET Connection Editor
To add a connection
To view provider details
To export connections
To import connections
To remove a connection
To start the ADO.NET Connection Editor as an administrator
To start the ADO.NET Connection Editor as a user
To test a connection
SQL Server COBOL Stored Procedures
To create a SQL Server database project
To add a project reference to a .Publish project
To create a SQL CLR stored procedure query
To generate a SQL CLR stored procedure
To add or update a SQL CLR Stored Procedure
To create a stored procedure definition (SPD) file
To add a post-deployment script
To set project properties to build verifiable code
To generate a COBOL wrapper for a SQL CLR stored procedure
Reference
EXEC SQL Statement
OpenESQL
Embedded SQL Statements
ALLOCATE CURSOR
ASSOCIATE LOCATORS
BEGIN DECLARE SECTION
BEGIN TRAN
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 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
UPDATE (Positioned)
UPDATE (Searched)
WHENEVER
Embedded ADO Statements
ACCEPT CHANGES
BIND
BIND CONNECTION
CLEAR
CLOSE
DECLARE DATAROWS
DECLARE DATASET
DECLARE DATATABLE
DELETE (POSITIONED)
DELETE (SEARCHED)
FETCH
FILL
GET CHANGES
GET CONNECTION
GET CURSOR
GET DATATABLE
GET RUNTIME
INITIALIZE DATASET
INITIALIZE DATATABLE
INSERT
LOAD DATASET
LOAD DATATABLE
MERGE
OPEN
PREPARE TO FILL
PREPARE TO UPDATE
REBIND CONNECTION
REJECT CHANGES
SAVE DATASET
SAVE DATATABLE
SELECT INTO
TO DELETE USE
TO FILL USE
TO INSERT USE
TO REFRESH USE
TO UPDATE USE
UNBIND
UNBIND CONNECTION
UPDATE
UPDATE (POSITIONED)
UPDATE (SEARCHED)
USING
SQL Compiler Directive Options
ACCESS
ADOPICXISANSI
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
MARS
NESTEDCLRDEBUG
NIST
NOT
ODBCTRACE
ODBCV3
ODBCVER
OPTIMIZECURSORS
OPTIMIZESPCURSORS
OPTION (deprecated)
OPTPER
PARAMARRAY
PASS
PICXBINARY
PICXBINDING
PRE
PREFETCH
PROCOB
QUALFIX
RESULTARRAY
SAVE-RETURN-CODE
SPCOMMITONRETURN
SPDISPLAY
SPTHROWEXCEPTION
SQLCLRTRANS
STMTCACHE
TARGETDB
TESTSQLSTATE
THREAD
TIME
TIMEDELIM
TRACELEVEL
TRANSACTION
TSTAMPSEP
UNSAFE_NULL
USECURLIB
USER-SQLDA
WHERECURRENT
XAID
DBMAN Directive Settings
SQL/COBOL Data Type Mappings
OpenESQL Date and Time Environment Variables
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.
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.
COBES0129 Unrecognized SQLDA in SQL statement - try compiling with SQL(USER-SQLDA=option) directive
COBES0130 Host variable host-var.group-var is part of a group variable expansion that is not supported in this type of SQL statement.
COBES0201 BEHAVIOR directive not valid unless TARGETDB directive of DB2, ORACLE, or MSSQLSERVER set first.
COBES0202 BEHAVIOR directive not set.
COBES0203 PREFETCH and BEHAVIOR directives are mutually exclusive - cannot set both.
COBES0205 Cannot set directive PF_RO_CURSOR > 1 if RO_CURSOR directive is set to IC_FH.
COBES0206 Cannot set directive PF_RO_CURSOR > 1 if RO_CURSOR directive is set to FORWARD and TARGETDB is MSSQLSERVER.
COBES0207 Cannot set directive PF_UPD_CURSOR > 1 if UPD_CURSOR directive is set to FORWARD.
COBES0208 Cannot set UPD_CURSOR directive to DYNAMIC if TARGETDB directive is set to ORACLE.
COBES0209 Cannot set UPD_CURSOR directive to STATIC if TARGETDB directive is set to MSSQLSERVER.
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
MFImportConn command
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
ADO.NET Connection Editor
ADO.NET Connection Editor - Main Window
Settings Menu
Add an ADO.NET Connection wizard - start page
Name Your Connection page
.NET Data Providers page
OLE DB Data Providers page
ODBC System DSNs page
Provider Connection Details page
Add ADO.NET Connection Finished page
Export ADO.NET Connections - start page
Select Connections to Export page
Specify an Export File page
Export Connections Wizard Finished page
Import ADO.NET Connections - start page
Select a File to Import page
Select Connections to Import page
Import Connections Wizard Finished page
Provider Information
COBSQL
PREPROCESS(cobsql)
COBOL Directives
COBSQL Compiler Directive Options
COBSQLTYPE, CSQLT
CSTART, CST
CSTOP, CSP
DEBUGFILE, DEB
DISPLAY, DIS
END-COBSQL, END-C, END
HSFTRACE
KEEPCBL
KEEPCOMP
MAKESYN
SQLDEBUG
STOPCHK
TRACE
VERBOSE
XAID
COBSQL Messages
CSQL-I-001 to CSQL-E-023
CSQL-I-001: COBSQL has finished returning to the Checker
CSQL-I-003: COBSQLTYPE is incorrect defaulting to Oracle
CSQL-I-004: Accepted COBSQL-directive
CSQL-I-005: Passing precompiler-directive
CSQL-I-006: Rejected COBSQL-directive
CSQL-F-007: COBSQL/Checker incompatible -- Terminating
CSQL-I-008: Invoking integrated-preprocessor Preprocessor
CSQL-F-009: Irrecoverable error in integrated-preprocessor -- Terminating
CSQL-F-010: Irrecoverable error writing STK record
CSQL-F-011: Environment unsupported by COBSQL/Informix
CSQL-F-012: INFORMIXDIR must be set for Informix Support
CSQL-F-013: Unable to access: filename
CSQL-F-015: DOS Exec error Return Code is return-code
CSQL-F-016: UNIX Exec error Return Code is Return-Code
CSQL-I-017: Creating filename
CSQL-I-018: Invoking precompiler Precompiler/Translator
CSQL-F-019: Irrecoverable error Opening STK file
CSQL-I-020: Processing output of precompiler Precompiler
CSQL-F-021: Precompiler did not complete -- Terminating
CSQL-F-022: Irrecoverable error Reopening ORG file
CSQL-E-023: File Status file-status
CSQL-E-024 to CSQL-F-050
CSQL-E-024: Encountered an I/O on file filename
CSQL-F-025: Unable to Create virtual-heap
CSQL-F-026: Premature end of expanded source.
CSQL-I-027: Detected Working Section, now processing it
CSQL-I-028: Now processing through Procedure Division
CSQL-I-029: Found an EXEC SQL Statement, processing it
CSQL-E-036: Unable to open the precompiler file: filename
CSQL-F-037: Wrong Version of COBOL used, please upgrade
CSQL-I-038: The following directive is now Obsolete: COBSQL-directive
CSQL-I-039: The ORG & the CBL files were out of synch
CSQL-W-040: Pro*COBOL commented out the following line: source-line
CSQL-F-041: Cannot read the COBOL runtime switches
CSQL-F-042: Cannot set the COBOL runtime switches
CSQL-F-046: Command line is too large. Maximum length is 1140 characters
CSQL-F-047: Cobsql cannot be used with the SOURCEFORMAT directive.
CSQL-F-048: Cobsql is not supported for use with .NET 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 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
Locking Files and Records
Example of Locking a File
Examples of Manual Record Locking
Examples of Automatic Record Locking
Examples of Single Record Locking
Examples of Multiple Record Locking
MFSORT 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
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
Connecting to the host
Disconnecting from the host
Using macros
Adding a macro to your project
Running a macro
Customizing the Embedded Rumba Display
Customizing Colors
Customize the Keyboard Settings
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+ Desktop Mainframe Display
Debugging using Rumba+ Desktop
Debugging using Other TN3270 Emulators
Assembler Support
Assembler Support Overview
About Developing Assembler Applications
About Creating, Editing and Navigating Source Code
Customizing the Editor for Assembler
Assembler Text Editor General Page
Assembler Editor Margins and Text Casing Options
Assembler Editor Scroll Bars
Assembler Text Editor Tab Page
Configuring the Environment
Configuring Assembler Project File Locations
Using the IDE to Set Locations
Using the Configuration File to Set Locations
Example: Using MF370CTL.CFG to Set Locations
Using a Command File to Configure Locations
Example: Using a Command File to Set Locations
Component Location Environment Variables
Compiling and Linking Assembler Modules
About Compiling and Linking Assembler Modules
Setting Compiler Directives
Compiling Assembler Copybooks and Macros Containing EXEC CICS Statements
Linking Modules
Program Structures and Static Linking
Single Assembler Module
Multiple Assembler Modules with Calls Using External Names
Multiple Assembler Modules with Calls Using Entry Points
Dynamic Linking
Mixing Static and Dynamic Linking
Assembler Modules that call COBOL Modules
Link File INCLUDE Commands
Other Link File Commands
Entry Point Mapping
Debugging Assembler Applications
Compiling Assembler Programs for Debugging
Configuring an Enterprise Server Region for Debugging
Starting the Assembler Debugger
How to...
To change a floating-point register value
To change a general-purpose register value
To change colors on Assembler debugger
To clear breakpoints
To examine an instruction
To execute a sequence of instructions
To execute the rest of the module or program
To find parts of the code
To find the next executable instruction
To get help while debugging
To jump instructions
To monitor module exits
To navigate your Assembler source code
To perform hexadecimal and decimal additions
To recall the last message
To set address breakpoints
To set branch breakpoints
To set opcode breakpoints
To set register breakpoints
To specify a hexadecimal value
To step through code
To stop debugging
To view debugging status information
To view floating-point registers
To view new dumps
To view previous dumps
To toggle zSeries and OS390 general-purpose registers
Configuring Runtime Memory Requirements
About Memory Requirements
Setting Addressing Mode and Residency Mode
Configuring the Default SQA Memory Size
Reserving Memory for Execution
Setting the Run Time Virtual Memory Environment
Example: Runtime Virtual Memory Configuration
Run Time Memory Environment Variables
Configuring a Program's Memory Requirements
Program Only Uses Memory Below the Line
Program Only Uses Memory Above the Line
Program Uses Memory Below and Above the Line
Setting Residency Mode
Using Subpools
File Handling
Introduction to File Handling
Using QSAM for File Handling
Using BSAM for File Handling
Using VSAM for File Handling
Using the Generalized Trace Facility
Generalized Trace Facility Introduction
Turning GTF on and Specifying Options
The Trace File
Types of Trace
Default Trace
Detailed Trace
File Input/Output Trace
Memory Allocation Trace
Program Interruption Information
CICS Support
Mainframe-style Pointers
AMODE and Non-AMODE Compiled Programs
Forcing a Program to be Reloaded
Accessing Large VSAM Files
Abend Codes in CICS Transactions
ASSA
EXIF
FUNC
IRST
LANG
MATP
MBLL
MCOM
MUSR
RECU
Using the SET Option of the BMS-related SEND Functions
Converting a Fake TIOA Address to a Real TIOA Address
Restrictions on Using DFHMFSET
Examples
OS/VS COBOL Example
VS COBOL II Example
Developing Exit Programs
Introduction to Developing Exit Points
Global and Task-related Exit Programs
User Exit Examples
Task-related User Exit Example
Global User Exit Example
Security Exit Programs
Interface
Error Conditions
User Interface Reference - CICS Support
Accessing CICS Resources in the IDE
CICS Web Services
Demonstration Applications
Configuration Requirements for CICS Web Services
CCSID Conversion Tables
CICS Web Service Types and Methods
CICS Web Service Components
CWS Security
Handling Variable Arrays in WSDL and JSON - CICS COBOL
Troubleshooting
How to
To install CCSID tables
To specify a CCSID table in the CICS SIT
To specify the corresponding ASCII CCSID for an EBCDIC CCSID
To create a CICS Web Service provider from WSDL using the top-down method
To create a CICS Web Service requester from WSDL using the top-down method
To create a CICS Web Service provider using the bottom-up method, WSDL
To create a CICS Web Service provider from JSON using the top-down method
To create a CICS RESTful Web Service provider from JSON using the top-down method
To create a CICS Web Service provider using the bottom-up method, JSON
To create a CICS Web Service requester from JSON using the top-down method
To generate a COBOL console client from request-response JSON Schemas
To generate a Web Service from request-response JSON Schemas
Reference
Command line reference
js2ls command
ls2js command
ls2ws command
ws2ls command
CWS Resources
CWS API Calls
CWS SPI Calls
User Interface reference
Generate Web Service dialog box - CICS COBOL
Operation Properties - CICS Web Services - General tab
HCO for DB2 LUW
Demonstration Applications
DB2 External Compiler Module
Compound SQL
User Defined Functions
Extensions to Embedded SQL Support
The INCLUDE Statement
The DECLARE Statement
Qualified Host Variables
Host Variable Groups and Indicator Arrays
The NOT Operator (Ā¬)
The Concat Operator (|)
SQL Communications Area
Support for Object Oriented COBOL Syntax
Support for Nested COBOL Programs and PL/I External Routines
Compiling
DB2 ECM Preprocessor
Setting the DB2 ECM Preprocessor and Compiler Directive Options
Setting DB2 Background Syntax Checking Options
Connecting to a DB2 Database
DB2 Compiler Directive
Error Codes
Binding
Linking
COBOL DB2 Stored Procedures
Working with Stored Procedures
Writing and Preparing Stored Procedures
Preparing Stored Procedures
How an Application Works With a Stored Procedure
Writing and Preparing Applications to Use Stored Procedures
Executing the SQL Statement CALL
Parameter Conventions
Using Indicator Variables to Speed Processing
Declaring Data Types for Passed Parameters
Limitations
Defining Stored Procedures under DB2 LUW
Compiling and Linking Stored Procedures under DB2 LUW
Testing Stored Procedures under DB2 LUW
Host Compatibility Option (HCO)
Creating a DB2 LUW Database for HCO
HCO Tools
Create Database Tool
DDL Processor
DCLGEN Tool
Export Data Tool
Import Data Tool
BindAll Packages Tool
Product Specifications
HCO Functions
DDL DB2 for z/OS Syntax Supported
Functions Processed Unchanged
Functions Changed to Comments
Functions That May Be Modified
DB2 LUW Syntax DDL
Features Supported by DB2 LUW
Column Functions and Scalars
Special Registers
Features Not Supported by DB2 LUW
Special Registers
Other Functions
Compiling and Run Time
Compiling DB2 Programs with HCO
DDL Processing
Invoking the DB2 ECM
Error Messages When Compiling Program
Run-time Services
MFHCOCDS Tool
Dynamic Bind Utility
DSNTIAR and DSNTIAC
MFHCOEBC
Sample Programs
How to
To start HCO tools
To create a database
To process SQL DDL statements
To create a DCLGEN
To bind files
To import data
To export data
To set HCO for DB2 LUW options
Reference
DB2 Compiler Directive Options
ACCESS
ACTION
ALEBRA
APREUSE
BIND
BINDDIR
BGP
BLOCK
CALL_RESOLUTION
CASE
CCSIDG
CCSIDM
CCSIDS
CHARSUB
COLLECTION
COMMIT
CONCAT
CONCURRENTACCESSRESOLUTION
CONNECT
COPY
CTRACE
DB
DBPROTOCOL
DEC
DECDEL
DEFERRED_PREPARE
DEGREE
DISCONNECT
DYNAMICRULES
ENCODING
EXPLAIN
EXPLSNAP
EXTENDEDINDICATOR
FEDERATED
FEDERATED_ASYNCHRONY
FOR
FORMAT
FUNCPATH
GENERIC
GEN-HV-FROM-GROUP
GEN-INIT-FLAG
GEN-SQLCA
HCO
HOSTVAR
HSFTRACE
IGNORE-NESTED
IMMEDIATE
IMMEDWRITE
INIT
INSERT
ISOLATION
KEEPDYNAMIC
LANGLEVEL
LEVEL
MSGAREA
MULTI_PACKAGE
NOT
OPTPROFILE
OPTHINT
OPTPER
OS400NAMING
OWNER
PACKAGE
PASS
PRE
QUALFIX
QUALIFIER
QUALIFY-CALL
QUERYOPT
RELEASE
REOPT
REPLVER
RETAIN
SAVE-RETURN-CODE
SINGLE_PACKAGE
SORTSEQ
SQLERROR
SQLFLAG
SQLRULES
SQLWARN
STATICREADONLY
STOPROC
STRDEL
SYNCPOINT
SYNTAX
TEMPORAL-HISTORY
TEXT
TRANSFORM-GROUP
UDB-VERSION
VALIDATE
VERSION
XAID
DB2 Environment Variables
HCOBND environment variable (deprecated)
SQLPASS.TXT environment variable (deprecated)
DB2 ECM Error Messages
COBDB0002 - COBDB0013
COBDB0002 token is badly defined.
COBDB0003 Program contains more than one definition of field-name
COBDB0004 Nested or multi-source programs not allowed.
COBDB0005 An error occurred when processing the internal dictionary.
COBDB0006 Required DB software token could not be found.
COBDB0007 Source file name is invalid.
COBDB0008 MF DB2 Connect program missing or invalid.
COBDB0009 MF DB2 Connect program reported error condition token.
COBDB0010 DB2 rejected an unspecified option.
COBDB0011 No database name was specified.
COBDB0012 Functionality only supported in 32-bit mode
COBDB0013 Invalid directive token. IBM supports only precompiled code running as native code.
COBDB0100 - COBDB0115
COBDB0100 SQL error description
COBDB0101 Statement is too long.
COBDB0102 Statement contains too many host variables.
COBDB0103 host-var definition does not match the column type associated with it.
COBDB0104 Bad SQL data declaration.
COBDB0105 Syntax error.
COBDB0106 Filename too long.
COBDB0107 File filename not found.
COBDB0108 host-var is non-unique and should be qualified.
COBDB0109 host-var is not a data item.
COBDB0110 Statement contains more than one SQLDA.
COBDB0111 token is not a table of null indicator variables.
COBDB0112 host-var should not be defined with an OCCURS clause.
COBDB0113 host-var should not be a subordinate to an item defined with an OCCURS clause.
COBDB0114 Statement only allowed in the Procedure Division.
COBDB0115 Statement not allowed in the PROCEDURE DIVISION.
COBDB0116 - COBDB0137
COBDB0116 An error occurred when processing the trace file.
COBDB0117 Invalid format of compound SQL statement.
COBDB0118 Mismatched DECLARE.
COBDB0119 Host variable name is too long.
COBDB0120 Internal error - dictionary handle is too big.
COBDB0121 Package name is too long.
COBDB0122 Nested INCLUDEs not supported
COBDB0127 Parentheses are illegal in the INTO clause.
COBDB0131 SQLCA or SQLCODE not found.
COBDB0137 Indicator variable ind-var is not SMALLINT type.
COBDB0501 - COBDB0503
COBDB0501 Found variable expected END-EXEC in nested include.
COBDB0502 Found variable expected INCLUDE in nested EXEC SQL statement.
COBDB0503 Found variable expected SQL in nested EXEC statement.
COBDB0900 - COBDB1004
COBDB0900 An internal error occurred.
COBDB0901 SQL processing cannot continue.
COBDB0902 An internal error occurred.
COBDB1000 Use of EXEC SQL INCLUDE SQLCA END-EXEC.
COBDB1001 MF DB2 Connect program produced the warning token.
COBDB1002 Statement is not in area B.
COBDB1004 INVALID SQL STATEMENT - statement ignored.
HCO Tools
Command Line Reference
mfhco and cobmfhco create commands
mfhco and cobmfhco ddl commands
mfhco and cobmfhco dclgen commands
mfhco and cobmfhco import commands
mfhco and cobmfhco export commands
mfhco and cobmfhco bindall commands
User Interface reference
Create Database tab
DDL Tool tab
DCLGEN tab
Copybook tab
Bind tab
Import tab
Export tab
Log tab
HCO for DB2 LUW Options
HCO for SQL Server (HCOSS)
Demonstration Applications
HCOSS Toolset
Before Using HCO for SQL Server
Using HCOSS with Windows User Account Control (UAC)
Working With HCOSS SQL CLR Stored Procedures and Result Sets
Mimicking Mainframe DB2 Transaction Support for COBOL Stored Procedures
HCOSS Datetime Data Type Handling
Scope - HCOSS SQL Compiler Directive Options
Managing Connections
Manage Connections Tool
Connection Types
Advanced Connection Options
Migrating Databases
DB2 Database Migration Process
DB2 Temporary Table Migration
Extract Schema Tool
Schema Extraction Process
Offline Extract Schema Solution
Modifying Exporting and Importing Schema Extract Files
Extract Schema Security
Assess Data Migration Tool
Define Lists Tool
Generate DDL Tool
Transfer Data Tool
SSIS Packages
Data Type Support
Data Transform Types
Compare Data Tool
Mainframe Batch Database Tools
Migrating Applications
Assess Application Migration Tool
Why You Should Use the Assess Application Migration Tool
Migration Scenarios
Supported Source Code
Processing Requirements
Application Migration Process
DB2 to SQL Server Conversion
HCOSS Conversion Rules
SQL Code Generation Options
SQL Statement Prefixes for DIALECT Directive
Datetime arithmetic in HCOSS
Application Progression from DB2 to SQL Server
Building Applications
Migrating Mainframe COBOL Stored Procedures
Generate SPD File tool
Application Database Support
Binding Applications
Manage Packages and Plans Tool
Package Specifications
Plan Specifications
Freeing Packages and Plans
DSN Bind Utility
Managing DBRMs
Local DBRMs
Shared DBRMs and multi-user environments
Running Applications
CICS Applications - DBRM Specification
JCL Applications - DBRM Specification
Deploying Native Applications
Managing Log Files
Customizing HCOSS
Customizing Data Type Mappings
Customizing Functions and Special Registers
Function Customization Process
Function Customization Example
Customize SQLCode Mappings Tool
Customizing SQLCA Error and Warning Processing
Customizing SQL Identifiers
How to
To start HCO for SQL Server
Manage Connections
To create a DB2 connection
To create a system or user SQL Server connection
To create an Azure SQL Database connection
To edit an existing connection
To import a connection
To export a connection
To repair a connection
To generate a stored procedure definition (SPD) file
Migrate Databases
To extract DB2 schema objects
To modify a schema extract file
To export and import DB2 schemas
To assess data migration
To export data assessment results
To define an object transfer list
To generate and execute DDL
To customize generated DDL
To customize schema mappings in DDL
To transfer data
To customize a transfer data task
To compare transferred data
To run customized data comparisons
Assess Application Migration
To analyze schema extract data
To assess application migration
To export assessment results
Manage Packages and Plans
To create a bind script file
To open an existing bind script file
To create a new package
To create a new plan
To edit an existing BIND command
To execute one or all bind script lines
To free one or more packages
To free one plan or all plans
Bind Applications with DSN
To bind from the command line
To bind as a post-build event
To manually code a bind script file
To bind from JCL
Customize HCOSS
To set HCOSS options
To customize data type mappings
To customize SQL name mappings
To customize SQLCode mappings
Reference
Command Line Reference
MFConnection command
MFDataTransferCtlr command
MFDDLConverter command
MFExtractSchemaInfo command
MFObjectList command
MFTestConversion command
COMPARE Command File
DSN command
SQL Compiler Directive Options - HCOSS
CHECKCALLPARAMS
CHECKSP
DATE
DBRMLIB
DETECTDATE
DIALECT
MEMBER
NORSLOCATORS
OPTION (deprecated)
PROMOTE
QUALIFIER
SPCALLLOCAL
STRICTPARSE
TIME
VERSION
DBMAN Directive Settings - HCOSS
Required DB2 Catalog Tables
DB2 to SQL Server Conversion Reference
Date and Time Data Types
Mainframe Date and Time Data Types
SQL Server Date and Time Data Types
Default Data Type Mappings
Default Function Mappings
Default Special Register Mappings
Default SQLCODE Mappings
DSNTIAR and DSNTIAC
Bind Script Commands
HCOSS Messages
Compare Data Tool
Define Lists Tool
Extract Schema Tool
Generate DDL Tool
Manage Connections Tool
Transfer Data Tool
Build error messages
Log Files
Manage Connections Tool Log Files
Extract Schema Tool Log Files
Define Lists Tool Log Files
Generate DDL Tool Log Files
Transfer Data Tool Log Files
Compare Data Tool Log Files
Manage Packages and Plans Tool Log Files
User Interface Reference
Manage Connections
Connection List tab
DB2 Connection tab
SQL Server Connection tab
Export tab
Import tab
Log Files tab
Extract Schema
Schema Extract tab
Create New Schema Extract
Results tab
Log Files tab
Assess Data Migration
Data Assessment Tasks tab
Create New Data Assessment Task dialog box
Results tab
Generate SPD File tab
Define Lists
Transfer Lists tab
Create New List dialog box
Log Files tab
Generate DDL
DDL Tasks tab
Create New DDL Task dialog box
Customize DDL tab
Schema Mappings tab
Results tab
Log Files tab
Transfer Data
Transfer Data Tasks tab
Create New Transfer Data Task dialog box
Customize Transfer Data tab
Results tab
Compare Data
Compare Data Tasks tab
Create New Compare Data Task dialog box
Customize Compare Data tab
Results tab
Assess Application Migration
Assessment Tasks tab
Create New Assessment Task dialog box
Source Code tab
Results tab
Data Analysis tab
SQL Conversion tab
Log Files tab
Manage Packages and Plans
Bind Scripts tab
Bind Packages tab
Bind Plans tab
Free Packages tab
Free Plans tab
Results tab
Log Files tab
Data Mappings tab
SQL Name tab
Customize SQLCode Mappings
SQLCode Mappings tab
Deploy/Extract tab
Options
Interface Mapping Toolkit (IMTK)
Creating an Enterprise Server for a Mainframe-based Service
Managing Mainframe-based IMTK Projects
Defining Mainframe-based Service Interfaces
Map Annotations Editor
CICS and IMS Screens - Interface Mapper
CICS COMMAREA - Interface Mapper
Operations
Screen-based Operations
CICS COMMAREA-based Operations
Operation Components
Interface Fields
Mappings
Assignments
Work Fields
Arrays
Conditional Statements
Initialization or Termination Logic
Deploying Service Interfaces to an MSS-enabled Enterprise Server
Enterprise Server Requirements
Service Interface Deployment Methods
Deploying to an Enterprise Server under UNIX
Clients
COBOL Console Client
CICS Application Client
WPF Client
Windows Forms Client
ASP.NET Client
JSP Client
Tracing Service Execution
Tracing CICS Service Execution
Tracing IMS Service Execution
How to
Manage Mainframe-based IMTK Projects
To configure the run-time environment
To create a project for mainframe-based service interfaces
To create a mainframe-based service interface
To debug a CICS service interface
To modify the CLASSPATH property for a Java-based service interface
To update service interfaces with source code or property changes
To set client generation options
To trace the execution of a CICS service
To trace the execution of an IMS service
To validate a service interface
Create and Edit Map Annotations
To edit a logical screen map name
To define a map field direction
To group map fields
To add or delete map field values
Define Mainframe-based Service Interfaces
To add initialization or termination code
To apply an existing condition
To assign a value to a screen, COMMAREA, or work field
To assign an extracted string value
To assign the result of a concatenation
To assign the result of an arithmetic function
To assign the summation of array elements
To create a CICS COMMAREA-based operation
To create a screen-based operation
To create a work field
To create an interface field
To create and apply a conditional statement
To edit conditions
To edit field properties
To group interface or work fields
To map an interface field
To view applied conditions
To start the Interface Mapper
Deploy Service Interfaces to an MSS-enabled Enterprise Server
To associate an enterprise server with a project
To compile a mainframe-based service driver program on a remote UNIX machine
To deploy a service interface from a project
To deploy to a remote enterprise server
To deploy a mainframe-based service interface using imtkmake
To generate clients
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
Service Interface Abend Codes
User Interface Reference
Service Interface Projects
Options - Service Interface
Properties - Mainframe-based Service Interfaces
Refresh Annotations
Service Interface
Username/Password
Map Annotations Editor
Field Values
Group Fields
Interface Mapper
Apply Condition / Edit Conditions
Assignment
Condition Editor
Field Properties
Group Properties
Mapping
Operation Properties - CICS COMMAREA Service Interfaces - General tab
Operation Properties - Screen-based Service Interfaces - General tab
Operation Properties - Transaction tab
Operation Properties - User Exits tab
Operation Reorder
Runtime Environment Configuration
Runtime Environment Configuration - Deployment Characteristics tab
Runtime Environment Configuration - Program Execution tab
Runtime Environment Configuration - File Handling tab
Runtime Environment Configuration - Memory Management tab
Runtime Environment Configuration - COBOL Switches tab
Runtime Environment Configuration - Environment Variables tab
IMS Support
IMS DB Compatible Production DBMS
IMS TM Compatible Transaction Manager
IMS Installation Verification Procedure (IVP)
Demonstration Application
Prepare the MFDEMO Application
Create and Configure an IMS Enterprise Server
Run MFDEMO
Developing IMS Applications
Migrating Existing IMS Applications
Unload an IMS Database
Download IMS Files
Create an IMS Project
Build the IMS Project
Load the IMS database
Create an IMS-enabled Enterprise Server
Export IMS Transactions
Import the Transaction File
Deploy and Run the IMS Application
ASCII/EBCDIC Conversion Issues
MFS Conversion Issues
Database Load Conversion Issues
MFS Double-byte Character Set (DBCS) Support
IMS Projects
IMS Project Components
IMS Project Properties
Viewing the IMS Databases in a Project
Building an IMS Project
IMS Database Features
IMS Generation
DBD Generation
PSB Generation
MFS Generation
Exit Routines
MFS Input Message Exits
MFSGEN Preprocessor Exit
IMS Data Capture Exits
IMS Print Exit
IMS Sparse Index Exits
IMS Non-discardable Messages Exit
IMSDBU Exits
IMS Database Tools
IMS Database Utility (IMSDBU)
Accessing IMSDBU
Fast Path MSDBs
Converting Segments from EBCDIC to ANSI
IMSDBU Automation
IMSDBU Functions
DBUTIL Utility
VRECGEN Utility
IMS Segment Layout Editor
Input
Segment Layout Types
Segment Layout Names
Output
IMS Database Editor
Configuring the IMS Database Editor
Navigating an IMS Database
Retrieving Data
Searching for a String
Bookmarking Segment Occurrences
Browsing Segment Occurrences
Creating and Editing Data
Editing Field Data
Editing Segment Data
Initializing Segments and Fields
Deploying IMS Applications
Creating and Configuring an Enterprise Server Region for IMS
MSS and CICS Support
IMS Connect
Open Transaction Manager Access (OTMA)
Configuring IMS Multiple Sign-on Support
IMS-enabled Enterprise Server Administration using ESMAC
Defining IMS Resources
Defining IMS Transactions
Configuring the IMS Message Queue
Dynamic IMS Message Queue Expansion
Dynamic IMS Message Queue Performance Tuning
Configuring IMS Printers
Calculating Shared Memory Area Requirements
IMS Database Administration
BTS Trace
IMS Database Locking
Traditional Locking
Internal Resource Lock Manager (IRLM)
Enabling IRLM Locking
IRLM Implementation
IRLM Lock Table Statistics
Deadlocking
DB Control Queries
IMS Database Recovery
IMS Database Automatic Backward Recovery
Automatic Backward Recovery Process
Invoking Backward Recovery from JCL
IMS Database Forward Recovery
Preparing for Forward Recovery
Image Copy Utility
Image Restore Utility
Recovery Utility
TLOG Files
Rebuild Utility
IMS Batch Backout
Batch Backout Implementation
Enabling Batch Backout Logging
Recovering Database Changes with the Batch Backout Utility
Using Checkpoints with Batch Backout
Using Extended Log Files
Batch Backout Example JCL
Restrictions and Limitations
Error Conditions
Enterprise Server warm/cold start
IMS Checkpoints
Basic and Symbolic Checkpoint Calls
IMSLGR Files
Avoiding Dataset Contention
WebSphere MQ Support
MQ-IMS Bridge
WebSphere MQ Configuration
Enterprise Server Configuration
MQ Listeners and Writers in ESMAC