GEMini Atari/GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso/files/bbs/wxytr2/transfer.doc

Text File | 1988-05-08 | 14KB | 301 lines

Copyright (c) 1987 by Thomas E. Zerucha.  These programs may be distributed
freely as long as no charge is made except for the costs incurred in
transcription if any.  These programs are being released as SHAREWARE, so
you can try them before you decide if they are worth it.  Any suggestions
on improvements would be appreciated (money talks louder).

 I have asked in the past for people not to distribute the newer
 versions to give some time for people to donate to recieve them.
 From this point, I will try something different.  You can distribute
 this version as widely as you desire, though it is still shareware
 and you are morally obligated to pay for it if you use it after
 you have tried it out, and I don't think I am asking very much
 for a donation.  And if you expect to see any more software on
 this basis, please make it worth my time and effort.

    Tom Zerucha
    24075 Lee Baker
    Southfield, MI
     48075.

===========================================================================
TRANS127.ARC - this contains the newer version of the accessory which allows
a last chance cancel which also can tell the BBS to start then.  The ACC
also implements the expanded buffer, so SERINI.PRG is not necessary when the
ACC is being used.  Some internal improvements have been made so it is more
resistant to errors, or recovers more easily, and will be able to implement
8 block windows when the spec is settled on (or before), however that is not
implemented, just the hooks so far - the rest is for a later update and when
the various ad hoc standards committee get their collective acts together.
This version also allows limited VT-52 emulation and a phone mode and lets
you configure the serial port.
===========================================================================

SERINI.PRG

 Expands the I/O buffers to reduce CPU time waiting for the buffer
 to have space enough - they are made larger than an entire YMODEM
 block.  It also sets the port at 1200 Baud, 8N1 (8 bit word, no
 parity, 1 stop bit), no control (no XON/XOFF).  The expansion also
 makes transfer more reliable in case of delays due to other tasks.
 For the auto folder.

THIS PROGRAM IS REDUNDANT IF THE TRANSFER.ACC IS USED AS IT EXPANDS THE
BUFFERS ITSELF (TRANS1.10 OR GREATER).

===========================================================================

Transfer program for shell useage (or as .ttp):

 WXYTR [-options] filename [more filenames]

 options (upper and lower case treated the same):
  -T   Transmit - send file to host
  -R   Receive - receive file from host

  Transmit Protocol Extensions
  -B   Use Batch Mode (if one file specified)
  -K   Use 1K blocks only (Forem ST Ymodem)
  -Y   Use normal Ymodem - mix blocks at end
  Transmit Xmodem Modify
  -C   Force CRC regardless of init char
  -S   Force checksum regardless of init char
  -A   Accelerate over Packet Switched Networks (PC Pursuit)
  -3   Accelerate at 300 baud
  Receive Extensions
  -A   Accelerate - assume no errors, cancel if one occurs
  -W   WXmodem transfer (attempt)
  -B   Batch mode, no file name specified
  -S   Force checksum mode - don't try sending C to use CRC
  -O   Overwrite existing files
  -1   Single file only (reject batch)
  Other (both)
  -D   Show transfer progress (debug)
  -L   Abort on Carrier Loss

  although A, B, and S are the same and are for similar
  functions, they do not affect the program identically.

 Transmit default is XMODEM with NAK/'C' setting checksum/CRC
 will upgrade to WX if receiver requests WXmodem transfers,
 but this will disable Ymodem (1K blocks, either -y or -k).

 Receive Mode, X or Y modem, and CRC or Checksum, and Batch or
 single are automatically determined from the received character
 stream. If W is specified, Wxmodem will be tried before CRC.

 filename - not required if batch receiveing, otherwise file to send
 or receive, for send multiple files force Batch Mode.  A specified
 receive file that is overridden by batch will not be created.

 For transmission:
 Only one protocol extension is allowed (either to WX, Y or Y1K).
 Acceleration only helps standard Xmodem, Do not use with extensions.
 Force CRC/Checksum will work with Y, Y1K modem but is not recommend.
 Force CRC/Checksum will NOT work with WX.
 Batch mode (send) will NOT default to Ymodem - you must add -Y or -K.
 Batch mode is NOT part of the WXmodem spec.

 Debug can be used any time.  A + will be printed for each ACKed
 block, a - for NAKs, # for wrong block numbers, and filenames.

 The extensions which are simple supersets (true Ymodem) or use
 characters (W,C,NAK) to determine protocol should back down to
 simpler protocols properly, but THIS IS NOT GUARANTEED to work
 with everything - it is best if you make sure the other end
 will support the extension and is in that mode before extending
 this end.  (Most problems come from the fact that each extension
 backs down or detects subsets differently).

 If you are having many problems, try XModem forcing checksum, then
 forcing CRC - some implementations accept the C but send checksum
 instead of CRC, or vice versa - especially 8 bit Atari's.

 -K is used when uploading to a Forem ST system which does not accept
 mixed X and Y Modem blocks according to the full specification.

This program will execute in background under MT C Shell or RTX and are
optimized for this use.  Disk I/O is done when Character I/O is not critical.
In this useage WXmodem receive might not run at full speed, and the packet
accelerator will not time precisely enough - this is only during background
with other active processes using CPU time.

Executing SERINI.PRG is recommended in either useage unless the accessory
is present (it need not be used, merely be in memory), or your shell or
communication program expands the serial port buffers themselves.

The only messages printed are for completion or fatal errors unless -D
is specified which prints a recieved filename (in batch) and a + for each
recieved block, - for each NAKed block and # for each out of sequence block.

The program uses the Iorec Xbios function and may not work if the serial
port is multiplexed - This is accessed to reject characters as noise
coming in before the transmission is complete.

Try to use YModem Batch if possible since the length of the file will be
copied exactly, instead of the nearest 1K or 128 bytes.

There might be a problem if these are run in the background, if the ampersand
is connected with the last parameter - that parameter might not be copied,
use:
 WXYTR UP.ARC &
instead of
 WXYTR UP.ARC&
under MT C Shell (and remember to disable tta1:)

---------------------------------------------------------------------------
TRANSFER DESK ACCESSORY

VT-52 Emulation:

Click on VT-52 and the screen will be cleared and you will be able to manually
send and recieve data just like the emulator.acc.  You can also use F1 to
capture incoming data (into a file, no buffer), and F10 will close the file.
Additionally, the arrow keys will send VT-52 type codes (esc-A for uparrow,
etc.) and the Clr/Home key will send a break (if you have SET 1:0,7:8, this
will get back to Telenet).  Undo exits the emulator (the screen will be lost).
Characters with their 8th bit set will be displayed in reverse video.

Port Setting:

Click on Config, then set the baud rate, parity, etc. you desire.
If you have a resource construction set, you can change the preselected
configuration by setting the buttons you want to default in the .rsc file.
Otherwise this information is not saved when changed and the port will be
set upon boot-up to 1200, 8n1, no-flow, but will probabaly be overridden
by any communications program.

Phone (chatting):

Click on phone, any recieved characters will be displayed in the top window,
and any characters you type will be sent AND be displayed in the bottom
window.  Wordwrap is implemented.  This is useful if calling a friend instead
of a BBS.

Up/Downloading:

1. click on send if you want to send, or recieve if you want to recieve.

if sending...
2. click on the variant, Xmodem, Ymodem, Ymodem 1K (for Forem type systems),
   or Accelerate.  WXmodem will automatically be detected from Xmodem.
3. if your reciever is out of spec, and requires either CRC or Checksum
   click on the Force Option. (some Atari 8 bit machines require these).
4. if you are sending many files, or one in batch, click batch, otherwise
   click OK.  If you wish to abort, click cancel.
5. a File Selector box will appear.  Click on each file you want - and click
   on OK,  If sending batch, click on OK for each file, then on cancel to
   start the batch send.
6. A box will appear giving a last chance to cancel, otherwise you may choose
   to send a yes/no to the BBS to start the transfer.  This way you can stop
   at "READY FOR TRANSFER (Y/N)?" on citadels, then provide the "Y", or at
   "is the file longer than XXX bytes" on Forem (send N<cr>) so you will have
   more time to use the selector boxes.
7. the file(s) will be sent - the progress will appear in a dialog box with
   alert boxes upon completion.  The length of the file will be displayed.

if receiving...
2. click on WXmodem if you desire this protocol (or SEAlink).
3. if using X/Y modem, click on "quick & dirty" if you are downloading small
   files on a reliable line - it will send the ack early, but will cancel
   the transfer if even one bad block is found.
4. Click on Force Checksum if you don't want CRC to be tried (for some out
   of spec programs).  Click overwrite if you wish recieved files to
   replace existing files if the filenames are the same.  (Some Atari 8 bit)
5. Click Batch for batch transfers, or OK - a batch transfer will force batch
   mode in either case (required for SEAlink).
6. A File selector box will appear.  Select the directory for the files to
   go into, and the name the file should take if it is not a batch transfer
   (a default name if Batch is not working from the senders end).
7. A box will appear giving a last chance to cancel, otherwise you may choose
   to send a yes/no to the BBS to start the transfer.  This way you can stop
   at "READY FOR TRANSFER (Y/N)?" on citadels, then provide the "Y" from this
   dialog box.
8. A dialog box will monitor the progress, with alert boxes when done or
   aborted.  In batch, the expected length of the file will be displayed.

Approximate mapping of command line options:

 -t  -r

 (none)  (none)
 -y  -w
 -k  -z
 -a
   -o
 (none)
 -c  -a
 -s  -s

  -b (none)

NOTE: The ABORT button on the progress dialog functions only with the mouse.
 Move the mouse into the box and click.  Hold the button down - it
 may take several seconds to be recognized.

---------------------------------------------------------------------------
Tips on PC Pursuit and other notes:

1. use SET? 1:0,7:8 to disable the <cr>@<cr> from dumping you to Telenet if
the string happens to be in a file.  The 7:8 will enable the Break condition
to get back to Telenet.

2. Sometimes Telenet is too sensitive about Break conditions, 7:0 will fix
that, but you will not be able to get back without hanging up.  Using two
stop bits also seems to work, but slows the speed a little.  Xmodem, and
Accelerated Xmodem don't seem to be affected, only Ymodem and WXmodem, and
only on uploads.

3. Redial a really noisy line.  These routines are good, but not perfect.

4. This version of WXmodem will work in Batch mode, but the receiving end
must specify WX, and maybe batch, and the sender must be in batch.

5. If you have many interrupt programs running, stealing CPU time, characters
may be missed resulting in more NAKs.  If you are having a lot of problems,
check your accessories and auto folder programs.

6. Make sure you have enough space on the disk - I don't check for that
(in this version).

7. Dates aren't supported either although they are part of the Ymodem spec
   (an extension which is optional).

TELENET UPLOAD PROBLEMS
There seems to be many problems caused by high throughput transfer protocols
like Ymodem and WXmodem, and I suspect false BREAK conditions are a part of
this.  It rarely happens if you are transmitting in 2 stop bit mode.  I have
included stopbit.ttp for this.  In the TTP dialog or in the command shell as
a parameter, you can specify 1 or 2, and that will set the number of stop
bits to the given value.  The extra stop bit will make uploads 10% slower,
but much more likely to get through without errors.  This does not apply to
recieve/downloading, only to sending.  If you are accessing Telenet at 2400
baud, and outdialing at 1200, you should stay with Xmodem (not accelerated)
or enable (from Flash, the VT52 emulator, etc.) Xon/Xoff control, and specify
SET? 5:1 at the Telenet command prompt (you will have to break to Telenet
after connecting and set this as you would have to in order to do 1:0,7:8).
Uploading will often work without problems even without these measures, so I
recomment trying it, and only if excessive errors are occuring, setting stop
bits to 2, etc.  You may also want to go back to Xmodem or Accelerated Xmodem
which are slower but more immune to error.

===========================================================================
1.2x additions and changes.

SEAlink has been added as a recieve option.  Simply select it as you would
WXmodem recieve, and always specify batch and proceed as for batch.

Config will allow you to set the port.  It comes up as 1200 baud, 8 bits,
no parity, 1 stop.  You can change it to what is needed.

VT-52 emulation has been added.  It does the normal ASCII keyboard, and in
addition sends the proper codes for the arrow keys, and the Clr/Home will
send a Break condition.  F1 will open a file and capture any data (up to
4K) recieved so far, and any additional until F10 or Undo is pressed.
F10 simply closes the file, Undo will also exit.

===========================================================================
Micro RTX and MT C Shell are trademarks of Beckemeyer Development Tools.
PC Pursuit is a trademark of Telenet, a US Sprint company.
Portions of this program copyright (c) 1984, Mark Williams Co.