--------------------------------------------------------------------------------
MODULE DTED2DTI

UTILITY DTED2DTI

--------------------------------------------------------------------------------
REPLACES MCE utility DTEDIN

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

FUNCTION

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

FORMAT

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

COMMAND QUALIFIERS

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

DTED2DTI COMMAND DEFAULTS.

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

DESCRIPTION

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

DTED2DTI COMMANDS

_@ COMMAND

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

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

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

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

DTED2DTI offers the facility of command input from an indirect command file. The '@' character preceding a file-spec will cause DTED2DTI 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 DTED2DTI 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

*** WARNING *** Indirect file error - returning to terminal input

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

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


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

_! 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:


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


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

DEVICE COMMAND

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

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

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

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

The DEVICE command enables the user to specify the type of magnetic tape drive that DTED2DTI is to read from. By default DTED2DTI will attempt to read from MTA0:.

Whatever the device type, it should be allocated to the user, the tape should be physically loaded and mounted foreign before attempting to read from it using DTED2DTI.

--------------------------------------------------------------------------------
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>
$ DTED2DTI<CR>
DTMCONVERT module DTED2DTI of 13:30:39 10-FEB-88
DTED2DTI> DEVICE MSA0:<CR>
DTED2DTI>

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 program debugging purposes and should be invoked by LSL software personnel only.

DISABLE DEBUG is the default at program startup.

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

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

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

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


DTED2DTI> ENABLE DEBUG<CR>
DTED2DTI> DISABLE DEBUG<CR>
DTED2DTI>

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:


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

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:


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

DISABLE PME COMMAND

--------------------------------------------------------------------------------
DISABLE PME

--------------------------------------------------------------------------------
FORMAT: DISABLE PME

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

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

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

DISABLE PME is the default at program startup.

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

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

*** WARNING *** You were not using PME !

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


DTED2DTI> ENABLE PME<CR>
DTED2DTI> DISABLE PME<CR>
DTED2DTI>

DISABLE FULL COMMAND

--------------------------------------------------------------------------------
DISABLE FULL

--------------------------------------------------------------------------------
FORMAT: DISABLE FULL

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

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

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

By default FULL is disabled, i.e. geographical extents will be based on the MBR.

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

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


DTED2DTI> ENABLE FULL<CR>
DTED2DTI> SHOW FULL<CR>
FULL enabled - a full one degree square will be constructed
DTED2DTI> DISABLE FULL<CR>
DTED2DTI> SHOW FULL<CR>
FULL disabled - geographical extents will be based on the MBR.
DTED2DTI>

EASTING COMMAND

--------------------------------------------------------------------------------
EASTING

--------------------------------------------------------------------------------
FORMAT: EASTING grid-X

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

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

The EASTING command causes DTED2DTI to search for a manuscript by its origin, and output it when it is found. The EASTING command may be issued on its own, or (on the same command line) in combination with the NORTHING command.

If the EASTING command is issued on its own (i.e. without an accompanying NORTHING command on the line) then the first manuscript found on the tape with a matching origin easting will be read and written to the DTI file opened with the FILEOUT command. The origin northing is thus treated as a wildcard.

The EASTING command requires the grid option to be enabled. As this is disabled by default on program startup, an ENABLE GRID command must be given before the EASTING command.

The default is to start searching with the next manuscript on the tape. Search is forwards, so to access a manuscript written on the tape earlier than the last one read, the REWIND command must be used.

The EASTING command will not be accepted until a successful FILEOUT command has been executed. The FILEOUT command causes a specified DTI file to be opened and used for output from DTED2DTI.

By default DTED2DTI will attempt to read from MTA0:, unless an alternative magnetic tape device has been specified using the DEVICE command.

After each EASTING command the DTI file opened with the FILEOUT command will be closed. A new FILEOUT command must be issued before another EASTING command will be accepted.

Note that if the MANUSCRIPT command is used on a command line, the EASTING and NORTHING commands may not be specified on that same command line.

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

The following messages are specific to the EASTING command:

*** WARNING *** You must give a FILEOUT command for the next manuscript

*** WARNING *** You cannot use the EASTING command with GRID disabled

*** WARNING *** Manuscript with required easting not found

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


$ ALLOCATE MSA0:<CR>
$ MOUNT/FOREIGN MSA0:<CR>
$ DTED2DTI<CR>
DTMCONVERT module DTED2DTI of 13:30:39 10-FEB-88
DTED2DTI> DEVICE MSA0:<CR>
DTED2DTI> FILEOUT DUA3:[DEMONSTRATION]SW12.DTI<CR>
DTI file DUA3:[DEMONSTRATION]SW12.DTI;2 opened for write
DTED2DTI> ENABLE GRID<CR>
DTED2DTI> EASTING 123<CR>
DTED2DTI> REWIND<CR>
DTED2DTI> FILEOUT DUA3:[DEMONSTRATION]SW15.DTI<CR>
DTI file DUA3:[DEMONSTRATION]SW15.DTI;1 opened for write
DTED2DTI> EASTING 345 NORTHING 765<CR>
DTED2DTI> EXIT<CR>
_$

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:


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

ENABLE DIAGNOSTICS COMMAND

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

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

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

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

ENABLE DIAGNOSTICS allows the user to produce diagnostic printout.

By default DTED2DTI produces minimal printout. If however, the user wishes to receive indications of processing progress, and details of the DTI file produced, 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 DTED2DTI 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:


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

ENABLE GRID COMMAND

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

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

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

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

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

The effects of this are that the matrix intervals from the tape are already in grid units, and are not converted. The origin in the tape UHL record is taken to be in grid units, as is the origin in EASTING or NORTHING commands. No attempt is made to read the SW corner of the bounding rectangle from the DSI record. A UHL1 format DTI file is produced, discarding any DSI and ACC records.

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:


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

ENABLE PME COMMAND

--------------------------------------------------------------------------------
ENABLE PME

--------------------------------------------------------------------------------
FORMAT: ENABLE PME

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

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

The ENABLE PME and DISABLE PME commands are reserved for Laser-Scan use. PME is a code optimisation tool and should be invoked by LSL software personnel only.

ENABLE PME causes the PME_INIT routine to be invoked.

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

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

*** WARNING *** You are already using PME!

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


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

ENABLE PME COMMAND

--------------------------------------------------------------------------------
ENABLE FULL

--------------------------------------------------------------------------------
FORMAT: ENABLE FULL

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

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

ENABLE FULL forces construction of a 1 degree square. This helps makes it possible to process DTED manuscripts which have missing or truncated profiles.

By default FULL is disabled, i.e. geographical extents will be based on the MBR.

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

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


DTED2DTI> ENABLE FULL<CR>
DTED2DTI> SHOW FULL<CR>
FULL enabled - a full one degree square will be constructed
DTED2DTI> DISABLE FULL<CR>
DTED2DTI> SHOW FULL<CR>
FULL disabled - geographical extents will be based on the MBR.
DTED2DTI>

EXIT COMMAND

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

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

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

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

The EXIT command causes DTED2DTI to close any open files and the program is terminated.

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

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:

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

FILEOUT COMMAND

--------------------------------------------------------------------------------
FILEOUT

--------------------------------------------------------------------------------
FORMAT: FILEOUT file-spec

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

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

The FILEOUT command causes the specified DTI file to be opened and used for output from DTED2DTI. A FILEOUT command must be issued before the MANUSCRIPT, LATITUDE or LONGITUDE, EASTING or NORTHING commands will be accepted.

After each MANUSCRIPT, LATITUDE or LONGITUDE, EASTING or NORTHING command the DTI file opened with the FILEOUT command will be closed. A new FILEOUT command must be issued before another MANUSCRIPT, LATITUDE or LONGITUDE, EASTING or NORTHING command will be accepted.

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

The following messages are specific to the FILEOUT command:

*** WARNING *** You have already issued a FILEOUT command for the next manuscript

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

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

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


DTED2DTI> FILEOUT DUA3:[DEMONSTRATION.DTI]IDAHO<CR>
DTI file DUA3:[DEMONSTRATION]IDAHO.DTI;1 opened for write
DTED2DTI> MANUSCRIPT 3<CR>
DTED2DTI>

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 DTED2DTI 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:


DTED2DTI> HELP ENABLE PME<CR>

DTED2DTI

ENABLE

PME


DTED2DTI>

LATITUDE COMMAND

--------------------------------------------------------------------------------
LATITUDE

--------------------------------------------------------------------------------
FORMAT: LATITUDE [D]D [MM] [SS] H

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

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

The LATITUDE command causes DTED2DTI to search for a manuscript by its origin, and output it when it is found. The LATITUDE command may be issued on its own, or (on the same command line) in combination with the LONGITUDE command.

If the LATITUDE command is issued on its own (i.e. without an accompanying LONGITUDE command on the line) then the first manuscript found on the tape with a matching origin latitude will be read and written to the DTI file opened with the FILEOUT command. The origin longitude is thus treated as a wildcard.

The LATITUDE command can only be used if the GRID option has been disabled (the default on program startup). If the ENABLE GRID command has been given, then disable GRID with the DISABLE GRID command or use the EASTING and/or NORTHING commands if the manuscript origin is held in grid units.

The default is to start searching with the next manuscript on the tape. Search is forwards, so to access a manuscript written before the current reading position on the tape, the REWIND command must be used.

The LATITUDE command will not be accepted until a successful FILEOUT command has been executed. The FILEOUT command causes a specified DTI file to be opened and used for output from DTED2DTI.

By default DTED2DTI will attempt to read from MTA0:, unless an alternative magnetic tape device has been specified using the DEVICE command.

After each LATITUDE command the DTI file opened with the FILEOUT command will be closed. A new FILEOUT command must be issued before another LATITUDE command will be accepted.

Note that if the MANUSCRIPT command is used on a command line, the LATITUDE and LONGITUDE commands may not be specified on that same command line.

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

The following messages are specific to the LATITUDE command:

*** WARNING *** You must give a FILEOUT command for the next manuscript

*** WARNING *** You cannot use a LATITUDE command with GRID enabled

*** WARNING *** Manuscript with required latitude not found

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


$ ALLOCATE MSA0:<CR>
$ MOUNT/FOREIGN MSA0:<CR>
$ DTED2DTI<CR>
DTMCONVERT module DTED2DTI of 13:30:39 10-FEB-88
DTED2DTI> DEVICE MSA0:<CR>
DTED2DTI> FILEOUT DUA3:[DEMONSTRATION]SW12.DTI<CR>
DTI file DUA3:[DEMONSTRATION]SW12.DTI;2 opened for write
DTED2DTI> LATITUDE 334557N<CR>
DTED2DTI> REWIND<CR>
DTED2DTI> FILEOUT DUA3:[DEMONSTRATION]SW15.DTI<CR>
DTI file DUA3:[DEMONSTRATION]SW15.DTI;1 opened for write
DTED2DTI> LATITUDE 334527N LONGITUDE 1475930W<CR>
DTED2DTI> EXIT<CR>
_$

LONGITUDE COMMAND

--------------------------------------------------------------------------------
LONGITUDE

--------------------------------------------------------------------------------
FORMAT: LONGITUDE [DD]D [MM] [SS] H

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

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

The LONGITUDE command causes DTED2DTI to search for a manuscript by its origin, and output it when it is found. The LONGITUDE command may be issued on its own, or (on the same command line) in combination with the LATITUDE command.

If the LONGITUDE command is issued on its own (i.e. without an accompanying LATITUDE command on the line) then the first manuscript found on the tape with a matching origin longitude will be read and written to the DTI file opened with the FILEOUT command. The origin latitude is thus treated as a wildcard.

The LONGITUDE command can only be used if the GRID option has been disabled (the default on program startup). If the ENABLE GRID command has been given, then disable GRID with the DISABLE GRID command or use the EASTING and/or NORTHING commands if the manuscript origin is held in grid units.

The default is to start searching with the next manuscript on the tape. Search is forwards, so to access a manuscript written before the current reading position on the tape, the REWIND command must be used.

The LONGITUDE command will not be accepted until a successful FILEOUT command has been executed. The FILEOUT command causes a specified DTI file to be opened and used for output from DTED2DTI.

By default DTED2DTI will attempt to read from MTA0:, unless an alternative magnetic tape device has been specified using the DEVICE command.

After each LONGITUDE command the DTI file opened with the FILEOUT command will be closed. A new FILEOUT command must be issued before another LONGITUDE command will be accepted.

Note that if the MANUSCRIPT command is used on a command line, the LATITUDE and LONGITUDE commands may not be specified on that same command line.

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

The following messages are specific to the LONGITUDE command:

*** WARNING *** You must give a FILEOUT command for the next manuscript

*** WARNING *** You cannot use a LONGITUDE command with GRID enabled

*** WARNING *** Manuscript with required longitude not found

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


$ ALLOCATE MSA0:<CR>
$ MOUNT/FOREIGN MSA0:<CR>
$ DTED2DTI<CR>
DTMCONVERT module DTED2DTI of 13:30:39 10-FEB-88
DTED2DTI> DEVICE MSA0:<CR>
DTED2DTI> FILEOUT DUA3:[DEMONSTRATION]SW12.DTI<CR>
DTI file DUA3:[DEMONSTRATION]SW12.DTI;2 opened for write
DTED2DTI> LONGITUDE 1475930W<CR>
DTED2DTI> REWIND<CR>
DTED2DTI> FILEOUT DUA3:[DEMONSTRATION]SW15.DTI<CR>
DTI file DUA3:[DEMONSTRATION]SW15.DTI;1 opened for write
DTED2DTI> LATITUDE 334527N LONGITUDE 1475930W<CR>
DTED2DTI> EXIT<CR>
_$

MANUSCRIPT COMMAND

--------------------------------------------------------------------------------
MANUSCRIPT

--------------------------------------------------------------------------------
FORMAT: MANUSCRIPT [number]

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

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

The MANUSCRIPT command enables the user to specify which manuscript (file) is to be read from the magnetic tape.

The optional MANUSCRIPT argument is a positive integer that identifies which manuscript (file) on the tape to read (where the first manuscript is numbered 1, etc). The default is always the next manuscript on the tape. Search is forwards, so to access a manuscript with a lower number than the last one read, the REWIND command must be used.

The MANUSCRIPT command will not be accepted until a successful FILEOUT command has been executed. The FILEOUT command causes a specified DTI file to be opened and used for output from DTED2DTI.

By default DTED2DTI will attempt to read from MTA0:, unless an alternative magnetic tape device has been specified using the DEVICE command.

After each MANUSCRIPT command the DTI file opened with the FILEOUT command will be closed. A new FILEOUT command must be issued before another MANUSCRIPT command will be accepted.

Note that if the MANUSCRIPT command is used on a command line, the LATITUDE, LONGITUDE, EASTING and NORTHING commands may not be specified on that same command line.

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

The following messages are specific to the MANUSCRIPT command:

*** WARNING *** You must give a FILEOUT command for the next manuscript

*** WARNING *** Manuscript 'number' not found - only 'n' manuscripts on the tape

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


$ ALLOCATE MSA0:<CR>
$ MOUNT/FOREIGN MSA0:<CR>
$ DTED2DTI<CR>
DTMCONVERT module DTED2DTI of 13:30:39 10-FEB-88
DTED2DTI> DEVICE MSA0:<CR>
DTED2DTI> FILEOUT DUA3:[DEMONSTRATION]SW12.DTI<CR>
DTI file DUA3:[DEMONSTRATION]SW12.DTI;2 opened for write
DTED2DTI> MANUSCRIPT 3<CR>
DTED2DTI> REWIND<CR>
DTED2DTI> FILEOUT DUA3:[DEMONSTRATION]SW15.DTI<CR>
DTI file DUA3:[DEMONSTRATION]SW15.DTI;1 opened for write
DTED2DTI> MANUSCRIPT 2<CR>
DTED2DTI> EXIT<CR>
_$

NORTHING COMMAND

--------------------------------------------------------------------------------
NORTHING

--------------------------------------------------------------------------------
FORMAT: NORTHING grid-Y

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

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

The NORTHING command causes DTED2DTI to search for a manuscript by its origin, and output it when it is found. The NORTHING command may be issued on its own, or (on the same command line) in combination with the EASTING command.

If the NORTHING command is issued on its own (i.e. without an accompanying EASTING command on the line) then the first manuscript found on the tape with a matching origin northing will be read and written to the DTI file opened with the FILEOUT command. The origin easting is thus treated as a wildcard.

The NORTHING command requires the grid option to be enabled. As this is disabled by default on program startup, an ENABLE GRID command must be given before the NORTHING command.

The default is to start searching with the next manuscript on the tape. Search is forwards, so to access a manuscript written on the tape earlier than the last one read, the REWIND command must be used.

The NORTHING command will not be accepted until a successful FILEOUT command has been executed. The FILEOUT command causes a specified DTI file to be opened and used for output from DTED2DTI.

By default DTED2DTI will attempt to read from MTA0:, unless an alternative magnetic tape device has been specified using the DEVICE command.

After each NORTHING command the DTI file opened with the FILEOUT command will be closed. A new FILEOUT command must be issued before another NORTHING command will be accepted.

Note that if the MANUSCRIPT command is used on a command line, the NORTHING and EASTING commands may not be specified on that same command line.

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

The following messages are specific to the NORTHING command:

*** WARNING *** You must give a FILEOUT command for the next manuscript

*** WARNING *** You cannot use a NORTHING command with GRID disabled

*** WARNING *** Manuscript with required northing not found

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


$ ALLOCATE MSA0:<CR>
$ MOUNT/FOREIGN MSA0:<CR>
$ DTED2DTI<CR>
DTMCONVERT module DTED2DTI of 13:30:39 10-FEB-88
DTED2DTI> DEVICE MSA0:<CR>
DTED2DTI> FILEOUT DUA3:[DEMONSTRATION]SW12.DTI<CR>
DTI file DUA3:[DEMONSTRATION]SW12.DTI;2 opened for write
DTED2DTI> ENABLE GRID<CR>
DTED2DTI> NORTHING 123<CR>
DTED2DTI> REWIND<CR>
DTED2DTI> FILEOUT DUA3:[DEMONSTRATION]SW15.DTI<CR>
DTI file DUA3:[DEMONSTRATION]SW15.DTI;1 opened for write
DTED2DTI> EASTING 345 NORTHING 765<CR>
DTED2DTI> EXIT<CR>
_$

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:


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

REWIND COMMAND

--------------------------------------------------------------------------------
REWIND

--------------------------------------------------------------------------------
FORMAT: REWIND

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

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

The REWIND command enables the user to rewind the tape to the BOT (Beginning Of Tape) marker. DTED2DTI is then ready to read manuscript 1 again.

Unless an appropriate DEVICE command has been issued earlier, by default DTED2DTI will attempt to rewind a tape on MTA0:.

The tape should be allocated, physically loaded and mounted foreign before attempting to rewind it using DTED2DTI.

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

The following messages are specific to the REWIND command:

REWIND complete

*** ERROR *** whilst rewinding tape

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


DTED2DTI> DEVICE MSA0:<CR>
DTED2DTI> REWIND<CR>
REWIND complete
DTED2DTI>

SHOW COMMAND

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

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

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

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

SHOW enables the user to examine the current status of the DTED2DTI 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       FILEOUT       PME          FULL

--------------------------------------------------------------------------------
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: selected for input of DTED data
                                                           
DIAGNOSTICS:
Diagnostic printout selected
GRID:
GRID disabled - manuscripts expected in geographical coordinates
FILEOUT:
DTI file LSL$DTI:FRED.DTI;0 selected for output
PME:
PME not running

DTED2DTI>

SPAWN COMMAND

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

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

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

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

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

--------------------------------------------------------------------------------
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 DTED2DTI

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


DTED2DTI> 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.

DTED2DTI>

DTED2DTI EXAMPLES

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

EXAMPLES

EXAMPLES

$
$ ALLOCATE MUB0:
%DCL-I-ALLOC, _$MUB0: allocated
$ MOUNT/FOREIGN MUB0:
%MOUNT-I-MOUNTED, ABCDEF mounted on _$MUB0:
$ RUN DTED2DTI
DTMCONVERT module DTED2DTI of 22:20:13  2-JUN-88
DTED2DTI> DEVICE MUB0:
DTED2DTI> MANUSCRIPT 1
*** WARNING ***  You must give a FILEOUT command for the next manuscript
DTED2DTI> FILEOUT TEST_DATA
DTED2DTI> MANUSCRIPT 1
Reading from magnetic tape device MUB0:                         
Change 3/4 manuscript found
Writing a TED4 type DTI file to LSL$DTI:TEST_DATA.DTI;0
DTED2DTI> ENABLE DIAGNOSTICS
DTED2DTI> FILEOUT TEST_DATA_2
DTED2DTI> SHOW DEFAULTS
Current defaults are:
DEBUG:
Debug printout suppressed
DEVICE:
Tapedeck MUB0: selected for input of DTED data
DIAGNOSTICS:
Diagnostic printout selected
FILEOUT:
DTI file LSL$DTI:TEST_DATA_2.DTI;0 selected for output
GRID:
GRID disabled - manuscripts expected in geographical coordinates
PME:
PME not running
DTED2DTI> MANUSCRIPT
No manuscript number given - assuming manuscript 2 required
Reading from magnetic tape device MUB0:                         
UHL10580000W0520000S002000100000000            00800080                         
Change 2 manuscript found
Writing a UHL1 type DTI file to LSL$DTI:TEST_DATA_2.DTI;0
10 % complete
20 % complete
30 % complete
40 % complete
50 % complete
60 % complete
70 % complete
80 % complete
90 % complete
100 % complete
File    :  LSL$DTI:TEST_DATA_2.DTI;0
Header  :  UHL1  Data:  WORD
Units are Degrees, Minutes, Seconds
Matrix Origin       :  52 00 00S   58 00 00W  
Matrix Coverage   SW:   0 00 00N    0 00 00E   NE:   0 00 00N    0 00 00E  
Matrix Interval    E:          2                N:          1
Value Range         :-30134   to  22081
DTED2DTI> EXIT
 ELAPSED:    0 00:02:45.91  CPU: 0:00:01.05  BUFIO: 82  DIRIO: 152  FAULTS: 128 
$DISMOUNT MUB0:
$DEALLOCATE MUB0:
$

DTED2DTI messages

See dted2dtimsg.html generated from DTED2DTIMSG.RNO.