Dial Up Icon

Dial Up Action

Declaration

<AMDIALUP ACTION="text [options]" ENTRY="text" NUMBER="text" USERNAME="text" PASSWORD="text" REDIAL="number" REDIALTIME="number" WAITTYPE="text [options]">

See Also

Open Web Page

Description

Establishes a dial-up connection from either a system phone book entry or a phone number. Note that this does not take on the redial properties that are specified in the phone book entry.

Practical Usage

Used to connect to the Internet with a modem of other network device if needed before executing Internet actions.

Parameters

General Tab

Action
Text [options], Optional - Default "connect_phone_book"
MARKUP: ACTION="connect_manual"

Specifies the action that should take place on the connection. The available actions are:

connect_phone_book: Connect to the phonebook connection specified in the Entry parameter.

connect_manual: Connect to the a machine manual, bypassing the Windows phonebook. The connection will be established based on the information in the NUMBER, USERNAME and PASSWORD fields.

disconnect_phone_book: Disconnects the phonebook connection specified in the Entry parameter if it is active.

disconnect_all: Disconnects all active RAS connections.

Phone Book Entry
Text, Optional
MARKUP: ENTRY="Earthlink Internet"

Specifies a network or dial-up connection to take action on. This option is only valid if action is set to connect_phone_book.

Number
Number, Optional - Default (none)
MARKUP: NUMBER="555-555-5555"

Specifies the phone number that should be dialed. This option is only valid when ACTION= is set to connect_manual.

Username
Text, Optional - Default NONE
MARKUP: USERNAME="joe"

Specifies the username to use when logging on to the remote connection. This option is only valid when ACTION= is set to connect_manual, otherwise the parameter is ignored.

Password
Text, Optional - Default NONE
MARKUP: PASSWORD="joe"

Specifies the password to use when logging on to the remote connection. This option is only valid when ACTION= is set to connect_manual, otherwise the parameter is ignored. When adding this step using visual mode, the value is automatically encrypted and decrypted at runtime.

Redial
Number, Optional - Default 0
MARKUP: REDIAL="3"

If the connection does not succeed, specifies the amount of times that the connection should be redialed before an error is generated. This option is only valid if action is set to connect_phone_book or connect_manual.

Time Between Attempts
Text, Optional - Default NONE
MARKUP: REDIALTIME="30"

Specifies the amount of time to wait for before attempting to redial the connection. The Wait Type [WAITTYPE] parameter specifies whether this value is referring to seconds or minutes. This option is only valid if action is set to connect_phone_book or connect_manual.

Wait Type
Text [options], Optional - Default seconds
MARKUP: WAITTYPE="minutes"

Specifies whether the number specified in Time Between Attempts [REDIALTIME=] is in seconds or minutes. This option is only valid if action is set to connect_phone_book or connect_manual.

The available options are:

seconds: The wait time specified is in seconds. (default)

minutes: The wait time specified is in minutes.

 

Notes

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 by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, a popup expression builder is available in all these fields by pressing F2.
More on variables...
More on expressions...
More on the expression builder...

Example

<AMPINGMACHINE HOST="server.domain.com" VARIABLE="responsetime">