JRchive File Archiving and Compression Software User's Manual JAYAR Systems 253 College Street Suite 263 Toronto, Ontario Canada M5T 1R5 (416) 751-5678 e-mail: jrsys@io.org World Wid Web: http://www.io.org/~jrsys LICENSE The license for the Shareware evaluation (trial use) version of JRchive is contained in the file LICENSE.DOC. This file has been included for your convenience as an appendix to this manual. WARRANTY The Shareware evaluation (trial use) version of JRchive is provided AS IS. JAYAR Systems MAKES NO WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE. SUPPORT POLICY JAYAR Systems provides free support for this product. We will answer questions and fix serious bugs. If you have any questions about or problems with using this product, give us a call, send us e-mail or, if you are not in a rush, send us a letter. We would also appreciate hearing from you if you have any comments or suggestions for improvements. _______ ____|__ | (R) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER JRchive Copyright (C) 1992-95 JAYAR Systems All Rights Reserved CONTENTS 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 Using JRchive . . . . . . . . . . . . . . . . . . . . . . . . . 3 3 Installing JRchive . . . . . . . . . . . . . . . . . . . . . . 4 4 Creating archives with JRC . . . . . . . . . . . . . . . . . . 5 Options . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Arguments . . . . . . . . . . . . . . . . . . . . . . . . . 6 Examples . . . . . . . . . . . . . . . . . . . . . . . . . . 6 5 Listing archives with JRCL . . . . . . . . . . . . . . . . . . 8 6 Extracting files with JRCE . . . . . . . . . . . . . . . . . . 9 Options . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Arguments . . . . . . . . . . . . . . . . . . . . . . . . . 10 Examples . . . . . . . . . . . . . . . . . . . . . . . . . . 10 7 Creating self-extracting archives with SELFEX . . . . . . . . . 11 8 DOS--UNIX transfers . . . . . . . . . . . . . . . . . . . . . . 12 A Caveat . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 B Error messages . . . . . . . . . . . . . . . . . . . . . . . . 14 C License . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 D Trial Use License: . . . . . . . . . . . . . . . . . . . . . . 17 E Limited Distribution License: . . . . . . . . . . . . . . . . . 18 F Definition of Shareware . . . . . . . . . . . . . . . . . . . . 20 G How to Register . . . . . . . . . . . . . . . . . . . . . . . . 21 iii 1 Introduction JRchive is a system for compressing and archiving files. The process of archiving files involves packing a number of separate files into one _______ archive file. As the files are added to the archive they may be compressed so that the archive file takes less space on disk than the individual files do. Actually there are two ways of compressing files in an archive. You may have some or all of your files compressed as you add them to the archive, or the files can be added to the archive in an uncompressed form ____________ and the archive as a whole compressed. The latter is called a concatenated _______ archive; it can save even more space if the archive consists of many small files or files with similar characteristics. What kinds of files can be compressed? Just about anything. Text files usually yield the best compression ratios--50% or better. Binary files such as executables will compress as well but not by so much. Only files with completely random data (which are quite rare) or files that have already been compressed will not be reduced in size. Why would you want to create an archive? There a number of good reasons: o Archives are convenient for storing related files. It is easier to copy, transport and keep track of one file than many. o If the archive is compressed it can save you a great deal of space on your hard disk or on floppies. o A compressed archive can be transmitted by modem much faster and easier than the individual files can be. o If you are a software developer or if you send files on diskette to your friends and associates then JRchive is ideal. You can pack more files on to fewer diskettes. You can distribute the extraction program without restriction with your archives. Or, you can create a self-extracting archive. The end user executes the archive like a program and it extracts its component files automatically. You can also include a display file in the archive which will display a message to the user while extraction is taking place. Otherwise extraction proceeds quietly. o JRchive is available for the DOS and UNIX operating systems. Compressed archives can be transmitted between these two operating systems by network or modem faster and with less effort than individual files can 1 Introduction 2 be. JRchive consists of a suite of four programs, described briefly in section 2. One section of this manual is devoted to describing each program and its use. The programs are easy to use and the manual is short. Spend a few minutes with it and you will be able to use all the features of JRchive. The programs in JRchive use a UNIX-style command line interface: the program name, followed by zero or more one-letter options each preceded by a - sign, followed by one or more arguments. Using JRchive 3 2 Using JRchive JRchive comprises four separate programs. In this section we will just present the purpose of each of the programs. More detailed information will be given in following sections. JRC is the program which creates an archive or adds files to an existing archive. You use this program to compress and archive your files. JRCE is the companion program which extracts files from an archive. You may extract all or just some of the files in an archive. JRCL is a program which shows you what programs are in an archive and gives you information on their size, format and modification date. Finally, SELFEX is a version of JRCE which is not used directly by itself but which is used to build a self-extracting archive. Installing JRchive 4 3 Installing JRchive Installation of JRchive couldn't be easier. The distribution diskette contains the four programs described in Section 2 and a file called README which you should check for any last minute updates which did not make this manual. The distribution diskette is not copy protected so you can copy the programs to your hard disk--a good location would be the directory where you keep your utilities. It should be a directory that is pointed to by your PATH environment variable so they will be easy to use. It is also possible to use any of the JRchive programs from a floppy diskette. A feature of JRchive is that the component programs are quite small and don't require a lot of memory or disk space so they are convenient to use even from a diskette. In any event, don't execute the programs from the distribution diskette. Copy them to another disk and put the distribution diskette away in a safe place. To install JRchive on a UNIX system, see the file BUILD.DOC on the distribution diskette. Creating archives with JRC 5 4 Creating archives with JRC An archive is a file that contains one or more component files. You use the program JRC to create an archive. By default JRC will attempt to compress files as it adds them to the archive. If a file cannot be compressed then it will be added in an uncompressed form. You can specify that JRC not attempt file compression when adding files. Why would you want to forego compression? If you don't care about the size of the archive then suppressing compression will save time. Or, if you are archiving files that are already compressed such as graphics interchange format (gif) files you should suppress compression. JRC will attempt to compress these files even though it will not be able to, thereby wasting a lot of time. ____________ _______ You can also specify that JRC create a concatenated archive. In this case JRC builds the archive by adding files to it in an uncompressed form--it then compresses the entire archive as a unit. The advantage of a concatenated archive is that it can achieve better compression ratios, depending on the nature of the files in the archive, than is possible by compressing the files individually. This is especially true if the files are small or have similar characteristics; JRC can detect pattern repetition across the entire archive. The disadvantage of a concatenated archive is that it cannot be extended, i.e., you can't add more files to it later. The syntax for executing JRC is _______ ________ ________ jrc [-v] [-N] [-c] [-u] archive [-n] [-d] filespec [[-n] [-d] filespec ... ] JRC uses a UNIX-style command line syntax; program action is modified by including options preceded by - signs. Items in square brackets are optional. Options There are four global options which apply to all files in the archive and two local options which apply only to the immediately following file specifiers. -v is the verbose option. Normally JRC runs quietly. The -v option will cause it to display the name of every file added to the archive as well as the compressed size of the file expressed as a percentage of its original size. Creating archives with JRC 6 -N is the global non-compression option. Including this option prevents JRC from compressing any of the files added to the archive in this invocation of the program. -c is the concatenated archive option. This causes JRC to create a concatenated archive as defined at the beginning of this section. This option is not valid with an existing archive--it can only be specified for new archives. -u is the UNIX transfer option. It should be specified when creating a text file archive on DOS that will unpacked on UNIX. -n is the local non-compression option. This option is included before a file specification and suppresses compression of the files selected by the immediately following file specification. -d is the display option. Files preceded by this option are added to the archive as any other file, however, they are flagged in the archive as display files. When files are extracted from the archive the display file(s) is displayed on the user's terminal--it is not extracted. Use this option if you want to display a message when extraction is taking place. Arguments _______ archive is the name of the archive file. If the file does not exist it is created. If the file exists and is a valid JRchive archive then files will be added to it. ________ filespec is a file specification. There may be more than one on the command line. Wildcard characters are permitted in a file specification and have the usual effect. You can include a full pathname for a file but not in combination with filenames containing wildcard characters. In any event only the file name portion is stored. This means that when you extract the file from the archive it is recreated in the current directory. JRchive will not recreate directory trees. (The registered version of JRchive can deal with directories however). Examples jrc -c -v source.jrc *.c *.h This example creates a concatenated archive file called SOURCE.JRC. It will contain all files in the current directory with extensions .c and .h. jrc -v text -d message -n header a:*.txt Creating archives with JRC 7 This example creates an archive file called TEXT. It contains the display file MESSAGE which will be printed when files are extracted from the archive, a file called HEADER which will not be compressed when it is added to the archive, and all the files in the current directory on drive A: with extension .TXT. These files will be compressed. In both examples the verbose option is specified so that file names and compression ratios will be printed out as files are added to the archive. Listing archives with JRCL 8 5 Listing archives with JRCL JRCL is the program which shows you what files are in an archive. The syntax for executing JRCL is _______ ______ jrcl archive [target] _______ JRCL prints for every file in archive its name, whether it is a compressed or display file, its size in bytes (its compressed size if it is compressed), and the file's time stamp. The time stamp is the date and time of the file's last modification as supplied by DOS. JRCL behaves somewhat differently if you include a target file specification. In this case it only lists those files in the archive that ______ match target. Upper case letters are treated the same as lower case when ______ specifying target and partial matches are allowed. For example, jrcl source input.f will list the entry for the file INPUT.F if it is in the archive SOURCE. It will also list the entry for INPUT.FOR (or for that matter INPUT.F??) if it is in the archive as well. jrcl source a will list all the files in the archive beginning with the letter A. JRCL cannot list the files in a concatenated archive as the archive would have to be uncompressed first. Extracting files with JRCE 9 6 Extracting files with JRCE JRCE is the program you use for extracting files from an archive. If the files were compressed when added to the archive they will be uncompressed automatically. Concatenated archives are also handled automatically by JRCE and in all respects you treat them the same as a normal archive. The syntax for executing JRCE is _______ ______ jrce [-v] [-t] [-l] [-u] archive [target] If invoked without the optional target argument JRCE extracts all of the files in the archive into your current directory. If JRCE encounters a display file (see Section 4) in the archive it prints out the display file on the user's screen, otherwise it produces no screen output unless the -v option is selected. If JRCE finds a file in the archive with the same name as one in the current directory it will ask you if you want to overwrite the file in the current directory. Replying with a Y or y will cause the file to be overwritten; replying with any other letter (including just a ) will prevent that file from being extracted from the archive. Note that you may freely distribute JRCE.EXE (and only JRCE.EXE) with your archive files to enable others to extract files from them. Options -v is the verbose option. Normally JRCE extracts files from the archive quietly. If you include this option it will display the file name and original time stamp of each file it extracts from the archive. -t is the time stamp option. By default when JRCE extracts a file from an archive it restores the file's time stamp (the date and time the file was last modified--supplied by the operating system) that it picked up when it archived the file. If you include this option JRCE will use the current date and time as the file's time stamp. -l is the lowercase option. On a UNIX system this forces the filenames of restored files to consist of all lowercase letters. Otherwise, files that were archived on a DOS system may be restored with uppercase names. -u is the UNIX option. You should specify this option on DOS systems when unpacking text file archives that were created on a UNIX system. Extracting files with JRCE 10 Arguments _______ archive is the name of the archive file from which JRCE will extract files. These files will be recreated in the current directory. It is not necessary for the archive file to be in the current directory. ______ target is a file selector which may be used to restrict the files _______ that JRCE extracts from archive. Normally JRCE extracts all files from an ______ archive. If you include target as an argument JRCE will only extract those ______ files whose names match target. Upper case and lower case are treated the ______ same in specifying target and partial matches are allowed. If you include a target then any display files in the archive will ______ ______ not be printed unless they match target. Also, files matching target will be extracted regardless of whether or not there is a file of the same name in the current directory--you will not be asked to confirm first. Examples jrce -v -t arch.jrc will extract all files from the archive file ARCH.JRC. As the files are extracted their names and original time stamps will be displayed on the screen. The files' time stamps will be set to the current date and time however. jrce source.jrc abc will extract any files whose names begin with the letters ABC from the archive file SOURCE.JRC. The extraction will proceed quietly. Creating self-extracting archives with SELFEX 11 7 Creating self-extracting archives with SELFEX If you are using JRchive to create archives for distribution it can be inconvenient to distribute the JRCE program along with the archive and explain its use. If you are a software developer this can add another layer of confusion to the distribution and installation process. _______________ _______ In this case what you need is a self-extracting archive. This is a program that the user runs--it contains an archive and extracts its contents as it runs. To construct a self-extracting archive you need the SELFEX file distributed as part of the DOS version of JRchive. SELFEX is not available for UNIX systems. We will explain how to create a self-extracting archive with an example. Suppose you want to distribute a software system consisting of o two programs, ONE.EXE and TWO.EXE, o a documentation file called DOC.TXT, o a file containing late developments called READ.ME o a file that contains a message for the user to read while the files are extracting called MESSAGE.TXT. First archive the files: jrc -v arch -d message.txt read.me one.exe two.exe doc.txt This creates an archive file called ARCH (you can use any name). Now convert this to a self-extracting archive: copy/b selfex+arch mysystem.exe This uses the DOS COPY command to paste SELFEX and your archive file together in one file called MYSYSTEM.EXE. Important points to note are that you must include the /B switch on COPY and the output file must have an extension of .EXE. Now you just send the MYSYSTEM.EXE (you can use any name in place of MYSYSTEM) file to your users. When a user runs this program by typing mysystem the material in MESSAGE.TXT is displayed on the screen and the files ONE.EXE, TWO.EXE, DOC.TXT and READ.ME are created in the current directory. DOS--UNIX transfers 12 8 DOS--UNIX transfers JRchive is available for both DOS and UNIX systems and provides a very convenient means of transferring files between the two operating systems. Some precautions must be taken when transferring text files between the two systems though. This is because UNIX uses a single character to _______ represent the newline character while DOS uses a two-character combination. For this reason archives created on one system for transfer to the other should consist of all text files (i.e., human-readable) or all binary files (i.e., non-readable)--do not mix the two. If the software you are using to exchange files between DOS and UNIX (e.g., KERMIT, ftp, etc.) has a "binary" file transfer mode, be sure to use it. Note that the default file transfer mode is usually "ascii" or "text"--this mode will not give correct results even if the archive consists solely of text files. For specific transfers between the two operating systems, use the following guidelines: o Binary file archives; DOS to UNIX or UNIX to DOS: No special requirements. These archives can be created and extracted on both systems. o Text file archives; DOS to UNIX: Use the -u option when creating the archive with JRC on DOS. Run JRCE in the usual way on UNIX to extract files from the archive. Use the -l option for JRCE if you want the file names in lowercase letters (DOS considers all file names to be in upppercase letters). o Text file archives; UNIX to DOS: Create the archive in the usual way with JRC on UNIX. Use the -u option when extracting files from the archive on DOS. Note that you can use jrce -u ... to extract files on DOS from an archive that was created on DOS with jrc -u .... In summary, when exchanging binary files between the systems, no special procedure is required; when exchanging text files, use the -u option on the DOS programs. The -u option is not recognized on the UNIX versions of the programs. Caveat 13 A Caveat We have taken a lot of care in the development of JRchive and we are reasonably sure that it is bug-free. However, it is the nature of computer software that you can never test it completely and certainly not against all possible inputs. There is always the possibility, however remote, that a particular input can cause one of the programs to fail. Therefore, if you compress important or difficult-to-reproduce files into an archive, you should extract them from the archive and compare them to the originals. Use the DOS COMP or UNIX cmp command to perform the comparison. To do this you will need to rename the original files or __ ____ ___ _______ extract the archived files into a different directory. Be sure you perform ____ __________ ______ ___ ______ ___ ________ ______ this comparison before you delete the original files. For example, say you want to compress the file VALUABLE.FIL into the archive file SAVE and make sure you can uncompress VALUABLE.FIL before deleting the original. On DOS, you would execute the following: jrc save valuable.fil ren valuable.fil valuable.old jrce save valuable.fil comp valuable.fil valuable.old If the compare shows the files to be identical, then type del valuable.* Error messages 14 B Error messages This section describes the error messages that the JRchive programs may produce and offers suggestions on how to remedy the problems they indicate. ____ Invalid option -opt] An undefined program option (a minus sign followed by a letter) was specified. Type the program name alone without options or arguments and it will list the valid options. -c option invalid with existing archive The concatenated archive option was specified with an existing archive. An existing archive can be extended, but the concatenated option cannot be used. Concatenated archives are created in one step and cannot be extended. ________ filename exists and is a concatenated archive The archive file already exists but it cannot be extended because it is a concatenate archive. Ordinary archives can be extended; concatenated archives are created in one step and cannot be extended. ________ filename is not a JRchive archive file The file specified as an archive file exists but is not an archive file. An attempt was made to extend it, unpack it or list its contents. ________ filename: not a regular file The named file was to be added to an archive, but it is not a regular file--most likely it is a directory. ________ ____ Cannot open file filename for mode mode The named file--either an archive or file to be added to an archive cannot be opened. Check to see that its path was specified properly. ________ filename: No such file or directory The file specified to be added to an archive does not exist in the current directory. When building an archive you must execute JRC from the directory in which the files to be added reside. The archive file itself may reside in a different directory. ________ File filename cannot be opened The named archive file cannot be found--check to make sure you have specified the path correctly. ________ ____ Cannot open temporary file filename for mode mode The JRchive programs use temporary files for building and unpacking archives. This error likely means that there is not enough space on the Error messages 15 device (perhaps a floppy disk) to open one. Unable to allocate memory One of the programs was unable to allocate memory for its internal tables. You should never see this error--if you do, please contact JAYAR Systems. The following errors indicate that JRCE is unable to proceed with decompression or unpacking of an archive file. These will only occur if the archive file has been corrupted or partially overwritten. Stack overflow in expansion Premature end of data End of data _ Invalid file code c License 16 C License This appendix contains important license information regarding the use of JRchive, Version 1.10. This information applies to individual users who wish to pass copies out to friends and associates. User Groups, Computer Clubs, Disk Vendors and Distributors, Subscription Services, Disk-of-the-Month Clubs, etc., should refer to the VENDOR.DOC file for complete information relating to them. BBS SYSOPs should refer to the SYSOP.DOC file for complete information relating to them. PLEASE! Show your support for Shareware by registering the programs you actually use. JAYAR Systems depends upon and needs your support. Thank you! Trial Use License: 17 D Trial Use License: JRchive is NOT a public domain program. It is Copyright (C) 1992-95 by JAYAR Systems. All rights reserved. This software and accompanying documentation are protected by Canadian Copyright law and also by International Treaty provisions. Any use of this software in violation of Copyright law or the terms of this limited license will be prosecuted to the best of our ability. The conditions under which you may copy this software and documentation are clearly outlined below under "Distribution Restrictions". JAYAR Systems hereby grants you a limited license to use this software for evaluation purposes for a period not to exceed sixty (60) days. If you intend to continue using this software (and/or it's documentation) after the sixty (60) day evaluation period, you MUST make a registration payment to JAYAR Systems. Using this software after the sixty (60) day evaluation period, without registering the software is a violation of the terms of this limited license. Licensee shall not use, copy, rent, lease, sell, modify, decompile, disassemble, otherwise reverse engineer, or transfer the licensed program except as provided in this agreement. Any such unauthorized use shall result in immediate and automatic termination of this license. All rights not expressly granted here are reserved to JAYAR Systems. For information on registering your copy of JRchive see Appendix G, "How to Register." Limited Distribution License: 18 E Limited Distribution License: As the copyright holder for JRchive, JAYAR Systems authorizes distribution by individuals only in accordance with the following restrictions. (User Groups, Computer Clubs, Disk Vendors and Distributors, Subscription Services, Disk-of-the-Month Clubs, etc., should refer to the VENDOR.DOC file for complete information relating to them.) (BBS SYSOPs should refer to the SYSOP.DOC file for complete information relating to them.) Individuals are hereby granted permission by JAYAR Systems to copy the JRchive diskette for their own use (for evaluation purposes) or for other individuals to evaluate, ONLY when the following conditions are met. The JRchive package is defined as containing all the material listed in the PACKING.LST text file. If any files listed in the PACKING.LST text file, or the PACKING.LST file itself, are missing, then the package is not complete and distribution is forbidden. Please contact us to obtain a complete package suitable for distribution. o The JRchive package--including all related program files and documentation files--CANNOT be modified in any way and must be distributed as a complete package, without exception. The PACKING.LST text file contains a list of all files that are part of the JRchive package. o No price or other compensation may be charged for the JRchive package. A distribution cost may be charged for the cost of the diskette, shipping and handling, as long as the total (per disk) does not exceed $10.00. o The JRchive package CANNOT be sold as part of some other inclusive package. Nor can it be included in any commercial software packaging offer, without a written agreement from JAYAR Systems. o The PRINTED User's Guide may not be reproduced in whole or in part, using any means, without the written permission of JAYAR Systems. In other words, the disk-based documentation may not be distributed in PRINTED (hardcopy) form. o The JRchive package cannot be "rented" or "leased" to others. o Licensee shall not use, copy, rent, lease, sell, modify, decompile, disassemble, otherwise reverse engineer, or transfer the licensed Limited Distribution License: 19 program except as provided in this agreement. Any such unauthorized use shall result in immediate and automatic termination of this license. o U.S. Government Information: Use, duplication, or disclosure by the U.S. Government of the computer software and documentation in this package shall be subject to the restricted rights applicable to commercial computer software as set forth in subdivision (b)(3)(ii) of the Rights in Technical Data and Computer Software clause at 252.227-7013 (DFARS 52.227-7013). The Contractor/manufacturer is JAYAR Systems, 253 College Street, Suite 263, Toronto, Ontario, CANADA M5T 1R5. All rights not expressly granted here are reserved to JAYAR Systems. Definition of Shareware 20 F Definition of Shareware Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Individual programs differ on details--some request registration while others require it, some specify a maximum trial period. With registration, you get anything from the simple right to continue using the software to an updated program with printed manual. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee--if you don't use the product, you don't pay for it. ASP OMBUDSMAN POLICY This program is produced by a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road Muskegon, MI 49442 or send a CompuServe message via CompuServe Mail to ASP Ombudsman 70007,3536. How to Register 21 G How to Register JRchive is a "shareware program" and is provided at no charge to the user for evaluation. Feel free to share it with your friends, but please do not give it away altered or as part of another system. The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you find this program useful and find that you are using JRchive and continue to use JRchive after a reasonable trial period, you must make a registration payment of US$29.00 (Cdn$34.00) to JAYAR Systems. The registration fee will license one copy for use on any one computer at any one time. When you register you receive the following: o You will get the latest version of JRchive, o The registered version of JRchive does not display a banner (registration reminder notice) when it runs, o You will get a typeset manual, o The shareware version of JRchive does not recognize directories; you must create and restore archives in the current working directory. The registered version can create archives from directories and recreate the directory subtree during restoration. o You will get the utilities CUT and PASTE. CUT breaks up large files into pieces which fit on a diskette. PASTE reassembles them. An ideal utility for developers and distributors. o You will be informed of updates and given a reduced upgrade cost. You must treat this software just like a book. An example is that this software may be used by any number of people and may be freely moved from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as a book cannot be read by two different persons at the same time. Commercial users of JRchive must register and pay for their copies of JRchive within 30 days of first use or their license is withdrawn. Your registration fee purchases a single user license. If you need to use multiple copies, significant savings can be had by purchasing a site license rather than registering multiple individual copies. Even a two-user site license saves you money. See the file SITELICE.DOC for details. How to Register 22 Anyone distributing JRchive for any kind of remuneration must first contact JAYAR Systems at the address given in DESCRIBE.DOC for authorization. This authorization is automatically granted to distributors and vendors who are members of the Association of Shareware Professionals (ASP). See files VENDOR.DOC and SYSOP.DOC for details. You are encouraged to pass a copy of JRchive along to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. All registered users will receive a copy of the latest version of the JRchive system. Note that JRchive is available for UNIX as well as for the DOS operating system. If you are ordering the DOS version, you may order a single-user UNIX version at the same time for only half price. If you want to order the UNIX version alone, or if it will be used in a multiuser or networked environment you must use the site license application form for ordering (see file SITELICE.DOC). The UNIX version is shipped as obfuscated C source code and will compile on most systems. Give us a call if you have any questions about this option. Send in the following form to register your copy of JRchive: REGISTRATION FORM Send to: JAYAR Systems GST Registration Number: 253 College Street R124607193 Suite 263 Toronto, Ontario Canada M5T 1R5 Name ___________________________________________ Address ___________________________________________ ___________________________________________ ___________________________________________ ___________________________________________ Telephone __________________________ +--------+------------------------+------------+------------+ |Quantity| Product | Each | Total | +--------+------------------------+------------+------------+ | | | US$29.00 | | | | JRchive | or | | | | | Cdn$34.00 | | +--------+------------------------+------------+------------+ | |single user UNIX version|1/2 of above| | +--------+------------------------+------------+------------+ | Canadian residents add 7% GST | | +----------------------------------------------+------------+ | Ontario residents add 8% PST | | +----------------------------------------------+------------+ | Outside Canada/U.S.A., add shpg/hndlg | $5.00 | +----------------------------------------------+------------+ | TOTAL | | +----------------------------------------------+------------+ DISK FORMAT (check one): 5-1/4"DD [ ] 5-1/4"HD [ ] 3-1/2"HD [ ] Please remit by cheque (we will accept cheques in your local currency at the appropriate rate of exchange) or by money order. We will accept your company's purchase order. We also accept payment by Visa or Mastercard. P.O. Number ______________________________________ (P.O. to follow) +------------------------------------------------------------------+ | Note - Fill out the following ONLY if you are making payment by | | credit card. You may also call (416) 751-5678 for credit | | card registrations. | | | | Master Card [ ] Visa [ ] Card Number ______ ______ _____ ______ | | | | Name on the Card (print) _______________________________________ | | | | Expires ____/____ | | Signature ___________________________________ | | | +------------------------------------------------------------------+