home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Club Amiga de Montreal - CAM
/
CAM_CD_1.iso
/
files
/
550a.lha
/
BackTalk_v1.46
/
About_XPR
next >
Wrap
Text File
|
1991-09-08
|
9KB
|
234 lines
XPR Options
The behavior of most XPR libraries can be configured through the options
interface (Selected Protocol Options item under the Files menu).
Following are the user selectable options for the QuickB library.
(T) Text mode
Y Turn text character editing on. On downloads, carriage
return and line feed pairs are turned into line feeds, the
standard Amiga line termination. Also, characters following
a control-Z are ignored. On uploads, carriage returns are
added before line feeds, which makes text more easily
portable to other machines.
N Turns text character editing off. All characters are passed
through as untranslated binary.
C Consult the communications program to determine the text/
binary status. XprQuickB defaults to binary transfer if the
communication program cannot assign a status,
H Use the host's suggestion. For uploads, text or binary mode
must be specified on the host command. This is the default
value of the option.
(O) Overwrite mode
Y Silently overwrite existing files during downloads.
N Avoid overwriting existing files. This is done by
appending ".dup" or ".dupN" (for N a number from 2 to 99)
to the downloaded file name. The new name will generally
appear in the file transfer status window. If 99 ".dup"
files exist, ".dup99" will be overwritten. This is the
default value of the option.
S This option aborts the download if the file exists.
(B) I/O buffer size (KB)
nnn Here, "nnn" is a number representing the desired file buffer
size in multiples of 1024 bytes (KB). This allows the disk
to be accessed less frequently. A value of 0 disables file
buffering by XprQuickB. The default is 16 KB. The buffer
is allocated only during file transfers. If the buffer can
not be allocated, XprQuickB uses no buffering.
(A) Auto-activate transfers
Y Setting this option on allows file transfers to be started
at the request of the host system. This is the default.
N This disables host initiation of transfers.
(D) Delete after sending
Y Turning this option on causes an uploaded file to be deleted
locally after a successful transfer. The communication
program must support the "xpr_unlink" call-back function to
enable this option.
N Uploaded files are retained. This is the default.
(K) Keep partial files
Y Setting this option on causes the incomplete file from an
unsuccessful download to be retained.
N Setting this option off causes the incomplete file to be
deleted. The deletion occurs only if the "xpr_unlink"
call-back is supported. This is the default (if
"xpr_unlink" is available).
Following are the user selectable options for the ZModem library.
T{Y|N|?|C} Text translation mode:
TY = Text Yes; if receiving, translate CR/LF pairs or solo
CR chars to normal Amiga LF chars. Ignore data past ^Z.
If sending, suggests to receiver that they should receive
this file in text mode.
TN = Text No; receive file verbatim, without changes. If
sending, suggest to receiver that they receive this
file verbatim, without translations.
T? = Text status unknown; if receiving, use sender's
suggestion as to whether to do EOL translations or not.
If sending, tell receiver to use default mode, 'cause we
don't know either.
TC = Text mode set by Comm program; the library asks the comm
program whether or not to use Text mode for each file.
If the comm program doesn't support the necessary
xpr_finfo() call, or if the call fails, this option acts
like T?. From the user's point of view, what this option
normally does is set the Text mode to match the comm
program's built-in text/binary/end-of-line/translation
mode, if any.
O{Y|N|R|S} Overwrite mode:
OY = Overwrite Yes; if about to receive file with same name as
one which already exists, delete the old file and receive
the new file in its place.
ON = Overwrite No; if about to receive file with same name as
one which already exists, append ".dup" onto the name of
the new file to keep them separate.
OR = Overwrite Resume; if about to receive file with same name
as one which already exists, resume receiving file data
from the current end of the existing file.
OS = Overwrite Skip; if (etc.), tell sender never mind, skip
this file, we don't want it. Batch transfers will move
on to the next file in the set, if any.
Bnnn Buffer size:
XPRZModem.library adds a layer of file I/O buffering in
addition to whatever the comm program may or may not provide.
This option sets the size of XPRZModem's file I/O buffer in
kilobytes. The minimum value is 1 KB, for those using RAM
drives or fast hard drives, or those whose comm programs
already provide sufficient buffering. The maximum value is
as much contiguous RAM as you have available in your Amiga.
If you specify more than is actually available, XPRZModem will
keep decrementing the buffer size requested by 1 KB until the
memory allocation works. That way, if your RAM is too
fragmented to use the amount you request, XPRZModem simply
uses the largest block available. Buffering is especially
helpful for floppy drive users; it keeps your drive from
continuously gronking and slowing things down all through the
transfer.
Fnnn Frame size:
Although normally avoided, ZModem has the ability to require
an ACK to be sent from the receiver to the sender every X-many
data bytes. Normally you don't want to use this feature,
because not waiting for ACKs is part of how ZModem works so
fast. However, this feature can be very useful in conjunction
with file I/O buffering on slow devices (namely those floppy
drives). If you set up a large I/O buffer to avoid gronking
your floppy so often, you'll find that when the buffer finally
*does* get around to being flushed that it can take a looonng
time; so long, in fact, that the delay can cause timeouts and
errors. But if you set your ZModem to require the sender to
wait for an ACK every buffer's-worth of data, the sender will
politely wait for you to flush your buffer to the slow floppy
and send it an ACK saying it's OK to continue now. This value
should be set to 0 to disable ACKs (normal mode), or set it to
the actual number of data bytes allowed between ACKs. For
example, if you set B64 because of your floppy, you should
also set F65536.
Ennn Error count:
This allows you to set the number of sequential errors which
will be required to convince ZModem to abort the transfer. The
normal value is 10, meaning that 10 errors must happen in a row
with no valid data being transferred in order to cause an abort.
This setting is provided for those using XPRZModem with a BBS,
who may wish to use a relaxed setting, or those with really
lousy phone lines who are desparate and patient enough to want
the transfer to continue in spite of horrible performance.
A{Y|N} Auto-activate mode:
AY = Auto-activate Yes; if the comm program supports the
ability, the library will automatically go into receive
mode when the start of a ZModem download is detected.
AN = Auto-activate No; don't try to automatically start
downloading, make the user activate it.
D{Y|N} Delete after sending:
DY = Delete Yes; delete each file after it has been
sucessfully sent.
DN = Delete No; don't delete files after sending them.
K{Y|N} Keep partial files:
KY = Keep Yes; keep the fragment of a file received so far
if file reception is aborted. This allows you to use the
Overwrite Resume option above to pick up where you left
off on your next attempt.
KN = Keep No; delete any partially-received file after an
aborted transfer.
S{Y|N} Send full directory path:
SY = Send path Yes; send full filenames including directory
path to receiver.
SN = Send path No; send only simple filenames, not including
directory path.
R{Y|N} Receive full directory path:
RY = Receive path Yes; use full filename exactly as received,
instead of using the P option directory path.
RN = Receive path No; ignore received directory path (if any),
use P option directory path instead.
P{dir} Path to use for received files:
Px = Store all received files in directory "x" if option RN
set. Ignored if option RY set. "x" can be any valid
existing directory, with or without trailing "/"
(e.g. "Pdf0:", "PComm:hold", etc.).
If you are using the SETXPR ARexx command to change the default
settings of the selected protocol, in the argument for SETXPR,
the setting for each option must immediately follow the option
character with no intervening characters ("TY", not "T Y" or "T=Y").
When setting multiple options at once, separate the options from each
other with commas and/or spaces, for example, "TN,OR,F0".