ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ PKSOFT MULTI-ARCHIVE SYSTEM (c)Copyright PKsoft 1990-1991 Written by Kelvin Goh ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ PKsoft Multi-ARChive System(R) LICENSE STATEMENT PKsoft & the author hereby grants a non-exclusive license to us the PKsoft Multi-ARChive System package, including all its documentation. The software may be used on any computer under the direct control of the licensee, provided that the software cannot possible be used on omore than one computer and by more than one user at the same time unless otherwised stated. The software may not be disassembled or reversed engineered by electronic or any other means. Copies of the software may be made for the sole purpose of backup, archive or distribution but not for commercial sale, without the prior written consent of PKsoft or the author. WARRENTY PKsoft and the author hereby explicitly disclaim all warranties, whether expressed or implied, including, without limitation, the implied warranties of merchantability and fitness for any particular purpose. PKsoft or the author shall not be liable for consequential, incidental, examplary, or special damages, including loss of profits. Dedecated to: The late Mr Ravi Kuppusamy who passed away peacefully on 8 Aug 91. A dear friend who will be sadly missed. My parents for their encouragement to strive throughout the years. CONTENTS ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ Introduction . . . . . . . . . . . . . . . . . . . 1 - 1 Package Contents. . . . . . . . . . . . . . . 1 - 1 Environment . . . . . . . . . . . . . . . . . 1 - 1 Overview. . . . . . . . . . . . . . . . . . . 1 - 2 Setup. . . . . . . . . . . . . . . . . . . . . . . 2 - 1 Main Menu . . . . . . . . . . . . . . . . . . 2 - 1 Address . . . . . . . . . . . . . . . . . . . 2 - 1 Paths . . . . . . . . . . . . . . . . . . . . 2 - 1 Compression . . . . . . . . . . . . . . . . . 2 - 2 Defaults. . . . . . . . . . . . . . . . . . . 2 - 3 Registration. . . . . . . . . . . . . . . . . 2 - 3 PKNODE.CTL. . . . . . . . . . . . . . . . . . 2 - 4 System Setup. . . . . . . . . . . . . . . . . 2 - 4 Registration Information . . . . . . . . . . . . . 3 - 1 Registration Information. . . . . . . . . . . 3 - 1 Appendix A . . . . . . . . . . . . . . . . . . . . 4 - 1 Bundle Calculation. . . . . . . . . . . . . . 4 - 1 Appendix B . . . . . . . . . . . . . . . . . . . . 4 - 2 IMAIL/TosScan Support . . . . . . . . . . . . 4 - 2 Appendix C . . . . . . . . . . . . . . . . . . . . 4 - 3 Features List . . . . . . . . . . . . . . . . 4 - 3 Appendix D . . . . . . . . . . . . . . . . . . . . 4 - 4 Credits . . . . . . . . . . . . . . . . . . . 4 - 4 ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ CONTENTS PKMAS USERS' GUIDE 1 - 1 ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ INTRODUCTION Package Contents ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The following are the contents of the PKMAS package. If you find or suspect any discrepancies, please don't hasitate to call The HOST Connection @ 6:600/400 or any official distribution site to pick up the original package. Program Name Description ------------ ----------------------------------------- PKCOMPAK.COM Compression Routine PKEXTRCT.COM Extraction Routine PKCONFIG.EXE Configuration Program PKCONFIG.HLP Context Sensitive Help File PKNODE.CTL Example Node Control File PKMAS.TXT Program Documentation CHANGES.TXT Program History/Changes REGISTER.TXT Registration Form ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ Environment ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Minimum hardware requirements: o An IBM PC, AT,, 386, 486, with 100% PC BIOS compatible computer with at least 300KB available memory. o A monochrome or color monitor. o A mouse (optional) Minimum software requirements: o MS or PC-DOS 3.10 or later, or DR-DOS 5.00 or later. o An echomail processor like Zmail(tm) or ConfMail(tm); Zmail is prefered. ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ INTRODUCTION PKMAS USERS' GUIDE ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ Overview 1 - 2 ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ PKMAS was written to meet the needs of memory hungry Sysops, running multi-line systems. The package takes advantage of memory overlays and executes a program directly instead of using the COMMAND.COM! This effectively reduces memory usage to a bare 20KB, and this is overlayed when the archive program runs. To assist in configurations, a specially written setup program was incorporated. This program features, among other things full mouse support, DesqView(tm) buffered screen writes, context sensitive help and automatic video detection. This should help most first time BBS operators to configure this software with at little hassle as possible. Much time and effort has gone into the programming and beta testing of this software. I would like to take this opportunity to thank all my beta testers for their invaluable help and suggestions. Special thanks to: Pete Franchi @ 2:253/157 "I'll trash it for you" Jason Steck @ 1:104/424 "Let me test it out further" Peter Tan @ 6:600/403 "Maybe if you...." Charles Cheong @ 6:600/307 "Why not add....." Robert Prowl "Hmmm. Let me see now...." Thanks again guys. Without your help, I guess this software will still be on the shelf! ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ INTRODUCTION PKMAS USERS' GUIDE 2 - 1 ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ SETUP Main Menu ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ To configure the PKMAS package, you'll need to run the PKCONFIG.EXE program. The program breaks down the configuration into 5 parts. They are: Address - This is your Primary Network Address. Paths - Defines paths and filenames. Compression - Compression program definition. Defaults - Some system defaults. Registration - To enter your unique registration information. We will examine each item closely. ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ Address ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This defines your primary network address. It must be in the format ZZZ:NNNN/nnnn. Any of the positions not in use must be filled by zeros (0). For example, if your primary network address is 6:600/400, then you would enter 006:0600/0400. It is essential that you enter ONLY your primary address because this field is used to calculate the origin/destination address from each bundle. ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ Paths ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Logfile refers to the logfile that you wish to append to when PKMAS operates. By default, the logfile is ZMAIL.LOG and the path is C:\RA. You may wish to change this. ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ SETUP PKMAS USERS' GUIDE 2 - 2 ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ Badmail refers to the path (and path only) to place bundles that are larger then a given size (see Defaults). These bundles can be extracted manually later. A trailing back slash (\) is recommended though not necessary. ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ Compression ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This menu allows for a further definition of 5 compression and extraction programs. By default, the PKMAS package has a predefined set of archive programs. These include: Label Program ----- --------------------------------------------------- LZH LHA.EXE(tm) v2.12 by Haruyasu Yoshizaki ZIP PKZIP.EXE(tm) v1.1 by PKWARE Inc. RZIP --- As Above --- (For registered PKZIP) PAK PAK.EXE(tm) v2.51 by NoGate Consulting ARC PKPAK.EXE(tm) v3.61 by PKWARE Inc. ARJ ARJ.EXE (tm) v0.20 by Robert K Jung The above labels should never be used when defining a new archive program. The fields for the definable compression system are: Archiver - The archive program name. No paths are required as the program will search the DOS path for the archiver. UnArchiver - The unarchiver program name. Again, no paths are required as the program will search the DOS path for the unarchiver. Command Line - This defines the command line options to be used by archiver/unarchiver. Each option must be saparated by a space. ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ SETUP PKMAS USERS' GUIDE 2 - 3 ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ Unique Label - This is the label that PKCOMPAK will use when it searches the PKNODE (see PKNODE) file for the packing method. ID Bytes - This is the ID Bytes of the archive program. Only look for bytes that are constant. Bytes that are not used must be specified as 000. PKEXTRCT searches only the first 8 bytes of the bundle, so archive programs like DWC cannot be specified as it uses the last 8 bytes of the archive. ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ Defaults ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This menu defines the Maximum Bundle Size and the Logfile type. The maximum bundle size refers to the size of the archive file when it arrives at the system for further processing. Some sysops would like to manual extract large bundles. The maximum bundle size is a figure in KB to a maximum of 9999KB or 9.9 MB! If these feature is not desirable, it can be turned off by specifying 0000. Logfile type refers to the logging method to be used by the program. At present, only OPUS(tm)/BinkleyTERM(tm) and FrontDoor(tm) logging systems are supported. ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ Registration ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This menu is used to enter your registration information once you have received your registration key. The Registered Name and BBS Name *MUST* be exactly the same as that used in your registration form. This includes capitalisations. Please refer to the section on Registration Information for more information. ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ SETUP PKMAS USERS' GUIDE 2 - 4 ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ PKNODE.CTL ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The PKNODE.CTL file defines that packing method for individual nodes and the default packing method. The format is as follows: [-