The default installation procedure places the GDE utility into a directory assigned to the environment variable gtm_dist.

To invoke GDE:

from within GTM, use the command:


from the shell, enter:

$ mumps -r GDE

GDE displays informational messages like the following, and then the GDE> prompt:

%GDE-I-LOADGD, loading Global Directory file /prod/mumps.gld
%GDE-I-VERIFY, Verification OK

If this does not work, contact your system manager to investigate setup and file access issues.


Even when invoked from within GT.M, GDE always uses the gtmgbldir environment variable to identify its target

To leave GDE:

This section lists the parameters that apply to defining each component of a mapping.


The NAMES section contains mappings of M global name spaces. More than one name space can map to a single region but a single name space can only map to one region.

A name space:


The REGIONS section contain mappings of database region. A region is a logical structure that holds information about a portion of a database, such as key-size and record-size. A key is the internal representation of a global variable name. In this chapter the terms global variable name and key are used interchangeably. A record refers to a key and its data.

A Global Directory must have at least one region. A region only maps to a single segment. More than one name may map to a region.

A region name:

GDE automatically converts region names to uppercase, and uses DEFAULT for the default region name.


The SEGMENTS section contains mappings for segments. A segment defines file-related database storage characteristics. A segment must map to a single file. A segment can be mapped by only one region.

GT.M uses a segment to define a physical file and access method for the database stored in that file.

A segment-name:

GDE automatically converts segment names to uppercase. GDE uses DEFAULT for the default segment name.


Files are the structures provided by UNIX for the storage and retrieval of information. Files used by GT.M must be random-access files resident on disk.

By default, GDE uses the file-name mumps.dat for the DEFAULT segment. GDE adds the .dat to the file name when you do not specify an extension. Avoid non-graphic and punctuation characters with potential semantic significance to the file system in file names as they will produce operational difficulties.

loading table of contents...