DEC DATATRIEVE provides a working interface to DECwindows
Motif. If you are working in a workstation environment and have
DECwindows Motif installed on your system, you can take advantage
of certain DECwindows Motif features that provide you with an
easy way to:
o Scroll through the content of your DEC DATATRIEVE session
o Invoke command files
o Open and close log sessions
o Navigate through the Oracle CDD/Repository dictionary
structure and perform expand, contract, edit, extract, show,
execute, and ready actions upon appropriate objects
o Set certain DEC DATATRIEVE setup parameters
o Display information on DEC DATATRIEVE objects and sources
in a separate Show window, which can remain on your screen
throughout your DEC DATATRIEVE session
o Display help on DEC DATATRIEVE-specific topics in a separate
DECterm window that can remain on your screen throughout your
DEC DATATRIEVE session
o Display DEC DATATRIEVE graphics in a separate DECterm window
that can remain on your screen throughout your DEC DATATRIEVE
session
For tutorial information on using the DECwindows Motif interface
to DEC DATATRIEVE, see the DEC DATATRIEVE DECwindows Motif Help
library.
1 – Invoking
Before you can invoke DEC DATATRIEVE in a DECwindows Motif
environment, you must be running DECwindows Motif software on
your workstation. You may also find that to run DEC DATATRIEVE
software on your workstation, the following conditions should be
met:
o The logical DECW$DISPLAY should be pointing to the node on
which you want to display DEC DATATRIEVE.
o The logical DTR$NOWINDOWS must be undefined or be assigned a
value other than true.
o The Security item of the Customize menu of your Session
Manager window should recognize the node on which you want
to display your DEC DATATRIEVE session.
These are described in more detail in the DEC DATATRIEVE Guide to
Interfaces or in the DECwindows Motif documentation.
You can then invoke DEC DATATRIEVE with either of the following
commands:
o The DCL command RUN SYS$SYSTEM:DTR32xx.EXE (where xx
represents the 1- to 26-character suffix appended at
installation). You can also use any symbols that you have
already defined to represent this command.
o The DATATRIEVE command. This command takes the following
format:
DATATRIEVE [qualifier [...]] ["DATATRIEVE-command-string"]
The optional qualifiers to the DATATRIEVE command include the
following:
/INTERFACE = {DECWINDOWS}
{CHARACTER_CELL}
Specifies the display interface to be used by DEC DATATRIEVE.
If your default environment is the command-line interface,
then CHARACTER_CELL is the default. If your system is properly
defined to invoke the DEC DATATRIEVE interface to DECwindows
Motif, the default is DECWINDOWS. This qualifier is useful
if you are working in a DECwindows Motif environment and
you want to submit a DEC DATATRIEVE command procedure from
a foreign command line. Normally if your system is defined
to invoke the DECwindows Motif interface and you try to
execute a DEC DATATRIEVE command from a foreign command
line, the DEC DATATRIEVE main application window appears on
your screen. By using the DCL DATATRIEVE command with the
/INTERFACE=CHARACTER_CELL qualifier, you can enter the command
on a foreign command line and the main application window will
not be displayed.
/[NO]DEBUG
Specifies whether DEC DATATRIEVE should display special debug
messages. The default is NODEBUG.
/VARIANT = image-suffix
Indicates the 1- to 26-character suffix applied to a DEC
DATATRIEVE image upon installation to uniquely identify that
image. This qualifier is needed only if you invoke a DEC
DATATRIEVE image that was not selected as the default image
at installation time. If the default image you are running
includes a suffix and you want to run an image that does not
include a suffix, use the /VARIANT qualifier alone, as in the
following example:
$ DATATRIEVE/VARIANT
The DCL DATATRIEVE command can also take a DEC DATATRIEVE command
or statement as an argument. This allows you to execute a DEC
DATATRIEVE command, statement, or procedure without entering
interactive DEC DATATRIEVE. If the DATATRIEVE-command-string
contains more than one word, it must be placed in quotation
marks.
You can abbreviate the DCL DATATRIEVE command to the shortest
form that is unique among other DCL commands.