checkque(ADM)                   19 June 1992                   checkque(ADM)


 Name

    checkque - MMDF queue status report generator

 Syntax

    /usr/mmdf/bin/checkque [ -fpsz ] [ -tage [ m ]] [ -c channel channel ...]

 Description

    checkque reports on the amount of mail waiting in the MMDF distribution
    queue.  It indicates the total number of messages and the size of the
    queue directory.  It then lists the number of messages waiting for each
    transmission channel.

    The -c option allows one or more channel names to be specified.  If
    present, checkque restricts its report to the named channels.

    The -f option causes checkque to print the name of the oldest queued mes-
    sage for each channel.  -p causes only channels with ``problems'' to be
    listed.  Problems are defined as channels with mail waiting for over some
    ``problem threshold''.  The default problem threshold is 24 hours.  The
    -t option is used to change the problem threshold.  A number of hours (or
    minutes, if m is appended) should appear without a space after the -t.
    -s forces an abbreviated summary listing instead of the normal multi-line
    report.  -z causes channels with no messages queued to be skipped in the
    report.

    Because the mail queue usually is protected from access by any uid,
    except MMDF, checkque should be run under root or mmdf uid.  It should
    not be made setuid() to mmdf unless you want to allow non-staff members
    to see the queue status.

    Most configurations will have only two channels.  One is for local
    delivery and the second is for off-machine relaying, such as by calling
    out or by being called up, or by attaching to ArpaNet hosts.  Local
    delivery usually happens at the time of submission, so it is rare that
    any mail is waiting in it.  Mail in other outbound queues is processed by
    deliver according to your site parameters, either by running deliver as a
    background daemon or by periodically firing it up via cron.

 Files

    quedfldir[]/addr
    quedfldir[]/msg
    quedfldir[]/q.*
    phase-directory/channel/*

 See also

    deliver(ADM)

 Credit

    This utility was written by Dave Crocker, Dept. of E.E., Univ. of
    Delaware.

    MMDF was developed at the University of Delaware and is used with permis-
    sion.