ISTSEL - IFF POLYGON SEGMENT SELECTION UTILITY

------------------------------------------------------------------------------
MODULE    ISTSEL

------------------------------------------------------------------------------ REPLACES NONE ------------------------------------------------------------------------------

FUNCTION

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

FORMAT


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

PROMPTS

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

PARAMETERS

input-file-spec

output-file-spec ------------------------------------------------------------------------------

COMMAND QUALIFIERS

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

DESCRIPTION

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

! Example code definition file for POLYGONS utility ISTSEL ! ! Copyright 1987 Laser-Scan Ltd, Cambridge, England ! ! Author: G S Tobiss 17-Feb-1987 ! ! File format is: ! ! %New_code ! Old_code_1 [, Old_code_n ... ] ! ! Where: ! ! ! - is a comment. Text after a "!" is ignored. ! % - indicates that the following text is to be read as a new ! segment code ! New_code - is the new segment code ! Old_code - is [one of a list of] old segment codes to be replaced ! by the new code. Old segment codes must be separated by ! commas . ! ! For example: ! %LOW_STRAW_INCORPORATION_POTENTIAL P123,P67a,P23/u ! %MEDIUM_STRAW_INCORPORATION_POTENTIAL P34, 901, River_terrace_material ! %MEDIUM_STRAW_INCORPORATION_POTENTIAL P67c,P98,P6Ab !

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

EXAMPLES

$ ISTSEL/DEF_FILE=POLDEF.DAT/LOG
_Input IFF file: DUA3:[BUREAU.SOILS]OLDCODES.IFF;7
_Output IFF file: GLEYS
%ISTSEL-I-DEFOPENED, /DEF_CODE file SYS$DISK:[]POLDEF.DAT;0 opened for read
%LSLLIB-I-IFFOPENED, DUA3:[BUREAU.SOILS]OLDCODES.IFF;7 opened for read
%LSLLIB-I-IFFOPENED, DUA3:[BUREAU.SOILS]OLDCODES.IFF;8 opened for write
Number of left/right coded links processed = 129
Number of left/right coded links deleted = 23
 ELAPSED: 00:02:01.10  CPU: 0:00:57.15  BUFIO:8250  DIRIO: 3230  FAULTS: 1037
$
$ ISTSEL/LOG _Input IFF file: DUA3:[BUREAU.SOILS]OLDCODES.IFF;7 _Output IFF file: GLEYS %ISTSEL-E-OPDEF, error opening code definition file SYS$DISK:[]CODE_DEF.DAT;0 -LSLLIB-E-NOSUCHFILE, file cannot be found ELAPSED: 00:02:01.10 CPU: 0:00:57.15 BUFIO:8250 DIRIO: 3230 FAULTS: 1037 $

$ ISTSEL POLFILE NEWFILE
 ELAPSED: 00:01:10.20  CPU: 0:00:37.15  BUFIO:6250  DIRIO: 2230  FAULTS: 797
$
------------------------------------------------------------------------------

MESSAGES (INFORMATIONAL)

These messages give information only, and require no immediate action by the user. They are often used to supply explanatory information in support of a warning or error message.

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

MESSAGES (WARNING)

These messages are output when an error has occurred which the user can correct immediately.

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

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 command line processing and file manipulation. As it is most unlikely that any output file produced will be correctly processed, the output file will normally be deleted.

DUPCODES, duplicate code "code" detected at line 'integer' of code definition file 'file-spec'

MAXCODEEX, maximum number of new codes exceeded at line 'integer' of code definition file - maximum allowed is 'integer'

MAXCODEEX, maximum number of old codes exceeded at line 'integer' of code definition file - maximum allowed is 'integer'

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

MESSAGES (OTHER)

In addition to the above messages which are generated by ISTSEL 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. 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. Generally, however, ISTSEL will attempt to delete any corrupt output file before program termination.