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".