MacWise - Macintosh Terminal Emulation - telnet / serial for OS X - Wyse, Viewpoint, VT100, VT220

MacWise Version 12
Screen Saves and Restores

Saving and Restoring Screens with MacWise

Many host computers are programmed to instruct the client app to save and restore screens.
MacWise 12.0 or later supports three sets of escape sequences commonly used by PC clients
(HostAccess, Accuterm and System Builder).
The client app is responsible for storing the screens (MacWise, in this case). This was originally done back in the days of slow serial connections because it was much faster for the client to display stored screens instead of the host resending them to the client app.
But that legacy code remains on host computers and therefore needs to be supported.
MacWise version 12.0 supports up to 13 screen levels (also called slots, stacks or blocks).

HostAccess Escape Sequences:

ESC [=Np Save the screen to slot N (where N is the slot number to save)
ESC [=Nq Restore the screen from slot N (where N is the slot number to restore)

The following HostAccess escape sequences use a stack (or slot) method.
Each time ESC [=p is sent to the client from the host, the client saves the current screen to the current stack and then increments the stack by one. Then when ESC [=q is sent to the client, the current stack is restored back to the current screen.

ESC [=p Save the current screen to the top of the stack
ESC [=q Restore the screen from the top of the stack back to the current screen.

Accuterm Escape Sequences:

Areas of the screen, called blocks, can be saved and restored. Any area of the screen can be defined as a block.
Each block can be captured from anywhere on the screen and then restored to any position on the screen.
Each block is defined by the ID which can be an alphanumeric string.
MacWise ignores the page attribute.

ESC CHAR(2) jD ,ID CR Clear the screen block stored as ID

ESC CHAR(2) jS ,ID , col , row , width , height , page CR Save the screen block with ID

Saves a copy of the specified screen block (text, colors and
visual effects) and terminal state in memory and associates the
block with the specified identifier (ID) whichcan be an
arbitrary alpha-numeric string (may not contain commas). Any
number of screen blocks can be saved, but MacWise currently
only supports 13 blocks. Coland rowspecify
the upper-left corner of the block. If either is omitted or null,
zero is assumed. Widthand heightspecify the size of the
block. If widthor heightis omitted or null, the screen width
or height is used. Pageoptionally specifies the terminal page
for the block, and if omitted or null, the current page is used.
MacWise ignores the Page attribute.

ESC CHAR(2) jR ,ID , col , row , page , state CR Restore the screen block with ID

Restores the screen block associated with the specified
identifier (ID) to the screen. Coland rowspecify the upper-
left corner of the destination. If either is omitted or null, the
original position of the saved block isassumed. Page
optionally specifies the terminal page for the destination, and
if omitted or null, the current page is used. If stateis 1, the
terminal state (current attribute, cursor position, write protect
mode, etc.) is restored along with the screen contents.
MacWise always assumes the State is 1 and Page is ignored.

System Builder Escape Sequences:

ESC [>xxp where xx is the save level. Saves the current screen as level xx
ESC [>xxq where xx is the restore level. Restores the screen from level xx

NOTE: You must have System Builder enabled under the Emulate Menu in MacWise
to process System Builder escape sequences.


NOTE: If you are doing some host programming, please be aware that you can only use one of the above methods for saving and restoring screens. For instance, you can't use HostAccess and Accuterm codes at the same time.

NOTE: HostAccess, Accuterm and System Builder are trademarks of their respective companies and are not associated with Carnation Software.

MacWise allows a Macintosh to be used as a terminal -- connected to a host computer directly, by modem, local area network or over the Internet. The emulators support video attributes such as dim, reverse, underline, 132-column modes, protected fields and graphic characters sent from the host computer, as well as enhanced Viewpoint mode. Features include phone list and dialer for modems, on-screen programmable function keys, connection scripts and more.


MacWise emulates ADDS Viewpoint, Wyse 50, Wyse 60, Wyse 370, Televideo TV 925, DEC VT100, VT220 and Prism terminals. Supports ANSI color. Esprit III color is also supported in Wyse 370 mode. SCO ANSI is also supported.

For more information and a demo, visit

Visit Carnation Software for other Macintosh Software at



1. Built in Modem
2. Telnet / TCP/IP
3. SSH Secure Shell
4. Serial ports via USB to Serial adaptor
5. Also communicates directly with the Mac unix shell


If your office uses a business computer that allows you to log in as a terminal, you can use MacWise to access your business data from your Macintosh when you are out of the office (or in the office)

MacWise will connect your Mac to the office computer using your modem or with ethernet using a lan connection in your office or over the Internet.


Rich Love
Carnation Software
512 858-9234

Carnation Software News Keep up to date with Carnation Software RSS News