How can I add a new toolbar button?

Tap Menu -> Settings -> Toolbar setup, then mark the button you want the new toolbar button(s) to be positioned after. 

​

Then tap Add

 

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.

​

​

​

​

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

​

​

Macro string

​

When entering a macro string, in addition to plain text, there are several conven-tions, all of which are signaled 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 follow-ing 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 depend-ing 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'.

​

​

​

​

​