ITCHECK - ERROR CHECKING OF IFF HEIGHTED DATA.


--------------------------------------------------------------------------------
MODULE ITCHECK

--------------------------------------------------------------------------------
DEVELOPED from DTMPREPARE module TCHECK.

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

FUNCTION

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

FORMAT

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

PROMPT

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

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

DESCRIPTION

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

GENERAL

GROUP DEFINITION TABLE

TOLERANCE

INPUT IFF FILES

ERROR REPORT

OUTPUT ERROR FILE

LITES2 GUIDANCE FILE

EXAMPLE

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

ITCHECK COMMAND DEFAULTS.

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

ITCHECK COMMANDS

_@ COMMAND

--------------------------------------------------------------------------------
_@

--------------------------------------------------------------------------------
FORMAT: _@file-spec

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

ITCHECK offers the facility of command input from an indirect command file. The '@' character preceding a file-spec will cause ITCHECK to open and read commands from the specified file until:

Nested command files are not supported (i_.e_. a command file containing an '@' command), although sequential '@' commands are supported when read from SYS$COMMAND.

As an aid to batch log interpretation ITCHECK will echo all commands read from an indirect command file.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the _@ command:

*** WARNING *** "@" must precede a file-spec

*** WARNING *** Indirect file error - returning to terminal input

*** ERROR *** Can't open indirect command file 'file-spec'

--------------------------------------------------------------------------------
Examples:


ITCHECK> @PRESETS<CR>
ITCHECK> LOOKUP GROUP1
ITCHECK> DESELECT FC 27
ITCHECK> CHECK 1,3:5
ITCHECK> CONTOUR_INTERVAL 10
ITCHECK> INDEX_INTERVAL 50
ITCHECK> SUPPLEMENTARY_INTERVAL 2
ITCHECK> PROFILE_INTERVAL 5
ITCHECK> RETURN
ITCHECK>

_! COMMAND

--------------------------------------------------------------------------------
_!

--------------------------------------------------------------------------------
FORMAT: _! [comment text]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

An exclamation mark is the standard DTMPREPARE package comment delimiter. All text (and numbers) which lie to the right of a '!' character are excluded from command interpretation. Comments are useful for annotating command procedures used in batch processing etc_.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


ITCHECK> _! a comment for the sake of it<CR>
ITCHECK> CHECK 1:5<CR>
ITCHECK>

BORDER COMMAND

--------------------------------------------------------------------------------
BORDER

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

FORMAT:	        BORDER sw_xcoord sw_ycoord ne_xcoord ne_ycoord

or

FORMAT:	        BORDER sw_xcoord sw_ycoord nw_xcoord nw_ycoord
		       ne_xcoord ne_ycoord se_xcoord se_ycoord

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

BORDER is used to define the map limits of the IFF file. By default, the bounding rectangle derived from the CP entry values is used.

The BORDER command can be given in one of two ways. The first method requires that the south-west followed by the north-east coordinates be supplied to define the rectangle. The second method requires that the south-west, north-west, north-east and south-east corners be supplied, in that order to define the area of interest.

This command is normally used when the values in the IFF file CP entry are known not to correspond to the actual map area ie. when the control points do not define the corners of the map. Care should be taken when inputting parameters with this command, as it may lead to the generation of erroneous messages when category 2 (link checks) checks are carried out.

The command SHOW BORDER may be used to examine the border coordinate values.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the BORDER command:


*** ERROR *** Specifying command BORDER
Command requires either: 
   2 x,y coordinate pairs (SW and NE)
or
   4 x,y coordinate pairs (SW, NW, NE and SE)

*** ERROR *** Specifying command BORDER
Real argument not found

*** ERROR *** Specifying command BORDER
NE x coordinate > SW x coordinate

*** ERROR *** Specifying command BORDER
NE y coordinate > SW y coordinate

*** ERROR *** Specifying command BORDER
SE x coordinate < SW x coordinate

*** ERROR *** Specifying command BORDER
NE x coordinate < NW x coordinate

*** ERROR *** Specifying command BORDER
NW y coordinate < SW y coordinate

*** ERROR *** Specifying command BORDER
NE y coordinate < SE y coordinate

--------------------------------------------------------------------------------
Examples:

ITCHECK>BORDER 0.0 0.0 300.0 350.0
ITCHECK>

CHECK COMMAND

--------------------------------------------------------------------------------
CHECK

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

FORMAT:         CHECK category[,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The CHECK command is used to specify which category or categories of checks are to be performed by the ITCHECK process. When two or more categories are specified by the CHECK command the lowest category number is always processed first. The checks are performed when the GO command is given.

The following categories of checks may be specified by using the the CHECK command (see utility description for more information):

Category 1 Height checks.

Category 2 Link checks.

Category 3 Intersection checks.

Category 4 Validity of neighbouring height checks.

Category 5 Loop, duplicate points and spot height single coordinate.

Category 6 Validity of spot heights checks.

The SHOW CHECK command can be used to display which checks are currently selected.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the CHECK command:


*** ERROR *** Specifying command CHECK
Unexpected character 'char' at this point 

*** ERROR *** Specifying command CHECK
Command requires check number or range of check numbers
*** ERROR *** Specifying command CHECK
Illegal check 'number' number
Checks must be between 1 - 6


--------------------------------------------------------------------------------
Examples:

ITCHECK>CHECK 6,1:3
ITCHECK>

CLOSE IFF COMMAND

--------------------------------------------------------------------------------
CLOSE IFF

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

FORMAT:	        CLOSE IFF

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The CLOSE IFF command is used to close all opened input IFF files. The command is generally used to close a set of input IFF files after checking has been performed, before specifying a new set of IFF files for a new series of checks.

The command is also useful when an IFF file is opened in error.

The command SHOW FILES may be used to list all opened input IFF files.

--------------------------------------------------------------------------------
Messages:

The following error message is specific to the CLOSE IFF command:


*** ERROR *** Specifying command CLOSE IFF
No input IFF files opened

--------------------------------------------------------------------------------
Examples:

ITCHECK>CLOSE IFF

All input IFF files have been closed

ITCHECK>

CLOSE LIST COMMAND

--------------------------------------------------------------------------------
CLOSE LIST

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

FORMAT:	        CLOSE LIST

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The CLOSE LIST command is used to close the error tabulation file. The error tabulation file can be re-specified using the LIST command.

The command SHOW FILES may be used to list all files specified.

--------------------------------------------------------------------------------
Messages:

The following error message is specific to the CLOSE LIST command:


*** ERROR *** Specifying command CLOSE LIST
No LIST file opened

--------------------------------------------------------------------------------
Examples:

ITCHECK>CLOSE LIST
ITCHECK>

CLOSE LITES COMMAND

--------------------------------------------------------------------------------
CLOSE LITES

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

FORMAT:	        CLOSE LITES 

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The CLOSE LITES command is used to close the LITES2 command file. The LITES2 command file can be re-specified using the LITES command.

The command SHOW FILES may be used to list all files specified.

--------------------------------------------------------------------------------
Messages:

The following error message is specific to the CLOSE LITES command:


*** ERROR *** Specifying command CLOSE LITES 
No LITES2 file opened

--------------------------------------------------------------------------------
Examples:

ITCHECK>CLOSE LITES
ITCHECK>

CLOSE OUTPUT COMMAND

--------------------------------------------------------------------------------
CLOSE OUTPUT

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

FORMAT:	        CLOSE OUTPUT 

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The CLOSE OUTPUT command is used to close an opened output IFF error file. The output IFF error file can be re-specified using the OUTPUT command.

The command SHOW FILES may be used to list all files specified.

--------------------------------------------------------------------------------
Messages:

The following error message is specific to the CLOSE OUTPUT command:


*** ERROR *** Specifying command CLOSE OUTPUT 
No OUTPUT file opened

--------------------------------------------------------------------------------
Examples:

ITCHECK>CLOSE OUTPUT
ITCHECK>

CONTOUR_INTERVAL COMMAND

------------------------------------------------------------------------------
CONTOUR_INTERVAL

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

FORMAT:		CONTOUR_INTERVAL contour_interval

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The CONTOUR_INTERVAL command is used to specify the height interval between adjacent contours. The contour interval is used to check that all normal contours (as opposed to supplementary or index contours) are divisible by the contour interval.

The parameter is also used to check that all contours are present between the lower and upper contour limits as specified by the ZLIMITS command.

The contour interval must be specified before the GO command if CHECK 1 and/or CHECK 4 have been requested.

The currently defined contour interval may be examined using the SHOW INTERVALS command.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the CONTOUR_INTERVAL command:


*** ERROR *** Specifying command GO

Command requires contour interval

*** ERROR *** Specifying command CONTOUR_INTERVAL
Value is less than previously specified SUPPLEMENTARY_INTERVAL
'supplementary_interval'

*** ERROR *** Specifying command CONTOUR_INTERVAL
Value is greater than previously specified INDEX_INTERVAL 'index_interval'

--------------------------------------------------------------------------------
Example:

ITCHECK>CONTOUR_INTERVAL 10
ITCHECK>SHOW INTERVALS

INTERVALS:
   Contour interval is 10.00
   No index interval specified
   No supplementary interval specified
   No profile interval specified

ITCHECK>

DESELECT FC COMMAND

--------------------------------------------------------------------------------
DESELECT FC

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

FORMAT:         DESELECT FC feature_code [,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DESELECT FC command is used to exclude IFF features from checking. Features are excluded on the basis of their feature code. This is useful if particular features are known to be in error, since they can be deselected from the error checking process.

By default ITCHECK will use all features defined in the group definition table.

The SHOW GROUP command can be used to display feature selections for each of the groups defined.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the DESELECT and DESELECT FC commands:


*** ERROR *** Specifying command DESELECT
Command qualifiers are FC, FSN or LAYER             

*** ERROR *** Specifying command DESELECT FC
Unexpected character 'char' at this point 

*** ERROR *** Specifying command DESELECT FC
Illegal feature code 'fc'

*** ERROR *** Specifying command DESELECT FC
No group definitions loaded
Therefore no feature codes available for selection
Use command LOOKUP to load group definition table
*** ERROR *** Specifying command DESELECT FC
Invalid group name 'group_name'

*** ERROR *** Specifying command DESELECT FC
Group not defined
Therefore no feature codes available for selection
Use command LOOKUP to load group definition table containing required group

--------------------------------------------------------------------------------
Examples:

ITCHECK>DESELECT FC 1
ITCHECK>DESELECT FC SPOT_HEIGHTS
ITCHECK>DESELECT FC 7:10,56:78
ITCHECK>

DESELECT FSN COMMAND

--------------------------------------------------------------------------------
DESELECT FSN

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

FORMAT:	        DESELECT FSN fsn [,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DESELECT FSN command is used to exclude IFF features from checking. Features are excluded on the basis of their feature serial number. This is useful if a particular feature is known to be in error, since it can be deselected from the error checking process.

By default ITCHECK will use all FSN's within an overlay.

The SHOW SELECTION command may be used to display which FSN's are currently selected.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the DESELECT and DESELECT FSN commands:


*** ERROR *** Specifying command DESELECT
Command qualifiers are FC, FSN or LAYER             

*** ERROR *** Specifying command DESELECT FSN
Unexpected character 'char' at this point 

*** ERROR *** Specifying command DESELECT FSN
Illegal FSN number 'fsn'

--------------------------------------------------------------------------------
Examples:

ITCHECK>DESELECT FSN 4
ITCHECK>DESELECT FSN 7:10,56:78
ITCHECK>

DESELECT LAYER COMMAND

--------------------------------------------------------------------------------
DESELECT LAYER

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

FORMAT:	        DESELECT LAYER layer [,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DESELECT LAYER command is used to exclude IFF features from the checking process. Features are excluded on the basis of IFF layer.

By default ITCHECK will use all features within an IFF file.

The SHOW SELECTION command may be used to display which layers are currently selected.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the DESELECT and DESELECT LAYER commands:


*** ERROR *** Specifying command DESELECT
Command qualifiers are FC, FSN or LAYER             

*** ERROR *** Specifying command DESELECT LAYER
Unexpected character 'char' at this point 

*** ERROR *** Specifying command DESELECT LAYER
Illegal layer number 'layer number'

--------------------------------------------------------------------------------
Examples:

ITCHECK>DESELECT LAYER 7
ITCHECK>DESELECT LAYER 1,7:10
ITCHECK>

EXIT COMMAND

--------------------------------------------------------------------------------
EXIT

--------------------------------------------------------------------------------
FORMAT: EXIT

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
Description:

The EXIT command is used to exit from ITCHECK. Any opened files are closed.

(pressing the Ctrl and Z keys together) may also be used to exit from the program.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

ITCHECK> EXIT<CR>
ELAPSED: 00:00:20.04 CPU: 0:00:04.71 BUFIO: 281 DIRIO: 46 FAULTS: 263
_$

GO COMMAND

--------------------------------------------------------------------------------
_GO

--------------------------------------------------------------------------------
FORMAT: GO

--------------------------------------------------------------------------------
Command parameters: None

--------------------------------------------------------------------------------
DESCRIPTION:

The GO command is used to start the processing and the error checking of the input IFF files. Before the check processing takes places, the following tests will be carried out to ensure that certain preconditions hold:-

Detected errors in the vector data will be reported in the tabulation error file. Optionally the detected errors, will be output to a LITES2 command file if the LITES command has been given. If the OUTPUT command has been specified then a portion of the coordinate data in the vicinity of detected error will be output to an IFF error file.

Upon successful completion of the checks the ITCHECK command prompt will be displayed. Any opened files apart from the input IFF files will be closed. The category parameter, specified with the CHECK command, will be undefined. Before another GO command can be given it will be necessary to re-specify the new sequence of checks using the CHECK command. This is to avoid running the same sequence of checks accidentally.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the GO command:


*** ERROR *** Specifying the command GO
No input IFF files open              >> Execute command IFF

*** ERROR *** Specifying the command GO
No group definition table loaded     >> Execute command LOOKUP

*** ERROR *** Specifying the command GO
No checks selected                   >> Execute command CHECK

*** ERROR *** Specifying the command GO
Contour interval not specified       >> Execute command CONTOUR_INTERVAL

*** ERROR *** Specifying the command GO
Index interval not specified         >> Execute command INDEX_INTERVAL

*** ERROR *** Specifying the command GO
Supplementary interval not specified >> Execute command SUPPLEMENTARY_INTERVAL

*** ERROR *** Specifying the command GO
Contour limits not specified         >> Execute command ZLIMITS

*** ERROR *** Specifying the command GO
Border tolerance not specified       >> Execute command TOLERANCE BORDER

*** ERROR *** Specifying the command GO
Maximum tolerance not specified      >> Execute command TOLERANCE MAXIMUM

*** ERROR *** Specifying the command GO
Minimum tolerance not specified      >> Execute command TOLERANCE MINIMUM

*** ERROR *** Specifying the command GO
Profile interval not specified       >> Execute command PROFILE_INTERVAL

*** ERROR *** No feature code match found
Either:-  FC has been deselected     >> Execute SELECT command
or        lookup file is invalid     >> Execute LOOKUP command

--------------------------------------------------------------------------------
Examples:

   .
   .
   .
   .

ITCHECK> CHECK ALL<CR>
ITCHECK> GO<CR> 100% complete 100% complete 100% complete 100% complete 100% complete 100% complete
ITCHECK>

HELP COMMAND

--------------------------------------------------------------------------------
HELP

    Give help on a subject

--------------------------------------------------------------------------------
FORMAT: HELP subject

--------------------------------------------------------------------------------
Command parameters:

    subject

    The subject on which help is required.

--------------------------------------------------------------------------------
Description:

The HELP command looks the rest of the line up in the DTMPREPARE HELP library. This library contains a brief summary of the operation of each command.

The information is looked up in the ITCHECK section of the DTMPREPARE help library, LSL$HELP:DTMPREPARE.HLB.

--------------------------------------------------------------------------------
Messages:

Where required, warning messages are output via the VMS LBR$OUTPUT_HELP utility.

--------------------------------------------------------------------------------
Examples:


ITCHECK> HELP CLOSE LIST

ITCHECK

CLOSE

LIST

    The CLOSE LIST command is used to close the tabulation error file which has been previous specified by the LIST command.


ITCHECK>

IFF COMMAND

------------------------------------------------------------------------------
IFF

    The IFF command specifies the name of an Internal Feature Format file, containing vector data that is to be input to the checking process.

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

FORMAT:		IFF file_spec

--------------------------------------------------------------------------------
Command parameters:

    file_spec

    The specification of the input IFF file to be opened for checking.

    Any part of the file_spec not supplied for the IFF command will be taken from the default file specification 'LSL$IF:IF.IFF'.

--------------------------------------------------------------------------------
DESCRIPTION:

The IFF command specifies the name of an Internal Feature Format file, containing vector data that is to be input to the checking process.

Multiple files may be specified by repeatedly giving the IFF command. Up to five input IFF files may be defined. Note: all the input IFF file must share a common local origin.

The SHOW FILES command will display the file specification of the input IFF files currently opened for vector checking.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the IFF command:


*** WARNING *** You must specify a file-spec argument to the IFF command

*** ERROR *** You must specify a file-spec argument to the IFF command

*** ERROR *** Specifying command IFF
A GO command with a checking sequence has been performed
No more IFF input files can be opened at this stage
Execute command CLOSE IFF followed by IFF to open a new series of files

*** ERROR *** Specifying command IFF
Maximum of five files already opened

*** ERROR *** Opening input IFF file 'file_spec'

*** ERROR *** With input IFF file 'file_spec'
Has a different local origin than the first file opened
Local origin of this file is : X = 'x_coord' Y = 'y_coord'
Local origin of first file is : X = 'x_coord' Y = 'y_coord'

--------------------------------------------------------------------------------
Example:

ITCHECK>IFF AREA1_M1
IFF file LSL$IF:AREA1_M1 selected as input
ITCHECK>IFF AREA1_M2
IFF file LSL$IF:AREA1_M2 selected as input
ITCHECK>

INDEX_INTERVAL COMMAND

------------------------------------------------------------------------------
INDEX_INTERVAL

    Specifies the index contour interval.

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

FORMAT:		INDEX_INTERVAL index_interval

--------------------------------------------------------------------------------
Command parameters:

    index_interval

    This specifies the height interval between index contour lines. The value must be a positive number greater than zero.

    If SUPPLEMENTARY_INTERVAL command has been executed then:

    
    		index_interval > supplementary_interval    
    

    If CONTOUR_INTERVAL command has been executed then:

    
    		index_interval >= contour_interval    
    

--------------------------------------------------------------------------------
DESCRIPTION:

The INDEX_INTERVAL command is used to specify the index contour interval. The value is used to check that all index contour features are divisible by the index contour interval.

The parameter is also used to check that all index contours are present between the lower and upper contour limits as specified by the ZLIMITS command. If an index contour is absent and a normal contour present instead then a warning message is entered into the error tabulation file.

This value must be assigned before the GO command is given if CHECK 1 has been requested, otherwise it will be assigned, by default, to the contour_interval, and a warning to this effect will be given.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the INDEX_INTERVAL command:


*** WARNING ***  Specifying command GO
Index interval not specified.         >> Defaulting to previously specified CONT
OUR_INTERVAL

*** ERROR *** Specifying command INDEX_INTERVAL
Value is less than previously specified SUPPLEMENTARY_INTERVAL 
'supplementary_interval'

*** ERROR *** Specifying command INDEX_INTERVAL
Value is less than previously specified CONTOUR_INTERVAL 'contour_interval'

--------------------------------------------------------------------------------
Example:

ITCHECK>INDEX_INTERVAL 50
ITCHECK>SHOW INTERVAL

INTERVALS:
   No contour interval specified
   Index interval is 50.00
   No supplementary interval specified
   No profile interval specified

ITCHECK>

LAYER COMMAND

------------------------------------------------------------------------------
LAYER

    Specifies the initial layer number in the output IFF error file.

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

FORMAT:		LAYER layer

--------------------------------------------------------------------------------
Command parameters:

    layer

    This specifies the first layer number in the output IFF file. An integer number in the range 0 to 32761 is required.

--------------------------------------------------------------------------------
DESCRIPTION:

The LAYER command is used to specify the number of the initial layer in the output IFF error file. The layer number is automatically incremented by 1 between the different checking processes when the GO command is executed.

If the LAYER command is not given then error layer 2 is initially created in the output IFF file.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the LAYER command:


*** ERROR *** Specifying command LAYER
Command requires initial layer number

*** ERROR *** Specifying command LAYER
Parameter 'layer' not in range 1 - 32761

--------------------------------------------------------------------------------
Example:

ITCHECK>LAYER 5
ITCHECK>CHECK 2,3:5
ITCHECK>

LIST COMMAND

------------------------------------------------------------------------------
LIST

    Specifies the name of the tabulation error file.

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

FORMAT:		LIST file_spec

--------------------------------------------------------------------------------
Command parameters:

    file_spec

    The specification of the tabulation error file.

--------------------------------------------------------------------------------
DESCRIPTION:

The LIST command specifies the name of a tabulation error file which will contain the list of errors output during the vector checking process.

If the LIST command is not given, the default file-spec will be ITCHECK.LIS on the current directory.

On completion of the GO command any opened tabulation error file will be closed. The LIST command will need to be given again if another series of checks are to be performed and a tabulation error file other than the default is required.

The SHOW FILES command will display the name of the currently specified tabulation error file.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the LIST command:


*** WARNING *** You must specify a file-spec argument to the LIST command

*** ERROR *** You must specify a file-spec argument to the LIST command

*** ERROR *** Unable to interpret input file-spec

--------------------------------------------------------------------------------
Example:

ITCHECK>LIST AREA1_CHK1_4.TXT
ITCHECK>

LITES COMMAND

------------------------------------------------------------------------------
LITES

    Specifies the name of an output LITES2 command file.

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

FORMAT:		LITES file_spec

--------------------------------------------------------------------------------
Command parameters:

    file_spec

    The specification of the LITES2 command file.

    Any part of the file_spec not supplied for the LITES command will be taken from the default file specification 'LSL$LITES2CMD:LCM.LCM'.

--------------------------------------------------------------------------------
DESCRIPTION:

The LITES command specifies the name of the output LITES2 command or guidance file.

The LITES2 command file will only be generated if the LITES command is given. During the vector checking process most detected errors will generate entries into this file. The resulting command file can be used in conjunction with the LITES2 cartographic editor to position an error in the IFF files, and to assist correction of the data.

On completion of the GO command any opened tabulation error file will be closed. The LITES command will need to be given again if another series of checks are to be performed and a LITES2 command file is required.

The SHOW FILES command will display the name of the currently specified LITES2 command file.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the LITES command:


*** WARNING *** You must specify a file-spec argument to the LITES command

*** ERROR *** You must specify a file-spec argument to the LITES command

*** ERROR *** Unable to interpret input file-spec

--------------------------------------------------------------------------------
Example:

ITCHECK>LITES AREA1_CHK1_4.LCM
ITCHECK>

LOOKUP COMMAND

------------------------------------------------------------------------------
LOOKUP

    Specifies the name of an ITCHECK group definition file.

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

FORMAT:		LOOKUP file_spec

--------------------------------------------------------------------------------
Command parameters:

    file_spec

    The specification of the file containing the group definitions.

    Any part of the file_spec not supplied for the LOOKUP command will be taken from the default file specification 'LSL$LOOKUP:ITCHECK.DAT'.

--------------------------------------------------------------------------------
DESCRIPTION:

The LOOKUP command specifies the name of the file containing the ITCHECK group definitions. The loading of a group definition table is a mandatory requirement of the ITCHECK module.

The SHOW FILES command will display the last group definition file loaded using the LOOKUP command. The SHOW GROUPS command may be used to examine the group definitions

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the LOOKUP command:


*** WARNING *** You must specify a file-spec argument to the LOOKUP command

*** WARNING *** Unrecognised group name 'group_name'

*** WARNING *** No feature codes with group name 'group_name'

*** WARNING *** Group 'group_name' previously defined
Feature codes will be added to the group definition table

*** ERROR *** You must specify a file-spec argument to the LOOKUP command

*** ERROR *** Unable to interpret input file-spec

*** ERROR *** Specifying command LOOKUP
Unable to open file 'file_spec'

*** ERROR *** Specifying command LOOKUP
While reading file 'file_spec'

*** ERROR *** Specifying command LOOKUP
Unable to close file 'file_spec'

*** ERROR *** in LOOKUP file 'file_spec'
Unexpected character 'char' at this point

*** ERROR *** in LOOKUP file 'file_spec'
Illegal feature code 'feat_code'
Feature code must be between 0 - 32767

*** ERROR *** in LOOKUP file 'file_spec'
New feature code 'feat_code' in group 'group_name' is not unique

--------------------------------------------------------------------------------
Example:

ITCHECK>LOOKUP GROUP_TABLE1.DAT
ITCHECK>SHOW GROUPS

GROUPS:
   COASTLINES have been defined
The following feature codes are currently selected:
14
   CONTOURS have been defined
The following feature codes are currently selected:
5:10,55
   INDEX_CONTOURS have been defined
The following feature codes are currently selected:
66
   LAKES have been defined
The following feature codes are currently selected:
4
   RIVERS have been defined
The following feature codes are currently selected:
2
   SPOT_HEIGHTS have been defined
The following feature codes are currently selected:
27
   SUPPLEMENTARY_CONTOURS have been defined
The following feature codes are currently selected:
77

ITCHECK>

OUTPUT COMMAND

------------------------------------------------------------------------------
OUTPUT

    Opens an output IFF (Internal Feature Format) error file.

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

FORMAT:		OUTPUT file_spec

--------------------------------------------------------------------------------
Command parameters:

    file_spec

    The specification of the output IFF error file to receive coordinates in error.

    Any part of the file_spec not supplied for the OUTPUT command will be taken from the default file specification 'LSL$IF:IFF.IFF'.

--------------------------------------------------------------------------------
DESCRIPTION:

The OUTPUT command specifies the name of an output Internal Feature Format error file. If any features are found to be in error during the checking process, the coordinates describing the relevant part of the feature will be output to the file. A maximum of 10 coordinates will be written. Which part of the feature these coordinates define is dependent on the nature of the error.

For each category of error checking a new layer within the IFF will be created. The LAYER command may be used to control which layers are created in the file.

The SHOW FILES command will display the file specification of the output IFF error file.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the OUTPUT command:


*** WARNING *** You must specify a file-spec argument to the OUTPUT command

*** ERROR *** You must specify a file-spec argument to the OUTPUT command

*** ERROR  *** Unable to interpret output file-spec

--------------------------------------------------------------------------------
Example:

ITCHECK>OUTPUT AREA1_OVERLAY
ITCHECK>

PAUSE COMMAND

--------------------------------------------------------------------------------
PAUSE

    Pauses ITCHECK execution.

--------------------------------------------------------------------------------
FORMAT: PAUSE

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Pauses ITCHECK execution and issues a prompt for a carriage return to continue execution. This command is designed for use in software demonstration situations.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


ITCHECK> PAUSE<CR>


Press to continue<CR>
ITCHECK>

PROFILE_INTERVAL COMMAND

------------------------------------------------------------------------------
PROFILE_INTERVAL

    Specifies the interval between successive vertical profiles.

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

FORMAT:		PROFILE_INTERVAL profile_interval

--------------------------------------------------------------------------------
Command parameters:

    profile__interval

    This specifies the distance between vertical profiles. The value must be a positive integer number.

--------------------------------------------------------------------------------
DESCRIPTION:

The PROFILE_INTERVAL command is used to specify the interval distance along the x axis between vertical profiles. The parameter is mandatory for a processing sequence which includes check 4.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the PROFILE_INTERVAL command:


*** ERROR *** Specifying command PROFILE_INTERVAL
Command requires profile interval

*** ERROR *** Specifying command PROFILE_INTERVAL
Value is less than 1

--------------------------------------------------------------------------------
Example:

ITCHECK>PROFILE_INTERVAL 5
ITCHECK>SHOW INTERVAL

INTERVALS:
   No contour interval specified
   No Index interval specified
   No supplementary interval specified
   Profile interval is 5

ITCHECK>

RETURN COMMAND

--------------------------------------------------------------------------------
RETURN

    Restores command input from an indirect file to SYS$COMMAND.

--------------------------------------------------------------------------------
FORMAT: RETURN

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Restores command input from an indirect file to SYS$COMMAND.

A typical application is to allow the user to use an indirect command file to set up those run time defaults which are constant within a flowline and then return to input from the terminal (or batch stream) for the run specific commands. To do this RETURN must be the last command in the indirect command file.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the RETURN command:

RETURN command detected - returning to terminal input

RETURN command ignored - command input is already from terminal

--------------------------------------------------------------------------------
Examples:


ITCHECK> @PRESET_INTERVAL<CR>
ITCHECK> CONTOUR_INTERVAL 10.0
ITCHECK> INDEX_INTERVAL 50.0
ITCHECK> SUPPLEMENTARY_INTERVAL 2.0
ITCHECK> PROFILE_INTERVAL 5
ITCHECK> RETURN
ITCHECK>

SELECT FC COMMAND

--------------------------------------------------------------------------------
SELECT FC

    Select IFF features for checking on the basis of feature code.

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

FORMAT:         SELECT FC feature_code [,...]

--------------------------------------------------------------------------------
Command parameters:

    feature_code

    An integer feature code in the range 0 to 32767. Multiple feature codes may be specified separated by commas or spaces, while a range of feature codes may be specified by means of a colon ':'. eg. SELECT FC 10:13 includes feature codes 10,11,12 and 13 if they are in a particular group definition table. Alternatively a group name from the group definition table may be specified eg SELECT FC RIVERS.

--------------------------------------------------------------------------------
DESCRIPTION:

The SELECT FC command is used to include IFF features for checking. Features are included on the basis of their feature code. The feature code must be defined in one of the group definition tables for it to be used in the checking process.

By default ITCHECK will use all features within the group definition table loaded using the LOOKUP command.

The SHOW GROUP command can be used to display feature selections for each of the groups defined.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the SELECT and SELECT FC commands:


*** ERROR *** Specifying command SELECT
Command qualifiers are FC, FSN or LAYER             

*** ERROR *** Specifying command SELECT FC
Unexpected character 'char' at this point 

*** ERROR *** Specifying command SELECT FC
Illegal feature code 'fc'

*** ERROR *** Specifying command SELECT FC
No group definitions loaded
Therefore no feature codes available for selection
Use command LOOKUP to load group definition table

*** ERROR *** Specifying command SELECT FC
Invalid group name 'group_name'

*** ERROR *** Specifying command SELECT FC
Group not defined
Therefore no feature codes available for selection
Use command LOOKUP to load group definition table containing required group

--------------------------------------------------------------------------------
Examples:

ITCHECK>SELECT FC 1
ITCHECK>SELECT FC SPOT_HEIGHTS
ITCHECK>SELECT FC 7:10,56:78
ITCHECK>

SELECT FSN COMMAND

--------------------------------------------------------------------------------
SELECT FSN

    Include an IFF feature for checking on the basis of feature serial number.

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

FORMAT:	        SELECT FSN fsn [,...]

--------------------------------------------------------------------------------
Command parameters:

    fsn

    An integer feature serial number in the range 0 to 65534. Multiple feature serial numbers may be specified separated by commas or spaces, while a range of numbers may be specified by means of a colon ':'. eg. SELECT FSN 10:13 includes feature serial numbers 10,11,12 and 13.

--------------------------------------------------------------------------------
DESCRIPTION:

The SELECT FSN command is used to include IFF features for checking. Features are included on the basis of their feature serial number.

By default ITCHECK will use all FSNs' within an layer.

The SHOW SELECTION command may be used to display which FSN's are currently selected.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the SELECT and SELECT FSN commands:


*** ERROR *** Specifying command SELECT
Command qualifiers are FC, FSN or LAYER             

*** ERROR *** Specifying command SELECT FSN
Unexpected character 'char' at this point 

*** ERROR *** Specifying command SELECT FSN
Illegal FSN number 'fsn'

--------------------------------------------------------------------------------
Examples:

ITCHECK>SELECT FSN 4
ITCHECK>SELECT FSN 7:10,56:78
ITCHECK>

SELECT LAYER COMMAND

--------------------------------------------------------------------------------
SELECT LAYER

    Includes an IFF feature for checking on the basis of layer number.

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

FORMAT:	        SELECT LAYER layer [,...]

--------------------------------------------------------------------------------
Command parameters:

    layer

    An integer layer number in the range 1 to 32767. Multiple layer numbers may be specified separated by commas or spaces, while a range of layer numbers may be specified by means of a colon ':'. eg. SELECT LAYER 10:13 excludes all features in layers 10,11,12 and 13.

--------------------------------------------------------------------------------
DESCRIPTION:

The SELECT LAYER command is used to include IFF features for checking. Features are included on the basis of IFF layer.

By default ITCHECK will use all features within an IFF file.

The SHOW SELECTION command may be used to display which layers are currently selected.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the SELECT and SELECT LAYER commands:


*** ERROR *** Specifying command SELECT
Command qualifiers are FC, FSN or LAYER             

*** ERROR *** Specifying command SELECT LAYER
Unexpected character 'char' at this point 

*** ERROR *** Specifying command SELECT LAYER
Illegal layer number 'layer'

--------------------------------------------------------------------------------
Examples:

ITCHECK>SELECT LAYER 7
ITCHECK>SELECT LAYER 1,7:10
ITCHECK>

SHOW BORDER COMMAND

--------------------------------------------------------------------------------
SHOW BORDER

    Displays information on the current values which define the map border.

--------------------------------------------------------------------------------
FORMAT: SHOW BORDER

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The command SHOW BORDER displays the x, y coordinates which define the map border. This will display either the SW and NE coordinates or the SW, NW, NE and SE coordinates depending on how the BORDER command was given.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the SHOW command:


*** ERROR *** Specifying the command SHOW
Available show command qualifiers are:
      BORDER      CHECKS      FILES       GROUPS      INTERVALS
      SELECTIONS  TOLERANCES  WINDOWS     ZLIMITS

--------------------------------------------------------------------------------
Examples:

ITCHECK> BORDER 10.0 220.0 100.0 375.0<CR>
ITCHECK> SHOW BORDER<CR>

   Border setting:  SW X = 10.0
                    SW Y = 220.0
                    NE X = 100.0
                    NE Y = 375.0

ITCHECK>

SHOW CHECKS COMMAND

--------------------------------------------------------------------------------
SHOW CHECKS

    Displays information on the current series of checks to be performed.

--------------------------------------------------------------------------------
FORMAT: SHOW CHECKS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The command SHOW CHECKS displays the series of checks that will be performed when the GO command is given.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the SHOW command:


*** ERROR *** Specifying the command SHOW
Available show command qualifiers are:
      BORDER      CHECKS      FILES       GROUPS      INTERVALS
      SELECTIONS  TOLERANCES  WINDOWS     ZLIMITS

--------------------------------------------------------------------------------
Examples:

ITCHECK> CHECKS 1,3:5<CR>
ITCHECK> SHOW CHECKS<CR>

   Current settings are 1 3 4 5

ITCHECK>

SHOW FILES COMMAND

--------------------------------------------------------------------------------
SHOW FILES

    Displays file specification of all ITCHECK files input and output.

--------------------------------------------------------------------------------
FORMAT: SHOW FILES

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The command SHOW FILES displays the files specification for all currently specified input and output ITCHECK files. File spec data is displayed for input IFF files, the output error IFF, the tabulation error file, the LITES2 command file and the group definition file lookup. Refer to the following commands for the file name specification:-

IFF for input IFF files.
OUTPUT for output IFF error file.
LIST for tabulation error file.
LITES for LITES2 command file.
LOOKUP for group definition table file.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the SHOW command:


*** ERROR *** Specifying the command SHOW
Available show command qualifiers are:
      BORDER      CHECKS      FILES       GROUPS      INTERVALS
      SELECTIONS  TOLERANCES  WINDOWS     ZLIMITS

--------------------------------------------------------------------------------
Examples:

ITCHECK> LOOKUP GROUPDEF1<CR>
ITCHECK> IFF AREA1_LINE_FC<CR>
ITCHECK> IFF AREA1_SPOT_FC<CR>
ITCHECK> LIST AREA1.LIS<CR>
ITCHECK> LITES AREA1<CR>
ITCHECK> SHOW FILES<CR>

FILES:
    IFF file LSL$IF:AREA1_LINE_FC selected for input
    IFF file LSL$IF:AREA1_SPOT_FC selected for input
    LIST file AREA1.LIS selected for tabulated errors
    LITES file LSL$LITES2CMD:AREA1.LCM selected
    LOOKUP file LSL$LOOKUP:GROUPDEF1.DAT loaded the last group definition table

ITCHECK>

SHOW GROUPS COMMAND

--------------------------------------------------------------------------------
SHOW GROUPS

    Displays the name of all currently defined groups, together with the selected feature codes.

--------------------------------------------------------------------------------
FORMAT: SHOW GROUPS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The command SHOW GROUPS displays the name of all groups defined in the group definition table. The command also listed the currently selected feature codes under the defined groups. The group definition table can be loaded by using the LOOKUP command. If the SHOW GROUPS command is given before the LOOKUP command a message is displayed indicating that no group definition table has been loaded.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the SHOW command:


*** ERROR *** Specifying the command SHOW
Available show command qualifiers are:
      BORDER      CHECKS      FILES       GROUPS      INTERVALS
      SELECTIONS  TOLERANCES  WINDOWS     ZLIMITS

--------------------------------------------------------------------------------
Examples:

ITCHECK> SHOW GROUPS<CR>

GROUPS:
    No group definition tables loaded

ITCHECK> LOOKUP GROUPDEF1<CR>
ITCHECK> DESELECT FC SHOT_HEIGHTS<CR>
ITCHECK> SHOW GROUPS<CR>
    COASTLINES have been defined         
The following feature codes are currently selected:
14
    CONTOURS have been defined         
The following feature codes are currently selected:
5,55:60
    INDEX_CONTOURS have been defined         
The following feature codes are currently selected:
6
    SUPPLEMENTARY_CONTOURS have been defined
7         
    SPOT_HEIGHTS have been defined
No feature codes selected

ITCHECK>

SHOW INTERVALS COMMAND

--------------------------------------------------------------------------------
SHOW INTERVALS

    Displays information on the current interval parameters.

--------------------------------------------------------------------------------
FORMAT: SHOW INTERVALS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The command SHOW INTERVALS displays the value of the current contour interval, index contour interval, supplementary contour interval and profile interval. These parameters may be varied using the CONTOUR_INTERVAL, INDEX_INTERVAL, SUPPLEMENTARY_INTERVAL and PROFILE_INTERVAL commands.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the SHOW command:


*** ERROR *** Specifying the command SHOW
Available show command qualifiers are:
      BORDER      CHECKS      FILES       GROUPS      INTERVALS
      SELECTIONS  TOLERANCES  WINDOWS     ZLIMITS

--------------------------------------------------------------------------------
Examples:

ITCHECK> CONTOUR_INTERVAL 10.0<CR>
ITCHECK> INDEX_INTERVAL 50.0<CR>
ITCHECK> SUPPLEMENTARY_INTERVAL 2.0<CR>
ITCHECK> SHOW INTERVALS<CR>

INTERVAL:
    Contour interval is 10.00
    Index interval is 50.00
    Supplementary interval is 2.00
    No profile interval specified

ITCHECK>

SHOW SELECTIONS COMMAND

--------------------------------------------------------------------------------
SHOW SELECTIONS

    Displays current IFF layer, feature code and FSN selections.

--------------------------------------------------------------------------------
FORMAT: SHOW SELECTIONS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The command SHOW SELECTIONS, displays the currently selected IFF layers, feature codes and FSNs. The layers, feature codes and FSNs required in the processing can be selected and deselected using the appropriate SELECT or DESELECT commands.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the SHOW command:


*** ERROR *** Specifying the command SHOW
Available show command qualifiers are:
      BORDER      CHECKS      FILES       GROUPS      INTERVALS
      SELECTIONS  TOLERANCES  WINDOWS     ZLIMITS

--------------------------------------------------------------------------------
Examples:

ITCHECK> SHOW SELECTIONS <CR>

SELECTIONS 
    No group definition tables loaded

ITCHECK> LOOKUP GROUPDEF1<CR>
ITCHECK> DESELECT LAYER 6:11<CR>
ITCHECK> SHOW SELECTIONS <CR>
SELECTION:
Following layers selected:
0:5,12:32767
Following feature codes selected:
5,7,27,55:60
All FSN's selected

ITCHECK>

SHOW TOLERANCES COMMAND

--------------------------------------------------------------------------------
SHOW TOLERANCES

    Displays information on the current tolerances parameters.

--------------------------------------------------------------------------------
FORMAT: SHOW TOLERANCES

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The command SHOW TOLERANCES displays information on the current border tolerance, minimum tolerance and maximum tolerance. These parameters may be varied using the appropriate TOLERANCE BORDER, TOLERANCE MINIMUM and TOLERANCE MAXIMUM commands.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the SHOW command:


*** ERROR *** Specifying the command SHOW
Available show command qualifiers are:
      BORDER      CHECKS      FILES       GROUPS      INTERVALS
      SELECTIONS  TOLERANCES  WINDOWS     ZLIMITS

--------------------------------------------------------------------------------
Examples:

ITCHECK> SHOW TOLERANCES<CR>

    No border tolerance specified
    No minimum tolerance specified
    No maximum tolerance specified

ITCHECK> TOLERANCE BORDER 1.0<CR>
ITCHECK> TOLERANCE MINIMUM 0.5<CR>
ITCHECK> TOLERANCE MAXIMUM 4.0<CR>
ITCHECK> SHOW TOLERANCES<CR>
INTERVALS:
    Border tolerance value is 1.00
    Minimum tolerance value is 0.50
    Maximum tolerance value is 4.00

ITCHECK>

SHOW WINDOW COMMAND

--------------------------------------------------------------------------------
SHOW WINDOW

    Displays the current SW and NE coordinates which define the map window.

--------------------------------------------------------------------------------
FORMAT: SHOW WINDOW

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The command SHOW WINDOW displays the SW and NE x, y coordinates which define the map window. The window coordinates are defined using the WINDOW command.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the SHOW command:


*** ERROR *** Specifying the command SHOW
Available show command qualifiers are:
      BORDER      CHECKS      FILES       GROUPS      INTERVALS
      SELECTIONS  TOLERANCES  WINDOWS     ZLIMITS

--------------------------------------------------------------------------------
Examples:

ITCHECK> WINDOW 50.0 300.0 90.0 350.0<CR>
ITCHECK> SHOW WINDOW <CR>

   window setting:  SW X = 50.0
                    SW Y = 300.0
                    NE X = 90.0
                    NE Y = 350.0

ITCHECK>

SHOW ZLIMITS COMMAND

--------------------------------------------------------------------------------
SHOW ZLIMITS

    Displays information on the lower and upper contour levels.

--------------------------------------------------------------------------------
FORMAT: SHOW ZLIMITS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The command SHOW ZLIMITS displays information on the current lower and upper height limits. These parameters may be varied using the ZLIMITS command.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the SHOW command:


*** ERROR *** Specifying the command SHOW
Available show command qualifiers are:
      BORDER      CHECKS      FILES       GROUPS      INTERVALS
      SELECTIONS  TOLERANCES  WINDOWS     ZLIMITS

--------------------------------------------------------------------------------
Examples:

ITCHECK> ZLIMITS 100.0 500.0<CR>
ITCHECK> SHOW ZLIMITS<CR>

ZLIMITS:
    Lower contour limit is 100.000
    Upper contour limit is 500.000

ITCHECK>

SPAWN COMMAND

--------------------------------------------------------------------------------
SPAWN

    The SPAWN command enables a subprocess to be created from within ITCHECK.

--------------------------------------------------------------------------------
FORMAT: SPAWN command-line

--------------------------------------------------------------------------------
Command parameters:

    command-line

    Specifies a DCL command string to be executed as if typed in response to a '$' prompt. When the command completes, the subprocess terminates and control is returned to ITCHECK. The command line cannot exceed 80 characters.

--------------------------------------------------------------------------------
DESCRIPTION:

The SPAWN command enables you to create a subprocess while within ITCHECK. When the subprocess terminates, control is returned to ITCHECK.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the SPAWN command:


*** ERROR *** Specifying command SPAWN 
Command requires a valid DCL command line

*** ERROR *** Unable to spawn command, returning to ITCHECK

--------------------------------------------------------------------------------
Examples:

ITCHECK> SPAWN DIRECTORY LSL$DTI:*_._DTI

Directory DUA3:[LSL.DTI]
TEST1_.DTI;1              8/8       18-AUG-1987 07:56  [LSL,DAVEC]
TEST2_.DTI;1              7/8       18-AUG-1987 17:17  [LSL,DAVEC]
TEST2_.DTI;2              7/8       18-AUG-1987 17:34  [LSL,DAVEC]
Total of 3 files, 22/24 blocks.

ITCHECK>

SUPPLEMENTARY_INTERVAL COMMAND

------------------------------------------------------------------------------
SUPPLEMENTARY_INTERVAL

    Specifies the supplementary contour interval.

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

FORMAT:		SUPPLEMENTARY_INTERVAL supplementary_interval

--------------------------------------------------------------------------------
Command parameters:

    supplementary_interval

    This specifies the height interval between any two supplementary contour lines. The value must be a positive number greater than zero.

    If CONTOUR_INTERVAL command has been executed then:

    
    		supplementary_interval <= contour_interval    
    

    If INDEX_INTERVAL command has been executed then:

    
    		supplementary_interval < index_interval    
    

--------------------------------------------------------------------------------
DESCRIPTION:

The SUPPLEMENTARY_INTERVAL command is used to specify the supplementary index contour interval. The value is used to check that all supplementary contour features are divisible by the supplementary contour interval.

This value must be assigned before the GO command is given if CHECK 1 has been requested, otherwise it will be assigned, by default, to the contour_interval, and a warning to this effect will be given.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the SUPPLEMENTARY_INTERVAL command:


*** WARNING ***  Specifying command GO
Supplementary interval not specified. >> Defaulting to previously specified CONT
OUR_INTERVAL

*** ERROR *** Specifying command SUPPLEMENTARY_INTERVAL
Value is greater than previously specified CONTOUR_INTERVAL 'contour_interval'

*** ERROR *** Specifying command SUPPLEMENTARY_INTERVAL
Value is greater than previously specified INDEX_INTERVAL 'index_interval'

--------------------------------------------------------------------------------
Example:

ITCHECK>SUPPLEMENTARY_INTERVAL 2
ITCHECK>SHOW INTERVAL

INTERVALS:
   No contour interval specified
   No index interval specified
   Supplementary interval is 2.00
   No profile interval specified

ITCHECK>

TOLERANCE BORDER COMMAND

------------------------------------------------------------------------------
TOLERANCE BORDER

    Specifies the border tolerance value.

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

FORMAT:		TOLERANCE BORDER border_tol

--------------------------------------------------------------------------------
Command parameters:

    border_tol

    This specifies the border tolerance value. The value must be a positive real number. Normally this value would be small. Values less than 0.5% of the x or y map extent being typical.

--------------------------------------------------------------------------------
DESCRIPTION:

The TOLERANCE BORDER command is used to specify the border tolerance value. This parameter is mandatory for check 2. The border tolerance is used to determine whether line features touch the map border; and no feature lies partly or wholly outside the map border. See section under "Tolerance" in ITCHECK utility description for more information on tolerance parameters.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the TOLERANCE and TOLERANCE BORDER commands:


*** ERROR *** Specifying command TOLERANCE 
Command qualifiers are
BORDER   MAXIMUM   MINIMUM

*** ERROR *** Specifying command TOLERANCE BORDER
Command requires tolerance value

*** ERROR *** Specifying command TOLERANCE BORDER
Value 'border_tol' is less than or equal to 0.0

--------------------------------------------------------------------------------
Example:

ITCHECK>TOLERANCE BORDER 1
ITCHECK>SHOW TOLERANCE

TOLERANCES:
   Border tolerance value is 1.000
   No minimum tolerance specified
   No maximum tolerance specified

ITCHECK>

TOLERANCE MAXIMUM COMMAND

------------------------------------------------------------------------------
TOLERANCE MAXIMUM

    Specifies the maximum tolerance value.

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

FORMAT:		TOLERANCE MAXIMUM maximum_tolerance

--------------------------------------------------------------------------------
Command parameters:

    maximum_tolerance

    This specifies the maximum tolerance value. The value must be a positive real number. Normally this value should reflect the maximum allowable gap between continuous line features.

--------------------------------------------------------------------------------
DESCRIPTION:

The TOLERANCE MAXIMUM command is used to specify the maximum tolerance value. The command is mandatory for check 2. The value defined by this command is used to test whether a continuous line feature is connected to similar allowing for any valid gaps which may be present. Breaks can occur in contour line features where it is necessary to annotate a height. The maximum tolerance value specifies the maximum width of such gaps. See section under "Tolerance" in ITCHECK utility description for more information on tolerance parameters.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the TOLERANCE and TOLERANCE MAXIMUM commands:


*** ERROR *** Specifying command TOLERANCE 
Command qualifiers are
BORDER   MAXIMUM   MINIMUM

*** ERROR *** Specifying command TOLERANCE MAXIMUM
Command requires tolerance value

*** ERROR *** Specifying command TOLERANCE MAXIMUM
Value 'minimum_tolerance' is less than or equal to 0.0

*** ERROR *** Specifying command TOLERANCE MAXIMUM
Value is less than or equal to previously specified TOLERANCE MINIMUM
'minimum_tolerance'

--------------------------------------------------------------------------------
Example:

ITCHECK>TOLERANCE MAXIMUM 1
ITCHECK>SHOW TOLERANCE

TOLERANCES:
   No border tolerance specified
   Minimum tolerance value is 1.000
   No maximum tolerance specified

ITCHECK>

TOLERANCE MINIMUM COMMAND

------------------------------------------------------------------------------
TOLERANCE MINIMUM

    Specifies the minimum tolerance value.

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

FORMAT:		TOLERANCE MINIMUM minimum_tolerance

--------------------------------------------------------------------------------
Command parameters:

    minimum_tolerance

    This specifies the minimum tolerance value. The value must be a positive real number. Normally minimum tolerance would be set to have a value which is smaller than the closest distance between any two continuous line features having different heights.

--------------------------------------------------------------------------------
DESCRIPTION:

The TOLERANCE MINIMUM command is used to specify the minimum tolerance value. The command is mandatory for check 2. The value defined using this command is used to test whether a continuous line feature is connected to another continuous line feature of the same height. See section under "Tolerance" in ITCHECK utility description for more information on tolerance parameters.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the TOLERANCE and TOLERANCE MINIMUM commands:


*** ERROR *** Specifying command TOLERANCE 
Command qualifiers are
BORDER   MAXIMUM   MINIMUM

*** ERROR *** Specifying command TOLERANCE MINIMUM
Command requires tolerance value

*** ERROR *** Specifying command TOLERANCE MINIMUM
Value 'minimum_tolerance' is less than or equal to 0.0

*** ERROR *** Specifying command TOLERANCE MINIMUM
Value is greater than or equal to previously specified TOLERANCE MAXIMUM
'maximum_tolerance'

--------------------------------------------------------------------------------
Example:

ITCHECK>TOLERANCE MINIMUM 1
ITCHECK>SHOW TOLERANCE

TOLERANCES:
   No border tolerance specified
   Minimum tolerance value is 1.000
   No maximum tolerance specified

ITCHECK>

WAIT COMMAND

--------------------------------------------------------------------------------
WAIT

    Suspend processing for the specified number of seconds.

--------------------------------------------------------------------------------
FORMAT: WAIT seconds

--------------------------------------------------------------------------------
Command parameters:

    seconds

    The number of seconds for which ITCHECK processing is to be suspended. An integer value is required

--------------------------------------------------------------------------------
DESCRIPTION:

The WAIT command causes processing to be suspended for a specified number of seconds. It is designed for use in software demonstration situations and is of no value in a production flowline.

--------------------------------------------------------------------------------
Messages:

The following warning message is specific to the WAIT command:

*** WARNING *** You must specify the number of seconds to wait

--------------------------------------------------------------------------------
Examples:


ITCHECK> WAIT 4<CR>
ITCHECK>

WINDOW COMMAND

--------------------------------------------------------------------------------
WINDOW

    Specifies the rectangle to be used in the checking processes.

--------------------------------------------------------------------------------
FORMAT: WINDOW x_min y_min x_max y_max

--------------------------------------------------------------------------------
Command parameters:

    x_min y_min

    The coordinates of the bottom left hand corner of the defining rectangle.

    x_max y_max

    The coordinates of the top right hand corner of the defining rectangle.

--------------------------------------------------------------------------------
DESCRIPTION:

The command is used to define rectangular limits to be used in the error checking process. This is useful if only a small segment of the map needs to be vector checked. If any part of a feature passes through the rectangle defined by the WINDOW command then the whole of the feature will be used in the error checking process. Features that do not intersect the defined rectangle are excluded from checking.

The SHOW WINDOW command will display the current window settings.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the WINDOW command:


*** ERROR *** Specifying command WINDOW
Command requires 2 x,y coordinate pairs (SW and NE)

*** ERROR *** Specifying command WINDOW
NE x coordinate < SW x coordinate

*** ERROR *** Specifying command WINDOW
NE y coordinate < SW y coordinate

--------------------------------------------------------------------------------
Examples:

ITCHECK> WINDOW 100.0 150.0 200.0 200.<CR>
ITCHECK>

ZLIMITS COMMAND

------------------------------------------------------------------------------
ZLIMITS

    Specifies the lower and upper contour limits

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

FORMAT:		ZLIMITS min_contour max_contour

--------------------------------------------------------------------------------
Command parameters:

    min_contour max_contour

    This specifies the lower and upper contour limits. The values can be any real numbers. The upper limit must be greater than the lower limit.

--------------------------------------------------------------------------------
DESCRIPTION:

The ZLIMITS command is used to specify the lower and upper contour limits for height checking. The command is mandatory for a processing sequence which includes check 1. The minimum contour and maximum contour parameters are used to ensure that all contours and index contours are present within the height limits, and that no contours lie outside the height range.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the ZLIMITS command:


*** ERROR *** Specifying command ZLIMITS
Command requires lower and upper height limits

*** ERROR *** Specifying command ZLIMITS
lower height = upper height

*** ERROR *** Specifying command ZLIMITS
lower height > upper height

--------------------------------------------------------------------------------
Example:

ITCHECK>ZLIMITS 0.0 100.0
ITCHECK>SHOW ZLIMITS

ZLIMITS:
   Lower contour limit is 'minimum_contour'
   Upper contour limit is 'maximum_contour'

ITCHECK>

ITCHECK EXAMPLES

EXAMPLES

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

$ ITCHECK
DTMPREPARE module ITCHECK of 12:20:05 30-MAR-88
ITCHECK> LOOKUP LOOKUP3.DAT
ITCHECK> LIST LIST3.LIS
ITCHECK> OUTPUT OUTPUT3.IFF
ITCHECK> IFF IFF3_1
IFF file LSL$IF:IFF3_1.IFF;0 selected as input
ITCHECK> IFF IFF3_2
IFF file LSL$IF:IFF3_2.IFF;0 selected as input
ITCHECK> IFF IFF3_3
IFF file LSL$IF:IFF3_3.IFF;0 selected as input
ITCHECK> IFF IFF3_4
IFF file LSL$IF:IFF3_4.IFF;0 selected as input
ITCHECK> IFF IFF3_5
IFF file LSL$IF:IFF3_5.IFF;0 selected as input
ITCHECK> TOLERANCE BORDER 1
ITCHECK> TOLERANCE MAXIMUM 5
ITCHECK> TOLERANCE MINIMUM 1
ITCHECK> CONTOUR 10
ITCHECK> INDEX 50
ITCHECK> SUPPLEMENTARY 2
ITCHECK> PROFILE 10
ITCHECK> ZLIMITS 0 190
ITCHECK> DESELECT FC 27
ITCHECK> SHOW GROUPS
GROUPS:
   COASTLINES have been defined
The following feature codes are currently selected:
14
   CONTOURS have been defined
The following feature codes are currently selected:
5
   INDEX_CONTOURS have been defined
The following feature codes are currently selected:
6
   LAKES have been defined
The following feature codes are currently selected:
4
   RIVERS have been defined
The following feature codes are currently selected:
2
   SPOT_HEIGHTS have been defined
No feature codes selected
   SUPPLEMENTARY_CONTOURS have been defined
The following feature codes are currently selected:
7
ITCHECK> CHECK 1,3:5
ITCHECK> GO
 
  IFF Feature Code Summary
The following feature codes are currently selected:
14
Group name: COASTLINES number of items: 1
The following feature codes are currently selected:
5
Group name: CONTOURS number of items: 32
The following feature codes are currently selected:
6
Group name: INDEX_CONTOURS number of items: 3
The following feature codes are currently selected:
4
Group name: LAKES number of items: 1
The following feature codes are currently selected:
2
Group name: RIVERS number of items: 1
No feature codes selected
Group name: SPOT_HEIGHTS number of items: 0
The following feature codes are currently selected:
7
Group name: SUPPLEMENTARY_CONTOURS number of items: 2
< PROCESSING CHECK 1> 100% complete 
< PROCESSING CHECK 3> 100% complete 
< PROCESSING CHECK 4> 100% complete 
< PROCESSING CHECK 5> 100% complete
ITCHECK> EXIT
 ELAPSED:    0 00:04:27.10  CPU: 0:00:30.52  BUFIO: 286  DIRIO: 587  FAULTS: 384 
$

ITCHECK MESSAGES

MESSAGES (WARNING)

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

MESSAGES (WARNING) NONE

MESSAGES (ERROR)

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

MESSAGES (ERROR) NONE

MESSAGES (FATAL)

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

MESSAGES (FATAL) NONE

MESSAGES (OTHER)

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

MESSAGES (OTHER)

In addition to the above messages which are generated by the program itself, other messages may be produced by Laser-Scan libraries. In particular, messages may be generated by the IFF library or by the Laser-Scan I/O library, LSLLIB. IFF library messages are introduced by %IFF and are documented in the IFFLIB Reference manual. LSLLIB messages are introduced by '%LSLLIB' and are generally self-explanatory. They are often used to explain the details of program generated errors.

If the cause of the error cannot be traced by the user, and Laser-Scan are consulted, then the output file should be preserved to facilitate diagnosis.