Section 3.3: Working with Actions

Editing Actions | Selecting Action Parameters | Executing Actions

TouchTerm Pro provides a library of Actions that can be performed at any time, or in response to Application Events or Gestures.

The Actions library can be accessed directly from the Settings screen (using the "Actions" link):

See the Reference Guide or use the Integrated Help for more detailed information on particular Actions.

The Actions are organized into groups as follows:

• Transmit: Actions for transmitting strings or special character codes to the remote host.
• Keyboard: Actions for controlling the main Keyboard used for typing commands, and Control and Alt key states.
• Interface: Actions for launching TouchTerm Pro interface components, such as Text Completion, QuickZoom, and Directory Navigation.
• Display: Actions for controlling the Terminal display contents, including scrolling, fitting font size to screen width/height, and clearing the display buffer.
• Clipboard: Actions for Copy, Paste, and working with the Clipboard and Selection Markers.
• Change Options: These Actions allow you to automatically change the values of Options. For example, use these Actions to toggle On/Off Options, or change the text or background colors.
• Keypads: Actions for showing and hiding Keypads.
• E-Mail: Actions for sending Clipboard or screen contents via E-Mail.
• Connection: Actions for terminating the active SSH session.
• Profiles: Actions for saving, reverting, and switching between configuration Profiles.
• Misc.: Includes actions for working with the Text Completion index and public host keys.

Editing Actions

(Back to Top)

The main tool involved in configuring Event Mappings or Keypad Keys is the Action Editor, pictured below:

Use the Action Editor to assign one or more Actions to the indicated Event or Key. The top section of the Action Editor provides information about the Event or Keypad Key that is being configured; in the caes of Keypad Keys, it also allows you to change the label used for the Key.

The bottom section of the Action Editor lists the currently configured Actions for this Event or Key. To add an Action, use the Add ("+") button in the upper-right corner. This brings up the Action library, and allows you to select an Action to add to the list. Select the Action that you wish to execute, choose its parameters if it has any, and then tap "Done" to add the Action to list of configured Actions.

Note that you can add as many Actions as you like, and they will be executed in the sequence specified.

To remove an Action from the list, use a swipe gesture on the appropriate entry and confirm the deletion.

Selecting Action Parameters

(Back to Top)

Many Actions include parameters which control the Action's behavior: for example, the Send String action includes as a parameter the string to transmit to the remote host; and the Show Keypad action has a parameter for selecting which Keypad to show.

Note that some Action Parameters have to meet certain criteria, otherwise they will present a "validation" error, requiring you to adjust the parameter appropriately. See the Integrated Help for the corresponding parameter for more details if you are getting a validation error.

Executing Actions

(Back to Top)

When browsing the Actions directly from the Settings menu, you can choose to execute them immediately, after selecting the parameters, by tapping the "Go" button in the upper-right.

Note that many Actions require an active SSH session in order to function properly; therefore, many actions will fail (and report an error) if you attempt to execute them without having an active connection.