ÜÜ ßÛÛÛßßßßÛÛÜÜ ÜÛÛßß ßßÜÜÝßÛÛÛßßßßÛÛÜÜ ÛÛÛ ßÛÛÜ ÞÛÛ Ý ÛÛÛ ßÛÛÜ ÛÛÛ ÜÛÛß ÛÛÝ ÛÛÛ ÞÛÛß ÞÛÛÛÜÜÜÜÜÛÛß ÞÛÛ ÞÛÛÛÜÜÜÜÜÛÛß Ò Ò Â ÖÄÄ¿ Ò Ò ÛÛÛ ÛÛÝ ÛÛÛ ßÛÛÜ º º ³ ÇÄÄ´ º º ÛÛÛ ÞÛÛ ÛÛÛ ÛÛÛ ÓÄÐÄÙ Ð Á ÐÄÄÙ ÐÄÄÙ ÞÛÛÝ ßÛÛÜÜ ÜÜßßÞÛÛÝ ÜÜÛÛß ßßßß ßß ßßßßßßßßßßß PCBWALL - PCBoard Graffiti Wall Users Manual Documentation and programming by Joseph Liu Copyright (C) 1995-1996 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 3.4 Logon Wall Display Setup . . . . . . . . . . . . . . . . . . 5 4 Maintenance and Hints . . . . . . . . . . . . . . . . . . . . . . . 6 4.1 Deny a User Entering the PCBWALL . . . . . . . . . . . . . . 6 4.2 Multilingual Support . . . . . . . . . . . . . . . . . . . . 6 4.3 Customize Menu and Intro. for PCBWALL . . . . . . . . . . . . 6 4.4 PCBWALL Commands . . . . . . . . . . . . . . . . . . . . . . 6 4.5 CALLERx logging . . . . . . . . . . . . . . . . . . . . . . . 7 5 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . 7 6 Technical Specs . . . . . . . . . . . . . . . . . . . . . . . . . . 8 7 Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 8 Credits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 9 PCBWALL Help and Support . . . . . . . . . . . . . . . . . . . . . . 8 10 Contacting the Author . . . . . . . . . . . . . . . . . . . . . . . 9 - 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. And wall display during logon makes the the wall more popular. 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. * Display the wall during logon once per day or only if changed. * Multinode support. * Multilingual support. * dBase III+ support. * Self-maintenance. * CALLERx logfile 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.22 or higher. * At least 35 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 1 1 === 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. Line 4 : User who is on trashcan list can read the wall while logon. User whose name is on trashcan list can read the wall while logon if this is set to 1 (Yes), and vice versa (0 = No). - 4 - Line 5 : Option on logon wall display '2' tells PCBWALL to only display the wall if the date stamp on the database file is more recent than the caller's last logon date. '1' will show the wall to a user ONCE per day. '0' will show the wall every time the caller logon. 3.3 PCBSETUP - CMD.LST Command Setup One more thing, add PCBWALL.PPE to your CMD.LST. You can add it to 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 The setup is finished if the wall isn't displayed to user during logon. 3.4 Logon Wall Display Setup To display the wall during logon, just include the PPE in a display file or attach it to a prompt in the PCBTEXT *during logon* (before the main board menu is displayed). Make sure that it will be always run every time when a user logon, otherwise it's meaningless to setup Logon wall display option in your PCBWALL.CFG. Here on my BBS it's included in Logon script questionnaires. (PCBSETUP/File Loc./Newuser Logon&off Quest/Name&Loc of Logon Script Quest.) ==== Top of LOGON ===== !M:\PCB\PPL\PCBWALL\PCBWALL.PPE LOGON ==== Bottom of LOGON == LOGON parameter turns PCBWall into LOGON mode (display the wall without entering command) That's all! Congratulations! you can test your PCBWALL now. - 5 - 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. Customize your language file based on the language file comes with the package. 4.3 Customize Menu and Intro. for PCBWALL PCBWALL has 3 display file described below. Customize them 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. WALLLOG: This file is displayed just before the wall during logon. It's only used to tell user that follows are our graffiti wall context. So keep this file as brief as possible. 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. - 6 - (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 are lines that users write you don't like, just delete them. Deletion is 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. But it won't log if it's in LOGON mode. Here 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, I can't read nor write messages to the wall. I get error messages about the dBase file. A: First, check if you specified full path and filename of the PPE in your CMD.LST, for example: WALL 10 0 0 M:\PCB\PPL\PCBWALL\PCBWALL.PPE Second, if the PPE is run under a multi-node environment, make sure that you've loaded SHARE.EXE or enabled SHARE support in your network config. SHARE locks opened files from writing simultaneously by 2 or more node. If both ways above doesn't help, delete your PCBWALL.DBF and try again. Q: When I enter the wall, 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. - 7 - 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. 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 - 8 - 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 - 9 -