home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / sunrise / clasfy30.zip / CLASSIFY.DOC < prev    next >
Text File  |  1993-07-15  |  41KB  |  915 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                              CLASSIFIED ADS
  11.  
  12.                                   v3.0
  13.  
  14.                                    by
  15.  
  16.                               Al Lawrence
  17.  
  18.                             Sunrise-80  BBS
  19.                     (404) 256-9525 (19.2 HST DS v.32)
  20.                     (404) 705-9104 (14.4 v.32bis)
  21.                             FIDO 1:133/410
  22.  
  23.  
  24.  
  25.  
  26.                  Copyright  1992 - 1993,   Al Lawrence
  27.                           All Rights Reserved
  28.  
  29.  
  30.                           Table of Contents
  31.                           -----------------
  32.  
  33.     Overview.......................................................... 1
  34.     Installation...................................................... 2
  35.     Configuration File Description.................................... 3
  36.     Restrictions...................................................... 4
  37.     Modify an Ad...................................................... 4
  38.     Download Ads...................................................... 4
  39.     Reading Ads Offline............................................... 5
  40.     Topics File (CLTOPICS)............................................ 6
  41.     Category File..................................................... 7
  42.     Welcome and Goodbye Files......................................... 8
  43.     'Pay to Advertise'................................................ 9
  44.     Purging Ads, Messages............................................. 10
  45.     Database Exchange................................................. 11
  46.     Setting up a Hub to Exchange files................................ 13
  47.     Non-Standard COM Support.......................................... 15
  48.     Multi-Node Setup.................................................. 16
  49.     File Transfer Protocols (PROTOCOL.DAT)............................ 17
  50.     File Compression (COMPRESS.DAT)................................... 18
  51.     Limiting Exports by Category (CLEXPORT.DAT)....................... 19
  52.     Maintenance Program (CLMAINT)..................................... 20
  53.     PrePaid Ads....................................................... 21
  54.     Legalities........................................................ 22
  55.     Distribution...................................................... 22
  56.     Registration...................................................... 22
  57.     Misc.............................................................. 23
  58.  
  59.                                                                        Page 1
  60.                                 OVERVIEW
  61.                                 ________
  62.  
  63.  
  64.    The CLASSIFIED Ads Door is designed to allow callers to post Classified Ads
  65.    in any of the unlimited categories you have set up. You can designate each
  66.    category to be "FREE" or "PAY". "PAY" categories give you the option of
  67.    charging businesses/individuals for posting their ads; similar to your
  68.    local newspapers.
  69.  
  70.  
  71.  
  72.    NOTE: Most errors will be logged to a file called DFRAME.ERR which is
  73.          created in the Classified Door directory.
  74.  
  75.  
  76.  
  77.                                                                        Page 2
  78.                               INSTALLATION
  79.                               ____________
  80.  
  81.  
  82.    Installation is fairly easy and straight-forward. The following steps and
  83.    examples should have you up and running in a very short period of time.
  84.    It is assumed that you are familiar with setting up DOORS on your system.
  85.    To this end, only examples of the configuration file and Door batch file
  86.    (if required by your BBS software) are described.
  87.  
  88.       1) Create a directory to hold all CLASSIFY files
  89.  
  90.       2) Unzip CLASFYxx.ZIP into the the above directory
  91.  
  92.       3) Create a configuration file, with a name of your choice, or modify
  93.          the supplied CLASSIFY.CFG file. You can do this manually with an editor
  94.          of your choice OR you can use the configuration option in the
  95.          Classified Ads Maintnenance program (CLMAINT). The configuration file
  96.          layout/description can be found further on in this document
  97.  
  98.       4) Create a batch file or modify the CLASSIFY file supplied (if your BBS
  99.          software requires the use of a batch file to execute the door). A
  100.          description of this file follows:
  101.  
  102.             ECHO off
  103.             cd\BBS\DOORS\CLASSIFY     Location of CLASSIFY files
  104.             CLASSIFY CLASSIFY.CFG     EXE filename and CFG filename (Name
  105.                                       used in creating file in #3 above)
  106.             CD\BBS
  107.             BOARD
  108.  
  109.  
  110.        5) When running more than one node, read MULTI-NODE SETUP further on
  111.           in this document.
  112.  
  113.  
  114.        6) Unzip CLBATCH.ZIP, which contains working batch files examples for
  115.           some popular protocols.
  116.  
  117.                                                                        Page 3
  118.                         CLASSIFIED ADS CONFIGURATION FILE
  119.  
  120.    **                       Location of system file (See Below)
  121.    SUNRISE-80 BBS           Your BBS Name
  122.    Al                       Sysop's First name
  123.    Lawrence                 Sysop's Last Name
  124. |-----------------------------------------------------------------------------|
  125. | READ!     1                        CommPort  \ These 2 lines are required   |
  126. | READ!     1                        Node #    / ONLY for GTUSER.BBS          |
  127. |-----------------------------------------------------------------------------|
  128.    00000000                 Registration Number
  129.  # 2                        Keyboard timeout value in Minutes
  130.  # NONE                     Drive:\Path\Filename to contain the Bulletin
  131.                             summarizing all Ads in the database
  132.  
  133.    Y                        Y=Display the Originating BBS Name, N = Do NOT
  134.  
  135.    N                        Y =  Use European Date Format (DDMMYY)
  136.                             N =  Use Regular  Date Format (MMDDYY)
  137.  
  138.    0                        Minimum Logon Security Level required to use the new
  139.                             AD option. Zero(0) will allow access to everyone.
  140.  
  141.    0                        Minimum Logon Security Level required to use the
  142.                             DELETE option. Zero(0) will allow access to everyone
  143.  
  144.    0                        Minimum Logon Security Level required to use the
  145.                             MODIFY option. Zero(0) will allow access to everyone
  146.  
  147.    0                        Minimum Logon Security Level required to use the
  148.                             MESSAGES option. Zero(0) allows access to everyone.
  149.  
  150.    00000000                 Ads Exchange Program Registration Number
  151.  
  152.    SUN80                    Name of the EXPORT file that is generated by the
  153.                             CLEXCH program. We suggest that it be a unique name.
  154.                             DO NOT include an extension! Maximum of 6 characters
  155.  
  156.    WELCOME                  Name of the WELCOME file. CAN contain an extension.
  157.  
  158.    GOODBYE                  Name of the GOODBYE file. CAN contain an extension.
  159.  
  160.    (Any Info You Wish)      Additional information about your BBS, that will be
  161.                             displayed with each Ad posted on your BBS. We
  162.                             suggest the use of the BBS telephone # as it is
  163.                             displayed adjacent to the Originating BBS Name.
  164.                             MAXIMUM of 25 characters.
  165.  
  166.    SYSOP                    BBS name the SYSOP uses when he/she logs on. When a
  167.                             caller enters an Ad in a PAY category, a message is
  168.                             sent to THIS name to notify the Sysop about the Ad.
  169.  
  170.    Y                        Y = Allow Downloading, N = NO Downloading
  171.  
  172. ** = Replace with a PATH to ONE of the following:
  173.    PCBOARD.SYS    CALLINFO.BBS   USERINFO.DAT    DOOR.SYS   GTUSER.BBS
  174.    DORINFOx.DEF   SFDOORS.DAT    CHAIN.TXT
  175.  
  176.   # = Requires registration to change to a different value.
  177.  
  178.                                                                        Page 4
  179.                             RESTRICTIONS!
  180.                             -------------
  181.  
  182.    UnRegistered versions of CLASSIFIED Ads have the following restrictions:
  183.  
  184.           . Maximum of 15 Messages may be entered
  185.           . Maximum of 20 Ads may be entered
  186.           . Purge option is disabled
  187.           . WELCOME file is not recognized
  188.           . GOODBYE file is not recognized
  189.           . Keyboard timeout value remains at 2 minutes
  190.           . Bulletin will not be generated
  191.           . Unable to Export Ads and Messages
  192.           . PAY advertising not functional
  193.  
  194.  
  195.  
  196.  
  197.  
  198.                            MODIFYING an AD
  199.                            ---------------
  200.  
  201.    All Ads may be modified by the caller that entered the Ad or the Sysop of
  202.    BBS on which the Ad was entered. If you, as the Sysop, try to modify an Ad
  203.    that was not entered on your BBS, the program will revert back to the Main
  204.    Menu.
  205.  
  206.  
  207.  
  208.  
  209.  
  210.                            DOWNLOADING  ADS
  211.                            ----------------
  212.  
  213.    Callers may download Ads by choosing the appropriate option from the main
  214.    menu. Downloading is OPTIONAL and is controled via an option in the
  215.    configuration file. Therefore, if you decide not to allow your callers to
  216.    download, you may set the appropriate option to "N" in the configuration
  217.    file. If you do permit downloading, you MUST define the protocols and
  218.    compression formats you will be supporting on your board. (See Compression
  219.    Formats and File Transfer Protocols in this document).
  220.  
  221.  
  222.                                                                        Page 5
  223.                         READING DOWNLOADED ADS OFFLINE
  224.                         ------------------------------
  225.  
  226.    Your callers have the ability to download the Ads database and read them
  227.    offline. They must use the reader supplied with the Classified Ads Door,
  228.    called CLREADER.
  229.  
  230.    Optionally, the caller can send a message to the Ad poster and upload the
  231.    message(s) to the Classified Ads door, on a subsequent call.
  232.  
  233.    There is an option on the Main Menu that will allow your callers to Download
  234.    the CLREADER.EXE and CLREADER.DOC files. You must ensure that both files
  235.    exist in the Classified Ads Directory. The files MUST NOT be compressed
  236.    (ZIPed, etc) as the caller will be given the option to choose one of the
  237.    compression routines you have defined for use with Classified Ads.
  238.  
  239.  
  240.                                                                        Page 6
  241.                                TOPICS File (CLTOPICS)
  242.                                ----------------------
  243.  
  244.    Classified Ads allows you to define an unlimited number of Categories into
  245.    which callers enter their Ads. Although this provides your callers with a
  246.    wide variety from which to choose, it takes a long time to display these
  247.    Categories on the screen (especially at lower modem speeds).
  248.  
  249.    To this end we have taken the approach that we will consolidate categories
  250.    into TOPICS and allow the caller to choose from a maximum of 30 TOPICS. As
  251.    each TOPIC is chosen we display ONLY those Categories that YOU have
  252.    associated with that TOPIC.
  253.  
  254.    If you DO NOT want to present TOPICS to your callers (yes it is optional...)
  255.    don't create the CLTOPICS file and they will be presented with the Categories
  256.    directly. OR create an ASCII file called CLTOPICS and define each topic on a
  257.    separate line, EXACTLY as you want it displayed to the caller. Each line
  258.    can have a maximum of 35 characters and a maximum of 30 TOPICS.
  259.  
  260.    Categories are defined in the CLASSIFY.CAT file. One of the entries for
  261.    each Category is the TOPICS number. This number corresponds to the line
  262.    number within the TOPICS file you wish to link to this Category. See
  263.    CATEGORY FILE discussion elsewhere in the documentation.
  264.  
  265.  
  266.  
  267.  
  268.                                                                        Page 7
  269.                         CATEGORY FILE (Classify.CAT)
  270.                         ----------------------------
  271.  
  272.        Be sure to give a lot of thought to your choice of categories, since
  273.        the category position in this file is carried in each Ad record. This
  274.        means, if you set up the categories so that #2 was 'Want Ads - General'
  275.        and the caller entered an Ad under that category, the Ad would carry
  276.        category #2 as the category number. If you then decide that you want to
  277.        change the 'Want Ad - General' category to say, 'Announcements', then
  278.        the Ads carrying #2 in their record would be classified incorrectly.
  279.  
  280.                The format of the Classify.Cat file follows:
  281.  
  282.                             TT,UUUUUUUU,VV,W,X,Y,Z
  283.  
  284.                Where t = Topic number from TOPICS file or 0 if you have
  285.                          chosen not to use TOPICS
  286.                      u = Category name. Max length: 25 characters(NO COMMAS)
  287.                      v = Maximum number of days a "FREE" ad can remain active.
  288.                          Min:1 Max 365 (This value is not used with "PAY"
  289.                          categories). Each "FREE" ad carries a purge date
  290.                          calculated by adding this value to the date the Ad
  291.                          was entered.
  292.                      w = Should the program ask for COST ($$$) info. You
  293.                          would answer Y for a For Sale type category and
  294.                          an N for a WANT AD or Announcment type category.
  295.                      x = Category security level. If caller's logon security
  296.                          level is less than this security level, they will not
  297.                          be able to enter or view an ad in this category. A
  298.                          category security level of 0 allows anyone access.
  299.                      y = Allow Ads to be downloaded from this conference.
  300.                          Y=yes, N=no
  301.                      z = 'Pay' Category.   P = Pay   F = Free
  302.  
  303.    The Classified Ads Door will check each category entry and will report
  304.    any errors it detects. Error numbers are defined as follows:
  305.  
  306.                1 = Category Name greater than 25
  307.                2 = Days to remain active is less than 0 or greater than 365
  308.                3 = COST field contains other than a Y or N
  309.                4 = Allow downloads field contains other than a Y or N
  310.                5 = PAY field contains other than a P or F
  311.                6 = The topic number is greater than the actual number of
  312.                    topics in the CLTOPICS file OR the CLTOPICS file was
  313.                    not found in the Classify directory.
  314.  
  315.                                                                        Page 8
  316.                         WELCOME and GOODBYE Files
  317.                         -------------------------
  318.       The following applies to registered versions of CLASSIFY ONLY!
  319.  
  320.       You can define the name of the WELCOME file in the configuration file.
  321.       If the program finds that filename, it will display that file after
  322.       the opening screen and before the main menu screens. The file must
  323.       reside in the same directory as CLASSIFY.EXE
  324.  
  325.       You can define the name of the GOODBYE file in the configuration file.
  326.       If the program finds that filename, it will display that file when the
  327.       caller exits the program. It will display prior to displaying the file
  328.       called ADOPT.SYS (if you have created it). The file must reside in the
  329.       same directory as CLASSIFY.EXE
  330.  
  331.  
  332.                                                                        Page 9
  333.                        "PAY-TO-ADVERTISE" Option
  334.                         ________________________
  335.  
  336.       Classified Ads can be used to charge for the placement of an
  337.       advertisement and/or allow for the ads to be placed free of charge. You
  338.       decide which on a category-by-category basis.
  339.  
  340.       You make a category a 'PAY' category by changing the appropriate entry
  341.       in the Classify.Cat file from an "F" to a "P".
  342.  
  343.       You have the option to create an ASCII file that will be displayed to
  344.       the caller, everytime they choose a particular 'PAY' category in which
  345.       to enter an ad. This file can contain any pertinant information such
  346.       as the method of payment, information required, etc. If you want the
  347.       same file to be used for ALL 'PAY' categories, then you must name the
  348.       file "PAY" (no quotes). If you want to display a unique file for some
  349.       'PAY' categories, then you must name the file  "PAYx", where x is the
  350.       line number of the corresponding entry in the ClASSIFY.CAT filer. If
  351.       the program does not find a 'PAYx" for a particular 'PAY' category, it
  352.       will then search for a "PAY" file. If neither is found it will not
  353.       display anything. We strongly suggest that you create a file for display
  354.       for all 'PAY' categories so as to ensure that the callers understand the
  355.       guidelines you have established for 'PAY' categories.
  356.  
  357.       Any ads entered into a 'PAY' category, will remain INVISIBLE to everyone
  358.       until payment is received and the Sysop makes that ad VISIBLE. You must
  359.       use the appropriate option in the Classified Ads Maintenance program
  360.       (CLMAINT) to make an ad VISIBILE. Please note that INVISIBLE ads are NOT
  361.       exported!
  362.  
  363.       The  maintenance program (CLMAINT.EXE) will display EVERY ad in the
  364.       database that is flagged as INVISIBLE. You will have the choice of
  365.       BYPASSING it, DELETING it or making it VISIBLE. Once an ad is deleted or
  366.       made VISIBLE, it can not be reversed... so BE CAREFUL!
  367.  
  368.       Registered option only.
  369.  
  370.                                                                        Page 10
  371.                            AUTOMATED PURGING
  372.                            -----------------
  373.  
  374.       When you set up the categories to be used in your version of CLASSIFIEDS,
  375.       you are asked to define the number of days the ad should remain active.
  376.       By running the CLMAINT (PURGE option) program in your nightly event
  377.       process you will ensure that the ads are deleted, automatically.
  378.  
  379.       In addition to purging expired ads, the CLMAINT Purge option will pack
  380.       the message database
  381.  
  382.       The following is all that is required to execute the purge:
  383.  
  384.                          CLMAINT CLASSIFY.CFG /EVENT
  385.                                  ^^^^^^^^^^^^
  386.                                      |
  387.                                      |------ or your congfiguration file name
  388.  
  389.           Note: This is only available in registered versions!
  390.  
  391.  
  392.   
  393.                                                                        Page 11
  394.                            DATABASE EXCHANGE
  395.                            _________________
  396.  
  397.   ** A GREAT WAY TO SHARE THE CLASSIFIED ADS DATABASE BETWEEN 2 OR MORE BBS' **
  398.      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  399.       The optional Classified Ads Database Exchange feature will allow you
  400.       to participate in the exchange of Classified Ads databases (Ads and
  401.       Messages) BBS' (Any number of BBS' can participate). The exchange
  402.       program is named CLEXCH and comes included in the CLASFYxx.ZIP file.
  403.  
  404.       CLEXCH performs three (3) major functions:
  405.  
  406.      (1) EXPORT:  Extracts all active ads and messages from the Classified
  407.                   databases. It creates files named XXXXXXrr.AXP and
  408.                   XXXXXXrr.MXP (XXXXXX is defined in the CFG file, rr is a
  409.                   random letter/number combination) and will bypass any
  410.                   ad already flagged for deletion as well as those Ads that
  411.                   were previously exported.
  412.  
  413.      (2) IMPORT:  Imports files named XXXXXXrr.AXP and XXXXXXrr.MXP and
  414.                   XXXXXXrr.MXP (XXXXXX is defined in the CFG file, rr is a
  415.                   random letter/number combination) created by the EXPORT
  416.                   option and merges all ads and messages into the Classified
  417.                   databases. It will not import any ads or messages that
  418.                   duplicates ads or messages found in the existing databases.
  419.                   Note that this option will IMPORT ALL files with an extension
  420.                   of AXP and MXP, during a single execution of the program.
  421.  
  422.      (3) IMPEXP:  This option will first IMPORT (as in (2) above) then turn
  423.                   around and EXPORT (as in (1) above) during one execcution
  424.                   of the program.
  425.  
  426.      All BBS' involved in the exchange MUST run registered versions of BOTH
  427.      Classified Ads and Classified Exchange (CLEXCH).
  428.  
  429.      It is critical that ALL participants in the exchange use the SAME
  430.      Category file. Failure to do so will result in ads meant for a certain
  431.      category on one system, showing up in a category totally unrelated on
  432.      another system.
  433.  
  434.  
  435.  
  436.       N O T E:  To EXCLUDE certain categories from being exported see
  437.                 "Limiting Export by Category" elsewhere in this document
  438.  
  439.  
  440.  
  441.  
  442.                             (Continued on Next Page)
  443.  
  444.  
  445.                                                                        Page 12
  446.                         DATABASE EXCHANGE (Continued)
  447.  
  448.  
  449.      To run the Exchange you do the following:
  450.  
  451.     ************************************************************************
  452.     * >>>>> If you are acting as a HUB you MUST signal CLEXCH.EXE by using *
  453.     *       HUBEXPORT, HUBIMPORT or HUBIMPEXP in lieu of EXPORT, IMPORT or *
  454.     *       IMPEXP. If you fail to do this you will not be able to export  *
  455.     *       newly imported Ads/Messages.                                   *
  456.     ************************************************************************
  457.  
  458.      EXPORT:  a) Change to the directory containing your CLASSIFY.DAT file
  459.               b) Issue this command:  CLEXCH EXPORT CLASSIFY.CFG
  460.                  If you use a different name for your Config file, then
  461.                  substitute that name for CLASSIFY.CFG
  462.               c) Send (transmit) ALL *.AXP and *.MXP files to those involved
  463.                  in the exchange or to the HUB.
  464.               d) Delete ALL .AXP and .MXP files
  465.  
  466.      IMPORT:  a) Change to the directory containing your CLASSIFY.DAT file
  467.               b) Copy the *.AXP and *.MXP files that were sent to you by the
  468.                  BBS you are exchanging with, to the directory used
  469.                  in item (a) above.
  470.               c) Issue the command:   CLEXCH IMPORT CLASSIFY.CFG
  471.                  If you use a different name for your Config file, then
  472.                  substitute that name for CLASSIFY.CFG
  473.               d) Delete ALL *.AXP and *.MXP files
  474.  
  475.      IMPEXP:  a) Change to the directory containing your CLASSIFY.DAT file
  476.               b) Copy the *.AXP and *.MXP files that were sent to you by the
  477.                  BBS you are exchanging with, to the directory used
  478.                  in item (a) above.
  479.               c) Issue the command:   CLEXCH IMPEXP CLASSIFY.CFG
  480.                  If you use a different name for your Config file, then
  481.                  substitute that name for CLASSIFY.CFG
  482.               d) Send (transmit) ALL *.AXP and *.MXP files to those involved
  483.                  in the exchange or to the HUB.
  484.  
  485.    NOTE: When registering CLEXCH, you MUST use the EXACT SAME Sysop Name
  486.          AND BBS NAME as used for CLASSIFIED ADS!!!!!!!!!!!!!!!!!!!!!!!!!
  487.  
  488.    NOTE: All IMPORT and EXPORT transactions are now recorded in a
  489.          file called CLEXCH.LOG. If the file exists it will append
  490.          the information, if not it will create the file and add
  491.          the information. Thus you are free to delete it at any time.
  492.  
  493.  
  494.                                                                        Page 13
  495.          HOW TO SETUP AS A HUB AND DO CLASSIFIED ADS EXCHANGES
  496.          -----------------------------------------------------
  497.  
  498. Below, is a fully working batch file complete with comments, for the group
  499. hub. There are a few very important things to remember in running the
  500. Classified Ads as a hub.
  501.  
  502. FIRST, make sure all your nodes have the same categories or mass confusion
  503. will result. SECOND, it is highly advisable that you and your nodes use a
  504. unique name (representative of your board) instead of the generic
  505. "Classify.exp", for example Sun.exp would be the name for Sunrise BBS.
  506. THIRD, this batch file (Exchange.bat) is best run during your event each
  507. night, rather than each time the door is executed, especially if you are
  508. connected to boards that are long distance. The commands for your nightly
  509. event batch file would be:
  510.  
  511. CD\CLASSIFY
  512.    CLPURGE CLASSIFY.CFG
  513.    CALL EXCHANGE.BAT
  514.    DEL CLASSIFY.EXP
  515. CD\
  516.  
  517. Exchange.bat would be located in your classified directory and would be the
  518. batch file listed below. You may feel free to remove the comments and use
  519. the batch file below after modification for your system drive/path/name
  520. specifications.
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                      (Continued on Next Page)
  527.  
  528.  
  529.                                                                        Page 14
  530.  
  531.                        HUB SETUP (Continued)
  532.  
  533.  
  534. _______________________________________________________________________________
  535. BATCH FILE EXAMPLE FOR THE HUB USING THE CLASSIFIED ADS EXCHANGE PROGRAM
  536.  
  537.  
  538.  
  539. @echo off
  540. del I:\db\files\classify.exp
  541.     ^  ^^ ^^^^^
  542. Comment: Above would be the drive/path to your inbound/outbound files directory.
  543.          This command will delete your previous night's export. NOTE: DO NOT
  544.          use this command the first night you start the import/export with
  545.          other boards.
  546.  
  547. cd\db\files
  548.    copy *.exp I:\ra\doors\classify
  549.         ^^^^^
  550.    del *.exp
  551.        ^^^^^
  552.  
  553. Comment: Copy all exported files sent to you into your classified directory,
  554.          then delete all the exported files. FAILURE to use a unique .exp
  555.          name will result in files over writing and only the last .exp file
  556.          copied will be imported into your database.
  557.  
  558. cd\ra\doors\classify
  559.    clexch IMPEXP classify.cfg
  560.                  ^^^^^^^^^^^^
  561.    copy classify.exp i:\db\files
  562.         ^^^^^^^^^^^^    ^^ ^^^^^
  563.  
  564. Comment: Perform the import/export (IMPEXP) then copy the resulting export file
  565.          from your classify directory to your outbound files directory.
  566.  
  567. cd\db
  568.    dbutil i send 1:114/203 i:\db\files\classify.exp
  569.    ^^^^^^
  570.  
  571. Comment: Send the export file to the other boards. Note above that the command
  572.          used is for D'Bridge...you may substitute the proper command and
  573.          outbound files directory for your front end mailer. You will need to
  574.          do an export for every BBS connected to you.
  575.  
  576.     __________________________________________________________
  577.    | This example provided to you courtesy of: Window In Time |
  578.    |                                           1:114/203      |
  579.    |                                           602-253-1946   |
  580.    |                                                          |
  581.    |  Feel free to contact the Sysop of Window In Time!!!!    |
  582.    |__________________________________________________________|
  583.  
  584.  
  585.  
  586.  
  587.                                                                        Page 15
  588.                         NON-STANDARD COM SUPPORT
  589.                         ________________________
  590.  
  591.       Support for COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  592.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  593.       number after the configuration filename. Let's assume your Door is
  594.       called FOOBAR and you want to use COM1 and IRQ5. The command line
  595.       passed to your Door would be:
  596.  
  597.                             FOOBAR FOOBAR.CFG /5
  598.  
  599.       The /5 tells FOOBAR to use IRQ5 rather than the standard IRQ4 that is
  600.       normally used with COM1. No /x parameter is needed for the standard
  601.       IRQ's.
  602.  
  603.       As an alternative, you may use an environmental variable on the command
  604.       line. To use the variable (following the example above), place a
  605.       SET IRQ=5 in the batch file used to bring up your BBS (you would need a
  606.       different IRQ number for each node). The command line would now look
  607.       like this:
  608.  
  609.                           FOOBAR FOOBAR.CFG /%IRQ%
  610.  
  611.       This, in combination with the use of the environmental variables
  612.       described in the MULTI-NODE SETUP section will allow you to use one
  613.       batch file and one config file to run this door on all nodes.
  614.  
  615.  
  616.  
  617.   
  618.                                                                        Page 16
  619.                            MULTI-NODE SETUP
  620.                            ________________
  621.  
  622.       All Sunrise Doors are Multi-Node capable. Each node must have the
  623.       ability to access a configuration file which will have its own system
  624.       file (DORINFOx.DEF, PCBOARD.SYS, DOOR.SYS, etc) defined on the first
  625.       line. There are 2 ways to accomplish this:
  626.  
  627.       (1) Create a separate configuration file for each node. The only
  628.           difference between each file would be the location of the system
  629.           file for that particular node. For example, on my system there are 2
  630.           nodes and the first line of the config files would look like this:
  631.  
  632.                         NODE1:  H:\PCB1\DOOR.SYS
  633.                         NODE2:  H:\PCB2\DOOR.SYS
  634.  
  635.           Thus, if you have a 4 node BBS, you will need 4 configuration files.
  636.  
  637.       (2) Use ONE configuration file for ALL nodes. This Door will recognize
  638.           the following PCBoard environmental variables:
  639.  
  640.                  PCBDIR    (Directory containing the System file)
  641.                  PCBDRIVE  (Drive containing the System file)
  642.  
  643.           Thus, the first line of the SINGLE configuration file, for this Door
  644.           would look like this:
  645.  
  646.                         %PCBDRIVE%%PCBDIR%\DOOR.SYS
  647.  
  648.       NOTE: This option, as described, assumes that you are running PCBoard
  649.             14.5a software. The environmental variables are automatically
  650.             created by the software for each node.
  651.  
  652.             HOWEVER, if you are running other BBS software you should be able
  653.             to set the variables EXACTLY as described below, for EACH node
  654.             (more than likely in each batch file you use to bring up EACH node):
  655.  
  656.                             PCBDRIVE=C:
  657.                             ^^^^^^^^^
  658.                             PCBDIR=\NODE2
  659.                             ^^^^^^^^
  660.  
  661.             Info with a carat (^) under it, MUST be typed as is. The rest
  662.             depends on your naming conventions.
  663.  
  664.             This, in combination with the use of the optional environmental
  665.             variable described in the NON-STANDARD COM SUPPORT section, will
  666.             allow you to use one batch file and one config file to run this
  667.             door on all nodes.
  668.  
  669.  
  670.  
  671.                                                                        Page 17
  672.                    UPLOAD/DOWNLOAD FILE TRANSFER PROTOCOLS
  673.                    ---------------------------------------
  674.  
  675.       Classified Ads externalizes all file transfer protocols used for Uploading
  676.       and Downloading of the Classified Ads. This allows the Sysop to define the
  677.       file transfer protocols they wish to support.
  678.  
  679.       A file called PROTOCOL.DAT is supplied with protocols already defined,
  680.       which you may alter at any time. Each entry in the PROTOCOL.DAT file
  681.       consists of the description that will be displayed to the caller on the
  682.       Protocol Menu and the 'high level' name of the protocol's batch files.
  683.  
  684.                Example:  ZModem   Upload or Download, ZPROT
  685.  
  686.       The information to the left of the comma is the description. Classified
  687.       requires that you have 2 batch files in the Classified directory to handle
  688.       the uploading and downloading. In the above example ZPROT is the 'high
  689.       level' portion of the 2 batch file names required for ZMODEM. Your
  690.       Classified directory should contain ZPROTR.BAT (the R is for uploading)
  691.       and ZPROTS.BAT (the S is for downloading). The R and S suffixes MUST be
  692.       present as that is what Classified Ads will be looking for in the
  693.       Classified Ad directory!
  694.  
  695.       Each protocol batch file MUST contain 2 batch file variables as follows:
  696.  
  697.       %1 = Classified will use this variable to substitute the current ComPort
  698.       %2 = Classified will use this variable to substitute the file name
  699.  
  700.       IMPORTANT! Place the variable (%1 and %2) ONLY in the EXACT location that
  701.                  your protocol requires them, in the protocol command line. Do
  702.                  NOT supply the ComPort or FileName, JUST the %1 and %2
  703.                  variables themselves (%1 and %2)!
  704.  
  705.       See example batch files supplied with the Classified. They are the ones
  706.       being used on the Sunrise-80 BBS.
  707.  
  708.                              *** PLEASE NOTE ***
  709.  
  710.       There may come a time when you will need to supply information to the
  711.       protocol you are using, based on the node it will be used on. You can
  712.       accomplish this by supplying a node-specific PROTOCOL file. Everything
  713.       described above stays the same except that you will name the file
  714.       PROTOCOL.x (where x is the node number). For example, to use a special
  715.       set of protocols (or batch files) on node number 5, modify a copy of
  716.       PROTOCOL.DAT and name it PROTOCOL.5. CLASSIFY will use PROTOCOL.5 when
  717.       someone logs on node 5 and will use PROTOCOL.DAT for ALL OTHERS. You do
  718.       not have to create node-specific PROTOCOL files for all nodes.. just the
  719.       node(s) that are different.
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.                                                                        Page 18
  732.  
  733.                     FILE COMPRESSION (COMPRESS.DAT)
  734.                     -------------------------------
  735.  
  736.    When a caller chooses to download a file of any kind, from Classified Ads,
  737.    they are presented with a list of compression types from which to choose.
  738.  
  739.    A file called COMPRESS.DAT is supplied with several types already defined.
  740.    You are free to alter the file to reflect the ones you support. Each entry
  741.    in the COMPRESS.DAT file consists of the description that will be displayed
  742.    to the caller on the Compression Menu, the name of the compression file
  743.    name and the command used to add files to the archive.
  744.  
  745.      EXAMPLE:
  746.                  PKZip  v1.10,PKZIP -a
  747.                  ARJ    v2.3,ARJ a
  748.  
  749.  
  750.    Please note that everything to the left of the comma is part of the
  751.    description for that compression type and may be modified to your liking.
  752.  
  753.  
  754.                                                                        Page 19
  755.  
  756.                      LIMITING EXPORTS BY CATEGORY
  757.                      ----------------------------
  758.  
  759.    By default the CLEXCH (Classified Exchange) program will export ads in ALL
  760.    categories. If you wish to limit the categories that will be exported,
  761.    create an ASCII file and call it CLEXPORT.CAT and enter the category
  762.    number(s) you DO NOT want to export, ONE to a line. The category number is
  763.    the line position of the category as it exists in the CLASSIFY.CAT file.
  764.  
  765.    For example, if the CLASSIFY.CAT file contained:
  766.  
  767.              Local For Sale
  768.              National For Sale
  769.              Local Announcements
  770.              National Announcements
  771.  
  772.    and you did NOT want to export local categories, you would create
  773.    CLEXPORT.CAT and input the following in the file:
  774.  
  775.    1
  776.    3
  777.  
  778.    Those 2 entries in the CLEXPORT.CAT would tell CLEXCH to NOT export the
  779.    "Local For Sale" and "Local Announcements" categories.
  780.  
  781.  
  782.                                                                        Page 20
  783.  
  784.                     MAINTENANCE PROGRAM (CLMAINT)
  785.                     -----------------------------
  786.  
  787.    The Classified Ads Maintenance program, CLMAINT.EXE, is a menu driven
  788.    program used to perform the following functions:
  789.  
  790.    (1) Maintain the PREPAID Ads file
  791.        . Add/view/delete prepaid ads entries in the PREPAID file
  792.  
  793.    (2) Database PURGE
  794.        .Will purge Ads, Messages and Prepaid Ads entries from their
  795.         respective files if they are marked for deletion.
  796.  
  797.    (3) View/maintain the Invisible Paid ads
  798.        .When an ad is entered into a PAID category, it is made invisible
  799.         (not displayable) until you manually make it visible. This option
  800.         allows you to do this or you can view and/or delete it
  801.  
  802.    (4) Setup the Classified Ads configuraiton file
  803.        .Use this option to setup or modify a configuration file.
  804.  
  805.    (5) Reset the EXPORT flag of ALL Ads in the database
  806.        .Use this option to force ALL ads in the Ads database to be marked for
  807.         Export the next time you run CLEXCH.
  808.  
  809.    (6) Reset the EXPORT flag of ALL Messages in the database
  810.        .Use this option to force ALL messages in the Message database to be
  811.         marked for Export the next time you run CLEXCH.
  812.  
  813.  
  814.    Execution examples:
  815.  
  816.       CLMAINT CLASSIFY.CFG               <===== Manual
  817.  
  818.              or
  819.  
  820.       CLMAINT CLASSIFY.CFG /EVENT        <===== Auto purge from an Event
  821.  
  822.                                                                        Page 21
  823.  
  824.                            PRE-PAID ADS
  825.                            ------------
  826.  
  827.    This option will allow you to accept payment for ads in advance. Using the
  828.    PREPAID ads option in the maintenance program (CLMAINT.EXE), you can add,
  829.    view or delete entries in the PREPAID file. The PREPAID file will contain
  830.    the name of the caller, the Ad display time (Week/Month/Quarter/Year) and
  831.    the number of ads they have prepaid for that type of Ad.
  832.  
  833.    You must have a separate entry for each display time type for each caller.
  834.    For example, a caller named Joe Door can prepay for 2 Monthly Ads and 3
  835.    Weekly Ads. In this case you would need 2 Joe Door entries in the PREPAID
  836.    file, one for the WEEKLY Ads and 1 for the Monthly Ads.
  837.  
  838.    When the caller enters an Ad in a PAY category, Classify asks what length
  839.    of time the Ad should run. If the program finds a match in the PREPAID file,
  840.    (on caller name and display time) it will make the Ad VISIBLE, IMMEDIATELY
  841.    and decrement the number of Pre-Paid Ads by 1.
  842.  
  843.    When the Purge option in CLMAINT is run (Manually or as an Event) entries
  844.    in the PREPAID file with a zero in the number of ads filed, will be deleted.
  845.  
  846.  
  847.    
  848.                                                                        Page 22
  849.                               LEGALITIES
  850.                               __________
  851.  
  852.  
  853.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  854.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  855.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  856.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  857.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  858.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  859.       OR BREACH OF ANY WARRANTY.
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.                              DISTRIBUTION
  868.                              ____________
  869.  
  870.    You may make this file available for downloading from your BBS or you may
  871.    upload it to any BBS of your choice, provided that you do not make any
  872.    changes to the contents of the archive (ZIP file). The archive and its
  873.    individual contents may not be used by any service that charges any money
  874.    whatsoever, without the written permission of the author.
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.                              REGISTRATION
  884.                              ____________
  885.  
  886.    Registration and the subsequent insertion of the registration number into
  887.    your configuation file, will remove all restrictions deined in the section
  888.    called "Restrictions', allows for the display of your BBS name on the
  889.    opening and closing screen
  890.  
  891.    To register your copy of CLASSIFY, please fill out the registration form
  892.    (REGISTER.FRM) and mail it along with the registration fee to
  893.    the name and address on the form.
  894.  
  895.    Be sure to use the proper upper/lower case when filling in your name and
  896.    BBS name, as they MUST match the way you entered them in the configuration
  897.    file.             ^^^^
  898.  
  899.    Based upon information supplied on the registration form, I will pre-
  900.    register you on my BBS. You will then be able to call SUNRISE-80 and pick
  901.    up your registration number OR you can enclose a SASE with the form/check.
  902.  
  903.  
  904.  
  905.                                                                        Page 23
  906.                                  MISC
  907.                                  ____
  908.  
  909.    The latest version of CLASSIFIED ADS and other fine SUNRISE DOOR programs
  910.    are always available for download from SUNRISE-80 BBS.
  911.  
  912.    Remember, should you have any problems, questions or suggestions, be sure
  913.    to drop me a message on Sunrise-80 or in the RIME network (BBS_Doors,
  914.    PCBHints, SYSops) or on SMARTNET (SN_Sysops) or FIDO 1:133/410.
  915.