Robo-FTP User's Guide > Script Programming > Script Commands > All Script Commands > DIALNET

Syntax:	DIALNET	[ name ] \| [ /options ]
Arguments:	[ name ]	Variable or string defining the computer/phonebook entry name that is to be dialed; the computer/phonebook entry name must have been predefined during Dial-Up Networking set up; if the computer/phonebook entry name is omitted, the default computer/phonebook entry name defined during Robo-FTP configuration is used.
Options:	/altnum=xx	Define an alternate phone number to be dialed if you wish to override the pre-defined phone number.
	/pw=xx	Define the password to use when logging on if one was not defined at Robo-FTP configuration time.
	/user=xx	Define the user name to use when logging on if one was not defined at Robo-FTP configuration time.
	/timeout=nn	Specifies the time-out in seconds to wait for the dial-up connection to complete. A %datetime value can also be given as an argument instead of a number of seconds.

This script command initiates a dial-up connection to a computer/phonebook entry name previously defined using the Dial-Up Networking services of your computer. Use this command to establish dial-up FTP file transfer sessions over the Internet.

Such connections are ended using the DISCONNECT script command.

The user name and password must be explicitly specified within the DIALNET command or specified as the DIALNET defaults at Robo-FTP configuration time. The /user and /pw options are used to specify the desired user name and password respectively if you elected not to use preconfigured defaults.

The /altnum may be used to override the phone number associated with computer/phonebook entry name. The /timeout option should be used to make sure that control returns to Robo-FTP if an FTP site does not respond.

Robo-FTP does not, under any circumstances, use the user name or password value specified for a given connection when the Dial-Up Networking connection was created.

Consider the following example where Robo-FTP establishes a dial-up connection and then logs on to an FTP site.

DIALNET "My Server Computer" /user=myuserid /pw=mysecret

FTPLOGON "ftp.acme-widget.com" /user=anonymous /pw=itchy

The following example would perform exactly the same as the previous one assuming that the user name and password were set up as the defaults in the Robo-FTP Configurator. This example also implements a 60 second connection time-out.

DIALNET "My Server Computer" /timeout=60

FTPLOGON "ftp.acme-widget.com" /user=anonymous /pw=itchy

Consider the following example where Robo-FTP establishes a dial-up connection and then logs on to an FTP site. Note: the /user option in the DIALNET command is missing -- the user name specified during Robo-FTP configuration is used.

DIALNET "My Server Computer" /pw=mysecret

FTPLOGON "ftp.acme-widget.com" /user=anonymous /pw=itchy

Related command(s): DISCONNECT, FTPLOGON, FTPLOGOFF