extend Interoperability Suite

Program Addresses

Debugger Restrictions

Using the Abend Diagnostic Report (ADR)

Generating a Report

Getting Object Information

ADR Restrictions

Object File Utility - cblutil

Object Libraries

Creating Object Libraries

Examples

Creating Remote Object Libraries

Examples

Generating Native Code

Vision File Utility - vutil

Examining File Information

Testing File Integrity

Modifying Keys in an Existing File

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

Testing for Vision File Locking Compatibility

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

IDENTITY-COLUMN 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-COLUMN (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

SYNCHRONIZED Clause (ACUCOBOL-GT)

JUSTIFIED 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

Appendix C. Changes Affecting Previous Versions

Changes Affecting Version 10.3.x

Changes Affecting Version 10.2.1

Changes Affecting Version 10.2.0

Changes Affecting Version 10.1.1

Changes Affecting Version 10.1.0

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

Introduction to Intrinsic Functions

Function Definitions and Returned Values

Function Definitions

ABSOLUTE-VALUE (ABS) Function

COUNT-LEADING Function

COUNT-TRAILING Function

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

INTERVAL-TIMER 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_PRESERVE_SIGNAL_HANDLERS

A_REMOVE_EMPTY_ERROR_FILE

A_RETRY_DELAY

A_SEQ_DEFAULT_BLOCK_SIZE

A_SYSLOG_ON_RUNTIME_ERROR

A_TMPDIR

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

ASQL_AUTO_DATE_FORMAT

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

PARAGRAPH_TRACE

PDF_FONT_NAME

PDF_FONT_SIZE

PDF_FONT_TRUETYPE_TTC

PDF_FONT_TRUETYPE_TTC_INDEX

PDF_FONT_TRUETYPE_TTF

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

Supported PDF Printing Functions

C$TOUPPER and C$TOLOWER

C$XML

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

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

Spooler Print Formatting

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.3.1 Run-Time Manual

Introduction

Overview

Available Runtime Systems

Windows Runtime Systems

Data Execution Prevention

DEP-aware Runtime Systems and Thin Clients

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

3D_LINES configuration variable

7_BIT configuration variable

A_EXTFH_SIMPLE_OPEN_OUTPUT

A_EXTFH_VARIABLE_x

A_JAVA_CHARSET

A_JAVA_GC_COUNT

A_JAVA_TRACE_FILENAME

A_PRESERVE_SIGNAL_HANDLERS

A_REMOVE_EMPTY_ERROR_FILE

A_RETRY_DELAY

A_SEQ_DEFAULT_BLOCK_SIZE

A_SYSLOG_ON_RUNTIME_ERROR

A_TMPDIR

A_XML_ENCODING

A_XMIF_EXPORT_EMPTY_ARRAY

A_XMLIF_EXPORT_OUTLINE

AGS_RECEIVE_BUFFER_SIZE

alfred Configuration variables

ASQL_AUTO_DATE_FORMAT

AXML_EXACT_TABLE_MATCH

AXML_IGNORE_EMPTY_DATA

AXML_SCHEMA_DOC

AXML_SCHEMA_NAME

AXML_SCHEMA_NAMESPACE_DATA

AXML_STYLESHEET_x

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

PARAGRAPH_TRACE

PDF_FONT_NAME

PDF_FONT_SIZE

PDF_FONT_TRUETYPE_TTC

PDF_FONT_TRUETYPE_TTC_INDEX

PDF_FONT_TRUETYPE_TTF

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

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

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

Object Libraries

Creating Object Libraries

Examples of Creating Object Libraries

Creating Remote Object Libraries

Examples of Creating Remote Object Libraries

Getting Object Information

Generating Native Code

Vision File Utility

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.3.1 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?

XFDs and Mapping

Summary

Getting Started

Installation

Demonstration Program

Compiling and Running the Demo 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

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

Invalid Data

Illegal COBOL Data

Invalid Key Data

Invalid Data Other Than Keys

Working with COBOL

Examples of Preparing and Compiling a Program

Example 1 - Compiling with just the -Fx compiler option

Example 2 - Compiling with the WHEN XFD Directive

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

Compiler and Runtime Options

Compiler File Options

Run-time Configuration Variables

4GL_CONVERT_DATE_ZERO

4GL_DB_MAP

4GL_EXTRA_DB_COLS_OK

4GL_FULL_DATA_TEST

4GL_IGNORED_SUFFIX_LIST

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_NO_TRANSACTION_ERROR

Configuration File Variables

A_INF_DUPLICATE_KEY

A_INFORMIX_ERROR_FILE

Microsoft SQL Server Concepts Overview

Appendix B: Acu4GL for Microsoft SQL Server

Installation and Setup

Installing the Server and Client Machine

To install Acu4GL for Microsoft SQL Server

Setting Up a User Login

Supported Data Types for SQL Server

Configuration File Variables

A_MSSQL_ADD_IDENTITY

A_MSSQL_ADD_TIMESTAMP

A_MSSQL_APPROLE_NAME

A_MSSQL_APPROLE_PASSWD

A_MSSQL_CREATE_UNICODE_COLUMNS

A_MSSQL_CURSOR_OPTION_1,2,3

A_MSSQL_DATABASE

A_MSSQL_DEADLOCK_LOOPS

A_MSSQL_DEFAULT_CONNECTION

A_MSSQL_DEFAULT_OWNER

A_MSSQL_DO_NOT_TRANSLATE_CHAR

A_MSSQL_FAILOVER_PARTNER

A_MSSQL_FAILOVER_PARTNER_SPN

A_MSSQL_IGNORE_GUID_COLUMNS

A_MSSQL_FAST_ACCESS

A_MSSQL_LIMIT_DROPDOWN

A_MSSQL_LOCK_DB

A_MSSQL_LOGIN

A_MSSQL_MAX_BINARY_LENGTH

A_MSSQL_MAX_CHAR_LENGTH

A_MSSQL_MAX_CHARACTERS

A_MSSQL_MAX_COLUMNS

A_MSSQL_MULTI_SUBNET_FAILOVER

A_MSSQL_NATIVE_LOCK_TIMEOUT

A_MSSQL_NO_23_ON_START

A_MSSQL_NO_CACHED_READ

A_MSSQL_NO_COUNT_CHECK

A_MSSQL_NO_DBID

A_MSSQL_NO_RECORD_LOCKS

A_MSSQL_NO_TABLE_LOCKS

A_MSSQL_NT_AUTHENTICATION

A_MSSQL_ODBC_DRIVER_NAME

A_MSSQL_PACKETSIZE

A_MSSQL_PASSWD

A_MSSQL_ROWCOUNT

A_MSSQL_SELECT_KEY_ONLY

A_MSSQL_SEPARATE_LOCK_CONN

A_MSSQL_SERVER_SPN

A_MSSQL_SKIP_ALTERNATE_KEYS

A_MSSQL_STRIP_PATH_INFO

A_MSSQL_TRANSACTION_LEVEL

A_MSSQL_TRANSLATE_TO_ANSI

A_MSSQL_UNLOCK_ON_EXECUTE

A_MSSQL_UPDATE_PRIMARY_COLS

A_MSSQL_USE_DROPDOWN_QUERIES

A_MSSQL_VISION_LOCKS_FILE

Using the Database Table

Working with Tables Containing Identity Columns

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

Limits and Ranges

Runtime Errors

Record Locking Issues in Transactions

Appendix C: Acu4GL for Oracle

Oracle Concepts Overview

Transactions

Acu4GL and Record Locking

The open_cursors Parameter

Table Ownership

Security

Installation and Setup

Windows Installation Steps

To Set Up a Service Name for an Oracle Database

UNIX Installation Steps

Completing the Installation

Checking System Parameters

To set the system parameters

Setting Up a User Account

To Configure a Login

Setting Up the Search Path

Handling Transactions

Oracle's Instant Client

To Test the Installation of Oracle's Instant Client

A_ORA_RETURN_SUCCESS_INFO

Configuration File Variables

A_ORA_DATABASE

A_ORACLE_ERROR_FILE

A_ORA_HINTS

A_ORA_KEEP_START_CURSOR

A_ORA_LIMIT_DROPDOWN

A_ORA_MAX_FILE_CURSORS

A_ORA_NLS_SORT

USER_PATH (for Oracle)

Using the Database Table

Acu4GL for ODBC Installation

Appendix D: Acu4GL for ODBC

ODBC Concepts

Installation and Setup

ODBC Installation

Supported Drivers

Setting Up Data Sources

Designating the Host Data Source

A_ODBC_ALTERNATE_COMMIT_LOGIC

Decimal Points

Configuration File Variables

A_ODBC_CATALOG

A_ODBC_COMMIT_ON_BEGIN

A_ODBC_DATASOURCE

A_ODBC_ERROR_MAP_FILE

A_ODBC_ISOLATION_LEVEL

A_ODBC_LOCK_METHOD

A_ODBC_LOGIN

A_ODBC_NO_NULL_COLUMNS

A_ODBC_PASSWD

A_ODBC_PRINT_LOG

A_ODBC_QUOTE_IDENTIFIERS

A_ODBC_STRICT_EQUAL

A_ODBC_TABLE_TYPES

A_ODBC_UNSIGNED_TINYINT

A_ODBC_USE_CATALOG

A_ODBC_USE_CHAR_FOR_BINARY

A_ODBC_USE_SPACE_IN_DATES

A_ODBC_USE_SQLCOLUMNS

A_ODBC_USE_SQLTABLES

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 Installations

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_CURSOR_OPTION_1, A_SYB_CURSOR_OPTION_2, A_SYB_CURSOR_OPTION_3

Configuration File Variables

A_SYB_ADD_IDENTITY

A_SYB_ADD_TIMESTAMP

A_SYB_CHECK_DELETE_SP

A_SYB_CHECK_INSERT_SP

A_SYB_CHECK_READ_SP

A_SYB_CHECK_UPDATE_SP

A_SYB_DATABASE

A_SYB_DEADLOCK_LOOPS

A_SYB_DEFAULT_CONNECTION

A_SYB_MAX_BINARY_LENGTH

A_SYB_MAX_CHAR_LENGTH

A_SYB_MAX_CHARACTERS

A_SYB_MAX_COLUMNS

A_SYB_NATIVE_LOCK_TIMEOUT

A_SYB_NO_COUNT_CHECK

A_SYB_NO_DBCLOSE

A_SYB_NO_DBID

A_SYB_NO_RECORD_LOCKS

A_SYB_SELECT_KEY_ONLY

A_SYB_SKIP_ALTERNATE_KEYS

A_SYB_TRANSACTION_LEVEL

A_SYB_TRANSLATE_TO_ANSI

A_SYB_UNLOCK_ON_EXECUTE

A_SYB_USE_DROPDOWN_QUERIES

A_SYB_VISION_LOCKS_FILE

Record and Table Locking

Stored Procedures

Developer- or Site-supplied Stored Procedures

Built-in Stored Procedures

sp_AcuInit

sp_AcuRemoveUnusedLocks_1

sp_AcuTableReport_1

Limits and Ranges

Runtime Errors

Appendix F: Acu4GL for DB2

DB2 Concepts Overview

Transactions

Record-locking Issues in 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 DB2 User Environment

Designating the Host Data Source

A_DB2_ALTERNATE_COMMIT_LOGIC

Decimal Points

Configuration File Variables

A_DB2_CATALOG

A_DB2_COMMIT_ON_BEGIN

A_DB2_DATASOURCE

A_DB2_ERROR_MAP_FILE

To create an error map

A_DB2_ISOLATION_LEVEL

A_DB2_USE_CHAR_FOR_BINARY

A_DB2_USE_SQLCOLUMNS

A_DB2_USE_SQLTABLES

USER_PATH (for DB2)

Record and Table Locking

Limits and Ranges

Data Type Mapping

Runtime Errors