GEMini Atari

home *** CD-ROM | disk | FTP | other *** search

/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / bbs / wxytr2 / transfer.doc < prev next >

Wrap

Text File | 1988-05-08 | 14.1 KB | 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.