VAXTPU — VMS 5.0
Additional information available:
ABORTADD_KEY_MAPADJUST_WINDOWANCHORANY
ANYLAPPEND_LINEARBASCIIATTACHBEGINNING_OF
BOOLEAN_EXPRESSIONSCALL_USERCHANGE_CASE
COMPILECOPY_TEXTCREATE_ARRAYCREATE_BUFFER
CREATE_KEY_MAPCREATE_KEY_MAP_LISTCREATE_PROCESS
CREATE_RANGECREATE_WINDOWCURRENT_BUFFERCURRENT_CHARACTER
CURRENT_COLUMNCURRENT_DIRECTIONCURRENT_LINECURRENT_OFFSET
CURRENT_ROWCURRENT_WINDOWCURSOR_HORIZONTALCURSOR_VERTICAL
DEBUGGERDEBUG_LINEDEFINE_KEYDELETEEDIT
END_OFERASEERASE_CHARACTERERASE_LINEERROR
ERROR_HANDLERSERROR_LINEERROR_TEXTEXECUTE
EXITEXPAND_NAMEFAOFILE_PARSEFILE_SEARCH
FILLGET_INFOGET_INFO(ANY_KEYNAME)GET_INFO(ANY_KEYWORD)
GET_INFO(ANY_VARIABLE)GET_INFO(ARRAY)GET_INFO(ARRAY_VARIABLE)
GET_INFO(BUFFER)GET_INFO(BUFFER_VARIABLE)GET_INFO(COMMAND_LINE)
GET_INFO(DEBUG)GET_INFO(DEFINED_KEY)GET_INFO(KEY_MAP)
GET_INFO(KEY_MAP_LIST)GET_INFO(MARKER_VARIABLE)GET_INFO(PROCEDURES)
GET_INFO(PROCESS)GET_INFO(PROCESS_VARIABLE)GET_INFO(RANGE_VARIABLE)
GET_INFO(SCREEN)GET_INFO(STRING_VARIABLE)GET_INFO(SYSTEM)
GET_INFO(WINDOW)GET_INFO(WINDOW_VARIABLE)HELP_TEXT
INDEXINTJOURNAL_CLOSEJOURNAL_OPENKEYMAPS_AND_KEYMAP_LISTS
KEY_NAMELAST_KEYLEARN_ABORTLEARN_BEGIN
LEARN_ENDLENGTHLINE_BEGINLINE_ENDLOCATE_MOUSE
LOOKUP_KEYMAPMARKMATCHMATCHLMESSAGE
MESSAGE_TEXTMOVE_HORIZONTALMOVE_TEXTMOVE_VERTICAL
NOTANYNOTANYLPOSITIONQUITREAD_CHARREAD_FILE
READ_KEYREAD_LINEREFRESHREMAINREMOVE_KEY_MAP
RETURNSAVESCANSCANLSCROLLSEARCHSEARCH_QUIETLY
SELECTSELECT_RANGESENDSEND_EOFSETSET(AUTO_REPEAT)
SET(BELL)SET(COLUMN_MOVE_VERTICAL)SET(CROSS_WINDOW_BOUNDS)
SET(DEBUG)SET(EOB_TEXT)SET(FACILITY_NAME)SET(FORWARD)
SET(INFORMATIONAL)SET(INSERT)SET(JOURNALING)SET(KEY_MAP_LIST)
SET(LEFT_MARGIN)SET(LEFT_MARGIN_ACTION)SET(LINE_NUMBER)
SET(MARGINS)SET(MAX_LINES)SET(MESSAGE_ACTION_LEVEL)
SET(MESSAGE_ACTION_TYPE)SET(MESSAGE_FLAGS)SET(MODIFIABLE)
SET(MOUSE)SET(NO_WRITE)SET(OUTPUT_FILE)SET(OVERSTRIKE)
SET(PAD)SET(PAD_OVERSTRUCK_TABS)SET(PERMANENT)SET(POST_KEY_PROCEDURE)
SET(PRE_KEY_PROCEDURE)SET(PROMPT_AREA)SET(REVERSE)
SET(RIGHT_MARGIN)SET(RIGHT_MARGIN_ACTION)SET(SCREEN_UPDATE)
SET(SCROLLING)SET(SELF_INSERT)SET(SHIFT_KEY)SET(SPECIAL_ERROR_SYMBOL)
SET(STATUS_LINE)SET(SUCCESS)SET(SYSTEM)SET(TAB_STOPS)
SET(TEXT)SET(TIMER)SET(TRACEBACK)SET(UNDEFINED_KEY)
SET(VIDEO)SET(WIDTH)SHIFTSHOWSLEEP
SPANSPANLSPAWNSPLIT_LINESTRSUBSTR
TPUTRANSLATEUNANCHORUNDEFINE_KEY
UNMAPUPDATEWRITE_FILE
CommandsKeynames TableNondefinable KeysRecovery
Commands
List of Topics
For help on VAXTPU topics, type the name of a topic and press RETURN.
~I~
o To exit from help and resume editing, press RETURN.
Text-Manipulation Statements
APPEND_LINE ERASE READ_FILE
BEGINNING_OF ERASE_CHARACTER SEARCH
CHANGE_CASE ERASE_LINE SELECT_RANGE
COPY_TEXT FILE_PARSE SPLIT_LINE
CREATE_BUFFER FILE_SEARCH TRANSLATE
CREATE_RANGE FILL WRITE_FILE
EDIT MOVE_TEXT
END_OF
Cursor-Movement and Editing-Position Statements
CURSOR_HORIZONTAL MARK POSITION
CURSOR_VERTICAL MOVE_HORIZONTAL SCROLL
LOCATE_MOUSE MOVE_VERTICAL
Key-Definition Statements
ADD_KEY_MAP DEFINE_KEY LOOKUP_KEY
CREATE_KEY_MAP KEY_NAME REMOVE_KEY_MAP
CREATE_KEY_MAP_LIST LAST_KEY UNDEFINE_KEY
Program-Execution Statements Multiple-Process Statements
COMPILE ATTACH SEND_EOF
EXECUTE CREATE_PROCESS SPAWN
SAVE SEND
Pattern-Match Statements Screen- and Window-Layout Statements
ANCHOR SCANL ADJUST_WINDOW REFRESH
ANY SEARCH CREATE_WINDOW SHIFT
ARB SEARCH_QUIETLY LOCATE_MOUSE UNMAP
MATCH SPAN MAP UPDATE
NOTANY SPANL
SCAN UNANCHOR
Status-Information Statements
CURRENT_BUFFER GET_INFO(ANY_VARIABLE) GET_INFO(PROCEDURES)
CURRENT_CHARACTER GET_INFO(ARRAY) GET_INFO(PROCESS)
CURRENT_COLUMN GET_INFO(ARRAY_VARIABLE) GET_INFO(PROCESS_VARIABLE)
CURRENT_DIRECTION GET_INFO(BUFFER) GET_INFO(RANGE_VARIABLE)
CURRENT_LINE GET_INFO(BUFFER_VARIABLE) GET_INFO(SCREEN)
CURRENT_OFFSET GET_INFO(COMMAND_LINE) GET_INFO(STRING_VARIABLE)
CURRENT_ROW GET_INFO(DEBUG) GET_INFO(SYSTEM)
CURRENT_WINDOW GET_INFO(DEFINED_KEY) GET_INFO(WINDOW)
GET_INFO GET_INFO(KEY_MAP) GET_INFO(WINDOW_VARIABLE)
GET_INFO(ANY_KEYNAME) GET_INFO(KEY_MAP_LIST) SHOW
GET_INFO(ANY_KEYWORD) GET_INFO(MARKER_VARIABLE)
SET Statements
SET SET(MAX_LINES) SET(RIGHT_MARGIN_ACTION)
SET(AUTO_REPEAT) SET(MESSAGE_FLAGS) SET(SCREEN_UPDATE)
SET(BELL) SET(MESSAGE_ACTION_LEVEL) SET(SCROLLING)
SET(COLUMN_MOVE_VERTICAL) SET(MESSAGE_ACTION_TYPE) SET(SELF_INSERT)
SET(CROSS_WINDOW_BOUNDS) SET(MOUSE) SET(SHIFT_KEY)
SET(DEBUG) SET(MODIFIABLE) SET(SPECIAL_ERROR_SYMBOL)
SET(EOB_TEXT) SET(NO_WRITE) SET(STATUS_LINE)
SET(FACILITY_NAME) SET(OUTPUT_FILE) SET(SUCCESS)
SET(FORWARD) SET(OVERSTRIKE) SET(SYSTEM)
SET(INFORMATIONAL) SET(PAD) SET(TAB_STOPS)
SET(INSERT) SET(PAD_OVERSTRUCK_TABS) SET(TEXT)
SET(JOURNALING) SET(PERMANENT) SET(TIMER)
SET(KEY_MAP_LIST) SET(POST_KEY_PROCEDURE) SET(TRACEBACK)
SET(LEFT_MARGIN) SET(PRE_KEY_PROCEDURE) SET(UNDEFINED_KEY)
SET(LEFT_MARGIN_ACTION) SET(PROMPT_AREA) SET(VIDEO)
SET(LINE_NUMBER) SET(REVERSE) SET(WIDTH)
SET(MARGINS) SET(RIGHT_MARGIN)
Miscellaneous Statements
ABORT ERROR_TEXT JOURNAL_OPEN READ_CHAR
ASCII EXPAND_NAME LEARN_ABORT READ_KEY
CALL_USER EXIT LEARN_BEGIN READ_LINE
CREATE_ARRAY FAO LEARN_END SLEEP
DEBUG_LINE HELP_TEXT LENGTH STR
DELETE INDEX MESSAGE SUBSTR
ERROR INT MESSAGE_TEXT
ERROR_LINE JOURNAL_CLOSE QUIT
Informational Topics
Boolean Expressions Keynames Table
Debugger Nondefinable Keys
Error Handlers Recovery
Keymaps and Keymap Lists
Keynames Table
Keynames Table
The following tables show VAXTPU keynames for the corresponding keys on
the LK201 and VT100-series keyboards:
VAXTPU Keynames for the Editing and Auxiliary Keypad
====================================================
Keyboard marking
Keyname LK201 VT100-series
--------------------------------------------
PF1 PF1 PF1
PF2 PF2 PF2
PF3 PF3 PF3
PF4 PF4 PF4
KP0,...,KP9 0,...,9 0,...,9
PERIOD . .
COMMA , ,
MINUS - -
ENTER Enter ENTER
UP Up arrow Up arrow
DOWN Down arrow Down arrow
LEFT Left arrow Left arrow
RIGHT Right arrow Right arrow
E1 Find
E2 Insert Here
E3 Remove
E4 Select
E5 Prev Screen
E6 Next Screen
HELP Help
DO Do
F6,...,F20 F6,...,F20
Note: Keys F1 through F5 are reserved by the operating system and
cannot be defined. See help on NONDEFINABLE KEYS.
VAXTPU Keynames for Keys on the Main Keyboard
=============================================
Keyboard marking
Keyname LK201 VT100-series
-----------------------------------------
TAB_KEY Tab TAB
RET_KEY Return RETURN
DEL_KEY <X] DELETE
LF_KEY LINE FEED
BS_KEY BACK SPACE
FS_KEY ----+
GS_KEY |
RS_KEY +--> See the programmer reference manual for
NUL_KEY | your terminal (VT220, Vt240, and so on).
US_KEY ----+
CTRL_A_KEY CTRL/A CTRL/A
: : :
: : :
CTRL_Z_KEY CTRL/Z CTRL/Z
Note: CTRL/A means you press and hold the CTRL key while you type the
letter A (upper- or lower-case).
VAXTPU Keynames for Mouse Keys
==============================
Each key on the mouse (or other pointing ___________________
device) is effectively two keys, which | _ _ _ |
are defined separately -- the down-stroke | | | | | | | |
(or press) and the up-stroke (or release) | | | | | | | |
-- as shown in the figure at the right: | | | | | | | |
| | | | | | | |
| |_| |_| |_| |
+-------------------+
M1DOWN M2DOWN M3DOWN
M1UP M2UP M3UP
Related topics:
DEFINE_KEY KEY_NAME NONDEFINABLE KEYS SHIFT_KEY
Nondefinable Keys
Nondefinable Keys
You can define all keys on the LK201 and VT100-series keyboards -- except
the following:
BREAK COMPOSE CHARACTER CTRL (by itself) LOCK or CAPS LOCK
NO SCROLL SET-UP SHIFT
While VAXTPU does not prevent you from defining keys F1 through F5 or the
ESCAPE key, the code bound to these keys cannot be executed.
The PF1 key is the default VAXTPU shift key. You cannot define PF1 unless
you specify a different shift key by using SET(SHIFT_KEY...).
The following keys can be defined -- although doing so is not recommended
-- only under some special terminal settings, as follows:
CTRL/C, CTRL/O, To execute a procedure or program bound to
CTRL/X, and F6 one of these keys, you must have entered
the DCL command SET TERMINAL/PASSTHRU.
CTRL/T and CTRL/Y To execute a procedure or program bound to
either of these keys, you must have entered
the DCL command SET TERMINAL/PASSTHRU or
SET TERMINAL/NOCONTROL (or both).
CTRL/Q and CTRL/S To execute a procedure or program bound to
either of these keys, you must have entered
the DCL command SET TERMINAL/NOTTSYNC.
Defining CTRL/M or RETURN affects the other as well. Similarly, defining
CTRL/I or TAB affects the other as well.
The EVE editor has the same restrictions as VAXTPU, except EVE does not
let you redefine RETURN, does not let you define typing keys (unless with
GOLD or CTRL), and lets you redefine the DO key only if you have defined
another key as DO. Also, EVE does not have a default shift key (or GOLD
key), so PF1 can be defined. (For more information, see EVE help on SET
GOLD KEY.)
Related topics
DEFINE_KEY KEY_NAME KEYNAMES TABLE SHIFT_KEY
Recovery
Recovery
If a system failure interrupts your editing session, you can usually
recover your work. VAXTPU makes this recovery possible by recording
the keystrokes of your editing session in a journal file.
o By default, VAXTPU creates a journal file for each editing session.
The journal file is created in your current (default) directory,
with the same name as the input file and the file type .TJL.
o If you invoked VAXTPU without specifying an input file, the journal
file is called TPU.TJL.
o To give the journal file a different name or directory, when you
invoke the editor, use the qualifier /JOURNAL= and specify the
journal file you want.
o If you do not want a journal file created, use /NOJOURNAL.
o To turn on journaling during an editing session (either because
journaling was never started or was started and then turned off),
use the JOURNAL_OPEN built-in. To stop journaling during an editing
session, use the JOURNAL_CLOSE built-in.
o Normally, the journal file is deleted automatically when you exit or
quit. However, if the system fails during your editing session, the
journal file is saved.
To recover your edits after a system failure, reissue the DCL command
you used for that editing session (including all qualifiers) -- and
adding the qualifier /RECOVER. For example, if the system failed when
you were editing a file called JABBER.TXT, you type the following DCL
command:
$ EDIT/TPU jabber.txt/RECOVER
Note that terminal characteristics must be the same as they were when
you started the editing session. Also, all input files must be in the
same state as during the session. Otherwise, the recovery may not
work.
When you invoke VAXTPU with the /RECOVER qualifier, VAXTPU runs the
journal file and recovers the edits you made up to the point where the
system failed. (The last few keystrokes or operations may be lost.)
You can then resume the editing session. Any new edits are journaled.
If you need to recover an editing session in which you read and saved
one or more files before the session terminated, you may find it
helpful, before using the /RECOVER qualifier, to rename the files you
saved after the editing session began. By renaming the files, you can
ensure that the recover operation uses the versions of files that were
used during the original editing session.
The recovery may not work (or may not be accurate) if the original
editing session included any of the following operations because they
do not necessarily behave the same the second time they are performed:
o A CTRL/C sequence
o A CTRL/T sequence
o Cut and paste operation from a file accessed in a subprocess
o Cut and paste operation from a mail message
o An operation using the contents of the message buffer
o An operation involving the CALL_USER built-in
o An operation using the date or time from the FAO built-in
It may be possible to edit a journal file, but DIGITAL does not
recommend this because you may alter or delete information necessary
for the recovery to work.
For more information, see DCL HELP on EDIT/TPU/JOURNAL and /RECOVER.
Related topics
JOURNAL_CLOSE JOURNAL_OPEN SET(JOURNALING)