home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / DEMO510.ZIP / SLDOCDOS.INS / MANUAL.TXT
Text File  |  1999-01-25  |  927KB  |  20,537 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.         ------------------------------------------------------------------
  10.        |                                                                  |
  11.        |                          Searchlight BBS                         |
  12.        |                                                                  |
  13.        |                            Version 5.1                           |
  14.        |                                                                  |
  15.        | ---------------------------------------------------------------- |
  16.        |                                                                  |
  17.        |        Copyright (c) 1988-1998 Searchlight Software, Inc.        |
  18.        | Portions Copyright (c) 1994-1998 TeleGrafix Communications, Inc. |
  19.        |                        All Rights Reserved                       |
  20.        |                                                                  |
  21.        |         This software is published and distributed under         |
  22.        |            license by TeleGrafix Communications, Inc.            |
  23.        |                                                                  |
  24.        |       This software includes proprietary computer code that      |
  25.        |        is the property of TeleGrafix Communications, Inc.        |
  26.        |                                                                  |
  27.        | ---------------------------------------------------------------- |
  28.        |                                                                  |
  29.        |                  TeleGrafix Communications, Inc.                 |
  30.        |                     111 Weems Lane, Suite 308                    |
  31.        |                     Winchester, VA 22601-3600                    |
  32.        |                                                                  |
  33.        |                        540-678-4050 support                      |
  34.        |                        540-678-4051 sales                        |
  35.        |                        540-678-4052 fax                          |
  36.        |                        540-678-4053 BBS                          |
  37.        |                                                                  |
  38.        |                 Web:    http://www.telegrafix.com                |
  39.        |                 Email:  info@telegrafix.com                      |
  40.        |                 FTP:    ftp.telegrafix.com                       |
  41.        |                 Telnet: telnet.telegrafix.com                    |
  42.        |                                                                  |
  43.        |             Version 5.1, 4th Printing, September 1998.           |
  44.        |                                                                  |
  45.         ------------------------------------------------------------------
  46.                           LICENSE AGREEMENT
  47.        _____________________________________________________________________
  48.  
  49.  
  50.         -------------------------------------------------------------------
  51.        | SEARCHLIGHT BBS LICENSE AGREEMENT                                 |
  52.         -------------------------------------------------------------------
  53.  
  54.  
  55.        COPYRIGHT
  56.        ---------
  57.  
  58.        Searchlight Bulletin Board System v5.1
  59.  
  60.        Copyright (c) 1987-98 Searchlight Software, Inc.
  61.        Portions Copyright (c) 1994-1998 TeleGrafix Communications, Inc.
  62.        All Rights Reserved
  63.  
  64.        This software is published and distributed under license by TeleGrafix
  65.        Communications, Inc.
  66.  
  67.        This software includes proprietary computer code that is the property
  68.        of TeleGrafix Communications, Inc.
  69.  
  70.                          TeleGrafix Communications, Inc.
  71.                             111 Weems Lane, Suite #308
  72.                             Winchester, VA 22601-3600
  73.                              United States of America
  74.  
  75.             Voice:  (540) 678-4050      WWW:  http://www.telegrafix.com
  76.             Sales:  (540) 678-4051    Email:  sales@telegrafix.com
  77.               Fax:  (540) 678-4052      FTP:  ftp.telegrafix.com
  78.               BBS:  (540) 678-4053   Telnet:  telnet.telegrafix.com
  79.  
  80.  
  81.        DISCLAIMER
  82.        ----------
  83.  
  84.        DO NOT DOWNLOAD OR USE THIS SOFTWARE UNLESS YOU AGREE TO BE BOUND BY
  85.        THE DEFINITIONS, TERMS AND CONDITIONS OF THIS LICENSE AGREEMENT.
  86.  
  87.        YOU SHOULD READ CAREFULLY THE FOLLOWING TERMS AND CONDITIONS OF THIS
  88.        LICENSE AGREEMENT IN ITS ENTIRETY BEFORE DOWNLOADING THIS SOFTWARE.
  89.        IF YOU DO NOT AGREE WITH ALL OF THESE TERMS AND CONDITIONS, YOU
  90.        SHOULD NOT DOWNLOAD OR USE THIS SOFTWARE. ANY DOWNLOADING,
  91.        INSTALLING, LOADING OR USING THIS SOFTWARE INDICATES YOUR ACCEPTANCE
  92.        OF THE TERMS AND CONDITIONS OF THIS LICENSE AGREEMENT. IF YOU HAVE
  93.        RECEIVED THIS SOFTWARE ON MAGNETIC MEDIA AND DO NOT AGREE WITH ALL
  94.        OF THESE TERMS AND CONDITIONS, DO NOT OPEN THIS ENVELOPE.  RETURN
  95.        THE UNOPENED SOFTWARE WITHIN 30 DAYS OF THE ORIGINAL DATE OF
  96.        PURCHASE, AND YOUR PURCHASE PRICE WILL BE REFUNDED TO YOU. OPENING
  97.        THE ENVELOPE WILL VOID THIS REFUND OFFER. IF THE COPY OF THE
  98.        SOFTWARE YOU RECEIVED WAS ACCOMPANIED BY A PRINTED OR OTHER FORM OF
  99.        "HARD-COPY" END USER LICENSE AGREEMENT WHOSE TERMS VARY FROM THIS
  100.        AGREEMENT, THEN THE HARD-COPY END USER LICENSE AGREEMENT GOVERNS
  101.        YOUR USE OF THE SOFTWARE.
  102.  
  103.        _____________________________________________________________________
  104.                                          i
  105.                                  LICENSE AGREEMENT
  106.        _____________________________________________________________________
  107.  
  108.  
  109.        1 - INTRODUCTION
  110.        ----------------
  111.  
  112.        The Searchlight Bulletin Board System is a RIPscrip (Remote Imaging
  113.        Protocol scripting language) enabled  direct-dial and Telnet
  114.        accessible computer bulletin board system and Internet information
  115.        server.  THIS SOFTWARE PROGRAM IS NOT "FREEWARE" AND IS NOT IN THE
  116.        PUBLIC DOMAIN. It is copyrighted commercial software owned by
  117.        Searchlight Software Inc., an Ohio corporation, and is is published
  118.        and distributed under license by TeleGrafix Communications, Inc.
  119.        "Searchlight BBS" is a trademark of Searchlight Software, Inc. which
  120.        is licensed by TeleGrafix Communications Inc. RIPscrip (TM) is a
  121.        trademark of TeleGrafix Communications Inc.
  122.  
  123.  
  124.        2 - DEFINITIONS
  125.        ---------------
  126.  
  127.        The term "License" shall refer to this License Agreement. The term
  128.        "Software" shall refer to the files supplied via electronic download
  129.        or on diskette(s), and/or to any and all copies, upgrades,
  130.        modifications, functionally-equivalent derivatives, or any parts or
  131.        portions thereof, including any electronic, online or printed
  132.        documentation. The terms "You" and "Your" shall refer to the
  133.        organization, person and/or business entity who purchased this
  134.        License to use this Software or for whom such License was purchased.
  135.  
  136.  
  137.        3 - NONEXCLUSIVE LICENSE
  138.        ------------------------
  139.  
  140.        Pursuant to agreement with Searchlight Software, Inc., TeleGrafix
  141.        Communications Inc. ("TeleGrafix"), a Virginia corporation, licenses
  142.        You to use this Software in binary executable form only on a
  143.        non-exclusive, non-sublicensable and terminable basis. All other
  144.        rights are reserved by Searchlight and/or TeleGrafix. The Software
  145.        is licensed for Your use as a single product and its component parts
  146.        may not be separated for use by You on other computers. This License
  147.        is a legal agreement between You and TeleGrafix and it shall
  148.        continue for as long as You use the Software. You agree that we need
  149.        not sign this License in order for it to take effect. You assume all
  150.        responsibility for the installation, use and results obtained from
  151.        this Software.
  152.  
  153.  
  154.        4 - NO-CHARGE EVALUATION EDITION USE
  155.        ------------------------------------
  156.  
  157.        You are licensed to use versions of the Software that are identified
  158.        by TeleGrafix as an "Evaluation Edition" for noncommercial
  159.        evaluation purposes only without charge for a single period of sixty
  160.        (60) days, counting from the day You first install the Software.
  161.        EVALUATION COPIES OF THIS SOFTWARE CONTAIN COMPUTER CODE THAT
  162.        _____________________________________________________________________
  163.                                         ii
  164.                                  LICENSE AGREEMENT
  165.        _____________________________________________________________________
  166.  
  167.        DISABLES, OR LIMITS THE USE OF, MANY FEATURES UNTIL A PAID ONGOING
  168.        SOFTWARE LICENSE IS PURCHASED AND CERTAIN SECURITY CODES ARE
  169.        INSTALLED. Unlicensed use of this Software after the evaluation
  170.        period is in violation of U.S. and international copyright laws and
  171.        may result in the imposition of civil and criminal penalties.
  172.        Continued use of this Software after termination of the evaluation
  173.        period requires the purchase of a registered license and payment of
  174.        license fees.
  175.  
  176.  
  177.        5 - REDISTRIBUTION OF EVALUATION EDITION SOFTWARE
  178.        -------------------------------------------------
  179.  
  180.        You are permitted to make unlimited copies of the Evaluation Edition
  181.        of the Software and redistribute them free of charge to other
  182.        persons or entities for noncommercial evaluation purposes only if it
  183.        has not been altered in any way and all copies contain this License
  184.        and the same copyright and other proprietary notices that appear on
  185.        the Software. TeleGrafix grants permission for public redistribution
  186.        of the Evaluation Edition of the Software by any online information
  187.        networks including bulletin board systems, freenets, intranets,
  188.        Internet service providers, public network servers, Telnet sites,
  189.        and World Wide Web sites. In addition, TeleGrafix grants permission
  190.        to any commercial vendor to bundle the Evaluation Edition of the
  191.        Software without charge with any book, CD-ROM, computer hardware,
  192.        computer software, online service or data communications product
  193.        available for sale to the general public provided that (a) Vendor
  194.        notifies TeleGrafix in writing at least thirty (30) days in advance
  195.        of any bundling redistribution and TeleGrafix does not object and
  196.        withhold its consent in writing, (b) the most recently published
  197.        version of the Evaluation Edition available from TeleGrafix is
  198.        bundled with the product, and (c) no fee is charged or collected by
  199.        the vendor for licensing or use of the Evaluation Edition by
  200.        end-users. Evaluation Edition software may not be licensed or sold
  201.        for profit to end-users as a separate, standalone or value-added
  202.        component or product unless previously authorized in writing by
  203.        TeleGrafix.  TeleGrafix will pay commissions to operators of certain
  204.        public-access networks and vendors who redistribute the Evaluation
  205.        Edition of the Software only under the terms and conditions as
  206.        specified in a separate "TeleGrafix Associates Agreement" (contact
  207.        TeleGrafix for details), and only if such an agreement has been
  208.        executed in writing by both parties PRIOR to any such
  209.        redistribution. UNDER NO CIRCUMSTANCES SHALL ANY NON-EVALUATION OR
  210.        COMMERCIAL EDITIONS OF THE SOFTWARE BE REDISTRIBUTED OR USED WITHOUT
  211.        FIRST OBTAINING PAID REGISTERED LICENSES OR WRITTEN AUTHORIZATION
  212.        FROM TELEGRAFIX.
  213.  
  214.  
  215.        6 - OBTAINING A PAID REGISTERED LICENSE
  216.        ---------------------------------------
  217.  
  218.        ANY USE OF THE SOFTWARE OTHER THAN FOR INITIAL NONCOMMERCIAL
  219.        EVALUATION REVIEW PURPOSES OR AS AUTHORIZED HEREIN REQUIRES
  220.        REGISTRATION AND PURCHASE OF A LICENSE. ANY COMMERCIAL USE OR
  221.        _____________________________________________________________________
  222.                                         iii
  223.                                  LICENSE AGREEMENT
  224.        _____________________________________________________________________
  225.  
  226.        DISTRIBUTION OF THIS SOFTWARE, OTHER THAN AS AUTHORIZED HEREIN,
  227.        REQUIRES REGISTRATION AND PURCHASE OF A LICENSE.  You may register
  228.        the Software and obtain a paid License by contacting TeleGrafix as
  229.        detailed above. Current License fees in effect are posted on the
  230.        TeleGrafix Web site (www.telegrafix.com) and are subject to change
  231.        without notice at any time. THE ACCEPTANCE OF ANY PURCHASE ORDER
  232.        PLACED BY YOU IS EXPRESSLY MADE CONDITIONAL ON YOUR ACCEPTANCE OF
  233.        THE TERMS AND CONDITIONS SET FORTH IN THIS LICENSE, AND NOT THOSE IN
  234.        YOUR PURCHASE ORDER.  You agree to pay the applicable license fee
  235.        for this Software if using it beyond the evaluation period. You are
  236.        also responsible for payment of any taxes, including personal
  237.        property taxes, resulting from this License.
  238.  
  239.  
  240.        7 - SCOPE OF LICENSE
  241.        --------------------
  242.  
  243.        Your License is personal to You. You shall not permit other
  244.        individuals or entities to operate or use the Software except under
  245.        such terms as are authorized by this License. As an individual
  246.        single-copy user, You are permitted to install and use one (1) copy
  247.        of this Software on a single computer used by You. If You received
  248.        Your first copy of the Software electronically, and a second copy on
  249.        magnetic media, the second copy may be used for archival purposes
  250.        only, and only a single Software License is created. You can
  251.        transfer the entire program to another computer provided that the
  252.        Software is used by only one computer at a time. Any simultaneous
  253.        use requires a separate License for each computer. You may use the
  254.        Software in a multiple computer, multi-user or network environment
  255.        only if You have obtained an additional License for each computer.
  256.        For example, if there are three users of the Software on a network,
  257.        three Licenses must be obtained from TeleGrafix. If you have
  258.        purchased multiple Licenses, then at anytime you may have as many
  259.        copies of the Software in use as you have Licenses. You may copy
  260.        this Software in machine-readable form for backup or archival
  261.        purposes in support of Your licensed use of this Software. Any copy
  262.        must contain all of the original Software's license, copyright and
  263.        proprietary notices. You may not copy any printed materials
  264.        accompanying the Software.  You may transfer this Software and
  265.        License to another party if the other party agrees to accept the
  266.        terms and conditions of this License. If the Software is an upgrade,
  267.        any transfer must include the updated and all prior versions. If You
  268.        transfer the Software, You must transfer all copies to the same
  269.        party and destroy any copies not transferred.
  270.  
  271.  
  272.        8 - CUSTOMER SUPPORT
  273.        --------------------
  274.  
  275.        IF YOU ARE USING ANY VERSION OF THE SOFTWARE FREE OF CHARGE, THIS
  276.        LICENSE DOES NOT ENTITLE YOU TO ANY TELEPHONE TECHNICAL SUPPORT OR
  277.        HARD-COPY DOCUMENTATION. Customers who have purchased a paid
  278.        registered License are eligible for free telephone technical support
  279.        for ninety (90) days.  Hard-copy documentation is available to
  280.        _____________________________________________________________________
  281.                                         iv
  282.                                  LICENSE AGREEMENT
  283.        _____________________________________________________________________
  284.  
  285.        licensed customers for an additional fee. Use of customer support
  286.        services is governed by the TeleGrafix policies and programs
  287.        described in the Software user manual, in on-line documentation
  288.        and/or other TeleGrafix-provided materials. Any supplemental software
  289.        code provided to You as part of customer support services shall be
  290.        considered part of this Software and subject to the terms and
  291.        conditions of this License.
  292.  
  293.  
  294.        9 - UPGRADES
  295.        ------------
  296.  
  297.        If the Software is identified by TeleGrafix as an upgrade, You must
  298.        have a valid paid License registration for a product identified by
  299.        TeleGrafix as eligible for the upgrade in order to use it. IF YOU
  300.        ARE USING ANY VERSION OF THE SOFTWARE FREE OF CHARGE, THIS LICENSE
  301.        DOES NOT ENTITLE YOU TO ANY UPGRADE. An upgrade replaces and/or
  302.        supplements the original software product that formed the basis for
  303.        Your eligibility for the upgrade. You may use the resulting upgraded
  304.        Software only in accordance with the terms and conditions of this
  305.        License. If this Software is purchased as an upgrade or provided as
  306.        an update to a previous version of licensed Software, this Software
  307.        may be used only to replace the previous version and no additional
  308.        license is granted. This Software and the previous version may not
  309.        be separately used or transferred to a third party. TeleGrafix
  310.        retains the right to charge for any upgrade.
  311.  
  312.  
  313.        10 - PUBLICITY FOR RIPscrip ENABLED PRODUCTS AND SERVICES
  314.        ---------------------------------------------------------
  315.  
  316.        If You are using the Software to develop, enhance or promote a
  317.        product or service (such as a CD-ROM, BBS, Telnet site, Web site or
  318.        software product) for use by the general public, You must clarify in
  319.        any news release or promotional announcement that the product or
  320.        service is RIPscrip-enabled and that the multimedia technology being
  321.        used is RIPscrip by TeleGrafix Communications. This requirement
  322.        includes (but is not limited to) news releases, news conferences,
  323.        and BBS/Telnet/Web site promotional announcements concerning the
  324.        product or service. For more information concerning specific
  325.        language to be included in news releases and promotional
  326.        announcements, contact TeleGrafix Communications. You agree that
  327.        TeleGrafix may use Your name as a licensee of the Software, for no
  328.        charge or payment, in TeleGrafix's publicity materials.
  329.  
  330.  
  331.        11 - OWNERSHIP OF SOFTWARE
  332.        --------------------------
  333.  
  334.        Title, ownership rights, and intellectual property rights in and to
  335.        the Software or any copy, modification or merged portion shall
  336.        remain in Searchlight and/or TeleGrafix and/or its suppliers. The
  337.        Software is protected by the copyright laws of the United States and
  338.        international copyright treaties. You shall not rent, lease,
  339.        _____________________________________________________________________
  340.                                          v
  341.                                  LICENSE AGREEMENT
  342.        _____________________________________________________________________
  343.  
  344.        sublicense, network, grant a security interest in, or otherwise
  345.        transfer rights to the software except under such terms as are
  346.        authorized by this License (or by a separate supplemental agreement
  347.        signed by an officer of TeleGrafix). Title, ownership rights, and
  348.        intellectual property rights in and to any information accessed
  349.        through the Software is the property of the applicable information
  350.        owner and may be protected by applicable copyright or other law.
  351.        This License gives You no rights to such information. With respect
  352.        to any technical information or product improvement suggestions that
  353.        You provide to TeleGrafix as part of customer support services,
  354.        TeleGrafix may use such information without charge for its business
  355.        purposes, including for product support and development.
  356.  
  357.  
  358.        12 - INTELLECTUAL PROPERTY PROTECTION
  359.        -------------------------------------
  360.  
  361.        You acknowledge that the structure, organization and code of the
  362.        Software are valuable trade secrets of Searchlight and/or TeleGrafix
  363.        and/or their suppliers. You acknowledge that the Software in source
  364.        code form remains a confidential trade secret of Searchlight and/or
  365.        TeleGrafix and/or their suppliers and cannot be disclosed by You to
  366.        any other party. You agree not to attempt to discover the source
  367.        code of the Software. You shall not use, copy, merge, modify,
  368.        translate, reverse engineer, decompile, disassemble, rent, lease or
  369.        transfer this Software (or any copy, modification, or merged
  370.        portion, in whole or in part) except to the extent applicable laws
  371.        specifically prohibit such restriction without the possibility of
  372.        contractual waiver or as expressly provided for in this License or
  373.        in amendments signed by an officer of TeleGrafix. You shall not
  374.        create derivative works based on this Software unless authorized in
  375.        writing by an officer of TeleGrafix. You shall not remove any
  376.        proprietary notices or legends, including copyright notices, from
  377.        this Software or archival backup copies. You shall not circumvent
  378.        any software protection devices used in this software. You agree
  379.        that any security codes (including keycodes, serial numbers or
  380.        activation codes) that are used to permit the operation of this
  381.        Software are to remain confidential information between You and
  382.        TeleGrafix.  You shall not under any circumstances broadcast,
  383.        publish, disclose or disseminate to any other person or party any
  384.        information about TeleGrafix software security protection devices
  385.        including security codes. You acknowledge that violations of the
  386.        U.S. Copyright laws may result in criminal and civil penalties,
  387.        including fines of up to $100,000. Title, ownership rights and
  388.        intellectual property rights in and to the Software and any security
  389.        codes or protection devices used to permit operation of this
  390.        Software shall remain exclusively with Searchlight and/or
  391.        TeleGrafix.
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.        _____________________________________________________________________
  399.                                         vi
  400.                                  LICENSE AGREEMENT
  401.        _____________________________________________________________________
  402.  
  403.  
  404.        13 - INJUNCTIVE RELIEF
  405.        ----------------------
  406.  
  407.        You acknowledge that the Software embodies trade secrets of
  408.        Searchlight and/or TeleGrafix, the unauthorized use or disclosure of
  409.        which would cause substantial harm to Searchlight and/or TeleGrafix
  410.        that could not be remedied by the payment of damages alone.
  411.        Accordingly, Searchlight and/or TeleGrafix shall be entitled to
  412.        preliminary and permanent injunctive relief and other equitable
  413.        relief for any breach of this License. The parties agree that in the
  414.        event of a breach or threatened breach of this License (including
  415.        unauthorized reproduction or dissemination of Software or security
  416.        codes), that immediate injunctive relief shall be appropriate, and
  417.        that injunctive action may be sought by Searchlight and/or
  418.        TeleGrafix. The parties agree that Searchlight and/or TeleGrafix
  419.        shall be released from any requirement to post any bond, cash or
  420.        security as a condition of obtaining injunctive relief, to the
  421.        extent permitted by law.  Searchlight and/or TeleGrafix's right to
  422.        obtain injunctive relief shall not limit their right to seek any
  423.        other remedies to which they may be entitled.
  424.  
  425.  
  426.        14 - EXPORT CONTROLS
  427.        --------------------
  428.  
  429.        None of the Software or underlying information or technology may be
  430.        downloaded or otherwise exported or reexported (1) into (or to a
  431.        national or resident of) Cuba, Iraq, Libya, Yugoslavia, North Korea,
  432.        Iran, Syria or any other country to which the U.S. has embargoed
  433.        goods; or (2) to anyone on the U.S. Treasury Department's list of
  434.        Specially Designated Nationals or the U.S. Commerce Department's
  435.        Table of Deny Orders; or (3) any end user who will use the Software
  436.        in the design, development or production of biological, chemical or
  437.        nuclear weapons. By downloading or using the Software, You are
  438.        agreeing to the foregoing and You are representing and warranting
  439.        that You are not located in the prohibited countries; You are not
  440.        under the control of, or a national or resident of any such country;
  441.        You are not on any such list; and You are not engaged in prohibited
  442.        weapons activities.
  443.  
  444.  
  445.        15 - HIGH-RISK ACTIVITIES
  446.        -------------------------
  447.  
  448.        The Software is not fault-tolerant. It is not designed, manufactured
  449.        or intended for use with, or resale as, online control equipment in
  450.        hazardous environments requiring fail-safe performance (such as
  451.        nuclear facilities, aircraft navigation or communications systems,
  452.        aircraft traffic control systems, life support machines, or weapons
  453.        systems) in which the failure of the Software could lead directly to
  454.        death, personal injury or severe physical or environmental damage
  455.        ("High Risk Activities"). SEARCHLIGHT AND/OR TELEGRAFIX AND THEIR
  456.        SUPPLIERS SPECIFICALLY DISCLAIM ANY EXPRESS OR IMPLIED WARRANTY OF
  457.        _____________________________________________________________________
  458.                                         vii
  459.                                  LICENSE AGREEMENT
  460.        _____________________________________________________________________
  461.  
  462.  
  463.        FITNESS FOR HIGH-RISK ACTIVITIES.
  464.  
  465.  
  466.        16 - LIMITED WARRANTY
  467.        ---------------------
  468.  
  469.        THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS WITHOUT WARRANTY OF ANY
  470.        KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY
  471.        IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
  472.        PURPOSE AND NON-INFRINGEMENT OF THIRD PARTY RIGHTS. SEARCHLIGHT
  473.        AND/OR TELEGRAFIX (AND THEIR SUPPLIERS) DO NOT AND CANNOT WARRANT
  474.        THE PERFORMANCE OR RESULTS YOU MAY OBTAIN BY USING THE SOFTWARE.
  475.        SEARCHLIGHT AND/OR TELEGRAFIX DOES NOT WARRANT THAT THIS SOFTWARE
  476.        WILL MEET YOUR REQUIREMENTS OR THAT THIS SOFTWARE WILL OPERATE
  477.        UNINTERRUPTED OR ERROR-FREE. THE ENTIRE RISK AS TO THE QUALITY AND
  478.        PERFORMANCE OF THE SOFTWARE IS BORNE BY YOU. SHOULD THE SOFTWARE
  479.        PROVE DEFECTIVE, YOU (NOT SEARCHLIGHT AND/OR TELEGRAFIX) ASSUME THE
  480.        ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION. THIS
  481.        DISCLAIMER OF WARRANTY IS AN ESSENTIAL PART OF THIS LICENSE. SOME
  482.        JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO
  483.        THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. YOU MAY HAVE OTHER LEGAL
  484.        RIGHTS THAT VARY BY JURISDICTION. Despite the foregoing, Searchlight
  485.        and/or TeleGrafix does warrant the physical media on which the
  486.        Software is furnished to be free from defects in materials and
  487.        workmanship under normal use for a period of ninety (90) days from
  488.        the date of delivery to You. This limited warranty for physical
  489.        media does not apply if the media has been abused, changed or
  490.        damaged by you, or if you received the software via electronic
  491.        download without physical media from Searchlight and/or TeleGrafix.
  492.  
  493.  
  494.        17 - LIMITATION OF LIABILITY
  495.        ----------------------------
  496.  
  497.        SEARCHLIGHT AND/OR TELEGRAFIX'S MAXIMUM AGGREGATE LIABILITY TO YOU
  498.        (AND THAT OF ITS AGENTS, DEALERS, DISTRIBUTORS, EMPLOYEES OR
  499.        SUPPLIERS) SHALL NOT EXCEED THE AMOUNT PAID BY YOU FOR THE
  500.        SOFTWARE.  SEARCHLIGHT AND/OR TELEGRAFIX'S ENTIRE LIABILITY AND YOUR
  501.        EXCLUSIVE REMEDY SHALL BE, AT SEARCHLIGHT AND/OR TELEGRAFIX'S
  502.        OPTION, THE REPLACEMENT OF THE SOFTWARE OR THE REFUND OF YOUR
  503.        PURCHASE PRICE. IF YOU DOWNLOADED THE SOFTWARE, THEN REPLACEMENT
  504.        DISKS ARE NOT COVERED BY THIS LICENSE. OUTSIDE OF THE UNITED STATES
  505.        OF AMERICA AND CANADA, THESE REMEDIES ARE NOT AVAILABLE WITHOUT
  506.        PROOF OF PURCHASE FROM SEARCHLIGHT AND/OR TELEGRAFIX OR AN
  507.        AUTHORIZED DISTRIBUTOR.  UNDER NO CIRCUMSTANCES SHALL SEARCHLIGHT
  508.        AND/OR TELEGRAFIX (OR THEIR AGENTS, DEALERS, DISTRIBUTORS, EMPLOYEES
  509.        OR SUPPLIERS) BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST
  510.        PROFITS, LOST SAVINGS, WORK STOPPAGE, LOSS OF GOODWILL, COMPUTER
  511.        FAILURE OR MALFUNCTION, LOST OR DAMAGED DATA, OR ANY AND ALL OTHER
  512.        INCIDENTAL, CONSEQUENTIAL, INDIRECT OR SPECIAL DAMAGES ARISING OUT
  513.        OF THE USE OR INABILITY TO USE THE SOFTWARE (EVEN IF SEARCHLIGHT
  514.        AND/OR TELEGRAFIX OR THEIR AUTHORIZED REPRESENTATIVE HAS BEEN
  515.        ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR THEY ARE FORESEEABLE),
  516.        _____________________________________________________________________
  517.                                        viii
  518.                                  LICENSE AGREEMENT
  519.        _____________________________________________________________________
  520.  
  521.        OR FOR ANY CLAIM BY ANY OTHER PARTY. THIS LIMITATION OF LIABILITY
  522.        SHALL NOT APPLY TO LIABILITY FOR DEATH OR PERSONAL INJURY TO THE
  523.        EXTENT APPLICABLE LAW PROHIBITS SUCH LIMITATION. SOME JURISDICTIONS
  524.        DO NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR INCIDENTAL
  525.        OR CONSEQUENTIAL DAMAGES SO THIS LIMITATION OR EXCLUSION MAY NOT
  526.        APPLY TO YOU. EXCEPT AS OTHERWISE PROVIDED BY APPLICABLE LAW, NO
  527.        CLAIM, REGARDLESS OF FORM, ARISING OUT OF OR IN CONNECTION WITH THIS
  528.        LICENSE MAY BE BROUGHT BY YOU MORE THAN ONE (1) YEAR AFTER THE CAUSE
  529.        OF ACTION HAS OCCURRED. NO ORAL OR WRITTEN INFORMATION OR ADVICE
  530.        GIVEN BY SEARCHLIGHT AND/OR TELEGRAFIX (OR ITS AGENTS, DEALERS,
  531.        DISTRIBUTORS, EMPLOYEES OR SUPPLIERS), SHALL CREATE ANY NEW WARRANTY
  532.        OR IN ANY WAY INCREASE THE SCOPE OF THIS WARRANTY, AND YOU MAY NOT
  533.        RELY ON ANY SUCH INFORMATION OR ADVICE.
  534.  
  535.  
  536.        18 - U.S. GOVERNMENT END-USER RESTRICTIONS
  537.        ------------------------------------------
  538.  
  539.        All U.S. Government end users license the Software with only those
  540.        rights set forth herein. This Software is licensed only with
  541.        "restricted rights" when used by or on behalf of an agency or unit
  542.        of the United States Government. This Software is "restricted
  543.        computer software" as defined by the Federal Acquisition
  544.        Regulations. This Software is "commercial computer software" and
  545.        "commercial computer software documentation" that was developed at
  546.        private expense. This Software is not in the public domain and in
  547.        all respects is proprietary data belonging to Searchlight and/or
  548.        TeleGrafix. Title to and ownership of this Software shall remain
  549.        with Searchlight Software Inc. and TeleGrafix Communications Inc.
  550.        All unpublished rights are reserved by Searchlight and/or TeleGrafix
  551.        under the copyright laws of the United States of America. Any use,
  552.        duplication or disclosure by the U.S. Government is subject to
  553.        restrictions set forth in subparagraphs (a) through (d) of the
  554.        Commercial Computer-Restricted Rights clause at FAR 52.227-19 when
  555.        applicable, or in subparagraph (c)(1)(ii) of the Rights in Technical
  556.        Data and Computer Software clause at DFARS 252.227-7013, and in
  557.        similar clauses in the NASA FAR Supplement. The U.S. Government is
  558.        prohibited from changing or removing any insignia, logo or lettering
  559.        from the Software or any accompanying written materials that are
  560.        provided, and from producing copies of any manuals or disks (except
  561.        one for backup purposes). Use of this Software and any documentation
  562.        shall be limited to the government facility for which it is
  563.        acquired. This Software is a trade secret of Searchlight Software
  564.        Inc. and/or TeleGrafix Communications Inc.  for all purposes of the
  565.        Freedom of Information Act.  Contractor/manufacturer is TeleGrafix
  566.        Communications Inc., 111 Weems Lane, Suite #308, Winchester, VA
  567.        22601-3600.
  568.  
  569.  
  570.        19 - LEGAL
  571.        ----------
  572.  
  573.        The official language of this License and all documents used in its
  574.        connection shall be English. All agreements covering this Software
  575.        _____________________________________________________________________
  576.                                         ix
  577.                                  LICENSE AGREEMENT
  578.        _____________________________________________________________________
  579.  
  580.        (including but not limited to any and all updates, upgrades, and
  581.        enhancements to this Software or any portion thereof, bearing the
  582.        same registration number) shall be deemed to be counterparts of one
  583.        and the same License instrument. This License shall be governed by
  584.        and construed under the laws of the Commonwealth of Virginia and the
  585.        United States of America, and the applicable international
  586.        treaties.  The parties agree that jurisdiction and venue for any
  587.        dispute arising from this License or relating to the Software shall
  588.        be in the United States District Court for the Western District of
  589.        Virginia, Harrisonburg Division, or the Circuit Court for the City
  590.        of Winchester, Virginia. By using this software, You expressly
  591.        confer upon these Courts in Virginia jurisdiction over you. In the
  592.        event that Searchlight and/or TeleGrafix is the prevailing party in
  593.        any litigation between the parties arising from this License,
  594.        Searchlight and/or TeleGrafix shall be entitled to recover, in
  595.        addition to any other relief awarded, its reasonable costs and
  596.        expenses including attorneys' fees, court costs and collection costs
  597.        incurred in the proceeding. The failure of either party to enforce
  598.        any rights granted by this License or to take action against the
  599.        other party in the event of any breach of this License shall not be
  600.        deemed a waiver by that party of its right to enforce such rights in
  601.        the future. If any provision of this License is held to be
  602.        unenforceable for any reason by a court of competent jurisdiction,
  603.        such provision shall be reformed only to the extent necessary to
  604.        make it enforceable, and the rest of this License shall remain in
  605.        full force and effect. This License will not be governed by the
  606.        United Nations Convention of Contracts for the International Sale of
  607.        Goods and its application is expressly excluded.  All questions
  608.        concerning this License shall be addressed to:  TeleGrafix
  609.        Communications Inc., 111 Weems Lane, #308, Winchester, VA
  610.        22601-3600, United States of America, Attention: Legal Department.
  611.  
  612.  
  613.        20 - TERM AND TERMINATION
  614.        -------------------------
  615.  
  616.        This License is effective until terminated, and it will terminate
  617.        automatically and immediately without notice if You fail to comply
  618.        with any of its provisions. In the case of Evaluation Edition
  619.        Software, this License will terminate automatically at the
  620.        expiration of the evaluation period. You may terminate it at any
  621.        time by destroying all copies of the Software covered by this
  622.        License. If You transfer possession of any copy of this software (or
  623.        any Functionally-equivalent derivative) or any portion or
  624.        modification thereof to another party, or remove any copyright or
  625.        proprietary notices or labels on the software or any copy, or
  626.        disclose any software codes, Your License is automatically
  627.        terminated. You may not sublicense, assign or otherwise transfer
  628.        this License or Software except as expressly provided in this
  629.        License. Any attempt to otherwise sublicense, assign, or transfer
  630.        any of the rights, duties or obligations hereunder is expressly
  631.        prohibited and will terminate this License immediately. In addition,
  632.        TeleGrafix may terminate this License at any time by delivering
  633.        notice to You. On termination, You must destroy all copies of the
  634.        _____________________________________________________________________
  635.                                          x
  636.                                  LICENSE AGREEMENT
  637.        _____________________________________________________________________
  638.  
  639.        Software.  Your obligation to pay any accrued charges or fees shall
  640.        survive any termination of this License.  The provisions of
  641.        Paragraphs 11 through 20 shall also survive any termination of this
  642.        License.
  643.  
  644.        BY INSTALLING OR USING THIS SOFTWARE, YOU ACKNOWLEDGE THAT YOU HAVE
  645.        READ THIS LICENSE AGREEMENT, UNDERSTAND IT, AND AGREE TO BE BOUND BY
  646.        ITS TERMS AND CONDITIONS. YOU FURTHER AGREE THAT IT IS THE COMPLETE
  647.        AND EXCLUSIVE STATEMENT OF THE LICENSE AGREEMENT BETWEEN US AND
  648.        SUPERSEDES ANY PROPOSAL OR PRIOR AGREEMENT, ORAL OR WRITTEN, AND ANY
  649.        OTHER COMMUNICATIONS BETWEEN US RELATING TO THE LICENSING OF THIS
  650.        SOFTWARE. THIS LICENSE AGREEMENT MAY BE AMENDED ONLY BY A WRITING
  651.        SIGNED BY BOTH PARTIES.
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.        _____________________________________________________________________
  694.                                         xi
  695.                                  TABLE OF CONTENTS
  696.        _____________________________________________________________________
  697.  
  698.  
  699.         -------------------------------------------------------------------
  700.        | TABLE OF CONTENTS                                                 |
  701.         -------------------------------------------------------------------
  702.  
  703.        Introducing Searchlight. . . . . . . . . . . . . . . . . . . . . 1
  704.        What Do I Need To Run Searchlight BBS? . . . . . . . . . . . . . 2
  705.        Searchlight Feature Overview . . . . . . . . . . . . . . . . . . 3
  706.        Searchlight BBS Installation And Setup . . . . . . . . . . . . . 8
  707.        Installing the DOS Version . . . . . . . . . . . . . . . . . . . 8
  708.        The CONFIG.SYS File. . . . . . . . . . . . . . . . . . . . . . . 8
  709.        File Sharing . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  710.        Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  711.        SLBBS Environment Variable . . . . . . . . . . . . . . . . . . . 11
  712.        Upgrading From Older Versions. . . . . . . . . . . . . . . . . . 11
  713.        Using the Windows Version. . . . . . . . . . . . . . . . . . . . 12
  714.        Searchlight BBS Configuration. . . . . . . . . . . . . . . . . . 13
  715.        Searchlight BBS General Setup Menu #1. . . . . . . . . . . . . . 14
  716.        Searchlight BBS General Setup Menu #2. . . . . . . . . . . . . . 18
  717.        Searchlight BBS Communications Setup . . . . . . . . . . . . . . 24
  718.        Automatic Modem Configuration. . . . . . . . . . . . . . . . . . 31
  719.        Searchlight BBS Pathnames Setup Menu . . . . . . . . . . . . . . 32
  720.        Searchlight BBS Protocol Setup Menu. . . . . . . . . . . . . . . 37
  721.        Searchlight BBS Screen Colors Setup. . . . . . . . . . . . . . . 39
  722.        Searchlight BBS AutoDoors Setup. . . . . . . . . . . . . . . . . 40
  723.        Searchlight BBS Function Attribute Setup . . . . . . . . . . . . 42
  724.        Default Access Level Setup . . . . . . . . . . . . . . . . . . . 45
  725.        Overlay Setup. . . . . . . . . . . . . . . . . . . . . . . . . . 48
  726.        Text Files Setup . . . . . . . . . . . . . . . . . . . . . . . . 49
  727.        Default File Directory Messages. . . . . . . . . . . . . . . . . 51
  728.        Multinode Setup. . . . . . . . . . . . . . . . . . . . . . . . . 52
  729.        Searchlight and Telnet . . . . . . . . . . . . . . . . . . . . . 56
  730.        Setting Up Telnet. . . . . . . . . . . . . . . . . . . . . . . . 56
  731.        Using Telnet . . . . . . . . . . . . . . . . . . . . . . . . . . 57
  732.        Telnet and RIP . . . . . . . . . . . . . . . . . . . . . . . . . 58
  733.        Telnet and Doors . . . . . . . . . . . . . . . . . . . . . . . . 58
  734.        Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . 58
  735.        Searchlight BBS Conference Maintenance . . . . . . . . . . . . . 60
  736.        Add Conference . . . . . . . . . . . . . . . . . . . . . . . . . 61
  737.        Edit Conference. . . . . . . . . . . . . . . . . . . . . . . . . 62
  738.        Delete Conference. . . . . . . . . . . . . . . . . . . . . . . . 67
  739.        Conference Utilities . . . . . . . . . . . . . . . . . . . . . . 67
  740.        File Directory Maintenance . . . . . . . . . . . . . . . . . . . 69
  741.        Directory Utilities. . . . . . . . . . . . . . . . . . . . . . . 72
  742.        Balance/Repair Directory . . . . . . . . . . . . . . . . . . . . 73
  743.        Import File Descriptions . . . . . . . . . . . . . . . . . . . . 73
  744.        Custom Ordering. . . . . . . . . . . . . . . . . . . . . . . . . 73
  745.        Running Searchlight BBS. . . . . . . . . . . . . . . . . . . . . 74
  746.        Auto ANSI Detect . . . . . . . . . . . . . . . . . . . . . . . . 76
  747.        Local RIP Mode . . . . . . . . . . . . . . . . . . . . . . . . . 77
  748.        Things To Do When First Logging In . . . . . . . . . . . . . . . 77
  749.        Using The Status Display . . . . . . . . . . . . . . . . . . . . 78
  750.  
  751.        _____________________________________________________________________
  752.                                         xii
  753.                                  TABLE OF CONTENTS
  754.        _____________________________________________________________________
  755.  
  756.        Command Line Parameters. . . . . . . . . . . . . . . . . . . . . 78
  757.        Adding New Users . . . . . . . . . . . . . . . . . . . . . . . . 80
  758.        Guest Account. . . . . . . . . . . . . . . . . . . . . . . . . . 81
  759.        Configuring User Options . . . . . . . . . . . . . . . . . . . . 82
  760.        User/Info. . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
  761.        User/Preference. . . . . . . . . . . . . . . . . . . . . . . . . 84
  762.        User/Stats . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
  763.        User/Access. . . . . . . . . . . . . . . . . . . . . . . . . . . 87
  764.        Searchlight Message System . . . . . . . . . . . . . . . . . . . 92
  765.        Entering Messages: The Post Command. . . . . . . . . . . . . . . 92
  766.        Retrieving Messages: The Read Command. . . . . . . . . . . . . . 93
  767.        Reading Messages in RIP Mode . . . . . . . . . . . . . . . . . . 99
  768.        Using the Thread Command . . . . . . . . . . . . . . . . . . . . 100
  769.        The List and Jump Commands . . . . . . . . . . . . . . . . . . . 102
  770.        Reviewing Messages: The Scan Command . . . . . . . . . . . . . . 102
  771.        Finding New Messages: The New Command. . . . . . . . . . . . . . 104
  772.        The Edit and Kill Commands . . . . . . . . . . . . . . . . . . . 107
  773.        The 1-Member Command . . . . . . . . . . . . . . . . . . . . . . 108
  774.        Using Electronic Mail. . . . . . . . . . . . . . . . . . . . . . 110
  775.        Netmail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
  776.        Internet Mail. . . . . . . . . . . . . . . . . . . . . . . . . . 114
  777.        A Word about Mailboxes . . . . . . . . . . . . . . . . . . . . . 115
  778.        Using The Bulletins System . . . . . . . . . . . . . . . . . . . 116
  779.        Using Chat Mode. . . . . . . . . . . . . . . . . . . . . . . . . 118
  780.        Sysop-To-User Chatting . . . . . . . . . . . . . . . . . . . . . 118
  781.        Internode Chatting . . . . . . . . . . . . . . . . . . . . . . . 118
  782.        Other Commands . . . . . . . . . . . . . . . . . . . . . . . . . 120
  783.        Ansi Command . . . . . . . . . . . . . . . . . . . . . . . . . . 120
  784.        Goodbye Command. . . . . . . . . . . . . . . . . . . . . . . . . 120
  785.        Info Command . . . . . . . . . . . . . . . . . . . . . . . . . . 120
  786.        Quotes Command . . . . . . . . . . . . . . . . . . . . . . . . . 120
  787.        Time Command . . . . . . . . . . . . . . . . . . . . . . . . . . 121
  788.        User Command . . . . . . . . . . . . . . . . . . . . . . . . . . 121
  789.        Version Command. . . . . . . . . . . . . . . . . . . . . . . . . 122
  790.        Who Command. . . . . . . . . . . . . . . . . . . . . . . . . . . 122
  791.        Sysop Functions. . . . . . . . . . . . . . . . . . . . . . . . . 123
  792.        Sysop/Options. . . . . . . . . . . . . . . . . . . . . . . . . . 123
  793.        Sysop/Adjust . . . . . . . . . . . . . . . . . . . . . . . . . . 123
  794.        Sysop/Validate . . . . . . . . . . . . . . . . . . . . . . . . . 123
  795.        Sysop/Mail . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
  796.        Sysop/TextEdit . . . . . . . . . . . . . . . . . . . . . . . . . 124
  797.        Sysop/DosShell . . . . . . . . . . . . . . . . . . . . . . . . . 124
  798.        Sysop/Relog. . . . . . . . . . . . . . . . . . . . . . . . . . . 125
  799.        The Status Line. . . . . . . . . . . . . . . . . . . . . . . . . 126
  800.        Hot Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
  801.        Output Logging . . . . . . . . . . . . . . . . . . . . . . . . . 128
  802.        Exit Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
  803.        Hangup Key . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
  804.        Local RIP Key. . . . . . . . . . . . . . . . . . . . . . . . . . 129
  805.        Command Keys . . . . . . . . . . . . . . . . . . . . . . . . . . 130
  806.        Text Editing: Introduction . . . . . . . . . . . . . . . . . . . 131
  807.        Using The Line Editor. . . . . . . . . . . . . . . . . . . . . . 132
  808.        Using The Full Screen Editor . . . . . . . . . . . . . . . . . . 135
  809.  
  810.        _____________________________________________________________________
  811.                                        xiii
  812.                                  TABLE OF CONTENTS
  813.        _____________________________________________________________________
  814.  
  815.        Reply-Quote Line Selection . . . . . . . . . . . . . . . . . . . 140
  816.        Message Uploading. . . . . . . . . . . . . . . . . . . . . . . . 141
  817.        Message Preview. . . . . . . . . . . . . . . . . . . . . . . . . 141
  818.        ANSI Compatibility . . . . . . . . . . . . . . . . . . . . . . . 142
  819.        RIP Mode Editing . . . . . . . . . . . . . . . . . . . . . . . . 142
  820.        Embedded Color Codes . . . . . . . . . . . . . . . . . . . . . . 143
  821.        Message Macros . . . . . . . . . . . . . . . . . . . . . . . . . 144
  822.        Binary File Attachment . . . . . . . . . . . . . . . . . . . . . 144
  823.        Using Prepared Text Files. . . . . . . . . . . . . . . . . . . . 146
  824.        Searchlight BBS File Transfer System . . . . . . . . . . . . . . 149
  825.        Setting Up Directories . . . . . . . . . . . . . . . . . . . . . 149
  826.        Setting A Default Text Message . . . . . . . . . . . . . . . . . 150
  827.        Loading Filenames. . . . . . . . . . . . . . . . . . . . . . . . 150
  828.        Using The File Transfer System . . . . . . . . . . . . . . . . . 151
  829.        Files System Commands. . . . . . . . . . . . . . . . . . . . . . 151
  830.        Protocols. . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
  831.        Downloading. . . . . . . . . . . . . . . . . . . . . . . . . . . 151
  832.        Uploading. . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
  833.        Upload AutoDoor. . . . . . . . . . . . . . . . . . . . . . . . . 153
  834.        FILE_ID.DIZ Importing. . . . . . . . . . . . . . . . . . . . . . 153
  835.        Bi-Directional File Transfer . . . . . . . . . . . . . . . . . . 154
  836.        Local File Transfer. . . . . . . . . . . . . . . . . . . . . . . 154
  837.        File Maintenance . . . . . . . . . . . . . . . . . . . . . . . . 155
  838.        Password Protection. . . . . . . . . . . . . . . . . . . . . . . 155
  839.        File Tagging . . . . . . . . . . . . . . . . . . . . . . . . . . 156
  840.        Sysop Functions. . . . . . . . . . . . . . . . . . . . . . . . . 159
  841.        RIP File Browser . . . . . . . . . . . . . . . . . . . . . . . . 159
  842.        Setting Up External Protocols. . . . . . . . . . . . . . . . . . 160
  843.        Download Commands. . . . . . . . . . . . . . . . . . . . . . . . 161
  844.        Upload Commands. . . . . . . . . . . . . . . . . . . . . . . . . 161
  845.        External Protocol Example. . . . . . . . . . . . . . . . . . . . 162
  846.        Summary Of Files System Commands . . . . . . . . . . . . . . . . 163
  847.        Importing File Lists . . . . . . . . . . . . . . . . . . . . . . 171
  848.        Working With Multiple Paths. . . . . . . . . . . . . . . . . . . 174
  849.        Searchlight Menu Editor. . . . . . . . . . . . . . . . . . . . . 176
  850.        Components Of A Menu . . . . . . . . . . . . . . . . . . . . . . 178
  851.        Menu Header. . . . . . . . . . . . . . . . . . . . . . . . . . . 180
  852.        RIP Menubar Buttons. . . . . . . . . . . . . . . . . . . . . . . 183
  853.        Auto RIP/ICN Download. . . . . . . . . . . . . . . . . . . . . . 183
  854.        Menu Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
  855.        Conference/Directory Tagging . . . . . . . . . . . . . . . . . . 184
  856.        Editing Commands . . . . . . . . . . . . . . . . . . . . . . . . 185
  857.        Adding Commands. . . . . . . . . . . . . . . . . . . . . . . . . 186
  858.        Deleting Commands. . . . . . . . . . . . . . . . . . . . . . . . 186
  859.        Copy Command . . . . . . . . . . . . . . . . . . . . . . . . . . 186
  860.        Move Command . . . . . . . . . . . . . . . . . . . . . . . . . . 187
  861.        Edit Command Screen. . . . . . . . . . . . . . . . . . . . . . . 187
  862.        Controlling Command Availability . . . . . . . . . . . . . . . . 188
  863.        Internal Commands. . . . . . . . . . . . . . . . . . . . . . . . 192
  864.        External (DOOR) Commands . . . . . . . . . . . . . . . . . . . . 193
  865.        Menu Commands. . . . . . . . . . . . . . . . . . . . . . . . . . 194
  866.        Changing Command Types . . . . . . . . . . . . . . . . . . . . . 195
  867.        Guide To Menu Setup. . . . . . . . . . . . . . . . . . . . . . . 195
  868.  
  869.        _____________________________________________________________________
  870.                                         xiv
  871.                                  TABLE OF CONTENTS
  872.        _____________________________________________________________________
  873.  
  874.        Standard Menu Names. . . . . . . . . . . . . . . . . . . . . . . 196
  875.        Menu Levels. . . . . . . . . . . . . . . . . . . . . . . . . . . 196
  876.        Executable Menus . . . . . . . . . . . . . . . . . . . . . . . . 197
  877.        Searchlight BBS Doors Subsystem. . . . . . . . . . . . . . . . . 198
  878.        Setting Up Doors . . . . . . . . . . . . . . . . . . . . . . . . 199
  879.        Door Parameters. . . . . . . . . . . . . . . . . . . . . . . . . 199
  880.        What Programs Can Be Used As Doors?. . . . . . . . . . . . . . . 205
  881.        Using COMMAND.COM as a Door. . . . . . . . . . . . . . . . . . . 206
  882.        Using Batch Files as Doors . . . . . . . . . . . . . . . . . . . 206
  883.        Searchlight's FOSSIL Emulation Feature . . . . . . . . . . . . . 207
  884.        Running DirectVideo Doors. . . . . . . . . . . . . . . . . . . . 208
  885.        Passing Parameters to a Door Program . . . . . . . . . . . . . . 209
  886.        Direct Use Of Searchlight Files. . . . . . . . . . . . . . . . . 210
  887.        Some Door Programming Tips . . . . . . . . . . . . . . . . . . . 211
  888.        Searchlight Sysop Utilities. . . . . . . . . . . . . . . . . . . 212
  889.        Change User's Name . . . . . . . . . . . . . . . . . . . . . . . 213
  890.        Purge User File. . . . . . . . . . . . . . . . . . . . . . . . . 214
  891.        Purge Message Files. . . . . . . . . . . . . . . . . . . . . . . 216
  892.        Purge Member Files . . . . . . . . . . . . . . . . . . . . . . . 219
  893.        Mass Validate Users. . . . . . . . . . . . . . . . . . . . . . . 220
  894.        Purge File Areas . . . . . . . . . . . . . . . . . . . . . . . . 222
  895.        Balance User File. . . . . . . . . . . . . . . . . . . . . . . . 224
  896.        Sysop Utility Notes. . . . . . . . . . . . . . . . . . . . . . . 224
  897.        Alias Names. . . . . . . . . . . . . . . . . . . . . . . . . . . 226
  898.        Alias Name Setup . . . . . . . . . . . . . . . . . . . . . . . . 226
  899.        Alias Name Lookups . . . . . . . . . . . . . . . . . . . . . . . 227
  900.        Alias Name Logins. . . . . . . . . . . . . . . . . . . . . . . . 228
  901.        Sending Messages with an Alias . . . . . . . . . . . . . . . . . 229
  902.        Replying to Alias Messages . . . . . . . . . . . . . . . . . . . 230
  903.        Changing Alias Names . . . . . . . . . . . . . . . . . . . . . . 231
  904.        Alias Names and Conferences. . . . . . . . . . . . . . . . . . . 232
  905.        Alias Names and Mail . . . . . . . . . . . . . . . . . . . . . . 233
  906.        Alias Names and Doors. . . . . . . . . . . . . . . . . . . . . . 233
  907.        Language Configuration . . . . . . . . . . . . . . . . . . . . . 236
  908.        Adding Languages . . . . . . . . . . . . . . . . . . . . . . . . 236
  909.        Creating Language Files. . . . . . . . . . . . . . . . . . . . . 238
  910.        Introduction To Netmail. . . . . . . . . . . . . . . . . . . . . 239
  911.        How Searchlight Handles Netmail. . . . . . . . . . . . . . . . . 240
  912.        Netmail Import & Export. . . . . . . . . . . . . . . . . . . . . 245
  913.        Nodelist Index . . . . . . . . . . . . . . . . . . . . . . . . . 247
  914.        Using Searchlight Netmail. . . . . . . . . . . . . . . . . . . . 249
  915.        Creating an Explicit Netmail Command . . . . . . . . . . . . . . 251
  916.        Creating Netmail Routing Addresses . . . . . . . . . . . . . . . 252
  917.        Additional Netmail Considerations. . . . . . . . . . . . . . . . 254
  918.        Using RIP Graphics . . . . . . . . . . . . . . . . . . . . . . . 256
  919.        What is RIPscrip?. . . . . . . . . . . . . . . . . . . . . . . . 256
  920.        How Searchlight Supports RIP . . . . . . . . . . . . . . . . . . 257
  921.        RIP General Setup. . . . . . . . . . . . . . . . . . . . . . . . 258
  922.        RIP Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
  923.        Internal RIP Features. . . . . . . . . . . . . . . . . . . . . . 266
  924.        RIP Menus. . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
  925.        External RIP Files . . . . . . . . . . . . . . . . . . . . . . . 270
  926.        Wallpaper. . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
  927.  
  928.        _____________________________________________________________________
  929.                                         xv
  930.                                  TABLE OF CONTENTS
  931.        _____________________________________________________________________
  932.  
  933.        Wallpaper with Internal Commands . . . . . . . . . . . . . . . . 273
  934.        RIPscrip 2.x Features. . . . . . . . . . . . . . . . . . . . . . 273
  935.        RIP 2.0 File Extension . . . . . . . . . . . . . . . . . . . . . 274
  936.        Automatic RIP Downloading. . . . . . . . . . . . . . . . . . . . 274
  937.        Sound/JPEG Support . . . . . . . . . . . . . . . . . . . . . . . 276
  938.        System Sounds. . . . . . . . . . . . . . . . . . . . . . . . . . 276
  939.        Using Searchlight With DESQview. . . . . . . . . . . . . . . . . 278
  940.        Environment Setup. . . . . . . . . . . . . . . . . . . . . . . . 278
  941.        Hardware Interrupts. . . . . . . . . . . . . . . . . . . . . . . 278
  942.        DESQview Setup . . . . . . . . . . . . . . . . . . . . . . . . . 279
  943.        Program Setup. . . . . . . . . . . . . . . . . . . . . . . . . . 280
  944.        Memory Issues. . . . . . . . . . . . . . . . . . . . . . . . . . 281
  945.        Performance Issues . . . . . . . . . . . . . . . . . . . . . . . 282
  946.        Fine Tuning. . . . . . . . . . . . . . . . . . . . . . . . . . . 283
  947.        Appendix A: Using The Activity Log . . . . . . . . . . . . . . . 284
  948.        SYSLOG.DBF Format. . . . . . . . . . . . . . . . . . . . . . . . 284
  949.        Enabling Events. . . . . . . . . . . . . . . . . . . . . . . . . 286
  950.        Logdump Utility Program. . . . . . . . . . . . . . . . . . . . . 289
  951.        Appendix B: Guide To Error Messages. . . . . . . . . . . . . . . 291
  952.        Appendix C: Automatic Events . . . . . . . . . . . . . . . . . . 295
  953.        Appendix D: Modem Configuration. . . . . . . . . . . . . . . . . 297
  954.        Appendix E: Using Alias Names. . . . . . . . . . . . . . . . . . 303
  955.        Appendix F: The SLMAIL Command Line Utility. . . . . . . . . . . 305
  956.        Reading and Sending Text Files . . . . . . . . . . . . . . . . . 306
  957.        Importing and Exporting Echomail Messages. . . . . . . . . . . . 308
  958.        Appendix G: Internal Command Reference . . . . . . . . . . . . . 313
  959.        Appendix H: Digiboard Installation and Use . . . . . . . . . . . 326
  960.        Appendix I: Searchlight for Windows. . . . . . . . . . . . . . . 330
  961.        Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . 330
  962.        General Information. . . . . . . . . . . . . . . . . . . . . . . 330
  963.        Communications . . . . . . . . . . . . . . . . . . . . . . . . . 330
  964.        Setup/Monitor Program. . . . . . . . . . . . . . . . . . . . . . 331
  965.        Runtime Architecture . . . . . . . . . . . . . . . . . . . . . . 331
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.        _____________________________________________________________________
  988.                                         xvi
  989.                                    INTRODUCTION
  990.        _____________________________________________________________________
  991.  
  992.  
  993.         -------------------------------------------------------------------
  994.        | INTRODUCING SEARCHLIGHT                                           |
  995.         -------------------------------------------------------------------
  996.  
  997.        Searchlight Bulletin Board System (BBS) is a powerful software
  998.        package that allows you to set up and run an online service right
  999.        from your PC. Using your computer, a network connection or a modem,
  1000.        and the Searchlight software, you'll have a complete BBS system that
  1001.        will:
  1002.  
  1003.             * Allow others to access your PC via the internet or direct
  1004.               telephone connection and exchange mail and other messages,
  1005.               even when you are not at your computer.
  1006.  
  1007.             * Provide password access and multiple levels of security,
  1008.               enabling you to control exactly who has access to information
  1009.               on your system.
  1010.  
  1011.             * Allow unattended, error-free transfer of programs and data
  1012.               files between your PC and other PC's via the internet or
  1013.               telephone.
  1014.  
  1015.             * Provide a complete, user friendly environment that's easy
  1016.               enough for most people to use intuitively, without the need
  1017.               for any documentation or assistance from you.
  1018.  
  1019.               Those familiar with the BBS community, and especially those
  1020.               who have used other BBS software, will appreciate
  1021.               Searchlight's long list of advanced features:
  1022.  
  1023.             * Internet (telnet) accessibility in addition to traditional
  1024.               dialup access.
  1025.  
  1026.             * Full screen interface for easy entry and editing of messages,
  1027.               mail and text files from a remote terminal.
  1028.  
  1029.             * Unique user interface with built in Online Help facility
  1030.               provides both you and your callers full access to the
  1031.               system's documentation. Complete menu editing function allows
  1032.               total customization.
  1033.  
  1034.             * ANSI and RIP graphics support for flexible screen displays.
  1035.               Built in RIP menu editor and built-in GUI features like
  1036.               scroll bars, dialog boxes and pop-up menus.
  1037.  
  1038.             * Advanced "lock and key" access system providing thousands of
  1039.               security profiles.
  1040.  
  1041.             * Powerful messaging system including message threading, new
  1042.               message scans, search functions, and unlimited message areas.
  1043.  
  1044.             * Complete Electronic Mail system with private "mailboxes" for
  1045.               each caller.
  1046.        _____________________________________________________________________
  1047.                                          1
  1048.                                    INTRODUCTION
  1049.        _____________________________________________________________________
  1050.  
  1051.             * Sysop utilities allow you to adjust most aspects of the
  1052.               system to your liking and give you powerful mass deletion
  1053.               commands. You can control the entire system from a remote
  1054.               location.
  1055.  
  1056.             * Files system featuring alphabetical and date sorted
  1057.               directories, passwords and access levels, up to 15 file
  1058.               transfer protocols, ZIP, ARJ and LZH file directories, etc.
  1059.               Fast file transfers with advanced buffering techniques.
  1060.  
  1061.             * Doors system gives you infinite expandability: run almost any
  1062.               program from within your BBS, write your own commands (in any
  1063.               language), even give console commands from a remote terminal.
  1064.  
  1065.               Searchlight is compatible with most popular door programs.
  1066.  
  1067.  
  1068.         -------------------------------------------------------------------
  1069.        | WHAT DO I NEED TO RUN SEARCHLIGHT BBS?                            |
  1070.         -------------------------------------------------------------------
  1071.  
  1072.        Your Searchlight BBS package includes versions for both MS-DOS and
  1073.        Windows; you can install either or both versions depending on your
  1074.        needs. System requirements vary depending on which versions you run
  1075.        and the number of incoming lines (nodes) you want to support.
  1076.  
  1077.        You can run a single-line BBS with the DOS version of Searchlight on
  1078.        any `286 or better PC with 1mb or more memory, a hard disk drive,
  1079.        and a modem.  To run multiple phone lines with the DOS version, you
  1080.        need at least a `386 w/2mb RAM. You also need the DESQview/386
  1081.        Multitasking Operating System if you want to run multiple nodes
  1082.        using our DOS software.
  1083.  
  1084.        The Windows version of Searchlight BBS requires a PC running Windows
  1085.        95 or Windows NT. We recommend at least a 486-based PC and at least
  1086.        8mb RAM if you run Windows 95, or 16mb if you use Windows NT. You
  1087.        don't need special multitasking software to run multiple nodes with
  1088.        our Windows version.
  1089.  
  1090.        The DOS version of Searchlight works with all standard serial ports
  1091.        and modems, DigiBoard multiport boards, and any device that supplies
  1092.        a FOSSIL driver interface. The Windows version works with standard
  1093.        serial ports and any device which supplies a Windows communications
  1094.        driver.
  1095.  
  1096.        If you want to use Searchlight's Telnet feature (which allows your
  1097.        system to receive connections over the internet), you need a full
  1098.        time internet connection with TCP/IP networking installed. Telnet
  1099.        connectivity is only available in the Windows version of
  1100.        Searchlight.
  1101.  
  1102.        With either version of Searchlight, you'll need one telephone line
  1103.        and one modem for each incoming direct connection you want to
  1104.  
  1105.        _____________________________________________________________________
  1106.                                          2
  1107.                                    INTRODUCTION
  1108.        _____________________________________________________________________
  1109.  
  1110.        support. (Modems are not required if you want to use Searchlight
  1111.        solely for local area network or internet connections).
  1112.  
  1113.  
  1114.         -------------------------------------------------------------------
  1115.        | SEARCHLIGHT FEATURE OVERVIEW                                      |
  1116.         -------------------------------------------------------------------
  1117.  
  1118.        Before you begin using Searchlight, we'd like to provide a short
  1119.        explanation of some of the major design features of our system and
  1120.        show you how these compare to other BBS products:
  1121.  
  1122.  
  1123.        --------------
  1124.        Message System
  1125.        --------------
  1126.  
  1127.        Searchlight divides public messages into areas we call conferences.
  1128.        Within each conference, Searchlight uses a "flat" message system
  1129.        structure; that is, all the messages are viewed as one list, with
  1130.        the oldest messages at the beginning of the list, and the newest
  1131.        messages at the end.
  1132.  
  1133.        Unlike most BBS systems, Searchlight uses short alphanumeric names,
  1134.        rather than numbers or single letters, to designate its message
  1135.        conferences and file areas. We think you'll find it much more
  1136.        convenient to refer to areas by name than to memorize a numeric
  1137.        list, particularly when your BBS contains a large number of message
  1138.        and file areas.
  1139.  
  1140.  
  1141.        ---------------
  1142.        Electronic Mail
  1143.        ---------------
  1144.  
  1145.        On most systems, sending a private message to another caller is
  1146.        possible by specifying the name of the caller to whom the message is
  1147.        directed. Such a message cannot be read by others, but it still
  1148.        appears on the message subsection with the other messages.
  1149.        Typically, you can find messages directed to you by performing an
  1150.        automatic search of all the messages in the system, looking for ones
  1151.        with your name on them.
  1152.  
  1153.        Searchlight uses a different approach. Rather than placing private
  1154.        messages in with the general message base, you send messages
  1155.        directly to another person on the system. This operation is called
  1156.        Electronic Mail, and it is similar to the way real mail works. When
  1157.        you decide to send a personal message to someone, the system looks
  1158.        up their name and places your message into that caller's personal
  1159.        "mailbox". To read a personal message, you inquire into your own
  1160.        mailbox to see what mail other people have sent to you. This method
  1161.        is a lot faster than the traditional approach and gives you an easy
  1162.        way to manage your own messages, separate from the main stream of
  1163.        things.
  1164.        _____________________________________________________________________
  1165.                                          3
  1166.                                    INTRODUCTION
  1167.        _____________________________________________________________________
  1168.  
  1169.        Searchlight's public message system does, in fact, have to fields on
  1170.        messages and supports an extremely efficient personal mail search --
  1171.        so you really have the best of both worlds with Searchlight BBS. Be
  1172.        sure to understand the distinction between public messages and
  1173.        private mail, though, in order to get the most out of using
  1174.        Searchlight.
  1175.  
  1176.        Incidentally, writing a public message on Searchlight is known as
  1177.        "Posting" the message, and is done with a command called POST.
  1178.        Sending a private message is referred to as "Sending" the message,
  1179.        and is done through the MAIL command.
  1180.  
  1181.        With our Uumail internet mail connectivity package, you can extend
  1182.        Searchlight's mail capabilities to include the reading and sending
  1183.        of messages to any internet address, in addition to local
  1184.        destinations.
  1185.  
  1186.  
  1187.        ------------
  1188.        RIP Graphics
  1189.        ------------
  1190.  
  1191.        Searchlight is the first BBS product with built-in support for RIP,
  1192.        the new non-proprietary terminal protocol that brings graphics,
  1193.        mouse support, and other GUI features to BBSing for the first time.
  1194.        Searchlight detects calls from RIP graphics terminals and provides
  1195.        features like mouse support, dialog boxes and scroll bars
  1196.        automatically. In addition, you can customize your display screens,
  1197.        menus, messages and other parts of your system with RIP graphics
  1198.        using a RIP graphics screen generator.
  1199.  
  1200.  
  1201.        ---------
  1202.        Bulletins
  1203.        ---------
  1204.  
  1205.        Searchlight BBS has user-definable bulletins. Unlike other systems,
  1206.        where the bulletin feature is defined by the sysop, callers can post
  1207.        bulletins (if you choose to allow it). The bulletin function is
  1208.        actually a special message base with features that make it ideal for
  1209.        posting announcements and urgent messages.
  1210.  
  1211.  
  1212.        ------------
  1213.        Flow Control
  1214.        ------------
  1215.  
  1216.        The term "flow control" refers to the flow of characters between
  1217.        your computer and a remote terminal, and it's very important on an
  1218.        interactive system like Searchlight BBS. During almost all
  1219.        operations, you can pause the output from Searchlight by pressing
  1220.        control-s, and abort a message or listing by pressing the letter
  1221.        "S", the spacebar or control-c (to enter a "control" character, you
  1222.  
  1223.        _____________________________________________________________________
  1224.                                          4
  1225.                                    INTRODUCTION
  1226.        _____________________________________________________________________
  1227.  
  1228.        hold down the key marked "Ctrl" on your keyboard and press the
  1229.        desired character, then release both keys. In this manual, control
  1230.        keys will generally be indicated with the ^ symbol; in other words,
  1231.        ^C means control-c).
  1232.  
  1233.        Whenever you request a message, display or listing in Searchlight
  1234.        that's larger than a single screen, you'll usually see Searchlight
  1235.        pause at with a prompt that has the options "Continue" and "Stop",
  1236.        allowing you to view that page of the output and then continue, or
  1237.        abort the listing. File listings also offer a "Tag" option that lets
  1238.        you mark particular files for later download. Although there is an
  1239.        explicit prompt for the continue and stop options, you can actually
  1240.        stop a listing at any time by pressing the "S" key or the other keys
  1241.        noted above.
  1242.  
  1243.        In addition, Searchlight features intelligent command type-ahead that
  1244.        lets you bypass most menus when you already know the command you
  1245.        want.  For example, if you press "N" while a message is being
  1246.        displayed, or while the message submenu is being drawn on your
  1247.        screen, Searchlight will stop its output immediately and proceed to
  1248.        the "Next" message.  This feature works while reading messages and
  1249.        mail, in the Bulletins area, on conference and file directory
  1250.        listings, on all submenus such as the Mail and User command menus,
  1251.        and even at the "more" prompt. It's an extremely valuable and time
  1252.        saving feature, especially when using Searchlight from a remote
  1253.        location at slower baud rates.
  1254.  
  1255.        One final word about flow control: in practically every situation
  1256.        where Searchlight requires you to answer an input prompt with a
  1257.        single character response, you need only type the desired character,
  1258.        NOT type the character and then press Enter. You only need to press
  1259.        Enter after typing a whole line of input. If you forget, and DO
  1260.        press the Enter key, it will be stored in memory and used as the
  1261.        response to the NEXT input prompt. This can be quite undesirable and
  1262.        confusing, if you do not understand what's going on -- so be a
  1263.        little careful at first.
  1264.  
  1265.  
  1266.        -----
  1267.        Doors
  1268.        -----
  1269.  
  1270.        In contrast to other BBS systems, Searchlight provides
  1271.        communications support when running external "Door" programs.  That
  1272.        means you don't need to use external support programs, batch files,
  1273.        or device drivers when running Doors; Searchlight handles
  1274.        communications internally, while consuming less than 75K of memory
  1275.        (leaving the rest free for your Door). And Searchlight makes it easy
  1276.        for you to run almost any program as a Door, including existing
  1277.        programs not designed for use with a BBS, and programs you write
  1278.        yourself (in any language). Plus, Searchlight is compatible with most
  1279.        of the programs written for other BBS systems -- giving you access
  1280.        to hundreds of the most popular games and utilities written for BBS
  1281.        use!
  1282.        _____________________________________________________________________
  1283.                                          5
  1284.                                    INTRODUCTION
  1285.        _____________________________________________________________________
  1286.  
  1287.        You can execute MS-DOS based door programs even if you run the
  1288.        Windows version of Searchlight BBS. Searchlight automatically loads
  1289.        the Windows MS-DOS emulator and executes your DOS-based door program
  1290.        for you.
  1291.  
  1292.  
  1293.        ------------
  1294.        Menu Editing
  1295.        ------------
  1296.  
  1297.        Virtually every menu you see when using Searchlight BBS is user
  1298.        definable -- that means you can change the appearance, commands and
  1299.        even the entire structure of our menus if you wish. If the default
  1300.        menus we've provided don't suite your needs, you'll be able to
  1301.        modify the menus, or even create brand new menus from scratch. You
  1302.        can also change the names we use for commands without affecting
  1303.        their function, and even change the text and messages that appear in
  1304.        the software.
  1305.  
  1306.  
  1307.        -------------
  1308.        Mouse Support
  1309.        -------------
  1310.  
  1311.        Searchlight features mouse support. If you have a local mouse
  1312.        attached to your system, you can use it in many places in the main
  1313.        program and CONFIG program instead of the keyboard. Some places that
  1314.        mouse usage is supported include:
  1315.  
  1316.           * Selection of items from menubar style menus
  1317.           * Selecting fields in Options type screens, and changing field
  1318.             values
  1319.           * Moving the cursor around during full screen message editing
  1320.           * Tagging lines when using the reply-quoting feature
  1321.  
  1322.        Mouse usage is supported in most other areas of the program where a
  1323.        menu choice or command choice is displayed on the screen. You can
  1324.        also click on the commands that appear when doing a "Help" command
  1325.        on a word type menu (like the default main menu). The right mouse
  1326.        button acts like an Enter or ESC keypress and can be used to exit
  1327.        most menus and as a substitute for pressing Enter or ESC at many
  1328.        textual prompts.
  1329.  
  1330.        Remote callers can also use mouse functions when calling Searchlight
  1331.        BBS with a RIP graphics compatible terminal.  Remote mouse functions
  1332.        are similar to local mouse functions, except that the right mouse
  1333.        button is not used with RIP.  Mouse functions are not available to
  1334.        remote callers with standard ANSI or non-ANSI terminals.
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.        _____________________________________________________________________
  1342.                                          6
  1343.                                    INTRODUCTION
  1344.        _____________________________________________________________________
  1345.  
  1346.        ---------
  1347.        And More!
  1348.        ---------
  1349.  
  1350.        There are many more interesting Searchlight features, but rather than
  1351.        go into detail here, let's get started with the installation
  1352.        instructions.  These are the major points we want you to keep in
  1353.        mind as your system unfolds, and we'll get to the rest of the
  1354.        goodies in turn.
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.        _____________________________________________________________________
  1401.                                          7
  1402.                                    INSTALLATION
  1403.        _____________________________________________________________________
  1404.  
  1405.  
  1406.         -------------------------------------------------------------------
  1407.        | SEARCHLIGHT BBS INSTALLATION AND SETUP                            |
  1408.         -------------------------------------------------------------------
  1409.  
  1410.        Searchlight BBS comes with both DOS and Windows versions, and your
  1411.        license may be for one or more users (nodes).  This manual covers
  1412.        both the DOS and Windows products for either single or multinode
  1413.        configurations. Note that if you have purchased a single line
  1414.        license, some of this information does not apply to you.
  1415.  
  1416.        If you plan to use a modem with Searchlight BBS, make sure your modem
  1417.        is installed and turned on before you install Searchlight; refer to
  1418.        your modem's documentation for more information. If you are using a
  1419.        new modem or computer, you should verify that the modem is working
  1420.        correctly by running the modem software that came with your modem.
  1421.        This way, if you have trouble setting up your BBS, you'll know
  1422.        whether the modem itself might be at fault.
  1423.  
  1424.        Some sort of text editor or word processor will generally be required
  1425.        for creating/editing text files used by Searchlight.  Since most
  1426.        people already have their favorite, we'll assume you know how to
  1427.        "edit" text files (such as CONFIG.SYS) on your system. If you use
  1428.        Windows, the notepad will suffice.
  1429.  
  1430.  
  1431.         -------------------------------------------------------------------
  1432.        | INSTALLING THE DOS VERSION                                        |
  1433.         -------------------------------------------------------------------
  1434.  
  1435.        The following comments apply to the DOS version of Searchlight. If
  1436.        you'll be installing only the Windows version, you may skip this
  1437.        section.
  1438.  
  1439.  
  1440.        -------------------
  1441.        The CONFIG.SYS File
  1442.        -------------------
  1443.  
  1444.        Somewhere in the root directory of your hard disk, there should be a
  1445.        file called CONFIG.SYS. This file is used to configure various
  1446.        aspects of your computer as it boots.
  1447.  
  1448.        Using a text editor or word processor, examine the CONFIG.SYS file
  1449.        and make sure it contains at least these two lines:
  1450.  
  1451.             Files   = 30
  1452.             Buffers = 20
  1453.  
  1454.        These commands ensure that your computer allocates enough file
  1455.        buffer space for Searchlight. If your CONFIG.SYS file already
  1456.        contains lines like those shown above, make sure the values for
  1457.        Files and Buffers are at least as large as those shown; otherwise,
  1458.  
  1459.        _____________________________________________________________________
  1460.                                          8
  1461.                                    INSTALLATION
  1462.        _____________________________________________________________________
  1463.  
  1464.        change them to the above values. If your disk does not contain the
  1465.        CONFIG.SYS file, create it, and add the three lines shown above.
  1466.  
  1467.        If too few file buffers are allocated when you try to run Searchlight
  1468.        BBS, the program may crash with an I/O error. If this occurs, check
  1469.        to make sure your CONFIG.SYS file contains the appropriate commands.
  1470.        If you continue to see file errors (usually Error 100, Error 103 or
  1471.        Error 104) you may need to increase the value of "Files" in your
  1472.        CONFIG.SYS; this is particularly true if you run a multitasking
  1473.        operating system, network driver or similar resident software.
  1474.  
  1475.        Note: Searchlight doesn't require that the ANSI.SYS file be loaded;
  1476.              however, some external Door programs do require ANSI.SYS to
  1477.              run properly.
  1478.  
  1479.  
  1480.        ------------
  1481.        File Sharing
  1482.        ------------
  1483.  
  1484.        Multiuser versions of Searchlight BBS perform file sharing in order
  1485.        to control access to data files by several callers at the same time.
  1486.        File sharing requires that SHARE.EXE, or its equivalent, be
  1487.        available when Searchlight runs.
  1488.  
  1489.        If you run multiple copies of Searchlight BBS on one machine using
  1490.        DESQview, OS/2 or a similar multitasking system, you will probably
  1491.        need to run the DOS program SHARE.EXE as you boot your system. Make
  1492.        sure the SHARE.EXE file is available on your disk, then load it by
  1493.        entering the command "SHARE" into your AUTOEXEC.BAT file (and
  1494.        rebooting your system).
  1495.  
  1496.        Because of its low memory requirements and overall efficiency,
  1497.        Quarterdeck's DESQview is the recommended multitasking operating
  1498.        software with which to run Searchlight BBS. You can also run
  1499.        Searchlight with IBM's OS/2.
  1500.  
  1501.        If you run Searchlight on a local area network, your LAN probably
  1502.        provides the Share function automatically. Do not load SHARE.EXE
  1503.        unless your LAN documentation instructs you to do so, or you receive
  1504.        a share related error message when you run Searchlight BBS.
  1505.  
  1506.        Please see Appendix B, Guide To Error Messages, for more information
  1507.        about loading Share and the share related error messages provided by
  1508.        Searchlight BBS.
  1509.  
  1510.        More information on the CONFIG.SYS and SHARE.EXE files can be found
  1511.        in your DOS manual.
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.        _____________________________________________________________________
  1519.                                          9
  1520.                                    INSTALLATION
  1521.        _____________________________________________________________________
  1522.  
  1523.  
  1524.        ------------
  1525.        Installation
  1526.        ------------
  1527.  
  1528.        Installing Searchlight BBS is a simple procedure, thanks to the easy
  1529.        to use INSTALL program we've provided.
  1530.  
  1531.        If your computer's floppy disk drive is drive A:, simply insert the
  1532.        Searchlight disk and type:
  1533.  
  1534.             A:INSTALL
  1535.  
  1536.        Of course, if you're using the B: floppy drive, type "B:INSTALL"
  1537.        instead.  When the installation menu appears, just select "New
  1538.        Installation" if you're a first time customer, or "Update
  1539.        Installation" if you already have a copy of Searchlight on your
  1540.        system.
  1541.  
  1542.        Proceed with the installation process by following the instructions
  1543.        that appear on your screen. The INSTALL program automatically
  1544.        creates appropriate directories on your hard disk, loads the
  1545.        Searchlight program files, and creates Searchlight data files for
  1546.        you. When the installation is complete, your command prompt
  1547.        re-appears.
  1548.  
  1549.        Note: Searchlight contains a number of optional components, such as
  1550.              an external version of the Zmodem protocol, which may be
  1551.              installed if you choose after the main programs are installed.
  1552.              Each optional component that you load contains its own
  1553.              documentation (.DOC) file that you can read to find out more
  1554.              about using that option.
  1555.  
  1556.        You're now ready to run Searchlight BBS! There are two main commands
  1557.        you'll need to know right now. To start Searchlight itself and begin
  1558.        waiting for an incoming phone call (or initiate a local session),
  1559.        type at your command prompt:
  1560.  
  1561.             SLBBS
  1562.  
  1563.        To access Searchlight's configuration menus and sysop utilities,
  1564.        enter this command:
  1565.  
  1566.             CONFIG
  1567.  
  1568.        We recommend running CONFIG first, in order to set Searchlight's
  1569.        options to your own preferences before you actually run your BBS.
  1570.        We'll talk more about the configuration program's features in the
  1571.        next few chapters.
  1572.  
  1573.        Note: If you want to run the Windows version of Searchlight under
  1574.              Windows 95 or Windows NT, the command to start Searchlight is
  1575.              SLBBS32. For more information about Searchlight and Windows,
  1576.              see "Appendix I: Searchlight for Windows."
  1577.        _____________________________________________________________________
  1578.                                         10
  1579.                                    INSTALLATION
  1580.        _____________________________________________________________________
  1581.  
  1582.  
  1583.  
  1584.        --------------------------
  1585.        SLBBS Environment Variable
  1586.        --------------------------
  1587.  
  1588.        In most cases, you'll be located in Searchlight's "home" directory
  1589.        every time you start the main program or run one of the utility
  1590.        programs. While you should always be in the home directory when you
  1591.        enter the command to start Searchlight, you can run utilities (like
  1592.        the CONFIG program or the auxiliary programs found on your
  1593.        distribution disk) from any directory, as long as you set up a DOS
  1594.        environment variable to tell Searchlight where the home directory is
  1595.        loaded.  To set up the environment variable, type "SET
  1596.        SLBBS=<directory>" at your command prompt, like this:
  1597.  
  1598.             SET SLBBS=C:\SLBBS
  1599.  
  1600.        You need to set this variable BEFORE running Searchlight or any
  1601.        Searchlight utilities. It's best to put the command into a startup
  1602.        file (like AUTOEXEC.BAT) to save you the trouble of having to enter
  1603.        it every time you boot your system. If you run a multiuser system,
  1604.        be sure that each node has its own `SLBBS' environment variable
  1605.        pointing to its own home directory.
  1606.  
  1607.  
  1608.        -----------------------------
  1609.        Upgrading From Older Versions
  1610.        -----------------------------
  1611.  
  1612.        All versions of Searchlight BBS provide an upgrade path that allows
  1613.        you to upgrade to newer versions of the software without losing any
  1614.        messages, caller records, or setup information stored on your
  1615.        system. You can upgrade to the latest version even if you are
  1616.        currently using as old a version of Searchlight as 1.28, which was
  1617.        released in 1988.
  1618.  
  1619.  
  1620.        -------------------------------------
  1621.        Upgrading From Searchlight 2.x -- 4.x
  1622.        -------------------------------------
  1623.  
  1624.        If you are upgrading from Searchlight 2.x through 4.x (for example,
  1625.        from version 3.5 to 5.0) the upgrade is automatic:  simply select
  1626.        Upgrade Installation when you run the INSTALL program. New versions
  1627.        of the Searchlight program files will replace your existing files.
  1628.        Since the data files for all 2.x, 3.x and 4.x versions of
  1629.        Searchlight are compatible with version 5, there is no data file
  1630.        upgrade procedure necessary, and all of your existing information
  1631.        will be retained.
  1632.  
  1633.        If you are upgrading from Searchlight 2.15, the upgrade program will
  1634.        also install the MENU FILES that are used by Searchlight version
  1635.  
  1636.        _____________________________________________________________________
  1637.                                         11
  1638.                                    INSTALLATION
  1639.        _____________________________________________________________________
  1640.  
  1641.        2.25 and later.  The menus files provided emulate the built in menus
  1642.        that were incorporated into Searchlight 2.15, but now you can change
  1643.        them: see Menu System (see section "Menu Editor - Searchlight Menu
  1644.        Editor") for more information.
  1645.  
  1646.  
  1647.        ------------------------------
  1648.        Upgrading From Searchlight 1.x
  1649.        ------------------------------
  1650.  
  1651.        Upgrading from versions of Searchlight older than 2.0 requires the
  1652.        use of an upgrade utility program, which may be downloaded from
  1653.        Searchlight's support BBS or Web site. Contact our technical support
  1654.        department if you need additional information about this type of
  1655.        upgrade.
  1656.  
  1657.  
  1658.         -------------------------------------------------------------------
  1659.        | USING THE WINDOWS VERSION                                         |
  1660.         -------------------------------------------------------------------
  1661.  
  1662.        If you run Windows 95 or Windows NT, you use the Windows version of
  1663.        Searchlight BBS instead of, or in addition to, the DOS version. Both
  1664.        the DOS and Windows versions are installed when you run the INSTALL
  1665.        program. To start the Windows version of Searchlight, execute the
  1666.        program WSLBBS.EXE.
  1667.  
  1668.        For additional background information on the Windows version of
  1669.        Searchlight BBS, please see Appendix I.
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.        _____________________________________________________________________
  1696.                                         12
  1697.                                    CONFIGURATION
  1698.        _____________________________________________________________________
  1699.  
  1700.  
  1701.         -------------------------------------------------------------------
  1702.        | SEARCHLIGHT BBS CONFIGURATION                                     |
  1703.         -------------------------------------------------------------------
  1704.  
  1705.        Before you launch Searchlight itself, you'll want to run one of
  1706.        Searchlight's configuration utility programs to set up and configure
  1707.        your system. You can reenter the configuration utility anytime you
  1708.        want to modify your settings.
  1709.  
  1710.        There are different configuration programs depending on whether you
  1711.        use the DOS or Windows version of Searchlight, but the options and
  1712.        settings they allow you to modify are the same. If you run the DOS
  1713.        version of Searchlight BBS, start the CONFIG.EXE program by typing
  1714.        "CONFIG" at the command prompt.  If you use the Windows version,
  1715.        launch the Configuration Utility by typing "WSLBBS" at a command
  1716.        prompt, or by selecting its icon from your start menu.
  1717.  
  1718.        Note: Throughout this manual, we'll use the term "CONFIG" to refer
  1719.              generically to either the DOS or Windows configuration
  1720.              program. If you run the Windows version exclusively,
  1721.              substitute WSLBBS for CONFIG. Screen displays shown here match
  1722.              the DOS CONFIG program; for the Windows utility, select the
  1723.              tab stop or menu choice that matches the name of the DOS
  1724.              screen or setting.
  1725.  
  1726.        You should be located in the "home" directory -- the directory where
  1727.        your Searchlight BBS data files are located -- when you run
  1728.        CONFIG.EXE. Run the configuration program by typing CONFIG at your
  1729.        DOS prompt. For example:
  1730.  
  1731.             C:\SLBBS> CONFIG
  1732.  
  1733.        If you see a message indicating that your Searchlight files can't be
  1734.        found, you should either make sure you are located in the directory
  1735.        that contains the files (the directory you specified during the
  1736.        install process), or set an SLBBS= environment parameter.
  1737.  
  1738.        Your screen should now show Searchlight's main configuration menu.
  1739.        CONFIG divides the setup procedures into several categories, as
  1740.        follows:
  1741.  
  1742.             A. General Configuration
  1743.             B. Message Conference Maintenance
  1744.             C. File Directory Maintenance
  1745.             D. User/Conference/File Utilities
  1746.             E. Searchlight Menu Editor
  1747.             F. Languages Configuration
  1748.  
  1749.        To begin, select the first item, General Configuration, by pressing
  1750.        the "A" key on your keyboard (don't press ENTER -- just press "A").
  1751.        The screen now shows a new menu that looks like this:
  1752.  
  1753.  
  1754.        _____________________________________________________________________
  1755.                                         13
  1756.                                    CONFIGURATION
  1757.        _____________________________________________________________________
  1758.  
  1759.             A. General Setup Menu #1
  1760.             B. General Setup Menu #2
  1761.             C. Communications Setup
  1762.             D. File Pathnames Setup Menu
  1763.             E. Xfer Protocols Setup
  1764.             F. Screen Colors Setup
  1765.             G. AutoDoors Setup
  1766.             H. Function Attrib Setup
  1767.             I. Default Access Levels
  1768.             J. Network Mail Setup
  1769.             K. RIP General Setup
  1770.             L. RIP Styles Setup
  1771.             M. RIP Sounds Setup
  1772.             N. Activity Logging
  1773.  
  1774.        We'll begin at the top with General Setup Menu #1, so press "A" at
  1775.        your keyboard again (or, if you prefer, click on the first menu line
  1776.        with your mouse), and follow along with the menu options as we
  1777.        describe them in the following pages.
  1778.  
  1779.  
  1780.         -------------------------------------------------------------------
  1781.        | SEARCHLIGHT BBS GENERAL SETUP MENU #1                             |
  1782.         -------------------------------------------------------------------
  1783.  
  1784.              1. System Name ................... Searchlight
  1785.              2. Allow New Users ............... Yes
  1786.              3. Prompt for Alias Names ........ No
  1787.              4. Allow Alias Name Logins ....... Yes
  1788.              5. Language Selection Prompt ..... Before Login
  1789.              6. Min. Access Needed to Log In .. 0
  1790.              7. Node Number ................... 1
  1791.              8. Number of Active Nodes ........ 2
  1792.              9. Cost (Credits per Minute) ..... 0
  1793.             10. New User Defaults [. . .]
  1794.  
  1795.        The first field, System Name, is highlighted by a reverse-video bar.
  1796.        To change the value of a field, you can type over the existing
  1797.        string, or edit it with the cursor keys. To switch to other fields,
  1798.        press the up and down arrow keys, or use your mouse to highlight the
  1799.        desired value. Numeric values are entered by typing a number within
  1800.        the allowable range, which is indicated to the right of the field
  1801.        when the field is selected, or by clicking the arrows with your
  1802.        mouse. Other fields can be changed by pressing the
  1803.        spacebar/backspace keys or left mouse button to display the
  1804.        available options. When you are done editing the above fields, press
  1805.        the ESC or ^Z (control-Z) key or the right mouse button to exit back
  1806.        to the CONFIG main menu. You may now go on to the next screen of
  1807.        configuration options, or exit the program by pressing ESC or the
  1808.        right mouse button again.
  1809.  
  1810.        Here is a detailed description of the functions of each option. As
  1811.        you move down the list, change the options as necessary or desired
  1812.        for your particular system.
  1813.        _____________________________________________________________________
  1814.                                         14
  1815.                                    CONFIGURATION
  1816.        _____________________________________________________________________
  1817.  
  1818.  
  1819.        ---------------
  1820.        1 - System Name
  1821.        ---------------
  1822.  
  1823.        This is an alphabetic field that you can use to enter an identifying
  1824.        name for your BBS. This name is used at the login message, on the
  1825.        help screen display, at the top of the Bulletin listing, and in the
  1826.        logoff message.
  1827.  
  1828.  
  1829.        -------------------
  1830.        2 - Allow New Users
  1831.        -------------------
  1832.  
  1833.        This option, normally set to "Yes", determines whether your system
  1834.        will allow new callers to register their names and passwords. When
  1835.        set to "Yes", new callers will be allowed to register by typing
  1836.        "NEW" at the login prompt.  If changed to "No", your BBS becomes a
  1837.        closed system, allowing only those callers with passwords already on
  1838.        file to log in.
  1839.  
  1840.        Note: If you decide to run a closed system, you must still set this
  1841.              option to "Yes" initially to allow callers to register.  You
  1842.              can either allow your callers to register themselves or you
  1843.              can register the names yourself by logging in locally and
  1844.              typing "NEW" at the login prompt. (You can also create new
  1845.              user accounts with Searchlight's Spotlight software; contact
  1846.              us for more information).
  1847.  
  1848.  
  1849.        --------------------------
  1850.        3 - Prompt for Alias Names
  1851.        --------------------------
  1852.  
  1853.        Searchlight allows each caller to maintain an alternate or "alias"
  1854.        name in addition to his or her real name. If you want to allow alias
  1855.        names on your BBS, set this switch to "Yes". Searchlight will then
  1856.        prompt callers for an alias name during the new caller registration
  1857.        process. If "No" is selected, callers won't be prompted for an alias
  1858.        name during the log in procedure (but you can still allow your
  1859.        callers to maintain an alias name via the Options/Preference
  1860.        command; see the section "Configuring User Options").
  1861.  
  1862.  
  1863.        ---------------------------
  1864.        4 - Allow Alias Name Logins
  1865.        ---------------------------
  1866.  
  1867.        If you allow alias names on your BBS, you can also choose whether you
  1868.        would like to permit callers to use their alias name as their login
  1869.        name. If you allow alias logins, callers will be able to type their
  1870.        alias name and password to log in. If you disallow alias logins,
  1871.  
  1872.        _____________________________________________________________________
  1873.                                         15
  1874.                                    CONFIGURATION
  1875.        _____________________________________________________________________
  1876.  
  1877.        callers must always enter their real name and password to log into
  1878.        your BBS, but may use alias names to enter messages if you permit
  1879.        it.
  1880.  
  1881.  
  1882.        -----------------------------
  1883.        5 - Language Selection Prompt
  1884.        -----------------------------
  1885.  
  1886.        If your BBS offers multiple languages, this option allows you to
  1887.        determine how the language choice is presented to your callers. The
  1888.        choices are "Before Login", "After Login" or "None".
  1889.  
  1890.        If "Before Login" is selected, Searchlight prompts each caller for
  1891.        their desired language immediately after a connection is
  1892.        established_and before the caller enters their name. Because the
  1893.        language is selected first, this option gives you the opportunity to
  1894.        present your login screen in the language of the caller's choice.
  1895.  
  1896.        If "After Login" is selected, Searchlight delays the language
  1897.        selection choice until after the caller has entered a name and
  1898.        password. The default language is used for the login screen and
  1899.        name/password dialogues. The advantage to this method is that the
  1900.        caller's last selected language may be used as a default.
  1901.  
  1902.        If you don't offer multiple languages, choose "None".
  1903.  
  1904.  
  1905.        --------------------------------
  1906.        6 - Min. Access Needed to Log In
  1907.        --------------------------------
  1908.  
  1909.        This field defines the minimum access level that a caller needs to
  1910.        log in via this particular node. You can use this feature on
  1911.        multinode systems to set up a system where some nodes are public
  1912.        access, and some are restricted to callers with a certain access
  1913.        level. Normally, at least one node should have a minimum access
  1914.        level of 0 (allowing public access).
  1915.  
  1916.  
  1917.        ----------------------
  1918.        7 and 8 - Node Numbers
  1919.        ----------------------
  1920.  
  1921.        These fields determine the node number of the current node and the
  1922.        total number of nodes in the system. When you copy your CONFIG.SL2
  1923.        file to a different directory and change the node numbers, you can
  1924.        create additional nodes that allow multiple callers to access your
  1925.        BBS at the same time. For more information, see the section
  1926.        "Configuration - Multinode Setup."
  1927.  
  1928.  
  1929.  
  1930.  
  1931.        _____________________________________________________________________
  1932.                                         16
  1933.                                    CONFIGURATION
  1934.        _____________________________________________________________________
  1935.  
  1936.        Note: The maximum number you can type in lines 7 and 8 depends on
  1937.              the product license level you purchased when ordering
  1938.              Searchlight BBS. For example, if you own a 10 user license,
  1939.              you can enter a maximum value of 10. If you'd like to upgrade
  1940.              your license level at any time, please contact TeleGrafix for
  1941.              upgrade information.
  1942.  
  1943.  
  1944.        -----------------------------
  1945.        9 - Cost (Credits per Minute)
  1946.        -----------------------------
  1947.  
  1948.        Line 9 defines the default "cost" to use your BBS system in terms of
  1949.        credits per minute. For each minute that someone is logged on to
  1950.        your BBS, Searchlight deducts this amount from that user's credit
  1951.        account. When a user's account reaches zero, they are disconnected
  1952.        any may not be allowed reentry to your system until their account
  1953.        has been replenished.
  1954.  
  1955.        If you do not wish to regulate online time by credits, be sure to set
  1956.        this value to zero.
  1957.  
  1958.  
  1959.        ----------------------
  1960.        10 - New User Defaults
  1961.        ----------------------
  1962.  
  1963.        In this section, you set default values for the user preferences.
  1964.        Each new account that Searchlight creates starts off with the values
  1965.        you provide here, although users can edit their account properties
  1966.        after they are logged in.
  1967.  
  1968.        The defaults you can set here include Help Level, ANSI Compatibility,
  1969.        Screen Length, File List Format, Pause Between Messages, Conference
  1970.        Disposition Prompts, Mail Disposition Prompts, Internal Protocol,
  1971.        Preference Attributes, and RIP
  1972.  
  1973.        Text Font. For more information about these options, see the section
  1974.        "Configuring User Options - User/Preference".  You also set the
  1975.        number of credits assigned to each new user account here.
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.        _____________________________________________________________________
  1991.                                         17
  1992.                                    CONFIGURATION
  1993.        _____________________________________________________________________
  1994.  
  1995.  
  1996.         -------------------------------------------------------------------
  1997.        | SEARCHLIGHT BBS GENERAL SETUP MENU #2                             |
  1998.         -------------------------------------------------------------------
  1999.  
  2000.              1. Screen Write Method ......... Direct
  2001.              2. Idle Time Limit ............. 15
  2002.              3. Quotes File ................. On
  2003.              4. Return to DOS on Logoff ..... No
  2004.              5. Hangup Phone on Logoff ...... Yes
  2005.              6. Allow Console Hotkeys ....... Yes
  2006.              7. Date Format ................. USA
  2007.              8. Time Format ................. 12 Hour
  2008.              9. Upload Time Repay Rate ...... 1
  2009.             10. ROM File Handling ........... Direct
  2010.             11. User Log Status ............. Public
  2011.             12. Clock Tick Source ........... Direct
  2012.             13. Use Session Time Limits? .... No
  2013.             14. Expired User Action ......... None
  2014.             15. Default Login Greeting ...... On
  2015.             16. Max File Description Size ... 10
  2016.             17. Allow High ASCII Chars ...... Yes
  2017.             18. Allow User Name Completion .. Yes
  2018.             19. Allow Mail Carbon Copies .... Yes
  2019.  
  2020.        Option screen B displays some more configuration switches for
  2021.        customizing your setup. Adjust your options as follows:
  2022.  
  2023.  
  2024.        -----------------------
  2025.        1 - Screen Write Method
  2026.        -----------------------
  2027.  
  2028.        This can be set to either BIOS or Direct. In BIOS mode, Searchlight
  2029.        will use BIOS calls to send all its output to the screen. In Direct
  2030.        mode, the BIOS is bypassed and screenwriting occurs via direct
  2031.        access to your computer's video hardware.
  2032.  
  2033.        In general, Direct mode is faster than BIOS mode. BIOS mode offers
  2034.        compatibility with standard system I/O functions, and is preferable
  2035.        when running Searchlight in a windowed environment (such as DESQview
  2036.        or OS/2). If you use a multiple window environment and you have a
  2037.        problem with Searchlight overwriting other windows on your screen,
  2038.        select BIOS mode; if you run only a single copy of Searchlight on
  2039.        any given machine, use Direct.
  2040.  
  2041.        Note: This setting has no effect on the Windows version of
  2042.              Searchlight.
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.        _____________________________________________________________________
  2050.                                         18
  2051.                                    CONFIGURATION
  2052.        _____________________________________________________________________
  2053.  
  2054.  
  2055.        -------------------
  2056.        2 - Idle Time Limit
  2057.        -------------------
  2058.  
  2059.        The value in this field determines the amount of time, in minutes,
  2060.        that Searchlight will wait for keyboard input. If Searchlight stops
  2061.        to wait for input and no keys are pressed after this amount of time
  2062.        has passed, Searchlight will abort the call and recycle back to the
  2063.        Login screen.
  2064.  
  2065.        Note: Please note that the idle time limit is NOT enforced during a
  2066.              local login.
  2067.  
  2068.  
  2069.        ---------------
  2070.        3 - Quotes File
  2071.        ---------------
  2072.  
  2073.        Searchlight's user quotes feature (the "Please leave us a quote"
  2074.        prompt displayed at logoff time) can be enabled or disabled with
  2075.        this option. If enabled, callers are able to enter short quotes each
  2076.        time they access the system, and the Quotes command (on the main
  2077.        menu) can be used to browse through the quotes left by others.
  2078.  
  2079.  
  2080.        ---------------------------
  2081.        4 - Return to DOS on Logoff
  2082.        ---------------------------
  2083.  
  2084.        This option controls the behavior of the system when a caller logs
  2085.        off, hangs up, or is otherwise disconnected from your BBS. In the
  2086.        default mode, with Return to DOS set to "No", the system will reset
  2087.        the modem, recycle to the Login program, and begin waiting for the
  2088.        next call. If "Yes" is selected, Searchlight will return to DOS when
  2089.        a caller logs off.
  2090.  
  2091.        Return to DOS is provided to enable Searchlight to be used with a
  2092.        "front-end" program. Typically, such a program will monitor and
  2093.        answer the telephone, start Searchlight BBS when a call is received,
  2094.        and regain control of the system when the call is finished. These
  2095.        programs are used for special purposes such as the interception of
  2096.        network mail. If you will not be using this type of program, leave
  2097.        this option set to "No".
  2098.  
  2099.        If Return to DOS is used, Searchlight will return a nonzero return
  2100.        code (errorlevel) if ALT-X is pressed by the Sysop or if there is an
  2101.        error encountered while running the BBS. The front end program
  2102.        should be set up to terminate to DOS when this happens, rather than
  2103.        recycle.
  2104.  
  2105.  
  2106.  
  2107.  
  2108.        _____________________________________________________________________
  2109.                                         19
  2110.                                    CONFIGURATION
  2111.        _____________________________________________________________________
  2112.  
  2113.        Note: If this option is selected, the only way to start Searchlight
  2114.              is with command line parameters for the baud rate and maximum
  2115.              time limit. See the section "Startup, Login & New Users -
  2116.              Command Line Parameters" for more information.
  2117.  
  2118.  
  2119.        --------------------------
  2120.        5 - Hangup Phone on Logoff
  2121.        --------------------------
  2122.  
  2123.        This option controls whether you want Searchlight to disconnect when
  2124.        a caller logs off. Normally, select "Yes" to hang up the phone and
  2125.        recycle the system for a new caller. Use "No" if you are running
  2126.        your copy of Searchlight BBS as a door or from a front end program
  2127.        which requires that the connection be maintained after Searchlight
  2128.        completes.
  2129.  
  2130.  
  2131.        -------------------------
  2132.        6 - Allow Console HotKeys
  2133.        -------------------------
  2134.  
  2135.        This switch controls whether the special "HotKey" functions (ALT-L,
  2136.        ALT-S, etc.) will be available at the local keyboard. Normally,
  2137.        leave HotKeys enabled if you or other Sysops will be the only people
  2138.        with access to the local PC. If you're running Searchlight in a
  2139.        situation where non-Sysop users will be logging into the system in
  2140.        local mode (such as in a local area network), turn HotKeys Off to
  2141.        disable unauthorized use of sysop functions.
  2142.  
  2143.  
  2144.        -------------------------------
  2145.        7 and 8 - Date and Time Formats
  2146.        -------------------------------
  2147.  
  2148.        These switches control the format in which dates and times are
  2149.        displayed.  Dates may be displayed in the USA format, MM-DD-YY, or
  2150.        the European format, DD/MM/YY. Notice that Searchlight uses the "-"
  2151.        character as the separator in the USA format, and the "/" in the
  2152.        European format; this is done to help distinguish the different
  2153.        formats. Inputting of dates, where required, must be done in the
  2154.        selected format.
  2155.  
  2156.        Times can be displayed in 12-Hour or 24-Hour formats. The 12 hour
  2157.        format includes an "am" or "pm" indicator.
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.        _____________________________________________________________________
  2168.                                         20
  2169.                                    CONFIGURATION
  2170.        _____________________________________________________________________
  2171.  
  2172.  
  2173.        --------------------------
  2174.        9 - Upload Time Repay Rate
  2175.        --------------------------
  2176.  
  2177.        This option determines the amount of "repay" time that the system
  2178.        will give for uploaded files. If the repay rate is set to 1, callers
  2179.        will be credited with the same amount of time that it took to upload
  2180.        a file, so that if a 10 minute upload occurs, an additional 10
  2181.        minutes of time are granted when the upload completes. If the repay
  2182.        rate is 2 to 1, an additional 20 minutes of time would be granted
  2183.        for a 10 minute upload, etc. If the repay rate is 0, then no
  2184.        additional time is credited for uploads.
  2185.  
  2186.        Note: Searchlight will reduce the amount of additional time granted
  2187.              after an upload if the additional time would interfere with a
  2188.              scheduled event, or exceed the maximum session time limit.
  2189.  
  2190.  
  2191.        ----------------------
  2192.        10 - ROM File Handling
  2193.        ----------------------
  2194.  
  2195.        This switch specifies whether files which reside on read-only
  2196.        devices, such as CD-ROM drives, will be accessed directly off the
  2197.        ROM device or copied to hard disk first.
  2198.  
  2199.        When this option is set to "Copy", Searchlight handles all files on
  2200.        read-only devices (those file directories for which the "Path to DIR
  2201.        File" is different from "Path to Files") by copying files from the
  2202.        ROM device to the DIR file path when Download or View commands are
  2203.        used. The directory containing the DIR file, rather than the ROM
  2204.        device itself, is made the active directory when external protocols
  2205.        are invoked. After the command is completed, Searchlight removes the
  2206.        copied files from your hard disk.
  2207.  
  2208.        File copying should be used if you experience sluggish operation or
  2209.        compatibility problems when accessing files on a CD-ROM or similar
  2210.        device.  Please see the File Transfer System section of this manual
  2211.        for further details.
  2212.  
  2213.  
  2214.        --------------------
  2215.        11 - User Log Status
  2216.        --------------------
  2217.  
  2218.        This option allows you to designate the status of your user list and
  2219.        caller logs as either Public or Private. When Public is selected,
  2220.        the USER command on Searchlight's main menu is available to all
  2221.        callers and can be used to search and display your user log and last
  2222.        75 callers log. If you select Private, your user logs are kept
  2223.        private and the USER command is made unavailable to all callers
  2224.        except the Sysop and Co-Sysops.
  2225.  
  2226.        _____________________________________________________________________
  2227.                                         21
  2228.                                    CONFIGURATION
  2229.        _____________________________________________________________________
  2230.  
  2231.        Note: You can also restrict or eliminate the USER command, or any
  2232.              other command, by editing your menus with Searchlight's menu
  2233.              editing features.
  2234.  
  2235.  
  2236.        ----------------------
  2237.        12 - Clock Tick Source
  2238.        ----------------------
  2239.  
  2240.        This option controls whether Searchlight uses a DOS call, a BIOS call
  2241.        or a direct memory read to obtain real-time clock information. Use
  2242.        "Direct" unless it conflicts with your operating system, otherwise
  2243.        use "DOS" or "BIOS" methods. If you experience problems such as
  2244.        system lockups, extremely short or long time delays, or inaccurate
  2245.        system dates, change this option.
  2246.  
  2247.        Note: This setting has no effect on the Windows version of
  2248.              Searchlight.
  2249.  
  2250.  
  2251.        -----------------------------
  2252.        13 - Use Session Time Limits?
  2253.        -----------------------------
  2254.  
  2255.        Searchlight supports the ability to limit a caller's time limit per
  2256.        session (per login) as well as per day. If you'd like to use this
  2257.        ability, set this field to "Yes". Otherwise, leave it set to "No".
  2258.  
  2259.        If you do choose "Yes", you must be sure to set your caller accounts
  2260.        up so that they have the desired Session Time Limit attributes. You
  2261.        can adjust accounts manually (via 2-Sysop/Options command on
  2262.        Searchlight's main menu), or you can perform global changes with the
  2263.        Sysop Utilities menu in the CONFIG program.
  2264.  
  2265.  
  2266.        ------------------------
  2267.        14 - Expired User Action
  2268.        ------------------------
  2269.  
  2270.        This field determines what to do with caller accounts which have
  2271.        "expired"*in other words, which are older than the expiration date
  2272.        specified in the account. The default action is "None", which means
  2273.        that nothing happens to these accounts (in effect, expiration dates
  2274.        are not used).
  2275.  
  2276.        If you'd like to use expiration dates on your system, set this field
  2277.        to either "Reset Access" or "Delete Account". The former setting
  2278.        will cause the caller's access level to fall back to the New User
  2279.        level when their account expires. The latter will cause the account
  2280.        to be deleted. In both cases, callers receive a 30 day warning
  2281.        message before the action occurs (the warning message appears as
  2282.        part of their log-in sequence).
  2283.  
  2284.  
  2285.        _____________________________________________________________________
  2286.                                         22
  2287.                                    CONFIGURATION
  2288.        _____________________________________________________________________
  2289.  
  2290.        Expired user actions only take place if and when a caller with an
  2291.        expired account attempts to log in to your BBS -- no action is taken
  2292.        if such a caller never calls back.
  2293.  
  2294.  
  2295.        ---------------------------
  2296.        15 - Default Login Greeting
  2297.        ---------------------------
  2298.  
  2299.        This switch enables or disables the default "greeting" message that
  2300.        is displayed when a caller logs in to your BBS. The default message
  2301.        includes the date and time, the name of the last caller, and the
  2302.        caller's last login date.
  2303.  
  2304.        If you disable the default greeting, you may provide your own
  2305.        greeting by creating a text, ANSI or RIP file named "GREETING" in
  2306.        the system text directory (use TXT, ANS or RIP file extensions as
  2307.        appropriate).
  2308.  
  2309.  
  2310.        ------------------------------
  2311.        16 - Max File Description Size
  2312.        ------------------------------
  2313.  
  2314.        This line defines the maximum length (in lines) of file descriptions
  2315.        that can be entered when uploading a file. The default size is 10.
  2316.  
  2317.  
  2318.        ---------------------------
  2319.        17 - Allow High ASCII Chars
  2320.        ---------------------------
  2321.  
  2322.        High ASCII characters_those in the range 128 through 255_normally
  2323.        aren't permitted to be part of a caller's name. If you want to allow
  2324.        high ASCII as part of caller names, set this switch to "Yes". This
  2325.        options is most useful if you expect to have non-English speaking
  2326.        callers.
  2327.  
  2328.  
  2329.        -------------------------------
  2330.        18 - Allow User Name Completion
  2331.        -------------------------------
  2332.  
  2333.        "User Name Completion" means that Searchlight looks for partial
  2334.        matches when you type an incomplete user name as part of an email
  2335.        address or other name lookup. For example, if you enter the text
  2336.        "DARRELL DAV", Searchlight might select a caller named "DARRELL
  2337.        DAVIS". As user name completion is very convenient; "Yes" is the
  2338.        default setting here.
  2339.  
  2340.        You can disable name completion by setting this option to "No". If
  2341.        you consider your caller list to be private information, you may
  2342.        wish to disable name completion in order to keep caller names more
  2343.        secure.
  2344.        _____________________________________________________________________
  2345.                                         23
  2346.                                    CONFIGURATION
  2347.        _____________________________________________________________________
  2348.  
  2349.  
  2350.        -----------------------------
  2351.        19 - Allow Mail Carbon Copies
  2352.        -----------------------------
  2353.  
  2354.        Searchlight's Carbon Copy feature allows you and your callers to send
  2355.        the same email message to multiple recipients with a single command.
  2356.        If you wish to disable carbon copy capabilities, set this option to
  2357.        "No".
  2358.  
  2359.  
  2360.         -------------------------------------------------------------------
  2361.        | SEARCHLIGHT BBS COMMUNICATIONS SETUP                              |
  2362.         -------------------------------------------------------------------
  2363.  
  2364.              1. COM Port Number .......... 1
  2365.              2. Modem Type ............... High Speed
  2366.              3. Locked Baud Rate ......... 19200
  2367.              4. Hardware Flow Control .... On
  2368.              5. Speed Detect Method ...... Modem Msg
  2369.              6. Minimum Connect Speed .... 1200
  2370.              7. Output Buffering Factor .. 32
  2371.              8. Buffer Door Programs? .... Yes
  2372.              9. Modem Init String ........ AT&C1&D2&K3!
  2373.             10. Local Init String ........ ATH1!
  2374.             11. Answer String ............ ATA!
  2375.             12. COM Port Setups [...]
  2376.  
  2377.        The modem setup screen is very important. Please read the following
  2378.        information carefully. Additional information about modems can be
  2379.        found in Appendix D, Modem Configuration, later in this manual.
  2380.  
  2381.        In most cases, Searchlight can configure these communications
  2382.        settings for you. See Automatic Configuration below.
  2383.  
  2384.        Note: With the Windows version of Searchlight, you can accept
  2385.        connections via the internet (using the Telnet protocol) in addition
  2386.        to, or instead of, via a modem. For more information about Telnet
  2387.        connectivity, see the section "Searchlight and Telnet."
  2388.  
  2389.  
  2390.        -------------------
  2391.        1 - COM Port Number
  2392.        -------------------
  2393.  
  2394.        This controls which communications port will be used to communicate
  2395.        with your modem. Make sure you set this option to the correct value
  2396.        for the modem in your system. If you have no modem or serial port,
  2397.        you may give a value of zero; this prevents Searchlight from
  2398.        attempting to initialize or otherwise access a modem (but still
  2399.        allows you to run the system in local mode or Telnet mode).
  2400.  
  2401.  
  2402.  
  2403.        _____________________________________________________________________
  2404.                                         24
  2405.                                    CONFIGURATION
  2406.        _____________________________________________________________________
  2407.  
  2408.        With the DOS version of Searchlight BBS, you can set the COM Port
  2409.        Number to a value between 1 and 4. However, you can customize each
  2410.        of the four COM ports to use a specific hardware address or device
  2411.        driver via the Com Port Setups screen, covered below. If you're
  2412.        using a port other than COM1 or COM2, you'll probably need to
  2413.        customize your port setup.
  2414.  
  2415.        For the Windows version of Searchlight, the Com Port Number refers to
  2416.        a communications port as configured under Windows, and can be any
  2417.        number up to 255. If you install special serial port hardware or
  2418.        modems, you should install the appropriate Windows driver for your
  2419.        device. The Windows version of Searchlight automatically uses
  2420.        Windows device drivers and communications support. The DOS version
  2421.        does not, so if you use nonstandard hardware with a Windows based
  2422.        driver, you must make sure you execute the Windows version of
  2423.        Searchlight (SLBBS32.EXE) rather than the DOS version.
  2424.  
  2425.  
  2426.        --------------
  2427.        2 - Modem Type
  2428.        --------------
  2429.  
  2430.        Searchlight groups modems into two general categories. If your
  2431.        modem's maximum speed is 300, 1200 or 2400 baud, toggle Modem Type
  2432.        to the corresponding setting. If your modem's maximum speed is
  2433.        higher than 2400 baud, set Modem Type to "High Speed". The High
  2434.        Speed setting covers all modems faster than 2400 baud, including all
  2435.        modems that provide error correction or data compression.
  2436.  
  2437.        Note: If you have a high speed modem, pay particular attention to
  2438.              lines 3 and 4 in order to get maximum performance from your
  2439.              modem.
  2440.  
  2441.  
  2442.        --------------------
  2443.        3 - Locked Baud Rate
  2444.        --------------------
  2445.  
  2446.        This field can be used to select a fixed baud rate of up to 115,200
  2447.        baud for use with high speed modems that allow a fixed baud rate.
  2448.        When a locked baud rate is selected, that baud rate is used for all
  2449.        communications with your modem regardless of the actual baud rate
  2450.        used by a remote caller.
  2451.  
  2452.        If you use a high speed modem, set Locked Baud Rate to the lowest
  2453.        speed that's faster than your modem's fastest speed.  For example,
  2454.        if your modem's fastest speed is 14,400 or 16,800 baud, set Locked
  2455.        Baud Rate to 19,200. If your fastest modem speed is 28,800, set
  2456.        Locked Baud Rate to 38,400. If your modem is a 300, 1200 or 2400
  2457.        baud model, set Locked Baud Rate to "None".
  2458.  
  2459.  
  2460.  
  2461.  
  2462.        _____________________________________________________________________
  2463.                                         25
  2464.                                    CONFIGURATION
  2465.        _____________________________________________________________________
  2466.  
  2467.  
  2468.        -------------------------
  2469.        4 - Hardware Flow Control
  2470.        -------------------------
  2471.  
  2472.        Hardware flow control lets Searchlight perform I/O handshaking with
  2473.        your modem. Normally, hardware flow control is required when a
  2474.        locked baud rate is used and can be left "Off" for 300, 1200 or 2400
  2475.        baud modems. Be aware that turning flow control "On" when your modem
  2476.        is turned off, disconnected, improperly configured of improperly
  2477.        connected can cause Searchlight to freeze during operation or behave
  2478.        erratically.
  2479.  
  2480.        Note: Locked Baud Rate and Hardware Flow Control should always be
  2481.              used together, and only with modems that support fixed baud
  2482.              rate (fixed DTE rate) with hardware handshaking (also called
  2483.              CTS handshaking). Be sure that your modem is properly
  2484.              configured for handshaking before you turn these options on.
  2485.              Most high speed modems require a modem command such as &K3 in
  2486.              the modem init string for proper operation.
  2487.  
  2488.  
  2489.        -----------------------
  2490.        5 - Speed Detect Method
  2491.        -----------------------
  2492.  
  2493.        This option determines how Searchlight will set the baud rate for a
  2494.        remote call. When set to Modem Msg, the software will set the baud
  2495.        rate by the Modem Message method; that is, it expects the modem to
  2496.        send a message that says "CONNECT xxxx" (where xxxx is the baud
  2497.        rate) upon answering a call.  Searchlight reads this message and
  2498.        uses it to set the baud rate.
  2499.  
  2500.        If this field is set to Key Hit, Searchlight will determine the baud
  2501.        rate via the Keystroke method. It will cycle through the defined
  2502.        baud rates until the caller presses the Enter key on the remote end.
  2503.        If you use this method, you must press the Enter key several times
  2504.        upon connecting with the BBS in order to establish the proper baud
  2505.        rate.
  2506.  
  2507.        Modem Msg is the default and preferred method. This topic is
  2508.        discussed further in Appendix D.
  2509.  
  2510.  
  2511.        -------------------------
  2512.        6 - Minimum Connect Speed
  2513.        -------------------------
  2514.  
  2515.        This field allows you to set a minimum allowable connect speed for
  2516.        your system. Callers who connect at speeds less than the minimum
  2517.        speed will not be allowed to log in or access your system in any
  2518.        way. Minimum Connect Speed applies only to the current node, and can
  2519.        be set differently for different nodes in a multiuser system.
  2520.  
  2521.        _____________________________________________________________________
  2522.                                         26
  2523.                                    CONFIGURATION
  2524.        _____________________________________________________________________
  2525.  
  2526.        Minimum Connect Speed has no effect on local logins or Telnet
  2527.        sessions.
  2528.  
  2529.  
  2530.        ---------------------------
  2531.        7 - Output Buffering Factor
  2532.        ---------------------------
  2533.  
  2534.        This value controls the size of Searchlight's output buffer during
  2535.        interrupt driven communications. The default value is 32. On slower
  2536.        systems, or when multitasking, setting the output buffering factor
  2537.        to a higher value increases the total speed of the system. Output
  2538.        buffering tends to place a larger interrupt overhead on your system;
  2539.        therefore, if you use multitasking or extensive background
  2540.        processing on your computer, and you experience problems such as
  2541.        lost data over your communications port, set this value to a smaller
  2542.        number or 0.
  2543.  
  2544.        Note: This option is strictly for "fine tuning" the performance of
  2545.              your BBS and it will not affect performance greatly in either
  2546.              direction. Also, this option has no effect if you run the
  2547.              Windows version of Searchlight or if you run the DOS version
  2548.              of Searchlight with a FOSSIL or DigiBoard communications
  2549.              driver.
  2550.  
  2551.  
  2552.        ------------------------
  2553.        8 - Buffer Door Programs
  2554.        ------------------------
  2555.  
  2556.        This option determines whether output buffering (if defined in option
  2557.        7) remains in effect during execution of Door programs. In general,
  2558.        you should buffer door programs. However, be aware that buffering
  2559.        such programs can result in sluggish reaction to the ^C key if the
  2560.        Door program uses it to interrupt output. Also, if you have problems
  2561.        with door programs such as lost characters, try turning Buffer Door
  2562.        Programs off.
  2563.  
  2564.  
  2565.        ---------------------
  2566.        9 - Modem Init String
  2567.        ---------------------
  2568.  
  2569.        This field defines the string of characters that will be sent to your
  2570.        modem whenever Searchlight begins running or resets itself after
  2571.        completing a call. You can use this string to send whatever
  2572.        initialization commands your modem requires before being able to
  2573.        accept a call.
  2574.  
  2575.        Besides regular letters and numbers, there are two special characters
  2576.        that you can insert into the modem init string:
  2577.  
  2578.             ~       Provides a 1/2 second delay between characters sent
  2579.             !       Sends a carriage return (Enter key) to the modem
  2580.        _____________________________________________________________________
  2581.                                         27
  2582.                                    CONFIGURATION
  2583.        _____________________________________________________________________
  2584.  
  2585.        Note that it is important to end the string with a ! character if you
  2586.        want it to terminate with a carriage return keystroke.  The ! can be
  2587.        used several times within the string, allowing you to send several
  2588.        commands to the modem.
  2589.  
  2590.        For many modems, it is essential that at least some command is sent
  2591.        to the modem after each call in order to initialize the modem to the
  2592.        proper transmission speed. Therefore, we recommend that you always
  2593.        have something in this field, even if it's just the empty modem
  2594.        command (AT!).
  2595.  
  2596.        The modem init string setting is provided to enable you to fine tune
  2597.        your modem's performance. In most cases, you can have Searchlight
  2598.        select a default init string by using the Automatic Configuration
  2599.        option outlined below.
  2600.  
  2601.  
  2602.        ----------------------
  2603.        10 - Local Init String
  2604.        ----------------------
  2605.  
  2606.        This string is similar to the Remote Init String, except that it is
  2607.        sent to the modem whenever you initiate a "local" logon to the
  2608.        system (by pressing the Enter key at the keyboard while the system
  2609.        is waiting for a call), or when the system goes off line to execute
  2610.        a scheduled event. In the above example, ATH1 is sent. This command
  2611.        places the phone "on hook", that is, it tells the modem to make the
  2612.        telephone line busy. This is very useful, since any users who
  2613.        attempt to call your BBS while you are logged on locally will
  2614.        receive a busy signal, rather than no answer.
  2615.  
  2616.  
  2617.        ------------------
  2618.        11 - Answer String
  2619.        ------------------
  2620.  
  2621.        You can specify an optional command that Searchlight will send to
  2622.        your modem when it detects that the line is ringing.  The usual
  2623.        modem command used here is "ATA!" (which causes your modem to answer
  2624.        the incoming call).
  2625.  
  2626.        By default, Searchlight configures your modem for auto-answer when
  2627.        you run the automatic modem configuration, and leaves this setting
  2628.        blank. If you prefer to have Searchlight explicitly answer calls
  2629.        only when it is running, add the command "ATA!" here, and modify
  2630.        your Remote Init String so that the auto answer is disabled (change
  2631.        S0=1 to S0=0).  Using an answer string rather than auto-answer mode
  2632.        is preferable if you do not run your BBS full time.
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.        _____________________________________________________________________
  2640.                                         28
  2641.                                    CONFIGURATION
  2642.        _____________________________________________________________________
  2643.  
  2644.  
  2645.        --------------------
  2646.        12 - COM Port Setups
  2647.        --------------------
  2648.  
  2649.        Note: These settings apply only to the DOS version of Searchlight
  2650.              BBS.
  2651.  
  2652.        To select this option, place the cursor on line 12 and press Enter,
  2653.        or click line 12 twice with your mouse. A new options screen appears
  2654.        which allows you to custom configure four communications ports for
  2655.        use with your BBS:
  2656.  
  2657.             1. Port 1 Type ........... Standard
  2658.             2. Base Address .......... 3F8
  2659.             3. Interrupt ............. 3
  2660.             4. External Port Number .. 1
  2661.  
  2662.  
  2663.        Port Type
  2664.        ---------
  2665.  
  2666.        The port type can have one of five values. Standard configures
  2667.        Searchlight to talk directly to a regular IBM compatible serial
  2668.        port, like COM1 or COM2, using built in communications drivers.
  2669.  
  2670.        FOSSIL lets Searchlight use a serial port defined by an external
  2671.        FOSSIL driver program. If your system contains a serial port which
  2672.        cannot be accessed directly by Searchlight, but which has a FOSSIL
  2673.        driver program available, you can access that port through its
  2674.        driver by setting the port type and External Port Number
  2675.        appropriately. It is usually not necessary to use FOSSIL drivers
  2676.        unless you want to use a non-standard device, like a multiport
  2677.        communications card.
  2678.  
  2679.        DigiBoard allows you to use an intelligent DigiBoard communications
  2680.        card. For more information about this setting, see Appendix H,
  2681.        Digiboard Installation and Use.
  2682.  
  2683.        BIOS INT14 configures Searchlight to communicate via standard INT 14
  2684.        function calls. This lets Searchlight work with some older
  2685.        communications drivers which only provide a BIOS interface. It is
  2686.        not recommended that you use this option unless absolutely
  2687.        necessary, since INT 14 is the least flexible type of driver.
  2688.  
  2689.        Equinox configures Searchlight for use with an Equinox brand
  2690.        intelligent serial card. You must install the Equinox drivers before
  2691.        you can use this setting. See your Equinox documentation for more
  2692.        information.
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.        _____________________________________________________________________
  2699.                                         29
  2700.                                    CONFIGURATION
  2701.        _____________________________________________________________________
  2702.  
  2703.  
  2704.        Base Address & Interrupt
  2705.        ------------------------
  2706.  
  2707.        Because there are few hardware standards for COM ports beyond COM2,
  2708.        Searchlight allows you to customize the hardware base address and
  2709.        interrupt for all com ports on your system. If you use ports other
  2710.        than the standard IBM compatible COM1 and COM2, find the base
  2711.        address and interrupts used by your ports in the hardware manuals
  2712.        that came with them, and input those values into these fields.
  2713.  
  2714.        If you run a multinode system on a single PC (using a multitasker
  2715.        such as DESQview), it is important that each node uses a unique
  2716.        interrupt and base address for its serial port. For example, many
  2717.        COM3 ports available actually use Interrupt 3 with a different base
  2718.        address than COM1. Such a serial port cannot be used simultaneously
  2719.        with your COM1 port since they share the same interrupt. When
  2720.        purchasing hardware to expand your system beyond COM1 and COM2,
  2721.        purchase serial ports that can be configured to use interrupt 2, 5
  2722.        or 7. (Note: it is only necessary to supply base address and
  2723.        interrupt data for the COM port actually being used by a particular
  2724.        node).
  2725.  
  2726.        Base Address and Interrupt are used only by the DOS version of
  2727.        Searchlight when the port type is Standard; these settings have no
  2728.        effect on other port types and are not used with the Windows version
  2729.        of Searchlight.
  2730.  
  2731.        Note: Be aware that the standard base address and interrupt for COM1
  2732.              is 3F4 and 4, and COM2 is 2F8 and 3. We suggest you do not
  2733.              alter these unless you have a specific requirement.
  2734.  
  2735.        Note: If you do not know the hardware base address and interrupt of
  2736.              the serial ports on your system, run another application that
  2737.              uses those ports (like a terminal program) and check that
  2738.              software's configuration menus for the proper values.
  2739.  
  2740.  
  2741.        External Port Number
  2742.        --------------------
  2743.  
  2744.        When you use the FOSSIL, Digiboard or Eqinox port type, use this
  2745.        line to specify the actual physical COM port number you want to use.
  2746.        The value entered here is what is actually sent to the FOSSIL,
  2747.        Digiboard or Equinox driver software to indicate which port should
  2748.        be used.
  2749.  
  2750.        The External Port Number has no effect when using Standard port
  2751.        types.
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.        _____________________________________________________________________
  2758.                                         30
  2759.                                    CONFIGURATION
  2760.        _____________________________________________________________________
  2761.  
  2762.  
  2763.         -------------------------------------------------------------------
  2764.        | AUTOMATIC MODEM CONFIGURATION                                     |
  2765.         -------------------------------------------------------------------
  2766.  
  2767.        In most cases, Searchlight can automatically determine the correct
  2768.        settings for your modem by testing your modem's capabilities. If
  2769.        you're not sure of the best settings for your modem, use Automatic
  2770.        Modem Configuration to find out.
  2771.  
  2772.        Before you can run Automatic Modem Configuration, your modem must be
  2773.        connected and turned on, and the COM Port Number and port type must
  2774.        be set correctly. To start the process, press F1 or click the
  2775.        "Automatic Modem Configuration" title bar at the top of the
  2776.        Communications Setup screen. After confirming your choice,
  2777.        Searchlight will begin testing your modem. The process takes 30 to
  2778.        60 seconds. Upon completion, Searchlight will display its
  2779.        recommended settings. For example:
  2780.  
  2781.        The recommended settings for your modem are:
  2782.  
  2783.             Modem Type ............... High Speed
  2784.             Locked Baud Rate ......... 38400
  2785.             Hardware Flow Control .... On
  2786.             Speed Detect Method ...... Modem Msg
  2787.             Modem Init String ........ ATH0M0&C1&D2W2S0=1N1&K3!
  2788.             Local Init String ........ ATH1!
  2789.  
  2790.             Do you want to install these settings?  Yes  No
  2791.  
  2792.        Select "Yes" if you want to accept Searchlight's recommendations. If
  2793.        you do, the Communications Setup screen will automatically be
  2794.        updated with the settings shown. Select "No" if you do not want to
  2795.        install the proposed changes.
  2796.  
  2797.        If you use a high speed modem, Searchlight will prompt you to select
  2798.        a locked baud rate. You should select a rate at least as fast as
  2799.        your modem's fastest speed.
  2800.  
  2801.        If you have any problems with modem configuration which cannot be
  2802.        resolved through the Automatic Modem Configuration option, refer to
  2803.        Appendix D for more detailed information.
  2804.  
  2805.        Note: Searchlight's automatic modem configuration sets your modem up
  2806.              in "auto answer" mode. That is, your modem will automatically
  2807.              answer incoming phone calls, even if Searchlight is not
  2808.              running. If you prefer to have Searchlight answer calls only
  2809.              when it is running, change the S0=1 part of the init string to
  2810.              S0=0, and place the command "ATA!" in the Answer String field.
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.        _____________________________________________________________________
  2817.                                         31
  2818.                                    CONFIGURATION
  2819.        _____________________________________________________________________
  2820.  
  2821.  
  2822.         -------------------------------------------------------------------
  2823.        | SEARCHLIGHT BBS PATHNAMES SETUP MENU                              |
  2824.         -------------------------------------------------------------------
  2825.  
  2826.              1. Primary Program Path ........ C:\BBS
  2827.              2. Alternate Program Path ......
  2828.              3. Data Files Path ............. C:\BBS
  2829.              4. Text Files Path ............. C:\BBS\TEXT
  2830.              5. Include Files Path ..........
  2831.              6. Mail Files Path .............
  2832.              7. Default Log File ............
  2833.              8. Default Passwd for Uploads ..
  2834.              9. DOOR Parameters Filename ....
  2835.             10. Chat File Path .............. C:\BBS
  2836.             11. Primary Menu Path ........... C:\BBS\MENU
  2837.             12. Alternate Menu Path .........
  2838.             13. File Attach Path ............ C:\BBS\ATTACH
  2839.             14. RIP Icons Path .............. C:\BBS\ICONS
  2840.  
  2841.        These options select path and filenames that Searchlight will use
  2842.        when accessing your disks. Flexible pathname selection is provided
  2843.        so that you may make the best use of available disk drives.
  2844.  
  2845.        If you just installed Searchlight, these fields will contain the
  2846.        proper values for your system. We recommend that you do not alter
  2847.        any of these fields until you are familiar with the field's
  2848.        function.
  2849.  
  2850.  
  2851.        ------------------------
  2852.        1 - Primary Program Path
  2853.        ------------------------
  2854.  
  2855.        This option determines where Searchlight will look for its executable
  2856.        files, including files ending in EXE, DLL and OVR, and the
  2857.        DEFAULT.LNG file. If no pathname is given, it defaults to the
  2858.        current directory.
  2859.  
  2860.        Use this field if you wish to have some or all your program files
  2861.        located on a different drive or directory than your data files. You
  2862.        can use this option to place your executable files into a high-speed
  2863.        RAM-disk for faster access.
  2864.  
  2865.  
  2866.        --------------------------
  2867.        2 - Alternate Program Path
  2868.        --------------------------
  2869.  
  2870.        If an executable file can't be found in the Primary location,
  2871.        Searchlight looks to this path for the file. For example, if you use
  2872.        a high-speed RAM disk as your primary program path, but not all of
  2873.        your program files fit on the ramdisk, store the most important ones
  2874.  
  2875.        _____________________________________________________________________
  2876.                                         32
  2877.                                    CONFIGURATION
  2878.        _____________________________________________________________________
  2879.  
  2880.        there and store the rest in another location specified by the
  2881.        Alternate program path.
  2882.  
  2883.        We recommend storing the following files in a high speed disk drive
  2884.        (as specified in your Primary path) if available:  BBS.EXE, BBS.OVR,
  2885.        BBS.INT; DEFAULT.LNG; and LOGIN.EXE. The remaining EXE files are not
  2886.        accessed directly by Searchlight and would not benefit by being
  2887.        placed in high speed storage.
  2888.  
  2889.        Note: The Alternate Program Path is provided primarily for DOS users
  2890.              who wish to maximize performance with limited DOS resources.
  2891.              Under Windows, there is little or no advantage in locating
  2892.              executables on a separate drive.
  2893.  
  2894.  
  2895.        -------------------
  2896.        3 - Data Files Path
  2897.        -------------------
  2898.  
  2899.        This option provides the path that the system with use to access its
  2900.        data files (all files ending in .SL2 and .DEF, except for CONFIG.SL2
  2901.        and EVENT.DEF, which are always located in the current directory).
  2902.        On multiuser systems, you use this option to create multiple nodes
  2903.        which reference the same database (see the following pages for
  2904.        additional multinode setup information).
  2905.  
  2906.  
  2907.        -------------------
  2908.        4 - Text Files Path
  2909.        -------------------
  2910.  
  2911.        The Text Files path is the directory where Searchlight will look for
  2912.        all of its text files. These include the user-defined login and info
  2913.        files, conference and file directory signon messages, help files,
  2914.        and any files referenced in messages via the @@FILENAME directive.
  2915.        Note: Text files ending in "DEF" (i.e. EVENT.DEF) should be located
  2916.        in the current or data file directory, rather than the text
  2917.        directory.
  2918.  
  2919.        Note: For security reasons, we recommend that the Text directory be
  2920.              different from the current directory and the Program File
  2921.              path. This is because the @@FILENAME command can access any
  2922.              file in the text path, and can lead to unwanted access to
  2923.              system or other private files (@@FILENAME is discussed further
  2924.              in the Text Editing section of this manual).
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.        _____________________________________________________________________
  2935.                                         33
  2936.                                    CONFIGURATION
  2937.        _____________________________________________________________________
  2938.  
  2939.  
  2940.        -------------------------
  2941.        5 - Include File Pathname
  2942.        -------------------------
  2943.  
  2944.        This pathname allows you to specify a directory which the callers of
  2945.        you BBS can access for the purpose of "including" text files in
  2946.        messages (via the "%%FILENAME" directive, as discussed in the Text
  2947.        Editing chapter). Normally, if you use this pathname, you'll also
  2948.        have a file transfer directory set to the same path. See File
  2949.        Transfer System for more details.
  2950.  
  2951.  
  2952.        -------------------
  2953.        6 - Mail Files Path
  2954.        -------------------
  2955.  
  2956.        The directory specified by this path is used for mail logging. The
  2957.        mail logging option, which can be turned on or off for each user in
  2958.        the system (via the 2-Sysop/Options command), provides an automatic
  2959.        log of all mail sent and received by users who have mail logging
  2960.        enabled. Searchlight stores each user's mail in a separate file;
  2961.        these files will have filenames created by a concatenation of the
  2962.        user's first and last name (for example, SYSOP.LOG or FLAROSA.LOG).
  2963.        The mail files path is where these files will be written. If no mail
  2964.        file path is given, it defaults to the current path when Searchlight
  2965.        is loaded.
  2966.  
  2967.  
  2968.        --------------------
  2969.        7 - Default Log File
  2970.        --------------------
  2971.  
  2972.        Default Log File is a default name that will be shown whenever a log
  2973.        (ALT-L) or forward to disk operation is selected. A default name is
  2974.        not required, and is only a convenience that allows you to log
  2975.        messages and information to one file without having to enter its
  2976.        name each time.
  2977.  
  2978.  
  2979.        ------------------------------
  2980.        8 - Default Passwd for Uploads
  2981.        ------------------------------
  2982.  
  2983.        This field, if filled in, defines a default password that will be
  2984.        assigned to each new file that is uploaded to your BBS via the File
  2985.        Transfer system. The purpose behind having a default password is to
  2986.        allow you to have control over new files.  Once a file is uploaded
  2987.        and assigned the default password, no one will be able to download
  2988.        the file until you remove the password, thus giving you the
  2989.        opportunity to check each new file before you allow it to be
  2990.        downloaded by your callers.
  2991.  
  2992.  
  2993.        _____________________________________________________________________
  2994.                                         34
  2995.                                    CONFIGURATION
  2996.        _____________________________________________________________________
  2997.  
  2998.        Note: Most sysops leave this field blank, allowing all new files to
  2999.              be downloaded without having to be cleared. If you do set this
  3000.              field, remember that you, or a co-sysop, must reset the
  3001.              passwords on all new files before they can be accessed (see
  3002.              File Transfer System for more information).
  3003.  
  3004.  
  3005.        ----------------------------
  3006.        9 - DOOR Parameters Filename
  3007.        ----------------------------
  3008.  
  3009.        This field can be used to set the filename, including drive and/or
  3010.        path, of the PCBOARD.SYS parameter file created by the Doors system
  3011.        when an external program is run with the PCBOARD dropfile option.
  3012.        The format and use of this file is discussed further in the Doors
  3013.        Subsystem section of this manual.
  3014.  
  3015.        Note: This field should specify a full filename, like
  3016.              "C:\SLBBS\PCBOARD.SYS", not just a path. If you leave this
  3017.              field blank, no parameter file is generated.
  3018.  
  3019.  
  3020.        -------------------
  3021.        10 - Chat File Path
  3022.        -------------------
  3023.  
  3024.        This option determines the drive and path where the file CHAT.SL2,
  3025.        used to hold the messages transmitted via the system's internode
  3026.        chatting facility, will be created. Since the messages in this file
  3027.        are short and of a temporary nature, and since the chat function
  3028.        accesses this file frequently, we recommend that you create a small
  3029.        RAM-disk or other high speed drive in your system for the purpose of
  3030.        containing this file, in order to maximize the speed and efficiency
  3031.        of the chat system. Chat File Path has no effect in single user
  3032.        installations.
  3033.  
  3034.        Note: Unlike Searchlight's other data files, CHAT.SL2 need not be
  3035.              present in the designated path when the system is started, and
  3036.              will be created if not available. Thus, you will not need to
  3037.              back-up or copy CHAT.SL2 to or from temporary disk drives each
  3038.              time your system is reset.
  3039.  
  3040.  
  3041.        ------------------------
  3042.        11 - Primary Menu Path
  3043.        12 - Alternate Menu Path
  3044.        ------------------------
  3045.  
  3046.        These fields specify the path where Searchlight will find its menu
  3047.        files.  Menu files are the external files (ending in .MNU) that
  3048.        describe the menus used by the system. When you install Searchlight,
  3049.        the default menus are loaded onto your system and the path where
  3050.        they are located is placed in the Primary Menu Path field. If you
  3051.  
  3052.        _____________________________________________________________________
  3053.                                         35
  3054.                                    CONFIGURATION
  3055.        _____________________________________________________________________
  3056.  
  3057.        wish to change the location your menu files, type the new location
  3058.        here, after moving the MNU files to the correct path.
  3059.  
  3060.        When both a primary and alternate menu path are provided, Searchlight
  3061.        first checks the primary path when attempting to load a menu file.
  3062.        If the file is not found in that directory, then the alternate path
  3063.        is used. This allows you to create alternate menus for a particular
  3064.        node without providing two different copies of all your menu files.
  3065.  
  3066.        Note: Notice that when you run the CONFIG program and select the
  3067.              Menu Editor option, only those menus in the Primary menu path
  3068.              are displayed. In a multinode system with several menu paths,
  3069.              switch to the home directory of the desired node in order to
  3070.              edit its menus.
  3071.  
  3072.  
  3073.        ---------------------
  3074.        13 - Attach File Path
  3075.        ---------------------
  3076.  
  3077.        This path points to the directory where Searchlight will store binary
  3078.        files that are "attached" to messages. If you wish to use the file
  3079.        attach feature on your BBS, you should create a new directory for
  3080.        attach files and fill in its path here; if you have a multiuser
  3081.        system, specify the same path on all your nodes. It is recommended
  3082.        that you do not use your attach directory for anything other than
  3083.        file attachments.
  3084.  
  3085.  
  3086.        -------------------
  3087.        14 - RIP Icons Path
  3088.        -------------------
  3089.  
  3090.        If you create RIP graphics menus or artwork using a drawing program
  3091.        like RIPaint_and if your RIP files use icons_use this line to
  3092.        specify the path to where your icon files are stored. Searchlight
  3093.        needs to know where your icons are located if you run your BBS in
  3094.        RIP mode (graphics mode) locally. If you don't use RIP icons or if
  3095.        you don't run in RIP mode locally, you can leave this field blank.
  3096.  
  3097.        With RIPscrip 2.x or later, you can create artwork that includes
  3098.        binary objects like WAV files or JPG images. Your RIP Icons Path is
  3099.        the place where you should store these objects if you want
  3100.        Searchlight to be able to automatically download them to your
  3101.        callers.
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.        _____________________________________________________________________
  3112.                                         36
  3113.                                    CONFIGURATION
  3114.        _____________________________________________________________________
  3115.  
  3116.  
  3117.        ----------------------------------
  3118.        Relative Versus Absolute Pathnames
  3119.        ----------------------------------
  3120.  
  3121.        As absolute pathname is a pathname that contains a drive letter and
  3122.        begins at the root directory. A relative pathname is one which
  3123.        begins at the current directory or omits a drive letter. For
  3124.        example, a pathname such as "C:\SLBBS\TEXT" is absolute; whereas
  3125.        "SLBBS\TEXT" is relative.
  3126.  
  3127.        We recommend that you use only absolute pathnames when configuring
  3128.        Searchlight BBS. The reason for this is that some Searchlight BBS
  3129.        programs and utilities can run from outside your "home" directory,
  3130.        and therefore will require absolute pathnames to locate your data
  3131.        files. This is especially true for multiuser systems, and systems
  3132.        which run in a local area network environment.
  3133.  
  3134.        If you do run a LAN, we further recommend that you use the same drive
  3135.        letters on each workstation to refer to the drives on which your
  3136.        Searchlight files are stored. Otherwise, nodes on other workstations
  3137.        may not be able to locate message conferences, file directories and
  3138.        Doors defined in the Node 1 directory.
  3139.  
  3140.  
  3141.         -------------------------------------------------------------------
  3142.        | SEARCHLIGHT BBS PROTOCOL SETUP MENU                               |
  3143.         -------------------------------------------------------------------
  3144.  
  3145.        Searchlight BBS provides a total of 15 "slots" for the designation of
  3146.        file transfer protocols. Protocols can be either internal (supplied
  3147.        by Searchlight BBS) or external. An external protocol is a program
  3148.        which is capable of transferring files to or from a remote system
  3149.        via modem.  Typically, such programs are written to be used from the
  3150.        DOS command line or as part of a BBS like Searchlight, where they
  3151.        can provide new transfer protocols such as Ymodem, Kermit, Bimodem,
  3152.        etc. in addition to Searchlight's built-in protocols.
  3153.  
  3154.        Each protocol consists of a name (which is displayed by the Files
  3155.        system), a type, and for external protocols, a send command and a
  3156.        receive command. To add or change a protocol, select one of the
  3157.        protocol slots from the list of 15 possible slots displayed by the
  3158.        Protocol Setup menu. Searchlight will display a setup screen with
  3159.        these options:
  3160.  
  3161.              1. Protocol Name ............. Zmodem
  3162.              2. Protocol Type ............. Zmodem
  3163.              3. External Send Command .....
  3164.              4. External Receive Command ..
  3165.              5. FOSSIL Emulation .......... Off
  3166.  
  3167.  
  3168.  
  3169.  
  3170.        _____________________________________________________________________
  3171.                                         37
  3172.                                    CONFIGURATION
  3173.        _____________________________________________________________________
  3174.  
  3175.        In line 1, enter the name of the protocol. Line 2, Protocol Type,
  3176.        selects whether a particular protocol is an external protocol (like
  3177.        DSZ) or one of Searchlight's built in protocols. The built in
  3178.        protocols include Xmodem, Xmodem/CRC, Xmodem/1K, and Zmodem. To
  3179.        select which type of protocol you want, toggle this line to the
  3180.        appropriate value.
  3181.  
  3182.        For internal protocols, no further action is necessary. For external
  3183.        protocols, you need to supply the appropriate commands needed to
  3184.        implement that protocol on your system. In general, commands should
  3185.        include the full pathname to the DOS file containing the command to
  3186.        execute, including the COM, EXE, or BAT file extension. Searchlight
  3187.        metacharacters can be used to provide information such as baud rate,
  3188.        COM port, etc. on the command line (see "Doors Subsystem - Passing
  3189.        Parameters to a Door Program", for more information on
  3190.        metacharacters).
  3191.  
  3192.        Where external protocols that require filenames on the command line,
  3193.        two special parameters, "%F" for single filenames and "%W" for
  3194.        wildcards, can be used to specify the filename(s) to send or receive
  3195.        when these programs are invoked.  Protocols which support the use of
  3196.        an indirect file can specify it on the command line as "@Filename".
  3197.  
  3198.        If you use an external protocol that requires a FOSSIL
  3199.        communications driver, set the "Fossil Emulation" option On.  When
  3200.        Searchlight runs the protocol driver, it will set up its own Fossil
  3201.        driver for the program to use, eliminating the need for you to
  3202.        install a third-party driver. For more information about Fossil
  3203.        drivers, please see the section "Doors Subsystem - Searchlight's
  3204.        FOSSIL Emulation Feature."
  3205.  
  3206.        Press ESC when done. To review or change external protocol setups
  3207.        later, just select the protocol you wish to view or edit from the
  3208.        External Protocol setup screen.
  3209.  
  3210.        Please consult External Protocol Setup in the File Transfer System
  3211.        section of this manual (i.e., "Setting Up External Protocols") for
  3212.        further details and examples of external protocol command lines.
  3213.  
  3214.        Note: Notice that lines 3-5 apply only to external protocols, and
  3215.              are ignored unless "external" is selected as the protocol type
  3216.              in line 2.
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.        _____________________________________________________________________
  3230.                                         38
  3231.                                    CONFIGURATION
  3232.        _____________________________________________________________________
  3233.  
  3234.  
  3235.         -------------------------------------------------------------------
  3236.        | SEARCHLIGHT BBS SCREEN COLORS SETUP                               |
  3237.         -------------------------------------------------------------------
  3238.  
  3239.       1. Normal Text Color ........... Blue
  3240.       2. Inverse Text Color .......... White
  3241.       3. Inverse Background Color .... Blue
  3242.       4. Command Color ............... Magenta
  3243.       5. Conference Highlight Color .. Yellow
  3244.       6. Heading Color ............... Lt Cyan
  3245.       7. Input/Chat Mode Color ....... Green
  3246.       8. Special Messages Color ...... Red
  3247.       9. Error Messages Color ........ Lt Blue
  3248.      10. Alternate Color ............. Magenta
  3249.      11. Prompt Color ................ White
  3250.  
  3251.        The colors you enter into the above fields are used when run on a
  3252.        computer with a color display, or when color mode is selected by a
  3253.        remote terminal.  In order to see the colors, the remote terminal
  3254.        must have a color CRT and it must recognize the ANSI escape
  3255.        sequences used to create colored text (the specific ANSI sequences
  3256.        used to create each of the above colors can be found in your DOS
  3257.        manual).
  3258.  
  3259.        Searchlight is capable of supplying color or monochrome text to the
  3260.        remote terminal independently of the local PC. That is, if the local
  3261.        PC (the computer running the Searchlight BBS Software) has a color
  3262.        CRT, but the logged-in user selects Monochrome graphics, color will
  3263.        still be displayed on the local screen, even though only monochrome
  3264.        codes are being sent to the terminal. Similarly, if the system is
  3265.        run on a Monochrome display, only monochrome graphics are sent to
  3266.        the screen even though color graphics are being sent to the
  3267.        terminal. Note that while the colors sent in Color mode can be
  3268.        adjusted, the monochrome mode is fixed and will always appear the
  3269.        same regardless of the colors selected for Color mode.
  3270.  
  3271.        Note: This screen defines only the colors used in plain text mode,
  3272.              such as when Searchlight is communicating with an ANSI
  3273.              terminal. In RIP graphics mode, Searchlight uses additional
  3274.              colors configured in the RIP Styles Setup portion of the
  3275.              config program. For more information, please see the sectin
  3276.              "RIP Graphics."
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.        _____________________________________________________________________
  3289.                                         39
  3290.                                    CONFIGURATION
  3291.        _____________________________________________________________________
  3292.  
  3293.  
  3294.         -------------------------------------------------------------------
  3295.        | SEARCHLIGHT BBS AUTODOORS SETUP                                   |
  3296.         -------------------------------------------------------------------
  3297.  
  3298.        The AutoDoors setup screen lets you specify "automatic doors", or
  3299.        door programs which execute automatically rather than on command as
  3300.        regular doors are used (see Doors Subsystem later in this manual for
  3301.        more information about door programs). Four AutoDoor settings are
  3302.        provided: New User AutoDoor, Login AutoDoor, Logoff AutoDoor and
  3303.        Upload AutoDoor. The Login and Logoff AutoDoors, if specified,
  3304.        execute automatically when a caller logs in or logs off. The New
  3305.        User AutoDoor executes immediately after a new caller registers with
  3306.        your system.
  3307.  
  3308.        Upload AutoDoor is a function that executes after any upload of a
  3309.        file to your BBS. Typically, it's used to scan uploaded files for
  3310.        viruses, repack files into selected formats, and so on. Please see
  3311.        File Transfer System later in this manual for more information.
  3312.  
  3313.              1. Command .................
  3314.              2. Directory Path ..........
  3315.              3. Communications Support .. None
  3316.              4. Abort Method ............ None
  3317.              5. Write Protection ........ No
  3318.              6. Parameter File .......... None
  3319.              7. Pause After Door ........ No
  3320.              8. Pass Username As ........ Real Name
  3321.              9. Pass COM Port As ........ COM1-COM4
  3322.  
  3323.        The parameters for AutoDoors are very similar to the parameters used
  3324.        in regular doors; please see the Doors Subsystem section of this
  3325.        manual for more information. Here is a brief summary:
  3326.  
  3327.  
  3328.        -----------
  3329.        1 - Command
  3330.        -----------
  3331.  
  3332.        This is the command name used to start the AutoDoor, including any
  3333.        command line parameters or Searchlight metacharacters necessary to
  3334.        start the program running. Programs other than batch files or DOS
  3335.        commands should include the .COM or .EXE extension on the program
  3336.        filename.
  3337.  
  3338.  
  3339.        ------------------
  3340.        2 - Directory Path
  3341.        ------------------
  3342.  
  3343.        This parameter specifies the directory which will be made active
  3344.        before the AutoDoor command is executed. If you wish to remain in
  3345.        the current directory, specify "." for this parameter.
  3346.  
  3347.        _____________________________________________________________________
  3348.                                         40
  3349.                                    CONFIGURATION
  3350.        _____________________________________________________________________
  3351.  
  3352.  
  3353.        --------------------------
  3354.        3 - Communications Support
  3355.        --------------------------
  3356.  
  3357.        This field selects the type of communications driver Searchlight
  3358.        will emulate when running the door program. Choose Fossil mode for
  3359.        BBS-ready programs that support the Fossil driver interface
  3360.        standard. For other doors, specify BIOS or DirectVideo if the
  3361.        AutoDoor does not provide its own RS232 serial support, None if it
  3362.        does. Force-Color may be used to force a program which uses color to
  3363.        run in color mode on a monochrome system. See the section "Doors
  3364.        Subsystem - Communications Support" for more information about the
  3365.        Communications Support settings.
  3366.  
  3367.  
  3368.        ----------------
  3369.        4 - Abort Method
  3370.        ----------------
  3371.  
  3372.        This field specifies the action to take if a carrier loss is detected
  3373.        during the execution of the door. Select "Terminate" for a normal
  3374.        program exit, "Reboot" to reboot the computer, or "None" to take no
  3375.        action in case of a carrier loss.
  3376.  
  3377.  
  3378.        --------------------
  3379.        5 - Write Protection
  3380.        --------------------
  3381.  
  3382.        A value of "Yes" forces software write protection of all drives
  3383.        during the execution of the door. You must use "No" for any program
  3384.        that needs to write to disk.
  3385.  
  3386.  
  3387.        ------------------
  3388.        6 - Parameter File
  3389.        ------------------
  3390.  
  3391.        This option lets you create a "drop" file, such as a DOOR.SYS file,
  3392.        for use with this door program.
  3393.  
  3394.  
  3395.        --------------------
  3396.        7 - Pause After Door
  3397.        --------------------
  3398.  
  3399.        If set to Yes, Searchlight will pause with the "Press any key to
  3400.        continue" prompt after running the door.
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.        _____________________________________________________________________
  3407.                                         41
  3408.                                    CONFIGURATION
  3409.        _____________________________________________________________________
  3410.  
  3411.  
  3412.        --------------------
  3413.        8 - Pass Username As
  3414.        --------------------
  3415.  
  3416.        If you allow alias names on your BBS, use this field to determine
  3417.        whether real names or alias names are passed as parameters to this
  3418.        door. This option affects doors that use the %N and %U parameters.
  3419.        For more information on this topic, see the section "Alias Names."
  3420.  
  3421.  
  3422.        --------------------
  3423.        9 - Pass COM Port As
  3424.        --------------------
  3425.  
  3426.        Controls what Searchlight writes as the communications port number in
  3427.        the dropfile (parameter file). Options are COM1- COM4, External
  3428.        Port, Node Number and Local. For more information, see the section
  3429.        "Doors Subsystem - Passing Parameters."
  3430.  
  3431.        Note: You can also set up programs to auto execute during
  3432.              Searchlight's login or logoff sequence, or at other times, by
  3433.              adding the commands directly to Searchlight's menus. See Menu
  3434.              Editor later in this manual for more information.
  3435.  
  3436.  
  3437.         -------------------------------------------------------------------
  3438.        | SEARCHLIGHT BBS FUNCTION ATTRIBUTE SETUP                          |
  3439.         -------------------------------------------------------------------
  3440.  
  3441.             1. Forward Messages .........
  3442.             2. Internode Chatting .......
  3443.             3. Editor Text Quoting ......
  3444.             4. Private File Attach ......
  3445.             5. Public File Attach .......
  3446.             6. Create Alias Name ........
  3447.             7. Change Alias Name ........
  3448.             8. Internet Mail Originate ..
  3449.             9. Internet Mail Reply ......
  3450.  
  3451.        This CONFIG program selection lets you regulate, by security
  3452.        attributes, several important functions.
  3453.  
  3454.  
  3455.        --------------------
  3456.        1 - Forward Messages
  3457.        --------------------
  3458.  
  3459.        This field regulates the ability to forward messages. Forwarding
  3460.        messages means being able to copy a message from one place (such as
  3461.        a conference or a mailbox) to another place, via the Other/Forward
  3462.        command. If you want to restrict this activity, specify security
  3463.        attributes here. Only callers who have all of the attributes listed
  3464.        here will be able to forward messages.
  3465.        _____________________________________________________________________
  3466.                                         42
  3467.                                    CONFIGURATION
  3468.        _____________________________________________________________________
  3469.  
  3470.  
  3471.        ----------------------
  3472.        2 - Internode Chatting
  3473.        ----------------------
  3474.  
  3475.        If you want to regulate the use of internode chatting, place
  3476.        specific attributes here. Only callers who meet these attribute
  3477.        requirements will be considered available and able to use chat
  3478.        functions.
  3479.  
  3480.        Note: This field actually controls the prompts that appear during
  3481.              the login sequence, and access to the "Chat" command from the
  3482.              message disposition line. The main "Chat" command (on the main
  3483.              menu) is regulated separately (you need to use the menu
  3484.              editor, described later in this manual). In most cases you
  3485.              will want to make sure that the attributes listed here match
  3486.              the ones listed in the main menu.
  3487.  
  3488.  
  3489.        -----------------------
  3490.        3 - Editor Text Quoting
  3491.        -----------------------
  3492.  
  3493.        Text Quoting means the ability to copy the contents of a message
  3494.        into the editor screen when making a reply to that message, via the
  3495.        F4 or ^KG command sequence. If you wish to regulate who has the
  3496.        ability to perform such quoting, list the desired attributes here.
  3497.  
  3498.  
  3499.        -----------------------
  3500.        4 - Private File Attach
  3501.        -----------------------
  3502.  
  3503.        This setting determines whether a caller is able to "attach" binary
  3504.        files to private messages (i.e. Mail messages). If the caller has
  3505.        sufficient attributes, and a File Attach directory is defined (see
  3506.        the section "Configuration - Attach File Path"), then file
  3507.        attachment is permitted.
  3508.  
  3509.  
  3510.        ----------------------
  3511.        5 - Public File Attach
  3512.        ----------------------
  3513.  
  3514.        This field is similar to field 4, except it defines the attributes
  3515.        required to attach files to public messages (any message entered
  3516.        into a conference or bulletins).
  3517.  
  3518.        Many operators will prefer to allow callers to attach binary files to
  3519.        private messages but not public messages. To accomplish this, set
  3520.        appropriate attributes here (or type "ALL" to prevent any caller
  3521.        from attaching a file to a public message).
  3522.  
  3523.  
  3524.        _____________________________________________________________________
  3525.                                         43
  3526.                                    CONFIGURATION
  3527.        _____________________________________________________________________
  3528.  
  3529.  
  3530.        ---------------------
  3531.        6 - Create Alias Name
  3532.        7 - Change Alias Name
  3533.        ---------------------
  3534.  
  3535.        These options describe the security attributes needed for a user to
  3536.        assign herself or himself an alias or alternate user name. Here's
  3537.        how they work: if a user meets the attribute requirements listed for
  3538.        "Create Alias Name", and does not already have an alias name, they
  3539.        can create an alias for themselves by entering one on the
  3540.        Options/Info screen.
  3541.  
  3542.        The "Change Alias" setting determines whether a user with an existing
  3543.        alias can change that alias later on, again using the Options/Info
  3544.        screen. If you would like your users to be able to change their
  3545.        alias name at any time, enter an appropriate list of security
  3546.        attributes here.
  3547.  
  3548.        If you wish users without alias names to be able to enter an alias,
  3549.        but don't want them to be able to change it in the future, the best
  3550.        way to do this is to set "Add Alias Name" to blank, and "Change
  3551.        Alias Name" to ALL or a similar high access level. This allows your
  3552.        current users to add alias names without giving them the opportunity
  3553.        to change their name in the future. Searchlight warns the user that
  3554.        this is the case, and provides an "Are You Sure?" prompt before
  3555.        accepting their alias name.
  3556.  
  3557.  
  3558.        ---------------------------
  3559.        8 - Internet Mail Originate
  3560.        9 - Internet Mail Reply
  3561.        ---------------------------
  3562.  
  3563.        These options control whether your callers can enter messages with
  3564.        internet addresses. Line 8 defines attributes required to originate
  3565.        a new message to an arbitrary internet address_callers who meet
  3566.        these requirements are able to type a new message to any internet
  3567.        address. Line 9 defines attributes required to reply to an internet
  3568.        message. Callers who don't meet the requirements of line 8, but do
  3569.        meet those in line 9, will not be able to send new internet mail but
  3570.        will be able to reply to mail addressed to them.
  3571.  
  3572.        Note: To use internet mail with Searchlight, you need our Uumail
  3573.              connectivity package. Contact TeleGrafix for more information.
  3574.  
  3575.        Note: Searchlight BBS provides much more extensive customization of
  3576.              main menu and submenu functions using the Menu Editor, which
  3577.              is described in more detail in the section "Menu Editor -
  3578.              Searchlight Menu Editor."
  3579.  
  3580.  
  3581.  
  3582.  
  3583.        _____________________________________________________________________
  3584.                                         44
  3585.                                    CONFIGURATION
  3586.        _____________________________________________________________________
  3587.  
  3588.  
  3589.         -------------------------------------------------------------------
  3590.        | DEFAULT ACCESS LEVEL SETUP                                        |
  3591.         -------------------------------------------------------------------
  3592.  
  3593.        This configuration option lets you define up to 12 default access
  3594.        levels.  Although each user in a Searchlight BBS system can be
  3595.        individually assigned access levels, time limits, attributes and so
  3596.        forth, often you will want to group sets of these items together
  3597.        into default groups. For example, you may have default groups for
  3598.        New Users, Validated Users, Adult Users, Members, and so forth.
  3599.        Default Access Levels gives you a way to predefine the parameters
  3600.        for these groups and quickly assign them to individual users.
  3601.  
  3602.        The first two items on the Default Access Levels menu are predefined
  3603.        as "New User" and "Validated User". Although you can change the name
  3604.        and definitions of these access levels, Searchlight will always
  3605.        assign access level "A" to new users, and will always assign "B" to
  3606.        users when you press the ALT-V key.
  3607.  
  3608.        To define a new access group, go to the first unassigned selection
  3609.        and press Enter. The following menu items appear:
  3610.  
  3611.             1. Name ........................ New User
  3612.             2. Message/Doors Access Level .. 2
  3613.             3. Files Access Level .......... 2
  3614.             4. Security Attributes ......... ABC
  3615.             5. Download:Upload Ratio ....... 3
  3616.             6. Daily Time Limit ............ 40
  3617.             7. Session Time Limit .......... 40
  3618.             8. Days Until Expiration ....... 365
  3619.  
  3620.        --------
  3621.        1 - Name
  3622.        --------
  3623.  
  3624.        This field defines a descriptive name for the access level. This is
  3625.        the name that appears when you use the 2-Sysop/Validate or
  3626.        Other/Validate commands from Searchlight BBS.
  3627.  
  3628.  
  3629.        ------------------------------
  3630.        2 - Message/Doors Access Level
  3631.        ------------------------------
  3632.  
  3633.        This field is the numerical access level (from 0 to 255) that is used
  3634.        for access to message areas and Doors.
  3635.  
  3636.        In Searchlight BBS, access levels and security attributes work
  3637.        together to define which users have access to particular features.
  3638.        In order for a user to access a conference, for example, that user
  3639.        must have at least the access level required to access that
  3640.        conference, and all the security attributes required for it. (You
  3641.  
  3642.        _____________________________________________________________________
  3643.                                         45
  3644.                                    CONFIGURATION
  3645.        _____________________________________________________________________
  3646.  
  3647.        determine what those requirements are when you create the
  3648.        conference). The only access levels which have absolute meaning in
  3649.        Searchlight are levels 254 and 255, which define cosysops and Sysops
  3650.        respectively (Sysops and cosysops have general access to all features
  3651.        on the system).
  3652.  
  3653.  
  3654.        ----------------------
  3655.        3 - Files Access Level
  3656.        ----------------------
  3657.  
  3658.        This field defines the user's access level in the Files section of
  3659.        the BBS.
  3660.  
  3661.  
  3662.        -----------------------
  3663.        4 - Security Attributes
  3664.        -----------------------
  3665.  
  3666.        Security attributes are letters from A to X which work in conjunction
  3667.        with access levels to provide a more flexible level of regulation.
  3668.        Security attributes are non-hierarchical in nature: whereas an
  3669.        access level of 100, for example, grants a user all the privileges
  3670.        of access levels 0 through 99, security attribute `X' does not
  3671.        automatically grant a user access to attributes `A' through `W'.
  3672.  
  3673.        Security attributes can be thought of as individual "keys" that a
  3674.        user most possess in order to open (access) a particular item on
  3675.        your BBS (that item can be a conference, file directory, Door, or a
  3676.        command, like POST). Suppose a particular item has "locks"
  3677.        (attributes) A,B and C associated with it:  then in order to
  3678.        "unlock" that item, a user must have keys A,B and C. A user who has,
  3679.        for example, keys B and C, but not key A, can't use the item, even
  3680.        if the user has many other keys.
  3681.  
  3682.        Security attributes give you the ability to mutually exclude groups
  3683.        of users from areas of your BBS. For example, if one group of users
  3684.        has attribute "A" only and another, attribute "B" only, no users
  3685.        from the first group will have access to conferences that have the
  3686.        "B" attribute, and none from the second group will have access to
  3687.        conferences with the "A" attribute. Of course, if you might wish to
  3688.        assign some user attributes A and B, in which case that user would
  3689.        have access to both areas.
  3690.  
  3691.        Note: Keep in mind that you can define security levels using any
  3692.              number and combination of the 24 attribute levels.  You're not
  3693.              limited to 24 security levels: the actual number of
  3694.              combinations available is in excess of 16 million.
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.        _____________________________________________________________________
  3702.                                         46
  3703.                                    CONFIGURATION
  3704.        _____________________________________________________________________
  3705.  
  3706.  
  3707.        -------------------------
  3708.        5 - Download:Upload Ratio
  3709.        -------------------------
  3710.  
  3711.        This field defines a user's maximum downloading privilege as a ratio
  3712.        to the amount of data uploaded. For example, a value of 2 in this
  3713.        field would mean that the user could download twice the amount of
  3714.        files uploaded. Ratios are computed from the total amount of KBytes
  3715.        uploaded and downloaded, without regard to the actual number of
  3716.        files transferred.
  3717.  
  3718.        For greater control over uploading and downloading, you can also
  3719.        define a downloading "grace period" for new users, and value
  3720.        multipliers to individual directories. See File Transfer System for
  3721.        more information.
  3722.  
  3723.  
  3724.        --------------------
  3725.        6 - Daily Time Limit
  3726.        --------------------
  3727.  
  3728.        This field defines the user's maximum daily time limit in minutes.
  3729.        Values can range from 0 to 1440 (the total number of minutes in one
  3730.        day).
  3731.  
  3732.  
  3733.        ----------------------
  3734.        7 - Session Time Limit
  3735.        ----------------------
  3736.  
  3737.        This field defines the maximum amount of time a user may spend in any
  3738.        one particular session (log-in). Values can range from 0 to 1440
  3739.        minutes. Note that the value in this field means something only if
  3740.        Session Time Limits are enabled (see General Setup Menu #2).
  3741.  
  3742.  
  3743.        -------------------------
  3744.        8 - Days Until Expiration
  3745.        -------------------------
  3746.  
  3747.        This field defines the number of days until the account "expires".
  3748.        Actually, this number is used to compute an expiration date for the
  3749.        user account. The expiration date is set by adding this number of
  3750.        days to the current date when validating the user, or to the current
  3751.        expiration date if one exists for that user.
  3752.  
  3753.        Note: Expiration dates are used only if they are enabled (see
  3754.              General Setup Menu #2).
  3755.  
  3756.  
  3757.  
  3758.  
  3759.  
  3760.        _____________________________________________________________________
  3761.                                         47
  3762.                                    CONFIGURATION
  3763.        _____________________________________________________________________
  3764.  
  3765.  
  3766.         -------------------------------------------------------------------
  3767.        | OVERLAY SETUP                                                     |
  3768.         -------------------------------------------------------------------
  3769.  
  3770.        Searchlight's main executable file, BBS.EXE, uses an overlay file.
  3771.        The overlay contains additional program code which is loaded from
  3772.        disk to memory as a program runs.
  3773.  
  3774.        Overlays are primarily used to reduce the amount of memory that
  3775.        Searchlight requires to run, in exchange for some loss of execution
  3776.        speed as modules are loaded from disk. However, if your computer
  3777.        contains ample memory, you can increase Searchlight's execution
  3778.        speed by allocating a larger overlay buffer area, or loading the
  3779.        entire overlay file into expanded memory. A text file called BBS.INT
  3780.        is used to adjust these options.
  3781.  
  3782.        If you have conventional memory available, you can improve
  3783.        Searchlight's execution speed by increasing the overlay buffer area
  3784.        within the program.  Edit the file BBS.INT with a text editor and
  3785.        locate the line containing a decimal number:  this is the overlay
  3786.        buffer size in bytes. The minimum buffer size is 25,000 bytes. Since
  3787.        Searchlight requires approximately 350K of conventional memory to
  3788.        run, any available memory you have beyond 350K can be used to expand
  3789.        the overlay buffer. The maximum buffer size you should use is the
  3790.        size of the overlay (OVR) file.
  3791.  
  3792.        If you have expanded (EMS) memory available, Searchlight will load
  3793.        the entire overlay file into EMS, which is much faster than loading
  3794.        overlays from disk.  You enable this option simply by typing the
  3795.        command "EMS" in the BBS.INT or FILES.INT file. If insufficient
  3796.        expanded memory is available at runtime, Searchlight will not load
  3797.        its overlay into EMS but will continue to operate by reading it from
  3798.        disk.
  3799.  
  3800.        You can examine the actual size of your overlay buffer, EMS usage
  3801.        and available free memory anytime SLBBS is loaded by pressing the F8
  3802.        key several times until a memory status line appears at the bottom
  3803.        of your screen. Use the memory information to determine the
  3804.        available resources on your system and make appropriate adjustments
  3805.        to your INT files.
  3806.  
  3807.        Note: Overlay files and EMS memory settings apply only to the DOS
  3808.              version of Searchlight BBS. The Windows version does not use
  3809.              EMS or overlays.
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.        _____________________________________________________________________
  3820.                                         48
  3821.                                    CONFIGURATION
  3822.        _____________________________________________________________________
  3823.  
  3824.  
  3825.         -------------------------------------------------------------------
  3826.        | TEXT FILES SETUP                                                  |
  3827.         -------------------------------------------------------------------
  3828.  
  3829.        Searchlight provides you with a way to customize your BBS by defining
  3830.        your own messages that will be displayed by various parts of the
  3831.        program. You can define a "greeting" message that will be shown to
  3832.        all users when they connect with your system, a message to be shown
  3833.        to new users, a general information message, etc. In addition, you
  3834.        can set up separate messages for RIP, ANSI and non-ANSI terminals,
  3835.        or use the same message for all.
  3836.  
  3837.        The messages you define will be saved in files. To write them, you
  3838.        must use a word processor or text editor that can write standard
  3839.        ASCII files to disk.  You can use the Searchlight's built-in text
  3840.        editor for this purpose, provided that it is adequate for the files
  3841.        you intend to produce.
  3842.  
  3843.        Files that end in .TXT are standard text files. These should contain
  3844.        only ASCII text. The standard text file will be used when ANSI
  3845.        graphics capability is not selected. Files ending in .ANS are ANSI
  3846.        files. These can contain ANSI escape sequences, as well as IBM
  3847.        character graphics (i.e.  eight-bit character codes). The ANSI
  3848.        version of the file is used when ANSI graphics are enabled. Files
  3849.        ending in .RIP or .RP2 are RIPscrip files; RIPscrip is a special
  3850.        terminal protocol that encompasses ANSI but includes graphics
  3851.        primitives, fonts, icons and other features. RIP files are displayed
  3852.        only if Searchlight detects RIP compatibility on the remote
  3853.        terminal. For more information about RIP files and RIP graphics, see
  3854.        the section "RIP Graphics - Using RIP Graphics."
  3855.  
  3856.        You do not need to create multiple versions of a file if you don't
  3857.        wish to send separate text to RIP, ANSI and non-ANSI users; simply
  3858.        create one file with the TXT extension, and it will be used in all
  3859.        cases.
  3860.  
  3861.        All text files should be located in the text directory, as defined in
  3862.        your configuration file. The following files are defined:
  3863.  
  3864.  
  3865.        LOGIN (.TXT/.ANS/.RIP/.RP2)
  3866.        ---------------------------
  3867.  
  3868.        This file is displayed immediately after the "Select Graphics" prompt
  3869.        during the login sequence. It normally contains a welcome message
  3870.        with the name of your BBS, etc.
  3871.  
  3872.  
  3873.  
  3874.  
  3875.  
  3876.  
  3877.  
  3878.        _____________________________________________________________________
  3879.                                         49
  3880.                                    CONFIGURATION
  3881.        _____________________________________________________________________
  3882.  
  3883.  
  3884.        NEWUSER (.TXT/.ANS/.RIP/.RP2)
  3885.        -----------------------------
  3886.  
  3887.        This file contains information for new users. It is displayed when
  3888.        someone logs in as NEW and attempts to register their name. You can
  3889.        use this file to communicate any requirements or rules to new users
  3890.        of your system. Each user sees this file only once, when first
  3891.        registering with the BBS.
  3892.  
  3893.  
  3894.        GREETING (.TXT/.ANS/.RIP/.RP2)
  3895.        ------------------------------
  3896.  
  3897.        This file replaces the default login greeting message, if "Default
  3898.        Login Greeting" is disabled (see General Setup Menu #2).
  3899.  
  3900.  
  3901.        INFO (.TXT/.ANS/.RIP/.RP2)
  3902.        --------------------------
  3903.  
  3904.        The "info" file can be used to enter a short description of your
  3905.        system. It is displayed whenever the INFO command is used.
  3906.  
  3907.  
  3908.        FILES (.TXT/.ANS/.RIP/.RP2)
  3909.        ---------------------------
  3910.  
  3911.        This text file is displayed whenever you enter the FILES system. Use
  3912.        it to provide news and information about your file transfer
  3913.        directories.
  3914.  
  3915.  
  3916.        LOGOFF (.TXT/.ANS/.RIP/.RP2)
  3917.        ----------------------------
  3918.  
  3919.        Similar to LOGIN, these files contain a short message to be displayed
  3920.        on the screen when a user logs off (disconnects).  Default
  3921.        Conference Entry Messages For each message conference, you can
  3922.        define a text message that will be displayed upon entry to the
  3923.        conference. To define a message for a conference, create a file
  3924.        using the name of the conference and the extension .TXT, .ANS, .RIP
  3925.        and/or .RP2. For example, the files
  3926.  
  3927.             GENERAL.TXT
  3928.             GENERAL.ANS
  3929.             GENERAL.RIP
  3930.             GENERAL.RP2
  3931.  
  3932.        would contain text messages to be displayed upon each access to
  3933.        conference `GENERAL' (the .TXT file is displayed if ANSI graphics
  3934.        are not selected, the .ANS file is displayed if they are, and the
  3935.        .RIP pr .RP2 file only if RIP 1.x or 2.x graphics are available).
  3936.  
  3937.        _____________________________________________________________________
  3938.                                         50
  3939.                                    CONFIGURATION
  3940.        _____________________________________________________________________
  3941.  
  3942.        You don't have to define text messages for any conference. If no
  3943.        message file exists, no message is printed upon entry to that
  3944.        conference.
  3945.  
  3946.  
  3947.        -------------------------------
  3948.        Default File Directory Messages
  3949.        -------------------------------
  3950.  
  3951.        You can define a default text message to be displayed upon each entry
  3952.        to a file directory in the FILES section of the BBS.  To do so,
  3953.        create a text file with the directory's name followed with a .TXT,
  3954.        .ANS, .RIP and/or .RP2 extension. For example, if you have a
  3955.        directory called UPLOADS, the file
  3956.  
  3957.             UPLOADS.TXT
  3958.  
  3959.        would be used to contain the message to be displayed each time the
  3960.        UPLOADS directory is accessed.
  3961.  
  3962.        Note: Note that the file directory text messages should be in the
  3963.              text directory, as with the other text messages; not in the
  3964.              directory containing the uploaded files for that directory.
  3965.  
  3966.  
  3967.         -------------------------------------------------------------------
  3968.        | COLOR CODES AND MACROS                                            |
  3969.         -------------------------------------------------------------------
  3970.  
  3971.        Searchlight supports a set of mnemonic, two-character color codes and
  3972.        macros that can be embedded into any message or text file used with
  3973.        the system. For more information, see the section on Embedded Macro
  3974.        Codes later in this manual.
  3975.  
  3976.  
  3977.         -------------------------------------------------------------------
  3978.        | EVENTS                                                            |
  3979.         -------------------------------------------------------------------
  3980.  
  3981.        In addition to "Door" programs, which can be set up to run on-demand
  3982.        from the BBS system's menus (see Doors Subsystem later in this
  3983.        manual), Searchlight supports automatic or timed events. An event is
  3984.        a program, DOS command, or batch file that executes automatically at
  3985.        a certain time and date, usually late at night when the system is
  3986.        unattended.  You can create automatic events that happen once or
  3987.        events that execute on a daily, weekly, or monthly basis. For a full
  3988.        explanation of events, refer to Appendix C, Automatic Events.
  3989.  
  3990.  
  3991.  
  3992.  
  3993.  
  3994.  
  3995.  
  3996.        _____________________________________________________________________
  3997.                                         51
  3998.                                    CONFIGURATION
  3999.        _____________________________________________________________________
  4000.  
  4001.  
  4002.         -------------------------------------------------------------------
  4003.        | MENU EDITING                                                      |
  4004.         -------------------------------------------------------------------
  4005.  
  4006.        Searchlight has a full featured menu editing system that allows you
  4007.        to modify or replace the menus that are included with the package.
  4008.        You can't modify the Config menus described in the previous section,
  4009.        but you can examine and change most of the menus that appear in
  4010.        Searchlight BBS itself, and you can create new menus.
  4011.  
  4012.        For more information, see the section "Menu Editor - Searchlight
  4013.        Menu Editor."
  4014.  
  4015.  
  4016.         -------------------------------------------------------------------
  4017.        | RIP GRAPHICS FEATURES                                             |
  4018.         -------------------------------------------------------------------
  4019.  
  4020.        Searchlight BBS contains a host of RIP graphics features, including a
  4021.        RIP graphics menu designer and a styles editor that lets you choose
  4022.        colors and other styles for the displays that are generated in RIP
  4023.        mode. For more information, please see the sectin "RIP Graphics -
  4024.        Using RIP Graphics" of this manual.
  4025.  
  4026.  
  4027.         -------------------------------------------------------------------
  4028.        | MULTINODE SETUP                                                   |
  4029.         -------------------------------------------------------------------
  4030.  
  4031.        With multiuser versions of Searchlight BBS, you have the capability
  4032.        of setting up two or more "nodes". Each node runs as a separate task
  4033.        or on a separate PC (using a local area network), but accesses a
  4034.        common set of data files, thus enabling you to have two or more
  4035.        people logged in to your bulletin board at the same time.
  4036.  
  4037.        To run multiple nodes, you need a multinode version of Searchlight
  4038.        BBS and an either a local area network or an operating system that
  4039.        supports multiple processes. The simplest solution is to run the
  4040.        Windows version of Searchlight BBS under Windows 95 or Windows NT,
  4041.        which provide built-in multiprocessing. If you want to run a
  4042.        multinode BBS using the DOS version of Searchlight, you need a
  4043.        separate multiprocessing operating system, such as DESQview/386.
  4044.  
  4045.        After installing your system for a single node (Node 1), follow these
  4046.        steps to bring additional nodes online:
  4047.  
  4048.             1) Each additional node you set up requires its own directory
  4049.                and its own copy of the CONFIG.SL2 file. You do not need to
  4050.                copy any other files. To create node #2, make a second BBS
  4051.                directory and copy your existing CONFIG.SL2 file into it;
  4052.                for example, at the DOS prompt enter:
  4053.  
  4054.  
  4055.        _____________________________________________________________________
  4056.                                         52
  4057.                                    CONFIGURATION
  4058.        _____________________________________________________________________
  4059.  
  4060.                       MKDIR C:\BBS2
  4061.                       COPY C:\BBS\CONFIG.SL2 C:\BBS2
  4062.  
  4063.                Before copying the file, you should check to make sure that
  4064.                complete pathnames are specified in the Pathnames Setup
  4065.                portion of the CONFIG program. Repeat the process for each
  4066.                additional node, using C:\BBS3, C:\BBS4, etc.
  4067.  
  4068.             2) Each node must be assigned a unique, sequential node number.
  4069.                To do the setup, you run the CONFIG program for each node,
  4070.                including the original node. Since CONFIG looks for the file
  4071.                CONFIG.SL2 in the current directory when it runs, you must
  4072.                switch to each node's directory, run CONFIG, set the
  4073.                required options, then exit CONFIG and go on to the next
  4074.                node. To configure node 2's options, you might type this:
  4075.  
  4076.                       CHDIR C:\BBS2
  4077.                       C:\BBS\CONFIG
  4078.  
  4079.                Notice that we typed "C:\BBS\CONFIG" as the command to run
  4080.                the CONFIG program; this is because CONFIG.EXE no longer
  4081.                resides in the current directory. However, you can avoid
  4082.                having to type an explicit pathname if you use the PATH
  4083.                command to set the search path to the directory containing
  4084.                the Searchlight program files (see your DOS or Windows
  4085.                manual for further assistance).
  4086.  
  4087.             3) Select the first CONFIG item, General Setup Menu #1. The
  4088.                screen will show these menu options:
  4089.  
  4090.                       7. Node Number ............. 1
  4091.                       8. Number of Active Nodes .. 2
  4092.  
  4093.                Each node should be assigned a different node number. Use 1
  4094.                for your original node, 2 for the second node, etc. In
  4095.                addition, each node must know the total number of nodes in
  4096.                your system. If you will be running a two-node system, for
  4097.                example, each node must have item #8 set to 2. If you add
  4098.                or remove nodes, each node's CONFIG file must be updated.
  4099.  
  4100.             4) Each node on the same machine must access a separate serial
  4101.                port. Be sure to configure the "Communications Setup"
  4102.                parameters correctly. If you will be running one or more
  4103.                nodes in local or Telnet mode only, set the COM Port to a
  4104.                value of 0. Each node can have its own separate baud rates,
  4105.                modem init strings, COM port setups, etc.
  4106.  
  4107.             5) Each node, with the exception of the original node, must be
  4108.                programmed with the appropriate program pathname and data
  4109.                pathname in order for it to locate and use the original
  4110.                node's files. To do this, execute the CONFIG program and
  4111.                select item #D, Pathnames Setup. As an example, if your
  4112.                original node is in C:\SLBBS, you would set up your
  4113.                additional nodes as follows:
  4114.        _____________________________________________________________________
  4115.                                         53
  4116.                                    CONFIGURATION
  4117.        _____________________________________________________________________
  4118.  
  4119.  
  4120.                       1. Primary Program Path .. C:\SLBBS\
  4121.                       3. Data Files Path ....... C:\SLBBS\
  4122.  
  4123.                In addition, you will want to update text, mail, include,
  4124.                and log file pathnames if necessary. Also, be sure that the
  4125.                "Chat File Path" option is set to the same value for each
  4126.                node; this will enable users to communicate using the chat
  4127.                facility (see additional information about the Chat File
  4128.                Path in the preceding configuration instructions).
  4129.  
  4130.             6) To begin running a node, change to the node's directory and
  4131.                execute the SLBBS or SLBBS32 program. (Under Windows, you
  4132.                can create an icon that runs the program SLBBS32 and specify
  4133.                the node's home directory as the "Start in" directory). Each
  4134.                node must be started up separately.
  4135.  
  4136.  
  4137.         -------------------------------------------------------------------
  4138.        | MULTINODE OPERATION                                               |
  4139.         -------------------------------------------------------------------
  4140.  
  4141.        Here are some notes and tips on running in the multinode
  4142.        environment:
  4143.  
  4144.        Note: When logged in to a particular node, you can use the Who
  4145.              command from the main menu to see the names of users logged on
  4146.              to other nodes. A user cannot be logged on to more than one
  4147.              node at a time. The login program will reject you if you try
  4148.              to log in and your name is already active on another node.
  4149.  
  4150.        Note: Certain sysop commands (such as Conference Repair facilities)
  4151.              should not be used while other users are on the system. You
  4152.              must shut down all nodes and leave them down while running
  4153.              these commands.
  4154.  
  4155.        Note: Use complete pathnames to designate directories in Searchlight
  4156.              BBS. By "complete" pathnames, we mean a pathname that contains
  4157.              a drive letter and starts at the root directory, such as
  4158.              "C:\BBS\NODE1", rather than a pathname which omits the drive
  4159.              letter or which doesn't contain a leading backslash. Complete
  4160.              pathnames are important because the paths pointed to should be
  4161.              accessible from anywhere in your system.
  4162.  
  4163.        Note: LAN Setup: If you are running Searchlight with a local area
  4164.              network, you must make sure that two users do not attempt to
  4165.              access the same node at the same time. This will usually mean
  4166.              constructing a node for each PC on the network. Alternately, a
  4167.              batch file or other front end program can be written to
  4168.              automatically select the proper home directory when starting
  4169.              SLBBS.
  4170.  
  4171.  
  4172.  
  4173.        _____________________________________________________________________
  4174.                                         54
  4175.                                    CONFIGURATION
  4176.        _____________________________________________________________________
  4177.  
  4178.        On a LAN, we strongly recommend that each workstation use the same
  4179.        drive letters to refer to drives that contain Searchlight BBS files.
  4180.        This is necessary in cases where all nodes refer to a common setup
  4181.        file (like the SUBBOARD.SL2 and FILEDIR.SL2 files) in order to
  4182.        prevent ambiguity which might arise if workstations used different
  4183.        drive letters to refer to the same volume. If it is impractical for
  4184.        you to assign the drive letters directly in your LAN operating
  4185.        software, use DOS's SUBST facility to create substitute drive
  4186.        letters, or use machine names rather than drive letters in your
  4187.        pathnames.
  4188.  
  4189.        To run Searchlight in a local-only mode, you can set the "Return to
  4190.        DOS on Logoff" feature (found in the CONFIG program) and start the
  4191.        system with the command "SLBBS Local". You may want to disable the
  4192.        system hotkeys if allowing non-sysops to run the program in local
  4193.        mode.
  4194.  
  4195.        Note: If you run multiple DOS nodes on a single PC (using a DOS
  4196.              multitasking operating system such as DESQview), each node
  4197.              must use a unique hardware interrupt value for its serial
  4198.              port. Normally this will not be an issue if just 2 nodes are
  4199.              run, but will need to be considered when you expand to a
  4200.              third node and beyond. Be sure to purchase communications
  4201.              hardware which is capable of addressing unique hardware
  4202.              interrupts. On most PCs, interrupts 2,3,4,5 and 7 are
  4203.              available for use with modems.
  4204.  
  4205.        Searchlight has special support for the DigiBoard brand of multiport
  4206.        hardware. If you are using a DigiBoard product, consult Appendix H,
  4207.        Digiboard Installation And Use.
  4208.  
  4209.        Selection of a unique interrupt is not necessary for nodes that do
  4210.        not use a modem (i.e. local use nodes with the COM port designated
  4211.        as 0). Of course, if you use a LAN, each PC on the network can use
  4212.        whatever local COM port is available without regard to interrupts
  4213.        used on other PC's in the LAN.
  4214.  
  4215.        Note: Chatting: Inter-Node Chatting (the ability to exchange short
  4216.              messages with users at other nodes) is available in multiuser
  4217.              systems. See "Using Chat Mode" later in this manual for
  4218.              details.
  4219.  
  4220.  
  4221.  
  4222.  
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.  
  4229.  
  4230.  
  4231.  
  4232.        _____________________________________________________________________
  4233.                                         55
  4234.                               SEARCHLIGHT AND TELNET
  4235.        _____________________________________________________________________
  4236.  
  4237.  
  4238.         -------------------------------------------------------------------
  4239.        | SEARCHLIGHT AND TELNET                                            |
  4240.         -------------------------------------------------------------------
  4241.  
  4242.        The Windows version of Searchlight BBS lets you perform Telnet
  4243.        hosting on a Windows 95 or Windows NT platform.  The telnet feature
  4244.        allows telnet clients on the internet (or on any TCP/IP network) to
  4245.        connect to your Searchlight BBS system using the telnet protocol,
  4246.        rather than via modems. (Note that Searchlight is a telnet host,
  4247.        rather than a client. It gives you the capability to create a telnet
  4248.        service on the internet, not the ability for your callers to access
  4249.        outbound telnet services through your BBS).
  4250.  
  4251.  
  4252.        -----------------
  4253.        Setting Up Telnet
  4254.        -----------------
  4255.  
  4256.        To enable the telnet feature, you need to be running Searchlight BBS
  4257.        on a computer with TCP/IP networking installed. It is recommended
  4258.        that you enable telnet only if your computer has a permanent,
  4259.        reliable connection to the internet and a static IP address. It is
  4260.        possible to use telnet if your internet connection is via a modem
  4261.        with a dynamic address, but it is generally impractical to do so
  4262.        since users need to know your IP address or computer name in order
  4263.        to connect with your system.
  4264.  
  4265.        To enable telnet connections, run the WSLBBS configuration program
  4266.        and edit the properties for your first node. If you run a multiuser
  4267.        BBS, telnet can be enabled or disabled individually for each node,
  4268.        so make sure you make the telnet settings for all node(s) which you
  4269.        desire to be accessible via telnet.
  4270.  
  4271.        On the Communications tab, find the option labeled "Accept Telnet
  4272.        connections?" and toggle it to Yes. In the following field, "Telnet
  4273.        IP address", enter the IP address on which you wish to receive
  4274.        telnet connections.
  4275.  
  4276.        If your computer runs Windows 95, you have only one IP address, which
  4277.        you can find by examining your TCP/IP protocol properties
  4278.        (right-click on the Network Neighborhood icon, then select
  4279.        Properties, then double-click on TCP/IP in the list). An IP address
  4280.        is four numbers separated by periods; for example, "207.54.137.11".
  4281.  
  4282.        If you run Windows NT, your computer may have more than one IP
  4283.        address. In this case, enter the IP address on which you desire to
  4284.        receive telnet connections for that node.
  4285.  
  4286.        There is no limit to the number of Searchlight nodes that may be
  4287.        configured to accept telnet connections from the same IP address, so
  4288.        if you run a multiuser BBS, you can configure two or more nodes on
  4289.        one computer with the same IP address. (If you run Windows NT, it is
  4290.  
  4291.        _____________________________________________________________________
  4292.                                         56
  4293.                               SEARCHLIGHT AND TELNET
  4294.        _____________________________________________________________________
  4295.  
  4296.        possible to have multiple nodes answering on different addresses,
  4297.        but this is seldom necessary).
  4298.  
  4299.        If your internet connection is through a dialup SLIP/PPP service
  4300.        which issues a different IP address each time you connect (called
  4301.        Dynamic IP addressing), you can leave the IP address field blank. If
  4302.        the field is left blank, then Searchlight will automatically connect
  4303.        to whatever IP address is available at the time it is launched.
  4304.        (Note that if your dialup connection is dropped and reestablished
  4305.        with a new IP address while Searchlight is running, telnet
  4306.        connections may not work until you exit and restart Searchlight).
  4307.  
  4308.        If you configure a node to accept a telnet connection, you should
  4309.        disable that node from accepting modem connections.  To do that,
  4310.        enter a 0 for the Com Port Number on the Communications setup tab.
  4311.  
  4312.  
  4313.        ------------
  4314.        Using Telnet
  4315.        ------------
  4316.  
  4317.        Once your BBS is configured to accept telnet sessions and the
  4318.        appropriate node(s) are launched, you can connect to your BBS via
  4319.        any telnet client by typing your host system's IP address or
  4320.        computer name (if you computer is registered on a domain name
  4321.        sever). Once connected, you use Searchlight just as you would use it
  4322.        via a modem connection.
  4323.  
  4324.        There are several issues you should be aware of when using
  4325.        Searchlight BBS via telnet. The TCP/IP protocol over which telnet
  4326.        rides is packet-oriented; that means information is transmitted in
  4327.        blocks. As a result, you may notice that screens tend to display in
  4328.        blocks rather than as a continuous stream of data; you may also
  4329.        notice short delays between when you type a letter or command and
  4330.        when the results of your typing are visible. This is normal behavior
  4331.        for telnet operations.
  4332.  
  4333.        Telnet performance may be limited by the capabilities of the telnet
  4334.        client you use. Some telnet clients do not provide the same level of
  4335.        ANSI graphics support as leading terminal programs. For example, the
  4336.        default telnet client included with Windows 95 supports ANSI, but
  4337.        does not support color codes or high ASCII characters. If you wish
  4338.        to use ANSI mode with a telnet client, remember to set the screen
  4339.        size (buffer size) to 24 lines. If you encounter a lot of display
  4340.        problems on a telnet client in ANSI mode, try switching to non-ANSI
  4341.        mode. Be sure to set your telnet client to "full duplex" mode, if a
  4342.        setting is available.
  4343.  
  4344.        Some telnet clients (such as the Windows 95 default client) do not
  4345.        support file transfers, and are thus incapable of uploading or
  4346.        downloading files.  For best results, try to use a more advanced
  4347.        telnet communications package.  Newer versions of Windows 95
  4348.        HyperTerminal support telnet operations and file transfers, and work
  4349.  
  4350.        _____________________________________________________________________
  4351.                                         57
  4352.                               SEARCHLIGHT AND TELNET
  4353.        _____________________________________________________________________
  4354.  
  4355.        well with Searchlight BBS.  There are a number of other shareware
  4356.        telnet clients that can be used with Searchlight, as well as a
  4357.        number of commercial communications packages (Procomm, Qmodem, etc.)
  4358.  
  4359.  
  4360.        --------------
  4361.        Telnet and RIP
  4362.        --------------
  4363.  
  4364.        RIP graphics are available via telnet if you use a RIP-compatible
  4365.        telnet client. The best way to use RIP over a telnet connection is
  4366.        to run TeleGrafix' RIP telnet client. For more information about the
  4367.        RIP telnet client, check the TeleGrafix home page at
  4368.        http://www.telegrafix.com.
  4369.  
  4370.        In some cases, you can telnet to a Searchlight BBS with an older
  4371.        RIPterm program indirectly (by dialing a Unix host or other type of
  4372.        host that has outbound telnet features). In many cases, RIP graphics
  4373.        will be available via this route, but file transfers may not work
  4374.        due to the 7-bit nature of many telnet connections.
  4375.  
  4376.  
  4377.        ----------------
  4378.        Telnet and Doors
  4379.        ----------------
  4380.  
  4381.        Door programs that rely on Searchlight's BIOS or Direct Video
  4382.        communications support can be used with a telnet connection and will
  4383.        normally not require any modifications.
  4384.  
  4385.        For best results with other types of doors, set the Communications
  4386.        Support option in Searchlight to "Fossil", and configure the door
  4387.        program such that it uses Fossil driver function calls for
  4388.        communication.
  4389.  
  4390.        Doors that install their own serial communications drivers or which
  4391.        attempt to write directly to a serial port will not work with telnet
  4392.        connections.
  4393.  
  4394.  
  4395.        ---------------
  4396.        Troubleshooting
  4397.        ---------------
  4398.  
  4399.        If you configure Searchlight for telnet support but you cannot
  4400.        connect, check to make sure that the IP address you entered in the
  4401.        configuration screen is correct. You must know your computer's IP
  4402.        address or registered computer name in order to connect to
  4403.        Searchlight via telnet. Contact your network administrator or
  4404.        internet service provider if you are not sure.
  4405.  
  4406.  
  4407.  
  4408.  
  4409.        _____________________________________________________________________
  4410.                                         58
  4411.                               SEARCHLIGHT AND TELNET
  4412.        _____________________________________________________________________
  4413.  
  4414.        If you connect to Searchlight but you see two characters for every
  4415.        key you type, your telnet client is probably set for "echo mode" or
  4416.        "half duplex" mode. Most clients have a configuration screen in
  4417.        which you can disable this mode.
  4418.  
  4419.        Many clients also have a "line entry" mode. If you see nothing until
  4420.        you press Enter, your client may be in line mode.  Line mode won't
  4421.        work properly with Searchlight BBS. Again, you should be able to
  4422.        disable this mode via a configuration screen on your client.
  4423.  
  4424.        If file transfers fail, or if screens with high ASCII characters
  4425.        don't look correct, your client may be set to 7-bit mode.
  4426.        Searchlight works best in 8-bit mode. Most clients can support 8-bit
  4427.        mode, but a few cannot.
  4428.  
  4429.        If ANSI displays look correct except for the last line, check to make
  4430.        sure your client is set to display 24 lines rather than 25 lines or
  4431.        some other number of lines.
  4432.  
  4433.        If you are trying to use Searchlight with an older telnet client, or
  4434.        with a unix-based client, you may be able to obtain best results by
  4435.        selecting the Monochrome or None graphics options when you connect.
  4436.  
  4437.  
  4438.  
  4439.  
  4440.  
  4441.  
  4442.  
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.  
  4449.  
  4450.  
  4451.  
  4452.  
  4453.  
  4454.  
  4455.  
  4456.  
  4457.  
  4458.  
  4459.  
  4460.  
  4461.  
  4462.  
  4463.  
  4464.  
  4465.  
  4466.  
  4467.  
  4468.        _____________________________________________________________________
  4469.                                         59
  4470.                               CONFERENCE MAINTENANCE
  4471.        _____________________________________________________________________
  4472.  
  4473.  
  4474.         -------------------------------------------------------------------
  4475.        | SEARCHLIGHT BBS CONFERENCE MAINTENANCE                            |
  4476.         -------------------------------------------------------------------
  4477.  
  4478.        Message Conference Maintenance, the second choice on Searchlight's
  4479.        CONFIG program main menu, provides you with a way to create, change,
  4480.        and delete message areas or conferences. Searchlight conferences are
  4481.        independent message areas that contain public or semi-private group
  4482.        discussions: they're equivalent to forums or conferences used in
  4483.        other online systems.
  4484.  
  4485.        To access the Conference Maintenance screen, simply select item "B"
  4486.        from the CONFIG main menu. You can also call Conference Maintenance
  4487.        up directly from the command line by typing:
  4488.  
  4489.             CONFIG B
  4490.  
  4491.        You'll see a list of the conferences that are available on your
  4492.        system, along with these options:
  4493.  
  4494.            <Enter>Edit Entry <F1>Add <F2>Delete <F3>Utilities <ESC>Exit
  4495.  
  4496.        Except for the Add option, these commands operate on the conference
  4497.        that's pointed to by the cursor position. To edit, delete, or
  4498.        perform utilities on a conference, move the cursor to the desired
  4499.        conference by pressing the direction keys (Up/Down arrow, PgUp,
  4500.        PgDn), then press <Enter>, F2 or F3.  Or, if you have a mouse,
  4501.        simply point to the desired conference and "click" the left mouse
  4502.        button once to move the cursor, or twice to edit the conference. You
  4503.        can scroll the list or operate any of the F key options by
  4504.        "clicking" on the names of the commands as they appear on your
  4505.        screen.
  4506.  
  4507.        To quickly locate a conference when your conference list is large,
  4508.        type the first few letters of the conference name. This will move
  4509.        the cursor to the first entry that begins with those letters. Since
  4510.        the CONFIG program always displays the conference lists in
  4511.        alphabetical order, the desired conference will then be either at or
  4512.        very near the cursor position.
  4513.  
  4514.        Note: Searchlight creates three default conferences, MAIL, BULLETIN
  4515.              and GENERAL, when you first install it. MAIL and BULLETIN are
  4516.              "hidden" conferences that are generally not used directly by
  4517.              your callers; we recommend that you do not change or delete
  4518.              these conferences. GENERAL is intended to be a "general
  4519.              purpose" conference for use by callers; you can edit or remove
  4520.              it if you wish, however, be sure that there is always at least
  4521.              one conference available for callers to use when they log in
  4522.              to your BBS.
  4523.  
  4524.  
  4525.  
  4526.  
  4527.        _____________________________________________________________________
  4528.                                         60
  4529.                               CONFERENCE MAINTENANCE
  4530.        _____________________________________________________________________
  4531.  
  4532.  
  4533.         -------------------------------------------------------------------
  4534.        | ADD CONFERENCE                                                    |
  4535.         -------------------------------------------------------------------
  4536.  
  4537.        Press F1 to create a new conference. Searchlight will prompt you for
  4538.        a conference name, and a path in which to store the data files for
  4539.        the conference. The conference name must be a unique 1 to 8
  4540.        character filename.  The path must refer to an existing drive and
  4541.        directory (it defaults to the current directory, but may be
  4542.        changed).
  4543.  
  4544.        We suggest you create one or more subdirectories for storing your
  4545.        conference files, rather than keep them in the default current
  4546.        directory. Create the directories at the command prompt or in the
  4547.        Windows explorer before running the CONFIG program.
  4548.  
  4549.        If the name or path you enter contains an error, Searchlight will
  4550.        prompt you to enter new information. Otherwise, it creates the data
  4551.        files for the new conference. Each conference you create will have
  4552.        three files: a header file, a message text file, and a member file;
  4553.        the filenames for these files are the conference name followed by
  4554.        the extension .HDR, .MSG and .MBR. For example, if you created a
  4555.        conference called "BUYSELL" on your system, the following files are
  4556.        created:
  4557.  
  4558.             BUYSELL.HDR
  4559.             BUYSELL.MSG
  4560.             BUYSELL.MBR
  4561.  
  4562.        As you can see, the conference name "BUYSELL" is used as the actual
  4563.        filename for the conference data files, which is why the conference
  4564.        name is required to be a legal eight character filename. Conference
  4565.        names may contain numbers (as is allowed by DOS) and a few symbols
  4566.        (such as "-" or "!") but may not contain blank spaces, back or
  4567.        forward slashes, periods, or other reserved characters.
  4568.  
  4569.        New conferences are created with a number of default options that can
  4570.        be changed to suit your needs. Once the file creation sequence is
  4571.        complete, the Add Conference procedure moves directly to the
  4572.        Conference Edit screen, where you can enter a descriptive name for
  4573.        your conference and edit the default options as needed.
  4574.  
  4575.  
  4576.  
  4577.  
  4578.  
  4579.  
  4580.  
  4581.  
  4582.  
  4583.  
  4584.  
  4585.  
  4586.        _____________________________________________________________________
  4587.                                         61
  4588.                               CONFERENCE MAINTENANCE
  4589.        _____________________________________________________________________
  4590.  
  4591.  
  4592.         -------------------------------------------------------------------
  4593.        | EDIT CONFERENCE                                                   |
  4594.         -------------------------------------------------------------------
  4595.  
  4596.        Whenever you create a new conference, or edit an existing conference,
  4597.        the following input screen will appear:
  4598.  
  4599.              1. Conference Description ....... General Msgs
  4600.              2. Data Files Path .............. C:\BBS
  4601.              3. Required Access Level ........ 0
  4602.              4. Join Attributes .............. ABC
  4603.              5. Post Attributes .............. ABCD
  4604.              6. Conference Sysop .............
  4605.              7. Max. Messages ................ 1000
  4606.              8. Max. Message Size ............ 400
  4607.              9. Alias Name Support ........... Real Only
  4608.             10. Anonymous Messages ........... No
  4609.             11. Auto Purge Old Messages ...... No
  4610.             12. Compress Message Texts ....... Yes
  4611.             13. Allow Users to Join .......... Yes
  4612.             14. Display on Conference Lists .. Yes
  4613.             15. Echomail Address .............
  4614.             16. Newsgroup Settings [. . .]
  4615.  
  4616.        As with the general configuration options, edit these fields by
  4617.        moving the cursor to the appropriate location and entering or
  4618.        editing the data within.  Here is an explanation of each field:
  4619.  
  4620.  
  4621.        --------------------------
  4622.        1 - Conference Description
  4623.        --------------------------
  4624.  
  4625.        This is a long description which you can use to further describe the
  4626.        message conference. Your description is displayed with the List
  4627.        command from Searchlight BBS.
  4628.  
  4629.  
  4630.        -------------------
  4631.        2 - Data Files Path
  4632.        -------------------
  4633.  
  4634.        This is the path that contains the data files (header, message and
  4635.        member files) for the conference. It must be a legal DOS pathname
  4636.        that exists on your system.
  4637.  
  4638.  
  4639.  
  4640.  
  4641.  
  4642.  
  4643.  
  4644.  
  4645.        _____________________________________________________________________
  4646.                                         62
  4647.                               CONFERENCE MAINTENANCE
  4648.        _____________________________________________________________________
  4649.  
  4650.  
  4651.        -------------------------
  4652.        3 - Required Access Level
  4653.        -------------------------
  4654.  
  4655.        This is the access level that users must have to use the conference.
  4656.        Users who have at least this access level, along with any required
  4657.        attributes, may Jump to and read messages on this conference;
  4658.        otherwise, the conference does not appear on the conference list and
  4659.        is not accessible.
  4660.  
  4661.  
  4662.        -------------------
  4663.        4 - Join Attributes
  4664.        -------------------
  4665.  
  4666.        This field defines the security attributes (keys) needed to access
  4667.        and join the conference. Attributes defined here must match those
  4668.        defined in the user's information record in order for that user to
  4669.        be able to use the conference.
  4670.  
  4671.  
  4672.        -------------------
  4673.        5 - Post Attributes
  4674.        -------------------
  4675.  
  4676.        This field defines the attributes required to Post a message on the
  4677.        conference. Those users who have attributes sufficient to Join a
  4678.        conference (line 4) but not Post, will be able to read messages on
  4679.        the conference but will not be able to write messages. This includes
  4680.        replying to messages, and forwarding messages to the conference.
  4681.  
  4682.  
  4683.        --------------------
  4684.        6 - Conference Sysop
  4685.        --------------------
  4686.  
  4687.        If filled in, this field defines the name of the person who is
  4688.        Conference Sysop for this conference. The Conference Sysop has the
  4689.        ability to moderate the conference discussion by editing or deleting
  4690.        any messages on the conference. Be sure to spell the Conference
  4691.        Sysop's name exactly as it is spelled in your User file.
  4692.  
  4693.  
  4694.        ------------------------------
  4695.        7 - Max Messages on Conference
  4696.        ------------------------------
  4697.  
  4698.        This field defines the maximum number of messages that can be posted
  4699.        on the conference at any given time. The maximum value that can be
  4700.        defined is 32767; or you can define a lower value if you wish to
  4701.        limit the number of messages. (Note: see Auto Purge Old Messages
  4702.        below).
  4703.  
  4704.        _____________________________________________________________________
  4705.                                         63
  4706.                               CONFERENCE MAINTENANCE
  4707.        _____________________________________________________________________
  4708.  
  4709.  
  4710.        --------------------
  4711.        8 - Max Message Size
  4712.        --------------------
  4713.  
  4714.        This defines the maximum message size in lines that may be input and
  4715.        posted on this conference. The maximum value that can be defined is
  4716.        1000. Use a lower value if you wish to limit the length of messages
  4717.        posted.
  4718.  
  4719.        Note: Max Message Size only defines the maximum size that will be
  4720.              allowed for messages entered directly through Searchlight's
  4721.              built in editors. Messages posted via external utilities like
  4722.              SLMAIL or an offline message reader, or messages Forwarded to
  4723.              the conference, can be longer.
  4724.  
  4725.  
  4726.        ----------------------
  4727.        9 - Alias Name Support
  4728.        ----------------------
  4729.  
  4730.        This field selects the type of alias name support (if any) that will
  4731.        be allowed on the conference. For more information about alias names
  4732.        and conferences, please see the section "Alias Names - Alias Name
  4733.        Logins."
  4734.  
  4735.  
  4736.        -----------------------------
  4737.        10 - Allow Anonymous Messages
  4738.        -----------------------------
  4739.  
  4740.        If set to Yes, Searchlight allows messages to be posted anonymously
  4741.        (i.e.  without indicating the name of the author in the message
  4742.        header). A "Post Anonymously? Yes/No" prompt will appear each time a
  4743.        new message is entered.  Otherwise, this prompt does not appear and
  4744.        anonymous posting is not allowed.
  4745.  
  4746.  
  4747.        ----------------------------
  4748.        11 - Auto Purge Old Messages
  4749.        ----------------------------
  4750.  
  4751.        If set to Yes, Searchlight will delete the oldest unprotected message
  4752.        on the conference when the conference is full (that is, when it
  4753.        reaches the maximum messages value defined in line 7) and someone
  4754.        tries to post a new message. If set to No, Searchlight will not
  4755.        allow a new message to be posted once the maximum value is reached.
  4756.  
  4757.        Note: You can protect individual messages from being deleted as part
  4758.              of the Auto Purge sequence. Use the Edit command to edit the
  4759.              desired message, and change the protection status when
  4760.              prompted.
  4761.  
  4762.  
  4763.        _____________________________________________________________________
  4764.                                         64
  4765.                               CONFERENCE MAINTENANCE
  4766.        _____________________________________________________________________
  4767.  
  4768.  
  4769.        ---------------------------
  4770.        12 - Compress Message Texts
  4771.        ---------------------------
  4772.  
  4773.        If set to Yes, Searchlight uses its built in text compression
  4774.        algorithm to reduce the size of message data as it is saved to disk.
  4775.        Otherwise, message data is not compressed.
  4776.  
  4777.        Compression reduces the overall size of your message text (MSG) file
  4778.        by about 30%, but requires additional time when saving and reading
  4779.        messages. We recommend turning data compression off if you have an
  4780.        extremely slow PC, if you have a large amount of storage space and
  4781.        desire the fastest possible operation, or for instances where you
  4782.        need to save a lot of messages at one time (such as during a Fidonet
  4783.        message import via SLMAIL). Otherwise, turn data compression on to
  4784.        achieve optimal storage space.
  4785.  
  4786.        Note: You can turn data compression on or off at anytime, however,
  4787.              only messages that are saved after making a change will be
  4788.              affected by the new setting.
  4789.  
  4790.  
  4791.        ------------------------
  4792.        13 - Allow Users to Join
  4793.        ------------------------
  4794.  
  4795.        If set to Yes (the default), users can join this conference by using
  4796.        the 1-Member/Join command. Otherwise, users may not join the
  4797.        conference.
  4798.  
  4799.        Joining a conference is a requirement for use of the New command and
  4800.        is generally recommended for anyone who plans to read the conference
  4801.        regularly.  You may wish to disallow joining for special conferences
  4802.        (such as BULLETIN) or for conferences with a private membership.
  4803.  
  4804.  
  4805.        --------------------------------
  4806.        14 - Display on Conference Lists
  4807.        --------------------------------
  4808.  
  4809.        If set to Yes (the default), Searchlight displays the conference when
  4810.        the List command is used, provided that the person using the command
  4811.        has access to the conference. Otherwise, the conference is not
  4812.        displayed (but may still be accessed via the Jump command).
  4813.  
  4814.        Note: The No setting is primarily designed for special conferences
  4815.              like MAIL and BULLETIN, which are accessible to Sysops but
  4816.              which you may desire not to appear on regular conference
  4817.              listings when you use your BBS.
  4818.  
  4819.  
  4820.  
  4821.  
  4822.        _____________________________________________________________________
  4823.                                         65
  4824.                               CONFERENCE MAINTENANCE
  4825.        _____________________________________________________________________
  4826.  
  4827.  
  4828.        ---------------------
  4829.        15 - Echomail Address
  4830.        ---------------------
  4831.  
  4832.        This field defines the echomail network numbers used on Fidonet
  4833.        systems. If you are a member of Fidonet or a Fidonet compatible
  4834.        network, use this field to fill in the proper address for the
  4835.        conference if this conference is to be used for echomail.
  4836.        Searchlight's SLMAIL software uses this value to construct the
  4837.        origin line when it exports messages from the conference. For more
  4838.        information about echomail, see Appendix F.
  4839.  
  4840.  
  4841.        -----------------------
  4842.        16 - Newsgroup Settings
  4843.        -----------------------
  4844.  
  4845.        This section lets you configure a conference to carry an internet
  4846.        newsgroup, when used with Searchlight's Uumail add-on product. For
  4847.        more information about these settings, see your Uumail manual. (For
  4848.        information about purchasing the Uumail product, which allows you to
  4849.        host newsgroups and internet email on your BBS via a low-cost dialup
  4850.        connection, contact TeleGrafix).
  4851.  
  4852.  
  4853.        ----------------------
  4854.        Additional Information
  4855.        ----------------------
  4856.  
  4857.        If you run a multinode system and you change conference information
  4858.        while other users are online, the new information may not take
  4859.        effect until the current users log off.
  4860.  
  4861.        Occasionally, you may wish to add a conference for which you already
  4862.        have data files (for example, if you have obtained a copy of a
  4863.        conference from another Searchlight BBS and wish to install it on
  4864.        your own). Searchlight supports this. Be sure the files are
  4865.        installed in the proper directory, then proceed to add the
  4866.        conference with F1. Searchlight will read the existing data files
  4867.        rather than create new ones.
  4868.  
  4869.        Because Searchlight's conference files (the HDR, MSG and MBR) files
  4870.        are designed to be independent of the main *.SL2 files, you can back
  4871.        up, restore, and transfer message conferences as independent units.
  4872.        However, within each conference, the three conference files should
  4873.        always be moved as a unit: that is, do not mix the HDR file from one
  4874.        conference with the MSG file from another, nor should you combine
  4875.        one file from a backup disk with your main files or files from a
  4876.        different backup disk.
  4877.  
  4878.  
  4879.  
  4880.  
  4881.        _____________________________________________________________________
  4882.                                         66
  4883.                               CONFERENCE MAINTENANCE
  4884.        _____________________________________________________________________
  4885.  
  4886.  
  4887.         -------------------------------------------------------------------
  4888.        | DELETE CONFERENCE                                                 |
  4889.         -------------------------------------------------------------------
  4890.  
  4891.        To delete a conference, position the cursor at the desired conference
  4892.        and press F2. The CONFIG program will prompt you as follows:
  4893.  
  4894.             Delete From Conference List? Yes/No
  4895.             Erase Files From Disk? Yes/No
  4896.  
  4897.        Assuming you really want to delete the conference, select "Yes" as
  4898.        your response to the first question. The file is removed from your
  4899.        conference list (SUBBOARD.SL2) file.
  4900.  
  4901.        You can choose whether or not you wish to delete the data files (HDR,
  4902.        MSG, MBR) from disk or retain them. If you delete these files, your
  4903.        conference data is erased and may not be recovered. However, if you
  4904.        retain them, you will be able to reinstate the conference later by
  4905.        adding it back to the conference list.
  4906.  
  4907.  
  4908.         -------------------------------------------------------------------
  4909.        | CONFERENCE UTILITIES                                              |
  4910.         -------------------------------------------------------------------
  4911.  
  4912.        The Conference Utilities menu provides several options for use in
  4913.        maintaining your conference files. Position the cursor at the
  4914.        desired conference and press F3 for the utilities menu:
  4915.  
  4916.             A. Repair/Rebuild Header File
  4917.             B. Repair/Rebuild Text File
  4918.             C. Repair/Rebuild Member File
  4919.  
  4920.  
  4921.        ------------------
  4922.        Repair Header File
  4923.        ------------------
  4924.  
  4925.        This option performs an integrity check on the header (HDR) file and
  4926.        rebuilds the indexes in the header file, repairing any damaged
  4927.        areas. Use this option if you are having a problem with a conference
  4928.        (such as unreadable or garbled messages, lock ups when saving or
  4929.        reading messages, etc.). Invalid index information, which may have
  4930.        gotten into the header file as a result of a disk error, a system
  4931.        crash, or other abnormal situation, will be corrected.
  4932.  
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.        _____________________________________________________________________
  4941.                                         67
  4942.                               CONFERENCE MAINTENANCE
  4943.        _____________________________________________________________________
  4944.  
  4945.  
  4946.        ----------------
  4947.        Repair Text File
  4948.        ----------------
  4949.  
  4950.        This option verifies and repairs the text (MSG) file. Unless you are
  4951.        sure that a problem is in the header or the text file, we suggest
  4952.        running option A, B and C in that order so that a conference is
  4953.        fully repaired.
  4954.  
  4955.  
  4956.        ------------------
  4957.        Repair Member File
  4958.        ------------------
  4959.  
  4960.        This option verifies and repairs the member (MBR) file. In addition,
  4961.        the member file is rebalanced (placed in an optimally sorted order)
  4962.        which reduces the time necessary to lookup member names in the file.
  4963.  
  4964.  
  4965.  
  4966.  
  4967.  
  4968.  
  4969.  
  4970.  
  4971.  
  4972.  
  4973.  
  4974.  
  4975.  
  4976.  
  4977.  
  4978.  
  4979.  
  4980.  
  4981.  
  4982.  
  4983.  
  4984.  
  4985.  
  4986.  
  4987.  
  4988.  
  4989.  
  4990.  
  4991.  
  4992.  
  4993.  
  4994.  
  4995.  
  4996.  
  4997.  
  4998.  
  4999.        _____________________________________________________________________
  5000.                                         68
  5001.                                DIRECTORY MAINTENANCE
  5002.        _____________________________________________________________________
  5003.  
  5004.  
  5005.         -------------------------------------------------------------------
  5006.        | FILE DIRECTORY MAINTENANCE                                        |
  5007.         -------------------------------------------------------------------
  5008.  
  5009.        To create or modify file directories (areas from which your users can
  5010.        upload and download files), select option C, File Directory Setup,
  5011.        from the CONFIG program main menu. (You can also type CONFIG C from
  5012.        a command prompt).
  5013.  
  5014.        File directory maintenance is similar to conference maintenance: to
  5015.        edit or delete a filedir, select it with the cursor, and press
  5016.        <Enter> to edit or F2 to delete. F1 is used to add a new directory.
  5017.  
  5018.        Note: A Searchlight File Directory or "Filedir" is a special file
  5019.              that contains information such as descriptions, number of
  5020.              times downloaded, etc.  about files on your system that are
  5021.              available for download. The filedir contains the names of
  5022.              available files, but not the files themselves. It is important
  5023.              to realize that most of Searchlight's file library management
  5024.              commands deal with the filedir, and not the physical DOS
  5025.              directory itself; you need to create filedirs, and create
  5026.              entries in them, before any file on your computer can be
  5027.              downloaded.
  5028.  
  5029.        Here are the options available when adding or editing a directory:
  5030.  
  5031.              1. Directory Description .. New Files
  5032.              2. Path to DIR File ....... C:\BBS\UPLOAD
  5033.              3. Path to Files .......... C:\BBS\UPLOAD
  5034.              4. Required Access Level .. 2
  5035.              5. Required Attributes .... ABC
  5036.              6. Read Only Directory .... No
  5037.              7. Write Only Directory ... No
  5038.              8. Duplicate File Scan .... Yes
  5039.              9. Free Files (K) ......... 100
  5040.             10. File Value Multiplier .. 10
  5041.             11. Credits per File ....... 0
  5042.             12. Credits per Kilobyte ... 0
  5043.  
  5044.  
  5045.        --------------
  5046.        Directory Name
  5047.        --------------
  5048.  
  5049.        This is the 1 to eight character name for the directory. As with
  5050.        conferences, directory names must be legal DOS filenames and may not
  5051.        contain spaces or other illegal characters.
  5052.  
  5053.        Note: The data files used to hold the file descriptions and other
  5054.              information for a directory are created by using the directory
  5055.              name with the extensions ".SL2" and ".EDF".
  5056.  
  5057.  
  5058.        _____________________________________________________________________
  5059.                                         69
  5060.                                DIRECTORY MAINTENANCE
  5061.        _____________________________________________________________________
  5062.  
  5063.  
  5064.        -------------------------
  5065.        1 - Directory Description
  5066.        -------------------------
  5067.  
  5068.        In this field, enter a verbose description of the file directory.
  5069.        The description appears whenever you use the List command in the
  5070.        files system.
  5071.  
  5072.  
  5073.        --------------------
  5074.        2 - Path to Dir File
  5075.        --------------------
  5076.  
  5077.        This is the path to the directory that contains the directory data
  5078.        file (*.SL2 file). By default, this is the same as "Path To Files",
  5079.        but may be changed. In this example, the file
  5080.        C:\BBS\UPLOADS\UPLOADS.SL2 contains all of the filenames and
  5081.        descriptions for the files in this directory.
  5082.  
  5083.  
  5084.        -----------------
  5085.        3 - Path to Files
  5086.        -----------------
  5087.  
  5088.        This is the path to the data files that will be uploaded and
  5089.        downloaded. Be sure that this pathname exists before you attempt to
  5090.        create a new directory.
  5091.  
  5092.        Note: In most cases, "Path to Dir File" and "Path to Files" are the
  5093.              same. The primary instance in which they will be different is
  5094.              in the case where "Path to Files" refers to a read-only
  5095.              device, such as a CD-ROM. Since the directory SL2 file needs
  5096.              to be on read/write media, it would be necessary to place
  5097.              this file on a different drive. This is also useful when
  5098.              making file directories that reside on floppy disks.
  5099.  
  5100.  
  5101.        -------------------------
  5102.        4 - Required Access Level
  5103.        5 - Required Attributes
  5104.        -------------------------
  5105.  
  5106.        These are the access level and attribute requirements needed to use
  5107.        the file directory. As with conferences, a user must meet both the
  5108.        access level and attribute requirement before he or she can use the
  5109.        directory.
  5110.  
  5111.  
  5112.  
  5113.  
  5114.  
  5115.  
  5116.  
  5117.        _____________________________________________________________________
  5118.                                         70
  5119.                                DIRECTORY MAINTENANCE
  5120.        _____________________________________________________________________
  5121.  
  5122.  
  5123.        -----------------------
  5124.        6 - Read Only Directory
  5125.        -----------------------
  5126.  
  5127.        If set to Yes, the directory becomes read-only; that is, users are
  5128.        permitted to download files from the directory, but may not upload
  5129.        new files (or move files from another directory).
  5130.  
  5131.        Note: The Sysop and those with sysop level privileges can place new
  5132.              files into a read only area.
  5133.  
  5134.  
  5135.        ------------------------
  5136.        7 - Write Only Directory
  5137.        ------------------------
  5138.  
  5139.        If set to Yes, a write only directory is created. Write only
  5140.        directories allow users to upload files, but do not allow them to
  5141.        download, type, or view other files in the directory. Write only
  5142.        areas are useful as a means of sending private files to the Sysop or
  5143.        for screening files before moving them to another directory where
  5144.        downloading is permitted.
  5145.  
  5146.  
  5147.        -----------------------
  5148.        8 - Duplicate File Scan
  5149.        -----------------------
  5150.  
  5151.        This options lets you exclude directories from the duplicate file
  5152.        search that normally takes place before a file is uploaded.  This is
  5153.        desirable with systems that have a large number of directories which
  5154.        do not need to be checked against new files for duplication.
  5155.        Excluding multiple directories from the upload scan helps speed up
  5156.        the scan.
  5157.  
  5158.  
  5159.        ------------------
  5160.        9 - Free Files (K)
  5161.        ------------------
  5162.  
  5163.        The "Free Files" field is a value, expressed in Kilobytes, that
  5164.        determines the amount of files that a new caller may download before
  5165.        their upload:download ratio takes effect. If you use ratios on your
  5166.        BBS, this allows you to create a "grace period" during which new
  5167.        users can download files before being required to upload files in
  5168.        order to maintain a ratio.
  5169.  
  5170.        Note: Although a different free files value may be expressed for
  5171.              each conference on your BBS, the decision to allow a new user
  5172.              to download is based upon the total size of files they have
  5173.              downloaded from all directories in the BBS as compared with
  5174.              the Free Files value for the directory from which the download
  5175.              is requested.
  5176.        _____________________________________________________________________
  5177.                                         71
  5178.                                DIRECTORY MAINTENANCE
  5179.        _____________________________________________________________________
  5180.  
  5181.  
  5182.        --------------------------
  5183.        10 - File Value Multiplier
  5184.        --------------------------
  5185.  
  5186.        This field defines a multiplier for the size of files in a directory
  5187.        as recorded in user downloading statistics. The multiplier is
  5188.        actually equal to this field divided by 10; therefore, a value of
  5189.        "10" is a multiplier of 1.0.
  5190.  
  5191.        The value multiplier lets you make certain files more or less
  5192.        valuable in terms of the way they will affect the upload:download
  5193.        ratio when downloaded.  For example, if a directory contains a value
  5194.        multiplier of 2.0 (field 10 equal to 20), then files in that
  5195.        directory will register as twice their actual size in Kilobytes when
  5196.        downloaded. A 100K file will count as 200K, 150K as 300K, etc. In a
  5197.        directory where the value multiplier is .5 (field 10 equal to 5),
  5198.        files downloaded would register as half their actual size. To make
  5199.        files completely free (i.e. no impact on download ratio), set the
  5200.        value multiplier to zero.
  5201.  
  5202.        File Value Multipliers can range from 0 to 9.9 (i.e. 0 to 99).
  5203.  
  5204.  
  5205.        -------------------------
  5206.        11 - Credits per File
  5207.        12 - Credits per Kilobyte
  5208.        -------------------------
  5209.  
  5210.        These values define the number of credits a user is charged when
  5211.        downloading files. You can charge credits on a per-file or
  5212.        per-kilobyte basis (or both).  If a user succeeds in downloading
  5213.        file(s), these values are deducted from the user's credit balance.
  5214.        (If a user has insufficient credits, the download is disallowed).
  5215.  
  5216.        If you don't wish to asses a per-file or per-kilobyte charge, you can
  5217.        leave these fields set to zero.
  5218.  
  5219.  
  5220.         -------------------------------------------------------------------
  5221.        | DIRECTORY UTILITIES                                               |
  5222.         -------------------------------------------------------------------
  5223.  
  5224.        The Directory Utilities menu provides several options for use in
  5225.        maintaining your directories. Position the cursor at the desired
  5226.        directory and press F3 for the utilities menu:
  5227.  
  5228.             A. Balance/Repair Directory
  5229.             B. Import File Descriptions
  5230.  
  5231.  
  5232.  
  5233.  
  5234.  
  5235.        _____________________________________________________________________
  5236.                                         72
  5237.                                DIRECTORY MAINTENANCE
  5238.        _____________________________________________________________________
  5239.  
  5240.  
  5241.        ------------------------
  5242.        Balance/Repair Directory
  5243.        ------------------------
  5244.  
  5245.        This function repairs a damaged directory file and also optimizes a
  5246.        directory file so that filename searches take the least amount of
  5247.        time possible. Use this command primarily if you suspect that a
  5248.        directory file is damaged or if you have trouble accessing the files
  5249.        in a directory.
  5250.  
  5251.  
  5252.        ------------------------
  5253.        Import File Descriptions
  5254.        ------------------------
  5255.  
  5256.        The Import command allows you to load filenames, descriptions, sizes
  5257.        and dates into Searchlight BBS from an external text file list.
  5258.        Import allows you to use generic directory listings, as well as
  5259.        directory listings from many other BBS programs, with Searchlight
  5260.        BBS. For more information, please see the section "File Subsystem -
  5261.        Importing File Lists."
  5262.  
  5263.  
  5264.         -------------------------------------------------------------------
  5265.        | CUSTOM ORDERING                                                   |
  5266.         -------------------------------------------------------------------
  5267.  
  5268.        By default, Searchlight lists your file areas and conferences in
  5269.        alphabetical order when you use the List command.  However, you can
  5270.        define the order in which you would like conferences and directories
  5271.        to appear by creating a customization file.
  5272.  
  5273.        Customization files are just text files containing a list of
  5274.        conferences or file directories, one per line. To customize the
  5275.        display of your conferences, create a file named MAIN.SUB, and place
  5276.        it in your Searchlight BBS home directory.  MAIN.SUB should contain
  5277.        a list of your conferences in the desired order. To do the same for
  5278.        your file directories, create a file called MAIN.DIR.
  5279.  
  5280.        In addition, it's possible to create a custom directory list for any
  5281.        conference on your system, so that when the Files system is invoked
  5282.        from that conference, only the directories associated with the
  5283.        conference are available. Create a text file with the name of the
  5284.        conference and the extension .DIR, and place this file in the
  5285.        directory that contains the other data files for the conference. As
  5286.        an example, if you wanted to create a custom dir list for the
  5287.        GENERAL conference, it would be called GENERAL.DIR.
  5288.  
  5289.        If you use a custom conference or directory file, remember that new
  5290.        directories and conferences must be added to the custom file as they
  5291.        are created; otherwise, the new areas won't be available from your
  5292.        BBS.
  5293.  
  5294.        _____________________________________________________________________
  5295.                                         73
  5296.                             STARTUP, LOGIN & NEW USERS
  5297.        _____________________________________________________________________
  5298.  
  5299.  
  5300.         -------------------------------------------------------------------
  5301.        | RUNNING SEARCHLIGHT BBS - LOGGING IN FOR THE FIRST TIME           |
  5302.         -------------------------------------------------------------------
  5303.  
  5304.        Once Searchlight BBS is set up and configured according to the
  5305.        previous instructions, running it is a relatively simple matter.
  5306.        Once again, make sure that you're in the same directory as the
  5307.        Searchlight data files (the "home" directory) and also make sure
  5308.        that your .EXE files are available in the directory you've defined
  5309.        for the program path (if you left this field blank, then the program
  5310.        files should be in the current directory as well).  If you use the
  5311.        DOS version of Searchlight, type the command:
  5312.  
  5313.             SLBBS
  5314.  
  5315.        To start the Windows version of Searchlight, the procedure is the
  5316.        same, except you use the command SLBBS32. If you like, you can add a
  5317.        shortcut to the Windows version of Searchlight to your desktop or
  5318.        Windows start menu.
  5319.  
  5320.        In a few seconds, your screen will clear and you will see a status
  5321.        box showing your system's name, the current time, and other
  5322.        information. At the bottom of the box it will say,
  5323.  
  5324.          ENTER for Local Login  ESC to Toggle Display On/Off  ALT-X to Exit
  5325.  
  5326.        along with the letters "sacnl" in the lower right hand corner of the
  5327.        screen (these are status indicators; we'll get to them later). There
  5328.        are a couple of other ways you can start Searchlight by adding
  5329.        parameters to the command line -- we'll outline these in a moment.
  5330.  
  5331.        If your computer beeps at you and puts the words "No Response" on the
  5332.        screen in reverse video, check the modem -- it indicates that the
  5333.        modem did not respond to the modem init string with an OK message.
  5334.        Check to make sure that
  5335.  
  5336.             * the modem is turned on
  5337.             * the modem is connected to the proper COM port
  5338.             * Searchlight is configured for the proper COM port
  5339.             * the baud rate(s) selected correspond to the modem's speed
  5340.  
  5341.        If all else fails, please reread the Communications Configuration
  5342.        section of this manual and consult Appendix D, Modem Configuration.
  5343.  
  5344.        Assuming you now see the status box, strike the ENTER key on your
  5345.        keyboard to initiate a local login session.  Searchlight will look
  5346.        for the text file called LOGIN.ANS or LOGIN.TXT, if it exists, and
  5347.        display it on your screen, followed by the prompt
  5348.  
  5349.             Enter your name, or type NEW
  5350.             >
  5351.  
  5352.  
  5353.        _____________________________________________________________________
  5354.                                         74
  5355.                             STARTUP, LOGIN & NEW USERS
  5356.        _____________________________________________________________________
  5357.  
  5358.        If you had called Searchlight from a remote location with a modem,
  5359.        you'd see a message like this upon connecting:
  5360.  
  5361.             ANSI Auto-Detected. (Press D to disable ANSI).
  5362.             Do you have a Color Screen (Yes/No/Disable)?
  5363.  
  5364.        In response to this question, you would type Y if you were using a
  5365.        color CRT, N otherwise. You can also type D here to disable
  5366.        Searchlight from sending ANSI codes -- this causes Searchlight to
  5367.        work in a simpler mode without full-screen text controls. Non-ANSI
  5368.        mode is suitable for older terminal emulators which don't support
  5369.        the full ANSI specification. More information on this topic is
  5370.        presented below.
  5371.  
  5372.        Note: This prompt is skipped if Searchlight detects a RIP compatible
  5373.              terminal. When RIP is detected, Searchlight automatically goes
  5374.              into its RIP graphics mode for the remainder of the session.
  5375.  
  5376.        Since ANSI is always available when logging in locally (it will
  5377.        operate correctly even if you don't boot with the ANSI.SYS driver),
  5378.        Searchlight doesn't ask this question for a local login (and it
  5379.        determines whether to use Color or Monochrome mode by looking at
  5380.        your system's video card).
  5381.  
  5382.        Now, back to that "Enter your name" prompt. Searchlight is asking you
  5383.        to type the name of a valid user account. Since your system is new,
  5384.        there are only two valid accounts on file: one called SYSOP and one
  5385.        called GUEST. The SYSOP account is provided as the default
  5386.        "superuser" account. Many sysops will want to use the SYSOP account
  5387.        as the account they use to log into Searchlight regularly, whereas
  5388.        others will want to set up an account with a different name for
  5389.        themselves; we recommend using SYSOP, because most people recognize
  5390.        that as the name they can use to reach the operator of the BBS. If
  5391.        you choose to use another name, you might want to delete your SYSOP
  5392.        account.
  5393.  
  5394.        For now, respond to the "Enter your name" prompt by typing SYSOP.
  5395.  
  5396.        Searchlight now executes its standard login sequence. First, you'll
  5397.        see a greeting message that displays some information about the
  5398.        system, the previous caller, and total number of callers to the
  5399.        system. On multiline systems with more than one node defined, a list
  5400.        of other concurrent users is shown.
  5401.  
  5402.        Next, the Login Autodoor, if one is defined, is executed. Many sysops
  5403.        use the Login Autodoor to display additional system information,
  5404.        daily news, quotes, etc.
  5405.  
  5406.        After pressing the ENTER key, as prompted, you will enter
  5407.        Searchlight's Bulletins menu, where new and important messages will
  5408.        usually be displayed to callers as the log in. However, since there
  5409.        are no Bulletins on file yet, this section is skipped. Finally, a
  5410.        check of your mailbox is made.  Searchlight displays the total
  5411.  
  5412.        _____________________________________________________________________
  5413.                                         75
  5414.                             STARTUP, LOGIN & NEW USERS
  5415.        _____________________________________________________________________
  5416.  
  5417.        number of messages and number of new messages in your mailbox, and
  5418.        gives you the opportunity to read new messages if they exist. In
  5419.        this case, you'll see a message indicating that you don't have any
  5420.        mail, and the system will deposit you at the main command prompt,
  5421.        which looks like this (the underscore shows your cursor position):
  5422.  
  5423.             [GENERAL] Command: Help   _
  5424.  
  5425.        You are now ready to use the Searchlight BBS system.
  5426.  
  5427.        Note: The login sequence described above, like most aspects of
  5428.              Searchlight, is configurable; you can modify or replace the
  5429.              commands used at login by editing the STARTUP menu. See Menu
  5430.              Editing in this manual for more information.
  5431.  
  5432.  
  5433.         -------------------------------------------------------------------
  5434.        | AUTO ANSI DETECT                                                  |
  5435.         -------------------------------------------------------------------
  5436.  
  5437.        Searchlight has an auto ANSI detect feature. Each time a caller
  5438.        connects to your BBS, Searchlight sends a special sequence of
  5439.        commands to their terminal to determine whether the caller can
  5440.        support ANSI graphics and screen controls.  If ANSI is detected,
  5441.        Searchlight displays this prompt:
  5442.  
  5443.             ANSI Auto-Detected. (Press D to disable ANSI).
  5444.             Do you have a Color Screen (Yes/No/Disable)?
  5445.  
  5446.        Since Searchlight cannot determine whether a caller has a color or
  5447.        monochrome screen, it prompts the caller to enter Yes for color, or
  5448.        No for monochrome.  "D" may also be pressed to disable ANSI screen
  5449.        controls and operate Searchlight in non-ANSI mode; users may wish to
  5450.        select this option if they do not wish to use ANSI even though it
  5451.        may be available in their terminal.
  5452.  
  5453.        If Searchlight fails to detect ANSI, it displays this prompt:
  5454.  
  5455.             Select Graphics Mode: [C]olor, [M]onochrome, or [N]one?
  5456.  
  5457.        Since some ANSI compatible terminal software does not support the
  5458.        auto-detect feature, users can still manually select color ANSI,
  5459.        monochrome ANSI, or non-ANSI mode with this prompt.
  5460.  
  5461.        Because of its many full screen oriented display modes (such as the
  5462.        full screen editor, options fields, and reply-quote editor),
  5463.        Searchlight operates properly in ANSI mode only when the remote
  5464.        terminal uses an 80x24 screen
  5465.         size. Although Searchlight cannot force a terminal into 80x24 mode,
  5466.        it can usually detect whether a terminal is not set to this mode
  5467.        during the ANSI detect sequence. If it does, the following
  5468.        informational message is displayed:
  5469.  
  5470.  
  5471.        _____________________________________________________________________
  5472.                                         76
  5473.                             STARTUP, LOGIN & NEW USERS
  5474.        _____________________________________________________________________
  5475.  
  5476.             Searchlight requires a standard 24 line screen for full screen
  5477.             ANSI mode.  Switch your local terminal to 24 lines now, or
  5478.             press D to disable ANSI.
  5479.  
  5480.        It is recommended that callers make sure their screen is set to 24
  5481.        lines by 80 characters before continuing in ANSI mode, if this
  5482.        message is displayed.  If a larger screen size is desired, callers
  5483.        may proceed in non-ANSI mode, which does not require a 24 line
  5484.        screen.
  5485.  
  5486.        Note: Incorrect screen size on the remote terminal is the cause of
  5487.              many common display problems, such as lines overwriting other
  5488.              lines or messages appearing in the wrong location on the
  5489.              screen. Note that some terminal software allows you to disable
  5490.              the status line, providing an 80x25 line screen. With such
  5491.              software, the status line should always remain enabled so as
  5492.              to provide the correct 80x24 line screen size.
  5493.  
  5494.  
  5495.         -------------------------------------------------------------------
  5496.        | LOCAL RIP MODE                                                    |
  5497.         -------------------------------------------------------------------
  5498.  
  5499.        During a local login, you can use Searchlight either in "ANSI" mode
  5500.        (text mode) or RIP graphics mode. To switch between ANSI and RIP
  5501.        modes, press ALT-R while positioned at any Word or Character style
  5502.        menu (such as the main menu).
  5503.  
  5504.        When RIP is enabled, Searchlight places your monitor into graphics
  5505.        mode and uses RIP graphics conventions to draw graphical menus,
  5506.        mouse areas, scroll bars and other graphical user interface
  5507.        features. RIP mode also allows you to view RIP pictures embedded in
  5508.        messages. You must have an EGA or VGA compatible monitor to use
  5509.        local RIP mode.
  5510.  
  5511.  
  5512.         -------------------------------------------------------------------
  5513.        | THINGS TO DO WHEN FIRST LOGGING IN                                |
  5514.         -------------------------------------------------------------------
  5515.  
  5516.        Here's a quick checklist of some of the things you should do the
  5517.        first time you log in to your new Searchlight BBS system:
  5518.  
  5519.             * Familiarize yourself with the user interface. It's quite easy
  5520.               to use. Try selecting different commands, and reading the
  5521.               online help text by pressing the F1 or ? key.
  5522.  
  5523.             * Use the OPTIONS command to assign a password to your Sysop
  5524.               account. This is very important! If you forget to assign
  5525.               yourself a password, others will be able to use the SYSOP
  5526.               account and that can compromise the security of your system.
  5527.               Don't forget the password you choose; write it down if you
  5528.               must.
  5529.  
  5530.        _____________________________________________________________________
  5531.                                         77
  5532.                             STARTUP, LOGIN & NEW USERS
  5533.        _____________________________________________________________________
  5534.  
  5535.             * Post a few messages and bulletins. This will not only help
  5536.               you learn how the text editor works but it will give your
  5537.               first users something to read when they call your BBS. To
  5538.               post a bulletin, Jump to the BULLETIN conference and use the
  5539.               Post command.
  5540.  
  5541.  
  5542.         -------------------------------------------------------------------
  5543.        | USING THE STATUS DISPLAY                                          |
  5544.         -------------------------------------------------------------------
  5545.  
  5546.        The status box displayed on your screen between calls shows some
  5547.        important information. The first line displays your BBS's name and
  5548.        node number (in multinode systems). Line 2 shows the modem's baud
  5549.        rate and COM port. If an error occurred when Searchlight attempted
  5550.        to set-up the modem using the modem init string, the phrase "No
  5551.        Response" is printed here, otherwise "Ok" is displayed. The third
  5552.        line shows the last caller to the system, and the right-hand part of
  5553.        the screen displays the current time, and the time that the LOGIN
  5554.        program started waiting.
  5555.  
  5556.        If you use preprogrammed events (via the EVENT.DEF file), line 4
  5557.        shows the name and execution time of the next event.  See Appendix
  5558.        C, Automatic Events, for complete instructions.
  5559.  
  5560.        With the DOS version of Searchlight, if a call is not received within
  5561.        five minutes, Searchlight will blank the screen. This is done to
  5562.        prevent screen "burn-in" that can be caused on some CRT's when the
  5563.        same image is displayed for a long time.  To restore the display,
  5564.        just press the ESC key. (With the Windows version of Searchlight,
  5565.        you can install a Windows screen saver, or minimize the Searchlight
  5566.        window, to prevent burn-in).
  5567.  
  5568.  
  5569.         -------------------------------------------------------------------
  5570.        | COMMAND LINE PARAMETERS                                           |
  5571.         -------------------------------------------------------------------
  5572.  
  5573.        Normally, you type the command "SLBBS" or "SLBBS32" from the command
  5574.        prompt to load Searchlight BBS, initialize the modem, and begin
  5575.        waiting for a call.  However, under certain circumstances you may
  5576.        wish to bypass the modem initialization and make a direct connection
  5577.        at a specified baud rate.  Searchlight provides command parameters
  5578.        to allow you to do this. The complete syntax is:
  5579.  
  5580.             SLBBS <BaudRate> <TimeLimit> [/C] [-uUsername] [-pPassword]
  5581.  
  5582.        To start Searchlight with a specific baud rate, just type the baud
  5583.        rate on the command line after SLBBS; for example, "SLBBS 2400" to
  5584.        start the system up at 2400 baud, bypassing the modem init string.
  5585.        If you want to connect to a remote terminal but don't know the baud
  5586.        rate, enter "SLBBS K". This will cause Searchlight to connect and
  5587.        begin sampling keyboard input to determine the proper baud rate --
  5588.  
  5589.        _____________________________________________________________________
  5590.                                         78
  5591.                             STARTUP, LOGIN & NEW USERS
  5592.        _____________________________________________________________________
  5593.  
  5594.        hit the ENTER key on the remote end a few times to establish a
  5595.        connection. A local login can be initiated with "SLBBS Local" or
  5596.        "SLBBS L".
  5597.  
  5598.        Command line parameters are useful for two reasons: to allow an
  5599.        external "front end" program to answer the phone, and to make direct
  5600.        connections without using a modem. In the first case, a separate
  5601.        program runs before Searchlight, monitors the phone, and makes a
  5602.        connection. Then, this program calls Searchlight, passing it the
  5603.        baud rate so that Searchlight can make a direct connection without
  5604.        resetting the modem.
  5605.  
  5606.        A direct connection involves connecting two computers or a computer
  5607.        and a terminal together with RS232 cables and "Null" modem
  5608.        connectors. To establish a direct connection, without requiring a
  5609.        modem to be present, simply give the desired baud rate on the
  5610.        command line when starting Searchlight.
  5611.  
  5612.        When passing a baud rate on the command line, you'll usually want to
  5613.        follow it with a time limit. The time limit, expressed as a number
  5614.        of minutes, specifies the maximum amount of time that may expire
  5615.        during that session. The /C parameter forces carrier checking. As an
  5616.        example, the command
  5617.  
  5618.             SLBBS 2400 30 /C
  5619.  
  5620.        will load Searchlight at 2400 baud, limit the session to a maximum of
  5621.        30 minutes, and force the system to check for carrier. The session
  5622.        time limit is useful if your front-end program needs to execute some
  5623.        event at a certain time, since it will ensure that Searchlight will
  5624.        return to the front end program in time for the event. It is
  5625.        recommended that the /C parameter be used under normal conditions
  5626.        when calling SLBBS from a front end program; omit it when a direct
  5627.        (modemless) connection is being used.
  5628.  
  5629.        Parameters -U and -P let you provide a username and password to
  5630.        Searchlight.  When a username and/or password are provided in this
  5631.        way, Searchlight skips its usual "Enter your name" and "Password"
  5632.        prompts. Of course, the name given must match a valid username in
  5633.        your system and the password must be valid. Otherwise, a "Name not
  5634.        on file" or "Invalid password" message will appear (followed by
  5635.        prompts for the correct information).
  5636.  
  5637.        Note: If you use the /C, -U or -P parameters, you must specify a
  5638.              baud rate and time limit first. Use "L" or "Local" for the
  5639.              baud rate if you're doing a local connection; use "1440" for
  5640.              the time limit if you don't need to limit the session time to
  5641.              any particular length.
  5642.  
  5643.        If you wish to use the ALT-X hot key in conjunction with a front end
  5644.        program, your front end program should exit to DOS if Searchlight
  5645.        returns a nonzero error code (which it will do when ALT-X is
  5646.        pressed). An error code of 0 indicates a successful run.
  5647.  
  5648.        _____________________________________________________________________
  5649.                                         79
  5650.                             STARTUP, LOGIN & NEW USERS
  5651.        _____________________________________________________________________
  5652.  
  5653.        Finally, notice that if you have General Setup #2 option #4 (Return
  5654.        to DOS on Logoff) set to "Yes", then the only way to get Searchlight
  5655.        to run is to call it with a command parameter! Otherwise, the system
  5656.        will simply exit, expecting a host to regain control of the line.
  5657.  
  5658.  
  5659.         -------------------------------------------------------------------
  5660.        | ADDING NEW USERS                                                  |
  5661.         -------------------------------------------------------------------
  5662.  
  5663.        New usernames and passwords are added to Searchlight BBS by typing
  5664.        NEW in response to the login prompt. In order to use this facility,
  5665.        you must have the "Allow New Users" option (in the CONFIG program)
  5666.        set to "Yes".
  5667.  
  5668.        Typing NEW will present the New User menu, which looks like this:
  5669.  
  5670.             [R] ... Register as a New User
  5671.             [G] ... Enter the system as a GUEST
  5672.             [C] ... Call the SYSOP to Chat
  5673.             [E] ... Re-Enter your Name
  5674.             [D] ... Disconnect (Hang Up)
  5675.  
  5676.             Command ->_
  5677.  
  5678.        To register his or her name in the user database, a new user would
  5679.        press the "R" key to access the Register option.  Searchlight will
  5680.  
  5681.             * Display the new user message (NEWUSER.TXT), if it exists;
  5682.             * Prompt the user for their name, location, phone number,
  5683.               system type, and password;
  5684.             * Enter the user's info into the Searchlight database;
  5685.             * Execute the New User Autodoor, if one is defined;
  5686.             * Log the user in to the BBS system.
  5687.  
  5688.        New user information is entered via an easy to use, full-screen input
  5689.        system that works like the system you used to enter and edit
  5690.        information in the CONFIG program. Users can edit data and change
  5691.        fields with the standard cursor and editing keys (check the Text
  5692.        Editing section of this manual for a full description of
  5693.        Searchlight's editing functions).
  5694.  
  5695.        A new user is given initial access levels and time limit as defined
  5696.        in the CONFIG file. Duplicate user names or blank passwords are not
  5697.        allowed. If the new user tries to enter a name that already exists
  5698.        in the user file, or does not fill in a password, a warning message
  5699.        is printed. The user may re-enter the bad data or return to the New
  5700.        User menu.
  5701.  
  5702.  
  5703.  
  5704.  
  5705.  
  5706.  
  5707.        _____________________________________________________________________
  5708.                                         80
  5709.                             STARTUP, LOGIN & NEW USERS
  5710.        _____________________________________________________________________
  5711.  
  5712.  
  5713.        ----------------------
  5714.        Other New User Options
  5715.        ----------------------
  5716.  
  5717.        The "C" option will issue a page to the Sysop, if the "Sysop
  5718.        Available" (ALT-A) flag is set. You can answer the page by pressing
  5719.        any key at the keyboard; after you're done chatting, press the ESC
  5720.        key to exit from chat mode. You may notice that the tone emitted
  5721.        from the speaker by the CHAT command is lower than usual when a new
  5722.        or nonvalidated user is paging. Thus, you can discern a new user's
  5723.        page without having to look at the screen.
  5724.  
  5725.        An "E" option is provided to allow re-entry of your name. If the
  5726.        "NEW" command is selected in error, typing "E" will return you to
  5727.        the original "Enter Your Name" prompt. Finally, a disconnect option,
  5728.        "D", will disconnect the remote user and recycle the system back to
  5729.        the call waiting screen.
  5730.  
  5731.  
  5732.        -------------
  5733.        Guest Account
  5734.        -------------
  5735.  
  5736.        Searchlight provides a default account called GUEST, which is
  5737.        designed for people who want to use your BBS once or twice but do
  5738.        not wish to establish a password for themselves. New users can log
  5739.        on as GUEST either by typing "G" at the New User menu, or by typing
  5740.        GUEST directly at the login name prompt.
  5741.  
  5742.        You can provide the GUEST account with any access level, security
  5743.        attributes, time limits, and other attributes you choose. GUEST
  5744.        users cannot change their own user information or preferences.
  5745.  
  5746.        The GUEST account may be deleted if you do not wish to allow this
  5747.        form of access to your BBS. GUEST can be restored later by
  5748.        re-entering the GUEST name as a new user; after doing so, remove the
  5749.        GUEST account's password via the Options command on the main menu
  5750.        (enter a blank space in the Password field).
  5751.  
  5752.  
  5753.  
  5754.  
  5755.  
  5756.  
  5757.  
  5758.  
  5759.  
  5760.  
  5761.  
  5762.  
  5763.  
  5764.  
  5765.  
  5766.        _____________________________________________________________________
  5767.                                         81
  5768.                              CONFIGURING USER OPTIONS
  5769.        _____________________________________________________________________
  5770.  
  5771.  
  5772.         -------------------------------------------------------------------
  5773.        | CONFIGURING USER OPTIONS                                          |
  5774.         -------------------------------------------------------------------
  5775.  
  5776.        When new users register with your BBS, Searchlight prompts them to
  5777.        enter a name, location, computer type, phone number, and password.
  5778.        These items, in addition to some others, can be changed by the user
  5779.        at any time by using the Options command on Searchlight's main menu
  5780.        .
  5781.  
  5782.        When Options is executed, it displays a screen like this:
  5783.  
  5784.             Info  Preference  Stats  Access  Quit  [?=Help]
  5785.  
  5786.        Each selection displays and/or allows you to edit various aspects of
  5787.        the user account. The "Access" setting controls user security
  5788.        levels, and is available only to Sysop level accounts.
  5789.  
  5790.  
  5791.         -------------------------------------------------------------------
  5792.        | USER/INFO                                                         |
  5793.         -------------------------------------------------------------------
  5794.  
  5795.             1. Location ......... Winchester, VA
  5796.             2. System Type ...... IBM 486
  5797.             3. Phone No. ........ 540-555-1212
  5798.             4. Password ......... <not shown>
  5799.             5. Alias Name ....... THE GIPPER
  5800.             6. Netmail Address ..
  5801.  
  5802.        This selection controls demographic information about the user, and
  5803.        the user's password. Field numbers 1 through 4 can be adjusted by
  5804.        all callers; fields 5 and 6 may be protected depending on the system
  5805.        configuration. In ANSI modes, use the cursor keys to highlight and
  5806.        edit the desired data; in non-ANSI, a prompt appears and you can
  5807.        type the field number to change, then the new data.
  5808.  
  5809.  
  5810.        -----------------------------------------
  5811.        1 to 3 - Location, System Type, Phone No.
  5812.        -----------------------------------------
  5813.  
  5814.        These fields allow you to enter the described information. Location
  5815.        and System Type can be any alphanumeric characters, and are
  5816.        displayed along with your name in user lists and searches. The phone
  5817.        number field is strictly confidential and can be viewed only by the
  5818.        Sysop.
  5819.  
  5820.  
  5821.  
  5822.  
  5823.  
  5824.  
  5825.        _____________________________________________________________________
  5826.                                         82
  5827.                              CONFIGURING USER OPTIONS
  5828.        _____________________________________________________________________
  5829.  
  5830.  
  5831.        ------------
  5832.        4 - Password
  5833.        ------------
  5834.  
  5835.        This field lets you enter a new password. For the sake of security,
  5836.        existing passwords are not shown, and dots are displayed when typing
  5837.        a new password.  To change your password, type the new password over
  5838.        the "<not shown>" message. When you exit the Options command,
  5839.        Searchlight will ask you to verify the password by typing it again
  5840.        (if you mistype a password, the old password will not be changed).
  5841.  
  5842.  
  5843.        --------------
  5844.        5 - Alias Name
  5845.        --------------
  5846.  
  5847.        This field shows the user's alias name, if one is defined. For more
  5848.        information about alias names, refer to the section "Alias Names."
  5849.  
  5850.        Field 5 may be labeled as a "read-only" field if Searchlight is
  5851.        configured so that a security level is required to change an alias
  5852.        name. See the section "Function Attribute Setup" for more
  5853.        information.
  5854.  
  5855.  
  5856.        -------------------
  5857.        6 - Netmail Address
  5858.        -------------------
  5859.  
  5860.        This field contains the user's netmail routing address, if one is
  5861.        defined.  For more information about this topic, refer to the
  5862.        section "Netmail - Creating Netmail Routing Addresses."
  5863.  
  5864.  
  5865.  
  5866.  
  5867.  
  5868.  
  5869.  
  5870.  
  5871.  
  5872.  
  5873.  
  5874.  
  5875.  
  5876.  
  5877.  
  5878.  
  5879.  
  5880.  
  5881.  
  5882.  
  5883.  
  5884.        _____________________________________________________________________
  5885.                                         83
  5886.                              CONFIGURING USER OPTIONS
  5887.        _____________________________________________________________________
  5888.  
  5889.  
  5890.         -------------------------------------------------------------------
  5891.        | USER/PREFERENCE                                                   |
  5892.         -------------------------------------------------------------------
  5893.  
  5894.              1. Help Level ................ Novice
  5895.              2. ANSI Compatibility ........ Generic
  5896.              3. Screen Length ............. 24
  5897.              4. File List Format .......... Prompt
  5898.              5. Pause Between Messages .... Yes
  5899.              6. Conf Disposition Prompts .. On
  5900.              7. Mail Disposition Prompts .. On
  5901.              8. Internal Protocol ......... Zmodem
  5902.              9. Preference Attributes .....
  5903.             10. RIP Text Font ............. Normal
  5904.             11. Download RIP Menus ........ Yes
  5905.  
  5906.        These fields display and edit user-controlled preferences. Each
  5907.        caller can set his or her own preferences in these fields, in order
  5908.        to modify Searchlight's behavior.
  5909.  
  5910.  
  5911.        --------------
  5912.        1 - Help Level
  5913.        --------------
  5914.  
  5915.        Possible values for this field are Novice, Intermediate and Expert.
  5916.        In Novice mode, Searchlight displays the main command menu after
  5917.        each command, provides verbose descriptions of menu selections, and
  5918.        shows additional help text at several points in the system.
  5919.        Intermediate mode is similar to Novice mode, but does not provide
  5920.        the automatic main menu display or the NOVICE.TXT help file at
  5921.        login. In Expert mode, all help messages and menus are suppressed
  5922.        (but you can always display help and menus on demand with the F1 or
  5923.        ? keys).
  5924.  
  5925.        Note: The actual behavior of these modes is determined by each menu
  5926.              in Searchlight, and can be changed by using the menu editing
  5927.              features. You can also create new menus or modify menu
  5928.              commands based on the help level switch.
  5929.  
  5930.  
  5931.        ----------------------
  5932.        2 - ANSI Compatibility
  5933.        ----------------------
  5934.  
  5935.        This field can be set to Generic, Procomm, or Full, and configures
  5936.        the Searchlight full-screen text editor for use with different types
  5937.        of ANSI terminals: Generic for minimally-compatible terminals,
  5938.        Procomm for the Procomm or Telix terminal software, and Full for
  5939.        fully capable ANSI terminals or terminal emulators. See the Text
  5940.        Editing section of this manual for further information.
  5941.  
  5942.  
  5943.        _____________________________________________________________________
  5944.                                         84
  5945.                              CONFIGURING USER OPTIONS
  5946.        _____________________________________________________________________
  5947.  
  5948.  
  5949.        -----------------
  5950.        3 - Screen Length
  5951.        -----------------
  5952.  
  5953.        This field describes the length in lines of the remote user's screen,
  5954.        and is used for placement of the "more" message during text output.
  5955.        If Screen Length is set to zero, "more" prompting is disabled.
  5956.  
  5957.        Note: The maximum supported screen length is 24. We recommend that
  5958.              you use Searchlight only with terminal software that supports
  5959.              a 24 line screen.
  5960.  
  5961.  
  5962.        --------------------
  5963.        4 - File List Format
  5964.        --------------------
  5965.  
  5966.        This option controls the display of long file descriptions in the
  5967.        Files system. If set to "Long", Searchlight always displays long
  5968.        file descriptions with the Files and New commands in the Files
  5969.        program. If set to "Short", the Files system always displays short
  5970.        listings. If set to "Prompt", the Files program will prompt you as
  5971.        to whether you want long descriptions displayed at the beginning of
  5972.        each command that displays descriptions.
  5973.  
  5974.  
  5975.        --------------------------
  5976.        5 - Pause Between Messages
  5977.        --------------------------
  5978.  
  5979.        This option defines whether Searchlight stops between messages (i.e.
  5980.        displays the message disposition prompts) when reading messages. The
  5981.        default setting is "Prompt", which means that you are prompted with
  5982.        "Pause Between Messages?" each time you read messages or mail.
  5983.  
  5984.        Change this setting to "Yes" if you wish to avoid the "Pause Between
  5985.        Messages?" question, and always see disposition prompts between
  5986.        messages.  Select "No" if you wish to have a non-prompted message
  5987.        read by default.
  5988.  
  5989.  
  5990.        ----------------------------------
  5991.        6 - Conference Disposition Prompts
  5992.        7 - Mail Disposition Prompts
  5993.        ----------------------------------
  5994.  
  5995.        These options determine whether the conference and mail disposition
  5996.        prompts (the "coNtinue, Post, Unmark" prompts) appear after reading
  5997.        conferences or mail.
  5998.  
  5999.  
  6000.  
  6001.  
  6002.        _____________________________________________________________________
  6003.                                         85
  6004.                              CONFIGURING USER OPTIONS
  6005.        _____________________________________________________________________
  6006.  
  6007.  
  6008.        ---------------------
  6009.        8 - Internal Protocol
  6010.        ---------------------
  6011.  
  6012.        This field allows each caller to select a default internal protocol
  6013.        (internal protocols are those file transfer protocols that
  6014.        Searchlight provides internally). The internal protocol is used as
  6015.        the default for operations like message and thread downloading,
  6016.        which require an internal protocol.
  6017.  
  6018.  
  6019.        -------------------------
  6020.        9 - Preference Attributes
  6021.        -------------------------
  6022.  
  6023.        This field contains a series of user-selectable attributes that work
  6024.        in conjunction with Searchlight's menu system to allow users to
  6025.        choose between different menu systems. See the Menu Editing
  6026.        information later in this manual for details.
  6027.  
  6028.  
  6029.        ------------------
  6030.        10 - RIP Text Font
  6031.        ------------------
  6032.  
  6033.        In RIP mode, callers can select the Normal or Large RIP font for use
  6034.        when reading messages, editing messages and browsing file listings.
  6035.        Normal displays 25 lines of text per screen using a compressed font;
  6036.        Large uses a larger font but only displays 14 lines per screen. RIP
  6037.        Text Font is used only in RIP mode.
  6038.  
  6039.  
  6040.        -----------------------
  6041.        11 - Download RIP Menus
  6042.        -----------------------
  6043.  
  6044.        This setting allows a user to choose whether Searchlight will use
  6045.        automatic RIP downloading to store menus, icons and other RIP
  6046.        elements on the user's local hard drive. In general, RIP downloading
  6047.        should be enabled as it provides better performance. Users can
  6048.        disable RIP downloading if they have a specific reason to avoid it
  6049.        (for example, if the user's terminal does not support downloading or
  6050.        if the user does not wish Searchlight to store files on their local
  6051.        hard disk).
  6052.  
  6053.        For more information about RIP downloading, see the section "RIP
  6054.        Graphics - Automatic RIP Downloading."
  6055.  
  6056.  
  6057.  
  6058.  
  6059.  
  6060.  
  6061.        _____________________________________________________________________
  6062.                                         86
  6063.                              CONFIGURING USER OPTIONS
  6064.        _____________________________________________________________________
  6065.  
  6066.  
  6067.         -------------------------------------------------------------------
  6068.        | USER/STATS                                                        |
  6069.         -------------------------------------------------------------------
  6070.  
  6071.        This selection displays non-modifiable account statistics, as
  6072.        follows:
  6073.  
  6074.         Stats for SYSOP
  6075.  
  6076.          First Logon: 10-08-90   BBS Access  : 255    Kb Uploaded  :  1117
  6077.          Last Logon : 11-19-92   Files Access: 255    Kb Downloaded:  2023
  6078.          Total Calls: 4414       Time Limit  : 1440   Xfer Protocol: Xmodem
  6079.                           Security Attributes: ALL
  6080.  
  6081.  
  6082.         -------------------------------------------------------------------
  6083.        | SYSOP-CONFIGURABLE SETTINGS                                       |
  6084.         -------------------------------------------------------------------
  6085.  
  6086.        In addition to the user-configurable options, there are additional
  6087.        data fields associated with each user record that may be accessed
  6088.        only by Sysop or CoSysop level users. These fields store the user's
  6089.        access levels, time limit, and other information. To view and/or
  6090.        change these protected values, you must log in as the Sysop, execute
  6091.        the "2-Sysop" main menu command, select "Options" from the menu bar,
  6092.        and type in the name of the user who's options you want to look at.
  6093.        Then pick "Access" from the menu bar.
  6094.  
  6095.  
  6096.         -------------------------------------------------------------------
  6097.        | USER/ACCESS                                                       |
  6098.         -------------------------------------------------------------------
  6099.  
  6100.             1. Security Attributes .... ABCDEFG
  6101.             2. BBS Access Level ....... 255
  6102.             3. Files Access Level ..... 255
  6103.             4. Daily Time Limit ....... 1440
  6104.             5. Session Time Limit ..... 1440
  6105.             6. Time Left Today ........ 1440
  6106.             7. Expiration Date ........ 0-00-00
  6107.             8. Credits ................ 100
  6108.             8. Download/Upload Ratio .. 3
  6109.             9. Mail Logging ........... Off
  6110.  
  6111.  
  6112.        -----------------------
  6113.        1 - Security Attributes
  6114.        -----------------------
  6115.  
  6116.        This field defines which of the 24 security attributes is associated
  6117.        with the user. Security attributes control a user's access to
  6118.        conferences, file areas, and other functions on the BBS. In order to
  6119.  
  6120.        _____________________________________________________________________
  6121.                                         87
  6122.                              CONFIGURING USER OPTIONS
  6123.        _____________________________________________________________________
  6124.  
  6125.        access a secure feature, a user must have all of the attributes
  6126.        associated with that feature, in addition to meeting an access level
  6127.        requirement if there is one.
  6128.  
  6129.        You can specify security attributes either by typing the letters A to
  6130.        X, by typing subranges (such as A-D or G-P), or by typing the word
  6131.        ALL to indicate all security attributes.
  6132.  
  6133.  
  6134.        -------------------------------------
  6135.        2 and 3 - BBS and Files Access Levels
  6136.        -------------------------------------
  6137.  
  6138.        These numbers define the user's access levels for the main BBS and
  6139.        the Files systems. Basically, the function of the access level is to
  6140.        define which message conferences, file areas and menu choices a user
  6141.        may access.
  6142.  
  6143.        Normal access levels range from 0 to 253. Access level 254 designates
  6144.        a "CoSysop"; CoSysops have the power to access all message and file
  6145.        areas, edit or delete messages and files, and view or change the
  6146.        user accounts of other users with access levels of 239 or less.
  6147.        CoSysops cannot (for obvious reasons) change their own access level,
  6148.        or assign an access level of 240 or greater to any other user; they
  6149.        also are prevented from using the "2-Sysop/TextEdit" command,
  6150.        running Doors with access level 255, and downloading
  6151.        password-protected files (unless they know the password).
  6152.  
  6153.        Access level 255 defines the Sysop, who has ultimate power to perform
  6154.        all operations on the BBS without restriction.  Extreme care should
  6155.        be taken in allowing users other than yourself to have 255-level
  6156.        access, since such users have the capability to not only delete
  6157.        messages, files, and users from your system, but also to edit text
  6158.        files and possibly access DOS itself.. We recommend that you use
  6159.        access level 255 only for yourself, and give 254-access where
  6160.        necessary to CoSysops.
  6161.  
  6162.  
  6163.        --------------------
  6164.        4 - Daily Time Limit
  6165.        --------------------
  6166.  
  6167.        This field defines the amount of time per day (in minutes) that a
  6168.        user may access your system. Values from 1 to 1440 minutes may be
  6169.        entered.
  6170.  
  6171.        Note: Sysops and CoSysops are untimed, and may use the system for
  6172.              any amount of time regardless of the Time Limit value.
  6173.  
  6174.  
  6175.  
  6176.  
  6177.  
  6178.  
  6179.        _____________________________________________________________________
  6180.                                         88
  6181.                              CONFIGURING USER OPTIONS
  6182.        _____________________________________________________________________
  6183.  
  6184.  
  6185.        ----------------------
  6186.        5 - Session Time Limit
  6187.        ----------------------
  6188.  
  6189.        This field provides a per-session time limit. This is the maximum
  6190.        amount of time that a user will be allowed to spend on any
  6191.        particular login.
  6192.  
  6193.  
  6194.        -------------------
  6195.        6 - Time Left Today
  6196.        -------------------
  6197.  
  6198.        This value is the number of minutes left in the user's allocation for
  6199.        today; it's equal to the daily time limit minus the amount of time
  6200.        the user has been online since midnight. You can view or manually
  6201.        adjust this option.
  6202.  
  6203.  
  6204.        -------------------
  6205.        7 - Expiration Date
  6206.        -------------------
  6207.  
  6208.        An expiration date defines the date when a particular user loses
  6209.        certain access rights, and may define a date when that user record
  6210.        is deleted altogether.
  6211.  
  6212.        A couple of special values are available. First, you can set any
  6213.        expiration date to "00-00-00", indicating no expiration (the account
  6214.        will never expire). Secondly, if zero is specified as the "Days
  6215.        Until Expiration" in the default access level setup, then the
  6216.        special "00-00-00" date is assigned to the user account, exempting
  6217.        it from any expiration. You can also use the Mass Validate procedure
  6218.        in the Config program to specify these values.
  6219.  
  6220.        What Happens When An Account Expires? By default, nothing happens to
  6221.        a user account when it expires (i.e. when the current system date
  6222.        passes the expiration date specified for the user). If you don't
  6223.        wish to use expiration dates on your system, you do not need to make
  6224.        any modifications to your user files or default access levels;
  6225.        expiration date processing is turned "off" by default.
  6226.  
  6227.        To enable expiration dates so that they actually have an effect, go
  6228.        to line 14 on menu B in the CONFIG program. This switch can be set
  6229.        to one of three choices: "None", the default choice that does
  6230.        nothing; "Reset Access", and "Delete Account".
  6231.  
  6232.        If Reset Access is selected, Searchlight reduces the access level of
  6233.        an expired account to that of a new user (i.e. the first default
  6234.        access level choice) whenever that user tries to log in on a date
  6235.        that's past his expiration date. The user's expiration date itself
  6236.        is not changed. When the access level modification occurs, the user
  6237.  
  6238.        _____________________________________________________________________
  6239.                                         89
  6240.                              CONFIGURING USER OPTIONS
  6241.        _____________________________________________________________________
  6242.  
  6243.        is told of the change and will continue to be reminded of it at each
  6244.        subsequent login, until you modify their expiration date (either
  6245.        manually or via an access level upgrade).
  6246.  
  6247.        If Delete Account is selected, then accounts are simply deleted from
  6248.        the user file when they expire.
  6249.  
  6250.        Both Reset Access and Delete Account options supply a warning message
  6251.        for 30 days prior to the expiration of the account, giving users the
  6252.        opportunity to contact you about extending their access rights
  6253.        before their account is terminated or reset.
  6254.  
  6255.  
  6256.        -----------
  6257.        8 - Credits
  6258.        -----------
  6259.  
  6260.        This value is the user's credit balance. You can assign credits to a
  6261.        user and have Searchlight automatically deduct credits for spending
  6262.        time online, downloading files, or executing certain menu choices.
  6263.        Many system operators assign credits in exchange for monetary
  6264.        payment.
  6265.  
  6266.  
  6267.        -------------------------
  6268.        9 - Download/Upload Ratio
  6269.        -------------------------
  6270.  
  6271.        This field defines the user's Download to Upload ratio. If, for
  6272.        example, a value of "3" is entered, it indicates that the user may
  6273.        download 3 Kbytes worth of files for every 1 Kbyte uploaded. If an
  6274.        attempt to download more than this amount is made, the Files program
  6275.        will not allow the download to proceed until the user has uploaded
  6276.        additional file(s).
  6277.  
  6278.        This field is initially set to the Default DL/UL Ratio entered in the
  6279.        CONFIG program, but may be changed for each user in the system.
  6280.  
  6281.        A DL/UL ratio value of 0 indicates that no ratio is to be enforced.
  6282.  
  6283.  
  6284.        -----------------
  6285.        10 - Mail Logging
  6286.        -----------------
  6287.  
  6288.        This switch activates Searchlight's Mail Logging feature. When turned
  6289.        On, Searchlight will generate a log (text file) containing the
  6290.        headers and text of all mail received and sent by a particular user.
  6291.        Each user's mail is stored in a separate file; the filename is
  6292.        generated by a concatenation of the user's name (for example,
  6293.        SYSOP.LOG or MSMITH.LOG).
  6294.  
  6295.  
  6296.  
  6297.        _____________________________________________________________________
  6298.                                         90
  6299.                              CONFIGURING USER OPTIONS
  6300.        _____________________________________________________________________
  6301.  
  6302.        Mail files are stored in the directory specified as the "Mail Files
  6303.        Path" in the CONFIG program (or in the current directory if no Mail
  6304.        Files Path is specified).
  6305.  
  6306.        Mail log files are intended for your own use in archiving your mail,
  6307.        and should be periodically compressed or moved offline to prevent
  6308.        the log files from growing unreasonably large. Searchlight doesn't
  6309.        truncate or otherwise manage these files in any way.
  6310.  
  6311.  
  6312.  
  6313.  
  6314.  
  6315.  
  6316.  
  6317.  
  6318.  
  6319.  
  6320.  
  6321.  
  6322.  
  6323.  
  6324.  
  6325.  
  6326.  
  6327.  
  6328.  
  6329.  
  6330.  
  6331.  
  6332.  
  6333.  
  6334.  
  6335.  
  6336.  
  6337.  
  6338.  
  6339.  
  6340.  
  6341.  
  6342.  
  6343.  
  6344.  
  6345.  
  6346.  
  6347.  
  6348.  
  6349.  
  6350.  
  6351.  
  6352.  
  6353.  
  6354.  
  6355.  
  6356.        _____________________________________________________________________
  6357.                                         91
  6358.                                   MESSAGE SYSTEM
  6359.        _____________________________________________________________________
  6360.  
  6361.  
  6362.         -------------------------------------------------------------------
  6363.        | SEARCHLIGHT MESSAGE SYSTEM                                        |
  6364.         -------------------------------------------------------------------
  6365.  
  6366.        The heart of Searchlight BBS is its public message system.
  6367.        Searchlight handles multiple conferences or subtopics, each of which
  6368.        can have any number of active messages. You can read existing
  6369.        messages, enter or "post" new ones, list the available conferences
  6370.        and available messages, and search for particular messages or for
  6371.        all new messages. In addition, messages can be replied to, edited,
  6372.        deleted, and copied to disk or to other message areas.  Finally, a
  6373.        powerful "Thread" command is included to allow related messages to
  6374.        be treated as a unit.
  6375.  
  6376.        In general, message base operations affect the currently active
  6377.        conference.  The "current" conference is the last conference jumped
  6378.        to (with the Jump, New, or List commands); its name is displayed to
  6379.        the left of the command prompt and in the upper right hand corner of
  6380.        the screen at most times. When you first log in, the current
  6381.        conference is either the last conference accessed during your
  6382.        previous login, or the first available conference.
  6383.  
  6384.        The databases that Searchlight BBS uses for conferences (and file
  6385.        directories) are compatible with Spinnaker, Searchlight's World Wide
  6386.        Web based conference system. For more information about using
  6387.        Spinnaker to create conferences and file areas on the Web, contact
  6388.        TeleGrafix.
  6389.  
  6390.        Note: Searchlight's Menu Editor makes it possible to change the
  6391.              names of commands and their placement on menus.  Throughout
  6392.              this manual, we use the command names that appear on the
  6393.              default menus that are included with Searchlight. You should
  6394.              be aware that if you change your menus, the exact screen
  6395.              display and key sequences used to access a particular
  6396.              function may be different than what is show in the manual,
  6397.              although commands themselves will function the same way
  6398.              regardless of how they are executed.
  6399.  
  6400.  
  6401.         -------------------------------------------------------------------
  6402.        | ENTERING MESSAGES: THE POST COMMAND                               |
  6403.         -------------------------------------------------------------------
  6404.  
  6405.        The Post command adds a new public message to the current conference.
  6406.        To use it, enter Post and type in the name of the recipient (or
  6407.        press Enter for the default "All"), and then a short title for the
  6408.        message. Then, you'll be placed into one of the system's message
  6409.        editors where you'll be able to enter the text of your message.
  6410.  
  6411.        If anonymous posting is enabled for the current conference, you'll
  6412.        be prompted as to whether you wish to post your message anonymously.
  6413.        Reply with Y or N as desired.
  6414.  
  6415.        _____________________________________________________________________
  6416.                                         92
  6417.                                   MESSAGE SYSTEM
  6418.        _____________________________________________________________________
  6419.  
  6420.        Use of the message editors (both a line editor and a full-screen
  6421.        editor are available) are discussed further later in the manual. It
  6422.        is possible to "import" text files into a message via several
  6423.        methods; this, too, is discussed later.
  6424.  
  6425.        When you save your message, it is added to the conference as the
  6426.        last available (highest-numbered) message. You can also post
  6427.        messages by replying to existing messages; this is discussed below.
  6428.  
  6429.  
  6430.         -------------------------------------------------------------------
  6431.        | RETRIEVING MESSAGES: THE READ COMMAND                             |
  6432.         -------------------------------------------------------------------
  6433.  
  6434.        There are a couple of ways to begin reading posted messages; the
  6435.        most straightforward of these is via the Read command.  To use it,
  6436.        enter Read, then give the message number of the message where you
  6437.        want to begin reading.  The Read command displays the message
  6438.        header, showing the subject, time, date, and person who posted the
  6439.        message, followed by the message text. If the text is longer than
  6440.        your "Screen Length" (set in user Options), a "More" is displayed
  6441.        every screenful. Press C to continue reading. At anytime, press the
  6442.        spacebar or ^C to abort a lengthy message.
  6443.  
  6444.        There is one additional prompt you may see displayed when you begin
  6445.        reading message and that is:
  6446.  
  6447.             Pause Between Messages? Yes/No
  6448.  
  6449.        Normally, select "Yes". After each message is displayed, the Read
  6450.        command presents a prompt such as this:
  6451.  
  6452.             Again  Reply  Mail  Prev  Next  Goto  Thread  Other  Quit
  6453.  
  6454.        In response, select the appropriate command depending on what you
  6455.        want to do next. You can select commands by pressing the first
  6456.        letter of the command you want, or by moving the menu bar to the
  6457.        desired command and pressing the ENTER key.
  6458.  
  6459.        If you do select "No" to the "Pause Between Messages" option,
  6460.        Searchlight skips the command prompt and displays messages
  6461.        continuously. This type of message dump is primarily of use to
  6462.        remote callers who will be capturing the text to a local buffer for
  6463.        later digestion.
  6464.  
  6465.        The Read command options are generally available anytime you're
  6466.        reading messages, whether via the Read command itself, the Mail
  6467.        command, or as part of a New message scan. Here's a summary:
  6468.  
  6469.  
  6470.  
  6471.  
  6472.  
  6473.  
  6474.        _____________________________________________________________________
  6475.                                         93
  6476.                                   MESSAGE SYSTEM
  6477.        _____________________________________________________________________
  6478.  
  6479.  
  6480.        ----------
  6481.        Read/Again
  6482.        ----------
  6483.  
  6484.        The "Again" option clears the screen and re-displays the last message
  6485.        read.  Use this option when you want to review a long message; it is
  6486.        also useful for redisplaying a message in case the message is
  6487.        garbled by line noise.
  6488.  
  6489.  
  6490.        ----------
  6491.        Read/Reply
  6492.        ----------
  6493.  
  6494.        This option lets you reply to the message you've just read. The reply
  6495.        is either a public message or a private (electronic mail) message
  6496.        depending on whether the message is public or private. Replying to a
  6497.        public message is similar to Posting a message, except that the
  6498.        reply contains additional information in the message header
  6499.        indicating that it's a reply.
  6500.  
  6501.        When replying to a message, the sender and subject of that message
  6502.        are displayed as default responses for the reply (the designator
  6503.        "Re:" may be added to the subject if it was not already present). If
  6504.        you want to use those defaults, just press Enter. To change them,
  6505.        type new information.
  6506.  
  6507.        After writing the reply, the current message is redisplayed.
  6508.  
  6509.  
  6510.        ---------
  6511.        Read/Mail
  6512.        ---------
  6513.  
  6514.        Sometimes you may wish to send a private reply to a public message;
  6515.        this option allows you to do so. Selecting Read/Mail is similar to
  6516.        Replying to a message, except that the reply is saved to the MAIL
  6517.        conference as a private reply rather than to the current conference
  6518.        as a public message.
  6519.  
  6520.  
  6521.        ---------
  6522.        Read/Prev
  6523.        ---------
  6524.  
  6525.        The "Previous" subcommand lets you read the preceding, or next
  6526.        lowest numbered, message. If there is no previous message, then the
  6527.        Read command exits.
  6528.  
  6529.  
  6530.  
  6531.  
  6532.  
  6533.        _____________________________________________________________________
  6534.                                         94
  6535.                                   MESSAGE SYSTEM
  6536.        _____________________________________________________________________
  6537.  
  6538.  
  6539.        ---------
  6540.        Read/Next
  6541.        ---------
  6542.  
  6543.        The "Next" subcommand is used to proceed to the next message on the
  6544.        active conference. If there is no next message, the command exits.
  6545.  
  6546.        Note: With both the Next and Previous subcommands, if the messages
  6547.              being read are part of a set selected via a search string
  6548.              (Scan/Search command), or part of a message thread (see the
  6549.              Thread command below), then Next and Previous display the
  6550.              next or previous message in the set or thread being read,
  6551.              rather than the next or previous message in numerical order.
  6552.  
  6553.  
  6554.        ---------
  6555.        Read/Goto
  6556.        ---------
  6557.  
  6558.        The "Goto" command lets you ahead or skip backward to any message on
  6559.        the conference, by entering the desired message number.
  6560.  
  6561.  
  6562.        ---------
  6563.        Read/List
  6564.        ---------
  6565.  
  6566.        List replaces Goto in RIP graphics mode. This command allows you to
  6567.        view a list of messages in a scrollable window and move to the
  6568.        desired message with mouse movements or direction keys.
  6569.  
  6570.  
  6571.        -----------
  6572.        Read/Thread
  6573.        -----------
  6574.  
  6575.        You'll see this option on the menu if the message you're reading has
  6576.        been replied to, or is itself a reply to a previously posted
  6577.        message. What the Thread command does is to let you view some or all
  6578.        of the replies and original messages directly, ignoring
  6579.        (temporarily) other messages which are not part of that message
  6580.        "thread". This submenu appears when you use Thread:
  6581.  
  6582.             Next  Prev  Original  First  Quit
  6583.  
  6584.        To read the next or previous message in the thread, use N or P
  6585.        commands.  "Original" takes you directly to the message to which the
  6586.        current message is a reply; "First" brings you to the very top of
  6587.        the message thread (the first message about a particular topic).
  6588.        Threading is discussed in more depth on the following pages.
  6589.  
  6590.  
  6591.  
  6592.        _____________________________________________________________________
  6593.                                         95
  6594.                                   MESSAGE SYSTEM
  6595.        _____________________________________________________________________
  6596.  
  6597.  
  6598.        ----------
  6599.        Read/Other
  6600.        ----------
  6601.  
  6602.        This option presents a new menu of additional choices that are
  6603.        available, including:
  6604.  
  6605.          Download  Forward  Edit  Kill  Post  Chat  Validate  Options  Quit
  6606.  
  6607.  
  6608.        -------------------
  6609.        Read/Other/Download
  6610.        -------------------
  6611.  
  6612.        This function lets you download a message or a thread to your remote
  6613.        terminal, via one of the internal protocols. Select whether you wish
  6614.        to transfer the message or thread; then begin your download when
  6615.        prompted. See below for more information on global thread
  6616.        operations.
  6617.  
  6618.        Local use of the message "Download" commands is supported. Instead of
  6619.        sending the message to a remote user via a file transfer protocol,
  6620.        Searchlight saves the message as a file in your local node's home
  6621.        directory. The name of the file is the conference name plus the
  6622.        message number modulo 1000 -- for example, if you were logged on
  6623.        locally and "downloaded" message number 1292 from the GENERAL
  6624.        conference, it would be written to disk as a text file called
  6625.        GENERAL.292.  Note that the same naming convention is used for
  6626.        remote callers who select Zmodem as their default internal protocol
  6627.        for message uploads and downloads.
  6628.  
  6629.  
  6630.        ------------------
  6631.        Read/Other/Forward
  6632.        ------------------
  6633.  
  6634.        The "Forward" subcommand is used to forward a copy of the message you
  6635.        just read to another place on the bulletin board. In general,
  6636.        messages can be forwarded to a public message conference or to a
  6637.        particular user's mailbox; Sysops and Cosysops can also forward
  6638.        messages to Bulletins, and Sysops only can forward them to text
  6639.        files on disk. For public messages, the Forward command is available
  6640.        only to Sysops, cosysops, the conference subop, or the person who
  6641.        posted the message; private mail can be forwarded by the recipient
  6642.        of the message.
  6643.  
  6644.        Pressing "F" prompts you with one or more of the following:
  6645.  
  6646.           Forward to:  User  Conference  Bulletins  Disk  Clipboard  Quit
  6647.  
  6648.  
  6649.  
  6650.  
  6651.        _____________________________________________________________________
  6652.                                         96
  6653.                                   MESSAGE SYSTEM
  6654.        _____________________________________________________________________
  6655.  
  6656.        If you wish to forward the message to a public message board, press
  6657.        "S"; Searchlight will then prompt you to enter the name of the board
  6658.        you wish to use. To forward the message to a user, type "U"; you
  6659.        will then be prompted to enter the name of the user to whom you wish
  6660.        to send the message. "B" forwards the message to the Bulletins menu
  6661.        without further ado.
  6662.  
  6663.        The Clipboard option appears when you are using the Windows version
  6664.        of Searchlight BBS only. If selected, it copies your message to the
  6665.        windows clipboard. You can retrieve the message by pasting it into
  6666.        another program, such as notepad or a word processor.
  6667.  
  6668.        When forwarding a message, you have the option to add comments to
  6669.        the message. When you add comments, the result is a message which
  6670.        contains the text of the original message below a line of dashes,
  6671.        and your comments above that line.  Notice that if you choose to add
  6672.        comments, the resulting message contains your name and the time you
  6673.        entered your comments in its message header; otherwise, the
  6674.        message's original header is retained.
  6675.  
  6676.        Selecting Disk allows you to write the message directly to a text
  6677.        file on your disk. It will prompt you to enter the filename, which
  6678.        may include a drive letter or directory path. If the file exists,
  6679.        the message is appended to the end of the file, otherwise a new file
  6680.        is created. The Disk option is only available to Sysop level users.
  6681.  
  6682.  
  6683.        ---------------
  6684.        Read/Other/Edit
  6685.        ---------------
  6686.  
  6687.        This option lets you edit the message at hand. You can change both
  6688.        the header information and text. For more information, see the Edit
  6689.        main menu command.
  6690.  
  6691.  
  6692.        ---------------
  6693.        Read/Other/Kill
  6694.        ---------------
  6695.  
  6696.        This command deletes the current message, after verification.
  6697.  
  6698.        Kill and Edit subcommands are only available to Sysops, the
  6699.        conference Cosysop, or the person who posted the particular message.
  6700.  
  6701.  
  6702.        ---------------
  6703.        Read/Other/Post
  6704.        ---------------
  6705.  
  6706.        This option lets you post a new message on the current conference. If
  6707.        you are reading mail, this option appears as Send instead of Post,
  6708.        and lets you send a new mail message to another user.
  6709.  
  6710.        _____________________________________________________________________
  6711.                                         97
  6712.                                   MESSAGE SYSTEM
  6713.        _____________________________________________________________________
  6714.  
  6715.  
  6716.        ---------------
  6717.        Read/Other/Chat
  6718.        ---------------
  6719.  
  6720.        This command is available on multiuser systems. It lets you chat with
  6721.        other users without exiting from the Read command, or losing your
  6722.        place in the current message area.
  6723.  
  6724.  
  6725.        -------------------
  6726.        Read/Other/Validate
  6727.        -------------------
  6728.  
  6729.        This command lets you validate the sender of the message by assigning
  6730.        one of the default access levels set up in the CONFIG program. This
  6731.        is the same as 2-Sysop/Validate (see that command for more
  6732.        information).
  6733.  
  6734.  
  6735.        ------------------
  6736.        Read/Other/Options
  6737.        ------------------
  6738.  
  6739.        This command lets you edit a user's options screen, as with
  6740.        2-Sysop/Options.  Of course, this command and the Validate
  6741.        subcommand are available to Sysops only.
  6742.  
  6743.  
  6744.        ---------
  6745.        Read/Quit
  6746.        ---------
  6747.  
  6748.        Select this option when you wish to quit reading messages and exit
  6749.        back to the main system prompt.
  6750.  
  6751.        Note: Notice that in addition to being able to abort messages with
  6752.              ^C, you can type the first letter of one of the above
  6753.              subcommands while the message is being displayed, at the
  6754.              "More" prompt, or while the menu is being drawn on your
  6755.              screen. Searchlight will immediately stop and execute the
  6756.              desired command. This intelligent command type ahead feature
  6757.              works in most other situations, such as Mail, Bulletins, and
  6758.              conference lists, as well.
  6759.  
  6760.  
  6761.  
  6762.  
  6763.  
  6764.  
  6765.  
  6766.  
  6767.  
  6768.  
  6769.        _____________________________________________________________________
  6770.                                         98
  6771.                                   MESSAGE SYSTEM
  6772.        _____________________________________________________________________
  6773.  
  6774.  
  6775.         -------------------------------------------------------------------
  6776.        | READING MESSAGES IN RIP MODE                                      |
  6777.         -------------------------------------------------------------------
  6778.  
  6779.        If you use Searchlight in RIP graphics mode (either during a local
  6780.        login or during a remote session with a RIP compatible terminal),
  6781.        Searchlight presents messages with a full screen interface. Instead
  6782.        of a "More" prompt, Searchlight places text inside a window and lets
  6783.        you use scroll bars or cursor keys to browse through messages in
  6784.        either direction.
  6785.  
  6786.        All of the commands described above function in RIP mode the same way
  6787.        they do in non-RIP mode. Instead of waiting for a prompt, however,
  6788.        these options are presented as pushbuttons on your screen. To
  6789.        activate an option, click on its button with your mouse, or type the
  6790.        highlighted function key. Certain commands, such as the "Other"
  6791.        command, will pop up a list of options from which you may select.
  6792.  
  6793.        One feature that's available exclusively in RIP mode is the ability
  6794.        to view embedded graphics in messages. If a message contains
  6795.        embedded RIP commands, you'll see a small box labeled "RIP!" in the
  6796.        upper right hand portion of the screen.  To view the picture, click
  6797.        this button. Searchlight will clear the screen and display the RIP
  6798.        picture. Then click the "OK" button in the lower right hand corner
  6799.        (or hit Enter) to continue.
  6800.  
  6801.        Another RIP mode exclusive is the List command, which replaces Goto
  6802.        at the bottom of the text reader screen. List generates a list of
  6803.        messages in the current conference and allows you to choose a new
  6804.        message by browsing the list and double clicking on the desired
  6805.        message; use the scroll bars or direction keys if the message list
  6806.        is larger than a single screen. If desired, you can press Goto
  6807.        within the List screen and enter a particular message number.
  6808.  
  6809.  
  6810.         -------------------------------------------------------------------
  6811.        | MAIL/CONFERENCE DISPOSITION PROMPTS                               |
  6812.         -------------------------------------------------------------------
  6813.  
  6814.        A prompt is available whenever you exit from reading a public
  6815.        message conference or reading mail; it's called the Mail Disposition
  6816.        or Conference Disposition prompt. The choices are:
  6817.  
  6818.             Conference Disposition:  coNtinue  Post  Unmark
  6819.  
  6820.        The default choice here is "Continue". Notice that "N" is the hotkey
  6821.        for this choice; Searchlight permits a key other than the first key
  6822.        of a choice to be the hotkey. "Continue" simply exits back to the
  6823.        previous menu (if you were using a Read or Mail command) or
  6824.        continues to the next conference (if you were using a New command).
  6825.        If you read new messages on that conference, then your new message
  6826.        pointer is updated.
  6827.  
  6828.        _____________________________________________________________________
  6829.                                         99
  6830.                                   MESSAGE SYSTEM
  6831.        _____________________________________________________________________
  6832.  
  6833.        Unmark lets you exit a conference without updating your new message
  6834.        pointer for that conference (or without marking new mail messages as
  6835.        read), thus causing any new messages there to continue to appear in
  6836.        the next New message scan.  This can prove useful in a variety of
  6837.        circumstances; for example, you might wish to "browse" through the
  6838.        new messages on a conference with the intention of returning to them
  6839.        later for a more thorough reading and reply.  Selecting "Unmark"
  6840.        after the initial browse lets you do that without the need to
  6841.        remember a specific message number
  6842.  
  6843.        Continue automatically "joins" users to a conference if they were not
  6844.        already conference members. Joining and unjoining conferences can
  6845.        also be accomplished manually via 1-Member.
  6846.  
  6847.        Post lets you post a new message on the current conference. On Mail
  6848.        commands, Post is replaced with Send, which lets you send a mail
  6849.        message to any user.  Both commands appear only if the user has
  6850.        access to perform the associated action.
  6851.  
  6852.        Both conference and mail disposition prompts can be disabled on a
  6853.        user by user basis. The switch to turn these prompts on and off is
  6854.        located in the Options/Preference command. When the prompts are
  6855.        disabled, the default choice, "Continue", is executed.
  6856.  
  6857.  
  6858.         -------------------------------------------------------------------
  6859.        | USING THE THREAD COMMAND                                          |
  6860.         -------------------------------------------------------------------
  6861.  
  6862.        Message Threading is a powerful concept that lets you display and
  6863.        follow "threads" of message replies within a message area.
  6864.        Searchlight's Thread command is unique in that it gives you the
  6865.        option to read a thread from several different places. You can read
  6866.        forward or backwards through a thread, and use all of the regular
  6867.        message subcommands (Again, Reply, Forward, etc.) while reading a
  6868.        message thread.
  6869.  
  6870.        Selecting the Thread command after reading a message brings up a
  6871.        submenu with options Next, Prev, Original, First and Quit. You can
  6872.        begin reading the thread at the Next message, backward to the
  6873.        Previous message, from the Original message (relative to the current
  6874.        message) or the First message in the entire thread. A reply thread
  6875.        contains all the original messages leading up to the current message
  6876.        (including originals of the originals), and all replies to that
  6877.        message (again, including all replies-to-replies). Notice that as
  6878.        you read a thread, the Next and Previous commands now deliver the
  6879.        next or previous message in the thread being read. When you're done
  6880.        reading the last message in the thread, or you select Sequentl from
  6881.        the menu, you'll return back to the original message (the message
  6882.        you were reading when you first pressed "Thread").
  6883.  
  6884.  
  6885.  
  6886.  
  6887.        _____________________________________________________________________
  6888.                                         100
  6889.                                   MESSAGE SYSTEM
  6890.        _____________________________________________________________________
  6891.  
  6892.        Threading scans a chain of replies recursively; i.e. if a reply has
  6893.        replies, those additional replies are scanned, and so forth.
  6894.        Therefore, the message thread will not necessarily be in numerical
  6895.        or chronological order, but will list all replies to a message in
  6896.        sequential order right after that message.  Of course, only messages
  6897.        which were posted as replies to an original message (via the Reply
  6898.        message subcommand) can be considered as part of a thread.
  6899.  
  6900.        When reading a thread, Searchlight keeps track of which messages you
  6901.        have read. After exiting from the thread, when you continue reading
  6902.        messages in order, messages you've already looked at (as part of a
  6903.        previous thread command) are skipped. These message markers are
  6904.        cleared when you exit the Read command back to the main menu prompt.
  6905.        Although the previously read messages are skipped when using the
  6906.        Next command, you can back-up and read them again with the Previous
  6907.        command if desired.
  6908.  
  6909.        Threading is usually used when you read a message that has replies
  6910.        (as indicated in the message header) and you want to see those
  6911.        replies immediately, or when you're reading through a conference
  6912.        with a large number of messages and want to restrict yourself to
  6913.        reading only messages belonging to a particular topic.
  6914.  
  6915.  
  6916.        ------------------------
  6917.        Global Thread Operations
  6918.        ------------------------
  6919.  
  6920.        Searchlight features commands that allow you to treat a thread as a
  6921.        unit, and perform actions on all the messages in a thread (or a
  6922.        specific part of a thread) with a single command. In particular, you
  6923.        can forward, delete, or download and entire group of related
  6924.        messages.
  6925.  
  6926.        The ability to forward or delete more than just a single message is
  6927.        available only to the Sysop, a CoSysop, or the Conference Sysop of a
  6928.        particular message area. Downloading of threads is available to any
  6929.        user. Whenever you are reading a message and you activate the Kill,
  6930.        Forward or Download option from the message disposition menu (i.e.
  6931.        Other/Kill, Other/Forward or Other/Download), the following new
  6932.        prompt will appear:
  6933.  
  6934.             Message  Replies  Thread  Quit
  6935.  
  6936.        If you want to delete, forward or download only the one message you
  6937.        have just read, select the default choice, Message.
  6938.  
  6939.        If you want to include the current message, plus all of the direct
  6940.        replies to that message, select Replies. This choice is different
  6941.        from selecting the entire thread, because it does not include any
  6942.        messages previous to the current message, nor does it include later
  6943.        messages except those that were entered directly as replies to the
  6944.        current message.
  6945.  
  6946.        _____________________________________________________________________
  6947.                                         101
  6948.                                   MESSAGE SYSTEM
  6949.        _____________________________________________________________________
  6950.  
  6951.        Finally, the third choice, Thread, selects every message in the
  6952.        current message thread, starting at the top of the thread.
  6953.  
  6954.  
  6955.         -------------------------------------------------------------------
  6956.        | THE LIST AND JUMP COMMANDS                                        |
  6957.         -------------------------------------------------------------------
  6958.  
  6959.        Searchlight supports an unlimited number of independent message areas
  6960.        or conferences. To get a list of the message areas available, use
  6961.        the List command. When List is done displaying the available areas,
  6962.        it supplies a prompt that enables you to enter the area of your
  6963.        choice (by keying the area name). The selected area then becomes the
  6964.        active area, and you are able to read, scan, and post messages to
  6965.        that area. If you just hit ENTER, the active area is unchanged.
  6966.  
  6967.        In general, you do not need to type the entire conference name of the
  6968.        area you wish to access; in most cases, the first two or three
  6969.        letters of the area name will suffice. It is also possible to select
  6970.        a conference area by entering any combination of letters found in
  6971.        its area name; however, be sure to type in enough letters to avoid
  6972.        ambiguity, which can result in selecting the wrong conference.
  6973.  
  6974.        If you want to switch message areas without viewing the list of
  6975.        available areas first, use the Jump command.
  6976.  
  6977.        Note: By default, Searchlight displays all available message
  6978.              conferences in alphabetical order when the List command is
  6979.              used. However, you can change the list order and contents by
  6980.              specifying a text file called MAIN.DIR. For more information,
  6981.              see the section "Directory Maintenance - Custom Ordering."
  6982.  
  6983.        Note: In RIP mode, Searchlight presents the conference list as a
  6984.              scrollable window. To select a conference, double click on the
  6985.              desired conference name or move the highlight bar and press
  6986.              Enter. You can move quickly through the conference list with
  6987.              the scroll bar or by typing the first few letters of the
  6988.              desired conference name.
  6989.  
  6990.  
  6991.         -------------------------------------------------------------------
  6992.        | REVIEWING MESSAGES: THE SCAN COMMAND                              |
  6993.         -------------------------------------------------------------------
  6994.  
  6995.        While the Read command is versatile, Searchlight provides additional
  6996.        commands that give you a brief summary of the messages on a
  6997.        conference, allow you to search for particular messages, and allow
  6998.        you to check for new messages posted since the last message you've
  6999.        read.
  7000.  
  7001.  
  7002.  
  7003.  
  7004.  
  7005.        _____________________________________________________________________
  7006.                                         102
  7007.                                   MESSAGE SYSTEM
  7008.        _____________________________________________________________________
  7009.  
  7010.        Use the Scan command to list or search the current message area.
  7011.        Scan presents a submenu with these options:
  7012.  
  7013.             Forward  Reverse  Search  Personal  Quit
  7014.  
  7015.        To list messages in ascending order, hit Forward; to display them in
  7016.        the opposite order, use Reverse. The listing shows the message
  7017.        number, date, person posting the message, and the message title for
  7018.        each message. You can abort the listing early with ^C.
  7019.  
  7020.        The Search option operates a little bit differently; it allows you to
  7021.        find specific messages by giving a search string. For a quick
  7022.        search, the search string you type can match any part of a message's
  7023.        title or a sender's name; you can also search the entire message
  7024.        (text as well as header information).  After selecting Search, you
  7025.        will be prompted with:
  7026.  
  7027.             Enter Search Key:
  7028.             >
  7029.  
  7030.        Enter the text for which you wish to search. The search is always
  7031.        case insensitive (all combinations of upper and lowercase will
  7032.        match). Next, you will see:
  7033.  
  7034.             Search Text of Messages? Yes/No
  7035.  
  7036.        If you choose "Yes", Searchlight will search the headers and text of
  7037.        all messages for your search string. If you want to search only for
  7038.        messages from a particular author or about a particular subject, you
  7039.        can answer with "No", and search only the message headers. A
  7040.        header-only search takes much less time than a full-text search. You
  7041.        can abort the search at any time by pressing ^C.
  7042.  
  7043.        The Personal subcommand searches the current conference for messages
  7044.        which are addressed to you. Note that the personal search can only
  7045.        find messages which were posted after you joined the current
  7046.        conference (and it will not work at all if you haven't joined the
  7047.        conference).
  7048.  
  7049.        After a successful search, this prompt will appear:
  7050.  
  7051.             Read Matching Messages? Yes/No
  7052.  
  7053.        If you press Y, you'll be transferred to the Read command, where
  7054.        you'll be able to read the first of the matching message.  When you
  7055.        use the Next and Previous subcommands on the message menu,
  7056.        Searchlight will display the next or previous message in the list of
  7057.        messages matching your search string, rather than the next or
  7058.        previous messages in numerical order.  Thus, you can easily view
  7059.        some or all of the messages you've searched for without having to
  7060.        key in the individual message numbers.
  7061.  
  7062.  
  7063.  
  7064.        _____________________________________________________________________
  7065.                                         103
  7066.                                   MESSAGE SYSTEM
  7067.        _____________________________________________________________________
  7068.  
  7069.        Note: In RIP graphics mode, Searchlight displays the results of the
  7070.              Scan command as a scrollable list. Use the mouse, scrollbar or
  7071.              direction keys to browse through this list. If you want to
  7072.              read a particular message, double click on the message or
  7073.              position the highlight bar on the desired message and press
  7074.              Enter.
  7075.  
  7076.  
  7077.         -------------------------------------------------------------------
  7078.        | FINDING NEW MESSAGES: THE NEW COMMAND                             |
  7079.         -------------------------------------------------------------------
  7080.  
  7081.        Searchlight provides a powerful New command that can automatically
  7082.        take you to new messages each time you log on to your BBS. The New
  7083.        command uses the high message pointer that's saved in each
  7084.        conference member file (when you Join that conference) and
  7085.        accurately finds all new messages, regardless of the date you last
  7086.        logged in.
  7087.  
  7088.        To begin the new message scan, enter the New command. These
  7089.        suboptions appear:
  7090.  
  7091.             All  Joined  Conference  Personal  Quit
  7092.  
  7093.        Here's a rundown of the New subcommands:
  7094.  
  7095.  
  7096.        -------
  7097.        New/All
  7098.        -------
  7099.  
  7100.        This function scans for new messages on all available, conferences,
  7101.        whether or not you are a member of the conference.  Because
  7102.        Searchlight BBS only keeps a new message pointer for conferences in
  7103.        which you are a member, any non- member conferences will indicate
  7104.        that all the messages on the conference are new; however, you will
  7105.        have an opportunity to join these conferences as you encounter them,
  7106.        and start reading at a later message if you wish.
  7107.  
  7108.        New/All is the recommended command for new callers to use in order
  7109.        to familiarize themselves with your BBS and "tour" the message areas
  7110.        available to them.
  7111.  
  7112.  
  7113.        ----------
  7114.        New/Joined
  7115.        ----------
  7116.  
  7117.        This command scans for new messages only on conferences which you
  7118.        have joined, skipping those in which you are not a member.
  7119.  
  7120.        Experienced callers can use this command to selectively read those
  7121.        conferences on your BBS that interest them while ignoring others. All
  7122.  
  7123.        _____________________________________________________________________
  7124.                                         104
  7125.                                   MESSAGE SYSTEM
  7126.        _____________________________________________________________________
  7127.  
  7128.        that is required is that users join those conferences which they are
  7129.        interested in, and not join (or unjoin) the others (we'll explain
  7130.        how to join and unjoin conferences in a moment).
  7131.  
  7132.  
  7133.        --------------
  7134.        New/Conference
  7135.        --------------
  7136.  
  7137.        This command performs a new message scan only on the current
  7138.        conference.  Searchlight lists the new messages on the conference,
  7139.        then allows you to read them.
  7140.  
  7141.  
  7142.        ------------
  7143.        New/Personal
  7144.        ------------
  7145.  
  7146.        The personal subfunction lets you scan either the current conference,
  7147.        or the entire BBS, for new messages that are addressed specifically
  7148.        to you.  New/Personal is similar to Scan/Personal, except that it
  7149.        scans only new messages, and gives you a choice to scan either the
  7150.        current conference or all conferences.
  7151.  
  7152.  
  7153.        ------------------------------
  7154.        Conference Navigation with New
  7155.        ------------------------------
  7156.  
  7157.        The global New functions (those that scan for new messages on all
  7158.        conferences) provide several options for reading messages. At each
  7159.        conference in which new messages exist, you'll see the conference
  7160.        name and (except in the case of personal scans) the number of new
  7161.        messages available.  Following this, another menu choice appears:
  7162.  
  7163.             Read  Goto  Next  Join  (Unjoin)  Quit
  7164.  
  7165.        Here, select the appropriate choice depending on what you wish to do
  7166.        about reading the new messages on that conference.
  7167.  
  7168.  
  7169.        ----
  7170.        Read
  7171.        ----
  7172.  
  7173.        If you select Read, you'll begin reading from the first new message
  7174.        on the conference. As you read messages, the various message
  7175.        disposition commands (discussed in detail on the previous pages) are
  7176.        available to you. If you select Quit while reading, the new scan
  7177.        resumes and goes to the next available conference (press `Q' at the
  7178.        next submenu to exit from the New command entirely).
  7179.  
  7180.  
  7181.  
  7182.        _____________________________________________________________________
  7183.                                         105
  7184.                                   MESSAGE SYSTEM
  7185.        _____________________________________________________________________
  7186.  
  7187.        The first time you read messages, this prompt may appear:
  7188.  
  7189.             Pause Between Messages? Yes/No
  7190.  
  7191.        If you want Searchlight to provide a continuous dump of the new
  7192.        messages on this conference and all subsequent conferences, select
  7193.        "No". Otherwise, select "Yes".
  7194.  
  7195.        Note: The "Pause Between Messages" prompt does not appear if you
  7196.              have your preference option for Pause Between Messages set to
  7197.              Yes or No. See the section "Configuring User Options - Pause
  7198.              Between Messages" for details.
  7199.  
  7200.  
  7201.        ----
  7202.        Goto
  7203.        ----
  7204.  
  7205.        This command lets you skip to any message on the conference by
  7206.        entering its message number. Goto is often convenient when you
  7207.        encounter a conference with many new messages, and you desire to
  7208.        skip ahead and read only the most recent messages instead of reading
  7209.        them all.
  7210.  
  7211.  
  7212.        ----
  7213.        Next
  7214.        ----
  7215.  
  7216.        Select Next if you want to skip this conference. The New command
  7217.        continues to scan for the next available conference with new
  7218.        messages.
  7219.  
  7220.  
  7221.        ----
  7222.        Join
  7223.        ----
  7224.  
  7225.        If you are using the New/All command and you are not a member of the
  7226.        conference shown, you can use the Join command to become a member.
  7227.        Remember that joining a conference is required if you wish
  7228.        Searchlight to remember the highest message you have read on that
  7229.        conference and be able to identify new messages each time you log
  7230.        on.
  7231.  
  7232.        When you join a conference, Searchlight will prompt you to enter a
  7233.        high message number. If you want to read messages on the conference
  7234.        from the beginning, just press Enter to accept the default value.
  7235.        When a conference has many messages, you may want to set your high
  7236.        message pointer to a higher value, thus skipping ahead to a more
  7237.        recent message at which to begin reading.
  7238.  
  7239.  
  7240.  
  7241.        _____________________________________________________________________
  7242.                                         106
  7243.                                   MESSAGE SYSTEM
  7244.        _____________________________________________________________________
  7245.  
  7246.        Note: Searchlight automatically joins you to a conference if you
  7247.              read messages there, and select "Continue" from the message
  7248.              disposition prompt when leaving the conference.
  7249.  
  7250.  
  7251.        ------
  7252.        Unjoin
  7253.        ------
  7254.  
  7255.        If you want to discontinue membership in a particular conference, use
  7256.        this command. Searchlight will confirm that it is your intention to
  7257.        unjoin, and remove you from the conference's member list. Unjoining
  7258.        a conference will prevent that conference from appearing when you
  7259.        select the New/Joined command in the future.
  7260.  
  7261.        Remember that Searchlight determines new messages based on the high
  7262.        message pointer kept in your conference member files. This number
  7263.        points to the highest message you've read, and Searchlight assumes
  7264.        that all messages above that value are new, and all below it are
  7265.        old. When you read messages nonsequentially -- if you use the Goto
  7266.        command, or perform personal message scans, for example -- your high
  7267.        message pointer may be set higher than some messages which you have
  7268.        not actually read. If you want to reset your high message pointer at
  7269.        any time, use the 1-Member/HighMsg command.
  7270.  
  7271.        New is Searchlight's "workhorse" command. It is the one command
  7272.        you'll use most often to read messages on your BBS and keep up with
  7273.        the activity on your conferences.
  7274.  
  7275.  
  7276.         -------------------------------------------------------------------
  7277.        | THE EDIT AND KILL COMMANDS                                        |
  7278.         -------------------------------------------------------------------
  7279.  
  7280.        These two commands on Searchlight's main menu facilitate the editing
  7281.        and deletion of messages. To edit or delete a message, you must
  7282.        either be the person who posted the message, or a Sysop, CoSysop, or
  7283.        Subop of the current conference.
  7284.  
  7285.        The Edit command lets you edit the title and text of a message, using
  7286.        the system's text editors. When you save the changes, the new
  7287.        message replaces the old. If you use the Abort editor command, no
  7288.        changes take place.
  7289.  
  7290.        Edit allows you to assign a "protected" status to messages.
  7291.        Protected messages can be edited and can be deleted on an individual
  7292.        basis, but a protected message will not be deleted during any mass
  7293.        message deletion.
  7294.  
  7295.        The Kill command lets you delete a message or a range of messages.
  7296.        Only Sysops, CoSysops or Subops can specify ranges with Kill.
  7297.        Normally, each message's header is displayed before it is deleted
  7298.        and you can opt to delete or keep the message. With range delete, it
  7299.  
  7300.        _____________________________________________________________________
  7301.                                         107
  7302.                                   MESSAGE SYSTEM
  7303.        _____________________________________________________________________
  7304.  
  7305.        is possible to kill all messages in the range without verification
  7306.        (you are prompted for this option).
  7307.  
  7308.  
  7309.         -------------------------------------------------------------------
  7310.        | THE 1-MEMBER COMMAND                                              |
  7311.         -------------------------------------------------------------------
  7312.  
  7313.        The 1-Member command is used to maintain the member (.MBR) file for
  7314.        the current conference. The member file is primarily used to hold
  7315.        high message pointers for use with the New command. On the MAIL
  7316.        conference, the member file contains user "mailboxes".
  7317.  
  7318.        These subcommands are available with 1-Member:
  7319.  
  7320.             HighMsg  Search  List  Join  Unjoin  Quit
  7321.  
  7322.        1-Member commands are generally available to both Sysops and regular
  7323.        users.  However, Sysops can perform these commands for any member in
  7324.        the member file (by typing the name at the prompt), whereas regular
  7325.        users can only perform these commands on their own member account.
  7326.  
  7327.  
  7328.        ----------------
  7329.        1-Member/HighMsg
  7330.        ----------------
  7331.  
  7332.        This subcommand lets you view or directly modify your high message
  7333.        pointer (the value used with the New command) for the current
  7334.        conference. Although Searchlight normally maintains this value on
  7335.        its own, you may wish to modify it manually under certain
  7336.        circumstances.
  7337.  
  7338.  
  7339.        -----------------------------
  7340.        1-Member/Search 1-Member/List
  7341.        -----------------------------
  7342.  
  7343.        The list and search commands operate similarly to User/List and
  7344.        User/Search; List allows you to list the members of the current
  7345.        conference, while Search lets you search for a particular member
  7346.        name. The list or search result shows members' high message pointers
  7347.        and date of last conference access.
  7348.  
  7349.        Please refer to the User command in the next section of this manual
  7350.        for a little more information about these suboptions.
  7351.  
  7352.  
  7353.  
  7354.  
  7355.  
  7356.  
  7357.  
  7358.  
  7359.        _____________________________________________________________________
  7360.                                         108
  7361.                                   MESSAGE SYSTEM
  7362.        _____________________________________________________________________
  7363.  
  7364.  
  7365.        -------------
  7366.        1-Member/Join
  7367.        -------------
  7368.  
  7369.        This command joins you (or any specified user, if you're a Sysop) to
  7370.        the member file for the current conference. Upon joining the
  7371.        conference, Searchlight prompts you to enter a value for the highest
  7372.        message read. You can press Enter to accept the default value or, if
  7373.        you wish to skip older messages in the conference, you can enter a
  7374.        different value.
  7375.  
  7376.        Note: Conference member files can contain entries that are not users
  7377.              in your main user file; the most common example is
  7378.              Searchlight's SLMAIL program, which inserts a member record
  7379.              for itself when used to read new messages on a conference,
  7380.              even though `SLMAIL' is probably not a valid login name on
  7381.              your BBS. As the Sysop, you can use 1- Member commands to
  7382.              examine the member record for SLMAIL or any other specialized
  7383.              entry in your member files.
  7384.  
  7385.  
  7386.        ---------------
  7387.        1-Member/Unjoin
  7388.        ---------------
  7389.  
  7390.        This is the complementary command to 1-Member/Join, and allows you to
  7391.        remove yourself (or if you are the Sysop, remove any user) from the
  7392.        conference membership file. Searchlight confirms the deletion
  7393.        request with a Yes/No prompt before removing the member.
  7394.  
  7395.        Note: Searchlight's CONFIG program contains other useful message
  7396.              management facilities, including the ability to purge old
  7397.              messages and member files.  See Sysop Utilities later in this
  7398.              manual.
  7399.  
  7400.  
  7401.  
  7402.  
  7403.  
  7404.  
  7405.  
  7406.  
  7407.  
  7408.  
  7409.  
  7410.  
  7411.  
  7412.  
  7413.  
  7414.  
  7415.  
  7416.  
  7417.  
  7418.        _____________________________________________________________________
  7419.                                         109
  7420.                                   ELECTRONIC MAIL
  7421.        _____________________________________________________________________
  7422.  
  7423.  
  7424.         -------------------------------------------------------------------
  7425.        | USING ELECTRONIC MAIL                                             |
  7426.         -------------------------------------------------------------------
  7427.  
  7428.        Searchlight BBS provides a complete electronic mail facility, in
  7429.        addition to the public message conferences. Some features of
  7430.        electronic mail are:  individual, private mailboxes for each user;
  7431.        read, list, search, and new mail commands; message reply and
  7432.        forwarding; automatic message logging; and unlimited number of
  7433.        messages per user mailbox.
  7434.  
  7435.        Searchlight's Mail commands let you send mail to, and receive mail
  7436.        from, other members of your BBS. Using our Uumail add-on software,
  7437.        you can also enable the Mail commands to send mail to internet
  7438.        addresses. See your Uumail manual for details, or contact TeleGrafix
  7439.        for more information.
  7440.  
  7441.        What is the difference between private mail and public messages?
  7442.        Although Searchlight BBS allows you to designate a recipient for
  7443.        both public and private messages, the Mail command is specifically
  7444.        designed for sending private mail to a particular user. The main
  7445.        advantage to Mail is that your private messages are separate from
  7446.        the main public message sections of Searchlight and easily
  7447.        accessible at any time, from any conference, by using the Mail
  7448.        command.
  7449.  
  7450.        In actuality, Searchlight stores mail messages in a conference called
  7451.        "MAIL".  If you examine this conference, you'll find that it looks
  7452.        exactly like any other conference on Searchlight BBS; you can even
  7453.        Jump to it and execute regular conference commands like Read or
  7454.        Post. However, because the MAIL conference contains private
  7455.        messages, you will want to prevent any users except authorized
  7456.        Sysops from accessing the mail area in this manner (by default, the
  7457.        MAIL conference is set to access level 255). In addition, we
  7458.        recommend that you press the ALT-I hotkey anytime you jump to MAIL as
  7459.        a conference (doing this prevents your actions from affecting the
  7460.        number of times read indicators in the mail headers).
  7461.  
  7462.        Think of the Mail command as a special way in which you access the
  7463.        conference called MAIL: special because it allows users to read only
  7464.        those messages which are directed to them, while allowing them to
  7465.        send messages only to users who are actually valid members of your
  7466.        BBS (except for internet messages, which are treated differently if
  7467.        you have the Uumail software installed).
  7468.  
  7469.        When you log in to Searchlight, a check of your mailbox is
  7470.        automatically made and the number of messages displayed. If you have
  7471.        any new mail, the system lets you enter the Mail/New command
  7472.        immediately. All other Mail operations are selected via the Mail
  7473.        command on the main menu. Mail presents this submenu:
  7474.  
  7475.             Read  Send  List  New  Find  Inquire  Purge  Quit
  7476.  
  7477.        _____________________________________________________________________
  7478.                                         110
  7479.                                   ELECTRONIC MAIL
  7480.        _____________________________________________________________________
  7481.  
  7482.        Select a command as follows:
  7483.  
  7484.  
  7485.        ---------
  7486.        Mail/Read
  7487.        ---------
  7488.  
  7489.        The Read command lets you read your private messages sequentially,
  7490.        beginning with the first message in your mailbox.  Those messages
  7491.        which are new (have never been read before) are presented with this
  7492.        prompt:
  7493.  
  7494.             Read Now? Yes/No/Quit
  7495.  
  7496.        You can press Y to read the message, N to skip it and go on to the
  7497.        next message, or Q to abort the mail command.
  7498.  
  7499.        As you read messages, the standard message disposition commands
  7500.        (Next, Prev, Reply, etc.) are available from the command line. Note
  7501.        that the Goto command is not available when reading mail.
  7502.  
  7503.  
  7504.        -----------------
  7505.        The Delete Prompt
  7506.        -----------------
  7507.  
  7508.        After reading each message in your electronic mailbox, and responding
  7509.        to it with one of the above subcommands, an additional prompt
  7510.        appears:
  7511.  
  7512.             Delete this message? No/Yes
  7513.  
  7514.        Press "Y" if you wish to delete the message you just read; or "N" if
  7515.        you don't want to delete the message. Because private mail is only
  7516.        readable by the person to whom it's addressed, the software
  7517.        encourages you to delete messages after you've read them. That's why
  7518.        this prompt appears when reading mail.
  7519.  
  7520.  
  7521.        ---------
  7522.        Mail/Send
  7523.        ---------
  7524.  
  7525.        Send is the command to use when you want to send private mail to one
  7526.        or more users. Remember that mail is strictly for private messages,
  7527.        and you cannot send mail to "ALL" users (although you can send the
  7528.        same message to a small group of users).
  7529.  
  7530.        Send prompts you with:
  7531.  
  7532.             Send To :
  7533.  
  7534.  
  7535.  
  7536.        _____________________________________________________________________
  7537.                                         111
  7538.                                   ELECTRONIC MAIL
  7539.        _____________________________________________________________________
  7540.  
  7541.        Enter the name of the person to whom you would like to send mail. You
  7542.        must enter a valid username that exists in Searchlight's database.
  7543.        However, you do not need to type the entire name; typing the first
  7544.        few characters of the name is sufficient to locate the correct user.
  7545.        If you type a partial username and there are several possible
  7546.        matches, Searchlight will prompt you for the correct one.
  7547.  
  7548.        Next, the prompt
  7549.  
  7550.             cc To :
  7551.  
  7552.        will appear. If you wish to send mail to more than one person, you
  7553.        can type the name of the next user here; if you have more usernames,
  7554.        more "carbon copy" prompts will appear to take them. When you're
  7555.        done entering names, just hit ENTER without typing anything.
  7556.  
  7557.        When sending mail to multiple recipients, Searchlight automatically
  7558.        includes a "CC:" line in the editor when you enter the message,
  7559.        listing those names.  If you wish, you can modify or delete this
  7560.        line before you save the message.
  7561.  
  7562.        You may now enter a title and text for the message you want to send
  7563.        using the system's text editing facilities. When you're done, the
  7564.        message is added to the mailbox(es) of the designated recipient(s).
  7565.  
  7566.        Note: You can also type "alias" names and "group" names in response
  7567.              to these prompts. For more information, consult Appendix E,
  7568.              Using Alias Names.
  7569.  
  7570.        Note: You can also create Mail Send commands that send mail to a
  7571.              particular person, disallow carbon copy, or override certain
  7572.              access privileges. For more information, see Appendix G.
  7573.  
  7574.  
  7575.        ---------
  7576.        Mail/List
  7577.        ---------
  7578.  
  7579.        The List option provides a sequential list of the messages on file in
  7580.        your mailbox. The list shows the message number, date, sender, and
  7581.        subject of each message.
  7582.  
  7583.        Searchlight prompts you for a "Start Date" with the list command; if
  7584.        you press ENTER, it will list all messages in your mailbox. If you
  7585.        provide a date, only messages posted on or after that date are
  7586.        displayed.
  7587.  
  7588.        When the list is complete (or ^C is pressed), you can read a specific
  7589.        message by keying in the message number at the prompt.
  7590.  
  7591.  
  7592.  
  7593.  
  7594.  
  7595.        _____________________________________________________________________
  7596.                                         112
  7597.                                   ELECTRONIC MAIL
  7598.        _____________________________________________________________________
  7599.  
  7600.  
  7601.        --------
  7602.        Mail/New
  7603.        --------
  7604.  
  7605.        The New subcommand lets you search for new (unread) messages in your
  7606.        mailbox.  This command is similar to Mail/Read, except that only the
  7607.        new messages are displayed for reading.
  7608.  
  7609.        Note that the Mail/New command decides a message is new solely based
  7610.        on the number of times read indicator in the message's header, not
  7611.        via a high message pointer. Therefore, it does not matter if you
  7612.        skip around when reading mail.
  7613.  
  7614.  
  7615.        ---------
  7616.        Mail/Find
  7617.        ---------
  7618.  
  7619.        The Find option lets you search for specific messages by sender or
  7620.        subject text. In response to the prompt, enter the information to be
  7621.        searched for.  Find then operates like List, except it displays only
  7622.        messages which match the search text.
  7623.  
  7624.  
  7625.        ------------
  7626.        Mail/Inquire
  7627.        ------------
  7628.  
  7629.        This subcommand is used to check, or inquire into, the status of
  7630.        messages you have sent to other users. When you use Mail/Inquire,
  7631.        you are prompted with:
  7632.  
  7633.             Search All Mailboxes? Yes/No
  7634.  
  7635.        If you choose "Yes", Searchlight will look at all the mail you have
  7636.        sent and which still exists (i.e. has not been deleted), starting
  7637.        with the last message sent and working backwards from there. If you
  7638.        choose "No", Searchlight will prompt you for a specific user name,
  7639.        and a start date, and will display mail sent to that person on or
  7640.        after the specified date, working forwards.
  7641.  
  7642.        After each message is displayed, this prompt appears:
  7643.  
  7644.             Again  Next  Forward  Edit  Kill  Quit
  7645.  
  7646.        You can choose Again to view the message again, or Next to proceed to
  7647.        the next message.
  7648.  
  7649.        Use the Forward option if you'd like to forward a copy of this
  7650.        message to another person, a conference, a text file, etc.
  7651.  
  7652.  
  7653.  
  7654.        _____________________________________________________________________
  7655.                                         113
  7656.                                   ELECTRONIC MAIL
  7657.        _____________________________________________________________________
  7658.  
  7659.        If the message has not yet been read by the person to whom it is
  7660.        addressed, you can Edit or Kill it. These options don't appear if
  7661.        the message has already been received.
  7662.  
  7663.  
  7664.        ----------
  7665.        Mail/Purge
  7666.        ----------
  7667.  
  7668.        The final Mail command is Purge. It lets you delete some or all of
  7669.        the mail in your mailbox automatically, based on these suboptions:
  7670.  
  7671.             1. Start Date .............. 1-01-87
  7672.             2. End Date ................ 5-24-92
  7673.             3. Purge New Mail? ......... No
  7674.             4. Purge Unanswered Mail? .. No
  7675.  
  7676.        The Start Date and End Date define a range of dates for which you
  7677.        would like to purge messages. If "Purge New Mail" is set to No, then
  7678.        new (unread) mail won't be deleted, regardless of its date.
  7679.        Similarly, "Purge Unanswered Mail", if set to No, will preserve any
  7680.        mail which has not been answered. Press ESC when you have filled
  7681.        these fields in with the desired settings.
  7682.  
  7683.        Before any purge takes place, Searchlight confirms the command by
  7684.        asking "Begin Mailbox Purge?"; to continue, press Y, or press N to
  7685.        abort the command.
  7686.  
  7687.  
  7688.        -------
  7689.        Netmail
  7690.        -------
  7691.  
  7692.        Searchlight supports Netmail -- the ability to send private messages
  7693.        via Fidonet or a similar network using FTSC technology. Sending and
  7694.        receiving netmail is similar to sending and receiving regular mail,
  7695.        with some exceptions; for more information, please refer to the
  7696.        section "Netmail - Introduction to Netmail."
  7697.  
  7698.  
  7699.        -------------
  7700.        Internet Mail
  7701.        -------------
  7702.  
  7703.        Searchlight can exchange messages with internet, the worldwide
  7704.        electronic data network, when used in conjunction with our Uumail
  7705.        internet mail connectivity package. When internet support is
  7706.        enabled, your callers can receive internet messages in their
  7707.        mailboxes and send mail to internet accounts by entering special
  7708.        internet addresses instead of the names of other callers. Contact
  7709.        TeleGrafix for more information about our Uumail software.
  7710.  
  7711.  
  7712.  
  7713.        _____________________________________________________________________
  7714.                                         114
  7715.                                   ELECTRONIC MAIL
  7716.        _____________________________________________________________________
  7717.  
  7718.  
  7719.        ----------------------
  7720.        A Word about Mailboxes
  7721.        ----------------------
  7722.  
  7723.        Having a mailbox on Searchlight BBS is the same thing as joining the
  7724.        MAIL conference. However, it isn't necessary for any users to
  7725.        explicitly join MAIL -- it's done automatically, the first time
  7726.        someone sends mail to a particular user. In general, new users won't
  7727.        have a mailbox until someone sends them a message.
  7728.  
  7729.        Some Mail commands will report "Mailbox not available" when used by
  7730.        someone who has never received mail and therefore doesn't have a
  7731.        mailbox; however, this doesn't mean that user cannot send mail, nor
  7732.        does it mean they can't receive mail if some is sent to them.
  7733.  
  7734.        You can regulate the sending of mail, though, by setting the post
  7735.        attributes field in the MAIL conference (use the CONFIG program to
  7736.        do this). Users who do not have these specified attributes won't be
  7737.        able to send mail messages (but can still read any messages sent to
  7738.        them).
  7739.  
  7740.        If for any reason you wish to manually create or delete someone's
  7741.        mailbox, Jump to the MAIL conference and use the 1- Member commands.
  7742.        Notice that deleting a user's mailbox does not delete any of the
  7743.        messages in that mailbox, it only removes the user's access to those
  7744.        messages.
  7745.  
  7746.  
  7747.  
  7748.  
  7749.  
  7750.  
  7751.  
  7752.  
  7753.  
  7754.  
  7755.  
  7756.  
  7757.  
  7758.  
  7759.  
  7760.  
  7761.  
  7762.  
  7763.  
  7764.  
  7765.  
  7766.  
  7767.  
  7768.  
  7769.  
  7770.  
  7771.  
  7772.        _____________________________________________________________________
  7773.                                         115
  7774.                                      BULLETINS
  7775.        _____________________________________________________________________
  7776.  
  7777.  
  7778.         -------------------------------------------------------------------
  7779.        | USING THE BULLETINS SYSTEM                                        |
  7780.         -------------------------------------------------------------------
  7781.  
  7782.        Bulletins are a small, special group of messages maintained by
  7783.        Searchlight.  These are the messages that are listed when a user
  7784.        first logs in, or when the Bulletin command is executed from the
  7785.        main menu.
  7786.  
  7787.        As you may have guessed, bulletins are actually stored in the
  7788.        BULLETIN conference that was created by default when you installed
  7789.        Searchlight BBS.  Although Bulletin is a conference, the Bulletins
  7790.        command is a special way to read that conference: it lists the
  7791.        messages in reverse chronological order and allows you to select
  7792.        them with a sequential number (regardless of the actual message
  7793.        numbers).
  7794.  
  7795.  
  7796.        -----------------
  7797.        Reading Bulletins
  7798.        -----------------
  7799.  
  7800.        To read bulletins, simply execute the Bulletins command and enter the
  7801.        number of the bulletin you want to read. This menu is also displayed
  7802.        as part of the login sequence.
  7803.  
  7804.  
  7805.        ---------------------
  7806.        Maintaining Bulletins
  7807.        ---------------------
  7808.  
  7809.        To post, edit, delete, or otherwise maintain your bulletins, simply
  7810.        Jump to the BULLETIN conference. Use Searchlight's standard message
  7811.        commands to modify or enter new information. Don't worry about the
  7812.        message numbers that are assigned to new bulletins, as the Bulletins
  7813.        command automatically assigns sequential values to your bulletins.
  7814.  
  7815.        By default, BULLETIN is a high access level, protected message area
  7816.        that is accessible only to you as the Sysop.  However, you might
  7817.        want to allow some or all of your users to access the BULLETIN
  7818.        conference and perform modifications. To do that, just edit the
  7819.        access levels and attributes of the bulletin area via the Setup
  7820.        utility program.
  7821.  
  7822.        If you do allow your users to post bulletins, you will usually want
  7823.        to ensure that the number of bulletins available doesn't go beyond a
  7824.        certain value (say 15 bulletins). We recommend setting this as the
  7825.        maximum number of messages via the CONFIG program. As well, use the
  7826.        "Auto Purge" feature to automatically purge old bulletins after the
  7827.        limit is reached (protect important bulletins by editing them and
  7828.        setting the protect flag on). The maximum allowable number of
  7829.        bulletins is 100.
  7830.  
  7831.        _____________________________________________________________________
  7832.                                         116
  7833.                                      BULLETINS
  7834.        _____________________________________________________________________
  7835.  
  7836.  
  7837.        ---------------------------------------
  7838.        Using an Alternate Bulletins Conference
  7839.        ---------------------------------------
  7840.  
  7841.        The Bulletins command can work with a conference other than the
  7842.        default BULLETIN conference. This feature allows you to have
  7843.        multiple bulletins areas by creating a conference for each area and
  7844.        a command to start the bulletins menu for that conference.
  7845.  
  7846.        To have the Bulletins command execute for a different conference, use
  7847.        the menu editor to create an internal command.  For example:
  7848.  
  7849.             1. Command Name ................... CarPool
  7850.             2. Command Key .................... C
  7851.             3. Description .................... Car Pool Info
  7852.             4. Access Levels & Graphics [...]
  7853.             5. Command Number (1) ............. 106
  7854.             6. Command Parameters (1) ......... CARPOOL /x
  7855.  
  7856.        In this example, we created a bulletins command using the CARPOOL
  7857.        conference.  The interface for this command will be the same as the
  7858.        regular bulletins command, except that it get its messages from our
  7859.        CARPOOL conference. (For more information about creating commands
  7860.        and using internal command numbers, see the menu editing section of
  7861.        this manual beginning in the section "Menu Editor - Searchlight Menu
  7862.        Editor".)
  7863.  
  7864.        The Bulletins command can accept any conference name, even if the
  7865.        caller does not have access to the conference. Thus, alternate
  7866.        bulletins areas can be created without those areas appearing in your
  7867.        regular conference listings.  However, if you use a MAIN.SUB file,
  7868.        or if you use internal command 200, the bulletin conference must be
  7869.        part of the current conference listing.
  7870.  
  7871.  
  7872.  
  7873.  
  7874.  
  7875.  
  7876.  
  7877.  
  7878.  
  7879.  
  7880.  
  7881.  
  7882.  
  7883.  
  7884.  
  7885.  
  7886.  
  7887.  
  7888.  
  7889.  
  7890.        _____________________________________________________________________
  7891.                                         117
  7892.                                   USING CHAT MODE
  7893.        _____________________________________________________________________
  7894.  
  7895.  
  7896.         -------------------------------------------------------------------
  7897.        | USING CHAT MODE                                                   |
  7898.         -------------------------------------------------------------------
  7899.  
  7900.        "Chat Mode" is a feature which allows you to "talk" to, or exchange
  7901.        short messages with, a user logged on to your BBS.  There are two
  7902.        kinds of chatting: Sysop-To-User chatting, which enables the Sysop
  7903.        to talk to a logged in user, and Internode chatting, which allows
  7904.        two logged-in users to communicate.
  7905.  
  7906.  
  7907.        ----------------------
  7908.        Sysop-To-User Chatting
  7909.        ----------------------
  7910.  
  7911.        The Sysop-To-User chat feature is invoked when the Sysop responds to
  7912.        a "page" by a logged-in user, or by the Sysop by pressing ALT-C
  7913.        anytime at the local console. In ANSI or RIP modes, ALT-C invokes a
  7914.        split screen Sysop chat mode.  The screen is divided in two; your
  7915.        typing occupies the lower portion of the screen, and the caller's
  7916.        typing appears in the upper portion. In non-ANSI mode, the local
  7917.        chat mode simply lets you and the caller type messages back and
  7918.        forth in a single window.
  7919.  
  7920.        Chat conversation may be logged by using the ALT-L logging facility.
  7921.        To exit chat mode, the Sysop presses the ESC key.
  7922.  
  7923.        If you like, you can provide a background or "wallpaper" file for
  7924.        split screen chatting in RIP mode. To do so, create a RIP file
  7925.        called CHAT.RIP and place it in your Text directory. Searchlight
  7926.        will display your file when ALT-C is pressed and place the chat
  7927.        windows on top of it. Wallpaper is not available in non-RIP modes.
  7928.  
  7929.  
  7930.        ------------------
  7931.        Internode Chatting
  7932.        ------------------
  7933.  
  7934.        A more powerful Chat command, available only with multiuser versions
  7935.        of Searchlight, allows two or more logged-in users to communicate
  7936.        directly, instead of just being able to chat with the Sysop.
  7937.  
  7938.        An internode chat session is initiated when one user enters the Chat
  7939.        command from the main menu. Chat displays the list of available
  7940.        nodes,  and prompts you to select the desired node with which to
  7941.        chat. If you select the Local Sysop option, Chat performs a local
  7942.        Sysop-To-User page, as with single-user systems. If you select a
  7943.        node, however, Chat prints the message
  7944.  
  7945.             Entering Chat Mode. Enter a period (.) to exit, .H for Help.
  7946.  
  7947.        followed by a right-bracket prompt. You may now type a short text
  7948.        message, pressing Enter when you are finished.
  7949.        _____________________________________________________________________
  7950.                                         118
  7951.                                   USING CHAT MODE
  7952.        _____________________________________________________________________
  7953.  
  7954.        At another node, the caller to whom your message is directed will
  7955.        continue to work. However, the next time the caller's screen is
  7956.        cleared, Searchlight will display the message from you. If this user
  7957.        wishes to respond to you, he or she will then enter Chat mode from
  7958.        the main menu and begin sending messages to you (your terminal will
  7959.        display the sent messages either immediately, if your cursor is just
  7960.        to the right of the ">" prompt and you haven't typed anything, or
  7961.        immediately after you finish typing the current line). When you're
  7962.        done talking, just type a period at the ">" prompt and hit Enter.
  7963.  
  7964.        The chat facility can buffer up to four lines of text. After four
  7965.        lines are sent, you cannot send any more text until the receiver has
  7966.        received the four buffered lines. When this happens, you must either
  7967.        wait for a response, or give up trying to chat. Notice that since
  7968.        messages sent to a user are only displayed when the screen clears, a
  7969.        user may not receive your message immediately; you should wait
  7970.        several minutes after sending the initial message before you can
  7971.        expect a reply.
  7972.  
  7973.        At anytime during the chat, you can get a list of currently logged in
  7974.        users by typing ".W" at the prompt. To switch nodes and chat with
  7975.        another user, you can enter ".n" where "n" is the node number you
  7976.        want to chat with next.
  7977.  
  7978.        Messages are exchanged through a file called CHAT.SL2, which will be
  7979.        created on your disk if it does not exist. Since the messages in
  7980.        CHAT.SL2 are of a temporary nature, and since interactive chatting
  7981.        is disk-intensive, we strongly recommend that you use a small
  7982.        RAM-disk to hold the CHAT.SL2 file.  You can specify the drive and
  7983.        pathname where CHAT.SL2 will be created using the option in the
  7984.        "Pathnames Setup" section of the CONFIG program. If you do so,
  7985.        however, remember that each node in your system MUST be set to the
  7986.        exact same chat path. Otherwise, chatting between some nodes won't
  7987.        work. The amount of disk space needed for the CHAT.SL2 file will be
  7988.        512 bytes plus 512 times the number of nodes in your system.
  7989.  
  7990.        Since Searchlight will create CHAT.SL2 if it does not exist, there is
  7991.        no need to copy this file to or from your RAM-disk when the computer
  7992.        is reset.
  7993.  
  7994.        Note: Searchlight's Fred Chat Central product replaces the internal
  7995.              chatting commands. If you received Fred Chat Central with your
  7996.              Searchlight purchase, please refer to your Fred manual for
  7997.              further information.
  7998.  
  7999.  
  8000.  
  8001.  
  8002.  
  8003.  
  8004.  
  8005.  
  8006.  
  8007.  
  8008.        _____________________________________________________________________
  8009.                                         119
  8010.                                   OTHER COMMANDS
  8011.        _____________________________________________________________________
  8012.  
  8013.  
  8014.         -------------------------------------------------------------------
  8015.        | OTHER COMMANDS                                                    |
  8016.         -------------------------------------------------------------------
  8017.  
  8018.        Here's an outline of miscellaneous Searchlight BBS main menu commands
  8019.        that were not covered in previous chapters:
  8020.  
  8021.  
  8022.        ------------
  8023.        Ansi Command
  8024.        ------------
  8025.  
  8026.        The Ansi command can be used at any time to change the current ANSI
  8027.        mode to Color, Monochrome, or None.  Normally, this selection is
  8028.        made before logging in, but it can be changed afterwards.
  8029.  
  8030.  
  8031.        ---------------
  8032.        Goodbye Command
  8033.        ---------------
  8034.  
  8035.        Goodbye logs you off the system, resetting Searchlight for the next
  8036.        call. If the "quotes file" is enabled, Searchlight will prompt you
  8037.        on logoff:
  8038.  
  8039.             Please leave us a quote:
  8040.             >
  8041.  
  8042.        You can type up to 72 characters. The message you leave is stored in
  8043.        the quotes file and can be viewed by later callers with the Quotes
  8044.        command.
  8045.  
  8046.  
  8047.        ------------
  8048.        Info Command
  8049.        ------------
  8050.  
  8051.        This command looks for a file called INFO.TXT (or INFO.ANS for ANSI
  8052.        users) in your text directory area, and displays it if it exists.
  8053.        You can use the Info file to provide a brief description of your
  8054.        system, an editorial, etc.
  8055.  
  8056.  
  8057.        --------------
  8058.        Quotes Command
  8059.        --------------
  8060.  
  8061.        Quotes looks into the QUOTES.SL2 file and displays the quotes entered
  8062.        at logoff (when the quotes file is active).
  8063.  
  8064.  
  8065.  
  8066.  
  8067.        _____________________________________________________________________
  8068.                                         120
  8069.                                   OTHER COMMANDS
  8070.        _____________________________________________________________________
  8071.  
  8072.  
  8073.        ------------
  8074.        Time Command
  8075.        ------------
  8076.  
  8077.        This command shows you the current time and date, the time you logged
  8078.        in, your elapsed time, and the amount of time left in your current
  8079.        session.
  8080.  
  8081.  
  8082.        ------------
  8083.        User Command
  8084.        ------------
  8085.  
  8086.        The User command is used to list or search for users in the user
  8087.        database or to get a log of the last 75 callers. It has these
  8088.        subcommands:
  8089.  
  8090.             CallLog  Search  List  Find  Delete  Quit
  8091.  
  8092.        To get the list of the last 75 successive calls to the system, select
  8093.        the CallLog option. You can abort the list with ^C if desired.
  8094.  
  8095.        Search lets you enter usernames to search for. If the user is found,
  8096.        the system displays his or her location, system type, total calls,
  8097.        and dates of first and last login. You can specify partial user
  8098.        names here; for example, typing TOM would display all users on your
  8099.        system named Tom.
  8100.  
  8101.        The List function gives an alphabetical list of users on your system.
  8102.        You can start the list anywhere, by typing the first few characters
  8103.        of the name you want to begin with; or press ENTER to view the
  8104.        entire list. If you are the Sysop or a co- Sysop, Searchlight
  8105.        prompts you:
  8106.  
  8107.             Enter Min Access Level [  0]:
  8108.             Enter Max Access Level [255]:
  8109.  
  8110.        If you press ENTER (to use the default values in brackets), all users
  8111.        are displayed. If you specify an access level range, however, only
  8112.        users who's access levels fall within that range are displayed.
  8113.  
  8114.        The Find option works like List, but allows you to specify an
  8115.        arbitrary search string. Only users who's user records contain the
  8116.        search string in the name, location, or system type fields are
  8117.        displayed. You can abort the search with ^C.
  8118.  
  8119.        Note: Notice that the List and Find commands display user access
  8120.              levels, but only when used by a Sysop or co-Sysop.
  8121.  
  8122.        Use the Delete option if you want to delete a user from your user
  8123.        file.  Naturally, this command is only available to you as a Sysop,
  8124.        and not to your regular callers.
  8125.  
  8126.        _____________________________________________________________________
  8127.                                         121
  8128.                                   OTHER COMMANDS
  8129.        _____________________________________________________________________
  8130.  
  8131.        Note: Deleting a user in this manner does not delete any mail or
  8132.              messages on the system for that user. The sysop utilities
  8133.              menu in CONFIG can be use to purge these items if desired.
  8134.  
  8135.  
  8136.        ---------------
  8137.        Version Command
  8138.        ---------------
  8139.  
  8140.        This command displays: the version number of Searchlight BBS being
  8141.        used, the public portion of your software registration number, and
  8142.        the user license level (single user, three user, etc.) that you
  8143.        purchased.
  8144.  
  8145.  
  8146.        -----------
  8147.        Who Command
  8148.        -----------
  8149.  
  8150.        In multiuser systems, you can use the Who command to display the
  8151.        number of active nodes and the names of the users logged in to each
  8152.        node. On single user systems, this command displays the current
  8153.        user's name and location.
  8154.  
  8155.  
  8156.  
  8157.  
  8158.  
  8159.  
  8160.  
  8161.  
  8162.  
  8163.  
  8164.  
  8165.  
  8166.  
  8167.  
  8168.  
  8169.  
  8170.  
  8171.  
  8172.  
  8173.  
  8174.  
  8175.  
  8176.  
  8177.  
  8178.  
  8179.  
  8180.  
  8181.  
  8182.  
  8183.  
  8184.  
  8185.        _____________________________________________________________________
  8186.                                         122
  8187.                                   SYSOP FUNCTIONS
  8188.        _____________________________________________________________________
  8189.  
  8190.  
  8191.         -------------------------------------------------------------------
  8192.        | SYSOP FUNCTIONS                                                   |
  8193.         -------------------------------------------------------------------
  8194.  
  8195.        A special command is provided on Searchlight's main menu that's
  8196.        available to Sysops and CoSysops only. This is the "2- Sysop"
  8197.        command and it lets you change access levels and options, read other
  8198.        users' mail, edit text files, and more. When you execute it (type
  8199.        "2" at the main menu and press ENTER), this subcommand menu appears:
  8200.  
  8201.           Options  Adjust  Validate  Mail  TextEdit  DosShell  Relog  Quit
  8202.  
  8203.        Select "Quit" to abort the command, or select one of the command
  8204.        options as follows:
  8205.  
  8206.  
  8207.        -------------
  8208.        Sysop/Options
  8209.        -------------
  8210.  
  8211.        This option lets you edit a user's record, including user
  8212.        information, preferences, access levels, attributes and time
  8213.        limits.  Complete details are given in the Configuring User Options
  8214.        section of this manual.
  8215.  
  8216.  
  8217.        ------------
  8218.        Sysop/Adjust
  8219.        ------------
  8220.  
  8221.        The Adjust feature is similar to Options, but allows you to edit four
  8222.        fields which are normally system-maintained: a user's upload and
  8223.        download amounts, first login date, and last login date. Normally,
  8224.        you will not need to change these fields as they are updated by the
  8225.        system; however, you may wish to do so in special circumstances,
  8226.        such as to correct inaccurate upload/download ratios.
  8227.  
  8228.  
  8229.        --------------
  8230.        Sysop/Validate
  8231.        --------------
  8232.  
  8233.        This command lets you "validate" a user by assigning one of the 12
  8234.        preset access levels to that user's record. When you select
  8235.        Sysop/Validate and enter a username, Searchlight displays a list of
  8236.        the default access levels; choose one by pressing the appropriate
  8237.        letter. Default access levels are configured by using option "I" on
  8238.        the CONFIG program's main menu.
  8239.  
  8240.        Validating a user assigns the values associated with the selected
  8241.        access level to that user's account. You can individually adjust
  8242.        user records, though, by using the Sysop/Options facility.
  8243.  
  8244.        _____________________________________________________________________
  8245.                                         123
  8246.                                   SYSOP FUNCTIONS
  8247.        _____________________________________________________________________
  8248.  
  8249.        You can also invoke the Validate command by using Other/Validate from
  8250.        any message disposition line.
  8251.  
  8252.        Note: Updating a particular default access level (via CONFIG) does
  8253.              not automatically update users to whom that access level has
  8254.              been assigned. Use the Sysop Utilities portion of the CONFIG
  8255.              program to effect such changes when required.
  8256.  
  8257.  
  8258.        ----------
  8259.        Sysop/Mail
  8260.        ----------
  8261.  
  8262.        The Mail subcommand lets you access the mailbox of another user. You
  8263.        can read, list, or search the user's mail, purge or delete messages,
  8264.        and write mail to other users "as" that user. First, pick the
  8265.        desired operation from the options displayed; then enter the desired
  8266.        user name.
  8267.  
  8268.        You can also access user mail by JUMPing to the "MAIL" conference.
  8269.  
  8270.        Note that when you read a user's mail in Sysop/Mail mode, the "number
  8271.        of times read" indicators do not increment.
  8272.  
  8273.  
  8274.        --------------
  8275.        Sysop/TextEdit
  8276.        --------------
  8277.  
  8278.        This command loads a text file from disk and puts it into the
  8279.        Searchlight text editor. You can edit the file and resave it to
  8280.        disk, thus giving you the ability to edit files used by Searchlight
  8281.        (such as ALIAS.DEF) or other short text files without exiting from
  8282.        Searchlight or using another editor.
  8283.  
  8284.        Searchlight's full screen editor allows you to edit lines longer
  8285.        than 76 characters by appending an underbar character to the end of
  8286.        long lines and continuing them on the next line. If you edit such
  8287.        lines, you must manually maintain the position of the underbar at
  8288.        the end of the line. Do not use TextEdit to edit files longer than
  8289.        1000 lines or files which contain non-ASCII characters.
  8290.  
  8291.        Only the Sysop (access level 255) is allowed to use TextEdit.
  8292.  
  8293.  
  8294.        --------------
  8295.        Sysop/DosShell
  8296.        --------------
  8297.  
  8298.        This command calls up a shell to the operating system (DOS) by
  8299.        running the COMMAND.COM program. This is similar to pressing ALT-D,
  8300.        but it's also available from a remote login (limited, of course, to
  8301.        Sysops with the highest access level).
  8302.  
  8303.        _____________________________________________________________________
  8304.                                         124
  8305.                                   SYSOP FUNCTIONS
  8306.        _____________________________________________________________________
  8307.  
  8308.        Note: DosShell is implemented as a "door" to the COMMAND.COM
  8309.              program. You can adjust the properties of the Dos Shell by
  8310.              examining the SYSOP menu with the Menu Editor.
  8311.  
  8312.  
  8313.        -----------
  8314.        Sysop/Relog
  8315.        -----------
  8316.  
  8317.        Relog can be used during a remote call to log off of Searchlight but
  8318.        return the system to the "Select Graphics Mode ..." prompt instead
  8319.        of hanging up the telephone. By doing this, you can allow someone
  8320.        else to log on to the system without having to redial and make
  8321.        another connection.
  8322.  
  8323.        Note: Additional sysop utilities that let you purge messages, users
  8324.              and files are available in the CONFIG program. See "Sysop
  8325.              Utilities - Searchlight Sysop Utilities" for more information.
  8326.  
  8327.  
  8328.  
  8329.  
  8330.  
  8331.  
  8332.  
  8333.  
  8334.  
  8335.  
  8336.  
  8337.  
  8338.  
  8339.  
  8340.  
  8341.  
  8342.  
  8343.  
  8344.  
  8345.  
  8346.  
  8347.  
  8348.  
  8349.  
  8350.  
  8351.  
  8352.  
  8353.  
  8354.  
  8355.  
  8356.  
  8357.  
  8358.  
  8359.  
  8360.  
  8361.  
  8362.        _____________________________________________________________________
  8363.                                         125
  8364.                                STATUS LINE & HOTKEYS
  8365.        _____________________________________________________________________
  8366.  
  8367.  
  8368.         -------------------------------------------------------------------
  8369.        | THE STATUS LINE                                                   |
  8370.         -------------------------------------------------------------------
  8371.  
  8372.        Whenever someone is logged into your BBS from a remote terminal, the
  8373.        local PC screen will display a status line in inverse video at the
  8374.        bottom of the screen. The status line gives you information about
  8375.        the currently logged in user. It looks something like this:
  8376.  
  8377.          Online: USER NAME   Access: AAA/BBB  Time: XXX/YYY  Node N  sacnl
  8378.  
  8379.        USER NAME shows you the name of the person who is logged in. AAA and
  8380.        BBB are the user's BBS access level and FILES access level,
  8381.        respectively. XXX is the amount of time (in minutes) that the user
  8382.        has been logged in, and YYY is the user's time limit for this
  8383.        session. Node indicates the node number (in multiuser systems) of
  8384.        the node you are looking at. The lowercase letters to the right are
  8385.        status flags, as explained below.
  8386.  
  8387.  
  8388.         -------------------------------------------------------------------
  8389.        | HOT KEYS                                                          |
  8390.         -------------------------------------------------------------------
  8391.  
  8392.        As the Sysop, there is a group of operations that you can perform
  8393.        through the use of what we call "hot keys" at the local keyboard. A
  8394.        "hot key" is a special key that can be pressed at almost any time
  8395.        the Searchlight is running, without disturbing the call in progress.
  8396.        For example, ALT-V is the hot key for validating users. If you press
  8397.        ALT-V while a new user is logged in, that user will be instantly
  8398.        validated, and the status line on the bottom of the screen will be
  8399.        updated to show the user's new status. Pressing ALT-V while a
  8400.        validated user is online results in un-validating the user, or
  8401.        returning the user to the defined new user access levels and time
  8402.        limit. The user at the remote terminal doesn't see any of this
  8403.        happening.
  8404.  
  8405.        The F9 and F10 keys can be used to adjust a user's time limit.
  8406.        Pressing F9 adds five minutes to the currently logged in user's time
  8407.        limit, and pressing F10 subtracts 5 minutes. The new time limit is
  8408.        in effect only for the current call.
  8409.  
  8410.        The F8 key is a status line toggle. Pressing F8 changes the status
  8411.        line, swapping the above access level/time limit display with one of
  8412.        five others showing the user's location, computer type, phone number,
  8413.        baud rate, system's memory usage, user alias, or security attributes.
  8414.  
  8415.        The letters "sacnl" on the lower right hand side of the screen are
  8416.        flags, and they are controlled with hot keys as well. The "S" flag
  8417.        is called the superuser status flag. When the flag is OFF, a
  8418.        lowercase s is displayed. When it is ON, an uppercase S is shown.
  8419.        You toggle it on or off by pressing the ALT-S key on the local
  8420.        keyboard.
  8421.        _____________________________________________________________________
  8422.                                         126
  8423.                                STATUS LINE & HOTKEYS
  8424.        _____________________________________________________________________
  8425.  
  8426.  
  8427.        When superuser status is ON, any user who is logged in is granted
  8428.        full Sysop privileges. Normally, you use this command in order to
  8429.        allow yourself to execute sysop commands while someone else is
  8430.        logged in. You can also use it to grant temporary Sysop access to
  8431.        the logged in user. Note that if you turn this switch ON, it remains
  8432.        ON until you turn it off, or until the current user logs off (or
  8433.        hangs up).
  8434.  
  8435.        The "a" and "c" flags control the operation of the chat command. The
  8436.        "a" flag is the Sysop Availability flag. When it is ON, an uppercase
  8437.        "A" is displayed, and paging is enabled; that is, the system will
  8438.        beep to inform you of an attempt by a user to call you with the
  8439.        "Chat" command. If availability is turned OFF, the computer will
  8440.        remain silent, and inform all users attempting to chat that no sysop
  8441.        is available. The sysop availability mode is turned on and off by
  8442.        pressing ALT-A.
  8443.  
  8444.        The "c" flag tells you whether or not the current user has attempted
  8445.        to page you since logging on. If a capital "C" is displayed, it
  8446.        means the user attempted to Chat. This is true regardless of the
  8447.        setting of the "A" flag.
  8448.  
  8449.        ALT-C is the chat hotkey. At most times when the Searchlight is
  8450.        running, you can "break in" to chat with the logged user by pressing
  8451.        ALT-C. This causes you to go into chat mode immediately, suspending
  8452.        any operation in progress.  When you exit the chat mode (by pressing
  8453.        the ESC key), Searchlight restores the original screen display and
  8454.        returns the user to the exact place where he or she left off.
  8455.  
  8456.        The `n' flag and the ALT-N function key toggle Searchlight's
  8457.        Sysop-Next option. Sysop-Next is a flag which you can set to
  8458.        indicate that you would like to system to revert to a local login
  8459.        immediately after the current user logs off, thus giving you the
  8460.        opportunity to log onto the BBS yourself or take the BBS down to
  8461.        perform maintenance functions. When the ALT-N flag is set,
  8462.        Searchlight will, upon recycling back to the call waiting screen,
  8463.        immediately issue the local init string to your modem, sound a short
  8464.        alert tone from the speaker, and go into a local login mode.
  8465.  
  8466.        You can turn the Sysop-Next flag or off by pressing the ALT-N key at
  8467.        any time. A capital "N" indicates that it is on, while a lowercase
  8468.        letter means that it's off.
  8469.  
  8470.        Note: If a front-end program is being used (that is, if Searchlight
  8471.              is set to Return to DOS on Logoff), it will exit with a result
  8472.              code of 3 when the Sysop-Next flag is set. It is up to the
  8473.              front end program to recognize this as a request to allow the
  8474.              sysop to log in next; if your front end software cannot do
  8475.              this, then you won't be able to use the ALT-N feature.
  8476.  
  8477.  
  8478.  
  8479.  
  8480.        _____________________________________________________________________
  8481.                                         127
  8482.                                STATUS LINE & HOTKEYS
  8483.        _____________________________________________________________________
  8484.  
  8485.        ALT-I is Searchlight's "invisible" hotkey. Actually, what ALT-I does
  8486.        is allow you to read messages on any conference, or in your mailbox,
  8487.        without updating your high message read counter, or the "number of
  8488.        times read" counters in message headers. (An uppercase I appears on
  8489.        the status line when you press ALT-I and disappears when you press
  8490.        it again). ALT- I is particularly useful when you want to review
  8491.        private messages by Jumping to the MAIL conference, without
  8492.        affecting the counters for those messages.
  8493.  
  8494.  
  8495.        --------------
  8496.        Output Logging
  8497.        --------------
  8498.  
  8499.        The "L" status flag and the ALT-L command control output logging.
  8500.        Logging allows you to capture all of the text being sent to and from
  8501.        your BBS and output it to a disk file or device. For example, you
  8502.        could use this feature to record a conversation with a user while in
  8503.        CHAT mode, or to make ASCII text files containing listings of your
  8504.        upload/download directories, or to get a printout of almost any
  8505.        listing, message, or display that Searchlight normally sends to the
  8506.        screen.
  8507.  
  8508.        To begin logging, press ALT-L; you are prompted to enter a filename.
  8509.        If you defined a default log file in the CONFIG program, it is
  8510.        displayed, and you can use it by pressing ENTER. Otherwise, enter
  8511.        the desired filename. Logging begins, and continues until you press
  8512.        ALT-L again, change from one program module to another (i.e. run the
  8513.        Files program or quit from Files to the main menu), log off, exit
  8514.        via ALT-X, or execute a Door program. All text normally displayed on
  8515.        the screen is copied into the log file.
  8516.  
  8517.        If you wish to obtain a hard copy (printout) of BBS activity, use PRN
  8518.        as the output filename. PRN is the printer device file, and it will
  8519.        cause subsequent output to go to the printer.
  8520.  
  8521.        Note: Backspace characters are processed out of the logged output,
  8522.              and ANSI escape sequences are removed. Also, the "-- more --"
  8523.              prompt is disabled during logging.
  8524.  
  8525.  
  8526.        --------
  8527.        Exit Key
  8528.        --------
  8529.  
  8530.        ALT-X can be used to temporarily exit Searchlight and return to DOS.
  8531.        When you press ALT-X (from the local keyboard only), all files are
  8532.        closed, Searchlight terminates, and you return to DOS. When you
  8533.        re-run Searchlight (by executing SLBBS.EXE), you are returned to
  8534.        your BBS and positioned at the main menu.
  8535.  
  8536.  
  8537.  
  8538.  
  8539.        _____________________________________________________________________
  8540.                                         128
  8541.                                STATUS LINE & HOTKEYS
  8542.        _____________________________________________________________________
  8543.  
  8544.        If you use ALT-X while a remote user is online, the modem will not
  8545.        hang up the telephone, but the remote user will cease to receive
  8546.        output or be able to give input to the system until you return to
  8547.        the BBS.
  8548.  
  8549.        You don't have to return to Searchlight after ALT-X: it is safe to
  8550.        shut your computer off, or run another program.  However, the next
  8551.        time you run Searchlight it will return to the current session. You
  8552.        must log off (using the GoodBye command) in order to allow
  8553.        Searchlight to receive new calls.
  8554.  
  8555.        ALT-X will exit with a return code (errorlevel) of 1. This allows an
  8556.        external front-end program, if used, to distinguish between an exit
  8557.        to DOS and a normal logoff.
  8558.  
  8559.        Note: Pressing ALT-X loses your current menu position and may make
  8560.              it impossible to return to previous menus, if you have made
  8561.              changes in your menus. If you encounter menu-related problems
  8562.              after using ALT-X, we recommend you either avoid using ALT-X
  8563.              (use GoodBye instead), or, when re-starting Searchlight, type
  8564.              "SLBBS Local".
  8565.  
  8566.  
  8567.        ----------
  8568.        Hangup Key
  8569.        ----------
  8570.  
  8571.        The ALT-H key has been provided to enable you to terminate a user's
  8572.        session immediately. If you press ALT-H from the console while a
  8573.        user is logged in, the modem will hang up on the user and
  8574.        Searchlight will recycle to accept another call.
  8575.  
  8576.  
  8577.        -------------
  8578.        Local RIP Key
  8579.        -------------
  8580.  
  8581.        Press ALT-R to toggle between RIP mode (graphics mode) and text mode
  8582.        during a local login. When RIP is enabled, Searchlight operates in
  8583.        graphics mode.  Graphics features like scroll bars and pop-up dialog
  8584.        boxes are available for your use. In text mode, graphics features
  8585.        are not used.
  8586.  
  8587.        If you have an EGA or VGA monitor, you can use Searchlight in either
  8588.        mode; if you have a monochrome or non-graphics monitor, you must use
  8589.        text mode.
  8590.  
  8591.  
  8592.  
  8593.  
  8594.  
  8595.  
  8596.  
  8597.  
  8598.        _____________________________________________________________________
  8599.                                         129
  8600.                                STATUS LINE & HOTKEYS
  8601.        _____________________________________________________________________
  8602.  
  8603.  
  8604.        ------------
  8605.        Command Keys
  8606.        ------------
  8607.  
  8608.        Two special keys are provided to allow access to other programs while
  8609.        running Searchlight. The ALT-F key runs the Searchlight CONFIG
  8610.        program. To use it, your CONFIG.EXE program must be loaded into your
  8611.        SLBBS program directory.
  8612.  
  8613.        ALT-D provides a shell to DOS. It requires that COMMAND.COM be
  8614.        available in the path specified in the COMSPEC environment variable.
  8615.        To return to Searchlight, give the command EXIT at the DOS prompt.
  8616.  
  8617.        Both ALT-F and ALT-D will return you to the last menu you accessed
  8618.        before using the command. However, if you press ALT-F or ALT-D while
  8619.        entering a message, you will lose any text which has not been saved.
  8620.        You can also lose new message pointers and lose your place while
  8621.        reading messages or mail. We recommend using ALT-F and ALT-D while
  8622.        situated at a menu prompt, rather than while reading or entering
  8623.        messages.
  8624.  
  8625.  
  8626.  
  8627.  
  8628.  
  8629.  
  8630.  
  8631.  
  8632.  
  8633.  
  8634.  
  8635.  
  8636.  
  8637.  
  8638.  
  8639.  
  8640.  
  8641.  
  8642.  
  8643.  
  8644.  
  8645.  
  8646.  
  8647.  
  8648.  
  8649.  
  8650.  
  8651.  
  8652.  
  8653.  
  8654.  
  8655.  
  8656.  
  8657.        _____________________________________________________________________
  8658.                                         130
  8659.                                    TEXT EDITING
  8660.        _____________________________________________________________________
  8661.  
  8662.  
  8663.         -------------------------------------------------------------------
  8664.        | TEXT EDITING: INTRODUCTION                                        |
  8665.         -------------------------------------------------------------------
  8666.  
  8667.        Searchlight contains two text editors that are used whenever you
  8668.        enter a message or send electronic mail. The text editors, while not
  8669.        full-fledged word processors, contain many features and commands
  8670.        that allow you to easily compose, enter, and change short to medium
  8671.        length messages. In addition, you can use Searchlight's text editing
  8672.        capabilities to edit text files on disk, even from a remote
  8673.        terminal.
  8674.  
  8675.        A line-oriented text editor, similar in nature to the DOS EDLIN
  8676.        editor and to the editors found on many BBS systems, is provided for
  8677.        use with non-ANSI terminals. The line editor provides a fast and
  8678.        simple way of entering messages, with rudimentary editing
  8679.        facilities, and it works from almost any kind of remote terminal,
  8680.        from IBM PCs to older home computers to printing terminals.
  8681.  
  8682.        Searchlight also contains a full-screen text editor that resembles
  8683.        the types of editors most people are used to working with on the IBM
  8684.        PC. It gives you an exact representation on the screen of what your
  8685.        message will look like when read back, and it allows you to move the
  8686.        cursor anywhere on the screen and insert, change, or delete text
  8687.        with simple keystrokes.  The commands used are a combination of
  8688.        standard PC editing keys and a subset of the popular "Wordstar"
  8689.        command set, so chances are you already know how to use
  8690.        Searchlight's editor.
  8691.  
  8692.        The main disadvantage of the full screen editor is that it's not
  8693.        compatible with all terminals -- you must have an ANSI (or vt100)
  8694.        compatible terminal (or terminal emulator) to use it in remote mode.
  8695.        Fortunately, software to emulate ANSI terminals is available for
  8696.        most microcomputers -- for the IBM PC, we recommend Procomm, Procomm
  8697.        Plus, and Telix.  In addition, you'll find that certain operations,
  8698.        such as PageUp and PageDown, are inherently slower when running from
  8699.        a remote terminal than when executed on a normal word processor:
  8700.        that's because Searchlight can only send text at the speed of the
  8701.        modem being used, and cannot manipulate the screen at high speeds the
  8702.        way regular text editors can.  However, Searchlight makes extensive
  8703.        use of ANSI control sequences to minimize the amount of text that
  8704.        must be retransmitted to the remote screen. In local mode, it
  8705.        operates at speeds comparable to most full screen text editors.
  8706.  
  8707.        Searchlight determines which editor to use based on the status of the
  8708.        ANSI graphics mode. When ANSI (color or monochrome) is enabled, the
  8709.        full screen editor is used; otherwise, the line editor is used. You
  8710.        can change the status of the ANSI flag from the main menu with the
  8711.        ANSI command.
  8712.  
  8713.  
  8714.  
  8715.  
  8716.        _____________________________________________________________________
  8717.                                         131
  8718.                                    TEXT EDITING
  8719.        _____________________________________________________________________
  8720.  
  8721.  
  8722.         -------------------------------------------------------------------
  8723.        | USING THE LINE EDITOR                                             |
  8724.         -------------------------------------------------------------------
  8725.  
  8726.        When ANSI mode is not selected, Searchlight uses a line oriented
  8727.        editor. The editor is invoked whenever you POST a message or
  8728.        bulletin, EDIT an existing message, or send a message via the MAIL
  8729.        command.
  8730.  
  8731.        When the line editor is running, you'll see the message
  8732.  
  8733.             Enter text; type a period (.) when done.  Max NNN lines.
  8734.  
  8735.        followed by the number "001". NNN is the maximum number of lines that
  8736.        you may enter into the message (it can be anywhere from 5 to 1000,
  8737.        as defined on the conference definition screen in CONFIG).
  8738.  
  8739.        You would now begin typing your message. As you type, you can correct
  8740.        errors by pressing the BACKSPACE key.  There's no need to press the
  8741.        ENTER key when you reach the end of a line; instead, the editor
  8742.        automatically performs "word wrapping", that is, it breaks the line
  8743.        at the nearest word boundary and moves the last word on the line
  8744.        down to the next new line. As you type, you'll see the line numbers
  8745.        to the left of your text increase.
  8746.  
  8747.        When you are done entering text, press the ENTER key once (so that
  8748.        the cursor is directly to the right of a line number).  Then type a
  8749.        single period (.), and press ENTER again. This takes you out of the
  8750.        text insertion mode and places you at the line editor's subcommand
  8751.        prompt, which looks like this:
  8752.  
  8753.             Cont  Edit  Ins  Del  List  Abort  Save  -?
  8754.  
  8755.        You can now enter an editor subcommand by typing the first letter of
  8756.        one of the above command words at the prompt.  The commands work as
  8757.        follows:
  8758.  
  8759.  
  8760.        ----
  8761.        Save
  8762.        ----
  8763.  
  8764.        This is the command that saves the message you just entered (or
  8765.        edited) onto the disk. You use this command when you are done with
  8766.        the message, unless you've changed your mind and decided not to send
  8767.        the message at all.
  8768.  
  8769.  
  8770.  
  8771.  
  8772.  
  8773.  
  8774.  
  8775.        _____________________________________________________________________
  8776.                                         132
  8777.                                    TEXT EDITING
  8778.        _____________________________________________________________________
  8779.  
  8780.  
  8781.        -----
  8782.        Abort
  8783.        -----
  8784.  
  8785.        The abort subcommand can be used to throw away the message in case
  8786.        you decide you don't want to send it. It will prompt you to make
  8787.        sure that's what you really want to do, in order to insure that you
  8788.        don't abort the message by mistake.
  8789.  
  8790.  
  8791.        ----
  8792.        Cont
  8793.        ----
  8794.  
  8795.        The cont, or continue, subcommand lets you continue entering lines at
  8796.        the end of the message. It places you back into the text entry mode
  8797.        at the next highest line number.
  8798.  
  8799.  
  8800.        ----
  8801.        List
  8802.        ----
  8803.  
  8804.        This command can be used to list, or review, the message just
  8805.        entered. It will prompt you for a line number; if you enter 1, or
  8806.        simply press ENTER, the message is listed from line 1 to the end. If
  8807.        you wish the listing to start at a specific line number, you can
  8808.        enter that line number.
  8809.  
  8810.        You can pause the listing with ^S, and cancel it with ^C.
  8811.  
  8812.  
  8813.        ---
  8814.        Ins
  8815.        ---
  8816.  
  8817.        This is the insert command. It lets you insert one or more new lines
  8818.        of text in between two existing lines. You are prompted to enter the
  8819.        number of the line that you want to insert BEFORE; for example, to
  8820.        insert between lines 11 and 12, you'd give line 12 as the target of
  8821.        the insertion.
  8822.  
  8823.        Once in insert mode, you can type as many new lines as you like. To
  8824.        exit back to the subcommand prompt, once again enter a period at the
  8825.        beginning of a new line.
  8826.  
  8827.  
  8828.  
  8829.  
  8830.  
  8831.  
  8832.  
  8833.  
  8834.        _____________________________________________________________________
  8835.                                         133
  8836.                                    TEXT EDITING
  8837.        _____________________________________________________________________
  8838.  
  8839.  
  8840.        ---
  8841.        Del
  8842.        ---
  8843.  
  8844.        The delete command lets you delete one or more entire lines of text
  8845.        from the message. It prompts you to enter the starting and ending
  8846.        line numbers of the range of lines that you want to remove.
  8847.  
  8848.  
  8849.        ----
  8850.        Edit
  8851.        ----
  8852.  
  8853.        This command gives you a way to edit the individual characters on a
  8854.        line. It prompts you for the line number of the line you wish to
  8855.        edit, and gives you a choice:
  8856.  
  8857.             Change or Retype?
  8858.  
  8859.        Respond by pressing "C" to change the line, or "R" to retype it.
  8860.        Retyping simply lets you re-enter the entire line of text from
  8861.        scratch. You can only retype one line at a time.
  8862.  
  8863.        Change gives you the opportunity to edit portions of the line without
  8864.        having to re-key the entire line. It works by prompting you for a
  8865.        "source" and a "replacement" string. The "source" is a portion of
  8866.        the text, exactly as it appears in the line. The "replacement" is a
  8867.        string of text that will replace the source string. As an example,
  8868.        suppose we typed this into our message at line number 7:
  8869.  
  8870.             07 Beethoven was bitten by a roach when he visited New York.
  8871.             08 .
  8872.  
  8873.        Obviously, we meant to type the word "salmon" instead of "roach". To
  8874.        correct it, we would edit the line and enter "roach" as the source
  8875.        string, and "salmon" as the replacement:
  8876.  
  8877.             Cont  Edit  Ins  Del  List  Abort  Save  -? E
  8878.  
  8879.             Line Number: 7
  8880.             Change or Retype? C
  8881.             Source String: roach
  8882.             Replacement  : salmon
  8883.  
  8884.        Although the corrected line is not displayed on the screen, we could
  8885.        view it by using the List subcommand. The new version of the line
  8886.        would look like this:
  8887.  
  8888.             07 Beethoven was bitten by a salmon when he visited New York.
  8889.  
  8890.  
  8891.  
  8892.  
  8893.        _____________________________________________________________________
  8894.                                         134
  8895.                                    TEXT EDITING
  8896.        _____________________________________________________________________
  8897.  
  8898.        Notice that you can replace a string with a string of a different
  8899.        length (or even a null string, in which case the original text is
  8900.        deleted entirely).  However, the total length of the line cannot
  8901.        exceed 76 characters.
  8902.  
  8903.  
  8904.         -------------------------------------------------------------------
  8905.        | EDITING EXISTING MESSAGES                                         |
  8906.         -------------------------------------------------------------------
  8907.  
  8908.        The line editor can also be used to edit existing messages via the
  8909.        "Edit" command on the main menu. When used in this fashion, it
  8910.        operates identically to the above description, except that you'll go
  8911.        right to the "Cont Edit List..." prompt rather than to the "Enter
  8912.        Text" prompt. Saving the message results in the edited version of
  8913.        the message replacing the old version on disk. If you abort the
  8914.        edit, the changes you've made to the message, if any, are not saved;
  8915.        the original message is left intact.
  8916.  
  8917.  
  8918.         -------------------------------------------------------------------
  8919.        | USING THE FULL SCREEN EDITOR                                      |
  8920.         -------------------------------------------------------------------
  8921.  
  8922.        When using an ANSI compatible remote terminal, or when logged in
  8923.        locally, you'll be able to enter and edit text via Searchlight's
  8924.        full screen editor.  The screen editor signs on by displaying an
  8925.        inverse video bar near the top of the screen that contains this
  8926.        message:
  8927.  
  8928.        Editing, max NNN lines | ESC/^Z Exit | F1/^J Help | F6/^P Color Codes
  8929.  
  8930.        If entering a new message, the lower portion of the screen will be
  8931.        clear and the cursor will be positioned at the top of the text entry
  8932.        "window" on the screen. If editing and existing message, you'll see
  8933.        the first few lines of the message, with the cursor positioned at
  8934.        the first character in the first line. You are now ready to enter or
  8935.        edit text.
  8936.  
  8937.        To enter text, simply begin typing. As with the line editor, you can
  8938.        correct single character mistakes as you type by pressing the
  8939.        BACKSPACE key. As you approach the end of a line, the text will
  8940.        "word wrap" down to the next line, so there's no need to press the
  8941.        ENTER key at the end of lines (unless, of course, you wish to type
  8942.        lines shorter than the width of the screen).
  8943.  
  8944.        Unlike the line editor, which has subcommands for performing editing,
  8945.        you can edit text in the full screen mode interactively, using the
  8946.        cursor position keys and control keys. As you change the text, your
  8947.        screen is updated instantly to reflect exactly what the file looks
  8948.        like. If you've ever used a word processor on your IBM PC, you're
  8949.        probably very familiar with this method of editing: you'll need only
  8950.        learn a few of the commands and keystrokes that are specific to the
  8951.        Searchlight editor.
  8952.        _____________________________________________________________________
  8953.                                         135
  8954.                                    TEXT EDITING
  8955.        _____________________________________________________________________
  8956.  
  8957.  
  8958.        ----------------------
  8959.        Wordstar Compatibility
  8960.        ----------------------
  8961.  
  8962.        When we say Searchlight's editor is "WordStar Compatible", what we
  8963.        mean is that, in most cases, we've used the same key sequences to
  8964.        perform the same editing tasks as the Wordstar word processor. We
  8965.        picked Wordstar because its command set is a well-known standard,
  8966.        and because its use of control key sequences (rather than menus or
  8967.        function keys) is particularly suitable for use with modems and
  8968.        remote terminals.
  8969.  
  8970.  
  8971.         -------------------------------------------------------------------
  8972.        | SCREEN EDITOR SUBCOMMANDS                                         |
  8973.         -------------------------------------------------------------------
  8974.  
  8975.        If you press either F2 or ^J (control-J) while in the editing mode,
  8976.        you'll see one of three help messages at the top of your screen.
  8977.        Press F2 again to see the remaining messages. The help text looks
  8978.        like this:
  8979.  
  8980.           Left/^S  Cursor left       ^A  Word left     DEL/^G  Delete char
  8981.          Right/^D  Cursor right      ^F  Word right        ^T  Delete word
  8982.             Up/^E  Cursor up     INS/^V  Insert mode       ^Y  Delete line
  8983.           Down/^X  Cursor down    CR/^N  Insert line       ^B  Reform para
  8984.  
  8985.           PgUp/^R  Page up          ^QR  Top of file      ^QY  Truncate line
  8986.           PgDn/^C  Page down        ^QC  End of file      ^QL  Restore line
  8987.          Home/^QS  Begin of line F3/^KO  View reply-text   ^L  Redraw line
  8988.           End/^QD  End of line   F4/^KG  Get reply-text    ^W  Redraw screen
  8989.  
  8990.          ^OI  Toggle indent mode    ^KP  Message Preview  ^KU  Upload text
  8991.          ^OC  Center line        F5/^KS  Exit & Save    F2/^U  Attach file
  8992.  
  8993.        These are the main editing commands. Many are self-explanatory, some
  8994.        need further study as we'll divulge below.
  8995.  
  8996.        The ^ character means CONTROL. To generate a control key, you hold
  8997.        down the key marked "Ctrl" on your keyboard, then press the
  8998.        indicated letter key, then release both keys.
  8999.  
  9000.        Notice that some commands have two ways of being entered, either via
  9001.        a control key or via a function key. This is done because some
  9002.        remote terminals don't configure the function keys the same way
  9003.        they're supposed to be set up on the true ANSI terminal. If a key
  9004.        such as F1 or HOME doesn't work on your terminal, you can always use
  9005.        the control key instead.
  9006.  
  9007.        Remember to press ESC (or ^Z) to exit the full screen editor. You can
  9008.        also exit by pressing F5 (or ^KS); this skips the "Continue, Save,
  9009.        Abort" prompt and goes directly into "save" mode.
  9010.  
  9011.        _____________________________________________________________________
  9012.                                         136
  9013.                                    TEXT EDITING
  9014.        _____________________________________________________________________
  9015.  
  9016.  
  9017.        ---------------
  9018.        Cursor Movement
  9019.        ---------------
  9020.  
  9021.        To edit text, you must first move the cursor to the character, word,
  9022.        or line that you want to change. The cursor movement keys accomplish
  9023.        this.
  9024.  
  9025.        The four arrow keys (left, right, up, down) move the cursor one
  9026.        character in the indicated direction. If you move up or down past
  9027.        the top or the bottom of the screen, the screen will scroll to
  9028.        display the previous or next line of text. You cannot move the
  9029.        cursor past the beginning or end of the file, but you can append
  9030.        text to the end of the file.
  9031.  
  9032.        Press the HOME key to move the cursor to the beginning of the current
  9033.        line.  The END key takes the cursor to the end of the line.
  9034.  
  9035.        The ^A and ^F keys move you left and right a word at a time. In local
  9036.        modes only, you can use ^LeftArrow and ^RightArrow as well.
  9037.  
  9038.        You can scroll a long message forward and backward one full screen at
  9039.        a time.  Press the PgUp and PgDn keys for this.  On a remote
  9040.        terminal, you must use ^R for pageup and ^C for pagedown.
  9041.  
  9042.        Finally, you can move directly to the beginning or end of the text.
  9043.        Press ^QR to get to the top of the file, ^QC to go to the bottom.
  9044.  
  9045.  
  9046.        --------
  9047.        Deletion
  9048.        --------
  9049.  
  9050.        You can delete text by characters, words, or lines.
  9051.  
  9052.        To delete the character under the cursor, press either DEL or ^G.
  9053.        Pressing the BACKSPACE key deletes the character to the left of the
  9054.        cursor. When you delete text, the text to the right of the cursor
  9055.        moves left to fill the gap left by the deleted characters.
  9056.  
  9057.        Text can be deleted a word at a time. Place the cursor on the first
  9058.        character in the word and press ^T.
  9059.  
  9060.        You can delete all the text on the current line from the cursor
  9061.        position to the end of the line. Press ^QY to perform this function.
  9062.  
  9063.        To delete an entire line, position the cursor anywhere in the line
  9064.        you wish to delete, and press ^Y. When you delete a line, the
  9065.        remaining lines in the message move up to fill the gap left by the
  9066.        deleted line.
  9067.  
  9068.  
  9069.  
  9070.        _____________________________________________________________________
  9071.                                         137
  9072.                                    TEXT EDITING
  9073.        _____________________________________________________________________
  9074.  
  9075.  
  9076.        ---------
  9077.        Insertion
  9078.        ---------
  9079.  
  9080.        Searchlight's editor supports either insert or overstrike mode. In
  9081.        insert mode, text you enter in the middle of a line causes the text
  9082.        to the right of the cursor to shift, making room for the new
  9083.        characters. In overstrike mode, new text overwrites any text
  9084.        underneath it, and no scrolling occurs. The editor is in insert mode
  9085.        each time it starts up, but you can toggle between modes with the
  9086.        INS or ^V key.
  9087.  
  9088.        When insert mode is active, the indicator "Ins" appears at the top of
  9089.        the screen. When overstrike mode is selected, "Ovr" is displayed
  9090.        instead.
  9091.  
  9092.        In insert mode, an attempt to insert characters into a full line
  9093.        causes the line to be split in half at the cursor position. The
  9094.        message "Press ^B to reform paragraph" appears at the top of the
  9095.        screen. After typing your new text, press the ^B key and the
  9096.        subsequent text will move back up and reformat into a paragraph. In
  9097.        overstrike mode, press ^N to force a line break before entering new
  9098.        text.
  9099.  
  9100.        You can also press the ENTER key to enter a new line in the text. In
  9101.        this case, the cursor moves down to next line, rather than remaining
  9102.        stationary as it does with ^N.
  9103.  
  9104.  
  9105.        --------------
  9106.        Error Recovery
  9107.        --------------
  9108.  
  9109.        If you make a mistake, you can restore the contents of the current
  9110.        line provided the cursor has not left the line. Press ^QL for this
  9111.        function.
  9112.  
  9113.  
  9114.        -----------------
  9115.        Reformatting Text
  9116.        -----------------
  9117.  
  9118.        After performing many insert and delete operations, your text will no
  9119.        doubt have lost its original format: you'll have some lines that are
  9120.        shorter than others. Never fear; you can reformat any continuous
  9121.        piece of text back into neat paragraph form by using the ^B command.
  9122.        Simply move the cursor up to the first line in the paragraph and
  9123.        press ^B. The editor will format all the subsequent text into a
  9124.        paragraph, until it reaches a blank line or a line that begins with
  9125.        a space or another non-alphabetic character.
  9126.  
  9127.  
  9128.  
  9129.        _____________________________________________________________________
  9130.                                         138
  9131.                                    TEXT EDITING
  9132.        _____________________________________________________________________
  9133.  
  9134.  
  9135.        -----------
  9136.        Indent Mode
  9137.        -----------
  9138.  
  9139.        Pressing ^OI activates Indent Mode (you'll see the letters "Ind" near
  9140.        the top of the screen when indenting is active). In indent mode, the
  9141.        editor will match your indent when typing lines -- for example, if
  9142.        you manually indent the first line of a paragraph by 5 spaces, then
  9143.        type some text, Searchlight will automatically insert 5 spaces
  9144.        before each new line as the text wordwraps or you press ENTER to end
  9145.        lines. This is useful, for example, when you want to indent an
  9146.        entire block of text.
  9147.  
  9148.        You can reformat indented text with the ^B command; Searchlight will
  9149.        continue to obey the indent, and format the text with the proper
  9150.        number of blank spaces before each line.
  9151.  
  9152.  
  9153.        ---------------
  9154.        Centering Lines
  9155.        ---------------
  9156.  
  9157.        A center line function is provided by pressing the ^OC keys. This
  9158.        command will center the current line of text, and move the cursor
  9159.        down to the next line.
  9160.  
  9161.  
  9162.        ----------
  9163.        Reply Text
  9164.        ----------
  9165.  
  9166.        Often when you reply to a message by selecting the "Reply" option on
  9167.        the menu line, you'll want to be able to read the original message
  9168.        again while you're typing the reply. You may even want to insert a
  9169.        few lines of the original message into the message you're writing.
  9170.        Searchlight provides a way to do this with the "View reply-text" and
  9171.        "Get reply-text" functions.
  9172.  
  9173.        If, while typing a reply, you want to look at the original message
  9174.        again, press F3 (or ^KO). The screen will clear and the text of the
  9175.        message will be displayed. At the end of the message, you'll be
  9176.        prompted to press the ENTER key to go on; when you do so, the editor
  9177.        redraws the screen and returns you to the message you were typing at
  9178.        the exact spot you left off.
  9179.  
  9180.  
  9181.  
  9182.  
  9183.  
  9184.  
  9185.  
  9186.  
  9187.  
  9188.        _____________________________________________________________________
  9189.                                         139
  9190.                                    TEXT EDITING
  9191.        _____________________________________________________________________
  9192.  
  9193.  
  9194.        --------------------------
  9195.        Reply-Quote Line Selection
  9196.        --------------------------
  9197.  
  9198.        The F4 (^KG) key lets you do even more with the original message.
  9199.        When you press F4, Searchlight places the original text into a
  9200.        selection mode that lets you review the text and tag specific lines
  9201.        for importing into your editing screen.
  9202.  
  9203.        To begin the reply-quote process, reply to a message and press F4 or
  9204.        ^KG:
  9205.  
  9206.         SpaceBar: Mark/Unmark Line  F4/F5: Mark/Unmark All  Enter when Done
  9207.         |Greetings!
  9208.         |    Received SLBBS today and am delighted! In only an hour I have
  9209.         |the main makings of the BBS and a couple of friends are equally
  9210.         |amazed with what's been done in a small part of one afternoon!!
  9211.         |
  9212.        *|    So far... not a single hitch in setting this thing up... of
  9213.        *|course I can see that my first problem is going to be resisting
  9214.        *|Conferences... they are almost _too_ easy the urge to have
  9215.        *|ump-teen hundred different to setup :)
  9216.         |
  9217.         |    Congrats on an absolute DYNAMITE program!
  9218.         |
  9219.         |Regards,
  9220.         |Bob
  9221.        <End of Listing>
  9222.  
  9223.        The full-screen display can be paged and scrolled by using the
  9224.        standard cursor control keys, including page up and down, home and
  9225.        end, and the arrow keys. To "quote" some lines, position the cursor
  9226.        to the left of the desired line, and press the spacebar. An asterisk
  9227.        appears to the left of the line, indicating that it is tagged;
  9228.        continue pressing spacebar to tag more lines in succession. In the
  9229.        example above, four lines starting with the text "So far..." have
  9230.        been selected for quoting. If a mouse is available, you can tag
  9231.        lines by clicking on the area to the left of the line. You can untag
  9232.        lines by clicking or pressing spacebar on the line again; or press
  9233.        F4 or F5 to automatically tag or untag all lines.
  9234.  
  9235.        Once the desired lines are tagged, press Enter or ESC. The tagged
  9236.        lines are imported into your reply:
  9237.  
  9238.           >    So far... not a single hitch in setting this thing up... of
  9239.           >course I can see that my first problem is going to be resisting
  9240.           >the urge to have ump-teen hundred different Conferences... they
  9241.           >are almost _too_ easy to setup :)
  9242.  
  9243.        If desired, you can tag more lines later by pressing F4 or ^KG again,
  9244.        and repeating the process.
  9245.  
  9246.  
  9247.        _____________________________________________________________________
  9248.                                         140
  9249.                                    TEXT EDITING
  9250.        _____________________________________________________________________
  9251.  
  9252.        Wise use of the reply-text function can aid you in replying to a long
  9253.        message with many specific points, and it can help end ambiguous
  9254.        electronic mail replies by reminding the original sender what
  9255.        question or statement is being addressed by your letter.
  9256.  
  9257.  
  9258.        -----------------
  9259.        Message Uploading
  9260.        -----------------
  9261.  
  9262.        Uploading a text file as a message to Searchlight BBS is accomplished
  9263.        by pressing ^KU. The file to be uploaded should be a plain text file
  9264.        with lines of no longer than 76 characters, and the total length of
  9265.        the message should be no larger than the total number of lines
  9266.        permitted to be entered for the current message area.
  9267.  
  9268.        Upon pressing ^KU, Searchlight prompts you to select a protocol and
  9269.        then begin sending your file. Upon completion of the transfer,
  9270.        Searchlight loads the text file into the editor. At this point, the
  9271.        text can be saved immediately or edited.
  9272.  
  9273.        If any text is already in the message editor prior to an upload (such
  9274.        as if you have typed some text in manually) then the uploaded text
  9275.        is appended to the text already present. If desired, two or more
  9276.        uploads can be used to create one large message from several smaller
  9277.        message files.
  9278.  
  9279.        Searchlight can use any of its internal protocols, including Zmodem,
  9280.        Xmodem, Xmodem/CRC or Xmodem/1K for message uploads. Select a
  9281.        default internal protocol on the Options/Preference screen.
  9282.        Searchlight automatically truncates lines longer than 76 characters,
  9283.        filters any non-text characters from an attempted upload, and
  9284.        truncates the entire message if it is longer than the maximum
  9285.        allowed message length. Should any of these modifications occur, a
  9286.        warning message appears following the upload to inform the user of
  9287.        the situation.
  9288.  
  9289.  
  9290.        ---------------
  9291.        Message Preview
  9292.        ---------------
  9293.  
  9294.        The ^KP key sequence provides a message preview feature (a display
  9295.        showing what the message will look like when it is read back later).
  9296.        The preview shows how color codes and included files will look (see
  9297.        the next two sections for information about color codes and file
  9298.        inclusion).
  9299.  
  9300.  
  9301.  
  9302.  
  9303.  
  9304.  
  9305.  
  9306.        _____________________________________________________________________
  9307.                                         141
  9308.                                    TEXT EDITING
  9309.        _____________________________________________________________________
  9310.  
  9311.  
  9312.        ------------------
  9313.        ANSI Compatibility
  9314.        ------------------
  9315.  
  9316.        Searchlight's full screen editor actually has three modes of
  9317.        operation, designed to allow it to interface with a variety of
  9318.        popular terminal software. When editing remotely using an ANSI
  9319.        terminal, certain operations (such as inserting and deleting lines)
  9320.        require that the terminal software implement the appropriate ANSI
  9321.        escape sequences that will cause the remote screen to scroll
  9322.        appropriately. Unfortunately, many terminal programs do not support
  9323.        the required commands. To work with such terminals, Searchlight
  9324.        includes a Generic ANSI mode. To select the editor's mode of
  9325.        operation, type the Options command (on Searchlight's main menu) and
  9326.        adjust the "Ansi Compatibility Mode". There are three possible
  9327.        settings: Generic, Procomm, and Full.
  9328.  
  9329.        In Generic mode, the Searchlight editor minimizes the types of ANSI
  9330.        commands sent to the terminal to a small subset of the most widely
  9331.        supported ones.  Instead of scrolling the screen and performing
  9332.        inserts and deletes directly on the terminal, Searchlight redraws
  9333.        portions of the screen when a change needs to be made.
  9334.  
  9335.        In Full mode, Searchlight will edit with the full set of ANSI
  9336.        commands for the fastest possible output, and will require a full
  9337.        featured ANSI terminal.  The remaining mode, Procomm, is similar to
  9338.        Full but takes into account several quirks found in the Procomm
  9339.        terminal software.
  9340.  
  9341.        The New User Registration procedure displays information about ANSI
  9342.        modes, and prompts each new user for the correct mode as they log
  9343.        in.
  9344.  
  9345.  
  9346.        ----------------
  9347.        RIP Mode Editing
  9348.        ----------------
  9349.  
  9350.        When using Searchlight in RIP graphics mode, in addition to the
  9351.        keyboard commands, you can use your mouse to select options like
  9352.        Save by pressing the buttons on screen. In addition, a scroll bar is
  9353.        provided for navigating through the message.
  9354.  
  9355.  
  9356.  
  9357.  
  9358.  
  9359.  
  9360.  
  9361.  
  9362.  
  9363.  
  9364.  
  9365.        _____________________________________________________________________
  9366.                                         142
  9367.                                    TEXT EDITING
  9368.        _____________________________________________________________________
  9369.  
  9370.  
  9371.         -------------------------------------------------------------------
  9372.        | EMBEDDED COLOR CODES                                              |
  9373.         -------------------------------------------------------------------
  9374.  
  9375.        One command that appears on the full screen editor's menu bar that we
  9376.        didn't mention yet is the F6/^P command, Display Color Codes. If you
  9377.        press F6 (or control-p) while within the editor, Searchlight will
  9378.        display a menu of two- character color codes in the help window at
  9379.        the top of the screen. By typing these codes into your messages, you
  9380.        can make your text appear in different colors.
  9381.  
  9382.        Here are the color codes as displayed by the editor:
  9383.  
  9384.         \BK  Black  \RD  Red     \DG  Dk. Gray   \LR  Lt. Red   \IV  Invrse
  9385.         \BL  Blue   \MG  Magenta \LB  Lt. Blue   \YE  Yellow    \BI  Blink
  9386.         \GR  Green  \BR  Brown   \LG  Lt. Green  \LM  Lt. Mag.  \NO  Normal
  9387.         \CY  Cyan   \GY  Gray    \LC  Lt. Cyan   \WH  White
  9388.  
  9389.        If you have a color CRT, the menu will appear in 16 different colors.
  9390.        On monochrome screens, the first eight colors will appear as normal
  9391.        text, the remaining eight as bright or highlighted text.
  9392.  
  9393.        To use color, just enter the above sequences into your message text.
  9394.        For example, if you wrote
  9395.  
  9396.             Jim left the \BLblue\NO book by the \GRgreen\NO tree,
  9397.  
  9398.        The words "blue" and "green" would appear blue and green when you
  9399.        read the message back. The \NO code is used to reset the color back
  9400.        to the "normal" text color (as defined in the CONFIG menus). If you
  9401.        want to insert the "\" character itself into your message, enter
  9402.        "\\".
  9403.  
  9404.        The inverse code, \IV, reverses the foreground and background colors.
  9405.        On monochrome screens, \IV provides a black-on- white display. With
  9406.        a color CRT, you can create any background/ foreground combination;
  9407.        for example,
  9408.  
  9409.             \BL\IV\WH This text will be printed white-on-blue. \NO
  9410.  
  9411.        Searchlight translates embedded color codes according to the ANSI
  9412.        graphics mode selected at login. If monochrome mode is selected,
  9413.        only normal, highlight, inverse, and underline attributes are used.
  9414.        In non-ANSI modes, no colors or attributes are used at all, but the
  9415.        color codes are still removed from the text; therefore, text with
  9416.        embedded color codes will appear readable in any of the three
  9417.        graphics modes.
  9418.  
  9419.        If you'd like to see what the actual colors you are using will look
  9420.        like, use the message preview command (^KP).
  9421.  
  9422.  
  9423.  
  9424.        _____________________________________________________________________
  9425.                                         143
  9426.                                    TEXT EDITING
  9427.        _____________________________________________________________________
  9428.  
  9429.        Finally, note that color codes are not restricted to the full screen
  9430.        editor.  You can insert color codes into messages using the line
  9431.        editor, and you can also use them in login screens, include files,
  9432.        custom menus, and other text files displayed by Searchlight.
  9433.  
  9434.  
  9435.         -------------------------------------------------------------------
  9436.        | MESSAGE MACROS                                                    |
  9437.         -------------------------------------------------------------------
  9438.  
  9439.        Searchlight provides a wide range of message macros. These macros
  9440.        are special three character sequences -- very similar to color codes
  9441.        -- that can be inserted into messages, text files, and other places
  9442.        where color codes are allowed.  When read back, these macros are
  9443.        expanded by Searchlight to display information.
  9444.  
  9445.        For example, the macro "\SB" stands for "Current Conference". When
  9446.        this three character sequence appears in a message, text file, or
  9447.        menu prompt, it's replaced with the name of the current conference.
  9448.        Searchlight's default main menu uses this sequence as part of its
  9449.        prompt.
  9450.  
  9451.        Here is the complete list of macros available:
  9452.  
  9453.        Macro  Description                      Macro  Description
  9454.        ==================================================================
  9455.         \FD   Current File Directory            \%@   Last caller's alias
  9456.         \%A   User's BBS Access Level           \%R   Effective Baud Rate
  9457.         \%X   Name user logged on with          \%N   Current User's Name
  9458.         \%K   Current User's First Name         \%V   Current time
  9459.         \%F   User's FILES Access Level         \%W   Current date
  9460.         \%T   User's time limit, in minutes     \%S   BBS System Name
  9461.         \%#   Total calls to the BBS to date    \%B   Current Baud Rate
  9462.         \%G   ANSI Graphics Mode (C, M, or N)   \%I   User's alias name
  9463.         \%L   Time the user logged in (HH:MM)   \%$   Last caller's name
  9464.         \%Q   The quote left by the last user   \SB   Current Conference
  9465.         \%P   Active Communications Port (0-4)  \%?   Date of last loggon
  9466.         \%H   Current Conference (Same as \SB)
  9467.         \%Z   Long date (e.g., "April 3, 1998")
  9468.         \%O   Node Number (Multiuser systems only)
  9469.         \%D   Current File Directory (Same as \FD)
  9470.         \%C   Sysop `Chat Available' status (Y or N)
  9471.         \%J   Alias name with spaced replaced by underbars
  9472.         \%E   External port number (port BBS is monitoring)
  9473.         \%U   Current User's Name, with spaces replaced by underbars
  9474.         \%M   Amount of time left in current session (in minutes)
  9475.         \%Y   Name user logged on with (spaces replaced by underbars)
  9476.         \%&   Total number of calls the current user has made
  9477.  
  9478.  
  9479.  
  9480.  
  9481.  
  9482.  
  9483.        _____________________________________________________________________
  9484.                                         144
  9485.                                    TEXT EDITING
  9486.        _____________________________________________________________________
  9487.  
  9488.  
  9489.  
  9490.         -------------------------------------------------------------------
  9491.        | BINARY FILE ATTACHMENT                                            |
  9492.         -------------------------------------------------------------------
  9493.  
  9494.        Searchlight allows you to "attach", or associate, a binary file
  9495.        (i.e., a file of any type) with a message. The attached file can be
  9496.        downloaded at the time the message is read. File attachment is a
  9497.        convenient way to send files privately through email, and can also
  9498.        be used with public messages.
  9499.  
  9500.        To attach a file to a message, press F2 (or ^U) in the message editor
  9501.        when entering (or editing) the message. Searchlight prompts you
  9502.        with:
  9503.  
  9504.             Enter Name of File to attach to message:
  9505.             >
  9506.  
  9507.        There are two ways to respond to this prompt. If you're using
  9508.        Searchlight as a normal user (not the Sysop) and logged in from a
  9509.        remote terminal, enter the desired filename here. Searchlight then
  9510.        prompts you to upload the file, first selecting one of the internal
  9511.        file protocols. Assuming the file is uploaded successfully, it is
  9512.        stored in the "File Attach Path" as defined in your CONFIG file, and
  9513.        "attached" to the message.
  9514.  
  9515.        If you're logged on as the Sysop, you can also specify the complete
  9516.        path to a file that exists on your local hard drive here.  For
  9517.        example:
  9518.  
  9519.             C:\SLBBS\SYSOP\MYFILE.ZIP
  9520.  
  9521.        Instead of initiating a file transfer, Searchlight copies this file
  9522.        into the attach directory.
  9523.  
  9524.        Note that each file that's attached to a message must have a unique
  9525.        filename.  If you try to attach a file with the same filename as
  9526.        another file attachment, Searchlight will inform you that the file
  9527.        already exists. You need to choose another name for the file.
  9528.  
  9529.  
  9530.        --------------------------
  9531.        Downloading Attached Files
  9532.        --------------------------
  9533.  
  9534.        Whenever you read a message that has a file attachment (whether in
  9535.        your mailbox, or a public message or bulletin) Searchlight will
  9536.        inform you of the file attachment, and ask if you'd like to download
  9537.        the file. If you do want to download it, you'll be prompted to
  9538.        choose a protocol, and the transfer begins.
  9539.        
  9540.  
  9541.  
  9542.        _____________________________________________________________________
  9543.                                         145
  9544.                                    TEXT EDITING
  9545.        _____________________________________________________________________
  9546.  
  9547.        Note that there is no upload ratio associated with attached files;
  9548.        they're treated as part of a message, and anyone who has permission
  9549.        to read a message that has a file attachment can also download the
  9550.        file. However, time limits are enforced; if you don't have enough
  9551.        time to download the attached file, the download is disallowed.
  9552.  
  9553.        If you have a multiuser system, it is important that each node in
  9554.        your system has the same file attach path. Otherwise, files attached
  9555.        to a message in one node won't be accessible from another node.
  9556.  
  9557.  
  9558.        --------------------------
  9559.        Maintaining Attached Files
  9560.        --------------------------
  9561.  
  9562.        All file attachments are stored in the "File Attach Path" defined in
  9563.        your CONFIG program (see "File Pathnames Setup" in this manual for
  9564.        details).  These files remain on your disk until the message to
  9565.        which they are attached is deleted (or, if the message is
  9566.        carbon-copied to a number of users, until the last copy of the
  9567.        message is deleted).
  9568.  
  9569.        You can manually maintain attached files in several ways. If you edit
  9570.        a message that contains an attached file, you can remove or replace
  9571.        the file attachment by pressing F2 to attach another file. The new
  9572.        file replaces the old one.
  9573.  
  9574.        You can also delete files from the attach directory directly from the
  9575.        command prompt or Windows explorer, even if you do not know to what
  9576.        message the file is attached. If that message is later read,
  9577.        Searchlight simply displays a message to the effect that the
  9578.        attached file is no longer available for download. You may wish to
  9579.        perform this kind of maintenance periodically in case a large number
  9580.        of file attachments build up in your system and aren't deleted.
  9581.  
  9582.  
  9583.         -------------------------------------------------------------------
  9584.        | USING PREPARED TEXT FILES                                         |
  9585.         -------------------------------------------------------------------
  9586.  
  9587.        Sometimes, instead of typing a message by hand, you'll want to insert
  9588.        a previously written file of text into a message, bulletin, or
  9589.        electronic letter. There are several ways to accomplish this with
  9590.        the Searchlight's editors.
  9591.  
  9592.  
  9593.        ---------
  9594.        Uploading
  9595.        ---------
  9596.  
  9597.        The simplest way to insert a text file into a message is to log on
  9598.        from a remote location using a terminal that's capable of file
  9599.        transfers. By pressing ^KU in the full screen message editor, you
  9600.  
  9601.        _____________________________________________________________________
  9602.                                         146
  9603.                                    TEXT EDITING
  9604.        _____________________________________________________________________
  9605.  
  9606.        can begin a file transfer of your text file, which will be loaded
  9607.        into the editor upon completion of the transfer.
  9608.        
  9609.        There are a couple of things to look out for when using this method
  9610.        of sending text. First, the text file should not contain lines
  9611.        longer than 76 characters; if it does, Searchlight will try to
  9612.        wordwrap the text, resulting in a sloppy format. Also make sure the
  9613.        text doesn't exceed the maximum line length of the message.
  9614.  
  9615.        You can't send text that contains embedded ANSI escape sequences,
  9616.        such as text that moves the cursor around on the screen or effects
  9617.        color changes (although eight-bit IBM graphics characters can be
  9618.        used). If you want embedded control codes, use one of the other
  9619.        methods for inserting text into messages.
  9620.  
  9621.  
  9622.        -------------
  9623.        Loading Files
  9624.        -------------
  9625.  
  9626.        The text editors feature a special function, executable only by
  9627.        Sysops, that lets you load a text file directly into a message.  To
  9628.        use it, press ESC and then "L" for the full screen editor, or press
  9629.        "F" at the subcommand prompt of the line editor.
  9630.  
  9631.        The editor will prompt you for a filename, and load the text of the
  9632.        specified file into the message. You can give a full pathname and
  9633.        drive letter if you want.
  9634.  
  9635.  
  9636.        ------------------------
  9637.        The %%FILENAME Directive
  9638.        ------------------------
  9639.  
  9640.        A third method of including text in messages is to use the
  9641.        `%%FILENAME' directive inside of a message. This method involves
  9642.        placing a special line within the message. It doesn't matter which
  9643.        editor you use to create the message. Let's suppose we have a text
  9644.        file called "PHONE.TXT" that we wish to include in a message we're
  9645.        sending to someone. We could write the following:
  9646.  
  9647.             01 Bill,
  9648.             02 Here's that phone number list I promised you:
  9649.             03
  9650.             04 %%PHONE.TXT
  9651.             05
  9652.             06 Enjoy.
  9653.  
  9654.        When we list, save, or edit this message later on, it looks exactly
  9655.        like the six lines shown above. However, when the message is read by
  9656.        Searchlight's read routines, something special happens when line 4
  9657.        is encountered. Instead of printing line 4 verbatim, Searchlight
  9658.        looks into a special directory for a file called PHONE.TXT, and
  9659.  
  9660.        _____________________________________________________________________
  9661.                                         147
  9662.                                    TEXT EDITING
  9663.        _____________________________________________________________________
  9664.  
  9665.        displays the contents of that file on the screen. When the PHONE.TXT
  9666.        file is done, Searchlight goes back and prints out lines 5 and 6.
  9667.  
  9668.        The `%%FILENAME' directive is convenient because the included file
  9669.        doesn't take space in Searchlight's message file, doesn't have to be
  9670.        less than 1000 lines long, and can contain any ANSI sequences that
  9671.        you desire. Notice, however, that you may give ONLY a filename with
  9672.        this directive, NOT a drive letter or pathname. The text file must
  9673.        reside in the directory you designated as the "include" directory
  9674.        when configuring your system via the CONFIG program. This is done
  9675.        for the purpose of security; since anyone can enter a `%%' directive
  9676.        into a message, you want to ensure that users don't try to read
  9677.        files which they don't have access to. It is assumed that anything
  9678.        in the "include" directory is public knowledge.
  9679.  
  9680.        The `%%' characters must be in the first column on the line, and the
  9681.        line must not contain any other text after the filename. You can
  9682.        have more than one include file in a particular message, however.
  9683.  
  9684.        If you only use file inclusion yourself, it doesn't matter what you
  9685.        choose as your "include" directory, as long as you store all the
  9686.        files which you want to include in messages there. However, if you
  9687.        want your users to be able to upload files to the system and include
  9688.        them in messages, make the "include" directory accessible via the
  9689.        FILES system; that is, define a file directory that uses the include
  9690.        directory to store the uploads. This way, your users will be able to
  9691.        upload files to the include directory, and access them in messages
  9692.        they post or send. Using include files this way, for example, is the
  9693.        only way to allow users to post messages containing ANSI escape
  9694.        sequences on your BBS.
  9695.  
  9696.  
  9697.        ------------------------
  9698.        The @@FILENAME Directive
  9699.        ------------------------
  9700.  
  9701.        In addition to including files in the "include" directory, we've
  9702.        also provided a way to access files in your "text" directory from
  9703.        within a message. It's similar to the "%%filename" construct used
  9704.        above, but you type "@@filename" instead.
  9705.  
  9706.        This directive lets you access any of your system's text files --
  9707.        including custom menus, help files, login screens, etc. -- from
  9708.        within a message. We don't recommend letting your users have upload
  9709.        access to your TEXT directory, however, since these text files are
  9710.        used by Searchlight BBS and you'll want to remain in total control
  9711.        of their
  9712.  
  9713.  
  9714.  
  9715.  
  9716.  
  9717.  
  9718.  
  9719.        _____________________________________________________________________
  9720.                                         148
  9721.                                   FILES SUBSYSTEM
  9722.        _____________________________________________________________________
  9723.  
  9724.  
  9725.         -------------------------------------------------------------------
  9726.        | SEARCHLIGHT BBS FILE TRANSFER SYSTEM                              |
  9727.         -------------------------------------------------------------------
  9728.  
  9729.  
  9730.        ------------
  9731.        Introduction
  9732.        ------------
  9733.  
  9734.        With file transfer, Searchlight gives you the ability to transmit
  9735.        files of any type from one computer to another, with the capability
  9736.        to check for errors. It lets you set up multiple directories where
  9737.        users can "upload" a file or choose from a selection of files to
  9738.        "download". You can have as many file directories as you need, and,
  9739.        if desired, you can use a different set of directories for each
  9740.        message conference on your system, giving you thousands of possible
  9741.        directory setups. As the sysop, you can assign different access
  9742.        levels to control what users have access to what files.
  9743.  
  9744.        The Searchlight file system has many useful features: alphabetical
  9745.        and chronological directory listings, wildcard directories, global
  9746.        directory scans, three built-in plus nine external transfer
  9747.        protocols, password protection, and private file transfers. Batch
  9748.        uploading and downloading are supported. Users can view the internal
  9749.        directory of ZIP, ARJ or LHARC files while online. Sysops can delete
  9750.        files, move and copy files between directories, and import filenames
  9751.        from existing files on disk quickly and easily. You can modify file
  9752.        descriptions and other information after it's been entered.
  9753.  
  9754.  
  9755.        ----------------------
  9756.        Setting Up Directories
  9757.        ----------------------
  9758.  
  9759.        Before you can use Searchlight's file transfer system, you need to
  9760.        set up directories from which to transfer files.  Directory setup is
  9761.        accomplished via the CONFIG program, as covered at the beginning of
  9762.        this manual (see p.  55).  Although the directory setup facility is
  9763.        easy to use, it's worth noting that you should create the actual DOS
  9764.        directories you want to use with Searchlight before defining them in
  9765.        CONFIG.
  9766.  
  9767.        A word about what we mean by "file transfer directories". You are
  9768.        undoubtedly aware that the operating system uses directories and
  9769.        subdirectory structures. For the purposes of Searchlight, however,
  9770.        we will be defining our own directory structure, partly to afford a
  9771.        greater level of security than is available with DOS, partly to
  9772.        extend the functionality of the directory beyond what DOS provides.
  9773.        Still, your upload/download directories can, and should, be
  9774.        constructed so that they correspond to actual DOS directories.
  9775.  
  9776.  
  9777.  
  9778.        _____________________________________________________________________
  9779.                                         149
  9780.                                   FILES SUBSYSTEM
  9781.        _____________________________________________________________________
  9782.  
  9783.        One directory that almost every BBS has is called UPLOADS, and it's
  9784.        used to contain all the "new and recently uploaded" files on the
  9785.        system. As an example, we will create this directory in the "root"
  9786.        directory of the C:  drive. The proper command, from the DOS prompt,
  9787.        would be:
  9788.  
  9789.             MKDIR C:\UPLOADS
  9790.  
  9791.        Next, we have to configure the FILES program to use the new UPLOADS
  9792.        directory. Run CONFIG and select option C at the main menu; then
  9793.        press F1 to add a directory. At the prompts, enter `UPLOADS' as the
  9794.        directory name, and `C:\UPLOADS' as the path. Searchlight creates an
  9795.        UPLOADS.SL2 file (which holds such information as file
  9796.        descriptions).
  9797.  
  9798.        Repeat this procedure to create other directories as needed.
  9799.  
  9800.  
  9801.        ------------------------------
  9802.        Setting A Default Text Message
  9803.        ------------------------------
  9804.  
  9805.        You can create a message that will be displayed automatically each
  9806.        time the FILES program is run. This message can contain any
  9807.        instructions or comments that you wish to give each time someone
  9808.        enters the file transfer system.
  9809.  
  9810.        The FILES default message is a text file called FILES.TXT and/or
  9811.        FILES.ANS.  It must be located in your user-defined "text"
  9812.        directory. As with BBS text files, you can either provide both a
  9813.        .TXT and an .ANS version of the file, or just the .TXT version,
  9814.        which will be delivered to everyone. The FILES text message is
  9815.        optional; if you don't provide one, no error message will be
  9816.        generated.
  9817.  
  9818.  
  9819.        -----------------
  9820.        Loading Filenames
  9821.        -----------------
  9822.  
  9823.        Normally, Searchlight enters new filenames and descriptions into its
  9824.        directories as files are uploaded to the system.  However, you may
  9825.        have an existing library of files which you wish to include in your
  9826.        BBS directories.  Searchlight provides two commands, 2-Sysop/Get and
  9827.        2-Sysop/Import, which facilitate the loading of existing files from
  9828.        disk and the importing of existing filename/description lists. These
  9829.        commands are described in more detail below.
  9830.  
  9831.  
  9832.  
  9833.  
  9834.  
  9835.  
  9836.  
  9837.        _____________________________________________________________________
  9838.                                         150
  9839.                                   FILES SUBSYSTEM
  9840.        _____________________________________________________________________
  9841.  
  9842.  
  9843.         -------------------------------------------------------------------
  9844.        | USING THE FILE TRANSFER SYSTEM                                    |
  9845.         -------------------------------------------------------------------
  9846.  
  9847.        To use the file transfer system, log in to Searchlight and execute
  9848.        the FILES command from the main menu. You'll see a message
  9849.        indicating that the files system is active, followed by your text
  9850.        message (if you created one), and finally a command prompt similar
  9851.        to Searchlight's main menu prompt. From here, you can execute the
  9852.        FILES system commands, as we'll describe in a moment.
  9853.  
  9854.        If no conference-specific .DIR file exists for the conference you're
  9855.        using when you execute FILES, all accessible directories defined in
  9856.        CONFIG are available. If a particular conference's .DIR file is
  9857.        available, it is loaded, and the message "Loading Conference
  9858.        Directories" appears, informing you that a special group of file
  9859.        directories, available only from that conference, is becoming
  9860.        available.  information about custom file directory setups).
  9861.  
  9862.  
  9863.        ---------------------
  9864.        Files System Commands
  9865.        ---------------------
  9866.  
  9867.        Accessing the FILES system presents you with a new command prompt and
  9868.        a new set of commands. The new prompt works the same way as
  9869.        Searchlight's main command prompt; it allows you to enter commands
  9870.        by typing the first letter of the command or by scrolling through
  9871.        the commands with the SPACEBAR and BACKSPACE keys, it will list
  9872.        available commands via the "Help" command, and it will display an
  9873.        explanation of each command when the F1 key is pressed.  The name
  9874.        and letter of the currently active file directory is displayed to
  9875.        the left of the prompt. To return to the message system, use the
  9876.        "Quit" command.
  9877.  
  9878.  
  9879.        ---------
  9880.        Protocols
  9881.        ---------
  9882.  
  9883.        You can select an upload/download protocol using the Xproto command.
  9884.        Xmodem, CRC Xmodem, Ymodem and Zmodem protocols are available by
  9885.        default; in addition, up to 9 external protocols can be installed.
  9886.  
  9887.  
  9888.        -----------
  9889.        Downloading
  9890.        -----------
  9891.  
  9892.        Files in the currently active directory can be downloaded, or sent
  9893.        from your BBS to a remote terminal, via the Download command. (See
  9894.        note below regarding file transfer during a local login).
  9895.  
  9896.        _____________________________________________________________________
  9897.                                         151
  9898.                                   FILES SUBSYSTEM
  9899.        _____________________________________________________________________
  9900.  
  9901.        If a user's download/upload ratio exceeds the maximum value assigned
  9902.        to them, no downloading is allowed until the user has uploaded
  9903.        enough to reduce his or her ratio to within the allowed range
  9904.        ("free" downloads are exempted).
  9905.  
  9906.        Multiple file downloads are allowed for external protocols if the
  9907.        external protocol supports it. To specify multiple files, give one
  9908.        or more filenames or wildcard specifications when inputting the name
  9909.        of the file to be downloaded (use blank spaces to separate
  9910.        filespecs). All files must reside in the same directory.
  9911.  
  9912.        The approximate time for the download is computed before the file
  9913.        transfer begins. If the time to download the file exceeds the amount
  9914.        of time left in the current user's session, the download is not
  9915.        allowed.
  9916.  
  9917.  
  9918.        ---------
  9919.        Uploading
  9920.        ---------
  9921.  
  9922.        Use the Upload command to upload files to Searchlight. "Uploading"
  9923.        means to send a file from the remote terminal to the BBS. The remote
  9924.        terminal must support one of the file transfer protocols used on the
  9925.        BBS system.
  9926.  
  9927.        For upload protocols which support only single file uploads, you must
  9928.        enter the exact filename of the file you wish to send. External
  9929.        protocols which have been configured to allow for "batch" uploading
  9930.        will allow you to specify anywhere from zero to 40 filenames and
  9931.        descriptions before uploading begins.  If no filenames or
  9932.        descriptions are specified prior to a batch upload, you'll be
  9933.        prompted for a description when the upload completes.
  9934.  
  9935.        Before an upload begins, Searchlight checks available directories to
  9936.        see if any file of the same name already exist on your BBS. If the
  9937.        file is a duplicate, the message
  9938.  
  9939.             File <filename> already exists.
  9940.  
  9941.        will appear. For non-batch uploads or for batch uploads where all of
  9942.        the specified files exist, Searchlight will abort the upload at this
  9943.        point. Note that the upload is not aborted when one of several
  9944.        filenames in a batch upload is found. In this case, the uploader
  9945.        should simply not send the duplicate file(s). A properly configured
  9946.        external protocol command should not accept duplicate files in the
  9947.        same directory, but may accept duplicates if the duplicate is in
  9948.        another directory area.
  9949.  
  9950.  
  9951.  
  9952.  
  9953.  
  9954.  
  9955.        _____________________________________________________________________
  9956.                                         152
  9957.                                   FILES SUBSYSTEM
  9958.        _____________________________________________________________________
  9959.  
  9960.  
  9961.        ---------------
  9962.        Upload AutoDoor
  9963.        ---------------
  9964.  
  9965.        You can add procedures to Searchlight that process files immediately
  9966.        after uploading by using an Upload AutoDoor. The upload autodoor is
  9967.        a program or batch file you can set up in the CONFIG program (see
  9968.        the section "Configuration - Searchlight BBS AutoDoors Setup").
  9969.        Upload autodoors can process newly uploaded files in the UPLOADS.BBS
  9970.        directory before they're registered in Searchlight: you can scan new
  9971.        uploads for viruses, repackage archives, remove unwanted file types,
  9972.        etc. Whatever files remain in the UPLOADS.BBS area after the
  9973.        autodoor processing is complete are the files actually seen by
  9974.        Searchlight as the new uploads.
  9975.  
  9976.        Note: Since upload autodoor processing takes place while a user is
  9977.              online and waiting, autodoor processing should be as brief as
  9978.              possible.
  9979.  
  9980.  
  9981.        ---------------------
  9982.        FILE_ID.DIZ Importing
  9983.        ---------------------
  9984.  
  9985.        Searchlight can automatically import file descriptions from ZIP, ARJ,
  9986.        LZH or ARC files as the files are uploaded, provided that the file
  9987.        contains an internal text file called FILE_ID.DIZ or DESC.SDI. A
  9988.        special program called FILEINFO.EXE is provided for the purpose of
  9989.        importing file descriptions. This program runs like an upload
  9990.        autodoor, except that it is called directly by Searchlight BBS after
  9991.        an upload (and after the regular upload autodoor, if one is
  9992.        defined). There is no need to explicitly run the FILEINFO program
  9993.        from your upload autodoor.
  9994.  
  9995.        FILEINFO.EXE searches the UPLOADS.BBS directory for ZIP, ARJ, LZH and
  9996.        ARC files. When such files are found, it attempts to extract a file
  9997.        called FILE_ID.DIZ or DESC.SDI by making a call to the appropriate
  9998.        archive program.  In order to support unpacking of all file types,
  9999.        you need to have the following programs available on your system:
  10000.        PKUNZIP.EXE, ARJ.EXE, LHA.EXE, and PKUNPAK.EXE. The archive programs
  10001.        can be in any directory that is pointed to by your PATH statement.
  10002.  
  10003.        If the FILEINFO program is successful in extracting a FILE_ID.DIZ or
  10004.        DESC.SDI file, it packs the contents into a temporary file, which is
  10005.        read by Searchlight upon completion of the upload. Both the
  10006.        temporary file and the unpacked FILE_ID.DIZ or DESC.SDI file are
  10007.        automatically deleted.
  10008.  
  10009.        Imported descriptions appear in the file directory list just as if
  10010.        they had been typed in manually. After uploading, Searchlight does
  10011.        not prompt the user to enter a manual description if a description
  10012.        has been imported.
  10013.  
  10014.        _____________________________________________________________________
  10015.                                         153
  10016.                                   FILES SUBSYSTEM
  10017.        _____________________________________________________________________
  10018.  
  10019.        The FILEINFO.EXE program must be placed in your Primary or Alternate
  10020.        Program Path for Searchlight to find it. (If you wish to disable
  10021.        automatic importing of descriptions, delete the FILEINFO.EXE
  10022.        program).
  10023.  
  10024.        Since the FILEINFO.EXE program makes calls to archive programs like
  10025.        PKUNZIP and ARJ, problems can occur if there is insufficient memory
  10026.        available to run these programs (such as if you are running
  10027.        Searchlight in a small DESQview window). We have run it successfully
  10028.        in a 400k window.
  10029.  
  10030.        Because it shells to archive programs, when the FILEINFO program runs
  10031.        you will notice that your local screen will become cluttered with
  10032.        the output of the archive programs. This output is hidden from the
  10033.        remote caller, however.
  10034.  
  10035.  
  10036.        ----------------------------
  10037.        Bi-Directional File Transfer
  10038.        ----------------------------
  10039.  
  10040.        Searchlight actually checks the UPLOADS.BBS directory for newly
  10041.        uploaded files after executing either upload or download commands.
  10042.        Thus, Searchlight supports two-way file transfer via such programs
  10043.        as BiModem, as long as all uploaded files are stored in the
  10044.        UPLOADS.BBS directory. To perform such a transfer, configure the
  10045.        protocol driver to direct all uploads to the UPLOADS.BBS directory,
  10046.        then install it as a download protocol via the directions outlined
  10047.        above. Should a remote user choose to upload files when executing a
  10048.        download command, Searchlight will recognize these files upon
  10049.        completion of the download and will prompt the user for descriptions
  10050.        (note that it is not possible to prompt for descriptions prior to
  10051.        the file transfer when using a bidirectional protocol).
  10052.  
  10053.  
  10054.        -------------------
  10055.        Local File Transfer
  10056.        -------------------
  10057.  
  10058.        During a local login (a session that takes place on the computer
  10059.        running Searchlight BBS, rather than from a remote terminal),
  10060.        downloading and uploading take on a somewhat different meaning.
  10061.        Since you will not be transferring a file from one computer to
  10062.        another, file transfer in the traditional sense (via a protocol like
  10063.        Xmodem or Zmodem) does not take place. Instead, Searchlight performs
  10064.        a local file copy.
  10065.  
  10066.        If you're downloading, after selecting the files or messages you want
  10067.        to download, Searchlight pops up a box and prompts you to enter a
  10068.        target directory. Enter any valid directory name. Searchlight will
  10069.        copy the files from its own directories to the directory you
  10070.        specify.
  10071.  
  10072.  
  10073.        _____________________________________________________________________
  10074.                                         154
  10075.                                   FILES SUBSYSTEM
  10076.        _____________________________________________________________________
  10077.  
  10078.        If you're uploading, Searchlight prompts you to enter the complete
  10079.        path and filename of the file you wish to upload.  Wildcards and
  10080.        multiple filenames (separated by a space) are supported. Searchlight
  10081.        copies these files into its own directories (the same directories it
  10082.        would use during a traditional upload).
  10083.  
  10084.        Local file transfer is ideal for BBS systems running on local area
  10085.        networks (LANs), since it allows LAN users to move files between
  10086.        their local or private directories and the shared Searchlight
  10087.        directories in a way that's analogous to the way callers of a
  10088.        traditional BBS share files.
  10089.  
  10090.  
  10091.        ------------------
  10092.        Directory Listings
  10093.        ------------------
  10094.  
  10095.        There are several types of directory listings that can be obtained
  10096.        using the Files and New commands. Wildcard, alphabetical, and
  10097.        date-sorted listings are available.
  10098.  
  10099.        To switch from one download directory to another, use the List
  10100.        command for a list of available directories, and Jump to move
  10101.        between them.
  10102.  
  10103.  
  10104.        ----------------
  10105.        File Maintenance
  10106.        ----------------
  10107.  
  10108.        Sysops and co-sysops can delete files, move files from one directory
  10109.        to another, rename files, and change the description associated with
  10110.        a file.  The commands to execute these functions are Kill, Move,
  10111.        Rename, and Edit.  These operations can also be performed by the
  10112.        user who uploaded the file.
  10113.  
  10114.  
  10115.        -------------------
  10116.        Password Protection
  10117.        -------------------
  10118.  
  10119.        Passwords can be assigned to files on an individual basis using the
  10120.        Passwd command. Once a file is assigned a password, it cannot be
  10121.        downloaded or deleted without giving the password. Even cosysops
  10122.        must know the password of a protected file to download it; only the
  10123.        Sysop can access the file without using the password.
  10124.  
  10125.        A typical use of passwords would be to allow two users to exchange a
  10126.        file privately. The sender would upload the file and assign a
  10127.        password to it. He or she would then communicate the password to the
  10128.        intended receiver (by sending a private message), who would then use
  10129.        the password to download the file. If more than one user needs to
  10130.        access the file, the sender gives the password to each person who
  10131.        needs to be able to download it.
  10132.        _____________________________________________________________________
  10133.                                         155
  10134.                                   FILES SUBSYSTEM
  10135.        _____________________________________________________________________
  10136.  
  10137.        Another way password protection can be used is via the Default
  10138.        Password for Uploads field in the CONFIG file. If this field is
  10139.        filled in, each new file that is uploaded to the system is assigned
  10140.        the default password. Thus, newly uploaded files cannot be accessed
  10141.        by the general user population; only the Sysop, and those who know
  10142.        the default password, can access a new file.  Typically, you'd use
  10143.        this option to give yourself the opportunity to check all new files
  10144.        before they can be downloaded by the users of your BBS. After
  10145.        confirming that the file is OK to download, you would remove the
  10146.        password (by using the Passwd command).
  10147.  
  10148.        A "+" sign appears in the directory listing of a password protected
  10149.        file.  This allows you to identify such files easily.
  10150.  
  10151.  
  10152.        ---------
  10153.        Filenames
  10154.        ---------
  10155.  
  10156.        The filenames used by Searchlight are in the same eight characters
  10157.        with three character extension format used by MS- DOS and Windows.
  10158.        (For reasons of backward compatibility with older systems,
  10159.        Searchlight does not use the long filenames added in Windows 95).
  10160.        Searchlight allows the use of wildcards with most commands. You can
  10161.        enter "*" and "?" wildcard characters, and you can enter two or more
  10162.        filenames or wildcard masks by separating each with a space.
  10163.  
  10164.        In general, you do not need to enter the full filename when entering
  10165.        filenames for the Download, View, Move, and other commands. Just
  10166.        enter the first few letters, and Searchlight will pick the correct
  10167.        file, filling in the remainder of the filename right on the screen.
  10168.  
  10169.  
  10170.        ------------
  10171.        File Tagging
  10172.        ------------
  10173.  
  10174.        Searchlight features file tagging, a shortcut method of selecting a
  10175.        list of files for downloading (or other operations) while viewing
  10176.        file listings.  File tagging lets you conveniently select files with
  10177.        just one keystroke whenever filenames appear on the screen.
  10178.  
  10179.        File tagging is available with the Files, New and Zippy commands.
  10180.        These commands display files in a new format that includes a one
  10181.        letter "tag" to the left of the filename:
  10182.  
  10183.  
  10184.  
  10185.  
  10186.  
  10187.  
  10188.  
  10189.  
  10190.  
  10191.        _____________________________________________________________________
  10192.                                         156
  10193.                                   FILES SUBSYSTEM
  10194.        _____________________________________________________________________
  10195.  
  10196.         Tag Filename   St Size Dl  Date    Descrip    0k Tagged/ 1540k Avail
  10197.  
  10198.          A F2DIRM2.ZIP     16k 35 10-24-92 Import `files.bbs' to Searchlight
  10199.            Faster! No longer needs DIRMAINT! Import from text file
  10200.            lists such as provided by Tick, Flea, and other BBS types.
  10201.  
  10202.          B FARMRAT3.ZIP    38k 23 12-31-92  UP/D ratio checking program.
  10203.            Uses DOOR.SYS file and shows up/dwn ratio, security level, ect.
  10204.  
  10205.          D FIAUDIT.ZIP     10k 61  3-29-92 File Area Audit trail program
  10206.            lists file area name & security aspects
  10207.  
  10208.         More... Continue Tag Stop
  10209.  
  10210.        Notice the Tag option available at the "More" prompt; it's used to
  10211.        select any of the files on the current screen. For example, suppose
  10212.        we wanted to select the files F2DIRM2.ZIP and FD-SLBBS.ZIP from the
  10213.        above listing. Simply select "Tag" from the prompt above.
  10214.        Searchlight responds with:
  10215.  
  10216.             Tag Items:
  10217.  
  10218.        Now simply type the letters A and C -- the "tag" letters associated
  10219.        with the desired files. Searchlight adds those files to an internal
  10220.        list, and continues with the file display. You can tag additional
  10221.        files, and even run other listings and tag more files there. Later,
  10222.        you can download the entire list of tagged files by giving the
  10223.        Download command. Searchlight prompts you with:
  10224.  
  10225.             Select 2 Tagged File(s)?  Yes No Edit
  10226.  
  10227.        Enter "Yes", and Searchlight will select the two files tagged earlier
  10228.        and place them into your download list. You can then enter
  10229.        additional filenames, or just press Enter to begin downloading. If
  10230.        you select "No", Searchlight disposes of the previously tagged file
  10231.        list, and allows you to enter new filenames manually.
  10232.  
  10233.        The "Edit" option shown above lets you edit the list of tagged files.
  10234.        A full screen display appears showing the files currently tagged.
  10235.        You can scroll through the list with arrow keys, PgUp and PgDn keys,
  10236.        etc.; press F2 to remove a file from your list. You may wish to use
  10237.        the edit option if you decide against downloading a particular
  10238.        tagged file, or if more files were tagged than may be downloaded
  10239.        given your current file ratio or time limit (see below). You can
  10240.        also edit the tag list at any filename input prompt by typing L and
  10241.        pressing Enter.
  10242.  
  10243.        Regular users can use the tag option to select files for downloading.
  10244.        In addition, Sysops and co-sysops in the file areas can use file
  10245.        tagging with the Kill, Copy and Move commands.
  10246.  
  10247.  
  10248.  
  10249.  
  10250.        _____________________________________________________________________
  10251.                                         157
  10252.                                   FILES SUBSYSTEM
  10253.        _____________________________________________________________________
  10254.  
  10255.  
  10256.        ------------------
  10257.        Tagging and Ratios
  10258.        ------------------
  10259.  
  10260.        The file tag command allows you to select any files that you can
  10261.        view -- including files that may be password protected, located in
  10262.        write-only directories, or that would exceed your download limits.
  10263.        However, the Download command will never allow a user to actually
  10264.        download such files: the entire tag list is always scanned
  10265.        immediately prior to a download, and any files which cannot be
  10266.        downloaded because of the above conditions are removed from the list
  10267.        (the remaining files may be downloaded).
  10268.  
  10269.        To aid users in deciding how many files should be selected for
  10270.        download, Searchlight displays a running total of the number of
  10271.        kilobytes selected, and the number of kilobytes available to
  10272.        download, at the top of each file listing screen (see the example
  10273.        above). The same numbers are also displayed to the left of the
  10274.        prompt that is used for traditional filename inputs when selecting
  10275.        files for download:
  10276.  
  10277.             You may enter up to 40 Filenames.
  10278.             Press F for File List, ? for Help, ENTER when Done:
  10279.  
  10280.             (   0k Total/ 1540k Avail) :
  10281.  
  10282.        Total Kilobytes is the total number of K selected for download.
  10283.        Available Kilobytes is the total number of K that may be downloaded
  10284.        in the current session. This number is computed based on the user's
  10285.        file ratio, baud rate, and time left in the current session (note
  10286.        that since time is part of the computation, available kilobytes
  10287.        decreases as time goes on). Although the Tag command while viewing
  10288.        file lists will accept tags on files which might cause total K to
  10289.        exceed available K, when typing filenames in manually, they will be
  10290.        rejected if they cause the total to exceed the available number.
  10291.  
  10292.        Note: Available Kilobytes is also based on the "Free Files" and
  10293.              "File Value" parameters associated with the current directory.
  10294.              Because of this, it is possible that a file in another
  10295.              directory may be selected for download even if its size
  10296.              exceeds the displayed K Available number, since the displayed
  10297.              number is only accurate for the current directory.
  10298.  
  10299.        The tag list can hold up to 40 filenames. The list itself is "global"
  10300.        and remains available in memory until a successful download, kill,
  10301.        move or edit command uses the list. The list is also cleared if a
  10302.        door is executed.
  10303.  
  10304.  
  10305.  
  10306.  
  10307.  
  10308.  
  10309.        _____________________________________________________________________
  10310.                                         158
  10311.                                   FILES SUBSYSTEM
  10312.        _____________________________________________________________________
  10313.  
  10314.  
  10315.        ---------------
  10316.        Sysop Functions
  10317.        ---------------
  10318.  
  10319.        A 2-Sysop command in the Files section gives you additional Sysop
  10320.        commands to load or import filenames from disk and update file
  10321.        sizes. These are discussed further in the following pages.
  10322.  
  10323.  
  10324.        ----------------
  10325.        RIP File Browser
  10326.        ----------------
  10327.  
  10328.        In RIP mode, Searchlight lets you manage files and use its file
  10329.        system with an integrated series of graphical screens we call the
  10330.        RIP File Browser. The browser replaces traditional line oriented
  10331.        file listing commands, like Files, Zippy and New. In browse mode,
  10332.        you can use your mouse or arrow keys to navigate file directories,
  10333.        tag files, and perform most file related commands.
  10334.  
  10335.        You'll see the file browser whenever you use the Files, New or Zippy
  10336.        command.  Here's an overview of what you'll see and how it works:
  10337.  
  10338.             * You'll start by seeing a screen with a list of file
  10339.               directories. If you do a plain Files command, you'll see a
  10340.               list of all directories that are available to you. If you do
  10341.               a New or Zippy command, you'll see only those directories
  10342.               that contain new files, or those that contain files which
  10343.               match your search string.
  10344.  
  10345.             * If the directory list is longer than one screen, use the
  10346.               scroll bar or arrow keys to see the entire list.
  10347.  
  10348.             * To view the matching files in any directory, just double
  10349.               click on the directory or position the lightbar on the
  10350.               directory and press Enter. If the files list is longer than
  10351.               one screen, use the scroll bar or arrow keys to view the
  10352.               entire list.
  10353.  
  10354.             * If you want to download a particular file, place the
  10355.               lightbar on the file and click the download button on the
  10356.               bottom of the screen (or press D).
  10357.  
  10358.             * If you want to download more than one file, tag the desired
  10359.               files by double clicking with your mouse or by pressing
  10360.               Spacebar. Then click the download button.
  10361.  
  10362.             * Use the "Directories" and "File List" buttons to switch
  10363.               between the files list and directory list. Files you tag
  10364.               remain tagged as you move from one directory to another.
  10365.               You can also use the Next Dir/Prev Dir buttons.
  10366.  
  10367.  
  10368.        _____________________________________________________________________
  10369.                                         159
  10370.                                   FILES SUBSYSTEM
  10371.        _____________________________________________________________________
  10372.  
  10373.             * Most of the other file related commands, like Xproto, are
  10374.               conveniently available on the browsing screen. You don't need
  10375.               to exit the browser to use these commands. You can even View
  10376.               archive files.
  10377.  
  10378.             * You also don't need to leave the browser if you want to do a
  10379.               different Zippy scan or New scan. Use the buttons at the top
  10380.               of the screen.
  10381.  
  10382.  
  10383.         -------------------------------------------------------------------
  10384.        | SETTING UP EXTERNAL PROTOCOLS                                     |
  10385.         -------------------------------------------------------------------
  10386.  
  10387.        An external protocol is a program which is capable of transferring
  10388.        files to or from a remote system via modem. Typically, such programs
  10389.        are written to be used from the DOS command line or as part of a BBS
  10390.        like Searchlight, where they can provide new transfer protocols such
  10391.        as Batch Ymodem or Kermit.
  10392.  
  10393.        To set-up external protocols, run the CONFIG program and access the
  10394.        "Protocol Setup" section. Each of the 15 possible protocol choices
  10395.        has a submenu which looks like this:
  10396.  
  10397.             1. Protocol Name .............
  10398.             2. Protocol Type ............. External
  10399.             3. Protocol Send Command .....
  10400.             4. Protocol Receive Command ..
  10401.             5. FOSSIL Emulation .......... On
  10402.  
  10403.        Each protocol consists of a name (which is displayed by the Files
  10404.        system), a type (set this to "External" to install external
  10405.        protocols), a send command, and a receive command. Send and receive
  10406.        commands are the commands normally used to execute the required
  10407.        external program from the DOS command line, including all
  10408.        parameters. You should specify the exact filename and path
  10409.        (including COM, EXE or BAT extension) to the external program. Where
  10410.        a filename is required on the command line, Searchlight provides
  10411.        three special character sequences which are substituted with actual
  10412.        filenames when the command is used. The special characters are:
  10413.  
  10414.             %F .......... Specifies a single filename (for uploads or
  10415.                           downloads)
  10416.             %W .......... Specifies one to three filenames (downloads only)
  10417.             @FILENAME ... Specifies an "indirect" file (download only)
  10418.  
  10419.        You don't have to specify both a send and receive command for each
  10420.        protocol.  If a receive command is missing, then the protocol can be
  10421.        used only for sending (downloading) files, and vice-versa.
  10422.  
  10423.        Note that since the directory from which an external protocol is
  10424.        "launched" can change, it is recommended that a full pathname be
  10425.        specified for each protocol (i.e. "C:\BIN\DSZ.COM ...").
  10426.  
  10427.        _____________________________________________________________________
  10428.                                         160
  10429.                                   FILES SUBSYSTEM
  10430.        _____________________________________________________________________
  10431.  
  10432.        The FOSSIL Emulation setting tells Searchlight to make a FOSSIL
  10433.        compatible communications interface available to the external
  10434.        program. We recommend using Fossil communications whenever possible,
  10435.        especially if you run the Windows version of Searchlight. For more
  10436.        information, see the section "Door Subsystem - Searchlight's FOSSIL
  10437.        EMULATION Feature."
  10438.  
  10439.  
  10440.        -----------------
  10441.        Download Commands
  10442.        -----------------
  10443.  
  10444.        Download commands should contain either the %F, %W or @FILENAME
  10445.        parameters in the command line where filenames are required by the
  10446.        external protocol. The %F parameter specifies a single filename; %W
  10447.        specifies one to three filenames. Each filename will be passed to
  10448.        the command line in sequence separated by a blank space. Wildcard
  10449.        characters are not passed to the command line, but are expanded to
  10450.        their full filenames.
  10451.  
  10452.        The @FILENAME parameter provides an alternate means of passing
  10453.        filenames to a download command (for use with those programs that
  10454.        support it) and allows multifile transfers of up to 40 files at a
  10455.        time, from any number of directories.  The @FILENAME parameter
  10456.        (where "FILENAME" is any filename, optionally including a drive
  10457.        letter/drive path) writes an indirect text file to disk. The
  10458.        indirect file contains a list of the files requested for download by
  10459.        the user, including full pathnames and drive letters. Many external
  10460.        protocols -- such as DSZ.COM -- can use such a file list instead of
  10461.        command line parameters.
  10462.  
  10463.        All download commands are launched from the Searchlight home
  10464.        directory area; the indirect text file is created in the home
  10465.        directory unless a specific drive/path is specified.
  10466.  
  10467.        Searchlight creates a file called FILELIST.BBS in your home directory
  10468.        during external download procedures. This is a temporary file and
  10469.        need not be backed-up (it will be created again if missing).
  10470.  
  10471.  
  10472.        ---------------
  10473.        Upload Commands
  10474.        ---------------
  10475.  
  10476.        Searchlight supports single-file or batch uploading (uploading two or
  10477.        more files with one command) in conjunction with external protocols
  10478.        that allow it. Batch uploading is assumed if no filenames (i.e. no
  10479.        %F parameter) is specified on the command line for a given upload
  10480.        protocol. For nonbatch protocols, add the %F parameter where a
  10481.        filename is expected.
  10482.  
  10483.  
  10484.  
  10485.  
  10486.        _____________________________________________________________________
  10487.                                         161
  10488.                                   FILES SUBSYSTEM
  10489.        _____________________________________________________________________
  10490.  
  10491.        When performing a batch upload, Searchlight can accept up to 40
  10492.        filenames and descriptions before the upload begins.  After
  10493.        uploading is completed, Searchlight locates the actual file(s) sent,
  10494.        and matches them to the descriptions provided prior to the upload.
  10495.        Should any files lack a description, the system will prompt for one
  10496.        after the upload. A default message of "description not available"
  10497.        is used if no description is provided by the user.
  10498.  
  10499.        Searchlight executes all external upload procedures from a temporary
  10500.        directory called UPLOADS.BBS, which is created as a subdirectory of
  10501.        your BBS home directory if it does not already exist. After each
  10502.        external upload procedure completes, Searchlight checks the
  10503.        UPLOADS.BBS directory to locate all uploaded files, then moves these
  10504.        files to the appropriate files area.  (Please note that if an
  10505.        uploaded file already exists in the current directory, Searchlight
  10506.        will delete the duplicate file). The UPLOADS.BBS directory is
  10507.        expected to be empty before uploading begins, so do not store any
  10508.        files in this directory.
  10509.  
  10510.        Searchlight creates a temporary file called UPLIST.BBS during
  10511.        external upload procedures.
  10512.  
  10513.  
  10514.        -------------------------
  10515.        External Protocol Example
  10516.        -------------------------
  10517.  
  10518.        The popular program DSZ (Omen Technology Inc.) can be used to add
  10519.        protocols like Ymodem Batch to Searchlight.  With the DSZ.COM
  10520.        executable file installed in the root directory of drive C:, you can
  10521.        use it like this:
  10522.  
  10523.          1. Protocol Name ............. Ymodem Batch
  10524.          2. Protocol Send Command ..... c:\dsz.com port %p sb -k @c:temp.txt
  10525.          3. Protocol Receive Command .. c:\dsz.com port %p restrict z pr1 rb
  10526.  
  10527.        Here we're using DSZ.COM to implement the Ymodem protocol by
  10528.        specifying the "sb -k" and "rb" command line parameters. Filenames
  10529.        are passed via an indirect file called "c:temp.txt" (note that the
  10530.        drive letter is required by DSZ in order to recognize an indirect
  10531.        file). Searchlight will allow you to enter up to 40 filenames and
  10532.        will allow filenames from multiple directories to be selected when
  10533.        you use this command.
  10534.  
  10535.        These commands are specific to DSZ; other software will use
  10536.        different commands. In general, any program can be set up to run as
  10537.        a protocol. It is up to you to install programs with the correct
  10538.        parameters for the transfer desired.
  10539.  
  10540.        As a final thought, note that external protocols can do other things
  10541.        besides straight uploading and downloading of files.  For example,
  10542.        an external protocol could perform processing, such as extraction of
  10543.        PKZIP files, before performing a file transfer. External protocols
  10544.  
  10545.        _____________________________________________________________________
  10546.                                         162
  10547.                                   FILES SUBSYSTEM
  10548.        _____________________________________________________________________
  10549.  
  10550.        gives you a way to interface custom file handling procedures with
  10551.        Searchlight.
  10552.  
  10553.  
  10554.         -------------------------------------------------------------------
  10555.        | SUMMARY OF FILES SYSTEM COMMANDS                                  |
  10556.         -------------------------------------------------------------------
  10557.  
  10558.        Here's a list of the File System's main menu of commands, followed by
  10559.        an explanation of what each command does.
  10560.  
  10561.             Copy ...... Copy File to New Dir
  10562.             Download .. Download File
  10563.             Edit ...... Edit File Descriptions
  10564.             Files ..... Directory of Files
  10565.             Goodbye ... Log Off System
  10566.             Jump ...... Jump to Directory
  10567.             Kill ...... Delete File
  10568.             List ...... List of Directories
  10569.             Move ...... Move File to New Dir
  10570.             New ....... New Files by Date
  10571.             Owner ..... Show Add'l File Info
  10572.             Passwd .... Assign/Change Passwords
  10573.             Quit ...... Return to BBS
  10574.             Rename .... Rename File
  10575.             Status .... Ratios & Disk Space
  10576.             Type ...... Read Text Files
  10577.             Upload .... Upload File
  10578.             View ...... View Compressed Files
  10579.             WideDir ... Brief File Listing
  10580.             XProto .... Change Xfer Protocol
  10581.             Zippy ..... Zippy Dir Scan
  10582.             2-Sysop ... Sysop Command Menu
  10583.  
  10584.  
  10585.        ----------
  10586.        Files/Copy
  10587.        ----------
  10588.  
  10589.        The Copy command copies files from one directory to another. The disk
  10590.        file, as well as the file's description, are copied to the new
  10591.        location.
  10592.  
  10593.        Copy is similar to Move, except that Move removes the original file
  10594.        after copying it, whereas Copy does not. You may specify a single
  10595.        filename or multiple filenames with this command, or you can copy
  10596.        all of the files in your tag list.
  10597.  
  10598.  
  10599.  
  10600.  
  10601.  
  10602.  
  10603.  
  10604.        _____________________________________________________________________
  10605.                                         163
  10606.                                   FILES SUBSYSTEM
  10607.        _____________________________________________________________________
  10608.  
  10609.  
  10610.        --------------
  10611.        Files/Download
  10612.        --------------
  10613.  
  10614.        The Download command is used to transfer files from the BBS to you.
  10615.        Your computer or terminal must be capable of receiving the file
  10616.        using one of four internally supported transfer protocols (Zmodem,
  10617.        Xmodem, CRC Xmodem, 1K Xmodem) or an externally supplied protocol
  10618.        (use the Xproto command for a list). If no protocol has been
  10619.        previously selected when you give the Download command, you will be
  10620.        prompted for a protocol; otherwise, the protocol used last is used.
  10621.  
  10622.        To begin downloading, enter the name of the file you wish to receive.
  10623.        You need not type the full filename. When Searchlight displays the
  10624.        message "Ready to send", the file transfer is ready to begin.
  10625.        However, before you can receive the file, you must give your
  10626.        terminal the proper command. Usually, this is done by selecting an
  10627.        option to receive files from a menu.
  10628.  
  10629.        Some external protocols allow you to specify multiple filenames
  10630.        and/or wildcard filespecs. The "*" and "?" characters may be used.
  10631.        All files specified must reside in the current directory.
  10632.  
  10633.        A file may be password protected. If you attempt to download such a
  10634.        file, you will be prompted for a password, and the download will
  10635.        proceed only if you provide the correct password.
  10636.  
  10637.        An auto-logoff feature is supported. If selected, the system will log
  10638.        you off after the download completes, allowing you to leave your
  10639.        computer unattended during the transfer.
  10640.  
  10641.        To get a directory of the files available for downloading, use the
  10642.        Files and New commands.
  10643.  
  10644.  
  10645.        ----------
  10646.        Files/Edit
  10647.        ----------
  10648.  
  10649.        This command allows you to change the description associated with a
  10650.        file. You can only change a file that you uploaded, unless you have
  10651.        sysop status, in which case you may edit any file's description.
  10652.  
  10653.  
  10654.        -----------
  10655.        Files/Files
  10656.        -----------
  10657.  
  10658.        The Files command displays a listing of files available for
  10659.        downloading. It prompts you to enter the "Starting Filename or
  10660.        Wildcard" of the directory you wish to view. There are three ways to
  10661.        respond to this prompt:
  10662.  
  10663.        _____________________________________________________________________
  10664.                                         164
  10665.                                   FILES SUBSYSTEM
  10666.        _____________________________________________________________________
  10667.  
  10668.        Pressing ENTER without typing anything gives you a list of all files
  10669.        in the current directory. The list is in alphabetical order and
  10670.        shows the filename, date uploaded, size in Kilobytes, number of
  10671.        times downloaded, and a description of the file.
  10672.  
  10673.        Typing a filename, or the first few characters of a filename, WITHOUT
  10674.        a wildcard, lists files in alphabetical order starting with the
  10675.        filename entered. For example, if you enter "L", you will get a list
  10676.        beginning with the files that start with the letter L, and
  10677.        continuing to the end.
  10678.  
  10679.        Finally, you may type a wildcard (a filename containing one or more
  10680.        "*" or "?" characters). In this case, only those files that match
  10681.        the wildcard specification are shown. In addition, the prompt
  10682.        "Search all directories (Y/N)?" appears. If "Y" is selected,
  10683.        Searchlight will list all files in all directories that match the
  10684.        wildcard; otherwise, only files in the current directory are listed.
  10685.  
  10686.        A "+" sign displayed in the file listing indicates a password
  10687.        protected file.  You can view or download such a file only if you
  10688.        know the password.
  10689.  
  10690.        Notice that Searchlight displays file sizes in terms of Kilobytes
  10691.        rather than bytes. One kilobyte equals 1024 bytes.
  10692.  
  10693.        You may abort any file listing at any time by pressing the <spacebar>
  10694.        or <ctrl-c> keys. Also, refer to the New command for information
  10695.        about date-sorted file listings.
  10696.  
  10697.  
  10698.        -------------
  10699.        Files/Goodbye
  10700.        -------------
  10701.  
  10702.        Use this command when you are ready to log off, or disconnect, from
  10703.        the BBS.  The computer may prompt you to "Please leave us a quote".
  10704.        Type a short 1-line message and press ENTER.
  10705.  
  10706.        Note that is considered good practice to always log off properly by
  10707.        using the Goodbye command, rather than simply hanging up. However,
  10708.        hanging up will not cause any damage to the system.
  10709.  
  10710.  
  10711.        ----------
  10712.        Files/Jump
  10713.        ----------
  10714.  
  10715.        This command is used to access the various file directories available
  10716.        on the system. Type the name (or partial name) of the directory you
  10717.        want.
  10718.  
  10719.        To see the list of available directories, either type "?" in response
  10720.        to the Jump command's prompt, or use the List command.
  10721.  
  10722.        _____________________________________________________________________
  10723.                                         165
  10724.                                   FILES SUBSYSTEM
  10725.        _____________________________________________________________________
  10726.  
  10727.  
  10728.        ----------
  10729.        Files/Kill
  10730.        ----------
  10731.  
  10732.        The Kill command deletes files. If you have Sysop or Co-Sysop access,
  10733.        you may delete any file; otherwise, you can only delete a file if
  10734.        you uploaded it.
  10735.  
  10736.        Kill can take a single filename, or one or more filenames and/or
  10737.        wildcard filespecs. The "*" and "?" characters are supported.
  10738.  
  10739.        Sysop Only: You may delete files from Searchlight's list of files
  10740.        without actually deleting them from the disk. You will be prompted
  10741.        for this option.
  10742.  
  10743.  
  10744.        ----------
  10745.        Files/List
  10746.        ----------
  10747.  
  10748.        The List command gives you a list of available directories. In order
  10749.        to view or download files in a specific directory, you normally make
  10750.        it the current directory; do this by responding to the List
  10751.        command's prompt with the directory name, or by using the Jump
  10752.        command (see Jump).
  10753.  
  10754.  
  10755.        ----------
  10756.        Files/Move
  10757.        ----------
  10758.  
  10759.        Use the Move command to transfer, or move, files from one directory
  10760.        to another. The files are copied into the destination directory and
  10761.        then the original files are deleted. Both Searchlight's entry for
  10762.        the file, and the actual file on disk, are moved to the appropriate
  10763.        directories.
  10764.  
  10765.        Move can take a single filename, or one or more filenames and/or
  10766.        wildcard filespecs. The "*" and "?" characters are supported. You
  10767.        can also move the currently tagged files if you are maintaining a
  10768.        tag list.
  10769.  
  10770.        Note that the Move command performs a byte-by-byte file copy only
  10771.        when the source and destination are on different drives; otherwise,
  10772.        it performs an efficient file rename without a physical file move.
  10773.  
  10774.        Users with Sysop access can move any file. Otherwise, you can only
  10775.        move your own files (files you have uploaded) into directories to
  10776.        which you have access.
  10777.  
  10778.  
  10779.  
  10780.  
  10781.        _____________________________________________________________________
  10782.                                         166
  10783.                                   FILES SUBSYSTEM
  10784.        _____________________________________________________________________
  10785.  
  10786.  
  10787.        ---------
  10788.        Files/New
  10789.        ---------
  10790.  
  10791.        The New command allows you to get a listing of "new" files since the
  10792.        last time you logged on, or since any specified date.
  10793.  
  10794.        To use the New command, answer the prompt with the desired target
  10795.        date. The date shown in brackets, which is the date you last logged
  10796.        on, is used as the default date if you press ENTER. A second prompt
  10797.        appears, "Scan all directories (Y/N)"- if you enter Y, all
  10798.        directories will be searched for new files, otherwise only the
  10799.        current directory is searched.
  10800.  
  10801.        Dates are entered in either USA (mm/dd/yy) or European (dd/mm/yy)
  10802.        format, depending on your Configuration (see CONFIG menu #2). You
  10803.        can use dashes, slashes, or any nonnumeric separators. If you don't
  10804.        include the year (e.g.  "9/21"), it defaults to the current year.
  10805.  
  10806.        The new file listing appears in reverse date-sorted order. It is
  10807.        often useful to run the NEW command with a very early target date,
  10808.        as this gives you a chronological file listing rather than an
  10809.        alphabetical listing as with the FILES command.
  10810.  
  10811.  
  10812.        -----------
  10813.        Files/Owner
  10814.        -----------
  10815.  
  10816.        This command prompts you for a filename and it displays the file's
  10817.        owner (the name of the person who uploaded the file) and the number
  10818.        of times that the file has been downloaded.
  10819.  
  10820.  
  10821.        ------------
  10822.        Files/Passwd
  10823.        ------------
  10824.  
  10825.        The Passwd command lets you assign a password to a file. Once a
  10826.        password is assigned, only users who know the password are able to
  10827.        download the file.
  10828.  
  10829.        You can only assign a password to a file that you have uploaded. If
  10830.        the file already has a password, you can only change it if you can
  10831.        give the old password. Note that the Sysop can assign an automatic
  10832.        password to all newly uploaded files, thus preventing anyone from
  10833.        downloading a new file until it has been cleared by the sysop.
  10834.  
  10835.  
  10836.  
  10837.  
  10838.  
  10839.  
  10840.        _____________________________________________________________________
  10841.                                         167
  10842.                                   FILES SUBSYSTEM
  10843.        _____________________________________________________________________
  10844.  
  10845.  
  10846.        ----------
  10847.        Files/Quit
  10848.        ----------
  10849.  
  10850.        The Quit command returns you to the Searchlight BBS Main Menu.
  10851.  
  10852.  
  10853.        ------------
  10854.        Files/Rename
  10855.        ------------
  10856.  
  10857.        Searchlight's Rename command is similar to its DOS counterpart. It
  10858.        will rename a single file; you must be a Sysop or the uploader of
  10859.        the file you want to rename. Both the directory entry for the file
  10860.        and the actual file on disk will be renamed.
  10861.  
  10862.        You cannot rename a file if the file resides on a read-only disk.
  10863.  
  10864.  
  10865.        ------------
  10866.        Files/Status
  10867.        ------------
  10868.  
  10869.        The Status command shows various information, including: the current
  10870.        time and date, time left in the current session, your current
  10871.        download:upload ratio and dl:ul limit, and the amount of free disk
  10872.        space remaining on the current volume.
  10873.  
  10874.  
  10875.        ----------
  10876.        Files/Type
  10877.        ----------
  10878.  
  10879.        The Type command allows you to read a text file. The output will
  10880.        pause every 24 lines and can be controlled with pause (^S) and break
  10881.        (^C) keys, just like when you read messages and other text.
  10882.  
  10883.  
  10884.        ------------
  10885.        Files/Upload
  10886.        ------------
  10887.  
  10888.        The Upload command is used to send files from your computer to the
  10889.        BBS. Your computer or terminal must be capable of sending the file
  10890.        using Zmodem, Xmodem, CRC Xmodem, 1K Xmodem, or one of the supported
  10891.        external protocols.  If no protocol has been previously selected
  10892.        when you give the Upload command, you will be prompted for a
  10893.        protocol; otherwise, the previously selected protocol is used.
  10894.  
  10895.        To begin uploading, enter the filename of the file you wish to send.
  10896.        You must enter a legal DOS filename (8 character filename with
  10897.        optional 3 character extension). Do not include drive letters or
  10898.        directory pathnames.
  10899.        _____________________________________________________________________
  10900.                                         168
  10901.                                   FILES SUBSYSTEM
  10902.        _____________________________________________________________________
  10903.  
  10904.        Before the file transfer begins, you will be prompted to enter a
  10905.        short and long description of the file to be displayed so that
  10906.        others will know what information the file contains. (Long
  10907.        descriptions are optional and may be 0, 1 to 2 lines in length).
  10908.  
  10909.        If less than 200K of disk space is available, Searchlight will
  10910.        display the amount of space left and ask if you wish to continue.
  10911.        Press "N" if your file is larger than the amount of space available,
  10912.        or "Y" to go on.
  10913.  
  10914.        Searchlight features an auto-logoff option. If this feature is
  10915.        selected, you will be logged off immediately after the upload
  10916.        completes. Thus, you may leave your computer unattended without
  10917.        worrying about terminating your session when the upload is finished.
  10918.  
  10919.        When Searchlight is ready to receive your file, it will display the
  10920.        message "ready to receive". What happens next depends on the
  10921.        terminal software that you use. In most cases, you must give a
  10922.        command to your software that tells it to load the file and begin
  10923.        sending it using the proper protocol.
  10924.  
  10925.        If the Sysop has assigned a "default" password to the files system,
  10926.        your file will be password protected until it is cleared by the
  10927.        sysop.
  10928.  
  10929.        After a successful upload, Searchlight will increase your time limit
  10930.        for the day according to the amount of time required for the upload,
  10931.        multiplied by the Upload Repay Rate (set by the Sysop on CONFIG menu
  10932.        #2).
  10933.  
  10934.  
  10935.        ----------
  10936.        Files/View
  10937.        ----------
  10938.  
  10939.        This command displays the internal directory of a compressed file,
  10940.        such as a ZIP or ARJ file. You are prompted for the filename, which
  10941.        may be abbreviated. The directory of the compressed file is
  10942.        displayed in a format similar to that of the "verbose" directory
  10943.        option found in the compression utility programs.
  10944.  
  10945.        Searchlight's View command supports ARC, ZIP, LZH, ARJ, SQZ and GIF
  10946.        file types (for GIF files, Searchlight displays only the file
  10947.        dimensions and color depth). The View command determines the file
  10948.        type by looking at the data in the file, rather than by the
  10949.        filename; therefore, you can view compressed files even if the
  10950.        filename does not have the expected extension.  The View command can
  10951.        also be used like the Type command to look at text files.
  10952.  
  10953.  
  10954.  
  10955.  
  10956.  
  10957.  
  10958.        _____________________________________________________________________
  10959.                                         169
  10960.                                   FILES SUBSYSTEM
  10961.        _____________________________________________________________________
  10962.  
  10963.  
  10964.        -------------
  10965.        Files/WideDir
  10966.        -------------
  10967.  
  10968.        This command gives you a "wide", four-across file listing which shows
  10969.        only the filename and file size in Kilobytes. It is similar to the
  10970.        DIR/W command in DOS. There is no parameter for WideDir; all files
  10971.        in the current directory are listed.  You may abort the listing with
  10972.        ^C.
  10973.  
  10974.  
  10975.        ------------
  10976.        Files/XProto
  10977.        ------------
  10978.  
  10979.        This command lets you change the transfer protocol used for uploading
  10980.        and downloading files. Searchlight supports four internal protocols
  10981.        (Zmodem, Xmodem, CRC Xmodem, and 1K Xmodem); in addition, up to 9
  10982.        external protocols can be supplied by the Sysop.
  10983.  
  10984.        Once a protocol is selected, it is used by default for all
  10985.        subsequent transfers until you change it again with the XProto
  10986.        command.
  10987.  
  10988.  
  10989.        -----------
  10990.        Files/Zippy
  10991.        -----------
  10992.  
  10993.        The "Zippy Directory Scan" command searches one or more file
  10994.        directories for a specific search string. The search string can be
  10995.        any group of characters, and both filenames and descriptions will be
  10996.        searched. It is not necessary to use wildcard characters with Zippy,
  10997.        and the search is case-insensitive when searching file descriptions.
  10998.  
  10999.        Searchlight's Zippy command is dedicated as a tribute to the folks at
  11000.        PCBoard for creatively allocating the last letter of the alphabet as
  11001.        a command, and to comic artist Bill Griffith for the inspiration
  11002.        provided to this author via his Zippy The Pinhead comic strips.
  11003.  
  11004.        You can abort the search by pressing ^C.
  11005.  
  11006.  
  11007.        -------------
  11008.        Files/2-Sysop
  11009.        -------------
  11010.  
  11011.        This command allows you to access several subfunctions related to
  11012.        the maintenance of your file system. Only Sysops can access these
  11013.        commands.
  11014.  
  11015.  
  11016.  
  11017.        _____________________________________________________________________
  11018.                                         170
  11019.                                   FILES SUBSYSTEM
  11020.        _____________________________________________________________________
  11021.  
  11022.        Get -- The Get command is used to load the names of existing files
  11023.        into Searchlight's directory, without having to upload them.
  11024.  
  11025.        To add files to a directory, first use DOS commands to copy the files
  11026.        to the appropriate disk and directory. When you execute Get,
  11027.        Searchlight reads the disk directory of the active drive and
  11028.        compares the filenames it finds to the filenames in its own internal
  11029.        directory list. When a new file is found, its name is printed and
  11030.        you are prompted to enter a description of the file. If you enter no
  11031.        description, the file is skipped; otherwise, it is added to
  11032.        Searchlight's list of files.
  11033.  
  11034.        To use Get, you must specify a filename or wildcard mask for the
  11035.        file(s) you wish to add. Enter "*.*" to search all the files in the
  11036.        directory.
  11037.  
  11038.        Note: By default, the Get command looks in the "Path to Files" path
  11039.              for the current directory to find files. However, you can
  11040.              override this path if you enter a complete file path with the
  11041.              Get command -- for example, "C:\SLBBS\UTILS\*.ZIP". Repeated
  11042.              use of the Get command with different paths allows a single
  11043.              Searchlight directory to contain files from multiple DOS
  11044.              directories. More information about working with multiple
  11045.              paths can be found in the section "Files Subsystem - Working
  11046.              With Multiple Paths").
  11047.  
  11048.        If you want to load more than one filename at a time, you may wish to
  11049.        use the Import features described in the following section.
  11050.  
  11051.        Update -- This command compares Searchlight's directory with the DOS
  11052.        directory of the current drive. It is used to update the sizes of
  11053.        files which have changed size since they were uploaded or added to
  11054.        the Searchlight directory.
  11055.  
  11056.        Update will place a "*" next to the directory listing of any files
  11057.        which have been deleted from the disk but remain in the system's
  11058.        file list.
  11059.  
  11060.  
  11061.         -------------------------------------------------------------------
  11062.        | IMPORTING FILE LISTS                                              |
  11063.         -------------------------------------------------------------------
  11064.  
  11065.        Searchlight's Import function, available from the CONFIG program
  11066.        under "Directory Utilities", is a flexible command that allows you
  11067.        to use filename and description lists from CD-ROM disks and other
  11068.        bulletin board software with Searchlight BBS.
  11069.  
  11070.        Searchlight BBS stores filenames and descriptions for its file
  11071.        transfer directories in binary rather than text files. This gives
  11072.        Searchlight the unique ability to maintain both alphabetical and
  11073.        date sorted indexes to its files, as well as file passwords,
  11074.        ownerships, and running download counts. One limitation of binary
  11075.  
  11076.        _____________________________________________________________________
  11077.                                         171
  11078.                                   FILES SUBSYSTEM
  11079.        _____________________________________________________________________
  11080.  
  11081.        files is that file listings from other BBS software or generic file
  11082.        listings (such as those provided with CD-ROM systems) cannot be used
  11083.        directly. However, the
  11084.  
  11085.        Import facility converts such listings for use with Searchlight and
  11086.        also allows you to freely edit Searchlight directories by listing to
  11087.        a text file, editing the text file, and importing the results back
  11088.        into the system.
  11089.  
  11090.             Import List Format
  11091.  
  11092.        The Import command expects to read a text file containing filenames
  11093.        in the following general format:
  11094.  
  11095.             <filename>  [size]  [date]  [description]
  11096.  
  11097.        The filenames must begin in column 1, and can be expressed as
  11098.  
  11099.             NAME     EXT   or
  11100.             NAME.EXT
  11101.  
  11102.        The file sizes can begin in any column, and may appear in bytes or
  11103.        Kbytes:
  11104.  
  11105.             153506   or
  11106.             149.9K
  11107.  
  11108.        The date can begin in any column, can be parsed with either "-" or
  11109.        "/" characters, and can appear as "MM/DD/YY" or "MM/YY":
  11110.  
  11111.             10/96      or
  11112.             10/23/96   or
  11113.             10-23-96
  11114.  
  11115.        The remainder of the line after the date contains the description. If
  11116.        a date is missing, Searchlight substitutes the current system date.
  11117.        Additional fields, such as the "times downloaded" field used in
  11118.        Searchlight file lists, may appear but will be ignored. Any lines
  11119.        which do not conform to the above, such as blank lines or heading
  11120.        lines, will be ignored when the file is processed. Any lines which
  11121.        contain an invalid filename, size, or date will also be skipped.
  11122.  
  11123.  
  11124.        --------------------------
  11125.        Running The Import Command
  11126.        --------------------------
  11127.  
  11128.        To begin importing, run the Config program and select File Directory
  11129.        Maintenance. Place the cursor next to the desired directory, press
  11130.        F3, and select Import Filenames from the menu. (If you have not
  11131.        already created a Searchlight directory entry for the files you wish
  11132.        to import, do so first by pressing F1 and following the prompts.
  11133.        More information about creating directories can be found in the
  11134.        sectin "Directory Maintenance - File Directory Maintenance").
  11135.        _____________________________________________________________________
  11136.                                         172
  11137.                                   FILES SUBSYSTEM
  11138.        _____________________________________________________________________
  11139.  
  11140.        To begin the import procedure, you need to enter two pieces of
  11141.        information: the path where the files are located, and the name of
  11142.        the file containing the file descriptions. Searchlight provides the
  11143.        Path to Files for the directory as a default for the first question,
  11144.        but you may override this with a different path. (Changing this path
  11145.        allows you to create a Searchlight directory that contains files
  11146.        from multiple DOS directories. If you have more than one directory
  11147.        from which you'd like to import files, repeat the import procedure
  11148.        for each. For more information about working with multiple directory
  11149.        paths, see the following section "File Subsystems - Working With
  11150.        Multiple Paths").
  11151.  
  11152.        Searchlight may also provide you with a default for the import
  11153.        filename, if a suitable file can be located. If a default is
  11154.        provided, either press Enter to accept it or type a different
  11155.        filename. If no default is shown, type in the complete filename of
  11156.        the description file (the description file may be located in any
  11157.        path you choose).
  11158.  
  11159.        Next, you'll see this prompt:
  11160.  
  11161.             Update Existing Files (Y/N)?
  11162.  
  11163.        If you answer "N", any files found in the import list which already
  11164.        exist in the Searchlight directory will be skipped. If you type "Y",
  11165.        then existing files will be updated with the file size, date, and
  11166.        description found on the import file list.
  11167.  
  11168.        Searchlight will proceed to read the import file list, and will
  11169.        report the number of files added and updated at completion.  All
  11170.        newly added files will be assigned an ownership of Sysop (or the
  11171.        name of whomever executes the Import command) and will have the
  11172.        times downloaded counter set to zero.
  11173.  
  11174.  
  11175.        -----------------
  11176.        Tips On Importing
  11177.        -----------------
  11178.  
  11179.        It is recommended that you run the 2-Sysop/Balance command after an
  11180.        import operation, to ensure that the directory is in an optimal tree
  11181.        sorted structure.
  11182.  
  11183.        Import does not check the file sizes of the files it reads. To do
  11184.        that, execute 2-Sysop/Update after importing.
  11185.  
  11186.        When specifying the name of the import file, Searchlight will be
  11187.        looking for that file in the DOS directory containing the files for
  11188.        the currently active file area. If your import file is in another
  11189.        directory, you can specify the drive letter and/or path.
  11190.  
  11191.  
  11192.  
  11193.  
  11194.        _____________________________________________________________________
  11195.                                         173
  11196.                                   FILES SUBSYSTEM
  11197.        _____________________________________________________________________
  11198.  
  11199.        The Import command can read files created with Searchlight's SLDIR
  11200.        utility. You can use SLDIR to create a text file listing of your
  11201.        directory, then edit file descriptions, sizes, or dates with a word
  11202.        processor, and load the changes back into Searchlight by specifying
  11203.        "Update Existing Files" when you import the list. There is no need
  11204.        to remove the headings or blank lines from the SLDIR list, as these
  11205.        will be ignored when the file is imported.
  11206.  
  11207.        Importing works one directory at a time. If you want to import
  11208.        several different file lists into one Searchlight directory, repeat
  11209.        the import procedure for each list. If you want to import files from
  11210.        a large list into several Searchlight directories, you'll need to
  11211.        split your list into smaller lists and import each one into the
  11212.        appropriate file area.
  11213.  
  11214.  
  11215.         -------------------------------------------------------------------
  11216.        | WORKING WITH MULTIPLE PATHS                                       |
  11217.         -------------------------------------------------------------------
  11218.  
  11219.        By default, each directory you set up with Searchlight's Config
  11220.        program (that is, each Searchlight directory) points to a particular
  11221.        DOS directory on your hard drive or a particular directory on a
  11222.        CD-ROM or network drive. This is the path defined by "Path to Files"
  11223.        in the directory setup screen. This is the path where Searchlight
  11224.        places new files when they are uploaded to the directory or copied
  11225.        to the directory when the Copy or Move commands are used from the
  11226.        Files menu.
  11227.  
  11228.        Sometimes, you may want to group files into a single Searchlight
  11229.        directory even though those files exist in different DOS directory
  11230.        paths. The most common reason for doing this is when you have CD-ROM
  11231.        discs. Suppose you have three CD discs and each disc contains files
  11232.        related to word processing. Rather than make three separate word
  11233.        processing directories, you might want to create a single file area
  11234.        combining the contents of the three discs. Another reason for
  11235.        grouping files from different DOS paths is so you can have one file
  11236.        appear in two or more Searchlight directories without making
  11237.        multiple copies of the file.
  11238.  
  11239.        Searchlight allows you to create multiple path groupings in two
  11240.        ways:
  11241.  
  11242.             * When you use the 2-Sysop/Get command, specify the full path
  11243.               to the files you wish to get; for example,
  11244.               "C:\SLBBS\WP\*.ZIP". Searchlight allows you to retrieve those
  11245.               files and create descriptions of them in the current file
  11246.               area, even if the "Path to Files" for the current area
  11247.               doesn't match the path typed.
  11248.  
  11249.             * When you use the Import command in the Config program,
  11250.               specify the desired file path when prompted.
  11251.  
  11252.  
  11253.        _____________________________________________________________________
  11254.                                         174
  11255.                                   FILES SUBSYSTEM
  11256.        _____________________________________________________________________
  11257.  
  11258.        In both cases, repeat the command as many times as needed_using a
  11259.        different path each time_until all of the files you need are placed
  11260.        into Searchlight's file database.
  11261.  
  11262.        Searchlight treats files that aren't located in the primary "Path to
  11263.        Files" much like any other files when listing and searching
  11264.        directories. Of course, when you attempt to View or Download such a
  11265.        file, Searchlight retrieves the file's contents from the correct
  11266.        directory.
  11267.  
  11268.        There are several differences between a "normal" file (one contained
  11269.        in the directory's default "Path to Files") and a file in a
  11270.        different path. If you use Searchlight to copy or move the file to a
  11271.        different directory, the file itself isn't physically copied.
  11272.        Instead, only the file description is moved.
  11273.  
  11274.        Searchlight stores the file's actual DOS path as a hidden part of the
  11275.        file description. Sysops can see the path: when you're logged into
  11276.        your system as a Sysop, you'll see the alternate directory path as
  11277.        part of the description when you display the file. Your regular
  11278.        callers can't see this path, and won't experience any difference
  11279.        between these files and other files.
  11280.  
  11281.        You cannot edit a file's path once it has been entered, nor can you
  11282.        convert existing files into files which use an alternate directory
  11283.        path. The only way to create these files is with the 2-Sysop/Get or
  11284.        Import procedures.
  11285.  
  11286.  
  11287.  
  11288.  
  11289.  
  11290.  
  11291.  
  11292.  
  11293.  
  11294.  
  11295.  
  11296.  
  11297.  
  11298.  
  11299.  
  11300.  
  11301.  
  11302.  
  11303.  
  11304.  
  11305.  
  11306.  
  11307.  
  11308.  
  11309.  
  11310.  
  11311.  
  11312.        _____________________________________________________________________
  11313.                                         175
  11314.                                     MENU EDITOR
  11315.        _____________________________________________________________________
  11316.  
  11317.  
  11318.         -------------------------------------------------------------------
  11319.        | SEARCHLIGHT MENU EDITOR                                           |
  11320.         -------------------------------------------------------------------
  11321.  
  11322.        Searchlight uses an externally stored menu system that directs the
  11323.        flow of commands, and forms most of the menus you and your callers
  11324.        will see when using the software. Because menus are stored
  11325.        externally in files, and because Searchlight's internal command
  11326.        structures include command-line style options, you have a tremendous
  11327.        amount of flexibility to decide how your system will look and work.
  11328.  
  11329.        With Searchlight and its menu editor software, you can:
  11330.  
  11331.             * Rename, rearrange, eliminate, or regulate by access level and
  11332.               attributes, any command on the default menus provided. You
  11333.               can even translate commands (including the command names and
  11334.               their associated "hot key") into other languages.
  11335.  
  11336.             * Create new commands on any menu. Your commands can be
  11337.               internal Searchlight functions (like List Conferences or Read
  11338.               Messages), external Door programs, or other menus.
  11339.  
  11340.             * Create commands that do something different, depending on the
  11341.               access level, attributes, and/or help level of the user who
  11342.               selects the command.
  11343.  
  11344.             * Execute a list of commands (both internal commands and Doors),
  11345.               creating commands that can perform complex sequences of
  11346.               events.
  11347.  
  11348.  
  11349.         -------------------------------------------------------------------
  11350.        | USING THE MENU EDITOR                                             |
  11351.         -------------------------------------------------------------------
  11352.  
  11353.        The core of Searchlight's menu system is a series of menu (*.MNU)
  11354.        files located in a directory on your hard drive. The menu editor
  11355.        function (part of the CONFIG program) can be used to examine and
  11356.        alter existing menu files or to create new ones from scratch. Note
  11357.        that it is not necessary to use the menu editor to use Searchlight;
  11358.        the default menus provided with the system can be used as-is. You
  11359.        need to use the menu editor only if you want to alter, or add to,
  11360.        the stock menus.
  11361.  
  11362.        Note: All of the command descriptions and examples in this manual
  11363.              assume you are using the default menus provided with
  11364.              Searchlight. If you change menus using the menu editor, you
  11365.              should be aware that the exact menu choices and keystrokes
  11366.              described in this manual may no longer be accurate for your
  11367.              system. However, commands themselves will operate the same.
  11368.  
  11369.  
  11370.  
  11371.        _____________________________________________________________________
  11372.                                         176
  11373.                                     MENU EDITOR
  11374.        _____________________________________________________________________
  11375.  
  11376.  
  11377.        ------------------------
  11378.        Starting The Menu Editor
  11379.        ------------------------
  11380.  
  11381.        To start the menu editor, run CONFIG and select item E, "Searchlight
  11382.        Menu Editor". You can also type from the DOS prompt:
  11383.  
  11384.             CONFIG E
  11385.  
  11386.        The menu editor starts up by displaying a list of available menus.
  11387.        The first time you run the menu editor, you will see a list of menus
  11388.        similar to this one:
  11389.  
  11390.             FILES       23  Searchlight Files System
  11391.             FSYSOP       6  Sysop Command Menu
  11392.             MAIL         8  Electronic Mail
  11393.             MAIN        25  Searchlight BBS Main Menu
  11394.             MEMBER       6  Subbd Member List/Options
  11395.             NEW          5  New Message Scans
  11396.             OPTIONS      5  Your Options & Stats
  11397.             SCAN         5  Quick Scan Messages
  11398.             STARTUP      7  SLBBS Startup Menu
  11399.             SYSMAIL      8  E-Mail/Sysop Access
  11400.             SYSOP        8  Sysop Options Menu
  11401.             SYSOPT       5  Sysop Options/Stats Access
  11402.             USER         7  User Lists & Information
  11403.             <End of Listing>
  11404.  
  11405.        These are the default menus provided with Searchlight BBS. As you add
  11406.        your own menus, those choices will also appear.
  11407.  
  11408.        From the menu editor's main screen, you can select a menu for editing
  11409.        by placing the cursor on the desired menu and pressing Enter, or by
  11410.        double-clicking the menu name with your mouse. You can add menus by
  11411.        pressing F1 and delete menus with F2. If the list of menus is longer
  11412.        than one screen, you can scroll with PgUp/PgDn keys, arrow keys, or
  11413.        by using the mouse to click on the screen messages.
  11414.  
  11415.        The menu editor always uses the "Menu Directory" that's specified in
  11416.        the CONFIG file for the node in which you are working, and all menus
  11417.        are searched for (or created in) that directory. If you need to
  11418.        change the default menu directory, you can do so by accessing the
  11419.        Pathnames Setup portion of the CONFIG program prior to running the
  11420.        menu editor software.
  11421.  
  11422.  
  11423.  
  11424.  
  11425.  
  11426.  
  11427.  
  11428.  
  11429.  
  11430.        _____________________________________________________________________
  11431.                                         177
  11432.                                     MENU EDITOR
  11433.        _____________________________________________________________________
  11434.  
  11435.  
  11436.         -------------------------------------------------------------------
  11437.        | COMPONENTS OF A MENU                                              |
  11438.         -------------------------------------------------------------------
  11439.  
  11440.        Each menu file consists of two distinct parts: a "header" part which
  11441.        contains information about the menu as a whole, and a body part,
  11442.        which consists of a list of commands on the menu. Every menu has one
  11443.        header and menus may have up to 64 commands.
  11444.  
  11445.        There are four basic menu types, and several options that control how
  11446.        a particular menu is displayed. A Word style menu is the kind of
  11447.        menu that makes up Searchlight's default main menu and files menu.
  11448.        That is, it consists of a series of one word commands, which can be
  11449.        selected by pressing the spacebar or backspace key or the first
  11450.        letter of the command, and then pressing Enter. A list of all the
  11451.        commands on this type of menu can be displayed, typically by
  11452.        selecting a "Help" command; the listing can be generated by
  11453.        Searchlight or displayed from and external file.
  11454.  
  11455.        Character style menus are similar to Word menus, except that no
  11456.        scrolling list of options is displayed. Users select commands by
  11457.        pressing 1 key, and the command is immediately executed. With this
  11458.        type of menu you'll normally want to display a list of the menu's
  11459.        commands every time that menu is used, although the exact behavior
  11460.        is up to you.
  11461.  
  11462.        MenuBar menus are the typical "Lotus 1-2-3" style menus found in
  11463.        areas such as the Mail or User command submenus.  With MenuBars, the
  11464.        commands are always displayed, and must fit on a single line
  11465.        (typically there are between three and eight selections on any
  11466.        MenuBar style menu).
  11467.  
  11468.        Picklist menus display choices as a scrollable list, using the 40
  11469.        character command descriptions. If there are more commands than fit
  11470.        on one screen, users can page through the commands and press Enter
  11471.        to select the desired command.  You can also select commands by
  11472.        typing the first few characters of the command description. In RIP
  11473.        mode, the picklist contains a scroll bar and is centered on the
  11474.        screen using the rip style associated with the menu.  Searchlight
  11475.        scales the height and width of the picklist to suit the data in the
  11476.        menu being displayed. Wallpaper is supported with picklists in the
  11477.        same manner as word or character menus.
  11478.  
  11479.        Picklists are designed primarily for use in RIP mode. Although ANSI
  11480.        mode is supported, the display is considerably less attractive due
  11481.        to the scrolling constraints imposed by ANSI terminals. You may wish
  11482.        to use picklists for menus with a large number of choices. Since hot
  11483.        keys aren't available on picklist menus, this menu type is more
  11484.        appropriate to larger menus.
  11485.  
  11486.  
  11487.  
  11488.  
  11489.        _____________________________________________________________________
  11490.                                         178
  11491.                                     MENU EDITOR
  11492.        _____________________________________________________________________
  11493.  
  11494.  
  11495.         -------------------------------------------------------------------
  11496.        | COMMANDS                                                          |
  11497.         -------------------------------------------------------------------
  11498.  
  11499.        Every menu contains a series of one or more commands. Commands
  11500.        consist of several components: a one to fifteen character command
  11501.        name, a "hotkey" that selects the command, a description of what the
  11502.        command does, access level/attribute information, and specific
  11503.        actions that Searchlight will take when executing that command.
  11504.        There are three basic command types: Internal commands execute a
  11505.        function that's built into Searchlight BBS; Door commands run
  11506.        external programs; and Menu commands transfer control to other
  11507.        menus.
  11508.  
  11509.        Menus can contain up to 64 commands. Not every command on every menu
  11510.        need be available to every person who uses the menu. Access level
  11511.        and attribute restrictions allow you to design commands that only
  11512.        certain groups of people can use -- you can even have two or more
  11513.        commands with the same name that perform different operations,
  11514.        provided that you arrange it so that only one is available to any
  11515.        particular user. You can also place commands in any order on the
  11516.        menu that you choose.
  11517.  
  11518.        Word, Character, MenuBar and Picklist menus all contain the same
  11519.        types of commands. The only difference is in how the menu is
  11520.        presented and how the command is selected.
  11521.  
  11522.  
  11523.         -------------------------------------------------------------------
  11524.        | RIP GRAPHICS                                                      |
  11525.         -------------------------------------------------------------------
  11526.  
  11527.        When in RIP graphics mode, Searchlight can generate graphical
  11528.        representations of menus instead of simply displaying text listings
  11529.        of the commands. These graphical displays can include a window face,
  11530.        a title bar, and mouse buttons, and the colors and other graphical
  11531.        features used to display the menu are governed by you via a feature
  11532.        called RIP Styles. For more information about RIP Styles, see the
  11533.        section "RIP Graphics - RIP Styles."  For now, you should know that
  11534.        pressing F6 will show you a graphical "Preview" of what your menu
  11535.        will look like in RIP graphics mode.
  11536.  
  11537.  
  11538.  
  11539.  
  11540.  
  11541.  
  11542.  
  11543.  
  11544.  
  11545.  
  11546.  
  11547.  
  11548.        _____________________________________________________________________
  11549.                                         179
  11550.                                     MENU EDITOR
  11551.        _____________________________________________________________________
  11552.  
  11553.  
  11554.         -------------------------------------------------------------------
  11555.        | MENU HEADER                                                       |
  11556.         -------------------------------------------------------------------
  11557.  
  11558.        The first screen that's displayed when editing a menu is its header
  11559.        information. Menu headers consist of 13 fields, as shown in this
  11560.        example:
  11561.  
  11562.              1. Title .................... Main Menu
  11563.              2. Clear Screen? ............ No
  11564.              3. Display Title? ........... Yes
  11565.              4. Display Filename .........
  11566.              5. Display Menu (Novice) .... Yes
  11567.              6. Display Menu (Intermed) .. No
  11568.              7. Display Menu (Expert) .... Yes
  11569.              8. Prompt Type (Novice) ..... Word
  11570.              9. Prompt Type (Intermed) ... Word
  11571.             10. Prompt Type (Expert) ..... Word
  11572.             11. Prompt String 1 .......... Command:
  11573.             12. Prompt String 2 ..........
  11574.             13. Prompt String 3 ..........
  11575.             14. Event Logging ............ No
  11576.             15. RIP Graphics Features [. . .]
  11577.  
  11578.        Here's a description of each field:
  11579.  
  11580.  
  11581.        ---------
  11582.        1 - Title
  11583.        ---------
  11584.  
  11585.        The title field contains a title, or description, for the menu as a
  11586.        whole.  For MenuBar type menus, this title is displayed before the
  11587.        menu is generated when field 3 is set to "Yes"; for Word and
  11588.        Character style menus, it's displayed whenever the menu is printed,
  11589.        unless and external file is used for menu display.
  11590.  
  11591.  
  11592.        ------------------
  11593.        2 - Clear Screen?
  11594.        3 - Display Title?
  11595.        ------------------
  11596.  
  11597.        These fields determine whether Searchlight will clear the screen, and
  11598.        display the menu title, before displaying a menu.  With MenuBar
  11599.        menus, this is every time the menu is called; for Word and Character
  11600.        type menus, whenever a display of the menu is requested.
  11601.  
  11602.  
  11603.  
  11604.  
  11605.  
  11606.  
  11607.        _____________________________________________________________________
  11608.                                         180
  11609.                                     MENU EDITOR
  11610.        _____________________________________________________________________
  11611.  
  11612.  
  11613.        -------------------------------
  11614.        4 - Display Filename (Optional)
  11615.        -------------------------------
  11616.  
  11617.        This is an optional field. For Word and Character style menus, this
  11618.        field allows you to name a file that will be displayed in place of
  11619.        the default menu generated by Searchlight. This file can be any
  11620.        text, ANSI or RIP file contained in your system "Text" directory.
  11621.        Notice that omitting the file extension causes Searchlight to select
  11622.        between ".TXT", ".ANS" and ".RIP" files as appropriate *.TXT for a
  11623.        pure text file, .ANS for an ANSI graphics file, and .RIP for RIP
  11624.        graphics images.
  11625.  
  11626.        For MenuBar type menus, this file does not replace the default
  11627.        display, but contains a message that's displayed before the default
  11628.        menu is generated.
  11629.  
  11630.  
  11631.        -------------------------------
  11632.        5 - Display Menu (Novice)
  11633.        6 - Display Menu (Intermediate)
  11634.        7 - Display Menu (Expert)
  11635.        -------------------------------
  11636.  
  11637.        These three fields determine, for users with the three possible help
  11638.        level settings, whether or not a listing of all the commands on a
  11639.        Word or Character type menu is generated each time the menu is
  11640.        entered (or re-entered after executing a command). These fields have
  11641.        no effect on MenuBar menus.
  11642.  
  11643.  
  11644.        ------------------------------
  11645.        8 - Prompt Type (Novice)
  11646.        9 - Prompt Type (Intermediate)
  11647.        10 - Prompt Type (Expert)
  11648.        ------------------------------
  11649.  
  11650.        These fields determine the type of menu (Word, Character, MenuBar or
  11651.        Picklist) that's generated from this menu file. It's possible to have
  11652.        one menu appear in several different ways, depending on the user's
  11653.        selected help level, although in most cases, you will design a menu
  11654.        to be displayed one particular way, and thus will set all three of
  11655.        these fields to the same value.
  11656.  
  11657.        Note: MenuBar style menus may not contain more choices than will fit
  11658.              in one screen line (80 characters). It is up to you to assure
  11659.              that menus will fit on a single line before selecting this
  11660.              type of menu.
  11661.  
  11662.  
  11663.  
  11664.  
  11665.  
  11666.        _____________________________________________________________________
  11667.                                         181
  11668.                                     MENU EDITOR
  11669.        _____________________________________________________________________
  11670.  
  11671.  
  11672.        ---------------------------
  11673.        11 thru 13 - Prompt Strings
  11674.        ---------------------------
  11675.  
  11676.        These three fields provide you with one to three lines to create a
  11677.        prompt. A prompt is short text that appears right before the cursor
  11678.        pauses to accept keyboard input for the menu selection. For example,
  11679.        on the default main menu, the prompt string consists of the current
  11680.        conference name in brackets, followed by the word "Command:".
  11681.  
  11682.        Notice that Searchlight color codes and macros are available for use
  11683.        in the prompt strings. "\sb" is an example of one of a macro code;
  11684.        it displays the name of the current message conference or file
  11685.        directory. A complete listing of these sequences appears earlier in
  11686.        this manual in the section "Message System - Message Macros."
  11687.  
  11688.  
  11689.        ------------------
  11690.        14 - Event Logging
  11691.        ------------------
  11692.  
  11693.        If you toggle this setting to Yes, Searchlight makes an entry in the
  11694.        system activity log each time the menu is displayed to a user. For
  11695.        more information about the activity log, see Appendix A.
  11696.  
  11697.  
  11698.        --------------------------
  11699.        15 - RIP Graphics Features
  11700.        --------------------------
  11701.  
  11702.        The options in this subsection control RIP graphics features used
  11703.        with the menu. They include:
  11704.  
  11705.  
  11706.        -------------------
  11707.        Use RIP Mouse Areas
  11708.        -------------------
  11709.  
  11710.        Since Searchlight provides its own mouse support with built in menus,
  11711.        this command is included in the menu setup screen to disable
  11712.        Searchlight from producing mouse areas for its internal menus. Set
  11713.        this option to "No" only if you are using RIPscrip files to generate
  11714.        your own menus with mouse areas.  Otherwise, leave it set to "Yes".
  11715.        The "No" setting prevents Searchlight from interfering with mouse
  11716.        areas that may have been created by your external file.
  11717.  
  11718.  
  11719.  
  11720.  
  11721.  
  11722.  
  11723.  
  11724.  
  11725.        _____________________________________________________________________
  11726.                                         182
  11727.                                     MENU EDITOR
  11728.        _____________________________________________________________________
  11729.  
  11730.  
  11731.        -----------------
  11732.        RIP Display Style
  11733.        -----------------
  11734.  
  11735.        This field selects a style for displaying the menu when in RIP
  11736.        graphics mode.  A "style" is actually a collection of colors, fonts,
  11737.        and other attributes that describe how the menu will look when
  11738.        displayed on screen. The choices that will be available here depend
  11739.        on what styles you have created using the RIP Styles Setup portion
  11740.        of the CONFIG program; for more information, see the section "RIP
  11741.        Graphics - RIP Styles."
  11742.  
  11743.  
  11744.        -------------------------
  11745.        RIP Menu Columns (Novice)
  11746.        RIP Menu Columns (Expert)
  11747.        -------------------------
  11748.  
  11749.        These fields define the number of columns that will be used to draw
  11750.        the menu in RIP graphics mode, for novice and expert callers. You
  11751.        should be careful to fill in values here that make sense for your
  11752.        menu.
  11753.  
  11754.        Note: When setting RIP display style and menu column values, use the
  11755.              RIP preview feature to see what your menu will look like. To
  11756.              access the preview feature, press F6 on the main "Edit Menus"
  11757.              screen. At least an EGA graphics monitor is required for the
  11758.              preview feature. See the RIP Graphics section of this manual
  11759.              for more information.
  11760.  
  11761.  
  11762.        -------------------
  11763.        RIP Menubar Buttons
  11764.        -------------------
  11765.  
  11766.        This setting applies only to menus where the prompt type is
  11767.        "Menubar". If set to Yes, Searchlight generates graphical RIP
  11768.        buttons for the menubar.  Otherwise, the menubar is displayed using
  11769.        plain-text characters.
  11770.  
  11771.  
  11772.        ---------------------
  11773.        Auto RIP/ICN Download
  11774.        ---------------------
  11775.  
  11776.        This option selects whether Searchlight uses automatic RIP
  11777.        downloading with the external RIP file that is associated with the
  11778.        menu (if any). Auto RIP downloading lets Searchlight store the
  11779.        menu's RIP commands, graphics, sounds, and other elements on the
  11780.        user's terminal, which makes for faster access when the menu is
  11781.        displayed frequently.
  11782.  
  11783.  
  11784.        _____________________________________________________________________
  11785.                                         183
  11786.                                     MENU EDITOR
  11787.        _____________________________________________________________________
  11788.  
  11789.        In general, this option should be enabled for best performance. You
  11790.        may wish to disable it if you use a small RIP screen with the menu
  11791.        or if your RIP screen contains any informational macros (such as the
  11792.        current conference name).
  11793.  
  11794.  
  11795.        ----------
  11796.        Menu Sound
  11797.        ----------
  11798.  
  11799.        You can place the name of a sound file (in Windows WAV format) here.
  11800.        Searchlight will play the sound each time it draws the menu. Your
  11801.        caller must be using RIPterm 2.0 or later in order to hear sounds.
  11802.  
  11803.        To use a sound file, type the name of the file without the WAV
  11804.        extension. (If your file has a Windows 95/NT long filename, type the
  11805.        short filename here).  Make sure that the WAV file is located in
  11806.        your system ICONS directory.
  11807.  
  11808.        For more information about using sound files with Searchlight, see
  11809.        the section "RIP Graphics - Sound/JPEG Support."
  11810.  
  11811.  
  11812.        ----------------------------
  11813.        Conference/Directory Tagging
  11814.        ----------------------------
  11815.  
  11816.        Searchlight lets you associate an optional list of conferences and
  11817.        file directories with a menu. Whenever that menu is displayed, its
  11818.        corresponding list of conferences and directories is activated, and
  11819.        stays activated until another menu with an associated list is
  11820.        displayed. Conference and directory association with menus gives you
  11821.        a convenient way to group related message and file areas together.
  11822.  
  11823.        The Config program lets you build conference and/or directory lists
  11824.        for each menu simply by tagging the desired areas.  At the Edit Menu
  11825.        screen, press F3 to edit the conference list, or F4 to edit the
  11826.        directory list. Add and remove items from the list simply by
  11827.        tagging/untagging the items in the picklist.
  11828.  
  11829.        The Config program stores your choices in your menu directory as a
  11830.        file with the same name as the menu, and the extension *.SUB for a
  11831.        conference list or *.DIR for a directory list. These files are text
  11832.        files, in the same format as the files used with internal commands
  11833.        200 and 201.
  11834.  
  11835.        If you untag all the items in a list, the Config program deletes the
  11836.        associated list file.
  11837.  
  11838.  
  11839.  
  11840.  
  11841.  
  11842.  
  11843.        _____________________________________________________________________
  11844.                                         184
  11845.                                     MENU EDITOR
  11846.        _____________________________________________________________________
  11847.  
  11848.  
  11849.         -------------------------------------------------------------------
  11850.        | EDITING COMMANDS                                                  |
  11851.         -------------------------------------------------------------------
  11852.  
  11853.        Once you have entered or changed the header information for a
  11854.        particular menu, you can move on and examine or create the commands
  11855.        for that menu. To access the command editor, press F1 from the
  11856.        header editing screen. Your screen will now show a list of the
  11857.        menu's commands, like this:
  11858.  
  11859.             <Enter> Edit  <F1> Add  <F2> Delete  <F3> Copy
  11860.  
  11861.             <F4> Move  <Esc> Exit
  11862.  
  11863.              Command  Key Description          Type
  11864.              Kill       K Delete Messages      INTERNAL 104
  11865.              List       L Conference List      INTERNAL 102
  11866.              Mail       M Electronic Mail      MENU     MAIL
  11867.              New        N New Message Scan     MENU     NEW
  11868.  
  11869.        Command, Key, Description and Type are some of the parameters that
  11870.        are associated with commands. For now, we'll ignore the meaning of
  11871.        these fields and concentrate on using the command editor's functions
  11872.        to manipulate the command list; individual command options will be
  11873.        discussed shortly.
  11874.  
  11875.  
  11876.        --------------
  11877.        Command Editor
  11878.        --------------
  11879.  
  11880.        To use the command editor, you select a command by positioning the
  11881.        cursor to the left of the command name. Use the up and down arrow
  11882.        keys to move the cursor; on menus where the number of commands
  11883.        exceeds the screen size, you may use PgUp and PgDn to view
  11884.        additional commands. You can also go directly to a command by
  11885.        pressing the first letter of its name (when there is more than one
  11886.        command with the same first letter, continue pressing that letter
  11887.        until you arrive at the desired location), or by using the mouse.
  11888.  
  11889.        Note that all menu editing takes place in memory only. The actual
  11890.        menu file on disk is not updated until you exit the menu editor and
  11891.        save the file.  Therefore, should you make a mistake when editing
  11892.        any part of a menu, and wish to go back to the original, simply exit
  11893.        the menu editor and choose NOT to save that menu back to disk.
  11894.  
  11895.  
  11896.  
  11897.  
  11898.  
  11899.  
  11900.  
  11901.  
  11902.        _____________________________________________________________________
  11903.                                         185
  11904.                                     MENU EDITOR
  11905.        _____________________________________________________________________
  11906.  
  11907.  
  11908.        -------------------------
  11909.        Editing Existing Commands
  11910.        -------------------------
  11911.  
  11912.        To edit a command, simply press <Enter> once the cursor is located on
  11913.        that command. You will be presented with the Edit Command screen,
  11914.        which is discussed shortly. You can also click twice on a command
  11915.        with your mouse to edit it.
  11916.  
  11917.  
  11918.        ---------------
  11919.        Adding Commands
  11920.        ---------------
  11921.  
  11922.        Press F1 to add a new command. You'll be asked to select the type of
  11923.        command you want to create, and then the Edit Command screen will
  11924.        appear, allowing you to enter the specifics for the command.
  11925.  
  11926.        When you add a command, it's added into the menu directly before the
  11927.        current cursor position. Therefore, you'll want to position the
  11928.        cursor to the desired location before pressing F1. To add a command
  11929.        to the end of the menu, place the cursor 1 line past the last
  11930.        command.
  11931.  
  11932.  
  11933.        -----------------
  11934.        Deleting Commands
  11935.        -----------------
  11936.  
  11937.        F2 is the delete command key. Press it to remove the currently
  11938.        selected item.  The menu editor confirms the deletion with a Yes/No
  11939.        prompt.
  11940.  
  11941.  
  11942.        ------------
  11943.        Copy Command
  11944.        ------------
  11945.  
  11946.        The F3 key performs a copy function. It lets you create a new command
  11947.        by duplicating an existing command. This is useful when you want to
  11948.        create several commands that are similar, as it saves you from
  11949.        re-entering the elements that are common to each command.
  11950.  
  11951.        To copy a command, place the cursor on the existing command and press
  11952.        F3.  Then, move the cursor to the place where you'd like the new
  11953.        command inserted, and press <Enter>. As with the F1 key, the new
  11954.        command is inserted before the cursor position. You can now press
  11955.        <Enter> once more to edit the new command's parameters.
  11956.  
  11957.  
  11958.  
  11959.  
  11960.  
  11961.        _____________________________________________________________________
  11962.                                         186
  11963.                                     MENU EDITOR
  11964.        _____________________________________________________________________
  11965.  
  11966.  
  11967.        ------------
  11968.        Move Command
  11969.        ------------
  11970.  
  11971.        Use the F4 key to move an existing command to a new position in the
  11972.        menu.  Begin by placing the cursor on the desired command; then
  11973.        press F4. Now, move the cursor to the location where you'd like that
  11974.        command to be moved, and press <Enter>. The command is moved, and
  11975.        the screen is redrawn to show its new location.
  11976.  
  11977.        Press the <ESC> key when you are done editing commands.
  11978.  
  11979.  
  11980.         -------------------------------------------------------------------
  11981.        | EDIT COMMAND SCREEN                                               |
  11982.         -------------------------------------------------------------------
  11983.  
  11984.        Whenever you edit a command or insert a new command, the Edit Command
  11985.        screen appears, allowing you to enter specific information about the
  11986.        command. This screen consists of two parts. The first nine lines of
  11987.        the Edit Command screen are the same for any command. The remaining
  11988.        lines vary according to the type of command (Internal, Door, or
  11989.        Menu) that's being edited.
  11990.  
  11991.        For existing commands, the correct screen is selected based on the
  11992.        type of command. When entering new commands, a prompt appears
  11993.        allowing you to select the desired type:
  11994.  
  11995.             Select Command Type:  Internal  Door  Menu  Quit
  11996.  
  11997.        The first part of the Edit Command screen looks like this:
  11998.  
  11999.                  Press F1 to Change Command Type
  12000.  
  12001.              1. Command Name .................. Bulletin
  12002.              2. Command Key ................... B
  12003.              3. Description ................... Bulletins
  12004.              4. Access Levels & Graphics [...]
  12005.  
  12006.        The first three options on this menu control what the command will
  12007.        look like when it appears on a menu. The fourth item is a submenu
  12008.        that controls who has access to the menu by a variety of criteria.
  12009.        Here's a breakdown of the options:
  12010.  
  12011.  
  12012.  
  12013.  
  12014.  
  12015.  
  12016.  
  12017.  
  12018.  
  12019.  
  12020.        _____________________________________________________________________
  12021.                                         187
  12022.                                     MENU EDITOR
  12023.        _____________________________________________________________________
  12024.  
  12025.  
  12026.        ----------------
  12027.        1 - Command Name
  12028.        ----------------
  12029.  
  12030.        This is a short name for the command, of between one and 15
  12031.        characters. This is the name that's displayed by Searchlight's
  12032.        default menu listing (for Word or Character style menus) or in the
  12033.        menubar for MenuBar type menus. If you use an external file to
  12034.        replace the default display for a Command or Character menu, then
  12035.        this name is not displayed, and is unimportant.
  12036.  
  12037.  
  12038.        ---------------
  12039.        2 - Command Key
  12040.        ---------------
  12041.  
  12042.        The most important attribute of a command is the key that needs to be
  12043.        pressed in order to trigger it. In almost all cases, this character
  12044.        is the first letter of the command name itself. However, it may be
  12045.        any other character (it is recommended that you use a character
  12046.        which appears somewhere in the name of the command, however). You
  12047.        may wish to use something other than the first character of the
  12048.        command name in order to resolve the problem of having two commands
  12049.        on a menu which start with the same letter. Searchlight always
  12050.        highlights the appropriate letter when drawing a menu display or
  12051.        menubar.
  12052.  
  12053.        Notice that the menu editor does not check to see if you enter two or
  12054.        more commands with the same command key. In fact, this is not only
  12055.        possible but it's something you'll want to do often -- as long as
  12056.        you insure, through the use of options 4 through 9, that two such
  12057.        commands are never available to the same user.
  12058.  
  12059.  
  12060.        ---------------
  12061.        3 - Description
  12062.        ---------------
  12063.  
  12064.        The command's description is used on the Searchlight generated main
  12065.        menu display (for Character or Word type menus) and in the help
  12066.        field below the cursor, when selected, in Menubar and Word menus.
  12067.  
  12068.  
  12069.         -------------------------------------------------------------------
  12070.        | CONTROLLING COMMAND AVAILABILITY                                  |
  12071.         -------------------------------------------------------------------
  12072.  
  12073.        Searchlight contains a rich set of configuration parameters that
  12074.        control which commands are available to a user whenever a menu is
  12075.        loaded or executed. Not only can certain commands be regulated by
  12076.        minimum access level and attributes, but you can omit low-access
  12077.        level commands from a menu when an experienced user logs on. In
  12078.  
  12079.        _____________________________________________________________________
  12080.                                         188
  12081.                                     MENU EDITOR
  12082.        _____________________________________________________________________
  12083.  
  12084.        fact, you can even make the same command perform different actions
  12085.        depending on the user that executes the command.  How is this done?
  12086.        Simply by having two or more commands with the same name, and same
  12087.        command key. Through proper configuration of access levels and other
  12088.        parameters, you set it up so that only one of the identically-named
  12089.        commands is available to any particular user.
  12090.  
  12091.        In exploiting these options, you may create menus which contain more
  12092.        commands than will ever actually appear at one time, and menus where
  12093.        the same command name and key appears more than once. That's not
  12094.        only OK, but recommended -- it lets you build very powerful menu
  12095.        systems.
  12096.  
  12097.        The commands available (on the "Access Levels & Graphics" submenu)
  12098.        include:
  12099.  
  12100.              1. Minimum Access Level ....... 0
  12101.              2. Maximum Access Level ....... 255
  12102.              3. Require Security Attrib ....
  12103.              4. Exclude Security Attrib ....
  12104.              5. Require Preference Attrib ..
  12105.              6. Exclude Preference Attrib ..
  12106.              7. Help Levels ................ All
  12107.              8. Graphics Required .......... All
  12108.              9. Minimum RIP Version ........ 150
  12109.             10. Maximum RIP Version ........ 9999
  12110.             11. Local Logins ............... Yes
  12111.             12. Remote Logins .............. Yes
  12112.             13. Minimum Baud Rate .......... 300
  12113.             14. Maximum Baud Rate .......... 230400
  12114.  
  12115.  
  12116.        ------------------------
  12117.        1 - Minimum Access Level
  12118.        2 - Maximum Access Level
  12119.        ------------------------
  12120.  
  12121.        These two fields work to regulate which users "see" this command when
  12122.        the menu is displayed on screen. If a user has an access level
  12123.        between the two values, and meets the other requirements in lines
  12124.        6-9, then this command is made available.  Otherwise, it is not
  12125.        displayed, nor can it be executed in any way.
  12126.  
  12127.  
  12128.        ---------------------------
  12129.        3 - Require Security Attrib
  12130.        ---------------------------
  12131.  
  12132.        This line gives the required security attributes necessary for this
  12133.        command to be executed. Similar to the way conferences and file
  12134.        areas use attributes, if a particular user has the attributes listed
  12135.        here, then the command is available; otherwise, it's omitted from
  12136.        the menu and can't be executed.
  12137.  
  12138.        _____________________________________________________________________
  12139.                                         189
  12140.                                     MENU EDITOR
  12141.        _____________________________________________________________________
  12142.  
  12143.  
  12144.        ---------------------------
  12145.        4 - Exclude Security Attrib
  12146.        ---------------------------
  12147.  
  12148.        This field specifies a set of security attributes which -- if the
  12149.        user satisfies the condition of having all of the attributes
  12150.        specified -- causes the command to be omitted from the menu.
  12151.  
  12152.        Typically, this line is used the way the Maximum Access Level line
  12153.        might be used: to omit commands from a menu: not because a user does
  12154.        not have the privilege of using that function, but because the
  12155.        command is designed for someone with a lesser overall access level.
  12156.        For example, a command to request validation instructions might be
  12157.        omitted if the user is already validated, as determined by examining
  12158.        their attributes.
  12159.  
  12160.  
  12161.        -----------------------------
  12162.        5 - Require Preference Attrib
  12163.        6 - Exclude Preference Attrib
  12164.        -----------------------------
  12165.  
  12166.        These fields modify command access by user preference attributes.
  12167.        Preference attributes are a group of 24 flags that users can set to
  12168.        choose between two or more possible ways that your BBS will look or
  12169.        work. Preference attributes are like the security attributes that
  12170.        you assign to your users' accounts, except that a preference
  12171.        attribute is something that users themselves can set or clear using
  12172.        the OPTIONS command on Searchlight's main menu. Whereas security
  12173.        attributes are something you use to grant or deny access to
  12174.        particular areas of your BBS, preference attributes enable the user
  12175.        to select between two or more alternatives, all of which are equally
  12176.        accessible.
  12177.  
  12178.        Like security attributes, you can set up menus so that particular
  12179.        preference attributes are required for the command to appear, or you
  12180.        can set it up so that particular attributes exclude that command
  12181.        from being available.
  12182.  
  12183.  
  12184.        ---------------
  12185.        7 - Help Levels
  12186.        ---------------
  12187.  
  12188.        This field controls whether or not the command appears on the menu
  12189.        based on the help level of the current user. The default is "All",
  12190.        meaning that the command is available to all help levels (Novice,
  12191.        Intermediate, and Expert).  By changing the value of this field, you
  12192.        can limit the command to only one or two of those help levels.
  12193.  
  12194.  
  12195.  
  12196.  
  12197.        _____________________________________________________________________
  12198.                                         190
  12199.                                     MENU EDITOR
  12200.        _____________________________________________________________________
  12201.  
  12202.  
  12203.        ---------------------
  12204.        8 - Graphics Required
  12205.        ---------------------
  12206.  
  12207.        This line can be used to create commands that are only available in
  12208.        certain graphics modes -- for example, only in ANSI mode, or only in
  12209.        RIP mode. For example, if RIP is specified here, then this command
  12210.        only appears for callers that have RIP compatible terminals; other
  12211.        callers can't execute the command.  You can toggle through the
  12212.        options, which contain all available combinations of ANSI, RIP and
  12213.        None graphics modes.
  12214.  
  12215.  
  12216.        ------------------------
  12217.        9 - Minimum RIP Version
  12218.        10 - Maximum RIP Version
  12219.        ------------------------
  12220.  
  12221.        These fields can be used to define what RIP versions are allowed for
  12222.        use of this command. Since Searchlight itself supports all RIP
  12223.        versions internally, there is no need to use this command in
  12224.        conjunction with internal Searchlight features. You may want to use
  12225.        it in the future with door programs that are designed to work only
  12226.        with newer versions of the RIP protocol. We recommend leaving the
  12227.        settings as shown unless you have a specific need.
  12228.  
  12229.        As an additional note on the issue of command regulation, it should
  12230.        be stated again that ALL of the requirements presented in these
  12231.        fields must be satisfied before a particular command will appear on
  12232.        a menu. If a user fails to meet any of these requirements when the
  12233.        menu is loaded, then that command is omitted.
  12234.  
  12235.        The default values for these fields when entering a new command (and
  12236.        for most of the commands in the standard menus) is either blank, or
  12237.        the minimum or maximum value of the field, meaning that the command
  12238.        is available to everyone.  Typically, only one or two of these
  12239.        fields are used at any one time, although more sophisticated menu
  12240.        systems may of course take advantage of all of them.
  12241.  
  12242.  
  12243.        ------------------
  12244.        11 - Local Logins
  12245.        12 - Remote Logins
  12246.        ------------------
  12247.  
  12248.        These settings control whether the command is available during local
  12249.        logins, remote connections, or both. (A remote connection means a
  12250.        connection that takes place over a modem, a direct serial
  12251.        connection, or via the Telnet protocol).
  12252.  
  12253.  
  12254.  
  12255.  
  12256.        _____________________________________________________________________
  12257.                                         191
  12258.                                     MENU EDITOR
  12259.        _____________________________________________________________________
  12260.  
  12261.  
  12262.        ----------------------
  12263.        13 - Minimum Baud Rate
  12264.        10 - Maximum Baud Rate
  12265.        ----------------------
  12266.  
  12267.        For modem connections, you can set a minimum and maximum baud rate
  12268.        that is required to be able to use the command.  (These settings do
  12269.        not affect local logins or Telnet connections).
  12270.  
  12271.  
  12272.         -------------------------------------------------------------------
  12273.        | INTERNAL COMMANDS                                                 |
  12274.         -------------------------------------------------------------------
  12275.  
  12276.        Now that we've discussed how to specify command names and regulate
  12277.        who can use a command, let's get down to the business of discussing
  12278.        what commands do, and how to specify those actions on the menus.
  12279.  
  12280.        The three basic kinds of commands are Internal commands, Doors, and
  12281.        Menus.  When you create a new command, you are prompted to select a
  12282.        command type.  When you edit an existing command, the command type
  12283.        is automatically selected. Fields 5 and up on the Edit Command
  12284.        screen vary depending on what type of command you're looking at.
  12285.  
  12286.        For internal commands, you'll see these fields:
  12287.  
  12288.              5. Command Number (1) ......
  12289.              6. Command Parameters (1) ..
  12290.                       ...
  12291.             11. Command Number (4) ......
  12292.             12. Command Parameters (4) ..
  12293.  
  12294.        Command Number is the number of a built in Searchlight function.
  12295.        Whenever someone selects this command choice off of a menu, what's
  12296.        actually executed is the internal function associated with the
  12297.        function number indicated here.  For example, the function to read
  12298.        messages is function number 100; any internal command which
  12299.        specifies "100" in the Command Number field will cause the read
  12300.        message function to execute. This is true regardless of the name or
  12301.        key associated with the command.
  12302.  
  12303.        Command Parameters is an optional alphanumeric field that can be used
  12304.        to supply parameters to certain internal functions. Command
  12305.        parameters typically consist of either short strings of characters
  12306.        (such as a conference name) or option flags, specified as a slash or
  12307.        dash followed by a letter, much as you would specify parameters for
  12308.        a command line program from the DOS prompt. For example, the
  12309.        parameter "/X" can be used with any internal function number to
  12310.        suppress that function from clearing the screen, and displaying its
  12311.        description, before it executes.
  12312.  
  12313.  
  12314.  
  12315.        _____________________________________________________________________
  12316.                                         192
  12317.                                     MENU EDITOR
  12318.        _____________________________________________________________________
  12319.  
  12320.        A complete list of the internal function numbers and the parameters
  12321.        associated with them appears in Appendix G, Internal Command
  12322.        Reference.
  12323.  
  12324.        Internal commands let you specify up to four pairs of command numbers
  12325.        and parameters (fields with zero do nothing).  When several
  12326.        functions are specified, they execute at once, in the order given,
  12327.        each time that command is selected.  Therefore, it's possible for a
  12328.        single command that appears on a Searchlight menu to actually
  12329.        execute two, three, or four built in functions. (It's also possible
  12330.        to execute more functions than this, including external functions,
  12331.        by executing menus -- we'll describe that process shortly).
  12332.  
  12333.  
  12334.         -------------------------------------------------------------------
  12335.        | EXTERNAL (DOOR) COMMANDS                                          |
  12336.         -------------------------------------------------------------------
  12337.  
  12338.        The second major category of command that can be included on a menu
  12339.        is a Door command. This type of command, when selected from a menu,
  12340.        executes an external program, such as a database program, a utility
  12341.        like CONFIG.EXE, a BBS game, or other program.
  12342.  
  12343.        When the command is a door, these fields appear in the Edit Command
  12344.        menu:
  12345.  
  12346.              6. Door Command ............ command.com
  12347.              7. Directory Path .......... c:\
  12348.              8. Communications Support .. DirectVideo
  12349.              9. Abort Method ............ Reboot
  12350.             10. Write Protection ........ No
  12351.             11. Parameter File .......... None
  12352.             12. Pause After Door ........ No
  12353.             13. Pass Username As ........ Real Name
  12354.             14. Pass COM Port As ........ COM1-COM4
  12355.  
  12356.        The example above shows a typical "Shell To DOS" command that might
  12357.        be included on a Sysop function menu. For more information about the
  12358.        above parameters, please see the Doors Subsystem section of this
  12359.        manual.
  12360.  
  12361.        After a door is finished executing, control returns to the menu from
  12362.        which the door was selected; thus, doors can be integrated into any
  12363.        menu in a seamless manner.
  12364.  
  12365.  
  12366.  
  12367.  
  12368.  
  12369.  
  12370.  
  12371.  
  12372.  
  12373.  
  12374.        _____________________________________________________________________
  12375.                                         193
  12376.                                     MENU EDITOR
  12377.        _____________________________________________________________________
  12378.  
  12379.  
  12380.         -------------------------------------------------------------------
  12381.        | MENU COMMANDS                                                     |
  12382.         -------------------------------------------------------------------
  12383.  
  12384.        The third type of command that you can place on a Searchlight menu is
  12385.        a Menu command -- basically, a link that starts up and displays a
  12386.        new menu. Menu commands are quite powerful, since you can use them
  12387.        to connect dozens, even hundreds, of menus together to form a
  12388.        comprehensive user interface.
  12389.  
  12390.        The options that appear for Menu commands are:
  12391.  
  12392.              5. Menu Name ......... MAIL
  12393.              6. Execution Method .. Display
  12394.              8. Stack Menu ........ Yes
  12395.  
  12396.        Menu Name is the eight-character filename of the new menu that you
  12397.        wish to load when this command is selected.  Provide the menu name
  12398.        exactly as it appears in the menu editor. Note that the named menu
  12399.        must exist in your specified menu directory when the attempt is made
  12400.        to load it. Otherwise, Searchlight will exit with an error message.
  12401.        Therefore, it is recommended to test all menu commands at least once
  12402.        before placing your system online.
  12403.  
  12404.        Execution Method tells Searchlight what to do with the menu specified
  12405.        in line 10. The usual function is called Display, and it does what
  12406.        you might expect:  displays the new menu, and allows the user to
  12407.        select a choice from that menu.
  12408.  
  12409.        The other option available here is called Execute, and it's one of
  12410.        the most powerful aspects of the entire Searchlight menu system.
  12411.        When you Execute a menu, Searchlight does not display the menu and
  12412.        solicit a choice from the user. Instead, it automatically executes
  12413.        every command on that menu in sequence. By setting up menus for
  12414.        execution, you have the capability of running long sequences of
  12415.        commands one after the other: those sequences can include internal
  12416.        functions, Door functions, and even other menus.
  12417.  
  12418.        Menu execution can be used anytime you want to string a series of
  12419.        commands together. As a typical example, the first thing Searchlight
  12420.        does after a user logs in is it executes a special menu called
  12421.        "STARTUP". This menu contains a series of commands that tells
  12422.        Searchlight to perform its usual log-in sequence: display the
  12423.        bulletins, check for new mail, etc.  Since that command sequence is
  12424.        a menu, it's completely modifiable.
  12425.  
  12426.        Stack Menu controls how Searchlight treats the stack of loaded menus.
  12427.        If set to "Yes", when Searchlight transfers control from one menu to
  12428.        another (for example, from the Main menu to the Options menu) it
  12429.        saves the name of the old menu on a list called a "stack". This is
  12430.        what enables the "Exit to previous menu" command (internal command
  12431.        #1) to work.
  12432.  
  12433.        _____________________________________________________________________
  12434.                                         194
  12435.                                     MENU EDITOR
  12436.        _____________________________________________________________________
  12437.  
  12438.        Sometimes it is desirable to load a new menu without saving the old
  12439.        menu on the stack. For example, you may have a series of menus and
  12440.        wish to switch between them without exiting to a prior menu; or you
  12441.        may wish to offer branches between otherwise unrelated portions of
  12442.        your BBS. To accomplish this kind of nonstacked behavior, set Stack
  12443.        Menu to "No".
  12444.  
  12445.        When menu stacking is disabled, the new menu loads without saving the
  12446.        name of the old menu. If the new menu contains a quit command, it
  12447.        would return control to the last menu that was loaded with the
  12448.        "Stack Menu" option set to "Yes". Note that there is no limit to the
  12449.        number of successive nonstacked menus you can load (stacked menus
  12450.        are limited to a maximum depth of 40) and also that it is
  12451.        permissible to have circular references within nonstacked menus
  12452.        (that is, menu A can load menu B, which can in turn reload menu A,
  12453.        as long as all the loads are nonstacked).
  12454.  
  12455.  
  12456.         -------------------------------------------------------------------
  12457.        | CHANGING COMMAND TYPES                                            |
  12458.         -------------------------------------------------------------------
  12459.  
  12460.        You can change the command type of an existing command by pressing F1
  12461.        while on the Edit Command screen. You'll be prompted to pick a new
  12462.        command type from the command type menu (Internal, Door or Menu).
  12463.        You can abort the change and retain the current command type by
  12464.        selecting the current type (highlighted on the menubar) or by
  12465.        selecting "Quit".
  12466.  
  12467.        Be aware that all command parameters specific to a particular type of
  12468.        command (that is, all items on the Edit Command screen after line 4)
  12469.        are cleared if you change the command type. Changing the command
  12470.        back to its original type will not restore the original information.
  12471.        Therefore, be sure you want to change the command type before doing
  12472.        so, and save a backup of the menu file (or a printout of the Edit
  12473.        Command screen) if you wish to have a record of the previous
  12474.        settings.
  12475.  
  12476.        More information about menu execution, and menu setup in general, is
  12477.        provided in the following section.
  12478.  
  12479.  
  12480.         -------------------------------------------------------------------
  12481.        | GUIDE TO MENU SETUP                                               |
  12482.         -------------------------------------------------------------------
  12483.  
  12484.        In the previous sections, we described how you can create and edit
  12485.        menus using Searchlight's menu editor. Here, we'll talk more about
  12486.        what you need to know to actually create working menu systems, along
  12487.        with tips and pitfalls to watch out for.
  12488.  
  12489.  
  12490.  
  12491.  
  12492.        _____________________________________________________________________
  12493.                                         195
  12494.                                     MENU EDITOR
  12495.        _____________________________________________________________________
  12496.  
  12497.  
  12498.        -------------------
  12499.        Standard Menu Names
  12500.        -------------------
  12501.  
  12502.        There are only two menu names that are hard-coded into Searchlight
  12503.        BBS, and therefore required for it to operate. Those names are
  12504.        STARTUP and MAIN.
  12505.  
  12506.        STARTUP is the name of the menu that's executed as soon as
  12507.        Searchlight completes the process of logging in a user, and
  12508.        transfers control to the main program module. The STARTUP menu is
  12509.        executed, not displayed; that means the commands it contains are run
  12510.        one after another. In the standard menus that are supplied with
  12511.        Searchlight, the last command in the STARTUP menu is a command to
  12512.        load the MAIN menu.
  12513.  
  12514.        Something to notice about the STARTUP menu: since it's always
  12515.        executed rather than displayed, the names of the commands in it
  12516.        don't matter too much, except perhaps as comments you can refer to
  12517.        when examining the menu.
  12518.  
  12519.        MAIN is typically the name of the menu called by STARTUP, although it
  12520.        doesn't need to be. The only time that a MAIN menu must be available
  12521.        is if you exit Searchlight by pressing ALT-X and wish to resume your
  12522.        current session by restarting the program from the command line.
  12523.        When you press ALT-X Searchlight loses track of the name of whatever
  12524.        menu you were using, and any previous menus that were loaded;
  12525.        therefore it resorts to loading the MAIN menu. If you use ALT-X
  12526.        often, you'll want to make sure that the primary menu file on your
  12527.        system is MAIN, to avoid confusion.
  12528.  
  12529.  
  12530.        -----------
  12531.        Menu Levels
  12532.        -----------
  12533.  
  12534.        Whenever one menu contains a command that calls for another menu to
  12535.        be executed or displayed, you can use the Stack Menu option to have
  12536.        Searchlight keep track of the name of the previous menu. This allows
  12537.        any menu to contain an "Exit to previous menu" command (internal
  12538.        command number 1).
  12539.  
  12540.        The level to which menus can be "stacked" in this manner is 40. That
  12541.        means that if 40 menus are loaded before any menu tries to exit back
  12542.        to a previous menu, Searchlight will not be able to keep track of
  12543.        any further menu levels.
  12544.  
  12545.        Be careful how you construct menus. If you have stacked menus that
  12546.        refer to each other in circular fashion, you can overflow the menu
  12547.        stack, which leads to unpredictable behavior. You can use unstacked
  12548.        menus instead, or reorganize your menus so that they are in a strict
  12549.        hierarchical layout.
  12550.  
  12551.        _____________________________________________________________________
  12552.                                         196
  12553.                                     MENU EDITOR
  12554.        _____________________________________________________________________
  12555.  
  12556.  
  12557.        ----------------
  12558.        Executable Menus
  12559.        ----------------
  12560.  
  12561.        When all the commands on an executable menu finish, control returns
  12562.        to the previous menu (i.e. the menu which called the executable
  12563.        menu).
  12564.  
  12565.        Should the STARTUP menu be allowed to finish (if a "Quit" command is
  12566.        placed on the main menu, for example) Searchlight will hang up and
  12567.        recycle back to the Login program. This may be used to provide a
  12568.        "quick logoff" function, if desired.
  12569.  
  12570.  
  12571.  
  12572.  
  12573.  
  12574.  
  12575.  
  12576.  
  12577.  
  12578.  
  12579.  
  12580.  
  12581.  
  12582.  
  12583.  
  12584.  
  12585.  
  12586.  
  12587.  
  12588.  
  12589.  
  12590.  
  12591.  
  12592.  
  12593.  
  12594.  
  12595.  
  12596.  
  12597.  
  12598.  
  12599.  
  12600.  
  12601.  
  12602.  
  12603.  
  12604.  
  12605.  
  12606.  
  12607.  
  12608.  
  12609.  
  12610.        _____________________________________________________________________
  12611.                                         197
  12612.                                   DOORS SUBSYSTEM
  12613.        _____________________________________________________________________
  12614.  
  12615.  
  12616.         -------------------------------------------------------------------
  12617.        | SEARCHLIGHT BBS DOORS SUBSYSTEM                                   |
  12618.         -------------------------------------------------------------------
  12619.  
  12620.  
  12621.        ------------
  12622.        Introduction
  12623.        ------------
  12624.  
  12625.        The Searchlight BBS Doors system provides a method for integrating
  12626.        external programs with your BBS. You can use doors to add additional
  12627.        features and capabilities to your system, such as databases, games,
  12628.        user polls, sysop utilities, etc.  Doors can be programs provided by
  12629.        TeleGrafix, programs you write yourself, or programs written by
  12630.        others. In addition, many general purpose DOS programs and utilities
  12631.        can be used as Doors.
  12632.  
  12633.        Most popular bulletin board systems provide only a means of executing
  12634.        a subprocess as the Doors mechanism. This has led to a plethora of
  12635.        external programs, drivers, and other methods of directing a Door
  12636.        program's input and output to the COM port for use by a remote
  12637.        caller. By contrast, Searchlight BBS fully supports communications
  12638.        during Door operation; you can use almost any program directly as a
  12639.        door, without having to alter the program, load a serial port
  12640.        driver, or use a batch file. Even programs which use full-screen
  12641.        cursor manipulation, color, IBM type character graphics, and simple
  12642.        sound effects will work, as long as these programs run in text mode.
  12643.        In addition, the Searchlight Doors system monitors and handles loss
  12644.        of carrier; optionally write-protects disk drives while the Door is
  12645.        active; and consumes less than 75K of memory above DOS, freeing the
  12646.        rest of your RAM for use by the Door software.
  12647.  
  12648.        We've also included features that help make Searchlight compatible
  12649.        with many of the Door programs already written for other BBS
  12650.        systems. Searchlight's COM port support can be fully disabled,
  12651.        allowing you to run programs which provide their own COM support,
  12652.        and Searchlight will optionally generate a door "drop" file such as
  12653.        DOOR.SYS.
  12654.  
  12655.        Note: If you use an ANSI.SYS replacement which bypasses the BIOS
  12656.              level of I/O, you may be unable to run DOS shells and other
  12657.              programs that output through DOS on your system. We recommend
  12658.              switching back to the original DOS ANSI.SYS driver when
  12659.              running Doors with Searchlight.
  12660.  
  12661.  
  12662.  
  12663.  
  12664.  
  12665.  
  12666.  
  12667.  
  12668.  
  12669.        _____________________________________________________________________
  12670.                                         198
  12671.                                   DOORS SUBSYSTEM
  12672.        _____________________________________________________________________
  12673.  
  12674.  
  12675.         -------------------------------------------------------------------
  12676.        | SETTING UP DOORS                                                  |
  12677.         -------------------------------------------------------------------
  12678.  
  12679.        Doors are usually installed by adding a command to one of
  12680.        Searchlight's existing menus, or by creating a new menu. See the
  12681.        previous chapter on menu editing for more details about the process
  12682.        of editing menus and entering new commands.
  12683.  
  12684.        If you are new to Doors and Searchlight BBS, we suggest the following
  12685.        steps to create a menu in which to place your first Door programs:
  12686.  
  12687.             * Run the Menu Editor program (see previous section). Access
  12688.               the MAIN menu, and delete the "Doors" command that resides
  12689.               there.
  12690.  
  12691.             * Press F1 to create a new command. Make this command "Doors"
  12692.               (same name as the previous command) but have it be a Menu
  12693.               type command. Enter "DOORS" as the name of the menu to
  12694.               display.
  12695.  
  12696.             * Save the MAIN menu, then create a new menu called "DOORS".
  12697.               Enter your desired Door commands as entries in this menu.
  12698.               Finally, execute them by selecting the "Doors" command from
  12699.               Searchlight's main menu.
  12700.  
  12701.        You can, of course, add Door programs to existing menus or create
  12702.        other menu structures. The above is just a suggestion to get you
  12703.        started.
  12704.  
  12705.  
  12706.         -------------------------------------------------------------------
  12707.        | DOOR PARAMETERS                                                   |
  12708.         -------------------------------------------------------------------
  12709.  
  12710.        When you are editing a menu and you reach the place where you need to
  12711.        enter the commands for a particular Door program, you'll see this
  12712.        screen:
  12713.  
  12714.              6. Door Command ............ command.com
  12715.              7. Directory Path .......... c:\
  12716.              8. Communications Support .. DirectVideo
  12717.              9. Abort Method ............ Reboot
  12718.             10. Write Protection ........ No
  12719.             11. Parameter File .......... None
  12720.             12. Pause After Door ........ No
  12721.             13. Pass Username As ........ Login Name
  12722.             14. Pass COM Port As ........ COM1-COM4
  12723.  
  12724.  
  12725.  
  12726.  
  12727.  
  12728.        _____________________________________________________________________
  12729.                                         199
  12730.                                   DOORS SUBSYSTEM
  12731.        _____________________________________________________________________
  12732.  
  12733.  
  12734.        ----------------
  12735.        6 - Door Command
  12736.        ----------------
  12737.  
  12738.        This is the name of the program that will be run. It should look
  12739.        exactly like the command line you'd normally type when starting the
  12740.        program from DOS, including any parameters, with one exception: if
  12741.        the program is a COM or EXE file, you should specify the .COM or
  12742.        .EXE extension in the program's name (for example, use COMMAND.COM
  12743.        instead of just COMMAND). If you don't specify an extension of .COM
  12744.        or .EXE, Searchlight assumes the program you wish to run is a batch
  12745.        (.BAT) file or a DOS command such as DIR, TYPE, etc. In this case,
  12746.        Searchlight will first load a copy of COMMAND.COM, and then execute
  12747.        the command. If the command is really a COM or EXE file and you don't
  12748.        say so, it will still run, but you'll have an extra copy of
  12749.        COMMAND.COM in memory that doesn't need to be there.
  12750.  
  12751.        If COMMAND.COM must be loaded, Searchlight will try to find it by
  12752.        examining the environment table for the line "COMSPEC=". Failing to
  12753.        find this, it will attempt to load COMMAND.COM from the current
  12754.        directory. If COMMAND.COM (or the Door program itself) cannot be
  12755.        found, the door won't be executed and control will return to
  12756.        Searchlight BBS.
  12757.  
  12758.  
  12759.        ------------------
  12760.        7 - Directory Path
  12761.        ------------------
  12762.  
  12763.        This is the drive/directory specification for the directory that will
  12764.        be made the current directory before your program is run. Since many
  12765.        programs require data files that reside in the current directory
  12766.        when they are run, you can specify the directory to switch to before
  12767.        the program is executed.  Searchlight automatically switches back to
  12768.        its own directory when the door closes.
  12769.  
  12770.        If you do not need to change directories when running an external
  12771.        program, or you wish to use the current directory, type a single
  12772.        period (".") as the directory name.
  12773.  
  12774.  
  12775.        --------------------------
  12776.        8 - Communications Support
  12777.        --------------------------
  12778.  
  12779.        In this field, you specify what type of communications support
  12780.        service you want Searchlight to provide when it executes your door
  12781.        program.  Communications support services let programs communicate
  12782.        with a remote terminal, even if the program was not originally
  12783.        designed to run as a door.  Searchlight can also allow door programs
  12784.        originally designed to work with modems to communicate via a telnet
  12785.        connection on the internet.
  12786.  
  12787.        _____________________________________________________________________
  12788.                                         200
  12789.                                   DOORS SUBSYSTEM
  12790.        _____________________________________________________________________
  12791.  
  12792.        Values for this field include BIOS, None, Force-Color, DirectVideo
  12793.        and Fossil. "None" specifies that no support will be provided for
  12794.        this program; the program is expected to interface with the
  12795.        communications port itself. Use a setting of None with products that
  12796.        are designed as door programs, but not designed specifically for
  12797.        Searchlight BBS. Usually, "None" programs will require parameters to
  12798.        tell them which serial port and baud rate to use; they may read this
  12799.        information in the doors system configuration file, Searchlight
  12800.        CONFIG file, or via explicit command line parameters. It is not
  12801.        recommended that you use the "None" setting with the Windows version
  12802.        of Searchlight BBS.
  12803.  
  12804.        Select the "BIOS" option when running programs that use BIOS function
  12805.        calls for input and output. This normally covers command line
  12806.        programs (like the DOS command prompt) and simple full screen
  12807.        programs; it also includes many door programs written expressly for
  12808.        Searchlight BBS. The "Force-Color" mode is similar to BIOS, but
  12809.        allows programs to use color codes on a remote terminal even if the
  12810.        local terminal is monochrome.
  12811.  
  12812.        If you want to run an application program that isn't specifically
  12813.        designed to be used on a BBS_such as a database program or a
  12814.        business application_you'll use the DirectVideo setting. Searchlight
  12815.        can run almost any program, as long as the program has a text
  12816.        (character) based interface.
  12817.  
  12818.        "DirectVideo" mode allows you to run any program that does not use
  12819.        BIOS function calls (it also works with BIOS compatible programs).
  12820.        Use the DirectVideo setting if your program is a full screen
  12821.        application that features fast screen updating. You can also use the
  12822.        DirectVideo setting if you are not sure whether your application
  12823.        uses BIOS function calls.
  12824.  
  12825.        In "Fossil" mode, Searchlight emulates a Fossil driver. Fossil is an
  12826.        MS-DOS based communications specification commonly used by door
  12827.        programs designed for use on a BBS. When this mode is selected,
  12828.        Searchlight emulates a Fossil driver, eliminating the need for a
  12829.        stand-alone driver when running Fossil-compatible door programs. See
  12830.        the section "Searchlight's FOSSIL Emulation Feature" later in this
  12831.        chapter for more information about the Fossil option.
  12832.  
  12833.        For more information on the Communications Support setting and on
  12834.        using various types of door programs, see the section "What Programs
  12835.        Can Be Used As Doors?" later in this chapter.
  12836.  
  12837.        Note: Versions of Searchlight earlier than 4.0 used the term
  12838.              "Standard" instead of BIOS for the BIOS compatible door mode.
  12839.              If you are installing a door program which mentions "Standard"
  12840.              communications support, use BIOS instead.
  12841.  
  12842.  
  12843.  
  12844.  
  12845.  
  12846.        _____________________________________________________________________
  12847.                                         201
  12848.                                   DOORS SUBSYSTEM
  12849.        _____________________________________________________________________
  12850.  
  12851.  
  12852.        ----------------
  12853.        9 - Abort Method
  12854.        ----------------
  12855.  
  12856.        This field specifies the action to be taken if the Doors system
  12857.        detects a carrier signal loss (i.e. if the user hangs up the
  12858.        telephone) during the operation of a door. If set to "None", the
  12859.        carrier is not monitored, and no action is taken. If set to
  12860.        "Terminate, the door system will attempt to terminate the running
  12861.        program via the DOS terminate procedure. If set to "Reboot", the
  12862.        doors system will reboot the computer when a carrier loss occurs.
  12863.  
  12864.        "None" should only be used with programs that do their own carrier
  12865.        loss checking, or with programs that must not be interrupted during
  12866.        processing.  "Terminate" is the standard abort method; it will work
  12867.        with programs that abort normally through the DOS TERMINATE process.
  12868.        "Terminate" is the preferred way to abort a program.
  12869.  
  12870.        Some programs, notably COMMAND.COM, will not abort via the standard
  12871.        DOS call, because they replace the return vector with a pointer back
  12872.        to their own code. Many games and other ill-behaved programs fall
  12873.        under this category. If a program will not return to the BBS via the
  12874.        TERMINATE call, an alternative is to set abort type to "Reboot",
  12875.        which will initiate a warm boot of the computer if a carrier loss is
  12876.        detected during the operation of the door program. If you use this
  12877.        method of abort, you must include in your AUTOEXEC.BAT file the
  12878.        commands necessary to start up Searchlight after the system boots
  12879.        itself up. Since it will be an unattended bootup, you must eliminate
  12880.        any programs from your AUTOEXEC that prompt you for input when they
  12881.        run.
  12882.  
  12883.        Note: If you use a multitasker, such as DESQview or OS/2, the reboot
  12884.              and terminate options may not operate correctly on your
  12885.              system. Try them before allowing callers to access your doors.
  12886.              Using "Reboot" is not recommended for multiuser systems, since
  12887.              it can interrupt other sessions in progress. It's also not
  12888.              recommended if you employ a write-buffered disk cache.
  12889.  
  12890.  
  12891.        ---------------------
  12892.        10 - Write Protection
  12893.        ---------------------
  12894.  
  12895.        This field determines whether the disk drives will be write protected
  12896.        during the execution of the door. If set to No, write protection is
  12897.        not in effect, and all disk i/o proceeds as usual. If set to Yes,
  12898.        software write protect is enabled on all disk drives. No disk writes
  12899.        will be allowed while this door is running.
  12900.  
  12901.        Write protection is useful when you wish to run a program that allows
  12902.        users to specify filenames to which data will be written. For
  12903.        example, a game program might have a "save game" option that asks
  12904.  
  12905.        _____________________________________________________________________
  12906.                                         202
  12907.                                   DOORS SUBSYSTEM
  12908.        _____________________________________________________________________
  12909.  
  12910.        the user to enter the name of the file to hold the saved game. If
  12911.        the user were to type the name of an existing file, he or she could
  12912.        easily destroy important data on your disk.  The software write
  12913.        protect guards against this. Any attempt to write to a disk while
  12914.        write protect is in effect will result in the standard DOS "Write
  12915.        protect error writing drive" message.
  12916.  
  12917.  
  12918.        -------------------
  12919.        11 - Parameter File
  12920.        -------------------
  12921.  
  12922.        Searchlight supports four kinds of parameter files (also known as
  12923.        "drop files") when launching a door program:  PCBOARD.SYS version 12
  12924.        and 14, DOOR.SYS, and DORINFOx.DEF.
  12925.  
  12926.        Parameter files are special files created by Searchlight just before
  12927.        executing a door program; they contain information that the door can
  12928.        read to find out the name of the person running the door, the
  12929.        current communications parameters, time limits and access levels,
  12930.        and many other items. Depending on what kind of file a particular
  12931.        door program expects, you can choose to create a DOOR.SYS file,
  12932.        DORINFOx.DEF file, or PCBOARD.SYS file when running a door by
  12933.        toggling the "Parameter File" field to the appropriate value.
  12934.  
  12935.        When DOOR.SYS is selected, Searchlight creates a text file called
  12936.        "DOOR.SYS" in the home directory of the current node. DOOR.SYS
  12937.        contains standard information about the current user and current
  12938.        status of the BBS.
  12939.  
  12940.        The option DOOR.SYS 4.0 is provided for backward compatibility with
  12941.        door programs that were created before RIP graphics were a standard
  12942.        part of BBS systems. If a door program does not work correctly with
  12943.        RIP compatible terminals, try the DOOR.SYS 4.0 option instead of the
  12944.        DOOR.SYS option.
  12945.  
  12946.        If DORINFOx.DEF is selected, Searchlight creates a file called
  12947.        "DORINFOx.DEF", where "x" a the node number from 1 to 9. If the
  12948.        current node number is between 1 and 9, Searchlight writes the
  12949.        DORINFOx.DEF file to the node where the door is launched from,
  12950.        rather than from the SLBBS home directory. For node numbers greater
  12951.        than 9, Searchlight creates a file called "DORINFO1.DEF" in the
  12952.        node's home directory.
  12953.  
  12954.        Note: When setting up door programs that use DOOR.SYS or
  12955.              DORINFOx.DEF, be sure to configure the program so that it
  12956.              looks for the drop file in the appropriate directory, as
  12957.              outlined above. Door programs have many different means of
  12958.              configuration; be sure to read each door program's
  12959.              documentation thoroughly before attempting to install it in
  12960.              Searchlight BBS.
  12961.  
  12962.  
  12963.  
  12964.        _____________________________________________________________________
  12965.                                         203
  12966.                                   DOORS SUBSYSTEM
  12967.        _____________________________________________________________________
  12968.  
  12969.  
  12970.        ---------------------
  12971.        12 - Pause After Door
  12972.        ---------------------
  12973.  
  12974.        If you toggle this setting to "Yes", Searchlight pauses after
  12975.        executing the door program with the message "Press any key to
  12976.        continue".
  12977.  
  12978.  
  12979.        ---------------------
  12980.        13 - Pass Username As
  12981.        ---------------------
  12982.  
  12983.        If you allow alias names on your system, this setting dictates
  12984.        whether a user's real name or alias name is passed to the door
  12985.        program. Choose "Real Name" if you always want to pass the real
  12986.        name; "Alias Name" if you always want to pass the alias; or "Login
  12987.        Name" if you want to pass whichever name was used to log on.
  12988.  
  12989.        This setting affects the name placed in a door.sys, dorinfo.def or
  12990.        pcboard.sys dropfile; it also affects the name returned by the %U
  12991.        macro.
  12992.  
  12993.  
  12994.        ---------------------
  12995.        14 - Pass COM Port As
  12996.        ---------------------
  12997.  
  12998.        This setting affects what number Searchlight passes as the
  12999.        communications port number in door.sys, dorinfo.def and pcboard.sys
  13000.        dropfiles. The default setting, COM1-COM4, passes the "COM Port
  13001.        Number" as specified on the first line of the Communications Setup
  13002.        screen.
  13003.  
  13004.        You can also pass the "External Port Number" or the "Node Number" as
  13005.        the COM Port. The latter settings are valuable if you use a
  13006.        DigiBoard, FOSSIL-driven device, or other nonstandard device on your
  13007.        system, or in any case where you have more than four nodes running
  13008.        on a single PC.
  13009.  
  13010.  
  13011.        -----------------
  13012.        PCBOARD.SYS Files
  13013.        -----------------
  13014.  
  13015.        For backward compatibility, Searchlight will still use the "Door
  13016.        Parameters Filename" in the CONFIG file as the target filename when
  13017.        creating a PCBOARD.SYS file. However, for convenience and for the
  13018.        sake of consistency with the new DOOR.SYS and DORINFOx.DEF options,
  13019.        Searchlight will simply create a file named "PCBOARD.SYS" in the
  13020.        home directory if the "Door Parameters Filename" is left blank.
  13021.        Unless you have a need to place the PCBOARD.SYS file in a particular
  13022.  
  13023.        _____________________________________________________________________
  13024.                                         204
  13025.                                   DOORS SUBSYSTEM
  13026.        _____________________________________________________________________
  13027.  
  13028.        directory or a need to have it named something other than
  13029.        PCBOARD.SYS, we recommend blanking that CONFIG field and letting
  13030.        Searchlight use its default behavior.
  13031.  
  13032.  
  13033.        ----------------------------------
  13034.        If You Receive An Error Message...
  13035.        ----------------------------------
  13036.  
  13037.        If you give the name of a non-existent program or directory when
  13038.        setting up doors you'll get an error message when you try to execute
  13039.        the command from within Searchlight. Check your setup screen and try
  13040.        to correct the error.
  13041.  
  13042.        Door programs can also fail to run if there's insufficient memory for
  13043.        the door to operate, or if Searchlight cannot locate the COMMAND.COM
  13044.        file when executing batch files or internal DOS commands. The latter
  13045.        situation can usually be corrected by examining your COMSPEC
  13046.        environment variable, or by placing a copy of COMMAND.COM in the
  13047.        SLBBS home directory.
  13048.  
  13049.        Of course, door programs can fail to operate correctly once they've
  13050.        been executed, even if the door is properly set up on Searchlight's
  13051.        end. If a door program runs, but displays error messages or seems to
  13052.        operate incorrectly, it's usually best to consult that program's
  13053.        documentation for more information (or contact the program's vendor,
  13054.        or others who use the program).
  13055.  
  13056.  
  13057.         -------------------------------------------------------------------
  13058.        | WHAT PROGRAMS CAN BE USED AS DOORS?                               |
  13059.         -------------------------------------------------------------------
  13060.  
  13061.        Searchlight's Doors system allows you to run almost any program that
  13062.        is designed to be used as a door on a BBS system, including many
  13063.        programs that were originally designed to be used with other BBS
  13064.        software products. In addition, Searchlight allows you, through the
  13065.        use of its BIOS and DirectVideo door modes, to run any text based
  13066.        program as a door, even if the program was not originally intended
  13067.        to be used with a BBS.
  13068.  
  13069.        BIOS mode is intended for programs that use the BIOS interrupts for
  13070.        input and output; DirectVideo mode is for programs that don't.
  13071.        Generally speaking, programs with command line interfaces (like a
  13072.        DOS prompt) tend to use BIOS functions, whereas full screen
  13073.        applications usually require the DirectVideo interface. If you're
  13074.        not sure which setting is appropriate for your application, we
  13075.        recommend trying BIOS first; if it doesn't work, switch to
  13076.        DirectVideo. For more information about the DirectVideo option, see
  13077.        below.
  13078.  
  13079.  
  13080.  
  13081.  
  13082.        _____________________________________________________________________
  13083.                                         205
  13084.                                   DOORS SUBSYSTEM
  13085.        _____________________________________________________________________
  13086.  
  13087.  
  13088.        ---------------------------
  13089.        Using COMMAND.COM as a Door
  13090.        ---------------------------
  13091.  
  13092.        If you use COMMAND.COM as a Door, as shown in our example in the
  13093.        previous section "Doors Subsystem - Door Command", you'll receive a
  13094.        DOS command prompt (i.e. "C:\>") at the remote terminal, and you
  13095.        will be able to enter DOS commands, such as DIR and CHKDSK, as well
  13096.        as execute other programs. It is recommended that you use
  13097.        DirectVideo mode for DOS prompts.
  13098.  
  13099.        The Reboot abort method is normally used with a COMMAND.COM door,
  13100.        since the new DOS shell points the abort return pointers back to
  13101.        itself and not back to Searchlight. Make sure you have your system
  13102.        configured to run your BBS when it is booted up (i.e. as part of the
  13103.        AUTOEXEC.BAT file) whenever you use a Reboot abort method.
  13104.  
  13105.        To exit back to Searchlight from the command shell, give the command
  13106.        EXIT.
  13107.  
  13108.  
  13109.        --------------------------
  13110.        Using Batch Files as Doors
  13111.        --------------------------
  13112.  
  13113.        The use of batch files (files with the .BAT extension), as well as
  13114.        DOS direct commands (such as DIR and COPY), is supported by the
  13115.        Doors system through the execution of a COMMAND.COM door. When you
  13116.        give a command line which does not specify a .COM or .EXE file to be
  13117.        run, Searchlight loads a COMMAND.COM shell and passes your command
  13118.        to it; this is necessary for the execution of DOS commands and batch
  13119.        files.
  13120.  
  13121.        In order to run COMMAND.COM, of course, it must be available on your
  13122.        disk.  Searchlight finds COMMAND.COM by looking for the "COMSPEC="
  13123.        line in the environment table. If no "COMSPEC" entry is found, it
  13124.        attempts to load the command processor from the current directory.
  13125.        If this fails, the message "Error running command" appears, and
  13126.        control returns to the BBS (you also get this error message if the
  13127.        command or program you're trying to execute is invalid or does not
  13128.        exist).
  13129.  
  13130.        Note: Searchlight will assume that any command without a .COM or
  13131.              .EXE extension is a batch file. Therefore, when executing
  13132.              commands that are executable files, always include the
  13133.              extension in the command line.
  13134.  
  13135.  
  13136.  
  13137.  
  13138.  
  13139.  
  13140.  
  13141.        _____________________________________________________________________
  13142.                                         206
  13143.                                   DOORS SUBSYSTEM
  13144.        _____________________________________________________________________
  13145.  
  13146.  
  13147.        --------------------------------------
  13148.        Searchlight's FOSSIL Emulation Feature
  13149.        --------------------------------------
  13150.  
  13151.        Many door programs designed for use on a BBS system employ the Fossil
  13152.        driver standard for serial communications.  Searchlight BBS provides
  13153.        a unique Fossil emulation feature for door programs that, in effect,
  13154.        lets Searchlight become a Fossil driver when it runs a door. This
  13155.        feature lets you run doors that require a Fossil driver without the
  13156.        need to load an external Fossil like BNU or X00. A significant
  13157.        benefit of this feature is that it allows you to run Fossil-driven
  13158.        doors through a DigiBoard, a Windows-based communications port, or a
  13159.        Telnet connection. Other benefits include much simpler Door
  13160.        installation, and less memory overhead (since you no longer need to
  13161.        load a separate Fossil driver).
  13162.  
  13163.        Fossil support is configured as a "Communications Support" type on
  13164.        your door setup screens. To use it, simply toggle this switch to
  13165.        "Fossil". When the door program runs, Searchlight will make a Fossil
  13166.        (INT 14) interface available for the door's use. You can also use
  13167.        Fossil support with external protocols. A separate "Fossil
  13168.        Emulation" switch is provided on the protocol setup screens for
  13169.        toggling this feature.
  13170.  
  13171.        Searchlight's Fossil driver only supports one communications channel
  13172.        (the current COM port that your BBS is using for that node). It
  13173.        ignores the COM port number passed to it from applications, and also
  13174.        ignores any requests to change the baud rate or communications
  13175.        parameters. This simplifies door installation, since you do not need
  13176.        to be concerned with what COM port number or baud rate your door
  13177.        programs attempt to use. On a multinode system, a door configured to
  13178.        run from COM1 could be launched from any node, and Searchlight would
  13179.        automatically direct its output to the correct port (or telnet
  13180.        connection) for that node. (Of course, you must make sure the door
  13181.        is configured to use a Fossil driver).
  13182.  
  13183.        Door programs which require the use of more than one communications
  13184.        port cannot be used with Searchlight's Fossil support, but you can
  13185.        instead use external Fossil drivers for these doors.
  13186.  
  13187.        With the Windows version of Searchlight BBS, Fossil emulation is also
  13188.        enabled automatically during an event, so you can run events that
  13189.        use Fossil driver functions without any special preparation. (To use
  13190.        Fossil features during events with the DOS version, an external
  13191.        driver program called SF is provided).
  13192.  
  13193.  
  13194.  
  13195.  
  13196.  
  13197.  
  13198.  
  13199.  
  13200.        _____________________________________________________________________
  13201.                                         207
  13202.                                   DOORS SUBSYSTEM
  13203.        _____________________________________________________________________
  13204.  
  13205.  
  13206.        -------------------------
  13207.        Running DirectVideo Doors
  13208.        -------------------------
  13209.  
  13210.        In the DirectVideo mode, Searchlight monitors video RAM and
  13211.        periodically updates the remote user's screen to match.  During a
  13212.        Direct Video door, you can execute any text-mode application
  13213.        program, including programs like databases, word processors, etc.
  13214.        You can also select DirectVideo mode when running a DOS shell, which
  13215.        in turn enables you to run these kinds of programs from the command
  13216.        prompt during your remote DOS session.
  13217.  
  13218.        DirectVideo mode is inherently different than BIOS mode. In BIOS
  13219.        mode, Searchlight captures each character or screen control command
  13220.        from the door program and outputs it directly to the remote screen.
  13221.        In DirectVideo mode, Searchlight sends a picture of the local video
  13222.        screen to the remote screen, and updates that picture as the local
  13223.        screen changes. The main functional difference you'll notice is that
  13224.        Searchlight will update the remote screen in phases when the local
  13225.        screen is changing rapidly.
  13226.  
  13227.        Searchlight's DirectVideo door support has a number of special
  13228.        features, all of which are built in and require no special settings
  13229.        on your part:
  13230.  
  13231.             * The timing between screen updates is determined automatically
  13232.               based on the screen content, baud rate, and keyboard
  13233.               activity. Searchlight keeps the screen reasonably current
  13234.               while minimizing transmission time and redundant screen
  13235.               updates.
  13236.  
  13237.             * Searchlight can handle 24 or 25 line screens. The size of the
  13238.               remote user's screen is determined automatically right before
  13239.               the door begins to run. In the event that the remote screen
  13240.               is only 24 lines but the local application uses 25 lines,
  13241.               Searchlight dynamically displays either lines 1-24 or lines
  13242.               2-25 depending on the cursor's location. If you want to have
  13243.               full access to 25 lines when running a door, disable your
  13244.               term program's status line immediately before executing the
  13245.               door.
  13246.  
  13247.             * When the local application scrolls the screen, Searchlight
  13248.               also updates the remote screen by scrolling it. This is a
  13249.               significant enhancement compared with typical direct video
  13250.               drivers, which often repaint the entire screen in the event
  13251.               of scrolling.
  13252.  
  13253.        All function keys and special keys are active during a direct video
  13254.        door. In most cases, you will need to activate your terminal
  13255.        program's "Doorway Mode" in order to be able to use them.
  13256.  
  13257.  
  13258.  
  13259.        _____________________________________________________________________
  13260.                                         208
  13261.                                   DOORS SUBSYSTEM
  13262.        _____________________________________________________________________
  13263.  
  13264.  
  13265.         -------------------------------------------------------------------
  13266.        | PASSING PARAMETERS TO A DOOR PROGRAM                              |
  13267.         -------------------------------------------------------------------
  13268.  
  13269.        Often, a program running as a Door will need to know something about
  13270.        the status of the BBS system at the time the program is run. Many
  13271.        programs will need to know the name or access level of the person
  13272.        who is using the door; others will need information such as the
  13273.        user's time limit or the active COM port and communications speed
  13274.        being used.  Searchlight provides several methods for communicating
  13275.        this information to the Door process.
  13276.  
  13277.  
  13278.        ---------------------------------
  13279.        Using Command Line Metacharacters
  13280.        ---------------------------------
  13281.  
  13282.        The easiest and most portable way to pass parameters to a program is
  13283.        via the command line. Searchlight provides 19 system variables, or
  13284.        "metacharacters", which you can include on a command line in a menu
  13285.        or autodoor definition.  When Searchlight executes the door, the
  13286.        metacharacters are replaced with specific information. Here is a
  13287.        list of the characters available:
  13288.  
  13289.            Code Description
  13290.            ===========================================================
  13291.             %N  Current User's Name
  13292.             %U  Current User's Name, with spaces replaced by underbars
  13293.             %K  Current User's First Name
  13294.             %A  User's BBS Access Level
  13295.             %F  User's FILES Access Level
  13296.             %G  ANSI Graphics Mode (C, M, or N)
  13297.             %T  User's time limit, in minutes
  13298.             %M  Amount of time left in current session (in minutes)
  13299.             %L  Time the user logged in (HH:MM)
  13300.             %B  DTE Baud Rate (Locked Baud Rate)
  13301.             %R  Effective Baud Rate (Modem Speed)
  13302.             %P  Active Communications Port (0-4)
  13303.             %C  Sysop `Chat Available' status (Y or N)
  13304.             %S  BBS System Name
  13305.             %O  Node Number
  13306.             %I  User's alias name
  13307.             %J  User's alias name with spaces replaced by underbars
  13308.             %X  User's login name
  13309.             %Y  User's login name with spaces replaced by underbars
  13310.             %H  Current conference name
  13311.             %D  Current file directory name
  13312.  
  13313.        Note: You can also use these codes in messages, text files, RIP
  13314.              files, menu titles, and menu prompt strings.
  13315.  
  13316.  
  13317.  
  13318.        _____________________________________________________________________
  13319.                                         209
  13320.                                   DOORS SUBSYSTEM
  13321.        _____________________________________________________________________
  13322.  
  13323.        The time parameter, %L, is given in the format "HH:MM", as a 24-hour
  13324.        time.  All other parameters appear as strings of characters or
  13325.        decimal numbers in the range 0 to 255. Baud rates appear as "2400",
  13326.        "9600", etc. The %N and %U parameters differ in that %N returns the
  13327.        user's exact name, including any spaces, while %U replaces spaces
  13328.        with underbars. Since the space character normally delimits command
  13329.        line parameters, many programs won't interpret a name containing
  13330.        spaces properly; you can use %U to send the full name as one word.
  13331.        %K returns the first name with all but the first character converted
  13332.        to lowercase.
  13333.  
  13334.        %P returns a value of zero if the current user is logged in locally;
  13335.        otherwise, it returns the value of the active COM port, 1 through 4.
  13336.        If %P returns zero, the value returned by %B is undefined and should
  13337.        be ignored.
  13338.  
  13339.        As an example of how to use metacharacters, let's say you have a game
  13340.        called SLOTS that you want to run as a door.  SLOTS takes as a
  13341.        command line parameter the name of the person running the program;
  13342.        it uses your name to keep a high scores table. The command line
  13343.        syntax is SLOTS <name>.
  13344.  
  13345.        To make SLOTS accept the first name of the logged in user, without
  13346.        the user having to type his or her name, enter SLOTS %K as the
  13347.        command line for the door:
  13348.  
  13349.             SLOTS.EXE %K
  13350.  
  13351.        Now, if a user named JIM BARRY executes this door selection, the
  13352.        actual command line sent to DOS will look like this:
  13353.  
  13354.             SLOTS Jim
  13355.  
  13356.        The SLOTS program would run, and use "Jim" as the user name.
  13357.        Similarly, a %N parameter line would have produced "SLOTS JIM
  13358.        BARRY", using the entire name, and %U would return "SLOTS
  13359.        JIM_BARRY".
  13360.  
  13361.  
  13362.        -------------------------------
  13363.        Direct Use Of Searchlight Files
  13364.        -------------------------------
  13365.  
  13366.        As a final method of obtaining information, a Door program can
  13367.        access Searchlight BBS's binary data files (files ending in .SL2).
  13368.        Since Searchlight closes all of its files before Door processing
  13369.        begins, and reopens them when processing resumes, Doors are free to
  13370.        read and/or write to these files, provided the proper data formats
  13371.        are retained. A program that reads Searchlight's data files can
  13372.        obtain everything Searchlight knows about its current state,
  13373.        including the ID of the current user, baud rates, configuration
  13374.        information, etc.
  13375.  
  13376.  
  13377.        _____________________________________________________________________
  13378.                                         210
  13379.                                   DOORS SUBSYSTEM
  13380.        _____________________________________________________________________
  13381.  
  13382.        If you want to be able to read in a message from the Searchlight data
  13383.        files, or post a message to a public conference or mailbox, you can
  13384.        use the SLMAIL program provided by us rather than code your own
  13385.        message conversion functions.  SLMAIL is discussed in Appendix F.
  13386.  
  13387.        If you wish to write programs that do more than simply read
  13388.        configuration data, we strongly recommend you obtain our developer's
  13389.        toolkit.
  13390.  
  13391.        Note: TeleGrafix is committed to assisting third party developers
  13392.              who want to write applications that interact with our BBS
  13393.              product. Much more detailed programming information, including
  13394.              a free Pascal language function library that can be used to
  13395.              create complex applications that access Searchlight message
  13396.              files and data files, is available from TeleGrafix. Check our
  13397.              BBS or contact us to obtain the latest information.
  13398.  
  13399.  
  13400.        --------------------------
  13401.        Some Door Programming Tips
  13402.        --------------------------
  13403.  
  13404.        Here are some tips for programmers writing Door programs:
  13405.  
  13406.             * Don't access the serial port. Searchlight will handle all
  13407.               modem I/O automatically when the door runs online. If you
  13408.               must access the local console independently of the remote,
  13409.               use Searchlight API functions or FOSSIL function calls
  13410.               rather than direct hardware writes.
  13411.  
  13412.             * Use command line parameters to pass information to your
  13413.               program when possible. Don't access Searchlight data files
  13414.               directly. Command line parameters are much faster and easier
  13415.               to use, and provide the advantage that your program can be
  13416.               distributed to and use by others who don't have a BBS.
  13417.  
  13418.             * If you write a utility program that uses SLBBS files
  13419.               directly, bear in mind that the data file format is subject
  13420.               to change. Your program should document which version of
  13421.               Searchlight it is to be used with, and, if possible, be
  13422.               flexible enough to work with different versions. For best
  13423.               results, use our prepared developer's library rather than
  13424.               code your own data formats and file access routines.
  13425.  
  13426.  
  13427.  
  13428.  
  13429.  
  13430.  
  13431.  
  13432.  
  13433.  
  13434.  
  13435.  
  13436.        _____________________________________________________________________
  13437.                                         211
  13438.                                   SYSOP UTILITIES
  13439.        _____________________________________________________________________
  13440.  
  13441.  
  13442.         -------------------------------------------------------------------
  13443.        | SEARCHLIGHT SYSOP UTILITIES                                       |
  13444.         -------------------------------------------------------------------
  13445.  
  13446.  
  13447.        ------------
  13448.        Introduction
  13449.        ------------
  13450.  
  13451.        Searchlight's CONFIG program contains a rich set of utility functions
  13452.        that allow you to easily maintain messages, users, conferences, and
  13453.        other aspects of your BBS. With the sysop utilities, you can rename
  13454.        users with optional updating of messages, purge your user file by
  13455.        last login date, access level and/or attributes, purge messages by
  13456.        date or search key, purge undeliverable mail, purge conference
  13457.        members and files, and effect mass validation changes.
  13458.  
  13459.        To access the sysop utilities, run CONFIG and enter option D:
  13460.  
  13461.             D. User/Conference/File Utilities
  13462.  
  13463.        You can also type CONFIG D at the DOS prompt, or place the command on
  13464.        a menu that you can access from within Searchlight BBS.
  13465.  
  13466.        Please read this documentation thoroughly before attempting to use
  13467.        any of the purge or validate utilities. Due to the nature of these
  13468.        utilities, a mistake or misunderstanding of a feature could have
  13469.        disastrous results. If you aren't sure, BACK UP your files before
  13470.        doing anything. If you are running a multiuser BBS, please see the
  13471.        note about concurrent operation at the end of this section.
  13472.  
  13473.        The Sysop utilities main menu shows the following options:
  13474.  
  13475.             A. Change User's Name
  13476.             B. Purge User File
  13477.             C. Purge Message Files
  13478.             D. Purge Member Files
  13479.             E. Mass Validate Users
  13480.             F. Purge File Areas
  13481.  
  13482.        To select a command, type a letter from A to F, or highlight the
  13483.        desired command and press Enter. Here's a breakdown of each menu
  13484.        option:
  13485.  
  13486.  
  13487.  
  13488.  
  13489.  
  13490.  
  13491.  
  13492.  
  13493.  
  13494.  
  13495.        _____________________________________________________________________
  13496.                                         212
  13497.                                   SYSOP UTILITIES
  13498.        _____________________________________________________________________
  13499.  
  13500.  
  13501.         -------------------------------------------------------------------
  13502.        | CHANGE USER'S NAME                                                |
  13503.         -------------------------------------------------------------------
  13504.  
  13505.        This option allows you to rename one or more users. Enter the name of
  13506.        the user you wish to rename, then press Enter, and type the new name
  13507.        you wish to assign to that user. Provided that the user is found and
  13508.        that the new name does not duplicate an existing name, the change
  13509.        will be made in the User file.
  13510.  
  13511.        If you wish to rename additional users, press Yes when prompted;
  13512.        otherwise enter No. If possible, it is advantageous to rename
  13513.        several users at once, rather than one at a time, since the message
  13514.        update phase of the rename operation may take some time.
  13515.  
  13516.        After you have input all of the name changes you wish to make, this
  13517.        menu will appear:
  13518.  
  13519.             A. Update All Messages
  13520.             B. Update Personal Messages Only
  13521.             C. Do Not Update Messages
  13522.  
  13523.        During this phase, the Sysop program will scan your entire message
  13524.        base, or selected portions of it, in order to change the to and from
  13525.        names on any messages posted by, or sent to, one of the users that
  13526.        has been renamed. It is recommended that you use the "Update All
  13527.        Messages" option. If you choose option B, the update scan will take
  13528.        less time, but will still ensure that mail and personal messages are
  13529.        correctly addressed, as well as high message pointers in message
  13530.        areas. Be aware that if you skip the update scan, messages left by
  13531.        users that have been renamed will bear the user's old name, and
  13532.        conference membership records will not be changed.
  13533.  
  13534.        After you choose option A or B, a conference selection screen will
  13535.        appear. We recommend pressing ESC to accept the default settings
  13536.        here and update all conferences. If desired, you can select the
  13537.        conferences to be updated; see "Purge Message Files" later in this
  13538.        documentation for information about conference selection.
  13539.  
  13540.        Note: Those who write utility programs for Searchlight should note
  13541.              that the rename procedure may move the user record in question
  13542.              to a different record number in the user file.
  13543.  
  13544.  
  13545.  
  13546.  
  13547.  
  13548.  
  13549.  
  13550.  
  13551.  
  13552.  
  13553.  
  13554.        _____________________________________________________________________
  13555.                                         213
  13556.                                   SYSOP UTILITIES
  13557.        _____________________________________________________________________
  13558.  
  13559.  
  13560.         -------------------------------------------------------------------
  13561.        | PURGE USER FILE                                                   |
  13562.         -------------------------------------------------------------------
  13563.  
  13564.        This option allows you to purge many names from your user file at
  13565.        once, based on various criteria. When option B is selected off of
  13566.        the main menu, an input screen appears. Your responses to these
  13567.        input prompts determine which users will be purged.
  13568.  
  13569.             1. Cutoff Date ......... 5-30-92
  13570.             2. Min Access Level .... 0
  13571.             3. Max Access Level .... 240
  13572.             4. Maximum Calls ....... 0
  13573.             5. Include Attributes ..
  13574.             6. Exclude Attributes ..
  13575.  
  13576.  
  13577.        ---------------
  13578.        1 - Cutoff Date
  13579.        ---------------
  13580.  
  13581.        The cutoff date determines the age of users to delete. In this
  13582.        example, any user who has not logged on since April 30th, 1992 is
  13583.        eligible for deletion.  (Whether such users are actually deleted
  13584.        depends upon the answers to the remaining prompts; a user must pass
  13585.        all eligibility requirements in order to be deleted).
  13586.  
  13587.        By default, the cutoff date is set to 6 months prior to the current
  13588.        date.  Change this field as desired.
  13589.  
  13590.  
  13591.        --------------------
  13592.        2 - Min Access Level
  13593.        3 - Max Access Level
  13594.        --------------------
  13595.  
  13596.        These fields determine the minimum and maximum access level that a
  13597.        user must have to be considered for deletion. Users that fall
  13598.        between the given access levels (inclusive of the minimum and
  13599.        maximum) are eligible to be purged.
  13600.  
  13601.  
  13602.        -----------------
  13603.        4 - Maximum Calls
  13604.        -----------------
  13605.  
  13606.        This field, if set to a nonzero value, lets you specify a maximum
  13607.        number of calls as part of your purge criteria. For example, a value
  13608.        of 2 specifies that users who have called your BBS 1 or 2 times may
  13609.        be targeted for deletion while users who have 3 or more calls are
  13610.        exempt. If this field is left as 0, number of calls is ignored.
  13611.  
  13612.  
  13613.        _____________________________________________________________________
  13614.                                         214
  13615.                                   SYSOP UTILITIES
  13616.        _____________________________________________________________________
  13617.  
  13618.  
  13619.        ----------------------
  13620.        5 - Include Attributes
  13621.        6 - Exclude Attributes
  13622.        ----------------------
  13623.  
  13624.        These two fields look at user attributes as part of the selection
  13625.        process.  You can input attribute strings here (letters from A to
  13626.        X).
  13627.  
  13628.        If Include Attributes are specified, only users who have all of the
  13629.        attributes specified here are considered for deletion.  Users who do
  13630.        not meet all of these attribute requirements are exempted from the
  13631.        purge.
  13632.  
  13633.        If Exclude Attributes are specified, users who have any of these
  13634.        attributes are exempted from the purge. In other words, a user must
  13635.        have all of the attributes listed in line 5, and none of the ones
  13636.        listed in line 6, in order to be eligible for deletion.  For
  13637.        example, if you specified "AB" as the Include Attributes and "CD" as
  13638.        the Exclude Attributes, users who have attributes "AB", "ABX" or
  13639.        "ABFG" would be eligible for deletion, while users with attributes
  13640.        "AFG", "ABD" or "ABCFGX" would not be deleted.
  13641.  
  13642.  
  13643.        -------------
  13644.        Purging Users
  13645.        -------------
  13646.  
  13647.        Once all fields are filled, press Escape. This prompt appears on
  13648.        your screen:
  13649.  
  13650.             Purge user file based on above criteria?
  13651.  
  13652.        Enter "Yes" to begin purging users, or "No" to abort the operation.
  13653.        If you proceed, the program provides a display of its progress.
  13654.  
  13655.        Note: The User Purge operation does not delete mail in the user
  13656.              mailboxes, nor does it delete the member information on
  13657.              conferences. However, the Sysop utilities provide special
  13658.              options in the Purge Message Files and Purge Member Files
  13659.              commands specifically for deleting mail and member records
  13660.              after a user purge. It is recommended that these be run after
  13661.              purging the user file to delete unnecessary mail and member
  13662.              records.
  13663.  
  13664.  
  13665.  
  13666.  
  13667.  
  13668.  
  13669.  
  13670.  
  13671.  
  13672.        _____________________________________________________________________
  13673.                                         215
  13674.                                   SYSOP UTILITIES
  13675.        _____________________________________________________________________
  13676.  
  13677.  
  13678.         -------------------------------------------------------------------
  13679.        | PURGE MESSAGE FILES                                               |
  13680.         -------------------------------------------------------------------
  13681.  
  13682.        This command option provides for the mass deletion of messages from
  13683.        one or more message areas (including the MAIL area) based on age,
  13684.        search strings, or other criteria.
  13685.  
  13686.        When option C is selected, a new menu appears with these choices:
  13687.  
  13688.             A. Date Range & Options
  13689.             B. Search Key Specification
  13690.             C. Conference Selection
  13691.             D. Begin Message Purge
  13692.  
  13693.  
  13694.        --------------------
  13695.        Date Range & Options
  13696.        --------------------
  13697.  
  13698.        Option A lets you specify the following criteria for purging
  13699.        messages:
  13700.  
  13701.             1. Start Date ............... 1-01-87
  13702.             2. End Date ................. 5-30-92
  13703.             3. Minimum Times Read ....... 0
  13704.             4. Undeliverable Mail Only .. No
  13705.             5. Attached Files Only ...... No
  13706.  
  13707.  
  13708.        --------------
  13709.        1 - Start Date
  13710.        2 - End Date
  13711.        --------------
  13712.  
  13713.        These two fields let you specify the range of dates that you wish to
  13714.        include in the message purge. The default is all dates up to 6
  13715.        months prior to the current date. Change these as necessary.
  13716.  
  13717.  
  13718.        ----------------------
  13719.        3 - Minimum Times Read
  13720.        ----------------------
  13721.  
  13722.        This field lets you select messages based on the number of times the
  13723.        message has been read. Messages which have been read less than the
  13724.        number of times indicated here are not deleted. The default value of
  13725.        0 effectively ignores the times-read counter.
  13726.  
  13727.        This option is primarily of use for deleting mail, as it can be used
  13728.        to insure that unread mail is not deleted.
  13729.  
  13730.  
  13731.        _____________________________________________________________________
  13732.                                         216
  13733.                                   SYSOP UTILITIES
  13734.        _____________________________________________________________________
  13735.  
  13736.  
  13737.        ---------------------------
  13738.        4 - Undeliverable Mail Only
  13739.        ---------------------------
  13740.  
  13741.        If this field is set to Yes, only messages which are addressed to a
  13742.        user who is not in the system's user file, and thus cannot be
  13743.        received, are deleted.  The main use for this feature is to delete
  13744.        mail addressed to users that have been deleted from the system with
  13745.        the user delete or purge commands.
  13746.  
  13747.        When this option is selected, Searchlight automatically selects the
  13748.        MAIL conference, and only that conference, as the default. You can
  13749.        change that by using the Conference Selection option. If other
  13750.        conferences are selected, Searchlight will delete public messages on
  13751.        those conferences that are addressed to nonexistent or deleted
  13752.        users, including messages addressed to "All"*so it's not recommended
  13753.        that you run this kind of purge except on the MAIL conference.
  13754.  
  13755.  
  13756.        -----------------------
  13757.        5 - Attached Files Only
  13758.        -----------------------
  13759.  
  13760.        If this option is set to Yes, Searchlight deletes only files that
  13761.        are attached to the targeted messages * not the messages themselves.
  13762.        You can use this setting to clean up your file attach directory
  13763.        without deleting the messages associated with the files.
  13764.  
  13765.  
  13766.        ------------------------
  13767.        Search Key Specification
  13768.        ------------------------
  13769.  
  13770.        This set of options lets you select messages for deletion based on a
  13771.        search string, which can match the To, From, Subject, or Fwd From
  13772.        fields in a message header.
  13773.  
  13774.             1. Search String .......
  13775.             2. Case Sensitive ...... No
  13776.             3. Search To: Field .... No
  13777.             4. Search From: Field .. No
  13778.             5. Search Subject ...... No
  13779.             6. Search Fwd From ..... No
  13780.  
  13781.        To use a search string selection, enter the text to search for (such
  13782.        as a username or a subject fragment) in line 1. If you want to do a
  13783.        case sensitive search, change the default on line 2.
  13784.  
  13785.        Fields 3 thru 6 determine where in the message header your search
  13786.        string should be found. You can select any combination of areas to
  13787.        search. At least one area must be specified if you wish to have a
  13788.        successful search. Only those messages in which the search string
  13789.        can be located in one of the indicated fields will be deleted.
  13790.        _____________________________________________________________________
  13791.                                         217
  13792.                                   SYSOP UTILITIES
  13793.        _____________________________________________________________________
  13794.  
  13795.        Note that the Search string works in conjunction with the date range
  13796.        and options in the previous menu. Only those messages which pass all
  13797.        of the tests indicated in the Date Range menu and the Search String
  13798.        menu (if a search string is used) are actually deleted from the
  13799.        system. Therefore, if you wanted to delete all messages containing a
  13800.        particular string, you should be sure to set the date range to the
  13801.        present day.
  13802.  
  13803.  
  13804.        --------------------
  13805.        Conference Selection
  13806.        --------------------
  13807.  
  13808.        This menu choice lets you select the conferences which you want to
  13809.        purge. You can purge messages from all conferences, or any
  13810.        combination of conferences.
  13811.  
  13812.        When this option is selected, a conference list appears, similar to
  13813.        the conference list used in the Conference Maintenance section of
  13814.        CONFIG. To navigate through the list, use your Up/Down arrow keys;
  13815.        PgUp and PgDn; or press the first letter of the conference to which
  13816.        you wish to travel.
  13817.  
  13818.        Conferences can be marked and unmarked by pressing the <Spacebar>
  13819.        when the cursor is to the left of the desired conference. Marked
  13820.        conferences are indicated by an asterisk (*) in the left hand
  13821.        column. If you did not select "Undeliverable Mail Only" in the Date
  13822.        Range menu, all conferences will be marked by default; otherwise,
  13823.        only the Mail conference will be marked.
  13824.  
  13825.        Select the desired conferences by marking and unmarking. You can use
  13826.        the F4 key to mark all conferences or F5 to unmark all. When you are
  13827.        done, press the ESC key to exit.
  13828.  
  13829.  
  13830.        -------------------
  13831.        Begin Message Purge
  13832.        -------------------
  13833.  
  13834.        Select this option to actually begin the purge operation. The CONFIG
  13835.        program examines the selected conferences and deletes messages
  13836.        meeting the criteria specified. A status report displays the
  13837.        program's progress.
  13838.  
  13839.        If you decide not to purge messages, press ESC at the Purge Messages
  13840.        menu instead of selecting option D.
  13841.  
  13842.  
  13843.  
  13844.  
  13845.  
  13846.  
  13847.  
  13848.  
  13849.        _____________________________________________________________________
  13850.                                         218
  13851.                                   SYSOP UTILITIES
  13852.        _____________________________________________________________________
  13853.  
  13854.  
  13855.         -------------------------------------------------------------------
  13856.        | PURGE MEMBER FILES                                                |
  13857.         -------------------------------------------------------------------
  13858.  
  13859.        This option provides for purging the member files associated with
  13860.        message areas. You can purge members who haven't accessed a
  13861.        conference since a specified date, or via a number of other
  13862.        criteria.
  13863.  
  13864.        The Purge Member menu contains these options:
  13865.  
  13866.             A. Member Purge Options
  13867.             B. Conference Selection
  13868.             C. Begin Member Purge
  13869.  
  13870.  
  13871.        --------------------
  13872.        Member Purge Options
  13873.        --------------------
  13874.  
  13875.        This input screen lets you select the criteria on which to purge
  13876.        member records. The fields are:
  13877.  
  13878.             1. Cutoff Date ............. 5-30-92
  13879.             2. Invalid Usernames Only .. No
  13880.             3. Inactive Members Only ... No
  13881.             4. No Personal Msgs Only ... No
  13882.  
  13883.        Cutoff Date specifies the last access date to purge members. Those
  13884.        members who have not accessed the conference (JUMPed to it or read
  13885.        messages as part of the NEW command) are eligible to be deleted.
  13886.  
  13887.        Invalid Usernames Only specifies that only members which are not
  13888.        valid names in the USER file are deleted. You would select this
  13889.        option primarily as a clean-up operation to delete member records
  13890.        after purging the user file.
  13891.  
  13892.        Inactive Members Only means that only members who are not active in
  13893.        the conference are deleted. "Not active" means that the member's
  13894.        highest message read is lower than the lowest numbered message in
  13895.        the conference.
  13896.  
  13897.        No Personal Msgs Only specifies that  the purge involves only users
  13898.        who have no personal messages on the given conference. This is
  13899.        primarily of use in conjunction with the MAIL conference, where it
  13900.        can be used to delete members who have no mail, and may be a useful
  13901.        option on other conferences as well.
  13902.  
  13903.        Note that as with other purges in the Sysop utilities, member records
  13904.        must meet all of the selected criteria in options 1 through 4 in
  13905.        order to be deleted.
  13906.  
  13907.  
  13908.        _____________________________________________________________________
  13909.                                         219
  13910.                                   SYSOP UTILITIES
  13911.        _____________________________________________________________________
  13912.  
  13913.  
  13914.        --------------------
  13915.        Conference Selection
  13916.        --------------------
  13917.  
  13918.        This choice lets you specify the conferences to be included in the
  13919.        member purge. Select conferences by marking with the <Spacebar>, F4
  13920.        and F5 keys.  See the "Purge Message Files" command above for more
  13921.        information about conference selection.
  13922.  
  13923.  
  13924.        ------------------
  13925.        Begin Member Purge
  13926.        ------------------
  13927.  
  13928.        Select this option to actually begin the purge procedure. (Press ESC
  13929.        if you wish to abort instead). A progress display is generated.
  13930.  
  13931.  
  13932.         -------------------------------------------------------------------
  13933.        | MASS VALIDATE USERS                                               |
  13934.         -------------------------------------------------------------------
  13935.  
  13936.        This command allows for making access level adjustments on many users
  13937.        at the same time. Users can be selected for validation by access
  13938.        level and attributes and can be affected by a variety of changes to
  13939.        access levels, attributes, time limits, and file transfer ratios.
  13940.  
  13941.        The term "Validate" is used loosely here to indicate changes to a
  13942.        user's security levels. Mass validation can involve changes in
  13943.        either direction to users' security levels.  Option E calls forth
  13944.        the following submenu:
  13945.  
  13946.             A. Specify Target Users
  13947.             B. Specify Adjustments
  13948.             C. Begin Mass Validation
  13949.  
  13950.        Suboption A specifies which users are to be validated; option B
  13951.        specifies the changes to be made to their accounts. Use option C to
  13952.        begin the process (or press ESC at this menu to abort it).
  13953.  
  13954.  
  13955.        --------------------
  13956.        Specify Target Users
  13957.        --------------------
  13958.  
  13959.        The following input items appear after selection of this option:
  13960.  
  13961.             1. Min Msg Access Level .... 0
  13962.             2. Max Msg Access Level .... 240
  13963.             3. Min Files Access Level .. 0
  13964.             4. Max Files Access Level .. 240
  13965.             5. Include Attributes ......
  13966.             6. Exclude Attributes ......
  13967.        _____________________________________________________________________
  13968.                                         220
  13969.                                   SYSOP UTILITIES
  13970.        _____________________________________________________________________
  13971.  
  13972.        Lines 1 through 4 determine by access level which users will be
  13973.        included in the validation. Users who have message access levels and
  13974.        file access levels within the specified ranges are included.
  13975.  
  13976.        Lines 5 and 6 specify by attributes which users are included in the
  13977.        validation. In order to be included, a user must have all of the
  13978.        attributes listed in line 5, and none of those listed in line 6.
  13979.        When both lines are blank, as in the default condition, no users are
  13980.        excluded based on attributes.
  13981.  
  13982.        For more information on the Include/Exclude Attribute fields, please
  13983.        see the example in "Purge User File" earlier in this section.
  13984.  
  13985.        As in other areas of the Sysop utilities, users must meet all of the
  13986.        requirements specified in lines 1 through 6 to be included in the
  13987.        validation operation.
  13988.  
  13989.  
  13990.        -------------------
  13991.        Specify Adjustments
  13992.        -------------------
  13993.  
  13994.        In this input screen, you specify what changes you want to make to
  13995.        the user records selected. The input lines are:
  13996.  
  13997.              1. Msg Level Adjustment ....... No Change
  13998.              2. Value ...................... 0
  13999.              3. Files Level Adjustment ..... No Change
  14000.              4. Value ...................... 0
  14001.              5. Ratio Adjustment ........... No Change
  14002.              6. Value ...................... 0
  14003.              7. Daily Time Limit ........... No Change
  14004.              8. Value ...................... 0
  14005.              9. Session Time Limit ......... No Change
  14006.             10. Value ...................... 0
  14007.             11. Account Expiration (Days) .. No Change
  14008.             12. Value ...................... 0
  14009.             13. Credits .................... No Change
  14010.             14. Value ...................... 0
  14011.             15. Add Attributes .............
  14012.             16. Remove Attributes ..........
  14013.  
  14014.        Msg Level Adjustment and Value specify what adjustment is to be made
  14015.        to each user's Message Access Level. The options for line 1 are "No
  14016.        Change", "Change To", "Increment" or "Decrement" (press Spacebar to
  14017.        toggle between the choices). Line 2 can contain a value between 0
  14018.        and 255.
  14019.  
  14020.        If "No Change" is selected, no change is made to the message access
  14021.        level. If you select "Change To", user message access levels are
  14022.        changed to the value in line 2, regardless of their previous value.
  14023.        If "Increment" or "Decrement" are selected, then the message access
  14024.  
  14025.  
  14026.        _____________________________________________________________________
  14027.                                         221
  14028.                                   SYSOP UTILITIES
  14029.        _____________________________________________________________________
  14030.  
  14031.        level is incremented or decremented by the value specified in line
  14032.        2. If the result is less than 0 or greater than 255, it is rounded
  14033.        off to 0 or 255, respectively.
  14034.  
  14035.        Lines 3 through 14 are used to effect changes to the files access
  14036.        level, upload ratio, time limits, expiration dates, and credits. As
  14037.        with lines 1 and 2, these fields work in pairs, with and action and
  14038.        a value. Time limit fields allows a maximum value of 14400. The
  14039.        Session Time Limit action (line 9) supports a value of "DailyLimit",
  14040.        which sets the session time limit equal to the user's daily time
  14041.        limit.
  14042.  
  14043.        Fields 15 and 16 add or remove security attributes from the selected
  14044.        user accounts. Enter those attributes you wish to add into line 15,
  14045.        and those you wish to remove, in line 16.
  14046.  
  14047.  
  14048.        ---------------------
  14049.        Begin Mass Validation
  14050.        ---------------------
  14051.  
  14052.        Select this menu choice to begin the mass validation. A status
  14053.        display is generated as the validation operation proceeds.
  14054.  
  14055.  
  14056.         -------------------------------------------------------------------
  14057.        | PURGE FILE AREAS                                                  |
  14058.         -------------------------------------------------------------------
  14059.  
  14060.        The Purge File Areas option allows you to automatically delete files
  14061.        from your download libraries based on age, number of downloads, and
  14062.        other criteria. Use this option when your hard disk becomes nearly
  14063.        full, or anytime you want to clean out old files from your BBS.
  14064.  
  14065.        The file area purge works like the other purges, and presents this
  14066.        menu:
  14067.  
  14068.             A. Date Range & Options
  14069.             B. Directory Selection
  14070.             C. Begin File Purge
  14071.  
  14072.  
  14073.  
  14074.  
  14075.  
  14076.  
  14077.  
  14078.  
  14079.  
  14080.  
  14081.  
  14082.  
  14083.  
  14084.  
  14085.        _____________________________________________________________________
  14086.                                         222
  14087.                                   SYSOP UTILITIES
  14088.        _____________________________________________________________________
  14089.  
  14090.  
  14091.        --------------------
  14092.        Date Range & Options
  14093.        --------------------
  14094.  
  14095.        Use this screen to select the desired file purge options:
  14096.  
  14097.             1. Start Date ................. 1-01-87
  14098.             2. End Date ................... 5-30-92
  14099.             3. Minimum Size (K) ........... 0
  14100.             4. Maximum Size (K) ........... 9999
  14101.             5. Maximum Times Downloaded ... 9999
  14102.             6. Confirm Each Deletion? ..... Yes
  14103.             7. Erase Files from Disk? ..... No
  14104.             8. Remove Upload Credits? ..... No
  14105.  
  14106.        Start Date and End Date specify a date range for deletion. Files with
  14107.        an upload date between these two dates will be eligible for
  14108.        deletion. Note that Searchlight looks at the date the file was
  14109.        uploaded (date in the directory listing), rather than the file's DOS
  14110.        date, as the basis for this selection.
  14111.  
  14112.        Minimum Size and Maximum Size specify a size range in kilobytes
  14113.        (1KB=1024 bytes). Only files which fall within the range will be
  14114.        deleted.
  14115.  
  14116.        Maximum Times Downloaded allows you to prevent deletion of files
  14117.        which have been downloaded more than a particular number of times.
  14118.        For example, if you enter 50 in this field, then files which have
  14119.        been downloaded more than 50 times are prevented from being purged.
  14120.        Only files with 50 or fewer downloads will be deleted.
  14121.  
  14122.        Confirm Each Deletion lets you decide whether you would like
  14123.        Searchlight to automatically delete files based on your
  14124.        specifications, or prompt you with a Yes/No prompt for each file. If
  14125.        you select "Yes" in line 6, you will be prompted; "No" initiates an
  14126.        automatic purge.
  14127.  
  14128.        Erase Files From Disk lets you decide whether Searchlight will erase
  14129.        entire files, or just remove the directory entries.  Select "Yes" if
  14130.        you want to delete the files from disk and free up disk space.
  14131.  
  14132.        Remove Upload Credits selects the action Searchlight will take with
  14133.        upload credits. If Yes is entered, Searchlight removes upload
  14134.        credits from the uploader of each file it deletes. In other words,
  14135.        if a 50KB file is deleted, Searchlight deducts 50 from the upload
  14136.        count of the user who uploaded that file. Select No if you do not
  14137.        want to deduct upload credits.
  14138.  
  14139.  
  14140.  
  14141.  
  14142.  
  14143.  
  14144.        _____________________________________________________________________
  14145.                                         223
  14146.                                   SYSOP UTILITIES
  14147.        _____________________________________________________________________
  14148.  
  14149.  
  14150.        -------------------
  14151.        Directory Selection
  14152.        -------------------
  14153.  
  14154.        This option lets you select the directories on which File Purge will
  14155.        operate.  Only those file areas you mark will be affected by the
  14156.        purge. Press F4 and F5 to mark and unmark all directories, or
  14157.        Spacebar to mark or unmark individual directories.
  14158.  
  14159.  
  14160.        ----------------
  14161.        Begin File Purge
  14162.        ----------------
  14163.  
  14164.        Searchlight shows you a running count of the number of files deleted
  14165.        and the amount of disk space freed up as it deletes files.
  14166.  
  14167.  
  14168.         -------------------------------------------------------------------
  14169.        | BALANCE USER FILE                                                 |
  14170.         -------------------------------------------------------------------
  14171.  
  14172.        This selection invokes the User File Balance procedure, which is used
  14173.        to repair damaged user files. This option also optimizes the index
  14174.        used to search the user file. Use Balance User File periodically to
  14175.        ensure that your user file is optimally sorted, or to repair a file
  14176.        that you suspect has been damaged. Searchlight must not be running
  14177.        when you use this function.
  14178.  
  14179.  
  14180.         -------------------------------------------------------------------
  14181.        | SYSOP UTILITY NOTES                                               |
  14182.         -------------------------------------------------------------------
  14183.  
  14184.  
  14185.        -------
  14186.        Backups
  14187.        -------
  14188.  
  14189.        We strongly recommend performing purge and mass validation operations
  14190.        only when a recent backup of the data files being modified is
  14191.        available. Due to the far-reaching nature of these operations, a
  14192.        small mistake in specifying the target parameters can lead to the
  14193.        loss of many users or messages. A backup is by far the best way to
  14194.        avoid disaster.
  14195.  
  14196.  
  14197.  
  14198.  
  14199.  
  14200.  
  14201.  
  14202.  
  14203.        _____________________________________________________________________
  14204.                                         224
  14205.                                   SYSOP UTILITIES
  14206.        _____________________________________________________________________
  14207.  
  14208.  
  14209.        -------------------
  14210.        Multiuser Operation
  14211.        -------------------
  14212.  
  14213.        If you run a multiuser BBS, it is recommended that you do not run
  14214.        lengthy purge or validation operations while other nodes are active.
  14215.        Since these operations keep the data files locked for long periods
  14216.        of time, and put a large load on the file system, they may cause
  14217.        unacceptably slow operation on other nodes. Therefore, we recommend
  14218.        you shut other nodes down while running these operations.
  14219.  
  14220.  
  14221.  
  14222.  
  14223.  
  14224.  
  14225.  
  14226.  
  14227.  
  14228.  
  14229.  
  14230.  
  14231.  
  14232.  
  14233.  
  14234.  
  14235.  
  14236.  
  14237.  
  14238.  
  14239.  
  14240.  
  14241.  
  14242.  
  14243.  
  14244.  
  14245.  
  14246.  
  14247.  
  14248.  
  14249.  
  14250.  
  14251.  
  14252.  
  14253.  
  14254.  
  14255.  
  14256.  
  14257.  
  14258.  
  14259.  
  14260.  
  14261.  
  14262.        _____________________________________________________________________
  14263.                                         225
  14264.                                     ALIAS NAMES
  14265.        _____________________________________________________________________
  14266.  
  14267.  
  14268.         -------------------------------------------------------------------
  14269.        | ALIAS NAMES                                                       |
  14270.         -------------------------------------------------------------------
  14271.  
  14272.  
  14273.        ------------
  14274.        Introduction
  14275.        ------------
  14276.  
  14277.        Searchlight BBS supports alias names. Simply put, an alias is an
  14278.        alternate name for the same user account. Alias names are generally
  14279.        used to hide a caller's true identity when posting a message_when
  14280.        you permit it, users can choose to post messages with either their
  14281.        real name or their alias name. For example, you may wish to allow
  14282.        alias names in an adult oriented message area, or other area where
  14283.        real names might not be appropriate. Searchlight also allows alias
  14284.        names to substitute for real names at most places where entry of a
  14285.        username is required (such as when sending mail).
  14286.  
  14287.        Unlike anonymous messages, alias names permit callers to distinguish
  14288.        between messages left by different callers, and even permit private
  14289.        replies to messages, without revealing the true identity of the
  14290.        original writer. Of course, as the Sysop, you have the ability to
  14291.        look up the real name of an alias author (or find the alias of a
  14292.        real name) at any time.
  14293.  
  14294.  
  14295.        ----------------
  14296.        Alias Name Setup
  14297.        ----------------
  14298.  
  14299.        Searchlight's CONFIG program contains three options relating to alias
  14300.        name support, and there are several ways in which a user may obtain
  14301.        an alias name. Under "General Setup Menu #1", you'll find an option
  14302.        which reads "Prompt for Alias Names?". If set to Yes, Searchlight
  14303.        will prompt for an alias name from new callers during the new user
  14304.        registration process. The default setting is No. If Yes is selected,
  14305.        an alias is asked for along with a real name, password, location,
  14306.        etc.  during the new user registration. Blank alias names are
  14307.        acceptable, but alias names that match an existing real name or
  14308.        alias name are not.
  14309.  
  14310.        Under "Function Attrib Setup", there are two options called "Add
  14311.        Alias Name" and "Change Alias Name". The first, Add Alias Name,
  14312.        describes the security attributes needed for a user to assign
  14313.        herself or himself an alias. Here's how it works:  if a user meets
  14314.        the attribute requirements listed here, and they do not already have
  14315.        an alias name, they can create an alias for themselves by entering
  14316.        one on the Options/Info screen.
  14317.  
  14318.  
  14319.  
  14320.  
  14321.        _____________________________________________________________________
  14322.                                         226
  14323.                                     ALIAS NAMES
  14324.        _____________________________________________________________________
  14325.  
  14326.        The "Change Alias" setting determines whether a user with an existing
  14327.        alias can change that alias later on, again using the Options/Info
  14328.        screen. If you would like your users to be able to change their
  14329.        alias name at any time, enter an appropriate list of security
  14330.        attributes here.
  14331.  
  14332.        If you wish to allow existing users without alias names to be able to
  14333.        enter an alias, but don't want them to be able to change it in the
  14334.        future, the best way to do this is to set "Add Alias Name" to blank,
  14335.        and "Change Alias Name" to ALL or a similar high access level. This
  14336.        allows your current users to add alias names without giving them the
  14337.        opportunity to change their name in the future. Searchlight warns
  14338.        the user that this is the case, and provides an "Are You Sure?"
  14339.        prompt before accepting their alias name.
  14340.  
  14341.        Note that users can always view their alias name with the
  14342.        Options/Info command, but may not be able to change their name. A
  14343.        "read-only" designation appears next to the alias name if changing
  14344.        is not allowed.
  14345.  
  14346.        Finally, as the Sysop, you can inspect, assign or change the alias
  14347.        name for any account, by using the 2- Sysop/Options/Info command
  14348.        sequence. The alias name appears in the list of options.
  14349.  
  14350.        "Alias Names" are very similar to real names in Searchlight: they are
  14351.        strings from one to 25 characters in length, consisting of all
  14352.        uppercase letters; high ascii characters are permitted if the Allow
  14353.        High Ascii switch is set in your CONFIG file.
  14354.  
  14355.        Alias names must be unique. No two users can have the same alias
  14356.        name, nor can an alias name be the same as a real user name.
  14357.        Searchlight enforces this rule by disallowing alias names that are
  14358.        the same as another alias name or a real name, and by disallowing
  14359.        real names that are the same as an existing alias name. Since all
  14360.        names are unique, Searchlight can easily substitute alias names for
  14361.        real names without ambiguity.
  14362.  
  14363.        If you do not wish to use alias names on your BBS at all, simply
  14364.        leave the settings for "Prompt for Alias Names", "Add Alias Name"
  14365.        and "Change Alias Name" at their defaults ("No" and All attributes,
  14366.        respectively).
  14367.  
  14368.  
  14369.        ------------------
  14370.        Alias Name Lookups
  14371.        ------------------
  14372.  
  14373.        Once an alias name is created for a particular account, it
  14374.        immediately becomes available as an alternate means of accessing
  14375.        that account. For example, if a user named JOE WILLIAMS chooses an
  14376.        alias name of SANTA CLAUS, then the name SANTA CLAUS can be used as
  14377.        a replacement for JOE WILLIAMS in commands such as Mail/Send, 2-
  14378.        Sysop/Options or 2-Sysop/Validate.
  14379.  
  14380.        _____________________________________________________________________
  14381.                                         227
  14382.                                     ALIAS NAMES
  14383.        _____________________________________________________________________
  14384.  
  14385.        In fact, an ordinary user who enters the name SANTA CLAUS as a
  14386.        destination for mail has no way of knowing whether SANTA CLAUS is a
  14387.        "real" user name or an alias name. Searchlight treats the alias name
  14388.        the same way as it would treat a real name. However, mail sent to
  14389.        SANTA CLAUS actually winds up in JOE WILLIAMS' mailbox.
  14390.  
  14391.        As the Sysop, you can type alias names like SANTA CLAUS when looking
  14392.        up user information via commands like 2- Sysop/Options. Although
  14393.        Searchlight treats the name like a real user name, you will of
  14394.        course see information for the "real" account of JOE WILLIAMS; thus,
  14395.        the "true identity" of SANTA CLAUS is revealed to you.
  14396.  
  14397.  
  14398.        -----------------
  14399.        Alias Name Logins
  14400.        -----------------
  14401.  
  14402.        By default, Searchlight does not allow users to log in with an alias
  14403.        name.  You can change this by setting a switch in the Config
  14404.        program:
  14405.  
  14406.             5. Allow Alias Name Logins .. Yes
  14407.  
  14408.        When enabled, users can log in to your system by giving either their
  14409.        real name and password at the login prompt, or their alias name and
  14410.        password.
  14411.  
  14412.        The commands Who, User/CallLog, and the Chat functions, as well as
  14413.        the "Last caller was..." display, show whichever name was actually
  14414.        used to log in. In other words, if a user logs in with an alias
  14415.        name, the alias name is displayed in the Who command, etc. If the
  14416.        same user logs in with a real name, then the real name is displayed.
  14417.        The local status line always displays the caller's real name.
  14418.  
  14419.        When the User/CallLog command displays an alias name, the caller's
  14420.        location is listed as "Somewhere" rather than their actual location.
  14421.        This prevents users from matching real names to alias names via the
  14422.        location. (If you wish to change the string "Somewhere", it's
  14423.        located in the default.lng file as string number 1240).
  14424.  
  14425.        Files uploaded during an alias session (a session which began by
  14426.        entering an alias name at the Login prompt) will show the alias name
  14427.        of the file uploader when the Owner command is used. However, you
  14428.        can override this behavior, and have the Owner command always
  14429.        display real names, by adding a /R switch to the Owner command on
  14430.        your menus:
  14431.  
  14432.             5. Command Number (1) ...... 322
  14433.             6. Command Parameters (1) .. /x /r
  14434.  
  14435.  
  14436.  
  14437.  
  14438.  
  14439.        _____________________________________________________________________
  14440.                                         228
  14441.                                     ALIAS NAMES
  14442.        _____________________________________________________________________
  14443.  
  14444.  
  14445.        ------------------------------
  14446.        Sending Messages with an Alias
  14447.        ------------------------------
  14448.  
  14449.        Notice that having an alias name associated with your user account
  14450.        does not automatically permit to you to "hide" behind your alias
  14451.        when entering a message. By default, any message you enter contains
  14452.        your real name as the "From:" address on the message, even if you
  14453.        are replying to a message which was sent to your alias name.
  14454.  
  14455.        Obviously, the most important aspect of alias support is the ability
  14456.        to substitute your alias name as the "From:" name on messages you
  14457.        send. Before you can do this, two things are required: you must have
  14458.        an alias name associated with your account (as per the above
  14459.        discussion), and the message area you're in must be configured to
  14460.        allow alias names.
  14461.  
  14462.        As the Sysop, you can control how alias names may be used in each
  14463.        message area of your system (including the MAIL area). To do this,
  14464.        access "Conference Maintenance" from the CONFIG program, choose a
  14465.        conference, and press Enter to edit its attributes. Examine line 9:
  14466.  
  14467.             9. Alias Name Support .. Real Only
  14468.  
  14469.        The default for all conferences when you first install Searchlight is
  14470.        "Real Only". In this mode, only real names are permitted. Any
  14471.        message entered into the area will have the author's real name in
  14472.        the "From:" address, regardless of whether that person has an alias
  14473.        name or not.
  14474.  
  14475.        In order to support alias names, you must change this setting to one
  14476.        of the other three options: Alias Only, User Choice, or Replies
  14477.        Only. "Alias Only" is, in many respects, the direct opposite of
  14478.        "Real Only". In this mode, all messages posted on a conference
  14479.        contain the poster's alias name in the "From:" field. The process is
  14480.        automatic and does not require a choice by the user. The only
  14481.        exception is for users who do not have alias names associated with
  14482.        their account; their real names are used instead.
  14483.  
  14484.        "User Choice" is the most flexible option. In this mode, users who
  14485.        have alias names are prompted each time they enter a new message
  14486.        with the question:
  14487.  
  14488.             Do you wish to use your Alias name for this message? Y/N
  14489.  
  14490.        The user can choose whether the "From:" field contains their real
  14491.        name or their alias name by responding to this prompt appropriately.
  14492.  
  14493.        "Replies Only" allows users to choose whether to use their alias or
  14494.        real name, as in the User Choice option, but only when replying to a
  14495.        message that was addressed to their alias name. That is, if JOE
  14496.        WILLIAMS were to reply to a message that was addressed to his alias
  14497.  
  14498.        _____________________________________________________________________
  14499.                                         229
  14500.                                     ALIAS NAMES
  14501.        _____________________________________________________________________
  14502.  
  14503.        name, SANTA CLAUS, he would have the option to use his alias or real
  14504.        name.  But he wouldn't have that option if posting a message
  14505.        directly, or replying to any other message.
  14506.  
  14507.        The "Replies Only" option is most useful with the MAIL conference. It
  14508.        allows users to respond to private messages sent to their alias
  14509.        address without revealing their true identity; but it prevents users
  14510.        from originating new messages from their alias name.
  14511.  
  14512.        In multiuser systems, Searchlight normally sends a chat message to
  14513.        you if you're online when someone sends you mail; i.e.
  14514.  
  14515.             Message from ZANNE MARIE GRAY on line 1
  14516.              * Received new mail from ZANNE MARIE GRAY
  14517.  
  14518.        When alias names are involved, Searchlight sends this message only if
  14519.        the "From:" name in the message matches the name with which the
  14520.        sender logged in. That is, if someone who logged in via a real name
  14521.        sent mail under an alias, the chat message would not appear.
  14522.  
  14523.  
  14524.        --------------------------
  14525.        Replying to Alias Messages
  14526.        --------------------------
  14527.  
  14528.        A message posted with an alias address may be replied to as easily as
  14529.        a message posted with a real name. As mentioned, Searchlight
  14530.        protects the "real" identity of the message poster, and in fact
  14531.        provides no indication as to whether a name is a "real" name or an
  14532.        alias.
  14533.  
  14534.        Most importantly, though, Searchlight's personal message pointers
  14535.        are internally maintained on the "real" account when a reply is
  14536.        posted. That is, if a private reply is made to a public message, the
  14537.        reply is stored in the mailbox of the "real" account. For example,
  14538.        JOE WILLIAMS might receive messages in his mailbox addressed to
  14539.        either his real name, JOE WILLIAMS, or his SANTA CLAUS alias. Users
  14540.        who send mail to JOE WILLIAMS and/or SANTA CLAUS do not know that
  14541.        the mail is going to the same place. Similarly, if Joe does a
  14542.        personal message scan on a conference that allows alias names, he
  14543.        will see both messages addressed to his real and alias names.
  14544.  
  14545.        Because alias names are internally translated into "real" names for
  14546.        the purposes of maintaining high message pointers and personal mail
  14547.        lists, alias names will never appear in the member listing of a
  14548.        conference. Only the user's real name appears in the member listing.
  14549.  
  14550.  
  14551.  
  14552.  
  14553.  
  14554.  
  14555.  
  14556.  
  14557.        _____________________________________________________________________
  14558.                                         230
  14559.                                     ALIAS NAMES
  14560.        _____________________________________________________________________
  14561.  
  14562.  
  14563.        ----------------------
  14564.        Replying with an Alias
  14565.        ----------------------
  14566.  
  14567.        When you reply to an existing message, Searchlight either forces you
  14568.        to use your real name, forces you to use your alias, or offers you a
  14569.        choice, depending on the "Alias Name Support" setting for the
  14570.        current conference (or for the MAIL conference, when replying to
  14571.        mail). In this respect, replying to a message is very similar to
  14572.        entering a message.
  14573.  
  14574.        However, Searchlight takes some precautions when you reply. If the
  14575.        alias support setting for the message area is "User Choice" or
  14576.        "Replies Only", Searchlight will display a message such as:
  14577.  
  14578.             The message you are reading is addressed to your Alias name.
  14579.             Do you wish to use your Alias for the reply? Y/N
  14580.  
  14581.        Similarly, if the original message is addressed to your real name,
  14582.        you are informed of this. Since most people will want to reply with
  14583.        the same names the original message was addressed, this prompt
  14584.        guards against accidentally replying to an alias-name message with
  14585.        your real name or vice versa.
  14586.  
  14587.        If a message you are reading is addressed to your alias name, but the
  14588.        message area only allows real names, you'll see this warning when
  14589.        you try to reply to that message:
  14590.  
  14591.             The message you are reading is addressed to your Alias name.
  14592.             However, your reply may only be addressed from your Real name.
  14593.             Do you wish to continue with the reply? Y/N
  14594.  
  14595.        Since replying to the message would force you to use your real
  14596.        name_thus sacrificing your anonymity_Searchlight warns you before
  14597.        proceeding. You can choose to continue by answering Yes, or abort
  14598.        the reply with No. A similar warning is displayed if you reply to a
  14599.        message addressed to your real name in an area that only allows
  14600.        alias names.
  14601.  
  14602.  
  14603.        --------------------
  14604.        Changing Alias Names
  14605.        --------------------
  14606.  
  14607.        Each user may only have one active alias name at any given time.
  14608.        However, that name can be changed. If the "Alias Change" attribute
  14609.        setting allows it, users can change their alias names using the
  14610.        Options/Info command. Their existing alias appears in the options
  14611.        list and can be edited, replaced or removed completely by entering a
  14612.        blank. Note that if the Alias Change attributes are insufficient to
  14613.        allow changes, users can still view their alias name via the
  14614.        Options/Info command, although Searchlight will disallow any
  14615.        attempted changes.
  14616.        _____________________________________________________________________
  14617.                                         231
  14618.                                     ALIAS NAMES
  14619.        _____________________________________________________________________
  14620.  
  14621.        Regardless of the Alias Change setting, Sysops may change or remove
  14622.        alias names for any user by using the 2- Sysop/Options/Info command
  14623.        sequence. Note that either the user's real name or alias name is
  14624.        acceptable to enter when you are prompted for the username. Sysops
  14625.        can also use Other/Options when reading messages to view or alter
  14626.        the alias name of the person who wrote the message being read.
  14627.  
  14628.        Alias names can be changed at any time. However, changing an alias
  14629.        name has no effect on messages previously posted with the old alias
  14630.        name, except to render private replies or name lookups on those
  14631.        messages impossible (since the alias name no longer exists, it
  14632.        cannot be cross-referenced with a real name). Also, should a user
  14633.        reply to messages addressed to his or her old alias name, the
  14634.        replies may only contain their new alias or their real name.
  14635.  
  14636.        You should also be aware that if someone's alias name changes,
  14637.        private mail that is addressed to their old alias name will be lost
  14638.        if you execute a message purge from the Config program that
  14639.        specifies "Undeliverable Mail Only", or if you need to run the
  14640.        Header File Repair function on your Mail conference (these functions
  14641.        won't damage mail addressed to alias names that are current).
  14642.  
  14643.  
  14644.        ---------------------------
  14645.        Alias Names and Conferences
  14646.        ---------------------------
  14647.  
  14648.        The most common use for alias names is in public message areas. Many
  14649.        sysops wish to allow alias names in conferences with sensitive
  14650.        topics, such as adult-oriented conferences. In the typical scenario,
  14651.        the Sysop will set the Alias Support option in these conferences to
  14652.        "User Choice" or "Alias Only", thus allowing (or requiring) users to
  14653.        post messages with their alias name as the "From:" address.
  14654.  
  14655.        Once such a message is posted, the ordinary caller has no way of
  14656.        determining the "real" name of the person who posted the message.
  14657.        Note, however, that while Searchlight displays no overt indication
  14658.        that the From: name in a message is an alias name, there are some
  14659.        differences between alias names and real names. Particularly, the
  14660.        "User/Search" feature does not display alias names [See Note Below].
  14661.        Therefore, it is possible to determine whether a particular name is
  14662.        an alias or a real name, although it is not possible to actually
  14663.        find the corresponding real name for an alias (except for Sysops,
  14664.        who can use the 2-Sysop/Options/Info or Other/Options sequences to do
  14665.        so).
  14666.  
  14667.        Reading and replying to messages from alias names may be done freely
  14668.        within a public message area without regard to whether the author
  14669.        name is a real name or an alias.
  14670.  
  14671.  
  14672.  
  14673.  
  14674.  
  14675.        _____________________________________________________________________
  14676.                                         232
  14677.                                     ALIAS NAMES
  14678.        _____________________________________________________________________
  14679.  
  14680.  
  14681.        --------------------
  14682.        Alias Names and Mail
  14683.        --------------------
  14684.  
  14685.        Searchlight's MAIL commands fully support alias names, and fully
  14686.        protect the real identity of the user. You can send mail to an alias
  14687.        name via the Mail/Send command, or by replying privately to a public
  14688.        message posted with an alias. The reply appears in the mailbox of
  14689.        the "real" user. Users who have alias names can carry on extended
  14690.        private message exchanges using their alias, without fear that their
  14691.        real names will be revealed.
  14692.  
  14693.        Because it is possible to receive messages in your mailbox that may
  14694.        be addressed to either your real name or your alias, Searchlight
  14695.        always displays the "To:" address on mail messages. This allows you
  14696.        to quickly determine whether the message you are reading was sent to
  14697.        your real name or your alias. (In previous releases, Searchlight did
  14698.        not list the "To:" address when reading private mail).
  14699.  
  14700.        Searchlight's Mail/Inquire command and carbon copy feature treat
  14701.        alias names just like real names. You can use the Inquire feature to
  14702.        review messages that you have sent to an alias name just like you
  14703.        can with a real name. You can also carbon copy messages to alias
  14704.        names. Note that it is possible to carbon-copy the same message to a
  14705.        user's real name and their alias name, which results in the message
  14706.        appearing in that user's mailbox twice (Searchlight intentionally
  14707.        allows the duplicate message, since disallowing it would serve to
  14708.        indicate the linkage between a particular set of names).
  14709.  
  14710.        If a user has a netmail address associated with their account, then
  14711.        sending a message to their alias results in a netmail message to
  14712.        their net address.
  14713.  
  14714.  
  14715.        ---------------------
  14716.        Alias Names and Doors
  14717.        ---------------------
  14718.  
  14719.        Searchlight supports the use of alias names in door dropfiles (such
  14720.        as DOOR.SYS) and in command metacharacters. Four metacharacters are
  14721.        available in Searchlight in support of alias names. They are:
  14722.  
  14723.            Command Description
  14724.            ===========================================================
  14725.               %I   User's alias name
  14726.               %J   User's alias name with spaces replaced by underbars
  14727.               %X   User's login name
  14728.               %Y   User's login name with spaces replaced by underbars
  14729.  
  14730.        By "User's login name" we mean whichever name the caller used to log
  14731.        in during that session. The login name is always equal to either the
  14732.        real name or the alias name. If your system doesn't allow alias
  14733.        names as login names, then %X and %Y always return a real name.
  14734.        _____________________________________________________________________
  14735.                                         233
  14736.                                     ALIAS NAMES
  14737.        _____________________________________________________________________
  14738.  
  14739.        The %I and %J sequences always return an alias name, except when no
  14740.        alias name exists, in which case they return the user's real name.
  14741.  
  14742.        For more information about metacharacters, refer to the section
  14743.        "Doors Subsystem - Searchlight BBS Door Subsystem."
  14744.  
  14745.        Door "drop" files can also be configured to contain either the user's
  14746.        real name, alias name, or whichever name was used to log in.
  14747.        Changing the drop file is accomplished with an additional setting
  14748.        that appears on each door type menu choice:
  14749.  
  14750.             12. Pass Username As .. Real Name
  14751.  
  14752.        By default, the user's real name is passed. You can change this
  14753.        setting to "Alias Name" if you want to always pass the user's alias
  14754.        name to a particular door; or "Login Name" if you want to pass
  14755.        whichever name was used to log on for that session. Each door can be
  14756.        individually configured as desired for that door.
  14757.  
  14758.  
  14759.        -----------
  14760.        Maintenance
  14761.        -----------
  14762.  
  14763.        Searchlight creates a data file, ALIAS.SL2, to store alias names and
  14764.        the cross-referencing information that enables it to substitute
  14765.        alias names for real names during name lookups. Be sure that your
  14766.        backup procedures include the ALIAS.SL2 file when backing up your
  14767.        Searchlight data files (it is located in your Data Files Path along
  14768.        with your USER.SL2 and other data files).
  14769.  
  14770.        You should keep your ALIAS.SL2 file in sync with your USER.SL2 file.
  14771.        That is, should you ever need to restore a USER.SL2 file from a
  14772.        backup, be sure to restore the ALIAS.SL2 file that was saved in the
  14773.        same backup, and vice-versa.  Failure to do this will not cause an
  14774.        error, but may result in an inability to use alias names in name
  14775.        lookups and private mail functions.
  14776.  
  14777.        Should your alias file become corrupted, the User/Balance command
  14778.        will attempt to repair and optimize the ALIAS.SL2 file after it
  14779.        fixes the USER.SL2 file. Use this command if you suspect a problem
  14780.        with your alias file (such as if you cannot look up an alias name
  14781.        properly).
  14782.  
  14783.  
  14784.  
  14785.  
  14786.  
  14787.  
  14788.  
  14789.  
  14790.  
  14791.  
  14792.  
  14793.        _____________________________________________________________________
  14794.                                         234
  14795.                                     ALIAS NAMES
  14796.        _____________________________________________________________________
  14797.  
  14798.  
  14799.        -----
  14800.        Notes
  14801.        -----
  14802.  
  14803.        The User/Search command does not look up alias names. If an alias
  14804.        name is entered, it will be reported as "Name not found".
  14805.  
  14806.        This may seem counter intuitive when you consider that Searchlight
  14807.        treats alias names the same as real names in every other case. The
  14808.        reason for it is because it is our intention to protect the "real"
  14809.        identity of users who choose to use an alias name.
  14810.  
  14811.        Suppose a caller suspects that the alias name DARK AVENGER is really
  14812.        the mild mannered user JOE FRANKLIN. If the User/Search command
  14813.        permitted either name to be looked up, the caller might look up both
  14814.        names: by comparing the resulting stats (location, last login date,
  14815.        etc.) it would be easy to verify the hunch that these names are
  14816.        really the same caller.
  14817.  
  14818.        By disallowing alias names in the User/Search command, users can
  14819.        determine only that "DARK AVENGER" is indeed an alias name. No clues
  14820.        as to the user's real identity are revealed.
  14821.  
  14822.        Still, if you consider alias names to be a sensitive security issue
  14823.        on your system, you may wish to remove the "User" commands and even
  14824.        the "Who" command from your menus, since these commands might reveal
  14825.        certain clues about the owners of alias names.
  14826.  
  14827.  
  14828.  
  14829.  
  14830.  
  14831.  
  14832.  
  14833.  
  14834.  
  14835.  
  14836.  
  14837.  
  14838.  
  14839.  
  14840.  
  14841.  
  14842.  
  14843.  
  14844.  
  14845.  
  14846.  
  14847.  
  14848.  
  14849.  
  14850.  
  14851.  
  14852.        _____________________________________________________________________
  14853.                                         235
  14854.                               LANGUAGE CONFIGURATION
  14855.        _____________________________________________________________________
  14856.  
  14857.  
  14858.         -------------------------------------------------------------------
  14859.        | LANGUAGE CONFIGURATION                                            |
  14860.         -------------------------------------------------------------------
  14861.  
  14862.        ------------
  14863.        Introduction
  14864.        ------------
  14865.  
  14866.        Searchlight BBS offers multilanguage support. This feature allows you
  14867.        to offer your callers a choice of languages each time they connect
  14868.        to your system. Language choices can be human languages (like
  14869.        English, Spanish or French) or whimsical selections (like Star Trek
  14870.        or New York). When a language is selected, some or all of
  14871.        Searchlight's messages, prompts, text and menu choices will appear
  14872.        in the selected language. You can also have a different menu
  14873.        structure for each language if that is appropriate.
  14874.  
  14875.  
  14876.        ----------------
  14877.        Adding Languages
  14878.        ----------------
  14879.  
  14880.        A "language" in Searchlight consists of a strings file and,
  14881.        optionally, a menu and text directory. The default English language
  14882.        is stored in a file called DEFAULT.LNG, which is included with your
  14883.        copy of Searchlight. (If you are upgrading from an early release of
  14884.        Searchlight, note that the DEFAULT.LNG file replaces the STRINGS.SYS
  14885.        file. The two files are of the same file type and format; you may
  14886.        use existing utility programs designed for STRINGS.SYS on
  14887.        DEFAULT.LNG).
  14888.  
  14889.        To offer multiple languages to your callers, the first step is to
  14890.        obtain or create a language file. Language files should be placed in
  14891.        your Program Path directory (the same directory as the Searchlight
  14892.        executable files).
  14893.  
  14894.        Next, run the Config program and select "Languages Configuration".
  14895.  
  14896.        The DEFAULT language should already be installed. To create a new
  14897.        language, press F1, then enter the language file name without the
  14898.        .LNG extension.  Searchlight will add the language to its internal
  14899.        language list, and offer the following options screen:
  14900.  
  14901.             1. String File Name ..... FRENCH
  14902.             2. Description .......... French Language
  14903.             3. Primary Menu Path ....
  14904.             4. Alternate Menu Path ..
  14905.             5. Text Files Path ......
  14906.  
  14907.  
  14908.  
  14909.  
  14910.  
  14911.        _____________________________________________________________________
  14912.                                         236
  14913.                               LANGUAGE CONFIGURATION
  14914.        _____________________________________________________________________
  14915.  
  14916.        Line 1 is the name of the language's string file. Line 2 is a
  14917.        description of the language. If the person who created the language
  14918.        file placed a description of the file in string number 1, this
  14919.        description is imported for you. If not, type your own description
  14920.        here.
  14921.  
  14922.        Searchlight offers you the option to have a separate primary and
  14923.        alternate menu path and a separate text files path for each
  14924.        language. If you don't want to take advantage of these options,
  14925.        leave the fields blank. If you do want to use them, then fill in the
  14926.        appropriate fields. For example, if you had a series of French
  14927.        language menus to go with your French strings file, you should fill
  14928.        in the menu directory name in line 3:
  14929.  
  14930.             3. Primary Menu Path .. C:\SLBBS\FRMENU\
  14931.  
  14932.        Searchlight would then use the directory "C:\SLBBS\FRMENU" as the
  14933.        primary menu path whenever a caller selected the French language.
  14934.        Similarly, if you had a French language text directory, place its
  14935.        name in line 5.
  14936.  
  14937.        When more than one language is available in your system, you have a
  14938.        choice as to how your callers are prompted to select a language.
  14939.        This choice is expressed in General Config menu #1:
  14940.  
  14941.             6. Language Selection Prompt .. Before Login
  14942.  
  14943.        The options are "Before Login", "After Login" and "None". If "None"
  14944.        is selected, then no prompting for languages takes place.
  14945.  
  14946.        "Before Login" is the default. With this setting, Searchlight prompts
  14947.        for a language before displaying the Login screen or accepting the
  14948.        user's name and password. The advantage to placing the language
  14949.        prompt before login is that the login screen and login dialogue will
  14950.        appear in the language of the caller's choice. The disadvantage is
  14951.        that the language prompt always appears; since Searchlight doesn't
  14952.        yet know who the caller is, it cannot offer a default.
  14953.  
  14954.        If you prompt for languages After Login, Searchlight can offer to
  14955.        default to the caller's last selection. For example, if the caller
  14956.        used the FRENCH language on his or her last call, Searchlight asks:
  14957.  
  14958.             Your current language is FRENCH.
  14959.             Do you want to select a new language? Yes/No
  14960.  
  14961.        The caller can then simply press "No" to use their default language,
  14962.        or press "Yes" to select something else. Obviously, the disadvantage
  14963.        to this method is that the login screen, "Enter your name" prompt,
  14964.        and language prompt will all appear in the default language for
  14965.        every caller. (Note that the "default" language need not be English.
  14966.        If your callers are primarily non-English speaking, you can use any
  14967.        language as your default simply by naming the file for that language
  14968.        DEFAULT.LNG).
  14969.  
  14970.        _____________________________________________________________________
  14971.                                         237
  14972.                               LANGUAGE CONFIGURATION
  14973.        _____________________________________________________________________
  14974.  
  14975.  
  14976.        -----------------------
  14977.        Creating Language Files
  14978.        -----------------------
  14979.  
  14980.        You can create your own language files. A language file is a file in
  14981.        the same format as the DEFAULT.LNG file and must end with the
  14982.        extension LNG (for example, FRENCH.LNG or STARTREK.LNG). You can use
  14983.        the Searchlight programs MSYS.EXE and XSYS.EXE to create a language
  14984.        file (to obtain these programs, install the Language Editor from
  14985.        your installation disks under "Install Utilities"). It's best to
  14986.        start with our DEFAULT.LNG file and modify it.
  14987.  
  14988.        For a complete language implementation, you'll want to modify menus
  14989.        and text files to correspond to the target language.  More
  14990.        information about menu modifications can be found in the section
  14991.        "Menu Editor - Searchlight Menu Editor."
  14992.  
  14993.  
  14994.  
  14995.  
  14996.  
  14997.  
  14998.  
  14999.  
  15000.  
  15001.  
  15002.  
  15003.  
  15004.  
  15005.  
  15006.  
  15007.  
  15008.  
  15009.  
  15010.  
  15011.  
  15012.  
  15013.  
  15014.  
  15015.  
  15016.  
  15017.  
  15018.  
  15019.  
  15020.  
  15021.  
  15022.  
  15023.  
  15024.  
  15025.  
  15026.  
  15027.  
  15028.  
  15029.        _____________________________________________________________________
  15030.                                         238
  15031.                                       NETMAIL
  15032.        _____________________________________________________________________
  15033.  
  15034.  
  15035.         -------------------------------------------------------------------
  15036.        | INTRODUCTION TO NETMAIL                                           |
  15037.         -------------------------------------------------------------------
  15038.  
  15039.  
  15040.        ----------------
  15041.        What is Netmail?
  15042.        ----------------
  15043.  
  15044.        The term netmail refers to any private electronic mail message, sent
  15045.        from one individual to another, that is carried across a network
  15046.        (hence network mail or netmail). The network that carries such a
  15047.        message can be any of the Fidonet* technology networks that exist
  15048.        between bulletin boards, including Fidonet itself, SL_NET, or any of
  15049.        the other networks which use the Fido style message standards.
  15050.  
  15051.        Why use netmail? The answer is that is allows you to communicate
  15052.        with virtually any person who is a member of a bulletin board in the
  15053.        network to which you are connected, without placing a direct call to
  15054.        the particular BBS on which that person is a member. As an example,
  15055.        let's look at what happens when you send a typical, non-netmail
  15056.        message using Searchlight BBS. Suppose you call a local Searchlight
  15057.        BBS, Joe's World of Widgets, by dialing a local telephone number
  15058.        with your modem, and you leave a private message to your friend
  15059.        Walter, who lives in a different state. Of course, Walter won't be
  15060.        able to see that message until he calls Joe's World of Widgets
  15061.        himself -- which is something he does infrequently, since it's a
  15062.        long distance call for him, and he's not all that interested in
  15063.        widgets anyway. If your message is important, Walter may not get it
  15064.        until it's too late to be of use to him.
  15065.  
  15066.        With netmail, though, you can make long distance communication much
  15067.        faster and more reliable. Suppose you know that your friend Walter
  15068.        uses a BBS in his area called Phil's Faucet Emporium on a daily
  15069.        basis, and both Joe's World of Widgets and Phil's Faucet Emporium
  15070.        are members of the international Fidonet network. You could send a
  15071.        message from Joe's BBS in your area code, and address it to Walter
  15072.        at Phil's BBS. In a day or two, network traffic automatically
  15073.        carries your message from Joe's BBS to Phil's BBS, where it appears
  15074.        in Walter's mailbox. Since Walter calls Phil's BBS every day, he
  15075.        sees your message immediately. The result: you can exchange mail with
  15076.        your friend Walter, even though he lives in a different state and
  15077.        has much different interests than you, and neither you nor Walter
  15078.        has to dial a long distance phone number or use an out of state BBS.
  15079.  
  15080.        Of course, there were some long distance calls and charges involved
  15081.        with getting your message from Joe's BBS to Phil's BBS, but those
  15082.        charges were incurred during late night hours and only for the
  15083.        amount of time necessary to transmit a compressed version of your
  15084.        message between two bulletin boards, so they're significantly less
  15085.        than what you'd pay to call the out of state BBS and leave your
  15086.        message personally. In addition, netmail gives you the convenience
  15087.  
  15088.        _____________________________________________________________________
  15089.                                         239
  15090.                                       NETMAIL
  15091.        _____________________________________________________________________
  15092.  
  15093.        of being able to originate and receive mail on one BBS instead of
  15094.        having to dial many different systems to communicate with all the
  15095.        people you'd like to reach.
  15096.  
  15097.  
  15098.        --------------------
  15099.        Who can use Netmail?
  15100.        --------------------
  15101.  
  15102.        Any Searchlight BBS which participates in a Fidonet-technology
  15103.        network can send and receive netmail messages. As the Sysop of a
  15104.        networked BBS, you can regulate by security attributes which of your
  15105.        users has the ability to use netmail.
  15106.  
  15107.        If your BBS does not currently participate in a Fidonet style
  15108.        network, you'll need to establish a network link before you can
  15109.        begin using netmail. Network policies vary; however, the usual
  15110.        procedure is to obtain and install a Fidonet compatible front end
  15111.        mailer software package on your system, and then apply for
  15112.        membership by contacting another BBS in your area that serves as the
  15113.        central distribution point (Hub) for that area. Before you try to
  15114.        install netmail support on your BBS, confirm that you can send and
  15115.        receive netmail messages (via "MSG" files) to and from other systems
  15116.        in your network. Once you have that capability, you'll start to use
  15117.        Searchlight to read and create the MSG files, rather than a front
  15118.        end mailer or special editor.
  15119.  
  15120.  
  15121.         -------------------------------------------------------------------
  15122.        | HOW SEARCHLIGHT HANDLES NETMAIL                                   |
  15123.         -------------------------------------------------------------------
  15124.  
  15125.        If you are already familiar with echomail, you'll find that netmail
  15126.        works in much the same way. If not, you may find the discussion
  15127.        below useful as background information.
  15128.  
  15129.        To send netmail from Searchlight BBS to another BBS, you start by
  15130.        entering a message through Searchlight's text editor, typically by
  15131.        selecting a command such as "Mail/Send" or by replying to an
  15132.        existing netmail message. When sending a new message, Searchlight
  15133.        will ask you for both the name of the person to whom you are sending
  15134.        the message and the netmail address of the bulletin board where you
  15135.        would like the message sent. All networked systems have a three part
  15136.        numerical address in the form "Zone:Net/Node; for example, the
  15137.        address of Searchlight BBS in Winchester is "1:157/582". (Some
  15138.        systems have multiple addresses and some have an additional number
  15139.        called the point address). In many cases, Searchlight will provide
  15140.        the netmail address itself (by looking at an address list) but you
  15141.        should always be prepared to type the address in yourself, if
  15142.        required.
  15143.  
  15144.  
  15145.  
  15146.  
  15147.        _____________________________________________________________________
  15148.                                         240
  15149.                                       NETMAIL
  15150.        _____________________________________________________________________
  15151.  
  15152.        Once your message is typed and saved, it exists inside Searchlight as
  15153.        an ordinary mail message. The next step in the message's journey is
  15154.        to be exported from Searchlight BBS into a format that can be
  15155.        handled by network mail software.  Exporting occurs when you run
  15156.        Searchlight's included NETMAIL.EXE utility program. The netmail
  15157.        utility turns netmail messages from your BBS into individual MSG
  15158.        files in a standard format that is recognized by Fidonet mail
  15159.        software. If you have a network mail system installed on your BBS,
  15160.        you most likely already have a directory where incoming netmail MSG
  15161.        files are saved and outgoing files are stored before they are sent.
  15162.        This is where you'll export your Searchlight netmail.
  15163.  
  15164.        Once your netmail is exported, your netmail software (third party
  15165.        products provided by other companies) can actually transmit the
  15166.        files to another BBS.  There are usually two steps involved, called
  15167.        "tossing" and "polling". To find our more about these steps, you
  15168.        need to obtain a third party mail product (such as D'Bridge, Front
  15169.        Door or Binkleyterm) and follow its documentation.
  15170.  
  15171.        To receive netmail, the procedure is reversed. Incoming mail is
  15172.        stored as "MSG" files by your front end software, which are then
  15173.        imported into Searchlight by the netmail utility program
  15174.        (NETMAIL.EXE). Once imported, you read the mail using Searchlight's
  15175.        usual Mail/Read or Mail/New commands. Of course, on most systems
  15176.        you'll want to automate the whole process by running the NETMAIL.EXE
  15177.        program as part of a mail event.
  15178.  
  15179.        The main difference between netmail and echomail is that each netmail
  15180.        message has a distinct from and to address provided by the person
  15181.        sending the message, whereas echomail goes to all addresses as
  15182.        determined by the network software.
  15183.  
  15184.        Two additional aspects of Searchlight's netmail implementation are
  15185.        nodelist indexing and mail routing. Nodelist indexing is the process
  15186.        by which Searchlight gains access to the information that is in your
  15187.        network node lists; it's important because Searchlight can use the
  15188.        nodelist to look up BBS names and addresses through the nodelist to
  15189.        help your users enter correct netmail messages. If you choose to
  15190.        restrict your users to sending netmail only to listed addresses, the
  15191.        nodelist index is essential since it's used to determine which
  15192.        addresses are considered valid. Searchlight includes a stand- alone
  15193.        utility program, INDEX.EXE, which compiles a nodelist index on
  15194.        demand.
  15195.  
  15196.        Mail routing allows you to associate a netmail address with a
  15197.        username on your system. By doing this, any mail sent to that person
  15198.        is automatically converted to netmail, even if the person entering
  15199.        the message does not type in the netmail address. Routing is useful
  15200.        when you want to simplify the process of sending netmail to certain
  15201.        people without having to remember their net address. It's also great
  15202.        when you have users who are infrequent callers, but frequently call
  15203.        another networked system.
  15204.  
  15205.  
  15206.        _____________________________________________________________________
  15207.                                         241
  15208.                                       NETMAIL
  15209.        _____________________________________________________________________
  15210.  
  15211.  
  15212.         -------------------------------------------------------------------
  15213.        | CONFIGURING SEARCHLIGHT FOR NETMAIL                               |
  15214.         -------------------------------------------------------------------
  15215.  
  15216.        Searchlight's main netmail options are entered via the CONFIG
  15217.        program. To access the setup screens, run CONFIG.EXE from the DOS
  15218.        prompt, then enter the General Configuration menu and choose option
  15219.        J, "Netmail Setup". The following options screen is disclosed:
  15220.  
  15221.              1. Primary Address ............... 1:157/582
  15222.              2. Sysop's Real Name ............. JEFF REEDER
  15223.              3. Send Bad Messages To .......... SYSOP
  15224.              4. Netmail Reply Attributes ......
  15225.              5. Netmail Originate Attributes ..
  15226.              6. Unlisted Address Attributes ... WX
  15227.              7. Send Crashmail Attributes .....
  15228.              8. Routing Address Edit .......... ABCD
  15229.              9. Nodelist Setups [...]
  15230.             10. Alias Addresses [...]
  15231.  
  15232.        Fill in these fields as follows:
  15233.  
  15234.  
  15235.        -------------------
  15236.        1 - Primary Address
  15237.        -------------------
  15238.  
  15239.        This line lets you enter the primary address of your system, which
  15240.        should be typed in the format "Zone:Net/Node" or
  15241.        "Zone:Net/Node.Point". You must list a primary address in order to
  15242.        activate netmail functions. If you have more than one address, list
  15243.        additional addresses under "Alias Addresses", as outlined below.
  15244.  
  15245.  
  15246.        ---------------------
  15247.        2 - Sysop's Real Name
  15248.        ---------------------
  15249.  
  15250.        Type your name in line 2. Searchlight uses your name to replace the
  15251.        word "SYSOP" on outgoing and incoming messages, so that if you use
  15252.        the name SYSOP to log onto your own BBS, you can still send netmail
  15253.        using your real name.
  15254.  
  15255.  
  15256.        ------------------------
  15257.        3 - Send Bad Messages To
  15258.        ------------------------
  15259.  
  15260.        In this field, type the name of the person to whom you'd like bad
  15261.        messages sent. A "bad message" is simply an incoming message which
  15262.        is addressed to a username that does not appear in your USER file.
  15263.        For example, if someone tried to send a netmail message to "Jimmy
  15264.  
  15265.        _____________________________________________________________________
  15266.                                         242
  15267.                                       NETMAIL
  15268.        _____________________________________________________________________
  15269.  
  15270.        Carter" on your BBS, and your userlog did not sport the former
  15271.        president as a caller, the message would be sent to you, or to
  15272.        whatever username you place here. On almost all systems, you'll want
  15273.        to put the name SYSOP here, or your own name if you do not use the
  15274.        name SYSOP to log on to your BBS.
  15275.  
  15276.  
  15277.        ----------------------------
  15278.        4 - Netmail Reply Attributes
  15279.        ----------------------------
  15280.  
  15281.        Fields 4 through 7 are security attributes that define which users on
  15282.        your BBS can perform netmail related functions.  Field 4 specifies
  15283.        the security attributes required to reply to a netmail message. Any
  15284.        user who possesses these attributes can respond to a netmail message
  15285.        or an echomail message, but cannot necessarily originate a new
  15286.        message. As with all security fields, you can leave this field blank
  15287.        if you do not wish to restrict this feature.
  15288.  
  15289.  
  15290.        --------------------------------
  15291.        5 - Netmail Originate Attributes
  15292.        --------------------------------
  15293.  
  15294.        This field defines the attributes needed for a user to be able to
  15295.        create a new netmail message to anyone who is reachable on the
  15296.        networks to which you belong. Searchlight determines which addresses
  15297.        are valid primarily by consulting the nodelists on your system. It
  15298.        also considers any pre-entered addresses to be valid.
  15299.  
  15300.  
  15301.        -------------------------------
  15302.        6 - Unlisted Address Attributes
  15303.        -------------------------------
  15304.  
  15305.        These are the security attributes required to send netmail to any
  15306.        address, even if the address is not listed in a nodelist. Be careful
  15307.        with this option; if you allow users to have unlisted address
  15308.        access, they will be able to send incorrectly addressed netmail
  15309.        which will never reach its destination. It is best to send such
  15310.        messages with care.
  15311.  
  15312.  
  15313.        -----------------------------
  15314.        7 - Send Crashmail Attributes
  15315.        -----------------------------
  15316.  
  15317.        These attributes define which users are able to send "Crash Mail".
  15318.        Crash mail is urgent netmail: instead of being routed through the
  15319.        network at night, it's sent directly to the destination BBS
  15320.        immediately. Since crash mail can cause your system to place long
  15321.        distance phone calls at any time, it is best to restrict this
  15322.        function to yourself and your most trusted users.
  15323.  
  15324.        _____________________________________________________________________
  15325.                                         243
  15326.                                       NETMAIL
  15327.        _____________________________________________________________________
  15328.  
  15329.  
  15330.        ------------------------
  15331.        8 - Routing Address Edit
  15332.        ------------------------
  15333.  
  15334.        These attributes determine whether your users can supply their own
  15335.        routing address. A routing address is a netmail address associated
  15336.        with a user account: whenever any mail is sent to such an account,
  15337.        it becomes netmail.  Normally, you will want to prevent your users
  15338.        from doing this, and assign such addresses yourself on a case by
  15339.        case basis. However, you can give your users the ability to change
  15340.        their own routing address (via Options/Info) if you specify
  15341.        appropriate attributes here.
  15342.  
  15343.  
  15344.        -------------------
  15345.        9 - Nodelist Setups
  15346.        -------------------
  15347.  
  15348.        To access the nodelist configuration screen, press Enter here (or
  15349.        click here twice with your mouse). A new screen appears which allows
  15350.        you enter up to twenty nodelist filenames:
  15351.  
  15352.             1. Primary Nodelist .... \DB\NODELIST
  15353.             2. Alternate Nodelist .. \DB\SL_NETNL
  15354.             3. Alternate Nodelist ..
  15355.             4. Alternate Nodelist ..
  15356.             5. Alternate Nodelist ..
  15357.              ...
  15358.  
  15359.        A nodelist is a text file containing a listing of the names and
  15360.        network addresses of all bulletin boards in a given network.  You
  15361.        should have at least one such file for each network in which you are
  15362.        a member. Type the filenames here, but leave off the extension part
  15363.        of the filename. Since the extensions change when nodelists are
  15364.        updated, Searchlight automatically searches for the most current
  15365.        filename.
  15366.  
  15367.        Searchlight uses nodelist files to look up and display information
  15368.        about bulletin boards in your network, but it can only do so after
  15369.        it has compiled a special binary index file, called NLINDEX.SL2,
  15370.        that helps it find information quickly. The included utility
  15371.        program, INDEX.EXE, creates the index. You should run INDEX.EXE
  15372.        manually after inputting or changing your list of nodelist files.
  15373.        It's also a good idea to run it as a nightly event, to ensure that
  15374.        the index is kept up to date.
  15375.  
  15376.  
  15377.  
  15378.  
  15379.  
  15380.  
  15381.  
  15382.  
  15383.        _____________________________________________________________________
  15384.                                         244
  15385.                                       NETMAIL
  15386.        _____________________________________________________________________
  15387.  
  15388.  
  15389.        --------------------
  15390.        10 - Alias Addresses
  15391.        --------------------
  15392.  
  15393.        If you have more than one netmail address, use this screen to list up
  15394.        to 19 additional addresses. You should only list one address for any
  15395.        given zone number here, and it should be the address you'd like to
  15396.        use as the origin for netmail originating on your BBS to a point
  15397.        within that zone. If you have additional addresses in the same zone,
  15398.        you can list these separately in a configuration file so that mail
  15399.        written to any address can be imported to your system.
  15400.  
  15401.  
  15402.         -------------------------------------------------------------------
  15403.        | NETMAIL IMPORT & EXPORT                                           |
  15404.         -------------------------------------------------------------------
  15405.  
  15406.        The way netmail messages move to and from your Searchlight BBS system
  15407.        to the rest of the network is through a special utility program
  15408.        called NETMAIL.EXE, which is included with your Searchlight package.
  15409.        Any netmail created from within your BBS remains there until it is
  15410.        exported by running the netmail utility (which creates "MSG" files
  15411.        for the outbound mail). Similarly, incoming netmail is not available
  15412.        within Searchlight until the MSG files are imported.
  15413.  
  15414.        You can, of course, run the program NETMAIL.EXE manually from the DOS
  15415.        prompt to move your mail, or attach it to a menu inside Searchlight
  15416.        to be executed on demand. But the best way to run the netmail
  15417.        utility is as part of an event or batch file, so that importing and
  15418.        exporting of netmail is automated. For example, you could run a
  15419.        netmail import event after your system receives mail packets, or
  15420.        once per day, or even after each login or logoff to your BBS.  The
  15421.        syntax for the NETMAIL.EXE utility is as follows:
  15422.  
  15423.             NETMAIL Command [Options]
  15424.  
  15425.        Command is "E" or "Export" to export messages, "I" or "Import" to
  15426.        import messages.
  15427.  
  15428.        Options are as follows:
  15429.  
  15430.            -a         Import or export all messages (default new msgs only)
  15431.            -l         Make lowercase names on outgoing messages
  15432.            -c         Allow color codes in messages
  15433.            -k         Kill source messages after importing or exporting
  15434.            -o         Optimize lock/buffer strategy
  15435.            -v         Verbose progress messages
  15436.            -p <path>  Specifies path to CONFIG.SL2
  15437.            -g <path>  Specifies path to *.MSG files
  15438.  
  15439.        The most basic Netmail command lines are NETMAIL E to export messages
  15440.        and NETMAIL I to import messages. If the MSG files are not in the
  15441.  
  15442.        _____________________________________________________________________
  15443.                                         245
  15444.                                       NETMAIL
  15445.        _____________________________________________________________________
  15446.  
  15447.        current directory, use -G to specify their location. If your
  15448.        CONFIG.SL2 file is not in the current directory (or in the
  15449.        environment), type -P to give its path.
  15450.  
  15451.        The -A option can be used to force the netmail utility to import or
  15452.        export all available messages. By default, if -A is not given, only
  15453.        new messages are imported or exported. The utility determines which
  15454.        messages are new when exporting by means of a high message pointer
  15455.        on the MAIL conference keyed to the name "NETMAIL"; it determines
  15456.        which are new when importing by looking for its tagline in the
  15457.        source MSG files. It is not recommended that you use the -A switch
  15458.        except for special purposes.
  15459.  
  15460.        The -K or Kill switch is recommended. When used during an import, the
  15461.        netmail utility deletes the source MSG file after importing it. When
  15462.        used during an export, the utility deletes the source message from
  15463.        Searchlight's mail conference after exporting it. It's especially
  15464.        important to kill messages after exporting because a netmail message
  15465.        that resides inside Searchlight BBS is generally inaccessible by any
  15466.        user, and therefore would simply take up space until removed during
  15467.        a mass message purge or manually deleted, if -K were not used.
  15468.  
  15469.        Other NETMAIL.EXE switches are similar to the SLMAIL echomail
  15470.        utility, and allow you to process lowercase name conversions and
  15471.        color codes. The -O switch optimizes the file locking strategy on
  15472.        multiuser systems by locking the entire MAIL conference for the
  15473.        duration of the operation; this makes netmail operations faster, but
  15474.        locks other nodes from using the MAIL conference during the Netmail
  15475.        operation. We recommend using the -O switch only if no nodes are
  15476.        active during the time that the Netmail command executes.
  15477.  
  15478.  
  15479.        -------------------------------------
  15480.        Additional Alias Addresses for Import
  15481.        -------------------------------------
  15482.  
  15483.        Earlier, we mentioned that you should specify only the primary
  15484.        address in a particular zone when typing your own netmail addresses
  15485.        into Searchlight's CONFIG program. As a rule, the NETMAIL utility
  15486.        will only import messages that are explicitly addressed to your
  15487.        system, which is determined by matching the destination address to
  15488.        your system's primary or alias addresses. If no match is found, the
  15489.        netmail utility won't import the message; this is an important
  15490.        feature, because your system may act as an intermediate storage area
  15491.        for mail that is destined for another BBS, and you don't want that
  15492.        mail to be imported into your BBS (and possibly deleted) by the
  15493.        netmail program.
  15494.  
  15495.        If your BBS has a number of alternate addresses in a particular zone,
  15496.        though, you need to tell the Netmail program about the other
  15497.        addresses so it can import all the mail that should be on your BBS
  15498.        no matter which alias was used by the sender.  The way to list your
  15499.        additional addresses is to create a text file called NETMAIL.CFG.
  15500.  
  15501.        _____________________________________________________________________
  15502.                                         246
  15503.                                       NETMAIL
  15504.        _____________________________________________________________________
  15505.  
  15506.        Type the additional addresses, one per line, using the standard
  15507.        Zone:Net/Node[.Point] format. Up to 40 addresses may be specified.
  15508.        You should place your NETMAIL.CFG file in your Searchlight "data
  15509.        files" directory (the same directory that contains your USER.SL2
  15510.        file).
  15511.  
  15512.        Once the NETMAIL.CFG file is installed, the netmail utility will
  15513.        recognize the additional addresses as aliases for your system, and
  15514.        will import mail destined for those addresses.
  15515.  
  15516.  
  15517.         -------------------------------------------------------------------
  15518.        | NODELIST INDEX                                                    |
  15519.         -------------------------------------------------------------------
  15520.  
  15521.        The nodelist indexing program, INDEX.EXE, is used to create a binary
  15522.        index that allows Searchlight to quickly access data within nodelist
  15523.        files. You should run INDEX once after setting up your nodelists,
  15524.        and again as a daily event so that any nodelist changes are
  15525.        recorded.
  15526.  
  15527.        Before running INDEX, run the CONFIG program and enter the filenames
  15528.        of your nodelist files as mentioned previously.  Be sure to give
  15529.        only the filename of the "raw" or text file nodelist, not the name
  15530.        of any other indexed nodelist that might be used by your system.
  15531.        Only standard (also know as "St.  Louis") nodelists may be compiled
  15532.        by Searchlight; do not specify point lists or non-standard nodelists
  15533.        as input. If you like, you can create a private nodelist in the same
  15534.        format as the standard nodelist and include it in your index (a
  15535.        private nodelist enables you to create alias names and/or lookups
  15536.        for usernames that don't appear in regular nodelists).
  15537.  
  15538.        To create the nodelist index, simply type INDEX on the command line.
  15539.        The program will display its progress and, when finished, will have
  15540.        created a file called NLINDEX.SL2 in your Searchlight data file
  15541.        directory.
  15542.  
  15543.        Note that the index utility checks to see if the current index is up
  15544.        to date by comparing the date it was last compiled against the dates
  15545.        of the nodelist files. If the index is up to date, the INDEX.EXE
  15546.        program will not recompile it. However, should you wish to force an
  15547.        index compilation when the index is up to date, add the parameter -F
  15548.        to the INDEX.EXE command line.
  15549.  
  15550.        You can eliminate certain netmail zones from a nodelist compile if
  15551.        you do not wish to have addresses in those zones available for
  15552.        lookup. To do so, specify one or more -N parameters, where N is the
  15553.        number of the zone you wish to exclude. For example, if you are
  15554.        compiling the Fidonet nodelist, but wish to exclude zones 2 through
  15555.        6, you could type:
  15556.  
  15557.             INDEX -2 -3 -4 -5 -6
  15558.  
  15559.  
  15560.        _____________________________________________________________________
  15561.                                         247
  15562.                                       NETMAIL
  15563.        _____________________________________________________________________
  15564.  
  15565.  
  15566.        -----------
  15567.        Performance
  15568.        -----------
  15569.  
  15570.        A few notes on performance and disk space issues are in order here.
  15571.        The index utility creates a file which contains 24 bytes per node in
  15572.        the nodelist. The complete Fidonet nodelist, which typically
  15573.        comprises some 19 or 20,000 entries, will result in an index file of
  15574.        approximately 450K. The index program will require an area of disk
  15575.        space equal to the size of the final index file as a work area;
  15576.        therefore, at least 900K of disk space must be available in order to
  15577.        compile a Fidonet nodelist.
  15578.  
  15579.        The speed of the index utility may be important to you if you index
  15580.        large nodelists on a relatively slow system. The main factor that
  15581.        influences indexing speed is the amount of DOS memory available to
  15582.        the index program when it is run. For best results, run the utility
  15583.        in a DOS environment or DOS window with as much free memory as
  15584.        possible available. A typical 33mhz 386 PC with disk cache software
  15585.        installed and 640K of RAM available can compile a 20,000 entry
  15586.        Fidonet nodelist in about five minutes.
  15587.  
  15588.        The source files (raw nodelists) must remain on your system for
  15589.        Searchlight's indexes to work. If the raw nodelist files are
  15590.        deleted, moved, or changed in any way, lookups via the index will
  15591.        become impossible until the index is rebuilt.  Executing INDEX.EXE
  15592.        causes the index to be rebuilt only if there has been a change in
  15593.        the source files, so it's a good idea to execute the index utility
  15594.        nightly.
  15595.  
  15596.  
  15597.        ----------
  15598.        Index Uses
  15599.        ----------
  15600.  
  15601.        Searchlight's internal netmail procedures don't require that a
  15602.        nodelist index exist, but without the nodelist index you won't be
  15603.        able to see and confirm the names of the bulletin boards where
  15604.        netmail is being sent, so it's highly recommended that you do use an
  15605.        index.
  15606.  
  15607.        If you choose not to compile a nodelist index, you should be aware
  15608.        that Searchlight will only send netmail if the user sending the
  15609.        message has the "Unlisted Address" attributes, or if the netmail is
  15610.        a reply to an existing message.
  15611.  
  15612.  
  15613.  
  15614.  
  15615.  
  15616.  
  15617.  
  15618.  
  15619.        _____________________________________________________________________
  15620.                                         248
  15621.                                       NETMAIL
  15622.        _____________________________________________________________________
  15623.  
  15624.  
  15625.         -------------------------------------------------------------------
  15626.        | USING SEARCHLIGHT NETMAIL                                         |
  15627.         -------------------------------------------------------------------
  15628.  
  15629.        Once your netmail infrastructure is set up -- you've got events and
  15630.        procedures in place which use the NETMAIL.EXE and INDEX.EXE programs
  15631.        to transfer mail and build the appropriate index files -- it's time
  15632.        to run Searchlight and actually read and create some netmail
  15633.        messages.
  15634.  
  15635.        The underlying goal of Searchlight's netmail system is simple:
  15636.        netmail is created and read with the same commands as regular mail
  15637.        in Searchlight BBS.  In almost all cases, the same intuitive
  15638.        commands you already know how to use to send mail to other users on
  15639.        your system can be used to send netmail. The only time special
  15640.        commands are needed is when there is no way for Searchlight to make
  15641.        a determination itself as to what kind of message you are sending
  15642.        and where its destination is.
  15643.  
  15644.  
  15645.        -----------------
  15646.        Receiving Netmail
  15647.        -----------------
  15648.  
  15649.        Receiving netmail sent to you from a remote system is
  15650.        extraordinarily straightforward; in fact, no new procedures or
  15651.        commands are required at all.  Searchlight simply presents netmail
  15652.        to you in your regular mailbox, along with your other mail, and you
  15653.        read netmail simply by reading your mail in Searchlight. You can
  15654.        easily end up with a mixture of regular mail and Netmail in your
  15655.        mailbox at the same time: Searchlight lets you deal with all of your
  15656.        mail the same way, regardless of its origin.
  15657.  
  15658.  
  15659.        -------------------
  15660.        Replying to Netmail
  15661.        -------------------
  15662.  
  15663.        In virtually all cases where you are reading a netmail message sent
  15664.        to you, you can reply in the usual fashion simply by selecting the
  15665.        "Reply" function from the menubar. At the "To:" prompt, where the
  15666.        name of the addressee appears, press Enter as usual, and then look
  15667.        for a netmail address and bulletin board name to appear to the right
  15668.        of the name. For example, if you were replying to a message from Jeff
  15669.        Reeder on Searchlight BBS, you might see something like this:
  15670.  
  15671.             To : JEFF REEDER @250:250/25 Searchlight BBS, Winchester, VA
  15672.  
  15673.        Notice that the netmail address (250:250/25) was inserted
  15674.        automatically and the name of the bulletin board was displayed for
  15675.        reference. If the name of the BBS were not listed in your nodelists
  15676.        (or if you did not create a nodelist index file), you might see the
  15677.  
  15678.        _____________________________________________________________________
  15679.                                         249
  15680.                                       NETMAIL
  15681.        _____________________________________________________________________
  15682.  
  15683.        words "Unknown Address" instead; this usually doesn't indicate that
  15684.        there is a problem with the address, only that the name of the BBS
  15685.        is not known by Searchlight.
  15686.  
  15687.        If a netmail address does not appear, or if you get a message such as
  15688.        "User not on file", it's probably because your account does not have
  15689.        the required security attributes to send netmail replies. Either
  15690.        change your attribute level, or change the required attributes to
  15691.        send netmail in the CONFIG program.
  15692.  
  15693.        If you like, you can send carbon-copies of your reply to others, as
  15694.        with any reply. Then simply type your reply and save it. That's all
  15695.        that is required to reply to a private netmail message on
  15696.        Searchlight BBS -- the message is saved and will become netmail as
  15697.        soon as you run the NETMAIL.EXE utility to export it.
  15698.  
  15699.        You can also create private netmail replies to public echomail
  15700.        messages, and you do so the same way you send regular private
  15701.        replies to public messages:  select "Mail" from the menubar when
  15702.        reading the public message. Again, you are able to press Enter at
  15703.        the "To:" prompt and will see the netmail address and bulletin board
  15704.        name if they are available. A few problems are possible when sending
  15705.        netmail replies to echomail. The way Searchlight determines the
  15706.        original address of an echomail message is by examining the "Origin"
  15707.        line on the message: in some cases, the origin line does not reflect
  15708.        a correct address. This is particularly true in conferences that
  15709.        have been gated from one network to another. You may not be able to
  15710.        enter an automatic reply to such messages, although you can still
  15711.        enter a netmail reply by manually typing the correct address with
  15712.        the "@" syntax, as we'll describe below.
  15713.  
  15714.  
  15715.        -------------------
  15716.        Originating Netmail
  15717.        -------------------
  15718.  
  15719.        There are several ways you can enter a new netmail message to someone
  15720.        that's not a reply to an existing message. In some cases, you will
  15721.        need to know the numerical netmail address of the BBS where you want
  15722.        to send the message, and in other cases, Searchlight can provide the
  15723.        address based on known data.  Again, Searchlight's goal is to
  15724.        automate the process of sending netmail without requiring you to
  15725.        specify information explicitly. Let's look at various possibilities.
  15726.  
  15727.  
  15728.        --------------------------
  15729.        Sending Netmail to a Sysop
  15730.        --------------------------
  15731.  
  15732.        If the person to whom you are sending a netmail message is the Sysop
  15733.        of a BBS, his or her name probably appears in your nodelist file,
  15734.        and Searchlight can find the appropriate netmail address based on
  15735.        that name. If you select the "Mail" command from Searchlight's main
  15736.  
  15737.        _____________________________________________________________________
  15738.                                         250
  15739.                                       NETMAIL
  15740.        _____________________________________________________________________
  15741.  
  15742.        menu and then select "Send" from the mail subcommands menu, and then
  15743.        type in the name of your addressee, you may see something like this:
  15744.  
  15745.                  To : JOHN YOHE
  15746.             John Yohe @1:107:213 Fort Z BBS, Levittown, NY?  Yes/No/Quit
  15747.  
  15748.        Searchlight discovered the name "JOHN YOHE" in your nodelist, and is
  15749.        asking you if this is the correct person and correct address. If it
  15750.        is, type "Y", and Searchlight will enter a message to node
  15751.        1:107/213. If the information shown isn't correct, you can press "N"
  15752.        to see additional choices.
  15753.  
  15754.        What if John Yohe is also a member of your own BBS? The answer is
  15755.        that Searchlight will assume you want to send a local message. To
  15756.        override that decision, you need to tell Searchlight explicitly that
  15757.        you want to send netmail: you can do that either by using the "@"
  15758.        syntax outlined below, or by selecting a dedicated "Netmail Send"
  15759.        command from a menu, as we'll describe shortly.
  15760.  
  15761.  
  15762.        -------------------------
  15763.        Sending Netmail to Others
  15764.        -------------------------
  15765.  
  15766.        What if you want to send netmail to someone who is a user on a remote
  15767.        system, but not the Sysop? Searchlight won't be able to look up the
  15768.        person's netmail address, since their name doesn't appear in any
  15769.        listing. The only way to send netmail in such cases is to tell
  15770.        Searchlight what the netmail address is.  One way to do that is to
  15771.        type an "@" sign after their name, followed by the address, like
  15772.        this:
  15773.  
  15774.             To : JOHN YOHE @1:107/213
  15775.  
  15776.        The @ tells Searchlight that you are interested in sending netmail to
  15777.        the given address. You can use @ signs anywhere that you type a
  15778.        username, including carbon copy lines, and in the prompts that
  15779.        appear when you reply to messages or forward messages to users. You
  15780.        can also type the @ sign by itself, without an address after it:
  15781.        Searchlight will either try look up the address in the nodelist, or,
  15782.        if the lookup fails, will prompt you to enter an address on a
  15783.        separate line. (This is a good way to resolve conflicts when you
  15784.        have a local user with the same name as someone to whom you'd like
  15785.        to send netmail).
  15786.  
  15787.  
  15788.        ------------------------------------
  15789.        Creating an Explicit Netmail Command
  15790.        ------------------------------------
  15791.  
  15792.        While specifying netmail addresses via the "@" syntax is great for
  15793.        experienced users, an easy to use, menu driven program like
  15794.        Searchlight BBS should have a better way to ask for a netmail
  15795.  
  15796.        _____________________________________________________________________
  15797.                                         251
  15798.                                       NETMAIL
  15799.        _____________________________________________________________________
  15800.  
  15801.        address. It does, and the way to access it is to set up a new
  15802.        command, "Netmail Send", on a menu within your BBS.
  15803.  
  15804.        Netmail send is a command you can use anytime you know you want to
  15805.        send a netmail message. The difference between the netmail send
  15806.        command and the regular send command is simply that the netmail send
  15807.        command assumes your message will be netmail; it doesn't check the
  15808.        local user database, and asks you to type in a netmail address if no
  15809.        address can be found in the nodelist.  The netmail send command is
  15810.        exactly like the regular send command with an "@" sign appended to
  15811.        the username, but doesn't require you to type in the "@" symbol.
  15812.  
  15813.        You can place a netmail send command anywhere you like in your menu
  15814.        structure, but the most obvious place to put it is on your MAIL menu,
  15815.        right after the regular send command. Here's an example:
  15816.  
  15817.             1. Command Name ................. Netmail
  15818.             2. Command Key .................. T
  15819.             3. Description       Send netmail
  15820.             4. Access Levels & Graphics [...]
  15821.             5. Command Number (1) ........... 131
  15822.             6. Command Parameters (1) ....... /x /n
  15823.  
  15824.        You may notice that the only difference between this command and the
  15825.        regular mail send command is the /N, or Netmail, parameter given on
  15826.        line 6.
  15827.  
  15828.        When this command is executed and you type a name at the "To:"
  15829.        prompt, Searchlight immediately checks your nodelist file. If a
  15830.        match is found, Searchlight displays it and asks whether you would
  15831.        like to use the address shown.
  15832.  
  15833.        If no satisfactory matches are found, Searchlight prompts for a
  15834.        netmail address:
  15835.  
  15836.             Address:
  15837.  
  15838.        Type the actual address (Zone:Net/Node or Zone:Net/Node.Point) here.
  15839.        If the address is valid, Searchlight will accept it and display the
  15840.        name and location of the BBS if possible.
  15841.  
  15842.  
  15843.        ----------------------------------
  15844.        Creating Netmail Routing Addresses
  15845.        ----------------------------------
  15846.  
  15847.        So far we've seen that Searchlight can obtain a netmail address from
  15848.        another message, from a nodelist, or by asking you to type in an
  15849.        address manually.  One other way that a netmail address can be
  15850.        supplied is by attaching it to a name in your Searchlight user file.
  15851.  
  15852.        Every user account on your BBS has room for an optional netmail
  15853.        address; by default, that space is blank for all users when you
  15854.  
  15855.        _____________________________________________________________________
  15856.                                         252
  15857.                                       NETMAIL
  15858.        _____________________________________________________________________
  15859.  
  15860.        install Searchlight. Use the command 2-Sysop/Options/Info to
  15861.        associate an address with any user account, by typing the netmail
  15862.        address (Zone:Net/Node[.Point]) on the last input line shown.
  15863.  
  15864.        Associating a netmail address with a user account in this way creates
  15865.        the effect of routing that person's messages to their netmail
  15866.        address automatically. That is, anytime someone tries to send a
  15867.        message or forward a message to that user, Searchlight automatically
  15868.        creates netmail to the user's address. This is true whether the
  15869.        message is entered via a normal Mail/Send command or a Netmail send
  15870.        command.
  15871.  
  15872.        Why set up a routing address? There are several reasons for doing so.
  15873.        If a particular person is a member of your BBS but calls
  15874.        infrequently, a routing address enables him to have his private mail
  15875.        sent to another bulletin board which he uses more often than yours.
  15876.  
  15877.        If a person has several different netmail addresses but one address
  15878.        is the preferable one, you could set up that address as his or her
  15879.        routing address.  Then Searchlight will find the preferable address
  15880.        immediately instead of scanning through many options.
  15881.  
  15882.        A particular benefit of routing addresses is that it allows you to
  15883.        create known netmail addresses for users who don't appear in your
  15884.        nodelists. For example, if a user named ED SMITH had a netmail
  15885.        address of "250:250/25" associated with his username, Searchlight
  15886.        would automatically know where to send Ed Smith's mail. Otherwise,
  15887.        someone who wanted to send netmail to Ed Smith would need to know
  15888.        his netmail address and enter it manually each time.
  15889.  
  15890.        It should be noted that mail sent to a routed address exists inside
  15891.        Searchlight as regular mail until it is exported; Ed Smith could,
  15892.        for example, call your BBS and read any netmail messages to him that
  15893.        have not yet been exported to your netmail directory. Also, a user
  15894.        who doesn't have the required security attributes to send netmail
  15895.        can send Ed Smith a message, but that message remains local to your
  15896.        BBS and does not become a netmail message.
  15897.  
  15898.  
  15899.        --------------------
  15900.        Routing Address Edit
  15901.        --------------------
  15902.  
  15903.        Most sysops will prefer to assign routing addresses manually.
  15904.        However, if you prefer, you can enable your users to type their own
  15905.        routing addresses into your system. To do so, specify appropriate
  15906.        security attributes on line 12 ("Routing Address Edit") in the
  15907.        Netmail Setups configuration screen.
  15908.  
  15909.  
  15910.  
  15911.  
  15912.  
  15913.  
  15914.        _____________________________________________________________________
  15915.                                         253
  15916.                                       NETMAIL
  15917.        _____________________________________________________________________
  15918.  
  15919.  
  15920.         -------------------------------------------------------------------
  15921.        | ADDITIONAL NETMAIL CONSIDERATIONS                                 |
  15922.         -------------------------------------------------------------------
  15923.  
  15924.  
  15925.        -------------
  15926.        Netmail Scope
  15927.        -------------
  15928.  
  15929.        Netmail messages can only be created inside of Searchlight BBS. You
  15930.        cannot create a netmail message through an offline reader program or
  15931.        by sending a message with SLMAIL or a similar external utility. You
  15932.        can receive netmail messages through an offline reader, but replies
  15933.        to such messages will not become netmail replies.
  15934.  
  15935.  
  15936.        ------------
  15937.        Bad Messages
  15938.        ------------
  15939.  
  15940.        Occasionally, you may see a message that starts with a line like
  15941.        this:
  15942.  
  15943.             ---- NETMAIL Message For Unknown User:
  15944.  
  15945.        The netmail utility generates this message when it tries to import
  15946.        netmail that is addressed to a user who is not a valid name in your
  15947.        user file. The unknown name is shown, followed by the entire text of
  15948.        the message.
  15949.  
  15950.        Bad messages are often the result of misspelled usernames, or titles
  15951.        (such as "Zone Coordinator") that may have been appended to a
  15952.        username. If possible, forward the message to the appropriate user.
  15953.        Otherwise, delete it or handle it as you see fit.
  15954.  
  15955.  
  15956.        -----------------------------
  15957.        Listed vs. Unlisted Addresses
  15958.        -----------------------------
  15959.  
  15960.        Searchlight considers any address which is found in an existing
  15961.        message or in the user file as a routing address to be a listed
  15962.        address. This distinction is important if you use security
  15963.        attributes to prevent your users from sending messages to random,
  15964.        unlisted addresses. It is possible, though unlikely, that an
  15965.        incoming netmail or echomail message contains an incorrect address
  15966.        or an address which has become obsolete since the mail was sent. In
  15967.        such cases, Searchlight will permit users to reply, which could
  15968.        result in an improperly addressed outgoing message. (Improperly
  15969.        addressed messages are normally not a problem in most networks as
  15970.        long as they are kept to a minimum).
  15971.  
  15972.  
  15973.        _____________________________________________________________________
  15974.                                         254
  15975.                                       NETMAIL
  15976.        _____________________________________________________________________
  15977.  
  15978.        You should also consider the possibility of users entering unlisted
  15979.        or improper addresses into their user account, if you allow routing
  15980.        address editing.
  15981.  
  15982.  
  15983.        ----------------
  15984.        Origin Addresses
  15985.        ----------------
  15986.  
  15987.        When Searchlight's netmail utility exports messages, it automatically
  15988.        picks one of the addresses you specified in the CONFIG program as
  15989.        the origin address for that message. Which of your addresses are
  15990.        used depends on the zone number of the outgoing message: Searchlight
  15991.        tries to match the zone of the origin address to the zone of the
  15992.        destination address.  If your system had an SL_NET address of
  15993.        250:250/25 and a Fidonet address of 1:157/582, Searchlight would
  15994.        assign the former address as the origin to messages destined for
  15995.        zone 250 and the latter for addresses in zone 1.
  15996.  
  15997.        If an exact match is not possible, but the destination address is
  15998.        somewhere inside Fidonet (zones 1 through 7), then Searchlight tries
  15999.        to pick as the origin address any address which is also in zone 1 to
  16000.        7. If that fails, then your Primary Address is used as the default.
  16001.  
  16002.  
  16003.  
  16004.  
  16005.  
  16006.  
  16007.  
  16008.  
  16009.  
  16010.  
  16011.  
  16012.  
  16013.  
  16014.  
  16015.  
  16016.  
  16017.  
  16018.  
  16019.  
  16020.  
  16021.  
  16022.  
  16023.  
  16024.  
  16025.  
  16026.  
  16027.  
  16028.  
  16029.  
  16030.  
  16031.  
  16032.        _____________________________________________________________________
  16033.                                         255
  16034.                                    RIP GRAPHICS
  16035.        _____________________________________________________________________
  16036.  
  16037.  
  16038.         -------------------------------------------------------------------
  16039.        | USING RIP GRAPHICS                                                |
  16040.         -------------------------------------------------------------------
  16041.  
  16042.        Searchlight supports RIP Graphics, an advanced terminal protocol that
  16043.        allows your BBS to take advantage of features like high resolution
  16044.        graphics, mouse support, fonts, icons, and more. RIP graphics are
  16045.        generated by a special language called RIPscrip.
  16046.  
  16047.  
  16048.        -----------------
  16049.        What is RIPscrip?
  16050.        -----------------
  16051.  
  16052.        One way to think of RIP graphics and RIPscrip is as an alternative to
  16053.        ANSI graphics. Many BBS systems and other character-based hosts use
  16054.        some kind of ANSI graphics today; Searchlight, in particular, takes
  16055.        advantage of ANSI screen controls to a great extent. ANSI is what
  16056.        allows Searchlight to do full screen interfaces, menubars, colors,
  16057.        and cursor positioning on a remote terminal with ANSI support. You
  16058.        can also make your own colorful ANSI files using products like
  16059.        THEDraw or Laughing Dog.
  16060.  
  16061.        Like ANSI, RIP is a terminal protocol; that is, it's a special
  16062.        language that Searchlight can use to communicate with a remote
  16063.        terminal. While RIP is compatible with ANSI, it offers far more
  16064.        functions than ANSI alone provides.  Among them are:
  16065.  
  16066.             * Full screen graphical primitives (Box, Circle, Line, etc.)
  16067.             * High-resolution bitmapped images (JPEG and BMP)
  16068.             * Digitized audio (WAV files)
  16069.             * Specialized fill patterns
  16070.             * Full color manipulation
  16071.             * Multiple scaleable fonts
  16072.             * Simultaneous text and graphics windows on the screen at once
  16073.             * Full mouse support for point and click operation
  16074.             * Remotely stored bitmap icons for detailed, high-speed graphics
  16075.             * Full clipboard copy and paste ability
  16076.             * Custom line-styles for technical drawings, etc.
  16077.  
  16078.        Using RIPscrip graphics on your Searchlight BBS, you can show
  16079.        visually stunning graphics, offer full point and click access to
  16080.        your system, and in many cases, speed up throughput of your user's
  16081.        on-line connect times. In other words, RIPscrip graphics can often
  16082.        be transmitted faster than ANSI graphics.
  16083.  
  16084.        Searchlight's RIP features are available both during a local login
  16085.        and during an online session with a RIP compatible terminal -- that
  16086.        is, when you or your caller dials into your BBS from a terminal
  16087.        program that supports the RIPscrip protocol. RIP is automatically
  16088.        selected when you connect to a Searchlight BBS system with RIPterm.
  16089.        In local mode, you can turn RIP on and off by pressing ALT-R at any
  16090.  
  16091.        _____________________________________________________________________
  16092.                                         256
  16093.                                    RIP GRAPHICS
  16094.        _____________________________________________________________________
  16095.  
  16096.        Character or Word style menu, such as the main menu. (RIP requires
  16097.        an EGA or VGA compatible monitor). During a remote login, you can
  16098.        use the ANSI command to turn RIP graphics on and off, if desired.
  16099.  
  16100.        Although local RIP displays can be enabled all the time, you may wish
  16101.        to enable RIP only for local logins. This is the most efficient way
  16102.        to run Searchlight in RIP mode. Attempting to use RIP mode in
  16103.        multiple small windows may result in a significant performance
  16104.        penalty, depending on your system's speed.
  16105.  
  16106.        RIP graphics are available to your callers even if you don't display
  16107.        local RIP. When a caller is using RIP graphics and your display is
  16108.        not in graphics mode, you won't be able to see all of the RIP
  16109.        features like buttons and scroll bars, but you'll still see as much
  16110.        of the text window as possible.
  16111.  
  16112.  
  16113.        ----------------------------
  16114.        How Searchlight Supports RIP
  16115.        ----------------------------
  16116.  
  16117.        Searchlight's RIP graphics support can be roughly divided into three
  16118.        main categories:
  16119.  
  16120.             * Built-in RIP features. These are features like pop-up dialog
  16121.               boxes, scroll bars, etc. that are built in to Searchlight
  16122.               BBS, and are displayed automatically in RIP mode. You can
  16123.               change the colors and certain other aspects of these
  16124.               features, but you can't change the buttons or commands that
  16125.               appear.
  16126.  
  16127.             * RIP menus. Searchlight lets you build your own RIP menus,
  16128.               using our menu editor system in conjunction with a set of
  16129.               "RIP Styles". Your RIP menus can contain any command buttons
  16130.               you choose, and can appear in a variety of colors, font
  16131.               styles, and layouts.
  16132.  
  16133.             * External RIP support. Searchlight can display external files
  16134.               created with a RIP graphics program, such as RIPdraw or
  16135.               RIPaint. These files can simply be pictures, or they can be
  16136.               menus with buttons and mouse areas.  You can also use
  16137.               externally generated RIP files as backdrops for built-in
  16138.               menus.
  16139.  
  16140.        In a moment, we'll look at each of these categories in more detail.
  16141.        First, though, let's look at Searchlight's RIP General Setup and RIP
  16142.        Styles Setup menus, located in the CONFIG program.
  16143.  
  16144.  
  16145.  
  16146.  
  16147.  
  16148.  
  16149.  
  16150.        _____________________________________________________________________
  16151.                                         257
  16152.                                    RIP GRAPHICS
  16153.        _____________________________________________________________________
  16154.  
  16155.  
  16156.         -------------------------------------------------------------------
  16157.        | RIP GENERAL SETUP                                                 |
  16158.         -------------------------------------------------------------------
  16159.  
  16160.        The RIP General Setup menu controls overall aspects of Searchlight's
  16161.        RIP features. The options are:
  16162.  
  16163.              1. Enable RIP Graphics .......... Yes
  16164.              2. RIP on All Help Levels ....... Yes
  16165.              3. ANSI Menus in RIP Mode ....... No
  16166.              4. Local RIP for Local Logins ... Prompt
  16167.              5. Local RIP for Remote Logins .. No
  16168.              6. Auto RIP/ICN Downloading ..... Yes
  16169.              7. RIP Dialog Box Style ......... Dial
  16170.              8. RIP Popup Box Style .......... Dial
  16171.              9. RIP Text Editor Style ........ Editor
  16172.             10. RIP Conference List Style .... Dial
  16173.             11. RIP Text Quote Style ......... Dial
  16174.             12. RIP Bulletins Style .......... Dial
  16175.             13. RIP Message Reader Style ..... Menu
  16176.             14. RIP Message Scan Style ....... Menu
  16177.             15. RIP File Browser Style ....... Menu
  16178.             16. RIP Who/Chat Style ........... Dial
  16179.             17. RIP User List Style .......... Dial
  16180.  
  16181.  
  16182.        -----------------------
  16183.        1 - Enable RIP Graphics
  16184.        -----------------------
  16185.  
  16186.        This is a "master switch" that you can use to enable or disable RIP
  16187.        graphics for your entire system. If you do not desire any RIP
  16188.        features to be available in your BBS, turn this switch to No.
  16189.  
  16190.  
  16191.        --------------------------
  16192.        2 - RIP On All Help Levels
  16193.        --------------------------
  16194.  
  16195.        If set to Yes (the default), Searchlight displays full RIP menus
  16196.        regardless of whether a user's help preference is set to Novice,
  16197.        Intermediate or Expert. This is the recommended behavior, because
  16198.        RIP menus generally need to be displayed in full each time they are
  16199.        used in order for mouse areas to be available.
  16200.  
  16201.        If you set this switch to No, then Expert and Intermediate users may
  16202.        get abbreviated ANSI menus rather than RIP menus on some screens.
  16203.  
  16204.  
  16205.  
  16206.  
  16207.  
  16208.  
  16209.        _____________________________________________________________________
  16210.                                         258
  16211.                                    RIP GRAPHICS
  16212.        _____________________________________________________________________
  16213.  
  16214.  
  16215.        --------------------------
  16216.        3 - ANSI Menus in RIP Mode
  16217.        --------------------------
  16218.  
  16219.        This switch tells Searchlight what to do if it encounters an external
  16220.        ANSI file attached to a menu, but no external RIP file.  If set to
  16221.        No (the default), Searchlight displays its own internally generated
  16222.        RIP menu rather than the ANSI file. If set to Yes, then Searchlight
  16223.        displays the ANSI file rather than its internal RIP menu.
  16224.  
  16225.        Since ANSI files do not have mouse areas, it is recommended to leave
  16226.        this switch set to No. If you'd like to display your ANSI files to
  16227.        RIP callers, however, then set this switch to Yes.
  16228.  
  16229.        Note: Notice that if an external RIP file is available, it is
  16230.              displayed in RIP mode regardless of this switch setting. This
  16231.              switch only controls whether Searchlight's internal RIP menus
  16232.              get precedence over external ANSI files.
  16233.  
  16234.  
  16235.        -------------------------------
  16236.        4 - Local RIP for Local Logins
  16237.        5 - Local RIP for Remote Logins
  16238.        -------------------------------
  16239.  
  16240.        These settings control whether or not Searchlight automatically
  16241.        displays local RIP graphics during local logins and remote
  16242.        connections. To obtain the most efficient operation, we recommend
  16243.        disabling Local RIP for Remote Logins.
  16244.  
  16245.  
  16246.        ----------------------------
  16247.        6 - Auto RIP/ICN Downloading
  16248.        ----------------------------
  16249.  
  16250.        When this setting is enabled, Searchlight automatically transfers
  16251.        RIP graphics artwork to remote users via the Zmodem protocol.
  16252.        Automatic downloading speeds up the display of RIP artwork, and is
  16253.        recommended. See the section "RIP Graphics - Automatic RIP
  16254.        Downloading" for more information about this feature.
  16255.  
  16256.  
  16257.        ------------------------
  16258.        7 - RIP Dialog Box Style
  16259.        ------------------------
  16260.  
  16261.        This selection -- and the selections following it -- define the "RIP
  16262.        Style" used to generate dialog boxes, popup menus, the full screen
  16263.        text editor, and other features listed when in RIP mode. The options
  16264.        available here correspond to the named RIP styles you have created
  16265.        in RIP Styles Setup -- as described in more detail below.
  16266.  
  16267.  
  16268.        _____________________________________________________________________
  16269.                                         259
  16270.                                    RIP GRAPHICS
  16271.        _____________________________________________________________________
  16272.  
  16273.        Note: Note that many of Searchlight's internal features use defaults
  16274.              for font sizes and other features that will override the style
  16275.              settings. This behavior is necessary in order to ensure that
  16276.              information is properly formatted on screen.
  16277.  
  16278.  
  16279.         -------------------------------------------------------------------
  16280.        | RIP STYLES                                                        |
  16281.         -------------------------------------------------------------------
  16282.  
  16283.        Searchlight uses a concept called RIP Styles as the primary means of
  16284.        customizing the look of its RIP menus and other RIP features. A RIP
  16285.        style is really a collection of colors, font sizes, and other
  16286.        options. Since there are so many different options associated with
  16287.        each RIP element, RIP styles give you a convenient way to assign
  16288.        options to multiple RIP features without having to manually key in a
  16289.        long list of colors and other settings for each feature on your
  16290.        system.
  16291.  
  16292.        Note: RIP Styles are used to customize the way Searchlight looks in
  16293.              RIP mode. If you're not interested in customizing Searchlight,
  16294.              or if you prefer to do this step later, you can skip this
  16295.              section and use Searchlight with the default settings that are
  16296.              provided.
  16297.  
  16298.        Searchlight divides each RIP element into three sections: Windows,
  16299.        Titles, and Buttons. A "Window" is a rectangular area of the screen
  16300.        which contains a particular RIP element, like a menu or a conference
  16301.        listing. A "Title" is an area at the top of the window -- typically
  16302.        one line -- that contains a title or heading for that window.
  16303.        "Buttons" are controls (mouse areas) that appear inside the window
  16304.        and let you perform functions. Here's a typical RIP display, showing
  16305.        all three elements:
  16306.  
  16307.                                     <insert image here>
  16308.  
  16309.        Here, the "Window" is the entire area; the "Title" is the box that
  16310.        contains the text "Electronic Mail"; and the buttons are the various
  16311.        controls, "Read", "Send", etc. You can customize not only the colors
  16312.        of these features, but also font and font size, "beveling" and other
  16313.        special effects, and in some cases screen position. You can also
  16314.        disable the title or the window itself.
  16315.  
  16316.        To view or modify the RIP styles, select "RIP Styles Setup", which
  16317.        can be found under "General Configuration" in the Searchlight CONFIG
  16318.        program. A listing such as this appears:
  16319.  
  16320.             Searchlight BBS RIP Styles Setup
  16321.  
  16322.             A. Aqua       Blue-Green Window
  16323.             B. Steel      Grey/Black
  16324.             C. RedGrey    Steel w/Red Letters
  16325.             D. <unassigned>
  16326.  
  16327.        _____________________________________________________________________
  16328.                                         260
  16329.                                    RIP GRAPHICS
  16330.        _____________________________________________________________________
  16331.  
  16332.        Up to 16 styles can be entered. Each style is given a one to eight
  16333.        letter name, which is used to apply the style to menus and other
  16334.        features later; a description; and various settings. To view a
  16335.        style, select one of the existing styles and press Enter. The
  16336.        following listing appears:
  16337.  
  16338.             Searchlight BBS RIP Styles Setup Menu
  16339.  
  16340.              1. Style Name .................... Aqua
  16341.              2. Style Description ............. Blue-Green
  16342.              3. Window Attributes [...]
  16343.              4. Title Attributes  [...]
  16344.              5. Button Attributes [...]
  16345.  
  16346.        Enter the name and description for the style in lines 1 and 2. As
  16347.        mentioned, the style name is what you'll use later to apply the
  16348.        style, so choose a name that you'll remember. The description is
  16349.        only displayed here.
  16350.  
  16351.        Each style has further submenus for the window, title and button
  16352.        attributes, as shown. Start by selecting "Window Attributes" (place
  16353.        the cursor on this line, then press Enter or double-click with your
  16354.        mouse).
  16355.  
  16356.  
  16357.        -----------------
  16358.        Window Attributes
  16359.        -----------------
  16360.  
  16361.              1. Make Window Visible .......... Yes
  16362.              2. Window Position .............. Center
  16363.              3. User Defined Top Left X ...... 0
  16364.              4. User Defined Top Left Y ...... 0
  16365.              5. User Defined Bottom Right X .. 0
  16366.              6. User Defined Bottom Right Y .. 0
  16367.              7. Foreground Color ............. White
  16368.              8. Background Color ............. Blue
  16369.              9. Bright Color ................. Lt Cyan
  16370.             10. Dark Color ................... Blue
  16371.             11. Surface Color ................ Cyan
  16372.             12. Corner Color ................. Cyan
  16373.             13. Bevel Size ................... 5
  16374.             14. Font Style ................... Default
  16375.             15. Font Size .................... 1
  16376.             16. Window Style Switches [...]
  16377.  
  16378.        Here's a description of each item:
  16379.  
  16380.  
  16381.  
  16382.  
  16383.  
  16384.  
  16385.  
  16386.        _____________________________________________________________________
  16387.                                         261
  16388.                                    RIP GRAPHICS
  16389.        _____________________________________________________________________
  16390.  
  16391.  
  16392.        -----------------------
  16393.        1 - Make Window Visible
  16394.        -----------------------
  16395.  
  16396.        This option determines whether the window itself -- the square,
  16397.        usually beveled area that acts as the outline for the entire area --
  16398.        appears. This is normally set to Yes. If set to No, the effect is to
  16399.        have the window's title and buttons "floating" above whatever is
  16400.        already on the screen. You can use this effect to add buttons to
  16401.        existing RIP pictures ("Wallpaper", as described later in this
  16402.        section).
  16403.  
  16404.  
  16405.        -------------------
  16406.        2 - Window Position
  16407.        -------------------
  16408.  
  16409.        This field defines where on the screen this window will appear. There
  16410.        are a number of options that can be selected here:  Center,
  16411.        Top-Left, Top-Right, Top-Center, etc. There is also a "User Defined"
  16412.        setting that allows you to describe exactly where you'd like the
  16413.        window to appear on your screen. If "User Defined" is selected, use
  16414.        lines 3 through 6 to define the upper-left and lower-right hand
  16415.        corners of the window. These coordinates are given over a 640x350
  16416.        pixel range.
  16417.  
  16418.        Note: Use the "User Defined" setting to place a Searchlight
  16419.              generated menu within an existing background, such as a
  16420.              picture created with RIPaint. When using this setting, you
  16421.              should be careful to make the window large enough to hold the
  16422.              title and buttons intended to fit within it, otherwise some
  16423.              of these elements may be omitted or may overlap the window
  16424.              border.
  16425.  
  16426.  
  16427.        --------------------
  16428.        7 - Foreground Color
  16429.        8 - Background Color
  16430.        --------------------
  16431.  
  16432.        These fields control the color of the text that appears on the face
  16433.        of the window. The "Background Color" is used only for text "boxes"
  16434.        that appear inside a window (such as in a conference listing). For
  16435.        regular menu windows, the background color is always the same as the
  16436.        window's surface color.
  16437.  
  16438.  
  16439.        ------------------
  16440.        11 - Surface Color
  16441.        ------------------
  16442.  
  16443.        This is the color of the surface of the button. For example, in the
  16444.        traditional "Steel" look, the surface color is gray.
  16445.        _____________________________________________________________________
  16446.                                         262
  16447.                                    RIP GRAPHICS
  16448.        _____________________________________________________________________
  16449.  
  16450.  
  16451.        -----------------
  16452.        12 - Corner Color
  16453.        -----------------
  16454.  
  16455.        This is the color used to generate a "3-D" look or shadowed look on
  16456.        the corner of the button.
  16457.  
  16458.  
  16459.        ---------------
  16460.        13 - Bevel Size
  16461.        ---------------
  16462.  
  16463.        This is the size, in pixels, of the "beveling" effect created around
  16464.        the surface of the window, if beveling is enabled.  (Beveling makes
  16465.        the window appear to be a raised button rather than a flat feature).
  16466.  
  16467.  
  16468.        ---------------
  16469.        14 - Font Style
  16470.        15 - Font Size
  16471.        ---------------
  16472.  
  16473.        Use these fields to set a font style and size for the window text.
  16474.        Various fonts are available, as defined in the RIP protocol.
  16475.  
  16476.  
  16477.        --------------------------
  16478.        16 - Window Style Switches
  16479.        --------------------------
  16480.  
  16481.        This option leads to an additional screen of yes/no settings:
  16482.  
  16483.             1. Chiseled .. No
  16484.             2. Recessed .. No
  16485.             3. Beveled ... Yes
  16486.             4. Sunken .... No
  16487.  
  16488.        These are various special effects that make a window appear
  16489.        chiseled, recessed, beveled or sunken when selected.
  16490.  
  16491.  
  16492.  
  16493.  
  16494.  
  16495.  
  16496.  
  16497.  
  16498.  
  16499.  
  16500.  
  16501.  
  16502.  
  16503.  
  16504.        _____________________________________________________________________
  16505.                                         263
  16506.                                    RIP GRAPHICS
  16507.        _____________________________________________________________________
  16508.  
  16509.  
  16510.        ----------------
  16511.        Title Attributes
  16512.        ----------------
  16513.  
  16514.        The next major portion of a RIP style is the Title Attributes.
  16515.        Options are:
  16516.  
  16517.              1. Make Title Visible ......... Yes
  16518.              2. Title Position ............. Top Center
  16519.              3. Foreground Color ........... Yellow
  16520.              4. Background Color ........... Black
  16521.              5. Bright Color ............... Black
  16522.              6. Dark Color ................. Black
  16523.              7. Surface Color .............. Green
  16524.              8. Corner Color ............... Black
  16525.              9. Bevel Size ................. 1
  16526.             10. Font Style ................. Default
  16527.             11. Font Size .................. 1
  16528.             12. Title Style Switches [...]
  16529.  
  16530.        Most of the items shown here perform similar functions to the same
  16531.        items listed under Window Attributes, except they apply to the title
  16532.        section of the window, rather than to the window as a whole. Below,
  16533.        we'll list the differences that apply:
  16534.  
  16535.  
  16536.        ----------------------
  16537.        1 - Make Title Visible
  16538.        ----------------------
  16539.  
  16540.        If set to Yes, the title portion of the window appears; if No, then
  16541.        the title is omitted. You can omit the title for menus that don't
  16542.        require it.
  16543.  
  16544.  
  16545.        -------------------------
  16546.        12 - Title Style Switches
  16547.        -------------------------
  16548.  
  16549.        These switches are similar to the Window Style switches, except that
  16550.        they apply to the titlebar, and several new options are available:
  16551.  
  16552.             1. Chiseled ................ No
  16553.             2. Recessed ................ No
  16554.             3. Drop Shadow ............. Yes
  16555.             4. Beveled ................. No
  16556.             5. Adjust Vertical Center .. Yes
  16557.             6. Sunken .................. No
  16558.             7. Left Justify Label ...... No
  16559.             8. Right Justify Label ..... No
  16560.  
  16561.  
  16562.  
  16563.        _____________________________________________________________________
  16564.                                         264
  16565.                                    RIP GRAPHICS
  16566.        _____________________________________________________________________
  16567.  
  16568.  
  16569.        -----------------
  16570.        Button Attributes
  16571.        -----------------
  16572.  
  16573.        These attributes apply to the buttons created within a menu:
  16574.  
  16575.              1. Foreground Color ............ Blue
  16576.              2. Background Color ............ Black
  16577.              3. Bright Color ................ Lt Cyan
  16578.              4. Dark Color .................. Blue
  16579.              5. Surface Color ............... Cyan
  16580.              6. Corner Color ................ Cyan
  16581.              7. Underline Color ............. Red
  16582.              8. Bevel Size .................. 3
  16583.              9. Font Style .................. Default
  16584.             10. Font Size ................... 1
  16585.             11. Orientation ................. Center
  16586.             12. Width ....................... 80
  16587.             13. Height ...................... 25
  16588.             14. Spacing ..................... 25
  16589.             15. Button Style Switches [...]
  16590.  
  16591.  
  16592.        7 - Underline Color
  16593.        -------------------
  16594.  
  16595.        Buttons that are commands feature an underline under the command's
  16596.        keyboard equivalent, where such an equivalent exists. This setting
  16597.        defines the color of the underline.
  16598.  
  16599.  
  16600.        11 - Orientation
  16601.        ----------------
  16602.  
  16603.        This setting describes how the text label is presented within the
  16604.        button:  Centered, left, right, etc.
  16605.  
  16606.  
  16607.        ------------
  16608.        12 - Width
  16609.        13 - Height
  16610.        14 - Spacing
  16611.        ------------
  16612.  
  16613.        These fields define the width and height of buttons, and the spacing
  16614.        between buttons, in pixels. When changing these values, bear in mind
  16615.        that the dimensions of the entire screen are 640 (width) by 350
  16616.        (height). You must ensure that the buttons are large enough to hold
  16617.        the intended commands; otherwise, the commands may overflow the
  16618.        buttons.
  16619.  
  16620.  
  16621.  
  16622.        _____________________________________________________________________
  16623.                                         265
  16624.                                    RIP GRAPHICS
  16625.        _____________________________________________________________________
  16626.  
  16627.  
  16628.        --------------------------
  16629.        15 - Button Style Switches
  16630.        --------------------------
  16631.  
  16632.        The largest number of special visual effects are available for
  16633.        buttons. They include:
  16634.  
  16635.              1. Chiseled ................ No
  16636.              2. Recessed ................ Yes
  16637.              3. Drop Shadow ............. No
  16638.              4. Beveled ................. Yes
  16639.              5. Underline Hotkey ........ No
  16640.              6. Adjust Vertical Center .. No
  16641.              7. Sunken .................. No
  16642.              8. Highlight Hotkey ........ Yes
  16643.              9. Explode ................. No
  16644.             10. Left Justify Label ...... No
  16645.             11. Right Justify Label ..... No
  16646.  
  16647.  
  16648.        ----------------
  16649.        Using RIP Styles
  16650.        ----------------
  16651.  
  16652.        The RIP styles you create apply to two major areas of Searchlight:
  16653.        menus (which are created and maintained in the menu editor portion
  16654.        of the CONFIG program), and built in RIP features. To apply styles
  16655.        to built-in features, use the RIP General Setup menu shown above.
  16656.        For more information about applying styles to user-defined menus,
  16657.        including a "preview" function that lets you see what your styles
  16658.        actually look like, see the section "Menu Editor - Searchlight Menu
  16659.        Editor."
  16660.  
  16661.  
  16662.         -------------------------------------------------------------------
  16663.        | INTERNAL RIP FEATURES                                             |
  16664.         -------------------------------------------------------------------
  16665.  
  16666.        Searchlight provides a host of internal RIP features that are
  16667.        automatically engaged when a caller connects to Searchlight with a
  16668.        RIP compatible terminal. In most cases, the RIP version of a feature
  16669.        contains the same commands as the ANSI version (i.e. the version
  16670.        seen locally or displayed to non-RIP callers), but the screen
  16671.        presentation is enhanced with features like mouse buttons and menus.
  16672.        For example, Searchlight's message reader looks like this in RIP
  16673.        mode:
  16674.  
  16675.  
  16676.  
  16677.  
  16678.  
  16679.  
  16680.  
  16681.        _____________________________________________________________________
  16682.                                         266
  16683.                                    RIP GRAPHICS
  16684.        _____________________________________________________________________
  16685.  
  16686.        Notice the differences between this display and the ANSI
  16687.        representation.  These differences can be summarized into the
  16688.        following categories:
  16689.  
  16690.             * Scroll Bars. The scroll bar to the right of the display
  16691.               allows you to navigate through a long message with your
  16692.               mouse, and also indicates the current cursor position and
  16693.               relative size of the message (by the size of the scroller
  16694.               element). To move the cursor, you can click anywhere on the
  16695.               scrollbar. Below the bar itself are additional controls for
  16696.               page up and down.
  16697.  
  16698.             * Buttons. Functions such as save, quote-text, and abort can be
  16699.               entered by clicking the buttons with your mouse, instead of
  16700.               giving keyboard commands (but the keyboard commands are still
  16701.               available in case you don't have a mouse).
  16702.  
  16703.             * Pop ups and dialog boxes. In many cases, when you're using a
  16704.               full screen display, additional menus or messages "pop up"
  16705.               over the display, as shown here. Select an item from these
  16706.               menus with the mouse or cursor keys. When an item is
  16707.               selected, the pop-up feature disappears and restores the
  16708.               display beneath it.
  16709.  
  16710.        Searchlight uses full screen RIP displays for many internal
  16711.        features, including the message editor, the message browser,
  16712.        conference listings, and bulletins. Although these features are
  16713.        functionally the same as their text equivalents, the graphics
  16714.        representations are more attractive and often more functional,
  16715.        thanks to the mouse support and scroll bars.
  16716.  
  16717.  
  16718.        -----------------------------
  16719.        Customizing Internal Features
  16720.        -----------------------------
  16721.  
  16722.        You can't change the basic look of Searchlight's internal features or
  16723.        add commands to the displays, but you can change the colors in which
  16724.        these features appear, and to some degree the appearance of the text
  16725.        and menus, by assigning a RIP style to each feature under RIP
  16726.        General Setup (as described earlier in this chapter). Note that some
  16727.        changes you may make to a style used for an internal feature -- most
  16728.        notably, font changes -- are overridden by the feature's defaults.
  16729.        This is necessary to maintain correct display formatting.
  16730.  
  16731.  
  16732.  
  16733.  
  16734.  
  16735.  
  16736.  
  16737.  
  16738.  
  16739.  
  16740.        _____________________________________________________________________
  16741.                                         267
  16742.                                    RIP GRAPHICS
  16743.        _____________________________________________________________________
  16744.  
  16745.  
  16746.         -------------------------------------------------------------------
  16747.        | RIP MENUS                                                         |
  16748.         -------------------------------------------------------------------
  16749.  
  16750.        Perhaps the most important RIP feature in Searchlight BBS is its
  16751.        ability to generate RIP representations of user-defined menus
  16752.        created with our menu editing system. In other words, Searchlight
  16753.        takes the menu choices placed on menus by you, and generates its own
  16754.        graphical RIP representation of the menu, complete with a window,
  16755.        mouse buttons, and a title.  You can control the colors, fonts,
  16756.        layout and screen position of the menu through RIP styles and menu
  16757.        options.
  16758.  
  16759.        Notice that Searchlight makes RIP menus "on the fly"*that is, it
  16760.        generates these menus as it executes, which means that menus can
  16761.        have different commands based on user access levels and attributes.
  16762.        And when you add or change commands on a menu, the RIP screens are
  16763.        automatically updated. Since there are no external RIP files, you
  16764.        don't need to manually update a file every time you change a menu.
  16765.  
  16766.  
  16767.        ------------------
  16768.        Creating RIP Menus
  16769.        ------------------
  16770.  
  16771.        As discussed, Searchlight creates RIP menus automatically, and there
  16772.        isn't much else you need to do to have Searchlight create a RIP menu
  16773.        except to create menus as described in our Menu Editing section (see
  16774.        the section "Menu Editor - Searchlight Menu Editor" for more
  16775.        information).  Three fields associated with each menu control how
  16776.        that menu will appear in RIP mode. The are:
  16777.  
  16778.             15. RIP Display Style .......... Steel
  16779.             16. RIP Menu Columns (Novice) .. 2
  16780.             17. RIP Menu Columns (Expert) .. 2
  16781.  
  16782.        RIP Display Style controls how the menu will look -- what colors will
  16783.        be used to draw it, what special effects (like beveling) will be
  16784.        used, and where the menu will appear on screen. Lines 16 and 17
  16785.        control the number of columns that will be used to generate the menu
  16786.        in Novice or Expert mode (Intermediate mode follows the Novice
  16787.        setting).
  16788.  
  16789.        It's easy to describe all the different style settings that are
  16790.        available, but when it comes to actually laying out a menu, you
  16791.        really need to see what the menu will look like. Fortunately,
  16792.        Searchlight provides a RIP preview function that enables you to do
  16793.        so. In fact, you can actually edit your menu and your RIP styles
  16794.        from within the preview mode, making it much easier to actually put
  16795.        a visual representation to all of the different RIP colors and
  16796.        settings.
  16797.  
  16798.  
  16799.        _____________________________________________________________________
  16800.                                         268
  16801.                                    RIP GRAPHICS
  16802.        _____________________________________________________________________
  16803.  
  16804.        To enter RIP preview mode, go to the Menu Editor main screen, place
  16805.        the cursor next to the desired menu, and press F6.  A graphics
  16806.        screen similar to this one will appear:
  16807.  
  16808.                                     <insert image here>
  16809.  
  16810.        Note: You must be running a system with at least EGA graphics
  16811.              capabilities -- preferably with a color CRT -- in order to use
  16812.              this preview mode. Also, you cannot use the preview mode if
  16813.              running the CONFIG program from a remote location.
  16814.  
  16815.        What your screen shows here is a mock-up of what the menu will look
  16816.        like when displayed online to a RIP-compatible caller. You can use
  16817.        this display to judge the general appearance of the menu, colors,
  16818.        and placement of commands and text.
  16819.  
  16820.        Notice that the menu is first displayed in "Novice" mode. To see what
  16821.        it looks like in "Expert" mode, click on the word "Novice" on the
  16822.        status line beneath the menu.
  16823.  
  16824.        If you want to change any aspect of the RIP Style used in the menu,
  16825.        you can do so by clicking on the status line or pressing the
  16826.        following keys:
  16827.  
  16828.                          Key  Description
  16829.                          =================================
  16830.                          F1   Change Window Attributes
  16831.                          F2   Change Window Style Switches
  16832.                          F3   Change Title Attributes
  16833.                          F4   Change Title Style Switches
  16834.                          F5   Change Button Attributes
  16835.                          F6   Change Button Style Switches
  16836.  
  16837.        Bear in mind that when you change any of these settings, you're
  16838.        changing the style associated with the menu, not the menu itself. In
  16839.        other words, any other menus or features that use this style are
  16840.        also affected by the changes.  (See the discussion of RIP styles
  16841.        earlier in this chapter for more information about style editing).
  16842.  
  16843.        Finally, if you want to access the menu's own settings (to change the
  16844.        column placement or style), click on the menu's name in the lower
  16845.        left hand corner of the screen.
  16846.  
  16847.        Note: Searchlight provides a great deal of flexibility in creation
  16848.              of RIP styles and menus. At the same time, it is possible to
  16849.              create settings that don't make sense, either because the
  16850.              text of your selections overflows the size of the menu or
  16851.              buttons or because your menu is too large to fit within the
  16852.              space given. The preview mode will help you make adjustments
  16853.              to your menus visually so that you can design graphics that
  16854.              look and work well for your own needs.
  16855.  
  16856.  
  16857.  
  16858.        _____________________________________________________________________
  16859.                                         269
  16860.                                    RIP GRAPHICS
  16861.        _____________________________________________________________________
  16862.  
  16863.  
  16864.         -------------------------------------------------------------------
  16865.        | EXTERNAL RIP FILES                                                |
  16866.         -------------------------------------------------------------------
  16867.  
  16868.        External RIP files provide the ultimate in design flexibility: they
  16869.        allow you to take any RIP scene or menu that you can create with an
  16870.        external drawing program and use it in your system, typically as a
  16871.        replacement for the built-in menus.  External menus are more
  16872.        flexible because they can contain illustrations and layouts beyond
  16873.        what can be created with our internal RIP styles, but they are also
  16874.        somewhat more difficult to create and maintain since you need to use
  16875.        an external RIP painting program.
  16876.  
  16877.        When RIP mode is enabled, Searchlight searches for text files ending
  16878.        in .RIP instead of .ANS or .TXT. You can make .RIP files for menus,
  16879.        include files, your login and logoff screens, and anywhere else that
  16880.        Searchlight displays a TXT or ANS file. In fact, since RIPscrip is
  16881.        plain text, you can even load RIP graphics into messages. If no RIP
  16882.        file is available for a particular menu or display screen, your
  16883.        existing ANS or TXT file is used instead.
  16884.  
  16885.        Note: You can view RIP files as graphics during a local login only
  16886.              if you enable Searchlight's Local RIP feature by pressing
  16887.              ALT-R at the main menu.
  16888.  
  16889.        Note: If your RIP files use icons, you should tell Searchlight the
  16890.              location of your icon files by filling in the RIP Icons Path
  16891.              in the Config program. For more information, see the section
  16892.              "Configuration - RIP Icons Path."
  16893.  
  16894.  
  16895.        ---------------------------
  16896.        How can I create RIP files?
  16897.        ---------------------------
  16898.  
  16899.        RIP graphics files are created with special programs such as RIPaint
  16900.        and RIPdraw, available from TeleGrafix Inc. They produce text files
  16901.        ending in .RIP, which you can load into your BBS. Searchlight
  16902.        displays the .RIP files instead of text or ANS files when searching
  16903.        for an external text file. Note that you can only use files created
  16904.        with a RIP specific drawing program; you can't use files created
  16905.        with other kinds of drawing programs. For more information about
  16906.        RIPscrip and RIP drawing utilities, check the Telegrafix home page
  16907.        (http://www.telegrafix.com).
  16908.  
  16909.  
  16910.  
  16911.  
  16912.  
  16913.  
  16914.  
  16915.  
  16916.  
  16917.        _____________________________________________________________________
  16918.                                         270
  16919.                                    RIP GRAPHICS
  16920.        _____________________________________________________________________
  16921.  
  16922.  
  16923.        -------------------
  16924.        RIPscrip Guidelines
  16925.        -------------------
  16926.  
  16927.        RIPscrip contains a rich set of commands that can make a RIP terminal
  16928.        display graphics, fonts, change screen sizes, relocate screen
  16929.        windows, and more.  Since Searchlight operates in text mode when it
  16930.        is not displaying a RIP file, RIP files should, in general, avoid
  16931.        using commands that would render Searchlight's text unreadable
  16932.        (unless that effect is desired).  In order to ensure that its text
  16933.        is readable, Searchlight always resets the RIP terminal's text
  16934.        window and font size whenever it clears the screen.
  16935.  
  16936.        RIPscrip files can contain mouse areas and mouse controls in addition
  16937.        to high resolution graphics, icons and other features. Typically,
  16938.        you will use mouse areas in menu display files, and have the mouse
  16939.        areas return a keystroke to Searchlight indicating the correct menu
  16940.        choice. For example, if F is the key to press to enter the files
  16941.        system on your main menu, you could generate a RIPscrip menu with a
  16942.        mouse button for files access; the mouse button would type the
  16943.        letter `F' when pressed.
  16944.  
  16945.        Note that your RIP menus should always send a single character in
  16946.        response to a mouse press. Even when you use the "Word" style menus
  16947.        in Searchlight, it isn't necessary to return an Enter keystroke
  16948.        after the command letter, since Searchlight only requires a single
  16949.        key when displaying a RIP menu.
  16950.  
  16951.        Note: RIP buttons contain an option that allows the act of pushing
  16952.              the button to clear the screen. Don't use this option in your
  16953.              RIP menus with commands that generate pop-up RIP features
  16954.              (like Searchlight's Time or Version command). Since
  16955.              Searchlight expects the screen to remain unchanged after
  16956.              these kinds of commands execute, it doesn't redraw the menu
  16957.              below; clearing the screen will thus destroy the "pop-up" effect.
  16958.  
  16959.        Since Searchlight provides its own mouse support with built in
  16960.        menubar menus, a special command is included in the menu setup
  16961.        screen to disable Searchlight from producing mouse areas for its
  16962.        internal menus:
  16963.  
  16964.             14. Use RIP Mouse Areas .. Yes
  16965.  
  16966.        Set this option to "No" if you are using RIPscrip files to generate
  16967.        your own menus with mouse areas. Otherwise, leave it set to "Yes".
  16968.        The "No" setting prevents Searchlight from interfering with mouse
  16969.        areas that may have been created by your external RIPscrip file.
  16970.  
  16971.  
  16972.  
  16973.  
  16974.  
  16975.  
  16976.        _____________________________________________________________________
  16977.                                         271
  16978.                                    RIP GRAPHICS
  16979.        _____________________________________________________________________
  16980.  
  16981.  
  16982.        ---------
  16983.        Wallpaper
  16984.        ---------
  16985.  
  16986.        Searchlight contains a unique feature that lets you combine the
  16987.        built-in RIP menu feature with external files -- we call it the
  16988.        "wallpaper" feature. What it allows you to do is take an external
  16989.        RIP file that contains drawings, but no mouse buttons, and use it as
  16990.        a background image over which Searchlight will display one of its
  16991.        built-in RIP menu representations. The wallpaper feature gives you
  16992.        the best of both worlds: you can design any kind of illustration
  16993.        with a RIP painting program, but still have Searchlight control the
  16994.        actual commands and mouse areas. Since Searchlight controls the
  16995.        commands, the actual menu can dynamically adapt itself to changes in
  16996.        access levels and attributes or changes in the Searchlight menu file
  16997.        itself.
  16998.  
  16999.        To use the wallpaper feature, create (or obtain) a RIP file that
  17000.        you'd like to use as background material, and place in the "Text"
  17001.        file directory in your system. Next, edit the menu in question. In
  17002.        the field marked "Display Filename (Optional)", enter the name of
  17003.        the wallpaper file using this syntax:
  17004.  
  17005.             4. Display Filename (Optional) .. @!MYFILE
  17006.  
  17007.        Notice the special "@!" syntax: this tells Searchlight that the file
  17008.        is a wallpaper file (otherwise, Searchlight would assume the file
  17009.        was a complete menu, and would not generate its own RIP menu).
  17010.        Searchlight displays the wallpaper file first, then draws its
  17011.        "default" menu on top.
  17012.  
  17013.        You may wish to disable the RIP window and title when using the
  17014.        wallpaper feature (you can disable them by editing the style
  17015.        associated with the menu). Without a window and title, Searchlight
  17016.        simply draws buttons over the wallpaper* which can make the buttons
  17017.        look more like an integral part of the picture.
  17018.  
  17019.        One final note: you can add a wallpaper file to a menu without
  17020.        destroying an existing ANSI or ASCII text screen. Just place the
  17021.        @!FILE after the existing ANSI filename on line 4, separated by a
  17022.        space:
  17023.  
  17024.             4. Display Filename (Optional) .. @ANSI @!RIP
  17025.  
  17026.  
  17027.        --------------------------------
  17028.        Wallpaper with Internal Features
  17029.        --------------------------------
  17030.  
  17031.        A number of Searchlight's internal RIP features can also have
  17032.        wallpaper files. When these files exist, Searchlight displays the
  17033.        file behind the indicated feature. In most cases, only the outer
  17034.  
  17035.        _____________________________________________________________________
  17036.                                         272
  17037.                                    RIP GRAPHICS
  17038.        _____________________________________________________________________
  17039.  
  17040.        edge of your wallpaper file will be visible, so design these files
  17041.        appropriately.
  17042.  
  17043.        Wallpaper files for internal features are defined simply by creating
  17044.        RIP files with fixed names, as defined below. These files should be
  17045.        located in your Text directory:
  17046.  
  17047.         Filename      Description
  17048.         ====================================================================
  17049.         CHATWALL.RIP  Defines a wallpaper behind the Sysop split screen chat
  17050.                       (ALT-C) feature.
  17051.         EDITWALL.RIP  Defines a wallpaper file behind the text editor screen
  17052.         READWALL.RIP  Defines wallpaper behind the RIP text reader (when
  17053.                       reading messages, bulletins or email).
  17054.         FILEWALL.RIP  Defines wallpaper for the RIP file browser screens.
  17055.         SCANWALL.RIP  Defines wallpaper for the RIP message browser screens
  17056.                       (Scan and Mail/List commands).
  17057.  
  17058.  
  17059.        --------------------------------
  17060.        Wallpaper with Internal Commands
  17061.        --------------------------------
  17062.  
  17063.        You can assign RIP wallpaper to any internal command by using the
  17064.        global command parameter /W followed by a wallpaper filename (the
  17065.        file must exist in your text directory). For example, if you wanted
  17066.        to assign the file "mywall.rip" as wallpaper for your bulletins
  17067.        command, the internal command would look like this:
  17068.  
  17069.             6. Command Number (1) ...... 106
  17070.             7. Command Parameters (1) .. /x /wMYWALL
  17071.  
  17072.        Assuming the file "mywall.rip" exists in your text directory,
  17073.        Searchlight displays it as the background over which it draws the
  17074.        bulletins picklist.  You can use the same syntax with any internal
  17075.        command number. Wallpaper is valid only in RIP mode; in non-RIP
  17076.        modes, Searchlight ignores /W.
  17077.  
  17078.  
  17079.         -------------------------------------------------------------------
  17080.        | RIPSCRIP 2.X FEATURES                                             |
  17081.         -------------------------------------------------------------------
  17082.  
  17083.        Searchlight is compatible with both RIPterm 1.54 and the newer
  17084.        RIPterm 2.x and 3.x specifications. Newer versions of RIP provide
  17085.        better support for graphical user interfaces and sound, including
  17086.        bitmapped images and audio.
  17087.  
  17088.        Searchlight's local RIP emulation is not compatible with RIPterm 2 at
  17089.        this time. Hence, RIP 2.0 features such as sounds and photos are
  17090.        only available when connecting to Searchlight BBS from a remote
  17091.        terminal using RIPterm 2.x, and are not available during a local
  17092.        login.
  17093.  
  17094.        _____________________________________________________________________
  17095.                                         273
  17096.                                    RIP GRAPHICS
  17097.        _____________________________________________________________________
  17098.  
  17099.  
  17100.        ----------------------
  17101.        RIP 2.0 File Extension
  17102.        ----------------------
  17103.  
  17104.        Searchlight supports an additional text file extension, .RP2, for RIP
  17105.        2.x files. You can use this extension any time you wish to have
  17106.        separate RIP files for RIPterm 1.54 and RIPterm 2.x callers; for
  17107.        example, LOGIN.RIP and LOGIN.RP2. It can also be used on menu files,
  17108.        text files displayed via command 160, etc. Note that it is not
  17109.        necessary to supply a .RP2 version of all existing .RIP files;
  17110.        Searchlight will display a .RIP file to RIPterm 2.x callers if an
  17111.        .RP2 version is not available. (You can also use the "Minimum RIP
  17112.        version" attribute of menus to have RIP 2.x callers branch to a
  17113.        different menu tree, if you have extensive alternatives for RIP 2.x
  17114.        callers; see below for details).
  17115.  
  17116.        Note: IMPORTANT: JPEG, WAV and BMP files are NOT Rip 2.x files! You
  17117.              should never use a .RP2 or .RIP extension on a JPEG, WAV or
  17118.              BMP file and you should never place such a file in your
  17119.              "Text" directory. To use such files, you must create a RIP
  17120.              file with the appropriate RIPscrip editor.
  17121.  
  17122.  
  17123.        -------------------------
  17124.        Automatic RIP Downloading
  17125.        -------------------------
  17126.  
  17127.        Searchlight can automatically download RIP files to the user's
  17128.        terminal. Once the file is downloaded, a short command sequence is
  17129.        issued that causes the terminal to display the file from local
  17130.        storage. This scheme can vastly reduce the time it takes to display
  17131.        RIP menus and other RIP files, especially when the RIP file is
  17132.        large.
  17133.  
  17134.        Automatic RIP downloading applies to RIP files you use as menus and
  17135.        wallpaper, RIP files uses with internal command 160, and your login
  17136.        and logoff screens. It also applies to all RIP 2.x multimedia
  17137.        objects (BMP, JPG and WAV files).  Searchlight does not download RIP
  17138.        files that are viewed from a file directory or included in messages.
  17139.        Any icon files that are contained within a RIP screen are also
  17140.        autodownloaded if the caller doesn't already have the icon (for this
  17141.        feature to work, you must be sure that your icon files are available
  17142.        in the "Icons Path" defined for your system).
  17143.  
  17144.        By default, RIP autodownloading is enabled. When a caller connects in
  17145.        RIP mode, Searchlight issues a file query before it displays each
  17146.        RIP screen. If the caller does not already have the current version
  17147.        of the file, it is automatically downloaded. You may wish to post a
  17148.        bulletin about the auto download process so that your RIP callers
  17149.        understand what is happening.
  17150.  
  17151.  
  17152.  
  17153.        _____________________________________________________________________
  17154.                                         274
  17155.                                    RIP GRAPHICS
  17156.        _____________________________________________________________________
  17157.  
  17158.        There are several ways that the auto download feature can be
  17159.        disabled:
  17160.  
  17161.             * You can permanently disable it for your entire system by
  17162.               toggling the "Auto RIP/ICN Downloading" switch in the Config
  17163.               program (located under "RIP General Settings").
  17164.  
  17165.             * Each caller can disable autodownloading for their account by
  17166.               toggling the "Download RIP Menus" switch in their
  17167.               Options/Preference screen.
  17168.  
  17169.             * Searchlight automatically disables autodownloading for the
  17170.               current call if a download fails, or if it detects that the
  17171.               caller's terminal is not compatible with the autodownloading
  17172.               feature. A few RIP compatible terminals, such as Qmodem Pro
  17173.               for Windows, are incompatible with this feature.
  17174.  
  17175.        You can also prevent individual RIP files from being autodownloaded.
  17176.        You may wish to do this if you use a particular RIP file that is
  17177.        small or one which is frequently updated. It is also necessary to
  17178.        disable autodownloading if a RIP file contains a macro character
  17179.        (like \%N for the current user's name).
  17180.  
  17181.             * For internal command #160, place a /N switch on the command
  17182.               line after the filename to prevent the file from being
  17183.               downloaded.
  17184.  
  17185.             * For menus, there is an "Auto RIP/ICN Download" switch on each
  17186.               menu. If you set this switch to No, Searchlight will not
  17187.               autodownload the RIP file associated with the menu.
  17188.  
  17189.        Searchlight downloads menu and wallpaper files using whatever
  17190.        filenames your system uses for these files. Your login and logoff
  17191.        screens are renamed to a name that includes your Searchlight BBS
  17192.        serial number. This is done so that callers who call multiple
  17193.        Searchlight systems can maintain separate login and logoff screens
  17194.        for each system.
  17195.  
  17196.        Searchlight can detect when you change a RIP file, and download a new
  17197.        version to your callers. This detection is triggered whenever a RIP
  17198.        file's date, time or size changes. If you update icon files used
  17199.        within a RIP file, you should also update the RIP files that contain
  17200.        them, to be sure that Searchlight automatically updates your
  17201.        callers' icons.
  17202.  
  17203.        The RIP autodownloading feature supports RIP 2.x multimedia objects,
  17204.        including Jpeg images, bitmap images (BMP files) and audio (WAV
  17205.        files). If your RIP screens include these features, place your JPG,
  17206.        BMP and WAV files in your Icons directory; Searchlight will
  17207.        autodownload these files to callers who connect with RIPterm 2.x.
  17208.        (RIP 1.54 callers will not receive the RIP 2.x objects). Note: As
  17209.        with icon files, if you update a JPG, BMP or WAV file, you should
  17210.        also update the RIP file containing the object in order to ensure
  17211.        that your callers automatically receive the updated file.
  17212.        _____________________________________________________________________
  17213.                                         275
  17214.                                    RIP GRAPHICS
  17215.        _____________________________________________________________________
  17216.  
  17217.  
  17218.        ------------------
  17219.        Sound/JPEG Support
  17220.        ------------------
  17221.  
  17222.        Searchlight implements internal commands for displaying JPEG and WAV
  17223.        (sound) files directly in RIP 2.x mode. The command to display a
  17224.        JPEG file is 161; place the full path to the JPEG file on the
  17225.        parameter line. For example:
  17226.  
  17227.             6. Command Number (1) ...... 161
  17228.             7. Command Parameters (1) .. c:\pics\mypic.jpg /p
  17229.  
  17230.        This command checks to see if the caller's hard disk contains a
  17231.        current version of the file MYPIC.JPG. If it does, the file is
  17232.        displayed. If not, Searchlight downloads the file to the caller
  17233.        automatically, and then displays it. Note the use of the /P switch
  17234.        to provide a pause (Ok box) after the picture is displayed. You can
  17235.        omit the /P if you don't need the pause.
  17236.  
  17237.        Command 162 is similar to command 161, except that it is used to play
  17238.        a sound file (which must be in the WAV file format). For example:
  17239.  
  17240.             6. Command Number (1) ...... 162
  17241.             7. Command Parameters (1) .. c:\sounds\hello.wav
  17242.  
  17243.        Since RIPterm 2.x can play audio files in the background, there is
  17244.        normally no need to pause after a sound command.
  17245.  
  17246.        Callers can also view JPEG and WAV files with the "View" command in
  17247.        the file browser. In other words, if "View" is selected while the
  17248.        highlight bar is on a JPEG or WAV file, Searchlight displays the
  17249.        picture or plays the WAV file, downloading it first if necessary.
  17250.  
  17251.        RIP files themselves can also contain references to JPEG images and
  17252.        sounds.  Use a RIP file editor, like RIPaint, to create RIP files
  17253.        with these multimedia features.
  17254.  
  17255.  
  17256.        -------------
  17257.        System Sounds
  17258.        -------------
  17259.  
  17260.        In addition to command 162, Searchlight lets you associate a sound
  17261.        file (.WAV file) with any of ten different system events, as well as
  17262.        with any menu.
  17263.  
  17264.        To add a sound to a menu, edit the desired menu and access the "RIP
  17265.        Graphics Features". Then enter the name of your sound file in line
  17266.        7. You should not type the `.WAV' file extension; just type the
  17267.        filename. The actual .WAV file should be placed in your RIP Icons
  17268.        directory. When a .WAV file is associated with a menu in this
  17269.        manner, Searchlight plays the sound each time that menu is
  17270.  
  17271.        _____________________________________________________________________
  17272.                                         276
  17273.                                    RIP GRAPHICS
  17274.        _____________________________________________________________________
  17275.  
  17276.        activated, autodownloading your sound file to the caller if he or she
  17277.        does not already have a copy.
  17278.  
  17279.        You can also program sounds for several system events, including
  17280.        login, logoff, file transfers, etc. The configuration for sound
  17281.        events is located in the General Configuration section of the Config
  17282.        program under "RIP Sounds Setup". The available events include:
  17283.  
  17284.         Sound                 Description
  17285.         ====================================================================
  17286.         Login Sound            Played in conjunction with your login screen
  17287.         Logoff Sound           Played in conjunction with your logoff screen
  17288.         Successful Download    Played after a successful file download
  17289.         Successful Upload      Played after a successful file upload
  17290.         Failed Download        Played if a download fails
  17291.         Failed Upload          Played if an upload fails
  17292.         Save Public Message    Played anytime a caller posts a conference
  17293.                                message
  17294.         Send Email             Played anytime a caller saves a private email
  17295.                                message
  17296.         Received New Mail      Played with the Mail Check command if new
  17297.                                mail is found
  17298.         Received Chat Message  Played when you receive a chat message online
  17299.  
  17300.        As with menu sounds, you should enter the desired sound filename
  17301.        without the .WAV extension, and place the actual .WAV file in your
  17302.        Icons path.
  17303.  
  17304.  
  17305.  
  17306.  
  17307.  
  17308.  
  17309.  
  17310.  
  17311.  
  17312.  
  17313.  
  17314.  
  17315.  
  17316.  
  17317.  
  17318.  
  17319.  
  17320.  
  17321.  
  17322.  
  17323.  
  17324.  
  17325.  
  17326.  
  17327.  
  17328.  
  17329.  
  17330.        _____________________________________________________________________
  17331.                                         277
  17332.                                   USING DESQVIEW
  17333.        _____________________________________________________________________
  17334.  
  17335.  
  17336.         -------------------------------------------------------------------
  17337.        | USING SEARCHLIGHT WITH DESQVIEW                                   |
  17338.         -------------------------------------------------------------------
  17339.  
  17340.        ------------
  17341.        Introduction
  17342.        ------------
  17343.  
  17344.        DESQview/386 is the multitasker of choice for use with the DOS
  17345.        version of Searchlight BBS, due to its low overhead and efficiency
  17346.        when running DOS based communications programs. By running DESQview
  17347.        on your 386, 486 or Pentium PC, you'll be able to have multiple
  17348.        Searchlight nodes active at the same time, allowing your BBS to
  17349.        support multiple incoming telephone lines and providing you with a
  17350.        means of logging in locally while keeping your incoming lines
  17351.        active.
  17352.  
  17353.        The following remarks will help you to set up an effective multiline
  17354.        Searchlight BBS system on a PC with at least 2 megabytes of memory.
  17355.        This is not an exhaustive review of DESQview's features, so please
  17356.        read your DV manual, especially the sections on memory usage and
  17357.        configuration, in order to get the most out of it.
  17358.  
  17359.        Note: If you run Windows 95 or Windows NT, you don't need DESQview to
  17360.              run a multinode BBS. Instead, run the native Windows version of
  17361.              Searchlight, which takes advantage of Windows' built-in
  17362.              multitasking and multithreading features.
  17363.  
  17364.  
  17365.        -----------------
  17366.        Environment Setup
  17367.        -----------------
  17368.  
  17369.        Before installing DESQview, it is best to remove any programs that
  17370.        use serial ports, especially serial mouse drivers. Even if your
  17371.        mouse uses COM3 or COM4, it can interfere with modems connected to
  17372.        COM1 and COM2.
  17373.  
  17374.        Make sure your Searchlight nodes are set up as explained in the
  17375.        Multinode Setup portion of this manual (see the section
  17376.        "Configuration - Multinode Setup").  Note the locations of your
  17377.        CONFIG files for reference while setting up DESQview.
  17378.  
  17379.  
  17380.        -------------------
  17381.        Hardware Interrupts
  17382.        -------------------
  17383.  
  17384.        Interrupts are an important issue whenever 3 or more remote nodes
  17385.        are configured for use on one machine. The standard IBM PC has only
  17386.        2 interrupts allocated for communications ports (COM1 and COM2,
  17387.  
  17388.  
  17389.        _____________________________________________________________________
  17390.                                         278
  17391.                                   USING DESQVIEW
  17392.        _____________________________________________________________________
  17393.  
  17394.        which use interrupts 4 and 3 respectively). In many cases, hardware
  17395.        adapters which support COM3 and COM4 simply re-use these interrupt
  17396.        lines, making those ports unsuitable for use in a multitasking
  17397.        environment.
  17398.  
  17399.        What you need is an adapter that's capable of selecting an alternate
  17400.        interrupt number, such as 2, 5 or 7. The Everex Magic I/O is one
  17401.        such adapter that's suitable for use with Searchlight. You can also
  17402.        overcome the two-port limitation by means of an intelligent
  17403.        DigiBoard hardware product; DigiBoards work with their own on-board
  17404.        processors instead of interrupts, and are ideal for large
  17405.        installations. See Appendix H of this manual for more information on
  17406.        DigiBoard installation.
  17407.  
  17408.        Local nodes which do not use a modem or an interrupt line require no
  17409.        special treatment.
  17410.  
  17411.  
  17412.        --------------
  17413.        DESQview Setup
  17414.        --------------
  17415.  
  17416.        Access the DESQview setup program by typing `Setup' from the DV
  17417.        directory.  Select the advanced options. Of interest are the mouse
  17418.        and performance setup sections.
  17419.  
  17420.        Mouse: If you have a serial mouse, you may not be able to use it
  17421.        with DESQview since you will probably want to use your available
  17422.        serial ports and interrupts for Searchlight. A bus mouse can be used
  17423.        if available, as long as the bus mouse adapter does not use
  17424.        interrupts which you may need for COM ports other than COM1 and COM2
  17425.        (on systems running 3 or more lines).
  17426.  
  17427.        Performance: We recommend you allocate between 1 and 4 clock cycles
  17428.        for foreground and background tasks. More cycles may increase
  17429.        efficiency, but also increase "choppiness". Fewer cycles reduce
  17430.        choppiness but decrease overall throughput. It is generally best to
  17431.        use the same value for foreground and background.
  17432.  
  17433.        The more nodes you install, the smaller you should make the
  17434.        performance numbers. On a 10 node system, we recommend using 1 or 2
  17435.        clock ticks.
  17436.  
  17437.        Select "Yes" for "Optimize Communications". This will give you
  17438.        better performance for the BBS nodes.
  17439.  
  17440.        Select "No" for "Allow Swapping of Programs". Since communications
  17441.        programs are interrupt driven, they cannot be swapped to disk.
  17442.        Assuming you are interested primarily in running Searchlight,
  17443.        swapping can be turned off.  (Note: When FOSSIL drivers or
  17444.        DigiBoards are used, it becomes possible to swap Searchlight in and
  17445.        out of memory. However, the performance penalty for doing so is
  17446.        usually too large to make swapping a practical option. If your
  17447.  
  17448.        _____________________________________________________________________
  17449.                                         279
  17450.                                   USING DESQVIEW
  17451.        _____________________________________________________________________
  17452.  
  17453.        computer is a `286, you may want to experiment with this option if
  17454.        you need to run more than 2 nodes).
  17455.  
  17456.  
  17457.        -------------
  17458.        Program Setup
  17459.        -------------
  17460.  
  17461.        Set up each Searchlight BBS node as a separate entry in DESQview,
  17462.        using DESQview's Add Program feature.  DESQview presents a menu of
  17463.        Basic options as you create each entry, and provides Advanced
  17464.        options by pressing the F1 Key.
  17465.  
  17466.        Basic options should be configured as follows:
  17467.  
  17468.        Memory: Try to allocate at least 450K per node. You can use a minimum
  17469.        of 400K if necessary, but performance is somewhat better with more
  17470.        memory available.  Watch out for "out of memory" errors (code 202
  17471.        and 203) if you allocate too little RAM.
  17472.  
  17473.        Program: Specify SLBBS.EXE as the program to run. If necessary, give
  17474.        the full pathname (such as C:\SLBBS\SLBBS.EXE).
  17475.  
  17476.        Directory: Give the home directory for that node (location of the
  17477.        CONFIG.SL2 file). Make sure each node has a separate home directory.
  17478.  
  17479.        Writes Text Directly to Screen: N
  17480.  
  17481.        Make sure all nodes are configured for BIOS screen writes. This will
  17482.        allow Searchlight to run in the background and in small windows
  17483.        under DV. On 386 PCs, direct screen writes can be used as long as
  17484.        you tell DESQview to Virtualize Text.
  17485.  
  17486.        Displays Graphics Information: N
  17487.        Virtualize Text/Graphics: N
  17488.  
  17489.        Choose "N" if you have Searchlight configured for BIOS operation. If
  17490.        you prefer to configure Searchlight for direct screen writes, you
  17491.        should enter "T" here.
  17492.  
  17493.        If you want to use Searchlight's local RIP graphics mode in a window,
  17494.        you must specify Y for both these options.  However, it is not
  17495.        recommended that you use local RIP in a DESQview window, due to the
  17496.        memory overhead.
  17497.  
  17498.        Uses Serial Ports: 1,2 or Y
  17499.  
  17500.        For each node, give the serial port (1 or 2) which that node will
  17501.        use. If the node uses a standard serial port other than COM1 or
  17502.        COM2, specify "Y" for this option. On nodes that use external
  17503.        drivers (i.e. DigiBoard or FOSSIL drivers) this setting is
  17504.        unimportant.
  17505.  
  17506.  
  17507.        _____________________________________________________________________
  17508.                                         280
  17509.                                   USING DESQVIEW
  17510.        _____________________________________________________________________
  17511.  
  17512.        Requires Floppy Diskette: N
  17513.  
  17514.        After configuring the Basic options, press F1 to access the
  17515.        "Advanced Options" screen. Of the fields on this screen, the
  17516.        majority should be left in the default state. Below are the fields
  17517.        that apply to Searchlight, and the recommended values for each:
  17518.  
  17519.        Can Be Swapped Out: N
  17520.  
  17521.        Interrupt driven communications programs should remain in memory at
  17522.        all times. Swapping is possible if you use a DigiBoard or FOSSIL
  17523.        driver, but is impractical; see note above.
  17524.  
  17525.        Uses Its Own Colors: Y
  17526.  
  17527.        Searchlight uses its own display colors.
  17528.  
  17529.        Runs in Background: Y
  17530.        Share CPU when Foreground: Y
  17531.  
  17532.        These options will allow you to multitask and run all nodes at the
  17533.        same time.
  17534.  
  17535.        Uses Math Coprocessor: N
  17536.        Share EGA When Foreground/Zoomed: N
  17537.  
  17538.        Check your DESQview manual for more information about the other
  17539.        options that are displayed.
  17540.  
  17541.  
  17542.        -------------
  17543.        Memory Issues
  17544.        -------------
  17545.  
  17546.        Searchlight is one of the most memory-efficient programs you'll find
  17547.        in the BBS environment. With low memory requirements, it's designed
  17548.        to run effectively in small DESQview windows.
  17549.  
  17550.        However, you may find that Door programs, front end mailers,
  17551.        utilities, and programs you run as events may require more memory
  17552.        than Searchlight. Since Searchlight requires about 75K for its
  17553.        in-memory kernel when executing a Door program, external protocol,
  17554.        or event, the actual amount of RAM available to those programs will
  17555.        be equal to the size of the DESQview window minus 75K, minus any RAM
  17556.        resident programs that might reside in that window (such as DVANSI
  17557.        or a front end mailer).
  17558.  
  17559.        DESQview is capable of running programs in extended memory (which is
  17560.        actually converted to expanded memory by QEMM). That means that with
  17561.        a 386 or better, you can increase the amount of RAM available to
  17562.        your windows simply by purchasing more system RAM for your computer.
  17563.        DESQview 386 automatically makes the RAM available and can open
  17564.        windows of up to about 600K in size.  The only limitation is that
  17565.  
  17566.        _____________________________________________________________________
  17567.                                         281
  17568.                                   USING DESQVIEW
  17569.        _____________________________________________________________________
  17570.  
  17571.        DESQview cannot overlap any of your base 640K ram with expanded
  17572.        memory. That means that your first 640K of memory can be used to run
  17573.        either two very small windows, or one large window, or a combination
  17574.        of a large window and a memory resident program (like a RAMdisk or
  17575.        disk cache). Use DESQview's Memory Status (MS) program to assess
  17576.        your system's available RAM.
  17577.  
  17578.  
  17579.        ------------------
  17580.        Performance Issues
  17581.        ------------------
  17582.  
  17583.        The more RAM that's available in your system, the better performance
  17584.        you can get out of Searchlight BBS. But just having the RAM
  17585.        available isn't enough.  There are three main ways to use additional
  17586.        RAM memory on your system wisely, and each can dramatically improve
  17587.        the speed of your BBS.
  17588.  
  17589.             * Allocate more RAM to Searchlight and increase the size of the
  17590.               overlay buffer. When Searchlight is given more than its
  17591.               minimum RAM requirement, it keeps frequently needed file
  17592.               information in memory and builds tables and buffers that help
  17593.               reduce the number of disk accesses required for many
  17594.               operations. Additionally, more DOS memory means you can
  17595.               increase the size of your overlay buffer, which decreases the
  17596.               amount of disk reads Searchlight needs to perform as it runs.
  17597.               Searchlight can profitably use approximately 70-80K of memory
  17598.               above its minimum requirement. Beyond that amount, the memory
  17599.               will be wasted unless you need it for doors or events.
  17600.  
  17601.             * Use a RAM cache and allocate as much memory to it as
  17602.               possible. RAM cache software is by far the most valuable
  17603.               utility you can add to your system. Even the smallest disk
  17604.               caches will improve performance a great deal; the larger the
  17605.               buffer, the fewer disk reads that need to be performed, and
  17606.               the faster your system will run.  Cache software with a
  17607.               buffered (staged) write mode is ideal for use with
  17608.               Searchlight, and will speed up your system even more.
  17609.  
  17610.               Always use expanded memory, not extended memory, with disk
  17611.               cache and RAM disk software. It is best to avoid the use of
  17612.               extended memory entirely, except for running DESQview itself.
  17613.               That's because the procedure that is required for the CPU to
  17614.               access extended memory can cause it to lose track of pending
  17615.               interrupts, and thus pending data coming in from the serial
  17616.               ports.
  17617.  
  17618.             * Install a RAM disk and use it to store frequently used files,
  17619.               such as Searchlight's EXE and OVR files. When storing
  17620.               Searchlight files on a RAM disk, be sure to update the data
  17621.               path lines in your CONFIG files to reflect the new
  17622.               drive/directory paths. Don't store data files (files that are
  17623.               written to and change during the program's execution) on RAM
  17624.               disks.
  17625.        _____________________________________________________________________
  17626.                                         282
  17627.                                   USING DESQVIEW
  17628.        _____________________________________________________________________
  17629.  
  17630.  
  17631.               The recommended files for RAM disk storage are DEFAULT.LNG,
  17632.               CHAT.SL2, BBS.EXE and BBS.OVR, and the menu (*.MNU) files.
  17633.               Note that if your overlay (OVR) file is on RAM disk, it's
  17634.               generally not necessary to load it into EMS memory, since
  17635.               disk access from a RAM disk is nearly as fast.
  17636.  
  17637.  
  17638.        -----------
  17639.        Fine Tuning
  17640.        -----------
  17641.  
  17642.        Best efficiency can be obtained if you use Searchlight's modem
  17643.        output buffering (Output Buffering Factor = 32) on all nodes. Output
  17644.        buffering lets Searchlight dump output into a holding area in RAM,
  17645.        which is then spooled out to the modem as a background task. The
  17646.        spooling takes place as an interrupt and is more or less independent
  17647.        of DESQview's task switching. When using more than 2 nodes, we
  17648.        recommend an intelligent DigiBoard hardware device for
  17649.        communications. See Appendix H for more information.
  17650.  
  17651.        When you watch Searchlight locally, the output may appear "choppy" on
  17652.        screen; that is, it will start, stop, then start again, etc.
  17653.        However, the remote user will see a much smoother, steady flow of
  17654.        characters, especially at lower baud rates (2400 baud and below). So
  17655.        you should be aware that even if you see a choppy, hesitant display
  17656.        at your end, it does not mean your users are seeing the same thing.
  17657.        Either ask your users, or log in from a remote terminal yourself, to
  17658.        see the difference.
  17659.  
  17660.        Set "Buffer Door Programs" to Yes, for best performance when running
  17661.        doors.  Should incompatibilities or system errors arise when running
  17662.        Door programs, disable output buffering by setting this option back
  17663.        to No.
  17664.  
  17665.        If you use a high speed modem on one node and a slower modem on the
  17666.        other, you may want to adjust the performance (clock cycles) and
  17667.        allocate more CPU time to the quicker modem.
  17668.  
  17669.        ASCII uploading to the message editor places the largest load on the
  17670.        system in terms of input and output. That's because Searchlight
  17671.        echoes characters as they are typed, thus creating a two way flow of
  17672.        information. We recommend using Xmodem or Zmodem protocol uploads if
  17673.        ASCII uploads present a problem.
  17674.  
  17675.        Many RS232 ports are not designed for speeds greater than 9600 baud.
  17676.        If you plan to use high speed modems, you may want to purchase high
  17677.        speed UART chips (16550 chips). Note that the speed of output is
  17678.        also dependent upon your CPU speed. Slow computers may not be able
  17679.        to provide maximum throughput, regardless of the UART chips used.
  17680.  
  17681.  
  17682.  
  17683.  
  17684.        _____________________________________________________________________
  17685.                                         283
  17686.                         APPENDIX A: USING THE ACTIVITY LOG
  17687.        _____________________________________________________________________
  17688.  
  17689.  
  17690.         -------------------------------------------------------------------
  17691.        | APPENDIX A: USING THE ACTIVITY LOG                                |
  17692.         -------------------------------------------------------------------
  17693.  
  17694.        Searchlight can be configured to generate a continuous record of 12
  17695.        different system events. The activity log gives you a record of
  17696.        system events and you can analyze your log file with database tools
  17697.        to produce graphs or summaries of your system's activity.
  17698.  
  17699.        Searchlight uses a DBase III database file (DBF file) called
  17700.        SYSLOG.DBF to log system activity. A single SYSLOG.DBF file, located
  17701.        in the main directory for your primary node, is used to log all
  17702.        activity from all nodes. In addition, the file format allows third
  17703.        party applications to use the SYSLOG.DBF file if desired.
  17704.  
  17705.        This chapter describes the general format of the SYSLOG.DBF file, the
  17706.        format of individual events logged by Searchlight BBS, and covers
  17707.        the use of the LOGDUMP.EXE command for retrieving information from
  17708.        the log file in a plain text format.
  17709.  
  17710.  
  17711.        -----------------
  17712.        SYSLOG.DBF Format
  17713.        -----------------
  17714.  
  17715.        SYSLOG.DBF is a standard DBase III database file; each record
  17716.        contains 11 data fields. This chart shows the name, type, size, and
  17717.        contents of each field:
  17718.  
  17719.          Label    Type  Size  Description
  17720.          ==================================================================
  17721.          PROGID    C     8    The name of the program that logged the event
  17722.          USER      C     25   The name of the current user
  17723.          NODE      C     4    The node number (right-justified text)
  17724.          DATE      D     8    Date, in the format YYYYMMDD  (i.e. 19950415)
  17725.          TIME      C     5    Time, in 24 hour HH:MM format  (i.e. 18:45)
  17726.          RES1      C     4    Reserved for future use
  17727.          RES2      C     4    Reserved for future use
  17728.          RES3      C     4    Reserved for future use
  17729.          RES4      C     4    Reserved for future use
  17730.          ACTION    C     1    One-character "action" code
  17731.          MSG       C     60   Message describing what happened
  17732.  
  17733.        Most of these fields are self-explanatory. The PROGID field is used
  17734.        to store the name of the program which generated the event; in the
  17735.        case of Searchlight, this can either be LOGIN for events generated
  17736.        by the Login program, or BBS for events generated from the main
  17737.        program. Third party programs which wish to log events can do so by
  17738.        placing their own program ID name in this field.
  17739.  
  17740.  
  17741.  
  17742.  
  17743.        _____________________________________________________________________
  17744.                                         284
  17745.                         APPENDIX A: USING THE ACTIVITY LOG
  17746.        _____________________________________________________________________
  17747.  
  17748.        In order to help categorize events, an event is described by using
  17749.        both a one-character "Action" code, and a 60 character description.
  17750.        The action codes help you when you wish to examine all the events of
  17751.        a particular type.  Searchlight currently uses the following action
  17752.        codes:
  17753.  
  17754.                   Code  Description
  17755.                   ==============================================
  17756.                    !    Error
  17757.                    N    New User Login
  17758.                    O    Login by Existing User
  17759.                    F    Logoff or System Reset
  17760.                    U    File Upload
  17761.                    D    File Download
  17762.                    M    User entered a menu
  17763.                    X    User executed a command on a menu
  17764.                    S    User saved a message
  17765.                    J    User jumped to a conference or file area
  17766.                    G    User downloaded a message
  17767.                    Q    QWK Mail event
  17768.                    C    Custom Message (user defined log entry)
  17769.  
  17770.        Other programs which use the system log should use their own codes to
  17771.        log events separate from these.
  17772.  
  17773.        The SYSLOG.DBF file was designed to be used with a database program
  17774.        that supports the Dbase file format, such as Dbase, Paradox, Foxpro
  17775.        or Access.  Most other database utilities can also read or import
  17776.        Dbase format. Using a database program, you can view your system
  17777.        activity, sort the records, and create queries, summary reports,
  17778.        graphs, etc.
  17779.  
  17780.        Note that the above chart is not the literal file format of a
  17781.        SYSLOG.DBF file. All DBF files contain standard header information
  17782.        as defined in the industry standard DBF format. If you wish to write
  17783.        programs that deal with the SYSLOG.DBF file, you should use a file
  17784.        access library that understands the DBF file format. Alternately,
  17785.        use the LOGDUMP utility program (described below) to create a text
  17786.        version of the system log.
  17787.  
  17788.  
  17789.  
  17790.  
  17791.  
  17792.  
  17793.  
  17794.  
  17795.  
  17796.  
  17797.  
  17798.  
  17799.  
  17800.  
  17801.  
  17802.        _____________________________________________________________________
  17803.                                         285
  17804.                         APPENDIX A: USING THE ACTIVITY LOG
  17805.        _____________________________________________________________________
  17806.  
  17807.  
  17808.        ---------------
  17809.        Enabling Events
  17810.        ---------------
  17811.  
  17812.        There are 12 different events for which Searchlight can generate an
  17813.        entry in the activity log. By default, all the events are disabled.
  17814.        To enable event logging, run the CONFIG program and choose the
  17815.        events you wish to log. Event logging is controlled by the "Logging
  17816.        Setup" screen under General Configuration #1:
  17817.  
  17818.              1. Login ................. Yes
  17819.              2. Log Off/System Reset .. Yes
  17820.              3. Bad Password .......... No
  17821.              4. File Downloaded ....... No
  17822.              5. File Uploaded ......... No
  17823.              6. Fatal System Error .... Yes
  17824.              7. Public Message Saved .. No
  17825.              8. Email Message Saved ... No
  17826.              9. Message Downloaded .... No
  17827.             10. Jump to Conference .... No
  17828.             11. Jump to Directory ..... No
  17829.             12. QWK Mail Logging ...... No
  17830.  
  17831.        Event logging options are specific to each node in a multinode
  17832.        system, so you can enable logging for some options on some nodes but
  17833.        not others. Be sure to set the logging options as desired for each
  17834.        node in your system if you run multiple nodes. Each option is
  17835.        described in more detail below.
  17836.  
  17837.        Events supported in Searchlight BBS at this time include the
  17838.        following:
  17839.  
  17840.  
  17841.        -------------------
  17842.        Logoff/System Reset
  17843.        -------------------
  17844.  
  17845.        This event is logged any time the system resets back to the "Waiting
  17846.        for call" screen. Normally this indicates the end of a call,
  17847.        although a reset can occur even if there is not a call in progress.
  17848.        System Reset uses an action code of "F". There is no data placed in
  17849.        the message field or username fields.
  17850.  
  17851.  
  17852.        -----
  17853.        Login
  17854.        -----
  17855.  
  17856.        Login events are recorded with an action code of "N" for a new user,
  17857.        or "O" for an existing user. The username field contains the name of
  17858.        the user who logged in. The Msg field contains the following
  17859.        additional information:  caller's graphics mode, baud rate,
  17860.  
  17861.        _____________________________________________________________________
  17862.                                         286
  17863.                         APPENDIX A: USING THE ACTIVITY LOG
  17864.        _____________________________________________________________________
  17865.  
  17866.        invisible status, location, and caller id information. The Msg field
  17867.        is formatted as follows:
  17868.  
  17869.             Graphics BaudRate [+] [Location] <CallerID>
  17870.  
  17871.        "Graphics" is a single character representing Rip (R), Color (C),
  17872.        Monochrome (M), or non-ansi (N). Baudrate is a seven- character
  17873.        field (left padded with spaces if necessary) representing the baud
  17874.        rate. The words "Local" and "Telnet" are used to designate local
  17875.        logins and Telnet connections, respectively.
  17876.  
  17877.        If a Sysop logs in and selects the invisible login option, a + sign
  17878.        appears next in the line with a space on either side.
  17879.  
  17880.        In the case of new user logins, the user's location is recorded
  17881.        next.  Finally, if caller ID information is available, it appears
  17882.        last on the line, enclosed within angle brackets.
  17883.  
  17884.  
  17885.        -------------
  17886.        Bad Passwords
  17887.        -------------
  17888.  
  17889.        A bad password is recorded with a "!" in the action field, and the
  17890.        following message text: Bad Password Attempted. The name for which
  17891.        the bad password was tried appears in the Username field. For
  17892.        security reasons, the bad password itself is not recorded.
  17893.  
  17894.  
  17895.        -----------------------
  17896.        File Upload or Download
  17897.        -----------------------
  17898.  
  17899.        File transfers are indicated with the action code "U" for Upload or
  17900.        "D" for Download. The Msg line contains the name of the file
  17901.        uploaded or downloaded, one blank space, and the name of the
  17902.        associated file directory (this is the directory name as it appears
  17903.        in the Searchlight config program, not the physical path).
  17904.  
  17905.  
  17906.        -----
  17907.        Menus
  17908.        -----
  17909.  
  17910.        If the Event Logging flag for a menu is enabled, Searchlight adds a
  17911.        record to the activity log each time that menu is activated. The log
  17912.        records these events with an "M" in the action field, and the one to
  17913.        eight-character menu name in the message field.
  17914.  
  17915.  
  17916.  
  17917.  
  17918.  
  17919.  
  17920.        _____________________________________________________________________
  17921.                                         287
  17922.                         APPENDIX A: USING THE ACTIVITY LOG
  17923.        _____________________________________________________________________
  17924.  
  17925.  
  17926.        --------
  17927.        Commands
  17928.        --------
  17929.  
  17930.        If a command on a menu is flagged for logging, Searchlight makes a
  17931.        log entry each time that command is executed. These types of entries
  17932.        contain "X" as the action code. The message field contains the menu
  17933.        name and the name of the command, separated by a period. For
  17934.        example, "FILES.List" indicates that the caller executed the command
  17935.        "List" from the menu FILES.
  17936.  
  17937.  
  17938.        --------------------
  17939.        User defined entries
  17940.        --------------------
  17941.  
  17942.        Internal command 220 can be used to place an arbitrary message into
  17943.        the system log. The entire parameter string used with command 220
  17944.        becomes the log message; the action code for these types of entries
  17945.        is "C".
  17946.  
  17947.  
  17948.        ------------
  17949.        Fatal Errors
  17950.        ------------
  17951.  
  17952.        These error events are logged with a "!" action code:
  17953.  
  17954.             Error loading menu <menuname>
  17955.             Read/Write error xxx on file <filename>
  17956.             Lock/Unlock error on file <filename>
  17957.             No conferences available
  17958.             No file directories available
  17959.  
  17960.  
  17961.        --------
  17962.        Messages
  17963.        --------
  17964.  
  17965.        If the "Public Message" or "Email Message" logging flag is enabled,
  17966.        the log file records each time a user saves a public or private
  17967.        message. The action character for these entries is "S"; the message
  17968.        line contains the following information: the conference name, the
  17969.        message number, the word "To:", and the addressee of the message.
  17970.        For example:
  17971.  
  17972.             MAIL 456 To: SYSOP
  17973.             MAIL 497 To: jim@flipflop.org
  17974.             GENERAL 1294 To: All
  17975.  
  17976.  
  17977.  
  17978.  
  17979.        _____________________________________________________________________
  17980.                                         288
  17981.                         APPENDIX A: USING THE ACTIVITY LOG
  17982.        _____________________________________________________________________
  17983.  
  17984.  
  17985.        -------------------------
  17986.        Conferences & Directories
  17987.        -------------------------
  17988.  
  17989.        If "Jump to Conference" or "Jump to Directory" logging is enabled,
  17990.        Searchlight logs each time a caller changes to a new message
  17991.        conference or a new file directory, respectively. The log shows "J"
  17992.        as the action code for these types of events, followed by
  17993.        "Conf.CONFNAME" for conferences or "Dir.DIRNAME" for directories.
  17994.        For example:
  17995.  
  17996.             Conf.GENERAL
  17997.             Conf.ALBBSE
  17998.             Dir.UPLOADS
  17999.  
  18000.        Note that this type of event is different than simply logging the
  18001.        "Jump" menu command because it records any time the current
  18002.        conference or directory changes, regardless of which command caused
  18003.        the change. It also records the default conference and directory
  18004.        that is established at login.
  18005.  
  18006.  
  18007.        ----------------
  18008.        Message Download
  18009.        ----------------
  18010.  
  18011.        If the Message Download event is enabled, Searchlight records each
  18012.        instance that a message is downloaded as a binary file (i.e. by
  18013.        pressing Other/Download while viewing the message). The action code
  18014.        for these events is "G"; the message shows the conference name and
  18015.        the message number of the message that was downloaded. If multiple
  18016.        messages are downloaded at once (i.e. a thread or part of a thread)
  18017.        then the message line contains each message number separated by a
  18018.        space.
  18019.  
  18020.  
  18021.        -----------------------
  18022.        Logdump Utility Program
  18023.        -----------------------
  18024.  
  18025.        If you do not wish to use a database program to view your activity
  18026.        log, the Logdump program will generate a text dump of your activity
  18027.        log to standard output, which you may then redirect to a file or a
  18028.        process. The syntax for running LOGDUMP.EXE is as follows:
  18029.  
  18030.         LogDump [?] [-I P|N|U|D|T|A|M] [-P <progid>]
  18031.                 [-N <node #>] [-A <action code>]
  18032.           -I Include (Program, Node, Username, Date, Time, Action, Message)
  18033.                      (Default = Include All)
  18034.  
  18035.        If you type LOGDUMP with no parameters, the utility lists all
  18036.        transactions in your SYSLOG.DBF file and includes all information
  18037.        about each transaction.
  18038.        _____________________________________________________________________
  18039.                                         289
  18040.                         APPENDIX A: USING THE ACTIVITY LOG
  18041.        _____________________________________________________________________
  18042.  
  18043.  
  18044.        You can use the -I switch to list only certain fields in your output.
  18045.        For example, if you want to generate a list that contains only the
  18046.        time, date, and message, type LOGDUMP -ITDM. To create a list
  18047.        containing only the date, username, and action code, use LOGDUMP
  18048.        -IDUA.
  18049.  
  18050.        The -P switch lets you list only those items associated with a
  18051.        particular program. For example, if you type LOGDUMP - Plogin, you
  18052.        will receive a list of only those events associated with the LOGIN
  18053.        program (i.e. logins, logoffs, and bad passwords).
  18054.  
  18055.        The -N switch restricts the list to a particular node; thus, LOGDUMP
  18056.        -N2 gives you a list of only those events associated with Node 2.
  18057.  
  18058.        The -A switch lists only the events for the given action code. If you
  18059.        type LOGDUMP -AU, you'll list only upload events.
  18060.  
  18061.        Two or more switches may be used together to further specify the type
  18062.        of listing desired.  As with any program that writes to standard
  18063.        output, you can use the redirection characters > or | to pipe the
  18064.        output to a file or process. For example:
  18065.  
  18066.             LOGDUMP >LOGFILE.TXT
  18067.  
  18068.        This command places a text dump of your entire activity log into a
  18069.        file called LOGFILE.TXT
  18070.  
  18071.  
  18072.  
  18073.  
  18074.  
  18075.  
  18076.  
  18077.  
  18078.  
  18079.  
  18080.  
  18081.  
  18082.  
  18083.  
  18084.  
  18085.  
  18086.  
  18087.  
  18088.  
  18089.  
  18090.  
  18091.  
  18092.  
  18093.  
  18094.  
  18095.  
  18096.  
  18097.        _____________________________________________________________________
  18098.                                         290
  18099.                             APPENDIX B: ERROR MESSAGES
  18100.        _____________________________________________________________________
  18101.  
  18102.  
  18103.         -------------------------------------------------------------------
  18104.        | APPENDIX B: GUIDE TO ERROR MESSAGES                               |
  18105.         -------------------------------------------------------------------
  18106.  
  18107.        Searchlight BBS is designed in such a way that the most common kinds
  18108.        of errors that occur are displayed on your screen in English, and
  18109.        don't cause your BBS to crash or go down. Occasionally, however, you
  18110.        may encounter a problem that causes Searchlight to produce a numeric
  18111.        error message, sometimes causing the software to terminate. You'll
  18112.        find that these types of errors are usually related to systemwide
  18113.        problems like bad filenames or lack of file handles.
  18114.  
  18115.        If you encounter a numeric error message, you should write down both
  18116.        the error number and the error address, if it is displayed. Then
  18117.        consult the list below for further information. If you get an error
  18118.        message that's not on this list, or if you can't resolve the
  18119.        problem, contact TeleGrafix with the complete error message and
  18120.        description of the problem.
  18121.  
  18122.  
  18123.        -----------------------------------------
  18124.        Errors 2 and 3 (File/Path does not exist)
  18125.        -----------------------------------------
  18126.  
  18127.        This error indicates that Searchlight is trying to read a file on the
  18128.        disk, and the file does not exist. There are several possible
  18129.        causes:
  18130.  
  18131.             1) The Program Path specified in the CONFIG program points to
  18132.                an invalid pathname, or the program files do not exist in
  18133.                the specified directory.
  18134.  
  18135.             2) A pathname or filename specified in the CONFIG program does
  18136.                not exist, or is an illegal name.
  18137.  
  18138.             3) An illegal or nonexistent pathname was specified in a menu
  18139.                file.
  18140.  
  18141.        Note: Check all of your CONFIG settings carefully, especially those
  18142.              on the Pathnames Setup screen. A missing or misspelled pathname
  18143.              or filename is the usual cause of these errors.
  18144.  
  18145.  
  18146.        -----------------------------
  18147.        Error 4 (Too many open files)
  18148.        -----------------------------
  18149.  
  18150.        This message will occur the first time you try to execute Searchlight
  18151.        or the CONFIG program if your system doesn't have enough file
  18152.        handles available.  The solution to this problem is simple; you must
  18153.        insert the line "Files=30" (or higher) into your CONFIG.SYS file, as
  18154.        discussed in the installation instructions (see the section
  18155.  
  18156.        _____________________________________________________________________
  18157.                                         291
  18158.                             APPENDIX B: ERROR MESSAGES
  18159.        _____________________________________________________________________
  18160.  
  18161.        "Installation - The CONFIG.SYS File"). Be sure to reboot your system
  18162.        after editing your CONFIG.SYS, in order to install the new
  18163.        configuration.
  18164.  
  18165.  
  18166.        ---------------------------
  18167.        Error 100 (Disk read error)
  18168.        ---------------------------
  18169.  
  18170.        This error will occur if a data file on disk is corrupted or
  18171.        otherwise damaged. If Error 100 occurs when trying to log in, read a
  18172.        message, or access a user record, it indicates a problem with one or
  18173.        more of the Searchlight data files. Usually, you can recover your
  18174.        data files by taking the following steps:
  18175.  
  18176.             1) Exit from Searchlight and type CHKDSK/F at the command
  18177.                prompt;
  18178.  
  18179.             2) For a problem that's related to Searchlight's user file,
  18180.                run Searchlight and use the User/Balance command;
  18181.  
  18182.             3) For a problem that's related to a particular message
  18183.                conference, run the CONFIG program and execute the
  18184.                conference repair functions (see the section "Conference
  18185.                Maintenance - Repair Conference Header");
  18186.  
  18187.             4) For a problem related to a file area, run the Files program
  18188.                and execute the 2-Sysop/Balance command.
  18189.  
  18190.        If you cannot run the SLBBS and log in normally, you will usually be
  18191.        able to run the BBS or FILES module directly by typing those
  18192.        commands at your DOS prompt.
  18193.  
  18194.  
  18195.        -------------------------------------
  18196.        Error 101 (Disk or Directory is full)
  18197.        -------------------------------------
  18198.  
  18199.        This error occurs if Searchlight must create a file (such as when you
  18200.        create a new conference or file directory or when you first set up
  18201.        Searchlight BBS) and the disk or directory is full. The solution is
  18202.        to delete some files or create a new directory.
  18203.  
  18204.  
  18205.        --------------------------
  18206.        Error 202 (Stack Overflow)
  18207.        Error 203 (Heap Overflow)
  18208.        --------------------------
  18209.  
  18210.        These errors indicate an "out-of-memory" condition. Usually this is
  18211.        caused by a lack of available memory; to correct the problem,
  18212.        increase the amount of memory available by reducing the size of
  18213.        RAM-disks and other memory resident software.
  18214.  
  18215.        _____________________________________________________________________
  18216.                                         292
  18217.                             APPENDIX B: ERROR MESSAGES
  18218.        _____________________________________________________________________
  18219.  
  18220.        Stack Overflow errors sometimes occur when accessing the User file
  18221.        (in the main BBS program) or a file directory file (in the FILES
  18222.        program) if the binary tree structure is corrupted or badly
  18223.        "unbalanced". If you get this error, try "rebalancing" your user or
  18224.        directory files (using the Balance commands in the Files and BBS
  18225.        programs). If Stack or Heap Overflow messages persist, please
  18226.        contact us.
  18227.  
  18228.  
  18229.        ------------
  18230.        SHARE Errors
  18231.        ------------
  18232.  
  18233.        Multiuser versions of Searchlight BBS require that SHARE.EXE or an
  18234.        equivalent operating system function be loaded when running multiple
  18235.        nodes. If there is a problem with a Share call, Searchlight may
  18236.        report one of the following messages:
  18237.  
  18238.             Share not detected. Load SHARE.EXE or equivalent.
  18239.  
  18240.        Searchlight could not perform a Share call (DOS function 5C)
  18241.        successfully.  The most likely cause is that SHARE is not loaded.
  18242.        Run the program SHARE.EXE from your AUTOEXEC file when you boot your
  18243.        computer, and before loading Searchlight BBS.
  18244.  
  18245.        SHARE.EXE is provided with DOS 3.1 and later. See your DOS manual for
  18246.        more information.
  18247.  
  18248.             SHARE buffer overflow
  18249.  
  18250.        Share did not have enough memory to handle the lock requests made by
  18251.        Searchlight. Increase Share's memory allocation by using Share's /F:
  18252.        and /L:  startup parameters (recommended values if you get this
  18253.        error message are /F:4096 and /L:50).
  18254.  
  18255.             LOCK error on file
  18256.             UNLOCK error on file
  18257.  
  18258.        These messages indicate a general breakdown of the lock/unlock
  18259.        system. This can happen if one node on your BBS locks a file, and
  18260.        then crashes, or otherwise keeps the file in a locked state. The
  18261.        recommended recovery is to reboot your system.
  18262.  
  18263.        If these errors are consistent, you may have a problem with the way
  18264.        Share calls are handled on your system.
  18265.  
  18266.  
  18267.        ------------
  18268.        Other Errors
  18269.        ------------
  18270.  
  18271.        Other errors in the range 5-6, 16-17, and 150-162 are DOS errors
  18272.        indicating disk or device access errors. Check your disk, files, and
  18273.        directories and try the command again.
  18274.        _____________________________________________________________________
  18275.                                         293
  18276.                             APPENDIX B: ERROR MESSAGES
  18277.        _____________________________________________________________________
  18278.  
  18279.  
  18280.        If other errors occur, please write down the exact error message as
  18281.        well as the exact conditions that caused the error, and contact us.
  18282.        Be sure to include your SLBBS version number, DOS version number,
  18283.        and the equipment you use. We will try to diagnose the problem as
  18284.        quickly as possible.
  18285.  
  18286.  
  18287.  
  18288.  
  18289.  
  18290.  
  18291.  
  18292.  
  18293.  
  18294.  
  18295.  
  18296.  
  18297.  
  18298.  
  18299.  
  18300.  
  18301.  
  18302.  
  18303.  
  18304.  
  18305.  
  18306.  
  18307.  
  18308.  
  18309.  
  18310.  
  18311.  
  18312.  
  18313.  
  18314.  
  18315.  
  18316.  
  18317.  
  18318.  
  18319.  
  18320.  
  18321.  
  18322.  
  18323.  
  18324.  
  18325.  
  18326.  
  18327.  
  18328.  
  18329.  
  18330.  
  18331.  
  18332.  
  18333.        _____________________________________________________________________
  18334.                                         294
  18335.                            APPENDIX C: AUTOMATIC EVENTS
  18336.        _____________________________________________________________________
  18337.  
  18338.  
  18339.         -------------------------------------------------------------------
  18340.        | APPENDIX C: AUTOMATIC EVENTS                                      |
  18341.         -------------------------------------------------------------------
  18342.  
  18343.        Searchlight provides a flexible event feature. An "Event" is a DOS
  18344.        command, executable program, or BATCH file that's set to execute at
  18345.        a given time and date. Searchlight scans the list of events when you
  18346.        start it up, and executes them at the proper time.
  18347.  
  18348.        Events execute only when Searchlight is offline -- waiting for a call
  18349.        at the initial display screen. To ensure that the system will
  18350.        actually be waiting for a call at the moment that an event is to be
  18351.        executed, Searchlight will adjust the time limit of a user's session
  18352.        (but not a user's daily time limit) when necessary, and warn a user
  18353.        logging on if an event will occur shortly.  While the event is in
  18354.        progress, Searchlight issues the "local init string" to the modem,
  18355.        causing it to keep the telephone off hook (busy) during the time it
  18356.        takes to execute the given procedure.
  18357.  
  18358.  
  18359.        -----------------------------
  18360.        Setting Up The EVENT.DEF File
  18361.        -----------------------------
  18362.  
  18363.        Events are configured by creating a text file called EVENT.DEF in
  18364.        your BBS system's home directory. The EVENT.DEF file takes three or
  18365.        four fields per line, separated by spaces, like this:
  18366.  
  18367.             [date] <time> <directory> <command>
  18368.  
  18369.        The date can be given in "month/day/year" or "month-day-year" format;
  18370.        times are given in 24 hour format as "hh:mm".  Note that you can
  18371.        omit the date entirely, this creating events that execute every day.
  18372.        Also, you can give a value of zero for the month or year, creating
  18373.        events that occur monthly or annually. The time must be given
  18374.        exactly; no event can execute more frequently than once per day (but
  18375.        you can create several identical events if you wish to run the same
  18376.        procedures more than once a day).
  18377.  
  18378.        <Directory> is the drive and directory that will be switched to
  18379.        before the Event is executed. If you want to stay in the current
  18380.        directory, just use "." for this field. <Command> specifies the
  18381.        command to be run. This can be a .COM or .EXE file, a DOS command,
  18382.        or a .BAT file. Be sure to give the full .COM or .EXE extension on
  18383.        executable files, to prevent an extra COMMAND.COM shell from being
  18384.        loaded. Since events occur when the system is offline, there are no
  18385.        options for modem support; all events occur locally, with no attempt
  18386.        to channel the output to a remote user. Like Doors, however, events
  18387.        can use almost all of the memory available in the machine when run,
  18388.        and can access the Searchlight files if desired.
  18389.  
  18390.  
  18391.  
  18392.        _____________________________________________________________________
  18393.                                         295
  18394.                            APPENDIX C: AUTOMATIC EVENTS
  18395.        _____________________________________________________________________
  18396.  
  18397.  
  18398.        -----------------------------------
  18399.        Running Events On Multiuser Systems
  18400.        -----------------------------------
  18401.  
  18402.        On multiuser Searchlight systems, each node can have its own
  18403.        EVENT.DEF file and its own set of events. Because it is usually
  18404.        undesirable to have the same events execute simultaneously on
  18405.        several nodes, all nodes look only in their home directories for the
  18406.        EVENT.DEF file, and do not attempt to read anyone else's list of
  18407.        events.
  18408.  
  18409.  
  18410.        -------------------------
  18411.        Fossil Support for Events
  18412.        -------------------------
  18413.  
  18414.        When Searchlight launches an event, it automatically enables its
  18415.        Fossil driver emulation feature. Thus, events that require
  18416.        communications can use Fossil function calls, without the need for
  18417.        you to install an external Fossil driver. This is particularly
  18418.        useful when running the Windows version of Searchlight BBS with DOS
  18419.        based events; if your event needs to communicate, make sure it is
  18420.        set up to communicate via Fossil function calls rather than direct
  18421.        access to communications ports.
  18422.  
  18423.  
  18424.        -------------
  18425.        Sample Events
  18426.        -------------
  18427.  
  18428.        Here is a sample EVENT.DEF file. Notice that you can leave blank
  18429.        lines in the text, and give comments by using the # symbol.
  18430.  
  18431.             # Searchlight BBS Event.Def file
  18432.             # Format is:  [mm/dd/yy] hh:mm  Dir Cmd Parameters
  18433.  
  18434.             # Run Tradewars Maintenance program at 3 am
  18435.             03:00 \TW500 TWMAINT.EXE
  18436.  
  18437.             # Run daily backup procedure at 4:30am
  18438.             04:30 . Backup.BAT
  18439.  
  18440.  
  18441.  
  18442.  
  18443.  
  18444.  
  18445.  
  18446.  
  18447.  
  18448.  
  18449.  
  18450.  
  18451.        _____________________________________________________________________
  18452.                                         296
  18453.                           APPENDIX D: MODEM CONFIGURATION
  18454.        _____________________________________________________________________
  18455.  
  18456.  
  18457.         -------------------------------------------------------------------
  18458.        | APPENDIX D: MODEM CONFIGURATION                                   |
  18459.         -------------------------------------------------------------------
  18460.  
  18461.        In order for Searchlight to work properly with a modem, your modem
  18462.        must be at least minimally compatible with the Hayes Smartmodem
  18463.        standard. These things are generally required:
  18464.  
  18465.             * The modem must assert the Carrier Detect (CD) signal when a
  18466.               carrier is detected, and remove it when carrier is absent;
  18467.  
  18468.             * The modem must hang up the telephone in response to a
  18469.               negative toggle on the Data Terminal Ready (DTR) line;
  18470.  
  18471.             * The modem must respond with a "CONNECT" or "CONNECT xxxx"
  18472.               message when connecting to a remote modem (where "xxxx" is
  18473.               the baud rate). This is only required if you use the "Modem
  18474.               Msg" method of baud rate detection.
  18475.  
  18476.        Most modems have options to disable the CD and DTR signals, either
  18477.        via dip switches or commands. If your modem uses dip switches, you
  18478.        must configure the switches to show the "true" state of CD, and
  18479.        respond to the DTR signal from the computer. If commands are
  18480.        required, you must place the commands in the modem remote
  18481.        initialization string; on most modems the commands "&C1" and "&D2"
  18482.        will work. Remember that you can enter more than one modem command
  18483.        in the modem initialization string -- most modems will accept several
  18484.        AT commands strung together (i.e. ATH0M0S0=1), and if not, you can
  18485.        use the "!" character to generate a carriage return. If you send
  18486.        several commands separated by carriage returns you may also need to
  18487.        place one or more "~" characters after each command to allow the
  18488.        modem enough time to complete the command before executing the next
  18489.        instruction.
  18490.  
  18491.        If your modem has a speaker, you will probably want to disable it
  18492.        while your BBS is running. You can do this by inserting the command
  18493.        to turn off the speaker into your Remote Init String (usually ATM0).
  18494.  
  18495.        If your modem does not answer the telephone, chances are that modem
  18496.        register S0 needs to be initialized to a nonzero value. While most
  18497.        modems initialize S0 to 1 when reset, some, particularly internal
  18498.        modems, initialize it to 0, preventing the modem from answering any
  18499.        calls. Use the command
  18500.  
  18501.             ATS0=1!
  18502.  
  18503.        in your remote initialization string (this command is present in the
  18504.        default init string when you first set up Searchlight).
  18505.  
  18506.        If your modem won't hang up the phone at the end of each session
  18507.        (i.e. after the Goodbye command is executed), it means that the
  18508.        modem is ignoring the status of the DTR signal coming from the
  18509.  
  18510.        _____________________________________________________________________
  18511.                                         297
  18512.                           APPENDIX D: MODEM CONFIGURATION
  18513.        _____________________________________________________________________
  18514.  
  18515.        computer. This is a common situation, and can usually be corrected
  18516.        by setting a dip switch on the modem or issuing the "&D" modem
  18517.        command. If you can't correct this problem, try setting your modem
  18518.        init string to:
  18519.  
  18520.             ~~~+++~~~ATH!
  18521.  
  18522.        This will cause Searchlight to perform a soft-reset of the modem at
  18523.        the end of each call by sending the modem escape sequence, followed
  18524.        by the hangup command. Since this method takes longer and is less
  18525.        reliable than a hardware hangup, it is recommended that you use it
  18526.        only if you can't get the hardware hangup to work.
  18527.  
  18528.        When sending a command to the modem, Searchlight will wait for the
  18529.        modem to respond with an "OK" message. If the "OK" is not received,
  18530.        Searchlight will print a warning message on the screen. If this
  18531.        happens it indicates that your modem is not responding; usually,
  18532.        this means that your modem is turned off, connected to the wrong
  18533.        communications port, or improperly connected. You should check the
  18534.        modem and try to alleviate the problem. If you receive this message
  18535.        the first time you run your BBS, make sure that the COM port
  18536.        selected in option 1 on the configuration menu corresponds to the
  18537.        port to which the modem is connected, and make sure that the modem
  18538.        type (option 2) is correct. Some modems have a dip switch that can
  18539.        be set to have the modem ignore all commands; make sure this switch
  18540.        is turned off. If you continue to have difficulty, it could indicate
  18541.        that your modem is not Hayes compatible (or needs to be configured
  18542.        for Hayes compatibility) or that your communications ports,
  18543.        computer, or operating system are not IBM compatible; although this
  18544.        is rarely the case.
  18545.  
  18546.        Note: If you are attempting to use COM3 or COM4, please see the note
  18547.              below.
  18548.  
  18549.  
  18550.        ---------------------
  18551.        Remote Baud Detection
  18552.        ---------------------
  18553.  
  18554.        Searchlight BBS can be configured to determine the baud rate of an
  18555.        incoming call in one of two ways, according to the value in the
  18556.        "Speed Detect Method" field on the Communications Setup screen. When
  18557.        this field is set to "Modem Msg", the program reads the modem
  18558.        connect message; when set to "Key Hit", it samples keyboard input to
  18559.        determine the baud rate.
  18560.  
  18561.        The modem message method is preferred, since it does not require that
  18562.        you strike the Enter key before Searchlight recognizes you. However,
  18563.        this method requires a Hayes compatible modem configured to respond
  18564.        with the proper message (i.e. CONNECT 2400, CONNECT 9600, etc). The
  18565.        keystroke method requires that you press the Enter key on the remote
  18566.        terminal several times before the connection is established;
  18567.        however, this method will work with non-Hayes compatible modems and
  18568.  
  18569.        _____________________________________________________________________
  18570.                                         298
  18571.                           APPENDIX D: MODEM CONFIGURATION
  18572.        _____________________________________________________________________
  18573.  
  18574.        with other types of connections, such as hardwired null-modem
  18575.        connections.
  18576.  
  18577.        If your BBS answers the telephone but connects at the wrong baud rate
  18578.        (for example, if it registers a 300 baud connection even though a
  18579.        2400 baud call has been made), it indicates that the modem is not
  18580.        sending the proper connect message to Searchlight (in this case,
  18581.        "CONNECT 2400"). Some modems can be configured to send the CONNECT
  18582.        message as numbers instead of words, or just send "CONNECT" without
  18583.        a baud rate, or not send any message at all.  You will have to
  18584.        configure your modem -- either through dip switches or via commands
  18585.        in the modem init string -- to send the proper message when
  18586.        connecting. Since these operations are nonstandard and vary from
  18587.        modem to modem, you will have to check the manual that came with
  18588.        your modem for the proper switch settings and commands for your
  18589.        modem (or try one of the recommended modem strings below).
  18590.  
  18591.        If you have this problem and don't have an "ATS0=1" in your init
  18592.        string, try adding that; "ATX4" may also be necessary for some
  18593.        modems.
  18594.  
  18595.        It is expected that the "CONNECT xxxx" message will be sent at the
  18596.        highest baud rate that's been selected for your BBS in option 2 on
  18597.        the configuration menu. Many modems will actually send the connect
  18598.        message at whatever speed the last command from the computer was
  18599.        sent at. For this reason, we recommend that you always have a modem
  18600.        init string; if you don't need to send any commands to your modem,
  18601.        just send
  18602.  
  18603.             AT!
  18604.  
  18605.        as this will cause the modem to be reset to its highest operating
  18606.        speed at the start of each new call. Remember to add the ! character
  18607.        at the end of your modem init strings. Leaving off the ! is a common
  18608.        mistake.
  18609.  
  18610.        If you can't get your modem to connect properly using the modem
  18611.        message method, use the keystroke method instead.
  18612.  
  18613.  
  18614.        ----------------------
  18615.        Modem Output Buffering
  18616.        ----------------------
  18617.  
  18618.        Searchlight BBS normally uses a two-way system of interrupt-driven
  18619.        i/o buffering. What this means is that both input and output are
  18620.        buffered.
  18621.  
  18622.        Buffered input means that characters entering Searchlight from the
  18623.        modem -- keys typed by the remote user -- are stored in a buffer for
  18624.        use when they are needed. This allows you to "type ahead" without
  18625.        losing any characters; the keys you type appear whenever Searchlight
  18626.        is next able to accept them.
  18627.  
  18628.        _____________________________________________________________________
  18629.                                         299
  18630.                           APPENDIX D: MODEM CONFIGURATION
  18631.        _____________________________________________________________________
  18632.  
  18633.        Buffered output is also supported. Output buffering allows your
  18634.        system to "dump" many characters of output into a buffer, and
  18635.        "spool" these output characters to the modem at the modem's speed,
  18636.        even while the BBS is performing other tasks. Modem output is done
  18637.        in the background. Using an output buffer has an important effect on
  18638.        the speed of the BBS as viewed from the remote end.
  18639.  
  18640.        However, we have found that modem output buffering doesn't work
  18641.        properly with all systems. In a few cases, using an output buffer
  18642.        will cause the BBS to run much more slowly than it should. If you
  18643.        experience any problem running Searchlight with an output buffer, it
  18644.        is suggested that you disable the output buffer. To disable output
  18645.        buffering, simply enter a value of 0 in the "Output Buffering
  18646.        Factor" field on the Communications Setup menu.
  18647.  
  18648.  
  18649.        ------------------
  18650.        COM Port Addresses
  18651.        ------------------
  18652.  
  18653.        Searchlight BBS supports virtually any IBM compatible COM port.
  18654.        Although you can only specify values of 1 thru 4 for the COM port
  18655.        number, these values actually reference a table of COM port
  18656.        parameters, and can refer to any physical COM port you have, as long
  18657.        as you know the port's physical address (base address) and interrupt
  18658.        request (IRQ) number.
  18659.  
  18660.        For reference, here is a list of the default port locations and IRQ
  18661.        lines used by Searchlight:
  18662.  
  18663.                                   Base        Interrupt
  18664.                            Port  Address       Request
  18665.                            ============================
  18666.                            COM1    3F8 (Hex)    IRQ 4
  18667.                            COM2    2F8          IRQ 3
  18668.                            COM3    3E8          IRQ 4
  18669.                            COM4    2E8          IRQ 3
  18670.  
  18671.        Keep in mind that on many systems, COM3 and COM4 will have a port
  18672.        address and interrupt different than those shown here. If
  18673.        Searchlight's values for COM3 or COM4 do not match those used by
  18674.        your hardware, you can change them by using the Communications Setup
  18675.        menu in the CONFIG program (see the section "Configuration - COM
  18676.        Port Setups").
  18677.  
  18678.        If you have COM ports on your system beyond COM4, you can easily use
  18679.        them:  just set the value for COM3 or COM4 equal to the base address
  18680.        and interrupt for the port you'd like to use.
  18681.  
  18682.  
  18683.  
  18684.  
  18685.  
  18686.  
  18687.        _____________________________________________________________________
  18688.                                         300
  18689.                           APPENDIX D: MODEM CONFIGURATION
  18690.        _____________________________________________________________________
  18691.  
  18692.  
  18693.        -----------------
  18694.        High Speed Modems
  18695.        -----------------
  18696.  
  18697.        Searchlight BBS includes full support for modern high-speed modems.
  18698.        Features include Locked DTE rate support up to 115,200 baud and
  18699.        hardware flow control. Options #3 and 4, located on the
  18700.        Communications Setup screen in the CONFIG program, implement high
  18701.        speed features:
  18702.  
  18703.             3. Locked Baud Rate ....... 38400
  18704.             4. Hardware Flow Control .. On
  18705.  
  18706.        Locked Baud Rate specifies a fixed speed at which Searchlight BBS (as
  18707.        well as all Door programs and external protocols) will communicate
  18708.        with your modem.  The fixed baud rate can be any speed up to 115,200
  18709.        baud. However, since the communications ports used in many PC's are
  18710.        not capable of running at speeds greater than 19,200 baud, you
  18711.        should use the higher speeds with caution.
  18712.  
  18713.        Hardware Flow Control specifies that Searchlight will use the CTS
  18714.        (clear to send) modem signal to handshake with the modem; that is,
  18715.        Searchlight will transmit only when the modem indicates it is ready
  18716.        to receive characters and will pause when the modem indicates that
  18717.        it is temporarily unable to receive new data.
  18718.  
  18719.        In general, Locked Baud Rate and Hardware Flow Control should be
  18720.        used together and should only be used with modems that support these
  18721.        features (these include most 2400 baud MNP modems and all modems
  18722.        faster than 2400 baud). Using a locked baud rate greater than the
  18723.        actual baud rate provided by the modem allows modems to take
  18724.        advantage of data compression, error checking, and internal
  18725.        buffering, all of which increase the speed at which data can be
  18726.        received and transmitted. Of course, your modem must be properly
  18727.        configured (via modem init strings) to perform buffering and/or data
  18728.        compression.
  18729.  
  18730.        When a locked baud rate is in effect, all stand-alone Door programs
  18731.        (those programs which use their own modem i/o) and all external
  18732.        protocols used must support hardware flow control (CTS handshaking).
  18733.        Searchlight will pass the locked baud rate, rather than the actual
  18734.        baud rate, to all external programs that use the command-line
  18735.        metacharacters to obtain a baud rate.
  18736.  
  18737.  
  18738.        ------------------------------
  18739.        Recommended Modem Init Strings
  18740.        ------------------------------
  18741.  
  18742.        The best way to determine the proper modem init strings and settings
  18743.        for your modem is to execute Searchlight's built in automatic modem
  18744.        configuration feature, as described in the section "Configuration -
  18745.        Automatic Modem Configuration."
  18746.        _____________________________________________________________________
  18747.                                         301
  18748.                           APPENDIX D: MODEM CONFIGURATION
  18749.        _____________________________________________________________________
  18750.  
  18751.        For reference, he following settings will configure most standard
  18752.        2400 baud modems for use with Searchlight BBS:
  18753.  
  18754.             Modem Type           : 2400 Baud
  18755.             Locked Baud Rate     : None
  18756.             Hardware Flow Control: Off
  18757.             Modem Init String    : ATH0M0&C1&D2S0=1!
  18758.  
  18759.        These settings will work for most high speed modems and most MNP or
  18760.        error correcting 2400 baud modems, other than US Robotics modems:
  18761.  
  18762.             Modem Type           : High Speed
  18763.             Locked Baud Rate     : 19200
  18764.             Hardware Flow Control: On
  18765.             Modem Init String    : ATH0M0&C1&D2&K3W2S0=1!
  18766.  
  18767.        A few high speed modems require \Q3 or *F3 in place of &K3 in order
  18768.        to enable hardware flow control. Consult your modem manual for
  18769.        further information, or try the Automatic Modem Configuration
  18770.        feature.  Use these settings for US Robotics high speed modems:
  18771.  
  18772.             Modem Type           : High Speed
  18773.             Locked Baud Rate     : 19200
  18774.             Hardware Flow Control: On
  18775.             Modem Init String    : ATH0M0&C1&D2&B1&H1W2S0=1!
  18776.  
  18777.  
  18778.  
  18779.  
  18780.  
  18781.  
  18782.  
  18783.  
  18784.  
  18785.  
  18786.  
  18787.  
  18788.  
  18789.  
  18790.  
  18791.  
  18792.  
  18793.  
  18794.  
  18795.  
  18796.  
  18797.  
  18798.  
  18799.  
  18800.  
  18801.  
  18802.  
  18803.  
  18804.  
  18805.        _____________________________________________________________________
  18806.                                         302
  18807.                               APPENDIX E: ALIAS NAMES
  18808.        _____________________________________________________________________
  18809.  
  18810.  
  18811.         -------------------------------------------------------------------
  18812.        | APPENDIX E: USING ALIAS NAMES                                     |
  18813.         -------------------------------------------------------------------
  18814.  
  18815.        An alias is a different name for the same thing. Searchlight BBS
  18816.        supports the use of alias usernames in place of actual usernames
  18817.        when sending mail, changing options, etc. In addition, Searchlight
  18818.        can define group alias names, where one name stands for a group of
  18819.        usernames.
  18820.  
  18821.        For example, if your name is Roger Armstrong but you log in to your
  18822.        BBS using the SYSOP account, you can set "Roger Armstrong" to be an
  18823.        alias name for SYSOP. When a user tries to send a message and types
  18824.        ROGER ARMSTRONG as the name of the receiver, Searchlight
  18825.        automatically reroutes the message to SYSOP. In addition, you can
  18826.        use the alias feature to set up group names. A group name is similar
  18827.        to an alias name, except that it is the alias for a group of two or
  18828.        more usernames. When you send mail to the group name, the message is
  18829.        sent to all users in the group.
  18830.  
  18831.        Alias names are defined by creating a file called ALIAS.DEF in your
  18832.        data files directory. The format is very simple, just enter each
  18833.        line in the following format:
  18834.  
  18835.             ALIASNAME = USERNAME
  18836.  
  18837.        or:
  18838.  
  18839.             GROUPNAME = USERNAME1, USERNAME2, USERNAME3, ...
  18840.  
  18841.        for example,
  18842.  
  18843.             ROGER ARMSTRONG = SYSOP
  18844.             CLIFF HELLER = FNORD
  18845.             CLIENTS = EUGENE CHOI, GREG RECCO, EILEEN WINTER
  18846.             GIRLFRIENDS = EDITH KEELER, ROBERTA LINCOLN
  18847.  
  18848.        If one line is not enough to type all the names in a group name, you
  18849.        can continue on additional lines. Just make sure the last character
  18850.        on all lines except the last line is a comma. Leading and trailing
  18851.        spaces are optional and can be included for clarity.
  18852.  
  18853.        Alias names are valid at any place you can type a user name, except
  18854.        at the login prompt. Group names are valid at the "Send To" and "cc
  18855.        To" prompts from the Mail command and as destinations for the
  18856.        Forward subcommand at any submenu. When you send or forward a
  18857.        message to a group, all group members receive the message in their
  18858.        mailbox. You can even send mail to several group addresses at once,
  18859.        specifying each group name at the "cc To" prompt; all users in all
  18860.        groups get the message.
  18861.  
  18862.  
  18863.  
  18864.        _____________________________________________________________________
  18865.                                         303
  18866.                               APPENDIX E: ALIAS NAMES
  18867.        _____________________________________________________________________
  18868.  
  18869.        Notice that you can only alias an invalid username (a name which does
  18870.        not appear in your Searchlight User file) to a valid name which does
  18871.        appear in the user file. For example, the command
  18872.  
  18873.             SYSOP = ROGER ARMSTRONG
  18874.  
  18875.        will not work. You cannot redirect the name SYSOP since Searchlight
  18876.        finds that name in its user file, before it ever looks at the alias
  18877.        definitions.  In fact, the ALIAS.DEF file is only processed when a
  18878.        particular username can't be located in the regular User file.
  18879.  
  18880.        If your system supports Fidonet or Internet email, you can use
  18881.        Fidonet and Internet addresses on the right-hand side of the equals
  18882.        sign in your ALIAS.DEF file. This gives you a way to make shortcuts
  18883.        to frequently used Fidonet and Internet addresses.
  18884.  
  18885.  
  18886.  
  18887.  
  18888.  
  18889.  
  18890.  
  18891.  
  18892.  
  18893.  
  18894.  
  18895.  
  18896.  
  18897.  
  18898.  
  18899.  
  18900.  
  18901.  
  18902.  
  18903.  
  18904.  
  18905.  
  18906.  
  18907.  
  18908.  
  18909.  
  18910.  
  18911.  
  18912.  
  18913.  
  18914.  
  18915.  
  18916.  
  18917.  
  18918.  
  18919.  
  18920.  
  18921.  
  18922.  
  18923.        _____________________________________________________________________
  18924.                                         304
  18925.                                 APPENDIX F: SLMAIL
  18926.        _____________________________________________________________________
  18927.  
  18928.  
  18929.         -------------------------------------------------------------------
  18930.        | APPENDIX F: THE SLMAIL COMMAND LINE UTILITY                       |
  18931.         -------------------------------------------------------------------
  18932.  
  18933.  
  18934.        ------------
  18935.        Introduction
  18936.        ------------
  18937.  
  18938.        SLMAIL is a command-line utility program which can read Fidonet
  18939.        message files or text files and send them to Searchlight BBS as
  18940.        messages, or read messages from Searchlight BBS and `export' them to
  18941.        Fidonet messages or text files (even the DOS standard input and
  18942.        output can be used). SLMAIL is designed to be called by other
  18943.        programs or batch files; it uses command line switches for all
  18944.        options.
  18945.  
  18946.        With the proper software, SLMAIL can be used as a "driver" program to
  18947.        extract or deliver text messages to or from your BBS's data files,
  18948.        saving the main program from having to open and manage Searchlight's
  18949.        data files on its own.  For example, SLMAIL could be used:
  18950.  
  18951.             * To forward `script' questionnaire replies to the Sysop;
  18952.             * To create archival files of message base discussions;
  18953.             * To move messages from one BBS system to another;
  18954.             * To automatically send reports to the Sysop's mailbox;
  18955.             * To connect your BBS to an international network like Fidonet.
  18956.  
  18957.  
  18958.         -------------------------------------------------------------------
  18959.        | SYNTAX                                                            |
  18960.         -------------------------------------------------------------------
  18961.  
  18962.        The SLMAIL.EXE program is installed when you install Searchlight from
  18963.        its distribution disks. The general syntax for running the program
  18964.        is as follows:
  18965.  
  18966.             SLMAIL command address [options]
  18967.  
  18968.        Command is R (to read text), S (to send text), E (to export Fido
  18969.        messages) or I (to import Fido messages); Address is the name of a
  18970.        conference on your system;
  18971.  
  18972.        Options are:
  18973.  
  18974.             -x <filename>  Name of the input file (for "Send" text commands)
  18975.                            or output file (for "Read" text commands)
  18976.             -p <pathname>  Pathname to the CONFIG.SL2 file (if not in the
  18977.                            current directory)
  18978.             -g <pathname>  Pathname where Fido *.MSG files are read or
  18979.                            written
  18980.  
  18981.  
  18982.        _____________________________________________________________________
  18983.                                         305
  18984.                                 APPENDIX F: SLMAIL
  18985.        _____________________________________________________________________
  18986.  
  18987.        For Send commands:
  18988.  
  18989.             -f <username>  Name of user from whom the message is "from"
  18990.             -t <username>  Name of the user to whom the message is "to"
  18991.             -s <text>      Text of the "Subject" field
  18992.             -w <text>      Text of the "Forwarded-From" field
  18993.             -c             Allow Searchlight color codes
  18994.  
  18995.        For Import commands:
  18996.  
  18997.             -k             Kill *.MSG files after importing
  18998.             -i             Import "Seen-By" lines
  18999.             -a             Import all messages
  19000.             -d             Disable threading/indexing on import
  19001.             -c             Allow Searchlight color codes
  19002.             -q             Allow ANSI sequences
  19003.  
  19004.        For Read and Export commands:
  19005.  
  19006.             -b <date>      Specifies the earliest date to read
  19007.             -e <date>      Specifies the latest date to read
  19008.             -m             Provides "more" prompting
  19009.             -l             Converts names to upper/lowercase format
  19010.             -n             Get new messages only
  19011.             -r             Get personal messages only
  19012.  
  19013.        Unlike most command-line driven software, SLMAIL allows embedded
  19014.        spaces in parameters and spaces after option switches. Thus, you can
  19015.        enter user names and text strings with embedded spaces on the SLMAIL
  19016.        command line. Note that if you type SLMAIL with no parameters, a
  19017.        list of options is displayed.
  19018.  
  19019.  
  19020.         -------------------------------------------------------------------
  19021.        | READING AND SENDING TEXT FILES                                    |
  19022.         -------------------------------------------------------------------
  19023.  
  19024.        SLMAIL lets you retrieve messages from your Searchlight data files
  19025.        (public messages or private) and write them to regular DOS text
  19026.        files, or place the contents of text files into Searchlight mail or
  19027.        messages. These operations are performed with the R (Read) and S
  19028.        (Send) subcommands. Here are some examples:
  19029.  
  19030.             SLMAIL S MAIL -t Sysop -s Local Area BBS List -x BBSLIST.TXT
  19031.  
  19032.        This command loads the text file BBSLIST.TXT and sends it to the
  19033.        Sysop as an electronic mail message with the subject "Local Area BBS
  19034.        List". The message will also be "from" the Sysop, since SLMAIL
  19035.        defaults to Sysop if the -f flag is not given. Since the -p flag was
  19036.        not used, this command must be given in the same directory where
  19037.        CONFIG.SL2 is located.
  19038.  
  19039.             TOPTEN | SLMAIL S MAIL -tSysop -s Top 10 Listing
  19040.  
  19041.        _____________________________________________________________________
  19042.                                         306
  19043.                                 APPENDIX F: SLMAIL
  19044.        _____________________________________________________________________
  19045.  
  19046.        This is similar to the above command, except that the text of the
  19047.        message is not loaded from a particular file but from the standard
  19048.        input stream. In this example, the program TOPTEN is run and its
  19049.        output is "piped" into SLMAIL using the standard DOS "|" symbol.
  19050.  
  19051.             SLMAIL S MAIL -t Joe Smith -f Mike Green -s Monday  <continued>
  19052.             Night's Game -x G.TXT
  19053.  
  19054.        This example sends a mail message from user Mike Green to user Joe
  19055.        Smith. The subject is "Monday Night's Game" and the text is read
  19056.        from the file G.TXT.
  19057.  
  19058.        So far, we have demonstrated sending messages to particular
  19059.        mailboxes, by specifying MAIL as the conference name. To send public
  19060.        messages with SLMAIL, specify the name of a public message
  19061.        conference (one that you've created via the CONFIG program). Here's
  19062.        an example:
  19063.  
  19064.             DIR | SLMAIL S GENERAL -p C:\BBS
  19065.  
  19066.        This command does a directory and sends the result as a public
  19067.        message to the GENERAL conference. Since no explicit to and from
  19068.        usernames were provided, SLMAIL defaults the message to "All" and
  19069.        from "Sysop".
  19070.  
  19071.        Also in this command, SLMAIL does not look for the CONFIG.SL2 file in
  19072.        the current directory, but instead looks in C:\BBS for it; thus,
  19073.        this command could be executed from within any directory, provided
  19074.        that the CONFIG.SL2 and SUBBOARD.SL2 files contain full pathname
  19075.        specifications to the GENERAL conference data files.
  19076.  
  19077.             SLMAIL R SLBBS -b1/1/92 -e4/30/92 -m
  19078.  
  19079.        This command reads all messages on conference "SLBBS" that were
  19080.        posted between January 1st and April 30th. The results are sent to
  19081.        the screen, with "more" prompting.
  19082.  
  19083.  
  19084.        -------------------------
  19085.        Reading Personal Messages
  19086.        -------------------------
  19087.  
  19088.             SLMAIL R MAIL -r -tSysop -xSYSMAIL.TXT
  19089.  
  19090.        This command will read the entire contents of the Sysop's mailbox and
  19091.        write them to the text file SYSMAIL.TXT in the current directory.
  19092.  
  19093.        Notice that the -r switch is used to tell SLMAIL to read personal
  19094.        messages from the Mail conference. Who's personal messages does
  19095.        SLMAIL read? The username is specified by providing the -t switch on
  19096.        the command line. You can read personal messages from any user and
  19097.        on any conference, not just MAIL, using this type of SLMAIL command.
  19098.  
  19099.  
  19100.        _____________________________________________________________________
  19101.                                         307
  19102.                                 APPENDIX F: SLMAIL
  19103.        _____________________________________________________________________
  19104.  
  19105.  
  19106.        --------------------
  19107.        Reading New Messages
  19108.        --------------------
  19109.  
  19110.             SLMAIL R NATIVE -n -m -tMichael Ford
  19111.  
  19112.        This command reads all new messages on conference NATIVE and presents
  19113.        them with "more" prompting. Which messages are new? SLMAIL uses the
  19114.        new message pointer of the conference member designated by the -t
  19115.        option. In this case, Michael Ford's new message pointer is used.
  19116.  
  19117.             SLMAIL R MAIL -tHenry Talisman -n -p -xMAIL.TXT
  19118.  
  19119.        With the MAIL conference, new messages are those messages which
  19120.        haven't been read before, regardless of high message pointers.
  19121.  
  19122.  
  19123.         -------------------------------------------------------------------
  19124.        | IMPORTING AND EXPORTING ECHOMAIL MESSAGES                         |
  19125.         -------------------------------------------------------------------
  19126.  
  19127.        SLMAIL's Import and Export commands work similarly to Send and Read,
  19128.        except that messages are read and written in the Fidonet `MSG' file
  19129.        format. This is an important format because these messages can
  19130.        participate in the international Fido network, and other networks
  19131.        based on Fidonet technology, thus allowing you to communicate with
  19132.        many different types of bulletin board systems around the world via
  19133.        echomail facilities.
  19134.  
  19135.        Please note that SLMAIL, by itself, does not give you access to
  19136.        echomail forums. You will also require "front end" software to
  19137.        interface with other nodes, and you will need authorization from
  19138.        your local network coordinator in order to begin participating. For
  19139.        more information on how to get started, contact other network users
  19140.        in your area. Information about joining SL_NET, the Fidonet
  19141.        technology network for Searchlight sysops, is available on our
  19142.        support BBS.
  19143.  
  19144.        SLMAIL deals with MSG files -- the standard network message package
  19145.        used on Fidonet technology networks. Before you try to set up mail,
  19146.        make sure you have a front end mailer properly set up and configured
  19147.        so that it produces MSG files from the network mail packets it
  19148.        receives, and can distribute MSG files generated by SLMAIL into your
  19149.        network.  SLMAIL does not read or write the actual "packet" files
  19150.        that are transferred from system to system -- you need to use a mail
  19151.        tosser product, or a front end mailer that provides the tosser
  19152.        function, in conjunction with SLMAIL.
  19153.  
  19154.  
  19155.  
  19156.  
  19157.  
  19158.  
  19159.        _____________________________________________________________________
  19160.                                         308
  19161.                                 APPENDIX F: SLMAIL
  19162.        _____________________________________________________________________
  19163.  
  19164.  
  19165.        -----------
  19166.        Fido Export
  19167.        -----------
  19168.  
  19169.        SLMAIL exports messages in the Fidonet *.MSG format when the E
  19170.        (export) command option is given. For example,
  19171.  
  19172.           SLMAIL E PASCAL        Export messages on conference "PASCAL"
  19173.           SLMAIL E PASCAL -N     Export new messages on conference "PASCAL"
  19174.           SLMAIL E PASCAL -L     Export "PASCAL", usernames to lowercase
  19175.  
  19176.        SLMAIL checks the current directory for *.MSG files and begins
  19177.        exporting messages at the next highest message number. If no MSG
  19178.        files exist, then exporting begins at 2.MSG and continues with
  19179.        3.MSG, 4.MSG, etc.
  19180.  
  19181.        Fidonet conventions require that user names be displayed using a
  19182.        combination of upper and lowercase characters. By default,
  19183.        Searchlight BBS and SLMAIL use all uppercase for usernames. You can
  19184.        change this default by placing a -L switch on the SLMAIL command
  19185.        line when exporting messages.
  19186.  
  19187.        The -N flag is normally used in conjunction with message exporting.
  19188.        In order to avoid duplication of messages, use the - N flag each
  19189.        time you export messages from a message conference for inclusion in
  19190.        a message echo. This will ensure that only new messages posted after
  19191.        the last export command was used are selected for export.
  19192.  
  19193.        How does SLMAIL keep track of which messages are "new" each time it
  19194.        exports?  The answer is that SLMAIL creates its own member record,
  19195.        called "SLMAIL", in each conference from which exporting occurs.
  19196.        This member record maintains SLMAIL's high message pointer just like
  19197.        regular member records contain your users' high message pointers.
  19198.        Should you wish to modify SLMAIL's high message value, use the
  19199.        command 1-Member/HighMsg at Searchlight's main menu, specifying
  19200.        SLMAIL as the user name. You may especially wish to do this the
  19201.        first time you run SLMAIL, in order to initialize it to the desired
  19202.        value.
  19203.  
  19204.        SLMAIL will not export "protected" messages. Messages are protected
  19205.        in Searchlight by editing the message and assigning a protected
  19206.        status when prompted. Protecting a message gives you a way to enter
  19207.        a local message into an otherwise echo-bound conference area.
  19208.  
  19209.        In addition to a message header and text, exported messages contain a
  19210.        tear line, an Origin line, and a "Via" line. These are standard
  19211.        items which other software will expect to find. Tear, Origin, and
  19212.        Via lines appear at the end of an exported message and look like
  19213.        this:
  19214.  
  19215.             --- SLMAIL v5.0  (#0001)
  19216.             * Origin: Searchlight BBS (1:157/582)
  19217.             ^AVia SLMAIL v5.0  (#0001)
  19218.        _____________________________________________________________________
  19219.                                         309
  19220.                                 APPENDIX F: SLMAIL
  19221.        _____________________________________________________________________
  19222.  
  19223.        The first line (Tear line) contains the version number of the SLMAIL
  19224.        program used to export the message, along with your unique
  19225.        Searchlight BBS registration number. Next is the Origin line, which
  19226.        contains the name of your BBS and your network node numbers (node
  19227.        numbers are entered on the conference setup screen; see the section
  19228.        "Conference Maintenance - Edit Conference"). The Via line, not
  19229.        normally visible when reading an Echomail message, serves to mark
  19230.        the message as having been exported by your BBS.  SLMAIL uses that
  19231.        information later to avoid duplication of messages as they are
  19232.        imported and exported.
  19233.  
  19234.  
  19235.        -----------
  19236.        Fido Import
  19237.        -----------
  19238.  
  19239.        SLMAIL imports Fidonet *.MSG format files when the I (Import) command
  19240.        is used. For example,
  19241.  
  19242.             SLMAIL I SYSOPS     Import messages to conference "SYSOPS"
  19243.  
  19244.        SLMAIL takes the *.MSG files in the current directory (starting with
  19245.        2.MSG) and imports them into the specified message area.
  19246.  
  19247.        SLMAIL skips messages which were previously imported into your
  19248.        message base or which were exported from your message base. If you
  19249.        do wish to import such messages, use the -A (All) flag on the SLMAIL
  19250.        command line.
  19251.  
  19252.        Messages are always imported in date and time sorted order. The
  19253.        process of sorting messages is done before the importing begins, and
  19254.        may take some time if you have a lot of messages to import.
  19255.  
  19256.        Messages can be imported from a directory other than the current
  19257.        directory.  To do this, specify the MSG directory with the -G option
  19258.        on the SLMAIL command line.
  19259.  
  19260.        By default, "Seen-By" lines at the end of a message are ignored. If
  19261.        you want to see these lines, add the -I switch to the SLMAIL command
  19262.        line.
  19263.  
  19264.        If the -K (Kill) command line option is given, SLMAIL deletes each
  19265.        *.MSG file as it is imported. The 1.MSG file (if it exists) is not
  19266.        deleted.
  19267.  
  19268.        Messages imported by SLMAIL appear as regular messages in Searchlight
  19269.        BBS, with only a few exceptions. Imported messages may contain
  19270.        lowercase characters in the "to" and "from" header fields. They
  19271.        normally contain some kind of tag line, similar to the origin line
  19272.        shown above, indicating the name and address of the BBS which
  19273.        originated the message.
  19274.  
  19275.  
  19276.  
  19277.        _____________________________________________________________________
  19278.                                         310
  19279.                                 APPENDIX F: SLMAIL
  19280.        _____________________________________________________________________
  19281.  
  19282.        Searchlight lets you send private replies to imported messages; such
  19283.        replies are called "Netmail". For more information about netmail,
  19284.        see the section "Netmail - Introduction to Netmail."
  19285.  
  19286.  
  19287.        -------------------------
  19288.        SLMAIL Configuration File
  19289.        -------------------------
  19290.  
  19291.        SLMAIL supports a configuration file, which allows you to provide the
  19292.        text of "Origin" type lines used by your system and an alias name
  19293.        for your SYSOP account. The configuration file is a text file called
  19294.        SLMAIL.CFG, which should be located in your Searchlight BBS home
  19295.        directory. The file contains just two lines of text, as follows:
  19296.  
  19297.             Default SYSOP alias
  19298.             Default origin line text
  19299.  
  19300.        Sysop alias is a name that SLMAIL will use in place of SYSOP when it
  19301.        exports messages. Normally, you should put your name here. Origin
  19302.        text is used in the "Origin" line appended by SLMAIL to each
  19303.        exported message. For example, your SLMAIL.CFG file might contain:
  19304.  
  19305.             Tim Robbins
  19306.             Montauk BBS 516-555-2646
  19307.  
  19308.        If you wish, you can provide a different Sysop alias and default line
  19309.        for each Echomail area you use. Create different CFG files using the
  19310.        name of your conference and the extension CFG; for example,
  19311.        PASCAL.CFG or GENERAL.CFG.  Place these files in the same
  19312.        directories where the other conference data files (HDR, MBR, MSG)
  19313.        are stored. The default values in SLMAIL.CFG apply to all areas for
  19314.        which specific data is not provided.
  19315.  
  19316.  
  19317.        --------------------------
  19318.        Echomail Network Addresses
  19319.        --------------------------
  19320.  
  19321.        Each Echomail message that you send requires a network zone, net,
  19322.        node, and sometimes a point address. These numbers are provided by
  19323.        the network coordinators in your area and serve to identify your
  19324.        bulletin board in the international network. They are included as
  19325.        part of the "Origin" line on messages created with your system.
  19326.  
  19327.        To install your network numbers, use the Conference Maintenance
  19328.        portion of the CONFIG program. Edit each echomail message conference
  19329.        and insert your address numbers. Because one bulletin board may wish
  19330.        to participate in several different networks, Searchlight supports
  19331.        the designation of different node numbers for each echomail
  19332.        conference; if you will only be using one set of node numbers, make
  19333.        sure you install these in each echomail area on your system. The
  19334.        point address is not required, and should be left with a value of
  19335.        zero if you do not have a point address.
  19336.        _____________________________________________________________________
  19337.                                         311
  19338.                                 APPENDIX F: SLMAIL
  19339.        _____________________________________________________________________
  19340.  
  19341.        See the section "Conference Maintenance - Edit Conference" for more
  19342.        information about editing conferences.
  19343.  
  19344.  
  19345.        -----
  19346.        NOTES
  19347.        -----
  19348.  
  19349.             * SLMAIL is compatible with single or multiuser versions of
  19350.               Searchlight. SLMAIL assumes the node number of the CONFIG
  19351.               file it finds in the current directory or in the specified
  19352.               path. When SLMAIL is active, no other Searchlight BBS or
  19353.               SLMAIL process must be allowed to be active on the same node
  19354.               number.
  19355.  
  19356.             * SLMAIL can run as part of a Door program or a scheduled
  19357.               event, as long as it accesses only the node from which the
  19358.               door or event was spawned.
  19359.  
  19360.             * If no "forward-from" text is given when sending mail, SLMAIL
  19361.               inserts its name and version number in the forward-from
  19362.               field.
  19363.  
  19364.             * The -D switch used with SLMAIL during fidonet imports
  19365.               disables SLMAIL from creating threads and the personal mail
  19366.               indexes that allow you to use the New/Personal function.
  19367.               Disabling these indexing operations will significantly
  19368.               improve the speed at which SLMAIL can import MSG files, and
  19369.               may be desirable if your system imports a large number of
  19370.               MSG files and you do not require threading or personal mail
  19371.               scans.
  19372.  
  19373.             * For additional information about optimizing the performance
  19374.               of SLMAIL for importing and exporting, check your READ.ME
  19375.               file.
  19376.  
  19377.  
  19378.  
  19379.  
  19380.  
  19381.  
  19382.  
  19383.  
  19384.  
  19385.  
  19386.  
  19387.  
  19388.  
  19389.  
  19390.  
  19391.  
  19392.  
  19393.  
  19394.  
  19395.        _____________________________________________________________________
  19396.                                         312
  19397.                       APPENDIX G: INTERNAL COMMAND REFERENCE
  19398.        _____________________________________________________________________
  19399.  
  19400.  
  19401.         -------------------------------------------------------------------
  19402.        | APPENDIX G: INTERNAL COMMAND REFERENCE                            |
  19403.         -------------------------------------------------------------------
  19404.  
  19405.        The following internal command functions are available at all times,
  19406.        from both the Main and Files menus:
  19407.  
  19408.  
  19409.        ----------------------------------
  19410.        Command #1 - Exit to Previous Menu
  19411.        ----------------------------------
  19412.  
  19413.        Causes an exit to the previous menu, when menus are called from other
  19414.        menus with the "Stack Menu" option enabled.
  19415.  
  19416.        By default, this command exits back to the menu immediately previous
  19417.        to the current menu. However, you can provide a command line
  19418.        parameter to make the exit command go back two or more menus. For
  19419.        example, if you want to exit 2 menus back, enter 2 as the command
  19420.        line parameter for this command, etc.
  19421.  
  19422.        The quit command can also take a menu name as a parameter instead of
  19423.        a number. When you use Quit with a menu name, the command quits back
  19424.        through the stacked menus until it hits the named menu. This enables
  19425.        you to return control to a particular place in your menu tree when
  19426.        you don't know the exact number of menus that are on the stack (a
  19427.        situation that can easily arise if you have menus on your system
  19428.        that can be reached via more than one path). For example:
  19429.  
  19430.             6. Command Number (1) ...... 1
  19431.             7. Command Parameters (1) .. MAIN
  19432.  
  19433.        This command would quit back to the MAIN menu, regardless of how many
  19434.        levels of menus were loaded between the main menu and the menu
  19435.        containing the quit command. (Note: if the menu name you use in line
  19436.        7 doesn't exist or isn't in the menu stack, then this command acts
  19437.        just like a regular Quit command with no parameter).
  19438.  
  19439.  
  19440.        ---------------------------
  19441.        Command #2 - Redisplay Menu
  19442.        ---------------------------
  19443.  
  19444.        For Word and Character prompted menus, this command draws or
  19445.        redisplays the menu (command #2 is associated with the "Help"
  19446.        command on the standard menus).
  19447.  
  19448.  
  19449.  
  19450.  
  19451.  
  19452.  
  19453.  
  19454.        _____________________________________________________________________
  19455.                                         313
  19456.                       APPENDIX G: INTERNAL COMMAND REFERENCE
  19457.        _____________________________________________________________________
  19458.  
  19459.  
  19460.        --------------------------------
  19461.        Command #3 - Pause for Keystroke
  19462.        --------------------------------
  19463.  
  19464.        This command produces the message, "Press [ENTER]:", and pauses until
  19465.        the Enter key is pressed. In RIP mode, you can append the switch /R
  19466.        to generate a small graphical "OK" box in the lower right hand part
  19467.        of the screen instead of the "Press [ENTER]" message.
  19468.  
  19469.  
  19470.        ----------------------
  19471.        Command #158 - Goodbye
  19472.        ----------------------
  19473.  
  19474.        The Goodbye command is used to log off of the system. It can be
  19475.        placed on any menu in either the Main or Files systems, and works
  19476.        regardless of how many menus are active at the time.
  19477.  
  19478.  
  19479.        ---------------------------
  19480.        Command #160 - Display File
  19481.        ---------------------------
  19482.  
  19483.        Command number 160 displays a text file on the screen, complete with
  19484.        "more" prompts, color code translation, and support for ^S, ^Q and
  19485.        ^C keys. The command requires a parameter which is the filename to
  19486.        display. You can specify either plain filename, or a filename with a
  19487.        complete path and drive letter. You can also precede the filename
  19488.        with "@" to indicate a file from the system TEXT directory, or "%"
  19489.        to indicate a file from the INCLUDE directory. For example, "@INFO"
  19490.        would display the file INFO.TXT, INFO.ANS or INFO.RIP from the
  19491.        system "TEXT" directory.
  19492.  
  19493.        As show here, you can omit the file extension if you'd like
  19494.        Searchlight to automatically select a text (TXT), Ansi (ANS) or RIP
  19495.        file depending on the user's terminal type.
  19496.  
  19497.        In RIP mode, you can choose to have Command 160 display your text
  19498.        file in a RIP browse box, using scroll bars and buttons instead of
  19499.        "more" prompts. To activate the RIP browse option, add a /R
  19500.        parameter to the command.  RIP browsing is most effective for text
  19501.        files; you may wish to disable it for ANSI or RIP files. In non-RIP
  19502.        mode, the /R parameter is ignored.
  19503.  
  19504.        In either RIP or text mode, you can use a /P switch to have
  19505.        Searchlight pause after displaying the file. In RIP mode,
  19506.        Searchlight produces a small "OK" button in the lower-right hand
  19507.        portion of the screen; in text mode, it generates a "Press Enter"
  19508.        message.
  19509.  
  19510.  
  19511.  
  19512.  
  19513.        _____________________________________________________________________
  19514.                                         314
  19515.                       APPENDIX G: INTERNAL COMMAND REFERENCE
  19516.        _____________________________________________________________________
  19517.  
  19518.  
  19519.        ----------------------------------
  19520.        Command #161 - Display JPG Picture
  19521.        ----------------------------------
  19522.  
  19523.        Command number 161 displays a JPG file on the remote user's terminal
  19524.        (provided that the remote user has a RIPterm 2.x or later terminal
  19525.        program).  As the command line, you give the full path to the JPG
  19526.        file you want to display, including the .JPG extension.
  19527.  
  19528.  
  19529.        ------------------------------
  19530.        Command #162 - Play Sound File
  19531.        ------------------------------
  19532.  
  19533.        Command number 162 plays a WAV sound file on the remote terminal
  19534.        (provided the remote terminal uses RIPterm 2.x or better). Give the
  19535.        full path to the sound file as the parameter (including the WAV
  19536.        extension).
  19537.  
  19538.  
  19539.         -------------------------------------------------------------------
  19540.        | COMMON PARAMETERS                                                 |
  19541.         -------------------------------------------------------------------
  19542.  
  19543.        These parameters can be used with any internal command with a command
  19544.        number of 100 or above.
  19545.  
  19546.  
  19547.        ----------------------------
  19548.        /X - Disable Heading Display
  19549.        ----------------------------
  19550.  
  19551.        By default, most internal commands, other than the global functions,
  19552.        will clear the screen and display the name of the command (from the
  19553.        description field on the menu) before executing.
  19554.  
  19555.        To disable that display, include "/X" in the parameter field for the
  19556.        command.  /X should come after any other parameters used with that
  19557.        command.
  19558.  
  19559.  
  19560.        -----------------------------------
  19561.        /Z - "Smart" Pause (Text mode only)
  19562.        -----------------------------------
  19563.  
  19564.        The smart pause feature pauses with the message "Press Any Key For
  19565.        The Menu" after executing an internal command -- but only under
  19566.        circumstances where a menu would automatically be displayed, or the
  19567.        screen would be cleared, or a text file would be displayed in
  19568.        conjunction with a Menubar menu, immediately after the command
  19569.        executes. "Smart" pause is typically used in conjunction with non
  19570.        interactive commands like "Who" and "Time" so that screen displays
  19571.        can be read before the next menu is displayed.  This command works
  19572.        _____________________________________________________________________
  19573.                                         315
  19574.                       APPENDIX G: INTERNAL COMMAND REFERENCE
  19575.        _____________________________________________________________________
  19576.  
  19577.        in non-RIP modes only. (In RIP mode, it is ignored, since all RIP
  19578.        features in Searchlight generate their own pauses where necessary).
  19579.  
  19580.  
  19581.        ----------------------------------
  19582.        /Y - "Smart" Pause (RIP mode only)
  19583.        ----------------------------------
  19584.  
  19585.        The global command parameter /Y can be used to suppress the clear
  19586.        screen that normally follows each command, but only in RIP mode. In
  19587.        other words, a command with a /Y parameter will generate a screen
  19588.        clear in non-RIP modes, but will not clear the screen in RIP mode.
  19589.        This behavior is often desirable, since most of Searchlight's RIP
  19590.        features appear as pop-up dialog boxes and do not require screen
  19591.        clears.
  19592.  
  19593.  
  19594.        ------------------
  19595.        /W - RIP Wallpaper
  19596.        ------------------
  19597.  
  19598.        This parameter lets you assign a RIP wallpaper to any internal
  19599.        command. For more information about wallpaper, see the section "RIP
  19600.        Graphics - Wallpaper."
  19601.  
  19602.  
  19603.  
  19604.  
  19605.  
  19606.  
  19607.  
  19608.  
  19609.  
  19610.  
  19611.  
  19612.  
  19613.  
  19614.  
  19615.  
  19616.  
  19617.  
  19618.  
  19619.  
  19620.  
  19621.  
  19622.  
  19623.  
  19624.  
  19625.  
  19626.  
  19627.  
  19628.  
  19629.  
  19630.  
  19631.        _____________________________________________________________________
  19632.                                         316
  19633.                       APPENDIX G: INTERNAL COMMAND REFERENCE
  19634.        _____________________________________________________________________
  19635.  
  19636.  
  19637.  
  19638.         -------------------------------------------------------------------
  19639.        | MESSAGE (MAIN) SYSTEM FUNCTIONS                                   |
  19640.         -------------------------------------------------------------------
  19641.  
  19642.        The following internal commands are available from the MAIN menu in
  19643.        Searchlight, and any of its submenus, except when the FILES menu is
  19644.        active.  Some commands have parameters, as described below.
  19645.  
  19646.          Function #  Name        Action
  19647.          ================================================================
  19648.          Message Group:
  19649.            100       Read        Read messages on current conference
  19650.            101       Jump        Jump to new conference
  19651.            102       List        List available conferences
  19652.            103       Edit        Edit a message on the current conference
  19653.            104       Kill        Delete message on current conference
  19654.            105       Post        Post message on the current conference
  19655.            106       Bulletin    Display the system bulletins menu
  19656.  
  19657.          Scan Group:
  19658.            110       Forward     Scan messages in forward direction
  19659.            111       Reverse     Scan messages in reverse direction
  19660.            112       Search      Search for text in messages or headers
  19661.            113       Personal    Personal message scan
  19662.  
  19663.          NEW Group:
  19664.            120       All         New message scan  on all conferences
  19665.            121       Joined      New message scan on joined conferences
  19666.            122       Conference  New message scan on current conference
  19667.            123       Personal    Scan for personal new messages
  19668.  
  19669.          Mail Group:
  19670.            130       Read        Read personal mail
  19671.            131       Send        Send private mail
  19672.            132       List        List mailbox contents
  19673.            133       New         Read new mail messages
  19674.            134       Find        Search mailbox for specific text
  19675.            135       Inquire     Check messages sent to other users
  19676.            136       Purge       Mass purge messages from mailbox
  19677.            137       MailCheck   Checks and reports number of new
  19678.                                  messages in mailbox, w/option to read
  19679.  
  19680.          Options Group:
  19681.            140       Info        Display/edit location, system type,
  19682.                                  phone number, password
  19683.            141       Preference  Display/edit user preferences
  19684.            142       Stats       Display user statistics (access levels,
  19685.                                  ratios, etc.)
  19686.            143       Access      Allows display & edit of user access
  19687.                                  levels & attributes
  19688.  
  19689.  
  19690.        _____________________________________________________________________
  19691.                                         317
  19692.                       APPENDIX G: INTERNAL COMMAND REFERENCE
  19693.        _____________________________________________________________________
  19694.  
  19695.          Function #  Name        Action
  19696.          ================================================================
  19697.          General Group:
  19698.            150       Ansi        Select ANSI mode
  19699.            151       Chat        Chat with Sysop or other users
  19700.            152       Doors       Loads "old style" DOORS.DEF menu
  19701.            153       Files       Enters the FILES program
  19702.            154       Quotes      Display user quotes
  19703.            155       Time        Display time information
  19704.            156       Version     Display version number
  19705.            157       Who         List who is online
  19706.  
  19707.          User Group:
  19708.            170       CallLog     List of last 75 callers
  19709.            171       Search      Search user file for names
  19710.            172       List        List user file contents
  19711.            173       Find        Locate text in user file
  19712.            174       Delete      Delete a user (Sysop function)
  19713.  
  19714.          Member Group:
  19715.            180       HighMsg     Display/modify high message pointer
  19716.            181       Search      Search for member names
  19717.            182       List        List conference members
  19718.            183       Join        Join user to conference
  19719.            184       UnJoin      Unjoin from conference
  19720.  
  19721.          Sysop Group:
  19722.            190       SysopFunc   Perform various Sysop functions
  19723.            194       TextEdit    Edit text file
  19724.            195       Relog       Recycle without carrier loss
  19725.  
  19726.          Special Group:
  19727.            200       LoadSub     Load conference areas
  19728.            201       LoadFiles   Load file areas
  19729.            210       SetPref     Set preference attributes
  19730.            211       ClearPref   Clear preference attributes
  19731.  
  19732.  
  19733.         -------------------------------------------------------------------
  19734.        | MAIN COMMAND OPTIONS                                              |
  19735.         -------------------------------------------------------------------
  19736.  
  19737.        -------------------
  19738.        Command #101 - Jump
  19739.        -------------------
  19740.  
  19741.        The Jump command has several possible parameters. To jump to a
  19742.        specific conference, give the conference name as the first
  19743.        parameter. "/V" toggles the "verbose" mode of this command. If
  19744.        specified, the command prints out the name of the conference and a
  19745.        short heading (i.e. number of messages).  Otherwise that is skipped.
  19746.  
  19747.  
  19748.  
  19749.        _____________________________________________________________________
  19750.                                         318
  19751.                       APPENDIX G: INTERNAL COMMAND REFERENCE
  19752.        _____________________________________________________________________
  19753.  
  19754.        You can specify an asterisk -- "*" -- as the conference name to jump
  19755.        to the current conference. This allows you to display the conference
  19756.        heading for the current conference at any time, without switching
  19757.        conferences.
  19758.  
  19759.        The conference list and jump commands (101 and 102) and the file list
  19760.        and jump commands (301 and 302) recognize a /V switch to suppress
  19761.        the default messages that appear when entering a new conference or
  19762.        directory. In RIP mode, these switches will eliminate the "Ok"
  19763.        status box when picking a directory or conference off of the list.
  19764.  
  19765.        The conference List and Jump commands recognize an /N switch to omit
  19766.        the eight-character conference name from the display. (On the Jump
  19767.        command, the conference name is replaced with its 40 character
  19768.        description). This switch can be useful on systems with a large
  19769.        number of conferences or where the short conference name is not
  19770.        sufficiently descriptive.
  19771.  
  19772.  
  19773.        ------------------------
  19774.        Command #106 - Bulletins
  19775.        ------------------------
  19776.  
  19777.        Add a conference name to the Bulletins command if you want to use a
  19778.        particular conference in place of the default BULLETIN conference.
  19779.        For more information and an example, see the section "Bulletins -
  19780.        Using an Alternate Bulletin Conference").
  19781.  
  19782.  
  19783.        ------------------------
  19784.        Command #130 - Read Mail
  19785.        ------------------------
  19786.  
  19787.        By default, mail is read in order from the oldest to the newest
  19788.        message. You can reverse this behavior by adding a /R switch to the
  19789.        command line. Reading mail in reverse order is especially useful if
  19790.        you tend to keep a large number of messages in your mailbox.
  19791.  
  19792.  
  19793.        ------------------------
  19794.        Command #131 - Send Mail
  19795.        ------------------------
  19796.  
  19797.        The Mail Send command can take the name of a user to whom the message
  19798.        is to be sent as a parameter. For example, to create a command that
  19799.        sends mail only to the Sysop, use "Sysop" as the first parameter.
  19800.  
  19801.        If /F is specified, then the mail send command forces mail to go to
  19802.        the username given on the command line (otherwise, the user could
  19803.        override that name with another).
  19804.  
  19805.        The /C parameter suppresses the carbon copy function, thereby
  19806.        allowing you to have Mail commands that can only send a message to a
  19807.        single user.
  19808.        _____________________________________________________________________
  19809.                                         319
  19810.                       APPENDIX G: INTERNAL COMMAND REFERENCE
  19811.        _____________________________________________________________________
  19812.  
  19813.        Finally, /O means override the post attributes of the mail
  19814.        conference, allowing anyone who can use the command to send mail.
  19815.        This is important if you want to set up a command that forces a user
  19816.        to send mail to the Sysop, for example, but you don't allow users to
  19817.        send general mail to anyone else.
  19818.  
  19819.        Here's an example of a command you might set up to send mail to the
  19820.        sysop (sometimes called "Comments" or "Feedback"):
  19821.  
  19822.             5. Command Number (1) ...... 131
  19823.             6. Command Parameters (1) .. SYSOP /f /c /o
  19824.  
  19825.        If you use Searchlight with Internet or Fidonet (FTSC) option
  19826.        packages, you can create special Send Mail commands that prompt
  19827.        callers for an Internet or Fidonet address. To prompt for Internet
  19828.        addresses, append the /I switch; for Fidonet, use /N. Although the
  19829.        standard Send Mail command can process either kind of address, these
  19830.        switches step your caller through the addressing process by
  19831.        requesting specific information. For example, the Internet command
  19832.        provides an example of an Internet address and checks the syntax of
  19833.        typed addresses.
  19834.  
  19835.        If you want to ensure that mail is sent only to a local address on
  19836.        your BBS (as opposed to an Internet or Fidonet destination), use the
  19837.        /L switch.
  19838.  
  19839.  
  19840.        --------------------
  19841.        Command #153 - Files
  19842.        --------------------
  19843.  
  19844.        Commands 153 and 330 are obsolete. These commands are supported for
  19845.        backward compatibility with old versions of Searchlight, but should
  19846.        be replaced by references to the FILES menu and the regular Quit
  19847.        command.
  19848.  
  19849.  
  19850.        ----------------------
  19851.        Command #158 - Goodbye
  19852.        ----------------------
  19853.  
  19854.        The Goodbye command sports two parameters. Parameter /N skips the
  19855.        "Yes/No" confirmation prompt, and allows you to proceed with the
  19856.        logoff without further prompting. Parameter /Q suppresses the
  19857.        "Please Leave a Quote" prompt, if that option is active. You may
  19858.        wish to use the Goodbye command with /N and/or /Q parameters to
  19859.        create a "quick logoff" command anywhere on your menus.
  19860.  
  19861.  
  19862.  
  19863.  
  19864.  
  19865.  
  19866.  
  19867.        _____________________________________________________________________
  19868.                                         320
  19869.                       APPENDIX G: INTERNAL COMMAND REFERENCE
  19870.        _____________________________________________________________________
  19871.  
  19872.  
  19873.        -----------------------------
  19874.        Command #190 - Sysop Function
  19875.        -----------------------------
  19876.  
  19877.        Command 190 acts as a dispatch for several Sysop level functions,
  19878.        including most of the functions on Searchlight's standard 2-Sysop
  19879.        menu and its submenus.
  19880.  
  19881.        The parameters are:
  19882.  
  19883.             A   Adjust user options
  19884.             V   Validate user
  19885.             I   View/change user info
  19886.             P   View/change user preferences
  19887.             S   View user stats
  19888.             C   View/change user access levels
  19889.             R   Read user's mail
  19890.             E   Send mail as a particular user
  19891.             L   List user's mail
  19892.             N   View user's new mail
  19893.             F   Find message in user's mailbox
  19894.             Q   Inquire function
  19895.             G   Mail purge function
  19896.  
  19897.  
  19898.        ------------------------------------
  19899.        Command #200 - Load Conference Areas
  19900.        ------------------------------------
  19901.  
  19902.        Internal command 200 can be used to load a particular list of
  19903.        conference areas from a text file:
  19904.  
  19905.             11. Command Number ...... 200
  19906.             12. Command Parameters .. SUBLIST1.TXT
  19907.  
  19908.        The file "SUBLIST1.TXT" is a text file listing the desired conference
  19909.        areas, one area per line, exactly the same way as they are listed in
  19910.        a MAIN.SUB text file. After executing this command, only the
  19911.        conferences listed in the text file are available. If the current
  19912.        conference is not part of that list, then Searchlight loads the
  19913.        first available conference (be sure that at least one conference is
  19914.        loaded and available).
  19915.  
  19916.        To clear a custom conference list or conference ordering, you can
  19917.        use command 200 again with a different filename parameter, or use
  19918.        command 200 with no parameter to load the default file list. See the
  19919.        section "Directory Maintenance - Custom Ordering" for more
  19920.        information about the format of the text file.
  19921.  
  19922.  
  19923.  
  19924.  
  19925.  
  19926.        _____________________________________________________________________
  19927.                                         321
  19928.                       APPENDIX G: INTERNAL COMMAND REFERENCE
  19929.        _____________________________________________________________________
  19930.  
  19931.        Note: Notice that the parameter to command 200 is a pathname. If a
  19932.              drive letter or directory is given, Searchlight loads the
  19933.              file from the specified drive and directory. Otherwise, the
  19934.              file is loaded from the current directory. You can take
  19935.              advantage of this behavior to make different conference lists
  19936.              available on different nodes in a multiuser system, if
  19937.              desired.
  19938.  
  19939.  
  19940.        ------------------------------
  19941.        Command #201 - Load File Areas
  19942.        ------------------------------
  19943.  
  19944.        Internal command 201 is similar to command 200, except that it is
  19945.        used to load a list of active file directories rather than a list of
  19946.        conferences:
  19947.  
  19948.             11. Command Number ...... 201
  19949.             12. Command Parameters .. DIRLIST1.TXT
  19950.  
  19951.  
  19952.        -------------------------------------------------------
  19953.        Commands #210 and 211 - Set/Clear Preference Attributes
  19954.        -------------------------------------------------------
  19955.  
  19956.        Internal commands 210 and 211 set and reset the current user's
  19957.        preference attributes. You can use command 210 to set preference
  19958.        attributes by listing the desired attributes as the parameter. Use
  19959.        command 211 to clear particular attributes.  For example:
  19960.  
  19961.             11. Command Number ...... 210
  19962.             12. Command Parameters .. ACFG
  19963.  
  19964.        This command would set preference attributes A,C,F and G in the
  19965.        current user's account. Commands 210 and 211 are useful when you
  19966.        want to create menu choices that allow users to select a preference
  19967.        attribute rather than type the attribute manually into their
  19968.        options. There are many other uses for these commands, for example,
  19969.        you could use them to automatically mark when a user has executed a
  19970.        particular command and set up your menu choices to skip that command
  19971.        later, based on preference attributes.
  19972.  
  19973.        If you append the switch /R to the command parameters for command 210
  19974.        or 211, Searchlight reloads the current menu.  If changes in the
  19975.        preference attributes would affect the current menu, this allows you
  19976.        to redisplay the changed menu (otherwise, the current menu would not
  19977.        be updated).
  19978.  
  19979.  
  19980.  
  19981.  
  19982.  
  19983.  
  19984.  
  19985.        _____________________________________________________________________
  19986.                                         322
  19987.                       APPENDIX G: INTERNAL COMMAND REFERENCE
  19988.        _____________________________________________________________________
  19989.  
  19990.  
  19991.         -------------------------------------------------------------------
  19992.        | FILES SYSTEM FUNCTIONS                                            |
  19993.         -------------------------------------------------------------------
  19994.  
  19995.        The following internal commands are available from FILES menus and
  19996.        their submenus; that is, any menus which are invoked after the files
  19997.        system (command 153) is active.
  19998.  
  19999.          Function #  Name        Action
  20000.          ================================================================
  20001.          List/Scan Group:
  20002.            300       Files       List files in current directory
  20003.            301       Jump        Jump to new directory
  20004.            302       List        List available directories
  20005.            303       New         List new files since specified date
  20006.            304       WideDir     Wide directory listing
  20007.            305       Zippy       Fast file search
  20008.  
  20009.          Edit Group:
  20010.            310       Copy        Copy file to new directory
  20011.            311       Edit        Edit file descriptions
  20012.            312       Kill        Delete files
  20013.            313       Move        Move file to new directory
  20014.            314       Passwd      Assign passwords to files
  20015.            315       Rename      Change name of file
  20016.            318       ClearTag    Clear tag list
  20017.            319       AddTag      Add files to tag list
  20018.  
  20019.          Application Group:
  20020.            320       Download    Download one or more files
  20021.            321       Upload      Upload one or more files
  20022.            322       Owner       Display file's owner & download count
  20023.            323       Type        Display text file to the screen
  20024.            324       View        View contents of ZIP/ARC/LZH file
  20025.  
  20026.          General Group:
  20027.            331       Status      Display ratio/disk space status
  20028.            332       Xproto      Change transfer protocol
  20029.  
  20030.          Sysop Group:
  20031.            340       Get         Load filenames from disk
  20032.            341       Import      Import names/descriptions from text file
  20033.            342       Update      Update internal directory
  20034.            343       Balance     Balance/repair directory structure
  20035.  
  20036.  
  20037.  
  20038.  
  20039.  
  20040.  
  20041.  
  20042.  
  20043.  
  20044.        _____________________________________________________________________
  20045.                                         323
  20046.                       APPENDIX G: INTERNAL COMMAND REFERENCE
  20047.        _____________________________________________________________________
  20048.  
  20049.  
  20050.        ----------------------------
  20051.        Directory Jump Command (301)
  20052.        ----------------------------
  20053.  
  20054.        The directory jump command (internal command number 301) supports
  20055.        two parameters: the name of the destination directory, and a /V
  20056.        option to suppress the display of the directory's name and number of
  20057.        available files.  You can use these options to construct commands
  20058.        which jump to a particular file directory. For example:
  20059.  
  20060.             11. Command Number ...... 301
  20061.             12. Command Parameters .. Uploads /x /v
  20062.             13. Command Number ...... 321
  20063.             14. Command Parameters .. /x
  20064.  
  20065.        This sequence creates an upload command that automatically jumps to
  20066.        the directory UPLOADS before executing the internal command to
  20067.        upload files.
  20068.  
  20069.  
  20070.        -------------------
  20071.        Tag List Management
  20072.        -------------------
  20073.  
  20074.        Searchlight includes internal commands to manipulate the tagged file
  20075.        list.  These commands are designed to make it easy for you to make
  20076.        internal commands that download a particular file or list of files,
  20077.        without the need to call external door programs.
  20078.  
  20079.        Internal command number 318 clears the global tag file list. You can
  20080.        use this command to ensure that no files are tagged, before adding
  20081.        files to a tag list yourself:
  20082.  
  20083.             11. Command Number ...... 318
  20084.             12. Command Parameters ..
  20085.  
  20086.        Command 319 adds one or more files to the tag list. Use this command
  20087.        to build specific lists of files that can be downloaded later with
  20088.        command 320 (Download). For example:
  20089.  
  20090.             11. Command Number ...... 319
  20091.             12. Command Parameters .. F2.ZIP LST.IX
  20092.  
  20093.        This command selects the two files listed and adds them to the user's
  20094.        tag list. The files listed must be in the currently active file
  20095.        directory. To ensure that this is the case, you will most likely
  20096.        want to use internal command 301 to jump to a particular directory
  20097.        before executing this command.
  20098.  
  20099.        You can use multiple sequences of command 301 and 319 to add files
  20100.        from different directories to a tag list (for example, as part of an
  20101.        execute menu). The tag list itself can hold up to 40 filenames. If
  20102.  
  20103.        _____________________________________________________________________
  20104.                                         324
  20105.                       APPENDIX G: INTERNAL COMMAND REFERENCE
  20106.        _____________________________________________________________________
  20107.  
  20108.        any of the filenames listed on the command lines are not found, they
  20109.        are not added to the list.
  20110.  
  20111.        Once a tag list is built, use command 320 to download the files. Two
  20112.        command line parameters for command 320 are available to help make
  20113.        downloading automatic. Parameter /F forces the download command to
  20114.        operate only on the files in the tag list, without the option to
  20115.        input additional filenames.  Parameter /T disables time limit
  20116.        checking on the download command; you may wish to use this option if
  20117.        you want users to be able to download a particular file regardless
  20118.        of time limits.
  20119.  
  20120.        A complete sequence of commands to select and download a particular
  20121.        list of files might look like this:
  20122.  
  20123.             11. Command Number ...... 318
  20124.             12. Command Parameters ..
  20125.             13. Command Number ...... 301
  20126.             14. Command Parameters .. DEMOS
  20127.             15. Command Number ...... 319
  20128.             16. Command Parameters .. DEMO350.ZIP
  20129.             17. Command Number ...... 320
  20130.             18. Command Parameters .. /F /T
  20131.  
  20132.  
  20133.  
  20134.  
  20135.  
  20136.  
  20137.  
  20138.  
  20139.  
  20140.  
  20141.  
  20142.  
  20143.  
  20144.  
  20145.  
  20146.  
  20147.  
  20148.  
  20149.  
  20150.  
  20151.  
  20152.  
  20153.  
  20154.  
  20155.  
  20156.  
  20157.  
  20158.  
  20159.  
  20160.  
  20161.  
  20162.        _____________________________________________________________________
  20163.                                         325
  20164.                         APPENDIX H: DIGIBOARD INSTALLATION
  20165.        _____________________________________________________________________
  20166.  
  20167.  
  20168.         -------------------------------------------------------------------
  20169.        | APPENDIX H: DIGIBOARD INSTALLATION AND USE                        |
  20170.         -------------------------------------------------------------------
  20171.  
  20172.  
  20173.        ------------
  20174.        Introduction
  20175.        ------------
  20176.  
  20177.        The use of DigiBoard* hardware with Searchlight BBS can greatly
  20178.        enhance performance, especially when Searchlight is used with high
  20179.        speed modems in a multiuser, multitasking environment. DigiBoards
  20180.        are the best choice when running more than 4 nodes from a single PC.
  20181.        This appendix will deal primarily with the intelligent variety of
  20182.        DigiBoards (models PC/Xe, PC/Xi, and COM/Xe). Although Searchlight
  20183.        will work with other Digi products, the intelligent DigiBoards are
  20184.        preferred because it is the on-board processing available in these
  20185.        models which provides most of the performance benefits.
  20186.  
  20187.        Before you begin working with a DigiBoard, we recommend that you are
  20188.        familiar with the procedures required to configure Searchlight and
  20189.        your system as a whole to be able to run the number of nodes you
  20190.        plan to install. This involves first installing Searchlight properly
  20191.        for the intended node count, then installing a multitasker (such as
  20192.        DESQview) so that simultaneous execution of all nodes is possible.
  20193.        If you are unfamiliar with the necessary procedures, please consult
  20194.        the appropriate sections of this manual for details.
  20195.  
  20196.  
  20197.        -------------------------------
  20198.        DigiBoard Hardware Installation
  20199.        -------------------------------
  20200.  
  20201.        Your DigiBoard product should arrive with a complete set of manuals
  20202.        covering hardware and software installation. For best results,
  20203.        consult these manuals first, and use the comments here as
  20204.        guidelines.
  20205.  
  20206.        There are three hardware parameters on the DigiBoard that should be
  20207.        set before the unit is physically installed inside your computer:
  20208.        these are the Memory Window, I/O Port, and IRQ. These options are
  20209.        set using a row of dip switches along the top of the DigiBoard unit.
  20210.  
  20211.        Memory Window and I/O Port should be chosen according to the
  20212.        guidelines in your DigiBoard manual. In general, the goal of setting
  20213.        these parameters is to avoid possible conflict with other hardware
  20214.        in your system. The default settings provided with your unit will
  20215.        probably work best, unless you have unusual hardware in your system
  20216.        which might conflict with the DigiBoard.
  20217.  
  20218.  
  20219.  
  20220.  
  20221.        _____________________________________________________________________
  20222.                                         326
  20223.                         APPENDIX H: DIGIBOARD INSTALLATION
  20224.        _____________________________________________________________________
  20225.  
  20226.        We recommend setting the IRQ number to 0, thus disabling interrupts.
  20227.        Searchlight does not require the use of an interrupt to use the
  20228.        DigiBoard hardware effectively.  Once the proper dip switch settings
  20229.        have been made, install the DigiBoard into a free slot inside your
  20230.        computer, and proceed with software installation.
  20231.  
  20232.  
  20233.        -------------------------------
  20234.        DigiBoard Software Installation
  20235.        -------------------------------
  20236.  
  20237.        Before Searchlight can communicate with your DigiBoard, you must
  20238.        install the DigiWare driver software into your system. Again, it is
  20239.        best to refer to Digi's software installation manual for complete
  20240.        information, and use our comments here as a guideline.
  20241.  
  20242.        Once the DigiWare software has been loaded on to your hard disk, run
  20243.        the configuration program (which is called XIDOSCFG.EXE for most
  20244.        Digi products).  Install your board, selecting the same Memory
  20245.        Window, I/O port and IRQ as you configured on the board's dip
  20246.        switches during the hardware installation.
  20247.  
  20248.        Set the Number Of Channels according to the number of ports on your
  20249.        DigiBoard: for example, 4 for a PC/4e or PC/4i, 8 for a PC/8e or
  20250.        PC/8i, or 16 if you have a PC/16e or PC/16i.
  20251.  
  20252.        The Starting Channel # specifies the logical channel number of the
  20253.        first physical port on your DigiBoard. This is largely an arbitrary
  20254.        number. If you already have a standard COM1 and COM2 port on your
  20255.        system, you may want to set the Starting Channel # to 3, as a
  20256.        reminder that the first DigiBoard port is really the third port
  20257.        available on your system. Be sure to remember what value you use
  20258.        here, because this is the number that Searchlight needs to know in
  20259.        order to access a particular DigiBoard channel.
  20260.  
  20261.        Be sure to specify EBIOS for the Driver Support parameter. This
  20262.        setting ensures that all of the DigiWare driver's extended functions
  20263.        are loaded into memory and available for use with Searchlight.
  20264.  
  20265.        It is not necessary to set the DigiBoard's channel parameters
  20266.        individually, since Searchlight will set these itself through
  20267.        software function calls.
  20268.  
  20269.        When you are done configuring the DigiWare driver, save your changes
  20270.        and then install the driver by placing a DEVICE statement in your
  20271.        CONFIG.SYS file.  For example:
  20272.  
  20273.             DEVICE = C:\DIGI\XIDOS5.SYS
  20274.  
  20275.        Now, reboot your system. You should see a message to the effect that
  20276.        the DigiWare driver is loaded successfully and the DigiBoard is
  20277.        responding properly. If there are any problems here, please go back
  20278.        and re-read DigiBoard's instruction manuals, and resolve the problem
  20279.        before you continue.
  20280.        _____________________________________________________________________
  20281.                                         327
  20282.                         APPENDIX H: DIGIBOARD INSTALLATION
  20283.        _____________________________________________________________________
  20284.  
  20285.        If you are using Quarterdeck's expanded memory manager (QEMM), one
  20286.        final step is necessary: you should inform QEMM about the RAM
  20287.        address space (Memory Window) being used by the DigiBoard. To do
  20288.        this, place the parameter ADAPTERRAM= on your QEMM.SYS line in your
  20289.        CONFIG.SYS file. For example:
  20290.  
  20291.             DEVICE = C:\QEMM.SYS ADAPTERRAM=D000-DFFF
  20292.  
  20293.        This statement would be correct if your DigiBoard were configured
  20294.        with D000 as the Memory Window. If you are using a different Memory
  20295.        Window, place the correct values into your QEMM command line.
  20296.  
  20297.  
  20298.        --------------------------------
  20299.        Using DigiBoard With Searchlight
  20300.        --------------------------------
  20301.  
  20302.        Once the DigiBoard hardware and software are correctly installed on
  20303.        your system, you are ready to tell Searchlight that you'd like to
  20304.        use the DigiBoard channels for communication. This is done by
  20305.        toggling the "Port Type" switch in the Communications Setup portion
  20306.        of the CONFIG program. Load the CONFIG program by typing "CONFIG" at
  20307.        the DOS prompt. Select option A, "General Configuration", then C,
  20308.        "Communications Setup". Move the lightbar to the last item, "COM
  20309.        Port Setup", and press Enter (or double click on "COM Port Setup"
  20310.        with your mouse). This reveals the communications port setup screen,
  20311.        which contains options for 4 COM ports.
  20312.  
  20313.        It is important to note that the 4 COM port settings shown here are
  20314.        not global to your entire system, but local to the node with which
  20315.        you are working. You can think of them as 4 presets for that node,
  20316.        enabling you to change a node's COM port selection quickly.
  20317.        Searchlight is not limited to 4 communications ports, since each
  20318.        node on your system can define COM1 through COM4 differently, in
  20319.        effect using different physical ports even though the "Com Port"
  20320.        number is the same.
  20321.  
  20322.        To specify DigiBoard support, pick one of the four available ports:
  20323.        we suggest using Port 3, so as to avoid changing the default COM1
  20324.        and COM2 settings. Change the Port Type to "DigiBoard". The next two
  20325.        settings, Base Address and Interrupt, do not apply to DigiBoard
  20326.        ports; therefore, you may leave them unchanged.
  20327.  
  20328.        The fourth parameter, External Port Number, is the most important
  20329.        value; this tells Searchlight which channel on the DigiBoard you
  20330.        want to use for that node. Remember that channel number refers to
  20331.        the "Starting Channel #" that you specified during the DigiWare
  20332.        installation procedure. If you set 3 as the starting channel number,
  20333.        as we recommended earlier, then place a 3 in the External Port
  20334.        Number field here if you want to access the first DigiBoard port.
  20335.        Use 4 to access the second port, 5 for the third, and so on. Of
  20336.        course if you used a different starting number when you installed
  20337.        the driver, then start with whatever number you used.
  20338.  
  20339.        _____________________________________________________________________
  20340.                                         328
  20341.                         APPENDIX H: DIGIBOARD INSTALLATION
  20342.        _____________________________________________________________________
  20343.  
  20344.        Finally, exit from the Com Port Setup screen. Go to line 1 of the
  20345.        Communications Setup screen, and place the appropriate number in "Com
  20346.        Port".  Remember that this number refers to the port number as set
  20347.        on the previous screen, not to any particular hardware port number.
  20348.        If you had modified Port 3 on the previous screen, then type "3"
  20349.        here.
  20350.  
  20351.        You need to repeat this procedure for additional nodes on your
  20352.        system. From DOS, switch to the home directory of Node 2 (i.e. the
  20353.        directory containing the CONFIG.SL2 file for Node 2), then run
  20354.        CONFIG, and repeat the above procedures.  Make sure you specify a
  20355.        different number for External Port Number, so that no two nodes try
  20356.        to use the same logical channel number.  It's OK if you configure
  20357.        the third Searchlight port number for DigiBoard access each time,
  20358.        since, as we mentioned earlier, those numbers are local to each node
  20359.        and do not have any effect on other nodes.
  20360.  
  20361.        If you have additional nodes of Searchlight which will not be using
  20362.        the DigiBoard, then simply ensure that they are properly configured
  20363.        for COM1 or COM2. No additional DigiBoard setup is required for
  20364.        those nodes.
  20365.  
  20366.  
  20367.        ---------------
  20368.        System Checkout
  20369.        ---------------
  20370.  
  20371.        Your system should now be properly configured for use with a
  20372.        DigiBoard. Plug a modem (or null modem device) into each DigiBoard
  20373.        port that you intend to use. To test your system, load DESQview or
  20374.        another multitasker, start Node 1, and make sure that it correctly
  20375.        accesses the modem which is plugged in to your DigiBoard. Then start
  20376.        Node 2, Node 3, etc. in each case verifying that the node is
  20377.        accessing the expected device.
  20378.  
  20379.  
  20380.  
  20381.  
  20382.  
  20383.  
  20384.  
  20385.  
  20386.  
  20387.  
  20388.  
  20389.  
  20390.  
  20391.  
  20392.  
  20393.  
  20394.  
  20395.  
  20396.  
  20397.  
  20398.        _____________________________________________________________________
  20399.                                         329
  20400.                         APPENDIX I: SEARCHLIGHT FOR WINDOWS
  20401.        _____________________________________________________________________
  20402.  
  20403.  
  20404.         -------------------------------------------------------------------
  20405.        | APPENDIX I: SEARCHLIGHT FOR WINDOWS                               |
  20406.         -------------------------------------------------------------------
  20407.  
  20408.  
  20409.        ------------
  20410.        Introduction
  20411.        ------------
  20412.  
  20413.        Your Searchlight BBS package includes separate versions for MS-DOS
  20414.        and Windows. You can run either or both versions of Searchlight BBS
  20415.        at your site, depending on your needs; they share the same
  20416.        databases, conferences and file libraries.
  20417.  
  20418.        The Windows version of Searchlight runs under Windows 95 or Windows
  20419.        NT. We recommend a minimum of a 486/66 CPU and 8mb if you run
  20420.        Windows 95, or 16mb for Windows NT. A Pentium CPU will provide
  20421.        significant performance benefits.  If you run Windows NT 3.51, be
  20422.        sure to install the latest service packs from Microsoft. We
  20423.        recommend upgrading to NT 4.0 as soon as possible.
  20424.  
  20425.        The Windows version of Searchlight will not run under DOS, Windows
  20426.        3.x, or OS/2.
  20427.  
  20428.  
  20429.        -------------------
  20430.        General Information
  20431.        -------------------
  20432.  
  20433.        Searchlight for Window uses 32-bit Windows code and Windows API
  20434.        function calls internally, but is externally similar to the DOS
  20435.        version. Searchlight for Windows supports ANSI, RIP and text
  20436.        interface modes, and uses the same internal command numbers, menus,
  20437.        and artwork as the DOS release. It can also run most of the same
  20438.        door programs as the DOS release.
  20439.  
  20440.        Searchlight creates a local text display in a console window when it
  20441.        executes. A console is a text window similar to what you might get
  20442.        when launching a command prompt under Windows 95 or NT. Although the
  20443.        console object has many of the same controls as a command prompt, it
  20444.        is not a DOS box; Searchlight is a fully 32-bit Windows application.
  20445.  
  20446.  
  20447.        --------------
  20448.        Communications
  20449.        --------------
  20450.  
  20451.        One major difference between DOS and Windows versions of Searchlight
  20452.        lies in the way serial communications are handled. Under DOS,
  20453.        Searchlight installs its own communications drivers that access
  20454.        serial port hardware directly, or it can use a DOS-based serial port
  20455.        driver (FOSSIL driver). With the DOS version of Searchlight, you use
  20456.  
  20457.        _____________________________________________________________________
  20458.                                         330
  20459.                         APPENDIX I: SEARCHLIGHT FOR WINDOWS
  20460.        _____________________________________________________________________
  20461.  
  20462.        Searchlight's own Config program to supply parameters like IRQ and
  20463.        port address (for nonstandard COM ports) or to select a particular
  20464.        type of hardware like a DigiBoard.
  20465.  
  20466.        Under Windows, Searchlight uses Windows services for communications.
  20467.        This has two advantages: communications are more efficient because
  20468.        they are handled by the operating system, and Searchlight can use
  20469.        any communications device which has a Windows driver.
  20470.  
  20471.        With the Windows version of Searchlight, if you have a communications
  20472.        port that uses a nonstandard IRQ or base address, you don't supply
  20473.        those parameters in Searchlight's config program. Instead, you
  20474.        supply them by configuring a Windows device driver in your control
  20475.        panel. If you use a DigiBoard or other advanced hardware device, you
  20476.        must install that device's Windows drivers and configure the device
  20477.        to appear as a specific COM port number or range of COM port
  20478.        numbers.
  20479.  
  20480.        Within Searchlight's setup program, you only need supply the COM port
  20481.        number you want to use; you don't need to specify a port type, base
  20482.        address, or IRQ. Searchlight automatically uses the operating system
  20483.        settings.
  20484.  
  20485.  
  20486.        ---------------------
  20487.        Setup/Monitor Program
  20488.        ---------------------
  20489.  
  20490.        The Windows program WSLBBS.EXE replaces the DOS CONFIG program. This
  20491.        program is a Windows GUI application that uses standard Windows
  20492.        controls to let you select and modify node and system properties. It
  20493.        also acts as a node monitor and central configuration utility for
  20494.        multinode systems. If you have more than one node, you can select a
  20495.        node and configure it from this utility's main screen. You can also
  20496.        launch nodes from here.
  20497.  
  20498.  
  20499.        --------------------
  20500.        Runtime Architecture
  20501.        --------------------
  20502.  
  20503.        The Windows version of Searchlight BBS is all 32-bit Windows code,
  20504.        except for the legacy code that is used to support DOS based Door
  20505.        programs. The Windows version has been entirely rewritten to take
  20506.        advantage of Win32 function calls and conventions for maximum
  20507.        performance and compatibility with 32-bit Windows.
  20508.  
  20509.        Almost all of the program code for Searchlight BBS is contained
  20510.        within a file called BBSLIB.DLL. This is a Windows Dynamic Link
  20511.        Library. The remaining code is in several much smaller EXE files.
  20512.  
  20513.  
  20514.  
  20515.  
  20516.        _____________________________________________________________________
  20517.                                          331
  20518.                         APPENDIX I: SEARCHLIGHT FOR WINDOWS
  20519.        _____________________________________________________________________
  20520.  
  20521.        You launch the Windows version of Searchlight by running the program
  20522.        SLBBS32.EXE, or by selecting a node in the Configuration program and
  20523.        using the Launch option. No matter how many nodes you launch,
  20524.        Windows only loads one copy of the BBSLIB.DLL file into memory.
  20525.        Thus, running a multinode BBS with Windows is a far less memory-
  20526.        intensive affair than with DOS, which requires that an entirely
  20527.        separate copy of the executable code be loaded for each node.
  20528.  
  20529.        Searchlight is a well-behaved Windows program which can safely be
  20530.        run alongside other Windows programs, including Searchlight's
  20531.        Spinnaker Web Server software.
  20532.  
  20533.        _____________________________________________________________________
  20534.  
  20535.                                        # # #
  20536.        _____________________________________________________________________
  20537.