3.4.1 The Record Macro Dialog Box

Use the Record Macro dialog box to record a macro. When you record a macro, you can temporarily pause the recording. For example, if you forget the name of a file to be included in the macro, you can pause the recording, look up the file name, and then resume recording.In addition, you can insert several special macro functions into a macro as you record it.

To record a macro

  1. From a session, choose Macro from the Tools menu.

    The Macro dialog box appears on your screen.

  2. Choose the Record button.

    The Record Macro dialog box opens.

  3. In the Macro Name field, enter a unique name for your macro.

  4. (Optional) In the Description field, enter a brief description of the macro.

    Your description provides a quick reference, especially in installations where many different macros have been created.

  5. In the Make Macro Available To field, enter the location to which you want to make your macro available.

  6. To use your macro with any session that is active, select Use With Any Active Session.

    -or-

    To use your macro with only the current session, select Use With This Session Only.

  7. Enter a value for Default Wait Timeout to indicate the amount of time the macro waits before continuing to record actions. The default is 3 seconds.

  8. Choose the OK button.The macro recording panel displays.

  9. Perform the actions you want to record.

    Select the Pause button to stop recording temporarily. Select the Pause button again to continue recording. To pause the macro and insert a special macro function into the script, press the Insert button.

  10. Select the Stop button to stop recording after the last action.

Inserting Special Macro Commands

You can pause a macro recording and insert special macro functions into the script. The following types of special macro functions are included:

  • Wait functions cause the macro to wait until specified host conditions are met before resuming (specific text appears, host is ready, a specified number of seconds has elapsed, the cursor is positioned at a specified row and column, the cursor moves up, down, left, or right a specified amount). Wait functions are useful in macros that require the host to do time-consuming processing.

  • Moving cursor position moves the cursor to a new position on the host screen.

  • Entering text pauses the macro and displays a text prompt. When responded to, the macro resumes.

Options

Description

Record Macro Name

Enter a unique name for your macro.

Description

(Optional) In the Description field, enter a brief description of the macro.

Your description provides a quick reference, especially in installations where many different macros have been created.

Make Macro Available To

Enter the location to which you want to make your macro available.

Save as Startup Macro for This Session

When selected, your macro is runs each time you start this session.

Run This Macro When Reconnecting

When selected, your macro runs each time this session reconnects.

Use with any Active Session

When selected, your macro is used with any session that is active.

Use with this Session Only

When selected, your macro is used only with the current session.

Default Wait Timeout

Indicates the amount of time the macro waits before continuing to record actions. The default is 3 seconds.

Record an Express Logon Macro

Select to record a start-up macro, which provides automatic logon by replacing the placeholder strings in the macro with the valid user name and password for the user connecting to the host.

Application ID

The ID of the host application to which the Express Logon Macro should connect.

Help button

Choose this button for help on recording macros.