-------------------------------------------------------------------------------- MODULE ISELAC
-------------------------------------------------------------------------------- REPLACES DAMP module SELAC
--------------------------------------------------------------------------------
ISELAC is a utility to read an IFF file and write selected features to a new IFF file. Feature selection is based on AC (Ancillary Code) type or on one or more of the attributes associated with an AC entry. ISELAC utilises a series of dynamic command tables created from a user-defined 'skeleton' file, to offer AC selection flexibility.
$ ISELAC
None, ISELAC is command driven.
AC (Ancillary Code) entries in an IFF file are used to hold miscellaneous information not held by the feature code (Feature Status entry). Common AC entries hold information on heights, left and right boundary codes, and secondary feature codes. ISELAC is the IMP utility that enables selection by AC type, numerical AC attribute, Feature Serial Number, and layer, or any combination of these. Layer 0 (zero) the registration layer is always copied to the output file.
If no features are found in the input IFF file which match the selection criteria, the output file IFF is deleted.
ISELAC is an interactive, command driven utility. Command input is expected when the following prompt is issued:
ISELAC>
In certain circumstances the user can also be prompted for values.
The format of an IFF AC Entry is a word (integer*2) type, a longword (integer*4 or real) code, and an optional text. The information held in an AC is determined by the AC type. The current AC type values are defined in the IFF User Guide.
To function successfully ISELAC requires a 'skeleton' file to be set up to define all relevant AC types and attributes. A 'skeleton' file is a text file which specifies for each AC the:
An default 'skeleton' file ACSKEL.DAT is supplied with the IMP package and should be present in the directory pointed to by the logical name LSL$LOOKUP. If this is not found on program initialisation a warning is given. A copy of this file is shown below. The 'skeleton' file can be redefined during program execution using the SKELETON command. Skeleton files can be edited and created using any text editor. They are compatable with skeleton files for the DAMP SELAC program and the LSL DIGSYS manual digitising software.
! EXAMPLE AC SKELTON FILE FOR IMP UTILITY ISELAC ! ! Copyright Laser-Scan Ltd, Cambridge, England ! ! Author: A T Timms 14-Oct-1986 ! ! Format of the file is: ! !(up to 24 characters) ! ! ! if the text descriptor is present a record of the associated text and ! numeric field is required: ! ! ! ! "!" is a comment. Text after a "!" is ignored. ! ! ! Secondary FC ! SECFC ! AC name 1 integer 'feature code' notext ! AC type , AC format , prompt, notext ! ! Integer contour height ! ICONTOUR ! AC name 2 integer 'Contour height (Int)' ! integer, notext by default ! ! Real contour height ! RCONTOUR ! AC name 3 real 'Contour height (Real)' ! real, notext by default ! ! Left code ! LCODE 4 integer 'Left code' notext ! ! Right code ! RCODE 5 integer 'Right code' notext ! ! MCE dfad_point ! DFAD_POINT 7 integer=0 text ! preset code to 0 %I1 typ 'type' [0] %I6 hgt 'height (ms)' [-1022,1022] %I4 fid 'feature id' [1,980] %I2 sec 'security ' [0] %I2 rel 'releasability' %I2 smc 'smc' [1,13] %I3 wid 'width' [0 254] %I3 lth 'length (ms)' [0:254] %I2 ori 'orientation (0 to 63)' [0,63] ! ! MCE dfad_linear ! DFAD_LINEAR 7 integer=0 text %I1 typ 'type' [1] %I6 hgt 'height (ms)' [-1022:1022] %I4 fid 'feature_id' [1,980] %I2 sec 'security' [0 0] %I2 rel 'releasability' %I2 smc 'smc' [1:13] %I3 wid 'width' [0,254] %I1 dir 'directivity' [1 3] ! ! MCE dfad_areal ! DFAD_AREAL 7 integer=0 text %I1 typ 'type' [2] %I5 hgt 'height (ms)' [-1022,1022] %I4 fid 'feature id' [1,980] %I2 sec 'security' [0] %I2 rel 'releasability' %I2 smc 'smc' [1 13] %I2 den 'density ' [0,15] %I3 rof 'roof coverage (%)' [0,100] %I3 tre 'tree coverage (%)' [0,100] ! ! MCE dfad_accuracy ! DFAD_ACC 8 integer=0 text %I4 absv 'absolute vertical' %I4 absh 'absolute horizontal' %I4 relv 'relative vertical' %I4 relh 'relative horizontal' ! ! Gaspipes ! GASPIPE 999 integer text %I1 typ 'type' [0,2] %I4 year 'year of installation' [1865:2100] %I6 pre 'pressure' [-1000,1000] %F6.2 dep 'depth (ms)' [0.00,1000.00] !
An exclamation mark '!' indicates a comment or comment line, and is ignored by ISELAC when reading from the skeleton file.
The AC name (character identifier) is used to select AC's. The name must consist of alphabetic characters or underlines, and may not exceed 24 characters. In the example skeleton file the following AC names are identified: SECFC, ICONTOUR, RCONTOUR, LCODE, RCODE, DFAD_POINT, DFAD_LINEAR, DFAD_AREAL, DFAD_ACC, and GASPIPE. Up to 20 AC names can be defined in one skeleton file.
The line following the AC name should have the format:
AC type [AC code format] ['Prompt string'] [Text indicator]
The AC type consists of one of the integer values in the table above, which is used by the program to identify an IFF AC entry of the specified name. This field is obligatory, the following three are optional.
The AC code format specifies whether the numerical value associated with the AC type is real or integer. In the case of a type 3 AC, the format is 'real' and for type 1 and 2 AC's the format is 'integer'. The value may be preset (ie. fixed) by supplying a value in the format:
[integer] [= n] [real] [= n] where n is an integer or real as appropriate.
If only 'integer' or 'real' is specified, then the value is free to vary. In the example above the type 1,2,3,4 and 5 AC's (SECFC, ICONTOUR, RCONTOUR, LCODE and RCODE) have values that are free to vary but the MCE DFAD AC's (AC types 7 and 8) have the fixed AC code 0 (zero).
An optional prompt string may be supplied which must be enclosed within single quotes. It may be up to 24 characters long and is used when the user requests prompting for AC values (see section below on PROMPT mode). In the example skeleton file the prompt for type 2 AC's (ICONTOUR) is 'Contour height (Int)'.
The final field indicates whether the AC has associated text. The default value of this field is 'notext'. 'Text' should be specified if the AC has associated text entries. In the example file the type 999 AC's (GASPIPE) have associated text whereas the type 2 and 3 AC's (integer and real contour heights, ICONTOUR and RCONTOUR) do not.
For an AC with text, there then follows a number of records each defining a portion of the text and associated numerical field. The form of this record is:
numeric format text entry 'attribute prompt' "" "[range]"
The numeric format specifies whether the field is integer or real, the field width, and (for real) the number of digits after the decimal point.
This is done using:
The text entry defines the characters that will precede the numeric field in the AC entry in the IFF file. There is no restriction on the number of characters, but spaces are not allowed.
The three remaining parts of the record are distinguished by having different delimiters. These may occur in any order:
The attribute prompt is enclosed in single quotes and may be up to 24 characters.
The attribute identifier is the name associated with the field, and is enclosed in angle brackets. It is also restricted to 24 characters although only 12 characters can be displayed by the HELP ATTRIBUTE command.
The range, which is optional, sets the lower and upper limits for the numeric field, enclosed in square brackets and separated by a space, comma or colon. A single number enclosed in square brackets is interpreted as as a preset value. ISELAC checks that values supplied by the user lie within these limits.
In the example skeleton file the type 999 AC (GASPIPE) has four possible associated attributes:
Specific AC names or AC attributes (as defined in the skeleton file) can be selected from the input file by simply typing the name of the AC or attribute. It is also possible to specify ranges of AC values, Feature Serial Numbers, and Layers for selection and deselection. A feature is copied to the output file if an AC for that feature matches the AC selections. All AC's within a feature are checked and if one matches the specified selections the feature is copied.
All AC names, attribute names, the FSN and LAYER commands take one or more optional numerical arguments in one of the following forms:
AC NAME [inequality] [value] ATTRIBUTE NAME [inequality] [value] FSN [inequality] [value] LAYER [inequality] [value]
AC NAME [inequality] value : value2 ATTRIBUTE NAME [inequality] value : value2 FSN [inequality] value : value2 LAYER [inequality] value : value2
AC NAME [inequality] value1 : value2 AND [inequality] value3 ATTRIBUTE [inequality] value1 : value2 AND [inequality] value3 FSN [inequality] value1 : value2 AND [inequality] value3 LAYER [inequality] value1 : value2 AND [inequality] value3
A range is specified by the use of ":" . The inequality NOT is used to exclude a specific value or range of values. A number of separate values or separate ranges of values, may be specified by use of the AND command. Care should be taken when specifiying ranges of REAL values to ensure that all required values are specified in the range. The difficulities encountered by the comparison of real numbers could mean that specifying a range of 200 : 300 for Real contour heights may not result in all contours with heights of 200.0 and 300.0 being selected. If such a range was required 199.999 : 300.001 would be more correct.
Possible inequalities are:
Inequalities: Meaning: = .EQ. Equals > .GT. Greater than >= .GE. Greater than or equal to < .LT. Less than <= .LE. Less than or equal to NOT Not equal to i.e. exclude
The omission of an inequality implies equals "=".
A value may be an integer or real depending on the format for the specified in the 'skeleton' file. If a real value is entered for an attribute requiring an integer value, the value is converted to integer.
The attribute arguments are validated against the upper and lower limits or fixed values defined in the 'skeleton' file. An error message is given (with the valid range) if any of the entered values lie outside the defined range.
If the attribute name is supplied without numerical arguments, a range of values defined by the upper and lower limits in the 'skeleton' file is set.
Up to 10 different values or ranges of values for inclusion or exclusion may be specified for each AC name, attribute name FSN or LAYER. No checks for consistency are made, and the use of the SHOW command is recommended to display the selections prior to issuing the GO command. Selections can be cancelled by the RESET command.
The following examples (based on the default skeleton file) illustrate some of the various possibilities:
ISELAC> GASPIPE will select all GASPIPE AC's (AC type 999) ISELAC> ICONTOUR 100 will select integer contours (AC type 2) with a value of 100 ISELAC> WIDTH will select widths lying between the upper and lower limits defined in the 'skeleton' file ISELAC> WIDTH 20 : 30 will select widths between 20 and 30 if one of the DFAD AC's has been previously selected. ISELAC> WIDTH NOT 20 : 30 will deselect widths between 20 to 30 (i.e. select widths outside the range 20 to 30), if one of the DFAD AC's has been previously selected. ISELAC> RCONTOUR 0.0 : 1000.0 AND NOT 499.99 : 700.9 will select real contour values between 0.0 and 1000.0 excluding 499.99 to 700.9 ISELAC> FSN > 100 will select all features with an FSN (Feature Serial Number) greater than 100 (101 to 65535) ISELAC> LAYER 1 : 3 AND 7 : 20 AND NOT 18 will select layers 1 to 3 and 7 to 20 excluding layer 18 ISELAC> YEAR .LT. 1900 AND .GE. 1940 will select years between 1865 and 1899 and 1904 to 2100 if GASPIPE has previously been selected. (1865 and 2100 are the maxima and minima for the year range specified in the skeleton file). The selection of an AC name automatically cancels previous AC selections. Layer and FSN selections are retained.
Commands, AC and ATTRIBUTE names can be abbreviated to their minimum non ambiguous form. Checks for ambiguities are made between the different commands and AC and attribute names. Warnings are given if commands are ambiguous.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
AND
Separates values or ranges of values
--------------------------------------------------------------------------------
FORMAT: AC NAME 'value' AND 'value'
ATTRIBUTE NAME 'value' AND 'value'
LAYER 'value' AND 'value'
FSN 'value' AND 'value'
--------------------------------------------------------------------------------
COMMAND PARAMETERS: None.
--------------------------------------------------------------------------------
DESCRIPTION:
The AND command separates values or ranges of values following an AC or attribute name, Layer or FSN specification.
--------------------------------------------------------------------------------
Warning messages: None.
--------------------------------------------------------------------------------
Examples:
ISELAC> FSN 1:100 AND NOT 50:60
ISELAC> SHOW
Current AC is ICONTOUR AC selection is by: FSN including: 1 to 100 FSN excluding: 50 to 60
ISELAC> GAS ?
type? 2
year of installation? 1908:1990
pressure? 10:100 AND 110:120
depth (ms)?
ISELAC> SHOW
Current AC is GASPIPE AC selection is by: TYPE including: 2 to 2 YEAR including: 1908 to 1990 PRESSURE including: 10 to 100 PRESSURE including: 110 to 120
ISELAC> DEPTH 10:100 AND NOT 50:60
ISELAC> SHOW
Current AC is GASPIPE AC selection is by: DEPTH including: 10.000 to 100.000 DEPTH excluding: 50.000 to 60.000
--------------------------------------------------------------------------------
EXIT
Exit from ISELAC.
--------------------------------------------------------------------------------
FORMAT: EXIT
--------------------------------------------------------------------------------
Command parameters: None.
--------------------------------------------------------------------------------
DESCRIPTION:
The EXIT command causes ISELAC to exit closing all IFF files.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
ISELAC> EXIT
--------------------------------------------------------------------------------
Selects the input IFF file.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
file-spec
The input IFF file.
--------------------------------------------------------------------------------
Any part of the file name that is not specified will be completed from the
default of "LSL$IF:IFF.IFF;0". Any file previously opened for input are closed.
--------------------------------------------------------------------------------
The following warning messages are specific to the FROM command:
ERRPARFIL, error parsing filename
NOFILNAM, no filename specified
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Selects specified Feature Serial Numbers.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
value
The required FSN.
inequality
One of the valid inequalities.
range
The required range of FSN's.
--------------------------------------------------------------------------------
Feature selection (or de-selection) can be made on the basis of Feature
Serial Number as well as AC. Any single value or range of values (within the
valid IFF limits of 0 to 65535) can be specified according to the format
specified in the section on AC name and attribute selection. FSN selections can
be cancelled using the RESET command.
--------------------------------------------------------------------------------
The following warning messages are specific to the FSN command:
INVALFSN, invalid value for FSN specified
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Terminates command input and activates the selection process.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
The GO command terminates command input, and activates the selection
process. Input and output IFF files must have been previously defined.
A message is output as each layer encountered and a summary of the features
selected or rejected made at the end of each layer. Command is returned to
the user once the input file has been processed, for possible further
selections.
--------------------------------------------------------------------------------
The following warning messages are specific to the GO command:
OUTFILNOSPEC, output file not specified
INFILNOSPEC, input file not specified
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Give help on a subject
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
subject
The subject on which help is required
--------------------------------------------------------------------------------
The HELP command looks the rest of the line up in the ISELAC HELP library.
This library contains a brief summary of the operation of each command.
The information is looked up in the ISELAC section of the IMP help
library, LSL$HELP:IMP.HLB.
In addition HELP AC gives a list of all available AC names defined in
the current skeleton file, and HELP ATTRIBUTES gives a list of all possible
attributes for the currently selected AC name.
--------------------------------------------------------------------------------
Where required, warning messages are output via the VMS LBR$OUTPUT_HELP
utility.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Selects specified Layers.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
value
The required LAYER.
inequality
One of the valid inequalities.
range
The required range of Layers.
--------------------------------------------------------------------------------
Feature selection (or de-selection) can be made on the basis of Layer as
well as Feature Serial Number or AC. Any single value or range of values
(within the valid IFF limits of 0 to 32767) can be specified according to the
format specified in the section on AC name and attribute selection. The
following rules apply to layer selection:
Layer selections can be cancelled using the RESET command.
--------------------------------------------------------------------------------
The following warning messages are specific to the LAYER command:
INVALLAY, invalid value for LAYER specified
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Cancels specified AC NAME, AC ATTRIBUTE, LAYER or FSN selection.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
The RESET command following an AC NAME, AC ATTRIBUTE, LAYER or FSN causes
the selection for that to be cancelled.
--------------------------------------------------------------------------------
The following warning messages are specific to the RESET command:
INVALRESET, invalid use of RESET command
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Displays current selections.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
The SHOW command displays the current selections including AC name, AC
attribute, Layer and Feature Serial Number.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Defines the AC skeleton file to be used.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
skeleton-file-spec
The skeleton file-specification to be used.
--------------------------------------------------------------------------------
Any part of the file name that is not specified will be completed from the
default of "LSL$LOOKUP:ACSKEL.DAT"
--------------------------------------------------------------------------------
The following warning messages are specific to the SKELETON command:
ERROPSKL, error opening skeleton file 'file-spec'
ERRRDSK, error reading AC skeleton file
NOSKFILNAM, no skeleton filename specified
ERRRDACNAM, error reading AC name in skeleton file, line 'integer'
IDNTABS, identifier absent in skeleton file, line 'integer'
IDNTNTCLO, identifier not closed in skeleton file, line 'integer'
IDNTOOLNG, identifier too long in skeleton file, line 'integer'
INCOMPFLD, incomplete field in skeleton file, line 'integer'
INVACTYP, invalid AC type in skeleton file, line 'integer'
INVALKYWD, invalid keyword in skeleton file, line 'integer'
INVALRNG, invalid range in skeleton file, line 'integer'
PRMTNTCLO, prompt not closed in skeleton file, line 'integer'
PRMTOOLNG, prompt too long in skeleton file, line 'integer'
RNGNTCLO, range not closed in skeleton file, line 'integer'
UNRECLIN, unrecognised line 'integer' in skeleton file
--------------------------------------------------------------------------------
ISELAC> SKELETON DUA0:[IMP.ISELAC]ACSKEL.DAT
--------------------------------------------------------------------------------
Specifies the output IFF file.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
file-spec
The output IFF file.
--------------------------------------------------------------------------------
Any part of the file name that is not specified will be completed from the
default of "LSL$IF:ISELAC_DEF.IFF"
--------------------------------------------------------------------------------
The following warning messages are specific to the TO command:
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
Prompts for values for the specified AC name or attribute.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
The _? command following an AC NAME name causes the program to prompt for
attribute values specified in the skeleton file with the prompts specified in
the skeleton file. Attributes that are not required for selection can be ignored
by typing carriage return to an attribute prompt.
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
%ISELAC-I-LAYPROC, layer 2 will be processed
0 features selected in layer 2
6 features rejected in layer 2
%ISELAC-I-LAYPROC, layer 3 will be processed
0 features selected in layer 3
1 feature rejected in layer 3
%ISELAC-I-LAYPROC, layer 4 will be processed
1 feature selected in layer 4
34 features rejected in layer 4
%ISELAC-I-LAYPROC, layer 5 will be processed
1 feature selected in layer 5
13 features rejected in layer 5
%ISELAC-I-LAYPROC, layer 10 will be processed
0 features selected in layer 10
2 features rejected in layer 10
ISELAC> EXIT
This example uses the default skeleton file LSL$LOOKUP:ACSKEL.DAT and
successfully selects a range of real contours (type 3 AC's) and a range of
integer contours (type 2 AC's) to separate files from one input file. The
default skeleton file is found and read in at program initialisation. The input
file (LSL$IF:153NW.IFF;2) is defined using the FROM command and the output
file (LSL$IF:153NW.SEL;1) is defined using the TO command. Real contours (type 3
AC's) in the range 99.999 to 200.001 and 299.99 to 300.001 are selected by
typing the AC name RCONT(OUR) followed by the required ranges of heights
(separated by AND). Layers 1 to 10 are selected using the LAYER
command followed by the range. The SHOW command confirms the selections and the
GO command starts the selection process. A message is output as each layer is
encountered and a summary of the number of features selected and rejected is
output at the end of each layer.
On completion of the selection process on the input file the user is
prompted again with the ISELAC prompt. The user now selects integer contours
(type 2 ACs) within the range 200 to 300 with the command ICONT with the
specified range. The SHOW command confirms the selection. Note the LAYER
selection is retained from the previous run, but all RCONTOUR selections are
cancelled with the ICONTOUR command. A new output file (LSL$IF:153NW.INT;1) is
selected with the TO command and the GO command starts the selection process
with selected features copied to the new output file. Again a message is output
as each layer is encountered and a summary of the number of features selected
and rejected is output at the end of each layer. Program execution is
terminated with the exit command.
ISELAC> ROAD RESET
ISELAC>
This example shows a successful run of ISELAC using a simple user defined
skeleton file to select two different codes from features with AC type 160. This
simple skeleton file is shown below.
The default skeleton file LSL$LOOKUP:ACSKEL.DAT is found and read in at
program initialisation. The user attempts to define the new skeleton file
using the SKELETON command but the file could not be found in LSL$LOOKUP, and
a message is output to this effect. The SKELETON command is reissued with a
correct file specification and the new skeleton file opened successfully. The
HELP AC command verifies the possible AC selection is ROAD and the user selects
AC codes 1 and 2 by issuing the ROAD AC name followed by the required range.
The SHOW command verifies this selection. The input and output files are then
specified using the FROM and TO commands and both files are opened successfully.
The GO command starts the selection process and messages are output as each
layer is encountered. When the selection process is completed the AC code
selections are cancelled using the RESET command and a new selection input
using the ROAD AC name followed by the required value 0 (zero). The SHOW
command again demonstrates the validity of the selections. A new output
file is specified with the TO command and the selection process started with
the GO command. On completion of the selection process
--------------------------------------------------------------------------------
These messages give information only, and require no immediate action by the
user.
Explanation: The AC type specified by the name 'AC name' in the
skeleton file has been selected without any arguments.
User action: None.
Explanation: The AC attribute specified by the name 'ATTRIBUTE name'
has been selected without any arguments.
User action: None.
Explanation: Layer 'integer' has been found and will be copied
User action: None.
Explanation: Layer 'integer' has been found and will be processed
User action: None.
Explanation: Layer 'integer' has been found and will be skipped
User action: None.
Explanation: The specified skeleton file has been successfully opened.
User action: None.
These messages are output when an error has occurred that can be corrected
immediately by the user.
Explanation: The command, AC or ATTRIBUTE name typed is ambiguous
between 'cmd1' and 'cmd2'.
User action: Add sufficient letters to the typed command to make it
non-ambiguous.
Explanation: The specified file cannot be opened for input. This
message will usually be followed by another giving the reason for the failure.
User action: The accompanying message should indicate the cause of the
error. Check the file specification for errors, check that logical name
LSL$LOOKUP: has been assigned to the correct device and directory, check that
the file and directory are not protected against write access. If the problem
continues, notify the system manager.
Explanation: The LSLLIB file name parsing routine has failed to
parse 'file-spec'.
User action: Check for the use of special characters and version
numbers, and the length of the filename specified.
Explanation: An error has occurred reading the AC skeleton file.
This message will usually be followed by another giving the reason for the
failure.
User action: The accompanying message should indicate the cause of the
error. Check the file specification for errors, check that logical name
LSL$LOOKUP: has been assigned to the correct device and directory, check that
the file and directory are not protected against read access. If the problem
continues, notify the system manager.
Explanation: A non numeric response to a prompt for a numeric AC
attribute value has been given.
User action: Give a numeric response to the prompt.
Explanation: A numeric value is missing on the command line.
User action: Check that inequalities and ranges are correctly
specified. Check the selected values with the SHOW command as erroneous
values may now be present. RESET as necessary and retype the corrected
command line.
Explanation: The GO command has been given but no input file has
yet been specified.
User action: Use the FROM command to specify an input file then
re-specify the GO command.
Explanation: A Feature Serial Number outside the valid IFF range
of 0 (zero) to 65535 has been specified.
User action: Retype command line with valid FSNs.
Explanation: A Layer outside the valid IFF range of 0 (zero) to 32767
has been specified.
User action: Retype command line with valid layers.
Explanation: The RESET command has been given after an AND command.
It is only valid after an AC or Attribute name.
User action: Check the selected values with the SHOW command as
erroneous values may now be present. Use the RESET command with a valid AC or
Attribute name.
Explanation: A value has been given for AC attribute 'attrib' that
lies outside the range specified in the AC skeleton file. An additional
message should give the valid maximum and minimum values for 'attrib'.
User action: Give a valid value or range of values. Check the selected
values with the SHOW command as erroneous values may now be present.
Explanation: The FROM or TO command has been given with no file
specification.
User action: Retype the command with a file specification
Explanation: The SKELETON command has been given with no file
specification.
User action: Retype the command with a file specification
Explanation: The GO command has been given but no output file has
yet been specified.
User action: Use the TO command to specify an output file then give
the GO command.
Explanation: The limit of 10 selected values or ranges of values
has been reached for an AC or Attribute name, Layer or FSN.
User action: Use the SHOW command to check that the selected limits
are correct. Either repeat the selection process several times to allow for the
number of limits required, or, check that inequalities are being used to their
maximum effect.
Explanation: An unrecognised command or AC or Attribute name 'cmd'
has been given that cannot be found in any of the command tables. This message
will also be given if there has been invalid use of an inequality after a
valid AC or Attribute name.
User action: Check the validity and spelling of 'cmd' and any
inequalities. Check the AC or Attribute name is in the current AC skeleton
file (use HELP AC and HELP ATTRIBUTE).
Explanation: A numeric value or inequality is missing at the end of the
command line after an AND or NOT for instance.
User action: Check the selected values with the SHOW command as
erroneous values may now be present. RESET as necessary and retype the corrected
command line
--------------------------------------------------------------------------------
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.
Explanation: An error has occurred adding an AC or Attribute name to
the dynamic command tables used by the program.
User action: Check that there are no more than 20 AC names defined
in the skeleton file. If the problem continues notify the system manager and
report the circumstances to LSL.
Explanation: An error has occurred creating a command table or adding
a name to it.
User action: Check that there are no more than 20 AC names defined
in the skeleton file. If the problem continues notify the system manager and
report the circumstances to LSL.
Explanation: An error has occurred reading an AC name in the
skeleton file at line 'integer'. The offending line should be output after the
message.
User action: Check the validity of the line in the skeleton file,
edit as necessary and rerun ISELAC.
Explanation: An error has occurred repositioning an IFF marker
to a previously noted position. This is likely to be an internal error
in the program.
User action: Report circumstances to LSL.
Explanation: The identifier for an AC attribute is missing in the
AC skeleton file in line 'integer'. The offending line should be output after the
message.
User action: Add the missing identifier and rerun ISELAC.
Explanation: The AC attribute identifier specified in line 'integer'
of the skeleton file has no closing angle bracket '>' or is greater than 24
characters long. The offending line should be output after the message.
User action: Edit the skeleton file to correct the error and rerun
ISELAC.
Explanation: The AC attribute identifier specified in line 'integer'
of the skeleton file is longer than 24 characters. The offending line should
be output after the message.
User action: Edit the skeleton file to correct the error and rerun
ISELAC.
Explanation: The numeric format field in the skeleton file, line
'integer', is incomplete.
User action: Edit the skeleton file to correct the error and rerun
ISELAC.
Explanation: An invalid AC type has been specified in the
skeleton file at line 'integer'. Either no AC name has been specified or
there is an error reading the AC type
User action: Edit the skeleton file to correct the error and rerun
ISELAC.
Explanation: An error has occurred reading the text entry for an AC
attribute in line 'integer' of the skeleton file which should be output after the
message.
User action: Edit the skeleton file to correct the error and rerun
ISELAC.
Explanation: An invalid numeric format has been specified in line
'integer' of the skeleton file which should be output after the error message.
User action: Edit the skeleton file to correct the error and rerun
ISELAC.
Explanation: An unrecognised entry has been found in line 'integer' of
the skeleton file. The offending line should be output after the error message.
User action: Check the spelling of keywords in the specified line. Edit
the skeleton file to correct the error and rerun ISELAC
Explanation: An error has occurred reading the range entry of an
AC Attribute in line 'integer' of the skeleton file. The line should be output
after the message.
User action: Check the validity of the specified range, edit the
skeleton file and rerun ISELAC.
Explanation: ISELAC found no matches between the selection criteria
and the features within the input IFF file.
User action: Check that the selection criteria have been specified
correctly. If so, then there really are no features with the selected
characteristics in the input file.
Explanation: The closing single quote is missing from a prompt in
line 'integer' of the skeleton file, or the prompt exceeds 24 characters.
User action: Add the closing single quote to the skeleton file and
rerun ISELAC.
Explanation: The prompt specified in line 'integer' of the skeleton file
is greater than 24 characters in length.
User action: Edit the skeleton file to make the prompt less than 24
characters and rerun ISELAC.
Explanation: The AC Attribute range specified in line 'integer' of the
skeleton file is missing a closing square bracket "]".
User action: Edit the skeleton file to add the closing bracket
and rerun ISELAC.
Explanation: The specified input IFF file terminated before an IFF EJ
entry was encountered.
User action: Use IPATCH to determine the position of the file
truncation and then use IMEND to correctly terminate the file. Re-run ISELAC on
the repaired IFF file.
Explanation: Line 'integer' of the skeleton file does not have any of
the recognised records or characters at the beginning of the line. The offending
line should be output after the error message.
User action: Check that the first character of the specified line is
valid. Valid characters are alphabetic (for AC names), numeric (for AC types),
"!" for a comment and "%" for a numeric format. Edit the skeleton file to
correct the error and rerun ISELAC.
In addition to the above messages which are generated by ISELAC 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.
Warning messages: None.
Examples:
ELAPSED: 00:05:25.84 CPU: 0:00:05.71 BUFIO: 281 DIRIO: 46 FAULTS: 263
_$
FROM COMMAND
FROM
FORMAT: FROM file-spec
Command parameters:
DESCRIPTION:
Warning messages:
Examples:
ISELAC> FROM
%ISELAC-W-NOFILNAM, no filename specified
ISELAC> FROM BUR$DISK:[BUREAU.TEST]101NW.IFF
%LSLLIB-I-IFFOPENED, DUA3:[BUREAU.TEST]101NW.IFF opened for read
ISELAC> FROM 101-NW--;
%ISELAC-W-ERRPARFIL, error parsing filename "101-NW--;"
FSN COMMAND
FSN
FORMAT: FSN [value] [inequality] [range]
Command parameters:
DESCRIPTION:
Warning messages:
Examples:
ISELAC> FSN
%ISELAC-W-MISSVALCMD, missing value on command line
ISELAC> FSN 1:1000
ISELAC> SHOW
Current AC is ICONTOUR
AC selection is by:
FSN including: 1 to 1000
ISELAC> FSN RESET
FSN selection reset
ISELAC> FSN 1:100 AND NOT 50:60
ISELAC> SHOW
Current AC is ICONTOUR
AC selection is by:
FSN including: 1 to 100
FSN excluding: 50 to 60
ISELAC> FSN RESET
FSN selection reset
ISELAC> FSN >10
ISELAC> SHOW
Current AC is ICONTOUR
AC selection is by:
FSN including: 11 to 65535
GO COMMAND
GO
FORMAT: GO
Command parameters: None.
DESCRIPTION:
Warning messages:
Examples:
ISELAC> GO
%ISELAC-W-OUTFILNOSPEC, output file not specified
ISELAC>
ISELAC> GO
%ISELAC-W-INFILNOSPEC, input file not specified
ISELAC> GO
%ISELAC-I-LAYPROC, layer 1 will be processed
0 features selected in layer 1
3 features rejected in layer 1
%ISELAC-I-LAYPROC, layer 4 will be processed
3 features selected in layer 4
32 features rejected in layer 4
%ISELAC-I-LAYCOP, layer 5 will be copied
%ISELAC-I-LAYPROC, layer 10 will be processed
6 features selected in layer 10
2 features rejected in layer 10
ISELAC>
HELP COMMAND
HELP
FORMAT: HELP subject
Command parameters:
DESCRIPTION:
Warning messages:
Examples:
ISELAC> HELP AC
Valid AC names are:
DFAD_ACC DFAD_AREAL DFAD_LINEAR DFAD_POINT GASPIPE
ICONTOUR LCODE RCODE RCONTOUR SECFC
ISELAC> GASPIPE
%ISELAC-I-ACNAMSEL, GASPIPE selected
ISELAC> HELP ATTRIB
Valid attribute names for defined AC are:
DEPTH PRESSURE TYPE YEAR
LAYER COMMAND
LAYER
FORMAT: LAYER [value] [inequality] [range]
Command parameters:
DESCRIPTION:
Warning messages:
Examples:
ISELAC> LAYER 1
ISELAC> SHOW
Current AC is GASPIPE
AC selection is by:
YEAR including: 1908 to 1990
PRESSURE including: 10 to 100
Layer including: 1 to 1
ISELAC> LAYER RESET
LAYER selection reset
ISELAC> LAYER 1:10 AND 15:20 AND NOT 17
ISELAC> SHOW
Current AC is GASPIPE
AC selection is by:
Layer including: 1 to 10
Layer including: 15 to 20
Layer excluding: 17 to 17
ISELAC> LAYER_RESET COMMAND
_RESET
FORMAT: _AC NAME RESET
_AC ATTRIBUTE RESET
_LAYER RESET
_FSN RESET
Command parameters: None.
DESCRIPTION:
Warning messages:
Examples:
ISELAC> SHOW
Current AC is GASPIPE
AC selection is by:
TYPE including: 2 to 2
YEAR including: 1908 to 1990
PRESSURE including: 10 to 100
PRESSURE including: 110 to 120
Layer including: 1 to 1
ISELAC> GAS RESET
GASPIPE and all associated attributes reset
ISELAC> SHOW
Current AC is GASPIPE
AC selection is by:
Layer including: 1 to 1
ISELAC> LAYER RESET
LAYER selection reset
ISELAC> SHOW
Current AC is GASPIPE
AC selection is by:
ISELAC>
SHOW COMMAND
SHOW
FORMAT: SHOW
Command parameters: None.
DESCRIPTION:
Warning messages: None.
Examples:
ISELAC>
ISELAC> SHOW
Current AC is GASPIPE
AC selection is by:
TYPE including: 2 to 2
YEAR including: 1908 to 1990
PRESSURE including: 10 to 100
PRESSURE including: 110 to 120
SKELETON COMMAND
SKELETON
FORMAT: SKELETON skeleton-file-spec
Command parameters:
DESCRIPTION:
Warning messages:
Examples:
ISELAC>
ISELAC> SKELETON
%ISELAC-W-NOSKFILNAM, no skeleton filename specified
ISELAC> SKELETON AIQWUERO
%ISELAC-W-ERROPSKL, error opening skeleton file "LSL$LOOKUP:AIQWUERO.DAT"
-LSLLIB-E-NOSUCHFILE, file cannot be found
ISELAC> SKELETON ME:LOGIN.COM
%ISELAC-I-OPNSKL, Skeleton file ME:LOGIN.COM opened for input
%ISELAC-E-UNRECLIN, unrecognised line 1 in skeleton file
$! Personal LOGIN.COM file
%ISELAC-I-OPNSKL, Skeleton file dua0:[imp.iselac]acskel.dat opened for input
ISELAC>
TO COMMAND
TO
FORMAT: TO file-spec
Command parameters:
DESCRIPTION:
Warning messages:
ERRPARFIL, error parsing filename
NOFILNAM, no filename supplied
Examples:
ISELAC> TO
%ISELAC-W-NOFILENAM, no filename specified
ISELAC> TO LSL$DISK:[LSL.TEST]RCONT_SEL
%LSLLIB-I-IFFOPENED, LSL$DISK:[LSL.TEST]RCONT_SEL.IFF opened for write
ISELAC> TO qwe-uu--;
%ISELAC-W-ERRPARFIL, error parsing filename "qwe-uu--;"
_? COMMAND
_?
FORMAT: _AC NAME ?
Command parameters: None.
DESCRIPTION:
Warning messages: None.
Examples:
ISELAC> gas ?
type? 3
%ISELAC-W-INVVALSPEC, invalid value specified for attribute "TYPE"
Valid range for TYPE is 0 to 2
type? 2
year of installation? 1908:1990
pressure? 10:100 AND 110:120
depth (ms)?
ISELAC>
ISELAC> SHOW
Current AC is GASPIPE
AC selection is by:
TYPE including: 2 to 2
YEAR including: 1908 to 1990
PRESSURE including: 10 to 100
PRESSURE including: 110 to 120
ISELAC>
_EXAMPLES
--------------------------------------------------------------------------------
EXAMPLES
$ ISELAC
%ISELAC-I-OPNSKL, Skeleton file LSL$LOOKUP:ACSKEL.DAT opened for input
ISELAC> FROM 153NW.IFF
$ ISELAC
!
! Skeleton file to select type 160 AC's
!
ROAD
160 integer notext
!
_MESSAGES
MESSAGES (INFORMATIONAL)
--------------------------------------------------------------------------------
ATTRNAMSEL, 'ATTRIBUTE name' selected
LAYCOP, layer 'integer' will be copied
LAYPROC, layer 'integer' will be processed
LAYSKIP, layer 'integer' will be skipped
OPNSKL, skeleton file 'file-spec' opened for input
MESSAGES (WARNING)
AMBIGCMD, ambiguous between 'cmd1' and 'cmd2'
ERROPSKL, error opening skeleton file 'file-spec'
ERRPARFIL, error parsing filename 'file-spec'
ERRRDSK, error reading AC skeleton file
ERRSPECARG, error specifying attribute argument
MISSVALCMD, missing value on command line
INFILNOSPEC, input file not specified
INVALFSN, invalid value for FSN specified
INVALLAY, invalid value for LAYER specified
INVALRESET, invalid use of RESET command
INVVALSPEC, invalid value specified for attribute 'attrib'
NOFILNAM, no filename specified
NOSKFILNAM, no skeleton filename specified
OUTFILNOSPEC, output file not specified
TOOMANLIM, too many limits specified
UNRECCMDAC, unrecognised command or AC name 'cmd'
UNEXPEOCL, unexpected end of command line
MESSAGES (ERROR)
--------------------------------------------------------------------------------
ADDNAMERR, error adding name to command tables
ERROPCMD, error opening command tables
ERRRDACNAM, error reading AC name in skeleton file, line 'integer'
FTOREPTONV, failed to reposition to non-void entry
IDNTABS, identifier absent in skeleton file, line 'integer'
IDNTNTCLO, identifier not closed in skeleton file, line 'integer'
IDNTOOLNG, identifier too long in skeleton file, line 'integer'
INCOMPFLD, incomplete field in skeleton file, line 'integer'
INVACTYP, invalid AC type in skeleton file, line 'integer'
INVALTXT, invalid text entry in skeleton file, line 'integer'
INVALFRMT, invalid format in skeleton file, line 'integer'
INVALKYWD, invalid keyword in skeleton file, line 'integer'
INVALRNG, invalid range in skeleton file, line 'integer'
NOSELFND, no selected items found in input file
PRMTNTCLO, prompt not closed in skeleton file, line 'integer'
PRMTOOLNG, prompt too long in skeleton file, line 'integer'
RNGNTCLO, range not closed in skeleton file, line 'integer'
UNEXPEOF, unexpected end of input IFF file
UNRECLIN, unrecognised line 'integer' in skeleton file
MESSAGES (OTHER)