Compaq AA-PWCBD-TE

Sample DECTPU Procedures

A.2 Translation of Control Characters

Example A–2 (Cont.) Procedure to Display Control Characters

LOOPCtrl_char_range := SEARCH_QUIETLY (Ctrl_char_pattern, FORWARD);

EXITIF Ctrl_char_range = 0;

POSITION (Ctrl_char_range);

! If we did not translate the character, move past it

IF NOT translate_controls (Ctrl_char_range)

THENMOVE_HORIZONTAL (1);

ENDIF;

ENDLOOP;

! Now display what we have done

!POSITION (BEGINNING_OF (translate_buffer));

MAP (translate_window, translate_buffer);

ENDPROCEDURE;

Sample DECTPU Procedures A–5

Contents

Main Guide to the DEC Text ProcessingUtility Page Contents Preface 1 Overview of the DEC Text Processing Utility 2 Getting Started with DECTPU 3 DEC Text Processing Utility Data Types 4 Lexical Elements of the DEC Text Processing Utility Language Page Page A Sample DECTPU Procedures B DECTPU Terminal Support C DECTPU Debugger Commands Index Examples Figures Tables Preface Intended Audience Document Structure Related Documents Readers Comments How To Order Additional Documentation Conventions The following conventions are used in this manual: Monospace text Page Overview of the DEC Text Processing Utility 1.1 Description of DECTPU 1.1.1 DECTPU Features 1.1 Description of DECTPU 1.1.2 DECTPU and User Applications 1.2 Description of DECwindows DECTPU 1.2 Description of DECwindows DECTPU 1.2.1 DECwindows DECTPU and DECwindows Features 1.2 Description of DECwindows DECTPU 1.2.2 DECwindows DECTPU and the DECwindows User Interface Language 1.3 Description of EVE 1.3 Description of EVE 1.4 DECTPU Language 1.4 DECTPU Language 1.4.1 Data Types 1.4.2 Language Declarations 1.4.3 Language Statements 1.4.4 Built-In Procedures 1.4 DECTPU Language 1.4.5 User-Written Procedures 1.5 Terminals Supported by DECTPU 1.6 Learning Path for DECTPU 1.6 Learning Path for DECTPU Getting Started with DECTPU 2.1 Invoking DECTPU on OpenVMS Systems 2.1 Invoking DECTPU on OpenVMS Systems 2.1.1 Default File Specications 2.1.2 Startup Files 2.1 Invoking DECTPU on OpenVMS Systems 2.2 Invoking DECTPU from a DCL Command Procedure 2.2.1 Setting Up a Special Editing Environment 2.2 Invoking DECTPU from a DCL Command Procedure 2.2.2 Creating a Noninteractive Application 2.2 Invoking DECTPU from a DCL Command Procedure 2.3 Invoking DECTPU from a Batch Job 2.3 Invoking DECTPU from a Batch Job 2.4 Using Journal Files 2.4 Using Journal Files 2.4.1 Keystroke Journaling 2.4.2 Buffer-Change Journaling 2.4 Using Journal Files 2.4.3 Buffer-Change Journal File-Naming Algorithm 2.5 Avoiding Errors Related to Virtual Address Space 2.5 Avoiding Errors Related to Virtual Address Space 2.6 Using OpenVMS EDIT/TPU Command Qualiers 2.6.1 /CHARACTER_SET $DEFINE TPU$CHARACTER_SET ISO_LATIN1 $EDIT/TPU $EDIT/TPU/CHARACTER_SET=general 2.6.2 /COMMAND 2.6.3 /CREATE 2.6.4 /DEBUG 2.6.5 /DISPLAY 2.6.6 /INITIALIZATION 2.6.7 /INTERFACE 2.6.8 /JOURNAL 2.6.9 /MODIFY 2.6.10 /OUTPUT 2.6.11 /READ_ONLY 2.6.12 /RECOVER 2.6.13 /SECTION Page DEC Text Processing Utility Data Types 3.1 Array Data Type 3.1 Array Data Type 3.1 Array Data Type 3.2 Buffer Data Type 3.2 Buffer Data Type 3.3 Integer Data Type 3.3 Integer Data Type 3.4 Keyword Data Type 3.4 Keyword Data Type 3.5 Learn Data Type 3.5 Learn Data Type 3.6 Marker Data Type Page 3.6 Marker Data Type 3.7 Pattern Data Type Page 3.7.1 Using Pattern Built-In Procedures and Keywords 3.7.2 Using Keywords to Build Patterns 3.7.3 Using Pattern Operators Page Page 3.7.4 Compiling and Executing Patterns 3.7.5 Searching for a Pattern 3.7.6 Anchoring a Pattern 3.8 Process Data Type 3.8 Process Data Type 3.9 Program Data Type 3.10 Range Data Type 3.10 Range Data Type 3.10 Range Data Type 3.11 String Data Type 3.11 String Data Type 3.12 Unspecied Data Type 3.12 Unspecied Data Type 3.13 Widget Data Type 3.14 Window Data Type 3.14.1 Dening Window Dimensions 3.14.2 Creating Windows 3.14.3 Displaying Window Values 3.14.4 Mapping Windows 3.14.5 Removing Windows 3.14.6 Using the Screen Manager 3.14.7 Getting Information on Windows Page Lexical Elements of the DEC Text Processing Utility Language 4.1 Overview 4.2 Case Sensitivity of Characters 4.3 Character Sets 4.3.1 DEC Multinational Character Set (DEC_MCS) 4.3.2 ISO Latin1 Character Set (ISO_LATIN1) 4.3.3 General Character Sets 4.3.4 Entering Control Characters For example: GOLD 27 GOLD Specins 4.3.5 DECTPU Symbols 4.4 Identiers 4.4 Identiers 4.5 Variables 4.5 Variables 4.6 Constants 4.6 Constants 4.7 Operators 4.7 Operators 4.8 Expressions Page 4.8.1 Arithmetic Expressions 4.8.2 Relational Expressions 4.8.3 Pattern Expressions 4.8.4 Boolean Expressions 4.9 Reserved Words 4.9.1 Keywords 4.9.2 Built-In Procedure Names 4.9.3 Predened Constants 4.9.4 Declarations and Statements Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page 4.9.5 Miscellaneous Declarations Page 4.10 Lexical Keywords 4.10 Lexical Keywords 4.10.1 Conditional Compilation 4.10 Lexical Keywords 4.10.2 Specifying the Radix of Numeric Constants DEC Text Processing Utility Program Development 5.1 Creating DECTPU Programs 5.1.1 Simple Programs 5.1.2 Complex Programs 5.1.3 Program Syntax 5.2 Programming in DECwindows DECTPU 5.2.1 Widget Support 5.2.2 Input Focus Support 5.2.3 Global Selection Support 5.2.4 Using Callbacks Page Page 5.2.5 Using Closures 5.2.6 Specifying Values for Widget Resources in DECwindows DECTPU Page Page 5.3 Writing Code Compatible with DECwindows EVE 5.3 Writing Code Compatible with DECwindows EVE 5.3.1 Select Ranges in DECwindows EVE 5.3 Writing Code Compatible with DECwindows EVE 5.4 Compiling DECTPU Programs 5.4 Compiling DECTPU Programs 5.4.1 Compiling on the EVE Command Line 5.4.2 Compiling in a DECTPU Buffer 5.5 Executing DECTPU Programs 5.5 Executing DECTPU Programs 5.5.1 Procedure Execution 5.5.2 Process Suspension 5.5 Executing DECTPU Programs 5.6 Using DECTPU Startup Files 5.6.1 Section Files 5.6.2 Command Files 5.6.3 Initialization Files 5.6.4 Sequence in Which DECTPU Processes Startup Files 5.6.5 Using Section Files Page Page Example 55 Source Code for Minimal Interface to DECTPU Page 5.6.6 Using Command Files 5.6.7 Using EVE Initialization Files Page Page 5.7 Debugging DECTPU Programs 5.7.1 Using Your Own Debugger 5.7.2 Using the DECTPU Debugger 5.7.3 Getting Started with the DECTPU Debugger 5.8 Handling Errors A Sample DECTPU Procedures A.1 Line-Mode Editor A.1 Line-Mode Editor A.2 Translation of Control Characters Page Page Page A.3 Restoring Terminal Width Before Exiting from DECTPU A.3 Restoring Terminal Width Before Exiting from DECTPU A.4 Running DECTPU from an OpenVMS Subprocess A.4 Running DECTPU from an OpenVMS Subprocess Page B DECTPU Terminal Support B.1 Using Screen-Oriented Editing on Supported Terminals B.1.1 Terminal Settings on OpenVMS Systems That Affect DECTPU DECTPU Terminal Support B.1 Using Screen-Oriented Editing on Supported Terminals B.2 Using Line-Mode Editing on Unsupported Terminals B.3 Using Terminal Wrap Page C DECTPU Debugger Commands DECTPU Debugger Commands Index A B C D E F G I J K L M N O Q R S T U V W X