GT.M Programmer's Guide

Table of Contents

About This Manual

Intended Audience

Purpose of the Manual

How to Use This Manual

Examples

1. About GT.M

Programming Environment

2. GT.M Language Extensions

MDC Type A Releases

Operating System Interface Facilities

Debugging Facilities

Exception Handling Facilities

Journaling Extensions

Extensions For Additional Capability

GT.M Device Handling Extensions

3. Program Development Cycle

Logical Names

Commands and Symbols

Preparing the Database

Creating and Editing a Source Program

Compiling a Source Program

Creating a Library

Controlling Run-time Parameters

Linking

LINKing from DCL

Executing from DCL

4. Operating and Debugging in Direct Mode

Operating in Direct Mode

Debugging a Routine in Direct Mode

Summary of GT.M Debugging Tools

5. General Language Features of M

Data Types

M Names

Variables

Literals

Expressions

Operators

Commands

Intrinsic Functions

Intrinsic Special Variables

Routines

Indirection

Parameter Passing

External Calls

Extrinsic Functions

Extrinsic Special Variables

Transaction Processing

6. Commands

Break

Close

Do

Else

For

Goto

Halt

Hang

If

Job

Kill

Lock

Using Locks within Transactions

Merge

New

Open

Quit

Read

Set

TCOMMIT

TREstart

TROllback

TStart

Use

View

WRITE

Xecute

ZALLOCATE

ZATtach

ZBreak

ZCompile

ZContinue

ZDeallocate

ZEDit

ZGoto

ZHelp

ZLink

ZKill

ZMessage

ZPrint

ZSHow

ZSTep

ZSYstem

ZTCommit

ZTStart

ZWIthdraw

ZWRite

7. Functions

$ASCII()

$Char()

$Data()

$Extract()

$Find()

$FNumber()

$Get()

$Justify()

$Length()

$NAme()

$Next()

$Order()

$Piece()

$Qlength()

$Qsubscript()

$Query()

$Random()

$Reverse()

$Select()

$Stack()

$Text()

$TRanslate()

$View()

$ZBIT Functions

$Zcall()

$ZDate()

$ZFILEattributes()

$ZGETDVI()

$ZGETJPI()

$ZGETLKI()

$ZGETSYI()

$ZJOBEXAM()

$ZLKID()

$ZMessage()

$ZPARSE()

$ZPID()

$ZPrevious()

$ZPRIVilege()

$ZQGBLMOD()

$ZSEARCH()

$ZSETPRV()

$ZTRNLNM()

8. Intrinsic Special Variables

$Device

$ECode

$EStack

$ETrap

$Horolog

$IO

$Job

$Key

$Principal

$Quit

$Reference

$STack

$Storage

$SYstem

$Test

$TLevel

$TRestart

$X

$Y

$ZA

$ZB

$ZCMdline

$ZCOmpile

$ZCstatus

$ZDAteform

$ZDirectory

$ZEDit

$ZEOf

$ZError

$ZGbldir

$ZINTerrupt

$ZINInterrupt

$ZIO

$ZJob

$ZLevel

$ZMAXTPTIme

$ZMOde

$ZPOSition

$ZPROCess

$ZPROMpt

$ZROutines

$ZSOurce

$ZStatus

$ZSTep

$ZSYstem

$ZTExit

$ZTrap

$ZVersion

$ZYERror

9. Input/Output Processing

I/O Intrinsic Special Variables

I/O Devices

Using Terminals

Using Sequential (RMS) Files

Using Mailboxes

Using Null Devices

Using Socket Devices

I/O Commands

10. Utility Routines

Using the Utilities

Date and Time Utilities

Conversion Utilities

Mathematic Utilities

Global Utilities

Routine Utilities

Internationalization Utilities

System Management Utilities

GT.M Utilities Summary Table

11. Integrating External Routines

Calls to External Routines

External Call Tables

External Call Parameter Passing

External Call Error Processing

Receiving String Arguments from External Routines

Compiling Procedures

Linking Procedures

Important Considerations for External Calls

External Call Example

Calls from External Routines

12. Database Access Library

Invoking DAL Functions from External Routines

Initializing the GT.M Run-time Environment

Call Arguments

Data Types and Descriptors

Routines Example

13. Internationalization

Collation Sequence Definitions

Creating the User-defined Collation Routines

Matching Alternative Patterns

14. Error Processing

Compile Time Error Message Format

Processing Compile Time Errors

Run-time Error Message Format

Processing Run-time Errors

Program Handling of Errors

Error Actions

Index