home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / EZYAD300.ZIP / EZYAD300.DOC < prev    next >
Text File  |  1994-02-05  |  22KB  |  454 lines
  1.                     ███████                █████      ██
  2.                     ██   ██               ██   ██     ██
  3.                     ██                    ██   ██     ██
  4.                     ██                    ██   ██     ██
  5.                     █████   ██████ ██  ██ ██   ██  █████
  6.                     ██         ██  ██  ██ ███████ ██  ██
  7.                     ██        ██   ██  ██ ██   ██ ██  ██
  8.                     ██   ██  ██    ██  ██ ██   ██ ██  ██
  9.                     ███████ ██████  █████ ██   ██  █████
  10.                                        ██
  11.                                      ███
  12.                        The Dynamic Archive Advertiser!
  13.  
  14.              (c)1993-1994 by Bob Milutinovic & The OnLine Tryst
  15.  
  16.  
  17.                                VERSION 3.0
  18.  
  19.  
  20.  
  21.  
  22.  
  23. --------------------------------------------------------------------------------
  24.                                  OVERVIEW
  25. --------------------------------------------------------------------------------
  26.  
  27.         EzyAd is a program which allows sysops to store all of their files in
  28. their original format, without advertising banners, logos, or embedded files
  29. of any kind, until such time as a user decides to download one of the files.
  30.  
  31.         It is then that EzyAd adds an advertising banner of your design, along
  32. with a descriptive "banner" detailing the downloader and originating system of
  33. the file, and an imbedded advertising file further promoting your BBS. These
  34. options are all selectable and configurable from within the ASCII EZYAD.CFG
  35. configuration file (see "CONFIGURATION" below), for optimum flexibility.
  36.  
  37.         Under normal circumstances, the sysop of an aspiring BBS will want to
  38. advertise his/her BBS as much as possible, thereby attracting a large volume
  39. of new users to keep the board thriving. The most common forms of advertising
  40. are archive headers and embedded advertising files. Unfortunately, including
  41. these in all available files tends to chew up disk space at a rather alarming
  42. rate - I use a header file of about 800 bytes in length, which in itself does
  43. not cause much concern. But multiply that by over 16000 files which I have
  44. online, and you get the point - by including the header in all of the files,
  45. I would be losing over 12.5 megabytes of storage space.
  46.  
  47.         Storing all of your files with headers presents another problem, in
  48. that should you ever decide to change the design of your header, updating the      
  49. entire filebase would be tedious and time-wasting.
  50.  
  51.         With EzyAd, you can change your header at will, and rest assured that
  52. whoever downloads a file from your system will have your latest information
  53. attached to it, and with the identifying banner being added to your advert,
  54. the user downloading the file will have less of a tendency to remove the
  55. archive header - after all, it's their name that's in the banner!
  56.  
  57.         A side benefit of EzyAd is that, because it copies all files to be
  58. processed for downloading into a temporary work directory, it can also affix
  59. your header to archives from a CD-ROM. No longer will users be downloading
  60. files from your system only to be confronted with advertisements for other
  61. BBS's. And by having the files on your hard disk drive rather than on CD, they
  62. will be transferred much faster. Users of EzyCom's CD-ROM Protocol Driver will
  63. now be able to switch back to the regular protocol driver without fear of loss
  64. of performance.
  65.  
  66.  
  67.  
  68.  
  69.  
  70. --------------------------------------------------------------------------------
  71.                                INSTALLATION
  72. --------------------------------------------------------------------------------
  73.  
  74.         EzyAd needs only two files to function - EZYAD.EXE and EZYAD.CFG. I
  75. would recommend that you place both these files in your EzyCom directory, but
  76. if you prefer keeping all your utilities in separate directories, you may
  77. place the files in any directory on any drive, as long as they are both
  78. together.
  79.  
  80.         If you are placing the EzyAd files in a directory other than your
  81. EzyCom system directory, or if you are receiving the error "EZYAD.CFG not
  82. found in current directory", you should set the EZYAD environment variable
  83. in your AUTOEXEC.BAT:
  84.  
  85.                 SET EZYAD=<path-to-EzyAd-files>
  86.  
  87.                 eg:     SET EZYAD=D:\BBS\EZYAD
  88.  
  89.         EzyAd will then search for its configuration file in that directory.
  90.  
  91.         The next step of installation requires you to go into EzyCom's CONFIG
  92. utility, and edit the Protocol Driver setup (CONFIG -> FILE AREAS -> PROTOCOL).
  93.  
  94.         Go into each of the protocol entries for which you want to use EzyAd,
  95. and edit the "Download Command" field by adding the path and filename of
  96. EzyAd, followed by "*N" enclosed in parentheses, before the command already
  97. in place for the protocol download.
  98.  
  99.         For example, for the X-Modem protocol, if you have:
  100.  
  101.                 D:\BBS\EZYPROT.EXE -N*N S X
  102.  
  103.         You would modify the line so that it reads:
  104.  
  105.                 D:\BBS\EZYAD.EXE (*N) D:\BBS\EZYPROT.EXE -N*N S X
  106.  
  107.         This is assuming that you have both the protocol driver and EzyAd in
  108. the D:\BBS directory, but you will naturally replace the drive/directory with
  109. those that are used on your system.
  110.  
  111.         Another option that I would recommend for those with ample memory, is
  112. to include the parameter "*M" at the very end of the line:
  113.  
  114.                 D:\BBS\EZYAD.EXE (*N) D:\BBS\EZYPROT.EXE -N*N S X *M
  115.  
  116.         This tells EzyCom to swap out to memory when performing the call to
  117. the protocol driver, and in effect improves the performance of EzyAd, because
  118. more memory is available to the archiving programs for processing files. If you
  119. are short on memory, exclude this option - if EzyCom has to swap out to disk,
  120. the performance gained by having the extra memory available will be lost through
  121. the time it takes to swap EzyCom out, then back in, from disk.
  122.  
  123.         Repeat the above procedure for the command line of each protocol you
  124. want EzyAd to handle, and you'll be 75% of the way to full EzyAd operation.
  125.  
  126.  
  127.  
  128.  
  129.  
  130. --------------------------------------------------------------------------------
  131.                                CONFIGURATION
  132. --------------------------------------------------------------------------------
  133.  
  134.         The most important part of setting up EzyAd is in tailoring the file
  135. EZYAD.CFG to suit your requirements. Without it, EzyAd will not function - and
  136. if it is incorrectly set up, EzyAd will become more of a nightmare than a
  137. utility.
  138.  
  139.         Supplied within this archive is a sample configuration file so you
  140. can get a quick idea of how EZYAD.CFG should look on your system, but your
  141. best bet would be to read through the options listed below carefully, before
  142. creating your own EZYAD.CFG (or modifying the sample EZYAD.CFG).
  143.  
  144.         Please note that blank lines, as well as anything after an apostrophe
  145. (') are ignored by EzyAd, so you can space out lines and add comments for your
  146. own reference later on.
  147.  
  148.         Entries in the EZYAD.CFG file comprise a keyword, an equal sign (=),
  149. and a parameter. The keyword specifies which option of EzyAd you want to define,
  150. while the parameter tells it what value you want the option to assume.
  151.  
  152.         The keywords and their meanings are as follows:
  153.  
  154. EZYPATH=        (required)      The complete path to your EzyCom system files
  155.                                 eg: EZYPATH=D:\BBS\
  156.  
  157. HANDSHAKE=      (required)      Which type of handshaking EzyAd should use
  158.                                 when communicating with your modem. The options
  159.                                 are "H" for hardware (CTS/RTS) handshaking, "S"
  160.                                 for software (XON/XOFF) handshaking, or "B" for
  161.                                 both hardware and software handshaking. I would
  162.                                 recommend that you use the hardware setting, but
  163.                                 there may be situations where you need to use
  164.                                 one of the others.
  165.                                 eg: HANDSHAKE=H
  166.  
  167. TEMPPATH=       (required)      The path to the temporary directory which EzyAd
  168.                                 will use to process downloadable files.
  169.                                 eg: TEMPPATH=D:\BBS\TEMP\
  170.  
  171. FLISTFILE=      (required)      The full path and name of the download batch
  172.                                 list that EzyCom creates when a batch download
  173.                                 begins. In the case of EzyCom's EZYPROT driver,
  174.                                 with the default configuration, this file will
  175.                                 be DNFILES. To check the name of the file which
  176.                                 EzyCom creates, look at the "Ctrl Name" entry
  177.                                 in the protocol driver screen in CONFIG. Note
  178.                                 that you should NOT include any file extension,
  179.                                 as EzyAd will append the node number as the
  180.                                 file extension, as in DNFILES.1, DNFILES.2, etc.
  181.                                 eg: FLISTFILE=D:\BBS\DNFILES
  182.  
  183. LOGOFILE=       (optional)      The full path and name of the text file which
  184.                                 you want EzyAd to use for creating the headers
  185.                                 on downloadable archive files.
  186.                                 eg: LOGOFILE=C:\UTILS\SMALL\TRYST.TXT
  187.  
  188. CDROM=          (optional)      If you have a CD-ROM, you can specify here
  189.                                 which drive letter your CD-ROM is identified
  190.                                 with. This tells EzyAd to copy ALL files from
  191.                                 this drive into the temporary directory, even
  192.                                 if they will not be processed with the archive
  193.                                 advertising option. Only one drive letter is
  194.                                 allowed per CDROM= statement, but you can have
  195.                                 up to 26 CDROM= statements in your EZYAD.CFG
  196.                                 file.
  197.                                 eg: CDROM=I:
  198.  
  199. BANNER=         (optional)      This tells EzyAd whether you want the user's
  200.                                 name or alias to be entered into the banner
  201.                                 added to the file being downloaded. The valid
  202.                                 options are "NAME" and "ALIAS".
  203.                                 eg: BANNER=ALIAS
  204.  
  205. BANNERLOC=      (optional)      This specifies whether you want the banner to
  206.                                 be placed in the archive header above or below
  207.                                 your logo. Valid options are "TOP" and "BOTTOM".
  208.                                 eg: BANNERLOC=BOTTOM
  209.  
  210. BORDER=         (optional)      This defines which type of border you'd like
  211.                                 drawn around the banner. Refer to "BANNER"
  212.                                 below for a description of the different types
  213.                                 of borders available. Valid options are 1-6.
  214.                                 eg: BORDER=3
  215.  
  216. PESTFILE=       (optional)      If you would like EzyAd to embed a file into
  217.                                 the archives being downloaded, for example a
  218.                                 self-displaying ANSI file which so many BBS's
  219.                                 use, you can specify it here. You need to
  220.                                 specify the full path and name of the file.
  221.                                 eg: PESTFILE=C:\UTILS\SMALL\U_READ.ME
  222.  
  223.  
  224.  
  225.  
  226.  
  227. --------------------------------------------------------------------------------
  228.                                     BANNER
  229. --------------------------------------------------------------------------------
  230.  
  231.         A vital factor in effective advertising in archived files is stopping
  232. the users who've downloaded the file from deleting the header, which many people
  233. do to preserve disk space on their own system. The most effective means (short
  234. of purchasing an ARJ Security Envelope package) I've found is to include the
  235. person's details in the archive header - this will make them proud of that fact
  236. when they proceed to upload the file, with the archive header intact, to another
  237. BBS.
  238.  
  239.         With EzyAd, you can specify the creation of a banner which will be added
  240. to your logo file while it's being placed in the archive header. You can specify
  241. whether this banner should be placed above or below your logo file and whether
  242. it should contain the name or the alias of the person downloading the file,
  243. depending on your personal preferences and the orientation of your BBS.
  244.  
  245.         You can further specify which type of border EzyAd should place around
  246. the banner - currently, there are six types available, and all are listed below:
  247.  
  248. Banner type 1:
  249.  
  250. +-----------------------------------------------------------------------------+
  251. |            This file (EZYAD300.ARJ) was downloaded by BLUEBEARD             |
  252. |          from THE ONLINE TRYST at 2:45pm on Saturday, 05-Feb-1994           |
  253. +-----------------------------------------------------------------------------+
  254.  
  255. Banner type 2:
  256.  
  257. ┌─────────────────────────────────────────────────────────────────────────────┐
  258. │            This file (EZYAD300.ARJ) was downloaded by BLUEBEARD             │
  259. │          from THE ONLINE TRYST at 2:45pm on Saturday, 05-Feb-1994           │
  260. └─────────────────────────────────────────────────────────────────────────────┘
  261.  
  262. Banner type 3:
  263.  
  264. ╔═════════════════════════════════════════════════════════════════════════════╗
  265. ║            This file (EZYAD300.ARJ) was downloaded by BLUEBEARD             ║
  266. ║          from THE ONLINE TRYST at 2:45pm on Saturday, 05-Feb-1994           ║
  267. ╚═════════════════════════════════════════════════════════════════════════════╝
  268.  
  269. Banner type 4:
  270.  
  271. ╓─────────────────────────────────────────────────────────────────────────────╖
  272. ║            This file (EZYAD300.ARJ) was downloaded by BLUEBEARD             ║
  273. ║          from THE ONLINE TRYST at 2:45pm on Saturday, 05-Feb-1994           ║
  274. ╙─────────────────────────────────────────────────────────────────────────────╜
  275.  
  276. Banner type 5:
  277.  
  278. ╒═════════════════════════════════════════════════════════════════════════════╕
  279. │            This file (EZYAD300.ARJ) was downloaded by BLUEBEARD             │
  280. │          from THE ONLINE TRYST at 2:45pm on Saturday, 05-Feb-1994           │
  281. ╘═════════════════════════════════════════════════════════════════════════════╛
  282.  
  283. Banner type 6:
  284.  
  285. ░░░░░░░░░░▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓███████████████████▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒░░░░░░░░░░
  286. ░░░░░░░░░░▒▒ This file (EZYAD300.ARJ) was downloaded by BLUEBEARD ▒▒▒░░░░░░░░░░
  287. ░░░░░░░░░░ from THE ONLINE TRYST at 2:45pm on Saturday, 05-Feb-1994 ▒░░░░░░░░░░
  288. ░░░░░░░░░░▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓███████████████████▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒░░░░░░░░░░
  289.  
  290.  
  291.  
  292.  
  293.  
  294. --------------------------------------------------------------------------------
  295.                                ACKNOWLEDGEMENTS
  296. --------------------------------------------------------------------------------
  297.  
  298.         Special acknowledgements are due to the following people and companies
  299. for their products, without which EzyAd would not be in existence:
  300.  
  301.                 EZYCOM      -   Peter Davies & The EzyCom Development Group
  302.                 PKZIP       -   Phil Katz & PKWare    
  303.                 ARJ         -   Robert K. Jung    
  304.                 SQZ         -   Jonas I. Hammarberg
  305.  
  306.         Note also that the program names listed above are the trademarks or
  307. registered trademarks of the people and companies listed.
  308.  
  309.  
  310.  
  311.  
  312.  
  313. --------------------------------------------------------------------------------
  314.                                COPYRIGHT NOTICE
  315. --------------------------------------------------------------------------------
  316.  
  317.         EzyAd shall at all times remain the property of the Bob Milutinovic,
  318. the author, and The OnLine Tryst. Under no condition may it be used to achieve
  319. monetary or other gain, or be disassembled or decompiled or modified, or 
  320. distributed contrary to the distribution guidelines listed below under 
  321. "DISTRIBUTION", without the express written permission of Bob Milutinovic 
  322. and/or The OnLine Tryst.
  323.  
  324.         By using EzyAd, you agree to abide by these conditions, and acknowledge
  325. that any breach of these conditions shall be cause enough for prosecution to
  326. take place.
  327.  
  328.  
  329.  
  330.  
  331.  
  332. --------------------------------------------------------------------------------
  333.                                  DISTRIBUTION
  334. --------------------------------------------------------------------------------
  335.  
  336.         EzyAd may be freely distributed among users of computer bulletin board
  337. systems, as long as the following conditions are met:
  338.  
  339. 1. That the file shall be distributed in archived form, and named EZYAD300,
  340.    with the extension of your preferred archiver appended (eg. EZYAD300.ZIP).
  341.  
  342. 2. That the archive shall include all of the following files in unmodified form:
  343.  
  344.                         EZYAD.EXE
  345.                         EZYAD.CFG
  346.                         WHATSNEW.300
  347.                         EZYAD300.DOC
  348.                         200TO300.DOC
  349.                         REGISTER.DOC
  350.  
  351. 3. That there be no charge levied specifically for the distribution of EzyAd
  352.    over and above the charge which may be charged by a particular BBS or vendor
  353.    for the distribution of any other file on the system.
  354.  
  355. 4. That EzyAd is not distributed as part of any other software package, be it
  356.    commercial, shareware, or public domain, nor as part of a hardware package.
  357.  
  358.         Failure to comply with these conditions will render you liable to the
  359. same consequences as those for breaching the copyright agreement above.
  360.  
  361.  
  362.  
  363.  
  364.  
  365. --------------------------------------------------------------------------------
  366.                                    WARRANTY
  367. --------------------------------------------------------------------------------
  368.  
  369.         EzyAd is hereby guaranteed to do as it damn well pleases, when and if
  370. it suits its mood, and to whom it desires. It is further guaranteed to occupy
  371. disk space if it is copied onto your disk(s).
  372.  
  373.         Other than the express guarantees listed in the paragraph above, there
  374. are NO warranties of ANY kind given with EzyAd, and by using or attempting to
  375. use EzyAd, you automatically indemnify Bob Milutinovic, The OnLine Tryst, and
  376. any other associated parties, from any damages incurred or incurrable from the
  377. use or inability to use EzyAd in any particular function.
  378.  
  379.  
  380.  
  381.  
  382.  
  383. --------------------------------------------------------------------------------
  384.                                  REGISTRATION
  385. --------------------------------------------------------------------------------
  386.  
  387.         EzyAd is distributed as a SHAREWARE product. That is, you are allowed to
  388. evaluate it for a period of up to 21 days without any responsibilities to the
  389. author. If, after evaluating it, you decide you wish to continue to use it, you
  390. MUST register the product, or discontinue its use.
  391.  
  392. ************************* REGISTRATION OF EZYAD IS FREE ************************
  393.  
  394.         There are no registration fees that need to be paid for the registration
  395. of EzyAd - I know how limited sysops' funds are, without the need to add yet
  396. another bank account crippling registration fee.
  397.  
  398.         All that you are required to do is to send a netmail message to Bob
  399. Milutinovic at any of the addresses listed at the end of this document, stating
  400. that you have decided to use EzyAd on a regular basis, along with the name you
  401. wish to appear on your screen when EzyAd is invoked.
  402.  
  403.         Once registered, EzyAd will display a line similar to:
  404.  
  405. ■ This copy of EzyAd is registered to Bob Milutinovic of The OnLine Tryst
  406.  
  407.                                       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  408.         It is this part of the registration line that you supply. It can be
  409. your name, your BBS's name, or both. The only restriction is that it may not
  410. be longer than 40 characters.
  411.  
  412.         Upon registration, you will be sent back a netmail message with a 4-
  413. digit registration key, which you should add to your EZYAD.CFG file in the
  414. following fashion:
  415.  
  416. 1. Add the entry REGISTER= to your EZYAD.CFG file, followed by the registration
  417.    name you used when sending in the netmail message for registration. This
  418.    needs to be EXACTLY the same as the one in the message, INCLUDING upper and
  419.    lower case - if it's at all different, EzyAd will refuse to recognise that
  420.    you've registered.
  421.    eg: REGISTER="Bob Milutinovic of The OnLine Tryst"
  422.  
  423. 2. Add the entry REGKEY= to your EZYAD.CFG file, followed by the 4-digit key
  424.    which you received by registering EzyAd.
  425.    eg: REGKEY=2123
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432. --------------------------------------------------------------------------------
  433.                              CONTACTING THE AUTHOR
  434. --------------------------------------------------------------------------------
  435.  
  436.         Should you have any difficulties in setting up EzyAd for use on your
  437. system, or have a desire to contact the author with suggestions or any other
  438. comments regarding EzyAd, you can do so by any of the following means:
  439.  
  440. Post:           Bob Milutinovic
  441.                 The OnLine Tryst
  442.                 P.O. Box 1200
  443.                 Liverpool  NSW  2170
  444.                 Australia
  445.  
  446. Telephone:      +61-(0)18-868-152
  447.  
  448. Netmail:        3:713/111 @ FidoNet
  449.                 61:9600/240 @ WorldNet
  450.                 69:1171/807 @ AdultLinks
  451.                 151:6121/964 @ EzyNet
  452.                 7:696/69 @ HeartNet
  453.                 181:100/210 @ MysticNet
  454.