The SET command is used with other  commands  to  define  or  change
  characteristics  of  the  Mail  Utility.   The SHOW command displays
  information about the characteristics.

Additional information available:

AUTO_PURGECOPY_SELFFILEFOLDERFORWARD
KEYMAIL_DIRECTORYNEW_MAIL_COUNTPERSONAL_NAME
WASTEBASKET_NAMEALL

  Determines whether or not MAIL empties the WASTEBASKET  folder  when
  you  enter  the  EXIT  or  SET  FILE  command.  When you use the SET
  NOAUTO_PURGE command, you must enter the PURGE command  periodically
  to delete the messages in the WASTEBASKET folder.

  The default you establish with the SET AUTO_PURGE command remains in
  effect until you enter the SET NOAUTO_PURGE command.

  The SHOW AUTO_PURGE command indicates whether or not you  have  used
  the SET AUTO_PURGE command.

   Format:

       SET [NO]AUTO_PURGE
       SHOW AUTO_PURGE

Additional information available:

Examples

  1.
       MAIL> SET AUTO_PURGE
       MAIL> SHOW AUTO_PURGE
       Automatic deleted message purge is enabled

  This example shows how to use the SET AUTO_PURGE command  to  enable
  MAIL to delete the messages in the WASTEBASKET folder every time you
  enter the EXIT command or the SET FILE command.  The SHOW AUTO_PURGE
  command displays whether or not automatic purging is enabled.

  Sets the default for determining whether the SEND or REPLY  commands
  return a copy of the message being sent back to the user sending the
  message.

  By specifying NOSEND or NOREPLY with the SET COPY_SELF command,  you
  can  clear  any  default  copying  you have established with the SET
  COPY_SELF command.

  The SHOW COPY_SELF command displays the established copying.

   Format:

       SET COPY_SELF command [,command]
       SHOW COPY_SELF

Additional information available:

ParametersExamples

 command

  The "command" parameter can be any  one  of  the  following:   SEND,
  NOSEND,  REPLY,  NOREPLY.  You can use NOSEND and NOREPLY to reverse
  previous settings of SEND and REPLY, respectively.

  1.
       MAIL> SHOW COPY_SELF
       No automatic copies to yourself are enabled

  This example shows the message MAIL displays when you have not  used
  the SET COPY_SELF command and you enter the SHOW COPY_SELF command.

  2.
       MAIL> SET COPY_SELF SEND
       MAIL> SHOW COPY_SELF
       Automatic copy to yourself on SEND

  This example shows how to use the SET COPY_SELF  command  to  enable
  copies  of  mail  messages you SEND to be returned back to you.  The
  SHOW COPY_SELF command indicates that  you  have  enabled  automatic
  copying.

  Establishes (or opens) another file as the current  mail  file.   By
  default,  your  mail file is MAIL.MAI.  If you use the COPY command,
  the FILE command, or the MOVE command to  create  other  mail  files
  (for  example,  JOKES.MAI  or HISTORY.MAI), you can then use the SET
  FILE command to open the MAIL files.

  When you enter the SET FILE command, the WASTEBASKET folder  of  the
  current  mail file is emptied, the file is closed, and the specified
  (alternate) file is opened.

  The SHOW FILE command displays the name of the  mail  file  that  is
  currently open.

   Format:

       SET FILE file-name
       SHOW FILE

Additional information available:

ParametersExamples

 file-name

  Indicates the name of the mail file you are opening.  Your mail file
   directory and a filetype of MAI are used when opening the file.

  1.
       MAIL> SHOW FILE
       DISK$:[ARAS]MAIL.MAI;2
       MAIL> COPY
       _Folder: LIMERICKS
       _File: JOKES

       %MAIL-S-CREATED, DISK$:[ARAS]JOKES.MAI;1 created
       %MAIL-I-NEWFOLDER, folder LIMERICKS created

       MAIL> SET FILE JOKES
       MAIL> SHOW FILE
       DISK$:[ARAS]JOKES.MAI

  This example demonstrates how the SHOW  FILE  command  displays  the
  name  of  the  mail file that is currently open (MAIL.MAI); the COPY
  command creates a  new  folder  (LIMERICKS)  and  a  new  mail  file
  (JOKES);  and  the  SET  FILE  command  opens  the  mail  file named
  JOKES.MAI.

 Allows you to change folders within a mail file.  The SET FOLDER command
 selects a new folder, and the SHOW FOLDER command displays the currently
 selected folder.  Several qualifiers may be used with the SET FOLDER
 command.  See the SELECT command for a complete description.

  Format:

      SET FOLDER folder-name
      SHOW FOLDER

  Sets a forwarding address for your mail.  After you  enter  the  SET
  FORWARD command, the address you specify will receive mail messages.

  The default you establish with the SET FORWARD  command  remains  in
  effect until you enter the SET NOFORWARD command.

  The  SHOW  FORWARD  command  displays  the  name  of  the  specified
  forwarding address.

  If you have SYSNAM  privilege,  you  can  set  and  show  forwarding
  addresses for other users.

   Format:

       SET [NO]FORWARD address
       SHOW FORWARD

Additional information available:

ParametersQualifiersExamples

 address

  Indicates the address (NODE::NAME) to which your mail is  forwarded.
  The node name is not required.

[/USER=user-name]

 [/USER=user-name]

 Indicates the name of another  user  for  whom  you  are  setting  or
  showing  a forwarding address.  You can use the /USER qualifier only
  if you have SYSNAM privilege.

  1.
       MAIL> SET FORWARD NEXUS::LARS
       MAIL> SHOW FORWARD
       Your mail is being forwarded to NEXUS::LARS

       MAIL>

  This example shows how to establish a forwarding  address  with  the
  SET FORWARD command and display the forwarding address with the SHOW
  FORWARD command.

  Displays key definitions created by the DEFINE/KEY command.

   Format:

       SHOW KEY [key-name]

Additional information available:

ParametersQualifiers

 key-name

  Specifies the name of the key whose definition you want displayed.
  See the DEFINE/KEY command for a list of valid key names.

Additional information available:

/ALL/BRIEF/DIRECTORY/STATE

 /ALL

 Displays all the key definitions in the specified state or states. You
 do not need to specify a keyname.

 /BRIEF

 Displys only the key definition.  By default, you see all the qualifiers
 associated with the key definition, including any specified state, unless
 you use /BRIEF.

 /DIRECTORY

 Displays the names of all the states for which keys have been defined.
 If you have not defined any keys, SHOW KEY/DIRECTORY displays the
 DEFAULT and GOLD states (the default keypad defined by MAIL).

 /STATE=(state,state,...)

 Specifies the name of a state for which the specified key definitions
 are to be displayed.  If you selecte more than one state name, separate
 them with commas and enclose the list in parentheses.

  Moves all MAI files from the mail  directory  SYS$LOGIN:MAIL.MAI  to
  the specified subdirectory.

  The SET NOMAIL_DIRECTORY  command  moves  all  MAI  files  from  the
  subdirectory back to the mail directory SYS$LOGIN:MAIL.MAI.

  The SHOW MAIL_DIRECTORY command displays the name of the device  and
  directory containing all your MAI files.

   Format:

       SET MAIL_DIRECTORY [.subdirectory-name] SHOW MAIL_DIRECTORY

Additional information available:

ParametersQualifiersExamples

 .subdirectory-name

  Specifies the name of the subdirectory in your SYS$LOGIN:  directory
  to which all MAI files are to be moved.

Additional information available:

/LOG

 /LOG

 Displays a listing of the MAI files moved from the previous directory
  to the specified subdirectory.

  1.
       MAIL> SHOW MAIL_DIRECTORY
       DISK$:[DALTON]
       MAIL> SET MAIL_DIRECTORY [.MAIL]

       %MAIL-I-CREATED, DISK$:[DALTON.MAIL] created

       MAIL> SHOW MAIL_DIRECTORY
       DISK$:[DALTON.MAIL]

          .
          .
          .

       $ SET DEFAULT [DALTON.MAIL]
       $ DIRECTORY

  This example shows how to create a subdirectory containing all  your
  MAI files.

  Displays the number of  new  (unread)  messages.   This  is  a  SHOW
  command only; no SET NEW_MAIL_COUNT command exists.

   Format:

       SHOW NEW_MAIL_COUNT

Additional information available:

Examples

  1.
       MAIL> SHOW NEW_MAIL_COUNT
       You have 5 new messages.


  This example shows how to use the SHOW NEW_MAIL_COUNT to display the
  number of unread messages (in this case, 5).

  Enables you to append a field to the end of  the  "From:"  field  of
  mail messages you send.  You can fill this field with your full name
  or any other information.

  The SET NOPERSONAL_NAME  command  clears  any  name  you  previously
  specified with the SET PERSONAL_NAME command.

  The SHOW PERSONAL_NAME command displays your personal name.

  If you have SYSNAM privilege, you may show the personal name of another
  user by using the SHOW PERSONAL_NAME/USER=username command.

   Format:

       SET [NO]PERSONAL_NAME "text-string"

Additional information available:

ParametersExamples

 "text-string"

  Specifies the string for the "From:"  field  of  mail  messages  you
  send.   You  must  enclose the string in quotation marks; otherwise,
  MAIL converts it to uppercase letters.  You must  begin  the  string
  with  an  alphanumeric  character and avoid two consecutive embedded
  spaces within the string.  The length of  the  "text-string"  should
  not  exceed  127 characters.  Strings longer than 37 characters will
  wrap.

  1.
       MAIL> SET PERSONAL_NAME "Catherine the Great"

          .
          .
          .

       MAIL> SEND

          .
          .
          .

       New mail on node FLAXEN from ALPHA::BELLINI "Catherine the
       Great"

          .
          .
          .

       From:    ALPHA::BELLINI "Catherine the Great"  19-APR-1985 15:34
       To:      FLAXEN::STARCK

  This example shows how a user named Bellini sets her  personal  name
  to Catherine the Great.

  Enables you to change the  name  of  the  WASTEBASKET  folder.   The
  WASTEBASKET  folder  contains  messages selected to be deleted.  You
  can delete all the messages in the WASTEBASKET  folder  by  entering
  either  the  PURGE or EXIT command.  You can avoid deleting messages
  in the WASTEBASKET folder by entering the QUIT command.

  When you change the name of a WASTEBASKET folder while  it  contains
  deleted  messages,  these  deleted  messages move to the newly named
  WASTEBASKET folder.

  The  SHOW  WASTEBASKET_NAME  command  displays  the  name   of   the
  WASTEBASKET folder.

   Format:

       SET WASTEBASKET_NAME folder-name SHOW WATEBASKET_NAME

Additional information available:

ParametersExamples

 folder-name

  Indicates the name that replaces the name WASTEBASKET for the folder
  containing  deleted  messages.   You can use any alphanumeric string
  for the new WASTEBASKET folder name except MAIL or NEWMAIL.

  1.
       MAIL> SET WASTEBASKET_NAME GARBAGE
       MAIL> SHOW WASTEBASKET_NAME
       The wastebasket folder name is GARBAGE
       MAIL>


  This example shows how  to  change  and  display  the  name  of  the
  WASTEBASKET folder.

  Displays detailed information about the state of MAIL.   This  is  a
  SHOW command only; no SET ALL command exists.

   Format:

       SHOW ALL

Additional information available:

Examples

  1.
       MAIL> SHOW ALL
       Your mail file directory is DISK:[SIMPSON].
       Your current mail file is
       DISK$DOCUMENT:[SIMPSON.NEWMAIL]MAIL.MAI;1.
       Your current mail folder is MAIL.
       The wastebasket folder name is GARBAGE.
       Mail file DISK$DOCUMENT:[SIMPSON.NEWMAIL]MAIL.MAI;1
                contains 0 deleted message bytes.

       You have 3 new messages.

       You have not set a forwarding address.
       Your personal name is "Louise Simpson".
       Automatic copies to yourself are disabled.
       Automatic deleted message purge is enabled.


  This example shows how a user named Louise Simpson has  entered  the
  SHOW ALL command to display the following information about MAIL:

  o  The name of your mail file directory

  o  The current mail file and folder

  o  The name of the WASTEBASKET folder (see the SET  WASTEBASKET_NAME
     command)

  o  The amount of deleted message space

  o  The number of any new (unread) messages

  o  Your forwarding address, if set (see the SET FORWARD command)

  o  Your personal name, if set (see the SET PERSONAL_NAME command)

  o  Whether of not you will receive copies of mail messages you  SEND
     or ANSWER (see the SET COPY_SELF command)

  o  Whether or not MAIL empties the WASTEBASKET folder when you  EXIT
     or SET FILE (see the SET AUTO_PURGE command)