▄▄
▀███▀▀▀▀██▄▄ ▄██▀▀ ▀▀▄▄▌▀███▀▀▀▀██▄▄
███ ▀██▄ ▐██ ▌ ███ ▀██▄
███ ▄██▀ ██▌ ███ ▐██▀
▐███▄▄▄▄▄██▀ ▐██ ▐███▄▄▄▄▄██▀ ╥ ╥ ┬ ╓──┐ ╥ ╥
███ ██▌ ███ ▀██▄ ║ ║ │ ╟──┤ ║ ║
███ ▐██ ███ ███ ╙─╨─┘ ╨ ┴ ╨──┘ ╨──┘
▐██▌ ▀██▄▄ ▄▄▀▀▐██▌ ▄▄██▀
▀▀▀▀ ▀▀ ▀▀▀▀▀▀▀▀▀▀▀
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 -