-------------------------------------------------------------------------------- MODULE IINFO

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

REPLACES  DAMP modules IFINFO and SCI

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

FUNCTION

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

FORMAT

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

PROMPT

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

PARAMETER

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

COMMAND QUALIFIERS

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

DESCRIPTION

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

EXAMPLES

$ IINFO/HEIGHT INFO_TEST
 
 IFF file   : DUA0:[LSL.IFF]INFO_TEST.IFF;5                               
 Created on : 25-NOV-1987 12:45:39.69
 Range Information
 -----------------
 Xmin =        0.000      Xmax =      234.567
 Ymin =        0.000      Ymax =      948.397
 Control Point Information
 -------------------------
  NW          0.000       1000.000          0.000        1000.000
  SW          0.000          0.000          0.000           0.000
  SE       1000.000          0.000       1000.000           0.000
  NE       1000.000       1000.000       1000.000        1000.000
 History Record Information
 --------------------------
 This IFF file contains no history entry
 Height Range Information
 ------------------------
 Minimum Z height       =            100.000
 Maximum Z height       =            983.622
 Minimum integer height =            -10
 Maximum integer height =           1000
 Minimum real height    =           -100.582
 Maximum real height    =            101.123
 Information per Layer
 ---------------------
 Layer    No. of     No. of      No. of           2-D                3-D
 Number  Features  2-D Points  3-D Points        Line-Length        Line-Length
     1        4            4           0               0.000              0.000
     2        9            6           3               0.000              0.000
 Information per Feature Code
 ----------------------------
 Feature  No. of     No. of      No. of           2-D                3-D
  Code   Features  2-D Points  3-D Points        Line-Length        Line-Length
      0      13           10           3               0.000              0.000
 Totals Information
 ------------------
 Total number of layers =                 2
 Total number of features =              13
 Total number of 2-D points =            10
 Total number of 3-D points =             3
 Total 2-D line-length =              0.000
 Total 3-D line-length =              0.000
 ELAPSED:    0 00:00:01.39  CPU: 0:00:00.89  BUFIO: 71  DIRIO: 5  FAULTS: 163 
$
$ IINFO/MAP_DESCRIPTOR/TIMINGS LESLEY
 IFF file   : DUA0:[IFF.IMP.IINFO]LESLEY.IFF;7
 Created on : 14-JUL-1986 17:38:03.09
 Updated on : 14-JUL-1986 17:39:53.69  (Revision number :  3)
 Range Information
 -----------------
 Xmin =       -0.643      Xmax =      400.093
 Ymin =       -0.145      Ymax =      400.000
 History Record Information
 --------------------------
Date        Time  Username     Program   Function     Elapsed  CPU      STATUS
06-JAN-1986 17:30 TIM          IFROMTEXT Create       00:00:26 00:00:10 00000001
12-MAR-1986 13:31 CLARKE       ITRANS    Create       00:00:04 00:00:02 00000001
23-APR-1986 10:02 TIM          IED       Update       00:01:00 00:00:07 00000001
23-APR-1986 10:21 TIM          IED       Update       00:00:37 00:00:00 00000001
15-MAY-1986 12:35 RON          IED       Update       00:00:58 00:00:00 00000001
31-MAY-1986 17:38 CLARKE       ITRANS    Create       00:00:03 00:00:01 00000001
19-JUN-1986 09:58 TOM          IED       Update       00:00:09 00:00:00 00000001
01-JUL-1986 15:02 TOM          IED       Update       00:00:07 00:00:00 00000001
14-JUL-1986 17:39 TIM          IED       Update       00:00:18 00:00:00 00000001
 Type 2 Map Descriptor Information
 ---------------------------------
 Local Origin    :     0.000,    90.000
 Scale           :  1000.000
 Projection Code :     101  (UK National Grid)
 Spheroid Code   :       0  (Airey)
 Unit Code       :       2  (Metres)
 Control Point Information
 -------------------------
  NW          0.000        400.000          0.000        400.000
  SW          0.000          0.000          0.000          0.000
  SE        400.000          0.000        400.000          0.000
  NE        400.000        400.000        400.000        400.000
 Information per Layer
 ---------------------
 Layer    No. of     No. of      No. of           2-D                3-D
 Number  Features  2-D Points  3-D Points         Line-Length        Line-Length
     1        17         231         156             770.742           2795.237
    11        0            0           0               0.000              0.000
    44        6           19           0              25.120              0.000
    55        6           31          20              61.461            623.010
    66        2          164           0             361.901              0.000
    88        1            4           0               6.007              0.000
   151        0            0           0               0.000              0.000
  1234       32           86           1             149.693              0.000
  9999        1            1           0               0.000              0.000
 Information per Feature Code
 ----------------------------
 Feature  No. of     No. of      No. of           2-D                3-D
  Code   Features  2-D Points  3-D Points        Line-Length        Line-Length
      0       4           17           0              25.120              0.000
      5       6          175           0             373.926              0.000
     13       4            5           0               0.000              0.000
    123      28          309           0             920.435              0.000
    150      10            0         120               0.000           2011.770
    600       3            0          45               0.000            988.223
    717       1            1           0               0.000              0.000
    800       3            3           0               0.000              0.000
    840       3            0          12               0.000            418.254
    987       3           26           0              55.443              0.000
 Totals Information
 ------------------
 Total number of layers =                 9
 Total number of features =              65
 Total number of 2-D points =           536
 Total number of 3-D points =           177
 Total 2-D line-length =           1374.924
 Total 3-D line-length =           3418.247
 Timings Information
 -------------------
 Total elapsed time = 0000:03:42
 Total CPU time     = 0000:00:20
 ELAPSED: 00:00:14.84  CPU: 0:00:02.05  BUFIO: 105  DIRIO:  22  FAULTS: 178 
$
$ IINFO/SCAN/TIMINGS
_File: LESLEY
 IFF file   : DUA0:[IFF.IMP.IINFO]LESLEY.IFF;7
 Created on : 14-JUL-1986 17:38:03.09
 Updated on : 14-JUL-1986 17:39:53.69   (Revision number :  4)
 %IINFO-I-ERTIM, No Timings information output with /SCAN
 Scan Information
 ----------------
     4566 -  NS : created by IFROMTEXT at 15:39:49 on 30-OCT-1985
 In Layer 1234
 -------------
 Feature   170 repeated
 Feature   170 repeated
 Feature   170 repeated
 Feature   170 repeated
 Feature   170 repeated
 Feature   170 repeated
 Feature   170 repeated
 Feature   170 repeated
 Feature   170 repeated
 Feature   170 repeated
 Feature   170 repeated
 Feature   170 repeated
 Feature   170 repeated
 Feature   170 repeated
 Feature   170 repeated
 In Layer   1
 ------------
 Feature   170 repeated
 In layer   55
 Before feature   280
     7865 -  CH : "This text came from a CH entry"
 In layer   44
 Before feature   300
     8022 -  TC : "This TC is outside a feature"
 Before feature   330
     8054 -  TC : "This is a pointless line of text"
 Before feature   190
     8115 -  CH : "This text came from a CH entry"
 Before feature   423
     8188 -  TC : "This is a particularly nasty TC"
 Layer Number :    1
 -------------------
 First feature number is :      170
 Feature numbers missing :      171 to   189
 Feature numbers missing :      191 to   209
 Feature numbers missing :      211 to   217
 Last feature number is  :      230
 Layer contains          :       16 features
 This layer contains     :       16 features,
                                229 2-D points,
                                156 3-D points.
 Layer Number :   11
 -------------------
 This layer contains     :        0 features,
                                  0 2-D points,
                                  0 3-D points.
 Layer Number :   44
 -------------------
 First feature number is :      190
 Feature numbers missing :      191 to   198
 Feature numbers missing :      200 to   299
 Feature numbers missing :      301 to   329
 Feature numbers missing :      331 to   421
 Last feature number is  :      423
 Layer contains          :        6 features
 This layer contains     :        6 features,
                                 19 2-D points,
                                  0 3-D points.
 Layer Number :   55
 -------------------
 First feature number is :      260
 Feature numbers missing :      261 to   279
 Feature numbers missing :      281 to   309
 Feature numbers missing :      311 to   420
 Feature numbers missing :      422 to   430
 Last feature number is  :      432
 Layer contains          :        6 features
 This layer contains     :        6 features,
                                 31 2-D points,
                                 20 3-D points.
 Layer Number :   66
 -------------------
 First feature number is :      320
 Feature numbers missing :      321 to   419
 Last feature number is  :      420
 Layer contains          :        2 features
 This layer contains     :        2 features,
                                164 2-D points,
                                  0 3-D points.
 Layer Number :   88
 -------------------
 First feature number is :      270
 Only one feature in layer
 This layer contains     :        1 feature,
                                  4 2-D points,
                                  0 3-D points.
 Layer Number :  151
 -------------------
 This layer contains     :        0 features,
                                  0 2-D points,
                                  0 3-D points.
 Layer Number : 1234
 -------------------
 First feature number is :      170
 Feature numbers missing :      171 to   174
 Last feature number is  :      175
 Layer contains          :        2 features 
 This layer contains     :        2 features,
                                  4 2-D points,
                                  1 3-D point.
 Layer Number : 9999
 -------------------
 First feature number is :      797
 Only one feature in layer
 This layer contains     :        1 feature,
                                  1 2-D point,
                                  0 3-D points.
 Totals Information
 ------------------
 Total number of features   :       34
 Total number of 2-D points :      452
 Total number of 3-D points :      177
 
 ELAPSED: 00:00:24.05  CPU: 0:00:04.39  BUFIO: 187  DIRIO:  17  FAULTS: 1953
$
$ IINFO GARBAGE
%LSLLIB-E-IFFOPEN, error opening LSL$IF:GARBAGE.IFF;0
%IFF-E-OPEN, error opening IFF file
-RMS-E-FNF, file not found
 ELAPSED: 00:00:06.34  CPU: 0:00:00.48  BUFIO: 4  DIRIO: 2  FAULTS: 150
$
 
$ IINFO/LAYER DUA0:[IAIN]NOTTS
 IFF file   : LSL$DATA_ROOT:[LSL.IFF]NOTTS.IFF;3                     
 Created on : 12-OCT-1987 17:14:53.00
 Updated on : 25-MAR-1988 11:07:16.00    (Revision number :    3)
 Range Information
 -----------------
 Xmin =      -11.300      Xmax =     1000.000
 Ymin =     -511.300      Ymax =      511.250
 History Record Information
 --------------------------
Date        Time  Username     Program   Function     Elapsed  CPU      STATUS
 7-OCT-1987 09:27 TOM          OSTF2I    Create       00:00:29 00:00:21 00000001
 7-OCT-1987 12:12 TOM          LITES2UIS Output       00:00:12 00:00:08 00000001
 7-OCT-1987 13:51 TOM          LITES2UIS Output       00:00:31 00:00:16 00000001
 7-OCT-1987 16:11 TOM          LITES2UIS Output       00:00:33 00:00:16 00000001
 7-OCT-1987 17:46 TOM          LITES2UIS Output       00:00:23 00:00:16 00000001
 9-OCT-1987 15:47 TOM          IPATCH    Patch        00:00:23 00:00:00 00000001
 9-OCT-1987 16:22 TOM          LITES2UIS Output       00:00:23 00:00:16 00000001
 9-OCT-1987 18:08 TOM          LITES2UIS Output       00:00:23 00:00:16 00000001
12-OCT-1987 17:05 TOM          ISELECT   Create       00:00:14 00:00:08 00000001
12-OCT-1987 17:12 TOM          IRECODE   Create mode  00:00:04 00:00:03 00000001
12-OCT-1987 17:14 TOM          IRECODE   Create mode  00:00:08 00:00:03 00000001
 Control Point Information
 -------------------------
  NW          0.000        500.000          0.000         500.000
  SW          0.000          0.000          0.000           0.000
  SE        500.000          0.000        500.000           0.000
  NE        500.000        500.000        500.000         500.000
 Information per Layer
 ---------------------
 Layer    No. of     No. of      No. of           2-D                3-D
 Number  Features  2-D Points  3-D Points        Line-Length        Line-Length
     0       27           60           0           11500.204              0.000
     1      182         2013           0           12067.274              0.000
 Information per Feature Code
 ----------------------------
 Feature  No. of     No. of      No. of           2-D                3-D
  Code   Features  2-D Points  3-D Points        Line-Length        Line-Length
     28      77           77           0               0.000              0.000
    398      28           62           0           12500.204              0.000
   2031      35          364           0            5556.678              0.000
   2101      69         1570           0            5510.597              0.000
 Totals Information
 ------------------
 Total number of layers =                 2
 Total number of features =             209
 Total number of 2-D points =          2073
 Total number of 3-D points =             0
 Total 2-D line-length =          23567.479
 Total 3-D line-length =              0.000
 Information per Feature Code/Layer
 ----------------------------------
   Layer    0
   ----------
 Feature  No. of     No. of      No. of           2-D                3-D
  Code   Features  2-D Points  3-D Points        Line-Length        Line-Length
    398      27           60           0           11500.204              0.000
   Layer    1
   ----------
 Feature  No. of     No. of      No. of           2-D                3-D
  Code   Features  2-D Points  3-D Points        Line-Length        Line-Length
     28      77           77           0               0.000              0.000
    398       1            2           0            1000.000              0.000
   2031      35          364           0            5556.685              0.000
   2101      69         1570           0            5510.522              0.000
 ELAPSED:    0 00:00:17.16  CPU: 0:00:07.04  BUFIO: 5  DIRIO: 118  FAULTS: 133 
$

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

MESSAGES (INFORMATIONAL)

These messages give information only, and require no immediate action by the user.

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

MESSAGES (WARNING)

These messages indicate that an error has occurred which may require some operator action, but which should not stop the processing of the file.

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

MESSAGES (ERROR)

These messages indicate an error in processing which has caused the program to terminate. The most likely causes are a corrupt or otherwise invalid input IFF file, or an error related to the command line processing and file manipulation.

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

MESSAGES (OTHER)

In addition to the above messages which are generated by IINFO 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.