7.3.1 The Insert Functions Dialog Box

In this dialog box, you can insert a wait command which pauses the macro until the specified host conditions are met, move the cursor to a new position on the host or pause the macro and display a text prompt.

Table 7-3

Settings

Description

Wait for Text

Causes the macro to wait until specified text appears. You can choose to have it appear at a specific position (Row(s), Col(s)) or you can choose no specific position (Anywhere On Screen).

Text

Enter the text that you would like to appear in the prompt message.

Anywhere On Screen

Indicates that the specified text may appear anywhere on the screen to satisfy the wait condition.

At Screen Position

Indicates that the text must appear at a designated screen postion (Row and Col) to satisfy the wait condition.

Row (s)

If the Wait Until Cursor Moves function is selected, this field indicates a relative move up or down this many rows.

Column(s)

If the Wait Until Cursor Moves function is selected, this field indicates a relative move left or right this many columns.

Wait for Cursor to Appear at

Causes the macro to wait until the cursor is at the designated row and column.

Wait Until Host is Quiet for

Causes the macro to wait until the host is quiet (ready) for the designated number of seconds.

Pause for ___ Seconds

Causes the macro to wait the designated number of seconds before resuming.

Seconds

Enter the number of seconds to wait before resuming. You can enter the number of seconds the host is quiet or you can enter the number of seconds the macro should wait before resuming.

Wait for Cursor to Move

Causes the macro to wait until the cursor moves to the designated location, relative to its current (up/down, left/right) location.

Up

Indicates the cursor must move this many rows (up) from its current position before the macro resumes.

Down

Indicates the cursor must move this many rows (down) from its current position before the macro resumes.

Left

Indicates the cursor must move this many columns (left) from its current position before the macro resumes.

Right

Indicates the cursor must move this many columns (right) from its current position before the macro resumes.

Move Cursor To

Indicates what row and column you want the cursor position to be on the host.

Display Message Box With Text

Causes the macro to wait until the user responds to the message box with this text.

To insert special macro functions

The following steps describe how to insert special macro functions as you record a macro.

  1. From the Macro Recorder panel, press the Insert button.

  2. Select the function you'd like to insert.

    • 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 the cursor position moves the cursor to a new position on the host screen.

      NOTE:This function repositions the cursor only when the macro is running. As you record, you must move the cursor manually.

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

  3. Choose the OK button.

  4. Finish recording your macro.