COMPARE FILES UTILITY
Release Level 12.1.13
This application consists of one runfile: CompareFiles.Run
Product Name :
Supported On : B24, B26, B27, B28, B38, B39, and all SuperGen hardware
Supported OS : BTOS II, CTOS I, CTOS II, CTOS III
Description : The /COMPARE FILES utility is used to compare a list of files
with a second list of files. The second list of files is
build from a Compare File Prefix and the file names in the
first list. Comparison of two volumes is also possible.
COMPARE FILES will indicate whether the compared files are
different (different End-Of-File, different file length,
different contents). When there is a difference in file
length, the contents will still be compared (this is not the
case for a different End-Of-File). When the contents differ,
the Lfa of the first difference is displayed. If you select
the 'Copy when differences?' option, the files with
differences may be copied. You may also select to copy the
files that do not exist as compare file. At the end,
/COMPARE FILES diplays the number of files compared, the
number of files with differences and the number of files that
returned and error. /COMPARE FILES is about 8 - 40 times as
fast as the CTOS DUMP. The following modifications have been
made to previous versions of this utility:
/COMPARE FILES now uses a default color palette if the
[Sys]<sys>KrivaboColorConfig.sys file cannot be opened.
Bug fix: Erc 219 no longer occurs when copying missing files
immediatelly after the occurrence of an erc 219
caused by an attempt to overwrite a file for which
both the fNoSave and fNoDelete flags are TRUE or to
expand a file for which the fNoDelete flag is TRUE.
/COMPARE FILES now sets up the screen colors . It uses
color palette 0 in the [Sys]<sys>KrivaboColorConfig.sys file.
When running /COMPARE FILES on an XE530 thru CLUSTER VIEW,
/COMPARE FILES searches your .user file for the following
entries:
:ClusterViewColor:Yes
:ClusterViewBackgroundColor:Yes
If these entries are 'Yes', /COMPARE FILES assumes that the
workstation supports color and background color. If you do
not want /COMPARE FILES to change your current colors, change
the second byte of the command case to 'C'.
Bug fix: The modification in level 12.1.1 caused a general
protection fault when a print file specification is
less than four characters.
Bug fix: Before, system files (e.g. <sys>sysimage.sys) were
never copied despite the "Copying ... done"
message. Now, system files are handled as follows:
- Files for which both the fNoSave and fNoDelete
flags are TRUE are never copied nor overwritten
(e.g. <sys>FileHeaders.sys, <sys>BadBlk.sys,
etc...).
- Files for which the fNoDelete flag is TRUE are
only overwritten if no file expansion is needed
(e.g. <sys>SysImage.sys).
Bug fix: /COMPARE FILES no longer aborts with erc 4593 when
a non-GPS print file specification is longer than
12 characters.
If the [sys]<sys>KrivaboSoftMsg.bin file does exist, it is
used instead of the English linked-in messages.
Passwords may now also be embedded in the file names and the
compare file prefix.
Line wrapping and video attributes are used to enhance the
readability of the video output and print file.
The following video attributes are used:
- Half-Bright (i.e. color 1) for copying message.
- Color 2 for input messages.
- Reverse Video and Color 3 (Half-Bright) for status.
- Bold and color 4 for errors.
- Bold and color 6 to indicate differences.
NOTES: - These video attributes produce a correct output on
both color and monochrome video monitors. If
needed, they may be changed thru the message file.
- /COMPARE FILES does not set the color palette but
uses your current colors.
- Due to a bug in the 12.0.0 and 12.1.0 EXECUTIVE,
colors 2, 3, 4 and 6 may not appear on the screen
unless you use a filter to get around the bug (The
executive reduces the 8 colors in the color palette
to 4 times the first 2 colors). This problem does
not occur below BTOS II-3.2.
If the print file is a GPS device, video escape sequences are
translated into GPS escape sequences (e.g. half-bright is
printed as bold). For non-GPS print files, they are
suppressed. There is however one exception: if the print
file is a disk file whose name ends with '.Vid', the video
escape sequences are written to the print file. If you TYPE
such a print file, the display is exactly the same as during
the execution of the /COMPARE FILES command.
Performance improvements:
- Use larger buffers if the memory is available.
- Use faster compare routine.
- Only use wildcard procedures when a file name contains a
wildcard.
Open all files in modeRead instead of modeModify and change
the mode when copying.
Display status line on the second line of the screen:
'Processing file #'.
Added the [Copy missing files?] parameter to the /COMPARE
FILES command.
Bug fix: When overwriting the compare file, always copy the
entire file.
Directions/Use : The Compare Files utility may be executed by passing
parameters to the /Compare Files command as detailed and
instructed below:
File list 1
This field is mandatory. Enter the name of the files to be
compared.
[Password list 1]
This field is optional. Enter the password which will allow
all of the files in the above list to be opened in read mode
(modify mode when the files are to be overwritten in case of
differences). When several passwords are needed, then the
passwords should be appended to the file specifications
above. The password entered here remains valid until a file
specification with an embedded password is encountered.
[Compare file prefix]
This field is optional. The default is the currently logged-
in volume and directory. Enter the prefix to be used to
build the second list of files. The second file list is
built as follows:
If the Compare file prefix only contains a volume name then
for each file name in file list 1 the directory + the file
name is extracted and appended to the volume name. For
example, if you specify [d0]<Sys>Test.run in the 'File list
1' parameter and [d1] as 'Compare File Prefix' then the files
[d0]<Sys>Test.run and [d1]<Sys>Test.run will be compared.
If the Compare file prefix contains a volume and a directory
name then for each file name in list 1 the file name is
extracted and appended to the Compare file prefix. For
example, if you specify [D0]<Sys>*Run in the 'File list 1'
parameter and [d1]<test> as 'Compare File prefix' then the
files [d0]<Sys>*Run will be compared with the files
[d1]<Test>*Run. If File List 1 contains a device or volume
specification then the Compare File Prefix is taken as is.
This allows comparison of two volumes.
[Password list 2]
This field is optional. Enter a password with which all the
files in file list 2 can be opened in read mode (modify mode
when the files are to be overwritten in case of differences).
[Print file]
This field is optional. The default is to display to the
screen. If you want the command output written to a log
file, enter a file specification. If the file does not
exist, it is created.
[List files with differences only?]
This field is optional. The default is 'No'. If you enter
'Yes', only the names of the files that are different are
listed. If you enter 'No' or leave this field blank, the
names of all the files being compared, are listed.
[Copy when different?]
This field is optional. The default is 'No'. Enter 'Yes' to
copy File 1 to the Compare File or vice-versa when they are
different. The next parameter indicates whether File 1 is to
be copied over the Compare File or the Compare File over File
1. When you enter 'Yes' and the Compare File does not exist
then it may be created from File 1 if the '[Overwrite compare
file?]' parameter is not 'No' (also see '[Copy missing
files?]'). If you enter 'No' or leave this field blank, the
files are only compared.
[Overwrite compare file?]
This field is optional. This field is entered only if the
previous parameter is 'Yes'. The default is to copy the file
with the latest modification date to the other file. If you
enter 'Yes', File 1 is copied to the Compare File. If you
enter 'No', the Compare File is copied to File 1.
[Suppress confirmation?]
This field is optional. This parameter is only used if the
'[Copy when different?]' parameter is 'Yes'. The default is
'No'. If you enter 'Yes', you are not prompted for
confirmation. If you enter 'No' or leave the field blank,
you are prompted to confirm each copy operation.
[Copy missing files?]
This field is optional. This parameter is only used if the
'[Copy when different?]' parameter is 'Yes' and the
[Overwrite compare file?] parameter is not 'No'. The default
is to ask for confirmation. If you enter 'Yes', all missing
Compare Files are created without prompting for confirmation.
If you enter 'No', missing Compare Files are not created. If
you leave the field blank, you are prompted to confirm the
creation of the missing Compare File.
COMMAND
/Compare Files
File list 1
[Password list 1]
[Compare file prefix]
[Password list 2]
[Print file]
[Only list files with differences?]
[Copy when different?]
[Overwrite compare file?]
[Suppress confirmation?]
[Copy missing files?]