Chapter Contents

TPU

TPU

Temporarily suspends the current SAS session and starts a session of the TPU Editor

Language element: command

OpenVMS specifics: All aspects are host-specific

Syntax
Details

Syntax

TPU | HOSTEDIT | HED

TPU: suspends your SAS session and opens a session of the TPU Editor.
HOSTEDIT: is an alias for the TPU command.
HED: is an alias for the TPU command.

The TPU command (or its aliases, HOSTEDIT or HED) enables you to use the OpenVMS Text Processing Utility (TPU) editor for editing instead of the default SAS Text Editor.

The command suspends your SAS session and initiates a session of the TPU Editor. When this session begins, the TPU window displays the contents of the window from which it was invoked, and the name of the window is displayed on the TPU status line. You can then edit the window's contents.

If you have write access to the window (such as the Program Editor window), then you can save the changes that you make during the TPU session to the window when you exit from the editor, or you can save the changes to an external file.
If you have only read access to the window, then a message on the message line of the TPU window alerts you to this fact. When you exit from the editor, you can save your changes to an external file, but you cannot save them to the window.

Special text attributes such as color or highlighting are lost during a TPU editing session. Therefore, when you issue the TPU command from a window that contains text with these attributes, a requestor window appears. The requestor window enables you either to continue or abort the TPU command.

To suppress this warning, issue the HEATTR OFF command from the window's command line before you invoke TPU. Text attributes will then be deleted without warning. To redisplay the warning message, issue the HEATTR ON command from the window command line, then issue the TPU command.

When you have finished editing in a TPU session, do one of the following:

To save the changes to the window, use the CTRL-Z key sequence or type EXIT at the TPU command prompt.
To discard the changes you made, type QUIT at the TPU command prompt.
To save the contents of the window to an external file, use the standard TPU commands. Then use the CTRL-Z command or the QUIT command, depending on whether you also want to save the changes to the window.

In each case, you are returned to the window in the SAS session that was suspended. You can undo any changes you made to the window text during that session by issuing the UNDO command from the window command line.

You may find it useful to define a function key to invoke your favorite editor interface. By default, the CTRL-N key sequence in the Program Editor window invokes the TPU Editor.

Chapter Contents
Previous
Next
Top of Page

Copyright © 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.