AccuRev
AccuRev SCM
AccuSync
AccuRev GitCentric
AccuRev Plugins
AccuRev SCM
AccuSync
AccuRev GitCentric
AccuRev Plugins
Atlas
Atlas
Atlas
Caliber
Caliber
Caliber
Enterprise
Enterprise Developer
Enterprise Server
Enterprise Test Server
Micro Focus Ant User Manual
Introduction
Usage
Defining Tasks and Types
Ant Tasks
analysis
asm
asmclean
bms
bmsclean
cobol
cobolclean
cobollbr
cobollink
ims
imsclean
pli
pliclean
plilink
Ant Types
mfdirlist
mffilelist
mfdestfilelist
ruleList
com.microfocus.cobol.runtimeservices Guide
API Documentation
Packages
com.microfocus.cobol.runtimeservices
com.microfocus.cobol.runtimeservices.servlet
Classes
com.microfocus.cobol.runtimeservices.RunUnitStartupOptions
com.microfocus.cobol.runtimeservices.RunUnitManager
com.microfocus.cobol.runtimeservices.RunUnit
com.microfocus.cobol.runtimeservices.IRunUnitManager
com.microfocus.cobol.runtimeservices.IRunUnit
com.microfocus.cobol.runtimeservices.Interop
com.microfocus.cobol.runtimeservices.CallableProgram
com.microfocus.cobol.runtimeservices.CallableProgram.ICancelProgramCallback
com.microfocus.cobol.runtimeservices.Callable
com.microfocus.cobol.runtimeservices.servlet.ServletRunUnitManager
Enterprise Sync
Installation and Administration Guide
Introduction
Key Benefits
Complementary Enterprise Products
Components
Server Components
Client Components
Concepts
General Concepts
Endevor/AccuRev Synchronization Support
General Considerations
Metadata Synchronization Support
On-Demand Synchronization Support
Required Credentials
Content Type Support
Change Package Support
Mapping Rules
Promote/Move Synchronization Rules
Moving Files in Endevor
Promoting Change Sets in AccuRev
Processing Endevor Sourceless Elements
Installation
Installing Enterprise Sync Server
Installing the AccuRev Server
Installing the AccuRev Windows Client
Installing Enterprise Developer
Installing the Enterprise Sync Add Pack
Installing the Workflow Manager Endevor Model
Administration
AccuRev Configuration
Define AccuRev User
Define AccuRev Depot
Define AccuRev Stream Structure
AccuRev Server Configuration
Installing the AccuRev Triggers
General Preparation before Customizing and Installing the Triggers
Installing the Trigger Supporting the On Demand Sync
Installing the Trigger for Defunct Deactivation and Read-Only Type Support
Enterprise Sync Server Configuration
Starting the UI
The Dashboard
Setting Synchronization Frequency
Setting Up Error Notification
Data Sources
Defining a Data Source
AccuRev Data Source Fields
Endevor Data Source Fields
Defining an Authenticator
Creating User Maps
Mapping Mainframe Users with AccuRev Users
Working with Connections
Creating and Editing Connections
Displaying Connection Information
Importing Project Definitions
Project Map File Includes/Excludes
Starting and Stopping Connections
Connection Status Values
Specific Considerations when Defining AccuRev to Endevor Connections
Changing the Configuration and Clearing Watermarks
Verifying the Installation and Configuration in Enterprise Developer
Glossary
Troubleshooting
Contacting Micro Focus
Creating a Dump File
Reviewing Log Files
Debugging the AccuRev Eclipse Plugin
Enterprise Developer and AWM Related Logs
AccuRev Server Logs
User's Guide for Mainframe Developers
Introduction
Audience
Using This Guide
The Bankdemo Sample
The Bankdemo Application in Endevor
The Bankdemo Application in AccuRev
The AccuRev Endevor Synchronization Rules/Configurations
Using AccuRev and Endevor with Enterprise Developer
Benefits
Features
Loading the AWM Application for Enterprise Sync
Creating an AccuRev Workspace
Navigating to AccuRev Files
Linking AccuRev Files to Micro Focus COBOL or PL/I Projects
Locking Endevor Elements
Editing Files in COBOL or PL/I Projects Linked to AccuRev
Promoting Files in AccuRev with Synchronization to Endevor
Navigating to Endevor Elements
Verifying Endevor Compile Results
Moving Files in Endevor and Synchronizing to AccuRev
Changing Files in Endevor and Synchronizing to AccuRev
Accepting Incoming Changes
Resolving Conflicts in AccuRev
Parallel Release Development
Data Express
Publications
Readme
System Requirements
Windows
z/OS
Extension Technology
Installation Notes
New Features
Updates and Product Support
Known Issues and Restrictions
Supplementary Information
Supported Character Encoding Systems
Supported Data Types
Data Type Restrictions
ADABAS Restrictions
Oracle Restrictions
DB2 for z/OS Environment Restrictions
AS/400 Data Stores
Readme Help
Contact Information
Installation Guide
Who Should Read This Guide
z/OS System Procedures
Installation Media
Installation Phases
New Software Installation Procedures
Allocate the Installation Sequential Data Set
Copy JCL Files to the Mainframe
Copy the Installation Data Set to the Mainframe
Allocate and Load the Installation PDS
Set Installation Parameters
Install the Data Set Libraries
Update the User Profile
Create the Database
Populate the Database
Enable Data Express for z/OS
Panels
Get Request Key
Apply Response Key
Display Enabled Options
Install Updates
Software Upgrade
Toolkit Installation
Installing Data Express Into Multiple DB2 Subsystems
Who Should Read This Information
Installation Cloning
Cloning Phases
Cloning a Database
Cloning Environment Libraries
Enabling a New Cloned Environment
Panels
Obtaining a Request Key
Applying the Response Key
Displaying Enabled Options
Install PTFs
Customization Reference
FTP Script Customization
FTP Script (ftpput.txt) Customization
FTP BAT File (ftpput.bat) Customization
PC3270 Transfer File List (inst.srl) Customization
PC3270 Transfer File List (kbd.srl) Customization
JCL File (iebupdte.jcl) Customization
Distributed Systems Procedures
Windows Installation
Installation Media
Software Setup
Software Update for Windows
UNIX Installation
Unix Software Updates
Getting Started with Distributed Data Stores
Using Distributed Data Stores with Data Express
DBA Tasks for Extension Technology
New Installations
Data Express Upgrades
Required Run-Time Knowledge Base Updates
Centralized Run-Time Knowledge Base for the ODBC Extension
Using Distributed Loader
Loading Data Store Information
Load from Database
Load from File
Limited Life Cycle Support
Use of Data Analysis (Sampling) for Class Assignment
Importing Classes
Data Dictionary
Referential Integrity
Sampling Results
Creating Referential Integrity Methods
Data Express for z/OS
Data Express for Distributed Systems
Using Distributed Exporter
Data Masking
Data Subset Extraction
SQL Files Generated by Distributed Exporter
Using Distributed Sampler
Sampling Options
Validation
Load results from file
Using Extension Technology
Extension Technology Configuration
Extension Technology Configuration File
Data Store SQL Scripts
DXCOMMON Environment Variable
Extension Technology Directories
Invoking Extension Technology
The dxestart command
Execution Modes
Error Diagnosis
Masking Routines
C
COBOL
Extension Technology Utilities
Creating an Encoded Connection File
Batch Distributed Exporter
Data Express for Distributed Data Stores Tutorials
Using Data Express
Preparation
Sample Session
Data Inventory
Sample Session
Data Masking
Sample Session
Simple Data Subset Extraction
Sample Session
Data Subset Extraction using Referential Integrity
Sample Session
Data Subset Extraction Using a Combined Data Element
Creating a Combined Data Element
Creating a Class on a Combined Data Element
Associating a Class with a Combined Data Element
Modifying a Referential Integrity Method to Use a Combined Data Element as a Selection Class
Exporting a Referential Integrity Method to Extension Technology
Executing Referential Integrity Method
Verifying Results
Simple Sampling
Sample Session
Data Generation
Catalog and Classify Tables
Start the Data Generation Module
Create Simple Data Generation Code
Execute a Simple Data Generation Law
Verify Results
Oracle Alias Creation
Oracle Wallet
Implementing Oracle Wallet Support
Getting Started with z/OS Data Stores
Product Components
Using z/OS Data Stores
Data Express for z/OS Tutorials
Sample Sessions
DB2 Data Stores Session
Importing JCL Job Streams into Your Mainframe Environment
Creating the DB2 Tablespace and Tables
Starting Data Builder
Setting Your Workspace
Loading Data Store Information into Your Mainframe Environment
Sequential Files Session
Importing the JCL CREASEQS into Your Mainframe Environment
Importing the Sequential File and Copybook Information into Your Mainframe Environment
Starting Data Builder
Setting Your Workspace
Loading Copybook Information into Your Mainframe Environment
Loading Data Store Information into Your Mainframe Environment
Data Masking
DB2 Data Stores Session
Associating Supplied Masking Classes to Data Elements
Starting the Data Masking Module
Enabling Masking on the DB2 Table CUSTOMER
Submitting a JCL to Mask Customer First and Last Names
Creating a Class
Associating a Class to Data Elements
Enabling Masking on the DB2 Table CUSTOMER for the CODCUS Class
Submitting a JCL to Mask Customer IDs
Sequential Files Session
Associating Supplied Classes to Data Elements
Starting the Data Masking Module
Enabling Masking on the Sequential File CUSTOMER and NAME and SURNAME classes
Submitting a JCL to Mask Customer First and Last Names
Simple Data Subset Extraction
DB2 Data Stores Session
Associating a Class to a Data Element
Starting Data Subset Extraction
Creating a Group
Creating a Simple Method within a Group
Submitting a JCL to Subset Customer Names
Sequential Files Session
Associating a Class to a Data Element
Starting Data Subset Extraction
Creating a Group
Creating a Simple Method within a Group
Submitting a JCL to Subset Customer Names
Data Subset Extraction using Referential Integrity and Combined Data Elements
Creating the HSURDRIA table
Importing Referential Integrity Classes
Assigning Estimated Classes
Verifying Combined Data Element Information
Creating a Referential Integrity Method
Editing Method Properties
Submitting a JCL to Create the Test Environment
Data Element Sampling
Submitting a JCL to Perform Sampling
Verifying Results
Creating a Sampling Class
Associating a Fingerprint to a Class
Associating a Class to Data Elements
Data Generation
Catalog and Classify Tables
Start the Data Generation Module
Create Simple Data Generation Code
Execute a Simple Data Generation Law
Verify Results
Managing XML and Large-object Columns
Load and Classification
Masking
XML Tag Identifiers
Provided Templates
XML Masking Template UDCXML1
Dummy Masking Template UDCXML0
LOB/BLOB/CLOB Masking Template UDCLOB1
Data Masking Guide
Who Should Read this Guide
Data Masking Considerations
Getting Started
General Characteristics of Use
Starting Data Masking
Menus and Toolbars
File Menu
Tools Menu
View Menu
Windows Menu
Help Menu
Toolbar
Context Menus
Column Sorting
Grid Functions
Data Masking Main Window
Introduction
Window Components
Machine ID./Company Grid
All Machine ID./Companies
Multiple Class Selection
Object Distribution
Column Headings in the Grid Area
Available Grid Operations
Data Changer Data Store Properties
Introduction
Window Contents
General Attributes
System
Object Attributes
Dates
Assigned Copybook
Data Changer Data Element Selection
Introduction
Window Contents
Data Store Information
Icon Bar
List of Data Elements
Data Changer Data Element Properties
Introduction
General Data Element Properties
Additional Data Element Properties
Data Changer - Work with Classes
Introduction
Window Contents
Available Operations
Data Changer Properties
Introduction
Window Contents
Available operations
Set Application ID
Introduction
Window Contents
Available Operations
Define Unload Output Data Store
Introduction
Window Contents
Available Operations
Options
Introduction
General Options
Connection Options
Work with Data Changer Jobs
Introduction
Data Store Data Changer Job Creation
Create Data Changer Job Creation
Available Operations
Distributed Exporter
Window Contents
Available Operations
Exit Routines
Writing Exit Routines
Writing Routine Parameters
Discard Exit Routines
Discard Routine Parameters
UDCUSSL Discard Exit Routine Example
Modification Exit Routines
Predefined Modification Exit Routines List
Modification Exit Routines Parameters
Logging Exit Routines
Predefined Masking and Logging Exit Routines List
Masking Routine UDCMASPG - Prototype
Masking Routine UDCLOGPG – Prototype
Logging Table HSLOGTAB
Appendix A: COBOL Masking Routines Technical Description
A.1. Masking Routines Interface
A.2. Interface Source
A.2.1. Data Express for z/OS
A.2.2. Data Express for Distributed Systems
A.3. Interface Description
A.4. UR-ACTION Values
Appendix B: C Masking Routines for ODBC - Technical Description
Appendix C: C Masking Routines for OCI - Technical Description
Data Model Guide
Table and Column Descriptions
ANDCHFLF
ANENVDLS
ANENVLST
ANLICCHG
ANLICLOG
ANURDCLA
ANURDFLC
ANURDFLF
ANURDFLN
ANURDFXC
ANURDFXF
ANURDIMC
ANURDIMG
ANURDIXC
ANURDLOG
ANURDRFC
ANURDSNC
ANURDSPE
ANURDSPN
ANURDSTR
DDDTMCOL
DDDTMDEC
DDDTMREF
DDDTMSTQ
DDDTMTAG
HSDCHCLA
HSDCHFIL
HSDGNCOD
HSDGNDIR
HSDGNLAW
HSENVELB
HSENVEXT
HSENVFLT
HSENVGRP
HSENVLMT
HSENVMTH
HSENVPAR
HSENVPRN
HSENVRRD
HSENVRRH
HSENVSTP
HSLICCHG
HSLICFIL
HSLICFLD
HSLICLID
HSLICSTR
HSLOGTAB
HSSYSAUX
HSSYSCKS
HSSYSCOL
HSSYSDAU
HSSYSDBA
HSSYSDEP
HSSYSFKE
HSSYSIND
HSSYSIPA
HSSYSKEY
HSSYSRAU
HSSYSREL
HSSYSSYN
HSSYSTAB
HSSYSTAU
HSSYSTPA
HSSYSTSP
HSSYSVDE
HSSYSVIE
HSURDAPP
HSURDAUT
HSURDCAR
HSURDCJD
HSURDCJH
HSURDCLA
HSURDCOL
HSURDCOM
HSURDCPY
HSURDDFT
HSURDEKY
HSURDEXT
HSURDFIL
HSURDFIN
HSURDICP
HSURDJOB
HSURDKEY
HSURDLIC
HSURDLOG
HSURDMF
HSURDMFD
HSURDMID
HSURDNCC
HSURDPID
HSURDPRG
HSURDPRO
HSURDROU
HSURDSYC
HSURDSYT
HSURDUE
HSURDUEV
HSURDUSR
USDCHADD
USDCHCOM
USDCHEMA
USDCHNAC
USDCHNAM
USDCHSUC
USDCHSUR
USURDCBE
USURDCBZ
USURDDBM
USURDFLC
USURDIMP
USURDRIR
V1DCHFIL
V1DCHFLF
V1REP01
V1REP02
V1REP03
V1REP04
V1REP05
V1REP06
V1REP07
V1REP08
V1REP09
V1REP10
V1REP11
V1REP12
V1REP13
V1REP14
V1REP15
V1URDCPY
V1URDFIL
V1URDFLF
V1URDIMC
V1URDIMG
V1URDLOG
V1URDRFC
V2URDFLF
V3URDFLF
XPURDFLC
Sequential Files
Load Data Store Information from External Interface
DB2 Databases
Direct Access – API Load Sequential File
Direct Access – HEADER
Direct Access – DETAIL
Access from Unload
VSAM Databases
Sequential and GDG Databases
DL/I Databases
ADABAS Data Stores
ADABAS – API Load Sequential File - HEADER
ADABAS Data Store – DETAIL
DB2 Catalog Synchronization Information
DB2 Catalog Synchronization - HEADER
DB2 Catalog Synchronization - INTERNAL KEY
DB2 Catalog Synchronization - EXTERNAL KEY
DB2 Catalog Synchronization - IMAGE COPY
Load Copy Information from External Interface
Flag replace Parameter
Flag associate Parameter
Copy Tolerance Parameter
COBOL Decimal Seperator Parameter
Maximum Progressive of I/O Area Parameter
Statement Length in PL/I Source Parameter
Load Referential Integrity Relation Information
IMPSRC - Modified Sources
HEADER
DETAIL
Import Classification from Data Dictionary
Data Subset Extraction Guide
Who should read this guide
Data Subset Extraction considerations
Getting Started
General characteristics of use
Starting Data Subset Extraction
Menus
Context menus
Column sorting
Grid functions
Introduction to Data Subset Extraction window
Window components
Node pane
Icons
Context menu
Column headers by group
List of groups
List of methods in group
List of Steps in Method Group
Column headers by creator
List of creators
List of methods created by
List of steps in method creator
Work with Groups
Introduction to Work with Groups
Window contents
Available operations
New Method wizard
Introduction to New Method wizard
Creating a new method
Definition of general method characteristics
Definition of primary extraction criteria
Definition of relationship criteria
Available operations
Work with Method
Introduction to the Work with Method area
Method Confirmation phase
Method elaboration
Method Activation phase
Extraction Batch Job Launch phase
Fields
Steps context menu
Tabs
Elaborations
Column headings tabs
Context menu tabs
Excluded files
Column headings
Context menu
Method overview
Warnings
Available operations
Method confirmation
Work with Method selection class/filter properties
Introduction to selection class/filter properties
Window contents
Column headings in top grid
Global filter fields
Filter types
Filter type properties
Work with Method work with steps
Introduction Work with Method work with steps
Window contents
Display mode
Insert mode
Available operations
Work with Method method properties
Introduction to Work with Method method properties
Window contents
Available operations
Method activation
Work with Method elaboration properties
Introduction to Work with Method elaboration properties
Window contents
Method’s description
Elaboration’s description
Available operations
Work with Method define reload rules
Introduction to Work with Method define reload rules
Window contents
Available operations
Create reload jobs from reload rules
Job creation
Available operations
JCL information
Options
Introduction to Options
Window contents
General
Server information
Available operations
Data subset extraction jobs
Introduction to data subset extraction jobs
Job creation
Test environment creation
Create allocation jobs
Job creation
JCL information
Create unload jobs
Job creation
JCL information
Create extraction jobs
Job creation
JCL information
Create reload jobs
Job creation
JCL information
Available operations
Distributed Exporter
Window contents
Available operations
Distributed Statistics Loader
Window contents
Available operations
Work with Method multiple filters
Introduction to Work with Method multiple filters
More than one single filter for the same data store
Filter types
Filter examples more than one single filter
More than one combined filter involving more than one data element
Filter types
Filter examples more than one data element
Error Messages
Error Message Format
Mainframe Messages WRC0001 to WRC0199
Mainframe Messages WRC0200 to WRC0299
Mainframe Messages WRC0300 to WRC0399
Mainframe Messages WRC0400 to WRC0499
Mainframe Messages WRC0500 to WRC0599
Mainframe Messages WRC2000 to WRC4999
Data Express Extension Messages
Front End Guide
General Features
Considerations
Getting Started with Data Builder
General characteristics of use
Starting the Data Builder module
Work environment settings
Machine identifier creation
Company creation
Application identifier creation
Default environment parameter settings selection
Analysis parameter modification
Default copy analysis parameter modification
Database interface specification
Database access modes
Process identifier and database types relationships
Main functions - phase execution
Menus
File menu
Tools menu
Environment menu
View menu
Windows menu
Help menu
Context menu
Column sorting
Grid functions
Main Window - Work with Data Stores
Window pages
Structure page
Classes page
Assigned to Copy page
Sampling page
Data Changer page
Button bar
Column headings
Context menu
Properties- File
Register Tables page
Button bar
Context menu
Custom Query page
Column headings in the grid area
Available grid operations
Work with Data Store Window
Window contents
Node pane
Grid
Data Elements columns
Associated Copybook columns
Associated Copybook - CopybookName columns
Assigned Classes columns
Sampling columns
Sampling – DataElementName columns
Context menu
Data element properties
Assign an Application ID Window
Window contents - Assign Single
Window contents - Assign Multiple
Add to Combined Data Element Window
Combined data element requirements and limitations
Available operations
Work with Classes
Work with Classes window
Work with Machine IDs
Work with Machine IDs window
Work with Companies
Window contents
Available operations
Work with Application IDs
Window contents
Available operations
Work with Routines
Window contents
Available operations
Work with Process IDs
Window contents
Available operations
Work with Data Elements
Window contents
Select Data Elements page
Available Filters area
Data Element Attributes page
Naming Convention page
Data Store Attributes page
Data Element Class page
Available operations
Classes - Assignment page
All classes hierarchy
Class Attributes area
Available operations
Estimated Classes - Confirm page
Class Attributes area
Selected Data Element Attributes area
Data Element page
Data Store page
General page
Date page
Available operations
Work with Jobs
Window contents
List of Jobs grid
List of Scheduled Jobs grid
Window fields
Available operations
Job creation
Class Field Assignment job
Sections and fields
Available operations
Create Format Selector job
DB2 Catalog Synchronization job
Data Store / Copybook Relationship Analysis job
Data Store Data Element Sampling job
Load Distributed Sampling Results job
Import Classification from Data Dictionary job
Import Classification from Referential Integrity job
Import Method from Referential Integrity job
Load Copy Information from External Interface job
Load DB2 Table Information by Unload job
Load DL/I Database Information job
Load Data Store Information from External Interface job
Load SEQ/GDG Data Set Information job
Load VSAM Data Set Information job
Custom jobs
New Custom Query Wizard
Starting the New Custom Query wizard
Options
Window contents
General
Filter settings
Confirmation messages
Confirmation routine name
Server information
Available operations
File Properties
Window contents
General attributes page
System page
Object attributes page
Dates page
Associated Copybook page
Available operations
Filter by Data Store
Window contents
System page
Object page
Record page
Dates page
Associated Copybook page
Scheduling page
Available operations
Compare Layouts - Copybook
Window contents
Available operations
Sample Graph - Data Sampling
Window contents
Show Synthetic Data Element Contents
Window contents
Work with Copybooks
Window contents
Distributed Loader
Load from database
Load from file
Appendix A. Standard Mode
Architecture
Database connection prerequisite
DB2 database alias creation
Authorizations and privileges
Appendix B. Client / Server Mode
Architecture
Server connection prerequisite
Defining server connection information
Authorizations and privileges
Starting Server-side Executables as Windows Services
Life Cycle Guide
Considerations
Life Cycle Introduction
Life Cycle Phases
Phase 1: Changed Data Stores Identification
Phase 2: Changed Data Elements Identification
Phase 3: Apply Identified Changes
Sequential Steps
Concepts and Terms
Backup Company
Log Files
Working with Life Cycle
Definition of Environment
Work with Companies
New Company Creation
Available Operations
Execute Life Cycle Phase 1
Modification of Guide Files
Work with Changed Data Stores
Case 1 - New copybook is not associated with data store
Case 2 - Existing copybook is associated with an existing data store
Case 3 - Existing copybook is not associated with any data store
Case 4 - New copybook is associated with new data store (for DB2 files only)
Execute Life Cycle Phase 2
Work with Changed Data Elements
Execute Life Cycle Phase 3
Work with Life Cycle Jobs
Introduction
Life Cycle Job Creation
Clear Life Cycle History Job Creation
Available Operations
Process for z/OS Guide
Project Implementation
Data Inventory
Load Copybook Information
Load DB2 Tables
Load ADABAS Data Stores
Load Other Data Stores
Data Classification
Import Classification from Referential Integrity Job
Import Classification from Data Dictionary Job
Manual Association
Data Analysis
DB2 Catalog Synchronization
Data Subsetting
Method Creation
Work with Method Function
Extraction Jobs Submission
Output Flat File
Data Masking
Life Cycle
Phase 1
Phase 2
Phase 3
Image Copy
Starting Data Express for z/OS
Submission Function
GDG Support
z/OS Toolkit Guide
Considerations
Load Sequential File with DB2 Catalog
Load IMPSRC for Life Cycle
DB2 Catalog Synchronization
Create CSV File from Referential Integrity
Load Sequential File with ADABAS FDT Report
Toolkit Tables
Data Generation Guide
Who Should Read This Guide
Before Starting with Data Generation
Getting Started
Mode
Data Generation UI Guidelines
Starting the Data Generation Module
Directive Types
Distributed Exporter Utility
Executing Data Generation
Catalog Distributed Data
Catalog z/OS Data
Classify Data
Define Rules
Export Rules
Execute Rules
Data Generation Jobs
Introduction to Data Generation Jobs
Job Creation
Data Generation Jobs
Create Allocation Jobs
Job Creation
JCL Information
Create Reload Jobs
Job Creation
JCL Information
Glossary
Copyright
Data Manager Red Book
Data Manager Architecture and Workflow
Architecture
Workflow
Creating Test Data with Data Manager
Allocate PDS Libraries and Launch Data Manager
Submit a Job
Create a Workspace and Groups
Data Inventory Phase
Data Classification Phase
Data Masking Phase
Data Subsetting Phase
Moving Data into SQL Option for DB2
Moving a Test Data Schema into SQL Option for DB2
Moving Test Data into SQL Option for DB2
Appendix A: Schema JCL
Appendix B: Unload JCL
Appendix C: Load JCL
Studio Enterprise Edition
Server Enterprise Edition
Visual COBOL 2010 Enterprise Option
Enterprise Developer
Enterprise Server
Enterprise Test Server
Micro Focus Ant User Manual
Introduction
Usage
Defining Tasks and Types
Ant Tasks
analysis
asm
asmclean
bms
bmsclean
cobol
cobolclean
cobollbr
cobollink
ims
imsclean
pli
pliclean
plilink
Ant Types
mfdirlist
mffilelist
mfdestfilelist
ruleList
com.microfocus.cobol.runtimeservices Guide
API Documentation
Packages
com.microfocus.cobol.runtimeservices
com.microfocus.cobol.runtimeservices.servlet
Classes
com.microfocus.cobol.runtimeservices.RunUnitStartupOptions
com.microfocus.cobol.runtimeservices.RunUnitManager
com.microfocus.cobol.runtimeservices.RunUnit
com.microfocus.cobol.runtimeservices.IRunUnitManager
com.microfocus.cobol.runtimeservices.IRunUnit
com.microfocus.cobol.runtimeservices.Interop
com.microfocus.cobol.runtimeservices.CallableProgram
com.microfocus.cobol.runtimeservices.CallableProgram.ICancelProgramCallback
com.microfocus.cobol.runtimeservices.Callable
com.microfocus.cobol.runtimeservices.servlet.ServletRunUnitManager
Enterprise Sync
Installation and Administration Guide
Introduction
Key Benefits
Complementary Enterprise Products
Components
Server Components
Client Components
Concepts
General Concepts
Endevor/AccuRev Synchronization Support
General Considerations
Metadata Synchronization Support
On-Demand Synchronization Support
Required Credentials
Content Type Support
Change Package Support
Mapping Rules
Promote/Move Synchronization Rules
Moving Files in Endevor
Promoting Change Sets in AccuRev
Processing Endevor Sourceless Elements
Installation
Installing Enterprise Sync Server
Installing the AccuRev Server
Installing the AccuRev Windows Client
Installing Enterprise Developer
Installing the Enterprise Sync Add Pack
Installing the Workflow Manager Endevor Model
Administration
AccuRev Configuration
Define AccuRev User
Define AccuRev Depot
Define AccuRev Stream Structure
AccuRev Server Configuration
Installing the AccuRev Triggers
General Preparation before Customizing and Installing the Triggers
Installing the Trigger Supporting the On Demand Sync
Installing the Trigger for Defunct Deactivation and Read-Only Type Support
Enterprise Sync Server Configuration
Starting the UI
The Dashboard
Setting Synchronization Frequency
Setting Up Error Notification
Data Sources
Defining a Data Source
AccuRev Data Source Fields
Endevor Data Source Fields
Defining an Authenticator
Creating User Maps
Mapping Mainframe Users with AccuRev Users
Working with Connections
Creating and Editing Connections
Displaying Connection Information
Importing Project Definitions
Project Map File Includes/Excludes
Starting and Stopping Connections
Connection Status Values
Specific Considerations when Defining AccuRev to Endevor Connections
Changing the Configuration and Clearing Watermarks
Verifying the Installation and Configuration in Enterprise Developer
Glossary
Troubleshooting
Contacting Micro Focus
Creating a Dump File
Reviewing Log Files
Debugging the AccuRev Eclipse Plugin
Enterprise Developer and AWM Related Logs
AccuRev Server Logs
User's Guide for Mainframe Developers
Introduction
Audience
Using This Guide
The Bankdemo Sample
The Bankdemo Application in Endevor
The Bankdemo Application in AccuRev
The AccuRev Endevor Synchronization Rules/Configurations
Using AccuRev and Endevor with Enterprise Developer
Benefits
Features
Loading the AWM Application for Enterprise Sync
Creating an AccuRev Workspace
Navigating to AccuRev Files
Linking AccuRev Files to Micro Focus COBOL or PL/I Projects
Locking Endevor Elements
Editing Files in COBOL or PL/I Projects Linked to AccuRev
Promoting Files in AccuRev with Synchronization to Endevor
Navigating to Endevor Elements
Verifying Endevor Compile Results
Moving Files in Endevor and Synchronizing to AccuRev
Changing Files in Endevor and Synchronizing to AccuRev
Accepting Incoming Changes
Resolving Conflicts in AccuRev
Parallel Release Development
Data Express
Publications
Readme
System Requirements
Windows
z/OS
Extension Technology
Installation Notes
New Features
Updates and Product Support
Known Issues and Restrictions
Supplementary Information
Supported Character Encoding Systems
Supported Data Types
Data Type Restrictions
ADABAS Restrictions
Oracle Restrictions
DB2 for z/OS Environment Restrictions
AS/400 Data Stores
Readme Help
Contact Information
Installation Guide
Who Should Read This Guide
z/OS System Procedures
Installation Media
Installation Phases
New Software Installation Procedures
Allocate the Installation Sequential Data Set
Copy JCL Files to the Mainframe
Copy the Installation Data Set to the Mainframe
Allocate and Load the Installation PDS
Set Installation Parameters
Install the Data Set Libraries
Update the User Profile
Create the Database
Populate the Database
Enable Data Express for z/OS
Panels
Get Request Key
Apply Response Key
Display Enabled Options
Install Updates
Software Upgrade
Toolkit Installation
Installing Data Express Into Multiple DB2 Subsystems
Who Should Read This Information
Installation Cloning
Cloning Phases
Cloning a Database
Cloning Environment Libraries
Enabling a New Cloned Environment
Panels
Obtaining a Request Key
Applying the Response Key
Displaying Enabled Options
Install PTFs
Customization Reference
FTP Script Customization
FTP Script (ftpput.txt) Customization
FTP BAT File (ftpput.bat) Customization
PC3270 Transfer File List (inst.srl) Customization
PC3270 Transfer File List (kbd.srl) Customization
JCL File (iebupdte.jcl) Customization
Distributed Systems Procedures
Windows Installation
Installation Media
Software Setup
Software Update for Windows
UNIX Installation
Unix Software Updates
Getting Started with Distributed Data Stores
Using Distributed Data Stores with Data Express
DBA Tasks for Extension Technology
New Installations
Data Express Upgrades
Required Run-Time Knowledge Base Updates
Centralized Run-Time Knowledge Base for the ODBC Extension
Using Distributed Loader
Loading Data Store Information
Load from Database
Load from File
Limited Life Cycle Support
Use of Data Analysis (Sampling) for Class Assignment
Importing Classes
Data Dictionary
Referential Integrity
Sampling Results
Creating Referential Integrity Methods
Data Express for z/OS
Data Express for Distributed Systems
Using Distributed Exporter
Data Masking
Data Subset Extraction
SQL Files Generated by Distributed Exporter
Using Distributed Sampler
Sampling Options
Validation
Load results from file
Using Extension Technology
Extension Technology Configuration
Extension Technology Configuration File
Data Store SQL Scripts
DXCOMMON Environment Variable
Extension Technology Directories
Invoking Extension Technology
The dxestart command
Execution Modes
Error Diagnosis
Masking Routines
C
COBOL
Extension Technology Utilities
Creating an Encoded Connection File
Batch Distributed Exporter
Data Express for Distributed Data Stores Tutorials
Using Data Express
Preparation
Sample Session
Data Inventory
Sample Session
Data Masking
Sample Session
Simple Data Subset Extraction
Sample Session
Data Subset Extraction using Referential Integrity
Sample Session
Data Subset Extraction Using a Combined Data Element
Creating a Combined Data Element
Creating a Class on a Combined Data Element
Associating a Class with a Combined Data Element
Modifying a Referential Integrity Method to Use a Combined Data Element as a Selection Class
Exporting a Referential Integrity Method to Extension Technology
Executing Referential Integrity Method
Verifying Results
Simple Sampling
Sample Session
Data Generation
Catalog and Classify Tables
Start the Data Generation Module
Create Simple Data Generation Code
Execute a Simple Data Generation Law
Verify Results
Oracle Alias Creation
Oracle Wallet
Implementing Oracle Wallet Support
Getting Started with z/OS Data Stores
Product Components
Using z/OS Data Stores
Data Express for z/OS Tutorials
Sample Sessions
DB2 Data Stores Session
Importing JCL Job Streams into Your Mainframe Environment
Creating the DB2 Tablespace and Tables
Starting Data Builder
Setting Your Workspace
Loading Data Store Information into Your Mainframe Environment
Sequential Files Session
Importing the JCL CREASEQS into Your Mainframe Environment
Importing the Sequential File and Copybook Information into Your Mainframe Environment
Starting Data Builder
Setting Your Workspace
Loading Copybook Information into Your Mainframe Environment
Loading Data Store Information into Your Mainframe Environment
Data Masking
DB2 Data Stores Session
Associating Supplied Masking Classes to Data Elements
Starting the Data Masking Module
Enabling Masking on the DB2 Table CUSTOMER
Submitting a JCL to Mask Customer First and Last Names
Creating a Class
Associating a Class to Data Elements
Enabling Masking on the DB2 Table CUSTOMER for the CODCUS Class
Submitting a JCL to Mask Customer IDs
Sequential Files Session
Associating Supplied Classes to Data Elements
Starting the Data Masking Module
Enabling Masking on the Sequential File CUSTOMER and NAME and SURNAME classes
Submitting a JCL to Mask Customer First and Last Names
Simple Data Subset Extraction
DB2 Data Stores Session
Associating a Class to a Data Element
Starting Data Subset Extraction
Creating a Group
Creating a Simple Method within a Group
Submitting a JCL to Subset Customer Names
Sequential Files Session
Associating a Class to a Data Element
Starting Data Subset Extraction
Creating a Group
Creating a Simple Method within a Group
Submitting a JCL to Subset Customer Names
Data Subset Extraction using Referential Integrity and Combined Data Elements
Creating the HSURDRIA table
Importing Referential Integrity Classes
Assigning Estimated Classes
Verifying Combined Data Element Information
Creating a Referential Integrity Method
Editing Method Properties
Submitting a JCL to Create the Test Environment
Data Element Sampling
Submitting a JCL to Perform Sampling
Verifying Results
Creating a Sampling Class
Associating a Fingerprint to a Class
Associating a Class to Data Elements
Data Generation
Catalog and Classify Tables
Start the Data Generation Module
Create Simple Data Generation Code
Execute a Simple Data Generation Law
Verify Results
Managing XML and Large-object Columns
Load and Classification
Masking
XML Tag Identifiers
Provided Templates
XML Masking Template UDCXML1
Dummy Masking Template UDCXML0
LOB/BLOB/CLOB Masking Template UDCLOB1
Data Masking Guide
Who Should Read this Guide
Data Masking Considerations
Getting Started
General Characteristics of Use
Starting Data Masking
Menus and Toolbars
File Menu
Tools Menu
View Menu
Windows Menu
Help Menu
Toolbar
Context Menus
Column Sorting
Grid Functions
Data Masking Main Window
Introduction
Window Components
Machine ID./Company Grid
All Machine ID./Companies
Multiple Class Selection
Object Distribution
Column Headings in the Grid Area
Available Grid Operations
Data Changer Data Store Properties
Introduction
Window Contents
General Attributes
System
Object Attributes
Dates
Assigned Copybook
Data Changer Data Element Selection
Introduction
Window Contents
Data Store Information
Icon Bar
List of Data Elements
Data Changer Data Element Properties
Introduction
General Data Element Properties
Additional Data Element Properties
Data Changer - Work with Classes
Introduction
Window Contents
Available Operations
Data Changer Properties
Introduction
Window Contents
Available operations
Set Application ID
Introduction
Window Contents
Available Operations
Define Unload Output Data Store
Introduction
Window Contents
Available Operations
Options
Introduction
General Options
Connection Options
Work with Data Changer Jobs
Introduction
Data Store Data Changer Job Creation
Create Data Changer Job Creation
Available Operations
Distributed Exporter
Window Contents
Available Operations
Exit Routines
Writing Exit Routines
Writing Routine Parameters
Discard Exit Routines
Discard Routine Parameters
UDCUSSL Discard Exit Routine Example
Modification Exit Routines
Predefined Modification Exit Routines List
Modification Exit Routines Parameters
Logging Exit Routines
Predefined Masking and Logging Exit Routines List
Masking Routine UDCMASPG - Prototype
Masking Routine UDCLOGPG – Prototype
Logging Table HSLOGTAB
Appendix A: COBOL Masking Routines Technical Description
A.1. Masking Routines Interface
A.2. Interface Source
A.2.1. Data Express for z/OS
A.2.2. Data Express for Distributed Systems
A.3. Interface Description
A.4. UR-ACTION Values
Appendix B: C Masking Routines for ODBC - Technical Description
Appendix C: C Masking Routines for OCI - Technical Description
Data Model Guide
Table and Column Descriptions
ANDCHFLF
ANENVDLS
ANENVLST
ANLICCHG
ANLICLOG
ANURDCLA
ANURDFLC
ANURDFLF
ANURDFLN
ANURDFXC
ANURDFXF
ANURDIMC
ANURDIMG
ANURDIXC
ANURDLOG
ANURDRFC
ANURDSNC
ANURDSPE
ANURDSPN
ANURDSTR
DDDTMCOL
DDDTMDEC
DDDTMREF
DDDTMSTQ
DDDTMTAG
HSDCHCLA
HSDCHFIL
HSDGNCOD
HSDGNDIR
HSDGNLAW
HSENVELB
HSENVEXT
HSENVFLT
HSENVGRP
HSENVLMT
HSENVMTH
HSENVPAR
HSENVPRN
HSENVRRD
HSENVRRH
HSENVSTP
HSLICCHG
HSLICFIL
HSLICFLD
HSLICLID
HSLICSTR
HSLOGTAB
HSSYSAUX
HSSYSCKS
HSSYSCOL
HSSYSDAU
HSSYSDBA
HSSYSDEP
HSSYSFKE
HSSYSIND
HSSYSIPA
HSSYSKEY
HSSYSRAU
HSSYSREL
HSSYSSYN
HSSYSTAB
HSSYSTAU
HSSYSTPA
HSSYSTSP
HSSYSVDE
HSSYSVIE
HSURDAPP
HSURDAUT
HSURDCAR
HSURDCJD
HSURDCJH
HSURDCLA
HSURDCOL
HSURDCOM
HSURDCPY
HSURDDFT
HSURDEKY
HSURDEXT
HSURDFIL
HSURDFIN
HSURDICP
HSURDJOB
HSURDKEY
HSURDLIC
HSURDLOG
HSURDMF
HSURDMFD
HSURDMID
HSURDNCC
HSURDPID
HSURDPRG
HSURDPRO
HSURDROU
HSURDSYC
HSURDSYT
HSURDUE
HSURDUEV
HSURDUSR
USDCHADD
USDCHCOM
USDCHEMA
USDCHNAC
USDCHNAM
USDCHSUC
USDCHSUR
USURDCBE
USURDCBZ
USURDDBM
USURDFLC
USURDIMP
USURDRIR
V1DCHFIL
V1DCHFLF
V1REP01
V1REP02
V1REP03
V1REP04
V1REP05
V1REP06
V1REP07
V1REP08
V1REP09
V1REP10
V1REP11
V1REP12
V1REP13
V1REP14
V1REP15
V1URDCPY
V1URDFIL
V1URDFLF
V1URDIMC
V1URDIMG
V1URDLOG
V1URDRFC
V2URDFLF
V3URDFLF
XPURDFLC
Sequential Files
Load Data Store Information from External Interface
DB2 Databases
Direct Access – API Load Sequential File
Direct Access – HEADER
Direct Access – DETAIL
Access from Unload
VSAM Databases
Sequential and GDG Databases
DL/I Databases
ADABAS Data Stores
ADABAS – API Load Sequential File - HEADER
ADABAS Data Store – DETAIL
DB2 Catalog Synchronization Information
DB2 Catalog Synchronization - HEADER
DB2 Catalog Synchronization - INTERNAL KEY
DB2 Catalog Synchronization - EXTERNAL KEY
DB2 Catalog Synchronization - IMAGE COPY
Load Copy Information from External Interface
Flag replace Parameter
Flag associate Parameter
Copy Tolerance Parameter
COBOL Decimal Seperator Parameter
Maximum Progressive of I/O Area Parameter
Statement Length in PL/I Source Parameter
Load Referential Integrity Relation Information
IMPSRC - Modified Sources
HEADER
DETAIL
Import Classification from Data Dictionary
Data Subset Extraction Guide
Who should read this guide
Data Subset Extraction considerations
Getting Started
General characteristics of use
Starting Data Subset Extraction
Menus
Context menus
Column sorting
Grid functions
Introduction to Data Subset Extraction window
Window components
Node pane
Icons
Context menu
Column headers by group
List of groups
List of methods in group
List of Steps in Method Group
Column headers by creator
List of creators
List of methods created by
List of steps in method creator
Work with Groups
Introduction to Work with Groups
Window contents
Available operations
New Method wizard
Introduction to New Method wizard
Creating a new method
Definition of general method characteristics
Definition of primary extraction criteria
Definition of relationship criteria
Available operations
Work with Method
Introduction to the Work with Method area
Method Confirmation phase
Method elaboration
Method Activation phase
Extraction Batch Job Launch phase
Fields
Steps context menu
Tabs
Elaborations
Column headings tabs
Context menu tabs
Excluded files
Column headings
Context menu
Method overview
Warnings
Available operations
Method confirmation
Work with Method selection class/filter properties
Introduction to selection class/filter properties
Window contents
Column headings in top grid
Global filter fields
Filter types
Filter type properties
Work with Method work with steps
Introduction Work with Method work with steps
Window contents
Display mode
Insert mode
Available operations
Work with Method method properties
Introduction to Work with Method method properties
Window contents
Available operations
Method activation
Work with Method elaboration properties
Introduction to Work with Method elaboration properties
Window contents
Method’s description
Elaboration’s description
Available operations
Work with Method define reload rules
Introduction to Work with Method define reload rules
Window contents
Available operations
Create reload jobs from reload rules
Job creation
Available operations
JCL information
Options
Introduction to Options
Window contents
General
Server information
Available operations
Data subset extraction jobs
Introduction to data subset extraction jobs
Job creation
Test environment creation
Create allocation jobs
Job creation
JCL information
Create unload jobs
Job creation
JCL information
Create extraction jobs
Job creation
JCL information
Create reload jobs
Job creation
JCL information
Available operations
Distributed Exporter
Window contents
Available operations
Distributed Statistics Loader
Window contents
Available operations
Work with Method multiple filters
Introduction to Work with Method multiple filters
More than one single filter for the same data store
Filter types
Filter examples more than one single filter
More than one combined filter involving more than one data element
Filter types
Filter examples more than one data element
Error Messages
Error Message Format
Mainframe Messages WRC0001 to WRC0199
Mainframe Messages WRC0200 to WRC0299
Mainframe Messages WRC0300 to WRC0399
Mainframe Messages WRC0400 to WRC0499
Mainframe Messages WRC0500 to WRC0599
Mainframe Messages WRC2000 to WRC4999
Data Express Extension Messages
Front End Guide
General Features
Considerations
Getting Started with Data Builder
General characteristics of use
Starting the Data Builder module
Work environment settings
Machine identifier creation
Company creation
Application identifier creation
Default environment parameter settings selection
Analysis parameter modification
Default copy analysis parameter modification
Database interface specification
Database access modes
Process identifier and database types relationships
Main functions - phase execution
Menus
File menu
Tools menu
Environment menu
View menu
Windows menu
Help menu
Context menu
Column sorting
Grid functions
Main Window - Work with Data Stores
Window pages
Structure page
Classes page
Assigned to Copy page
Sampling page
Data Changer page
Button bar
Column headings
Context menu
Properties- File
Register Tables page
Button bar
Context menu
Custom Query page
Column headings in the grid area
Available grid operations
Work with Data Store Window
Window contents
Node pane
Grid
Data Elements columns
Associated Copybook columns
Associated Copybook - CopybookName columns
Assigned Classes columns
Sampling columns
Sampling – DataElementName columns
Context menu
Data element properties
Assign an Application ID Window
Window contents - Assign Single
Window contents - Assign Multiple
Add to Combined Data Element Window
Combined data element requirements and limitations
Available operations
Work with Classes
Work with Classes window
Work with Machine IDs
Work with Machine IDs window
Work with Companies
Window contents
Available operations
Work with Application IDs
Window contents
Available operations
Work with Routines
Window contents
Available operations
Work with Process IDs
Window contents
Available operations
Work with Data Elements
Window contents
Select Data Elements page
Available Filters area
Data Element Attributes page
Naming Convention page
Data Store Attributes page
Data Element Class page
Available operations
Classes - Assignment page
All classes hierarchy
Class Attributes area
Available operations
Estimated Classes - Confirm page
Class Attributes area
Selected Data Element Attributes area
Data Element page
Data Store page
General page
Date page
Available operations
Work with Jobs
Window contents
List of Jobs grid
List of Scheduled Jobs grid
Window fields
Available operations
Job creation
Class Field Assignment job
Sections and fields
Available operations
Create Format Selector job
DB2 Catalog Synchronization job
Data Store / Copybook Relationship Analysis job
Data Store Data Element Sampling job
Load Distributed Sampling Results job
Import Classification from Data Dictionary job
Import Classification from Referential Integrity job
Import Method from Referential Integrity job
Load Copy Information from External Interface job
Load DB2 Table Information by Unload job
Load DL/I Database Information job
Load Data Store Information from External Interface job
Load SEQ/GDG Data Set Information job
Load VSAM Data Set Information job
Custom jobs
New Custom Query Wizard
Starting the New Custom Query wizard
Options
Window contents
General
Filter settings
Confirmation messages
Confirmation routine name
Server information
Available operations
File Properties
Window contents
General attributes page
System page
Object attributes page
Dates page
Associated Copybook page
Available operations
Filter by Data Store
Window contents
System page
Object page
Record page
Dates page
Associated Copybook page
Scheduling page
Available operations
Compare Layouts - Copybook
Window contents
Available operations
Sample Graph - Data Sampling
Window contents
Show Synthetic Data Element Contents
Window contents
Work with Copybooks
Window contents
Distributed Loader
Load from database
Load from file
Appendix A. Standard Mode
Architecture
Database connection prerequisite
DB2 database alias creation
Authorizations and privileges
Appendix B. Client / Server Mode
Architecture
Server connection prerequisite
Defining server connection information
Authorizations and privileges
Starting Server-side Executables as Windows Services
Life Cycle Guide
Considerations
Life Cycle Introduction
Life Cycle Phases
Phase 1: Changed Data Stores Identification
Phase 2: Changed Data Elements Identification
Phase 3: Apply Identified Changes
Sequential Steps
Concepts and Terms
Backup Company
Log Files
Working with Life Cycle
Definition of Environment
Work with Companies
New Company Creation
Available Operations
Execute Life Cycle Phase 1
Modification of Guide Files
Work with Changed Data Stores
Case 1 - New copybook is not associated with data store
Case 2 - Existing copybook is associated with an existing data store
Case 3 - Existing copybook is not associated with any data store
Case 4 - New copybook is associated with new data store (for DB2 files only)
Execute Life Cycle Phase 2
Work with Changed Data Elements
Execute Life Cycle Phase 3
Work with Life Cycle Jobs
Introduction
Life Cycle Job Creation
Clear Life Cycle History Job Creation
Available Operations
Process for z/OS Guide
Project Implementation
Data Inventory
Load Copybook Information
Load DB2 Tables
Load ADABAS Data Stores
Load Other Data Stores
Data Classification
Import Classification from Referential Integrity Job
Import Classification from Data Dictionary Job
Manual Association
Data Analysis
DB2 Catalog Synchronization
Data Subsetting
Method Creation
Work with Method Function
Extraction Jobs Submission
Output Flat File
Data Masking
Life Cycle
Phase 1
Phase 2
Phase 3
Image Copy
Starting Data Express for z/OS
Submission Function
GDG Support
z/OS Toolkit Guide
Considerations
Load Sequential File with DB2 Catalog
Load IMPSRC for Life Cycle
DB2 Catalog Synchronization
Create CSV File from Referential Integrity
Load Sequential File with ADABAS FDT Report
Toolkit Tables
Data Generation Guide
Who Should Read This Guide
Before Starting with Data Generation
Getting Started
Mode
Data Generation UI Guidelines
Starting the Data Generation Module
Directive Types
Distributed Exporter Utility
Executing Data Generation
Catalog Distributed Data
Catalog z/OS Data
Classify Data
Define Rules
Export Rules
Execute Rules
Data Generation Jobs
Introduction to Data Generation Jobs
Job Creation
Data Generation Jobs
Create Allocation Jobs
Job Creation
JCL Information
Create Reload Jobs
Job Creation
JCL Information
Glossary
Copyright
Data Manager Red Book
Data Manager Architecture and Workflow
Architecture
Workflow
Creating Test Data with Data Manager
Allocate PDS Libraries and Launch Data Manager
Submit a Job
Create a Workspace and Groups
Data Inventory Phase
Data Classification Phase
Data Masking Phase
Data Subsetting Phase
Moving Data into SQL Option for DB2
Moving a Test Data Schema into SQL Option for DB2
Moving Test Data into SQL Option for DB2
Appendix A: Schema JCL
Appendix B: Unload JCL
Appendix C: Load JCL
Studio Enterprise Edition
Server Enterprise Edition
Visual COBOL 2010 Enterprise Option
Enterprise Analyzer
Enterprise Analyzer
Enterprise View
Modernization Workbench
Enterprise Analyzer
Enterprise View
Modernization Workbench
Micro Focus Connect
Connect
Connect
Micro Focus Developer
extend Interoperability Suite
COBOL Analyzer
com.microfocus.cobol.runtimeservices Guide
API Documentation
Packages
com.microfocus.cobol.runtimeservices
com.microfocus.cobol.runtimeservices.servlet
Classes
com.microfocus.cobol.runtimeservices.RunUnitStartupOptions
com.microfocus.cobol.runtimeservices.RunUnitManager
com.microfocus.cobol.runtimeservices.RunUnit
com.microfocus.cobol.runtimeservices.IRunUnitManager
com.microfocus.cobol.runtimeservices.IRunUnit
com.microfocus.cobol.runtimeservices.Interop
com.microfocus.cobol.runtimeservices.CallableProgram
com.microfocus.cobol.runtimeservices.CallableProgram.ICancelProgramCallback
com.microfocus.cobol.runtimeservices.Callable
com.microfocus.cobol.runtimeservices.servlet.ServletRunUnitManager
Visual COBOL
Visual COBOL Development Hub
COBOL Server
Micro Focus Ant User Manual
Introduction
Usage
Defining Tasks and Types
Ant Tasks
analysis
asm
asmclean
bms
bmsclean
cobol
cobolclean
cobollbr
cobollink
ims
imsclean
pli
pliclean
plilink
Ant Types
mfdirlist
mffilelist
mfdestfilelist
ruleList
Server Express Remote Development Option
Start Here
Remote Development
Overview of COBOL Remote Development using Eclipse
To create a COBOL remote application in Eclipse
Tutorials and Demonstrations
Information Sources
Licensing
Licensing Concepts
Remote Development Licensing
Using the Sentinel RMS License Server for Remote Development Option
Licensing Tasks
Sentinel RMS license server
To start the Sentinel RMS license server
To stop the Sentinel RMS license server
Managing your licenses
To start the Licensing System Administration tool
To authorize your product
To install licenses from a license file
To view installed licenses
To configure licenses
To revoke licenses
UNIX and Linux Licensing Messages
Error - Initalizing: Cannot find initialisation file
Error - Unable to manage licenses in license manager that is not running on localhost
Error authorizing... Remote request error - The authorization code is invalid
Unable to authorise ()
Product Information
Micro Focus End User License Agreement
Known Errors and Restrictions for Server Express Remote Development Option
Background Parsing
Build Configurations
Adding Link Libraries
COBOL Dialects
COBOL Launch Configuration
Resource Outside a COBOL Project
Slow Performance
COBSQL and Oracle
Debug Configurations
COBOL Attach to Remote Application Configuration
Leaking File Handles
Contacting Micro Focus
Help with Problems
Information We Need
Contact Information
Remote Development
Remote Development Concepts
Overview of Remote Development Option
Remote Development Option- Prerequisites
What is Remote System Explorer?
Preparing for Remote Development
To create a remote connection
To configure a remote connection
To configure the remote server
To launch a server on the remote host
To launch a server on the remote host using a daemon process
To launch a server on the remote host without a daemon process
Remote System Explorer logging
Using Eclipse for COBOL Development
Creating COBOL Applications
Perspectives and Projects
COBOL Editor
Project Properties and Configurations
To Create, Build and Run COBOL
To create a COBOL remote project
To convert a COBOL local project to a COBOL remote project
To add files to a COBOL remote project
To import existing files
To build a COBOL project
To set build properties for a single file
To run an application
Building COBOL Remote Projects
Debugging COBOL Applications
Debugging Overview
Debugging COBOL in Eclipse
Debug Configurations
COBOL Remote Application
COBOL Attach to Remote Application
COBOL Wait for Remote Application Attachment
To Create a Debug Configuration
Programming
Application Extension with Distributed Computing
What is Distributed Computing?
Servers and Server Enterprise Edition
Creating 64-bit Programs
Introduction
Creating 64-bit Programs from 32-bit Programs
Compiling Programs for 64-Bit
Pointers
Single Sourcing
Library Routine Prototypes
Object Code and Intermediate Code
File and FCD Handling
Single Sourcing and Dual FCD Support
Scan64
Introduction
Object Missing
Starting Scan64
Examples of Using Scan64
Modification of Pointers by Implicit Redefinition
Possible Pointer Modification Via CALL Statements and Prototypes
Explicit and Implicit Definitions of Pointers in Call Prototypes
Constant and Variable Indexing
Constant and Variable Reference Modification
Error Messages
SCAN64: Old int code with D4 operations not supported
SCAN64: Old int code with D7 operations not supported
SCAN64: Cobol COMMS not checked
SCAN64: File records are not checked
SCAN64: Adis accept/display not checked
Unsupported Features
Calling COBOL Programs
Specifying the Program to Be Called
Naming a Program in its PROGRAM-ID Paragraph
Entry Point Mapping for COBOL Programs
Calling a Program Using an Implicit Program Name
Calling a Program Using an Explicit Program Name
Calling Entry Points in Subprograms
Calling Programs According to How They Are Linked
State of the Data when a Program is Called Again
Search Conventions Used for Calling Programs
Passing Parameters to a Called Program
Passing Return Codes Back to the Calling Program
Call Prototypes
About Call Prototypes
The ANY Keyword
Relaxed Type-checking
Using Type Definitions
Using the Library Routine Type Definitions and Call Prototypes
Communications
Communications and Client/Server Binding
Client/Server Binding
Introduction
How the Client/Server Binding Works
How to Use the Client/Server Binding
The Client/Server Binding Copyfile
The Client/Server Binding Configuration File
Configuration File Parameters
Minimum Required Configuration File Entries
Locating the Configuration File
Connecting Your Client Program to mfclient
Connecting Your Server Program to mfserver
Running a Client/Server Binding Application
Debugging Your Application
Managing the Server
Shutting Down mfserver
Managing Authorisation Passwords
Setting the Maximum Number of Clients
Enabling Server Override
Advanced Topics
System Log File
Creating Audit Trails
Overriding Configuration File Entries
Using Dialog System 'Callout'
Using an existing Dialog System program as the server module
Using the In-line Configuration Facility
The Reduced Data Transfer Facility
Server Controlled File Management Facility
Client/Server Binding Limitations
Client/Server Binding for Server Enterprise Edition
Prerequisites
Overview
How It Works
Summary of Changes
Not Supported in this Release
Supported in this Release
New Features in this Release
Improvements
Advantages over Implementations using CCI
Advantages over Implementations using AAI
Client Side Requirements
Server Side Requirements
Development and Sample files
What You Need To Do
Starting the Directory Server
Deploying the Default Service
Adding Extra Services
Installing the Server Module
Start the Enterprise Server
Setting the Service Status
Setting the Listener Status
Migration Considerations
Understanding the Changes in Server Management
Notes and Recommendations
Configuring Micro Focus Common Client
Using a Fixed TCP Port
Using the machinename parameter
Using the New Configuration Options
Performance Planning
Restrictions
Configuring CCI Introduction
CCI Support for APPC
CCI Support Modules for APPC
Pre-requisite SNA Support for CCIAPPC
APPC Configuration
APPC Product Configuration Guides
Application Configuration
CCIAPPC Server Name
CCIAPPC Machine Name
Troubleshooting
CCIIPX Configuration
CCI Support for Novell NetWare IPX
CCI Support Modules for IPX
Novell NetWare IPX Configuration
Configuring CCIIPX Parameters
CCI.INI File Options for CCIIPX
Application Configuration
CCIIPX Server Name
CCIIPX Machine Name
CCINETB Configuration
CCI Support for NetBIOS
CCI Support Modules for NetBIOS
Configuring the Environment for Using CCINETB
Which Protocol will CCINETB Use?
Using Multiple Adapters on Windows 95
Configuring CCINETB Parameters
CCI.INI File Options for CCINETB
Why would I need to use any CCI.INI options?
What form do CCI.INI options take?
Available CCI.INI Options for CCINETB
Application Configuration
CCINETB Server Name
CCINETB Machine Name
CCITCP Configuration
CCI Support For TCP/IP
CCI Support Modules for TCP/IP
TCP/IP Configuration
Running the CCI Configuration Utility
CCI Configuration for UNIX Users
Using CCITCP2
Using Directory Server Instead of CCITCP2
CCITCP2 Search Order
CCITCP2 Troubleshooting
Advanced Features
Running CCITCP2 as an NT Service
Using CCI Over TCP/IP Without CCITCP2
Direct Connection and Starting Servers on Fixed Ports
Environment Variables and the CCI.INI File
CCITCP Environment Variables
CCITCP Options in the CCI.INI File
Application Configuration
CCITCP Server Name
CCITCP Machine Name
CCINAMPU Configuration
CCI Support for UNIX Named Pipes (FIFO's)
CCI Support Module for UNIX Named Pipes
Transport Speed
CCI.INI File Options for CCINAMPU
Application Configuration
CCINAMPU Server Name
CCINAMPU Machine Name
Default Service Location
Common Error Status
Application Configuration
CCI Configuration for the Mainframe Access Product Suite
An example of using APPC with Mainframe Access
An example of using TCP/IP with Mainframe Access
CCI Configuration for Fileshare
Generic Fileshare Configuration
Example FHREDIR.CFG Configuration File for Use with APPC
Example FHREDIR.CFG Configuration File for Use with Multiple CCI Modules
Example FHREDIR.CFG Configuration File for Use with Default CCI Modules
CCI Configuration for Applications
CCI Configuration Information by Protocol
Advanced Use of CCITCP Without Using CCITCP2
CCI Trace
Activating CCI Trace
CCI Trace Options
CCITRACE Environment Variable
CCI.INI Trace Options
CCI.INI - The CCI Configuration File
What is the CCI.INI File?
Where to Locate CCI.INI
The Format of CCI.INI
Specific Contents of CCI.INI for Each CCI Module
CCI Status Messages
CCI Status Messages
CCI Message Table
Attachmate Personal Client v6.3
Installing DLC for Windows 95
Installing Attachmate Personal Client
Configuring Attachmate Personal Client
Step 1: Creating a New Configuration
Step 2: Local Node Definition
Step 3: Data Link Control Definition
Step 4: Port Definition
Step 5: Configuring the 802.2 Template (Port Definition)
Step 6: Link Definition
Step 7: Configuring the 802.2 Template (Link Definition)
Step 8: Configuring a 3270 LU for Terminal Emulation
Step 9: Configuring LU's for APPC
Step 10: Configuring the Local LU
Step 11: Configuring the Remote LU
Step 12: Adjacent Link Definition
Step 13: Configuring Session Limits - Defining a Mode
Step 14: Enabling CCIAPPC to Find the Local LU
Step 15: Updating the System Path
Step 16: Activating the Configuration
Error Reporting and Diagnostics
Known Problems
Attachmate Personal Client v6.1 and v6.2
Installing DLC for Windows 95
Installing Attachmate Personal Client
Configuring Attachmate Personal Client
Step 1: Creating a New Configuration
Step 2: Local Node Definition
Step 3: Data Link Control Definition
Step 4: Configuring the NCIA Template (Data Link Control)
Step 5: Port Definition
Step 6: Configuring the 802.2/NCIA Template (Port Definition)
Step 7: Link Definition
Step 8: Configuring the 802.2/NCIA Template (Link Definition)
Step 9: Configuring a 3270 LU Pool
Step 10: Configuring LU's for APPC
Step 11: Configuring the Local LU
Step 12: Configuring the Remote LU
Step 13: Adjacent Link Definition
Step 14: Enabling CCIAPPC to Find the Local LU
Step 15: Updating the System Path
Step 16: Activating the Configuration
Error Reporting and Diagnostics
IBM Communications Server v5.01 for Windows NT
Installing IBM Communications Server
Installing IBM LLC2 Protocol for Windows NT
Configuring IBM Communications Server
Configuring the Node
Step 1: Node Setup
Basic Settings
Advanced Settings
DLU Requester Settings
Step 2: Device Configuration
Basic Settings
Advanced Settings
Performance Settings
Step 3: Connection Configuration
Basic Settings
Advanced Settings
Security Settings
Step 4: Enable API Client Support (Configure the Gateway)
SNA Clients Settings
Step 5: Local LU Configuration
Step 6: Partner LU 6.2 Configuration
Basic Settings
Advanced Settings
Configuring Session Limits: Defining a Mode
Step 7: Configuring Modes (Optional)
Basic Settings
Advanced Settings
Configuring the IBM Communications Server SNA Client
Creating User IDs
Creating the SNA Client Configuration File
Enabling CCIAPPC to Find the Local LU
To Set the APPCLLU in the Windows NT Environment
To Set the APPCLLU in the Windows 95 Environment
Verifying the Configuration
Activating the Configuration
Testing the Configuration
Error Reporting and Diagnostics
Known Problems
IBM Personal Communications v4.2 for Windows 95 and Windows NT
Installing IBM IEEE 802.2 LAN Interface
Configuring IBM Personal Communications
Configuring the Node
Step 1: Node Setup
Basic Settings
Advanced Settings
DLU Requester Settings
Step 2: Device Configuration
Basic Settings
Advanced Settings
Performance Settings
Step 3: Connection Configuration
Basic Settings
Advanced Settings
Security Settings
Step 4: Local LU Configuration
Step 5: Partner LU 6.2 Configuration
Basic Settings
Advanced Settings
Configuring Session Limits: Defining a Mode
Step 6: Configuring Modes (Optional)
Basic Settings
Advanced Settings
Enabling CCIAPPC to Find the Local LU
To Set the APPCLLU in the Windows NT Environment
To Set the APPCLLU in the Windows 95 Environment
Verifying the Configuration
Activating the Configuration
Testing the Configuration
Error Reporting and Diagnostics
Known Problems
Microsoft SNA Server v3.0
Installing DLC for Windows NT or 95
Installing Microsoft SNA Server
Configuring Microsoft SNA Server
Step 1: Configuring the Local Server
Step 2: Configuring the Link Service
Step 3: Configuring the Connection
Step 4: Configuring the Connection Address
Step 5: Configuring the System Identification
Step 6: Configuring 802.2 DLC Properties
Step 7: Configuring Local LUs
Step 8: Configuring Remote LUs
Configuring Session Limits: Defining a Mode
To Define a New Mode
Step 9: Enabling CCIAPPC to Find the Local LU
Step 10: Configuring a 3270 LU for the 3270 Applet
Step 11: Associating a 3270 LU with a User
Step 12: Activating the Configuration
Error Reporting and Diagnostics
Known Problems
Microsoft SNA Server v2.11
Installing DLC for Windows NT or 95
Configuring Microsoft SNA Server
Step 1: Configuring the Local Server
Step 2: Configuring the Adapter
Step 3: Configuring the Connection
Step 4: Configuring the Connection Setup
Step 5: Configuring Local LUs
Step 6: Configuring Remote LUs
Step 7: Partnering LUs
Configuring Session Limits: Defining a Mode
To Define a New Mode
Step 8: Enabling CCIAPPC to Find the Local LU
Step 9: Configuring a 3270 LU for the 3270 Applet
Step 10: Associating a 3270 LU with a User
Step 11: Activating the Configuration
Error Reporting and Diagnostics
Rumba Office 95/NT
Installing DLC for Windows 95
Installing Rumba Office 95/NT
Configuring Rumba Office 95/NT
Step 1: Enter Network Name and Control Point Name
Step 2: Configuring the Connection
Step 3: 802.2 DLC Configuration
Step 4: Configuring the Advanced Options
Step 5: Configuring Local LU's
Step 6: Configuring Local LU's Advanced Options
Step 7: Configuring a Dependent LU to be Used for a 3270 Terminal Session
Step 8: Configuring Dependent Local LU's Advanced Options
Step 9: Configuring Remote LU's
Step 10: Configuring Remote LU's Advanced Options
Step 11: Configuring Session Limits: Defining a Mode
To Define a New Mode
Step 12: Enabling CCIAPPC to Locate the Local LU
Step 13: Saving your Configuration
Step 14: Updating the System Path
Step 15: Activating the Configuration
Error Reporting and Diagnostics
Support for Attachmate EXTRA! Personal Client
Mainframe Access may hang with CCIAPPC and Attachmate EXTRA! Personal Client 32 Bit
Configuring DLC over 802.2 on Windows 95
Installing DLC for Windows 95
Step 1: Downloading MSDLC32.EXE
Step 2: Select Network from the Control Panel
Step 3: Adding a Protocol
Step 4: Select Component Type
Step 5: Select Have Disk
Step 6: Finishing up and Restarting Windows '95
Configuring DLC over 802.2 on Windows NT
Installing DLC for Windows NT
Step 1: The Microsoft 32-bit DLC Driver
Step 2: Select Network from the Control Panel
Step 3: Adding a Protocol
Step 4: Select Network Protocol
Step 5: Specify the Location of the Windows NT Files
Step 6: Finishing up and Restarting Windows NT
Compatibility Guide
Introduction
Compatibility Directives
DG
RM
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
RM/COBOL Source Programs
The RM Directive
RM/COBOL File Status Codes
Perform Statements
Table Bound Checking
Types of Data
COMPUTATIONAL (COMP) Data Types
COMPUTATIONAL-1 (COMP-1) Data Types
The DECIMAL POINT IS COMMA Clause
PICTURE Character-strings
COMPUTATIONAL-6 (COMP-6) Data Types
RM/COBOL Conversion Issues
Producing Executable Code
Length of Nonnumeric Literals
Source Code in Columns 73 to 80
Linkage Section in Main Program
Reserved Words
Numbering of Segments
Program Identification and Data-names
Duplicate Paragraph-names
Running the Code
Trailing Blanks in Line Sequential Files
Undefined Results of MOVE and Arithmetic Operations
Embedded Control Sequences in DISPLAY Statements
Printer Output is Written to Disk
Redefinition of COMPUTATIONAL or COMPUTATIONAL-6 Data Items
ON SIZE ERROR Phrase
Field Wrap-Around
COMPUTATIONAL-1 Data Items with a PICTURE other than S9(4)
File and Record Locking
Initialization of Working Storage
Screen Column Number Specification
End of File Notification
ACCEPT Fields at the Edge of the Screen
Display of Input Data in Concealed ACCEPT Fields
Open EXTEND of Nonexistent File
Converting RM/COBOL Data Types
COMP/COMPUTATIONAL Data
COMP-3/COMPUTATIONAL-3 Data
COMP-6/COMPUTATIONAL-6 Data
DISPLAY Data
Database Access
Database Access Guide
Database Access Facilities
Introduction to Database Access Facilities
Overview
OpenESQL
DB2 ECM
Embedded SQL
Case
Building your Application
Multiple Program Modules
Host Variables
Overview
Declaring Host Variables
OpenESQL and DB2 Preprocessor
Host Arrays
The FOR Clause
Determining the Number of Rows Processed
The DB2 Preprocessor
Indicator Variables
Null Values
Data Truncation
Indicator Arrays
Data Types
Converting Data Types
Integer Data Types
Tiny Integer
Small Integer
Integer
Big Integer
Character Data Types
Fixed-length Character Strings
Variable-length Character Strings
Unicode Character Strings
Approximate Numeric Data Types
Exact Numeric Data Types
Date and Time Data Types
OpenESQL
Binary Data Types
OpenESQL
OpenESQL SQL TYPEs
BINARY
CHAR-VARYING
DATE
DATE-RECORD
TIMESTAMP and TIMESTAMP-RECORD
Cursors
Overview
Declaring a Cursor
Object Oriented COBOL Syntax
Opening a Cursor
Using a Cursor to Retrieve Data
Closing a Cursor
Cursor Options
Positioned UPDATE and DELETE Statements
Using Cursors
Data Structures
SQL Communications Area (SQLCA)
The SQLCODE Variable
The SQLSTATE Variable
The Warning Flags
The WHENEVER Statement
COBSQL
SQLERRM
SQLERRD
DB2
The SQL Descriptor Area (SQLDA)
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
Executing Dynamic SQL Statements
EXECUTE IMMEDIATE Statement
FREE Statement (COBSQL Informix)
Dynamic SQL Statements and Cursors
CALL Statements
Example
OpenESQL
ODBC Drivers and Data Source Names
Setting up a Data Source Name
Oracle OCI Support
SQL Compiler Directive
The SQL Compiler Directive Options
Creating Debug Files
Database Connections
Keywords
Building an Application
Demonstration Applications
Managing Transactions
Data Types
Using the SQLCA
OpenESQL Stored Procedures
Positioned Update
Example
Unicode Support in OpenESQL
DB2 External Compiler Module
Character Data
Additional Data Types
Compound SQL
Extensions to Embedded SQL Support
The INCLUDE Statement
The DECLARE TABLE Statement
Integer Host Variables
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
INIT DB2 Directive Option
UDB-VERSION DB2 Directive Option
Compiling
DB2 Compiler Directive
DB2 Compiler Directive Options
Error Codes
Creating Debug Files
Building Applications
Stand-alone DB2 Applications
Client DB2 Applications and Stored Procedures
Binding
Host Compatibility Option Technical Guide
Introducing HCO
Prerequisite Software
HCO Tools
Sample Programs
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 Unsupported by DB2 LUW
Special Registers
Other Functions
Running HCO Tools
What to Do First
Accessing a Database on the Mainframe
HCO Tools
Create Database
Command Line Interface
DDL Processor
Downloading Source DDL
Downloading Data to Load Tables
Using the DDL Processor to Load Data
Command Line Interface
DCLGEN
Command Line Interface
DCLGEN Tool Examples
Exporting Data
Limitations
Command Line Interface
Importing Data
Limitations
Command Line Interface
Compiling and Run Time
Compiling DB2 Programs with HCO
Overview
DDL Processing
Collating Sequence For Data
Invoking the DB2 ECM
Using DB2 LUW V7.1 and Later
Error Messages When Compiling Program
Run-time Services
MFHCOCDS
Dynamic Bind Utility
DSNTIAR and DSNTIAC
Example
Return Codes
MFHCOEBC
Database Access Reference
OpenESQL
Embedded SQL Statements
BEGIN DECLARE SECTION
BEGIN TRAN
CALL
CLOSE
COMMIT
CONNECT
DECLARE CURSOR
DECLARE DATABASE
DELETE (Positioned)
DELETE (Searched)
DESCRIBE
DISCONNECT
END DECLARE SECTION
EXECSP
EXECUTE
EXECUTE IMMEDIATE
FETCH
GET HDBC
GET HENV
INCLUDE
INSERT
OPEN
PREPARE
QUERY ODBC
ROLLBACK
SELECT DISTINCT (using DECLARE CURSOR)
SELECT INTO
SET AUTOCOMMIT
SET CONCURRENCY
SET CONNECTION
SET OPTION
SET SCROLLOPTION
SET TRACELEVEL
SET TRANSACTION ISOLATION
UPDATE (Positioned)
UPDATE (Searched)
WHENEVER
SQL/COBOL Data Type Mappings
Data Structures
The SQLCA Data Structure
The SQLDA Data Structure
SQL Compiler Directive Options
ALLOWNULLCHAR
ANSI92ENTRY
AUTOCOMMIT
AUTOFETCH
BEHAVIOR
DEF_CURSOR
PF_RO_CURSOR
PF_UPD_CURSOR
RO_CURSOR
UPD_CONCURRENCY
UPD_CURSOR
CHECK
CHECKDUPCURSOR
CHECKSINGLETON
CONCAT
CONNECTIONPOOL
CTRACE
CURSORCASE
DB
DBMAN
DECDEL
DETECTDATE
ESQLVERSION
FIPSFLAG
GEN-CC2
GEN-INIT-FLAG
IGNORE-NESTED
INIT
ISOLATION
JIT
MARS
NIST
NOT
ODBCTRACE
ODBCV3
PARAMARRAY
PASS
PRE
PREFETCH
QUALFIX
RESULTARRAY
STMTCACHE
TARGETDB
THREAD
TRACELEVEL
USECURLIB
OpenESQL Messages
SQLSTATE Values
SQLCODE Values
OpenESQL Preprocessor Error Messages
DB2
DB2 Compiler Directive Options
ACCESS
ACTION
BIND
BLOCK
CALL_RESOLUTION
CASE
CCSIDG
CCSIDM
CCSIDS
CHARSUB
COLLECTION
COMMIT
CONCAT
CONNECT
COPY
CTRACE
DB
DEC
DECDEL
DEFERRED_PREPARE
DEGREE
DISCONNECT
DYNAMICRULES
ENCODING
EXPLAIN
EXPLSNAP
FEDERATED
FORMAT
FUNCPATH
GENERIC
GEN-INIT-FLAG
GEN-SQLCA
HOSTVAR
IGNORE-NESTED
IMMEDIATE
IMMEDWRITE
INIT
INSERT
ISOLATION
KEEPDYNAMIC
LANGLEVEL
LEVEL
MSGAREA
MULTI-NESTED
NOT
OPTHINT
OS400NAMING
OWNER
PASS
PRE
QUALFIX
QUALIFIER
QUERYOPT
RELEASE
REOPT
REPLVER
RETAIN
SORTSEQ
SQLERROR
SQLFLAG
SQLRULES
SQLWARN
STATICREADONLY
STRDEL
SYNCPOINT
SYNTAX
TEXT
TRANSFORM-GROUP
UDB-VERSION
VALIDATE
VERSION
DB2 ECM Error Messages
COBDB0002 - COBDB0021
COBDB0100 - COBDB0115
COBDB0116 - COBDB0901
Keywords
Database Connectors
Database Connectors User's Guide
Database Connectors Overview
Introduction
RDBMS Support
Accessing Data
Interface Routines
Extended File Descriptors (XFDs)
Database Concepts
How Database Connectors Works
What Is a Transparent Interface?
XFDs and Mapping
Summary
Getting Started
Licensing
Installing an Alternate License
The Activator Utility
Installation
The Demonstration Program
XFDs
XFD Files
How XFDs are Formed
Defaults Used in XFD Files
KEY IS Phrase
REDEFINES Clause
Summary of XFD Fields
Identical Field Names
Long Field Names
Naming the XFD File
Forming the Final XFD Name
Mapping Other Files to an XFD
Using XFD Directives
Introduction
XFD Directive Syntax
Line Continuation for Complex XFDs
Supported XFD Directives
Invalid Data
Illegal COBOL Data
Invalid Key Data
Invalid Data Other Than Keys
Invalid Database Data
Working with COBOL
Preparing and Compiling a Program Example
Compiling with just the CREATEXFD directive
Compiling with the WHEN XFD Directive
Using Additional XFD Directives
Creating a COBOL Application
Turning on Tracing
New and Existing Databases
Databases
Default Behavior
Accessing Existing Database Files
How Do I Match Existing Text Fields?
How Do I Match Existing Numeric Fields?
Field Names
Resolving Name Conflicts
Index Names
Run-time Configuration
ACUFH Configuration Variables
Enabling Dynamic Redirection to a Custom File Handler
Performance and Troubleshooting
Performance Issues
Guidelines
The WHERE Constraint
Troubleshooting
Compiler Errors
Compiler Warnings
Run-time System Errors
Using the FILE_TRACE ACUFH Configuration Variable
Retrieving Messages Using the CTF
General Questions and Answers
Questions and Answers
Appendix B: Database Connectors for Microsoft SQL Server
Microsoft SQL Server Concepts Overview
Installation and Setup
Installing on a Client Machine
Installation Steps for a Windows Client
Setting Up a User Account
Setting Up the User Environment
Designating the Host File System
Filename Translation
ACUFH Configuration File Variables
Using the Database Table
Table Locking
Stored Procedures
Developer- or Site-supplied Stored Procedures
Built-in Stored Procedures
Limits and Ranges
Run-time System Errors
Common Questions and Answers
Database Connectors Tasks
To check the database table
To create an empty table and grant access privileges to other users
To create an error map
To enable tracing for ACUFH
To examine the CTF trace file
To prepare your program and execute it using Database Connectors
To set the run time environment variables
To set the system parameters
To set up the user environment
To start the demo program
To use the WHERE constraint from COBOL
Database Connectors Reference
Configuration Variables
4GL_2000_CUTOFF configuration variable
4GL_8_DIGIT_CUTOFF configuration variable
4GL_COLUMN_CASE configuration variable
4GL_COMMIT_COUNT configuration variable
4GL_CONVERT_DATE_ZERO configuration variable
4GL_DB_MAP configuration variable
4GL_FULL_DATA_TEST configuration variable
4GL_IGNORED_SUFFIX_LIST configuration variable
4GL_ILLEGAL_DATA configuration variable
4GL_JULIAN_BASE_DATE configuration variable
4GL_WHERE_CONSTRAINT configuration variable
DEFAULT_HOST configuration variable
FILE_TRACE configuration variable
filename_HOST configuration variable
XFD_DIRECTORY configuration variable
XFD_MAP configuration variable
XFD_MAP_RESETS configuration variable
XFD_PREFIX configuration variable
Error Messages
9D,01 Read error on dictionary file
9D,02 Corrupt dictionary file
9D,04 Corrupt dictionary file
9D,04 Too many fields in the key
9D,05 Too many fields in the key (more than 16 for Oracle)
9D,12 DB2 library function returned an unexpected error
9D,13 Illegal size or type of data for variable xxx
9D,14 More than one table with the same name
9D,1001 Invalid Cursor
Bad picture for DATE: keyname
Data missing from key segment keyname
Directive word too long: keyname
Field xxx causes duplicate database data
GROUP expected after USE
Missing '=' in XFD directive
Missing field name after WHEN
Value should be a literal: xxx
Value should be a name: xxx
Value should be numeric: xxx
Variable file name requires FILE directive
WHEN variable xxx not found in record
xxx not unique in first 30 characters
xxx: unknown XFD directive
XFD Directives
ALPHA XFD directive
BINARY XFD directive
COBOL-TRIGGER XFD directive
COMMENT XFD directive
CREATEXFD XFD directive
DATE XFD directive
FILE XFD directive
NAME XFD directive
NUMERIC XFD directive
SECONDARY_TABLE XFD directive
USE GROUP XFD directive
VAR_LENGTH XFD directive
WHEN XFD directive
WHEN Complex Expressions
XSL XFD directive
File Handling
File Handling Examples
Example of Data and Key Compression
External Files.
Example External Files
File Handler
Example Configuration File
Example of Creating a New Index File
Example of Accessing the FCD
Example of Setting Up the Record Area
Example of Setting up the Filename Area
File Names
Examples of static filename assignment
Example of dynamic filename assignment
Example of external filename assignment
Examples of device name assignment
Example of Forced Filename Mapping
Example of Connecting a File to Standard Output
Example of Connecting a File to Standard Input
Example of Setting up a Two-way Pipe
Example of using the External File Mapper
Example of Specifying a Fileshare Client User ID and Password
Example Fileshare Client Configuration File
Example Fileshare Client
File Status
Example of Displaying File Status Codes
Example of Checking File Status Codes
Example of Extended File Status Codes
Indexed Files
Example of Indexed File Definition
Example of Primary Key Definition
Example of Alternate Key Definition
Example of Duplicate Key Definition
Example of Sparse Key Definition
Example of Indexed File Access Definition
Example of Creating Fixed Length Records
Example of Creating Variable Length Records
Locking Files and Records
Example of Locking a File
Examples of Manual Record Locking
Examples of Automatic Record Locking
Examples of Single Record Locking
Examples of Multiple Record Locking
Example File and Record Locking Application
MFSORT
Example Mfsort Command Line
Example Mfsort Fields Instruction
Example Mfsort Key Instruction
Example Mfsort Instruction File
Rebuild
Example of Reorganizing an Indexed File
Example of recovering a corrupt indexed file
Example of using Rebuild to convert a file
Example of validating the structure of an indexed file
Example of a Rebuild options file
Example of calling Rebuild from a COBOL program
Example Relative File Definition
Sequential Files
Example Record Sequential File Definition - Fixed Length Records
Example Record Sequential File Definition - Variable Length Records
Example Line Sequential File Definition
Example Printer Sequential File Definition
File Handling Guide
Introduction
Overview
Micro Focus File Handler
File Organizations
Overview
Sequential Files
Record Sequential Files
Line Sequential Files
Printer Sequential Files
Relative Files
Indexed Files
Primary Keys
Alternate Keys
Duplicate Keys
Sparse Keys
Indexed File Access
Fixed-length and Variable-length Records
File Headers
Filenames
Filename Conventions
Assigning Filenames
Static Filename Assignment
Dynamic Filename Assignment
External Filename Assignment
Library Names in Paths
Filename Mapping
Multiple Paths
Library Names
Assigning Device Names
Setting Up Pipes
Output Pipes
Input Pipes
Two-way Pipes
File Status
What is File Status?
Defining a File Status Data Item
File Status Conventions
ANSI'85 File Status
ANSI'74 File Status
File Status Conversions
Extended File Status Codes
Sharing Files
Sharing mode
Record Locking
Manual and Automatic Record Locking
Manual Record Locking
Automatic Record Locking
Single and Multiple Record Locking
Single Record Locking
Multiple Record Locking
Handling Record Locks
Releasing Record Locks
File Status Codes
An Example Locking Application
File Handler Configuration
Configuration File
Configuration Options
Configurable Behavior
Large Indexed Files
File Striping
Headers in Striped Files
Options
MAXSTRIPEDIGITS
MAXSTRIPEFILES
MAXSTRIPESIZE
STRIPE-X
STRIPENAMETYPE
STRIPING
Examples
Performance
File Handler and Sort APIs
Calling the File Handler
Overview
Data Structures
File Control Description (FCD)
Record Area
Filename Area
Key Definition Block
Global Information Area
Key Definition Area
Component Definition Area
Accessing the FCD
Operation Codes
Relative Byte Addressing
Read a Record
Rewrite a Record
Delete a Record
Creating Your Own File Handler
Dynamic Redirection to a Custom File Handler
Redirection Using Configurable DYNREDIR
Specifying a List of Custom File Handlers
Specifying Configurable Custom File Handlers
Writing a Custom File Handler
Restrictions
Creating a New Index File
Compression Routines
Sort Module
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
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
Using the File Handling Redirector Module
Configuring Your Fileshare Client
Specifying the Fileshare Server
As a Filename
In a Configuration File
Specifying the Communications Protocol
FHREDIR Return Codes
Fileshare Server
Configuring the Fileshare Server
Specifying a Fileshare Server Name
Specifying the Communications Protocol
Starting the Fileshare Server
Stopping the Fileshare Server
Configuration
Client Configuration
Example Client Configuration File
Server Configuration
Example Server Configuration File
Database Integrity
Transaction Processing
Automatic Record Lock Timeout
Transaction Processing - Fileshare Client
Transaction Processing - Fileshare Server
Rollforward Recovery Logging
Rollforward Recovery Logging - Fileshare Server
Rollforward Recovery Utility
Database Sequence Numbering
Database Sequence Numbers - Fileshare Server
Automatic Database Backup and Rollforward Recovery
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
Security
Password System
Fileshare Client
Fileshare Server
Writing Your Own FHRdrPwd Module
Logon Validation Module
File Access Validation Module
Password File Maintenance
User-ID Groups
Supervisor Mode
Advanced Operation
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
FSVIEW
FSVIEW Command Line
Redirection of Information
Command Files
FSVIEW API
Call Interface
Callbacks
Fileshare Manager
Fileshare Manager Configuration
Linking Fileshare Manager Applications
Byte-stream I/O Calls
FS_LOCATE_FILE
FS_SPLIT_FILENAME and FS_JOIN_FILENAME
Running Fileshare as a Windows Service
Fileshare Server Configuration
Linking the Fileshare Server on Windows
Performance Considerations
Large File Support with Fileshare
Fileshare on UNIX
Running Fileshare as a Background Process
The NFILES Setting
Communications
Overview
Using CCITCP
CCI Trace
CCI Timeout
Error Handling
COBOL Run-time Errors
Communications Errors
Transaction Processing Errors
Fileshare Server Messages
Messages from FS001-S to FS050-W
Messages from FS051-W to FS099-W
Messages from FS101-I to FS149-I
Messages from FS151-I to FS200-W
Messages from FS201-S to FS252-S
File Handling Reference
Compiler Directives - File Handling
File Handler
Configuration File Options
ASCIIMAINFRAMEPRINT
BASENAME
CBL_CFGREAD_DYNFH
COMMITFLUSH
CONCATNAME
CONVERTDBSPACE
CONVERTEUCKATAKANA
CONVERTSTATUS
DATACOMPRESS
DATAFILE
EXPANDPOSITIONING
EXPANDTAB
FASTREAD
FHREDIR
FILEMAXSIZE
FILEPOINTERSIZE
FSIDXINTEGRITY
IDXDATBUF
IDXFORMAT
IDXNAMETYPE
IGNORELOCK
INDEXCOUNT
INDEXFILE
INSERTNULL
INSERTTAB
KEYCHECK
KEYCOMPRESS
LOADONTOHEAP
LOCKTYPE
LOG
LOGFILENAME
LSFILETERM
LSRECDELIM
MAINFRAMEPRINT
NAMEOPTIONS
NFSFILELOCK
NODESIZE
NOSEQCHECK
OPENINPUTSHARED
OSVSREWRITE
READSEMA
READTODELIM
RELDATBUF
RELRECDELIM
RETRYLOCK
RETRYOPEN
RETRYTIME
RUNITLOCKDETECT
SEARCHONCREATE
SEQDATBUF
SKIPLOCK
SPACEFILL
STARTUNLOCK
STRIPSPACE
SUPPRESSADV
TRACE
TRACEFILEEXTEND
TRACEFILENAME
USEVSAMKEYDEFS
WRITELINE
WRITETHRU
Data Structures
File Control Description (FCD)
Global Information Area
Key Definition Area
Component Definition Area
Operation Codes
Standard Operation Codes
Standard Operation Codes - Overview
CLOSE
COMMIT
DELETE
DELETE FILE
OPEN
READ
REWRITE
ROLLBACK
START
STEP
UNLOCK
WRITE
Special Operation Codes
Special Operation Codes - Overview
File Information
Create Index File
Get Next Record
Add Key Value
Re-index File
Flush File
Unlock Record
File Status
File Status Codes
Extended File Status Codes
Microsoft COBOL V2 File Status Codes
File Structures
Files without Headers
Line Sequential File Structure
Printer Sequential File Structure
Fixed Format Record Sequential File
Fixed Format Relative File
Files with Headers
Standard File Header
Standard Record Header
Variable Format Record Sequential File
Variable Format Relative Structure
Indexed Files
Types of Indexed File
Index File
Index Files - Overview
Index File - File Header
Index File - Free Space Record
Index File - Key Information Record
Index File - Index Node Record
Data File
Indexed File - Data File Structure
Library Routines
Limits
Limits - Overview
File Handling - COBOL Compiler Limits
File Handling - Run-time Limits
File Size Limits - General
Indexed File Size Limits
Sequential and Relative File Size Limits
File Handling - Operating System Limits
Rebuild Command Line Options
Rebuild Options - /c
Rebuild Options - /d
Rebuild Options - /e
Rebuild Options - /f
Rebuild Options - /i
Rebuild Options - /k
Rebuild Options - /l
Rebuild Options - /n
Rebuild Options - /o
Rebuild Options - /p
Rebuild Options - /r
Rebuild Options - /s
Rebuild Options - /t
Rebuild Options - /u
Rebuild Options - /v
Rebuild Options - /x
Rebuild Options - /y
Rebuild Options - /z
Rebuild Options - //q
Rebuild Options - //v
Rebuild Error, Information and Warning Messages
Syntax Errors
Execution Errors
Information Messages
Warning Messages
Run-time Switches
Sorting Files
Callable Sort Module
Sort Module Function Codes
Sort File Control Description
Mfsort Error Messages
Messages 0001 to 0099
Messages 0100 to 0199
Messages 0200 to 0399
Internationalization Support
National Locale Support
Compiling Programs with NLS
Setting Up the National Locale Environment
Using the LANG Environment Variable
Running Your NLS Program
NLS Initialization
NLS Operations
String Comparisons
Class Condition Tests
SORT and MERGE Key Comparisons
Case Conversion
Collating Sequence Operations
Editing and De-editing Moves
Intrinsic Functions Numval and Numval-c
Using NLS Library Routines in Your Programs
Mixing Programs With and Without NLS
Message Files
Format of a Message File
Example Error Message File
Unicode Support
UTF-16 Byte Ordering
National Literals
National Hexadecimal Literals
National Data Items
Java and COBOL
Using Java and COBOL Together
Overview
Setting Up the Environment for Java and COBOL
Compiling COBOL Programs that Call Java
Compiling COBOL Programs that Are Used from the CobolBean interface
Java/COBOL Application Launcher
Linking to the Multi-threaded Run-time System
Calling Procedural COBOL from Java
Overview
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
Demonstration Programs
Calling Java from OO COBOL
Overview of Calling Java from OO COBOL
Before You Start
Declaring Java Classes
Instantiating Java Objects
Calling Java Methods
Accessing Java Variables
Handling Java Exceptions
Accessing Native Java Objects
Finalizing Java Objects
Calling OO COBOL from Java
Overview
Before You Start
Writing a Java Class in OO COBOL
Importing the COBOL Support
The Wrapper Class
Adding and Removing Methods
Throwing Exceptions from COBOL
Using BY REFERENCE Parameters
Working with Java Programs
Demonstration 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
Mixed Language Programming
Ordering Parameters to Pass to Non-COBOL Programs
Removing Parameters from the Stack
Storage Representation of Parameters
Aligning Parameters on Word and Double Word Boundaries
Handling Return Codes in Mixed Language Applications
Call Conventions for Interfacing with Mixed Languages
Building a Mixed Language Application
Interfacing with Assembler Subprograms
Interfacing with Windows API Routines
Interfacing with C Programs
Passing Data between C and COBOL
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
Multi-threaded Programming
Introduction to Multi-threading
Multi-threading and the Operating System
Multi-threading and the Application
Multi-threading and the Command Line
Synchronizing Execution and Resolving Contention
Introduction
Multi-threaded Program Attributes
Specifying No Multi-threading
Serial Programs
Reentrant Programs
Use of Data Attributes
Using Synchronization Primitives
Using a Mutex
Using a Monitor
Using a Semaphore
Using an Event
Writing Multi-threaded Applications
Overview
Run-time System for Multi-threaded Applications
Considerations When Creating Reentrant Programs
Multi-threading Library Routines
Thread-control Routines
Thread-synchronization Routines
Routines for Handling Thread-specific Data
Initializing Applications
Manipulating Threads
Thread Handles
Creating and Terminating a Thread
Canceling a Thread
Suspending a Thread
Identifying a Thread
Threads in Other Languages
Canceling Called Programs
Optimizations and Programming Tips
Multi-threading in the .NET Framework
Multi-threading Compiler Directives
Directives for Serial and Reentrant Programs
Directives that Optimize Performance
Overview - Performance Programming
Optimizing Data Definitions
Speed of Processing of Different Data Types
COMP-5 Performance
COMP-X Performance
COMP Performance
COMP-3 Performance
DISPLAY Performance
Aligning Data Items for Efficiency
Optimizing Arithmetic Statements
Optimizing COMPUTE Statements
Decimal Point Alignment
Optimizing Exponential Operations
Initializing Data Items
Optimizing Data Manipulation and Reference Modification
Optimizing Table Handling
Optimizing Conditional Statements
Optimizing Logical Operations
Optimizing PERFORM Statements
Optimizing CALL Statements
Optimizing Parameter Handling
Optimizing File Sorting
Aligning Bit Data Items
Compiler Directives for Optimizing Code
Directives that Optimize for Speed
Directives that Optimize for Size
Examples
Example of Inefficient Use of the PERFORM Statement
Example of Optimized Subscripts to Table Elements
Example of Optimizing USAGE DISPLAY Subscripts
Protection Violations
Overview - Protection Violations
What Are Protection Violations?
General Protection Violations
Cobol Protection Violations
Unflagged Protection Violations
Correcting Protection Violations
Errors in Non-COBOL Portions of an Application
Parameter Mismatches in a CALL Statement
Stack Overflow
Illegal Reference Modification
Illegal Values for Pointers
Subscript Out of Range
Incorrect Linking Options or Procedures
Debugging Techniques
Debugging Intermediate Code Programs
Debugging Generated Code Programs
Debugging Example
Web Services and COBOL
Introduction to COBOL Web Services
Overview
COBOL Web Services
WS-I Compliance
XML Input/Output
Using XML and COBOL Together
COBOL and XML
XML Implementation
XML PARSE
Special Registers
User Routine
XML in Brief
XML Schemas
XML Instance Documents
XML Syntax Extensions
Overview
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 from your COBOL development system
Compiling from the Command Line
Generating COBOL Structures with XML Syntax
CBL2XML Functionality
Generating a Copyfile 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
Programming Techniques
Accessing Data on the Command Line
Manipulating Data with Reference Modification and STRING
Writing Recursive Routines
Coding an Intrinsic Function
Manipulating Bits
Examples
Example of Recursion
Example of Recursive Routines
Example of Intrinsic Functions
Example of Bit Manipulation
General Reference
C Functions for Calling COBOL
cobcall
cobcancel
cobcols
cobcommandline
cobexit
cobfunc
cobget
cobgetenv
cobgetfuncaddr
cobinit
coblines
coblongjmp
cobpostsighandler
cobput
cobputenv
cobremovesighandler
cobrescanenv
cobsetjmp
cobthreadtidy
cobtidy
COBOL Language Reference
COBOL Language Supported and Copyrights
Notations
Part 1. Concepts
Introduction to the COBOL Language
The COBOL Language
Source Format
Fixed Format
Sequence Number
Indicator Area
Areas A and B
Sample Program
Free Format
Variable Format
Concepts of the COBOL Language
Character Set
Language Structure
Separators
Character-strings
COBOL Words
Scope of Names
Conventions for Program-names
Conventions for Condition-names, Data-names, File-names, Record-names, Report-names and Typedef-names
Conventions for Index-names
Conventions for Class-names (for Object Orientation) and Interface-names
Conventions for Method-names
Conventions for Function-prototype-names
Conventions for Program-prototype-names
Literals
Nonnumeric Literals
Numeric Literals
National Literals
Figurative Constant Values
Constant-names
Concatenation Expressions
Special Registers
Predefined Object Identifiers
PICTURE Character-Strings
Comment-entries
Formats and Rules
General Format
Syntax Rules
General Rules
Elements
Concept of Computer-independent Data Description
Concept of Levels
Level-Numbers
Class and Category of Data
Algebraic Signs
Standard Alignment Rules
Item Alignment for Increased Object-code Efficiency
Selection of Character Representation and Radix
DISPLAY Format
COMPUTATIONAL, BINARY, or COMPUTATIONAL-4 Format
Computer Memory Natural Boundaries
Synchronization
Implicit Synchronization
Example of Implicit FILLER Assignments
Truncation
Example of Truncation
COMPUTATIONAL-1, COMPUTATIONAL-2,FLOAT-SHORT and FLOAT-LONG Formats
COMPUTATIONAL-3 or PACKED-DECIMAL Format
COMPUTATIONAL-X and COMPUTATIONAL-5 Formats
POINTER Format
PROCEDURE-POINTER Format
Uniqueness of Reference
Qualification
Subscripting
Indexing
Function-identifier
Reference Modification
Identifier
Condition-name
Object property
Inline method invocation
Object-view
Data-address-identifier
Type of identifier
Program-address-identifier
Explicit and Implicit Specifications
Explicit and Implicit Procedure Division References
Explicit and Implicit Transfers of Control
Explicit and Implicit Attributes
Explicit and Implicit Scope Terminators
Language Fundamentals
Optional Division, Section and Paragraph Headings
Reserved Words
External Repository
Call Prototypes
Part 2. Program Definition
Compilation Group
Compilation Groups
End Markers
Identification Division
Identification Division - General Description
The Program-ID Paragraph
The Class-ID Paragraph
The Factory Paragraph
The Object Paragraph
The Method-ID Paragraph
The Interface-ID Paragraph
The Function-ID Paragraph
The Date-Compiled Paragraph
The Delegate-ID Paragraph
The Enum-ID Paragraph
The Iterator-ID Paragraph
The Operator-ID Paragraph
The Valuetype-ID Paragraph
Environment Division
General Description
Configuration Section
The Source-Computer Paragraph
The Object-Computer Paragraph
The Special-Names Paragraph
The Repository Paragraph
The Constraints Paragraph
The Class-attributes Paragraph
The Assembly-Attributes Paragraph
Input-Output Section
The File-Control Paragraph
The File Control Entry
The I-O-Control Paragraph
Data Division
General Description
File Section
Working-Storage Section
Thread-Local-Storage Section
Object-Storage Section
Local-Storage Section
Linkage Section
Screen Section
File and Data Description
File Description Entry Skeleton
Data Description Entry Skeleton
The ANY LENGTH Clause
The BLANK WHEN ZERO Clause
The BLOCK CONTAINS Clause
The CODE-SET Clause
The ATTRIBUTE Clause
The DATA RECORDS Clause
The Data-name or FILLER Clause
The EXTERNAL Clause
The GLOBAL Clause
The GROUP-USAGE Clause
The JUSTIFIED Clause
The LABEL RECORDS Clause
Level Number
The LINAGE Clause
The OCCURS Clause
The PICTURE Clause
The PROPERTY Clause
The RECORD Clause
The RECORDING MODE Clause
The REDEFINES Clause
The RENAMES Clause
The SIGN Clause
The SYNCHRONIZED Clause
The THREAD-LOCAL Clause
The TYPEDEF Clause
The USAGE Clause
The VALUE Clause
The VALUE OF Clause
Screen Section
Screen Section Entry Skeleton
The AUTO Clause
The BACKGROUND-COLOR Clause
The BELL Clause
The BLANK Clause
The BLANK WHEN ZERO Clause in the Screen Section
The BLINK Clause
The COLUMN Clause
The CONTROL Clause
The ERASE Clause
The FOREGROUND-COLOR Clause
The FROM Clause
The FULL Clause
The GRID Clause
The HIGHLIGHT Clause
The JUSTIFIED Clause in the Screen Section
The LEFTLINE Clause
The LINE Clause
The LOWLIGHT Clause
The OCCURS Clause in the Screen Section
The OVERLINE Clause
The PICTURE Clause in the Screen Section
The PROMPT Clause
The REQUIRED Clause
The REVERSE-VIDEO Clause
The SECURE Clause
The SIGN Clause in the Screen Section
The SIZE Clause
The TO Clause
The UNDERLINE Clause
The USAGE Clause in the Screen Section
The USING Clause
The VALUE Clause in the Screen Section
The ZERO-FILL Clause
Procedure Division
Procedure Division General Description
The PROCEDURE DIVISION Header
Arithmetic Expressions
Arithmetic Operators
Bitwise Operators
Permissible Combinations of Symbols
Formation and Evaluation Rules
Intermediate Results
Conditional Expressions
Simple Conditions
Relation Condition
Comparison of Numeric Operands (Relation Condition)
Comparison of Nonnumeric Operands (Relation Condition)
Comparisons Involving Index-Names and/or Index Data Items (Relation Condition)
Comparisons Involving Data Items with USAGE POINTER (Relation Condition)
Comparisons Involving Data Items with USAGE PROCEDURE-POINTER (Relation Condition)
Comparisons Involving Data Items with USAGE OBJECT (Relation Condition)
Class Condition
Condition-name Condition (Conditional Variable)
Switch-Status Condition
Sign Condition
Omitted-argument Condition
Instance-of Condition
Complex Condition
Negated Simple Condition
Combined and Negated Combined Condition
Abbreviated Combined Relation Conditions
Condition Evaluation Rules
Common Phrases
Arithmetic Statements
Overlapping Operands
Multiple Results in Arithmetic Statements
Incompatible Data
Signed Receiving Items
The ROUNDED Phrase
The ON SIZE ERROR Phrase and NOT ON SIZE ERROR Phrase
ON SIZE ERROR Phrase Not Specified
ON SIZE ERROR Phrase Specified
The NOT ON SIZE ERROR Phrase
The CORRESPONDING Phrase
File I/O Concepts
File Position Indicator
I-O Status
Status Key 1
Successful Completion
Successful Completion
AT END Condition with Unsuccessful Completion
INVALID KEY Condition with Unsuccessful Completion
Permanent Error Condition with Unsuccessful Completion
Logic Error Condition with Unsuccessful Completion
Run-Time System Error Message
Valid Combinations of Status Keys 1 And 2
The AT END Condition
The INVALID KEY Condition
Sharing Files on Multi-user Systems
Single Record Locking
Multiple Record Locking
Default Record Locking
Conformance for Parameters and Returning Items
Parameters
Group Items
Elementary Items
Elementary Items Passed by Reference
Elementary Items Passed by Content or by Value
Returning Items
Group Items
Elementary Items
Intrinsic Functions
Arguments
Function Types
Data Item Functions
Date Conversion Functions
Trigonometric Functions
Definitions of Functions
The ABS Function
The ACOS Function
The ANNUITY Function
The ASIN Function
The ATAN Function
The BOOLEAN-OF-INTEGER Statement
The CHAR Function
The CHAR-NATIONAL Function
The COS Function
The CURRENT-DATE Function
The DATE-OF-INTEGER Function
The DATE-TO-YYYYMMDD Function
The DAY-OF-INTEGER Function
The DAY-TO-YYYYDDD Function
The DISPLAY-OF Function
The E Function
The EXP Function
The EXP10 Function
The FACTORIAL Function
The FRACTION-PART Function
The INTEGER Function
The INTEGER-OF-BOOLEAN Statement
The INTEGER-OF-DATE Function
The INTEGER-OF-DAY Function
The INTEGER-PART Function
The LENGTH Function
The LENGTH-AN Function
The LOG Function
The LOG10 Function
The LOWER-CASE Function
The MAX Function
The MEAN Function
The MEDIAN Function
The MIDRANGE Function
The MIN Function
The MOD Function
The NATIONAL-OF Function
The NUMVAL Function
The NUMVAL-C Function
The ORD Function
The ORD-MAX Function
The ORD-MIN Function
The PI Function
The PRESENT-VALUE Function
The RANDOM Function
The RANGE Function
The REM Function
The REVERSE Function
The SIGN Function
The SIN Function
The SQRT Function
The STANDARD-DEVIATION Function
The SUM Function
The TAN Function
The UPPER-CASE Function
The VARIANCE Function
The WHEN-COMPILED Function
The YEAR-TO-YYYY Function
Statements
The ACCEPT Statement
The ADD Statement
The ALTER Statement
The CALL Statement
The CANCEL Statement
The CHAIN Statement
The CLOSE Statement
The COMMIT Statement
The COMPUTE Statement
The CONTINUE Statement
The DELETE Statement
The DELETE FILE Statement
The DISPLAY Statement
The DIVIDE Statement
The ENTER Statement
The ENTRY Statement
The EVALUATE Statement
The EXAMINE Statement
The EXEC(UTE) Statement
The EXHIBIT Statement
The EXIT Statement
The GOBACK Statement
The GO TO Statement
The IF Statement
The INITIALIZE Statement
The INSPECT Statement
The INVOKE Statement
The MERGE Statement
The MOVE Statement
The MULTIPLY Statement
The NEXT SENTENCE Statement
The NOTE Statement
The ON Statement
The OPEN Statement
The PERFORM Statement
The RAISE Statement
The READ Statement
The RELEASE Statement
The RETURN Statement
The REWRITE Statement
The ROLLBACK Statement
The SEARCH Statement
The SERVICE Statement
The SET Statement
The SORT Statement
The START Statement
The STOP Statement
The STRING Statement
The SUBTRACT Statement
The TRANSFORM Statement
The TRY Statement
The UNLOCK Statement
The UNSTRING Statement
The USE Statement
The WAIT Statement
The WRITE Statement
The XML GENERATE Statement
The XML PARSE Statement
Compiler-directing Statements
Source Text Manipulation
The COPY Statement
The REPLACE Statement
The BASIS Mechanism
The BASIS Statement
The DELETE Statement - BASIS Control
The INSERT Statement - BASIS Control
The ++INCLUDE and -INC Mechanisms
The -INC Statement
The ++INCLUDE Statement
Conditional Compilation
$DISPLAY Statement
$ELSE Statement
$END Statement
$IF Statement
The Listing Control Statements
The EJECT Statement
The SKIP1, SKIP2 and SKIP3 Statements
The TITLE Statement
Compiler Directives Specific to Your COBOL System
Examples
Call Prototypes
Calling and Setting a Procedure-Pointer
Call Returning a Dynamically Allocated Data Area from a Subprogram
Compilation Group
COPY (ANSI'68 or LANGLVL(1) Variation)
COPY (Partial Word Replacement)
CRT STATUS Clause of the SPECIAL-NAMES Paragraph
$IF Statement (Conditional Compilation)
INSPECT Statement (Tallying, Replacing, and Converting)
NEXT Phrase of CONSTANT-NAMES
SEARCH statement
SORT a File Using Input and Output Procedures
SORT Table Entries
Split Key
Typedef - User Defined USAGE or Structure
Part 3. Additional Topics
Overview - XML Syntax Extensions
XML File Status Codes
XML Preprocessor Restrictions
XML Syntax - CLOSE Statement
XML Syntax - COUNT IN Clause
XML Syntax - DELETE Statement
XML Syntax - IDENTIFIED BY Clause
XML Syntax - NAMESPACE clause
XML Syntax - PROCESSING-INSTRUCTION Clause
XML Syntax - OPEN Statement
XML Syntax - READ Statement
XML Syntax - REWRITE Statement
XML Syntax - SELECT Clause
XML Syntax - START Statement
XML Syntax - WRITE Statement
XML Syntax - XD File Description
Report Writer
Report Section
Report Structure
Vertical Spacing
Horizontal Spacing
Data Manipulation
Report Subdivisions
Physical Subdivision of a Report
Logical Subdivisions of a Report
Procedure Division Report Writer Statements
Language Concepts
Report File
Special Register PAGE-COUNTER
Special Register LINE-COUNTER
Special Register PRINT-SWITCH
Subscripting
Environment Division
Input-Output Section
The File-Control Paragraph
The I-O-Control Paragraph
Data Division
The File Description Entry (Report Writer)
The REPORT Clause
Report Section
The Report Description Entry
PAGE-COUNTER Rules
LINE-COUNTER Rules
The CODE Clause
The CONTROL Clause
The PAGE Clause
The Report Group Description Entry
Presentation Rules Tables
Organization
Line Number Clause Notation
Line Number Clause Sequence Substitutions
Saved Next Group Integer Description
Report Heading Group Presentation Rules
Page Heading Group Presentation Rules
Body Group Presentation Rules
Page Footing Presentation Rules
Report Footing Presentation Rules
The COLUMN NUMBER Clause (Report Writer)
Data-name (Report Writer)
The GROUP INDICATE Clause
Level-Number (Report Writer)
The LINE NUMBER Clause (Report Writer)
The NEXT GROUP Clause
The SIGN Clause (Report Writer)
The SOURCE Clause (Report Writer)
The SUM Clause (Report Writer)
The TYPE Clause
The USAGE Clause
The VALUE Clause (Report Writer)
Procedure Division
General Description
The CLOSE Statement
The GENERATE Statement
The INITIATE Statement
The OPEN Statement (Report Writer)
The SUPPRESS Statement
The TERMINATE Statement
The USE BEFORE REPORTING Statement
Debug Module
Standard ANSI COBOL Debug
Object-time Switch
COBOL Debug RTS Switch
Debugging Lines
Environment Division
The WITH DEBUGGING MODE Clause
Procedure Division
The READY TRACE Statement
The RESET TRACE Statement
The USE FOR DEBUGGING Statement
Segmentation
General Description of Segmentation
Organization
Program Segments
Fixed Portion
Independent Segments
Segmentation Classification
Segmentation Control
Structure of Program Segments
Segment-Numbers
The SEGMENT-LIMIT Clause
Restrictions on Program Flow
The ALTER Statement
The PERFORM Statement
The MERGE Statement
The SORT Statement
Double-Byte Character Set Support
DBCS Data
Roman Script in DBCS
Multivendor Integration Architecture Support
Source Programs
Language Extensions
Comments and Comment-entries
User-defined Words
Spaces
Data Items
DBCS Data Items
Mixed Data Items
Literals
DBCS Literals
Category of DBCS Literals
Mixed Literals
Figurative Constants
The "N" literal
Program Structure
The END PROGRAM Header (DBCS)
Identification Division
The PROGRAM-ID Paragraph (DBCS)
Environment Division
The SOURCE-COMPUTER Paragraph (DBCS)
The OBJECT-COMPUTER Paragraph (DBCS)
The SPECIAL-NAMES Paragraph (DBCS)
The FILE-CONTROL Paragraph (DBCS)
Data Division
The JUSTIFIED Clause (DBCS)
The PICTURE Clause (DBCS)
The REDEFINES Clause (DBCS)
The RENAMES Clause (DBCS)
The USAGE Clause (DBCS)
The VALUE Clause (DBCS)
Procedure Division
Conditional Expressions (DBCS)
Relation Conditions
Class Condition
Statements that Involve Moving Data
The ACCEPT Statement (DBCS)
The CALL Statement (DBCS)
The CANCEL Statement (DBCS)
The INITIALIZE Statement (DBCS)
The INSPECT Statement (DBCS)
The MOVE Statement (DBCS)
The SEARCH Statement (DBCS)
The STOP Statement (DBCS)
The STRING Statement (DBCS)
The UNSTRING Statement (DBCS)
Micro Focus Extensions for Double-Byte Character Support
Environment Division
The OBJECT-COMPUTER Paragraph
The SPECIAL-NAMES Paragraph
The FILE-CONTROL Paragraph
Data Division
The JUSTIFIED Clause
The PICTURE Clause (DBCS)
The USAGE Clause
The VALUE Clause
Procedure Division
Conditional Expressions
Condition-name
Relation Conditions
Class Condition
The ACCEPT Statement
The INITIALIZE Statement
The INSPECT Statement
The MOVE Statement
The SEARCH Statement
The STRING Statement
The UNSTRING Statement
Micro Focus OO COBOL Extensions
Directives
Class Definition
Class Extension
Class-body
Class-object
Object-program
Method
Method Interface Definition
Summary of Obsolete Language Elements
Additional Dialect Support
Data General Interactive COBOL V1.3 Syntax Support
Environment Division
Switch-Names
File-Name on Disk
The DATA SIZE Clause
The INDEX SIZE Clause
Duplicate Alternate Keys
Alternate Keys
I-O-Control Paragraph
Data Division
VALUE Clause
The Screen Section
Procedure Division
The CALL Statement
The COPY INDEXED Statement
The DISPLAY Statement
File Sharing Syntax
The OPEN Statement
The READ Statement
DOS/VS COBOL Support
Microsoft COBOL V1.0 and V2.0 Syntax Support
Special Registers LIN and COL
Environment Division
The Special-Names Paragraph
Data Division
The USAGE Clause
Procedure Division
The Position-Specification Phrase
The ACCEPT Statement
The DISPLAY Statement
The EXHIBIT Statement
Microsoft V2.0 Additional Syntax Support
Record LOCKING
OPEN LOCKING Statement
READ Statement (in Manual Mode)
START Statement
Ryan McFarland COBOL V2.0 Syntax Support
Environment Division
The ASSIGN Clause
The ORGANIZATION Clause
Data Division
The VALUE OF LABEL Clause
Length of Nonnumeric Literals
Default Sign Representation
The USAGE Clause
Procedure Division
Literals as CALL Parameters
The EXIT PROGRAM Statement
Bound Checking
Size Allocation for Index Data Items
The ACCEPT Statement
The DISPLAY Statement
Non-Standard Operations on Alphanumeric Data Items
OPEN and CLOSE on SEQUENTIAL Files
The PERFORM Statement
Procedure Names
REWRITE on LINE SEQUENTIAL Files
The STOP RUN Statement
I-O Status Codes
Locked Records
Siemens BS2000 COBOL Syntax Support
Concepts
Indicator Area
Areas A and B
Special Registers
Nonnumeric Literals
Floating-point Literals
Function-Identifier
Representation of Numeric Items
The BINARY, COMPUTATIONAL and COMPUTATIONAL-5 phrases
File Concepts
Subscripts
Object Views
Identification Division
Identification Division Header
Identification Division Structure
The Class-ID Paragraph
The Factory Paragraph
The Interface-ID Paragraph
The Method-ID Paragraph
The Object Paragraph
Environment Division
The Special-Names Paragraph
The File Control Entry
The Repository Paragraph
Data Division
The File Description Entry
The Sort-Merge File Description Entry
The Working-Storage Section
The DYNAMIC Clause
The OCCURS Clause
The PICTURE Clause
The REDEFINES Clause
The SYNCHRONIZED Clause
The USAGE Clause
The VALUE Clause
Procedure Division
Class Condition
Intrinsic Functions
The ADDR Function
The ACCEPT Statement
The CALL Statement
The CLOSE Statement
Record Sequential Files
Line Sequential Files
The DISPLAY Statement
The ENTRY Statement
The EVALUATE Statement
The EXIT Statement
The GOBACK Statement
The INSPECT Statement
The INVOKE Statement
The MERGE Statement
The MOVE Statement
The OPEN Statement
The READ Statement
Relative and Indexed Files
The REWRITE Statement
The SEARCH Statement
The SET Statement
The SORT Statement
Sorting of Tables
Sorting Two-digit Years with a Century Window
The START Statement
Relative and Indexed Files
The STRING Statement
The USE Statement
The WRITE Statement
Sequential Files
Compiler Directing Statements
The COPY Statement
VS COBOL II Compatibility
Part 4: Appendices
Character Sets and Collating Sequences
ANSI File Status Summary
ANSI'74 File Status Codes
ANSI'85 File Status Codes
Reserved Words
Reserved Words Table
Context-sensitive Words Table
XML-CODE Exception Codes
Glossary
Compiler Directives
Language Features
Language Features - Additional Features
CONSTANT
DB2
FCDREG
PREPROCESS, P
REWRITE-LS
SEQCHK
SOURCEFORMAT
Language Features - Dialect
ACTUAL-PARAMS
ANS85
BS2000
COMS85
DBCHECK
DBCS
DBCSSOSI
DG
DIALECT
FLAG
FLAGCD
FLAGSTD
IBM-MS
ISO2002
JAPANESE
MF, MFLEVEL
MS
NCHAR
NSYMBOL
OOCTRL
OSVS
PC1
RM
VSC2
XOPEN
Language Features - Mainframe Compatibility
AREACHECK
CMPR2
DBCSSOSI
DIALECT
DPC-IN-SUBSCRIPT
LIBRARIAN
MAPNAME
PANVALET
PROGID-COMMENT
RDW
TRUNCCALLNAME
TRUNCCOPY
TRUNCINC
Language Features - Multi-threading
REENTRANT
SERIAL
Language Features - Reserved Word Control
ADDRSV
ADDSYN
COBOL370
DOSVS
MAKESYN
MVS
OS390
OVERRIDE
REMOVE
SAA
Language Features - Speed
ALTER
FASTCALL
FASTLINK
FIXOPT
QUAL
QUALPROC
SEG
TRICKLE
CGI-based Programming
WEBSERVER
Compiler Control
Compiler Control - Compile/Link Files
CANCELLBR
CONVSPACE
COPYLBR
COPYPATH
DATA-CONTEXT
IDYSRCPATH
INT
INTLEVEL
KEEP-INT
KEYCHECK
OBJ
OSEXT
P64
PCOMP
PREPROCESS, P
PROGID-INT-NAME
PROTOTYPE
RDFPATH
REPOSITORY
SOURCETABSTOP
UNICODE
Compiler Control - Directives Control
COBOLDIR
CONFIRM
DIALECT
DIRECTIVES, DIR
DIRECTIVES-IN-COMMENTS
SETTING, SETTINGS
SHOW-DIR
USE
Compiler Control - Error and Flag Messages
BRIEF
CHANGE-MESSAGE
EDITOR
ERRFORMAT
ERRLIST
ERRQ
FLAG
FLAGAS
FLAGCD
FLAGEUC
FLAGMIG
FLAGQ
FLAGSINEDIT
FLAGSTD
HIDE-MESSAGE
IMPLICITSCOPE
INFORETURN
MAX-ERROR
MOVE-LEN-CHECK
QUERY
STDERR
WARNING, WARNINGS
Compiler Control - Listing
ASM
COPYEXT
COPYLIST
COPYLISTCOMMENT
DATAMAP
DATE
ERRLIST
FORM
LINE-COUNT
LIST
LISTPATH
LISTWIDTH, LW
MFCOMMENT
PREPLIST
PRINT
RAWLIST
REF
REFNO
RESEQ
SEQCHK
SETTING, SETTINGS
SHOW-DIR
SOURCEASM
TIME
VERBOSE
XREF
ZEROSEQ
Compiler Control - Screen
BELL
CONFIRM
ECHO
ECHOALL
SUPFF
Compiling for Debugging and Analysis
ANIM
COBIDY
FAULTFIND
FLAGSINEDIT
PROFILE
TESTCOVER
TRACE
File Handling
ANS85
ASSIGN-PRINTER
ASSIGN
AUTOLOCK
CALLFH
CALL-RECOVERY
CALLSORT
COBFSTATCONV
DATACOMPRESS
DETECT-LOCK
FDCLEAR
FILESHARE
FILETYPE
HOSTCONTZERO
HOSTFD
IDXFORMAT
IXNLSKEY
IXNUMKEY
KEYCHECK
KEYCOMPRESS
LOCKTYPE
OLDREADINTO
OPTIONAL-FILE
PRESERVECASE
PRINT-EXT
RDW
RECMODE
RETRYLOCK
REWRITE-LS
SEQUENTIAL
WRITELOCK, WRITE-LOCK
WRITETHROUGH, WRITETHRU
Object Code, Size, and Optimization
Object Code - External Handlers
CALLFH
CALLMCS
CALLSORT
Object Code - File Handling
WRITETHROUGH, WRITETHRU
Object Code - Interprogram Communication
LITLINK
LITVAL-SIZE
RTNCODE-SIZE
PPLITLINK
Object Code - Object File Format
OMF
Object Code - Size and Speed
CHECK
FASTCALL
FIXOPT
HOSTSIGNS
LINKCHECK
LNKALIGN
OPT (Intel x86 platforms)
OPT (Non-Intel x86 platforms)
PARAMCOUNTCHECK
RECURSECHECK
SCHEDULER
SEG
Report Writer
RWHARDPAGE
Reserved Directives
CANCEL
CSI
ENSUITE
FASTSORT
FCD3
LOCALCOUNT
WB
WB2
WB3
Run-time Behavior
Run-time Behavior - General
ACCEPTREFRESH
ASSIGN-PRINTER
ASSIGN
BWZSTAR
CHARSET
CHECKDIV
CHECKNUM
COBFSTATCONV
CONVERTRET
CURRENCY-SIGN
CURRENT-DATE
DATA
DEFAULTBYTE
DEFAULTCALLS
DETECT-LOCK
FOLD-CALL-NAME
FOLD-COPY-NAME
HOSTARITHMETIC
INDD
INITCALL
INITPTR
INTDATE
IXNLSKEY
IXNUMKEY
LOCKTYPE
NATIVE
NLS
OUTDD
PRINT-EXT
PROTECT-LINKAGE
REPORT-LINE
SHARE-OUTDD
STICKY-LINKAGE
TERMPAGE
ZEROLENGTHFALSE
ZWB
Run-time Behavior - Arithmetic
ARITHMETIC
COMP-5
COMP-6
HOSTARITHMETIC
NATIVE-FLOATING-POINT
TRUNC
Run-time Behavior - Mainframe Compatibility
ADV
AMODE
APOST
BYTE-MODE-MOVE
COMP5-BYTE-ORDER
DATA
DIALECT
DYNAM
FP-ROUNDING
HOST-NUMCOMPARE
HOST-NUMMOVE
IBMCOMP
MAPNAME
NATIVE-FLOATING-POINT
ODOOSVS
OLDCOPY
PERFORM-TYPE
QUOTE
REMAINDER
SIGN-FIXUP
SYSPUNCH
Run-time Behavior - Compatibility with Older Micro Focus Products
AUTOLOCK
COMP-5
COMP
DE-EDIT
FILESHARE
IOCONV
MF, MFLEVEL
OLDBLANKLINE
OLDINDEX
OLDNEXTSENTENCE
OLDREADINTO
OLDSTRMIX
SPZERO
WRITELOCK, WRITE-LOCK
Run-time Behavior - Compatibility with Other COBOL Dialects
ALPHASTART
APOST
CASE
COMP-6
DBSPACE
FDCLEAR
IBMCOMP
INTDATE
ODOSLIDE
OPTIONAL-FILE
QUOTE
RETRYLOCK
SIGN
SSRANGE
STICKY-PERFORM
SWITCH-TYPE
SYMBSTART
TRUNC
Run-time Behavior - Speed or Size
ALIGN
BOUND
BOUNDOPT
CHECK
FIXOPT
LINKCHECK
MFSYNC
PARAMCOUNTCHECK
PERFORMOPT
RECURSECHECK
Key to Compiler Directives
Compiler Directives - Alphabetical List
Consolidated Tracing Facility
To enable CTF tracing
CTF Viewer
CTF Perspective
Annotation Files for CTF Events
Bookmarks in the CTF viewer
To create and load a binary trace file into the CTF Viewer
To search in the CTF viewer
To enable your annotation files in the CTF viewer
Components Traced by CTF
mf.ede.mfeditor Properties
mf.ede.textmgr Properties
mf.ide Properties
mf.idmr Properties
mf.mffh.fs Properties
mf.mffh.xfh Properties
mf.mffh.xsm Properties
mf.mvs.casspool Properties
mf.mvs.mvscatio Properties
mf.rts Properties
CTF Configuration File
mftrace.application
mftrace.comp.component-name#property
mftrace.dest
mftrace.dest.component-name
mftrace.emitter.emitter-name#property
mftrace.level
mftrace.level.component-name
Example CTF Configuration Files
CTF Emitter List
CTF Trace File Formats
BINFILE Emitter Properties
TEXTFILE Emitter Properties
CTF Demonstration Programs
CTF Tracing Examples
Error Messages
Syntax Checking Error Messages
Key to Syntax Checking Error Messages
COBCH0001 - COBCH0100
COBCH0101 - COBCH0200
COBCH0201 - COBCH0300
COBCH0301 - COBCH0400
COBCH0401 - COBCH0500
COBCH0501 - COBCH0600
COBCH0601 - COBCH0700
COBCH0701 - COBCH0800
COBCH0801 - COBCH0900
COBCH1001 - COBCH1100
COBCH1101 - COBCH1200
COBCH1201 - COBCH1300
COBCH1301 - COBCH1400
COBCH1401 to COBCH1500
COBCH2000 and above
Code Generation Error Messages
Key to Code Generation Error Messages
COBOP001 - COBOP080
Run-time System Error Messages
COBRT001 - COBRT020
COBRT021 - COBRT040
COBRT041 - COBRT060
COBRT061 - COBRT080
COBRT101 - COBRT120
COBRT121 - COBRT140
COBRT141 - COBRT160
COBRT161 - COBRT180
COBRT181 - COBRT200
COBRT201 - COBRT220
COBRT221 - COBRT240
COBRT241 - COBRT260
COBOL Preprocessor Error Messages
Explanation of Error Codes
Integrated Preprocessor Interface
Overview - Integrated Preprocessor Interface
Invoking a Preprocessor
Writing a Preprocessor
Writing a Preprocessor Overview
Definition of the Interface Between the Compiler and a Preprocessor
Preprocessor Response Codes
Inserting Source Lines
Generating Preprocessor Error Messages
Querying Directive Settings
Handling COPY Statements
Source Modification
Multiple Preprocessors
Considerations When Writing a Preprocessor
CP Preprocessor
Copyfile Expansion
REPLACE Notification
CP Directives
CONFIRM, C
LIMITED-SEARCH, LS
PREPROCESS, P
SQL, S
TRACE, T
WARNINGS, WARNING, W
Example Integrated Preprocessor
To build the demonstration preprocessor
To debug the demonstration preprocessor
COBOL Preprocessor Error Messages
Library Routines
Library Routines - Key
Application Subsystem Routines
CBL_SUBSYSTEM
Bit-packing Routines
X"F4"
X"F5"
Byte-stream File Routines
CBL_CLOSE_FILE
CBL_CREATE_FILE
CBL_FLUSH_FILE
CBL_FREE_RECORD_LOCK
CBL_GET_RECORD_LOCK
CBL_OPEN_FILE
CBL_READ_FILE
CBL_TEST_RECORD_LOCK
CBL_WRITE_FILE
Byte-stream File Handling Routines - Example
Character Set Conversion Routines
PC_WIN_CHAR_TO_OEM
PC_WIN_OEM_TO_CHAR
PC_WIN_SET_CHARSET
Consolidated Tracing Facility Routines
CBL_CTF_COMP_PROPERTY_GET
CBL_CTF_COMP_PROPERTY_SET
CBL_CTF_DEST
CBL_CTF_EMITTER_PROPERTY_GET
CBL_CTF_EMITTER_PROPERTY_SET
CBL_CTF_LEVEL
CBL_CTF_TRACE
CBL_CTF_TRACER_GET
CBL_CTF_TRACER_LEVEL_GET
CBL_CTF_TRACER_NOTIFY
Consolidated Tracing Facility Return Codes
Debugging Routines
CBL_DEBUGBREAK
CBL_DEBUG_START
CBL_DEBUG_STOP
Display Attribute Routines
CBL_SCR_ALLOCATE_COLOR
CBL_SCR_ALLOCATE_VC_COLOR
CBL_SCR_CREATE_VC
CBL_SCR_GET_ATTR_INFO
CBL_SCR_GET_ATTRIBUTES
CBL_SCR_NAME_TO_RGB
CBL_SCR_QUERY_COLORMAP
CBL_SCR_RESTORE_ATTRIBUTES
CBL_SCR_SAVE_ATTRIBUTES
CBL_SCR_SET_ATTRIBUTES
X"A7" functions 6 and 7
X"A7" function 16
X"A7" functions 20 and 21
Enhanced ACCEPT and DISPLAY Syntax Routines
X"AF" function 1
X"A7" function 18
X"AF" function 22
X"AF" function 26
Exit and Error Procedure Routines
CBL_ERROR_PROC
CBL_EXIT_PROC
CBL_GET_EXIT_INFO
File and Filename Routines
CBL_CHANGE_DIR
CBL_CHECK_FILE_EXIST
CBL_COPY_FILE
CBL_CREATE_DIR
CBL_DELETE_DIR
CBL_DIR_SCAN_END
CBL_DIR_SCAN_READ
CBL_DIR_SCAN_START
CBL_GET_CURRENT_DIR
CBL_FILENAME_CONVERT
CBL_FILENAME_MAX_LENGTH
CBL_JOIN_FILENAME
CBL_RENAME_FILE
CBL_SPLIT_FILENAME
MFFH_MODIFY_DISABLE
MFFH_MODIFY_TRACE
PC_FIND_DRIVES
PC_READ_DRIVE
PC_SET_DRIVE
X"91" function 46
X"91" function 47
X"91" function 48
X"91" function 49
Interpreting the return code as a file status code
Filename Routines - Example
Keyboard Routines
CBL_GET_KBD_STATUS
CBL_READ_KBD_CHAR
X"B0" function 0
X"B0" function 2
X"B0" function 4
Keyboard Routines - Example
Logical Operator Routines
CBL_AND
CBL_EQ
CBL_IMP
CBL_NOT
CBL_OR
CBL_XOR
Memory Allocation Routines
CBL_ALLOC_MEM
CBL_ALLOC_DYN_MEM
CBL_ALLOC_SHMEM
CBL_ALLOC_THREAD_MEM
CBL_FREE_DYN_MEM
CBL_FREE_MEM
CBL_FREE_SHMEM
CBL_FREE_THREAD_MEM
CBL_MEM_STRATEGY
CBL_MEM_VALIDATE
Multi-threading Routines
Thread-control Routines
CBL_THREAD_CREATE
CBL_THREAD_CREATE_P
CBL_THREAD_DETACH
CBL_THREAD_EXIT
CBL_THREAD_IDDATA_ALLOC
CBL_THREAD_IDDATA_GET
CBL_THREAD_KILL
CBL_THREAD_LIST_END
CBL_THREAD_LIST_NEXT
CBL_THREAD_LIST_START
CBL_THREAD_LOCK
CBL_THREAD_PROG_LOCK
CBL_THREAD_PROG_UNLOCK
CBL_THREAD_RESUME
CBL_THREAD_SUSPEND
CBL_THREAD_SELF
CBL_THREAD_SLEEP
CBL_THREAD_UNLOCK
CBL_THREAD_WAIT
CBL_THREAD_YIELD
RETURN-CODE Values For Thread-control Routines
Using the Program Thread-locking Routines
Using CBL_THREAD_SELF to Check Operating System
Synchronization Routines
Synchronization Routines - Monitors
Monitors - General Notes
CBL_MONITOR_BROWSE
CBL_MONITOR_BROWSE_TO_READ
CBL_MONITOR_BROWSE_TO_WRITE
CBL_MONITOR_CLOSE
CBL_MONITOR_OPEN_INTRA
CBL_MONITOR_READ
CBL_MONITOR_RELEASE
CBL_MONITOR_UNBROWSE
CBL_MONITOR_UNREAD
CBL_MONITOR_UNWRITE
CBL_MONITOR_WRITE
CBL_MONITOR_WRITE_TO_BROWSE
Synchronization Routines - Semaphores
Semaphores - General Notes
CBL_SEMAPHORE_ACQUIRE
CBL_SEMAPHORE_CLOSE
CBL_SEMAPHORE_OPEN_INTRA
CBL_SEMAPHORE_RELEASE
Synchronization Routines - Mutexes
Mutexes - General Notes
CBL_MUTEX_ACQUIRE
CBL_MUTEX_CLOSE
CBL_MUTEX_OPEN_INTRA
CBL_MUTEX_RELEASE
Synchronization Routines - Events
Events - General Notes
CBL_EVENT_CLEAR
CBL_EVENT_CLOSE
CBL_EVENT_OPEN_INTRA
CBL_EVENT_POST
CBL_EVENT_WAIT
RETURN-CODE Values For Synchronization Routines
Routines for Handling Thread-specific Data
CBL_TSTORE_CLOSE
CBL_TSTORE_GET
Thread-specific Data Handling Routines - Example
RETURN-CODE Values For Thread-specific Data Handling Routines
CBL_TSTORE_CREATE
NLS Message-file Handling Routines
CBL_NLS_CLOSE_MSG_FILE
CBL_NLS_COMPARE
CBL_NLS_INFO
CBL_NLS_OPEN_MSG_FILE
CBL_NLS_READ_MSG
Operating System Information Routines
CBL_GET_OS_INFO
Portability Routines
CBL_SCR_SET_PC_ATTRIBUTES
Program Canceling Routines
CBL_CANCEL
CBL_CANCEL_PROC
Program Information Routines
CBL_GET_PROGRAM_INFO
Run-unit Handling Routines
CBL_ABORT_RUN_UNIT
CBL_EXEC_RUN_UNIT
CBL_GET_SHMEM_PTR
CBL_PUT_SHMEM_PTR
CBL_YIELD_RUN_UNIT
Screen Routines
CBL_CLEAR_SCR
CBL_GET_CSR_POS
CBL_GET_SCR_GRAPHICS
CBL_GET_SCR_LINE_DRAW
CBL_GET_SCR_SIZE
CBL_READ_SCR_ATTRS
CBL_READ_SCR_CHARS
CBL_READ_SCR_CHATTRS
CBL_SET_CSR_POS
CBL_SWAP_SCR_CHATTRS
CBL_WRITE_SCR_ATTRS
CBL_WRITE_SCR_CHARS
CBL_WRITE_SCR_CHARS_ATTR
CBL_WRITE_SCR_N_ATTR
CBL_WRITE_SCR_N_CHAR
CBL_WRITE_SCR_N_CHATTR
CBL_WRITE_SCR_TTY
X"A7" function 17
X"A7" function 18
X"A7" function 25
X"AF" function 18
X"AF" function 22
X"E5"
State Maintenance Routines
MF_CLIENT_STATE_ALLOCATE
MF_CLIENT_STATE_DELETE
MF_CLIENT_STATE_EXPIRY
MF_CLIENT_STATE_FILE
MF_CLIENT_STATE_PURGE
MF_CLIENT_STATE_RESTORE
MF_CLIENT_STATE_SAVE
State Maintenance Routines Status
Text Routines
CBL_TOLOWER
CBL_TOUPPER
PC_WIN_SET_CHARSET
Virtual Heap Routines
CBL_CLOSE_VFILE
CBL_OPEN_VFILE
CBL_READ_VFILE
CBL_WRITE_VFILE
Windows Routines
PC_WIN_HANDLE
PC_WIN_INIT
Miscellaneous Routines
X"91" function 11
X"91" function 12
X"91" function 13
X"91" function 14
X"91" function 15
X"91" function 35
Alphabetical List of Library Routines
Restrictions, Compiler Limits, and System Limits
ALTER and ACCEPT Statement Restrictions
Command Line Length
Data Items Size and Number Restirctions
ELSE Clause Restrictions
ENTRY Statement Restrictions
Filename Restrictions
Floating-point Numbers
Hardware or Operating System Limits
Maximum Core Heap Size
Names, Literals and PICTURE Character Strings
Nested Statement Restrictions
Numbers Restrictions
PERFORM Ranges
Program Source File Limits
Size of Programs, Divisions and Sections
Sort and Merge Restrictions
Table Dimension Limits
USE Statements
USING Phrase Parameters
Run-time System Configuration
Run-time Configuration Settings Available in the IDE
ANSI Display Settings in the IDE
Command Line Handling Settings in the IDE
Console Size Settings in the IDE
Date/Time Warp Settings in the IDE
Error Handling Settings in the IDE
File Handling Settings in the IDE
Memory Strategy Settings in the IDE
Non-Shared Memory Settings in the IDE
Program Loading Settings in the IDE
Testing Settings in the IDE
Deployment Characteristics Settings in the IDE
Run-time Switches - Overview
Setting Run-time Switches
COBOL Programmable Switches
Syntax for Setting Switches
Examples
Key to Run-time Switches
List of General Run-time Switches
0, 1, 2, 3, 4, 5, 6, 7 and 8 run-time switches
A1 run-time switch
B, B1 run-time switches
C4 run-time switch
C5 run-time switch
D run-time switch
d run-time switch
E run-time switch
F run-time switch
i run-time switch
I2 run-time switch
K4 run-time switch
l run-time switch
L1 run-time switch
L2 run-time switch
N run-time switch
O run-time switch
S5 run-time switch
T run-time switch
t OO run-time switch
Run-time Switches for OO Programs
d OO run-time switch
f OO run-time switch
g1 OO run-time switch
g2 OO run-time switch
l OO run-time switch
t OO run-time switch
Run-time Tunables
Format of the Configuration File
List of Run-time Tunables
ansi_input_mode
arguments_are_initial
cobconfig_error_report
command_line_accept
command_line_linkage
core_filename
core_on_error
current_day
current_hour
current_minute
current_month
current_second
current_year
datewarp_dynamic
debug_on_error
default_cancel_mode
detect_alt_ctrl
device_name_detection
entry_point_mapper
entry_point_mapper_alias_exists_error
entry_point_mapper_search_order
environment_mapper
error_on_duplicate_entry_point
lock_mode
mainframe_floating_point
memory_free_check_size
memory_strategy
mfpm_access_cancelled_data
mfpm_external_data31
mfpm_logging
no_mfredir
os_error_log
printer_redirection
program_search_intgnt
program_search_order
screen_cols
screen_lines
shared_memory_segment_size
signal_regime
timewarp_dynamic
Deployment
Configuration and Administration
Configuration and Administration
Introduction
Enterprise Server Overview
Licensing
Prerequisites
Server Enterprise Edition Architecture
Service Execution Processes
The Directory Server
Servers
Services
Communications Processes
Service Listeners
Request Handlers
Implementation Packages
XA Resources
Resource Management
Container-managed Services
Application-managed Services
Mixing Container-managed and Application-managed Services
Server Enterprise Edition Acting as a Resource Manager
Administering Server Enterprise Edition
Where to Go From Here
Configuration
Introduction
Setting up the Environment
Process User ID
System-wide Environment Variables
Starting Directory Server
Firewall configuration
Setting Security Options
Directory Server
Enterprise Servers
Shared Memory Area
Shared Memory Cushion
Number of Service Execution Processes
Number of Communications Processes
Environment Variables
Fileshare
Resource Managers
Oracle
DB2
Performance Considerations
I/O-bound Services
CPU-bound Services
Short-running Client Requests
Long-running Client Requests
Deployment Services and Listeners
Deployment Services
Deployment Listeners
Deploying Interfaces
Service Interfaces
Deploying the .car File Manually
EJBs and Resource Adapters
Resource Adapters Supplied by Micro Focus
Deployment Descriptors that Are Required
CustomRecord and the RuntimeProperties Support
Deploying EJBs
Third Party Application Server Deployment
Troubleshooting
Introduction to Enterprise Server Administration
Before Using Enterprise Server Administration
Starting and Stopping the Directory Server
Access and Permissions
Visual Appearance
Menus
Status Line
Tables
Navigation
Refreshing a Page
Viewing the Documentation
The Directory Server Repository
Introduction
Repository Information
What You Can Do
Servers
Introduction
Command-line Interface
Server Information
Information Applicable to All Servers
Information Applicable to Enterprise Servers
Configuration Information
Server Statuses
Using Start and Stop Scripts
Stopping and Restarting Servers
What You Can Do
Enterprise Servers
CCI Servers
Communications Processes and Service Listeners
Introduction
Communications Process and Listener Information
Configuration Information
Communications Processes
timeout-grain
listener-wait (MTO only)
logging
trace
limit
Service Listeners
Web Services and J2EE conversation type
Web conversation type
logging
default
element in [virtual paths] Section
element in [allow] Section
Fileshare conversation type
timeout
control
data
file
TN3270 conversation type
client-close
default-terminal-type
Timeout
TN3270E conversation type
trace
data
length
sem
file
MSS Inter-System Communication conversation type
timeout
trace
data-trace
allmax
file
MSS Inter-System Communication (inbound only) conversation type
timeout
trace
data-trace
allmax
file
CICS Transaction Gateway conversation type
timeout
trace
data-trace
allmax
file
What You Can Do
Services, Packages and Request Handlers
Introduction
Creating Services Manually
Additions, Updates and Deletions
Services
The Services Table
Configuration Information
Configuration Parameters
scheme
URL
accept
listener
server
Implementation Packages
The Packages Table
What You Can Do
Request Handlers
The Request Handlers Table
What You Can Do
Monitoring the Directory Server
Monitoring Facilities
&nbs