1 NETMAIL

  The NETMAIL  program is used to display an entry in the NETMAIL
  mail database for a particular user.  This information consists
  of a USERNAME,  the "Name" that user goes by,  and any personal
  information entered by the user.  These last two items are also
  displayed  by the  VMSMAIL  program  when  the  "SHOW PERSONAL"
  command is issued, or when a users sends a mail message.  Also,
  the forward field is displayed  if the running username matches
  the displayed user entry.

  NETMAIL uses the  VMSMAIL database.  If the node a user resides
  on is a NETMAIL node, that user's personal information  will be
  changed by this program.  If the user does not reside on one of
  the NETMAIL nodes,  personal information on the local node will
  remain unchanged.

2 NETMAIL_Node
  The  NETMAIL  node for your  area is  determined by your system
  manager.  This allows you to enter "NETMAIL::username" when you
  want to send a message to  another user on the  NETMAIL system.
  There can be more  than one  NETMAIL  node on an  inter-company
  Network. This mimimizes network traffic.  Since NETMAIL updates
  all mail nodes in  its system when a  user makes or modifies an
  entry,  other users can send messages without  needing to  know
  which node that user resides on.

  It is recommended  that when a user's home node is known,  mail
  should be addressed directly to the given user. That is to say,
  if user SMITH  resides on node AVAX,  send mail to AVAX::SMITH.
  Not to  NETMAIL::SMITH.  This will reduce the  amount  of  time
  needed to establish a logical link to the remote node.

  Example:

  $ mail
  MAIL> send
  To: NETMAIL::auser
  .
  .
  .

2 NETMAIL_Messages

  Informational Messages are:

  %NETMAIL-I-UPDERR, error updating all NETMAIL nodes, retry later.
  Action: There was an error during the update. Because NETMAIL may
          be updating more than one node, the user should try again
          at a later time to ensure the changes are made on all nodes.

  %NETMAIL-I-DECNET, establishing decnet link to node xxxxxx...
  Action: NETMAIL is informing the user that a link to the given node
          is being made.

  %NETMAIL-I-DELETE, delete complete on node xxxxxx.
  Action: The requested NETMAIL entry was deleted as requested.

  %NETMAIL-I-MODFWD, forward node matches NETMAIL node, entry adjusted.
  Action: NETMAIL is informaing the user that the forward field has
          been adjusted to ensure that inifinite looping with the VMS
          Mail system will not occure.

  %NETMAIL-I-NORECFND, requested record not found.
  Action: NETMAIL is informing the user that the entry requested for
          look up was not found. That user may not be in the NETMAIL
          system.

  %NETMAIL-I-NORECORD, username not in database.
  Action: The username specified was not found in the NETMAIL database.

  %NETMAIL-I-ROUTE, attempting to use alternate NETMAIL node.
  Action: NETMAIL is informaing the user that the local NETMAIL
          node was now available and it is attempting to use an
          alternate NETMAIL node.

  %NETMAIL-I-UPDATE, update complete on node xxxxxx.
  Action: Requested update was completed on the specified NETMAIL node.

  Warning Error Messages are:

  %NETMAIL-W-MAILUPD, unable to open mail data file on node xxxxxx.
  Action: NETMAIL could not open a NETMAIL database on the given node.
          If a user was updating their NETMAIL entry, the SET command
          should be rerun at a later time to ensure in NETMAIL database
          match.

  %NETMAIL-W-UPDERR, error updating all NETMAIL nodes, retry later.
  Action: There was an error opening or updating a NETMAIL node's
          database.

  %NETMAIL-W-UPDINT, interrupt during update, databases may not match.
  Action: An interrupt occured during an update. To ensure a user's
          entry if consistent across all NETMAIL nodes, the SET command
          should be rerun.

  Severe Error Messages are:

  %NETMAIL-F-ABORTUPD, Requested changes aborted.
  Action: User entered a negative response to prompt for approving
          changes to a NETMAIL entry.

  %NETMAIL-F-BADINPUT, Too few charaters entered.
  Action: When using the /USER or /NAME qualifier, less than 3
          characters were entered. NETMAIL does not allow wildcarding
          with less than 3 characters.

  %NETMAIL-F-CTRLC, ^C interrupt request acknowledged - NETMAIL aborted.
  Action: User entered a control-c; NETMAIL terminated abnormally.

  %NETMAIL-F-CTRLY, ^Y interrupt request acknowledged - NETMAIL aborted.
  Action: User entered a control-y; NETMAIL terminated abnormally.

  %NETMAIL-F-MAILFILE, Unable to open mail data file on node xxxxxx.
  Action: NETMAIL was unable to open the NETMAIL database on the
          displayed node. Node may be unavailable. If not, contact
          your system manager.

  %NETMAIL-F-NOINPUT, No input on command line.
  Action: User did not enter any command-line information for NETMAIL
          to process.

  %NETMAIL-F-NOMAILNODE, MAIL Node logical name not found.
  Action: Contact your system manager.

  %NETMAIL-F-NOLOCALNODE, Unable to find logical name for SYS$NODE.
  Action: Contact your system manager.

  %NETMAIL-F-NOPRIV, No privilege for attempted operation.
  Action: Attempt to use restricted feature of NETMAIL.

  %NETMAIL-F-NOUSERNAME, Unable to translate running username.
  Action: Contact your system manager.

  %NETMAIL-F-SETUSER, Program not installed with proper privileges.
  Action: Contact your system manager.

2 Parameters
  The parameters for NETMAIL  are DELETE,  LIST,  SHOW (default),
  and  SET.  Any user many  SHOW  another user's entry.  Only the
  current or running user may  SET (add/modifiy) or  DELETE their
  own entry, unless the running user is privileged. The parameter
  LIST is reserved for privileged users.

3 COMPARE
  The COMPARE parameter is used to display an  individual
  entry on each NETMAIL node. This feature is mainly used
  for checking  a user's various  entries to  assure they
  are consistent across the enitre NETMAIL system.

  Format:

  $ NETMAIL COMP/USER=auser

3 DELETE
  The DELETE parameter will remove a user's entry from all
  NETMAIL databases.  The /USER  qualifier is reserved for
  privileged users only.

  Format:

  $ NETMAIL DELETE
  $ NETMAIL DELETE/USER=auser

3 LIST
  The LIST parameter will display all entries in the local
  NETMAIL  database.  The LIST parameter  is reserved  for
  privileged users only.

  Format:

  $ NETMAIL LIST

3 SET
  The SET  parameter is used to add or modify an entry in
  the NETMAIL system. The /USER qualifier is reserved for
  privileged users only.

  Format:

  $ NETMAIL SET/qualifier/qualifier...

3 SHOW
  The  SHOW  parameter is used to  display an  individual
  entry  in the  NETMAIL  system  by username or personal
  name. This is the default parameter.

  Format:

 $ NETMAIL/USER=ausername
 $ NETMAIL/NAME=aname
 $ NETMAIL SHOW/USER=auser

2 Qualifiers
  The qualifiers used by NETMAIL  for displaying information with
  the SHOW parameter on a given user are:  /NAME and /USER.  When
  using either of these qualifiers,  at least three characters of
  the username to be looked up must be supplied.

  The qualifiers  used by  NETMAIL  for modifiying  an entry are:
  /NAME, /FORWARD, and /PERSONAL; /USER is a privileged qualifier
  with the SET parameter.

  No qualifiers are used with the LIST parameter.

  No qualifiers are used with the DELETE parameter, except when
  deleting another entry.  The /USER  qualifier is a privileged
  qualifier with the DELETE parameter.

/FORWARD
  The  /FORWARD  qualifier is used to determine the node a user
  would like their  NETMAIL forwarded to.  This forward node is
  set  the  same on all  NETMAIL  nodes,  except when the  user
  selects a home node  which is  also a  NETMAIL node.  If this
  is the case,  NETMAIL automatically adjusts the entry on that
  NETMAIL  node to avoid an infinite loop in forwarding.  If  a
  user  modifies their entry  and  does not  specify a  forward
  node,  the  current  node name and  username is  used as  the
  default.

  To override using the current node and username as a default
  when modifying an entry, use the /NOFORWARD qualifier.  This
  will leave the forward field untouched.

  Format:

  $ NETMAIL/FORWARD=node::username

/NAME
  The /NAME qualifier is used to select an entry for display or
  to set the name  field in the  NETMAIL  database for a  given
  entry. When used as a search field, at least three characters
  must  be supplied.  When used to  SET  the name  field in the
  NETMAIL database,  double quotation marks should be used if a
  space is entered between the first and last name.

  Format:

  $ NETMAIL/NAME=name
  $ NETMAIL SET/NAME=name/qualifier...

  Example:

  $ NETMAIL/NAME=SMITH
  $ NETMAIL SET/NAME="Joe Smith"

/NOFORWARD
  The /NOFORWARD qualifier is used to override the default set-
  ting of the  forward field in the  NETMAIL  database.  If the
  SET  parameter is  used and the  /NOFORWARD  qualifier is not
  used,  NETMAIL will set the forward field to the current node
  and username.

  Format:

  $ NETMAIL SET/NOFORWARD/qualifier...

  Example:

  $ NETMAIL SET/NAME="Joe Smith"/NOFORWARD

/PERSONAL
  The /PERSONAL qualifier is used to set the  personal field in
  the  NETMAIL  database.  This is a same field as the  VMSMAIL
  personal field. This field is then joined with the name field
  entered with the /NAME qualifier.

  Format:

  $ NETMAIL SET/PERSONAL="My personal information"

/USER
  The  /USER  qualifier is used to select a username to view or
  modify in the NETMAIL database. When modifying an entry, this
  qualifier is restricted to priviledged users.

  Formats:

  $ NETMAIL/USER=username
  $ NETMAIL SHOW/USER=username

  $ NETMAIL SET/USER=username/qualifiers...        (privileged)

