.; Transmitting files between computers
.P %
.H ~
.R _
.B
.U +
                  _~ Transmitting Files Between Computers ~_



The ~FSEND~ command is used to transfer data for use with the ~FRCV~ command.
FSEND has two command formats as follows:

                         ) ~fsend =filespec~
                         ) ~fsend terminal=filespec~

The first format is used to transfer a file from the remote system to ~your~
local computer.

The second format is used to send a file from your local computer to a ~remote~
system.  The terminal to be used for the transfer is defined by ~terminal~.  
It must be attached to a job on the remote system and not on your local 
system.

In both formats, ~filespec~ is the file specification of the file(s) to 
transfer between the systems.  Full d/os wildcarding may be used.  See the
WILD help file for additional information on using the d/os wildcarder.

.page 11
In the following examples it is assumed that ~MODEM~ is a terminal defined on 
the system and the physical link has been established between the two systems.

~Example of sending a file from a remote to a local computer:~

                ) ~remote modem~
                d/os Remote communications
                Escape character is: `
                Begin remote communications
                ) ~fsend =myfile.dat~
                FSEND - d/os File Send Utility - Version x.x(y)

                ~`~        <--- enter escape character
                ) ~frcv =modem~
                ((( transmission takes place )))

The remote system is considered to be the system where you do not use a 
terminal definition in either the FSEND or FRCV commands.

.page 11
~Example of sending a file to a remote system:~

                ) ~remote modem~
                d/os Remote communications
                Escape character is: `
                Begin remote communications
                ) ~frcv~
                FRCV - d/os File Receive Utility - Version x.x(y)

                ~`~      <--- enter escape character
                ) ~fsend modem=letter.txt~
                ((( transmission takes place )))

The remote system may reject the files sent to it for a variety of reasons.  
For example, if you specified that files were only to be transferred that 
didn't exist on the remote system (using the /NOD switch), the remote system 
would reject the file if it existed.

.page 10
You may use a number of option switches with the FSEND command.  The 
supported switches are:

      +~Switch  Switch Meaning                                           +~
        ~/?~     Display switches and help file.
        ~/B~     Rename existing destination file to ~.BAK~ if it exists.
        ~/C~     Copy contiguous (random access) files (default)
        ~/NOC~   Don't copy contiguous files.
        ~/D~     Delete destination file if it exists (default).
        ~/NOD~   Only copy if destination file does not exist.
        ~/M~     Move the file.  Delete source after successful transmission.
        ~/NOM~   Copy the file (default).
        ~/Q~     Ask for confirmation (only when sending to remote).
        ~/NOQ~   Don't ask for confirmation (default).
        ~/U~     Only transfer files that are on both systems.
        ~/NOU~   Copy all files (default).

.page 5
~Special notes:~

FSEND adjusts itself to the quality of the physical link.  When a retransmit 
occurs due to a bad packet, it shortens the packet length so as to minimize 
future retransmissions.  As line quality improves, it increases the packet 
length.

FSEND and FRCV can transmit files at speeds of up to 19,200 baud.  However, 
characters can be lost in the physical link if there is a lot of system 
activity during the transmission.  This will manifast it as a number of 
retransmissions or time-out errors.

FSEND attempts to compress the data transmitted in order to minimize the 
number of characters actually transmitted.  It does this by encoding runs of 
identical characters to a shortened form.

FSEND and FRCV run under both AMOS/L and d/os.  The AMOS/L version uses the 
AMWILD.SYS file to perform the wildcard processing.  The d/os version uses
the WLDCRD.SYS module for that function.

See the help files ~FRCV~, ~REMOTE~, and ~TELCOM~ for additional information on
using the d/os telecommunications utilities.

.
