.-------------==[ 100% CNet Innovation! ]==-----------. | .#### | | .#### .o######o. .o######o. .0#0. .####" | | 0##### ####" #### ####" #### #[ ]#.####" | | #### #### .#### #### .#### "0#0"####" | | #### ####o##### ####o##### .####.0#0. | | #### ########## ########## .####"#[ ]# | | #### "0######0" "0######0" .####" "0#0" | | ####" | `----------------==[ H Y D R A / 3 ]==--------------' The SATISFYING Hydra implementation for CNet/3 :) 02-05-95 (c) by Dreamer / Shoot! & 100% Neurodancer / Abyss & 100% - -- Contents ]----. - -- --- --------------' 1. Short Description 2. Disclaimer 3. Features 4.1. Introduction 4.2. What is Hydra?! 4.3. Theory of Operation 5.1. Needful Things 5.2. Installation 5.3. Configuration 6.1. How to use it 6.2. How to let your users use it 7. History 8. How to get in touch 9. This and that - -- 1. Short Description ]----. - -- --- --------------------------' Program: Hydra/3, V0.15beta Function: Support of the Hydra protocol in CNet Authors: Dreamer/SHT/1OO% Neurodancer/AYS/1OO% Releasedate: Tue 02-May-1995 12:00 - -- 2. Disclaimer ]----. - -- --- -------------------' This software is subject to the "Standard Amiga FD-Software Copyright Note" It is Freeware as defined in paragraph 4a. (Although it would be nice if you drop a mail to one of us, if you use and like this product.) For more information please read "AFD-COPYRIGHT" (Version 1 or higher). - -- 3. Features ]----. - -- --- -----------------' o Reads CNet's Selectlist and creates Hydra sendlist o Transfers run over a temporary dir - no orphan files in any subboard when transfer gets interrupted! o Fully aware of *ALL* influences on transfer, such as byte/file credits; daily bytes/files; disabled ratios; etc. o Analyses Hydra's result-log for filenames & sizes o Adds uploaded files into CNet's dirlisting; files are online immediately after successful transfer! o Describes uploaded files the normal way, thus you can use your preferred File_ID.diz processor or whatever! o Sysop only must move files from tempdir to the final location o Gives correct upload credits depending on users ratio o Writes CNet conform into the up/download logfile o Fully aware of carrier losses & resumable files; writes automail & prompts user for upload resume! o utterly easy installation, needs very few configuration; only 2 changes to your bbstext, 1 extra subboard, 1 change in the main program, and you're ready to burn something! o Localized. Multiple language output possible! o Fully multiline aware, gets the devicename and unitnumber of the serial from CNet's main configuration. - -- 4.1. Introduction ]----. - -- --- -----------------------' Maybe you've heard about that Hydra-thingie and the things it does before, but because your beloved BBS program (namely CNet ;) doesn't support it, you never got in touch with it. Until now... - -- 4.2. What is Hydra?! ]----. - -- --- --------------------------' Hydra (or Hydracom) is a bi-directional protocol. You can upload and download at the same time, without any noticable loss on the CPS side. While you are transferring data, you also can chat with the remote side. - -- 4.3. Theory of Operation ]----. - -- --- ------------------------------' First, the Selectlist of CNet has to be translated into a Hydra sendlist, and it also has to be "parsed" to find all the values for deducting credits and all that stuff. Second, Hydra is invoked (this is the easiest part of the job), and the items in the sendlist will be transferred to the user while at the same time he can upload something. Third, the received files will be moved into the corresponding dirs, and will be *complete* processed. That is: putting them into CNet's dirlist, giving credits to uploader, check for unfinished files, and bringing CNet back to life :) ... - -- 5.1. Needful Things ]----. - -- --- -------------------------' - You need the following files in C: or somewhere else in your path: * Copy * Makedir * Delete * Move (submitted, as this is no standard command) * Hydracom (not submitted; try to get the file term43-extras.lha on Aminet (comm/term), which contains the actual revision of Hydracom by Olaf Barthel.) - You have to set every Port on shared mode, in order to run Hydra. - Hydra/3 uses CNet's OLM temp (as stated in Config) as its temporary Dir. This should reside anywhere in RAM:. - -- 5.2. Installation ]----. - -- --- -----------------------' - Copy all *.rexx files to 'Pfiles:Hydra3/' - Edit CNet:bbsmenu. Add the following new commands below all other commands in the "4; ud/base" menu: HYdra |#0Pfiles:Hydra3/Hydra3-Main.rexx}| SETALLBACK |#0Pfiles:Hydra3/Hydra3-Post.rexx}| ^--- CTRL-Q - Edit CNet:bbstext, and change the following lines (take care of not adding more lines than there were before!) Line 80: n1Lost carrier.n1#0 Pfiles:Hydra3/Hydra3-Lost.rexx} Add to Line 394: t68 #163}JN 1}#0Pfiles:Hydra3/Hydra3-Adds.rexx}1} e.g. in the original bbstext: n1q0c6(c7v48}c6)c7 v49}> q1t68 #163}JN 1}#0Pfiles:Hydra3/Hydra3-Adds.rexx}1} - Now set up an new Subboard escpecially for Hydra-Transfers. ATTENTION: The Direcory (on Disk) MUST NOT be "UDbaseX:Hydra", as this is the automatically created directory from the script! The following entries are used by Hydra/3 directly: Upload file ratio# (to determine which credit-ratio to use from the Upload file ratio# user's account.) Upload time return % (set this to 0 if You don't like this. At default, 100% of the time used for upload will be added to the users onlinetime. Note that the added time depends on how much the user uploads, not on the time needed for the whole transfer.) - -- 5.3. Configuration: ]----. - -- --- -------------------------' Explanation of Config in "Hydra3-Main.rexx": - -- --- -------------------------- --- -- - aocom="AO" /* BBSCommand for "Adopt Orphans" */ wrcom="wr" /* BBSCommand for "Write" Description */ . `--> BBScommands. May differ in your enviroment, so edit if necessary. newname.0="new" /* Show "New" - Language 0 */ newname.1="neu" /* Show "New" - Language 1 */ . `--> In some languages, "New" may be called otherwise. hydradir="z1[ HYDRA-TRANSFER! ]z0" /* Title of the UL-Tmp-Dir */ . `--> This is the Title of the Hydra-Transfer-Subboard. Needed to recognize wether or not the user is in the correct location for hydra transfers. Note that it HAS to be the complete name, including MCI-Codes you might use to especially highlight this subboard in the list. (Note: it would NOT be absolutely necessary to receive files into this special subdirectory, but as it speeds up things A LOT when processing a [nearly] empty directory, we decided to implement it this way.) ** Edit the multilanguage config, if needed! When translating, we were assuming that you use "0", english, as default language. "1" is provided as a german text. You may add/change the trans- lation for your personal needs. Explanation of Config in "Hydra3-Post.rexx" and "Hydra3-Lost.rexx": - -- --- ------------------------------------------------- --- -- - ** Just edit the multilanguage config, if needed! Nothing to change in "Hydra3-Adds.rexx" ;) - -- 6.1. How to use it... ]----. - -- --- ---------------------------' Things are pretty easy for your users once you have successfully installed the program. They may type "HYdra" at any subboard command prompt. If the user is not in the correct subboard, he will be prompted to enter the Hydra transfer subboard. If the user is in the correct subboard, the selectlist will be processed, and it ends up in a prompt were the user is asked if he is sure to start the transfer. At this point, it depends on what terminal software your user has and how Hydra is implemented on HIS end. On YOUR side, after pressing CR/Y HydraCom will be invoked and you're ready to go. - -- 6.2. How to let your users use it ]----. - -- --- ---------------------------------------' Depending on the terminal software your user runs, there are different solutions for the Hydra task. We know of at least 2 solutions for each NComm, Term, and Terminus. The cornerstone is that the terminal must be able to open the serial.device in shared mode. Almost every BBS had those Hydra installation packets for each and every terminal a few month ago when the big Hydra run on the Amiga started. Look there for any solutions. One of the best might be to use the new "transfer" settings in Term 4.3a. - -- 7. History ]----. - -- --- ----------------' V 0.0 - V0.14 Internal revisions for beta-testing-purposes only V 0.15 beta Initial release to the Public (Why beta? Because we were not able to test it on some system with more than one port. But it should work, as far as we can see...) - -- 8. How to get in touch ]----. - -- --- ----------------------------' For suggestions, Bug-Reports and Arexx-Tech-Talk ( ;) ) drop a mail to 90191@novell1.rz.fht-mannheim.de (this is Dreamer) For anything, but swapping, mail: neurodancer@highvolt.gun.de (Obviously, this is Neurodancer ;) - -- 9. This and that... ]----. - -- --- -------------------------' First some greetings and "Thank You!"s from Dreamer: - Neurodancer... Thanx, pal! (Nothing more, nothing less!) - Logo... For giving me the initial kick on how to get this thingie workin' - Aerosoul... Beta-testing-user-victim. :) - Spin... Had nothing to do with this project, but anyway... :) - Quickfinger... You were right. CNet IS the BEST! - Cyberpunk... keep it goin'! - everyone from dA sHoOt!-pOsSEy ...and Neurodancers talk: - Dreamer... thanx back. Guess we're quite a team, eh? - Anti-g... constant nagging & testing stuff! Thanx! - Hugh... Defiant is a cool ship, yezzz! The end are odd, though! - Radiosity... that voice chat is more fun. - All Abyss dudes... I'm starving for more voices... - The Coconet dudes... for being a nice community. - The rest... feel greeted, friends! And last but not least a small message to the Rainbow Hydra developers: we thought we were the first to offer a solution for integrating Hydra in CNet. Seems we were wrong, eh? :) So we could just make it better, and I think we succeeded! Maybe you can learn from our script, as we've learned from yours (FreezeIdle... Much more elegant than our workaround ;)