Toolbar setup

Edit

The Edit button allow you to either delete buttons from the toolbars or to move a button to a new position, either within the same toolbar or to a different toolbar. Tap the stop icon and confirm by tapping the Delete button to delete a button. Tap, hold and drag the list-icon on the button you want to move, to its new position. Tap Done to exit Edit-mode.

Add buttons

This option allow you to add new buttons to the current position in the current toolbar, so before tapping Add buttons you have to select the toolbar and toolbar-position where you want to insert the new toolbar button(s). From the Add buttons screen you can select one or more buttons to be inserted. The button can either be used to activate a predefined function (key) or a Macro. Tap Save when you have completed your selection, or tap Cancel to return to the Toolbar setup screen. If you decided to add a Macro, tap the detail-icon on the righthand side of the new button with text Macro to configure the macro 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

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, or tap Cancel to return to the Toolbar setup screen.

Options

The size of the toolbar buttons be changed, both the width and the height, see Toolbar options.

Toolbar 1-n buttons

Each button in a toolbar can be modified by tapping the detail-icon on the righthand side. You can modify this button-position to perform a different function by tapping the Button selected line. You can also 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.

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'.