HP Transact Computer System Manual

HP 3000 Computer Systems
HP TRANSACT
Quick Reference Guide
ABCDE
HP Part No. 32247-90020
Printed in U.S.A.
Second Edition
E0494
The information contained in this document is subject to change without notice.
HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD
TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. Hewlett-Packard shall not be liable for errors contained herein or use of this
material.
Hewlett-Packard assumes no responsibility for the use or reliability of its software on
equipment that is not furnished by Hewlett-Packard.
This document contains proprietary information which is protected by copyright. All
rights are reserved. No part of this document may be photocopied, reproduced, or
translated to another language without the prior written consent of Hewlett-Packard
Company.
Copyright c 1992, 1994 by Hewlett-Packard Company
Contents
1.
Transact Verbs
CALL . . .
CLOSE . .
DATA . . .
DEFINE . .
DELETE .
DISPLAY .
END . . .
EXIT . . .
FILE . . .
FIND . . .
FORMAT .
GET . . .
GO TO . .
IF . . . .
INPUT . .
LET . . .
LEVEL . .
LIST . . .
LOGTRAN
MOVE . .
OUTPUT .
PATH . . .
PERFORM
PROC . . .
PROMPT .
PUT . . .
REPEAT .
REPLACE .
RESET . .
RETURN .
SET . . . .
SYSTEM .
UPDATE .
WHILE . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
1-1
1-1
1-2
1-3
1-4
1-5
1-6
1-6
1-7
1-8
1-9
1-10
1-11
1-12
1-13
1-13
1-14
1-15
1-16
1-17
1-17
1-19
1-19
1-20
1-21
1-22
1-23
1-24
1-25
1-25
1-26
1-28
1-29
1-30
Contents-1
2.
Running Transact
3.
Test Facility (Transact/V)
4.
TRANDEBUG Commands (Transact/iX)
Compiler Output Commands . . . . . . . . . . .
System Dictionary Commands . . . . . . . . . .
Conditional Compile Commands . . . . . . . . .
Transact/V Program Compilation . . . . . . . . .
Formal File Designators for Transact/V Compilation
Transact/V Program Execution . . . . . . . . . .
Formal File Designators for Transact/V Execution .
Transact/iX Compilation and Execution . . . . . .
Transact/iX Compiler Options . . . . . . . . . .
Formal File Designators for Transact/iX Compilation
Formal File Designators for Transact/iX Execution .
Architected Call Interface (ACI) . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
2-1
2-1
2-1
2-2
2-3
2-3
2-3
2-4
2-4
2-5
2-5
2-6
Enabling Test Modes . . . . . . . . . . . . . . . . . . . . . . . . .
Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . .
3-1
3-1
: . . . . . . . . . . . .
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 . . . . . . . . . .
Contents-2
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
4-1
4-1
4-1
4-1
4-1
4-2
4-2
4-2
4-2
4-2
4-3
4-3
4-3
4-3
4-3
4-4
4-4
4-4
4-4
4-4
4-5
4-5
4-5
4-5
4-5
4-5
4-6
4-6
4-6
4-6
4-6
4-7
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 . . . .
TRANDEBUG Files
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
4-7
4-7
4-7
4-7
4-8
4-8
4-8
4-8
4-8
4-8
4-9
4-9
4-9
4-9
4-9
4-10
4-10
4-10
4-10
4-10
4-10
4-11
Contents-3
1
Transact Verbs
CALL
CALL le-name[([password,][mode])][,option-list];
OPTIONS
DATA=item-name[(subscript)]
SIZE=number
SWAP
INFORM
REPORT
STATUS
Example
CALL INVMGT ("PASS",7),DATA=ORDER,SIZE=1000,STATUS;
CLOSE
2
3
CLOSE source ,option-list ;
SOURCE
le-name
$FORMLIST
$PRINT
$VPLS
set-name(base-name)
@[(base-name )]
-
MPE or KSAM file
VPLUS spool file
TRANLIST print file
active formfile
IMAGE dataset
IMAGE database
OPTIONS
ERROR=label([item-name])
NOMSG
STATUS
Example
CLOSE KDATA;
Transact Verbs
1-1
DATA
DATA[(modier)][item-name][("prompt-string")][,option-list][:item-name...]...;
MODIFIERS
none - Places value in data register
ITEM - Prompts for item name and places value in data register
KEY
- Places value in argument register
MATCH - Places value in data and match registers
PATH - Places value in data and argument registers
SET
- Places value in data register if entered
UPDATE - Places value in data and update registers
OPTIONS
BLANKS
CHECK=set-name
CHECKNOT=set-name
NOECHO
NULL
RIGHT
STATUS
Example
DATA CUSTNUM ("Please enter customer number"),BLANKS,CHECK=CUST-M;
1-2
Transact Verbs
DEFINE
DEFINE(modier) denition-list ;
MODIFIERS
ENTRY
- Defines a program control label
INTRINSIC - Defines MPE intrinsic to be called
ITEM
- Defines one or more items, a synonym, a marker item
DEFINITION WITH DEFINE(ENTRY)
label[:label]
DEFINITION WITH DEFINE(INTRINSIC)
intrinsic-name[:intrinsic-name]
DEFINITION WITH DEFINE(ITEM)
item-name[count]
[type(size[,decimal-length[,storage-length]])]
[=parent-name[(position)]]
[,ALIAS=(alias-reference)]
[,COMPUTE=arithmetic-expression]
[,EDIT="edit-mask"]
[,ENTRY="entry-text"]
[,HEAD="heading-text"]
[,INIT=[value|(BINARY(value))|(HEX(value))|(OCTAL(value))]
[,OPT]
[:item-name...]
Example
DEFINE(ITEM) TOTAL I(4,0,2),COMPUTE=[(QTY)*(PRICE)];
Transact Verbs
1-3
DELETE
2
3
2
3
DELETE (modier) source ,option-list ;
MODIFIERS
none
- Deletes from master set
CHAIN
- Deletes from detail set or KSAM file
based on key
CURRENT - Deletes last entry accessed from KSAM file
or data set
DIRECT - Deletes entry at specified record number in KSAM
file or data set
PRIMARY - Deletes from master set at the primary location
RCHAIN - Same as CHAIN in reverse order for a data set;
same as CHAIN for KSAM file
RSERIAL - Same as SERIAL in reverse order for data set;
same as SERIAL for KSAM file
SERIAL - Deletes entries in serial mode
SOURCE
le-name
set-name[(base-name)]
OPTIONS
ERROR=label[([item-name])]
LIST=(range-list)
LOCK
NOCOUNT
NOMATCH
NOMSG
PERFORM=label
RECNO=item-name[(subscript)]
SINGLE
SOPT
STATUS
Example
DELETE(CHAIN) ORDER-D,NOMATCH,PERFORM=PRINT-PARA;
1-4
Transact Verbs
DISPLAY
2 2
DISPLAY ( TABLE
32
3 32
,FILE=mpe-le )
3
display-list . . . ;
DISPLAY LIST
display-eld[,format-parm]...
[:display-eld[,format-parm]...]
DISPLAY FIELDS
item-name[(subscript)]
"string"
$CPU
$DATELINE
$PAGE
$TIME
$TODAY
FORMAT PARAMETER
CCTL=number
CENTER
COL=number
EDIT="edit-string"
HEAD="character-string"
JOIN[=number]
LEFT
LINE[=number]
LNG=number
NEED=number
NOCRLF
NOHEAD
NOSIGN
PAGE[=number]
RIGHT
ROW=number
SPACE[=number]
TITLE
TRUNCATE
ZERO[E]S
Example
DISPLAY CUSTNUM,LINE=1,NOHEAD,COL=10;
Transact Verbs
1-5
END
2
3
END modier ;
MODIFIERS
none
(LEVEL)
system-name
(SEQUENCE)
Example
END PROG1;
EXIT
EXIT;
Example
EXIT;
1-6
Transact Verbs
-
Ends the command sequence
Ends the current level
Ends the executing program file
Returns to command level
FILE
3
2
FILE(modier) le-name ,option-list ;
MODIFIERS
CLOSE
CONTROL OPEN
READ
SORT
UPDATE WRITE
-
Closes the file
Performs an FCONTROL operation
Opens the file
Reads record from the file
Sorts the file
Replaces current record
Writes record to file
OPTIONS WITH CONTROL
CODE=number
PARM=item-name[(subscript)]
OPTION WITH OPEN, READ, UPDATE, and WRITE
LIST=(range-list)
OPTION WITH SORT
8
< SORT=(range-list) 9
=
(ASC)
(ASC)
. . . ]) ;
[,item-name2
: SORT=(item-name1
(DES)
(DES)
Example
FILE(CONTROL) MPEFILE,CODE=45;
Transact Verbs
1-7
FIND
2
3
2
3
FIND (modier) source ,option-list ;
MODIFIERS
none
- Retrieves from master set
CHAIN
- Retrieves from detail set or KSAM file
based on key
CURRENT - Retrieves last entry accessed from KSAM file,
data set. or MPE file
DIRECT - Retrieves entry at specified record number
PRIMARY - Retrieves from master set at the primary location
RCHAIN - Same as CHAIN only reverse order for data set;
same as CHAIN for KSAM file
RSERIAL - Same as SERIAL only reverse order for data set;
same as SERIAL for KSAM or MPE file
SERIAL - Retrieves entries in serial mode
SOURCE
le-name
set-name[(base-name)]
OPTIONS
ERROR=label[([item-name])]
LIST=(range-list)
LOCK
NOMATCH
NOMSG
PERFORM=label
RECNO=item-name[(subscript)]
SINGLE
SOPT
(ASC)
(ASC)
SORT=(item-name1
[,item-name2
. . . ])
(DES)
(DES)
STATUS
WORKFILE
Example
FIND(SERIAL) CUST-M,LIST=(CUSTNUM),
SORT=(CUSTNUM),PERFORM=PARA;
1-8
Transact Verbs
FORMAT
FORMAT display-list;
DISPLAY LIST
display-eld[,format-parm]...
[:display-eld[,format-parm]...]
DISPLAY FIELDS
item-name[(subscript)]
"string"
$CPU
$DATELINE
$PAGE
$TIME
$TODAY
FORMAT PARAMETERS
CCTL=number
CENTER
COL=number
EDIT="edit-string"
HEAD="character-string"
JOIN[=number]
LEFT
LINE[=number]
LNG=number
NEED=number
NOCRLF
NOHEAD
NOSIGN
PAGE[=number]
RIGHT
ROW=number
SPACE[=number]
TITLE
TRUNCATE
ZERO[E]S
Example
FORMAT CUSTNUM,LINE=2,NOHEAD,COL=10;
Transact Verbs
1-9
GET
2
3
2
3
GET (modier) source ,option-list ;
MODIFIERS
none
- Retrieves from master set
CHAIN
- Retrieves from detail set or KSAM file
based on key
CURRENT - Retrieves last entry accessed from KSAM or
MPE file or data set
DIRECT - Retrieves entry at specified record number
FORM
- Displays VPLUS form and retrieves data
KEY
- Calculated access on master set
PRIMARY - Retrieves from master set at the primary location
RCHAIN - Same as CHAIN in reverse order for data set;
same as CHAIN for KSAM file
RSERIAL - Same as SERIAL in reverse order for data set;
same as SERIAL for KSAM or MPE file
SERIAL - Retrieves entries in serial mode
SOURCE
le-name
set-name[(base-name)]
SOURCE WITH FORM
form-name
(item-name[(subscript)])
* - the CURRENT FORM name
& - the NEXT FORM name
OPTIONS WITHOUT THE FORM MODIFIER
ERROR=label([item-name])
LIST=(range-list)
LOCK
NOFIND
NOMATCH
NOMSG
RECNO=item-name[(subscript)]
STATUS
OPTIONS WITH THE FORM MODIFIER
APPEND
AUTOREAD
CLEAR
CURRENT
CURSOR=eld-name|item-name[(subscript)]
FEDIT
1-10
Transact Verbs
FKEY=item-name[(subscript)]
Fn[(AUTOREAD)]=label
FREEZE
INIT
LIST=(range-list)
STATUS
WINDOW=([eld,]message)
Examples
GET(DIRECT) ORDER-D,LIST=(CUSTNUM:QTY),RECNO=REC;
GET(FORM)FORM1,INIT,LIST=(),
WINDOW=(field1,"This field must be numeric");
GO TO
GO TO label;
Example
GO TO PARA1;
Transact Verbs
1-11
IF
IF condition-clause THEN statement [ELSE statement];
CONDITION CLAUSE
test-variable relational-operator value[,value...][{AND|OR} ...]
TEST VARIABLES
(item-name[(subscript)])
arithmetic-expression
EXCLAMATION
FIELD
INPUT
PRINT
REPEAT
SORT
STATUS
-
Status of automatic null response
Status of the FIELD option
Last value input to INPUT
Status of PRINT or TPRINT option
Status of REPEAT option
Status of SORT option
Value of STATUS register
RELATIONAL OPERATORS
=
<>
<
<=
>
>=
When test variable is (item-name [(subscript )]) and relational operator is \=" or \<>", value
can be:
NUMERIC
ALPHABETIC
ALPHABETIC-LOWER
ALPHABETIC-UPPER
Example
IF (QTY)>(ONHAND) THEN DISPLAY "Too many ordered!";
1-12
Transact Verbs
INPUT
3
2
INPUT "prompt-string" ,option-list ;
OPTIONS
BLANKS
NOECHO
STATUS
Example
INPUT "Do you want the report on printer? (Y/N)";
LET
2
2 2
3 33
LET destination-variable = arithmetic-expression ,ERROR=label ( item-name )
DESTINATIONS
(item-name)
LINE
OFFSET(item-name)
PAGE
PLINE
STATUS
TLINE
-
;
Value of the line counter
The offset of a child item
Value of the page counter
Line counter for printer output
Value of the status register
Line counter for terminal output
ARITHMETIC EXPRESSION
[-]source1 [operator source2]
OPERATORS
+
*
/
//
**
Transact Verbs
1-13
FUNCTIONS
ASCII(item-name|value)
LENGTH(item-name|value)
LN(item-name|value)
LOG(item-name|value)
POSITION(item-name|value, item-name|value);
SQRT(item-name|value)
VALUE(item-name|value)
Example
LET (ONHAND)=(ONHAND)-(QTY);
LET (S-LENGTH) = LENGTH(STRING);
LEVEL
LEVEL[(label([item-name]))];
Example
LEVEL(finished-level());
1-14
Transact Verbs
LIST
3
2
2
LIST (modier) item-name1 ,option-list
MODIFIERS
none
AUTO
KEY
MATCH
PATH
UPDATE -
Adds
Adds
Adds
Adds
Adds
Adds
32
2
:item-name2 ,option-list
33
. .. ;
item name to list register
all file items to list register
item-name to key register
item to list and match register
item to list and key register
item to list and update register
OPTIONS
ACCOUNT
ALIGN (All modifiers except KEY)
DATE
DATE/C
DATE/D
DATE/J
DATE/L
DATE/Y
GROUP
HOMEGROUP
INIT[IALIZE]
PASSWORD
PROCTIME
TERMID
TIME
TIMER
SESSION
USER
OPTIONS WITH MATCH
NE
LT
LE
GT
GE
LEADER
SCAN
TRAILER
OPTIONS WITH AUTO
@
- Lists all defined items
le-name - Name of file to list
Transact Verbs
1-15
Example
LIST CUSTNO,INIT: CUSTNAME,INIT: USERNAME,INIT;
LOGTRAN
2
3
LOGTRAN(modier) base, log-message ,option-list ;
MODIFIERS
BEGIN
END
MEMO
XBEGIN
XEND
XUNDO
Writes a DBBEGIN log record
Writes a DBEND log record
Writes a DBMEMO log record
Writes an XBEGIN Transaction Manager log record
and starts a dynamic transaction
- Writes an XEND Transaction Manager log record
and ends a dynamic transaction
- Writes an XUNDO Transaction Manager log record
and undoes a dynamic transaction
OPTIONS
NOMSG
STATUS
OPTION WITH BEGIN, XBEGIN
LOCK(setlist)
Examples
LOGTRAN(BEGIN) CUSTDB,"Begin logging/lock database", LOCK(@);
LOGTRAN(XBEGIN) $HOME, "Begin dynamic txn logging", LOCK(@);
1-16
Transact Verbs
MOVE
MOVE (item-name)=source-expression;
SOURCE EXPRESSION
[-](item-name[(subscript)])
[-]"character-string"
[-]string-function
format-function
source1 {+|-} source2 {+|-} ... sourcen
STATUS(DB)
STATUS(BASE)
STATUS(FILE)
FUNCTIONS
CHAR(item-name|value)
COL(item-name|"character string",position)
LOWER(item-name|"character string")
PROPER(item-name|"character string")
SPACE(item-name|"character string",space-size)
STRING(item-name|"character string",position,length)
UPPER(item-name|"character string")
Example
MOVE (FULLNAME)=(FNAME)+(LNAME);
OUTPUT
2
3
2
3
OUTPUT (modier) source ,option-list ;
MODIFIERS
none
- Retrieves from master set
CHAIN
- Retrieves from detail set or KSAM file
based on key
CURRENT - Retrieves last entry accessed from MPE or KSAM
file or data set
DIRECT - Retrieves entry at specified record number
PRIMARY - Retrieves from master set at the primary location
RCHAIN - Same as CHAIN in reverse order for data set;
same as CHAIN for KSAM file
RSERIAL - Same as SERIAL in reverse order for data set;
same as SERIAL for MPE or KSAM file
SERIAL - Retrieves entries in serial mode
Transact Verbs
1-17
SOURCE
le-name
set-name[(base-name)]
OPTIONS
ERROR=label([(item-name)])
LIST=(range-list)
LOCK
NOCOUNT
NOHEAD
NOMATCH
NOMSG
PERFORM=label
RECNO=item-name[(subscript)]
SINGLE
SOPT
(ASC)
[,item-name . . . ])
SORT=(item-name
(DES)
STATUS
Example
OUTPUT(SERIAL) ORDER-D,LIST=(CUSTNO:QTY),NOMATCH;
1-18
Transact Verbs
PATH
2
3
PATH source ,option-list ;
SOURCE
le-name
set-name[(base-name)]
OPTIONS
ERROR=label([item-name])
LIST=(range-list)
NOMSG
STATUS
Example
PATH ORDER-D,NOMSG;
PERFORM
PERFORM label;
Example
PERFORM PRINT-PARA;
Transact Verbs
1-19
PROC
2
PROC procedure-name (parameter-list)
32
3
,option-list ;
PARAMETER LIST
(item-name[(subscript)])
ARG
ARGLNG
BASE[(base-name)]
BASELNG[(base-name)]
BYTE(item-name)
COUNT(item-name)
DECIMAL(item-name)
FILEID(le-name)
INPUT
INPUTLNG
ITEM(item-name)
ITEMLNG(item-name)
KEY
KEYLNG
POSITION(item-name)
SET(set-name)
SETLNG(set-name)
SIZE(item-name)
STATUS
STATUS(DB)
STATUS(IN)
TYPE(item-name)
VCOM(form-le)
PARAMETER PREFIXES
% - Passes by byte address
# - Passes by value
& - Copies function value of intrinsic to item
OPTIONS
COBOL|FORTRAN|BASIC|Pascal|SPL
NOTRAP
NOLOAD
UNLOAD
Examples
PROC DBCLOSE(BASE(CUST),SET(CUST-M),(MODE),STATUS(DB));
PROC CREATE(%(ROUTINE),,(CPIN),,#(CFLAG),,,,,,#(MAP));
1-20
Transact Verbs
PROMPT
PROMPT[(modier)]item-name[("prompt-string")][,option-list]
[:item-name[("prompt-string")][,option-list]]...;
MODIFIERS
none
KEY
MATCH
PATH
SET
UPDATE -
Places
Places
Places
Places
Places
Places
value
value
value
value
value
value
in
in
in
in
in
in
list and data registers
key and argument registers
list, data, and match registers
list, data, key, and argument registers
list and data registers if entered
list, data, and update registers
OPTIONS
ALIGN (All modifiers except KEY)
BLANKS
CHECK=set-name
CHECKNOT=set-name
NOECHO
RIGHT
STATUS
OPTIONS WITH MATCH
NE
LT
LE
GT
GE
LEADER
SCAN
TRAILER
Example
PROMPT CUSTNO ("Please enter customer number",)CHECK=CUST-M;
Transact Verbs
1-21
PUT
2
3
2
3
PUT (modier) destination ,option-list ;
MODIFIERS
none
FORM
DESTINATIONS
set-name[(base-name)]
le-name
DESTINATIONS WITH FORM MODIFIER
form-name
(item-name[(subscript)])
*
&
- the CURRENT FORM name
- the NEXT FORM name
OPTIONS
LIST=(range-list)
STATUS
OPTIONS WITHOUT THE FORM MODIFIER
ERROR=label([item-name])
LIST=(range-list)
LOCK
NOMSG
RECNO=item-name[(subscript)]
STATUS
OPTIONS WITH ONLY THE FORM MODIFIER
APPEND
CLEAR
CURRENT
CURSOR=eld-namejitem-name[(subscript)]
FEDIT
FKEY=item-name[(subscript)]
Fn=label
FREEZE
INIT
LIST=(range-list)
STATUS
WAIT=[Fn]
WINDOW=([eld,]message)
1-22
Transact Verbs
Example
PUT ORDER-D,LIST=(CUSTNO:QTY);
REPEAT
REPEAT statement UNTIL condition-clause;
CONDITION CLAUSE
test-variable relational-operator value[,value...][{AND|OR}...]
TEST VARIABLES
(item-name[(subscript)])
arithmetic-expression
EXCLAMATION
FIELD
INPUT
PRINT
REPEAT
SORT
STATUS
-
Status of automatic null response
Status of the FIELD option
Last value input to INPUT
Status of PRINT option
Status of REPEAT option
Status of SORT option
Value of status register
RELATIONAL OPERATORS
=
<>
<
<=
>
>=
When test variable is (item-name [(subscript )]) and relational-operator is \=" or \<>", value
can be:
NUMERIC
ALPHABETIC
ALPHABETIC-LOWER
ALPHABETIC-UPPER
Example
REPEAT LET (A)=(A)/10 UNTIL (A)<=1;
Transact Verbs
1-23
REPLACE
2
3
2
3
REPLACE (modier) source ,option-list ;
MODIFIERS
none
- Updates master set entry
CHAIN
- Updates detail or KSAM chain based on key
CURRENT - Updates last entry accessed from file or
data set
DIRECT - Updates entry at specified record number
PRIMARY - Updates master set at primary location
RCHAIN - Same as CHAIN in reverse order for data set;
same as CHAIN for KSAM file
RSERIAL - Same as SERIAL in reverse order for data set;
same as SERIAL for MPE or KSAM file
SERIAL - Updates entries in serial mode
SOURCE
le-name
set-name[(base-name)]
OPTIONS
ERROR=label([item-name])
LIST=(range-list)
LOCK
NOCOUNT
NOMATCH
NOMSG
PERFORM=label
RECNO=item-name[(subscript)]
SINGLE
SOPT
STATUS
UPDATE
Example
REPLACE(SERIAL) ORDER-D,LIST=(CUSTNO:QTY),NOCOUNT;
1-24
Transact Verbs
RESET
3
2
RESET(modier) target ;
MODIFIERS
COMMAND
DELIMITER
LANGUAGE
OPTION
PROPER
STACK
-
Clears
Resets
Resets
Resets
Resets
Resets
user response from buffer
delimiters to default
language
various execution parameters
delimiters for upshifting the next letter
list register pointer
TARGET WITH STACK MODIFIER
LIST
TARGETS WITH OPTION MODIFIER
AUTOLOAD
END
FIELD
FORMSTORE=(form-store-list)
[item-name]
)]
MATCH [LIST(
*
NOHEAD
NOLOCK
NOLOOKAHEAD
PRINT
SORT
SUPPRESS
TPRINT
UPDATE [LIST(
[item-name]
)]
*
VPLS
Example
RESET(OPTION) NOHEAD;
RETURN
2
3
RETURN (level) ;
Examples
RETURN; RETURN(5);
Transact Verbs
1-25
SET
SET(modier) target;
MODIFIERS
COMMAND
DELIMITER
FORM
KEY
LANGUAGE
MATCH
OPTION
PROPER
STACK
UPDATE
-
Invokes command mode
Changes delimiters
Specifies transfer to VPLUS buffer
Sets value of key and argument register
Specifies language
Sets up match register
Sets execution parameters
Sets delimiters for upshifting the next letter
Sets list register pointer
Sets value of update register
TARGETS WITH COMMAND
EXIT
INITIALIZE
COMMAND[(command-label)]"input-string"
TARGET WITH DELIMITER,PROPER
"delimiter-string"
TARGET WITH STACK, UPDATE, MATCH, KEY, LANGUAGE
LIST(item-name1)
OPTIONS WITH MATCH MODIFIER
NE
LT
LE
GT
GE
LEADER
SCAN
TRAILER
TARGETS WITH FORM
form-name[,option list]
(item-name[(subscript)])[,option-list]
* [,option-list] - the CURRENT FORM name
& [,option-list] - the NEXT FORM name
1-26
Transact Verbs
OPTIONS WITH FORM MODIFIER
APPEND
CLEAR
CURSOR=eld-namejitem-name[(subscript)])
FEDIT
FREEZE
INIT
LIST=(range-list)
WINDOW=([eld],message)
TARGETS WITH OPTION MODIFIER
AUTOLOAD
DEPTH=number
END=label
FIELD[="ab"]
FORMSTORE=(form-store-list)
HEAD
LEFT
NOBANNER
NOHEAD
NOLOCK
NOLOOKAHEAD
PALIGN=number
PDEPTH=number
PRINT
PROMPT=number
PWIDTH=number
REPEAT
RIGHT
SORT
SUPPRESS
TABLE
TPRINT
VPLS=item-name[(subscript)]
WIDTH=number
ZERO[E]S
Examples
SET(OPTION) PRINT;
SET(FORM) LIST-FORM,LIST=(LIST-DATE),
WINDOW=(LIST-DATE,"Only enter orders for this date");
Transact Verbs
1-27
SYSTEM
SYSTEM program-name[,denition-list];
DEFINITIONS
BANNER="text"
BASE=base-name1[(["password"][,mode]
[,optlock][,[basetype]]]])]
[,base-name2[(["password"][,mode]
[,optlock][,[basetype]]]])]]...
DATA=data-length,data-count
FILE=le-name1[(access[(le-option-list)]
[,rec-length[,blocking-factor
[,le-size[,extents[,initial-allocation
[,le-code]]]]]])]...
FSTORESIZE=formstoresize
KSAM=le-name1[(access[(le-option-list)])]...
OPTION={TEST|NOTEST}
SIGNON="text"
SORT=number
VPLS=le-name1[(form-name1[(item-list1)] ...)] ...] ...
WORK=work-length,work-count
WORKFILE=number
Example
SYSTEM PROG1, BASE=DB1("PASS",1);
1-28
Transact Verbs
UPDATE
2
3
2
3
UPDATE (FORM) destination ,option-list ;
DESTINATIONS
le-name
set-name[(base-name)]
DESTINATIONS WITH FORM
form-name
(item-name[(subscript)])
* - the CURRENT FORM name
& - the NEXT FORM name
OPTIONS
ERROR=label([item-name])
LIST=(range-list)
LOCK
NOMSG
STATUS
OPTIONS WITH FORM
APPEND
CLEAR
CURSOR=eld-namejitem-name[(subscript)]
FEDIT
FKEY=item-name[(subscript)]
Fn=label
FREEZE
INIT
LIST=(range-list)
STATUS
WAIT=[Fn]
WINDOW=([eld,]message)
Examples
UPDATE ORDER-D,LIST=(DATE);
UPDATE(FORM) *,WINDOW=((FIELD-ENH),(WINDOW-MSG));
Transact Verbs
1-29
WHILE
WHILE condition-clause statement;
CONDITION CLAUSE
test-variable relational-operator value[,value...][{AND|OR}...]
TEST VARIABLES
(item-name[(subscript)])
arithmetic-expression
EXCLAMATION
FIELD
INPUT
PRINT
REPEAT
SORT
STATUS
-
Status of automatic null response
Status of the FIELD option
Last value input to INPUT
Status of PRINT option
Status of REPEAT option
Status of SORT option
Value of STATUS register
RELATIONAL OPERATORS
=
<>
<
<=
>
>=
When test variable is (item-name [(subscript )]) and relational-operator is \=" or \<>", value
can be:
NUMERIC
ALPHABETIC
ALPHABETIC-LOWER
ALPHABETIC-UPPER
Example
WHILE (A)>10 LET (A)=(A)/10;
1-30
Transact Verbs
2
Running Transact
Compiler Output Commands
!COPYRIGHT("text-string")
!INCLUDE(le-name)
!LIST
!NOLIST
!PAGE
!SEGMENT[("text-string")]
System Dictionary Commands
!SYSDIC[(dictionary.group.account)]
!NOSYSDIC
!DOMAIN [(domain)]
!VERSIONSTATUS[(P/T/A)]
!VERSION[(version)]
!SCOPE[(scope[,"password"])]
Conditional Compile Commands
!SET Xn {ON/OFF}
!IF Xn={ON/OFF}
!ELSE
!ENDIF
!IF XL={ON/OFF}
!ELSE
!ENDIF
Running Transact
2-1
Transact/V Program Compilation
:RUN TRANCOMP.PUB.SYS
SOURCE
FILE>
Enter the source file name
LIST FILE> <cr>
LP
NULL
to send listing to $STDLIST
to send listing to TRANLIST
to suppress compiler listing
*le-name to back reference a file equation
le-name to send listing to a disk file
CONTROL>
LIST
DICT
CODE
ERRS
CHCK
DEFN
OBJT
OPT@
OPTE
OPTH
OPTI
OPTP
OPTS
STAT
XERR
XREF
DEFAULTS:
Note
2-2
Generates a listing of the compiled source code
References the DICTIONARY to resolve item definitions
Creates p-code if no errors occur
Lists errors on $STDLIST even if you redirect listing
Produces a list of items that are used but never put on
the list register
Produces a list of item definitions
Produces a listing of the p-code
Optimizes compilation tables and IP file
Eliminates edit mask specs from IP file
Eliminates heading text from IP file
Eliminates item names from IP file
Eliminates prompt strings from IP file
Optimizes segmented Transact programs
Generates statistics on data stack usage
Creates p-code file even if errors are encountered
Provides a cross reference listing of labels and
references
LIST,DICT,CODE,ERRS
You can precede any of the above CONTROL options with \NO" to reverse
its eect. For example, NOXREF.
Running Transact
Formal File Designators for Transact/V Compilation
TRANCODE
TRANIN
TRANLIST
TRANOUT
TRANTEXT
Name of the le opened and used by the compiler. Default size is 1023
records.
Formal le designator for responses to prompts issued by compiler. Default is
$STDINX.
Formal le designator for destination of compiler listings when LP is the
response to the LIST FILE prompt.
Formal le designator for output from the compiler that by default, is sent to
the standard list device.
Formal le designator for the source code le.
Transact/V Program Execution
:RUN TRANSACT.PUB.SYS
SYSTEM NAME> program-name[,mode[,test-parm[,start-location[,end-location]]]]
Formal File Designators for Transact/V Execution
TRANDUMP Formal le designator for the destination of test mode output.
TRANIN
Formal le designator for responses issued by the processor. The default is
$STDINX.
TRANLIST
Formal le designator for output from the processor that is normally sent to
the line printer.
TRANOUT
Formal le designator for output from the processor that is normally sent to
the standard list device.
TRANSORT Name of the sort le opened and used by the processor in sort operations.
Default size is 10,000 records.
TRANVPLS Name of the le used by the processor to open the VPLUS terminal.
Running Transact
2-3
Transact/iX Compilation and Execution
TRANXL [textle] [,[rlle] [,[listle]]] [;INFO="compiler-options"]
RUN TRAN.PUB.SYS [;PARM=parmnum] [;INFO="compiler-options"]
LINKEDIT
LINK [FROM=le[,le]...] [;TO=destle]
[;RL=rlle]
[;XL=xlle]
[;CAP=caplist]
[;STACK=maxstacksize]
[;HEAP=maxheapsize]
[;UNSAT=unsatname]
[;PARMCHECK= integer]
[;PRIVLEV=integer]
[;XLEAST=integer]
[;ENTRY=entryname]
[;NODEBUG]
[;NOSYM]
[;MAP]
[;SHOW]
TRANXLLK [textle,[progle] [,[listle]]] [;INFO="compiler-options"]
TRANXLGO [textle][,[listle]][;INFO="compiler-options"]
RUN progname [;XL="xlname[,xlname,...]"]
Transact/iX Compiler Options
CHCK
CODE_OFFSETS
DEFN
DYNAMIC_CALLS
ERRS
HP3000_16
LIST
OPTE
OPTH
OPTI
OPTIMIZE
OPTP
OPTS
OPT@
2-4
Running Transact
PROCALIGNED_16
PROCALIGNED_32
PROCALIGNED_64
PROCINTRINSIC
SUBPROGRAM
TRANDEBUG
XREF
DEFAULTS:
NODYNAMIC_CALLS
NOHP3000_16
NOPROCALIGNED
NOPROCINTRINSIC
NOOPTIMIZE
Note
You can precede any of the above options with \NO" to reverse its eect. For
example, NOXREF.
Formal File Designators for Transact/iX Compilation
TRANLIST
TRANOBJ
TRANTEXT
Formal le designator for output from the compiler that, by default, is sent to
the standard list device. The default is $STDLIST.
Formal le designator of the RSOM le. The default is $NEWPASS.
Formal le designator for the source code le. The default is $STDIN.
Formal File Designators for Transact/iX Execution
TDBGINIT
Formal le designator that is checked for during start up of TRANDEBUG. If
it is present, it is treated as a user le.
TDBUGIN
Formal le designator where TRANDEBUG reads user input information. It
is typically assigned to the $STDINX.
TDBUGOUT Formal le designator where TRANDEBUG responds to user's requests. It is
typically assigned to the $STDLST.
TRANIN
Formal le designator for responses issued by the processor. The default is
$STDINX.
TRANLIST
Formal le designator for output from the processor that is normally sent to
the line printer.
TRANOUT
Formal le designator for output from the processor that is normally sent to
the standard list device.
TRANSORT Name of the sort le opened and used by the processor in sort operations.
Default size is 10,000 records.
Running Transact
2-5
TRANVPLS
Name of the le used by the processor to open the VPLUS terminal.
Architected Call Interface (ACI)
TL_CALL_TRANSACT (program name, data buer, data length, return status)
program name
data buer
data length
return status
2-6
Name of Transact/iX subprogram to call. Must be terminated with a blank.
User dened structure for passing data to and from subprogram.
Maximum data register size (in bytes) in subprogram.
Status value indicating success or failure of the intrinsic call.
Running Transact
3
Test Facility (Transact/V)
Enabling Test Modes
RUN TRANSACT.PUB.SYS
SYSTEM NAME> PROG1,,test-parameter[,[segment1.]starting-instru ction-address]
[,[segment2.]ending-instruction-address]
or
4Ctrl5Y
>TEST [test-parameter [,[segment1.]starting-instruction-address
[,[segment2.]ending-instruction-address]]
Example
TEST 44,0,333
Test Parameters
PARM
FUNCTION
|||
none
1
2
3
||||||
Switches o existing test mode.
Displays information about the le or database operation if error occurs.
Displays each instruction address and compiler code at that address.
Displays each instruction address, compiler code, space used by list and data
registers, and amount of remaining processor work space.
Displays each instruction address, compiler code, instruction timings, and
HP3000 data stack pointers Z, S, Q, and DL.
Displays each instruction address, compiler code, and key and argument
register values used by the database or le operation.
Displays each instruction address, compiler code, and contents of list, data,
key, argument, match and update registers if used by the database or le
operation.
Same as 23 except it is only issued when an accessed record meets the
selection criteria in the match register.
Same as 24 except display is issued for every record accessed by the database
or le operation.
4
22
23
24
25
Test Facility (Transact/V)
3-1
34
42
43
44
101
102
121
122
123
3-2
Displays the instruction address, compiler code, and contents of the VPLUS
buer following an instruction generated by a statement that references a
VPLUS form.
Displays the instruction address and compiler code only if the instruction
is not listed in the compiler listing. Displays contents of the list and data
registers whenever the contents of list register changes.
Displays the instruction address, compiler code, and the contents of the list
and data registers for every instruction.
Displays the instruction address, compiler code, and the contents of all
registers for every instruction.
Lists the data and workspace recovery statistics for every command sequence.
Lists the data and workspace recovery statistics for the entire program.
Issues an overlay trace whenever a program switches segments.
Issues a trace whenever a le is locked or unlocked.
Issues a workspace recovery message whenever recovery is needed.
Test Facility (Transact/V)
4
TRANDEBUG Commands (Transact/iX)
:
Allows access to the MPE/iX Command Interpreter.
:
2
COMMAND
3
ABORT
Terminates execution of the Transact/iX program and exits TRANDEBUG.
ABORT
AUTORPT
Allows you to repeat the last command typed by pressing the 4Return5 key.
AUTORPT
AR
ON
OFF
BREAK DELETE
Deletes a specied breakpoint.
3
2
#breakpoint number
33
2
2
BREAK DELETE 4
p-code oset ,segment ,system 5
BD
ALL
BREAK LIST
Lists the breakpoints that have been set in the Transact/iX program.
BREAK LIST
BL
TRANDEBUG Commands (Transact/iX)
4-1
BREAK SET
Sets a breakpoint at the specied location.
BREAK SET
BS
32
2
oset ,segment ,system
system
3
2
,count
32
,{cmdlist}
3
CONTINUE
Continues execution of the Transact/iX program until a breakpoint is encountered or the
program completes execution.
CONTINUE
C
DATA BREAK DELETE
Deletes a specied data breakpoint.
DATA BREAK
DBD
3
2
#breakpoint number
37
2
DELETE 6
item name
7
6
,
system
5
4 register name
ALL
DATA BREAK LIST
Lists the data breakpoints currently set in the Transact/iX program.
DATA BREAK LIST
DBL
DATA BREAK REGISTER
Sets a breakpoint at the specied register.
4-2
32 8
933
2 2
DATA BREAK REGISTER
register , count , cmdlist
DBR
TRANDEBUG Commands (Transact/iX)
DATA BREAK SET
Sets a breakpoint at the specied location.
2
2
2 8
9333
DATA BREAK SET
, cmdlist
,length ,count
2 8
93
item name
,rel-op ,value , cmdlist
DBS
DATA LOG
Allows logging of TRANDEBUG commands and output to a le.
DATA
DL
2
3
filename
7
LOG 6
ON
6
7
4 OFF
5
CLOSE
DEFN
Displays information about the denition of a particular item.
DEFN item name
DISPLAY BASE
Displays information for specic databases.
DISPLAY BASE
DB
2
base name
3
DISPLAY CALLS
Displays the CALL stack from the currently executing system back to the main program.
DISPLAY CALLS
DCA
TRANDEBUG Commands (Transact/iX)
4-3
DISPLAY COMAREA
Displays the contents of the currently active VPLUS communication area (comarea).
DISPLAY COMAREA
DCO
DISPLAY FILE
Displays information for specic MPE/KSAM les.
DISPLAY FILE
DF
2
file_name
3
DISPLAY INPUT
Displays the contents of the input register.
DISPLAY INPUT
DIN
DISPLAY ITEM
Displays the value of an item or all items in the data register.
DISPLAY ITEM
DIT
2
item name list =
item name list
3
3
2
3
2
8
(
subscript
)
(
subscript
)
:
item2
item1
>
2
32
2
>
<
item1 (subscript) , . . . itemN (subscript)
3
2
item1 2(subscript) 3:
>
>
:
:item1 (subscript)
9
33>
>
=
>
>
;
Note that child items cannot be specied for range boundaries.
DISPLAY KEY
Displays the item in the key register and the corresponding value in the argument register.
4-4
DISPLAY KEY
DK
TRANDEBUG Commands (Transact/iX)
DISPLAY MATCH
Displays the contents of the match register.
DISPLAY MATCH
DM
DISPLAY PERFORMS
Displays the current PERFORM stack.
DISPLAY PERFORMS
DP
2
ALL
3
DISPLAY STATUS
Displays the value in the status register.
DISPLAY STATUS
DS
DISPLAY STATUSDB
Displays the contents of the database status array returned by the last TurboIMAGE/XL call.
DISPLAY STATUSDB
DSDB
DISPLAY STATUSIN
Displays the value in the statusin register.
DISPLAY STATUSIN
DSIN
DISPLAY UPDATE
Displays the specied item in the update register.
DISPLAY UPDATE
DU
TRANDEBUG Commands (Transact/iX)
4-5
EDIT
Invokes HP EDIT from within TRANDEBUG, allowing you to edit or browse source les.
2
EDIT filename
3
HELP
Provides online assistance for TRANDEBUG.
2
33
2
ALL
4 PARMS
57
HELP 6
6 command
7
4
EXAMPLES 5
?
HELPINSTRUCTIONS
LABEL BREAK SET
Sets a breakpoint at the specied label.
2 8
9333
2
2
LABEL BREAK SET
label ,segment ,count , cmdlist
LBS
LABEL JUMP
Moves the source code window to a specic label in the code.
3
2
LABEL JUMP
label ,segment
LJ
LOC
Indicates the p-code oset, segment, and system of the Transact/iX statement that executes
next.
LOC
4-6
TRANDEBUG Commands (Transact/iX)
LOG
Allows logging of TRANDEBUG commands to an MPE/iX le.
2
LOG
lename
6 ON
6
4 OFF
3
7
7
5
CLOSE
MODIFY INPUT
Modies the contents of the input register.
MODIFY INPUT
MIN
2
new value
3
MODIFY ITEM
Modies the value of a data item in the data register.
32
3
2
MODIFY ITEM
item name (subscript) new value
MIT
MODIFY KEY
Modies the item in the key register.
MODIFY KEY
MK
2
new item
3
MODIFY MATCH
Modies the specied item in the match register.
2
3
MODIFY MATCH
item name new value
MM
TRANDEBUG Commands (Transact/iX)
4-7
MODIFY STATUS
Modies the value in the status register.
MODIFY STATUS
MS
2
new value
3
MODIFY UPDATE
Modies the specied item in the update register.
32
3
2
MODIFY UPDATE
item name (subscript) new value
MU
NMDEBUG
Transfers control from TRANDEBUG to NMDEBUG.
NMDEBUG
NM
PAGE BACK
Pages back the source code window in the source le.
PAGE BACK
PB
PAGE FORWARD
Pages the source code window forward in the source le.
PAGE FORWARD
PF
PAGE JUMP
Moves the source code window to a specied segment and oset in the program.
4-8
2
3
PAGE JUMP
oset ,segment
PJ
TRANDEBUG Commands (Transact/iX)
PRINT
Alters or displays the Transact/iX PRINT option.
ON
PRINT
OFF
REPEAT
Alters or displays the Transact/iX REPEAT option.
ON
REPEAT
OFF
SORT
Alters or displays the Transact/iX SORT option.
ON
SORT
OFF
STEP
Continues execution of the Transact/iX program for the specied number of statements.
STEP
S
2
number of steps
3
TPRINT
Alters or displays the Transact/iX TPRINT ag to format the output generated from the
DISPLAY or OUTPUT verbs for printing.
TPRINT
ON
OFF
TRANDEBUG Commands (Transact/iX)
4-9
TRACE
Turns the trace ag on or o for the specied type of trace.
TRACE
TR
8
9
< CODE =
:
IMAGE
;
MPE
ON
OFF
USE
Reads TRANDEBUG commands from the specied MPE/iX le.
USE lename
VERSION
Outputs the current version of the Transact/iX run time library.
VERSION
WINDOW LENGTH
Adjusts the size of the source code window.
WINDOW LENGTH
new size
WL
WINDOW OFF
Turns the source code window o.
WINDOW OFF
WOFF
WINDOW ON
Turns on the source code window.
4-10
WINDOW ON
WON
TRANDEBUG Commands (Transact/iX)
TRANDEBUG Files
DATA LOG
LOG
USE
The DATA LOG le is established and controlled via the DATA LOG
command. The le records the user input from TDBUGIN as well as the
output to TDBUGOUT. The actual le name for this le can be found in
data log le name .
The LOG le is established and controlled via the LOG command. The le
records the user input from TDBUGIN so that it can be used later as a use
le. The actual le name for this le can be found in logle name .
The USE le can be assigned via a USE command. TRANDEBUG then uses
this le as the input instead of TDBUBIN until an end of le is found. The
le id for this le can be found in use le number .
TRANDEBUG Commands (Transact/iX)
4-11
">