WORKINGDIR        Change local default (working) folder

Top  Previous  Next

Syntax:

WORKINGDIR

[ folder name ]

Alt Syntax:

CHGDIR

[ folder name ]

 

CD

[ folder name ]

Arguments:

[ path name ]

A variable or string to specify the path name of Robo-FTPs default folder.

Options:

None

 

 

 

This script command defines the default folder for all file oriented script commands. Anytime a file name is specified in a command without a full path associated with it, Robo-FTP either searches for or creates this file in the designated working folder. The selection made in this command overrides the default selection set with the Robo-FTP Configurator.

 

The current working folder is always maintained in the %currentlocaldir variable.

 

Consider the following example.

 

;; read record in "c:\Program Files\Robo-FTP\example.txt"

WORKINGDIR "c:\Program Files\Robo-FTP"

READLINE "example.txt" first_record

 

If a partial path is specified, it and the previous working folder are used to define the new working folder.

 

;; current working folder is "c:\Program Files\Robo-FTP"

WORKINGDIR "test"

;; new working folder is now "c:\Program Files\Robo-FTP\test"

 

If “..” is specified, the new working folder is set one folder above the previous working folder.

 

;; current working folder is "c:\Program Files\Robo-FTP"

WORKINGDIR ".."

;; new working folder is now "c:\Program Files"

 

Caution

The directory change made by WORKINGDIR is global within the Robo-FTP script environment. If WORKINGDIR is going to be called in a function or a called script, it is always recommended that the current working folder be saved on entry and restored on exit if it is going to be changed. See the description of the %currentlocaldir variable for an example of this.

 

To change to a different directory on an FTP site, use the FTPCD script command.

 

Related Command(s): ARCHIVEDIR, MAKEDIR