VAXTPU — VMS 5.2
Additional information available:
ABORTADD_KEY_MAPADJUST_WINDOWANCHORANY
ANYLAPPEND_LINEARBASCIIATTACHBEGINNING_OF
BOOLEAN_EXPRESSIONSCALL_USERCHANGE_CASE
COMPILECONVERTCOPY_TEXTCREATE_ARRAYCREATE_BUFFER
CREATE_KEY_MAPCREATE_KEY_MAP_LISTCREATE_PROCESS
CREATE_RANGECREATE_WIDGETCREATE_WINDOWCURRENT_BUFFER
CURRENT_CHARACTERCURRENT_COLUMNCURRENT_DIRECTION
CURRENT_LINECURRENT_OFFSETCURRENT_ROWCURRENT_WINDOW
CURSOR_HORIZONTALCURSOR_VERTICALDEBUGGERDEBUG_LINE
DEFINE_KEYDEFINE_WIDGET_CLASSDELETEEDIT
END_OFERASEERASE_CHARACTERERASE_LINEERROR
ERROR_HANDLERSERROR_LINEERROR_TEXTEXECUTE
EXITEXPAND_NAMEFAOFILE_PARSEFILE_SEARCH
FILLGET_CLIPBOARDGET_GLOBAL_SELECTGET_INFO
GET_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(INTEGER_VARIABLE)GET_INFO(KEY_MAP)
GET_INFO(KEY_MAP_LIST)GET_INFO(MARKER_VARIABLE)GET_INFO(MOUSE_BUTTON)
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(WIDGET)GET_INFO(WIDGET_VARIABLE)
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_KEYMANAGE_WIDGETMAPMARKMATCH
MATCHLMESSAGEMESSAGE_TEXTMODIFY_RANGEMOVE_HORIZONTAL
MOVE_TEXTMOVE_VERTICALNOTANYNOTANYLPOSITION
QUITREAD_CHARREAD_CLIPBOARDREAD_FILE
READ_GLOBAL_SELECTREAD_KEYREAD_LINEREFRESH
REMAINREMOVE_KEY_MAPRETURNSAVESCANSCANL
SCROLLSEARCHSEARCH_QUIETLYSELECTSELECT_RANGE
SENDSEND_EOFSETSET(ACTIVE_AREA)SET(AUTO_REPEAT)
SET(BELL)SET(COLUMN_MOVE_VERTICAL)SET(CROSS_WINDOW_BOUNDS)
SET(DEBUG)SET(DRM_HIERARCHY)SET(ENABLE_RESIZE)
SET(EOB_TEXT)SET(FACILITY_NAME)SET(FORWARD)SET(GLOBAL_SELECT)
SET(GLOBAL_SELECT_GRAB)SET(GLOBAL_SELECT_READ)SET(GLOBAL_SELECT_TIME)
SET(GLOBAL_SELECT_UNGRAB)SET(ICON_NAME)SET(INFORMATIONAL)
SET(INPUT_FOCUS)SET(INPUT_FOCUS_GRAB)SET(INPUT_FOCUS_UNGRAB)
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(MODIFIED)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(RESIZE_ACTION)
SET(REVERSE)SET(RIGHT_MARGIN)SET(RIGHT_MARGIN_ACTION)
SET(SCREEN_LIMITS)SET(SCREEN_UPDATE)SET(SCROLLING)SET(SCROLL_BAR)
SET(SCROLL_BAR_AUTO_THUMB)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(WIDGET)
SET(WIDGET_CALLBACK)SET(WIDTH)SHIFTSHOW
SLEEPSPANSPANLSPAWNSPLIT_LINESTR
SUBSTRTPUTRANSLATEUNANCHORUNDEFINE_KEY
UNMANAGE_WIDGETUNMAPUPDATEWRITE_CLIPBOARDWRITE_FILE
WRITE_GLOBAL_SELECT
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 MOVE_TEXT
BEGINNING_OF ERASE_CHARACTER READ_FILE
CHANGE_CASE ERASE_LINE SEARCH
COPY_TEXT FILE_PARSE SELECT_RANGE
CREATE_BUFFER FILE_SEARCH SPLIT_LINE
CREATE_RANGE FILL TRANSLATE
EDIT MODIFY_RANGE WRITE_FILE
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(ARRAY) GET_INFO(PROCEDURES)
CURRENT_CHARACTER GET_INFO(ARRAY_VARIABLE) GET_INFO(PROCESS)
CURRENT_COLUMN GET_INFO(BUFFER) GET_INFO(PROCESS_VARIABLE)
CURRENT_DIRECTION GET_INFO(BUFFER_VARIABLE) GET_INFO(RANGE_VARIABLE)
CURRENT_LINE GET_INFO(COMMAND_LINE) GET_INFO(SCREEN)
CURRENT_OFFSET GET_INFO(DEBUG) GET_INFO(STRING_VARIABLE)
CURRENT_ROW GET_INFO(DEFINED_KEY) GET_INFO(SYSTEM)
CURRENT_WINDOW GET_INFO(INTEGER_VARIABLE) GET_INFO(WIDGET)
GET_INFO GET_INFO(KEY_MAP) GET_INFO(WIDGET_VARIABLE)
GET_INFO(ANY_KEYNAME) GET_INFO(KEY_MAP_LIST) GET_INFO(WINDOW)
GET_INFO(ANY_KEYWORD) GET_INFO(MARKER_VARIABLE) GET_INFO(WINDOW_VARIABLE)
GET_INFO(ANY_VARIABLE) GET_INFO(MOUSE_BUTTON) SHOW
SET Statements
SET SET(JOURNALING) SET(REVERSE)
SET(ACTIVE_AREA) SET(KEY_MAP_LIST) SET(RIGHT_MARGIN)
SET(AUTO_REPEAT) SET(LEFT_MARGIN) SET(RIGHT_MARGIN_ACTION)
SET(BELL) SET(LEFT_MARGIN_ACTION) SET(SCREEN_LIMITS)
SET(COLUMN_MOVE_VERTICAL) SET(LINE_NUMBER) SET(SCREEN_UPDATE)
SET(CROSS_WINDOW_BOUNDS) SET(MARGINS) SET(SCROLL_BAR)
SET(DEBUG) SET(MAX_LINES) SET(SCROL_BAR_AUTO_THUMB)
SET(DRM_HIERARCHY) SET(MESSAGE_FLAGS) SET(SCROLLING)
SET(ENABLE_RESIZE) SET(MESSAGE_ACTION_LEVEL) SET(SELF_INSERT)
SET(EOB_TEXT) SET(MESSAGE_ACTION_TYPE) SET(SHIFT_KEY)
SET(FACILITY_NAME) SET(MOUSE) SET(SPECIAL_ERROR_SYMBOL)
SET(FORWARD) SET(MODIFIABLE) SET(STATUS_LINE)
SET(GLOBAL_SELECT) SET(MODIFIED) SET(SUCCESS)
SET(GLOBAL_SELECT_GRAB) SET(NO_WRITE) SET(SYSTEM)
SET(GLOBAL_SELECT_READ) SET(OUTPUT_FILE) SET(TAB_STOPS)
SET(GLOBAL_SELECT_TIME) SET(OVERSTRIKE) SET(TEXT)
SET(GLOBAL_SELECT_UNGRAB) SET(PAD) SET(TIMER)
SET(ICON_NAME) SET(PAD_OVERSTRUCK_TABS) SET(TRACEBACK)
SET(INFORMATIONAL) SET(PERMANENT) SET(UNDEFINED_KEY)
SET(INPUT_FOCUS) SET(POST_KEY_PROCEDURE) SET(VIDEO)
SET(INPUT_FOCUS_GRAB) SET(PRE_KEY_PROCEDURE) SET(WIDGET)
SET(INPUT_FOCUS_UNGRAB) SET(PROMPT_AREA) SET(WIDGET_CALLBACK)
SET(INSERT) SET(RESIZE_ACTION) SET(WIDTH)
DECwindows-Related Statements
CREATE_WIDGET GET_GLOBAL_SELECT UNMANAGE_WIDGET
DEFINE_WIDGET_CLASS MANAGE_WIDGET WRITE_CLIPBOARD
GET_CLIPBOARD READ_CLIPBOARD WRITE_GLOBAL_SELECT
GET_DEFAULT READ_GLOBAL_SELECT
Miscellaneous Statements
ABORT ERROR INT MESSAGE_TEXT
ASCII ERROR_LINE JOURNAL_CLOSE QUIT
CALL_USER ERROR_TEXT JOURNAL_OPEN READ_CHAR
CONVERT EXPAND_NAME LEARN_ABORT READ_KEY
CREATE_ARRAY EXIT LEARN_BEGIN READ_LINE
DEBUG_LINE FAO LEARN_END SLEEP
DELETE HELP_TEXT LENGTH STR
INDEX MESSAGE SUBSTR
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)