--------------------------------------------------------------------------------
MODULE    ISELECT

-------------------------------------------------------------------------------- REPLACES None, ISELECT is a completely new IMP utility.

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

FUNCTION

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

FORMAT

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

PROMPTS

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

PARAMETERS

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

COMMAND QUALIFIERS

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

RESTRICTIONS

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

DESCRIPTION

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

EXAMPLES

$ ISELECT/FC=0/LAYER=123 W009SW W009SW_LAYER_123
 ELAPSED: 00:00:17.54  CPU: 0:00:01.57  BUFIO: 16  DIRIO: 68  FAULTS: 123 
$

$ ISELECT/EXCLUDE_FC=0/LAYER=123 W009SW W009SW_LAYER_123 ELAPSED: 00:00:17.54 CPU: 0:00:01.57 BUFIO: 16 DIRIO: 68 FAULTS: 123 $

$ ISELECT/FC=(0:100)/LAYER=(1:99) LESLEY/LOG _To: LESLEY.SEL %LSLLIB-I-IFFOPENED, DUA3:[BUREAU.TRIALS]LESLEY.IFF;2 opened for read %LSLLIB-I-IFFOPENED, DUA3:[BUREAU.TRIALS]LESLEY.SEL;1 opened for write %ISELECT-I-LAYER, layer 24 found %ISELECT-I-LAYER, layer 1 found %ISELECT-I-LAYER, layer 66 found %ISELECT-I-LAYER, layer 44 found %ISELECT-I-LAYER, layer 151 found ELAPSED: 00:00:21.20 CPU: 0:00:01.77 BUFIO: 16 DIRIO: 70 FAULTS: 95 $

$ ISELECT/LAYER=9/INTEGER_HEIGHT/MODULUS=15 _From: BUR$DISK:[BUREAU.TRIALS.EDITING]CONTOURS7.IFF;1 _To: INDEX_CONTOURS ELAPSED: 00:00:03.77 CPU: 0:00:00.49 BUFIO: 2 DIRIO: 7 FAULTS: 111 $

$ ISELECT/AC=(2,4)/LAYER=(1,3,11,80:200) SHEET_190.IFF;1 SELECTIONS/LOG %LSLLIB-I-IFFOPENED, DUA3:[BUREAU.TRIALS]SHEET_190.IFF;1 opened for read %LSLLIB-I-IFFOPENED, DUA3:[BUREAU.TRIALS]SELECTIONS.IFF;1 opened for write %ISELECT-E-UNEXPEOF, unexpected end of IFF file ELAPSED: 00:00:07.54 CPU: 0:00:01.81 BUFIO: 15 DIRIO: 69 FAULTS: 128 $

$ ISELECT/AC=(2,4)/LAYER=(1,3,11,80:200) _From: GROUND_RENT_ISOLINES/REAL_HEIGHT=(99.Y:800.0) _To: GROUND_RENT_ISOLINES %LSLLIB-E-INVALSPEC, invalid syntax for value specification _\9.Y_\ ELAPSED: 00:00:01.65 CPU: 0:00:00.25 BUFIO: 2 DIRIO: 0 FAULTS: 100 $

$ ISELECT/AC=(2,4)/LAYER=(1,3,11,80:200) FE/MODULUS=10 _To: FE_SEL %LSLLIB-E-IFFOPEN, error opening input file "LSL$IF:FE.IFF;0" for read -RMS-F-FNF, file not found ELAPSED: 00:00:03.14 CPU: 0:00:00.37 BUFIO: 4 DIRIO: 2 FAULTS: 81 $

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

MESSAGES (INFORMATIONAL)

These messages give information only, and require no immediate action by the user (except perhaps to verify that the correct options have been selected). Generally they will only appear if /LOG has been specified on the command line.

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

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. With the exception of the IFF file closure errors, no output file will be produced if one of these error messages is output.

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

MESSAGES (OTHER)

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