Creating and Using Macros

In addition to remapping individual keys, TinyTERM Enterprise for Android can create, edit and use macros.

Recording a Macro

To record a macro, you must first have an active host connection. Once connected, go to TinyTERM's list of configurations, scroll down to the bottom, and tap the Macros button. The Macros dialog opens.

Tap the Record Macro button to start recording. TinyTERM will return to the active session.

At this point everything sent to the host is recorded in the macro including text, function keys, etc. TinyTERM also recognizes incoming data from the host, and automatically configures the macro to match.

Entering Secure Text

While recording a macro, tapping the Macros button brings up a Macros menu. This is not recorded as part of the macro.

Selecting Enter Username or Enter Password adds the username or password from the connection settings and enters that information automatically at this point when the macro runs.

If there is no username or password entered, a dialog will open for the missing item as the macro runs. The dialog also offers the option to save the username or pasword. This allows one person to create a macro for distribution, with users able to customize it at runtime.

The Enter Secure Text button allows you to enter text that will be masked. Secure text can't be read by looking at the configuration or macro, or by reading the screen as the macro plays back.

Once you've chosen any of the three Enter buttons, or chosen not to use any of the buttons at all, tapping the back arrow at top left returns you to the configuration screen. From there you can return to the active TinyTERM session. These screen taps are not recorded as part of the macro.

Saving a Macro

To finish recording and save the macro, edit the Enter Macro Name field, or accept the default name. Then tap the Save Macro button.

Running a Macro

To run a macro, tap the macro button in the title bar of an active session. A list of macros displays. Tap the name of the macro you want to run.

There is also an Option button at the bottom of the list. This will take you to the Macros menu.

Editing a Macro

From the Macros menu, select a macro to edit. Tap the Macro Name field to rename the macro.

To edit the macro's behavior, scroll down to to the Edit Macro section. In this section, "^M" is used for the Enter key, ASCII value 13. Similar values can be used for any control character, such as "^S" for Ctrl-S, or "^I" for Tab.

You can also reorder or remove rows in the macro. Tap the check box on the left of the line. Up and down arrows and a trash can will appear in the title bar. Tap the up or down arrow to change the order of the selected line. Tap the trash can to remove it.

Once you're done making changes, tap the back arrow at top left to return to the macro menu. The changes will take effect immediately.

Deleting a Macro

To delete a macro, tap the Macro button to bring up the menu. Tap the macro you want to remove. At the bottom of the screen, tap Delete Macro.

Android User Guide Table of Contents