Beijing Paradise BBS Backup

home *** CD-ROM | disk | FTP | other *** search

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / PBNET185.ZIP / STRUCT.ZIP / INOUT / PBNET.DOC < prev next >

Wrap

Text File | 1995-03-31 | 13.8 KB | 378 lines

Powerboard 1.25a Fido compatible network interface (c) 1994 by Radu Hociung The PBNet Mail Scanner/tosser for Powerboard 1.25A User's Guide Version 1.84, February 1995 Copyright (c) 1994,1995 Radu Hociung. ALL RIGHTS RESERVED. PBNet is Copyright (c) 1994,1995 by Radu Hociung. Powerboard 1.25A is Copyright (c) 1993-1994 by NuIQ Software, Inc. No parts of the PBNet software or this document may be copied in part or in whole, except as provided by the License in the following pages. This version of PBNet is NOT public domain or free software, but is distributed as "shareware" for evaluation purposes only. Please refer to the license information in the following pages. The Powerboard BBS 1.25A is a trademark of NuIQ Software, Inc. Other product names found throughout this document are trademarks of various companies. o Copyright and Proprietary Rights The PBNet software is owned by Radu Hociung, and is protected by Canada copyright laws and international treaty provisions. The PBNet software contains valuable trade secrets proprietary to Radu Hociung, and NuIQ software Inc. You may not disassemble, decompile, reverse engineer, or create any derivative works of the software for any purpose other than making an adaptation to the software as a normal step in configuring it for your own personal use. o License and Restrictions Radu Hociung grants individuals a limited license to use the shareware version of PBNet for an evaluation period of up to 30 days in order to determine if it suits their needs. Any other use of PBNet, or use past the 30 day trial period requires the individual to purchase a license from Radu Hociung. PBNet is not "public domain" or "free" software. If you use it beyond the 30-day trial you MUST purchase a license. All users are granted a limited license to copy the shareware version of PBNet for the sole purpose of allowing others to try it, subject to the above as well as the following restrictions: - PBNet must be distributed in absolutely unmodified form in its entirety, including all file names, program code, documentation, and any related files. No other programs or files may be included. The files may be distributed in a compressed or library format. - PBNet may not be included in combination with any other software or hardware product as an enticement or for any other reason, without special permission from Radu Hociung. - No fee or payment may be charged or accepted for PBNet. Electronic bulletin board system operators (sysops) are encouraged to post the shareware version of PBNet on their BBS for downloading by their users, but only if the above conditions are met and no special fee is charged to access PBNet files (a general fee may be charged to access the BBS). Non-profit User Groups may distribute the shareware version of PBNet provided the above conditions are met. These User Groups may charge a nominal fee to cover the cost of the disk and copying of the software. o Warranty Disclaimer Radu Hociung makes no warranty of any kind, either express or implied,including but not limited to implied warranties of merchantability and fitness for a particular purpose, with respect to this software and accompanying documentation. IN NO EVENT SHALL RADU HOCIUNG BE LIABLE FOR ANY DAMAGES RESULTING FROM THE USE OF THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, INCIDENTAL OR CONSEQUENTIAL DAMAGES, OR OTHER FINANCIAL LOSS ARISING OUT OF THE USE OF OR INABILITY TO USE THIS PROGRAM, EVEN IF RADU HOCIUNG HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. o Ordering Information Purchasing a license for (or registering) PBNet, allows you to use the product beyond the 30-day trial period. With your registration, you will receive the PBNet registration key which will unlock all the registered functions and features of PBNet. Registration also entitles you to free lifetime technical support, free and discounted upgrades, priority notification on major new updates and releases. Registration costs just $15.00 plus $3 shipping (if you would like the key mailed to you. otherwise, netmailing the key is free). Please register now, and help me continue to make high quality software available to you at a low cost. o Ordering information Please Send Check or Money Order. I regret being unable to process credit card payments at this time. For current mailing address, please contact me at radu@io.org on the Internet Please use the enclosed register.frm for the ordering form. o What is it ? PBNet is a Fido-type driver for the Powerboard BBS package developed by Scott Brown. It can handle FidoNet, as well as other networks which are handled in a similar and compatible way. The node setup, FidoNet applications, and hub agreements are beyond the purpose of this text and will not be covered. o How do I install it on my Powerboard 1.25a BBS ? Once you have been assigned a node number by the network administrator, you can basically start receiving and sending echomail and netmail. You will need to install PBNet. PBNet consists of 3 key files: - PBNETOUT.EXE - the PBNet mail exporter - PBNETIN.EXE - the PBNet mail importer - PBNET.CFG - configuration file required by both the exporter and the importer. PBNet creates and uses the following files: - POINTERS.IDX This is where the high message pointers are kept. (PBNET directory) - *.LNK These are the files PBNet uses to keep track of the messages in your message base, for the purpose of building message threads, and for avoiding duplicate in/out mail. Do not delete any of these files, they are important to PBNet. 1. To install PBNet, create a PBNET directory off your mailer's root directory. That is, if you are using FrontDoor, you might create C:\FD\PBNET\ 2. Copy the three files mentioned above to the directory you just created. (PBNETIN.EXE, PBNETOUT.EXE, PBNET.CFG). 3. Edit PBNET.CFG and change it to reflect your setup. The variables PBNets needs set are: BBSAddress - Your BBS's network address (xxx:yyy/zzz) Ex: BBSAddress = 1:123/456 HUBAddress - Your HUB's network address (xxx:yyy/zzz) PktPassword - The password used for packet security. BBSPath - The path to Powerboard's main directory. MsgBasePath - The path to your message base directory Ex: MsgBasePath = C:\PB\MESSAGES\ InboundPath - This is the directory where PBNet will look for the incomming mail packets (*.PKT) OutboundPath - This is the directory where PBnet will place outgoing mail packets (*.PKT) MailerOutPath- This is the mailer's outbound directory, and it may be different from OutboundPath. PBNet will put mail for point systems off of your node in this directory, in .MSG files. (Hudson Message Format). AttachPath - This is where files attached to messages are placed by your mailer. (Ex: C:\FD\FILES\) LogFile - If you wish to keep a log of all your mail activities, set this variable to point to a log file. (Ex: C:\FD\PBNET\PBNET.LOG) OriginLine - This is a short descriptive line about your system. Many sysops put the BBS's name, address and phone number here. SysopName - If specified, PBNet will place netmail for this user in FrontDoor's MSG message base. CompressCommand - If specified, PBNet will compress outgoing mail using this command line. The first %s will be substituted with the archive name (internally generated), and the second with the PKT name (also internally generated). DecompressCommand - If specified, PBNet will attempt to decompress incomming mail using this command line. The meanings of the first and second %s are the same as above. If your feed sends your mail uncompressed, this line willl not be used. PBNet cannot guess what compression program has been used on incomming mail, but if the command line you gave it is not usable, the compressed mail will be left alone in the incomming directory. 4. Set-up your conferences to be exported/imported by PBNet: In PBNET.CFG, after the path and address variables, set up a block called AREAS, as in the following example: [AREAS] ; AreaTag PB_conf_number BUYNSEL 10 REQUEST 11 HINTS 13 NETMAIL 18 TRASH 19 [AREAS:END] As you noticed, in this block you list the conferences that are either echo or netmail conferences. If you get a message for a conference which you have not specified in PBNET.CFG, and you have a "TRASH" area, this is where the message will go. Otherwise, it will be ignored. The NETMAIL conference is also a 'special' conference. This is where the private, direct mail is placed, and ALL outgoing mail must be ADDRESSED, or it will be rejected. REMEMBER to put the [AREAS:END] line after the last area. Save PBNET.CFG. Set up your conferences with AREACFG.EXE, to match the settings in PBNET.CFG You're all set. Should you ever need to set a high pointer manually, use the HI.EXE utility which is included. Run is as in: HI 123 56993 to change the high exported message number in area #123 to 56993. To view a high message, type simply HI 123 to view the high message number for area #123. o How do I send NETMAIL ? Sending netmail is very easy and straight forward. Also, it is PowerMail compatible. To send netmail, all you need to do is put the address of the recepient after his/her name, as in: From: My Name To: Radu Hociung 1:250/642.1 Subject: How's it goin' pal ? If the address will not fit entirely in the To: field, put it on the first line of the message, as in: From: My Name To: Radu Hociung Longname Subject: How's it goin' pal ? ----------------------------------- To: 1:250/642.1 Hi, Radu .... o Can I send mail to someone on the Internet ? Yep. Write the message in the NETMAIL conference. To send Internet Mail to "radu@io.org", type the following in the To: Field: "To: radu@io.org 1:1/31". Then type your message as you would type any other message. Note 1: Your Internet gateway may be different from "1:1/31" ... substitute its address in the above example. Note 2: If the Internet address is too long to fit in the To: field, and still leave room for the gateway address, you can normally send mail to "UUCP 1:1/31" and then put the Internet address on the first line of the message, as in: From: My Name To: UUCP 1:1/31 Subject: How's it goin' pal ? ----------------------------------- To: radu@some.mailer.server.with.a.really.long.name Hi, Radu .... o My mailer intercepts PKTs and the messages never make it to the message base. What can I do ? Most mailers have a configuration or a run-time command- line-parameter which tells them not to unpack incoming PKTs. If you are using FrontDoor 2+, the command line switch is /NOUNPACK. Even if you get mail for one of your points, or for other systems, PBNet will do one of two things: 1. If the PKT has your node address stamp on it, the mail for your points will be unpacked as if FrontDoor unpacked it, so it will be sent out. 2. If the PKT does NOT have your address stamp on it, PBNet will ignore it. This may happen if you run multiple nets, in which case you will need to run a copy of PBNet for each of the nets you are carrying. o You still have questions ? Send me mail at either 1:250/642.1 on Fido or radu@io.org on the Internet.