Metropoli BBS
VIEWER: pcbwall.doc MODE: TEXT (CP437)















                          ▄▄
     ▀███▀▀▀▀██▄▄    ▄██▀▀  ▀▀▄▄▌▀███▀▀▀▀██▄▄
      ███      ▀██▄ ▐██         ▌ ███      ▀██▄
      ███      ▄██▀ ██▌           ███      ▐██▀
     ▐███▄▄▄▄▄██▀  ▐██           ▐███▄▄▄▄▄██▀      ╥ ╥ ┬ ╓──┐ ╥    ╥
     ███            ██▌          ███      ▀██▄     ║ ║ │ ╟──┤ ║    ║
     ███            ▐██          ███        ███    ╙─╨─┘ ╨  ┴ ╨──┘ ╨──┘
    ▐██▌             ▀██▄▄  ▄▄▀▀▐██▌     ▄▄██▀
    ▀▀▀▀                  ▀▀    ▀▀▀▀▀▀▀▀▀▀▀



                       PCBWALL - PCBoard Graffiti Wall



                                Users Manual



                 Documentation and programming by Joseph Liu
                      Copyright (C) 1995 Oriental Royal


       All information herein is subject to change without prior notice


                          Dedicated to my mother


                         Made in Republic of China



   1  Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
        1.1  What is PCBWALL?  . . . . . . . . . . . . . . . . . . . . . .   2
        1.2  Features  . . . . . . . . . . . . . . . . . . . . . . . . . .   2
        1.3  System Requirements . . . . . . . . . . . . . . . . . . . . .   2
        1.4  License and Disclaimer  . . . . . . . . . . . . . . . . . . .   2

   2  Registrations  . . . . . . . . . . . . . . . . . . . . . . . . . . .   3

   3  Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
        3.1  Extract and Place PCBWALL Files to a New Directory  . . . . .   4
        3.2  PCBWALL.CFG Configuration . . . . . . . . . . . . . . . . . .   4
        3.3  PCBSETUP - CMD.LST Command Setup  . . . . . . . . . . . . . .   5

   4  Maintenance and Hints  . . . . . . . . . . . . . . . . . . . . . . .   5
        4.1  Deny a User Entering the PCBWALL  . . . . . . . . . . . . . .   5
        4.2  Multilingual Support  . . . . . . . . . . . . . . . . . . . .   5
        4.3  Customize Menu and Intro. for PCBWALL . . . . . . . . . . . .   6
        4.4  PCBWALL Commands  . . . . . . . . . . . . . . . . . . . . . .   6
        4.5  CALLERx logging . . . . . . . . . . . . . . . . . . . . . . .   6

   5  Troubleshooting  . . . . . . . . . . . . . . . . . . . . . . . . . .   7

   6  Technical Specs  . . . . . . . . . . . . . . . . . . . . . . . . . .   7

   7  Development  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7

   8  Credits  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7

   9  PCBWALL Help and Support . . . . . . . . . . . . . . . . . . . . . .   8

  10  Contacting the Author  . . . . . . . . . . . . . . . . . . . . . . .   8






























                                        - 1 -



   1  Introduction

   1.1  What is PCBWALL?

   PCBWALL is a PCBoard Graffiti Wall. It let users write few lines on the
   wall anonymously. A PCBoard-like user interface makes it seamless connect
   with PCBoard. The best of all is latest write is always on the top of the
   wall. This makes it more easier to read the wall. There are also sysop
   facility commands support and lots more!

   This program is a PCBoard Programming Executable (PPE). It works perfectly
   with all PCBoard security features (plus it's own trashcan support). This
   is really a neat PPE. You can't miss the program. :-)


   1.2  Features

      * PCBoard-like interface.

      * Latest write is always on the top of the wall.

      * Sysop only facility commands.

      * Take advantage of PCBoard color code.

      * non-hardcoded screen. All screen is customizible.

      * Support for "Trashcan" of unwanted users.

      * Multinode support.

      * Multilingual support.

      * dBase III+ support.

      * Self-maintenance.

      * CALLERx log file logging.

      * Very HIGH quality performance, very LOW registration fee.

      * Seamlessly works with PCBoard. (after registration)


   1.3  System Requirements

      * IBM PC, XT, AT or 100% compatible, with hard drive.

      * Microsoft MS-DOS or IBM PC-DOS 3.0 or higher.

      * PCBoard BBS Software 15.21 or higher.

      * At least 30 KB of RAM available after PCBoard is loaded.


   1.4  License and Disclaimer





                                        - 2 -



   "PCBWALL" refers to all executables and documentation as distributed in the
   compressed file in which the package was released and on the installation
   disk.

      * PCBWALL is copyrighted by Oriental Royal. It may only be used in
        agreement with the conditions set out in this license agreement.

      * PCBWALL is released as shareware. You may use PCBWALL for an
        evaluation period of one month. After this period you MUST either
        register PCBWALL or stop using it.

      * PCBWALL can ONLY be distributed without modification. You may compress
        it with another compressor but the distributed package MUST include
        all the original files.

      * You may not disassemble, reverse engineer, decompile, or modify any
        part of this program for any purpose other than those set forth in
        this document.

      * Registration is REQUIRED for commercial usage (in a commercial
        environment, such as business, governmental organization, association,
        school, foundation, or any other form of juridical person, or any
        system where PCBWALL is directly or indirectly used for profit)

      * PCBWALL may be distributed freely provided no money or any other
        compensation is asked or accepted without prior written permission
        from the author.

      * Although care has been taken to write and test a program that does
        what this document states, PCBWALL is provided as is, without warranty
        or guarantee of any kind, either expressed or implied, as to the
        fitness for a particular purpose, quality or performance of this
        program, except that PCBWALL will take disk space.

      * In no event shall Oriental Royal or Joseph Liu be liable to you or
        anyone else for any damages or cost, including, but not limited to,
        any lost profits, lost savings or lost income which may result from
        the use of PCBWALL.

      * In no way is Oriental Royal or Joseph Liu obligated to you or anyone
        else to provide future versions of, or support for PCBWALL.

      * Your use of PCBWALL constitutes your agreement to this license and
        disclaimer and your release of the author from any form of liability
        or litigation.


   2 Registrations

   PCBWALL is the best Graffiti Wall I've ever seen. If you like the program,
   please register.

   PCBWALL is a non-cripple Shareware. All functions in a registered version
   are the same as they are in a unregistered version except that there will
   be some delay and copyright message when you exit PCBWALL. All these will
   disappear after registration. PCBWALL works seamlessly with PCBoard after
   registration. PCBWALL may be used for a trial period of 30 days. PCBWALL
   must be registered if it is used after the trial period. The registration
   key is valid for all future versions of PCBWALL.


                                        - 3 -



   To register, fill out the file PCBWALL.REG that comes with this package and
   send it back to Joseph Liu along with the necessary payment. PCBWALL.REG
   contains the necessary information about the registration process.


   3  Installation

   Follows are step-by-step instructions in setting up PCBWALL. This chapter
   is for first time installation. If you are looking for information about
   maintenance. Refer to Chapter 4 of this manual.


   3.1  Extract and Place PCBWALL Files to a New Directory

   Make the directory that you want to place the PCBWALL files and change to
   that directory. Here we use M:\PCB\PPL\PCBWALL as example. Extract PCBWALL
   compressed file. If the file you received is not compressed with PKWare's
   PKZIP, chances are that someone has recompressed it.


   3.2  PCBWALL.CFG Configuration

   Your PCBWALL.CFG should resemble the following example. Modify it to suit
   your needs.

   === Top of PCBWALL.CFG ===
   100
   3
   110
   === Bottom of PCBWALL.CFG ===

   Line 1 : Maximum number of entries being kept on the wall

            When user writes something on the wall and the total number of
            entries in the database exceed the number here, PCBWALL will
            delete the oldest entries and keep the total number of entries
            equal to or less than the number.

   Line 2 : Maximum number of lines being written on the wall at a time

            Each time user writes on the wall, he is allowed to write few
            number of lines which is equal to or less than the number defined
            here.

   Line 3 : The security needed to delete entries, read whom post the entries

            This is usually equal to sysop security. Only users with security
            higher or equal to the security level defined here can delete
            lines, read the record number, date, time and writer's name of
            each line on the wall.











                                        - 4 -



   3.3  PCBSETUP - CMD.LST Command Setup

   The last thing, add PCBWALL.PPE to your CMD.LST. You can add it at
   conference specific CMD.LST or default CMD.LST. I recommend default
   CMD.LST. At PCBSETUP Main Menu, press "B" to File Locations, "B" again to
   Configuration Files. Now, you will see "Name/Loc of Default CMD.LST File",
   move the scrollbar to it and press F2 to edit.

 ╔═══════════════════════════════════════════════════════════════════════════╗
 ║                              CMD.LST Editor                               ║
 ║                                                                           ║
 ║                          Charges Per     PPE/MNU File Specification -or-  ║
 ║         Command    Sec  Minute    Use    Keystroke Substitution           ║
 ║     ══════════════ ═══ ═════════════════ ═══════════════════════════════  
 ║ 20) NALL            10        0        0 M:\PCB\PPL\LNZ\LNZ.PPE           ▒
 ║ 21) ZALL            10        0        0 M:\PCB\PPL\LNZ\LNZ.PPE           ▒
 ║ 22) PCBCD           10        0        0 M:\PCB\PPL\PCBCD\PCBCD.PPE       ▒
 ║ 23) WALL            10        0        0 M:\PCB\PPL\PCBWALL\PCBWALL.PPE   ▒
 ║                                                                           
 ║      ESC=Exit AltI=Insert AltD=Delete AltR=Repeat Alt5=25/50 F2=Edit      ║
 ╚═ 01:22:59 ═══ 03-03-95 ══════ F1 ═ help ════ caps: OFF  num: OFF  ins: OFF╝

   In the example above, WALL is the command to enter the Graffiti Wall, user
   with a security higher or equal to 10 can use it. No charge for the wall.
   And the path to the PPE is M:\PCB\PPL\PCBWALL\PCBWALL.PPE

   That's all! Congratulations! you can test your PCBWALL now.


   4  Maintenance and Hints

   4.1  Deny a user entering the PCBWALL

   PCBWALL supports trashcan file. If user's name is listed in the file, he or
   she can't enter PCBWALL. PCBWALL will check if there is a file called
   WALLTSH in the directory that you put PCBWALL.PPE in. If found, PCBWALL
   will check the list inside the file. If the name of the user online matches
   a name in the file, PCBWALL will stop him entering the PCBWALL.

   Your WALLTSH resembles this example:

   === Top of WALLTSH ===
   Bill Gates
   Your Father
   === Bottom of WALLTSH ===

   Hint: There is a trashcan file in PCBoard too. It's usually named TCAN
         in C:\PCB\MAIN\


   4.2  Multilingual Support

   PCBWALL has it's own language file. You can customize it to your own taste.
   The filename of the language file should be WALLTXT.??? while ??? is the
   extension that corresponds to your setting in PCBSETUP. Both PCBWALL and
   PCBoard use extension as the identification of different language files or
   menu. For example, you have your PCBoard French language file named
   PCBTEXT.FRE, then you should named PCBWALL language file WALLTXT.FRE.
   For more information about PCBoard language support, consult your manual.


                                        - 5 -



   Customize your language file based on the language file comes with the
   package.


   4.3  Customize Menu and Intro. for PCBWALL

   PCBWALL has 2 screen file. The filename are WALLMNU and WALLINT. Customize
   it on your own taste. You can have multilingual menu and intro. too.

   WALLMNU: This file is used as menu file which is displayed when user enter
            the wall. It displays PCBWALL commands and introduction. You may
            want to have some announcements here to let user know the rules of
            the wall on your BBS too.

   WALLINT: Most users are not familiar with PCBoard color codes. This file
            displays a table of PCBoard color codes when users want to write
            on the wall. Customize it if you don't like the default table.


   4.4  PCBWALL Commands

   Here is a list of PCBWALL Commands:

   (M)enu re-display     : Re-display PCBWALL menu. You will want to use it if
                           there is a line noise and your screen is screwed.

   (R)ead the wall       : Display the wall in reverse way (latest first) in
                           Force-Count-Lines mode. You can stop reading by
                           either answer 'N' to more prompt or press CTRL-K
                           (or CTRL-X).

   (L)eave the wall      : Quit the program.

   (S)ysop mode          : This command toggles sysop mode and is only
                           available if user's security is equal to or higher
                           than the security defined in PCBWALL.CFG. The
                           default value is off. When it's on, you will have
                           additional information (Record Number, Date, Time,
                           Name) displayed on the wall. This command is not
                           listed in WALLMNU.

   (W)rite on the wall   : Write lines on the wall. Enter alone to stop.
                           Before saving, it will display your lines with
                           colors (if there is color code) for reconfirmation.

   (D)elete entries      : If there is lines which users write you don't like,
                           you can delete them. Delete in reverse way too.
                           Enter 'Q' to quit at any time. If deletion starts
                           and you want to stop it for some reasons, press
                           CTRL-K to stop deletion immediately. Though, you
                           might lose some lines which was deleted.

   (P)rogram information : Display copyright and register information.


   4.5  CALLERx logging

   PCBWALL will log your system log file if user enter the wall, leave the
   wall or write lines on the wall.


                                        - 6 -



   This is an example:

      Opened PCBWALL at 15:07:40        <- time
      Words Left (PCBWALL): # 99        <- record number
      Words Left (PCBWALL): # 100
      Closed PCBWALL at 15:09:53


   5  Troubleshooting

   Q: When I enter PCBWALL, all message was screwed up. What happened?
   A: Check your language file. You probably have deleted the language file or
      some sentences in the language file is missing. There are 7 lines in
      the language file.


   Q: I can't even run the PPE (or it executes slowly), PCBoard reports some
      error message like "Unable to Allocate Memory".
   A: First, check if your PCBoard is 15.21 or higher. If not, upgrade your
      PCBoard before you run this program. PCBWALL is compiled by PPLC 3.10.

      Second, check the memory left after you load PCBoard. You can read it at
      the 2nd line of the status line in PCBoard. You must have 30k+ memory
      left.

      Third, increase the size of your overlay buffer of PCBOARD.EXE, a
      recommended value is 25. Use OVLSIZE to adjust the buffer size.


   6  Technical Specs

      * dBase III+ support.

      * Multinode support.

      * PCBoard-like user interface.

      * Special design : -SMART SEARCH- commands.

      * No error checking routine in PCBWALL.

      * CTRL-K, CTRL-X and CTRL-S support.

      * Write CALLERx log.


   7  Development

   Joseph Liu and Oriental Royal will continue developing PCBWALL in the
   future. All registration key is valid in all future version. Follows are
   the plans for next release:

      * RIPscrip support.


   8  Credits

   None this time.



                                        - 7 -



   9  PCBWALL Help and Support

   Leave a message to me (Joseph Liu) on Salt Air or RIME/Fido PCBOARD echo.

   You can always find latest version of PCBWALL at following place:

   Sirius BBS    : +886-2-961-0004 (USR Courier DS V.34)
   (Author's BBS)  +886-2-962-9282 (USR Courier DS V.34)

                   Join conference 5 (Oriental Royal Products)

   Salt Air BBS  : +1-801-261-8976 (V.34)

   FTP access    : wuarchive.wustl.edu
                   /pub/MSDOS_UPLOADS/ppe


   10  Contacting the Author

   Joseph Liu (Siri\/s / Oriental Royal), the author of PCBWALL, can be
   contacted at the following ways:

   Fidonet address:

   6:720/301

   The reply will be sent via normal netmail to the sender.

   Internet e-mail address:

   josephl@sirius.uuserv.net.tw

   Postal address:

   Joseph Liu
   3F, No.12, Lane 109, Sec. 2,
   San-ming Rd.
   Panchiao, Taipei Hsien
   Taiwan, Republic of China






















                                        - 8 -
[ RETURN TO DIRECTORY ]