--------------------------------------------------------------------------------
MODULE DTI2DTED

UTILITY DTI2DTED

--------------------------------------------------------------------------------
REPLACES MCE utility DTI2DTED

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

FUNCTION

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

FORMAT

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

COMMAND QUALIFIERS

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

DTI2DTED COMMAND DEFAULTS.

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

DESCRIPTION

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

DTI2DTED COMMANDS

_@ COMMAND

--------------------------------------------------------------------------------
_@

--------------------------------------------------------------------------------
FORMAT: _@file-spec<CR>

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

DTI2DTED offers the facility of command input from an indirect command file. The '@' character preceding a file-spec will cause DTI2DTED to open and read commands from the specified file until:

Nested command files are not supported (i_.e_. a command file containing an '@' command), although sequential '@' commands are supported when read from SYS$COMMAND.

As an aid to batch log interpretation, DTI2DTED will echo all commands read from an indirect command file.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the _@ command:

*** WARNING *** "@" must precede a file-spec

*** WARNING *** Unexpected end of indirect command file detected
RETURN command assumed - returning to terminal input

*** ERROR *** Can't open indirect command file 'file-spec'

--------------------------------------------------------------------------------
Examples:


$ DTI2DTED<CR>
DTMCONVERT module DTI2DTED of 13:30:39 10-FEB-88
DTI2DTED> @PRESETS<CR>
DTI2DTED> ENABLE DIAGNOSTICS
DTI2DTED> RETURN
DTI2DTED>

_! COMMAND

--------------------------------------------------------------------------------
_!

--------------------------------------------------------------------------------
FORMAT: _! [comment text]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

An exclamation mark is the standard DTM package comment delimiter. All text (and numbers) which lie to the right of a '!' character are excluded from command interpretation. Comments are useful for annotating command procedures used in batch processing etc_.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


DTI2DTED> _! a comment for the sake of it<CR>
DTI2DTED>


$ TYPE PRESETS.COM<CR>
_! This is an indirect command file to set up
_! site specific defaults for DTI2DTED.
_!
ENABLE DIAGNOSTICS
DEVICE MSA2:
RETURN
$

APPEND COMMAND

--------------------------------------------------------------------------------
APPEND

--------------------------------------------------------------------------------
FORMAT: APPEND

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The APPEND command specifies that the magnetic tape is to be positioned at the end of existing data before writing the first file onto it. This allows new files to be appended to the end of the tape.

By default, when the first FILEIN command is given, DTI2DTED will rewind and initialise the magnetic tape. If this action is not required the APPEND command should be given prior to the first FILEIN command.

If the APPEND command is given the first FILEIN command will cause DTI2DTED to find (searching from the beginning of the tape) and then position the write head between the two tapemarks at the end of the tape. All DTI files supplied using FILEIN commands will be formatted and appended to the end of the tape.

Remember, unless the APPEND command is given, DTI2DTED will overwrite and destroy any data previously on the tape.

--------------------------------------------------------------------------------
Messages:_None.

--------------------------------------------------------------------------------
Examples:


DTI2DTED> DEVICE MSA0:<CR>
DTI2DTED> APPEND<CR>
DTI2DTED>

DENSITY COMMAND

--------------------------------------------------------------------------------
DENSITY

--------------------------------------------------------------------------------
FORMAT: DENSITY integer

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DEVICE command enables the user to specify the density at which DTI2DTED will write the magnetic tape. The command must be given before any DEVICE, APPEND, or FILEIN commands.

By default DTI2DTED will write at 1600bpi.

The available densities are 800, 1600, and 6250. This command will only have any effect if the particular tape drive supports the given density, and allows the density to be set by software.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the DENSITY command:

*** WARNING *** Density cannot be changed after tape has been initialised

*** WARNING *** Invalid density - 'integer'
Available DENSITY numbers are: 800 1600 6250

--------------------------------------------------------------------------------
Examples:


DTI2DTED> DENSITY 6250<CR>

DEVICE COMMAND

--------------------------------------------------------------------------------
DEVICE

--------------------------------------------------------------------------------
FORMAT: DEVICE type

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DEVICE command enables the user to specify the type of magnetic tape drive that DTI2DTED is to write to.

By default DTI2DTED will attempt to write to MTA0:.

Whatever the device type, it should be allocated, and the tape should be physically loaded and mounted foreign before attempting to write to it using DTI2DTED.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the DEVICE command:

*** WARNING *** You have already specified a magnetic tape device

*** WARNING *** You must specify a magnetic tape device type to the DEVICE command

*** ERROR *** 'type' is not a known magnetic tape device

*** ERROR *** when reading magnetic tape device name

*** ERROR *** Tape is not mounted as foreign

--------------------------------------------------------------------------------
Examples:


$ ALLOCATE MSA0:<CR>
$ MOUNT/FOREIGN MSA0:<CR>
$ DTI2DTED<CR>
DTMCONVERT module DTI2DTED of 13:30:39 10-FEB-88
DTI2DTED> DEVICE MSA0:<CR>
DTI2DTED>

DISABLE DEBUG COMMAND

--------------------------------------------------------------------------------
DISABLE DEBUG

--------------------------------------------------------------------------------
FORMAT: DISABLE DEBUG

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE DEBUG allows the user to disable a previous ENABLE DEBUG command.

The ENABLE DEBUG and DISABLE DEBUG commands are reserved for Laser-Scan use. The output produced by the ENABLE DEBUG command is used only for diagnostic purposes and should be invoked by LSL software personnel only.

--------------------------------------------------------------------------------
Messages:

The following warning message is specific to the DISABLE DEBUG command:

*** WARNING *** You were not using DEBUG!

--------------------------------------------------------------------------------
Examples:


DTI2DTED> ENABLE DEBUG<CR>
DTI2DTED> DISABLE DEBUG<CR>
DTI2DTED>

DISABLE DIAGNOSTICS COMMAND

--------------------------------------------------------------------------------
DISABLE DIAGNOSTICS

--------------------------------------------------------------------------------
FORMAT: DISABLE DIAGNOSTICS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE DIAGNOSTICS allows the user to disable a previous ENABLE DIAGNOSTICS command.

DISABLE DIAGNOSTICS is the default at program startup.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


DTI2DTED> ENABLE DIAGNOSTICS<CR>
DTI2DTED> SHOW DIAGNOSTICS<CR>
Diagnostic printout selected
DTI2DTED> DISABLE DIAGNOSTICS<CR>
DTI2DTED> SHOW DIAGNOSTICS<CR>
Diagnostic printout suppressed
DTI2DTED>

DISABLE GRID COMMAND

--------------------------------------------------------------------------------
DISABLE GRID

--------------------------------------------------------------------------------
FORMAT: DISABLE GRID

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE GRID allows the user to disable a previous ENABLE GRID command.

By default GRID is disabled, i.e. the matrix intervals in the manuscripts on the tape are considered to be in geographical units.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


DTI2DTED> ENABLE GRID<CR>
DTI2DTED> SHOW GRID<CR>
GRID enabled - manuscripts expected in grid coordinates.
DTI2DTED> DISABLE GRID<CR>
DTI2DTED> SHOW GRID<CR>
GRID disabled - manuscripts expected in geographical coordinates.
DTI2DTED>

ENABLE DEBUG COMMAND

--------------------------------------------------------------------------------
ENABLE DEBUG

--------------------------------------------------------------------------------
FORMAT: ENABLE DEBUG

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The ENABLE DEBUG and DISABLE DEBUG commands are reserved for Laser-Scan use. The output produced by the ENABLE DEBUG command is used only for diagnostic purposes and should be invoked by LSL software personnel only.

--------------------------------------------------------------------------------
Message:

The following warning message is specific to the ENABLE DEBUG command:

*** WARNING *** You are already using DEBUG!

--------------------------------------------------------------------------------
Examples:


$ DTI2DTED<CR>
DTMCONVERT module DTI2DTED of 13:30:39 10-FEB-88
DTI2DTED> ENABLE DEBUG<CR>
DTI2DTED>

ENABLE DIAGNOSTICS COMMAND

--------------------------------------------------------------------------------
ENABLE DIAGNOSTICS

--------------------------------------------------------------------------------
FORMAT: ENABLE DIAGNOSTICS

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE DIAGNOSTICS allows the user to produce diagnostic printout.

By default DTI2DTED produces minimal printout. If however, the user wishes to receive indications of processing progress, and details of the DTI file processed, a diagnostic printout may be selected with the ENABLE DIAGNOSTICS command.

On a heavily loaded computer it may be reassuring to ENABLE DIAGNOSTICS for the conversion stage of DTI2DTED processing to indicate progress through the input data. Messages are issued indicating which input file is being read, the contents of all UHL1 type blocks, the percentage of the data currently processed, a summary of the DTI file, and the minimum and maximum Z values read.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


DTI2DTED> ENABLE DIAGNOSTICS<CR>
DTI2DTED> SHOW DIAGNOSTICS<CR>
Diagnostic printout selected
DTI2DTED> DISABLE DIAGNOSTICS<CR>
DTI2DTED> SHOW DIAGNOSTICS<CR>
Diagnostic printout suppressed
DTI2DTED>

ENABLE GRID COMMAND

--------------------------------------------------------------------------------
ENABLE GRID

--------------------------------------------------------------------------------
FORMAT: ENABLE GRID

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

The ENABLE GRID command causes UHL1 and LSLA (and the historical MIKE and ALVY) type DTI files to be translated into a GRID DTED tape file with zero-filled DSI and ACC blocks.

ENABLE GRID specifies that future manuscripts on the tape are in grid coordinates rather than geographicals.

By default GRID is disabled, i.e. the matrix intervals in the manuscripts on the tape are considered to be in geographical units.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:


DTI2DTED> ENABLE GRID<CR>
DTI2DTED> SHOW GRID<CR>
GRID enabled - manuscripts will be written in grid coordinates.
DTI2DTED> DISABLE GRID<CR>
DTI2DTED> SHOW GRID<CR>
GRID disabled - manuscripts will be written in geographical coordinates.
DTI2DTED>

EXIT COMMAND

--------------------------------------------------------------------------------
EXIT

--------------------------------------------------------------------------------
FORMAT: EXIT

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
Description:

The EXIT command causes DTI2DTED to close any open files and the program to terminate. If a file has already been written to tape, a second tape mark will be written after the file to indicate 'end of tape'.

(pressing the Ctrl and Z keys together) may also be used to exit from DTI2DTED.

An EXIT command at the end of an indirect command file, in lieu of a RETURN command, will exit the program without returning to terminal command input.

--------------------------------------------------------------------------------
Messages: None.

--------------------------------------------------------------------------------
Examples:

DTI2DTED> EXIT<CR>
ELAPSED: 00:00:20.04 CPU: 0:00:04.71 BUFIO: 281 DIRIO: 46 FAULTS: 263
_$

FILEIN COMMAND

--------------------------------------------------------------------------------
FILEIN

--------------------------------------------------------------------------------
FORMAT: FILEIN file-spec

--------------------------------------------------------------------------------
COMMAND PARAMETERS:

--------------------------------------------------------------------------------
DESCRIPTION:

The FILEIN command causes the specified DTI file to be opened and used for output to tape.

By default, when the first FILEIN command is given, DTI2DTED will rewind and initialise the magnetic tape. If this action is not required the APPEND command should be given prior to the first FILEIN command.

If the APPEND command is given the first FILEIN command will cause DTI2DTED to find and then position the write head between the two tapemarks at the end of the tape. All DTI files supplied using FILEIN commands will be formatted and appended to the end of the tape.

Remember, unless the APPEND command is given, DTI2DTED will overwrite and destroy any data previously on the tape.

After the first FILEIN command, unless the APPEND command was given, DTI2DTED will prompt for the reel 'number' to be inserted in the volume header label. The reel 'number' consists of up to 6 alphanumeric characters, and will be left justified and padded with spaces if less are given.

Unless the APPEND command was given the tape is now initialised.

DTI2DTED will now prompt for a 'file identifier' to be inserted in the HDR1 header label. The file identifier consists of up to 17 alpha characters, and will be left justified and padded with spaces if less are given. If no file identifier is supplied a default of 'UKMCETERRAIN' will be used.

If the DTI file is found to be of LSLA (MIKE or ALVY) type, then the program prompts for the longitude and latitude of the origin (SW corner) of the map. These must be typed in in the format in which they appear on the DTED tape i.e. DDDMMSSH where H is a hemisphere letter (W, E, S, N).

Second and subsequent DTI files supplied by FILEIN commands within a single run of DTI2DTED are formatted and written to the tape sequentially. They are automatically appended to the first new manuscript written.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the FILEIN command:

*** WARNING *** You must specify a file-spec argument to the FILEIN command.

*** ERROR *** Unable to interpret output file-spec

--------------------------------------------------------------------------------
Examples:


DTI2DTED> DEVICE MSA0:<CR> ! select MSA0: for output
DTI2DTED> APPEND<CR> ! append to end of tape
DTI2DTED> FILEIN DUA3:[DEMONSTRATION.DTI]IDAHO<CR>
DTI file DUA3:[DEMONSTRATION.DTI]IDAHO.DTI;2 opened for reading

HELP COMMAND

--------------------------------------------------------------------------------
HELP

--------------------------------------------------------------------------------
FORMAT: HELP subject

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
Description:

The HELP command looks the rest of the line up in the DTMCONVERT HELP library. This library contains a brief summary of the operation of each command.

The information is looked up in the DTI2DTED section of the DTMCONVERT help library, LSL$HELP:DTMCONVERT.HLB.

--------------------------------------------------------------------------------
Messages:

Where required, warning messages are output via the VMS LBR$OUTPUT_HELP utility.

--------------------------------------------------------------------------------
Examples:


DTI2DTED> HELP ENABLE GRID<CR>

DTI2DTED

ENABLE

GRID


DTI2DTED>

RETURN COMMAND

--------------------------------------------------------------------------------
RETURN

--------------------------------------------------------------------------------
FORMAT: RETURN

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Restores command input from an indirect file to SYS$COMMAND.

A typical application is to allow the user to use an indirect command file to set up those run time defaults which are constant within a flowline and then return to input from the terminal (or batch stream) for the run specific commands. To do this RETURN must be the last command in the indirect command file.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the RETURN command:

RETURN command detected - returning to terminal input

RETURN command ignored - command input is already from terminal

--------------------------------------------------------------------------------
Examples:


DTI2DTED> @FLOW2<CR>
DTI2DTED> ENABLE DIAGNOSTICS
DTI2DTED> RETURN
RETURN command detected - returning to terminal input
DTI2DTED>

SHOW COMMAND

--------------------------------------------------------------------------------
SHOW

--------------------------------------------------------------------------------
FORMAT: SHOW subject

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

SHOW enables the user to examine the current status of the DTI2DTED defaults. Defaults may be examined either singly by specifying the name of the item of interest (eg SHOW DIAGNOSTICS will give the current status of diagnostic printout) or collectively by using the SHOW DEFAULTS command.

--------------------------------------------------------------------------------
Messages:

The following message is specific to the SHOW command:

*** WARNING *** Invalid qualifier

Available SHOW command qualifiers are:
DEBUG      DEFAULTS      DEVICE       DIAGNOSTICS
GRID       FILEIN

--------------------------------------------------------------------------------
Examples:

   .
   .
DTED2DTI> SHOW DIAGNOSTICS
DIAGNOSTICS:
Diagnostic printout suppressed
DTED2DTI> ENABLE DIAGNOSTICS
DTED2DTI> SHOW DEFAULTS<CR>
Current defaults are:
DEBUG:
Debug printout selected
DEVICE:
Tapedeck MTA0: at 1600bpi selected for output of DTED data
                                                           
DIAGNOSTICS:
Diagnostic printout selected
GRID:
GRID disabled - manuscripts will be written in geographical coordinates
FILEIN:
DTI file LSL$DTI:FRED.DTI;0 selected for input

DTED2DTI>

SPAWN COMMAND

--------------------------------------------------------------------------------
SPAWN

--------------------------------------------------------------------------------
FORMAT: SPAWN command-line

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The SPAWN command enables you to create a subprocess while within DTI2DTED. When the subprocess terminates control is returned to DTI2DTED.

--------------------------------------------------------------------------------
Messages:

The following warning messages are specific to the SPAWN command:

*** WARNING *** SPAWN requires a valid DCL command line

*** ERROR *** Unable to spawn command, returning to DTI2DTED

--------------------------------------------------------------------------------
Examples:


DTI2DTED> SPAWN DIRECTORY *_.DTI;*<CR>

Directory DUA3:[DTMPROCESS.ACCEPTANCE_TESTS]
TEST1_.DTI;1              8/8       10-FEB-1988 07:56  [LSL,TIM]
TEST2_.DTI;2              7/8       10-FEB-1988 17:17  [LSL,TIM]
TEST2_.DTI;1              7/8       10-FEB-1988 17:07  [LSL,TIM]
Total of 3 files, 22/24 blocks.

DTI2DTED>

DTI2DTED EXAMPLES

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

EXAMPLES

EXAMPLES

$ 
$ ALLOCATE MUB0:
%DCL-I-ALLOC, _$MUB0: allocated
$ MOUNT/FOREIGN MUB0:
%MOUNT-I-MOUNTED, A mounted on _$MUB0:
$ RUN DTI2DTED
DTMCONVERT module DTI2DTED of 22:27:16  2-JUN-88
DTI2DTED> SHOW DEFAULTS
Current defaults are:
DEBUG:
Debug printout suppressed
DEVICE:
Tapedeck MTA0: at 1600bpi selected for output of DTED data
DIAGNOSTICS:
Diagnostic printout suppressed
FILEIN:
DTI input file not yet specified
GRID:
GRID disabled - manuscripts will be written in geographical coordinates
DTI2DTED> DEVICE MUB0:
Magnetic tape device MUB0: opened for writing
DTI2DTED> FILEIN FRANK_TED4_40
File    :  LSL$DTI:FRANK_TED4_40.DTI;0
Header  :  DTED  Data:  WORD
Units are Degrees, Minutes, Seconds
Matrix Origin       :  56 36 00N    5 15 00W  
Matrix Coverage   SW:  56 36 00N    5 15 00W   NE:  56 36 39N    5 13 42W  
Matrix Interval    E:          2                N:          1
Value Range         :   179   to    559
Reel number (6 characters): ABCDEF
Producing a change 4 DTED tape file
File ident (def:UKMCETERRAIN     ): 
DTI2DTED> ENABLE DIAGNOSTICS
DTI2DTED> FILEIN FRANK_UHL1_1
File    :  LSL$DTI:FRANK_UHL1_1.DTI;0
Header  :  UHL1  Data:  WORD
Units are Degrees, Minutes, Seconds
Matrix Origin       :  52 00 00S   58 00 00W  
Matrix Coverage   SW:  52 00 00S   58 00 00W   NE:  51 58 41S   57 57 22W  
Matrix Interval    E:          2                N:          1
Value Range         :     0   to     61
Producing a change 2 DTED tape file
File ident (def:UKMCETERRAIN     ): TEST_DATA
*** WARNING ***  Invalid file identifier
File ident (def:UKMCETERRAIN     ): TESTDATA
UHL10580000W0520000S002000100000000            00800080                         
10 % complete
20 % complete
30 % complete
40 % complete
50 % complete
60 % complete
70 % complete
80 % complete
90 % complete
100 % complete
DTI2DTED> DEVICE MUB0:
*** WARNING ***  You have already specified a magnetic tape device
DTI2DTED> EXIT
 ELAPSED:    0 00:05:36.97  CPU: 0:00:00.97  BUFIO: 100  DIRIO: 141  FAULTS: 100 
$DISMOUNT MUB0:
$DEALLOCATE MUB0:
$
--------------------------------------------------------------------------------

DTI2DTED messages

See dti2dtedmsg.html generated from DTI2DTEDMSG.RNO.