home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Media Share 9
/
MEDIASHARE_09.ISO
/
bbsdoor
/
ansi320.zip
/
ANSIART.DOC
< prev
next >
Wrap
Text File
|
1992-09-19
|
14KB
|
379 lines
ANSi Art Gallery version 3.20
Documentation
Programmed by Roger Hu
NOTE: ANSi Art Gallery requires the ANSI.SYS device driver to be
installed. The program is not dependent on a FOSSIL driver.
────────────────
Installation
────────────────
1. Make a new directory called ANSIART under your main BBS directory.
2. Unpackage ALL files into the ANSIART directory. All files must be
present. Consult FILES.AAG for complete file listing.
3. Run ARTINST.EXE. You will be asked four questions about your system
and the setup will be easily finished.
DSZ Path
────────────────────────────────────────────
ANSi Art Gallery uses DSZ for its protocol(s) when uploading or
downloading. Make sure you know where DSZ.COM or DSZ.EXE is located
before you run the installation program.
Temporary directory
────────────────────────────────────────────
ANSi Art Gallery uses the temporary directory for temporarily storing
files users upload or download. Make sure this directory is EMPTY!
The door will erase ALL files in this directory when it is run by a
user or the sysop.
Validation of ANSi's uploaded to the door
────────────────────────────────────────────
This will specify whether or not you want to validate files yourself.
Answer (Y)es if you want to leave files unvalidated. This means that
each time a file is uploaded to ANSi Art Gallery, it will not be
accessible to any users until validated by the sysop (by renaming
x.NEW to x). Registered sysops have a special function that will
validate files. See Registration Information for details. Answer
(N)o if you want to have files auto-validated.
NOTE: The unregistered version of ANSi Art Gallery will only accept up
to 10 ANSi's.
PKZIP path
────────────────────────────────────────────
This is used when ANSi Art Gallery prompts the user whether or not to
compress all files into a ZIP file. This will minimize transfer time
and is an added feature in version 3.20.
4. This section is for REGISTERED USERS:
Create a file called REGISTER.CFG. Enter the registration name on the
first line, and the registration number on the next line. Make sure
you type in the BBS name EXACTLY as it appears on the registration
form, Ensure all spelling and capitalizing is correct.
Sample REGISTER.CFG:
ANSi Art Gallery Registered
11111
Using your favorite text editor, load/create SYSOP.LST. Enter all the
user names that will be able to access the Sysop Functions ('%' from
main menu). If the user is not in the SYSOP.LST file, the [%][Sysop
Functions] will not be displayed and cannot be accessed.
Sample SYSOP.LST: (Not case-sensitive)
Roger Hu
Sysop
5. ANSIART <DoorInfoFile> [PORT:<ADDRESS>:<COM port>]
Sample command line for use with a Door Info file
and standard COM port:
ANSIART C:\BBS\PCBOARD.SYS
Sample command line for a non-standard COM port 3
at Hex address "03e8":
ANSIART C:\BBS\PCBOARD.SYS PORT:03E8:3
ANSi Art Gallery, supports many BBS systems. If the BBS system you
are using can support at least one of the following files, then ANSi
Art Gallery should work with:
Door Information File BBS Software
───────────────────── ─────────────────────
DORINFOx.DEF RBBS, QBBS & others
DOOR.SYS Telegard, GAP, TAG
CALLINFO.BBS WildCat!
CHAIN.TXT WWIV
PCBOARD.SYS PCBoard
That's it!
─────────────────
FOSSIL Driver
─────────────────
If you would like to use a FOSSIL driver to speed up the program, or have a
non-standard port with ANSi Art Gallery, the parameters are as follows:
ANSIART <DoorInfoFile> [PORT:F:<COM port>]
Sample command line to use a FOSSIL driver on COM1:
ANSIART C:\BBS\PCBOARD.SYS PORT:F:1
─────────────
UART Chip
─────────────
Thanks to Rickie Belitz, ANSi Art Gallery will enable the 16550 or 16550A
UART Chip if present.
────────
OS/2
────────
Although ANSi Art Gallery does not use 32-bit operations, ANSi Art Gallery
should still work under OS/2. This program has been tested and compiled
under OS/2. Should problems arise, please contact the listed support
sites.
──────────────
Sysop Keys
──────────────
Function key Action Performed
──────────── ──────────────────────────────────────────
* F3 Toggle printer on/off
* F4 Toggle pagebell on/off
F5 Shell to DOS
* F7 Toggle caller alarm on/off
F8 Return user to system
F9 Toggle display on/off
F10 Chat mode (use the ESCAPE key to exit)
Alternate key Action Performed
────────────- ──────────────────────────────────────────
ALT-H Toggle between different status lines
* ALT-N Toggle sysop on next
* ALT-X Toggle exit to dos after call
and help lines
Alternately pressing the ALT-H key will bring up the next status
line screen. The 1st screen is a help screen, the second second
screen shows your COM port status.
* The function keys marked with an "*" will only be of use to systems
using PCBOARD.SYS. The rest are functional with any system.
──────────────
Protection
──────────────
I have attempted to add as much protection to your system as possible.
Users may attempt to send files to a different directory while batch
uploading. Using the "restrict" command in DSZ, I have minimized, if not
eliminated, the possibility of users tampering with the BBS. However, I
offer no responsibility if a user somehow is able to harm the system.
When a user selects a "single file upload" protocol, the user is prompted
to enter a filename. This filename, to help prevent any hackers, is first
split apart into directory, drive, filename, and extension. The filename
and extension are then put together, and the directory and drive are
excluded. This is an extra security measure for sysops. This also applies
when a user attempts to view an ANSi file.
───────────────
Error Codes
───────────────
ANSi Art Gallery will return an Errorlevel and display an error message if
something went wrong during execution. Here are what they correspond to:
Errorlevel Meaning
────────── ──────────────────────────────────────────────
0 Successful execution
1 Unable to open BBS system file
(PCBOARD.SYS, DOOR.SYS, etc.)
2 Problem reading BBS system file
3 Unrecognized BBS file type
4 Unable to open PCBOARD USERS file
5 Invalid User record or
problem seeking to user record
6 Problem reading USER record
7 PORT command syntax error
8 FOSSIL driver specified but no FOSSIL driver
installed
9 Memory allocation problem
If you still continue to have problems, contact one of the boards listed
below for help. Make sure you have the Errorlevel on-hand when you log in.
────────────────────────────
Registration Information
────────────────────────────
NOTE: Prices are subject to change. Offer expires August 1, 1993.
*** ANSi Art Gallery has lowered its registration fee! ***
Registration is only $5(US Dollars). If you
register ANSi Art Gallery, you will receive:
■ Support for ANSi Art Gallery - Support will be given as long as
ANSi Art Gallery is maintained by the authors.
■ Ability to catalog, upload and download an unlimited number of
ANSi's.
■ Registration code to personalize your copy of ANSi Art Gallery
with your BBS name.
■ Remote/local Sysops functions. This is an added feature
allowing you to edit, insert, and delete ANSi records. (See
PREVIEW.ANS to find out what these added functions are!).
═════════════════════════════════════════════════════════════════════════════
Registration Form ANSi Art Gallery 3.20
Basic Registration [ ] $ 5.00
ANSi Art Gallery Latest Version
5 1/4" disk [ ] $ 3.00
3 1/2" disk [ ] $ 5.00
NOTE: If you would like the latest version of ANSi Art Gallery
without having a disk sent, you may call any of the sites
and download it. If you have a FidoNet address, you may
request the file from address 1:161/704 (The Dark Side
408-251-0357).
Shipping for orders outside North America [ ] $ 5.00
══════════
Total Amount Enclosed $ __.__
(Expect at least 2 weeks delivery time for disks orders)
If you only mark the first box, then a letter with your registration code
will be included. If you would like an updated version of ANSi Art Gallery
with your registration, mark the second and/or third box.
Name to be registered to: __________________________________________
BBS Name: __________________________________________________________
FidoNet Address (if any): __________________________________________
Address: ___________________________________________________________
___________________________________________________________
___________________________________________________________
Where did you get this program? ____________________________________
___________________________________________________________
BBS Number: (___)___-____
Comments or Suggestions:____________________________________________
____________________________________________________________________
____________________________________________________________________
____________________________________________________________________
____________________________________________________________________
Send registration fees to:
26705 St. Francis Drive
Los Altos Hills, CA 94022
RE: Registration of ANSi Art Gallery
Make checks payable to Roger Hu
═════════════════════════════════════════════════════════════════════════════
Questions, Comments, or Suggestions can be answered by contacting the
following boards listed below:
The Dark Side (408)251-0357 14.4k Dual Std Alpha Center I TeleGard
Social Distortion (415)343-1501 14.4k Dual Std Alpha Center II TeleGard
The Fast Tracks (408)739-5781 14.4k v32/v32bis Alpha Center III TeleGard
Omega-One BBS (601)287-1336 14.4k Courier HST Beta Center I WildCat!
For information or help with ANSi Art Gallery Network Interface,
call The Dark Side.
Try to contact the alpha centers before attempting to leave a message on
Omega-One, since letters written to me on Omega-One may take some time to
obtain a response.
The latest versions of ANSi Art Gallery may be downloaded from any of these
support sites.
───────────
Credits
───────────
Original Programming by Stanley Hu
Thanks go out to Jedi for revising the documentation files.
Programmed in Turbo C with modem routines by Rickie Belitz.
Turbo C is a registered trademark of Borland International, Inc.
PCBoard is a registered trademark of Clark Development Company.
WildCat! is a registered trademark of Mustang Software.
SpitFire is a registered trademark of Buffallo Creek Software
RBBS-PC is copyright(c) Tom Mack, Capital PC Software Exchange.
QuickBBS is copyright(c) Adam Hudson.
DSZ is a registered trademark of Omen Technology.
OS/2 is a registered trademark of IBM Corporation.
You are running ANSi Art Gallery at your OWN RISK. The authors of AAG are
not liable for any damages caused by this program.
No portion of this distribution package should be sold for any sort of
profit nor may any portion be distributed with modification without the
prior written consent of Roger Hu.
I strongly suggest using PKSFANSI(tm) by Phil Katz. This program prevents
keyboard reassignments (also known as ANSi bombs) from uploads by malicious
users attempting to do harm to your system.
──────────────────
Modifications
──────────────────
Here are several modifications that may be in future releases:
■ There will be an unlimited number of ANSi's supported. Organizing
and sorting of ANSi's will need to be rewritten.
■ The batch downloading will be revised with windows.
■ Chat mode will hopefully support word wrap and perhaps a two
way/color chat will be implemented.
■ EMS/XMS Support for uploading and downloading.
■ Any commonly used BBS System not supported by ANSi Art Gallery.
───────────────
Definitions
───────────────
ANSi - A computer text file using the driver ANSI.SYS to display color
graphics and text.
AAG - ANSi Art Gallery