The TPU$CONTROL routine is the main processing routine of the
TPU editor. It is responsible for reading the text and
commands and executing them. When you call this routine (after
calling TPU$INITIALIZE), control is turned over to TPU.
Format
TPU$CONTROL [integer]
1 – Returns
OpenVMS usage:cond_value
type: longword (unsigned)
access: write only
mechanism: by value
Longword condition value. Most utility routines return a
condition value in R0. Condition values that this routine can
return are listed under Condition Values Returned.
2 – Argument
integer
OpenVMS usage:integer
type: longword (unsigned)
access: read only
mechanism: by reference
Prevents TPU from displaying the message "Editing session is
not being journaled" when the calling program gives control to
TPU. Specify a true (odd) integer to preserve compatibility in
future releases. If you omit the parameter, TPU displays the
message if journaling is not enabled.
3 – Description
This routine controls the editing session. It is responsible for
reading the text and commands and for executing them. Windows on
the screen are updated to reflect the edits made. Your program
can regain control by interrupting TPU using the TPU$SPECIFY_
ASYNC_ACTION routine, together with the TPU$TRIGGER_ASYNC_ACTION
routine.
NOTE
Control is also returned to your program if an error occurs
or when you enter either the built-in procedure QUIT or the
built-in procedure EXIT.
4 – Condition Values Returned
TPU$_EXITING A result of EXIT (when the default condition
handler is established).
TPU$_NONANSICRT A result of operation termination - results
when you call TPU with TPU$DISPLAYFILE
set to nodisplay and you attempt to execute
screen-oriented commands.
TPU$_QUITTING A result of QUIT (when the default condition
handler is established).
TPU$_RECOVERFAIL A recovery operation was terminated
abnormally.