_______ _______ ___ COMPARE Version 3.0 ____ __________ _______ File Comparison Program ___ ___ __ _____ for the HP e3000 _______ ____ ______ Compare User Manual _______ _________ __________ ____ Robelle Solutions Technology Inc. ____ ___ _______ _____ ___ 7360 137 Street, Suite 372 _______ ____ ______ ___ ___ Surrey, B.C. Canada V3W 1A3 __________ _____________ Toll-free: 1.888.robelle ________________ (1.888.762.3553) ______ ____________ Phone: 604.501.2001 ____ ____________ Fax: 604.501.2003 ___________________ support@robelle.com _______________ www.robelle.com _____ ____ April 2004 Program and Manual Copyright Robelle Solutions Technology Inc. 1982-2008 Portions Copyright 1978, J. Miner All rights reserved. ___ Permission is granted to reprint this document (but not for profit), provided that copyright notice is given. QEDIT and SUPRTOOL are trademarks of Robelle Solutions Technology Inc. Other product and company names mentioned herein may be the trademarks of their respective owners. 1 _______ _ _______ __ _______ Chapter 1 Welcome to Compare _ _____________ __ ___ _______ * Authorization to Use Compare _ ____ ______ * User Manual _ ___ _____ * DIF Users _ ___ ________ __ _______ * New Features of Compare Welcome to version 3.0 of Compare -- a file comparison program for text files. Compare answers the question, "How different are these two text files?" Compare tells you whether lines have been added, or how blocks of lines differ. Compare is available for MPE/iX (only), and it works with both regular Keep files and Qedit workfiles (original and Jumbo format). The Keep file can have either fixed- or variable-length records. _____________ __ ___ _______ Authorization to Use Compare Compare is a "bonus" program that accompanies most Robelle products. We will send you a copy if your Robelle order entitles you to receive it. As a Robelle customer you may install Compare on your CPUs which are licensed for our products. There is no ___ charge for using Compare, but you are not free to distribute it. Please install Compare only on your primary licensed CPUs, or on CPUs which are registered secondary CPUs. Compare is in the PUB group to remind you that it is a Bonus product, and not part of any library that you can freely distribute. There is another category of programs from Robelle, called the "Qlib". These are programs which you may use on any ___ CPU and may distribute freely to your friends. Compare is not part of the Qlib. If you have questions on whether you are authorized to install Compare on a particular CPU, please call us for advice. ____ ______ User Manual The Compare User Manual is included on the distribution tape as the file Compare.Doc.Robelle. To print it on an HP LaserJet or a regular lineprinter, run the Printdoc program. :run printdoc.pub.robelle;info="compare.doc.robelle" Printdoc is menu-driven and easy to use. Printdoc asks you for information, and if you are not sure of your answer, you can ask for help by typing a question mark (?) and pressing the Return key. There are two steps in printing a manual: first, choose one _______ _ _______ __ _______ 2 Chapter 1 Welcome to Compare of the manuals on the menu; second, select a printer. Printdoc supports all HP LaserJets and regular lineprinters. The Compare User Manual describes how to install Compare, how to access it, and how to read the reports that it generates. ___ _____ DIF Users DIF was a file comparison program that Robelle distributed many years ago. Although both DIF and Compare perform file comparison, Compare is a completely new program and is not a direct replacement for DIF. Therefore, if you have jobs or command files that use DIF, you cannot just replace Dif.Pub.Robelle with Compare.Pub.Robelle. The main differences between DIF and Compare are summarized below: 1. DIF is a compatibility-mode program, whereas Compare is a native-mode program. This means that DIF can be used on both MPE V and MPE/iX, while Compare can only be used on MPE/iX. 2. You access DIF by typing in commands inside the program; you access Compare by using :File equations and specifying commands in the Info= string of the MPE :Run command. 3. DIF lists the lines that are different, but Compare lists these lines as well as additional comments telling you whether the lines were added or changed. ___ ________ __ _______ ____ New Features in Version 3.0: * Compare now has better heap space management. ___ ________ __ _______ ____ New Features in Version 2.9: * Compare can process text files with records up to 8,172 characters wide. Qedit workfiles are limited to 1,000 characters i.e. jumbo workfiles. Compare does not abort anymore if a text file is wider than the limits. If a text file exceeds the new limit, Compare uses only the first 8,172 characters and ignores the rest. ___ ________ __ _______ ____ New Features in Version 2.8: * Compare displays filenames in appropriate notation. MPE files appear as filename.group.account and Posix (HFS) files appear in the absolute path notation starting with a slash "/". _______ _ _______ __ _______ Chapter 1 Welcome to Compare 3 ___ ________ __ _______ ____ New Features in Version 2.7: * Compare properly detects if Time Machine is installed. ___ ________ __ _______ ____ New Features in Version 2.6: * Two-user site licenses can now run Compare. * Compare no longer misses the last few lines of certain Jumbo Qedit files. ___ ________ __ _______ ____ New Features in Version 2.5: * Compare now works with Time Machine and the HP utility Setdate. ___ ________ __ _______ ____ New Features in Version 2.4: * Fixed occasional abort when reading Jumbo text files. ___ ________ __ _______ ____ New Features in Version 2.3: * Compare can read Jumbo text files wider than 256 characters. ___ ________ __ _______ ____ New Features in Version 2.2: * Compare can read Qedit's new Jumbo files. ___ ________ __ _______ ____ New Features in Version 2.1: * Input file names can be specified on the command line. * Command line options can be preceded by a dash. 4 _______ _ _________ _______ Chapter 2 Accessing Compare _ _____ _________ * Info= Filenames _ _____ _______ * Info= Options _ ____ _______ _______ * User Defined Command _ ____ ______ * Help Screen _ ___ _______ _____ * Job Control Words _ _______ ____ * On-Line Help _ _________ * Control-Y Compare uses the following three files: filea {first file} fileb {second file} outfile {output file} Filea and Fileb are the two input files. Typically, you would use :File equations to assign Filea and Fileb to the files that you want to compare. _____ ____ :file filea=first file ______ ____ :file fileb=second file ______ ____ :file outfile=output file :run Compare.Pub.Robelle The output file Outfile is created as a temporary file by default. You can use a :File equation to change the characteristics of the Outfile, and you can redirect it to another file or device. Here, you would also usually use a :File equation to assign $Stdlist to the Outfile. _____ _________ Info= Filenames Instead of using :File equations for filea and fileb, you can specify the names of the two files to compare in the Info= string. To use this feature, the Info= string must be formatted as follows: 1. It must begin with a dash. 2. All options must be preceded with a dash. To fulfill the first requirement, you can either put an option in the beginning, or just put a dash by itself. :file outfile=$stdlist :run compare.pub.robelle;info="-f2 thisfile thatfile" :run compare.pub.robelle;info="- thisfile thatfile" compare.pub.robelle "- thisfile thatfile" _______ _ _________ _______ Chapter 2 Accessing Compare 5 Note that the output file Outfile still uses a :File equation. Also note that the third example, which uses the Implied Run feature of MPE/iX, requires quotes around the parameters. _____ _______ Info= Options Additional run-time options for Compare are specified in the Info= _______ string. These options are described in their own chapter Compare _______ Options. ____ _______ _______ User Defined Command We suggest that you use the following UDC to invoke Compare. Subsequent examples of invoking Compare in this manual will use this UDC. COMPARE filea, fileb, outfile="$STDLIST", info="" file filea=!filea file fileb=!fileb file outfile=!outfile run compare.pub.robelle;info="!info" reset filea reset fileb reset outfile **** To invoke this UDC, specify the UDC name "Compare" and the names of two files to compare. The Outfile parameter is optional and defaults to $Stdlist. Error messages from Compare are always written to $Stdlist. The Info parameter is also optional, and defaults to a null string (i.e., no additional options). The following are valid examples for invoking the UDC: _____ ____ ______ ____ :Compare first file, second file _____ ____ ______ ____ ______ ____ :Compare first file, second file, output file _____ ____ ______ ____ :Compare first file, second file, *lp, L2 _____ ____ ______ ____ :Compare first file, second file,,"L2 J+" A copy of the Compare UDC is included in the file Compudc.Catalog.Robelle. To invoke this UDC from within Qedit, use the following command: /set udc compudc.catalog.robelle ____ ______ Help Screen If you forget what options are available, you can have Compare print a quick summary of the options (without comparing any files) by using the ? option in the Info= string. :Compare x,x,,? _______ _ _________ _______ 6 Chapter 2 Accessing Compare Compare/Copyright Robelle Solutions Technology Inc. 1991-2008 (Version 3.0) :File equations required: filea = first file to compare fileb = second file to compare outfile = output file info="[?] [Fn] [J+] [Ln] [Mn] [N+] [Pc] [T+] [V+] [Wn/n]" ?: Display this help information, don't compare F: output format; default=1 1=normal 2=condensed J: Set detailed JCWs L: Min matching lines for resync; default 4 M: Max lines before resync fail; default 10,000 N: Display line numbers instead of prefix char P: Prefix character printed before lines; default > T: Print timing info V: Display program version only, don't compare W: Column range for comparison; default entire line ___ _______ _____ Job Control Words Compare sets the system job control word (JCW) to a fatal state when Compare fails (e.g., when Compare is unable to resynchronize after a mismatch). Compare sets the CompareOutCount JCW to the number of differences found. Additional JCWs are set with the J+ Info parameter (see _______ _______ the chapter Compare Options). _______ ____ On-Line Help There is a help file available for Compare for use with the Qhelp on-line help system. If you are inside Qedit, you can get help on Compare by using Qedit's Qhelp command. /Qhelp compare.help.robelle If you are not inside Qedit (i.e., in MPE V or MPE/iX), you can get help by running Qhelp. :run qhelp.qlib.robelle;info="compare.help.robelle" _________ Control-Y While Compare is checking the files, you can interrupt it by pressing Control-Y (hold down Control while pressing Y). Compare will print out the number of lines that it has checked so far, and ask you if you want to stop. Press the Return key to continue comparing, or type YES to stop. 7 _______ _ ________ _______ Chapter 3 Applying Compare _ ____________ * Introduction _ _____ _____ * Added Lines _ _______ _____ * Deleted Lines _ _______ _____ * Changed Lines _ _______________ * Resynchronizing ____________ Introduction How are two files different from each other, and why would we want to know the differences between them? We start with the assumption that both files are similar. Perhaps one file is a newer version of another, and we want to see what changes were made. Or the two files are file listings from two accounts or computers, and these file listings must be kept synchronized. We can use Compare to check if these files are identical. Compare works on a line-by-line basis. A difference between two files is defined as at least one line that occurs in one file but not the other, or at least one different line in both files that are surrounded by identical lines. From this definition, Compare recognizes three types of differences: lines that are added, deleted and changed. Lines that are deleted from one file are treated as lines added to the other file (and vice-versa), and are described as "extra text". Lines that are changed in some way are described as a "mismatch". Compare will remove trailing blanks from lines before comparing them. All other blanks and blank lines are treated like text. To illustrate how Compare works, we will present examples using a file called FILE1 consisting of the following six lines: 1 a 2 b 3 c 4 d 5 e 6 f Then we will make changes to a similar file called FILE2 and use Compare to find the differences between the two files. Although the line numbers are shown in the examples, Compare does not treat the line numbers as part of the data. Compare treats the line number as an attribute of a line, not as part of a line. This means that Compare will not find any differences in two files that are otherwise identical except for different line numbers. _______ _ ________ _______ 8 Chapter 3 Applying Compare _____ _____ Added Lines The second file has one additional line (the line "new line"). 100 a 101 b 102 new line 103 c 104 d 105 e 106 f The Compare output is as follows: ---------------------------------- Extra text in FILE2, Line 102 Between lines 2 and 3 of FILE1 > new line Compare is telling you that FILE2 has an extra line (line number 102), and that this extra line would have appeared between lines 2 and 3 of FILE1. _______ _____ Deleted Lines In this example, FILE2 has one line deleted (line "b" is gone). 100 a 101 c 102 d 103 e 104 f The Compare output is as follows: ----------------------------------- Extra text in line FILE1, Line 2 Between lines 100 and 101 of FILE2 > b Because Compare does not know how you changed the file, it treats the case of a line deleted from FILE2 the same as a line added to FILE1. This is the same as being given two lists of names, where a name occurs in the first list but not on the second. You have no way of knowing whether there is an extra name in the first list, or a name missing from the second list. _______ _ ________ _______ Chapter 3 Applying Compare 9 _______ _____ Changed Lines In this example, FILE2 has two consecutive lines changed (lines "b" and "c" are replaced by new text). 100 a 101 changed line 102 another changed line 103 d 104 e 105 f The Compare output is as follows: ----------------------------------- Mismatch: Lines 2 to 3 of FILE1: > b > c Lines 101 to 102 of FILE2: > changed line > another changed line _______________ Resynchronizing Once Compare discovers a difference, it has to read both files until it finds matching lines again. This process is called resynchronizing. By default, Compare needs four consecutive matching lines before it considers the two files resynchronized. For some data, such as a list of items, you may want to reduce the number of required consecutive lines to one. For example, here is FILE2 with one line changed and one line added: 100 a 101 changed line 102 c 103 d 104 extra line 105 e 106 f If you compare this with FILE1 using the default four-line resynchronization (L4), Compare will find one set of differences. _______ _ ________ _______ 10 Chapter 3 Applying Compare ---------------------------------------- Mismatch: Lines 2 to 4 of FILE1: > b > c > d Lines 101 to 104 of FILE2: > changed line > c > d > extra line Notice that the "extra line" is grouped into the same block of changes as the first changed line. This is because Compare did not find four consecutive matching lines after the first change. If you compare FILE1 and FILE2 with a one-line resynchronization (L1), Compare will find two sets of differences. ---------------------------------------- Mismatch: Line 2 of FILE1: > b Line 101 of FILE2: > changed line ---------------------------------------- Extra text in FILE2, Line 104 Between lines 4 and 5 of FILE1 > extra line This time, the two sets of changes were identified separately, because only one matching line was needed to resynchronize both files. Since L1 appears to be more "accurate" in finding differences, why isn't it the default value? The reason is that in documents and source code, you almost always have blank lines. If you use L1, you will resynchronize every time there is a blank line, which may not be what you want if a difference contains blank lines. 11 _______ _ _______ _______ Chapter 4 Compare Options _ ____________ * Introduction _ _______ __ _______ * Summary of Options _ ____ ______ * Help Screen _ ______ ______ * Output Format _ ________ ____ * Detailed JCWs _ _____ ___ _________________ * Lines for Resynchronization _ _______ __________ ____ * Maximum Difference Size _ ____ ____ _______ * Show Line Numbers _ ______ _________ * Prefix Character _ _____ ______ ___________ * Print Timing Information _ _______ ______ * Version Number _ ______ ___ __________ * Window for Comparison ____________ Introduction You specify run-time options for Compare in the Info= string of the Run command. Option names are represented by a single letter, and can be typed in either uppercase or lowercase. The name of the option follows the Info= parameter, without any intervening blanks. info="L2" Some options are switches (i.e., they indicate either On or Off). A switch option is set On by adding a "+" after the name, or just by specifying it. A switch option is set Off by adding a "-" after the name. For example: info="J" {turn option J on} info="J+" {turn option J on} info="J-" {turn option J off} You can specify several options at once. Options are separated by blanks, and can appear in any order. However, there cannot be any blanks between the option name and its parameters. For example, the following Info= strings are equivalent: info="J+ L2" info="l2 j+" You can also use a UNIX-like Info= string, where each option is preceded by a dash. However, when you use this style, all options must be preceded by a dash, and you must specify the files to compare in the Info= string. info="-j thisfile thatfile -L2" _______ _ _______ _______ 12 Chapter 4 Compare Options _______ __ _______ Summary of Options ______ ____ _______ _______ Option Type Default Meaning ? -- off display help screen F number 1 output format J switch off set detailed JCWs L number 4 minimum lines to resynchronize M number 10000 maximum lines in one difference N switch off display line numbers P char > prefix character in output T switch off print timing info V switch off print version; don't compare W range 1/256 column range used in comparison These two files will be used in subsequent examples in this chapter: FILE1 FILE2 1 a 100 a 2 b 101 changed line 3 c 102 c 4 d 103 d 5 e 104 extra line 6 f 105 e 106 f Note that the first column displayed in each file represents the line number of the data, and is not considered as part of the data. ____ ______ Help Screen ?: This will print a help screen of the run-time options. No files are compared. ______ ______ Output Format F: Compare can produce several types of output. Format 1 is the default. Format 2 is similar to format 1, but it does not use as many blank lines, and automatically prints line numbers with the lines. In the following examples, we also include the "L2" option to find more differences. _______ _ _______ _______ Chapter 4 Compare Options 13 Format 1 :compare file1 file2,,"F1 L2" ---------------------------------------- Mismatch: Line 2 of FILE1: > b Line 101 of FILE2: > changed line ---------------------------------------- Extra text in FILE2, Line 104 Between lines 4 and 5 of FILE1 > extra line Format 2 :compare file1 file2,,"F2 L2" ---------------------------------------- Mismatch: FILE1: 2 b FILE2: 101 changed line ---------------------------------------- Extra text in FILE2 that does not appear between lines 4 and 5 of FILE1 104 extra line ________ ____ Detailed JCWs J: Compare will set more JCWs describing the type of differences that it found between the two files. These JCWs are as follows: CompareExtra1 extra text in Filea CompareExtra2 extra text in Fileb CompareMismatch mismatches between Filea and Fileb Note that these JCWs are similar to the CompareOutCount JCW in that they count the number of differences, not the number of lines. CompareExtra1 counts the text that appears in Filea but not in Fileb. CompareExtra2 is the opposite; it counts the _______ _ _______ _______ 14 Chapter 4 Compare Options text that appears in Fileb but not in Filea. CompareMismatch counts the final type of difference, a mismatch between lines in Filea and Fileb. If we had used the "L2" option as we had done in the example under the F option, the JCWs would be set to the following values. CompareExtra1 0 CompareExtra2 1 CompareMismatch 1 _____ ___ _________________ Lines for Resynchronization L: This sets the number of lines that must match before the files are considered to be resynchronized. With the default value of L4, the following is grouped as one mismatch: From filea:b c d From fileb:lines changed c d extra line However, with the L2 option, the two differences (a mismatch and extra text) are shown separately. This is because the matching lines c,d caused the files to become resynchronized after the first difference. For documents and source code, the default of L4 works well. For data files such as file listings that do not have blank lines between data items, L1 can produce a more detailed report instead of grouping a large number of differences together. _______ __________ ____ Maximum Difference Size M: This sets the maximum number of lines that Compare tries to read after it finds a difference, before it stops. Compare stores all the lines it reads (after finding a difference) in memory, until the files are resynchronized. The default is 10,000 lines, which should be enough for most files. If you are comparing files with very large differences, you may want to use a larger number (e.g., M20000). On the other hand, if you would rather have Compare stop instead of using large amounts of memory resources, use a smaller number (e.g., M1000). _______ _ _______ _______ Chapter 4 Compare Options 15 ____ ____ _______ Show Line Numbers N: By default, Compare prints a ">" in front of the lines from the input files. You can have Compare print the line number instead, by setting this option to N+. :compare file1 file2,,N+ ---------------------------------------- Mismatch: Lines 2 to 4 of FILE1: 2 b 3 c 4 d Lines 101 to 104 of FILE2: 101 changed line 102 c 103 d 104 extra line ______ _________ Prefix Character P: By default, Compare prints a ">" in front of the lines from the input files. This helps distinguish the text of the input files from Compare's messages. You can change this character to another non-alphabetic character. For example, P* changes the prefix character to an asterisk (*). :compare file1 file2,,P* ---------------------------------------- Mismatch: Lines 2 to 4 of FILE1: * b * c * d Lines 101 to 104 of FILE2: * changed line * c * d * extra line _______ _ _______ _______ 16 Chapter 4 Compare Options _____ ______ ___________ Print Timing Information T: This prints out the time it takes to compare two files, along with other timing information. _______ ______ Version Number V: When you run Compare, it will always print the version number to the screen. To check the version number without comparing any files, run Compare with the V option in the Info= string. :Compare anything,anything,,v Compare/Copyright Robelle Solutions Technology Inc. (Version 3.0) ______ ___ __________ Window for Comparison W: By default, Compare checks entire lines from the input files. You can restrict Compare to check only a particular "window", or column range, of the lines, rather than the entire length of the lines. This is especially useful for tagged COBOL files, where you are interested in the lines' contents instead of the tags. Because it strips out line numbers, Compare considers all text to start at column one, even in COBOL files. In tagged COBOL files, the text would be in columns 1 through 66, and the tags in columns 67 through 74 (instead of the physical layout of text in columns 7 to 72, and tags in columns 73 to 80). The format of the column range is two numbers separated by a slash. _____ ______ ____ ______ first column/last column For example, to compare only the text of two tagged COBOL files, you would type the following: :compare cobol1,cobol2,,"W1/66" W1/66 would restrict comparisons to columns 1 through 66. Compare will still print the entire line when it encounters a difference, even if you use a window. If a line is shorter than the last column, then only the actual length of the line is checked. 17 _______ _ __________ _______ Chapter 5 Installing Compare _ ____ __ _______ ___ _______ _______ * Step 1: Upgrade the Robelle Account _ ____ __ _______ ___ _____ * Step 2: Restore the Files _ ____ __ _______ ___ _______ * Step 3: Install the Program _ _____________ * Documentation There are three steps to installing or updating the Compare software from the distribution tape. First, build (or upgrade) the Robelle account using a job stream that we provide. Second, restore the Robelle files from tape to disc. Third, stream the installation job. ____ __ _______ ___ _______ _______ Step 1: Upgrade the Robelle Account Even if you already have the Robelle account, the first thing you must do is stream the Robelle job. This ensures that any new groups will be built with the proper capabilities and security. :hello manager.sys :file robtape;dev=tape :restore *robtape; robelle.job.robelle; create :run qedit.pub.robelle {or use :Editor} /text robelle.job.robelle /modify first {Manager.Sys password} ___ ________ ___ ________ /change "old password","new password",ALL{Robelle password} /keep $newpass /exit :stream $oldpass This job stream launches a second job, which will send you a message when it is complete. ____ __ _______ ___ _____ Step 2: Restore the Files Stay logged on as Manager.Sys, then restore these files: :restore *robtape;@.@.robelle;show ____ __ _______ ___ _______ Step 3: Install the Program Our Bonus.Job.Robelle job stream installs all Robelle Bonus programs. No one can be using Compare, HowMessy, Spell, Prose or Xpedit during installation. Warn people not to use these programs for awhile, and then stream our installation job: _______ _ __________ _______ 18 Chapter 5 Installing Compare :hello mgr.robelle :warn @;please stop using Compare NOW! :run qedit.pub.robelle {or use :Editor} /text bonus.job /modify first {Mgr.Robelle passwords} /keep $newpass /exit :stream $oldpass Check the installation job $Stdlist. If anyone was using Compare or the other files, or attempting to back them up, the job will have failed. Chase away any users, ensure that backup is not in progress, then stream the installation job again. After the installation job completes, you are ready to use this new version of Compare. :run Compare.pub.robelle _____________ Documentation The Compare file in the PUB group is the program file; the file in the DOC group is the user manual, and the Printdoc and Prose files are programs to print and format documentation. :run printdoc.pub.robelle;info="Compare.doc.robelle" 19 ________ _ _ _____ ________ Appendix A - Error Messages The following are some common error messages that you might encounter. _______ ______ Invalid option You have specified an option name in the Info= string that Compare does not recognize. Run Compare with Info="?" for a list of the available options. ______ __ ____ ___ ____ _____ ___ ______ Unable to open the file filea (or fileb) You have specified a file that does not exist or that is not accessible. The next line after this error message will give you a specific file system error message encountered. ______ __ ___________ _____ _ _____ Unable to synchronize after n lines _ After n lines, Compare still has not found enough matching lines. Try using a bigger value in the M option (the default is 10,000). 20 _____ Index ? option...........................5,12 _ A accessing Compare..................4 added lines........................8 applying...........................7 _ B Bonus programs.....................1 _ C changed lines......................9 COBOL columns......................16 column range to compare............16 combining options..................11 Compare UDC........................5 Compare.Doc.Robelle................18 Compare.Pub.Robelle................18 CompareExtra1 JCW..................13 CompareExtra2 JCW..................13 CompareMismatch JCW................13 CompareOutCount JCW................6 Compudc.Catalog.Robelle............5 Control-Y..........................6 _ D deleted lines......................8 detailed JCWs......................13 DIF................................2 documentation......................1 _ E error messages.....................19 _ F F option...........................12 filea..............................4 fileb..............................4 filenames in info= string..........4 _____ 21 Index _ H help screen........................5,12 how to install Compare.............17 how to run Compare.................4 _ I info=..............................5,11,16 info= filenames....................4 installing Compare.................17 interrupting Compare...............6 introduction.......................1 _ J J option...........................13 JCW................................6 job control word...................6 _ L L option...........................14 line numbers.......................15 _ M M option...........................14 manual.............................1 maximum lines per difference.......14 multiple options...................11 _ N N option...........................15 new features.......................2 number of lines, resynchronization.14 _ O on-line help.......................6 option names.......................11 options............................11 options, with dashes...............11 outfile............................4 output format......................12 _____ Index 22 _ P P option...........................15 password, Robelle account..........17 prefix character...................15 Printdoc program...................1 Printdoc.Pub.Robelle...............18 Prose.Qlib.Robelle.................18 _ Q Qedit..............................5,6 Qhelp..............................6 Qlib programs......................1 _ R resynchronizing....................9 Robelle account....................17 Robelle.Job.Robelle job............17 running Compare....................4 _ S show line numbers..................15 stopping Compare...................6 summary of options.................12 switches...........................11 _ T T option...........................16 timing.............................16 _ U UDC for invoking Compare...........5 _ V V option...........................16 version number.....................16 _ W W option...........................16 window for comparison..............16 ______ _______ _____ Reader Comment Sheet _______ ___ ____ ______ COMPARE 3.0 User Manual Your opinion of this manual is a valuable resource for helping us improve the quality of our documentation. We invite you to rate the manual on this form. Your Name: Date: Company: Position: Address: Phone: ______ ______ ___ ______ ___ _____ Please circle one number for each: ____ _______ ____ Good Average Poor * General organization 1 2 3 * Technical accuracy 1 2 3 * Writing clarity 1 2 3 * Convenience of size and format 1 2 3 * Ease of locating information 1 2 3 * Thoroughness of material 1 2 3 * Quality of examples 1 2 3 ________ ___ ____________ _______ ___ ________ __ __________ Comments and suggestions: (please use reverse, or additional ______ __ _______ sheets as needed) _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ Thank you for your feedback. We appreciate your time and interest. Please send your comments to us at one of the following numbers or addresses: Robelle Solutions Technology Inc. Toll-free: 1.888.robelle (1.888.762.3553) 7360 137 Street, Suite 372 Phone: 604.501.2001 Surrey, B.C. Canada V3W 1A3 Fax: 604.501.2003 E-mail: support@robelle.com Web: www.robelle.com iii _______ ____ ______ COMPARE User Manual ________ Contents _______ _ _______ __ _______ Chapter 1 Welcome to Compare Authorization to use Compare..........1 User manual...........................1 DIF users.............................2 New features of Compare...............2 New features of Compare...............2 New features of Compare...............2 New features of Compare...............3 New features of Compare...............3 _______ _ _________ _______ Chapter 2 Accessing Compare Info= filenames.......................4 Info= options.........................5 User Defined Command..................5 Help screen...........................5 Job Control Words.....................6 On-line help..........................6 Control-Y.............................6 _______ _ ________ _______ Chapter 3 Applying Compare Introduction..........................7 Added lines...........................8 Deleted lines.........................8 Changed lines.........................9 Resynchronizing.......................9 ________ iv Contents _______ _ _______ _______ Chapter 4 Compare Options Introduction..........................11 Summary of options....................12 Help screen...........................12 Output format.........................12 Detailed JCWs.........................13 Lines for resynchronization...........14 Maximum difference size...............14 Show line numbers.....................15 Prefix character......................15 Print timing information..............16 Version number........................16 Window for comparison.................16 _______ _ __________ _______ Chapter 5 Installing Compare Step 1: Upgrade the Robelle account..17 Step 2: Restore the files............17 Step 3: Install the program..........17 Documentation.........................18 ________ _ _ _____ ________ Appendix A - Error Messages......................19 _____ Index............................................20