Niwot Networks Innovative File Transfer and File Management
Innovative File Transfer and Management

Gigabyte Express™ DSL for Windows

 
 

USER MANUAL
FOR


Gigabyte Express™ 7 for Windows
with RELIA™ Technology


Internet Protocol File Transfer
for Windows 2000/2003/NT4/XP



N I W O T    N E T W O R K S,    I N C.



721 9th Avenue
Longmont, CO 80501
(303) 772-8664

© Copyright 2000-2006 Niwot Networks, Inc.

0.1492 February 2006

February 2006 GBXWIN 7.208
December 2005 GBXWIN 7.203
November 2005 GBXWIN 7.201



Table Of Contents



1. GIGABYTE EXPRESS FOR WINDOWS

1.1. Gigabyte Express Introduction

1.2. System Requirements

2. RELIA™ Technology

2.1. RELIA™ Technology Summary (Patent No. US 6,445,717; US 6,895,019)

2.2. RELIA™ Technology Reports

3. GIGABYTE EXPRESS INSTALLATION

3.1. Software Installation from Scratch

3.2. Demo Download Installation

3.3. Make sure you can 'Ping' your destination

3.4. Firewall Notes

3.5. Software Upgrade

3.6. Uninstall

4. GIGABYTE EXPRESS

4.1. Start Up

4.2. Answer Window

4.2.1. State
4.2.2. Name and Size
4.2.3. Byte Count
4.2.4. Message
4.2.5. Overall
4.2.6. Line Status
4.2.7. Transport
4.2.8. Average Rate
4.2.9. Min.

4.3. Dial Window

4.3.1. State
4.3.2. Name and Size
4.3.3. Byte Count
4.3.4. Message
4.3.5. Overall
4.3.6. Line Status
4.3.7. Transport
4.3.8. Average Rate
4.3.9. Min.

5. Autosend

5.1. Overview

5.2. Sent Files Handling

5.3. Autosend Options

5.3.1. Start Autosend Using:
5.3.2. Autosend List
5.3.3. File Handling After Send
5.3.4. Poll Folders Every xxx Seconds
5.3.5. Examine Files Every yyy Seconds
5.3.6. Restore Defaults

5.4. AutoSendList format

5.4.1. WAIT and WHEN in NiwotAutoSendList
5.4.2. GET in NiwotAutoSendList (Autoget)
5.4.3. [NoFolder] in NiwotAutoSendList
5.4.4. [Dwell=<t>] in NiwotAutoSendList
5.4.5. Source folder
5.4.6. Destination folder
5.4.7. Gigabyte Express phonebook name
5.4.8. Options
5.4.9. Example

6. Gigabyte Express Menu Bar Selections

6.1. File Menu

6.1.1. Send Files/Folders (File Menu)
6.1.1.1. Send
6.1.1.2. Cancel
6.1.1.3. Add
6.1.1.4. Select All
6.1.1.5. Remove
6.1.1.6. Remove All
6.1.1.7. Phonebook
6.1.2. Get Files / Folders (File Menu)
6.1.2.1. Get
6.1.2.2. Cancel
6.1.2.3. Add
6.1.2.4. Select All
6.1.2.5. Remove
6.1.2.6. Remove All
6.1.2.7. Phonebook
6.1.3. Select InBasket (File Menu)
6.1.4. Select OutBasket (File Menu)
6.1.5. Show Selections (File Menu)
6.1.6. Select Gbxacct.log Folder (File Menu)
6.1.7. Quit (File Menu)

6.2. Edit Menu

6.2.1. Serial Number / Validation Code (Edit Menu)
6.2.2. PenName (Edit Menu)
6.2.3. PhoneBook (Edit Menu)
6.2.3.1. Select
6.2.3.2. Cancel
6.2.3.3. Delete
6.2.3.4. New
6.2.3.5. Modify
6.2.3.6. Edit PhoneBook Entry
6.2.3.6.1 PhoneBook Entry
6.2.3.6.2 Transport Type
6.2.3.6.3 Remote Address
6.2.3.6.4 Local Address
6.2.3.6.5 Username and Password
6.2.3.6.6 Disable PenName
6.2.3.6.7 Disable Compression
6.2.3.6.8 Advanced
6.2.3.6.8.1 Target Link Rate Kbits
6.2.3.6.8.2 Remote Port
6.2.3.6.8.3 RELIA Redundancy
6.2.4. Options (Edit Menu)
6.2.4.1. GBXpress Options
6.2.4.1.1. Beep on File Transfer Completion
6.2.4.1.2. Allow PenName Disabling
6.2.4.1.3. Allow Autosend Pathing
6.2.4.1.4. Disable Encryption
6.2.4.1.5. Support Encryption
6.2.4.1.6. Require Encryption
6.2.4.1.7. Read After Write Integrity Check
6.2.4.1.8. Use Log File
6.2.4.1.9. Generate 'Gbxacct.log' Log file
6.2.4.1.10. Restore Defaults

6.2.4.2. Autosend Options
6.2.4.3. Answer Options
6.2.4.3.1. Transport, RELIA™ Technology Answer
6.2.4.3.2. Local IP Address
6.2.4.3.3. Port Number

6.2.4.4. Autoget Handling
6.2.5. Watchdog (Edit Menu)
6.2.6. Transport (Edit Menu)
6.2.7. Users (Edit Menu)

6.3. Session Menu

6.3.1. Start (Session menu)
6.3.2. Stop (Session menu)
6.3.3. New Answer (Session menu)
6.3.4. New Dial (Session menu)
6.3.5. Delete (Session menu)

6.4. View Menu

6.4.1. Toolbar (View menu)
6.4.2. Status Bar (View menu)
6.4.3. Log Window (View menu)
6.4.4. Tile (View menu)

7. Alphabetic list of configuration entries

8. ERRORS

8.1. Error Messages Reported by GBXWin

8.2. GBXWin Transport Layer Messages

8.3. General System Error Codes

8.4. Winsock Error Codes

8.5. Alert Messages

8.6. Niwot Temp_Do Not Use

9. TCP Registry

9.1. Windows 2000/2003/XP TCP Registry

9.1.1. TcpMaxConnectRetransmissions
9.1.2. TcpWindowSize
9.1.3. GlobalMaxTcpWindowSize
9.1.4. Tcp1323Opts

9.2. Windows NT4 TCP Registry

9.2.1. TcpMaxConnectRetransmissions

10. Services for Macintosh on NT/2000 Servers

10.1. MACSUPPORT=1 in the [PREFERENCES] section of the GBXWIN7.INI

10.2. Finder information is written by Services for Macintosh based on extensions

10.2.1. Windows 2000 Servers:
10.2.2. Windows NT Servers:

11. Release Notes

11.1. Release Notes 7.2.0.8

11.2. Release Notes 7.2.0.3

11.3. Release Notes 7.2.0.1

11.4. Release Notes 5.2.0.9

11.5. Release Notes 5.2.0.7

11.6. Release Notes 5.1.2.2

11.7. Release Notes 5.1.2.1

11.8. Release Notes 5.1.2.0

11.9. Release Notes 5.1.1.6

11.10. Release Notes 5.1.1.4

11.11. Release Notes 5.1.1.3

11.12. Release Notes 5.1.1.2

11.13. Release Notes 5.1.1.1

12. Index and License


1. GIGABYTE EXPRESS FOR WINDOWS Back to Table of Contents

1.1. Gigabyte Express Introduction Back to Table of Contents

Gigabyte Express for Windows provides the highest performance file transfer solution when you need to move large files by way of Internet Protocol (IP) backbones.

Two transport types are supported, TCP and RELIA.

RELIA™ technology (Patent No. US 6,445,717; US 6,895,019) Enhances TCP (Transmission Control Protocol) to handle packet loss (also called congestion) and long delay (also called ping time or latency) - your information gets through under harsh network conditions. Niwot's RELIA Technology is an extension to TCP which adds redundant information that enables the receiver to reconstruct lost information without requiring the time delay of retransmission. RELIA™ Technology also adds support of 32 bit window size.

The first application to support RELIA is Niwot's Gigabyte Express for Windows 5.0. RELIA Technology uses Large Window and Packet Recovery™ techniques to optimize throughput over the congested international and satellite Internet or intranets. With 4 percent packet loss, RELIA Technology is 2.9 times as fast as naked TCP on the national Internet, 8.8 times as fast on the international Internet, and 15.8 times as fast on the satellite Internet.

File Pipeline - Improves multi-file transfers by filling the data pipe, 5 times as fast for large numbers of small files.

1.2. System Requirements Back to Table of Contents

1) Windows 2000\2003\NT4\XP
2) 20 Megabytes of disk storage.
3) Application requires 4 Megabytes of RAM, plus 4 Megabytes per active session.

2. RELIA™ Technology Back to Table of Contents

2.1. RELIA™ Technology Summary (Patent No. US 6,445,717; US 6,895,019) Back to Table of Contents

RELIA(tm) Technology is an extension to TCP that uses redundant UDP packets to allow the receiving side to recover from lost packets without requiring the sender to retransmit them. The more redundant packets which are sent, the more severe the congestion can be without degrading performance. The DEMO provides redundancy levels to recover from packets being lost 1,2,4, or 8 packets at a time (RED1,RED2, RED4, and RED8 redundancies).

RELIA(tm) Technology also supports a 32 bit window size, allowing full throughput even when faced with the typical 300 millisecond international Internet and 600 millisecond satellite Internet delays.

The RELIA(tm) Technology is implemented for Windows 2000, NT, and 98 in the form of the RelSock DLL.

2.2. RELIA™ Technology Reports Back to Table of Contents

GBXWin.log entries made by a session using RELIA Technology:

Common information:

Date > Time > Session ID RELIA

Dial Session Connection start:

REDx Connecting on 206.124.12.218 to 185.135.4.151:168
x is 1,2,4, or 8
Connecting on Source IP address to
Destination IP address:Destination port

Answer session Connection start:

Answering on 185.135.4.151:168 from 206.124.12.218
Answering on Destination IP address:Destination port from
Source IP address.

Dial or answer session Connection finish:

REDx: TargetRate=1600 Kbps
x is 1,2,4, or 8
TargetRate= the kilobits/sec link rate requested by PhoneBook entry on the Dialing side

chunks rcvd=40, rercvd=0, sent=2362, chunks resent=4
chunks rcvd=xx, the total number of chunks(multi-packet blocks) received.
rerecvd =xx, the number of extra chunks received(retransmitted by other side)
chunks resent= xx, the number of chunks retransmitted by this station

outgoing lost =305 sent = 16683 rcvd =16378
outgoing lost = xxx is the difference between the number of packets this station sent(given in sent=) and the number of packets the far side received(given in rcvd=).

incoming lost =0 sent= 3745 rcvd =3745
incoming lost=xxx is the difference between the number of packets this station received(given in rcvd=) and the number of packets the far side sent(given in sent=).

3. GIGABYTE EXPRESS INSTALLATION Back to Table of Contents

3.1. Software Installation from Scratch Back to Table of Contents

a) Insert the Niwot CD in CD drive

b) Go to My Computer -> CD drive: -> Setup.exe

c) On some computers, you will need to restart before using GBXWin.

3.2. Demo Download Installation Back to Table of Contents

After download of demo from our website, double-click on exe and it self-extracts into several files - one of those files is setup.exe.

Double-click on setup.exe, then follow instructions.

3.3. Make sure you can 'Ping' your destination Back to Table of Contents

Go to the Command prompt and ping your destination. In order to do this, type "ping". For example, type "ping 206.168.187.169" to ping our test site.

3.4. Firewall Notes Back to Table of Contents

TCP connections start on port 167 (default for Windows, or 32779 default for Mac OS X/Linux). Thereafter communications move to default ports with port values of:

Gigabyte Express Home Answer session needs to allow incoming TCP connections to ports 167 and 32780.
Gigabyte Express Home Dial session initiates outgoing TCP connections from ephemeral ports and most firewalls do not block outgoing TCP connections.

Gigabyte Express DSL Answer sessions needs to allow incoming TCP connections to port 167 and ports 32780 through the maximum number of answer sessions.
   DSL (4+4) we recommend allowing incoming TCP connections to ports 32780 through 32783.
   For DSL (16) we recommend allowing incoming TCP connections to ports 32780 through 32795.
   For DSL (32) we recommend allowing incoming TCP connections to ports 32780 through 32810.
Gigabyte Express DSL Dial sessions initiate outgoing TCP connections from ephemeral ports and most firewalls do not block outgoing TCP connections.

In summary, for Windows, the default for DSL (4+4) products is to allow incoming TCP connections to ports 167 and 32780 through 32783.

Gigabyte Express T1 and T2 TCP Answer sessions needs to allow incoming TCP connections to port 167 and ports 32780 through the maximum number of answer sessions.
   For T1 and T2 (4+4) we recommend allowing incoming TCP connections to port 167 and ports 32780 through 32783.
Gigabyte Express T1 and T2 TCP Dial sessions initiate outgoing TCP connections from ephemeral ports and most firewalls do not block outgoing TCP connections.

RELIA connections start with both TCP connections and UDP packets in to port 168 (default for Windows, or 32778 default for Mac OS X/Linux). Thereafter communications move to default ports with port values of:

Gigabyte Express T1 and T2 RELIA Answer sessions needs to allow incoming TCP connections to port 168 and ports 32780 through the maximum number of answer sessions.
Gigabyte Express T1 and T2 RELIA Answer sessions needs to allow incoming UDP packets to port 168 and ports 32780 through the maximum number of answer sessions.
Gigabyte Express T1 and T2 RELIA Dial sessions initiate outgoing TCP connections from pairs of ports counting down from the 32777,32776 pair, with 2 ports consumed per additional Dial session.
Gigabyte Express T1 and T2 RELIA Dial sessions initiate outgoing UDP packets from pairs of ports counting down from the 32777,32776 pair, with 2 ports consumed per additional Dial session.
Gigabyte Express T1 and T2 RELIA Dial sessions also receive incoming UDP packets from pairs of ports counting down from the 32777,32776 pair, with 2 ports consumed per additional Dial session.
   T1 and T2 (4+4) we recommend allowing incoming TCP connections to port 168 and ports from 32780 through 32783.
   T1 and T2 (4+4) we recommend allowing incoming UDP packets to port 168 and ports from 32770 through 32783.

In summary, for Windows, the default for T1 and T2 products is to allow incoming TCP connections to ports 167, 168, and ports 32780 through 32783.
   UDP packets should be allowed in to ports 168 and the ports from 32770 through 32783.

Within the Gbxwin7.ini file, the ANSWSECOND= parameter is by default set to 32780 and the above notes apply.

The customer may specify different starting ports and ANSWSECOND value (global) if desired.



3.5. Software Upgrade Back to Table of Contents

The GBXWIN7.INI file in the operating system root directory (normally something like C:\WINDOWS) has the serial number, validation code, and settings. The GBXPHONEBOOK7.INI in the operating system root directory has the phonebook information.

Installation of newer versions does not overwrite this file, so your settings are preserved.

3.6. Uninstall Back to Table of Contents

1. To uninstall, go to My Computer -> Control Panel -> Add/Remove Programs. Select GBXWin, hit Add/Remove button. You will be asked, "Are you sure you want to completely remove GBX/Win and all of its components?" Say "Yes".

2. Two files are shared libraries - mfc42.dll and msvcrt.dll. You may be prompted on whether you want to delete these. You should probably not delete these. If you are not prompted, then they will not be deleted.

3. The uninstall does not delete GBXWIN7.INI in your operating system's root directory which contains the serial number, validation code, and preferences, or GBXPHONEBOOK7.INI which contains the phone book.

4. GIGABYTE EXPRESS Back to Table of Contents

4.1. Start Up Back to Table of Contents

Start -> Programs -> Niwot -> GBXWin to start the software. GBXWin comes up displaying its splash screen; you can either press a key on the keyboard, click the mouse, or allow five seconds time to clear the splash screen. If Gigabyte Express is being run for the first time, you will be asked to enter your Niwot License Serial number and Validation Code, then click on OK. NOTE: The Validation Code should be blank in DEMO mode.

Figure 4-1

    

Gigabyte Express initially starts up with 2 answer sessions (one RELIA, and one TCP),2 dial windows (one RELIA, one TCP), and a log window. You may be asked to specify the IP Address for the Answer window. To do that, go to Edit -> Options -> Answer Options -> choose TCP/IP address. Choose 0.0.0.0 for all available addresses, choose another IP address, or type in what IP address you will have, then click on OK.

Additional windows or "sessions" may be started by selecting "New Dial Session" or "New Answer Session" from the pull-down "Session" menu.

The 'Dial' window is used to send a file, to send the contents of a folder, or to get files. An alert window will ask you to enter your PenName when you select the "Send Files/Folder" from the File menu. Your PenName will apply to all answer and dial sessions.

When restarting GBXWin, it will display the last session(s) you had open.

4.2. Answer Window Back to Table of Contents

The title bar of an Answer window displays the Transport type (TCP or Relia) and the Port number used (with TCP, default is 167 for Windows, 32779 for Mac OS X/Linux ... with Relia, default is 168 for Windows, 32778 for Mac OS X/Linux).

Figure 4-2

    

4.2.1. State Back to Table of Contents

The "State" of the 'Answer' window will read "WAITING FOR CALL" when it comes up. If an 'Answer' window has been stopped, the "State" will read "IDLE, WON'T ANSWER" and should be started again. See Session Menu, Start in the GIGABYTE EXPRESS MENU BAR SELECTIONS Section 6.3.

4.2.2. Name and Size Back to Table of Contents

During a file transfer, the name of the file will appear by "Name:" and the size of the file will appear by "Size:". When the transfer is complete, the name and size of the last file will remain.

4.2.3. Byte Count Back to Table of Contents

During a file transfer, the "Byte Count" keeps track of bytes transferred. It may not be accurate after a file transfer. The progress bar by Byte count shows the progress of the file being transferred.

4.2.4. Message Back to Table of Contents

The "Message" field is used to display the last transfer rate and line utilization after a file transfer. Error messages will appear in this field when a problem occurs. To get rid of the message after you have read it, simply click on the message text and it goes away.

4.2.5. Overall Back to Table of Contents

The "Overall" field is used to display the average transfer rate and line utilization of the files transferred. If TCP/IP is being used, line utilization will not be displayed.

4.2.6. Line Status Back to Table of Contents

The line status field is not relevant for an 'Answer' window. The progress bar by Line Status displays the overall progress of all files to be received.

4.2.7. Transport Back to Table of Contents

The "Transport" field is used to display the type of transport that is being used by the session. To change the Transport Type, use Edit -> Transport from the Gigabyte Express Menu Bar, Section 6.2.4.3. This field also displays the local TCP/IP or RELIA address and port being used to answer. A value of 0.0.0.0 allows Gigabyte Express to listen on all available addresses.

4.2.8. Average Rate Back to Table of Contents

During a file transfer, the average transfer rate (in Kbps) for all files so far is displayed. After the transfer is completed, this field is cleared.

4.2.9. Min. Back to Table of Contents

During a file transfer, this field displays an approximation of the time remaining in minutes and seconds until all files are transferred.

4.3. Dial Window Back to Table of Contents

Figure 4-3

    

4.3.1. State Back to Table of Contents

The "State" of the 'Dial' window will read "IDLE" when not in use. During a transfer, it will read "CONNECTING", "FILE TRANSFER", "DISCONNECTING", then back to "IDLE". The "State" will read "AUTOSEND" when in Autosend mode.

4.3.2. Name and Size Back to Table of Contents

When a file transfer is occurring, the name of the file will appear by "Name:" and the size of the file will appear by "Size:". When a transfer is complete, the name and size of the last file will remain.

4.3.3. Byte Count Back to Table of Contents

During a file transfer, the "Byte Count" keeps track of bytes transferred. It may not be accurate after a file transfer. The progress bar by Byte Count shows the progress of the file being transferred.

4.3.4. Message Back to Table of Contents

The "Message" field is used to display the line utilization after a file transfer. Error messages will appear in this field when a problem occurs. To get rid of the message after you have read it, simply click on the message text and it goes away.

During Autosend , when a file is found in the folder Gigabyte Express is checking, the "Message" will flash "FILE OPEN" while the status of the file is being checked. If the file is not in a state to be sent immediately, then "Message" will read "Next Autosend File Exam in xx secs". When no files are in the folder Gigabyte Express is checking, "Message:" will read "Next Autosend Poll in xx secs".

4.3.5. Overall Back to Table of Contents

The "Overall" field is used to display the average transfer rate of the files transferred.

4.3.6. Line Status Back to Table of Contents

The line status field shows the status of a connection when dial-up networking is being used. The progress bar by Line Status displays the overall progress of all files to be transferred.

4.3.7. Transport Back to Table of Contents

The "Transport" field is used to display the type of transport that is being used by the session. To change the Transport Type, edit the Phone Book entry for the Dial Window. See the Edit PhoneBook section under Gigabyte Express Menu Bar Selections, Section 6.2.3.

4.3.8. Average Rate Back to Table of Contents

During a file transfer, the average transfer rate (in Kbps) for all files so far is displayed. After the transfer is completed, this field is cleared.

4.3.9. Min. Back to Table of Contents

During a file transfer, this field displays an approximation of the time remaining in minutes and seconds until all files are transferred.

5. Autosend Back to Table of Contents

5.1. Overview Back to Table of Contents

Autosend is a Gigabyte Express feature which supports ongoing, unattended transmission of files from one or more Dial windows. The sources and destinations for file transfer are supplied by text-based Autosend List files in the Gigabyte Express folder. Filenames for the list files begin with "NiwotAutoSendList". These list files can contain multiple lines, each of which defines the source folder, destination folder, and Phonebook name used during connection.

Autosend supports a [NoFolder] option, which prevents autosend from expanding or sending any folders within the source folder. To ignore folders within the source folder put [NoFolder] after the Phonebook name.

Autosend for a session may be stopped by highlighting the dial session which you want to stop, and selecting "Stop" from the "Session" menu.

5.2. Sent Files Handling Back to Table of Contents

The AutoSend tab under Edit -> Options allows you to specify what action to take after files and folders are sucessfully transferred. The default is to create a "source folder"_sent at the same level as the "source" folder, and to move files and folders into it. Sent files can also be deleted or moved to the Recycle Bin/Trash. Another option allows folder structures to remain in place after these various file moves or deletions. These choices are further explained under Autosend Options, Section 5.3.

The "Send Only Modified Files" option is different in that it also controls which files are sent. Only files with the Archive attribute set will be transferred, and the attribute will be cleared after the transfer is complete.

5.3. Autosend Options Back to Table of Contents

This screen allows you to specify options and setting which control Autosend processing for Dial sessions.

Figure 5-1

    

5.3.1. Start Autosend Using: Back to Table of Contents

If you click "OK" and this box is checked then you will start Autosend for the script selected. This check box controls whether Autosend will be active for the session. The default is to not run Autosend.

5.3.2. Autosend List Back to Table of Contents

Every file whose first seventeen letters are "NiwotAutoSendList" and which resides in the same directory from which Gigabyte Express was started is available for selection. Choose one. If a list file has been previously chosen for the current Dial session, it appears as the default choice.

5.3.3. File Handling After Send Back to Table of Contents

These radio buttons control how files are handled after successful transfer. Choose one.

Move Files to _sent folder (creates a new folder and retains sent files there)

Move Files to Recycle/Trash (delete via Recycle Bin if supported)

Delete Files (simple deletion of sent files)

Move To Selected Folder (you may click Browse to define a folder where you would like sent files to be retained)

Leave Folder Structure in Place (leaves folder structure in place, but moves or deletes files as requested)

Send Only Modified Files (checks and clears Archive attribute)

The default is Move Files to _sent folder. If you select this option, Gigabyte Express will, after successfully transferring files from the folder specified in the NiwotAutoSendList ("Niwot_outBasket" in our example), move those files to another folder on the sending computer. That folder will be at the same level as the source folder, and the name will be generated by appending "_sent" to the source folder name. PenName folders may be created within that folder, depending on whether Disable PenName was requested by the sender. These folders are created if necessary.

For example, you use Autosend to transfer a file from "Niwot_outBasket" to a remote computer, your PenName is "faststuff", and Disable PenName was not selected. After successful transfer of the file, Gigabyte Express will move the file on your computer from "Niwot_outBasket" to a folder named "faststuff1" within the "Niwot_outBasket_sent" folder.

If Send Only Modified Files is chosen, only files in the source directory that have the Archive attribute set on will be transferred. After successful transfer of the file, the Archive attribute will be cleared and the file is left in place. You may want to use NMOVE to then clear out the files from the hotfolder .

5.3.4. Poll Folders Every xxx Seconds Back to Table of Contents

The Autosend function will continue to check the specified folders, moving from line to line at the interval specified as "Poll Folders" Next to "Message:" in the 'Dial' window, it will say "Next autosend poll in xx seconds" and the "State:" will say "AUTOSEND". If there are files in the folders, they will be transferred to the destination corresponding to the IP address. When a file is found, the "Message" will flash "FILE OPEN" while the status of the file is being checked.

Default is 30 seconds. Minimum is 1 second.

5.3.5. Examine Files Every yyy Seconds Back to Table of Contents

Specifies how long Autosend will wait between successive file examinations. The default is 30 seconds. Minimum is 1 second.

5.3.6. Restore Defaults Back to Table of Contents

Restores default settings.

5.4. AutoSendList format Back to Table of Contents

[waitspec optional]

[whenspec optional] [GET optional]"source folder-1" "destination folder-1" phonebook-name-1 [NoFolder optional]

[whenspec optional] [GET optional]"source folder-2" "destination folder-2" phonebook-name-2 [NoFolder optional]

:

:

[whenspec optional] [GET optional]"source folder-n" "destination folder-n" phonebook-name-n [NoFolder optional]

END


The source folders and destination folders are enclosed in double-quotes. These can supply a full drive and path specification, or a simple folder name. If a full path is not specified, the folders are treated as relative to the Gigabyte Express folder. Full paths can be entered as:

drive-letter:\path\folder \\computer\share\path\folder \\server\volume\path\folder

Source folders must exist to the folder level (\folder in the examples). Wildcards are supported. The question mark (?) wildcard can be used to represent any single character, and the asterisk (*) wildcard can be used to represent any character or group of characters that might match that position in other filenames.

Destination folders must exist to the path level (\path in the examples). The specified folder, and possibly a Penname folder within it, will be created if necessary at the destination side. The destination string is limited to 60 characters.

The Autosend List must end with "END".

5.4.1. WAIT and WHEN in NiwotAutoSendList Back to Table of Contents

AutoSend now has a WAIT/WHEN feature for the NiwotAutoSendList script.These features are used to schedule the starting of a NiwotAutoSendList script file (the WAIT command) or the sending of files in a specific "hot-folder" (the WHEN command). Both commands have the same format, but each is used in a different way. WAIT is placed at the top of the NiwotAutoSendFile (the first line of script), and is used to schedule when AutoSend can access the "hot-folder" script lines below. The WHEN command is used at the beginning of a "hot-folder" script line,and is used to schedule when files in the specified "hot-folder" can be sent.

Format:
This is StartTime
This is either Duration or EndTime
WAIT hh:mmx yhh:mmx
hh - is hours (24hr time if no x)
mm - is minutes
x - is 'A'(am), 'P'(pm), or not used
Note: If x is not used, hh becomes 24hr time.
y - is either 'd' or 'D'(duration), or not used
Note: If y is not used, the hh:mmx that follows is then considered an EndTime.

Examples:
WAIT 2:00a 6:00p
WHEN 2:01a d0:45 "toCustomerOne" "fromNiwot" "PhoneBookEntry1"
WHEN 3:00 13:45 "toCustomerTwo" "fromNiwot" "PhoneBookEntry2"
WHEN 14:00 d2:00 "toCustomerThree" "fromNiwot" "PhoneBookEntry3"

Explanation of examples:
Line 1 - WAIT until 2:00am to start AutoSend and stop at 6:00pm.
Line 2 - WHEN it is 2:01am, send all items in the "toCustomerOne"
hot-folder to the phonebook entry "PhoneBookEntry1", and place these items into a folder at the destination called "fromNiwot".
Stop sending newly placed items from "toCustomerOne" hot-folder after 45 minutes.
Line 3 - WHEN it is 3:00 (24hr time), send all items in the "toCustomerTwo" hot-folder to the phonebook entry
"PhoneBookEntry2", and place these items into a folder at the destination called "fromNiwot".
Stop sending newly placed items from "toCustomerTwo" hot-folder at 13:45 (24hr time).
Line 4 - WHEN it is 14:00 (24hr time), send all items in the "toCustomerThree" hot-folder to the phonebook entry "PhoneBookEntry3", and place these items into a folder at the destination called "fromNiwot".
Stop sending newly placed items from "toCustomerThree" hot-folder after 2 hours.

NOTE: WHEN commands will not execute if the autosendlist is disabled by a WAIT command.

5.4.2. GET in NiwotAutoSendList (Autoget) Back to Table of Contents

The Autoget feature includes support of an optional "GET" in each line of the AutoSendList and Answer session control of the Handling of files that have been retrieved using Autoget. Each line in the NiwotAutoSendList may have GET after the whenspec(if it exists) and the before the source folder specification. If GET is used, the source folder spec is as it appears to the remote end's Gigabyte Express answer session, and destination folder spec is as it appears to the local Gigabyte Express.

5.4.3. [NoFolder] in NiwotAutoSendList Back to Table of Contents

Each line in the NiwotAutoSendList may have the [NoFolder] option after the Phonebook name. Folders within the source folder will be ignored with this option. See above example, Section 5.4. Only files will be sent, not folders.

5.4.4. [Dwell=<t>] in NiwotAutoSendList Back to Table of Contents

Each line in the NiwotAutoSendList may have the [Dwell=<t>] option after the Phonebook name. The AutoSend Dwell feature is used to keep an established connection up for a user defined amount of time (<t>, in seconds) after the current set of file transfers has completed. The designated hot-folder will be re-examined at the "Examine" interval during the AutoSend Dwell time and new files found will be transmitted. The answer side's Watchdog timer may need to be increased by the AutoSend Dwell time to prevent premature link disconnect.

Example:
"C:\GBX_files\toLondon" "fromUSA" London_Relia1 [Dwell=60]
"C:\GBX_files\toJapan" "fromUSA" Japan_Relia3_crypt [Dwell=120]
"C:\GBX_files\toSeattle" "fromLongmont" Seattle_Relia1_crypt

Causes "C:\GBX_files\toLondon" to be re-examined for a duration of 60 seconds after the current file transfer completion before the link is dropped. "C:\GBX_files\toJapan" will be re-examined for 120 seconds. "C:\GBX_files\toSeattle" will disconnect the link immediately after found files are transmitted and acknowledged.

5.4.5. Source folder Back to Table of Contents

The source folder is enclosed in double-quotes. The contents can be a full drive and path specification, or a simple folder name. If a full path is not specified, the folders are treated as relative to the Gigabyte Express folder. Full paths can be entered as:

drive-letter:\path\folder
\\computer\share\path\folder
\\server\volume\path\folder
Wildcards are supported such as:
drive-letter:\path\folder\*.ZIP
The total number of characters should not exceed 55.
Wildcard behavior will match the behavior of "dir" in your MS-DOS window.
Source folders must exist to the folder level (\folder in the examples).

5.4.6. Destination folder Back to Table of Contents

The destination folder is enclosed in double-quotes. The contents can be a full drive and path specification, or a simple folder name. If a full path is not specified, the folders are treated as relative to the Gigabyte Express folder. Windows full paths can be entered as:

drive-letter:\path\folder
\\computer\share\path\folder
\\server\volume\path\folder

Macintosh full paths are specified as:
volume:folder:folder

These can supply a full drive and path specification, or a simple folder name. If a full path is not specified, the folders are treated as relative to the Gigabyte Express folder.

Destination folders must exist to the path level (\path in the examples). The specified folder, and possibly a Penname folder within it, will be created if necessary at the destination side. The destination string is limited to 55 characters.

5.4.7. Gigabyte Express phonebook name Back to Table of Contents

The Gigabyte Express phonebook name is the same one used in sending files manually. Selection of transport, IP address, and such is controlled by the Gigabyte Express phonebook. If you are using RAS and using Gigabyte Express to dial and hang up RAS then that is also done by way of the Gigabyte Express phonebook.

5.4.8. Options Back to Table of Contents

The only options currently supported are [NoFolder] and [Dwell=<t>].

r customers use [NoFolder] to keep autosend from sending folders found within the source folder and [Dwell=<t>] to keep a connection up longer for possible new files instead of waiting for the next poll time.

NOTE: Both options are case-sensitive

5.4.9. Example Back to Table of Contents

The sample file we include with the installer is NiwotAutoSendList.txt:

"Niwot_outBasket" "from5demo" niwothqWin
"Niwot_out2Basket" "from5demo" niwothqMac
"Niwot_out3Basket" "from5demo" selfTCP
"Niwot_out4Basket" "from5demo" niwothqRED1
"Niwot_out5Basket" "from5demo" selfRED1
END

The first line will cause all files and folders in the folder "Niwot_outBasket" to be sent using the phone book entry with the name "niwothqWin". The files will be placed in a pen name folder in the folder "from5demo" in the GBXWin folder at the destination.

The second line will cause all files and folders in the folder "Niwot_out2Basket" to be sent using the phone book entry "niwothqMac".

The third line will cause all files and folders in the folder "Niwot_out3Basket" to be sent to the same machine using TCP.

The fourth line will cause all files and folders in the folder "Niwot_out4Basket" to be sent to "niwothqRED1" using RELIA.

The fifth line will cause all files and folders in the folder "Niwot_out5Basket" to be sent to the same machine using RELIA.

6. Gigabyte Express Menu Bar Selections Back to Table of Contents

6.1. File Menu Back to Table of Contents

6.1.1. Send Files/Folders (File Menu) Back to Table of Contents

This option is available from the 'Dial' window only. If you haven't yet chosen a PenName, the "PenName" dialog box will pop up.

This screen allows you to select files/folders to be sent to a remote computer. The title bar at the top of the window displays the PhoneBook entry chosen. Available files and folders are displayed and navigated using the left window. The list of selected files and folders is displayed on the right and labeled "Selected Files/Folders". Drives can be selected from a pull-down list. Folders can be opened and closed by double-clicking. When you select a folder, all files and folders within that folder will be transmitted.

Figure 6-1

    

6.1.1.1. Send

Once you have completed your selections, click on this button and it will exit this screen and initiates a connection request.

This will cause Gigabyte Express to connect to the remote Gigabyte Express computer specified by the name and IP address or phone number you have selected in the phone book. The selected file(s) will be transferred to the InBasket chosen by the receiver at the remote site. Unless the sender and receiver both choose to disable the pen name, a folder will be created in the InBasket to contain the file(s) transmitted. This folder is named with the pen name chosen by the sender.

When sending a file, the "State" of the 'Dial' window will read "CONNECTING", "FILE TRANSFER", then back to "IDLE". The name of the file will appear by "Name:" and the size of the file will appear by "Size:". After the transfer has occurred, the file size will also appear by "Byte Count".

When sending a folder, the "State" of the 'Dial' window will read "CONNECTING", "FILE TRANSFER", then back to "IDLE". After the transfer has occurred, the name of the folder will appear by "Name:" and the number of files in that folder will appear by "Size:". The size of that last file will also appear by "Byte Count". GBXWin does not send hidden or system files.

6.1.1.2. Cancel

This button will exit this screen without connection or transfer. You may cancel at any time.

6.1.1.3. Add

This button adds the selected file or folder from the list box to the "Selected Files/Folders" box. Double-clicking a file will also add it.

In order to select a file or folder from the list box, single click on the file or folder name.

6.1.1.4. Select All

This button adds the selected file or folder and all of it's siblings from the list box.

6.1.1.5. Remove

This button removes the selected file or folder from the "Selected Files/Folders:" box. Double-clicking a file or folder will also remove it.

In order to select a file or folder from the list box, single click on the file or folder name.

6.1.1.6. Remove All

This button clears all files and folders from the "Selected Files/Folders:" box.

6.1.1.7. Phonebook (See Section 6.2.3)

If you are making your selections and realize you need to send the files to a different site, just click the 'PhoneBook' button. This invokes the Edit PhoneBook screen which will allow you to select a new IP address or phone number to dial.

6.1.2. Get Files / Folders (File Menu) Back to Table of Contents

This command is available from Dial sessions only. Use this command to retrieve files from a remote workstation. If you haven't yet chosen a PenName, the PenName dialog box will pop up.

Shortcuts

Toolbar:
Keys: CTRL+G

This screen allows you to select files/folders to be sent to a remote computer. The title bar at the top of the window displays the PhoneBook entry chosen. Available files and folders are displayed and navigated using the left window. The list of selected files and folders is displayed on the right and labeled "Selected Files/Folders". Drives can be selected from a pull-down list. Folders can be opened and closed by double-clicking. When you select a folder, all files and folders within that folder will be transmitted.

There are two available outbaskets. The default Out Basket "Niwot_outBasket", with public files in it. The other basket you may choose has the same name as your PenName . This folder is considered your private folder and only people with that specific PenName can view this folder. On the remote side, this folder has to be in the same folder as Gigabyte Express and must be spelled the same as the PenName in order to work. If a PenName folder does not exist on the remote side, the person doing the Get will just see the OutBasket folder.

Figure 6-2

    

6.1.2.1. Get

Once you have completed your selections, click on this button and it will exit this screen and initiates a connection request.

This will cause Gigabyte Express to transfer the files you selected from the remote site to you. Files will be transferred to the InBasket associated with the 'Dial' window. A folder will be created in the InBasket to contain the files and folders received. This folder is named using the PenName chosen by the remote site. If the remote user hasn't yet chosen a PenName, the folder name will be "NNx" where "x" is a number starting at "1" that will increment as you get files from remote computers with no pen name. The default InBasket is "Niwot_inBasket" in the same folder as Gigabyte Express. To change the InBasket, see the File menu selection "Select InBasket", Section 6.1.3.

"State" of the 'Dial' window will read "CONNECTING", "FILE TRANSFER", then "IDLE". The name of the file will appear by "Name:" and the size of the file will appear by "Size". Afterf the transfer has occurred, the file size will also appear by "Byte Count".

6.1.2.2. Cancel

This button will exit this screen without connection or transfer. You may cancel at any time.

6.1.2.3. Add

This button adds the selected file or folder from the list box to the "Selected Files/Folders" box. Double-clicking a file will also add it.

In order to select a file or folder from the list box, single click on the file or folder name.

6.1.2.4. Select All

This button adds the selected file or folder and all of its siblings from the list box.

6.1.2.5. Remove

This button removes the selected file or folder from the "Selected Files/Folders:" box. Double-clicking a file or folder will also remove it.

In order to select a file or folder from the list box, single click on the file or folder name.

6.1.2.6. Remove All

This button clears all files and folders from the "Selected Files/Folders:" box.

6.1.2.7. Phonebook (See Section 6.2.3)

If you are making your selections and realize you need to send the files to a different site, just click the 'PhoneBook' button. This invokes the Edit PhoneBook screen which will allow you to select a new IP address or phone number to dial.

6.1.3. Select InBasket (File Menu) Back to Table of Contents

This option is available separately from both the 'Answer' and 'Dial' windows and allows you to choose the folder into which files are transferred from a remote user. Click in the 'Answer' or 'Dial' window so that its title bar is blue. Then you may choose the option to Select InBasket for that window. The default InBasket for all sessions is "Niwot_inBasket" in the same folder as Gigabyte Express. The InBasket selected from the 'Answer' window does not have to be the same as that selected from the 'Dial' window. All Answer windows share a common InBasket. Different InBaskets may be selected for each Dial session if desired.

A list box will pop up requesting that you select a folder. You may cancel at any time. If you double click on a folder, this will open the folder and select it as your InBasket. The folder to be used as your InBasket is displayed in the text above the selection box. Example is given in figure 6-3.

Figure 6-3

    

6.1.4. Select OutBasket (File Menu) Back to Table of Contents

This option is available from the 'Answer' window only. Click in the 'Answer' window so that its title bar is blue. Then choose the Select OutBasket option. This allows you to choose what folder a remote user can access to get files. The OutBasket does not need to be in the Gigabyte Express folder. Some users have their OutBasket on their server. The default OutBasket is "Niwot_outBasket" in the same folder as Gigabyte Express. The remote user will also be able to get files/folders from an OutBasket which matches their PenName. PenName OutBaskets must be in the same folder as Gigabyte Express.

A list box will pop up requesting that you select a folder. If you double click on a folder, this will open the folder and select it as your OutBasket. The folder to be used as your OutBasket is displayed in the text above the selection box.

6.1.5. Show Selections (File Menu) Back to Table of Contents

    

This option allows you to display the InBasket, OutBasket, and 'Gbxacct.log' folder selections for either the 'Answer' or 'Dial' window, whichever is selected at the time. The selected window will have a blue title bar. Click on the "OK" button when you are done viewing your selections.

An alert window may pop up if the selection of the InBasket or OutBasket is no longer valid.

6.1.6. Select Gbxacct.log Folder (File Menu) (See Section 6.2.4.1.9) Back to Table of Contents

This allows you to select the destination folder for your Gbxacct.log.

6.1.7. Quit (File Menu) Back to Table of Contents

Use this option to close the 'Dial' and 'Answer' windows and exit Gigabyte Express. You may also quit by using ALT+F4.

6.2. Edit Menu Back to Table of Contents

6.2.1. Serial Number / Validation Code (Edit Menu) Back to Table of Contents

    

Use this command to view or change your Serial Number and/or Validation Code as needed. Gigabyte Express will not execute without a valid Serial Number and Validation Code. Also shown in Figure 4-1, Section 4.1 of this manual.

Demo serial numbers are: niwotdemo1, niwotdemo2, and niwotdemo3. NOTE: The Validation Code should be blank in DEMO mode.

6.2.2. PenName (Edit Menu) Back to Table of Contents

The PenName is used to name the folder on the receiving computer which will contain the files and folders you have sent. For example, let’s use the PenName "Jack". The first batch of files/folders you send will be placed in the folder "Jack1". The second batch of files/folders you send will be placed in the folder "Jack2", and so forth. The PenName number will increment unless you delete a pen name folder, then it will replace the deleted folder so the numbers remain consecutive.

Type in the PenName you would like to use, then click on the "OK" button.

Figure 6-5

    

6.2.3. PhoneBook (Edit Menu) Back to Table of Contents

This command is used to select a PhoneBook entry for the current 'Dial' session. It is also the starting point for defining and maintaining the PhoneBook itself.

The entry name selected for each Dial session is displayed in the title bar.

The main list box shows all entries that are currently defined. The entry used by the current Dial session will appear highlighted. Doubleclicking on an entry name will invoke Modify.

Figure 6-6

    

6.2.3.1. Select

This button selects the highlighted entry as the one to be used by the current dial session.

6.2.3.2. Cancel

This button ends the dialog without changing the selection for the current Dial session. This does NOT undo changes you may have made to the PhoneBook entries.

6.2.3.3. Delete

This button removes the highlighted entry from the PhoneBook.

6.2.3.4. New

This button takes you to the Edit PhoneBook Entry dialog which allows you to create a new entry.

6.2.3.5. Modify

This button takes you to the Edit PhoneBook Entry dialog which allows you to update the highlighted entry.

6.2.3.6. Edit PhoneBook Entry

This dialog is used to create or modify a PhoneBook entry. PhoneBook entries are used by Dial sessions to communicate with a remote workstation.

If you are modifying an existing entry, and you make a change to the entry name field, you will be asked whether you want to replace the original entry or create a new one.

6.2.3.6.1 PhoneBook Entry

This is the name under which the entry definition is stored. All currently defined entry names will appear in the Select PhoneBook Entry window.

6.2.3.6.2 Transport Type

This field specifies which transport type will be used for the entry.

Specify RELIA to use RELIA(tm) Technology

Specify TCP/IP to use TCP/IP

The fields that define an entry are described below.

Figure 6-7

    

6.2.3.6.3 Remote Address

This field specifies the IP address of the remote workstation with which a Dial session will communicate. The IP address can be entered as a host name (e.g., win.gigabytex.com) or as a "dotted" IP address (e.g., 64.32.164.216).

6.2.3.6.4 Local Address

This field specifies the local IP address used during communication. When the remote IP address is entered or changed, GBXWin will automatically select the closest match from the pull-down list. A local address of 0.0.0.0 is recommended if you are on a machine where your IP address changes, this may happen if you are using DHCP or a dial-up connection. You can select another entry, or enter a value manually; be sure to use one appropriate for the remote IP address. You may enter 127.0.0.1 in both the local and remote IP addresses to test on a single machine. In this case the answer session should be set to answer on 0.0.0.0.

6.2.3.6.5 Username and Password

If you are using encryption , this username and password must match the username and password allowed on the machine to which you are connecting.

6.2.3.6.6 Disable PenName

This check box indicates whether the current PenName should be used to create a folder when sending files to a remote Gigabyte Express workstation. NOTE: the remote Answer session must have the "Allow PenName Disabling" option specified in order for this Dial session to disable PenName processing.

6.2.3.6.7 Disable Compression

This check box allows you to turn off compression when using this phonebook entry. The default is to not disable compression.

6.2.3.6.8 Advanced

6.2.3.6.8.1 Target Link Rate Kbits

A "0"(TCP/IP default) allows connections using this phonebook entry to go as fast as they can. A "768"(RELIA default) allows connections using this phonebook entry to use 768 kilobits of link rate.

If a non-zero number is specified then the connection will be throttled or governed to not exceed the specified number of kilobits per second. This link rate governor feature allows you to put an upper limit on the amount of bandwidth Gigabyte Express consumes. Specify amount of link bandwidth this PhoneBook entry may use.(0 is not recommended in RELIA technology)

6.2.3.6.8.2 Remote Port

Windows TCP/IP default port is 167.
Mac OS X/Linux TCP/IP default port is 32779.
Windows RELIA(tm) Technology default port is 168.
Mac OS X/Linux RELIA(tm) Technology default port is 32778.

6.2.3.6.8.3 RELIA Redundancy

RED1 is default, can recover without retransmission from single lost packets. Use this for optimum throughput on satellite and international IP connections experiencing low congestion. (the sending side RED2 is reporting less than 1 chunk resent per 1000 chunks sent).

RED2 can recover without retransmission from pairs of lost packets. This is a robust level, capable of recovering from most cases of satellite and international congestion.

RED4 can recover without retransmission from groups of 4 lost packets. Use this when the sending side at RED 2 is reporting more than 4 chunks resent per 1000 chunks sent. This is not recommended for use on the Internet.

RED8 can recover without retransmission from groups of 8 lost packets. Use this when the sending side at RED4 is reporting more than 4 chunks resent per 1000 chunks sent. This is not recommended for use on the Internet.

6.2.4. Options (Edit Menu) Back to Table of Contents

This command allows you to select or modify options that affect Gigabyte Express operations. Some are common to Dial and Answer Windows, while others are only applicable to Windows of a given type. You may navigate among the available option sheets as needed. Press "OK" when you have finished, or press "Cancel" to exit without saving any changes. The following sections provide details about the Gigabyte Express options.

Figure 6-8

    

6.2.4.1. GBXpress Options

This screen allows you to specify some common options and setting used by Gigabyte Express sessions. Click on the boxes to enable (checked) or disable (cleared) the options. The following items are available:

6.2.4.1.1. Beep on File Transfer Completion (Edit -> Options)

This option is available from both the Dial and Answer Windows. Click on the box to place a checkmark in the box to select this option. The default is to not beep on file transfer completion.

6.2.4.1.2. Allow PenName Disabling (Edit -> Options) Answer

This option is available from the Answer Window. The default is to not allow Pen Name disabling.

Click on the box to place a checkmark in the box to select this option. If you select this option, and if the sender has chosen to disable the PenName, files and folders will be placed directly in your InBasket without a PenName. Both the sender and receiver must request the no pen name in their respective ways for this to occur. CAUTION: With this option, over-writing of a duplicate file can occur.

If the Sender does not disable the PenName, or if the Receiver does not choose the "Allow PenName Disabling" option, all incoming files will be put into correct PenName folders.

6.2.4.1.3. Allow Autosend Pathing (Edit -> Options) Answer

This option applies to all Answer sessions. The default is to not allow Autosend Pathing.

If this option is checked, and a remote sender is running Autosend with destination folders specified, files and folders are placed into the specifed destination if it can be found. If it cannot be found the actual destination is reported in the gbxwin.log file.

6.2.4.1.4. Disable Encryption (Edit -> Options) Answer

This option applies to all Answer sessions. The default is to support encryption. If this "Disable Encryption" option is checked, Dial sessions requiring encryption will not be able to connect to this Gigabyte Express machine.

6.2.4.1.5. Support Encryption (Edit -> Options) Answer

This option applies to all Answer sessions. The default is to support encryption. If this option is checked, Dial sessions requiring or using encryption will be able to connect to this Gigabyte Express machine. (assuming their username and password match an authorized username and password) and use encryption. Dial sessions with encryption disabled or dial sessions from versions of Gigabyte Express not supporting encryption will still be able to connect.

6.2.4.1.6. Require Encryption (Edit -> Options) Answer

This option applies to all Answer sessions. The default is to support encryption. If this "Require Encryption" option is checked, Dial sessions requiring encryption will be able to connect to this Gigabyte Express machine. Dial sessions using encryption will connect (assuming their username and password match an authorized username and password) and use encryption. Dial sessions with encryption disabled or dial sessions from versions of Gigabyte Express not supporting encryption will not be able to connect.

6.2.4.1.7. Read After Write Integrity Check (Edit -> Options) Dial

Enabling this option adds an extra read after write longitudinal redundancy file integrity check at the destination. This option is only available from 'Dial' sessions. The default is to not perform the check.

6.2.4.1.8. Use Log File (Edit -> Options)

Click on the box to place a checkmark in the box to select this option. When you choose the log file option, Gigabyte Express will create a log file in the same folder where Gigabyte Express resides. The log file will be named "GBXWin.log". Gigabyte Express operations from ALL sessions will be logged here. When the file is approximately 5 megabytes, it is copied to GBXWin1.log (after GBXWin1.log is copied to GBXWin2.log)

Leave the box empty if you do not wish to use a log file. No log file will be created. The Gigabyte Express default is to use a log file.

6.2.4.1.9. Generate 'Gbxacct.log' Log file (Edit -> Options)

Click on the box to place a checkmark in the box to select this option. When you choose to generate a Gbxacct.log, it contains one line for every file successfully transferred. The file is organized to allow importing by spreadsheet programs to capture file transfer information for billing purposes. When the file is approximately 5 megabytes, it is copied to Gbxacct1.log (after Gbxacct1.log is copied to Gbxacct2.log) While the default folder into which the file is written is the Gigabyte Express start-up folder, a different destination may be selected with the File -> Select Gbxacct.log Folder.

Each line has the format:

Date>StartTime>FinishTime>Session ID>FileName>Size>OtherSide ID

The Session ID gives the session number and the direction of the transfer. A Dial session may receive "R"(Get) or send "S". An Answer session may receive "R" or send "S"(in response to a Get))

The OtherSide for an Answer Session has the format "PenName: xxxx" where xxxx is the Other side's PenName. For a Dial session, the OtherSide has the format "PhoneBook: xxxx" where xxxx is the name of the PhoneBook entry.

Leave the box empty if you do not wish to use a Gbxacct.log file. The Gigabyte Express default is to not generate a Gbxacct.log file.

6.2.4.1.10. Restore Defaults

Click on the "Restore Defaults" button to restore defaults.

The defaults for Dial Sessions are:
    Do not Beep on File Transfer Completion
    Do not Perform Read After Write Integrity Check
    Use Log File

The defaults for Answer Sessions are:
    Do not Beep on File Transfer Completion
    Do not Allow PenName Disabling
    Use Log File

6.2.4.2.Autosend Options

These options are available for Dial Windows only and are covered in the "Autosend Options" Section 5.3.

6.2.4.3. Answer Options

This tab is used to specify the transport and local address for the current answer session. This tab is only accesible when an answer session is highlighted.

If you select OK and the answer session is either idle or listening, the session will be restarted with new settings.

Figure 6-9

    

6.2.4.3.1. Transport, RELIA™ Technology Answer

Within the Answer session, you may select either the Winsock TCP/IP Transport (default port 167 for Windows, default port 32779 for Mac OS X/Linux) or the RELIA(tm) Transport (default port 168 for Windows, default port 32778 for Mac OS X/Linux).

6.2.4.3.2. Local IP Address

This field specifies the local address used during communication. You can select an entry from the pull-down list, or enter a value manually. A special value of 0.0.0.0 allows you to listen on all available addresses.

6.2.4.3.3. Port Number

This field specifies the port number on which the answer session will listen for its initial call.

Windows TCP/IP default port is 167.
Mac OS X/Linux TCP/IP default port is 32779.
Windows RELIA(tm) Technology default port is 168.
Mac OS X/Linux RELIA(tm) Technology default port is 32778.

The usage of ports is described in the Firewall Note.

6.2.4.4 Autoget Handling (Edit Menu) Back to Table of Contents

    

Autoget Handling is available from Answer Windows only.

These radio buttons control how files are handled after successful transfer. Choose one.

Move Files to _sent folder (the default behavior, creates a new folder and retains sent files there)

Move Files to Recycle/Trash (delete via Recycle Bin if supported)

Delete Files (simple deletion of sent files)

Move To Selected Folder (you may browse to choose where to put the files that have been retrieved by Autoget)

Leave Folder Structure in Place (leaves folder structure in place, but moves or deletes files as requested)

Send Only Modified Files (checks and clears Archive attribute)

6.2.5. Watchdog (Edit Menu) Back to Table of Contents

The WatchDog timer is used to monitor file transfer action between connected computers. If there is no file transfer action within the set WatchDog time, the link between computers will be terminated. The default WatchDog time is 3 minutes.

Type in the WatchDog time you would like in minutes, then click on the "OK" button. Zero indicates unlimited time. With zero, the link may stay up indefinitely creating high long distance bills.

Figure 6-10

    

6.2.6. Transport (Edit Menu) Back to Table of Contents

This option is available from the Answer window only. This gives you the same screen as Edit -> Options -> Answer Options. See Section 6.2.4.3.

6.2.7. Users (Edit Menu) Back to Table of Contents

    

    

When requiring encryption, these users are the only ones allowed to connect.

6.3. Session Menu Back to Table of Contents

6.3.1. Start (Session menu) Back to Table of Contents

If the State of the 'Answer' window is "IDLE, WON'T ANSWER", use this option to change the State to "WAITING FOR CALL", thereby readying it to receive files or to answer a call to get files.

This command is not available from the 'Dial' window.

6.3.2. Stop (Session menu) Back to Table of Contents

For a 'Dial' window this will stop a connection and hang up; the State will then read "IDLE". For an 'Answer' window this will stop a connection and hang up and/or stop listening for calls; the State will then read "IDLE, WON'T ANSWER".

6.3.3. New Answer (Session menu) Back to Table of Contents

Use this command to initiate a new Answer session. This can be used when you want to handle multiple incoming requests simultaneously. Depending on your Serial Number and Validation Code, Gigabyte Express will support from 1 to 32 Answer sessions.

6.3.4. New Dial (Session menu) Back to Table of Contents

Use this command to initiate a new Dial session. This may be helpful for situations where you store different dial sessions with different dial numbers or IP addresses, or if the Dial sessions are running different autosend scripts. Depending on your Serial Number and Validation Code, Gigabyte Express will support from 1 to 32 Dial sessions.

When you choose this option, a message will pop up that reads "No Dial String is Specified". Click "OK", and the PhoneBook will appear.

6.3.5. Delete (Session menu) Back to Table of Contents

Use this command to delete the active dial or answer session. You can also delete by clicking on the "X" at the far right section of the title bar.

6.4. View Menu Back to Table of Contents

6.4.1. Toolbar (View menu) Back to Table of Contents

Figure 6-11

    

Use this command to display and hide the Toolbar, which includes buttons for some of the most common commands in GBXWin. A check mark appears next to the menu item when the Toolbar is displayed.

The toolbar is displayed across the top of the application window, below the menu bar. The toolbar provides quick mouse access to commands used in GBXWin,

To hide or display the Toolbar, choose Toolbar from the View menu (ALT+V, T). The following commands are available from the toolbar:

Send Files/Folders to a remote workstation.
Get Files/Folders from a remote workstation.

6.4.2. Status Bar (View menu) Back to Table of Contents

Figure 6-12

    

A check mark appears next to Status Bar when it is displayed. The status bar is displayed at the bottom of the GBXWin window. The left area of the status bar describes actions of menu items or descriptions of toolbar items. This area similarly shows messages that describe the actions of toolbar buttons as you depress them, before releasing them. If after viewing the description of the toolbar button command you wish not to execute the command, then release the mouse button while the pointer is off the toolbar button.The right area of the status bar displays CAP, NUM, and SCRL if Caps Lock, Num Lock, or Scroll Lock (respectively) are on.

6.4.3. Log Window (View menu) Back to Table of Contents

Use this command to display and hide the Log Window. The Log Window displays what is being written to the GBXWin.log file. The log file is opened when the Log Window is being displayed, even if the the logging option is not enabled.

The display is limited to 2000 lines in order to reduce the log window's memory consumption.

6.4.3. Tile (View menu) Back to Table of Contents

Use this command to arrange Dial sessions, Answer sessions, and the Log Window within the main window in an orderly fashion. Dial and Answer sessions will be placed in columns in the top 3/4 of the main window, and the Log Window will be displayed across the entire width of the bottom 1/4 of the main window.


7. Alphabetic list of configuration entries:

ENTRY (case sensitive)   DEFAULT  
ALLOWASPATHING=  Default is 0 (Answer session Global) 
ANSWERENCRYPTION=  Default is 1, (Answer session Global) 
ANSWSECOND=  Default is 32780 (Answer/Dial session Global) 
AUTOEXAMTICK=  Default is 30 seconds (Dial session Global) 
AUTOGETSENTHANDLING=  Default is USESENT (Answer session Global) 
AUTOGETLEAVEFOLDERS=0  Default is 0 (Answer session Global) 
AUTOGETMOVESELECTEDPATH=  Default is blank (Answer session Global) 
AUTOGETNOIDLEMESSAGES=  Default is 0 (Answer/Dial session Global) 
AUTOLISTXXX=  Default is NiwotAutoSendList.txt (Dial session Specific) 
AUTOSENDMOVESELECTEDPATHXXX=  Default is blank (Dial session Specific) 
AUTOSENDTICK=  Default is 30 seconds (Dial session Global) 
DISPENNAME=  Default is 0 (Answer session Global) 
INBASKET=  Default is blank (Answer session Global) 
LEAVEFOLDERSXXX=  Default is 0 (Dial session Specific) 
LOGACCT=  Default is 0 (Answer/Dial session Global) 
LOGACCTFOLDER=  Default is blank (Answer/Dial session Global) 
LOGFILE=  Default is 1 (Answer/Dial session Global) 
LRCVERIFY=  Default is 0 (Dial session Global) 
MACSUPPORT=  Default is 0 (Answer/Dial session Global) 
OUTBASKET=  Default is blank (Answer session Global) 
PENNAME=  Default is niwot1demo (Answer/Dial session Global) 
SENTHANDLINGXXX=  Default is USESENT (Dial session Specific) 
SERIALNUM=  Default niwotdemo1 expires. (Answer/Dial session Global) 
SORTTYPE=  Default is 1. (Answer/Dial session Global) 
VALIDATIONCODE=  Default is blank (Answer/Dial session Global) 
WATCHDOG=  Default is 3 minutes (Answer/Dial session Global) 

• ANSWERENCRYPTION -- Encryption setting (Answer session Global)
This setting in GBXWIN7.INI applies to all Answer sessions, and is normally managed via the Graphical User Interface here. The default of ANSWERENCRYPTION=1 is to support encryption. If this setting is ANSWERENCRYPTION=0, meaning "Disable Encryption", then Dial sessions requiring encryption will not be able to connect to this Gigabyte Express machine.

If this setting is ANSWERENCRYPTION=1, meaning, "Support Encryption", Dial sessions requiring or using encryption will be able to connect to this Gigabyte Express machine (assuming their username and password match an authorized username and password) and use encryption. Dial sessions with encryption disabled or dial sessions from versions of Gigabyte Express not supporting encryption will still be able to connect.

If this setting is ANSWERENCRYPTION=2, meaning "Require Encryption", Dial sessions requiring encryption will be able to connect to this Gigabyte Express machine. Dial sessions using encryption will connect (assuming their username and password match an authorized username and password) and use encryption. Dial sessions with encryption disabled or dial sessions from versions of Gigabyte Express not supporting encryption will not be able to connect.

• ANSWSECOND -- The Answer session Data Transfer Port (Answer session Specific)
Defined in GBXWIN7.INI, the default Answer session Data Transfer Port setting is ANSWSECOND=32780, so Answer session #1 will use port 32780, Answer session #2 will use 32781, and so on. User may specify the secondary port numbers by modifying this value. A value of 0 or deleting this parameter will cause the ephemeral ports to be used. Please see the Firewall Notes here for an in-depth explanation of port usage.

• AUTOEXAMTICK -- Poll Folders Every xxx Seconds (Dial session Global)
This setting in GBXWIN7.INI file applies to all Dial sessions, and is normally managed via the Graphical User Interface here. The Autosend function will continue to check the specified folders, moving from line to line at the interval specified in seconds. If there are files in the folders, they will be transferred to the destination corresponding to the IP address. The default setting is AUTOEXAMTICK=30 (seconds). Minimum is 1 second.

• AUTOGETSENTHANDLING -- Handling of Files After Autoget (Answer session Global)
This setting in GBXWIN7.INI allows you to define the manner in which files sent via incoming Autoget are handled for all Answer sessions. AUTOGETSENTHANDLING is normally managed via the Graphical User Interface here. Currently the options for this setting are:
USESENT    Move files to an "_sent" folder after incoming Autoget (default behavior)
RECYCLE/TRASH    Move Files to Recycle/Trash after incoming Autoget
DELETE    Delete files after incoming Autoget
MOVESELECTED    Move files to AUTOGETMOVESELECTEDPATH (see below) after incoming Autoget

• AUTOGETLEAVEFOLDERS -- Leave Folder Structure in Place (Answer session Global)
This setting in GBXWIN7.INI is normally managed via the Graphical User Interface here, and allows folder structures to remain in place after files sent via incoming Autoget have been moved or deleted, for all Answer sessions:
0    Delete folder structure after sending files (default behavior)
1    Do not delete folder structure

• AUTOGETMOVESELECTEDPATH -- Files Moved Here After Autoget (Answer session Global)
This setting in GBXWIN7.INI is normally managed via the Graphical User Interface here, and allows you to choose the folder into which files are transferred after incoming Autoget, if AUTOGETSENTHANDLING=MOVESELECTED (see above). Example: "AUTOGETMOVESELECTEDPATH=C:\SentFiles\autoget" ... for all Answer sessions, this would move all files sent via incoming Autoget to "C:\SentFiles\autoget".

• AUTOGETNOIDLEMESSAGES -- No Idle Messages from Autoget written to Logfile (Answer/Dial session Global)
This setting in GBXWIN7.INI may be set to:

AUTOGETNOIDLEMESSAGES=0 (zero)  Gigabyte Express Autoget will write Idle Messages to logfile.
AUTOGETNOIDLEMESSAGES=1  Gigabyte Express Autoget will write NO Idle Messages to logfile.

By using this setting, as Gigabyte Express Autoget queries a remote system for files to receive (or is being queried by a remote system for files to send), the log files are not filled up with "idle" messages when there are no files to receive or send.

• AUTOLISTXXX -- The Autosend List file (Dial session Specific)
This setting in GBXWIN7.INI is normally managed via the Graphical User Interface here, and allows you to define the Autosend List file for a specific numbered Dial session. Filenames for the list files begin with "NiwotAutoSendList". For example, with Dial session #1 you could define AUTOLIST1=NiwotAutoSendList1.txt and with Dial session #2 you could define AUTOLIST2=NiwotAutoSendList2.txt

• AUTOSENDMOVESELECTEDPATHXXX -- Files Moved Here After Autosend (Dial session Specific)
This setting in GBXWIN7.INI is normally managed via the Graphical User Interface here, and allows you to choose the folder into which files are transferred after Autosend, if SENTHANDLINGXXX=MOVESELECTED. Example: "AUTOSENDMOVESELECTEDPATH1=C:\SentFiles\autosend" ... for Dial session #1 only, this would move all files sent via Autosend to "C:\SentFiles\autosend".

• AUTOSENDTICK -- Examine Files Every yyy Seconds (Dial session Global)
This setting in GBXWIN7.INI is normally managed via the Graphical User Interface here. AUTOSENDTICK specifies how long Autosend will wait between successive file examinations. The default is AUTOSENDTICK=30 (seconds). Minimum is 1 second.

• LEAVEFOLDERSXXX -- Leave Folder Structure in Place (Dial session Specific)
This setting in GBXWIN7.INI is normally managed via the Graphical User Interface here, and allows folder structures to remain in place after the Sent files have been moved or deleted, for a specific numbered Dial session:
0    Delete folder structure after sending files (default behavior)
1    Do not delete folder structure
For example, with Dial session #1 you could define LEAVEFOLDERS1=0 and with Dial session #2 you could define LEAVEFOLDERS2=1

• LOGACCT -- The Gbxacct.log Accounting Log File
This setting is defined in the GBXWIN7.INI file. The default is LOGACCT=0 to not write the Gbxacct.log Accounting Log File. This file maintains a record of the files transferred for accounting purposes. Enable the writing of this file by using LOGACCT=1 for this setting.
Click here to see the Graphical User Interface for configuring the Gbxacct.log Accounting Log File.
Click here to see the complete explanation of the Gbxacct.log Accounting Log File.

• LOGACCTFOLDER -- Folder to write Accounting Log File
This setting is defined in the GBXWIN7.INI file, and is normally managed via the Graphical User Interface here. The default is to leave this field blank. If the setting LOGACCT=1 is defined, the Gbxacct.log Accounting Log File will be written to the folder where Gigabyte Express is installed. If the LOGACCTFOLDER setting is also defined it will be used, i.e. LOGACCTFOLDER=C:\Test then the Accounting Log File will be written to C:\Test\Gbxacct.log

• LOGFILE -- The GBXWin.log Log File
This setting is defined in the GBXWIN7.INI file, and is normally managed via the Graphical User Interface here. The default setting of LOGFILE=1 is recommended so that a record is kept of the operation of the program, start-up, sending/receiving files, etc. This file will always be written to the folder where Gigabyte Express is installed. Gigabyte Express operations from ALL sessions will be logged here. When the file is approximately 5 megabytes, it is copied to GBXWin1.log (after GBXWin1.log is copied to GBXWin2.log). If desired you may disable writing of the Log File with LOGFILE=0

• LRCVERIFY -- Read After Write Integrity Check (Dial session Global)
This setting is defined in the GBXWIN7.INI file, and is normally managed via the Graphical User Interface here. Enabling this with LRCVERIFY=1 adds an extra read after write longitudinal redundancy file integrity check at the destination. The default setting LRCVERIFY=0 will not perform the check.

• PENNAME -- The PenName
This setting is defined in the GBXWIN7.INI file, and is normally managed via the Graphical User Interface here. The PenName is used to name the folder on the receiving computer which will contain the files and folders you have sent. For example, let’s use the setting PENNAME=Jack ... The first batch of files/folders you send will be placed in the folder "Jack1". The second batch of files/folders you send will be placed in the folder "Jack2", and so forth. The PenName number will increment unless you delete a pen name folder, then it will replace the deleted folder so the numbers remain consecutive.

• SENTHANDLINGXXX -- Handling of Files After Autosend (Dial session Specific)
This setting in GBXWIN7.INI is normally managed via the Graphical User Interface here, and allows you to define the manner in which Sent Files are handled for a specific numbered Dial session. Currently the options for this setting are:
USESENT    Move files to an "_sent" folder after send (default behavior)
RECYCLE/TRASH    Move files to Recycle/Trash after send
DELETE    Delete files after send
MOVESELECTED    Move files to AUTOSENDMOVESELECTEDPATHXXX (see above) after send
For example, with Dial session #1 you could define SENTHANDLING1=USESENT and with Dial session #2 you could define SENTHANDLING2=DELETE
Click here for examples of Sent File Handling in the larger context of Autosend.

• SERIALNUM -- The Serial Number
This setting in GBXWIN7.INI is where you may view or change your Serial Number, and is normally managed via the Graphical User Interface here. Gigabyte Express will not execute without a valid Serial Number and Validation Code.
Demo serial numbers are: SERIALNUM=niwotdemo1 or SERIALNUM=niwotdemo2 or SERIALNUM=niwotdemo3

• SORTTYPE -- The File Sorting algorithm used (Answer/Dial session Global)
If SORTTYPE=1 or if SORTTYPE is not found in the GBXWIN7.INI file then oldest files will be sent first. If SORTTYPE=0 then files will be sent in the order they are found.

• VALIDATIONCODE -- The Validation Code
This setting in GBXWIN7.INI is normally managed via the Graphical User Interface here. The Validation Code goes hand-in-hand with your licensed Serial Number for Gigabyte Express. Gigabyte Express will not execute without a valid Serial Number and Validation Code. NOTE: The Validation Code should be blank in DEMO mode.

• WATCHDOG -- The Watchdog Timeout, in minutes
This setting in GBXWIN7.INI is normally managed via the Graphical User Interface here. The WatchDog timer is used to monitor file transfer action between connected computers. If there is no file transfer action within the set WatchDog time, the link between computers will be terminated. The default WatchDog time setting is WATCHDOG=3 (minutes). Setting WATCHDOG=0 (zero) indicates unlimited time. CAUTION: With WATCHDOG=0, the link may stay up indefinitely creating high long distance bills.

8. ERRORS Back to Table of Contents

8.1. Error Messages Reported by GBXWin Back to Table of Contents

The error code can be either a general system or Winsock error code.

Autosend Folder Does Not Exist
Auto-Send not supported by remote
Bad connection state=
Bad file send list format
Command confirm failed with
Connect confirm send failed with
connect request failed with
Connect request fail code =
Connect retry in x secs
Compress Block Error =
Compressor Initialize error =
Connection error waiting for ack
Connection request timed out
Decompress Block Error =
Decompressor Initialize error =
Disconnect confirm failed with
Disconnect listen failed with
Disconnect request failed with
Disk file write error =
Duplicate Serial# detected
Error Creating File (RC=)
Error Creating File on Remote
File command not sent in entirety
File command send failed
File confirm failed with
File Not Found
File Open, Not Sent
File Open Failure =
File read error: OS error:
Get File not supported by remote
Get Folder not supported by remote
Incoming connect request failed with
Incoming connection request timed out
init command read error:
Link has failed unexpectedly!
Link Watchdog has expired
Listen failed with
Local Hard Drive Full
No Dial String is Specified
No File Opened on Remote
No Filename chosen
No valid wait time defined in auto-send file
Non-printable character detected in list file
Not enough receive side disk space
Read After Write Fail, Terminating connection
Read data failed with
Receive Side Setup Err = cmdRes
Received data larger than expected
Received data length greater than expected
Sorry, Autosending on Remote
System Error
Transfer File Not Selected
writeNet failed with
8.2. GBXWin Transport Layer Messages Back to Table of Contents

The error code will be a Winsock error code.

closesocket failed: [error code]
Connect: socket failed: [error code]
Connect: setsockopt(