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