Session (tbx) File Format

The tbx file utilizes a human-readable format to store/restore the content of the transfer queue. A tbx file is created with menu [Session | Save queue] or manually with a text editor.

Each line in a tbx file is a queue entry and looks almost exactly what you see in the Queue Window. Format of an entry:

<localpath> <size> <direction> <remotepath> <host> [d]

Use a whitespace character as the delimiter.
If localpath or remotepath contains whitespace, it must be enclosed in double quotes("").

localpath
The local file/folder path.

direction use the following symbols:
-> or <-
for upload and download, respectively.

>> or <<
to overwrite all existing files found on destination with no confirmation.

->> or <<-
to indicate that the source path uses a wildcard to represent a group of files (wildcard only applies to files, all sub-folders under the same directory will be ignored and will not be transferred).

.-> or <-. (there is a dot at the opposite end of the arrow)
to indicate a "transfer as" action, a new file name must be given in the destination path.

Append an 'x' at the opposite end of the arrow to delete files from the source after they are transferred successfully to the destination path.

Append a '=' at the opposite end of the arrow to move files to a predefined folder after they are transferred successfully to the destination path. This feature is only available when running a sync task or session task.

remotepath
Remote file/folder path.

size
If you create a tbx file manually, using zero (0) as size will be fine.

host
Host address without ftp:// at the beginning.

d
If the source path is a folder, append a "d' to the end of the line.

Examples:

Upload a file to remote host
c:\upload\www\index.html 0 -> \public\www ftp.myhost.com

Download the whole remote folder \archive 2003\update to local directory c:\download. There is a whitespace in the remote path name, so double quotes are used.
c:\download 0 <- "\archive 2003\update" ftp.myhost.com d

Download myfile.doc then delete it on the remote server.
c:\download 0 <<x \archive\update\myfile.doc ftp.myhost.com

Upload all files with extension jpg in c:\upload to remote server.
c:\mysite\www\images\*.jpg 0 ->> \pub\images ftp.myhost.com

Upload wessi.doc and store it on the remote server in name ossi.doc
c:\download\wessi.doc 0 .-> \archive\update\ossi.doc ftp.myhost.com