Send Terminal Text

Declaration

<AMSENDTERMTEXT SESSION="text" WAITFORDEFAULTPROMPT="text [options]">text</AMSENDTERMTEXT>

See Also

Connect Terminal, Disconnect Terminal, Send Terminal Text, Get Terminal Text, Wait Terminal, Control Terminal

Description

Sends text at the current cursor position to an established Terminal session.

Practical Usage

Used to send text into an existing terminal session that was previously created by Connect Terminal. The terminal actions are used in leu of terminal emulation software. Using the terminal actions, legacy systems can be automated in the background without the use of 3rd party software.

Parameters

General Tab

Text

Options, optional default tcp/ip
MARKUP: <AMSENDTERMTEXT WAITFORDEFAULTPROMPT="BEFORE">Smith</AMSENDTERMTEXT>

Specifies the text to send to the terminal. For example, if the terminal prompt was requesting a last name, the Send Terminal Text could be "Smith" (no quotes).

Session Name

Text, Optional - Default "TermSess1"
MARKUP: SESSION="terminalsession2"

Specifies the session name to send this text to. This session name must have been previously created with a prior Connect Terminal step. This allows several connections to be active simultaneously. If you are only using one connection at a time, do not specify a value other than the default.

Wait for Default Prompt

Text [options], Optional - Default
MARKUP: WAITFORDEFAULTPROMPT="BEFORE"

Specifies whether task execution should stop before and/or after the text is sent to the terminal. Often this option is needed to cause the task to wait until the terminal is ready to receive the next command before sending text.

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMSENDTERMTEXT WAITFORDEFAULTPROMPT="BEFORE">Smith</AMSENDTERMTEXT>