SO MANY CD's (tm) 1. INTRODUCTION Do you have more CD-ROMs for your BBS callers than drives? If so, this package contains a pair of PCBoard (tm) PPE's that let users request files from offline CD's! Later, when the Sysop logs in, he is notified of any pending requests. If logged in at the local console, the Sysop is prompted to load the necessary CD's one at a time. Each requested file is posted as an attachment to a message addressed to the requesting caller and left in the corresponding CD-ROM conference. These messages are marked with an automatic expiration (pack-out) date so that the message (and the attached file) will be automatically deleted after a sysop-defined number of days. 2. REQUIREMENTS There are two PPE's: RQSTFILE and POSTFILE. RQSTFILE allows callers to leave requests for files from offline CD's; POSTFILE is used by the Sysop to respond to those requests. These PPE's require that: o There must be a separate PCBoard conference for each CD-ROM diskette. For run-time efficiency, it is best if all of the CD-ROM conferences can be assigned to a set of adjacent conference numbers, with no intervening non-CD-ROM conferences. o Each CD-ROM conference must be configured with a directory for file attachments to messages. Callers must be able to read, kill, and download messages in the conference; although it is not required, you may also wish to let them leave messages as well. o The display file for the list of file directories must be stored on the hard disk, not the CD-ROM. o The display files for the individual file directories must be stored on the hard disk, not the CD-ROM. o There must be a PCBoard v15.x index (IDX) file for accelerating access to the CD-ROM files, and it must be stored on the hard disk, not the CD-ROM. o "Caller Notes Support" must be installed, and at least one of the five note fields must be available. You can install Caller Notes by going Copyright (C) 1990-94, Key Software Products. All Rights Reserved SO MANY CD's (tm) to the main menu of the PCBoard System Manager (PCBSysMgr) and selecting option "D" (User Info File Maintenance), then selecting option "C" (Add PCBoard Supported Allocations), and then option "F" (Caller Notes Support). 3. INSTALLING THE PPE's The following assumes that you have unpacked the contents of the distribution file into a directory called C:\PPE\SOMANYCD. The minimum set of files required for operation are: RQSTFILE.PPE POSTFILE.PPE PENDING POSTED OFFLINE 3.1 Installing RQSTFILE.PPE RQSTFILE.PPE allows callers to request files from off-line CD-ROMs. To install it, use MKPCBTXT to change prompt #326 to: !C:\PPE\SOMANYCD\RQSTFILE.PPE @OPTEXT@ 9 12 1 10 12345678 20 The five numeric parameters at the end of the line must be changed to correspond to your particular PCBoard configuration as follows: o The first two parameters ("9" and "12" in the example above) should be replaced by the numbers of your first and last CD-ROM conferences. o The third parameter ("1" in the example above) selects which of the caller notes in the PCBoard user database is used to keep track of how many requests each user has pending. Valid entries for this parameter are 0 through 4; you must select a note field not already in use. o The fourth parameter ("10" in the example above) is the maximum number of pending requests for offline files allowed per user. (See access key next.) o The fifth parameter ("12345678" in the example above) is an access key, and is optional. Without a valid access key, your callers will be limited to a single pending request, regardless of the fourth Copyright (C) 1990-94, Key Software Products. All Rights Reserved SO MANY CD's (tm) parameter specified above. The access key is a sequence of eight hexadecimal characters derived from the name of your BBS as specified in PCBSETUP. o The sixth parameter ("20" in the example above) is the minimum caller's security level required to use RQSTFILE. If not specified, then all callers will be able to use RQSTFILE. 3.2 Installing POSTFILE.PPE POSTFILE.PPE allows the Sysop to process requests left by callers for files from offline CD-ROM's. To install it, you must create a LOGIN security file corresponding to the security level equal to or below the level assigned to the sysop. (POSTFILE compares the caller's security level against that of a sysop and only runs if they match.) The directory containing login security files is specified in PCBSetup. From the main menu, select option "B" (File Locations), then option "A" (System Files & Directories). The proper entry appears near the end of the entries of that page. As an example, if the sysop security level is 110, you should create a file called simply "110" (no extension) containing the following line of text: !C:\PPE\POSTFILE.PPE 9 12 1 7 The four numeric parameters at the end of the line must be changed to correspond to your particular PCBoard configuration as follows: o The first two parameters ("9" and "12" in the example above) should be replaced by the numbers of your first and last CD-ROM conferences. o The third parameter ("1" in the example above) selects which of the caller notes in the PCBoard user database is used to keep track of how many requests each user has pending. Valid entries for this parameter are 0 through 4; you must select a note field not already in use. o The fourth parameter ("7" in the example above) is the number of days before the posted file and associated message to the requesting user are deleted. Copyright (C) 1990-94, Key Software Products. All Rights Reserved SO MANY CD's (tm) To have the "expired" messages and their attached files deleted automatically, it is necessary to pack the message base in a PCBoard event that runs once each day. A simple batch command for doing this in the event is: PCBPACK /AREA:ALL /FAST /NOCALLER 4. HOW TO REACH US The Key Software Products telephone (415-364-9847) is shared by our BBS, FAX, and voice mail answering system. Approximate hours of operation are: Voice mail and FAX: 8am - 5pm PST (weekdays) BBS system: 5pm - 8am PST (24 hrs on weekends) BBS Parameters: 1200/2400/9600/14400 baud (v.32bis/v.42bis) 8 data bits, No Parity If your call is answered by the voice mail system, it can take a message that will be automatically forwarded to someone who can return your call as soon as possible. In addition, it offers a touch-tone driven menu of useful information about our product. To send us a FAX, follow the following steps: Step 1: You'll be greeted by our Voice Mail system which will prompt you to press 1 if you have a touch-tone phone. Step 2: Press 1. You'll then hear a menu that prompts you to press 5 to send a FAX. Step 3: Press 5. In a few seconds, you'll hear a FAX tone; press start on your FAX machine. That's all there is to it. Be sure to include your FAX number for the reply which will be sent back to you in one or two days. If you have access to electronic mail, you can send us a message via any of the following: On COMPUSERVE, send mail to: >Internet:tech.support@ksp.com On PRODIGY, send mail to: VGDC59A On INTERNET, UUCP, or BITNET, send mail to: Copyright (C) 1990-94, Key Software Products. All Rights Reserved SO MANY CD's (tm) tech.support@ksp.com On FIDONET, address mail to "UUCP" at nearest fidonet site which provides a gateway to Internet, such as 1:105/42. 1st line of message: To: tech.support@ksp.com On MCI, At the "To:" prompt enter: TECH SUPPORT (EMS) At the "EMS:" prompt enter: Internet At the "Mbx:" prompt enter: tech.support@ksp.com On APPLELINK, send mail to: tech.support@ksp.com@dasnet# On TELENET's Telemail Service: Send to: [INTERMAIL/USCISI]TELEMAIL/USA 1st line of message: Forward: ARPA 2nd line of message: To: tech.support@ksp.com 5. LIMITED WARRANTY This software is provided 'as is' without warranty of any kind, either expressed or implied, including, but not limited to the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the program is with you. Some states do not allow the exclusion of implied warranties, so the above exclusions may not apply to you. This warranty gives you specific legal rights and you may also have other rights which vary from state to state. Key Software Products has taken due care in preparing the documentation and software included in So Many CD's to ascertain their correctness and effectiveness. However, Key Software Products does not warrant that operation of this software will be uninterrupted or error free. In no event shall Key Software Products be liable for incidental or consequential damages in connection with or arising out of the furnishing, performance, or use of this software. LICENSE You MAY use this software on any computer or computers in your possession, but on no more than one computer at any given time. Copyright (C) 1990-94, Key Software Products. All Rights Reserved SO MANY CD's (tm) You MAY copy this software into any machine readable or printed form for backup or modification purposes in support of your use of the software. You MAY distribute the original unmodified, unlicensed version of this software, but you may not charge a fee exceeding $5.00 to cover the cost of duplicating, shipping, and handling. You may NOT distribute a licensed version of this software. You may NOT use, copy, modify, sublicense, assign or transfer this software and its license, or any copy or modification, in whole or in part, except as expressly provided for in this license. Copyright (C) 1990-94, Key Software Products. All Rights Reserved