Toolbar setup

Add

This option allow you to add new buttons to the current position in the current toolbar, so before tapping Add select the toolbar and toolbar-position where you want to add the new button(s). From the Add button screen you can select one or more buttons to be added. The button can either be used to activate a predefined function (key) or a Macro. Tap Save when you have completed your selection. If you decided to add a Macro, use the Modifiy menu function to set the button name and the macro string to be executed. See Macro string section below on how to define a macro string.

Note that the simplest way to define a Toolbar macro is to use the macro-recording feature available from Menu > Record macro. See the help page for Record macro

Modify

Each button in a toolbar can be modified by Modify menu function. You can modify the text displayed on the button for this particular function by editing the Button text field. If the Button selected is a Macro, you have to define the Macro string to be executed when the button is tapped.

Remove

Use the Remove menu function to remove a button from the toolbar. The last button removed can be added again using the Paste menu function. Select a new position to paste the button at a new location.

Paste

See Remove menu function above.

Add toolbar

This option allow you to add new buttons to a new toolbar. From the Add toolbar screen you can select one or more buttons to be inserted. Tap Save when you have completed your selection.

Button size

This option allow you to adjust the width and height for all the toolbar buttons with a scaling factor (from 0.2 to 5.0).

Please note that the width for an individual button can be doubled by preceding the button text with a * (star). If the button text starts with **, the button width will be tripled and so on. For example, if the button text is modified from Enter to *Enter, the button text shown is Enter but the button width is doubled.

Macro string

When entering a macro string, in addition to plain text, there are several conventions, all of which are signalled using the caret (^). If you wish to enter a 'real' caret then you must type it twice (^^).

Control characters may be entered using the normal convention with a letter following the caret symbol. For example, a return is ^M and a line feed is ^J.

You may also send specific ASCII codes in hexadecimal, decimal, or octal form by following the caret with a $, #, or & character, and the desired code:

^#ddd
decimal specification
^&ooo
octal specification
^$hh
hexadecimal specification

Note that decimal and octal codes must be 3 digits and prefixed with 0 if it is 2 digit codes.

Transmitting the string you have defined on a macro can be awkward if you are working in multiple environments where you sometimes need a CR terminator and sometimes need an ETX or EOT. To do this transparently, use the conventional form ^! (caret + exclamation mark). The correct line terminator will be sent depending on the mode in which the emulator is operating. Note that if a macro contains multiple transmits then the macro execution will be suspended on each transmit, and resumed when the host has responded. This functionality is only reliable for host connections with a 'turn' mechanism that signals when the host response is finished (DSA, Ggate and TNVIP).

Function codes (for those using synchronous interfaces) may be sent using the form '^=x', where 'x' is the function code you wish to be sent with the next message to be transmitted.

If the last character in the macro string typed in is '^', it will be ignored. This can in fact be useful: in that trailing spaces are deleted from the input you type, you can use an appropriately placed '^' at the end of the string to ensure that required trailing spaces are actually included. For example, entering 'ABC ^' will provide a trailing space after the 'ABC'.