linguist/samples/RUNOFF/mcp_help.rnh

.!++
.!
.! Copyright (c) 2008, Matthew Madison.
.! Copyright (c) 2012, Endless Software Solutions.
.! 
.! All rights reserved.
.! 
.! Redistribution and use in source and binary forms, with or without
.! modification, are permitted provided that the following conditions
.! are met:
.! 
.!     * Redistributions of source code must retain the above
.!       copyright notice, this list of conditions and the following
.!       disclaimer.
.!     * Redistributions in binary form must reproduce the above
.!       copyright notice, this list of conditions and the following
.!       disclaimer in the documentation and/or other materials provided
.!       with the distribution.
.!     * Neither the name of the copyright owner nor the names of any
.!       other contributors may be used to endorse or promote products
.!       derived from this software without specific prior written
.!       permission.
.! 
.! THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
.! "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
.! LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
.! A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
.! OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
.! SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
.! LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.! DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.! THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.! (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
.! OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.!
.! NAME:	    MCP_HELP.RNH
.!
.! ABSTRACT: MCP help file.
.!
.! FACILITY: MX Control Program
.!
.! DESCRIPTION:
.!
.!   This is the RUNOFF source for the help library for MCP.
.!   To create the help library, use the following commands:
.!
.!   	$ RUNOFF MCP_HELP.RNH
.!   	$ LIB/CREATE/HELP MCP_HELPLIB MCP_HELP
.!
.! MODIFICATION HISTORY:
.!
.!   30-SEP-1990    V1.3    Madison 	Update for MX V1.3.
.!   04-OCT-1990    V1.3-1  Madison	Further file server-related changes.
.!   05-DEC-1990    V2.1    Madison	Add SET JNET.
.!   10-DEC-1990    V2.1-1  Madison	New qualifiers for DEFINE LIST.
.!   12-DEC-1990    V2.1-2  Madison	One more DEFINE LIST qualifier.
.!   11-FEB-1991    V2.2    Madison	Various new command options.
.!   27-MAR-1991    V2.2-1  Madison	Mention SHUT SMTP.
.!   07-NOV-1991    T2.4    Madison	New commands.
.!   11-NOV-1991    T2.4-1  Madison	Forgot QUEUE SHOW. SET JNET/LENIENT. REVIEW.
.!   05-DEC-1991    V3.0    Madison	SHOW VERSION.
.!   03-JAN-1992    V3.0-1  Madison	DEFINE LIST/REPLY_TO wasn't correct.
.!   14-FEB-1992    V3.1    Madison 	SET JNET/USERNAME.
.!   05-MAR-1992    V3.1-1  Madison 	SHUTDOWN, RESET changes.  STATUS.
.!   13-MAR-1992    V3.1-2  Madison 	Forgot SET X25_SMTP.
.!   15-FEB-1993    V3.2    Goatley     DEFINE LIST/FILE changes, fix typos.
.!   19-MAR-1993    V3.3    Goatley	DEFINE LIST/PRIVATE, QUEUE SHOW/BRIEF.
.!   16-APR-1993    V3.3-1  Goatley	SET LOCAL/MULTIPLE_FROM.
.!    7-AUG-1993    V3.4    Goatley     Fix missing double "_" in qualifiers.
.!   29-AUG-1993    V3.4-1  Goatley	SET LOCAL/MM_DELIVER.
.!   17-DEC-1993    V3.4-2  Goatley	DEFINE LIST/STRIP=OTHER, SET LOCAL/CC.
.!   10-JAN-1994    V3.4-3  Goatley     DEF LIST/CASE, - Q RECLAIM, + Q SYNCH.
.!   16-FEB-1994    V4.0    Goatley     QUEUE CREATE, QUEUE EXTEND.
.!   10-DEC-1995    V4.2    Goatley	/NODE, /DIGEST.
.!    7-OCT-1996    V4.3    Goatley	SPAWN.
.!  14-JAN-1997	    V4.4    Madison 	SET MLF.
.!  17-FEB-1997	    V4.5    Madison 	DEFINE/MODIFY/REMOVE/SHOW REJECTION.
.!  02-APR-1997	    V4.6    Madison 	LOCAL_DOMAIN, SMTP/RELAY, LIST/RECIP/HIDE.
.!  13-APR-1997	    V4.6-1  Madison 	SET MLF/DELAY_DAYS.
.!   2-MAY-1997	    V4.7    Goatley     Added DEF LIST/XHEADERS, /LIST_HEADERS, /HOSTNAME
.!   5-MAY-1997	    V4.7-1  Goatley	Added DEF LIST/SETTINGS.
.!   4-AUG-1997	    V4.7-2  Goatley     Add REJECTION to SHOW.
.!   8-SEP-1997	    V4.7-2  Goatley     Add multiple addrs to DEFINE ALIAS.
.!   3-OCT-1997	    V4.7-3  Goatley     Add /CC_POST_ERRORS, /SUBJECT_PREFIX.
.!  05-OCT-1997	    V4.7-4  Madison 	Removed REJECTION due to inclusion of REJMAN utility;
.!  	    	    	    	    	added SET SMTP/VALIDATE_SENDER_DOMAIN.
.!  29-OCT-1997	    V4.7-5  Goatley     Fix /LIST_HEADERS description.
.!  21-NOV-1997	    V4.7-6  Goatley	Add /QP_DECODE to SET LOCAL.
.!  19-APR-1998	    V4.7-7  Madison 	Add SET LOCAL/DISABLE_EXQUOTA; remove /MM_DELIVER.
.!  24-APR-1998	    V4.8    Madison 	Add SET SMTP/RBL, SET ROUTER/ACC.
.!  15-JUN-1998	    V4.9    Madison 	Add INSIDE_NETWORK_ADDRESS settings.
.!  26-JUN-1998	    V4.9-1  Madison 	Add /RELAY_ALLOWED to DEFINE INSIDE.
.!  03-AUG-1998	    V4.9-2  Madison 	REMOVE INSIDE_NETWORK_ADDRESS was missing.
.!  15-AUG-1998	    V4.9-3  Madison 	Document /RBL_CHECK=domain-name; add MODIFY INSIDE.
.!  27-AUG-1998	    V4.9-4  Madison 	New HOLDING_QUEUE paths.
.!  30-JAN-2000	    V4.9-5  Madison 	More holding queues.
.!  25-NOV-2000	    V4.9-6  Madison 	list ignore flags; remove Jnet support; set local/long.
.!  22-DEC-2000	    V4.10   Madison 	SHOW LIST/BRIEF.
.!  13-JAN-2001	    V4.11   Madison 	QUEUE SELECT.
.!  14-FEB-2002     V4.12   Madison     SET SMTP/[NO]PERCENT, regex, QUEUE DUMP.
.!  03-Feb-2008     V5.0    Madison     Cleanup of obsolete keywords.
.!  12-Mar-2012     V5.1    Sneddon	SET SMTP/[NO]TLS.
.!--
.P0
.AP
.LM1
.RM70
.I-1
1 @
 @
 You can create MCP command files and execute them with the "@"
(input-indirection) function.
.NJ
 Format:
 @ file-spec
.J
 You can use the command SHOW/OUTPUT=file/COMMAND ALL to create a command
file out of the current MX configuration, edit it outside of MCP, and then
load in the commands with @file to create a new MX configuration.
.I-1
1 ADD
 See the help text for ADD USER.
.I-1
2 USER
 ADD USER adds a username and password to the authentication database
used by the SMTP server.
.NJ
 Format:
 ADD USER username
.J
 A username may be up to 16 characters in length, and are case-sensitive.
Use quotation marks to specify a username that contains lower-case letters.
.I-1
3 Qualifiers
.I-1
/PASSWORD
 /PASSWORD=password-text
 Specifies a password for this username.  The password may be up to 64
characters in length, and may contain any characters.  To specify lower case
letters or blanks in the password, surround it with quotation marks.
 If this qualifier is omitted, a default password, "PASSWORD", is assigned
to the username.
.I-1
1 CREATE
 See the help text for CREATE USER__DATABASE__FILE.
.I-1
2 USER__DATABASE__FILE
 The CREATE USER__DATABASE_FILE command creates an empty file for the SMTP
authentication database.  This database is used in conjunction with the
CRAM-MD5 authentication extension (see SET SMTP/AUTHENTICATION).
.NJ
 Format:
 CREATE USER__DATABASE__FILE [file-spec]
.J
 If a file-spec is omitted, a new (empty) version of MX__DIR:MX__USERAUTH__DB.DAT, the
standard location for the SMTP authentication database, is created.  In general,
this command is used only once, to create the initial database for population using
the ADD USER command.
.I-1
1 DEFINE
 The DEFINE command is used to add new alias and path entries,
new rewrite-rules, mailing lists, and file servers, as well as identify
privileged users.
.I-1
2 ALIAS
 DEFINE ALIAS adds a new alias definition to the alias list.  The
new alias always goes at the end of the list.
.NJ
 Format:
 DEFINE ALIAS alias real-address[,...]
.J
 Real-address must be a full address, not just a username.  Alias
matching is case-insensitive.  If case is important in the substitution,
place quotation marks around real-address.
 The maximum size of the real-address (including all addresses, if multiple
real-addresses are specified) is 255 characters.
.I-1
2 FILE__SERVER
 DEFINE FILE__SERVER is used to create a file server.
.NJ
 Format:
 DEFINE FILE__SERVER name
.J
 The name given must be 32 characters or less in length, and should not
be the same as an existing username or mailing list.
.I-1
3 Qualifiers
.I-1
/BEGIN__SEND__PERIOD
 /BEGIN__SEND__PERIOD=hh:mm
 This qualifier identifies the hour of the day when the off-peak sending
period begins.  It is only meaningful when a delay threshold is specified.
The default send period begins at 17:00.
.I-1
/DELAY__THRESHOLD
 /DELAY__THRESHOLD=size
 /NODELAY__THRESHOLD
 This qualifier identifies the largest size, in bytes, that a file service
response can be to be sent during prime time.  Responses exceeding that size
are delayed until the off-peak sending period.  /NODELAY__THRESHOLD lets
responses  of any size be sent at any time.  Omitting "size" sets a default
size of 16,384 bytes.
.I-1
/DESCRIPTION
 /DESCRIPTION=text
 /NODESCRIPTION (default)
 The /DESCRIPTION qualifier defines a brief description for the file server.
This description is added to the file server address in the
X-FileServer header on outgoing file server messages.
.I-1
/END__SEND__PERIOD
 /END__SEND__PERIOD=hh:mm
 This qualifier identifies the hour of the day when the off-peak sending
period ends.  It is only meaningful when a delay threshold is specified.
The default send period ends at 09:00.
.I-1
/HOST__LIMIT
 /[NO]HOST__LIMIT=n
 This qualifier specifies a daily per-host byte count limit on requests
to the file server.  If a requested file's size plus the current byte
count exceeds the daily limit, the file is not sent.  This limit is
kept on a per-host basis.
.I-1
/MAILING__LIST
 /[NO]MAILING__LIST=list-name
 This qualifier specifies that only those users who subscribe to the
specified mailing list (which must be a list on the local system) may
have access to the file server.
.I-1
/MANAGER
 /MANAGER=address
 The /MANAGER qualifier identifies the address to which file service management
requests are forwarded (when sent to user {file-server-username}-Mgr).
If omitted, Postmaster on the local system is used.
.I-1
/ROOT
 /ROOT=root-spec
 The /ROOT qualifier identifies the root for the file server.  Root-spec
must be a rooted logical name or a device and root directory specification.
.I-1
/SERVER__LIMIT
 /[NO]SERVER__LIMIT=n
 This qualifier specifies a daily server byte count limit on requests
to the file server.  If a requested file's size plus the current byte
count exceeds the daily limit, the file is not sent.  This limit applies
to all requests to the server.
.I-1
/USER__LIMIT
 /[NO]USER__LIMIT=n
 This qualifier specifies a daily per-user byte count limit on requests
to the file server.  If a requested file's size plus the current byte
count exceeds the daily limit, the file is not sent.  This limit is
kept on a per-destination-user basis.
.I-1
2 INSIDE__NETWORK__ADDRESS
 The DEFINE INSIDE__NETWORK__ADDRESS command establishes an IP address or
network that is in one of the local domains, is permitted to use your SMTP
server as a relay, or to reject a particular host or network from being
considered as part of your local domain.
.NJ
 Format:
 DEFINE INSIDE__NETWORK__ADDRESS ip-address
.J
 Inside network address definitions are only used with the SMTP server
is set to disallow relays with SET SMTP/NORELAY__ALLOWED.  When at least
one inside address is defined, messages coming in via SMTP are allowed
to have recipients outside of the local domain(s) only if the sending
system's IP address is on the inside network address list.
 By default, the SMTP server will still reject a message that contains
non-local addresses for both the sender and the receiver, even from
hosts on the inside network address list.  You can ease that restriction
with the /RELAY__ALLOWED qualifier.
.I-1
3 ip-address
 IP address, in dotted-decimal form, of the host or network.  If this is
a network address, you must also specify the /NETMASK qualifier.
.I-1
3 Qualifiers
.I-1
/NETMASK
 /NETMASK=ip-netmask
 Specifies the network mask to be applied to the address, in dotted-decimal
form.  The default is 255.255.255.255, which indicates that the IP address
is for a host, not a network.
.I-1
/REJECT
 /REJECT
 /NOREJECT (default)
 Indicates whether relay is to be rejected from the specified
host or network.  This qualifier can be used to reject SMTP relay
from particular hosts or subnetworks that are below a parent network
that is already on the inside network address list.
.I-1
/RELAY__ALLOWED
 /RELAY__ALLOWED
 /NORELAY__ALLOWED (default)
 Indicates that the host(s) should be allowed full relay permission; that
is, messages sent from the host(s) are allowed to contain non-local addresses
for both sender and receiver.
 This qualifier is useful when your system is acting as a central mail hub,
and there are hosts on your local network that automatically forward messages
for their local users to hosts outside your domain via an alias.  When such
messages are sent back to your system (as the mail hub), they will contain
non-local addresses for both the sender and the recipient.
.I-1
2 LIST
 The DEFINE LIST command is used to create a mailing list.
.NJ
 Format:
 DEFINE LIST listname
.J
 DEFINE LIST creates three addresses on the local system: the mailing list
itself, a control address (listname-REQUEST), and a sender address
(listname-SENDER).
.I-1
3 Qualifiers
.I-1
/ADD__MESSAGE
 /ADD__MESSAGE=fspec
 /NOADD__MESSAGE (default)
 The /ADD__MESSAGE qualifier is used to specify a file whose contents
are to be sent when a user subscribes to the list.  If you omit
the device and directory parts of the file specification, they default
to MX__MLIST__DIR.  If you omit the file type, it defaults to TXT.
 If no add message is specified, the system default add message, contained
in file MX__MLIST__DIR:MLIST__ADD__MESSAGE.TXT, is used.
.I-1
/ARCHIVE
 /ARCHIVE=fspec
 /NOARCHIVE (default)
 The /ARCHIVE qualifier  is used to establish a file into which mailing list
messages are archived.  You may specify just parts of a file specification,
to allow the following defaults to take effect:
.NJ
 Device, directory: MX__MLIST__DIR:
 File name: same as mailing list name
 File type: yyyy-mm (four-digit year, a hyphen, two-digit month)
.J
 This setup allows for easy monthly disposal of the mailing list archives.
.I-1
/CASE__SENSITIVE
 /CASE__SENSITIVE (default)
 /NOCASE__SENSITIVE
 Enables or disables case-sensitivity with regard to mailing list
subscribers.  By default, MX treats the left-hand side of subscriber
addresses in a case-sensitive manner with regard to SIGNOFF and SET
commands.  If a list is defined /NOCASE__SENSITIVE, then the case of
subscriber addresses will be ignored.
.I-1
/CC__POST__ERRORS
 /CC__POST__ERRORS
 /NOCC__POST__ERRORS (default)
 Enables or disables copying mailing post failure messages to the /ERRORS__TO
address.  By default, if a message cannot be forwarded to a list, an error
message is sent back to the sender of the message.  If /CC__POST__ERRORS
is set, those error messages are also sent to the /ERRORS__TO address.
This lets the list owner see attempted posts from non-subscribers and other
posting failures.
.I-1
/CONFIRMATION__MESSAGE
 /CONFIRMATION__MESSAGE=fspec
 /NOCONFIRMATION__MESSAGE (default)
 The /CONFIRMATION__MESSAGE qualifier is used to specify a file whose contents
are to be sent when the mailing list processor requests confirmation of
a subscription request (see DEFINE LIST /REQUEST__CONFIRMATION).  If you omit
the device and directory parts of the file specification, they default
to MX__MLIST__DIR.  If you omit the file type, it defaults to TXT.
 If the NO form is specified, the system default confirmation message, contained
in file MX__MLIST__DIR:MLIST__CONFIRM__MESSAGE.TXT, is used.
.I-1
/DESCRIPTION
 /DESCRIPTION=text
 /NODESCRIPTION (default)
 The /DESCRIPTION qualifier defines a brief description for the
mailing list. This description is added to the mailing list address in the
X-Listname header on outgoing mailing list messages.
.I-1
/DIGEST
 /DIGEST
 /NODIGEST (default)
 The /DIGEST qualifier enables or disables the support for digest subscribers
for the given mailing list.
.I-1
/ERRORS__TO
 /ERRORS__TO=address
 This qualifier identifies the address that messages sent to the
listname-SENDER sending address (which are usually delivery error messages)
are sent.  If omitted, the first owner specified with /OWNER will be
used.
.I-1
/FORWARD__MESSAGE
 /FORWARD__MESSAGE=fspec
 /NOFORWARD__MESSAGE (default)
 The /FORWARD__MESSAGE qualifier is used to specify a file whose contents
are to be sent when the list is set to no E (enroll) access for WORLD and
a user attempts to subscribe to the list.  The message should inform the
user that the subscription request was forwarded to the mailing list's
owner.  If you omit the device and
directory parts of the file specification, they default to MX__MLIST__DIR. 
If you omit the file type, it defaults to TXT.
 If no forward-to-owner message is specified, the system default message,
contained in file MX__MLIST__DIR:MLIST__FORWARD__MESSAGE.TXT, is used.
.I-1
/HIDE__ERRORS__TO
 /HIDE__ERRORS__TO (default)
 /NOHIDE__ERRORS__TO
 The /HIDE__ERRORS__TO qualifier instructs MLF to hide the error-returns
address in outbound messages to the mailing list, even when the return
address is specified with /ERRORS__TO. When /HIDE__ERRORS__TO is set on
a list, MLF uses the automatically-created owner-{listname} alias as
the envelope FROM and Errors-To address in outbound list messages.
This is the default setting.
 If you have set up a special address or alias for receiving mailing
list-related error messages, and the address can be externally visible,
you should specify that address with the /ERRORS__TO qualifier and
specify /NOHIDE__ERRORS__TO to have the address you specify
appear in the envelope FROM and Errors-To headers.
.I-1
/HOSTNAME
 /HOSTNAME=hostname
 /NOHOSTNAME (default)
 The /HOSTNAME qualifier instructs MLF to use the supplied hostname
for all addresses generated by MLF for the mailing list.  The supplied
hostname is used instead of the actual running host's name.
 For example, specifying /HOSTNAME="YYZ.COM" will cause all MLF-generated
mailing list addresses to include "@YYZ.COM" instead of the actual host name.
It is assumed that MX has been properly configured to handle mail addressed
using the supplied hostname (i.e., that MX records for YYZ.COM point to
the node running MX, and that it recognizes that YYZ.COM is a LOCAL path,
etc.).
.I-1
/IGNORE
 /IGNORE=(keyword[=value],...)
 The /IGNORE qualifier instructs MLF to ignore postings to the mailing list
if they match the specified criteria.  The criteria keywords are
MISSING__LIST__ADDRESS and JUNK__MAIL.  These keywords are negatable.  By default,
no postings are ignored.
 Specifying the MISSING__LIST__ADDRESS criterion causes MLF to ignore
postings to the list that do not explicitly include the list's address in either
the To: or CC: header of the message.  This keyword does not take a value.
 Specifying the JUNK__MAIL criterion causes MLF to ignore postings that
contain the X-Junk-Mail-Rating: header that is inserted by the heuristic
junk-mail filter in the SMTP server.  This keyword takes a value: LOW,
MEDIUM, or HIGH, corresponding to the confidence level of the likelihood
that the message is junk mail, as entered in the
X-Junk-Mail-Rating: header by the SMTP server.  Only those messages with
the specified or higher rating are ignored; i.e., if MEDIUM is specified
as the keyword value, only those messages with MEDIUM or HIGH ratings are
ignored.
 
.I-1
/LIST__HEADERS
 /LIST__HEADERS=(keyword=value[,...])
 /NOLIST__HEADERS (default)
 The /LIST__HEADERS qualifier instructs MLF to include or omit special
List-* headers that provide URLs for subscribing to a list,
unsubscribing from a list, and getting help for that list.
 There are three valid keywords: SUBSCRIBE, UNSUBSCRIBE, and HELP.
All three accept values that are used in the creation of the actual headers,
which will be added to each message posted to the mailing list.  However,
only HELP requires a value.  If the value is omitted for SUBSCRIBE and
UNSUBSCRIBE, the proper URLs for those actions will be automatically generated
by MLF.
 Clients that support these headers (both X-List-* and List-*) will provide
click buttons to perform the specified actions (usually "mailto" URLs).
.I-1
/MAXIMUM__MESSAGE__SIZE
 /MAXIMUM__MESSAGE__SIZE=size-in-Kbytes
 /NOMAXIMUM__MESSAGE__SIZE (default)
 Specifies a limit on the size of a message posted to the list, expressed
in kilobytes.  Messages with contents (excluding headers) that exceed the
specified limit are rejected and returned to sender.
 Specifying zero as the value is identical to specifying /NOMAXIMUM__MESSAGE__SIZE.
.I-1
/NOTIFY
 /NOTIFY=(type,...)
 /NONOTIFY (default)
 Specifies that the owner(s) of the mailing list should be sent a
notification message for control transactions.  Valid type keywords are
ALL (for all transaction types), ADD, REMOVE, REQUEST, and SET.
 By default, no owner notifications are sent.
.I-1
/OWNER
 /OWNER=(address[,...])
 The /OWNER qualifier identifies the address(es) of the owner(s) of the
mailing list.  Messages coming to the mailing list or the listname-REQUEST
control address will be granted OWNER access to the mailing list.
.I-1
/PRIVATE
 /PRIVATE
 /NOPRIVATE (default)
 The /PRIVATE qualifier is used prevent a list from being displayed in
response to a LIST command sent to ListServ.  The list protection mask
is not affected by this qualifier.
.I-1
/PROTECTION
 /PROTECTION=(class:code[,...])
 This qualifier allows you to grant or deny certain types of access to
various users.  The protection code is of the same form as a normal VMS
file protection specification.
 "Class" can be one of SYSTEM, OWNER, GROUP, or WORLD.  The SYSTEM class
includes only those addresses identified as system users with DEFINE
SYSTEM__USERS. The OWNER class includes only the owners of the mailing list.
The GROUP class consists of the subscribers of the mailing list.  The WORLD
class consists of those addresses that are not subscribers of the mailing
list.
 "Code" can consist of the letters R,W,E, and D.  R (Read or Review) access
allows the user to request a listing of the addresses on the mailing list
with the REVIEW command.  W (Write) access allows the user to send a message
to the mailing list.  E (Execute) access allows the user to use the automatic
subscription facility to subscribe to the mailing list (meaningful only for
the WORLD class, of course).  D (Delete) access allows the user to use the
automatic subscription facility to sign off the mailing list (meaningful only
for the GROUP class).
 If E access is denied to WORLD, subscription requests are forwarded to the
mailing list owner(s).  If D access is denied to GROUP, signoff requests
are forwarded to the mailing list owner(s).
 Note that protection codes are checked just like VMS protection codes,
so that you cannot grant some kind of access to WORLD and exclude that
access from GROUP, SYSTEM, or OWNER.  Also, SYSTEM and OWNER classes are
granted CONTROL access implicitly (just as with VMS file protection), which
allows them to add and remove other users from the mailing list.
.I-1
/RECIPIENT__MAXIMUM
 /RECIPIENT__MAXIMUM=DEFAULT (default)
 /RECIPEIENT__MAXIMUM=count
 /NORECIPIENT__MAXIMUM
 The /RECIPIENT__MAXIMUM qualifier controls how the mailing list
processor sets the maximum number of recipients per outbound message
for the list.  The default setting is DEFAULT, which causes the
mailing list processor to set the maximum number based on the
SET MLF/RECIPIENT__MAXIMUM setting.  You may override the SET MLF
default by specifying a number, or by specifying /NORECIPIENT__MAXIMUM,
which prevents MLF from breaking up long lists of recipients into
smaller chunks for this list.
.I-1
/REMOVE__MESSAGE
 /REMOVE__MESSAGE=fspec
 /NOREMOVE__MESSAGE (default)
 The /REMOVE__MESSAGE qualifier is used to specify a file whose contents
are to be sent when a user signs off of the list.  If you omit
the device and directory parts of the file specification, they default
to MX__MLIST__DIR.  If you omit the file type, it defaults to TXT.
 If no removal message is specified, the system default removal message,
contained in file MX__MLIST__DIR:MLIST__REMOVE__MESSAGE.TXT, is used.
.I-1
/REPLY__TO
 /REPLY__TO=(kwd[,...])
 Specifies how the mailing list processor should handle Reply-To headers.
Available reply-to types are SENDER and LIST, which may be combined.
The default is
SENDER, which prevents the mailing list processor from modifying the headers.
If LIST is specified, a Reply-To header is added to list messages to re-direct
replies to the mailing list, eliminating any existing Reply-To header in the
original message.  If LIST and SENDER are both specified, a Reply-To header
containing both the mailing list address and the original Reply-To address
is added to list messages (using the From address if no Reply-To header
existed in the original message).
.I-1
/REQUEST__CONFIRMATION
 /REQUEST__CONFIRMATION[=INTERVAL=delta-time]
 /NOREQUEST__CONFIRMATION (default)
 The /REQUEST__CONFIRMATION qualifier is used to specify whether or not
the mailing list processor should request confirmation of a subscription
request from a user being added to a list via the SUBSCRIBE or ADD list
processor command.  By default, confirmations are not requested.
 You can control the length of time that the mailing list processor will
wait for a subscription request to be confirmed by specifying the INTERVAL
keyword and a VMS delta-time string for its value.  If not specified,
the default confirmation interval is 3 days.
.I-1
/RETURN__ADDRESS
 /RETURN__ADDRESS=address
 /NORETURN__ADDRESS (default)
 The /RETURN__ADDRESS qualifier is used to specify an alternate address
that is to be used as
the Reply-To address when /REPLY__TO=LIST is specified.
This qualifier is most useful when multiple lists should have a common
return address.  For example, it can be used to redirect replies to a
"-Digest" list back to the non-digest address.
.I-1
/SETTINGS
 /SETTINGS=(keyword[,...])
 /SETTINGS=DEFAULT  (default)
 The /SETTINGS qualifier is used to override the default subscriber settings
for a list.  The valid keywords are MAIL, REPRO, CONCEAL, DIGEST, POST, and
their "NO" forms.
 A special keyword, DEFAULT, can be used to reset the settings
to the MLF default for a mailing list.  The default settings for a list
are MAIL, REPRO, NOCONCEAL, NODIGEST, and POST.
.I-1
/STRIP__HEADERS
 /STRIP__HEADERS=(RECEIVED[,OTHER])
 /STRIP__HEADERS=(NORECEIVED,NOOTHER) (default)
 The /STRIP__HEADERS qualifier is used to strip certain RFC822 headers from
messages posted to a mailing list.  Currently, only the keywords RECEIVED and
OTHER (and NORECEIVED and NOOTHER) are supported.
 When /STRIP__HEADERS=RECEIVED is set, the "Received:" headers are stripped from
the incoming message before it is mailed out to the list subscribers, thereby
reducing the total number of "Received:" headers in the final message.  This is
especially beneficial to BITNET hosts because there can be a substantial number
of "Received:" headers added to a message that must pass through one or more
Internet/BITNET gateways.
 When /STRIP__HEADERS=OTHER is set, all "other" headers are stripped from
the incoming message before it is mailed out.  "Other" headers are any headers
not listed under HELP SET LOCAL/HEADERS.  This includes return-receipt
headers, X-400 headers, etc.
.I-1
/SUBJECT__PREFIX
 /SUBJECT__PREFIX="string"
 /NOSUBJECT__PREFIX (default)
 Enables or disables the addition of a prefix to the Subject line of
messages posted to the list.  By default, no prefix is added.  When
the list is set to /REPLY__TO=(SENDER), a short prefix string may be
supplied to help subscribers recognize mailing list messages.  The
given string is bracketed by square brackets ([]) when it is prefixed
to the subject lines.  The maximum length for the prefix string is 32
characters.  Prefix strings should be kept short to avoid generating
extremely long subject lines.
.I-1
/TEXT__ONLY
 /TEXT__ONLY
 /NOTEXT__ONLY (default)
 The /TEXT__ONLY qualifier is used to specify whether or not the
mailing list processor should accept only those messages with plain
text content.  By default, any content type is accepted for list postings.
.I-1
/XHEADERS
 /XHEADERS=("string"[,...])
 /NOXHEADERS (default)
 The /XHEADERS qualifier can be used to add additional site-specific headers
to mailing list posts.  For example, you can use /XHEADERS to add additional
non-standard "X-List-" headers such as "X-List-Archives".  The format of the
header string is: "Keyword: text".  For example, "Precedence: Bulk", which
is a non-standard header used by some mailers.
 Extreme care should be taken when adding additional headers to mailing lists
to ensure that duplicate headers or improperly formatted headers
(those that don't comply with RFC 822) aren't added to mailing list posts.
.I-1
2 LOCAL__DOMAIN
 The DEFINE LOCAL__DOMAIN command adds a domain name or pattern
to the list of recognized "local" domains considered by the SMTP
server when determining relay rejection.
.NJ
 Format:
 DEFINE LOCAL__DOMAIN domain-name-or-pattern
.J
 The LOCAL__DOMAIN list is only used when the SMTP server is set
to reject "relayed" SMTP messages with SET SMTP/NORELAY__ALLOWED.
 A "relayed" message is one that originates on a remote system and
is sent to another remote recipient, using your system as an
intermediate relay.
 When the SMTP server is set /NORELAY__ALLOWED, it checks the
envelope FROM and TO addresses, and if neither is local, refuses
to deliver the message.  By default, any host in your local domain
(based on your TCP/IP host name and your MX host name) is considered
"local".  You may use this command to add other hosts or domains
to this list.
.I-1
3 Parameter
 domain-name-or-pattern
 Either a fully-qualified domain name of a single host, or a VMS-style
wildcard pattern.  Host names in envelope addresses that match the
specified name or pattern will be considered local by the relay
checker.
.I-1
2 PATH
 The DEFINE PATH command is used to map a domain to a delivery path.
.NJ
 Format:
 DEFINE PATH domain-pat path-name
.J
.I-1
3 Qualifiers
.I-1
/ROUTE
 /ROUTE=host-name

 Specifies the name of a host through which messages matching the domain
pattern should be routed.
.I-1
3 domain-pat
 This can be a specific domain name or a pattern containing wildcards to
match a domain name.  For example: "specific.host.EDU", "*.BITNET".
.I-1
3 path-name
 This is one of DECNET__SMTP, HOLDING__QUEUE=n, LOCAL, SITE, SMTP.
You MUST have at least one LOCAL path defined; other paths will depend on the
network transports you have installed.  For the HOLDING__QUEUE path, you must
specify an integer from 1 to 32 for "n".
.I-1
2 REWRITE__RULE
 The DEFINE REWRITE__RULE command establishes an address rewriting rule to
be used by the Router.
.NJ
 Format:
 DEFINE REWRITE__RULE  old-addr  new-addr
.J
 When the router rewrites an address, it tries each rewrite rule, in the
order you define them, until one matches.  It then applies the one rule
to that address.
.I-1
3 Qualifiers
.I-1
/REGEX
 /REGEX
 Specifies use of regular-expression matching and substitution instead
of substitution variables.
.I-1
3 old-addr
 The address-specification to be rewritten.  All addresses must conform
to RFC821 and therefore will always contain a leading and closing angle
bracket.  To create a substitution variable, surround the variable with
curly braces.  Matching is done from right to left.  Substitution variables
match all characters.
 Example: <{user}@{host}.CSNET>
 Substitution variables are not used with regular-expression matching
(when /REGEX is specified); instead, use subexpressions enclosed in
parentheses.
.I-1
3 new-addr
 The resulting address pattern.  Substitution variables created in the
old-addr specification can be used here.
 Example: <@relay.cs.net:{user}@{host}.CSNET>
 When using regular-expression matching, replacements are specified
with a backslash followed by a single digit (1 through 9), representing
the 1st through the 9th matching subexpression.
.I-1
2 SYSTEM__USERS
 The DEFINE SYSTEM__USERS command identifies addresses that the mailing list
processor should treat as SYSTEM-class users for protection purposes.
.NJ
 Format:
 DEFINE SYSTEM__USERS address[,...]
.I-1
1 EXIT
 The EXIT command leaves MCP.  If you were using MCP to edit an existing
MX configuration, a new version of the configuration file is saved before
MCP exits.  If the configuration file name is unknown, you are prompted
for a file name before exiting.
.I-1
1 HELP
 The HELP command displays information on MCP commands.
.I-1
1 MODIFY
 The MODIFY command is used to change definitions of mailing lists, aliases,
paths, etc.  The following MODIFY commands are supported, and take the same
qualifiers as their DEFINE counterparts (see the help information on DEFINE
for more information):
.NJ
 MODIFY ALIAS  alias
 MODIFY FILE__SERVER  fsrv-name
 MODIFY INSIDE__NETWORK__ADDRESS  ip-address
 MODIFY LIST  list-name
 MODIFY PATH  domain-pattern
 MODIFY REWRITE__RULE  lhs
.J
 The MODIFY USER command is documented here.
.I-1
2 USER
 The MODIFY USER command is used to set a new password for a username in the
SMTP authentication database.
.NJ
 Format:
 MODIFY USER username
.J
 Usernames may be up to 16 characters in length, and are case-sensitive.
.I-1
3 Qualifiers
.I-1
/PASSWORD
 /PASSWORD=password-text
 Specifies a password for this username.  The password may be up to 64
characters in length, and may contain any characters.  To specify lower case
letters or blanks in the password, surround it with quotation marks.
 If this qualifier is omitted, a default password, "PASSWORD", is assigned
to the username.

.I-1
1 QUIT
 Quits out of MCP without saving the configuration.  If you have changed
the configuration, QUIT will ask for confirmation before exiting.
.I-1
1 REMOVE
 The REMOVE command is used to remove an alias, mailing list, path, or
rewrite rule from the configuration.  The following REMOVE commands
are supported:
.NJ
 REMOVE ALIAS  alias
 REMOVE FILE__SERVER  fsrv-name
 REMOVE INSIDE__NETWORK__ADDRESS  ip-address
 REMOVE LIST  listname
 REMOVE LOCAL__DOMAIN domain-name-or-pattern
 REMOVE PATH  domain-spec
 REMOVE REWRITE__RULE  old-addr
.J
 The REMOVE INSIDE__NETWORK__ADDRESS command also takes a qualifier,
/NETMASK.  The combination of the IP address and the netmask must
match the combination in the inside address list.
 The REMOVE USER command is documented here.
.J
 The MODIFY USER command is documented here.
.I-1
2 USER
 The REMOVE USER command removes a username from the
SMTP authentication database.
.NJ
 Format:
 REMOVE USER username
.J
 Usernames may be up to 16 characters in length, and are case-sensitive.
.I-1
1 QUEUE
 The QUEUE suite of commands is used to control the system message queue.
.I-1
2 CANCEL
 Cancels one or more messages.
.NJ
 Format:
 QUEUE CANCEL [entry-number,...]
.J
 If you cancel the main entry for a message, all entries related to that
message will also be cancelled.  If no entry numbers are specified, the
entries selected by the last QUEUE SELECT command are cancelled.
.I-1
3 Qualifiers
.I-1
/LOG
 /LOG
 /NOLOG (default)
 Displays a log message for each successful operation.
.I-1
2 COMPRESS
 Shrinks the message queue file by creating a new file and renumbering
all the existing entries in the file.
.NJ
 Format:
 QUEUE COMPRESS/LOG
.J
.I-1
3 Qualifiers
.I-1
/MAXIMUM__ENTRIES
 /MAXIMUM__ENTRIES=number-of-entries
 Specifies the maximum number of queue entries to be allowed.  MX will not
allow more entries to be added to the queue than the specified value.
MCP QUEUE EXTEND can be used to increase the number of allowed entries.
 The size of the queue file in blocks is equal to the maximum number of
entries, plus 10 blocks plus whatever is added for the disk cluster.
.I-1
/LOG
 /LOG
 /NOLOG (default)
 Displays a log message for each successful operation.
.I-1
2 CREATE
 Creates a new, empty, MX message queue control file.
.NJ
 Format:
 QUEUE CREATE [filespec]
.J
.I-1
3 Parameters
 filespec
 Name of the queue control file to be created.  If omitted, the
default name, MX_FLQ_DIR:MX_SYSTEM_QUEUE.FLQ_CTL, is used.
.I-1
3 Qualifiers
.I-1
/MAXIMUM__ENTRIES
 /MAXIMUM__ENTRIES=number-of-entries
 Specifies the maximum number of queue entries to be allowed for the queue.
The message queue will be extended to allow the specified number of entries.
 The size of the queue file in blocks is equal to the maximum number of
entries, plus 10 blocks plus whatever is added for the disk cluster.
.I-1
2 DUMP
 Dumps an enqueued message to a set of files suitable for modifying
recipient addresses and requeuing with MX_SITE_IN.
.NJ
 Format:
 QUEUE DUMP entry-number
.J
.I-1
3 Qualifiers
.I-1
/CANCEL
 /CANCEL (default)
 /NOCANCEL
 By default, MCP cancels the queue entry for the dumped message.
Specify /NOCANCEL to keep the dumped entry in the queue.
.I-1
/OUTPUT
 /OUTPUT=file-spec
 Specifies the location for the three output files generated by
this command.  By default, the files are written to the current
default directory with the filename for the message text and recipient
files as ENTRY_n and the filename for the command procedure as
REQUEUE_n (where "n" is the entry number).
 Do not specify a file type or version in the file specification;
QUEUE DUMP always uses the file types .MSG__TEXT, .RECIPIENTS, and .COM for 
the message text, recipient, and command procedure files, respectively.
.I-1
3 Parameter
 entry-number
 Queue entry number for the message to be dumped.  The queue entry
must be in READY or IN-PROGRESS state.
 QUEUE DUMP creates three output files for the message: one
containing the message text, one containing the list of recipients,
and a command procedure for invoking MX_SITE_IN to requeue the
message.
.I-1
2 EXTEND
 Extends the existing message queue file to allow more entries to be in
the queue at any given time.
.NJ
 Format:
 QUEUE EXTEND
.J
.I-1
3 Qualifiers
.I-1
/MAXIMUM__ENTRIES
 /MAXIMUM__ENTRIES=number-of-entries
 Specifies the maximum number of queue entries to be allowed.  MX will not
allow more entries to be added to the queue than the specified value.
MCP QUEUE EXTEND can be used to increase the number of allowed entries.
 The size of the queue file in blocks is equal to the maximum number of
entries, plus 10 blocks plus whatever is added for the disk cluster.
.I-1
2 HOLD
 Places one or more queue entries on hold.
.NJ
 Format:
 QUEUE HOLD [entry-number,...]
.J
 This command places the specified queue entry or entries on hold,
so they will not be processed.  Use the QUEUE READY command to release
the entries for processing.  If no entry numbers are specified, the
entries selected by the last QUEUE SELECT command are held.
.I-1
2 PURGE
 Purges the message queue of all finished and cancelled entries.
.NJ
 Format:
 QUEUE PURGE
.J
 The Router process automatically purges the queue of finished and cancelled
entries, periodically.  This command can be used to force an immediate
purge of the queue.
.I-1
3 Qualifiers
.I-1
/LOG
 /LOG
 /NOLOG (default)
 Displays a log message for each entry purged from the queue.
.I-1
2 READY
 Readies one or more queue entries for processing.
.NJ
 Format:
 QUEUE READY [entry-number,...]
.J
 This command can be used to ready a destination-specific entry or the main
entry for a message (in which case all previous destination-specific entries
are automatically cancelled).  If no entry numbers are specified, the queue
entries selected by the last QUEUE SELECT command are readied.
.I-1
3 Qualifiers
.I-1
/AFTER
 /AFTER=date-time
 Specifies a date and time after which the entry should be processed. If
not specified, the entry is readied for immediate processing.
.I-1
/FINAL
 /FINAL
 /NOFINAL (default)
 Sets the error count for all recipients associated with this entry
to 32767.  This causes the delivery agent to process the entry
only once for each recipient.
.I-1
/LOG
 /LOG
 /NOLOG (default)
 Displays a log message for each successful operation.
.I-1
2 SELECT
 Selects queue entries.
.NJ
 Format:
 QUEUE SELECT
.J
 This command builds a list of queue entries based on selection
criteria that you specify with qualifiers on the command.  Subsequent
QUEUE CANCEL, HOLD, and READY commands will use this selection list
by default if you do not specify entry numbers on those commands.
 You can display the selected entries with the QUEUE SHOW/SELECTED
command.
.I-1
3 Qualifiers
.I-1
/BEFORE
 /BEFORE[=time]
 Selects only those entries dated before the specified time.   You can
specify time as an absolute time, a combination of absolute and delta
times, or as one of the following keywords: TODAY (default), TOMORROW,
or YESTERDAY. Specify one of the following qualifiers with the /BEFORE
qualifier to indicate the time attribute to be used as the basis for
selection: /CREATED (default), /DELAY, /EXPIRE, or /MODIFIED.
.I-1
/CREATED
 /CREATED
 Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /CREATED qualifier selects entries based on their
dates of creation. 
.I-1
/DELAY
 /DELAY
 Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /DELAY qualifier selects entries based on their
delay dates.
.I-1
/DESTINATION__AGENT
 /DESTINATION__AGENT=agent
 Selects only those entries that are to be or have been processed by the
specified MX agent.  Valid keywords are: ROUTER, MLF, LOCAL, SMTP, SITE,
DNSMTP, and HOLDING__QUEUE=n (where n ranges from 1 to 32,
the maximum number of holding queues).  HOLD1 through HOLD8 are obsolte,
but still supported for backward compatibility with prior versions of MX.
This qualifier is most useful when used with /BRIEF.
.I-1
/EXPIRE
 /EXPIRE
 Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /EXPIRE qualifier selects entries based on their
dates of expiration. 
.I-1
/HELD
 /HELD
 Selects only those entries that are in USER-HOLD or OPER-HOLD state.
.I-1
/IN__PROGRESS
 /IN__PROGRESS
 Selects only entries marked as being in-progress (INPROG).
.I-1
/MODIFIED
 /MODIFIED
 Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /MODIFIED qualifier selects entries based on their
dates of modification. 
.I-1
/ORIGIN__AGENT
 /ORIGIN__AGENT=agent
 Selects only those entries that were entered into the queue by the
specified MX agent.  Valid keywords are: LOCAL, SMTP, SITE,
MAIL, and DNSMTP.
.I-1
/SINCE
 /SINCE[=time]
 Selects only those entries dated after the specified time.   You can
specify time as an absolute time, a combination of absolute and delta
times, or as one of the following keywords: TODAY (default), TOMORROW,
or YESTERDAY. Specify one of the following qualifiers with the /SINCE
qualifier to indicate the time attribute to be used as the basis for
selection: /CREATED (default), /DELAY, /EXPIRE, or /MODIFIED.
.I-1
/WAITING
 /WAITING
 Selects only those entries that are waiting for processing.
.I-1
2 SHOW
 Displays queue entries.
.NJ
 Format:
 QUEUE SHOW [entry-number,...]
.J
 With no qualifiers, QUEUE SHOW gives a brief display for each active
(READY or IN-PROGRESS) queue entry.
.I-1
3 Qualifiers
.I-1
/ALL
 /ALL
 Causes the display of all queue entries, including those that have been
finished or cancelled.
.I-1
/BEFORE
 /BEFORE[=time]
 Selects only those entries dated before the specified time.   You can
specify time as an absolute time, a combination of absolute and delta
times, or as one of the following keywords: TODAY (default), TOMORROW,
or YESTERDAY. Specify one of the following qualifiers with the /BEFORE
qualifier to indicate the time attribute to be used as the basis for
selection: /CREATED (default), /DELAY, /EXPIRE, or /MODIFIED.
.I-1
/BRIEF
 /BRIEF
 Causes a brief display of all queue entries, including those that have
been finished or cancelled.  The information displayed
is taken only from the MX queue file and includes the target MX process
for each entry.
.I-1
/CREATED
 /CREATED
 Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /CREATED qualifier selects entries based on their
dates of creation. 
.I-1
/DATE
 /DATE
 Causes the creation and modification dates to be displayed for each queue
entry.
.I-1
/DELAY
 /DELAY
 Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /DELAY qualifier selects entries based on their
delay dates.
.I-1
/DESTINATION__AGENT
 /DESTINATION__AGENT=agent
 Selects only those entries that are to be or have been processed by the
specified MX agent.  Valid keywords are: ROUTER, MLF, LOCAL, SMTP, SITE,
DNSMTP, and HOLDING__QUEUE=n (where n ranges from 1 to 32,
the maximum number of holding queues).  HOLD1 through HOLD8 are obsolte,
but still supported for backward compatibility with prior versions of MX.
This qualifier is most useful when used with /BRIEF.
.I-1
/EXPIRE
 /EXPIRE
 Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /EXPIRE qualifier selects entries based on their
dates of expiration. 
.I-1
/FULL
 /FULL
 Provides a more detailed display of each queue entry.
.I-1
/HELD
 /HELD
 Selects only those entries that are in USER-HOLD or OPER-HOLD state.
.I-1
/IN__PROGRESS
 /IN__PROGRESS
 Displays only entries marked as being in-progress (INPROG).
.I-1
/MODIFIED
 /MODIFIED
 Modifies the time value specified with the /BEFORE or the /SINCE
qualifier. The /MODIFIED qualifier selects entries based on their
dates of modification. 
.I-1
/ORIGIN__AGENT
 /ORIGIN__AGENT=agent
 Selects only those entries that were entered into the queue by the
specified MX agent.  Valid keywords are: LOCAL, SMTP, SITE,
MAIL, and DNSMTP.
.I-1
/OUTPUT
 /OUTPUT=file-spec
 Directs the output of the command to the specified file.
.I-1
/SELECTED
 /SELECTED
 Displays the entries that were selected by the last QUEUE SELECT
command.
.I-1
/SINCE
 /SINCE[=time]
 Selects only those entries dated after the specified time.   You can
specify time as an absolute time, a combination of absolute and delta
times, or as one of the following keywords: TODAY (default), TOMORROW,
or YESTERDAY. Specify one of the following qualifiers with the /SINCE
qualifier to indicate the time attribute to be used as the basis for
selection: /CREATED (default), /DELAY, /EXPIRE, or /MODIFIED.
.I-1
/WAITING
 /WAITING
 Causes only those entries that are waiting for processing to be displayed.
.I-1
2 STATISTICS
 Displays statistics concerning the number of entries in the MX message queue.
.NJ
 Format:
 QUEUE STATISTICS
.J
.I-1
2 SYNCHRONIZE
 Synchronizes the message queue bitmap with the actual entries in the queue.
.NJ
 Format:
 QUEUE SYNCHRONIZE
.J
.I-1
3 Qualifiers
.I-1
/LOG
 /LOG
 Displays a log message about the synchronization.
.I-1
/RESET
 /RESET
 Resets the "Highest entry used" counter displayed by QUEUE
STATISTICS.  By default, the counter is not reset.
.I-1
1 RESET
 Sends a reset signal to one or more MX delivery agent processes, causing
them to reload their configuration information.
.NJ
 Format:
 RESET [agent,...]
.J
 Accepted agent names are: DECNET__SMTP, LOCAL, MLF, ROUTER, SITE,
SMTP, and SMTP__SERVER.
If omitted, all agents are reset.
.I-1
2 Qualifiers
.I-1
/ACCOUNTING
 /ACCOUNTING
 Causes a new accounting file to be opened, for those agents supporting
accounting (DECNET__SMTP, LOCAL, MLF, ROUTER, and SMTP).
No reloading of configuration occurs when RESET/ACCOUNTING is used.
.I-1
/CLUSTER
 /CLUSTER
 Causes the reset to affect agents cluster-wide; this is the default
behavior.  Use the /NODE qualifier to restrict the reset action to
specific nodes in the cluster.
.I-1
/NODE
 /NODE[=(node[,...])]
 Causes the specified agent resets to occur only on the specified nodes.
If no node names are specified, the local node is used by default.
.I-1
1 REVIEW
 Displays the subscribers of a locally-managed mailing list.
.NJ
 Format:
 REVIEW list-name
.J
.I-1
2 Qualifier
.I-1
/OUTPUT
 /OUTPUT=file-spec
 Directs the output of the REVIEW command to the specified file.
.I-1
1 SAVE
 Saves the current MX configuration to a file.  To be used by the Router
and other processing agents, the file must be called MX__CONFIG.MXCFG and
reside in the MX__DIR directory.  Alternatively, you can define the system-wide
logical name MX__CONFIG (in exec mode) to point to the real location of the
MX configuration file to be used by the processing agents.
.NJ
 Format:
 SAVE file-spec
.J
.I-1
1 SET
 The SET command sets flags for use by some of the delivery agents.
.NJ
 Format:
 SET  option
.J
.I-1
2 DECNET__SMTP
 The SET DECNET__SMTP command sets flags for use by the SMTP-over-DECnet
delivery agent.
.NJ
 Format:
 SET DECNET__SMTP
.I-1
3 Qualifiers
.I-1
/ACCOUNTING
 /ACCOUNTING
 /NOACCOUNTING  (default)
.J
 Controls whether accounting records are written by the delivery agent.
If enabled, accounting records are written to the file MX__DNSMTP__ACC
(with a default directory of MX__DNSMTP__DIR: and a default type of DAT).
.I-1
/MAXIMUM__RETRIES
 /MAXIMUM__RETRIES=n
 Specifies the maximum number of times the DECnet-SMTP agent should
try to deliver a message if the message cannot be delivered (due to
network failure).  The default is 96.
.I-1
/RETRY__INTERVAL
 /RETRY__INTERVAL=hh:mm:ss
 Specifies the minimum amount of time that should elapse between attempts
to deliver a message.  The default is 00:30:00 (30 minutes).
.I-1
2 LOCAL
 The SET LOCAL command sets flags for use by the local delivery agent.
.NJ
 Format:
 SET LOCAL
.I-1
3 Qualifiers
.I-1
/ACCOUNTING
 /ACCOUNTING
 /NOACCOUNTING  (default)
.J
 Controls whether accounting records are written by the delivery agent.
If enabled, accounting records are written to the file MX__LOCAL__ACC
(with a default directory of MX__LOCAL__DIR: and a default type of DAT).
.I-1
/CC__POSTMASTER
 /CC__POSTMASTER
 /NOCC__POSTMASTER
 Specifies whether or not error messages resulting from LOCAL delivery
errors are mailed to the local POSTMASTER, in addition to the original
message sender.
.I-1
/DISABLE__EXQUOTA
 /DISABLE__EXQUOTA[=[NO]FATAL]
 /NODISABLE__EXQUOTA
 Specifies whether the EXQUOTA privilege should be disabled during
local delivery attempts.  By default, EXQUOTA remains enabled during
local message delivery.  Specifying /DISABLE__EXQUOTA=FATAL causes messages
that exceed the recipient's diskquota to be returned to sender immediately,
rather than going through normal retry procedures.
.I-1
/HEADERS
 /HEADERS=(TOP:([NO]hdrname[,...]),BOTTOM:([NO]hdrname[,...]))
.J
 Controls the placement of message headers in local delivery of messages.
Any or all headers may be placed at the top and/or bottom of the message,
or not added to the message at all.  Valid values for hdrname are:
.i+10;ALL
.i+10;BCC
.i+10;CC
.i+10;DATE
.i+10;ENCRYPTED
.i+10;FROM
.i+10;IN__REPLY__TO
.i+10;KEYWORDS
.i+10;MESSAGE__ID
.i+10;OTHER
.i+10;RECEIVED
.i+10;REFERENCES
.i+10;REPLY__TO
.i+10;RESENT__BCC
.i+10;RESENT__CC
.i+10;RESENT__DATE
.i+10;RESENT__FROM
.i+10;RESENT__MESSAGE__ID
.i+10;RESENT__REPLY__TO
.i+10;RESENT__SENDER
.i+10;RESENT__TO
.i+10;RETURN__PATH
.i+10;SENDER
.i+10;SUBJECT
.i+10;TO
 The hdrname keywords may be negated.  ALL specifies all headers;
NOALL specifies no headers.  OTHER specifies all headers with a header
name not matching one of the other keywords.
.I-1
/LONG__LINES
 /LONG__LINES
 /NOLONG__LINES (default)
 Specifies that lines exceeding the MAIL-11 255 character maximum
should not be wrapped during delivery to what appears to be a
local user.  This setting is disabled by default, so lines exceeding
the maximum length get wrapped at the nearest whitespace character
to the limit (if there are any).  Enabling this
setting could cause mail delivery via VMS MAIL's DECnet support to
fail when MX cannot determine that a recipient is a DECnet
address.
.I-1
/MAXIMUM__RETRIES
 /MAXIMUM__RETRIES=n
 Specifies the maximum number of times the local delivery agent should
try to deliver a message if the message cannot be delivered (due to
DECnet outage or locked mail file).  The default is 96.
.I-1
/MULTIPLE__FROM
 /MULTIPLE__FROM (default)
 /NOMULTIPLE__FROM
 Controls whether or not the VMS Mail ``From:'' line on incoming
messages can contain multiple return addresses.  By default, if an
RFC822 From: or Reply-To: line contains more than one address, as many
of those addresses as will fit are included on the VMS Mail ``From:''
line (up to 255 characters).  Specifying /NOMULTIPLE__FROM limits the
``From:'' line to a single address.
.I-1
/OMIT__RESENT__HEADERS
 /OMIT__RESENT_HEADERS
 /NOOMIT__RESENT_HEADERS (default)
 Specifies that MX forwarding using VMS Mail SET FORWARD should
omit the Resent- headers MX normally uses to detect forwarding loops.
This setting is disabled by default, and should only be enabled if
users' mail clients have trouble interpreting Resent- headers.
.I-1
/QP__DECODE
 /QP__DECODE
 /NOQP__DECODE
 Specifies whether or not incoming MIME quoted-printable messages are
automatically decoded by MX Local before delivery through VMS Mail.  By
default, such messages are decoded.  If your users read their mail via
POP or IMAP, you might want to disable the decoding to let the users'
browsers do the decoding.
.I-1
/RETRY__INTERVAL
 /RETRY__INTERVAL=hh:mm:ss
 Specifies the minimum amount of time that should elapse between attempts
to deliver a message.  The default is 00:30:00 (30 minutes).
.I-1
2 MLF
 The SET MLF command sets global parameters for the MLF
Mailing List/File Server agent.
.NJ
 Format:
 SET MLF [qualifiers]
.I-1
3 Qualifiers
.I-1
/DELAY__DAYS
 /DELAY__DAYS=(dow[,...])
 /NODELAY__DAYS
 Sets the days of the week on which all file servers'
delayed-send threshold should be honored.  Defaults
to all days of the week.
.I-1
/RECIPIENT__MAXIMUM
 /RECIPIENT__MAXIMUM=number
 /NORECIPIENT__MAXIMUM
 Sets the maximum number of recipients per message generated
by the MLF agent.  If your MLF agent services large mailing
lists with many remote subscribers, you may want to use this
setting to limit the number of recipients per message generated
by MLF.  This will break up the distribution to the mailing list
into smaller chunks, allowing for more parallelism in delivery.
 Setting too small a value, however, could create a lengthy backlog
in your MX message queue, depending on the number of subscribers
on your mailing list(s) and the number of messages the list receives
each day.
 The default is /NORECIPIENT__MAXIMUM, which forces each incoming
mailing list message to be forwarded as just one outbound message.
.I-1
2 ROUTER
 The SET ROUTER command sets flags for use by the Router.
.NJ
 Format:
 SET ROUTER [qualifiers]
.I-1
3 Qualifiers
.I-1
/ACCOUNTING
 /ACCOUNTING
 /NOACCOUNTING  (default)
.J
 Controls whether accounting records are written by the Rourter.
If enabled, accounting records are written to the file MX__ROUTER__ACC
(with a default directory of MX__ROUTER__DIR: and a default type of DAT).
 One accounting record is written for each recipient of each routed message,
either successful or unsuccessful.
.I-1
/OMIT__VMSMAIL__SENDER
 /OMIT__VMSMAIL__SENDER
 /NOOMIT__VMSMAIL__SENDER (D)
 Enables or disables the omission of the Sender: header for messages
sent from VMS Mail.  Needed by some sites to work with other mailers that
don't adhere to RFC822.
.I-1
/PERCENT__HACK
 /PERCENT__HACK (D)
 /NOPERCENT__HACK
 Specify /NOPERCENT__HACK when you want to disable the automatic resolution
of percent-hacked addresses.  It is enabled by default, and automatically
translates addresses of the form "user%host@localhost" to "user@host".
Percent-hack resolution may need to be disabled when you need to pass
MX mail through the VMS Mail interface and into another mail system.
.I-1
2 SITE
 The SET SITE command sets flags for use by the SITE delivery agent.
.NJ
 Format:
 SET SITE
.I-1
3 Qualifiers
.I-1
/MAXIMUM__RETRIES
 /MAXIMUM__RETRIES=n
 Specifies the maximum number of times the SITE agent should
try to deliver a message if the message cannot be delivered (due to
network failure).  The default is 96.
.I-1
/RETRY__INTERVAL
 /RETRY__INTERVAL=hh:mm:ss
 Specifies the minimum amount of time that should elapse between attempts
to deliver a message.  The default is 00:30:00 (30 minutes).
.I-1
2 SMTP
 The SET SMTP command sets flags for use by the SMTP delivery agent
and SMTP server.
.NJ
 Format:
 SET SMTP
.I-1
3 Qualifiers
.I-1
/ACCOUNTING
 /ACCOUNTING
 /NOACCOUNTING  (default)
.J
 Controls whether accounting records are written by the delivery agent.
If enabled, accounting records are written to the file MX__SMTP__ACC
(with a default directory of MX__SMTP__DIR: and a default type of DAT).
.I-1
/AUTHENTICATION
 /AUTHENTICATION=(type,...)
 /NOAUTHENTICATION (default)
.J
 Enables or disables the authentication extension in the SMTP server.
The "type" keyword can be CRAM__MD5, which enables the use of MX's
private authentication database (see CREATE USER__DATABASE__FILE),
or PLAIN, which enables the use of the VMS user authorization file.
 Specifying /NOAUTHENTICATION disables the authentication completely.
.I-1
/DEFAULT__ROUTER
 /DEFAULT__ROUTER=domain-name
 Specifies the name of a host through which all SMTP-bound mail should
be sent if a host name lookup fails.
.I-1
/DNS__RETRIES
 /DNS__RETRIES=n
 Specifies the maximum number of attempts to deliver a message when the
host name in a destination address cannot be resolved.  The default is
12.
.I-1
/MAXIMUM__RETRIES
 /MAXIMUM__RETRIES=n
 Specifies the maximum number of times the SMTP agent should
try to deliver a message if the message cannot be delivered (due to
network failure).  The default is 96.
.I-1
/PERCENT__HACK
 /PERCENT__HACK (D)
 /NOPERCENT__HACK
 Specify /NOPERCENT__HACK when you want to reject any addresses containing
a percent-sign in the username portion of the address.  Such addresses
are accepted by default.  Disabling the percent hack may be necessary to
prevent other sites from using this feature to relay e-mail through your
system.
.I-1
/RBL__CHECK
 /RBL__CHECK[=(domain-name,...)]
 /NORBL__CHECK (default)
 Specifies whether the SMTP server should check to see if a
system connecting to it is on an Internet Realtime Blackhole List (RBL).
RBL checking is disabled by default.
 You must specify one or more domain names as values for this qualifier;
consult your RBL provider for information on the domain names to use.
.I-1
/RELAY__ALLOWED
 /RELAY__ALLOWED (default)
 /NORELAY__ALLOWED
 Specifies whether the SMTP server will allow messages to be relayed
through your system from one outside system to another.  This is
allowed by default.  If you disable the relay function with
/NORELAY__ALLOWED, you may also need to tell MX which domains
it should consider "local" for the purposes of this check.  See
the DEFINE LOCAL__DOMAIN command for more information.
.I-1
/RETRY__INTERVAL
 /RETRY__INTERVAL=hh:mm:ss
 Specifies the minimum amount of time that should elapse between attempts
to deliver a message.  The default is 00:30:00 (30 minutes).
.I-1
/TLS
 /TLS
 /NOTLS  (default)
.J
 Controls whether SMTP_SERVER advertises and supports the STARTTLS
ESMTP command documented in RFC3207.
.I-1
/VALIDATE__SENDER__DOMAIN
 /[NO]VALIDATE__SENDER__DOMAIN
 Enables or disables a check in the SMTP server on whether the
domain name appearing in an SMTP MAIL FROM command appears in the Domain Name System.
When enabled, a message from a sender whose domain name is invalid is
rejected.  This setting is disabled by default.
.I-1
/VERIFY__ALLOWED
 /[NO]VERIFY__ALLOWED
 Enables or disables the processing of VRFY commands by the SMTP server.
By default, VRFY is enabled.  System administrators concerned about
network security should specify /NOVERIFY__ALLOWED to disable the VRFY
command in the SMTP server.
.I-1
1 SHOW
 The SHOW command displays all or part of the MX configuration.
.NJ
 Format:
 SHOW ALIASES [pattern]
 SHOW CONFIGURATION__FILE
 SHOW DECNET__SMTP
 SHOW FILE__SERVER [pattern]
 SHOW LISTS [pattern]
 SHOW LOCAL
 SHOW LOCAL__DOMAINS
 SHOW PATHS [pattern]
 SHOW REWRITE__RULES [pattern]
 SHOW ROUTER
 SHOW SITE
 SHOW SMTP
 SHOW SYSTEM__USERS
 SHOW USERS [pattern]
 SHOW VERSION
 SHOW ALL
.J
 Those commands taking a pattern will display all entries matching the specified
pattern, which defaults to "*".  SHOW ALL displays all of the configuration
information.
.I-1
2 Qualifiers
.I-1
/BRIEF
 /BRIEF
 The /BRIEF qualifier causes SHOW to display information in an
abbreviated format.  Only SHOW LISTS has a brief display; for all
other commands, the brief and full displays are identical.
.I-1
/COMMAND
 /COMMAND
 /NOCOMMAND (default)
 The /COMMAND qualifier causes the SHOW output to be formatted as MCP
commands, which could be executed later to reconstruct the configuration.
By default, the configuration information is displayed in a more
eye-pleasing and descriptive format.
.I-1
/FULL
 /FULL (default)
 The /FULL qualifier causes SHOW to display information in its
normal, full format.  Only SHOW LISTS has a brief display; for all
other commands, the brief and full displays are identical.
.I-1
/OUTPUT
 /OUTPUT=file-spec
 The /OUTPUT qualifier can be used to direct the SHOW output into a file.
When used with the /COMMAND qualifier, SHOW/OUTPUT can be used to create
a command file that can be edited and then read back in with the "@"
input-indirection function to create a new configuration file from scratch.
.I-1
1 SHUTDOWN
 Sends a shutdown signal to one or more MX delivery agent processes, causing
them to exit cleanly.
.NJ
 Format:
 SHUTDOWN [agent,...]
.J
 Accepted agent names are: DECNET__SMTP, LOCAL, MLF, ROUTER, SITE,
SMTP, SMTP__SERVER, and HOLDING__QUEUE=n (where n ranges
from 1 to 32, the maximum number of holding queues).  HOLD1 through HOLD8 are
obsolete but still supported for backward compatibility with prior versions
of MX.
If omitted, all agents are shut down.
.I-1
2 Qualifiers
.I-1
/CLUSTER
 /CLUSTER
 Causes the specified agent shutdowns to occur cluster-wide.  By default,
SHUTDOWN affects only agents on the local node.
.I-1
/NODE
 /NODE[=(node[,...])]
 Causes the specified agent shutdowns to occur only on the specified nodes.
If no node names are specified, only agents on the local node are affected.
.I-1
/WAIT
 /WAIT
 /NOWAIT (default)
 Waits for the specified agent to exit before returning (up to 30 seconds).
.I-1
1 STATUS
 Displays the status of one or more MX agent processes.
.NJ
 Format:
 STATUS [agent,...]
.J
 Accepted agent names are: DECNET__SMTP, LOCAL, MLF, ROUTER, SITE,
SMTP, SMTP__SERVER, and HOLDING__QUEUE=n (where n ranges
from 1 to 32, the maximum number of holding queues).  HOLD1 through HOLD8 are
obsolete but still supported for backward compatibility with prior versions
of MX.
If omitted, status of all running agent processes is displayed.  For each
process, the process ID, node name (on VMScluster systems), process name,
and agent type are displayed.
.I-1
2 Qualifier
.I-1
/NODE
 /NODE=(node[,...])
 Causes the display of only those specified agents running on the specified
nodes.
.!
.I-1
1 SPAWN
 SPAWN is used to create a subprocess and transfer control to it.
.NJ
 Format:
 SPAWN [command]
.J
.I-1
2 Parameter
 command
 Specifies a command line to be executed within the spawned subprocess. 
If a command is given, then the spawned process will be deleted after
that command is executed.
.I-1
2 Examples
.LITERAL
   1.  prompt> SPAWN DIRECTORY
       [Output of the DIRECTORY command]
          .
          .
          .
       prompt>

     The command above demonstrates spawning a subprocess to execute
     a particular command.

   2.  prompt> SPAWN
       sub_prompt>  dir
          .
          .
          .

     The spawned process created above will stick around until it
     is explictly deleted (or its parent process is deleted). Once
     you SPAWN a subprocess, you can transfer control between it and
     program by using the DCL and program ATTACH commands.
.END LITERAL
.!
.I-1
1 ATTACH
 ATTACH is used to transfer control to another process in the current
process tree.
.NJ
 Format:
 ATTACH [process]
.J
.I-1
2 Parameter
 process
 Specifies the process name of the process to which to attach.  Not
required if one of the ATTACH qualifiers is used.
.I-1
2 Qualifiers
.I-1
/IDENTIFICATION
 /IDENTIFICATION=pid
 Specifies the PID of the process to which to attach.
.I-1
/PARENT
 /PARENT
 Transfers control to the parent process of the process running MCP.
Returns an error if MCP is not running in a subprocess.
.I-1
2 Examples
.LITERAL
     MCP> ATTACH GOATHUNTER_1

     The command above demonstrates attaching to the subprocess
     named "GOATHUNTER_1".
.END LITERAL