Document Outline

• Guide to the DEC Text Processing Utility
  • Contents
    • Preface
      • Intended Audience
      • Document Structure
      • Related Documents
      • Reader’s Comments
      • How To Order Additional Documentation
      • Conventions
    • 1 Overview of the DEC Text Processing Utility
      • 1.1 Description of DECTPU
        • 1.1.1 DECTPU Features
        • 1.1.2 DECTPU and User Applications
        • 1.1.3 DECTPU Environments
      • 1.2 Description of DECwindows DECTPU
        • 1.2.1 DECwindows DECTPU and DECwindows Features
        • 1.2.2 DECwindows DECTPU and the DECwindows User Interface Language
      • 1.3 Description of EVE
      • 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.5 User-Written Procedures
      • 1.5 Terminals Supported by DECTPU
      • 1.6 Learning Path for DECTPU
    • 2 Getting Started with DECTPU
      • 2.1 Invoking DECTPU on OpenVMS Systems
        • 2.1.1 Default File Specifications
        • 2.1.2 Startup Files
      • 2.2 Invoking DECTPU from a DCL Command Procedure
        • 2.2.1 Setting Up a Special Editing Environment
        • 2.2.2 Creating a Noninteractive Application
      • 2.3 Invoking DECTPU from a Batch Job
      • 2.4 Using Journal Files
        • 2.4.1 Keystroke Journaling
        • 2.4.2 Buffer-Change Journaling
        • 2.4.3 Buffer-Change Journal File-Naming Algorithm
      • 2.5 Avoiding Errors Related to Virtual Address Space
      • 2.6 Using OpenVMS EDIT/TPU Command Qualifiers
        • 2.6.1 /CHARACTER_SET
        • 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
        • 2.6.14 /START_POSITION
    • 3 DEC Text Processing Utility Data Types
      • 3.1 Array Data Type
      • 3.2 Buffer Data Type
      • 3.3 Integer Data Type
      • 3.4 Keyword Data Type
      • 3.5 Learn Data Type
      • 3.6 Marker Data Type
      • 3.7 Pattern Data Type
        • 3.7.1 Using Pattern Built-In Procedures and Keywords
        • 3.7.2 Using Keywords to Build Patterns
        • 3.7.3 Using Pattern Operators
        • 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.9 Program Data Type
      • 3.10 Range Data Type
      • 3.11 String Data Type
      • 3.12 Unspecified Data Type
      • 3.13 Widget Data Type
      • 3.14 Window Data Type
        • 3.14.1 Defining 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
        • 3.14.8 Terminals That Do Not Support Windows
    • 4 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
        • 4.3.5 DECTPU Symbols
      • 4.4 Identifiers
      • 4.5 Variables
      • 4.6 Constants
      • 4.7 Operators
      • 4.8 Expressions
        • 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 Predefined Constants
        • 4.9.4 Declarations and Statements
        • 4.9.5 Miscellaneous Declarations
      • 4.10 Lexical Keywords
        • 4.10.1 Conditional Compilation
        • 4.10.2 Specifying the Radix of Numeric Constants
    • 5 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
        • 5.2.5 Using Closures
        • 5.2.6 Specifying Values for Widget Resources in DECwindows DECTPU
      • 5.3 Writing Code Compatible with DECwindows EVE
        • 5.3.1 Select Ranges in DECwindows EVE
      • 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.1 Procedure Execution
        • 5.5.2 Process Suspension
      • 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
        • 5.6.6 Using Command Files
        • 5.6.7 Using EVE Initialization Files
      • 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.2 Translation of Control Characters
      • A.3 Restoring Terminal Width Before Exiting from DECTPU
      • A.4 Running DECTPU from an OpenVMS Subprocess
    • B DECTPU Terminal Support
      • B.1 Using Screen-Oriented Editing on Supported Terminals
        • B.1.1 Terminal Settings on OpenVMS Systems That Affect DECTPU
        • B.1.2 SET TERMINAL Command
      • B.2 Using Line-Mode Editing on Unsupported Terminals
      • B.3 Using Terminal Wrap
    • C DECTPU Debugger Commands
    • Index
    • Examples
      • Example 1–1 Sample User-Written Procedure
      • Example 2–1 DCL Command Procedure FILENAME.COM
      • Example 2–2 DCL Command Procedure FORTRAN_TS.COM
      • Example 2–3 DCL Command Procedure INVISIBLE_TPU.COM
      • Example 2–4 DECTPU Command File GSR.TPU
      • Example 3–1 Suppressing the Addition of Padding Blanks
      • Example 4–1 Global and Local Variable Declarations
      • Example 4–2 Global and Local Constant Declarations
      • Example 4–3 Procedure That Uses Relational Operators on Markers
      • Example 4–4 Simple Procedure with Parameters
      • Example 4–5 Complex Procedure with Optional Parameters
      • Example 4–6 Procedure That Returns a Result
      • Example 4–7 Procedure Within Another Procedure
      • Example 4–8 Recursive Procedure
      • Example 4–9 Procedure That Uses the CASE Statement
      • Example 4–10 Procedure That Uses the ON_ERROR Statement
      • Example 4–11 Procedure with a Case-Style Error Handler
      • Example 4–12 Procedure That Returns a Value
      • Example 4–13 Procedure That Returns a Status
      • Example 4–14 Using RETURN in an ON_ERROR Section
      • Example 4–15 Simple Error Handler
      • Example 5–1 SHOW (SUMMARY) Display
      • Example 5–2 Syntax of a DECTPU Program
      • Example 5–3 Sample DECTPU Programs
      • Example 5–4 Sample Program for a Section File
      • Example 5–5 Source Code for Minimal Interface to DECTPU
      • Example 5–6 Command File for GOTO_TEXT_MARKER
      • Example 5–7 SHOW DEFAULTS BUFFER Display
      • Example A–1 Line-Mode Editing
      • Example A–2 Procedure to Display Control Characters
      • Example A–3 Procedure to Restore Screen to Original Width
      • Example A–4 Procedure to Run DECTPU from a Subprocess
      • Example B–1 DCL Command Procedure for SET TERM/NOWRAP
    • Figures
      • Figure 1–1 DECTPU as a Base for EVE
      • Figure 1–2 DECTPU as a Base for User-Written Interfaces
    • Tables
      • Table 2–1 Default File Specifications on OpenVMS Systems
      • Table 2–2 Journaling Behavior Established by EVE
      • Table 2–3 Character Set Values You Can Set with /CHARACTER_SET
      • Table 3–1 Keywords Used for Key Names
      • Table 3–2 Effects of Two String-Reduction Operations
      • Table 4–1 Categories of ASCII Character Set Characters
      • Table 4–2 Categories of DEC Multinational Character Set Characters
      • Table 4–3 Categories for ISO Latin1 Characters
      • Table 4–4 DECTPU Symbols
      • Table 4–5 DECTPU Operators
      • Table 4–6 Operator Precedence
      • Table 5–1 Relationship Between DECTPU Data Types and DECwindows Argument Data Types
      • Table 5–2 Special DECTPU Variables That Require a Value from a Layered Application
      • Table B–1 Terminal Behavior That Affects DECTPU’s Performance