
               GALGDB - Galacticomm Global Debug Utilities

    Copyright (c) 1994-1996 by Galacticomm, Inc. All Rights Reserved

Overview
--------

This Globals package gives the Sysop or Developer several powerful
debugging tools that can be used to obtain important status information
about thier system while only using a single Global socket. These
commands can only be executed by a Master key holder.

Installation
------------

Unzip the file GALGDB45.ZIP into a temporary directory. Make the
temporary directory current and type INSTALL.

The following files will be installed on your system:

     GALGDB.DLL          The GALGDB main module.
     GALGDB.TXT          The GALGDB documentation file.
     GALGDB.RLN          The GALDBG documentation file.
     GALGDB.MSG          The GALGDB message file.
     GALGDB.MDF          The GALGDB module definition file.

SETUP
-----

Once the files have been unzipped into the Worldgroup Server directory
you only need to restart the Worldgroup Server to make GALGDB active.

USAGE
-----

GALGDB is used just like any other global command.  Each command is
preceeded with the "/" (forward slash) character.

You must be logged into the system with a User-ID that has the Master Key
          to be able to use any of these commands.

COMMAND REFERENCE
-----------------

CAT
---

This command will force a CATASTRO error.  This command should obviously
be used with care.

Syntax:

    /CAT

CDST
----

This command returns channel device status information. This is for
Serial or Modem devices only.

Syntax:

    /CDST chan

    Where "chan" is the hexidecimal channel number of interest.

Response (typical):

    User:9 Chn:0 Port:2F8 Reg6:0 CD is Off. 16550 UART detected. Reg2:C1

GDB
---

This command simply outputs a short help file on the GALGDB commands.

Syntax:

    /GDB

GPME
----

This command will force a GP error.  This command should be used with
care.

Syntax:

    /GPME

HAN
---

This command is used to determine the number of free file handles you
currently have on your system.

Syntax:

    /HAN

Response (typical):

    Available File Handles: 67

LOG
---

This command logs all of the modules that have been loaded when the
system was started up to the screen or to a file called MODULE.LOG.
The file output will also contain module file sizes, date and time
information.

Syntax:

    /LOG [S|F]

    Where "S" will direct the output to the screen.

    Where "F" will direct the output to the file MODULE.LOG.

MOD
---

This command logs all of the modules that are in the module table (these
are modules that are registered with MAJORBBS.EXE and have been assigned
a STATE number).  The output is placed in the file STATE.LOG. Routine
addresses will be output along with the module description.

Syntax:

    /MOD

DISCLAIMER
----------

This module is provided "AS IS" and is not officially supported by
Galacticomm, Inc.  Galacticomm, Inc. is not responsible for any damage or
loss sustained as a result of using or installing this program.