Beijing Paradise BBS Backup

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

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / CSPRO10.ZIP / CSPRO.DOC < prev next >

Wrap

Text File | 1993-11-13 | 100KB | 2,515 lines

CATSCAN PROFESSIONAL An Upload File Processor and Virus Scanning Program for Bulletin Board Systems Version 1.0 Copyright 1993 by Scott Green / Mike Ortiz "The Intelligent File Processor" Table of Contents ----------------------------------------------------------------- 1.0 Trademark and Copyright Information . . . . . . . . . . . .3 2.0 Catscan Professional Licensing Agreement. . . . . . . . . .3 3.0 Program Support . . . . . . . . . . . . . . . . . . . . . .3 4.0 Warranty . . . . . . . . . . . . . . . . . . . . . . . . .4 5.0 Catscan Professional Introduction . . . . . . . . . . . . .4 5.1 Hardware Requirements. . . . . . . . . . . . . . . . .4 5.2 Catscan Professional Features. . . . . . . . . . . . .5 5.3 What will Catscan Professional do for me . . . . . . .6 6.0 Installation. . . . . . . . . . . . . . . . . . . . . . . .7 6.1 Files used with Catscan Professional . . . . . . . . .7 6.1.1 ADDNAMES.TXT . . . . . . . . . . . . . . . . . .8 6.1.2 BADNAMES.TXT . . . . . . . . . . . . . . . . . .8 6.1.3 CAPTURE .TXT . . . . . . . . . . . . . . . . . .9 6.1.4 KEEPAV .TXT . . . . . . . . . . . . . . . . . .9 6.1.5 TXTNAMES.TXT . . . . . . . . . . . . . . . . . .9 6.1.6 ZIP .CMT . . . . . . . . . . . . . . . . . 10 6.2 Message Files used with Catscan Professional . . . . 10 6.2.1 @ Macros used with messages. . . . . . . . . . 11 6.2.1 INFOMSG .TXT . . . . . . . . . . . . . . . . . 11 6.3 Screen Files used with Catscan Professional. . . . . 11 7.0 Configuration with CSEDIT . . . . . . . . . . . . . . . . 12 7.1 CSEDIT / PATHS . . . . . . . . . . . . . . . . . . . 13 7.2 CSEDIT / GENERAL . . . . . . . . . . . . . . . . . . 15 7.3 CSEDIT / OPTIONS . . . . . . . . . . . . . . . . . . 24 7.3.1 CSEDIT / OPTIONS / SCANNERS SETUP. . . . . . . 25 7.3.2 CSEDIT / OPTIONS / SCAN DIRS ONLY. . . . . . . 26 7.3.3 CSEDIT / OPTIONS / EXCLUDE DIRS. . . . . . . . 26 7.3.4 CSEDIT / OPTIONS / EXCLUDE SECURITY. . . . . . 27 7.4 CSEDIT / EXTERNALS . . . . . . . . . . . . . . . . . 27 7.4.1 CSEDIT / EXTERNALS / ARCHIVERS . . . . . . . . 28 7.4.2 CSEDIT / EXTERNALS / GIF PROCESSING. . . . . . 29 7.5 CSEDIT / IMPORT-EXPORT . . . . . . . . . . . . . . . 34 7.6 CSEDIT / FILE. . . . . . . . . . . . . . . . . . . . 35 7.6.1 CSEDIT / FILE / SAVE CONFIG. . . . . . . . . . 35 7.6.2 CSEDIT / FILE / LOAD CONFIG. . . . . . . . . . 35 7.6.3 CSEDIT / FILE / EXIT . . . . . . . . . . . . . 35 8.0 Catscan Professional Command Line Options . . . . . . . . 36 9.0 Creating a Custom ANSI Screen . . . . . . . . . . . . . . 37 10.0 Using CatScan Professional with Uart and DigiBoards . . . 38 11.0 Testing Your Configuration. . . . . . . . . . . . . . . . 39 12.0 Processing Files with Catscan Professional. . . . . . . . 40 12.1 Processing files after Upload. . . . . . . . . . . . 40 12.2 Processing Uploaded Files in an Event. . . . . . . . 40 13.0 Catscan Professional Support Sites. . . . . . . . . . . . 41 14.0 Registering Catscan Professional. . . . . . . . . . . . . 41 15.0 Acknowledgements. . . . . . . . . . . . . . . . . . . . . 43 ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 2 1.0 ... Trademark and Copyright Information Catscan Professional, CSPro, and CSEdit are trademarks of City Limits Software and PC Connections. All other trademarks are the property of their respective owners. Their use in this documentation does not constitute that City Limits Software or PC Connections, has attempted to claim ownership of, or endorse the use of these products or programs. Catscan Professional is Copyrighted by City Limits Software and PC Connections, 1993. All Rights Reserved. 2.0 ... Catscan Professional Licensing Agreement Catscan Professional uses a special KEY file to allow operation in either the DEMO or REGISTERED mode. Before CSPro will operate, the demo key must be obtained from one of the Catscan Professional support boards. This demo key may not be distributed in any form. Sysops are allowed to evaluate Catscan Professional for a period of 30 days. After which, the Sysop MUST register the program or discontinue its use. Catscan Professional is not "Cripple Ware". All features of the program are fully functional during the 30 day evaluation period. The Catscan Professional distribution archive files may not be modified in any way. This includes adding special archive comments or other files that would advertise or promote any organization. The original Catscan Professional archive file may be distributed so long as no KEY files are contained in the archive. No special fee may be charged for the distribution of Catscan Professional. Pay BBS systems may distribute Catscan Professional, as long as the above conditions have been met. 3.0 ... Program Support Catscan Professional is fully supported by the authors. Every effort was made to insure that the installation of If any problem is encountered during installation or the normal operation of Catscan Professional, please feel free to call any of the support sites listed in section 13.0 - Catscan Professional Support Sites. ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 3 4.0 ... Warranty Catscan Professional is provided "As Is" with no other warranty either expressed or implied. You assume all risks associated with the use or misuse of Catscan Professional. The authors of Catscan Professional, Scott Green, Mike Ortiz, and their respective companies will not be liable for any damages, service, repair, loss of profit, or loss of savings associated with the use of Catscan Professional. The only guarantee expressed is that Catscan Professional will occupy disk space. Catscan Professional may have bugs, as found in any commercial program. 5.0 ... Catscan Professional Introduction Thank you for taking the time to use Catscan Professional. You have chosen the state-of-the-art in Upload File Processors. No other upload file processor provides the rich feature set that Catscan Professional provides its users. Catscan Professional, or CSPro for short, was born out of the necessity for quality, virus free files available for user download. This is, very possibly, the finest and most important service that you can provide your users. Your users will not worry about files downloaded from your BBS, after the files are processed by CSPro. 5.1 ... Hardware Requirements CSPro will function on any IBM PC or compatible computer. Memory requirements will vary based on the operation being performed on the file in process. It is recommended that 450 k-bytes of free conventional memory be available for proper operation. XMS Memory is not required, but if available, will be used by CSPro to further enhance program operation. ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 4 5.2 ... Catscan Professional Features Catscan Professional offers the Sysop many features that are not found in any other Upload File Processor. The following are but a few of the many features available with CSPro. o CSPro creates temp directories from a work directory, allowing you to have all the temp directories created from within the same work directory. o CSPro has the ability to move failed files to a bad directory. o CSPro has two different ways to check the date of files. o You can set the archive date by Current Date, Oldest File, Newest File, or Original Date. o Supports ZIP, LZH, ARJ, PAK, ARC, ZOO, SDN, TD0, and user definables USR1 through USR7. o Converts files to any default archive format. o Option to not recompress archives of the same type as your default. o Converts non-compressed files to your compression default. o Place an archive comment on any file compressed with an archiver supporting archive comments. o Will convert self extracting files to your default archive compression. o Can retain all -AV signatures, a list of certain ones, or remove them completely. o Capture comments from archive files before their replaced with your own comment. o Writes GIF, JPG and/or just archive files to a RUNLATER.TXT file for later processing. o A 32 bit CRC duplicate file checking system eliminating duplicate files on the BBS. o Ability to move failed files to a file area on the BBS. o Stop processing after the current file if ESC is pressed. ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 5 o Seconds to delay on passed and failed files. o Two separate Sysop names for sending and receiving mail o Sends internal BBS messages to users and Sysop. o Ability to turn off screen display for slow baud rates. o Works on either Serial (Uart) or DIGI ports. o Can delay processing and converting of SDN files. o CSPro can create SDI or DIZ files in the archive file. o Creates an EXTRA INFO message for files not containing FILE_ID.DIZ description files. o Can use up to 15 different virus scanners. o CSPro can fail GIF files by GIF resolution or integrity. o Converts JPG to GIF, GIF to JPG, or GIF to Giflite. o Enters the GIF Resolution in the short description. o Imports and Exports to an ASCII text file for easy upgrading. o Context sensitive help for every entry field in CSEdit. 5.3 ... What will Catscan Professional do for me? If you are a Sysop then you know the extra work involved in keeping your BBS files virus clean and up to date with the latest archiver. With more and more users and Sysops having 14.4k baud modems, a greater number of files are being transferred to and from BBS's. Imagine the ability to set up a program that can take care of all your files uploaded to your system automatically. CSPro can make your file area appear like a hard working Sysop is behind all the work. CSPro will effortlessly maintain your file area for you and perform these basic functions; scan every file for viruses using up to 15 virus scanners, convert any noncompressed files to your choice of archivers, or convert archives not in your default archive format. All this can happen automatically and CSPro will change everything on your BBS to reflect any changes it made to the file. The options mentioned so far are just the basic functions that a file scanner needs. However CSPro has many more options to simplify the Sysop's life, which are too numerous to mention again in this DOC file. For ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 6 more information on what features CSPro has available to you see section entitled "CatScan Professional Features". 6.0 ... Installation of CatScan Professional. Installation of CSPro consists of creating a directory to hold all of the accessory files needed for CSPro to operate. This directory will be called the "CSPro Home Directory". In our example we will create a directory called CSPRO on the C: drive. The following commands will accomplish this for you. C: MD \CSPRO CD \CSPRO You should now uncompress all the files contained in the CSPRO*.ZIP archive to the C:\CSPRO directory. The following command will do this for you. We are assuming that you have PKZIP version 2.04g and that it is in your DOS PATH. We will also assume that the CSPRO*.ZIP is in the C:\DOWN directory. PKUNZIP C:\DOWN\CSPRO*.ZIP At this point all the working files should be in the CSPRO directory on your C: drive. Keep in mind that if you wish to use another drive or directory then you may do so. The CSPro Home Directory, must also exist in the DOS path. The DOS path indicates the directories DOS searches for a program file that you want to run, including the current directory. To place the CSPro Home Directory into the DOS path, edit your AUTOEXEC.BAT file with any ASCII text editor. Place the cursor on a blank line, and type the following: PATH=C:\CSPRO Replace the C:\CSPRO with the directory that you have just placed all of the CSPro distribution files into. If you already have a PATH statement, add C:\CSPRO to the end. 6.1 ... Files used with Catscan Professional The following files are used by CSPro during normal operation. These files are maintained by the Sysop with any ASCII text editor. These files must reside in the CSPro Home Directory. ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 7 6.1.1 ... ADDNAMES.TXT This file is used when CSPro is configured to add a file to the uploaded archive. Many Sysops wish to add a file to each uploaded archive file to advertise their BBS. This file allows the Sysop to specify a file to be added to the archive, and a list of random names to call the file when added to the archive. The format of this file is as follows: C:\CSPRO\MYBBS.AD README.NOW THEBEST.BBS CALLMY.BBS README.1ST HAPPY.BBS The first line of ADDNAMES.TXT is used to define the drive, directory, and name of the original file to add to the archive. The following lines are used to rename the original file when it is put into the archive file. There is no limit to the number of names that may be placed into this file, as long as the first line specifies an existing file. 6.1.2 ... BADNAMES.TXT This file is used to specify a list of file names that the Sysop wishes to be removed from all uploaded archive files. Most Sysops do not want other BBS ads in the files that are available for download. In the past, this was a tedious process, in which the Sysop, or Co-Sysop, had to look at each uploaded file and delete any unnecessary files that existed in the archive. When CSPro is used to process the uploaded archive this task is virtually eliminated. After you have found a file in an uploaded archive that is a BBS ad, simply add the name of this file to the BADNAMES.TXT file. It is also possible to add the 32 bit CRC value of the BBS ad to the BADNAMES.TXT file. To obtain this value, use the provided CSCRCBR.EXE program and find the file name. The 32 bit CRC value is displayed in the right most column of the screen. This method may be used to eliminate BBS ads in which the file name rotates much like the ADDNAMES.TXT description above. The format of BADNAMES.TXT is as follows: README.NOW THEBEST.BBS CALLMY.BBS README.1ST HAPPY.BBS -1906333621 210555281 1261087244 ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 8 The first five lines in this example are specific file names that are to be deleted from the archive. The following three lines denote specific 32 bit CRC values of files to be removed from the archive file. Note that negative numbers are supported. When CRC values are used the file will be found even if the file name changes. 6.1.3 ... CAPTURE.TXT This file is used to maintain a list of all comments that were placed in the uploaded archive files. Some archive files will be uploaded with a BBS ad in the form of an archive comment. Currently ZIP, LZH, and ARJ files support archive comments. The Sysop may wish to place a comment on the uploaded file, but at a later date, determine the BBS from which the file originated. Reference the configuration option "Capture Uploaded Comments in CAPTURE.TXT" in the section entitled "CSEDIT / GENERAL" for further configuration. 6.1.4 ... KEEPAV.TXT Some archive files created by PKZIP contain a unique signature that insures that the file was not tampered with after original creation. This signature is called the "AV" or "Authentic Verification" signature. The Sysop may wish to leave this signature intact. To configure CSPro to allow this feature simply add the AV value, each on a separate line, of all signatures that you wish to remain intact. The format for KEEPAV.TXT is as follows: UUM818 PKW655 TYR931 When CSPro encounters a file with one of the above signatures the file will not be recompressed after processing. CSPro will make all other tests on the file. Reference the configuration option "Do What with -AV Files" in the section "CSEDIT / GENERAL" for further configuration. 6.1.5 ... TXTNAMES.TXT This file is used to define a list of file extensions that will be converted to the default archive type. This feature is used when the Sysop wishes to have all uploaded files compressed to ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 9 save disk space. Files such as DOC, TXT, WAV, and many others are not compressed before upload. If CSPro encounters a file in which the extension exists in TXTNAMES.TXT, the file will be converted to the default archive type. The format of TXTNAMES.TXT is as follows: TXT DOC WAV ROL Any file that is uploaded with one of the above extensions will be converted to the default archive type. Reference the configuration option "Compress TXT files from TXTNAMES.TXT" found in "CSEDIT / GENERAL" for further configuration. 6.1.6 ... ZIP.CMT This file is used by CSPro when an archive comment is placed on an uploaded archive file. Most Sysops choose to place a comment on ZIP, ARJ, and LZH files. This comment is generally an advertisement for the Sysop's BBS. This file may be created and maintained with any ASCII editor. To achieve the proper aesthetic effect, place a blank line at the top of the file. ZIP.CMM must exist in the CSPro Home Directory. 6.2 Message Files used with Catscan Professional When using CSPro with a BBS, messages may be sent in the BBS to both the Sysop and the uploader in the event that an uploaded file passes or fails processing. CSPro uses the following files as templates when creating these messages. SYSOPB.TXT - Message template used when sending the Sysop a message after an uploaded file has failed processing. SYSOPG.TXT - Message template used when sending the Sysop a message after an uploaded file has passed processing. USERB.TXT - Message template used when sending the uploader a message after an uploaded file has failed processing. USERG.TXT - Message template used when sending the uploader a message after an uploaded file has passed processing. ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 10 These files must exist in the CSPro Home Directory. These files may be created and maintained with any ASCII text editor. 6.2.1 ... @ Macros used with messages When CSPro uses one of the above files to send the Sysop or uploader a message, Macros may be used. Macros serve as a way to create a boilerplate document with different information inserted into the text at the Macro position. Macros always begin and end with the "@" symbol. When CSPro encounters one of the following Macros in a template, the appropriate information is inserted into the text produced: @ORIGFILENAME@ - File name before processing @NEWFILENAME@ - File name after processing @FAILEDSTATE@ - If file fails, last check ran on file @ORIGFILEPATH@ - File path before processing @NEWFILEPATH@ - File path after processing @NUMFILES@ - Total number of files contained in archive @OLDESTFILE@ - Date of oldest file in archive @NEWESTFILE@ - Date of newest file in archive @BIGGESTFILE@ - Size of largest file in archive @SMALLESTFILE@ - Size of smallest file in archive @UNCOMPBYTES@ - Size of file when uncompressed @ORIGFILESIZE@ - File size before processing @NEWFILESIZE@ - File size after processing @IMBEDDEDARC@ - "Yes" if file contains an imbedded archive 6.2.2 ... INFOMSG.TXT When CSPro is used with a WildCat BBS, the extended file information may be created. This feature is used when a file does not already contain extended information, or a FILE_ID.DIZ file. When the file is uploaded the uploader may choose to add extended information about the uploaded file. A FILE_ID.DIZ file may exist in the uploaded archive file. This file is an ASCII text file that contains extended information about the uploaded file. If neither of these conditions exist, CSPro will search the CSPro Home Directory for the file INFOMSG.TXT. If this file exists, the file will be used much like the message templates described in section 6.2 to create the extended file information. INFOMSG.TXT may also contain the message Macro codes described in section 6.2.1. 6.3 ... Screen Files used with Catscan Professional Screen files are used to display status information to both the Sysop and the uploader during file processing. The following ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 11 files are used as CSPro screen display files and must exist in the CSPro Home Directory: CSPRO.SCR - File used to display status information during local processing, or if the uploader has ANSI color selected. This file may be customized to the Sysop's needs. Please reference the section "Creating a Custom ANSI Screen" for further information. CSPRO.RIP - File used to display status information if the uploader is using a RipScript compatible terminal program. This file may not be modified by the Sysop. CSPro is pre-configured to place the status information in the appropriate locations on the screen. 7.0 ... Configuration with CSEDIT CSEDIT.EXE is used to modify the many options and features available with CatScan Professional. When the program starts, CSEdit will search for two files called CSPRO.CFG and CSEDIT.HLP. CSPRO.CFG is used to store all of the configuration information entered in CSEdit. When the program is started for the first time, CSEdit will choose default values for all configuration options. CSEDIT.HLP is used to display help information for CSEdit when the "F1" key is pressed while a configuration field is highlighted. Context sensitive help is available for each configuration option available in CSEdit. To run CSEdit simply type the following: C: CD \CSPRO CSEDIT Moving from screen to screen: In this documentation the CSEdit configuration screens will be presented in the order, left to right, that they occur in the main menu. To exit from one screen and move to another press escape to return to the main menu and select the configuration screen that you wish to edit. Pressing escape while on a field that is currently being edited will cause the edited information to be lost. To insure that information is not lost always make sure that when going back to the main menu your selection bar is not on a field that has just been modified. ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 12 While entering information in CSEdit, the following keys are active for use: F1 - Display context sensitive help for the current field. Pressing F1 while help is displayed will display a complete list of topics for which help is available. PgDn - Scroll to the next screen of information in the current configuration screen. Some configuration screens extend below the boundaries of the current window. These screens use a scroll bar to display the relative location in the current configuration screen. PgUp - Scroll to the previous screen of information in the current configuration screen. Down Arrow - Move to the next field in the configuration screen. Up Arrow - Move to the previous field in the configuration screen. Spacebar - This key is used to advance through the available choices when a multiple choice field is highlighted. Enter - Accept the current field information and move to the next field. Escape - Exit the current configuration screen and return to the CSEdit main menu. Delete - Delete the character to the right of the cursor. Backspace - Delete the cursor to the left of the cursor. ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 13 After the program is started CSEdit will display the following menu: +---------------------------------------------------------------+ | Paths General Options Externals Import / Export File | +---------------------------------------------------------------+ From this menu you will be able to select any of the available configuration screens. 7.1 ... CSEDIT / PATHS The following screen will be displayed after selecting "PATHS" in the CSEdit Main Menu: +---------------------------------------------------------------+ | | | Path to Temp Drive\Directory C:\CSPRO\TEMP\ | | Path to Bad Directory C:\CSPRO\BAD\ | | Path to CSPRO Home Directory C:\CSPRO\ | | Path to BBS Home Directory C:\WC30\ | | | +----------------------- Paths To Files ------------------------+ Path to Temp Drive\Directory: When CSPro is processing an uploaded file it needs a location in which to place files of a temporary nature. This field is used to establish the drive and path to store these files. This field may contain the path to any directory on any logical disk. EXAMPLE : C:\CSPRO\TEMP\ NOTE : CSPro unarchives uploaded files to this directory so you must insure that this drive contains enough space for any file that may be uploaded to your BBS. Path to Bad Directory : If CSPro encounters a file that fails processing for any reason, that file is a candidate for relocation to the bad directory. If the field "Move Failed Files to your BAD dir" in CSEDIT / GENERAL is set to Y, CSPro will move the failed file to the directory specified by this field. Path to CSPRO Home Directory : ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 14 This field establishes the directory where CSPro will look to find all of the files needed for normal operation. Path to BBS Home Directory : This field is used to inform CSPro where to locate files that are maintained by your BBS Software. For instance, for WildCat, CSPro uses the file MAKEWILD.DAT to determine where the User and File databases are located. EXAMPLE : C:\WC30\ 7.2 ... CSEDIT / GENERAL +---------------------------------------------------------------+ | Date Configuration | | Use Strict Date Checking N | | How old in days should you accept files 360 | | Set Archive date Original Date | | | | File Compression | | Default Archiver ZIP | | Convert files to your default Archive Y | | Compress TXT files from TXTNAMES.TXT Y | | Recompress files of the same archive type Y | | Convert Self Extracting Files Y | | Put your Comment on the archived file Y | | DO what with -AV Files Keep All | | Capture Uploaded Comments in CAPTURE.TXT N | | | | Duplicate File Detection | | Use Internal Archive Dup Checking N | | CRC Percentage to fail in Dup Database 70 | | | | Failed File Processing | | Move failed files to your BAD dir N | | File area to move bad files to 0 | | | | Time Constraints | | Stop Processing after x Minutes 0=Never 0 | | Seconds to Delay if File Fails 2 | | Seconds to Delay if File Passes 2 | | | | Messages | | Conference Number to Leave Messages in 0 | | Enter Sysop Name here to get messages TO them SCOTT GREEN | | Enter Sysop Name here to get messages FROM them SCOTT GREEN | | Send message to user if file passes N | | Send message to user if file fails N | ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 15 | Send message to sysop if file passes N | | Send message to sysop if file fails N | | | | Modem Configuration | | Does your Modem use RTS/CTS N | | Show ANSI Screen to This Baud and Higher 0 | | Device Type UART | | | | Miscellaneous | | How many days to preserve SDN files 0 | | Network Type Single Line | | BBS Type WildCat | | Create Description File FILE_ID.DIZ | | Scan TD0 Files for integrity N | | Add Info Message to extended Information Y | +---------------------------------------------------------------+ Use Strict Date Checking : The Sysop may wish to reject any uploaded files that do not fall within a specific age group. For instance, you may not want any files to exist on your BBS that are older than one year. CSPro will check the date of uploaded files to determine the oldest and newest file contained in the archive. This file works in conjunction with the field "How old in days should you accept files" located in Misc Options. If this field is set to Y, CSPro will accept the file only if all files in the archive are newer than the specified age. If this field is set to N, CSPro will accept the file if any files are found in the archive that are newer than the specified age. How old in days should you accept files : This field is used to establish the age of files in days that you wish to accept. When this field is set to 0, file age checking is disabled. Set Archive Date : Set Archive Date gives you the ability to set the date of the file being processed. You have four choices to choose from: Original Date, Current Date, Oldest File, and Newest File. Original Date - This option will retain the archives original file date. This method is used to process a directory that you just want to freshen or change the archive type. Using this method will cause the files to not be displayed during a "New File Scan" on the BBS. ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 16 Current Date - This method will place the current date and time on the newly processed archive. The file will be displayed on the BBS during a New File Scan when using this method. Newest File - This method will set the archive date to the same date as the newest file in the archive. This feature is nice to use after your files have been available for a period of time. The Sysop would then execute CSPro with this option set against the directory. The archive files contained in the directory would then reflect the archives true date. Oldest File - This method could be used just like the Newest file method. But it would be for more conservative Sysops. The archive date would guarantee that all files would not be older than the archive date. Default Archiver : This field may be changed by pressing either the space bar to move forward or the minus '-' key to go backwards. This field is used to inform CSPro which archive type that all other archives will be converted to. Convert files to your default Archive : If this field is set to Y, CSPro will convert all uploaded archive files to the type specified in "Default Archiver". For instance, if the user uploads an ARJ file and the Sysop wishes all uploaded files to be ZIP files, this field would be set to Y and the "Default Archiver" field to ZIP. CSPro will convert the ARJ to ZIP. Compress TXT files from TXTNAMES.TXT : This field is used to inform CSPro to convert uploaded files that are not already compressed to the default archiver type. For instance, the Sysop may wish to compress all uploaded files with a .TXT extension with the default archiver. In this case the field would be set to Y. The file TXTNAMES.TXT is an ASCII file located in the CSPro home directory. The file contains a list of file extensions, one per line, to compress. Do not include any of the standard archiver extensions into this file, such as ZIP, LZH, or ARJ. Recompress files of the same archive type : ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 17 In order to insure that all archive files uploaded to the BBS are archived with the latest archiver version, set this field to Y. For instance, a user uploads a file compressed with PKZIP v1.1, and you are using PKZIP v2.0, the file will be recompressed. If you want to bypass recompression of these files, set this field to N. Put your Comment on the archived file : This field will inform CSPro that you wish to put your own comment on all ZIP and ARJ files. To allow for this set this field to Y. Then create a file called CSPRO.CMT with an ASCII editor in your CSPro Home Directory. This file will then be added as the archive comment in the file when rearchived. This feature only functions with ZIP and ARJ files. NOTE : It is recommended that you place a blank line at the top of this file because some archivers will not display the first comment line properly. Convert Self Extracting Files : CSPro can detect files that have been uploaded to your BBS in Self-Extracting form. This type of file generally has an extension of .EXE. When the file is executed, it will uncompress itself. This allows the creator of the file to provide the user the ability to uncompress the file without obtaining the unarchiver. If you would like to convert these files to your default archive type, set this field to Y. DO what with -AV Files : This is a new and unique feature that CSPro offers its users. It gives the Sysop the ability to maintain certain files that contain specific "AV" signatures. Three options are available: Strip All, Keep All, and Keep List. Below is a brief explanation of each of the options: Strip All - Rearchives the file which will cause CSPro to recompress the file, removing any previous "AV" signature on the file. Keep All - Will never rearchive the file so that the previous "AV" signature on the file will remain intact. Keep List - This option will allow the Sysop to maintain a list of specific "AV" signatures. To use this option simply create or add to the file KEEPAV.TXT with an ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 18 ASCII editor. All that is required is for you to type in each AV signature you want to preserve on its own line. An example may look like the following: UUM818 <--- This is Our AV Signature PKW655 <--- This is PKWare!'s AV Signature In the above example, any files that contained one of above "AV" signatures would be preserved in their original state. All other files would have their "AV" signature stripped. Capture Uploaded Comments in CAPTURE.TXT : CSPro has the ability to maintain the comments of all .ZIP and .LZH files uploaded to your BBS. This is useful if you would like to see where your files are coming from. CSPro will append the comments to the file CAPTURE.TXT located in the CSPro Home Directory. Use Internal Archive Dup Checking : CSPro has the ability to reject uploaded files that already exist on your BBS. CSPro can detect a duplicate file even if the file name changes or files have been added to the archive file. CSPro accomplishes this feature by creating a 32 bit CRC for each file in the archive and checking the CRC against other files that have been uploaded to your BBS. This field works in conjunction with "CRC Percentage" located in Misc. Options. Let's assume, for instance, that a user uploads a file called GAMES.ZIP and it contains 10 files in the archive. A CRC is generated for each of the 10 files and is saved in the CRC database. At a later date, another user uploads a file called GAMES1.ZIP, which is an exact copy of GAMES.ZIP. The BBS will allow the user to upload the file because the name does not exist in the file database. Since you do not want duplicates, CSPro will fail the file because the file CRC values match files already uploaded to your BBS. The CRC Percentage field is used to set a maximum threshold of duplicate files that you wish to allow in an uploaded file. Setting this field to 70% would inform CSPro to allow 70 percent of the files contained in an archive to be duplicates of files already uploaded. For example, 7 of 10 files could be duplicates but 8 of 10 would fail. CRC Percentage to fail in Dup Database : This field is used to establish the maximum percentage of duplicate files that you wish to allow in an archive. See Also: Use Internal Archive Dup Checking ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 19 Move failed files to your BAD dir : This field is used to inform CSPro to move any uploaded file that fails to the BAD directory. See "Bad Directory Path" for a complete explanation of this field. Note : When using CSPro with a WildCat BBS, the file will NOT be moved if executed from SCANFILE.BAT. This is because WildCat will retain the original file area that the file was uploaded to. File area to move bad files to : This field is used to define the BBS file area in which you wish to move all files that fail processing. Stop Processing after x Minutes : This field is used to define the maximum amount of time that you wish CSPro to process a file, or list of files. When set to 0 this option is disabled. How long to Delay if File Fails : This field establishes the amount of seconds that CSPro will display the final status screen upon the event the file fails processing. How long to Delay if File Passes : This field establishes the amount of seconds that CSPro will display the final status screen when a file passes all tests. Conference Number to Leave Messages in : This field defines the BBS conference number that you wish to send all messages to the Sysop and Uploader to. Enter Sysop Name here to get messages TO them : When sending messages to the Sysop this field is the name of the Sysop that all messages will be sent to. This option is broken down by TO and FROM because you may wish to have a Co-Sysop or File Sysop receive all the messages of failed files. In which case you would want his/her name in the TO field so that you are not bothered with the messages of failed files. You will, however, want all messages informing the user of the CSPro results, to be from you (the Sysop). If you do not have a Co- ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 20 Sysop or a File Sysop, simply enter your name in both fields. See also : Sysop Name to get message FROM them Enter Sysop Name here to get messages FROM them : When sending messages to users, this field is the name of the Sysop that the messages will be addressed from. This option is broken down by TO and FROM because you may wish to have a Co- Sysop or a File Sysop receive all the messages of failed files. However, you may wish all messages informing the uploader of the CSPro results to be addressed from the Sysop. If you do not have a Co-Sysop or a File Sysop, simply enter your name in both fields. See also : Sysop Name to get message TO them Does your Modem use RTS/CTS : Most high speed modems use hardware handshaking flow control. Set this field to Y if your modem requires hardware flow control. If this field is set to N, it may be overridden by setting the CSPro Command Line option /RTSCTS. See Also: CSPro Command Line Options Show ANSI Screen to This Baud and Higher : This field defines the minimum caller baud rate that you wish CSPro to display the status screen to. If your status screen is very complex, CSPro may process small files before the screen has been completely displayed to lower speed callers. Device Type : This field is used to configure the type of hardware that the Sysop is using to communicate with the modem. CSPro supports Uart and DigiBoard. Uart is the normal method of communication between the computer and modem. DigiBoard is an additional expansion board placed in the computer to gain access to up to 16 communication ports. If you are using non-standard uart addresses and IRQ's with WildCat BBS, CSPro uses the environment variables WCIRQID and WCBASEID. Please refer to your WildCat documentation for an explanation of these environment variables. ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 21 How many days to preserve SDN files : This field establishes the minimum age in days of SDN files that you wish to have rearchived when uploaded. All SDN files that are newer than this age, will be written to the file SDNLATER.TXT in the CSPro Home Directory. Network Type : This is the network mode in which CSPro should operate in. There are three choices that may be chosen here: Single Line, DOS Share and Novell. These options are further described below: Single Line - This is used for single line BBS systems that are not using any form of networking or multitasking software. DOS Share - This option should be used for systems that are using DOS SHARE, Lantastic, Novell Lite or any other networking software other than Novell. Novell - This option is used for NOVELL 286 or Novell 386 systems only. This does not apply to NOVELL LITE users. BBS Type : This Field informs CSPro which type of BBS environment it will be operating under. At this time, WildCat and MainLine are the only two BBS types being supported. We will add any BBS to our list providing we can obtain the file formats to the Message, User, and File databases. Create Description File : CSPro has the ability to add either a FILE_ID.DIZ or a DESC.SDI file into the archive if it does not already contain one. A FILE_ID.DIZ file may contain extended file information. However, if the user does not enter a detailed description then the FILE_ID.DIZ will be very small (60 characters from a WildCat system). This option is also convenient if you ever need to rebuild your file database because your BBS file database gets corrupted, you will then be able use the description files CSPro added. ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 22 Log to the BBS Activity Logs : Set this field to Y if you wish all activity to be saved in your BBS activity log in addition to the normal log files created by CSPro. Scan TD0 Files for integrity : CSPro has the ability to check TD0 files for integrity. A TD0 file is commonly used when an entire disk is compressed into an image file. This file commonly has an extension of .TD0. If you set this field to Y, you will need TDCHECK.EXE in your DOS path. If you do not wish to have TD0's scanned, then answer N. Add Info Message to extended Information : This field is used with WildCat BBS's only. When set to Y, this field informs CSPro to create extended information about the uploaded file in the file database. The file MSGINFO.TXT is used as a template to create the extended information. Standard CSPro @ Macros may be used in the creation of this file. See Also: File Format - MSGINFO.TXT Send Message to User if File Passes : This option is used to tell CSPro if it should send a thank you note to the user if a file passes. The message will be addressed from the Sysop's name that was entered in CSEdit "Sysop Name Messages are FROM". You can make this file say anything you want. If you do answer YES to this question then you will need to create a file in the CSPro directory called USERG.TXT. You may use any of the available MACROS that CSPro has to offer. Send Message to User if File Fails : This option is used to tell CSPro if it should send a message to the user if a file fails. The message will be addressed from the Sysop's name defined in CSEdit under the option "Sysop Name Messages are FROM". Any text information may be entered into this file. If you do answer YES to this question then you will need to create a file in the CSPro directory called USERB.TXT. You may use any of the available MACROS that CSPro has to offer. Send Message to Sysop if File Passes : This option is used to tell CSPro if it should send a message to the Sysop name, defined in CSEdit under the option "Sysop Name to ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 23 Receive Messages". If a file passes then this person will actually get a message to them informing them that a file has passed CSPro. They may then move the file to the appropriate file area. Any text information may be entered into the file. If you do answer Y to this question then you will need to create a file in the CSPro directory called SYSOPB.TXT. You may use any of the available CSPro message MACROS. Send Message to Sysop if File Fails : This option is used to tell CSPro if it should send a message to the Sysop name, defined in CSEdit under the option "Sysop Name to Receive Messages". If a file fails then this person will actually get a message to them informing them that a file has failed scan. They may then take appropriate action. Any text information may be entered into this file. If you do answer Y to this question, you will need to create a file in the CSPro directory called SYSOPB.TXT. You may use any of the available CSPro message MACROS. 7.3 ... CSEDIT / OPTIONS When this menu option is selected, the following menu will be displayed. Further configuration screens may be selected as described below: +-------------------+ | Scanners Setup | | Scan Dirs Only | | Exclude Dirs | | Exclude Security | +-------------------+ ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 24 7.3.1 ... CSEDIT / OPTIONS / SCANNERS SETUP When this menu option is selected, the Sysop will be presented with the configuration shown below: +-------------------------------------------------------------+ | Scanner Drive\Path\Filename Scanner Parameters | | | | 1) C:\SCANNERS\SCAN.EXE /NOMEM /NOEXPIRE /NOPAUSE | | 2) | | 3) | | 4) | | 5) | | 6) | | 7) | | 8) | | 9) | | 10) | | 11) | | 12) | | 13) | | 14) | | 15) | +----------------- Define up to 15 Scanners ------------------+ Scanner Definitions : This screen will allow you to define up to 15 different virus scanners that will be used to process an uploaded file. CSPro will execute each defined scanner on the uploaded file. Scanner Program : This field is used to define the drive, directory and file name of each scanner program. EXAMPLE : C:\SCANNERS\SCAN.EXE Scanner Parameters : This field is used to define the parameters to pass to the virus scanner program. EXAMPLE : /NOMEM /NOEXPIRE /NOPAUSE ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 25 7.3.2 ... CSEDIT / OPTIONS / SCAN DIRS ONLY When this menu option is selected, the Sysop will be presented with the configuration shown below: +-------------------------------+ | 1) | | 2) | | 3) | | 4) | | 5) | | 6) | | 7) | | 8) | | 9) | | 10) | | 11) | | 12) | | 13) | | 14) | | 15) | + Only Scan Files in These Dirs + This screen establishes up to 15 directories in which the Sysop only wishes CSPro to scan, but not recompress the files uploaded to them. All other directories will function as normal. 7.3.3 ... CSEDIT / OPTIONS / EXCLUDE DIRS When this menu option is selected, the Sysop will be presented with the configuration shown below: +----------------------------------+ | 1) | | 2) | | 3) | | 4) | | 5) | | 6) | | 7) | | 8) | | 9) | | 10) | | 11) | | 12) | | 13) | | 14) | | 15) | + Exclude Processing in These Dirs + ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 26 This screen establishes up to 15 directories in which you do not want CSPro to process the file in any way. You may wish to use this when you have a file area that your users upload secure, preprocessed files into. 7.3.4 ... CSEDIT / OPTIONS / EXCLUDE SECURITY When this menu option is selected the Sysop will be presented with the configuration shown below: +-----------------------+ | 1) 0 2) 0 | | 3) 0 4) 0 | | 5) 0 6) 0 | | 7) 0 8) 0 | | 9) 0 10) 0 | | 11) 0 12) 0 | | 13) 0 14) 0 | | 15) 0 16) 0 | +-----------------------+ This screen allows the Sysop to define up to 16 user security levels that, after uploading a file, CSPro will not process their uploaded files in any way. 7.4 ... CSEDIT / EXTERNALS When this menu option is selected the following menu will be displayed. Further configuration screens may be selected as described below: +---------------------+ | Archiver Progs | | Gif Processing | +---------------------+ ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 27 7.4.1 ... CSEDIT / EXTERNALS / ARCHIVERS When this menu option is selected the Sysop will be presented with the configuration screen shown below: +-------------------------------------------------------------+ | | | Default Extension ZIP Archiver 1 ZIP | | | | Archiver C:\DOS\PKZIP.EXE | | | | Archiver Parm -rp -ex | | | | Un-Archiver C:\DOS\PKUNZIP.EXE | | | | Un-Archiver Parm -do | | | | Comment Parm -o -z < | | | | Signature PKCD | | | | Self Extr Sig MZUA_ | | | +------------- Please Define your Archivers --------------+ Default Extension : This field is used to tell CSPro what the extension should be for this archiver type. PKZIP would use the extension of ZIP. ARJ would use the extension of ARJ, and so on. Archiver : This field is the Drive\Directory\Filename.EXT of your archiver. In most cases this field will be filled in for you when you first run CSEDIT. CSEDIT will search your hard drive for all the default archivers supported and fill in the appropriate drive\directory\filename. Archiver Parameter : This field is provided for you to define the parameters your archiver should use. In most cases, you will not need to change these parameters and you should not change them if you are not familiar with the archiver. If a new archiver comes out and you wish to use it then you will need to enter the parameters needed for the archiver to compress a file. ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 28 Unarchiver : This field is the Drive\Directory\Filename.EXT of your unarchiver. In most cases this field will be filled in for you when you first run CSEDIT. CSEDIT will search your hard drive for all the default archivers supported and fill in the appropriate drive\directory\filename. Unarchiver Parameter : This field is provided for you to define the parameters your unarchiver should use. In most cases you will not need to change these and you should not change them if you are not familiar with the un-archiver. If a new un-archiver comes out and you wish to use it then you will need to enter the parameters needed for the un-archiver to uncompress a file. Comment Parameter : This field is provided for you to enter the specific parameters needed to make this archiver add a comment to its archive. In most cases you will not need to change what is provided, because currently only two archivers, PKZIP and ARJ support placing comments on files. Since we provide the defaults for those two archivers you will not need to modify them, and should not modify them, unless your archiver comment parameter requirements change. If by chance a current archiver comes out that supports adding comments to files, then the use the following format: Archiver.exe <Comment Parameters> Filename Signature : Every file that is created by an archiver has some type of "Signature" at the beginning of the file. These are usually the first couple of bytes in the file. These "Signatures" are always the same when a particular archiver creates them. For example, when PKZIP creates a ZIP file then the first four bytes are always PKCD. Each archiver has its own signature for the normal archive file and the self extracting archive files. This field is provided to enter the NORMAL signature for this archiver. See also Self Extracting Signature Self Extract Signature : Every file that is created by an archiver has some type of "Signature" at the beginning of the file. These are usually the ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 29 first couple of bytes in the file. These "Signatures" are always the same when a particular archiver creates them. For example, when PKSFX creates a self extracting ZIP file, then the first four bytes are always the same. Each archiver has its own signature for the normal archive file and the self extracting archive files. This field is provided to enter the self extracting signature for this archiver. See also Signature 7.4.2 ... CSEDIT / EXTERNALS / GIF PROCESSING When this menu option is selected, the Sysop will be presented with the configuration shown below: +---------------------------------------------------------------+ | GIF Processing | | GIF Processing Method GifLite | | GIF Resolution Location Left | | Where is your GIFTEST.EXE C:\DOS\GIFTEST.EXE | | What Parameters for GIFTEST | | Where is your GIF2JPG.EXE C:\DOS\GIF2JPG.EXE | | What Parameters for GIF2JPG -a -k -q55 | | Where is your GIFLITE.EXE C:\DOS\GIF2JPG.EXE | | What Parameters for GIFLITE -b -i -o -u -t | | GIF Signature GIF8 | | GIF Extension GIF | | | | Minimum GIF Resolutions | | X : 0 Y : 0 Colors : 0 | | | | JPG Processing | | JPG Processing Method GIF | | Where is your JPG2GIF.EXE C:\DOS\JPG2GIF.EXE | | What Parameters for JPG2GIF -a -k | | JPG Signature | | JPG Extension | +-------------------------- GIF Options ------------------------+ GIF Processing Method : This option allows you to tell CSPro how to handle GIF files. You have three choices here: GifLite, JPG and None. If Giflite is chosen then CSPro will expect to find GIFLITE.EXE in the directory specified by "Where is your GIFLITE.EXE". If JPG is used then CSPro will expect to find GIF2JPG.EXE in the directory ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 30 specified by "Where is your GIF2JPG.EXE". If None is selected then CSPro will not perform any GIF processing on GIF files that are uploaded to your system. GIF Resolution Location : This field is used to tell CSPro where to place the GIF resolution for the GIF file that was uploaded. Your choices are LEFT, RIGHT, EXTENDED, and NONE. A GIF resolution looks something like this; 640x480x256, where the 640 is the amount of horizontal pixels, 480 is the amount of vertical pixels, and 256 is the amount of colors used in the GIF image. Below are detailed descriptions of the locations: Left - will put the resolution of the GIF file at the left of the users description. Ex. 640x480x256 A picture of the space shuttle taking off. Right - Puts the resolution at the far right of the users description. Ex. A picture of the space shuttle taking off. 640x480x256 Extended - Puts the resolution at the very beginning of the Extended information. We have plans to make CSPro read the contents of GIF comments and place them in the extended information. At this time this is not implemented so this option most likely will not be used until the above is implemented. Where is your GIFTEST Program : If this field is filled in then CSPro will use this program to test the integrity of any GIF files that are uploaded to your system. We suggest that you use GIFTEST v4.0. GIFTEST may be downloaded from The CSPro Support BBS's. What Parameters for GIFTEST : This is the command line options for your GIFTEST program. The current GIFTEST program we suggest to use with CatScan Professional, does not need any command line parameters in which case this field will be blank. Where is your GIF2JPG.EXE : ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 31 This is the complete Drive\Path\Filename of where GIF2JPG.EXE is located. GIF2JPG.EXE is an external program that will convert GIF files to "JPG" files. What Parameters for GIF2JPG : If you are using GIF2JPG to convert your GIF files, enter the desired GIF2JPG options in this field. If you are unfamiliar with your choices then see the GIF2JPG manual for your options. We recommend that you use the defaults for initial setup. Where is your GIFLITE.EXE : This is the complete Drive\Directory\Filename of where GIFLITE.EXE is located. Giflite is an external program that will compress GIF files. Although some of the picture sharpness is lost when compressing GIF files, it's not very noticeable by the naked eye. What Parameters for GIFLITE : If you are using GifLite to compress your GIF files then enter the desired GifLite options in this field. If you are unfamiliar with your choices then see the GifLite manual for your options. We recommend that you use the defaults for initial setup. Minimum GIF Resolutions : CSPro gives you the option to restrict GIF files by their resolution. A GIF resolution consists of three numbers; How many pixels going across the screen (horizontal X axis), How many pixels going from top to bottom (vertical Y axis), and how many colors are in the picture. It normally looks something like this. 640x480x256 X Y Colors To reject GIF files, simply enter the minimum number you wish to accept for any category. If a 0 is entered then resolution checking is disabled for that part of the resolution. To set CSPro so that it will accept any GIF file resolution, then simply enter 0 in all three fields. JPG Processing Method : This field instructs CSPro what to with JPG type files. You basically have two choices, Convert them to GIF, or do Nothing. If you chose to convert them to GIF, then CSPro will run JPG2GIF ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 32 on the file and convert it to a GIF file. This will not bring back the files original picture clarity, but will allow you to only have GIF type pictures available on your system. Where is your JPG2GIF.EXE : This is the complete Drive\Path\Filename of where JPG2GIF.EXE is located. JPG2GIF.EXE is an external program that will convert JPG files to "GIF" files. Since most picture viewers do not view JPG files directly, your users must do this if they wish to view JPG files. What Parameters for JPG2GIF : If you are converting JPG files to GIF format then you will need to enter the desired parameters you wish CSPro to use when it encounters a JPG file. If you are unfamiliar with the parameters available then see the JPG2GIF documentation for your options. We recommend that you use the defaults for initial setup. Write GIF and JPG Files to RUNLATER.TXT : This option is used to tell CSPro to write files that are of GIF or JPG format to the RUNLATER.TXT file. You may want to convert these types of files in either your POSTCALL.BAT or in your nightly maintenance. The reason for this is because GIF and JPG files that are 200K will take approximately one minute on a 486/33 machine to convert. You may not want to make your uploader wait this amount of time for the file to be processed. If you choose to have CSPro bypass conversion of GIF or JPG files while the user is on-line, then you will need to set the options at the bottom of this help screen (See Also "Gif Processing Method") to NONE. Then use CSEDIT / FILE / SAVE, to create another configuration file that informs CSPro to convert the GIF and JPG files the way you wish them to be processed. In your nightly event batch file, you will need to have CSPro load that config file and also process the file list RUNLATER.TXT. Below is an example of the command line that could be used in your nightly bat file: CSPRO -Cc:\CSPRO\NIGHTLY.CFG -Lc:\CSPRO\RUNLATER.TXT The command line parameters -C and -L are used to make CSPro process the RUNLATER.TXT file. The -C tells CSPro to use a different CFG file and the -L tells CSPro to process all the files out of a list of files. See Also: GIF Processing Method JPG Processing Method ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 33 7.5 ... CSEDIT / IMPORT / EXPORT CSPro has the ability to import and export to ASCII text files. This will enable you to upgrade to new versions without being forced to totally reconfigure. Here is how it works: CSEdit will create an ASCII text file containing all of the programs configuration settings. This file will always be readable by later versions of the program. This procedure is only needed when upgrading to a newer version because CSPro and CSEdit normally loads the binary configuration file CSPRO.CFG. The advantage of using a binary configuration file for normal operation will let CSPro read all the options in one physical disk read making it very fast. The disadvantage to this is that if the file changes in size then it will not be loaded properly. This is why the Import/Export option is so convenient for upgrading. 7.5.1 ... CSEDIT / IMPORT - EXPORT / IMPORT The import screen that you will be presented with when choosing this menu option is a pick list of files ending in *.XPT. You are also presented with the parent directory and any subdirectories if they exist. Remember only files that end in *.XPT are displayed so be sure to save them with the extension XPT. +----------- N:\BP\CLS\CATSCAN\*.XPT -----------+ | ..\ HOLD\ TEST\ | | BAD\ TEMP\ CSPRO.XPT | | | | | | | +-----------------------------------------------+ 7.5.2 ... CSEDIT / IMPORT - EXPORT / EXPORT When choosing the export option in CSEDIT, you will be prompted for a file name. The default file name that will always be displayed is CSPRO.XPT. You may change this by typing in a file name, when the default is displayed. CSEdit will create an ASCII configuration file in the name that you specified. You may look at this file with a text editor to view the information that is contained in the file. We do not recommend you make changes to this file and re-import it, but it is possible and will work if configured properly. +-------------------------------------------+ | | | File Name CSPRO.XPT | | | +-------------------------------------------+ ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 34 7.6 ... CSEDIT / FILE When this menu option is chosen, the following menu will be displayed. Other menu choices may be selected from this menu as described below: +-----------------+ | Save Config | | Load Config | | Exit (No Save) | +-----------------+ 7.6.1 ... CSEDIT / FILE / SAVE CONFIG Selecting the "Save Config" menu option will prompt you for a file name to save the CSPro configuration to in Binary format. This file can not be edited or viewed by ASCII editors. All your configuration files should end in the extension *.CFG so that when you want to load that configuration for review it will be displayed in the Pick list of files, much like the Import menu option. +-------------------------------------------+ | | | File Name CSPRO.CFG | | | +-------------------------------------------+ 7.6.2 ... CSEDIT / FILE / LOAD CONFIG Selecting the "Load Config" menu option will present the Sysop with the following menu. This option will allow the Sysop to load a CSPro binary configuration file such as CSPRO.CFG, for editing. This option will only display files with a .CFG extention. To insure that all of your configuration files are displayed, save them with a CFG extention. +----------- N:\BP\CLS\CATSCAN\*.CFG -----------+ | ..\ HOLD\ TEST\ | | BAD\ TEMP\ CSPRO.CFG | | | | | | | | | | | | | +-----------------------------------------------+ ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 35 8.0 CatScan Professional Command Line Options CSPro has several command line options that help enhance its operation. The command line options may be entered in any order and case is NOT sensitive. Below is a list of the available options: -CFILENAME - Where FILENAME is set to an alternate CSPro configuration file. This field is not normally used but may be used when multiple configuration files are desired. -LFILENAME - Where FILENAME is set to a list of files to process. When this option is used CSPro will open FILENAME and process each file in the list. This file is a standard ASCII file with a filename per line. /DEBUG - This option is used for debugging purposes only. When used, this option will cause CSPro to display all information available when shelling to run an external program. /RTSCTS - This option is used to override the setting used in CSEdit to inform CSPro that the modem requires hardware flow control. When set, CSPro will always use hardware flow control. /DIGI - This option is used to override the device setting in CSEdit that defines the type of hardware used to communicate with the modem. When set, CSPro will always use DigiBoard. This option is normally used when CSPro is used in an environment in which both Uart and DigiBoards are used. Reference the section "Using CSPro with Uart and DigiBoards" for further configuration information. /SDN - This option instructs CSPro to look in the CSPro directory for the file SDNLATER.TXT (A Standard Text file). If it finds the file then it will check to make sure each file is older than the SDNAge set in CSEdit. If the file is older than that date then CSPro will process and convert the file if told to do so. ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 36 9.0 ... Creating a Custom ANSI Screen To display file process status information to uploaders using an ANSI color terminal program and during local file processing, CSPro uses the file CSPRO.SCR. This file may be customized with an ASCII text editor to meet the individual needs of the Sysop. CSPro requires that the file be created in the CSPro Home Directory. The display may be totally redefined using CSPro display Macros. These Macros define the screen position, colors, and character used to place the check mark character during each phase of the file process. The following Macros are supported in the CSPRO.SCR file. Each display Macro must exist or CSPro will not function properly. In the event that one or more of the display Macros do not exist, CSPro will exit, informing the Sysop which Macros are missing. Each Macro must begin and end with the "@" character. The first two characters of the Macro define the unique Macro code. The remaining characters are defined as follows: b - Background color of check mark character. f - Foreground color of check mark character. c - Character used to represent the check mark character. @CVbf@ - Catscan Version information. @CRbf@ - BBS Name if registered, or "Unregistered" if CSPro is operating in "DEMO" mode. @CFbfc@ - Current file in process. @UCbfc@ - File is currently being uncompressed. @TFbfc@ - File Integrity Test in progress. @CDbfc@ - File Date Check in progress. @SCbfc@ - Virus Scan in progress. @BNbfc@ - Removing unwanted files. (BADNAMES.TXT) @CPbfc@ - File is being Recompressed. @CGbfc@ - Graphic file is being converted. CSPro will also allow color Macros to be used in CSPRO.SCR. The following color Macros are supported. @BF@ - Replace "B" with the desired background color, and "F" with the desired foreground color. The following are the valid color codes for foreground and background: 0 - Black 1 - Blue 2 - Green 3 - Cyan 4 - Red ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 37 5 - Magenta 6 - Brown 7 - Gray 8 - Dark Gray 9 - Light Blue A - Light Green B - Light Cyan C - Light Red D - Light Magenta E - Yellow F - White 10.0 ... Using CatScan Professional with Uart and DigiBoards The following will explain the recommended conguration to run CSPro on both DIGI and Uart comports. On systems that are running both the IM version of WildCat and the Uart version you probably had to create a WildCat home directory for each of the two different types. Below is an example of the directory structure of both: C:\WILDCAT = DIGI IM Version C:\WC30 = UART Version C:\WC30--- |--WCWORK---- |--NODE1 |--NODE2 C:\WILDCAT- |--WCWORK---- |--NODE3 |--NODE4 |--NODE5 |--NODE6 In the two home directories, WC30 and WILDCAT, you will have WILDCAT.EXE and WILDCAT.OVR. This is because the IM version uses a different WILDCAT.EXE than the Uart version. To make CSPro operate with both of these versions simultaneously you will need to create two configuration files. The first configuration file should be called CSPRO.CFG, and it should be configured to work with the majority of your lines. Secondly major parts of the CFG file that will be different between the two CFG files will be the DEVICE type, found in "CSEDIT / GENERAL, and the "Path to the BBS Home Directory", found in "CSEDIT / PATHS". For example we have more DIGI lines than Uart lines so we are ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 38 going to setup our main CFG file to use DIGI point to the C:\WILDCAT directory. Next, you will need to create a second configuration file just like the first, except that it uses UART for the device type and it will point to the C:\WC30 directory for the BBS Home Directory. Once this is done, then the only part that will be different is the BAT files to run the two different types. The two different BAT files are illustrated below: For the DIGI version: Since this is the majority of your nodes, the BAT file will be very straight forward and simple. CSPRO %1 For the Uart version: Since it requires a CFG file other than the default loaded by CSPro you must pass the name of the configuration file on the command line. Also since it will be a different BAT file to run than the one used to operate the DigiBoard nodes, you will need to make SCANFILE.RUN files for each of the UART nodes you have. If WildCat finds a SCANFILE.RUN in the NODE home directory then it will execute that file rather than the SCANFILE.BAT located in the WILDCAT Home Directory. The following example is what the SCANFILE.RUN will look like for each of the UART NODES: CSPRO -Cc:\cspro\cspro1.cfg %1 The above informs CSPro to load a different configuration file and operate using its specified parameters. As mentioned before, the above is only one way to operate both DIGI and UART together. We hope that this short information helps you in your setup. 11.0 Testing your configuration After you have answered all of the questions in CSEDIT and feel you are ready to do the initial test, then you need to select a file to test. We suggest that you have a backup of the first initial file you test so in the event that something is not setup properly you will not be frustrated with the loss of a file. For example, create a directory called C:\TEMP and place the file TEST.ZIP in that directory. The command line you will use to test the setup of CSPRO is as follows: CSPRO C:\TEMP\TEST.ZIP ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 39 If everything is setup properly you will see CSPro's ANSI screen appear on the monitor. If CSPro encounters a setup problem it will stop processing the file and exit to DOS immediately. You will need to check the CSPRO.LOG in your CSPRO directory to see why CSpro exited. If CSPro exits normally you will see either a PASS or FAILED window on the monitor. 12.0 ... Processing Files with CatScan Pro There are basically three ways that CSPro operates. The three distinctive ways are either at the time of the upload to your BBS, executed from an event on your BBS, or from the DOS prompt. You can have CSPro operate differently for these three processes by creating different configuration files. By default, CSPro will always look for the configuration file CSPRO.CFG, if no configuration file is listed on the command line. 12.1 ... Processing files after Upload Running CSPro at the time of the upload is very easy to setup. Once you have verified that CSPro is functioning properly at the DOS prompt you are ready to create the SCANFILE.BAT which will be located in the WildCat Home Directory (i.e. \WC30). If you already have a SCANFILE.BAT in your \WC30 directory then you will want to delete it or rename it to something else for back up purposes. After you have removed the file you will want to recreate it. The SCANFILE.BAT is very simple and short. For testing purposes create the file exactly like the example below. If you wish to add other programs to your SCANFILE.BAT please do so after first testing CSPRO. CSPRO %1 This is the only line that needs to be in your SCANFILE.BAT for CSPro to operate properly. CSPro will detect if you are running in a multi node environment or single node environment so your SCANFILE.BAT will be the same either way. 12.2 ... Processing Uploaded Files in an Event Running CSPro from the DOS prompt Running CSPro from DOS can be used for several reasons. Because CSPro is so versatile you can even come up with reasons to run it ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 40 we haven't even thought of yet. The basic reasons would be to process a directory of newly downloaded files, process files coming in from a file network, or process files that have been written to the RUNLATER.TXT file. Below are several examples of how to use CSPro from the DOS prompt or in an Event. CSPRO C:\DOWNLOAD Will process all the files in the C:\DOWNLOAD directory and use the config file CSPRO.CFG for processing. CSPRO -Cc:\cspro\cspro1.cfg C:\DOWNLOAD This example will process all the files in the C:\DOWNLOAD directory and use the config file CSPRO1.CFG which is located in the C:\CSPRO directory. CSPRO -LMYLIST.TXT CSPro will process all the files contained in the ASCII file MYLIST.TXT, which is located in the current directory. If the list of files to process is in another directory then you can add the drive and path on the command line as well. CSPRO -Cc:\cspro\cspro1.cfg -Lc:\cspro\mylist.txt CSPro will process all the files contained in the ASCII file MYLIST.TXT, which resides in the C:\CSPRO directory. CSPro will use the config file CSPRO1.CFG which is also located in the C:\CSPRO directory. CSPRO /SDN CSPro will process all files that have been written to the file SDNLATER.TXT. Files will only be written to this file if you have elected to not process SDN files until they have reached a certain age. If a SDN file is not old enough to process, then it is written to the SDNLATER.TXT file. CSPro will only check the contents of this file to see if a file needs to be processed if you run the above command (CSPRO /SDN). If a file in the list is not old enough then it will remain in the list. If the file is old enough then it will be processed and removed from the list. CSPRO C:\MYDIR\MYFILE.ZIP CSPro will process ONLY the file MYFILE.ZIP in the C:\MYDIR directory. When executing CSPro from your nightly event, insure that the configuration file being used does not have Duplicate File ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 41 Checking turned on. This is because CSPro adds the CRC values for the files, when executed after the upload. The files that are processed from RUNLATER.TXT will already exist in the CRC database, and therefore be condered duplicates if CRC checking is in use. Also, when executing CSPro from your nightly event, insure that no files will be written to the RUNLATER.TXT file. This includes "Write all GIF and JPG files to RUNLATER.TXT", located in GIF options, and "Write All Files To RUNLATER.TXT", located in General Options. This is to insure that no files will be written to the end of the RUNLATER.TXT file, while CSPro is processing this file. 13.0 CatScan Professional Support Sites Scott Green | Mike Ortiz 915 SW Lincoln | 5237 SW 31 Terr. Topeka, KS. 66606 | Topeka, KS. 66614 | BBS : City Limits Software BBS | BBS : The Software Connection (913)357-7552 NODE 1 HST |(913)271-2070 All (913)357-7628 NODE 2 HST |(914)271-2071 Dual FIDONET : 1:281/10 |(913)271-2072 Standards VOICE : (913)357-7546 | (913)271-2073 | (913)271-2074 | (913)271-2076 | FIDONET : 1:281/2 and 1:281/3 | VOICE : (913) 271-2079 14.0 Registering CatScan Professional Registering CSPro will entitle you to the following: o A permanent registered key that will authorize you to run CSPro on a single computer system. Once you obtain the registered key you will not have to call the support board for another DEMO key. o Removal of the "Un-Registered Copy" on the ANSI and RIP Screens displayed as CSPro operates. CSPro will then place your BBS name in that spot. o To register CSPro, fill out the REGISTER.DOC file included in the CSPRO*.ZIP file. You may use either VISA or MasterCard if you wish to use a credit card. When using a credit card, you may complete the form with an ASCII text editor and attach it to a comment on either of the support BBS's. You may also mail ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 42 the registration form with a check or money order drawn on funds from a United States Bank, to either of the support addresses listed in the file REGISTER.DOC. The Cost to register CSPro is $25.00 if you are not already a registered CatScan Owner. If you have previously registered CatScan version 1.x "The Premium File Scanner and Maintainer" then you are entitled to an upgrade discount to CSPro "The Intelligent File Scanner and Maintainer", for $10.00. Customers who registered CatScan after September 15 1993, will receive the upgrade for free. 15.0 ... Acknowledgements o PKZIP, PKUNZIP, and PKSFX - Copr. 1989-1993 PKWARE Inc. o PAK - Copyright 1988-89 NoGate Consulting o NetScan, and Scan - Copyright 1989-93 by McAfee Associates. o ARJ - Copyright (c) 1990-93 Robert K Jung. o LHA - Copyright (c) 1988-1993 Haruyasu Yoshizaki o QARC and XARC - Copyright 1990 System Enhancement Associates, Inc. o GIF2JPG and JPG2GIF - Copyright (c) 1990-91, Handmade Software, Inc. o GIFLITE - Copyright 1991 Tsung Hu. o GIFTTEST - Copyright 1991-93 Max Bernard. o RIPScrip - Copyright 1992-93 TeleGraphix Communications, Inc. o Wildcat! - (c) Mustang Software o MainLine BBS - Copyright 1989 - 1993 by City Limits Software o ZOO Copyright (c) 1988 by Rahul Dhesi o Async Professional, Object Professional, and BTREE Filer - Copyrighted by Turbo Power Software, Colorado Springsl, CO. o Borland Pascal - Copyright Borland International, Scotts Valley, CA. o DigiBoard - Copyright DigiBoard. ----------------------------------------------------------------- CatScan Professional v1.0 Copyright 1993 Page - 43