home *** CD-ROM | disk | FTP | other *** search
/ Groovy Bytes: Behind the Moon / groovybytes.iso / GROOVY / PPE / Q_TIP / Q_RESUME.ZIP / RESUME.DOC < prev    next >
Encoding:
Text File  |  1994-02-04  |  19.5 KB  |  391 lines

  1.  
  2.  
  3.  
  4.            ▄▄▄▄▄▄▄▄
  5.         ▄▀▀▄▄▄▄▄▄▄▄▀▀▄            ▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▀▀▀▀▀▀▄▄▄▄
  6.       ▄▀▄████████████▄▀▄        ▄▀▄█████████████████▄▐█████▄▄▄▄▀▀▄
  7.     ▄▀▄██████▀▀▀▀██████▄▀▄      ▀▄▀█████████████████▀▐███████████▄▀▄
  8.    █ █████▀▀▄▀▀▀▀▄▀▀█████ █       ▀▄▄▄▄▄ █████ ▄   ▄ ▐████ ▀▀██████▄▀▄
  9.    █▐████▌█▀  ▄▄▄▄▀█▐████▌█           ▄█ █████ ▄███▄ ▐████ █▀▄▀▀█████ █
  10.   █ ▓▓▓▓▓ █▄▀▀▄▄▄▄▀█ ▓▓▓▓▓ █    ▄▄▄▄▄▀▄  ▓▓▓▓▓ ▓▓▓▓▓ ▒▒▓▓▓ █  ▀█▐████▌█
  11.   █ ▒▒▒▒▒ ▀▄▓▒▓████▄ ▒▒▒▒▒ █▀▀▀▀▄▄▄▄▄▄▄█ ▒▒▒▒▒ ▒▒▒▒▒ ░░▒▓▓ █  ▄█▐████▌█
  12.   █ ░░░░░ █▓▒░▒▓████▌░░░░░  ██████████▀▄ ░░░░░ ░░░░░ ░▒▒▓█ █▄▀▄▄█████ █
  13.   █ ▒▒▒▒▒  █▓▒▓█████ ▒▒▒▒▒ █▀▀▀▀▀▀▄▄▄▄▀█ ▒▒▒▒▒ ▒▒▒▒▒ ▒▒▒▓█ ▄▄██████▀▄▀
  14.   █ ▓▓▓▓▓ █▄▀▓██████ ▓▓▓▓▓ ▄▀▄▀▀▀▀     █ ▓▓▓▓▓ ▓▓▓▓▓ ▓▓▓▓█ ██████▀▄▀
  15.    █▐████▌█▄▀▄▀▀█▀▄▄▐████▌█ ▀          █ █████ █████ █████ ▀▀▀▀▄▄▀
  16.    █ █████▄▄▀▄██ ░▄▄█████ █            █ █████ █████ █████ █▀▀▀
  17.     ▀▄▀██████▄▄▄▄██████▀▄▀             █ █████ █████ █████ █
  18.       ▀▄▀████████████▀▓▓ █             █ █████ █████ █████ █
  19.         ▀▄▄▀▀▀▀▀▀▀▀ ▒▓▓▓▓ █            █ █████ █████ █████ █
  20.            ▀▀▀▀▀▀▀▀█ ▓▓███ █           ▀▄▀███▀▄▀███▀▄▀███▀▄▀
  21.                     █ ▓████ █            ▀▄▄▄▀ ▀▄▄▄▀ ▀▄▄▄▀
  22.                      █ █████ █    ▄▄▄▄   ▄▄▄▄ ▄▄▄▄   ▄▄▄   ▄▄▄  ▄▄▄▄  ▄▄▄▄
  23.                       █ █████ █   █   █ █     █   █ █   █ █   █ █   █ █   █
  24.                        █ █████ █  █   █ █     █▄▄▄▀ █   █ █▄▄▄█ █▄▄▄▀ █   █
  25.                         ▀▄▀█▀▄▀   █▀▀▀  █     █   █ █   █ █   █ █   █ █   █
  26.                           ▀▄▀     █     ▀▄▄▄▄ █▄▄▄▀ ▀▄▄▄▀ █   █ █   █ █▄▄▄▀
  27.  
  28.      ▄▄▄▄  ▄▄▄▄▄ ▄   ▄ ▄▄▄▄▄ ▄      ▄▄▄  ▄▄▄▄  ▄     ▄ ▄▄▄▄▄ ▄    ▄ ▄▄▄▄▄
  29.      █   █ █     █   █ █     █     █   █ █   █ █▀▄ ▄▀█ █     █▀▄  █   █
  30.      █   █ █▄▄   ▐▌ ▐▌ █▄▄   █     █   █ █   █ █  █  █ █▄▄   █  ▀▄█   █
  31.      █   █ █      █ █  █     █     █   █ █▀▀▀  █     █ █     █    █   █
  32.      █▄▄▄▀ █▄▄▄▄   █   █▄▄▄▄ █▄▄▄▄ ▀▄▄▄▀ █     █     █ █▄▄▄▄ █    █   █
  33.                                 for fun
  34.  
  35. PCB-RESUME V1.0 (c)1994 by Q-TiP PCBoard-Development
  36. ───────────────────────────────────────────────────────────────────────────────
  37. Table of contents:
  38.  
  39.         1 - INTRO
  40.         2 - HOW TO SET-UP PCB-RESUME
  41.         3 - PROBLEMS WITH HS-LINK DUPECHECK (-NO PARAMETER)
  42.         4 - OTHER
  43.         5 - GREETINGS (a MUST hehe)
  44.         6 - CREDITS
  45.  
  46.  
  47.  
  48. ═══[ PCB-RESUME V1.0 INTRO ]═══════════════════════════════════════════════════
  49.  
  50.      ─┐ You did a good decision unzipping another great Q-TiP
  51.       │ release. This time it's an utility we all missed a long
  52.       │ time - upload resume. It really sux if you upload a 1,44
  53.       │ megs file and after 1,40 megs the carrier drops or
  54.       │ whatever and you spent 13 minutes uploading FOR
  55.       │ NOTHING.
  56.       │
  57.       │ But now you can just continue with the upload like
  58.       │ /X-users do it for years. A really great tool for
  59.       │ PCBoard!
  60.       │
  61.       │ I tested it for about one month on my bbs and i think
  62.       │ there are no real bugs in it. I hope you don't discover
  63.       │ some. ;)
  64.       │
  65.       │                                 -Frank Q.
  66.       │
  67.       └
  68.  
  69.  
  70. ═══[ HOW TO SET UP PCB-RESUME V1.0 ]═══════════════════════════════════════════
  71.  
  72. STEP 1: INSTALL A NEW DOOR USING PCBSETUP
  73.      ─┐
  74.       │ I believe PCB-RESUME isn't the first door you gonna go to
  75.       │ install. On my harddisk all doors are in e:\pcb\doors
  76.       │ (network drive) so just create a directory
  77.       │ called e:\pbc\doors\RESUME and copy RESUME.EXE, RESUME.CFG,
  78.       │ RESUME.DOC (this one) AND RESUME into it.
  79.       │
  80.       │ 1) Create a new directory for PCB-RESUME.
  81.       │ 2) Copy all PCB-RESUME files into it.
  82.       │
  83.       │ Then start PCBSETUP.EXE and edit the DOORS file:
  84.       │
  85.       │ ╔═════════════════════════════════════════════════════════════════════╗
  86.       │ ║                        Edit DOORS File                              ║
  87.       │ ║                                                                     ║
  88.       │ ║                              USER DOOR                              ║
  89.       │ ║   Filename  Passwd Sec Login SYS  SYS  Shell    Path to DOOR Files  ║
  90.       │ ║  ══════════ ══════ ═══ ═════ ════ ════ ═════ ══════════════════════ ║
  91.       │ ║ 1) RESUME           20   N    N    N     Y   E:\PCB\DOORS\RESUME\   ║
  92.       │ ╚═════════════════════════════════════════════════════════════════════╝
  93.       │
  94.       │ Create a new line (ALT-I) and enter the values. If you didn't
  95.       │ copy PCB-RESUME into c:\pcb\doors\resume then (of coz) enter
  96.       │ the path where you placed it and not the path above ;)
  97.       └
  98. STEP 2: CHANGE THE PATHS IN THE RESUME.CFG ────────────────────────────────────
  99.      ─┐
  100.       │ Now leave the PCBSETUP and edit the RESUME.CFG file,
  101.       │ it should look like this:
  102.       │
  103.       │ ╔═[ RESUME.CFG ]══════════════════════════════════════════════════════╗
  104.       │ ║ e:\f\private                                                        ║
  105.       │ ║ e:\f\private\keep                                                   ║
  106.       │ ║ @X1A                                                                ║
  107.       │ ║ @X0B                                                                ║
  108.       │ ║ @X03                                                                ║
  109.       │ ║ @X02                                                                ║
  110.       │ ║                                                                     ║
  111.       │ ║ ════[ Resume v1.0 Configuration File ]═════════════════════════════ ║
  112.       │ ║ line 1: Path of where the uploads take part (private Upload Dir)    ║
  113.       │ ║ line 2: Path where the aborted uploads are                          ║
  114.       │ ║ line 3: Color of header-message                                     ║
  115.       │ ║ line 4: Color of files                                              ║
  116.       │ ║ line 5: Color of sizes                                              ║
  117.       │ ║ line 6: Color of other messages                                     ║
  118.       │ ╚═════════════════════════════════════════════════════════════════════╝
  119.       │
  120.       │ I guess you know where the uploads take part. Put this
  121.       │ directory into line 1. Now create another directory where the
  122.       │ ZIP files with CRC errors should moved into. Write the path of
  123.       │ this directory into line 2.
  124.       │
  125.       │ If you use different private upload directories for each
  126.       │ conference PCB-RESUME won't work!
  127.       │ So go and use only ONE private directory for all conferences!
  128.       └
  129. STEP 3: CHANGE THE PATHS IN THE RESUME PCBOARD DOORWAY FILE ───────────────────
  130.      ─┐
  131.       │ Now change the paths in the RESUME Batch for PCBoard... put
  132.       │ your own in...
  133.       └
  134. SETP 4: CHANGE PCBOARDS TRANSFER BATCHES ──────────────────────────────────────
  135.      ─┐
  136.       │ Here are examples how the PCBRZ.BAT for GSZ Z-Modem receive
  137.       │ and HS-Link 1.21(ßx) should look like.
  138.       │
  139.       │ ╔═[ PCBRZ.BAT ]═══════════════════════════════════════════════════════╗
  140.       │ ║ @echo off                                                           ║
  141.       │ ║ if exist pcberr.fil del pcberr.fil                                  ║
  142.       │ ║ if exist pcbdsz.log del pcbdsz.log                                  ║
  143.       │ ║ GSZ.exe F pY129 ha both estimate 0 %5 z rz -rr %3                   ║
  144.       │ ║ e:\pcb\doors\resume\resume GSZ e:\f\private                         ║
  145.       │ ╚═════════════════════════════════════════════════════════════════════╝
  146.       │
  147.       │ ╔═[ PCBRH.BAT ]═══════════════════════════════════════════════════════╗
  148.       │ ║ @echo off                                                           ║
  149.       │ ║ if exist pcberr.fil del pcberr.fil                                  ║
  150.       │ ║ if exist %DSZLOG% del %DSZLOG%                                      ║
  151.       │ ║ HSLink -p%1 -e%5 -u%6 -A -HX -NV -NG -NM -R -K -O                   ║
  152.       │ ║ e:\pcb\doors\resume\resume HSLINK e:\f\private                      ║
  153.       │ ╚═════════════════════════════════════════════════════════════════════╝
  154.       │
  155.       │ ╔═[ PCBSH.BAT ]═══════════════════════════════════════════════════════╗
  156.       │ ║ @echo off                                                           ║
  157.       │ ║ if exist pcberr.fil del pcberr.fil                                  ║
  158.       │ ║ if exist %DSZLOG% del %DSZLOG%                                      ║
  159.       │ ║ HSLink -p%1 -e%5 -u%6 -A -HS -HX -NV -NG -NM %3 -R -K -O            ║
  160.       │ ║ e:\pcb\doors\resume\resume HSLINK e:\f\private                      ║
  161.       │ ╚═════════════════════════════════════════════════════════════════════╝
  162.       │
  163.       │ Append a line to the batch:
  164.       │ <path to resume>\resume [HSLINK/GSZ]
  165.       │
  166.       │ Be sure to write GSZ and HSLINK in capital letters or it won't
  167.       │ work!
  168.       │
  169.       │
  170.       │ There are slight differences between the GSZ and HSLINK
  171.       │ parameters: GSZ uses a slash "/" to seperate the
  172.       │ components of a path while HS/Link expects a backslash
  173.       │ "\". GSZ has got "Z" and HS/Link "H" as symbols for
  174.       │ upload.
  175.       │
  176.       │ So you can set up other protocols too, you only need to take a
  177.       │ look at the PCBDSZ.LOG.... if the protocol (ZyRion etc) uses
  178.       │ '/' to seperate the paths choose GSZ, else HSLINK.
  179.       │
  180.       │ If an upload is aborted the first character in the PCBDSZ.LOG
  181.       │ will be an "E"... And if PCBoard recognizes that it will delete the
  182.       │ file. So the RESUME.EXE isn't just a doorway but also a
  183.       │ converter for the PCBDSZ.LOG... it converts every "E" to "Z" or
  184.       │ "H" and the upload is tested like any other completed upload.
  185.       │
  186.       │ If a carrier is lost while uploading there will be a "L"
  187.       │ instead of "E". I found out that just a few days ago...
  188.       │
  189.       │ PCB-RESUME saves only ZIP files, all other shit ARJ/LHA/S-NESsux
  190.       │ and amiga-lame is deleted by PCBoard if the upload has been
  191.       │ aborted.
  192.       │
  193.       │ The last thing you must do is modify your PCBTEST.BAT...
  194.       └
  195. STEP 5: EDIT YOUR PCBTEST.BAT ─────────────────────────────────────────────────
  196.      ─┐
  197.       │ I'm sure you have differnt parts in it but you must perform a
  198.       │ CRC-check on the ZIP!
  199.       │ Take a look how I do it:
  200.       │
  201.       │ ╔═[ PCBTEST.BAT ]═════════════════════════════════════════════════════╗
  202.       │ ║ [...]                                                               ║
  203.       │ ║ pkunzip -t %1 >NUL                                                  ║
  204.       │ ║ IF ERRORLEVEL 8 GOTO ZIP_ERROR                                      ║
  205.       │ ║ IF ERRORLEVEL 2 GOTO ZIP_ERROR                                      ║
  206.       │ ║ IF ERRORLEVEL 1 GOTO ZIP_ERROR                                      ║
  207.       │ ║                                                                     ║
  208.       │ ║ GOTO ENDE                                                           ║
  209.       │ ║                                                                     ║
  210.       │ ║ rem *** PKZIP REPORTS ERROR *******************                     ║
  211.       │ ║ :ZIP_ERROR                                                          ║
  212.       │ ║ ECHO ■ CRC ERROR!                                                   ║
  213.       │ ║ move %1 e:\f\private\keep /Q /O                                     ║
  214.       │ ║ COPY e:\pcb\pcbtest.f01 %pcbdir%\pcbfail.txt                        ║
  215.       │ ║ GOTO tf_end                                                         ║
  216.       │ ║ [...]                                                               ║
  217.       │ ╚═════════════════════════════════════════════════════════════════════╝
  218.       │
  219.       │ Note:
  220.       │ MOVE.EXE is a little shareware program, also included, should be
  221.       │ in the DOS search path... You move the ZIPs which failed the CRC
  222.       │ check into the directory you explained in line 2 in RESUME.CFG.
  223.       └
  224. STEP 6: MAKE A FIRST TEST ─────────────────────────────────────────────────────
  225.      ─┐
  226.       │ Now log on local to your bbs and type RESUME.
  227.       │ The following should come up:
  228.       │
  229.       │ ╔═════════════════════════════════════════════════════════════════════╗
  230.       │ ║                            Q-TiP's PCB-RESUME V1.0 (c)1994 Frank Q. ║
  231.       │ ║ Files in Sysop's hold directory:                                    ║
  232.       │ ║ ═══════════════════════════════════════════════════════════════════ ║
  233.       │ ║ No files to resume!                                                 ║
  234.       │ ║                                                                     ║
  235.       │ ║ Your Command? _                                                     ║
  236.       │ ╚═════════════════════════════════════════════════════════════════════╝
  237.       │
  238.       │ When you copy a TEST.ZIP into the directory (where the rejected
  239.       │ ZIPs get moved) and start it again it should look so:
  240.       │
  241.       │ ╔═════════════════════════════════════════════════════════════════════╗
  242.       │ ║                            Q-TiP's PCB-RESUME V1.0 (c)1994 Frank Q. ║
  243.       │ ║ Files in Sysop's hold directory:                                    ║
  244.       │ ║ ═══════════════════════════════════════════════════════════════════ ║
  245.       │ ║ TEST.ZIP 365k If you want to resume an upload,                      ║
  246.       │ ║ just type RESUME <filename>                                         ║
  247.       │ ║                                                                     ║
  248.       │ ║ Your Command? _                                                     ║
  249.       │ ╚═════════════════════════════════════════════════════════════════════╝
  250.       │
  251.       │ If you type now -
  252.       │
  253.       │ ╔═════════════════════════════════════════════════════════════════════╗
  254.       │ ║                            Q-TiP's PCB-RESUME V1.0 (c)1994 Frank Q. ║
  255.       │ ║ Files in Sysop's hold directory:                                    ║
  256.       │ ║ ═══════════════════════════════════════════════════════════════════ ║
  257.       │ ║ TEST.ZIP 365k If you want to resume an upload,                      ║
  258.       │ ║ just type RESUME <filename>                                         ║
  259.       │ ║                                                                     ║
  260.       │ ║ Your Command? RESUME TEST.ZIP                                       ║
  261.       │ ╚═════════════════════════════════════════════════════════════════════╝
  262.       │
  263.       │ it should look like -
  264.       │
  265.       │ ╔═════════════════════════════════════════════════════════════════════╗
  266.       │ ║                            Q-TiP's PCB-RESUME V1.0 (c)1994 Frank Q. ║
  267.       │ ║ TEST.ZIP moved to the upload directory.                             ║
  268.       │ ║                                                                     ║
  269.       │ ║ Now go and resume your upload! But don't enter the original file    ║
  270.       │ ║ name because PCBoards dupecheck also checks the private upload dir, ║
  271.       │ ║ where the file is moved to! Just enter some crap when PCBoard asks  ║
  272.       │ ║ for the filename.                                                   ║
  273.       │ ║                                                                     ║
  274.       │ ║ Your Command? _                                                     ║
  275.       │ ╚═════════════════════════════════════════════════════════════════════╝
  276.       │
  277.       │ If you now shell to DOS and take a look at the upload dir, you
  278.       │ should find the TEST.ZIP...
  279.       │
  280.       │
  281.       │ That's it!
  282.       │ PCB-RESUME should now work without problems.
  283.       │
  284.       │
  285.       └
  286. ═══[ PROBLEMS WITH HS-Link-DUPECHECK ]═════════════════════════════════════════
  287.  
  288.      ─┐ I noticed that the HS-Link Dupecheck
  289.       │ (-NO<dupelist_with_paths>) is pretty useless with the
  290.       │ Overwrite-File option (-O) which is necessary to resume an
  291.       │ upload. So you should create another protocol just for
  292.       │ HS-Link-upload resume. Of cause you can tell your users
  293.       │ that upload resume only works with z-modem but some of
  294.       │ my users have got much trouble with normal z-modem/GSZ,
  295.       │ so they use HS-Link and can now upload and download
  296.       │ without problems.
  297.       │ So I created another protocol and here is the batch (if
  298.       │ you are interested in it):
  299.       │
  300.       │ ╔═[ PCBRB.BAT ]═══════════════════════════════════════════════════════╗
  301.       │ ║ @echo off                                                           ║
  302.       │ ║ if exist pcberr.fil del pcberr.fil                                  ║
  303.       │ ║ if exist %DSZLOG% del %DSZLOG%                                      ║
  304.       │ ║ HSLink -p%1 -e%5 -u%6 -A -HX -S1024 -CP2 -FT4 -NV -NG -NM -R -K -O  ║
  305.       │ ║ e:\pcb\doors\resume\resume HSLINK e:\f\private                      ║
  306.       │ ╚═════════════════════════════════════════════════════════════════════╝
  307.       │
  308.       │ There's no dupecheck possible. But I think the users
  309.       │ won't get killed by that. ;-)
  310.       │
  311.       └
  312.  
  313. ═══[ OTHER ]═══════════════════════════════════════════════════════════════════
  314.  (errors etc)
  315.      ─┐
  316.       │   Check all paths carefully to avoid runtime-errors or
  317.       │ other shit!
  318.       │
  319.       │   On every error, first check the paths in all batches
  320.       │ and in the RESUME.CFG. Be sure that they are a 100%
  321.       │ right!
  322.       │
  323.       │   If you don't use the MOVE (included in the package) make
  324.       │ sure that your program overwrites existing files without
  325.       │ asking to avoid problems with two time/same file-upload
  326.       │ aborts.
  327.       │
  328.       │   If you are not sure how to install a doorway properly
  329.       │ refer to your pcboard manual!
  330.       │
  331.       │   In case that all paths are for sure correct but
  332.       │ PCB-RESUME still don't works check the free memory in
  333.       │ shell. Maybe you should turn on "swap out during shell" in
  334.       │ order to get more memory when executing PCB-RESUME.
  335.       │
  336.       └
  337.  
  338. ═══[ GREETINGS (A MUST! hehe) ]════════════════════════════════════════════════
  339.  
  340. Frank Q.'s personal greetinx (alphabetical order):
  341.  
  342.               Automan, Bandieto, Bubba, Blackbird, Butcher, Byte,
  343.                  Chronus, Crackpipe, Cosmic, Crimson-Couriers,
  344.                  Decker, Delirious Nomad, Dr.Byte, Dr.Insanity,
  345.                 Drunken Rom, Dodger, Elrond/SOTL, Faith Healer,
  346.               Fate, Fbi, Flashlight, GTW, Hollis, Iceman, Irakis,
  347.               Joe Handsome, Killefitt, Luke Skyywalker, Loverman,
  348.               Lybis/BCD, Mamma, Maverick, Merlin, Mikeysoft, Milo
  349.                Mindbender, Morgaine, Mooncrow, Nuke, Oppi, Orion,
  350.                PWA-Crew, Rambone, Rave, Ravish, Ripwave, Samson,
  351.               Santa Claus, Selim, Sle, Tailgunner, The Brain, The
  352.                           Terrorist, Troops, Twilight
  353.                        (i hope i didn't forgot someone!)
  354.  
  355.  
  356.  
  357. ═══[ CREDITS ]═════════════════════════════════════════════════════════════════
  358.  
  359.         Coded by Frank Q.
  360.  
  361.  
  362.  
  363.  
  364.                          real killer-credits, eh? haha
  365.  
  366.  
  367.  
  368.  
  369.     Ok, that's it, if you've got any problems with PCB-RESUME contact me or
  370.                           call Tippies Palace.
  371.  
  372. l8r
  373.  
  374.                 Frank
  375.  
  376.  
  377.  
  378.  
  379. ───────────────────────────────────────────────────────────────────────────────
  380. PCB-RESUME V1.0 (c)1994 by Q-TiP PCBoard-Development
  381.  
  382. <End Of File>
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.