--------------------------------------------------------------------------------
MODULE IDIFFERENCE

--------------------------------------------------------------------------------
REPLACES DAMP module CMPIFF

--------------------------------------------------------------------------------

FUNCTION

--------------------------------------------------------------------------------

FORMAT

--------------------------------------------------------------------------------

PROMPTS

_File1: master-file-spec
_File2: revision-file-spec

--------------------------------------------------------------------------------

PARAMETERS

--------------------------------------------------------------------------------

COMMAND QUALIFIERS

--------------------------------------------------------------------------------

DESCRIPTION


--------------------------------------------------------------------------------

EXAMPLES

$ IDIFFERENCE TJI1 TJI2 /FRT=RONACD<CR> File 1 is LSL750$DUA0:[LSL.IFF]TJI1.IFF;4 File 2 is LSL750$DUA0:[LSL.IFF]TJI2.IFF;15 Comparing with lookahead 20, point tolerances: default 0.03412, factor 1.00 HI (HIstory) entry missing in file 1 HI (HIstory) entry missing in file 2 Comparing layer 1 ******* Feature 1 line feature ======= CB data - differences for file 1 Point X Y 200: 17.4755 87.266922 201: 18.21361 91.21772 202: 18.247231 96.905792 ...equal ------- CB data - differences for file 2 Point X Y 200: 18.247231 96.905792 ...equal ******* Feature 2 line feature CB entries - some columns will not be compared Column Z ( 93) is only present in file 2 ******* Feature 3 line feature FS entry: Feature Code - in file 1 = 0, file 2 = 1 ======= TH entry: file 1 = 0, file 2 = 5 ======= CB data - differences for file 1 Point X Y CAPTURE_XY 6: 50.737034 164.85843 62 7: 50.983398 164.81369 62 8: 51.230087 164.77017 62 9: 51.477097 164.72789 62 10: 51.724419 164.68683 62 11: 51.972038 164.64699 62 ...equal ------- CB data - differences for file 2 Point X Y CAPTURE_XY 6: 50.737034 164.85843 61 7: 50.983398 164.81369 61 8: 51.230087 164.77017 61 9: 51.477097 164.72789 61 10: 51.724419 164.68683 61 11: 51.972038 164.64699 62 ...equal ======= CB data - differences for file 1 Point X Y CAPTURE_XY 23: 54.963589 164.26456 62 24: 55.214287 164.24066 62 25: 55.465157 164.21799 62 26: 55.716187 164.19653 62 ...equal ------- CB data - differences for file 2 Point X Y CAPTURE_XY 23: 54.963589 164.26456 57 24: 55.214287 164.24066 57 25: 55.465157 164.21799 57 26: 55.716187 164.19653 62 ...equal ======= CB data - differences for file 1 Point X Y CAPTURE_XY 27: 55.967377 164.17632 62 28: 56.218708 164.15732 62 ...equal ------- CB data - differences for file 2 Point X Y CAPTURE_XY 27: 55.967377 164.17632 57 28: 56.218708 164.15732 62 ...equal ******* Feature 5 symbol feature FS entry: differing text/symbol codes - in file 1 = symbol, in file 2 = line ======= --- unmatched --- ******* Feature 6 symbol feature ======= AC entries: in file 1 AC Name ( Type) Value Text AC CHANGE_DATE ( 1002) 10-DEC-1987 "" AC DATE_EXAMPLE (12007) 1-JAN-1900 "" ------- AC entries: in file 2 AC Name ( Type) Value Text AC CHANGE_DATE ( 1002) 10-DEC-1987 "" AC DATE_EXAMPLE (12007) 1-JAN-1988 "" AC ? ( 2009) 8 "K200/3/4-B" ******* Feature 7 line feature ======= CB data - differences for file 1 Point X Y Z SURVEY_DATE 1: 5.0 3.0 0.0 23-DEC-1962 2: 6.0 4.0 1.0 14-NOV-1965 ...equal ------- CB data - differences for file 2 Point X Y Z SURVEY_DATE 1: 5.0 3.0 0.0 5-JAN-1988 2: 6.0 4.0 1.0 14-NOV-1965 ...equal ======= CB data - differences for file 1 Point X Y Z SURVEY_DATE 4: 1.0 9.0 8.0 5-MAY-1966 5: 9.0 1.0 2.0 7-JUL-1945 (ends unequal) ------- CB data - differences for file 2 Point X Y Z SURVEY_DATE 4: 8.0 9.0 8.0 5-JAN-1988 5: 9.0 10.0 10.0 5-JAN-1988 (ends unequal) ******* Feature 8 line feature ======= CB data - differences for file 1 21 points left in file 1 ======= --- unmatched --- ******* Feature 9 line feature ======= CB data - differences for file 1 18 points left in file 1 Summary of differences ********************** 1 layer was found Number of layers compared 1 Missing layers in file 1 0 Missing layers in file 2 0 9 features required comparison: Identical 1 Different 6 Unmatched 2 How features differed by entry type: FS entry 2 AC entries 1 CB entries - columns 1 CB entries - geometry 3 CB entries - attributes 2 CB entries - point count 2 TH entry 1 Missing features in file 1 0 Missing features in file 2 0 Duplicated FSNs in file 1 0 Duplicated FSNs in file 2 0 ELAPSED: 0 00:00:17.53 CPU: 0:00:12.63 BUFIO: 171 DIRIO: 179 FAULTS: 168 8

$ IDIFFERENCE RWRB RWRD /OUTPUT=RWR<CR> ELAPSED: 0 00:00:20.26 CPU: 0:00:10.42 BUFIO: 64 DIRIO: 295 FAULTS: 1896 $ TYPE RWR.LIS<CR> ============================ I D I F F E R E N C E ============================= IDIFFERENCE invoked by TONY using terminal RTA1: at 5-JAN-1988 14:03:05.29 Command line: IDIFFERENCE RWRB RWRD/OUTPUT=RWR ================================================================================ File 1 is LSL750$DUA0:[LSL.IFF]RWRB.IFF;2 File 2 is LSL750$DUA0:[LSL.IFF]RWRD.IFF;1 Comparing with lookahead 20, point tolerances: default 0.10000, factor 1.00 RA (RAnge) entry in file 1 0.0000 1000.0001 -0.0000 1000.0001 RA (RAnge) entry in file 2 0.0000 1000.0001 -0.0000 1000.0001 HI (HIstory) entry missing in file 1 HI (HIstory) entry missing in file 2 MH (Map Header) entry longword 4 in file 1 = 00079D38, file 2 = 0007A120 (hex) longword 23 in file 1 = 00079D38, file 2 = 0007A120 (hex) Map descriptors - type 2 MDs do not match File 1: - Local origin: 599500.0000, 499000.0000 - Map scale: 1250.0000 - Projection: 101 (UK national grid) - Spheroid: 9 (Airy) - Units: 2 (metres) File 2: - Local origin: 599500.0000, 499500.0000 - Map scale: 2500.0000 - Projection: 101 (UK national grid) - Spheroid: 9 (Airy) - Units: 2 (metres) Comparing layer 1 Comparing layer 11 Summary of differences ********************** The following header entries did not match: RA (RAnge) MH (Map Header) MD (Map Descriptor) 2 different layers were found Number of layers compared 2 Missing layers in file 1 0 Missing layers in file 2 0 53 features required comparison: Identical 53 Different 0 Unmatched 0 Missing features in file 1 0 Missing features in file 2 0 Duplicated FSNs in file 1 0 Duplicated FSNs in file 2 0

$ IDIFFERENCE FILE1 FILE2 /LOG/PLOT=COORDINATES/OUTPUT=FILE<CR> %LSLLIB-I-IFFOPENED, LSL750$DUA0:[LSL.IFF]FILE1.IFF;2 opened for read %LSLLIB-I-IFFOPENED, LSL750$DUA0:[LSL.IFF]FILE2.IFF;1 opened for read %LSLLIB-I-LOGOPNOUT, log file FILE.LIS opened for write %LSLLIB-I-IFFOPENED, LSL750$DUA0:[LSL.IFF]FILE2_DEL.IFF;2 opened for write %LSLLIB-I-IFFOPENED, LSL750$DUA0:[LSL.IFF]FILE2_CRE.IFF;2 opened for write %LSLLIB-I-IFFOPENED, LSL750$DUA0:[LSL.IFF]FILE2_DIF.IFF;2 opened for write ELAPSED: 0 00:01:28.09 CPU: 0:01:17.63 BUFIO: 35 DIRIO: 912 FAULTS: 1720

$ IDIFFERENCE TL1659NE.IFF1 TL1659NE_AFTER.IFF1 /SUMMARY<CR> Summary of differences ********************** The following header entries did not match: HI (HIstory) 1 layer was found Number of layers compared 1 Missing layers in file 1 0 Missing layers in file 2 0 427 features required comparison: Identical 422 Different 4 Unmatched 1 How features differed by entry type: CB entries - geometry 5 CB entries - attributes 5 Missing features in file 1 0 Missing features in file 2 0 Duplicated FSNs in file 1 0 Duplicated FSNs in file 2 0 ELAPSED: 0 00:01:23.27 CPU: 0:01:14.67 BUFIO: 33 DIRIO: 905 FAULTS: 1526

$ IDIFFERENCE CODETEST CODESORT /OS<CR> File 1 is LSL750$DUA0:[OS.IFF]CODETEST.IFF;3 File 2 is LSL750$DUA0:[OS.IFF]CODESORT.IFF;1 Comparing with lookahead 20, point tolerances: default 0.10000, factor 1.00 HI (HIstory) entry missing in file 1 HI (HIstory) entry missing in file 2 Comparing layer 1 Ignoring layer 11 Summary of differences ********************** 2 different layers were found Number of layers compared 2 Missing layers in file 1 0 Missing layers in file 2 0 706 features required comparison: Identical 706 Different 0 Unmatched 0 Missing features in file 1 0 Missing features in file 2 0 Duplicated FSNs in file 1 0 Duplicated FSNs in file 2 0 ELAPSED: 0 00:01:26.54 CPU: 0:01:16.78 BUFIO: 35 DIRIO: 1394 FAULTS: 194 5

$ IDIFFERENCE TJI1 TJI3<CR> File 1 is LSL750$DUA0:[LSL.IFF]TJI1.IFF;4 File 2 is LSL750$DUA0:[LSL.IFF]TJI3.IFF;1 Comparing with lookahead 20, point tolerances: default 0.03412, factor 1.00 HI (HIstory) entry missing in file 1 HI (HIstory) entry missing in file 2 Comparing layer 1 ******* Feature 1 line feature ======= CB data - differences for file 1 Point X Y 2: 2.8696361 20.28903 3: 4.7384071 28.668381 ...equal ------- CB data - differences for file 2 Point X Y 2: 2.8729999 20.188999 3: 4.7371998 28.669201 ...equal Summary of differences ********************** 1 layer was found Number of layers compared 1 Missing layers in file 1 0 Missing layers in file 2 0 9 features required comparison: Identical 8 Different 1 Unmatched 0 How features differed by entry type: CB entries - geometry 1 Missing features in file 1 0 Missing features in file 2 0 Duplicated FSNs in file 1 0 Duplicated FSNs in file 2 0 ELAPSED: 0 00:00:12.60 CPU: 0:00:05.82 BUFIO: 51 DIRIO: 178 FAULTS: 1480

$ IDIFFERENCE TJI1 TJI3 /TOLERANCE=(DEFAULT=0.001)<CR> File 1 is LSL750$DUA0:[LSL.IFF]TJI1.IFF;4 File 2 is LSL750$DUA0:[LSL.IFF]TJI3.IFF;1 Comparing with lookahead 20, point tolerances: default 0.00100, factor 1.00 HI (HIstory) entry missing in file 1 HI (HIstory) entry missing in file 2 Comparing layer 1 ******* Feature 1 line feature ======= CB data - differences for file 1 Point X Y 2: 2.8696361 20.28903 3: 4.7384071 28.668381 4: 4.315804 32.933281 ...equal ------- CB data - differences for file 2 Point X Y 2: 2.8729999 20.188999 3: 4.7371998 28.669201 4: 4.316 32.9333 ...equal ======= CB data - differences for file 1 Point X Y 7: 5.1894598 39.32761 8: 7.4283938 43.95649 ...equal ------- CB data - differences for file 2 Point X Y 7: 5.1894999 39.330101 8: 7.4278998 43.9566 ...equal Summary of differences ********************** 1 layer was found Number of layers compared 1 Missing layers in file 1 0 Missing layers in file 2 0 9 features required comparison: Identical 8 Different 1 Unmatched 0 How features differed by entry type: CB entries - geometry 1 Missing features in file 1 0 Missing features in file 2 0 Duplicated FSNs in file 1 0 Duplicated FSNs in file 2 0 ELAPSED: 0 00:00:13.93 CPU: 0:00:05.95 BUFIO: 64 DIRIO: 175 FAULTS: 1513


--------------------------------------------------------------------------------

MESSAGES (GENERAL)

IDIFFERENCE message output differs from the other IMP utilities in two ways:

Thus in the following sections, only those messages that are produced in unusual circumstances, or that might be puzzling, are listed. Also, all messages are presented as they would appear - that is, the full message text is shown, including the %'utility'... message header when appropriate.


--------------------------------------------------------------------------------

MESSAGES (INFORMATIONAL)

Most IDIFFERENCE messages may be regarded as informational. Apart from messages arising directly from the succesful comparison of two files, the following may be produced:


--------------------------------------------------------------------------------

MESSAGES (ERROR)

These messages indicate an error in processing which has caused the program to terminate. The normal cause is an error related to command line processing and file manipulation.


--------------------------------------------------------------------------------

MESSAGES (FATAL)

These messages indicate that the program has failed in some catastrophic manner. IDIFFERENCE fatal error messages will always be followed by one of the following sequences of text:


--------------------------------------------------------------------------------

MESSAGES (OTHER)

In addition to the above messages which are generated by IDIFFERENCE itself, other messages may be produced by the command line interpreter (CLI) and by Laser-Scan libraries. In particular, messages may be generated by the IFF library. These are introduced by '%IFF' and are documented in the IFF library users' guide. In most cases IFF errors will be due to a corrupt input file, and this should be the first area of investigation. If the cause of the error cannot be traced by the user and Laser-Scan are consulted, then the input file should be preserved to facilitate diagnosis.