--------------------------------------------------------------------------------
MODULE    ISORT

-------------------------------------------------------------------------------- REPLACES DAMP modules SIF and IRN

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

FUNCTION

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

FORMAT


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

PROMPTS


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

PARAMETERS

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

COMMAND QUALIFIERS

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

DESCRIPTION

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

EXAMPLES

$ ISORT LESLEY FE.IFF
 ELAPSED: 00:02:03.15  CPU: 0:00:56.12  BUFIO: 8362  DIRIO: 3230  FAULTS: 1379
$ 
$ ISORT LESLEY FE.IFF/LOG
%LSLLIB-I-IFFOPENED, DUA0:[IFF.IMP.TEST]LESLEY.IFF;0 opened for read
%LSLLIB-I-IFFOPENED, DUA0:[IFF.IMP.TEST]FE.IFF opened for write
%ISORT-I-LAYER, layer 4 found
%ISORT-I-LAYER, layer 7 found
%ISORT-I-LAYER, layer 1 found
%ISORT-I-LAYER, layer 24 found
%ISORT-I-LAYER, layer 31 found
%ISORT-I-LAYER, layer 32 found
 ELAPSED: 00:00:11.18  CPU: 0:00:02.38  BUFIO: 7  DIRIO: 50  FAULTS: 1227 
$ 
$ ISORT LESLEY/OUTPUT/NODUPLICATES=FIRST FE.IFF
=================================== ISORT ======================================
Input file:   DUA0:[IFF.IMP.TEST]LESLEY.IFF;3
Output file:  DUA0:[IFF.IMP.TEST]FE.IFF;4
Command line:
ISORT LESLEY/OUTPUT/NODUPLICATES=FIRST FE.IFF
SORT SUMMARY:
Layer 1
Duplicate Feature with FSN 1 discarded
Duplicate Feature with FSN 1 discarded
Duplicate Feature with FSN 98 discarded
Lowest Feature Serial Number     1
Missing Feature Serial Numbers   113 to 327
Highest Feature Serial Number    329
Layer 1 contains 116 sorted features
3 duplicates were omitted
Layer 4
Duplicate Feature with FSN 6 discarded
Duplicate Feature with FSN 74 discarded
Lowest Feature Serial Number     408
Missing Feature Serial Numbers   2117 to 9995
Highest Feature Serial Number    9999
Layer 4 contains 1713 sorted features
2 duplicates were omitted
DUA0:[IFF.IMP.TEST]LESLEY.IFF;3 contains 2028 unsorted features
DUA0:[IFF.IMP.TEST]FE.IFF;4 contains 2023 sorted features, 5 duplicates were
omitted 
 ELAPSED:    0 00:00:19.15  CPU: 0:00:10.28  BUFIO: 26  DIRIO: 242  FAULTS: 1192
$
$ ISORT/FC/LOG/OUT START FC_SORTED<CR>
%LSLLIB-I-IFFOPENED, LSL$SOURCE_ROOT:[IMP.ISORT]START.IFF;2 opened for read
%LSLLIB-I-IFFOPENED, LSL$SOURCE_ROOT:[IMP.ISORT]FC_SORTED.IFF;5 opened for write
=================================== ISORT ======================================
Input file:   LSL$SOURCE_ROOT:[IMP.ISORT]START.IFF;2
Output file:  LSL$SOURCE_ROOT:[IMP.ISORT]FC_SORTED.IFF;5
Command line:
ISORT/FC/LOG/OUT START FC_SORTED
SORT SUMMARY:
%ISORT-I-LAYER, layer 1 found
Layer 1
Lowest Feature Code              1
Highest Feature Code             300
Layer 1 contains 16 sorted features
%ISORT-I-LAYER, layer 2 found
Layer 2
Lowest Feature Code              1
Highest Feature Code             1000
Layer 2 contains 8 sorted features
%ISORT-I-LAYER, layer 3 found
Layer 3 is empty
%ISORT-I-LAYER, layer 4 found
Layer 4
Lowest Feature Code              1
Highest Feature Code             1
Layer 4 contains 1 sorted features
LSL$SOURCE_ROOT:[IMP.ISORT]START.IFF;2 contains 25 unsorted features
LSL$SOURCE_ROOT:[IMP.ISORT]FC_SORTED.IFF;5 contains 25 sorted features
 ELAPSED:    0 00:00:14.66  CPU: 0:00:12.61  BUFIO: 49  DIRIO: 73  FAULTS: 1598 
$
$ ISORT UNCODE CODE
%LSLLIB-E-IFFOPEN, IFF error opening file "LSL$IF:UNCODE.IFF;0" for read
%IFF-E-OPEN, error opening IFF file
-RMS-E-FNF, file not found
 ELAPSED: 00:00:01.11  CPU: 0:00:00.28  BUFIO: 2  DIRIO: 4  FAULTS: 60 
$
$ ISORT LESLEY FE.IFF/DUP/OUT=LESLEY.LIS
 ELAPSED: 00:00:14.80  CPU: 0:00:05.65  BUFIO: 10  DIRIO: 60  FAULTS: 1988 
$
$ ISORT LESLEY FE.IFF/OUT=LESLEY.LIS/PRINTER
 ELAPSED: 00:00:02.54  CPU: 0:00:00.38  BUFIO: 3  DIRIO: 1  FAULTS: 155 
$
$ ISORT LESLEY FE.IFF/PRINTER/INTERNAL
 ELAPSED: 00:00:07.78  CPU: 0:00:01.78  BUFIO: 6  DIRIO: 55  FAULTS: 1125 
$

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

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)

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

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. It is most unlikely that any output file produced will be correctly processed.

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

MESSAGES (OTHER)

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