HP Transact Reference Manual MPE/iX 5.0 Documentation
HP Transact Reference Manual
Table of Contents
HP Transact Reference Manual
HP Transact Reference Manual : COPYRIGHT NOTICE
Ch 1. Introduction to Transact
Transact Features and Benefits
Consistent Interface to HP File Structures
Integration with System Dictionary and Dictionary/V
Command Structure Reduces Coding Time
Development of Block-Mode or Character-Mode Applications
Examples
Built-in Debugging Facilities
Options for Producing Reports
Additional Features
Ch 2. Program Structure
SYSTEM Statement
DEFINE(ITEM) Statement
LIST Statement
END and EXIT Statements
Statements
Labels
Verbs
Modifiers
Target
Option-List
Compound Statements
Statement Formatting
Comments
Delimiters
Reserved Words
Ch 3. Data Items
Data Item Definitions
Data Item Names
Data Item Types
Data Item Sizes
Data Type Compatibility
Data Types and VPLUS
Data Types and Databases
Data Types and Data Dictionaries
Parent Items and Child Items
Compound Items
Array Subscripting
Defining and Handling Arrays
Simple Arrays
Complex Arrays
Child Identified as Simple Items
Child Items Defined as Compound Items
Special Considerations
Alias Items
Using Dictionary Definitions with Data Item Relations
Ch 4. Transact Registers
List and Data Registers
Managing the List and Data Registers
Key and Argument Registers
Key Register
Argument Register
Match Register
Update Register
Input Register
Status Register
How Registers Work
Verbs and Registers
Sample of Transact Coding
Ch 5. User Interface
Command Sequences
Processing Command Sequences
Command and Subcommand Labels
User-Entered Passwords for Commands and Subcommands
Built-in Commands
Command Qualifiers
DATA, INPUT, and PROMPT
Responding to a MATCH Prompt
VPLUS Interface
Local Form Storage
Look-Ahead Loading
Automatic Form Loading
Local Form Storage Example
Special Notes
Special Characters and Keys That Control Execution
Control Y
Data Entry Control Characters
MATCH Specification Characters
Field Delimiters
Special Keys for Use with VPLUS Forms
Ch 6. Accessing Databases and Files
Using Databases
Access Mode
Database Close
Database and File Locking
Locking Options Available with Transact
Avoiding Deadlocks in Transact Programs
Understanding the Optimized Locking Scheme
Using the LOCK Option with the Database Access Verbs
Using the LOCK Option with the LOGTRAN Statement
Dynamic Roll-Back
Locking
Examples of Locking Strategy With LOGTRAN
Limitations
DELETE Verb
REPLACE Verb
Database Unlocking
Using KSAM and MPE Files
Defining a Buffer Record
General Format for Key-Driven Access
Traversing a KSAM File by Primary Key
Traversal by Alternate Key
General Format for Generic Keys
Search with Generic Key
Simulating an Approximate Key Search
Chronological Traversal of a KSAM File
IPC Files
Ch 7. Error Handling
Automatic Error Handling
Data Entry Errors
Database or File Operation Errors
Arithmetic Calculations
Using the STATUS Option
Data Entry Errors
Database or File Operation Errors
Compiler Error Messages
Transact/V Error Message Formats
Transact/iX Error Message Formats
Error-Info
Run-time Error Messages
Error Message Format
Error-Info
Program-Name
Using EXPLAIN
Example
Ch 8. Transact Verbs
CALL
CLOSE
DATA
DEFINE
DELETE
DISPLAY
END
EXIT
FILE
FIND
FORMAT
GET
GO TO
IF
INPUT
ITEM
LET
LEVEL
LIST
LOGTRAN
MOVE
OUTPUT
PATH
PERFORM
PROC
PROMPT
PUT
REPEAT
REPLACE
RESET
RETURN
SET
SYSTEM
UPDATE
WHILE
Ch 9. Running Transact
Compiler Commands
Compiler Output Commands
Conditional Compilation Commands
System Dictionary Compiler Commands
Program Segmentation
Reserved File Names
The Transact/V Compiler
Bypassing Transact/V Compiler Prompts
Controlling Input Sources to the Transact/V Compiler
Controlling Output Destinations from the Transact/V Compiler
Executing Transact/V Programs
Controlling Input Sources to the Transact/V Processor
Controlling Output Destinations from the Transact/V Processor
The Transact/iX Compiler
Transact/iX Compiler Options
TRANCOMP Options Available to the Transact/iX Compiler
Compiling Programs for Static Calls
Example of Static Calls with Link-Time Linking
Example of Static Calls with Load-Time Linking
Dynamic Calls
Controlling Transact/iX Program Execution
Transact/iX Environment Variables
TRANDBMODE
TRANDEBUG
Compiling and Executing Transact/iX Programs
RUN TRAN.PUB.SYS
TRANXL
Statement Parts
TRANXLLK
Statement Parts
TRANXLGO
Statement Parts
LINK
LINKEDIT
RUN progname
Transact Compiler Listings
Transact Compiler Listings
Ch 10. Transact/V Test Facility
Statement Parts
TEST Output
Examples
Test Mode 1
Test Mode 3
Test Mode 4
Direct Test Output to File
Test Modes 22 through 25
Test Mode 25
Test Mode 34
Test Mode 42
Test Modes 101 and 102
Ch 11. Transact/iX Symbolic Debugger: TRANDEBUG
Overview
Features and Benefits
Symbolic Debugger
Breakpoints
Transact Display Functions
Transact Modify Functions
Program Execution Control
MPE/iX Subsystem Support
Source Code Window
TRANDEBUG Log and Command Files
Arithmetic Trapping
Control Y Trapping
Online Help
Compatibility
Using TRANDEBUG
Compiling with the TRANDEBUG Option
Starting and Ending TRANDEBUG Sessions
Displaying Source Code in TRANDEBUG
Setting a Breakpoint
Continuing Program Execution
Displaying the Values of Data Items
Modifying the Values of Data Items
Stepping Through a Program
TRANDEBUG Startup Initialization File
Redirecting VPLUS Input and Output
Disabling the Debugger
Alternative Debug Entry Points
TRANDEBUG Run-Time Environment
Arithmetic Traps
TRANDEBUG Commands
:
ABORT
AUTORPT
BREAK DELETE
BREAK LIST
BREAK SET
CONTINUE
DATA BREAK DELETE
DATA BREAK LIST
DATA BREAK REGISTER
DATA BREAK SET
DATA LOG
DEFN
DISPLAY BASE
DISPLAY CALLS
DISPLAY COMAREA
DISPLAY FILE
DISPLAY INPUT
DISPLAY ITEM
DISPLAY KEY
DISPLAY MATCH
DISPLAY PERFORMS
DISPLAY STATUS
DISPLAY STATUSDB
DISPLAY STATUSIN
DISPLAY UPDATE
EDIT
HELP
LABEL BREAK SET
LABEL JUMP
LOC
LOG
MODIFY INPUT
MODIFY ITEM
MODIFY KEY
MODIFY MATCH
MODIFY STATUS
MODIFY UPDATE
NMDEBUG
PAGE BACK
PAGE FORWARD
PAGE JUMP
PRINT
REPEAT
SORT
STEP
TPRINT
TRACE
USE
VERSION
WINDOW LENGTH
WINDOW OFF
WINDOW ON
Ap A. Flowcharts of File and Database Operations
Flowcharts of File and Database Operations
DELETE Charts
FIND Charts
GET Charts
OUTPUT Charts
PATH Charts
PUT Charts
REPLACE Charts
SET Charts
UPDATE Charts
Ap B. Native Mode Transact/iXMigration Guide
Exclusive Transact/iX Features
Additional Compiler Options
Options on the PROC Verb: Parameters Passed by Byte Address
Floating Point Formats
Dynamic Roll-Back
Critical Item Update
Symbolic Debugger
Exclusive Transact/V Features
MPE V-Related Compiler Options
Run-Time Item Attribute Resolution (Binding)
Test Modes
INITIALIZE
Calls to Transact/V Subprograms
UNLOAD and NOLOAD Options in the PROC Verb
TRANIN
Features that Differ Between Transact/V and Transact/iX
Multiple Systems in One File
Parameters Passed by Value or by Reference in the PROC Verb
Parent and Child Values in SET(UPDATE)
ALIGN Option of LIST and PROMPT Verbs.
Fill Characters Used for Data Type 9 with the MOVE Verb
Source Program Migration
Conversion
Data File Migration
File Format Conversion
Migration Examples
Data File Real Number Conversion
Procedures with Null 32 Bit Parameters
Migration Checklist
Ap C. Optimizing Transact Applications
Run-Time Stack
Compiler Statistics
Single-Segment Programs
Multiple-Segment Programs
Programs Using CALLs Without the SWAP Option
Programs Using CALLs with the SWAP Option
Stack Usage Comparison
Processing Time Optimization
Ap D. Architected Call Interface (ACI)
Introduction
Syntax
Parameters
Data Area Allocation
Database and File Handling
VPLUS Forms
Trap Handling
Examples
Pascal Code
Pascal Commands
COBOL Code
COBOL Commands
Pascal Code With Status
Ap E. Native Language Support
The SET(LANGUAGE) Statement
The RESET(LANGUAGE) Statement
Specifying the Language for the Compiler and Processor
Called Programs
Numeric Input
Numeric Output
Date and Time
IF and MATCH Changes
Upshifting and Character Types
Intrinsics That Support Native Languages
Examples:
INDEX
Index
MPE/iX 5.0 Documentation