*************************************************************** Q U I C K S I L V E R F I L E R E Q U E S T S E R V E R *************************************************************** The ARexx Alternative by Roger Clark v1.16 28 Mar 93 *************************************************************** I. Introduction. Welcome to Quick Silver, a fully functional FidoNet file request server written entirely in ARexx. This project has taken the better part of 5 months to complete, and has been tested online for over six months with no bugs in sight. I hope to add more features in the future, but since ARexx is an interpreted language, the increase in the script size will surely decrease the execution speed. For now, it serves the files and has a few other nice features. Here's a basic overview of what is available. o MAGIC filename support, with password protection o Multiple directory paths, each can have it's own password o FTS-001 compliant NetMail status report o FTS-001 compliant NetMail for first time callers o Nodelist support to allow/not allow unlisted nodes or points access to your files o Ability to lockout specified nodes and points from your system o Filter to check for file extensions that you do not want Quick Silver to send (.info .Desc .BBS etc.) o Update Requests now supported. Format is as follows: FILENAME [!PASSWORD] +YYMMDD for files after selected date FILENAME [!PASSWORD] -YYMMDD for files before selected date o Wildcard pattern matching supported with the standard ? and * characters. II. Setup. The setup for Quick Silver is fairly straight forward, and should only take a few moments to accomplish. o Copy QSilver.rexx to your systems Rexx: directory o Make a directory for Quick Silver's data and configuration files. Example: "Mail:QSilver" o Copy "QSilver.CFG" to this directory o Make a subdirectory for Quick Silver's accounting files. Example: "Mail:QSilver/Accounts" o If you wish to use a custom HEADER file or FIRST TIME CALLER file then edit the included "QSilver.Header" and "FirstTime.TXT" and place them in the Quick Silver data directory. o Tell your mailer/frontend how to call Quick Silver. You need to pass the following to Quick Silver: [Input File] [Output File] [Configuration File] [Caller's Node Number] [Caller's Name] TrapDoor users: FREQUEST "RX QSilver.rexx %i %o {Path to QSilver.CFG} %n %S" o Edit the QSilver.CFG file to reflect your system's information III. Configuration File. Note: Parameters in [] are required, {} are optional. Keyword Description ------------ ----------------------------------------------------------------- NODE Your 4-Dimensional FidoNet Node Number. Usage: NODE [Node number] NODE 1:382/105.0 NAME Your BBS Name. Usage: NAME [BBS Name] NAME The Hotel California PRIORITY Task priority you wish Quick Silver to run at. Default is 4. Usage: PRIORITY [Task Priority] PRIORITY 0 NODELIST Path to your Nodelist Files. Required for nodelist support when using the (NO)POINT or (NO)UNLISTED keywords. Also will include data from the nodelist in your Quick Silver log file. Access to the nodelist is via the traplist.library by Martin J Laubach. Usage: NODELIST [Pathname] NODELIST DH0:Mail/Nodelist LOGFILE Path to Quick Silver's log file. Omitting this keyword will tell Quick Silver not to keep a log of the file request results for your personal records. Usage: LOGFILE [Pathname] LOGFILE DH0:Mail/QSilver/QSilver.Log ACCTPATH Path for Quick Silver's accounting files. Omitting this keyword will tell Quick Silver not to keep accounting data for calling systems. Usage: ACCTPATH [Pathname] ACCTPATH DH0:Mail/QSilver/Accounts SCREEN Public Screen name to open status window on. This can only be used with WorkBench 2.0+. Please note that screen names are case sensitive. Default is no display. Usage: SCREEN [Screen Name] SCREEN TrapDoor SCREENPOS Defines the X and Y coordinates of the upper-left corner for the status window. Only effective if SCREEN keyword is used. Default is 100 75. Usage: SCREENPOS [X-Coordinate Y-Coordinate] SCREENPOS 100 75 HEADER Path and name of Header file for Quick Silver's report file. Omitting this keyword will create a report file with a generic header. Usage: HEADER [Path to file] HEADER DH0:Mail/QSilver/QSilver.Header FIRSTCALL Path and name of the data file to be sent to first time callers. Omitting this keyword will tell Quick Silver not to send a file to first time callers. Usage: FIRSTCALL [Path to file] FIRSTCALL DH0:Mail/QSilver/FirstTime.TXT MAXBYTES Maximum number of bytes to be requested in one session. If the current file is large enough to exceed this limit, Quick Silver will skip this file and go on to the next, and a error message will be added to the report file to inform the caller of the problem. It is therefore adviseable to set this value larger than the biggest file that is available for requesting. If this keyword is omitted or set to zero, then no limit is imposed. Usage: MAXBYTES [Number of bytes] MAXBYTES 750000 MAXFILES Maximum number of files to be requested in one session. Quick Silver will simply stop processing the request file when it reaches the limit set with this keyword. A message will be added to the report file telling the caller that the maximum file per call limit was exceeded. If this keyword is omitted or set to zero, then no limit is imposed. Usage: MAXFILES [Number of files] MAXFILES 10 MAXMATCH Maximum files to match with a single wildcard. Quick Silver will only send as many matches to a wildcard as you specify. If this keyword is omitted or set to zero, then all files that match the requested wildcard will be sent. NOTE: *.* is not accepted as a valid wilcard, nor is any other *. wildcard. ie: *.LHA would be rejected as a bad wildcard pattern. Usage: MAXMATCH [Number of matched files to send] MAXMATCH 5 MAGIC Defines a standard name for a file to be requested and may be followed by the PASSWORD keyword. Usage: MAGIC [Magic Filename] [Path] {PASSWORD} {file password} MAGIC Files DH0:BBS/Files.LHA MAGIC QSilver DH0:Beta/QSilver.LHA PASSWORD Secret DEFCOMMENT Defines the comment that Quick Silver should use in its reply message if the filenote for a requested file is not set. Usage: DEFCOMMENT [Comment] DEFCOMMENT No File Description Available DEFAULTSEND Defines a file that will be sent with every file request. This flie is sent only if the file request resulted in files being sucesfully requested and sent. If this keyword is omitted then no file will be sent. Usage: DEFAULTSEND [Path] DEFAULTSEND BBS:NewFiles.LHA DIRECTORY Defines the directory path(s) to be searched for requested files and may be followed by the PASSWORD keyword. If the PASSWORD keyword is specified, then all files in that directory will require the password if they are to be sucessfully requested. It is advised that you list the paths that receive the most requests at the beginning of the list, as Quick Silver searches for files in the order of paths specified. Usage: DIRECTORY [Path] {PASSWORD} {directory password} DIRECTORY DH0:Files/TransAmiga DIRECTORY DH0:Files/TA-Betas PASSWORD Confidential POINTS Allow or not allow points to request files from your system. NOPOINTS Usage: POINTS or: NOPOINTS POINTS UNLISTED Allow or not allow unlisted systems to request files from your NOUNLISTED system. Usage: UNLISTED or: NOUNLISTED NOUNLISTED PASSWORD Defines the password for a DIRECTORY or MAGIC filename Usage: PASSWORD [Password] IGNORE Tells Quick Silver to ignore any files with the indicated filetype. Specify one file extension per IGNORE statement. Usage: IGNORE .INFO IGNORE .DESC IGNORE .BBS EXCLUDE Tells Quick Silver not to accept File Requests from the node or point specified after the keyword. Specify one node per EXCLUDE statement. Specify the full 4D address (Z:N/n.p) when listing the node number. Usage: EXCLUDE 1:234/56.0 EXCLUDE 2:345/67.8 IV. Registration This program is released as SHAREWARE. If you use Quick Silver for more than 30 days, you must register the program or stop using it. I do not like CRIPPLEWARE, nor do I like REQUESTORS as reminders, so you won't be annoyed by either of these. I ask that you send a $15 registration fee to me, and in return you will be entitled to the 'C' version when it is completed. You can also run the compiled ARexx version if you want, which is many times faster than the simple ARexx version. Please send your registration fee, payable to: Roger Clark 234 Simpson St Austin TX 78719 ---------------------- [EOF]