extend Interoperability Suite

Changing or Updating the Windows License File

Installation on Windows Platforms

Installation Steps

Windows 64-bit Installations

BIN-REDIST and REDIST Installation Directories

Uninstalling or Modifying your Installation

Compiling Your Programs

Running Your Programs

Printing and Spooler Issues

Spooler Formatting

-P SPOOLER

-Q <printername>

Direct Control

Printing Multiple Jobs Simultaneously

UNIX Installation

License Files for UNIX

Changing or Updating Your UNIX License File

Installation Under UNIX

Installation from FTP Site

Installation from CD-ROM

SHARED_LIBRARY_PREFIX Configuration Variable

VMS and OpenVMS Installation

Before You Begin

License Files for VMS

Changing or Updating Your License File

Installation Steps

HP e3000 Installation

File System Syntax

MPE/iX versus HFS

LISTF versus LISTFILE

License Files for HP e3000

Changing or Updating Your License File

Installation on HP e3000 Machines

Before Installing extend Products

Installing Products Within the MPE/iX Shell

Verifying Your MPE/iX Installation

Installing Products Within the POSIX Shell

Verifying Your POSIX Installation

Printing from the MPE/iX POSIX Shell

Known Errors and Restrictions

Micro Focus Services and Solutions

Contacting Micro Focus

Further Information and Product Support

Getting Started

Installation and License File Basics

Requirements

License Files for extend Products

License file names

Sample, Definition, and DLL Files

Sample Programs

Definition Files

DLL Files

Configuring Your Terminals

TERM Variable

Terminal Database

License Management

Using Multiple Versions of ACUCOBOL-GT

Evaluation License Files

License Management for ISVs

Licensing Requirements

Including the License File in Your Distribution

Distributing License Files to your Customers

Distributing extend Products and License Files

License Management with CGI on the Internet

Multiple-User License File Management

Updating the User Limit

Acushare License File Management for UNIX and Linux

AcuServer License Management

How Acushare License Management Works

Starting and Stopping acushare

-start

-kill

Troubleshooting

Debugging an Invalid License Host Error

Identifying a Machine Key Mismatch

Tracing a License File

Questions & Answers

ACUCOBOL-GT Version 10.0 Documentation Set

ACUCOBOL-GT User's Guide

Introduction

ACUCOBOL-GT Documentation

Product Overview

Portability and Compatibility

Native Instructions

The ACUCOBOL-GT Run Time

Windows Console Runtime

Run-Time Configuration

Graphical Technology

File System Flexibility

Complementary Technologies

Document Overview

User Interface Programming

Reference Manual

Appendices

Getting Started

ACUCOBOL-GT Run-Time Manual

extend Product Guides

Transitioning to ACUCOBOL-GT

A Guide to Interoperating with ACUCOBOL-GT

A Programmer's Guide to the Internet

Related Documents

Supported Hardware

Native Code Supported Processors

Environment Variables

Environment Variables for Handling Temporary Files

Notation

Contacting Micro Focus

Handling Compilation Problems

Handling Program Execution Problems

Using the Debugger

Using File Trace

Using Screen Trace

Working with your Technical Support Representative

Compiler and Runtime

Using the Compiler

Internal Tables Options

Compatibility Options

Interoperability Options

Compiler File Options

Source Options

Reserved Word Options

Data Storage Options

Truncation Options

Video Options

Warning and Error Options

Debugging Options

Mapping Options

Conditional Compilation Options

Miscellaneous Options

Upper and Lower Case

File Name Handling

Remote File Name Handling

Compiler Command-Line Examples

CBLFLAGS Environment Variable

Help, Version Information, and Communication With C Programs

The ">>IMP" Directive

Specifying an Alternate Data Alignment

Forcing Compilation of ANSI or Terminal Format Files

Using the Runtime System

Runtime Options

Compatibility Modes

Source Formats

COPY Libraries

Resource Files

General Rules for Resources

Source Code Control

Run-Time Configuration

File Name Assignments

Code and Data File Search Paths

File Status Codes

Terminal Handling Options

File Handling Options

Sort Files

Carriage Control

Device Locking

File Name Interpretation

File Names Starting With a Hyphen

File Name Examples

Example 1: Default Name Handling

Example 2: Accessing Printers

Assigning Files to Local Printers

Calling Subprograms

CALL

Recursive CALLs

CANCEL

CHAIN

Alternate ENTRY Points

Reducing the Size of the runtime

acushare Utility Program

Using Shared Memory

Indicating Programs to Share

Using acushare

acushare -start

Automatic Startup at System Boot

acushare -kill

acushare -clean

acushare -version

acushare (with no options)

acushare Errors

General Preprocessor Interface

Use of Preprocessors

Calling a Preprocessor

Preprocessor Written in ACUCOBOL-GT

Calling Two or More Preprocessors

Compiler Options Forwarded to Preprocessors

Calling a Preprocessor Without the Compiler

AcuSQL Pre-compiler

Compatibility with ACUCOBOL-GT general preprocessor interface

Calling the AcuSQL pre-compiler

Writing a Preprocessor

Command-line options

Line and File Directives

Error Messages

Debugger and Utilities

Run-Time Debugger

General Debugging Information

Source Debugging

Symbolic Debugging

Low-Level Debugging

Debugging in Background Mode

The Abend Diagnostic Report

Entering the Debugger

Cursor and Mouse Handling in Source-level Debugging

Debugger Commands

Source-level Commands

Other Commands

Multithreading Issues

Help Menu

File Tracing

File Trace Timestamps

Screen Tracing

Macro Debugger

Specifying Addresses

Variables

Program Addresses

Debugger Restrictions

Using the Abend Diagnostic Report (ADR)

Generating a Report

ADR Restrictions

Object File Utility - cblutil

Object Libraries

Creating Object Libraries

Creating Remote Object Libraries

Getting Object Information

Generating Native Code

Vision File Utility - vutil

Examining File Information

Testing File Integrity

Rebuilding Files

Resetting User Counts

Resetting Internal Revision Number

Extracting Records From a File

Recovering Deleted Records

Creating Empty Files

Responding to vutil Generated Prompts

Collating Sequence

Specifying File Attributes in Advance

Indexed Format

Sequential and Relative Files

Unloading to Binary and Line Sequential Format

Loading a File

File Size Summary Report

Converting RMCOBOL-85 Indexed Files

Converting C-ISAM Files

Converting Micro Focus Files

Changing Record Size

Setting the Comment Field

Miscellaneous Commands

Default Settings of vutil

File Transfer Utility - vio

vio Options

Windows Considerations

vio Examples

Known Limitations

Indexed File Record Editor (alfred)

logutil

Syntax and Options

logutil Report Headings

The Profiler

Using the Profiler

Configuring the Profiling Tools

PROFILE_TYPE Runtime Configuration Variable

Configuring Profiler Behavior

Configuring acuprof

Understanding the Report

Understanding the XML Data File

Structure of the Raw Report File

The Runtime Level

The Program Level

The Paragraph level

External Sort Utility AcuSort

AcuSort Command Format

AcuSort Instructions

CHAR-ASCII and SIGN-ASCII

CHAR-EBCDIC and SIGN-EBCDIC instructions

SORT/MERGE Instructions

USE/GIVE instructions

KEY Structure

USE/GIVE Example

INCLUDE/OMIT Instructions

INCLUDE/OMIT Samples

AcuSort Code Sample

AcuSort Environment Variables

Remote Preprocessing Utility Boomerang

License Requirements and Installation

Server Setup and Configuration

Step 1: Creating an Alias File

Pro*COBOL Alias Example

CICS Alias Example

UniKix Alias Example

DB2 Alias Example

Step 2: Creating a Configuration File

Step 3: Creating an Access File

Step 4: Starting the Server

Server Commands

Client-side Operation Remote Precompiling

Remote Precompiling

Client Commands

Working with INCLUDE files

Terminal Manager

How the Terminal Manager Works

Terminal Manager Functions

Alternate Terminal Manager

Getting Your Terminals Ready

Step One: Terminal Identification

Step Two: Terminal Definition

Windows Special Considerations for Terminal Manager

Step Three: Configuration Variables

The Keyboard Interface

Key Mapping

Key Interpretation

Key Translation

Keyboard Configuration

Note to RMCOBOL-85 Users

Redefining the Keyboard

The KEYBOARD Variable

AUTO-RETURN=value

CASE=value

CHECK-NUMBERS=value

CURSOR-PAST-END=value

DATA-RANGE=value

EXCEPTION-RANGE=value

IMPLIED-DECIMAL=value

RM-2-DEFAULT-HANDLING=value

SCREEN-DEFAULT=value

The KEYSTROKE Variable

Additional Windows Keys

Keys that Cannot be Defined

Special Keys

Arrow Keys

Backspace vs. Left Arrow

Interrupt Key

Default Keyboard

Keyboard Modification Examples

The Display Interface

The SCREEN Option

NUMERIC-UPDATES=value

Additional Configuration Variables

Double-Byte Character Handling

SCROLL

WRAP

Restricted Attribute Handling

Restricted Video Modes

Restrictions

The Terminal Database File

Required Functions

Additional Screen Functions

Video Attributes

Color

One-color terminals

Function Keys and Other Keys

Multi-character Sequences for Graphics

Line Drawing

Graphical Window and Control Emulation

Reconstructing the Screen

Mouse Support for X Terminals

Initialization

Numeric Mode

Print Functions

Pass Through Mode

Continued Entries

File Processing

Transaction Management

Overview of Transaction Management

Transaction logging

File types

Features

The Transaction Logging Process

Transaction Management Verbs

Extended Locking Rules

Special handling of implicit transactions

Logging and Rollback of File Update Operations

Multiple Log Files

Transaction Error Handling

Compiler File Options

Recovery

Transaction logging and recovery with AcuServer

AcuServer

Product Requirements

Remote Name Notation

XFD Files

Understanding how the XFD File is Formed

Defaults Used in XFD Files

KEY IS phrase

RENAMES clause

REDEFINES clause

Multiple record definitions

Group items

FILLER data items

OCCURS clauses

Summary of dictionary fields

Identical field names

Long field names

Naming the XFD

Examples of XFD names

Using Directives

Important for Acu4GL and AcuXML sites

Directive Syntax

ALPHA Directive

BINARY Directive

COBOL-TRIGGER Directive

SECONDARY-TABLE Directive

SUBTABLE Directive (AcuXDBC use only)

XFD Format

Identification Section

Key Section

Condition Section

Field Section

International Character Handling

Files Required for Translation

Programmer's Guide

Handling Files

Sequential Files

Relative Files

Indexed Files - Vision

Segment Naming of Vision 6 Files

Segment Naming of Vision 4 and 5 Files

Method One: The Format Method

Method Two: The Default Method

Overriding Individual Segment Names

Selecting the Vision Version

Keys

Other Vision Features

Record Locking

Device Locking Under UNIX

Indexed File Considerations

Compression

Mass Update

Bulk Addition Mode for Vision

Using Bulk Addition

Effect on COBOL Rules

Duplicate Key Handling

Progress Reporting

Bulk Addition and AcuServer

Using Bulk Addition with Transactions

Performance Tips

Summary

Performance Considerations

Limits on Open Files

Terminal IO

Performance Considerations

Terminal Manager Restrictions

Memory Management

Other Memory Management Tools

External Data Items

Memory Testing and Error Handling

Memory Access Violations

Logging Errors to the Runtime's Error File

Run-Time Memory Tracking and Testing

Memory Handling Descriptions

Memory Tracking

Memory Bounds Checking

Screen Section

Advantages

Structure

Syntax

Comparison to Field-level

Field-level ACCEPT & DISPLAY

Form-level DISPLAY and ACCEPT (Screen Section)

Using Screen Section Embedded Procedures

Data Validation

Exiting From ACUCOBOL-GT Programs

Multiple Execution Threads

Thread Fundamentals

LAST THREAD

Data Sharing Among Threads

LOCK THREAD and UNLOCK THREAD

Thread Communication

SEND and RECEIVE

Thread Priorities

Threading Rules that Affect Windows and ACCEPT Statements

Thread Pausing

Multithreading and Multiprocessor Systems

Thread Interaction With Run Units

Working with External Sort Modules on UNIX

Before Using an External Sort Module

Linking in a Third-Party Sort Module

ACUCOBOL-GT User Interface Programming

Introduction

Overview of User Interface Features

Floating Windows and Graphical Controls

Automatic GUI Runtime Support

Developing Programs for Graphical Systems

Event-driven Environments

Configuration and Programming Support

Index to Related Topics

GUI Development with Third-party Kits and Tools

Windowing Concepts

ACUCOBOL-GT Window Types

Creating Portable User Interfaces

Incompatibilities Between Graphical and Character Systems

Strategies for Supporting Multiple Systems

Dual Interface, Dual Code

Single Interface, Single Code

Dual Interface, Single Code

Selecting the Right Approach

Determining Which UI is Running

Tips for Solving Cross-Platform Interface Problems

Establishing the Initial Window

Tips for Building Single-interface Programs

Tips for Building Dual-interface Programs

GUI Development Project Issues

Extent of the Interface Changes

Suitability of the Current UI to Conversion

Recommendations

Conversion Wizard

Sample Programs

Floating Windows

Overview of Floating Windows

Relationship Between Floating Windows and Subwindows

Active and Current Windows

Parent and Child Windows

Creating, Inquiring, Modifying, and Destroying Windows

Menus and Floating Windows

Graphical Controls

Overview of Graphical Controls

Visual Styles and Differences Among Operating Systems

Control Types Handles and IDs

Interaction Between Controls and Windows

Creating, Inquiring, Modifying, and Destroying Windows

The Character Coordinate Phrases

Controls and the Mouse

Bitmap Buttons

Paged List Boxes

Creating a Paged List Box

Adding Records to a Paged List Box

Other List Box Operations

Scroll Bars in Text-mode Environments

Paged List Box Event Handling

Paged List Box Example

Paged Grids

Supporting Concepts and Related Issues

Handles

Events

Graphical vs Textual Modes

Styles and Special Properties

Methods

ActiveX Example

.NET Example

Coordinates

Coordinate Handling

Coordinate Space Problems

Coordinate Space Solutions

Fonts

Layout Managers

Working with Layout Managers

Attaching a Layout Manager to a Window

Setting LAYOUT-DATA

Minimum and Maximum Control Dimensions

The Resize Layout Manager

Resize Manager LAYOUT-DATA Values

Control Types Reference

The Components of a Control

Type

Handle

Properties

Common Properties

Style

Special Properties

Control Components Diagram

Global Styles

Control Types

ActiveX

Bar

Bitmap

Check Box

Combo Box

Date Entry

Entry Field

Frame

Grid

Special Properties

ACTION (alphanumeric)

ACTION-HIDE-DRAG

ALIGNMENT (alphanumeric)

BITMAP (numeric)

BITMAP-NUMBER (numeric)

BITMAP-TRAILING (numeric)

BITMAP-WIDTH (numeric)

CELL-COLOR (numeric)

CELL-DATA (alphanumeric)

CELL-FONT (numeric)

CELL-PROTECTION (numeric)

COLUMN-COLOR (numeric)

COLUMN-DIVIDERS (numeric)

COLUMN-FONT (numeric)

COLUMN-PROTECTION (numeric)

CURSOR-COLOR (numeric)

CURSOR-FRAME-WIDTH (numeric)

CURSOR-X (numeric)

CURSOR-Y (numeric)

DATA-COLUMNS (numeric)

DATA-TYPES (alphanumeric)

DISPLAY-COLUMNS (numeric)

DIVIDER-COLOR (numeric)

DRAG-COLOR (numeric)

END-COLOR (numeric)

ENTRY-REASON (alphanumeric)

FILE-POS (numeric)

FINISH-REASON (signed integer)

HEADING-COLOR (signed integer)

HEADING-DIVIDER-COLOR (numeric)

HEADING-FONT (numeric)

HIDDEN-DATA (alphanumeric)

HSCROLL-POS (numeric)

INSERT-ROWS (numeric)

INSERTION-INDEX (numeric)

LAST-ROW (numeric)

MASS-UPDATE (numeric)

NUM-COL-HEADINGS (numeric)

NUM-ROWS (numeric)

NUM-ROW-HEADINGS (numeric)

RECORD-DATA (alphanumeric)

RECORD-TO-ADD (alphanumeric)

RECORD-TO-DELETE (numeric)

REGION-COLOR (numeric)

RESET-GRID (numeric)

ROW-COLOR (numeric)

ROW-COLOR-PATTERN (numeric)

ROW-DIVIDERS (numeric)

ROW-FONT (numeric)

ROW-PROTECTION (numeric)

SEARCH-OPTIONS (alphanumeric)

SEARCH-TEXT (alphanumeric)

SEPARATION (numeric)

SORT-TYPES (alphanumeric)

START-X (numeric)

START-Y (numeric)

VIRTUAL-WIDTH (numeric)

VPADDING (numeric)

VSCROLL-POS (numeric)

Label

List Box

Special Properties

ITEM-TO-ADD (alphanumeric)

RESET-LIST (numeric)

MASS-UPDATE (numeric)

ITEM-TO-DELETE (numeric)

INSERTION-INDEX (numeric)

SEARCH-TEXT (alphanumeric)

DATA-COLUMNS (numeric)

DISPLAY-COLUMNS (numeric)

ALIGNMENT (alphanumeric)

SEPARATION (numeric)

DIVIDERS (numeric)

SELECTION-INDEX (numeric)

THUMB-POSITION (numeric)

QUERY-INDEX (numeric)

ITEM-VALUE (alphanumeric)

TERMINATION-VALUE (numeric)

EXCEPTION-VALUE (numeric)

.NET

Push Button

Radio Button

Scroll Bar

Status Bar

Special Properties

Array and index modes

Tab

Tree View

Special Properties

BITMAP-HANDLE (numeric)

BITMAP-NUMBER (numeric)

BITMAP-WIDTH (numeric)

ENSURE-VISIBLE (numeric)

EXPAND (numeric)

HIDDEN-DATA (alphanumeric)

HAS-CHILDREN (numeric)

ITEM (numeric)

ITEM-TEXT (alphanumeric)

ITEM-TO-ADD (alphanumeric)

ITEM-TO-DELETE (numeric)

ITEM-TO-EMPTY (numeric)

Web Browser

Special Properites

CUSTOM-PRINT-TEMPLATE (alphanumeric)

PRINT (numeric)

PRINT-NO-PROMPT (numeric)

PAGE-SETUP (numeric)

PRINT-PREVIEW (numeric)

COPY-SELECTION (numeric)

CLEAR-SELECTION (numeric)

SAVE-AS (numeric)

SAVE-AS-NO-PROMPT (alphanumeric)

FILE-NAME (alphanumeric)

Events Reference

Control Events

CMD-CLICKED (value 4)

CMD-DBLCLICK (value 5)

CMD-GOTO (value 3)

CMD-HELP (value 8)

CMD-TABCHANGED (value 7)

MSG-AX-EVENT (value 16436)

MSG-BEGIN-DRAG (value 16406)

MSG-BEGIN-ENTRY (value16392)

MSG-BITMAP-CLICKED (16400)

MSG-BITMAP-DBLCLICK (event 16401)

MSG-BEGIN-HEADING-DRAG (value 16408)

MSG-CANCEL-ENTRY (value 16394)

MSG-COL-WIDTH-CHANGED (value 16410)

MSG-END-DRAG (value 16407)

MSG-END-HEADING-DRAG (value 16409)

MSG-FINISH-ENTRY (value16393)

MSG-GOTO-CELL (value 16395)

MSG-GOTO-CELL-DRAG (16404)

MSG-GOTO-CELL-MOUSE (value 16396)

MSG-GRID-RBUTTON-DOWN (value 16426)

MSG-GRID-RBUTTON-UP (value 16427)

MSG-HEADING-CLICKED (value 16402)

MSG-HEADING-DBLCLICK (value 16403)

MSG-HEADING-DRAGGED (value 16405)

MSG-NET-EVENT (value 16437)

MSG-PAGED-FIRST (16423)

MSG-PAGED-LAST (value 16424)

MSG-PAGED-NEXT (value 16419)

MSG-PAGED-NEXTPAGE (value 16421)

MSG-PAGED-NEXT-WHEEL (value 16439)

MSG-PAGED-PREV (value 16420)

MSG-PAGED-PREVPAGE (value 16422)

MSG-PAGED-PREV-WHEEL (value 16438)

MSG-SB-NEXT (value 16385)

MSG-SB-NEXTPAGE (value 16387)

MSG-SB-PREV (value 16386)

MSG-SB-PREVPAGE (value 16388)

MSG-SB-THUMB (value 16389)

MSG-SB-THUMBTRACK (value 16390)

MSG-SPIN-DOWN (value 16417)

MSG-SPIN-UP (value 16416)

MSG-TV-BEGINEDITLABEL (value 16440)

MSG-TV-ENDEDITLABEL (value 16441)

MSG-TV-DBLCLICK (value 16428)

MSG-TV-EXPANDED (value 16414)

MSG-TV-EXPANDING (value 16413)

MSG-TV-SELCHANGE (value 16412)

MSG-TV-SELCHANGING (value 16411)

MSG-VALIDATE (value 16391)

MSG-WB-BEFORE-NAVIGATE (value 16429)

MSG-WB-DOWNLOAD-BEGIN (16431)

MSG-WB-DOWNLOAD-COMPLETE (value 16432)

MSG-WB-NAVIGATE-COMPLETE (value 16430)

MSG-WB-PROGRESS-CHANGE (value 16433)

MSG-WB-STATUS-TEXT-CHANGE (16434)

MSG-WB-TITLE-CHANGE (value 16435)

NTF-CHANGED (value 4100)

NTF-PL-FIRST (value 4105)

NTF-PL-LAST (value 4106)

NTF-PL-NEXT (value 4101)

NTF-PL-NEXTPAGE (value 4103)

NTF-PL-NEXT-WHEEL (value 4109)

NTF-PL-PREV (value 4102)

NTF-PL-PREV-WHEEL (value 4108)

NTF-PL-PREVPAGE (value 4104)

NTF-PL-SEARCH (value 4107)

NTF-SELCHANGE (value 4099)

Menu Events

Using the Mouse

Mouse Properties

Mouse Action Ownership

How Mouse Actions Are Handled

Mouse Exception Processing

Assigning Results to Mouse Actions

Unmasking Mouse Actions

Automatic Mouse Handling

Screen Section Behavior

W$MOUSE Library Routine

Menu Bars and Pop-up Menus

Generic Menu Handler

Graphical Menu Facilities

Overview of Menu Handling

Properties of Menu Entries

Creating Menus - the Shortcut

Using genmenu

Menu Activation and Use

Defining Menu Keys

Menu Input

Function Key Handling

Menu Selection Limits

Changing Menu Results

Common Menu Operations

Disabling Menu Items

Checking Menu Items

Disabling an Entire Menu

Menu Configuration With the Generic Menu Handler

Pop-up Menus

Menu Handling: Sample Code

System Menu Close Handling Under Windows

Portability Concerns

Menu Bar Sample Programs

Color Mapping

Overview of Color Choices

Simplified Mapping Approach

Controlling the Color Mapping

COLOR_MODEL Settings

COLOR_MODEL Settings 1 and 2

COLOR_MODEL Settings 3 and 4

COLOR_MODEL Settings 5 and 6

COLOR_MODEL Settings 7 and 8

COLOR_MODEL Settings 9 and 10

COLOR_TABLE Settings

Additional Color Configuration Variables

Step 1: Assign Initial Colors

Step 2: Assign Initial Attributes

Step 3: Transform Colors

Step 4: Transform Intensities

ActiveX Color Settings

Miscellaneous Window Options

Background Brush Color

Drawing 3-D Lines

Help Automation

Introduction to Help Automation

Windows Help

Tips and Hints

Regarding Configuration Variables

UI Terminology

character-based display

Graphical User Interface System (GUI System)

main application window

menu bar

message box

method

minimize/maximize buttons

mnemonic keys

modal window

modeless window

multi-line entry field

ACUCOBOL-GT Reference Manual

Introduction

Overview of Reference Manual

Conventions

Upper-case and Special-character Words

Lower-case Words

Brackets Braces and Vertical Bars

Ellipses

Shading

Acknowledgment

Program Structure

Language Elements

COBOL Words

Literals

Source Format

Blank Lines and Comment Lines

Compiler Compatibility Modes

ANSI ACCEPT and DISPLAY Verbs

Source Management Statements

COPY Statement

++INCLUDE Statement

REPLACE Statement

Conditional Compilation

Program Organization

Program Elements

Identification Division

PROGRAM-ID Paragraph

Environment Division

Configuration Section

Source-Computer Paragraph

Object-Computer Paragraph

Special-Names Paragraph

Input-Output Section

File-Control Paragraph

I-O-Control Paragraph

Data Division

Data Structures

Record Description

Level-Numbers

Classes of Data

Standard Alignment Rules

Table Handling

Large Data Handling

File Types

Floating-Point Data

Using Floating-Point Data

Data Names

Qualification

Subscripting

Reference Modification

Condition-Name Level 88

RECORD-POSITION

Data Division Format

File Section

File Description Entry

Sort File Description Entry

IS EXTERNAL Clause

BLOCK CONTAINS Clause

RECORD Clause

LABEL RECORDS Clause

VALUE OF LABEL Clause

VALUE OF FILE-ID Clause

CODE-SET Clause

DATA RECORDS Clause

LINAGE Clause

WORKING-STORAGE Section

LINKAGE Section

Record Description Entry

Data Description Entry

Level-number

The data-name or FILLER Clause

REDEFINES Clause

IS EXTERNAL Clause

IS SPECIAL-NAMES Clause

IS EXTERNAL-FORM Clause

BLANK WHEN ZERO Clause

VALUE Clause

RENAMES Clause

Screen Section

Screen Description Entry

PICTURE FROM TO and USING Clauses

Procedure Division

Organization

Statements and Sentences

Scope of Statements

Flow of Control

Arithmetic Expressions

Evaluation of Arithmetic Expressions

ADDRESS OF Phrase in Expressions

Conditional Expressions

Relation Conditions

Comparison of Numeric Operands

Comparison of Nonnumeric Operands

Class Condition

Sign Condition

Condition-Name Condition

Switch-Status Condition

Complex Conditions

Combined Conditions

Order of Evaluation

Abbreviated Combined Relation Conditions

Common Statement Rules

Arithmetic Operations

Multiple Receiving Fields

ROUNDED Option

SIZE ERROR Option

CORRESPONDING Option

Unpredictable Results

I/O Status

AT END and INVALID KEY Phrases

Common Screen Options

AUTO Phrase

BACKGROUND-HIGH, BACKGROUND-LOW, and BACKGROUND-STANDARD Phrases

BELL Phrase

BLINK Phrase

CCOL, CLINE, CLINES, and CSIZE Phrases

EVENT-LIST, AX-EVENT-LIST, EXCLUDE-EVENT-LIST Phrases

FONT Phrase

FOREGROUND-COLOR and BACKGROUND-COLOR Phrases

FOREGROUND-RGB and BACKGROUND-RGB Phrases

FULL Phrase

HELP-ID Phrase

HIGH, LOW, and STANDARD Phrases

IDENTIFICATION Phrase

MAX-HEIGHT, MAX-WIDTH, MIN-HEIGHT, MIN-WIDTH Phrases

PROPERTY and Property-Name Phrases

SIZE Phrase (with a text entry field)

SIZE Phrase (with Windows and Controls)

STYLE Phrase and Style-Name

UPPER and LOWER Phrases

VALUE Phrase

VISIBLE Phrase

ZERO-FILL and NUMERIC-FILL Phrases

Procedure Division Format

Procedure Division Statements

DISPLAY Statement

DISPLAY UPON WINDOW TITLE

DISPLAY UPON COMMAND LINE

DISPLAY src-item ANSI format

DISPLAY UPON GLOBAL TITLE

DISPLAY FLOATING WINDOW

DISPLAY INITIAL WINDOW

DISPLAY TOOL-BAR

DISPLAY control-type-name

DISPLAY MESSAGE BOX

DISPLAY external-form-item

DISPLAY UPON ENVIRONMENT-NAME

DISPLAY assembly-name

NEXT SENTENCE Statement

The SORT Statement (for SORT TABLE)

XML GENERATE Statement

XML PARSE Statement

Appendices

Appendix A. Specifications

Appendix B. Reserved Words

Conventions

Reserved Word List

ACUCOBOL-GT Reserved Words - F

ACUCOBOL-GT Reserved Words - J

ACUCOBOL-GT Reserved Words - L

Appendix C. Changes Affecting Previous Versions

Changes Affecting Version 10.0

Changes Affecting Version 9.0.0

Changes Affecting Version 8.1.2

Changes Affecting Version 8.1.1

Changes Affecting Version 8.1

Changes Affecting Version 8.0

Changes Affecting Version 7.2

Changes Affecting Version 7.1

Changes Affecting Version 7.0

Changes Affecting Version 6.2

Changes Affecting Version 6.1

Changes Affecting Version 6.0

Changes Affecting Version 5.2

Changes Affecting Version 5.1

Changes Affecting Version 5.0

Changes Affecting Version 4.3

Changes Affecting Version 4.2

Changes Affecting Version 4.1

Changes Affecting Version 4.0

Changes Affecting Version 3.2

Changes Affecting Version 3.1

Changes Affecting Version 2.4

Changes Affecting Version 2.3

Changes Affecting Version 2.1

Changes Affecting Version 2.0

Changes Affecting Version 1.5

Changes Affecting Version 1.4

Changes Affecting Version 1.3

Appendix D. Compiler Error Messages

List of Errors

Appendix E. File Status Codes

Vision Secondary Error Codes for Error 98s

Table of Codes

Transaction Error Codes

IBM DOS/VS Error Codes

Appendix F. Intrinsic Functions

ABSOLUTE-VALUE (ABS) Function

Function Definitions and Returned Values

Function Definitions

CURRENT-DATE Function

DATE-OF-INTEGER Function

DAY-OF-INTEGER Function

FACTORIAL Function

INTEGER Function

INTEGER-OF-DATE Function

INTEGER-OF-DAY Function

INTEGER-PART Function

PRESENT-VALUE Function

STANDARD-DEVIATION Function

WHEN-COMPILED Function

Appendix G. Reserved for Future Use

Appendix H. Configuration Variables

Introduction

Variable Syntax

Variable Usage

Configuration Filename Resolution

Nested Configuration Files

Configuration Variables

A_EXTFH_SIMPLE_OPEN_OUTPUT

A_EXTFH_VARIABLE_IDX, A_EXTFH_VARIABLE_REL, A_EXTFH_VARIABLE_SEQ

A_JAVA_CHARSET

A_JAVA_GC_COUNT

A_JAVA_TRACE_FILENAME

A_REMOVE_EMPTY_ERROR_FILE

A_RETRY_DELAY

A_SEQ_DEFAULT_BLOCK_SIZE

A_SYSLOG_ON_RUNTIME_ERROR

A_XMLIF_ENCODING

A_XMLIF_EXPORT_EMPTY_ARRAY

A_XMLIF_EXPORT_OUTLINE

ACU_DUMP, ACU_DUMP_FILE, ACU_DUMP_WIDTH, ACU_DUMP_TABLE_LIMIT

AGS_RECEIVE_BUFFER_SIZE

alfred Configuration variables

AXML_EXACT_TABLE_MATCH

AXML_IGNORE_EMPTY_DATA

AXML_SCHEMA_DOC

AXML_SCHEMA_NAME

AXML_SCHEMA_NAMESPACE_DATA

AXML_STYLESHEET_HREF and AXML_STYLESHEET_TYPE

BACKGROUND_INTENSITY

BELL

BOXED_FLOATING_WINDOWS

CARRIAGE_CONTROL_FILTER

CBLHELP

CELL_SEPARATION

CGI_AUTO_HEADER

CGI_CLEAR_MISSING_VALUES

CONTROL_CREATION_EVENTS

CONVERT_WINDOW_DEFAULT

DISABLED_CONTROL_COLOR

DISPLAY_SWITCH_PERIOD

DYNAMIC_FUNCTION_CALLS

EXTFH_KEEP_TRAILING_SPACES

FILE_IO_PEEKS_MESSAGES

FILE_IO_PROCESSES_MESSAGES

FONT_WIDE_SIZE_ADJUST

FOREGROUND_INTENSITY

FREEZE_AX_EVENTS configuration

FULL_BOXES

GRID_BUTTONS_CAUSE_GOTO

GRID_ENFORCE_DATATYPE

HP_TERMINAL_ATTRIBUTE_HANDLING

HTML_TEMPLATE_PREFIX

ICOBOL_FILE_SEMANTICS

ICON

IMPORT_USES_CELL_SIZE

INACTIVE_BORDER_COLOR

LICENSE_ERROR_MESSAGE_BOX

MAX_ERROR_AND_EXIT_PROCS

OPTIMIZE_CONTROL_RESIZE

OPTIMIZE_INDIVIDUAL_LINKAGE

PAGE_EJECT_ON_CLOSE

PAGED_LIST_SCROLL_BAR

RECURSION_DATA_GLOBAL

REL_DELETED_VALUE

REL_LOCK_READ_THROUGH

RENEW_TIMEOUT

RESIZE_FRAMES

RESIZE_FREELY

TC_AUTO_UPDATE_FAILED_MESSAGE

SHARED_LIBRARY_EXTENSION

SHARED_LIBRARY_LIST

SHARED_LIBRARY_PREFIX

SHUTDOWN_DESTROYS_GUI

SHUTDOWN_FREES_PROGRAMS

STRIP_TRAILING_SPACES

SWITCH_PERIOD

SYSINTR_NAME

SYSPUNCH

TC_AUTO_UPDATE_FAILED_TITLE

TC_AUTO_UPDATE_NOTIFY_FAIL thin client

TC_AUTO_UPDATE_QUERY

TC_AUTO_UPDATE_QUERY_MESSAGE

TC_AUTO_UPDATE_QUERY_TITLE

TC_AX_EVENT_LIST

TC_CHECK_ALIVE_INTERVAL

TC_CHECK_INSTALLER_TIMESTAMP

TC_CONTINUITY_WINDOW

TC_CONTROL_SYNC_LEVEL

TC_DELAY_ACTIVATE

TC_DELAY_PRE_EVENT_OPS

TC_DISABLE_AUTO_UPDATE

TC_DISABLE_SERVER_LOG

TC_DOWNLOAD_CANCEL_MESSAGE

TC_DOWNLOAD_DESCRIPTION

TC_DOWNLOAD_DIALOG

TC_DOWNLOAD_DIALOG_TITLE

TC_EVENT_LIST

TC_EXCLUDE_EVENT_LIST

TC_INSTALLER_ARGS

TC_INSTALLER_CLIENT_FILE

TC_INSTALLER_RUN_ASYNC

TC_INSTALLER_SERVER_FILE

TC_INSTALLER_TARGET_DIR

TC_INSTALLER_UI_LEVEL

TC_MAP_FILE

TC_NESTED_AX_EVENTS

TC_QUIT_MODE

TC_REQUIRES_BUILD_NUMBER

TC_RESTRICT_AX_EVENTS

TC_SERVER_LOG_FILE log

USE_EXECUTABLE_MEMORY

V_BASENAME_TRANSLATION

V_INDEX_BLOCK_PERCENT

V_INTERNAL_LOCKS

V_LOCK_METHOD

V_MARK_READ_CORRUPT

V_NO_ASYNC_CACHE_DATA

V_OPEN_STRICT

V_READ_AHEAD

V_SEG_SIZE

V_STRIP_DOT_EXTENSION

V_VERSION

V23_GRAPHICS_CHARACTERS

V71_ALIGNED_ENTRY_FIELD

WARNING_ON_RECURSIVE_ACCEPTS

WHITE_FILL

WIN_ERROR_HANDLING

WIN_F4_DROPS_COMBOBOX

WIN32_CTL_INPUT_STATUS

WIN32_FRAMES_AS_ON_TABS

Appendix I. Library Routines

General Syntax and Library List

C$MEMCPY (Dynamic Memory Routine)

C$TOUPPER and C$TOLOWER

C$XML

CXML-PARSE-FILE

CXML-RELEASE-PARSER

CXML-GET-FIRST-CHILD

CXML-GET-NEXT-SIBLING

CXML-GET-PARENT

CXML-GET-DATA

CXML-GET-ATTRIBUTE-COUNT

CXML-PARSE-NEXT-RECORD

CXML-GET-PREV-SIBLING

CXML-NEW-PARSER

CXML-GET-ATTRIBUTE-BY-NAME

CXML-GET-CHILD-BY-NAME

CXML-GET-CHILD-BY-CDATA

CXML-GET-CHILD-BY-ATTR-NAME

CXML-GET-CHILD-BY-ATTR-VALUE

CXML-GET-SIBLING-BY-NAME

CXML-GET-SIBLING-BY-CDATA

CXML-GET-SIBLING-BY-ATTR-NAME

CXML-GET-SIBLING-BY-ATTR-VALUE

CXML-GET-COMMENT

CXML-MODIFY-CDATA

CXML-MODIFY-ATTRIBUTE-VALUE

CXML-DELETE-ATTRIBUTE

CXML-GET-PROC-INSTR-COUNT

CXML-GET-RAW-DOCTYPE-LEN

CBL_WRITE_SCR_CHARS_ATTR

CBL_WRITE_SCR_CHATTRS

CBL_WRITE_SCR_N_ATTR

CBL_WRITE_SCR_N_CHAR

CBL_WRITE_SCR_N_CHATTR

CBL_WRITE_SCR_TTY

CBL_XOR

DISPLAY_REG_*

Dynamic Memory Routines

M$ALLOC (Dynamic Memory Routine)

M$COPY (Dynamic Memory Routine)

M$FILL (Dynamic Memory Routine)

M$FREE (Dynamic Memory Routine)

M$GET (Dynamic Memory Routine)

M$PUT (Dynamic Memory Routine)

Error and Exit Procedures

HEX2ASCII

I$IO

OPEN-FUNCTION (op-code 1)

CLOSE-FUNCTION (op-code 2)

MAKE-FUNCTION (op-code 3)

INFO-FUNCTION (op-code 4)

READ-FUNCTION (op-code 5)

NEXT-FUNCTION (op-code 6)

PREVIOUS-FUNCTION (op-code 7)

START-FUNCTION (op-code 8)

WRITE-FUNCTION (op-code 9)

REWRITE-FUNCTION (op-code 10)

DELETE-FUNCTION (op-code 11)

UNLOCK-FUNCTION (op-code 12)

REMOVE-FUNCTION (op-code 13)

SYNC-FUNCTION (op-code 14)

EXECUTE-FUNCTION (op-code 15)

BEGIN-FUNCTION (op-code 16)

COMMIT-FUNCTION (op-code 17)

ROLLBACK-FUNCTION (op-code 18)

RECOVER-FUNCTION (op-code 19)

IN-TRANSACTION-FUNCTION (op-code 21)

LIB$GET_SYMBOL

LIB$SET_SYMBOL

OCTAL2ASCII

R$IO

R-OPEN-FUNCTION (op-code 1)

R-CLOSE-FUNCTION (op-code 2)

R-MAKE-FUNCTION (op-code 3)

R-READ-FUNCTION (op-code 4)

R-NEXT-FUNCTION (op-code 5)

R-PREVIOUS-FUNCTION (op-code 6)

R-START-FUNCTION (op-code 7)

R-WRITE-FUNCTION (op-code 8)

R-REWRITE-FUNCTION (op-code 9)

R-DELETE-FUNCTION (op-code 10)

R-UNLOCK-FUNCTION (op-code 11)

RMNet Routines

Function Calls

HttpSetConnectTimeout

HttpSetCookieFile

HttpSetEncoding

HttpSetResponseHeader

S$IO

S-OPEN-FUNCTION (op-code 1)

S-CLOSE-FUNCTION (op-code 2)

S-MAKE-FUNCTION (op-code 3)

S-READ-FUNCTION (op-code 4)

S-WRITE-FUNCTION (op-code 5)

S-REWRITE-FUNCTION (op-code 6)

S-SEEK-FUNCTION (op-code 7)

$WINHELP

HLP Files

WinHelp

Commonly Used Operations

CHM Files

W$BITMAP

WBITMAP-DISPLAY (op-code 1)

WBITMAP-DESTROY (op-code 2)

WBITMAP-LOAD (op-code 3)

WBITMAP-LOAD-IMAGELIST (op-code 5)

WBITMAP-DESTROY-IMAGELIST (op-code 6)

WBITMAP-CAPTURE-IMAGE (op-code 7)

WBITMAP-CAPTURE-DESKTOP (op-code 8)

WBITMAP-CAPTURE-CLIPBOARD (op-code 9)

WBITMAP-LOAD-PICTURE (op-code 10)

Error Handling

W$BROWSERINFO

W$FLUSH

W$FONT

WFONT-SUPPORTED (op-code 1)

WFONT-GET-FONT (op-code 101)

WFONT-GET-CLOSEST-FONT (op-code 102)

WFONT-DESCRIBE-FONT (op-code 106)

WFONT-CHOOSE-FONT (op-code 2)

W$MENU

W$MOUSE

ENABLE-MOUSE (op-code 10)

TEST-MOUSE-PRESENCE (op-code 0)

GET-MOUSE-STATUS (op-code 1)

GET-MOUSE-SCREEN-STATUS (op-code 2)

SET-MOUSE-POSITION (op-code 3)

SET-MOUSE-POSITION-EX (op-code 23)

SET-MOUSE-POSITION-PIXEL (op-code 25)

SET-MOUSE-SCREEN-POSITION (op-code 4)

SET-MOUSE-SCREEN-POSITION-EX (op-code 24)

SET-MOUSE-SCREEN-POSITION-PIXEL (op-code 26)

SET-MOUSE-SHAPE (op-code 5)

SET-DELAYED-MOUSE-SHAPE (op-code 6)

GET-MOUSE-SHAPE (op-code 7)

CAPTURE-MOUSE (op-code 8)

RELEASE-MOUSE (op-code 9)

SET-MOUSE-HELP (op-code 19)

Mouse Handling: Sample Code

W$PALETTE

WPALETTE-SUPPORTED (op-code 1)

WPALETTE-NUM-COLORS (op-code 2)

WPALETTE-GET-COLOR (op-code 3)

WPALETTE-SET-COLOR (op-code 4)

WPALETTE-UPDATE (op-code 5)

WPALETTE-CHOOSE-COLOR (op-code 6)

WPALETTE-SET-USER-COLOR (op-code 7)

Error Handling

W$PROGRESSDIALOG

WPROGRESSDIALOG-CREATE (op-code 1)

WPROGRESSDIALOG-DESTROY (op-code 2)

WPROGRESSDIALOG-SET-PROGRESS (op-code 3)

WPROGRESSDIALOG-QUERY-CANCEL (op-code 4)

WPROGRESSDIALOG-SET-LINE (op-code 5)

WPROGRESSDIALOG-RESET-TIMER (op-code 6)

WPROGRESSDIALOG-C-COPY (op-code 7)

WIN$PRINTER

WIN$PRINTER op-codes

Printer Information op-codes

WINPRINT-GET-SETTINGS-SIZE

WINPRINT-SETUP

WINPRINT-SETUP-USE-MARGINS

WINPRINT-SUPPORTED

WINPRINT-GET-SPOOL-ERR

WINPRINT-SET-JOB

WINPRINT-UPDATE-PRINTERS

WINPRINT-DATA op-codes

WINPRINT-GET-CAPABILITIES

WINPRINT-GET-MARGINS

WINPRINT-GET-PAGE-LAYOUT

WINPRINT-GRAPH-DRAW

WINPRINT-GRAPH-BRUSH

WINPRINT-GRAPH-PEN

WINPRINT-PRINT-BITMAP

WINPRINT-SET-CURSOR

WINPRINT-SET-TEXT-COLOR

WINPRINT-SET-FONT

WINPRINT-SET-LINES-PER-PAGE

WINPRINT-SET-MARGINS

WINPRINT-SET-STD-FONT

WINPRINT-SET-BKMODE

WINPRINT-SELECTION op-codes

WINPRINT-GET-CURRENT-INFO

WINPRINT-GET-CURRENT-INFO-EX

WINPRINT-GET-NO-PRINTERS

WINPRINT-GET-PRINTER-INFO

WINPRINT-GET-PRINTER-INFO-EX

WINPRINT-GET-PRINTER-STATUS

WINPRINT-SET-PRINTER

WINPRINT-SET-PRINTER-EX

WINPRINT-SETUP-EX

WINPRINT-COLUMN op-codes

WINPRINT-SET-DATA-COLUMNS

WINPRINT-CLEAR-DATA-COLUMNS

WINPRINT-SET-PAGE-COLUMN

WINPRINT-CLEAR-PAGE-COLUMNS

WINPRINT-GET-PAGE-COLUMN

WINPRINT-COLUMN-ALIGN-VERT

WINPRINT-JOB-STATUS op-codes

WINPRINT-GET-JOB-STATUS

WINPRINT-SET-JOB-STATUS

WINPRINT-MEDIA op-codes

WINPRINT-GET-PRINTER-MEDIA

USER-DATA op-codes

WINPRINT-GET-SETTINGS

WINPRINT-SET-SETTINGS

WIN$VERSION

Windows Print Spooler (-Q and -P)

-Q <printername>

Setting Options

Output from sample program - PaperInfo.cbl

-P SPOOLER

Direct Control

Printing Multiple Jobs Simultaneously

Windows Registry Routines

REG_CLOSE_KEY, DISPLAY_REG_CLOSE_KEY

REG_CREATE_KEY, DISPLAY_REG_CREATE_KEY

REG_CREATE_KEY_EX, DISPLAY_REG_CREATE_KEY_EX

REG_DELETE_KEY, DISPLAY_REG_DELETE_KEY

REG_DELETE_VALUE, DISPLAY_REG_DELETE_VALUE

REG_ENUM_KEY, DISPLAY_REG_ENUM_KEY

REG_ENUM_VALUE, DISPLAY_REG_ENUM_VALUE

REG_OPEN_KEY, DISPLAY_REG_OPEN_KEY

REG_OPEN_KEY_EX, DISPLAY_REG_OPEN_KEY_EX

REG_QUERY_VALUE, DISPLAY_REG_QUERY_VALUE

REG_QUERY_VALUE_EX, DISPLAY_REG_QUERY_VALUE_EX

REG_SET_VALUE, DISPLAY_REG_SET_VALUE

REG_SET_VALUE_EX, DISPLAY_REG_SET_VALUE_EX

ACUCOBOL-GT Version 10.0 Run-Time Manual

Introduction

Overview

Available Runtime Systems

Windows Runtime Systems

Setting up your Terminals

How the Terminal Manager Works

Terminal Manager Functions

Alternate Terminal Manager

Getting Your Terminals Ready

Step One: Terminal Identification

Step Two: Terminal Definition

Windows Special Considerations for Terminal Manager

Step Three: Configuration Variables

The Keyboard Interface

Key Mapping

Key Interpretation

Key Translation

Keyboard Configuration

Note to RMCOBOL-85 Users

Redefining the Keyboard

The KEYBOARD Variable

AUTO-RETURN=value

CASE=value

CHECK-NUMBERS=value

CURSOR-PAST-END=value

DATA-RANGE=value

EXCEPTION-RANGE=value

IMPLIED-DECIMAL=value

RM-2-DEFAULT-HANDLING=value

SCREEN-DEFAULT=value

The KEYSTROKE Variable

Additional Windows Keys

Keys that Cannot be Defined

Special Keys

Arrow Keys

Backspace vs. Left Arrow

Interrupt Key

Default Keyboard

Keyboard Modification Examples

The Display Interface

The SCREEN Option

NUMERIC-UPDATES=value

Additional Configuration Variables

Double-Byte Character Handling

SCROLL

WRAP

Restricted Attribute Handling

Restricted Video Modes

Restrictions

The Terminal Database File

Required Functions

Additional Screen Functions

Video Attributes

Color

One-color terminals

Function Keys and Other Keys

Multi-character Sequences for Graphics

Line Drawing

Graphical Window and Control Emulation

Reconstructing the Screen

Mouse Support for X Terminals

Initialization

Numeric Mode

Print Functions

Pass Through Mode

Continued Entries

Runtime Configuration File

Introduction

Variable Syntax

Variable Usage

Configuration Filename Resolution

Nested Configuration Files

Configuration Variables

A_EXTFH_SIMPLE_OPEN_OUTPUT

A_EXTFH_VARIABLE_IDX, A_EXTFH_VARIABLE_REL, A_EXTFH_VARIABLE_SEQ

A_JAVA_CHARSET

A_JAVA_GC_COUNT

A_JAVA_TRACE_FILENAME

A_REMOVE_EMPTY_ERROR_FILE

A_RETRY_DELAY

A_SEQ_DEFAULT_BLOCK_SIZE

A_SYSLOG_ON_RUNTIME_ERROR

A_XMLIF_ENCODING

A_XMLIF_EXPORT_EMPTY_ARRAY

A_XMLIF_EXPORT_OUTLINE

ACU_DUMP, ACU_DUMP_FILE, ACU_DUMP_WIDTH, ACU_DUMP_TABLE_LIMIT

AGS_RECEIVE_BUFFER_SIZE

alfred Configuration variables

AXML_EXACT_TABLE_MATCH

AXML_IGNORE_EMPTY_DATA

AXML_SCHEMA_DOC

AXML_SCHEMA_NAME

AXML_SCHEMA_NAMESPACE_DATA

AXML_STYLESHEET_HREF and AXML_STYLESHEET_TYPE

BACKGROUND_INTENSITY

BELL

BOXED_FLOATING_WINDOWS

CARRIAGE_CONTROL_FILTER

CBLHELP

CELL_SEPARATION

CGI_AUTO_HEADER

CGI_CLEAR_MISSING_VALUES

CONTROL_CREATION_EVENTS

CONVERT_WINDOW_DEFAULT

DISABLED_CONTROL_COLOR

DISPLAY_SWITCH_PERIOD

DYNAMIC_FUNCTION_CALLS

EXTFH_KEEP_TRAILING_SPACES

FILE_IO_PEEKS_MESSAGES

FILE_IO_PROCESSES_MESSAGES

FONT_WIDE_SIZE_ADJUST

FOREGROUND_INTENSITY

FREEZE_AX_EVENTS configuration

FULL_BOXES

GRID_BUTTONS_CAUSE_GOTO

GRID_ENFORCE_DATATYPE

HP_TERMINAL_ATTRIBUTE_HANDLING

HTML_TEMPLATE_PREFIX

ICOBOL_FILE_SEMANTICS

ICON

IMPORT_USES_CELL_SIZE

INACTIVE_BORDER_COLOR

LICENSE_ERROR_MESSAGE_BOX

MAX_ERROR_AND_EXIT_PROCS

OPTIMIZE_CONTROL_RESIZE

OPTIMIZE_INDIVIDUAL_LINKAGE

PAGE_EJECT_ON_CLOSE

PAGED_LIST_SCROLL_BAR

RECURSION_DATA_GLOBAL

REL_DELETED_VALUE

REL_LOCK_READ_THROUGH

RENEW_TIMEOUT

RESIZE_FRAMES

RESIZE_FREELY

TC_AUTO_UPDATE_FAILED_MESSAGE

SHARED_LIBRARY_EXTENSION

SHARED_LIBRARY_LIST

SHARED_LIBRARY_PREFIX

SHUTDOWN_DESTROYS_GUI

SHUTDOWN_FREES_PROGRAMS

STRIP_TRAILING_SPACES

SWITCH_PERIOD

SYSINTR_NAME

SYSPUNCH

TC_AUTO_UPDATE_FAILED_TITLE

TC_AUTO_UPDATE_NOTIFY_FAIL thin client

TC_AUTO_UPDATE_QUERY

TC_AUTO_UPDATE_QUERY_MESSAGE

TC_AUTO_UPDATE_QUERY_TITLE

TC_AX_EVENT_LIST

TC_CHECK_ALIVE_INTERVAL

TC_CHECK_INSTALLER_TIMESTAMP

TC_CONTINUITY_WINDOW

TC_CONTROL_SYNC_LEVEL

TC_DELAY_ACTIVATE

TC_DELAY_PRE_EVENT_OPS

TC_DISABLE_AUTO_UPDATE

TC_DISABLE_SERVER_LOG

TC_DOWNLOAD_CANCEL_MESSAGE

TC_DOWNLOAD_DESCRIPTION

TC_DOWNLOAD_DIALOG

TC_DOWNLOAD_DIALOG_TITLE

TC_EVENT_LIST

TC_EXCLUDE_EVENT_LIST

TC_INSTALLER_ARGS

TC_INSTALLER_CLIENT_FILE

TC_INSTALLER_RUN_ASYNC

TC_INSTALLER_SERVER_FILE

TC_INSTALLER_TARGET_DIR

TC_INSTALLER_UI_LEVEL

TC_MAP_FILE

TC_NESTED_AX_EVENTS

TC_QUIT_MODE

TC_REQUIRES_BUILD_NUMBER

TC_RESTRICT_AX_EVENTS

TC_SERVER_LOG_FILE log

USE_EXECUTABLE_MEMORY

V_BASENAME_TRANSLATION

V_INDEX_BLOCK_PERCENT

V_INTERNAL_LOCKS

V_LOCK_METHOD

V_MARK_READ_CORRUPT

V_NO_ASYNC_CACHE_DATA

V_OPEN_STRICT

V_READ_AHEAD

V_SEG_SIZE

V_STRIP_DOT_EXTENSION

V_VERSION

V23_GRAPHICS_CHARACTERS

V71_ALIGNED_ENTRY_FIELD

WARNING_ON_RECURSIVE_ACCEPTS

WHITE_FILL

WIN_ERROR_HANDLING

WIN_F4_DROPS_COMBOBOX

WIN32_CTL_INPUT_STATUS

WIN32_FRAMES_AS_ON_TABS

Runtime Options

Using the Runtime System

Runtime Options

Runtime Debugger

Run-Time Debugger

General Debugging Information

Source Debugging

Symbolic Debugging

Low-Level Debugging

Debugging in Background Mode

The Abend Diagnostic Report

Entering the Debugger

Cursor and Mouse Handling in Source-level Debugging

Debugger Commands

Source-level Commands

Other Commands

Multithreading Issues

Help Menu

File Tracing

File Trace Timestamps

Dynamic Runtime Tracing

Configuration Variables for Dynamic Runtime Tracing

Screen Tracing

Macro Debugger

Specifying Addresses

Variables

Program Addresses

Debugger Restrictions

Using the Abend Diagnostic Report (ADR)

Generating a Report

ADR Restrictions

File Status Codes

Vision Secondary Error Codes for Error 98s

Table of Codes

Transaction Error Codes

IBM DOS/VS Error Codes

Utilities

Object File Utility - cblutil

Object Libraries

Creating Object Libraries

Creating Remote Object Libraries

Getting Object Information

Generating Native Code

Vision File Utility - vutil

Examining File Information

Testing File Integrity

Rebuilding Files

Resetting User Counts

Resetting Internal Revision Number

Extracting Records From a File

Recovering Deleted Records

Creating Empty Files

Responding to vutil Generated Prompts

Collating Sequence

Specifying File Attributes in Advance

Indexed Format

Sequential and Relative Files

Unloading to Binary and Line Sequential Format

Loading a File

File Size Summary Report

Converting RMCOBOL-85 Indexed Files

Converting C-ISAM Files

Converting Micro Focus Files

Changing Record Size

Setting the Comment Field

Miscellaneous Commands

Default Settings of vutil

File Transfer Utility - vio

vio Options

Windows Considerations

vio Examples

Known Limitations

Indexed File Record Editor (alfred)

logutil

Syntax and Options

logutil Report Headings

The Profiler

Using the Profiler

Configuring the Profiling Tools

PROFILE_TYPE Runtime Configuration Variable

Configuring Profiler Behavior

Configuring acuprof

Understanding the Report

Understanding the XML Data File

Structure of the Raw Report File

The Runtime Level

The Program Level

The Paragraph level

External Sort Utility AcuSort

AcuSort Command Format

AcuSort Instructions

CHAR-ASCII and SIGN-ASCII

CHAR-EBCDIC and SIGN-EBCDIC instructions

SORT/MERGE Instructions

USE/GIVE instructions

KEY Structure

USE/GIVE Example

INCLUDE/OMIT Instructions

INCLUDE/OMIT Samples

AcuSort Code Sample

AcuSort Environment Variables

Remote Preprocessing Utility Boomerang

License Requirements and Installation

Server Setup and Configuration

Step 1: Creating an Alias File

Pro*COBOL Alias Example

CICS Alias Example

UniKix Alias Example

DB2 Alias Example

Step 2: Creating a Configuration File

Step 3: Creating an Access File

Step 4: Starting the Server

Server Commands

Client-side Operation Remote Precompiling

Remote Precompiling

Client Commands

Working with INCLUDE files

Shared Memory

acushare Utility Program

Using Shared Memory

Indicating Programs to Share

Using acushare

acushare -start

Automatic Startup at System Boot

acushare -kill

acushare -clean

acushare -version

acushare (with no options)

acushare Errors

extend Product Guides

Acu4GL Version 10.0 User's Guide

Acu4GL Overview

Extended File Descriptors (XFDs)

RDBMS Support

Accessing Data

Interface Routines

Web Runtime Integration

Database Concepts

How Acu4GL Works

What Is a Transparent Interface?

Demonstration Program

Using the sql.acu Program

Running sql.acu from the Command Line

Calling sql.acu from a Program

XFDs

Creating XFDs

How XFDs are Formed

Defaults Used in XFD Files

KEY IS Phrase

REDEFINES Clause

Summary of XFD Fields

Identical Field Names

Long Field Names

Naming the XFD File

Forming the Final XFD Name

Mapping Other Files to an XFD

Using XFD Directives

Line Continuation for Complex XFDs

XFD Directive Syntax

Supported XFD Directives

ALPHA XFD directive

BINARY XFD directive

COBOL-TRIGGER XFD directive

COMMENT 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

Invalid Data

Illegal COBOL Data

Invalid Key Data

Invalid Data Other Than Keys

Working with COBOL

Preparing and Compiling a Program Example

Compiling with just the -Fx compiler option

Compiling with the WHEN XFD Directive

Using Additional XFD Directives

Creating File Descriptors and SELECT Statements

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

Compiler and Runtime Options

Compiler File Options

Run-time Configuration Variables

4GL_2000_CUTOFF configuration variable

4GL_8_DIGIT_CUTOFF configuration variable

4GL_COLUMN_CASE configuration variable

4GL_COMMIT_COUNT configuration variable

4GL_CONVERT_DATE_ZERO configuration variable

4GL_DB_MAP configuration variable

4GL_EXTRA_DB_COLS_OK configuration variable

4GL_FULL_DATA_TEST configuration variable

4GL_IGNORED_SUFFIX_LIST configuration variable

4GL_ILLEGAL_DATA configuration variable

4GL_JULIAN_BASE_DATE configuration variable

4GL_USEDIR_LEVEL configuration variable

4GL_WHERE_CONSTRAINT configuration variable

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

Performance and Troubleshooting

Performance Issues

Guidelines

The WHERE Constraint

To use the WHERE constraint from COBOL

Setting External Variables

Compiler Errors

Bad picture for DATE: keyname

Data missing from key segment keyname

Directive word too long: keyname

GROUP expected after USE

Missing '=' in XFD directive

Missing field name after WHEN

xxx: unknown XFD directive

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

Compiler Warnings

Field xxx causes duplicate database data

xxx not unique in first 30 characters

Retrieving Runtime Errors

Retrieving Messages with -x runtime option

Retrieving Messages with the Debugger

Retrieving Messages with C$RERR

Questions and Answers

Appendix A: Acu4GL for Informix Information

Getting Started with Acu4GL for Informix

Installation Preparation

Installation Steps

Designating a Database

A_INF_DUPLICATE_KEY configuration variable

Configuration File Variables

A_INF_NO_TRANSACTION_ERROR configuration variable

A_INFORMIX_ERROR_FILE configuration variable

DATABASE

INF_LOGIN

INF_PASSWD

INFORMIX_TYPE configuration variable

Microsoft SQL Server Concepts Overview

Appendix B: Acu4GL for Microsoft SQL Server

Installation and Setup

Installing on a Client Machine

To install Acu4GL on a Windows server

Installation Steps for a Windows Client

Setting Up a User Account

A_MSSQL_ADD_IDENTITY configuration variable

Configuration File Variables

A_MSSQL_ADD_TIMESTAMP configuration variable

A_MSSQL_APPROLE_NAME configuration variable

A_MSSQL_APPROLE_PASSWD configuration variable

A_MSSQL_CURSOR_OPTION_1,2,3 configuration variables

A_MSSQL_DATABASE configuration variable

A_MSSQL_DEADLOCK_LOOPS configuration variable

A_MSSQL_DEFAULT_CONNECTION configuration variable

A_MSSQL_DEFAULT_OWNER configuration variable

A_MSSQL_DO_NOT_TRANSLATE_CHAR configuration variable

A_MSSQL_FAST_ACCESS configuration variable

A_MSSQL_LIMIT_DROPDOWN configuration variable

A_MSSQL_LOCK_DB configuration variable

A_MSSQL_LOGIN configuration variable

A_MSSQL_MAX_BINARY_LENGTH configuration variable

A_MSSQL_MAX_CHAR_LENGTH configuration variable

A_MSSQL_MAX_CHARACTERS configuration variable

A_MSSQL_MAX_COLUMNS configuration variable

A_MSSQL_NATIVE_LOCK_TIMEOUT configuration variable

A_MSSQL_NO_23_ON_START configuration variable

A_MSSQL_NO_CACHED_READ configuration variable

A_MSSQL_NO_COUNT_CHECK configuration variable

A_MSSQL_NO_DBID configuration variable

A_MSSQL_NO_RECORD_LOCKS configuration variable

A_MSSQL_NO_TABLE_LOCKS configuration variable

A_MSSQL_NT_AUTHENTICATION configuration variable

A_MSSQL_ODBC_DRIVER_NAME configuration variable

A_MSSQL_PACKETSIZE configuration variable

A_MSSQL_PASSWD configuration variable

A_MSSQL_ROWCOUNT configuration variable

A_MSSQL_SELECT_KEY_ONLY configuration variable

A_MSSQL_SEPARATE_LOCK_CONN configuration variable

A_MSSQL_SKIP_ALTERNATE_KEYS configuration variable

A_MSSQL_STRIP_PATH_INFO configuration variable

A_MSSQL_TRANSACTION_LEVEL configuration variable

A_MSSQL_TRANSLATE_TO_ANSI configuration variable

A_MSSQL_UNLOCK_ON_EXECUTE configuration variable

A_MSSQL_UPDATE_PRIMARY_COLS configuration variable

A_MSSQL_USE_DROPDOWN_QUERIES configuration variable

A_MSSQL_VISION_LOCKS_FILE configuration variable

Using the Database Table

Table Locking

Stored Procedures

Developer- or Site-supplied Stored Procedures

tablename_delete stored procedure

tablename_insert stored procedure

tablename_read stored procedure

tablename_startnnn stored procedure

tablename_update stored procedure

Built-in Stored Procedures

sp_AcuInit stored procedure

sp_AcuRemoveUnusedLocks_1 stored procedure

sp_AcuTableReport_1 stored procedure

sp_AcuUserCount_1 stored procedure

sp_AcuZeroUserCount_1 stored procedure

Acu4GL and Record Locking

Appendix C: Acu4GL for Oracle Information

Oracle Concepts Overview

open_cursers parameter

Table Ownership

Security

Installation and Setup

Windows Installation Steps

To set up an alias for Oracle or a similar tool

UNIX Installation Steps

Completing the Installation

Checking System Parameters

To set the system parameters

Setting Up a User Account

Configured Login

Setting Up the Search Path

Handling Transactions

Oracle's Instant Client

To test the installation of Oracle's Instant Client

A_ORA_DATABASE configuration variable

Configuration File Variables

A_ORACLE_ERROR_FILE configuration variable

A_ORA_HINTS configuration variable

A_ORA_KEEP_START_CURSOR configuration variable

A_ORA_LIMIT_DROPDOWN configuration variable

A_ORA_MAX_FILE_CURSORS configuration variable

A_ORA_NLS_SORT configuration variable

A_ORA_RETURN_SUCCESS_INFO configuration variable

A_ORA_USE_PRIMARY configuration variable

A_ORA_WAIT_LOCK configuration variable

COMMIT_COUNT configuration variable

ECN-GL443

ORA_LOGIN configuration variable

ORA_PASSWD configuration variable

USER_PATH (for Oracle) configuration variable

Using the Database Table

Supported Features

Installation from CD or Download

Appendix D: Acu4GL for ODBC

ODBC Concepts

Acu4GL for ODBC Installation and Setup

ODBC Installation

Installation of Acu4GL for ODBC

Setting Up Data Sources

Designating the Host Data Source

4GL_COLUMN_CASE configuration variable

Decimal Points

Configuration File Variables

4GL_MAX_DATE configuration variable

4GL_MIN_DATE configuration variable

4GL_JULIAN_NULL configuration variable

A_ODBC_ALTERNATE_COMMIT_LOGIC configuration variable

A_ODBC_CATALOG configuration variable

A_ODBC_COMMIT_ON_BEGIN configuration variable

A_ODBC_DATASOURCE configuration variable

A_ODBC_ERROR_MAP_FILE configuration variable

A_ODBC_ISOLATION_LEVEL configuration variable

A_ODBC_LOCK_METHOD configuration variable

A_ODBC_LOGIN configuration variable

A_ODBC_NO_NULL_COLUMNS

A_ODBC_PASSWD

A_ODBC_PRINT_LOG configuration variable

A_ODBC_QUOTE_IDENTIFIERS configuration variable

A_ODBC_STRICT_EQUAL configuration variable

A_ODBC_TABLE_TYPES configuration variable

A_ODBC_UNSIGNED_TINYINT configuration variable

A_ODBC_USE_CATALOG configuration variable

A_ODBC_USE_CHAR_FOR_BINARY configuration variable

A_ODBC_USE_SPACE_IN_DATES configuration variable

A_ODBC_USE_SQLCOLUMNS configuration variable

A_ODBC_USE_SQLTABLES configuration variable

USER_PATH

Mixed-case SQL Identifiers

Record and Table Locking

Troubleshooting

Sybase RDBMS Installation

Appendix E: Acu4GL for Sybase Information

Sybase Concepts Overview

Installation and Setup

Acu4GL for Sybase Installation

UNIX Client Installations

UNIX Client Installation Steps

UNIX or Windows NT server Intallations

Windows Client and UNIX or Windows NT Server Installations

UNIX Server Machine Installations

Windows NT Server and Windows Client Installations

Windows client Installations

Setting Up a User Account

A_SYB_ADD_IDENTITY configuration variable

Configuration File Variables

A_SYB_ADD_TIMESTAMP configuration variable

A_SYB_CHECK_DELETE_SP configuration variable

A_SYB_CHECK_INSERT_SP configuration variable

A_SYB_CHECK_READ_SP configuration variables

A_SYB_CHECK_UPDATE_SP configuration variable

A_SYB_CURSOR_OPTION_1, A_SYB_CURSOR_OPTION_2, A_SYB_CURSOR_OPTION_3 configuration variables

A_SYB_DATABASE configuration variable

A_SYB_DEADLOCK_LOOPS configuration variable

A_SYB_DEFAULT_CONNECTION configuration variable

A_SYB_EXTRA_PROC configuration variable

A_SYB_FAST_ACCESS configuration variable

A_SYB_FORCED_INDEX configuration variable

A_SYB_LOCK_DB configuration file

A_SYB_LOGIN configuration variable

A_SYB_MAX_BINARY_LENGTH configuration variable

A_SYB_MAX_CHAR_LENGTH configuration variable

A_SYB_MAX_CHARACTERS configuration variable

A_SYB_MAX_COLUMNS configuration variable

A_SYB_NATIVE_LOCK_TIMEOUT configuration variable

A_SYB_NO_COUNT_CHECK configuration variable

A_SYB_NO_DBCLOSE configuration variable

A_SYB_NO_DBID configuration variable

A_SYB_NO_RECORD_LOCKS configuration variable

A_SYB_NO_TABLE_LOCKS configuration variable

A_SYB_NO_23_ON_START configuration variable

A_SYB_PACKETSIZE configuration variable

A_SYB_PASSWD configuration variable

A_SYB_ROWCOUNT configuration variable

A_SYB_SELECT_KEY_ONLY configuration variable

A_SYB_SKIP_ALTERNATE_KEYS configuration variable

A_SYB_TRANSACTION_LEVEL configuration variable

A_SYB_TRANSLATE_TO_ANSI configuration variable

A_SYB_UNLOCK_ON_EXECUTE configuration variable

A_SYB_USE_DROPDOWN_QUERIES configuration variable

A_SYB_VISION_LOCKS_FILE configuration variable

Record and Table Locking

Stored Procedures

Developer- or Site-supplied Stored Procedures

Built-in Stored Procedures

sp_AcuInit

sp_AcuRemoveUnusedLocks_1

sp_AcuTableReport_1

Record-locking Issues in Transactions

Appendix F: Acu4GL for DB2 Information

DB2 Concepts Overview

Transactions

Acu4GL and Record Locking

Installation and Setup

Windows Installation Steps

UNIX Installation Steps

Sample ACUCOBOL-GT runtime configuration file

Setting Up the User Environment

To set up the user environment

Designating the Host Data Source

A_DB2_ALTERNATE_COMMIT_LOGIC configuration variable

Decimal Points

Configuration File Variables

A_DB2_CATALOG configuration variable

A_DB2_COMMIT_ON_BEGIN

A_DB2_DATASOURCE configuration variable

A_DB2_ERROR_MAP_FILE configuration variable

To create an error map

A_DB2_ISOLATION_LEVEL configuration variable

A_DB2_LOCK_METHOD configuration variable

A_DB2_LOGIN configuration variable

A_DB2_PASSWD configuration variable

A_DB2_STRICT_EQUAL configuration variable

A_DB2_TABLE_TYPES configuration variable

A_DB2_USE_CATALOG configuration variable

A_DB2_USE_CHAR_FOR_BINARY configuration variable

A_DB2_USE_SQLCOLUMNS configuration variable

A_DB2_USE_SQLTABLES configuration variable

USER_PATH (for DB2) configuration variable

Record and Table Locking

Mapping DB2 Data Types to COBOL Data Types

Data Type Mapping