--------------------------------------------------------------------------------
MODULE    ILAYFC

--------------------------------------------------------------------------------
REPLACES  DAMP module LIT

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

FUNCTION

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

FORMAT


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

PROMPTS

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

PARAMETERS

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

QUALIFIERS

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

DESCRIPTION

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

EXAMPLES

$ ILAYFC
_Input-file: NOTHERE/LOG
_Output file: FAILURE
Layer number, Feature code ? 1,23
Layer number, Feature code ? 11,22
Layer number, Feature code ? 
%LSLLIB-E-IFFOPEN, error opening IFF input file LSL$IF:NOTHERE.IFF
%RMS-E-FNF, file not found
 ELAPSED: 00:00:27.87  CPU: 0:00:00.37  BUFIO: 8  DIRIO: 11  FAULTS: 70 
$

$ ILAYFC
_Input-file: TEST1/LOG/CODES=(1>A23,55>11)
_Output file: : TEST22
%ILAYFC-W-BADPARFMT, incorrect format for /CODES parameters \1>A23\
Layer number, Feature code ? 1,23HEL
%ILAYFC-W-TWOARGS, two integer arguments required.
Layer number, Feature code ? 1 23
Layer number, Feature code ? 55>11
Layer number, Feature code ? 
%LSLLIB-I-IFFOPENED, DUA0:[LSL.IFF]TEST1.IFF;3 opened for read
%LSLLIB-I-IFFOPENED, DUA0:[LSL.IFF]TEST22.IFF;1 opened for write
%ILAYFC-I-LAYERCHA, changing all layer 1 feature codes to 23
%ILAYFC-I-LAYERSKP, skipping layer 12
%ILAYFC-I-LAYERCHA, changing all layer 55 feature codes to 11
 ELAPSED: 00:02:22.95  CPU: 0:00:03.31  BUFIO: 13  DIRIO: 18  FAULTS: 110 
$

$ ILAYFC _Input-file: MARSH11/LOG _Output file: MARSH12 Layer number, Feature code ? 1,23 Layer number, Feature code ? 55 11 Layer number, Feature code ? %LSLLIB-I-IFFOPENED, DUA0:[LSL.IFF]MARSH11.IFF;89 opened for read %LSLLIB-I-IFFOPENED, DUA0:[LSL.IFF]MARSH12.IFF;7 opened for write %ILAYFC-I-LAYERCHA, changing all layer 1 feature codes to 23 %ILAYFC-I-LAYERCHA, changing all layer 55 feature codes to 11 %ILAYFC-I-LAYERSKP, skipping layer 70 %ILAYFC-I-LAYERSKP, skipping layer 71 ELAPSED: 00:02:22.95 CPU: 0:00:03.31 BUFIO: 13 DIRIO: 18 FAULTS: 110 $

$ ILAYFC TEST/LOG/CODES=(1>1,88>9,55>17,66>66) DUA0:[DILL.FAILED]TESTOUT %LSLLIB-I-IFFOPENED, DUA0:[LSL.IFF]TEST.IFF;2 opened for read %LSLLIB-I-IFFOPENED, DUA0:[DILL.FAILED]TESTOUT.IFF;184 opened for write %ILAYFC-I-LAYERCHA, changing all layer 1 feature codes to 1 %ILAYFC-I-LAYERCHA, changing all layer 8 feature codes to 9 %ILAYFC-I-LAYERCHA, changing all layer 6 feature codes to 6 %ILAYFC-I-LAYERCHA, changing all layer 15 feature codes to 7 %ILAYFC-I-LAYERSKP, skipping layer 14 %ILAYFC-I-LAYERSKP, skipping layer 11 ELAPSED: 00:00:04.98 CPU: 0:00:02.02 BUFIO: 5 DIRIO: 95 FAULTS: 84 $

$ ILAYFC TEST5/IN_SITU/LOG/CODES=(1>9,11>99) %LSLLIB-I-IFFOPENED, DUA3:[BUREAU.TRIALS]TEST5.IFF;3 opened for update %ILAYFC-I-LAYERCHA, changing all layer 2 feature codes to 37 %ILAYFC-I-LAYERCHA, changing all layer 3 feature codes to 349 %ILAYFC-I-LAYERCHA, changing all layer 8 feature codes to 400 ELAPSED: 00:00:04.98 CPU: 0:00:02.02 BUFIO: 5 DIRIO: 95 FAULTS: 84 $

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

MESSAGES (INFORMATIONAL)

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

MESSAGES (WARNING)

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

MESSAGES (ERROR)

These messages indicate an error in processing which has caused ILAYFC 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 ILAYFC 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.