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_PURGECC_PROMPTCOPY_SELFDELETED
EDITORFILEFOLDERFORMFORWARDKEYMAIL_DIRECTORY
NEW_MAIL_COUNTPERSONAL_NAMEQUEUEWASTEBASKET_NAME
ALL

  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 AUTO_PURGE
       SET NOAUTO_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 determining whether the carbon copy (CC:) prompt
  appears when sending a message.

   Format:

       SET CC_PROMPT
       SET NOCC_PROMPT
       SHOW CC_PROMPT

Additional information available:

Examples

  1.
       MAIL> SET CC_PROMPT
       MAIL> SEND
       To: Smith
       CC: Jones
       Subject: Meeting on Monday
      Enter your message below.  Press CTRL/Z when complete, or CTRL/C to quit:

  This example shows how to set the carbon copy prompt. A copy of the
   message is sent to user JONES.

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

  By specifying NOSEND, NOREPLY or NOFORWARD 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, FORWARD, or NOFORWARD.  You can use NOSEND,
  NOFORWARD, and NOREPLY to reverse previous settings of SEND, FORWARD,
  and REPLY, respectively.

  1.
       MAIL> SHOW COPY_SELF
       Automatic copies to yourself are disabled

  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 copied back to you.  The
  SHOW COPY_SELF command indicates that  you  have  enabled  automatic
  copying.

  Displays the amount of deleted message space in the current mail
  file.

   Format:

       SHOW DELETED

Additional information available:

Examples

  1.
       MAIL> SHOW DELETED
       Mail file DISK$NOE:[TOM.NEWMAIL]MAIL.MAI;1 contains 234 deleted
        message bytes.

       This example displays the number of deleted message bytes.

  Enables you to specify the editor that you wish to use for the SEND,
  REPLY, FORWARD and EDIT commands.

  The SET NOEDITOR command  sets your editor to EDT.

  The SHOW EDITOR command displays your editor.


   Format:

       SET EDITOR editor_name
       SET NOEDITOR
       SHOW EDITOR

Additional information available:

ParametersExamples

 editor_name

  Specifies the name of the editor you wish to use.  Specify any callable
  editor on your system.

  1.
       MAIL> SET EDITOR TPU

  This example shows how to set the editor for the SEND, REPLY, FORWARD
  and EDIT commands to TPU.

  2.
       MAIL> SHOW EDITOR
       Your editor is TPU.

  This example shows how to use the SHOW EDITOR command to display your
  editor setting.

  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
       Your current mail file is DISK$:[ARAS]MAIL.MAI;2
       MAIL> 2
       MAIL> COPY
       _Folder: LIMERICKS
       _File: JOKES
       File DISK$:[ARAS]JOKES does not exist.
       Do you want to creat it (Y/N)?
       %MAIL-S-CREATED, DISK$:[ARAS]JOKES.MAI;1 created
       %MAIL-I-NEWFOLDER, folder LIMERICKS created

       MAIL> SET FILE JOKES
       MAIL> SHOW FILE
       Your current mail file is 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 copies message 2 into this folder;  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 folder-name

Additional information available:

ParametersQualifiersExamples

 folder-name

  The name of the folder to be selected. If no folder name is specified,
   the folder with the same name as the mail file is selected.

Additional information available:

/BEFORE/CC_SUBSTRING/FROM_SUBSTRING/MARKED/NEW
/REPLIED/SINCE/SUBJECT_SUBSTRING/TO_SUBSTRING

 /BEFORE=date

 Indicates that messages dated before the specified date be selected.

 /CC_SUBSTRING=text
  Selects messages which contain "text" in the CC field of the message.

 /FROM_SUBSTRING=text

  Selects messages which contain "text" in the FROM field of the message.

 /[NO]MARKED

 Selects messages which have been marked. The /NOMARKED qualifier
  selects messages that are not marked.

 /NEW

 Indicates that new (unread) messages be selected.  When a mail file other
  than your default mail file is open, MAIL closes the file and opens your
  default mail file.

 /[NO]REPLIED

 Selects messages which have been replied to with the REPLY command.
  The /NOREPLIED qualifier selects messages that have not been
  replied to.

 /SINCE=date

 Indicates that messages dated on or after the specified date be selected.

 /SUBJECT_SUBSTRING=text
  Selects messages which contain "text" in the SUBJECT field of the
   message.

 /TO_SUBSTRING=text

 Selects messages which contain "text" in the TO field of the message.

  1.
       MAIL> DIRECTORY/FOLDERS

       MAIL               NEWMAIL
       WASTEBASKET        JOKES

       MAIL> SET FOLDER WASTEBASKET

       %MAIL-I-SELECTED, 3 messages selected

       MAIL> DIRECTORY

                                             WASTEBASKET
       #   From    Date             Subject

       1   GORK    19-APR-1988      Venus Fly Traps
       2   GORK    21-APR-1988      The Aloe
       3   BURT    22-APR-1988      Scales

  This example shows how to display all currently existing folders.
  The SET FOLDER command moves you to the WASTEBASKET folder.

  Sets the default print form. Avoids jobs from sitting in a queue
  with a pending status because its print form does not match the
  default queue set with the SET QUEUE command. The SET NOFORM command
  clears the print form and specifies the default form as SYS$PRINT.
  Use the DCL command SHOW QUEUE/FORM or see your system manager
  for valid forms on your system.
   Format:

       SET FORM form-name
       SET NOFORM
       SHOW FORM

Additional information available:

Examples

  1.
       MAIL> SHOW FORM

       You have not specified a form

       MAIL> SET FORM MEMO
       MAIL> SHOW FORM

       Your default print form is MEMO

       MAIL>

  This example shows how to set your default form to MEMO.

  Sets a forwarding address for your mail.  After you  enter  the  SET
  FORWARD command, the address you specify receives 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 FORWARD address
       SET NOFORWARD
       SHOW FORWARD

Additional information available:

ParametersQualifiersExamples

 address

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

Additional information available:

/ALL/USER

 /ALL

 Lists forwarding information or displays a message if the specified
  user does not have forwarding enabled.

 /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. The user name can be specified, or you
  can use the wildcard characters (* or %) to search for names with a
  particular string in common.

  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.

  2.
       MAIL> SHOW FORWARD/ALL/USER=C*
       Username                Forwarding address
       CARTON                   VIOLET::CARTON
       COLLINS                  None
       CRUTHERS                 GREEN::CRUTHERS

  This example shows a wildcard search for all users whose names begin
  with the letter 'C'. Since the /ALL qualifier has been specified, all
  users are listed, even if they have not entered a forwarding address.
  COLLINS has not entered a forwarding address, therefore, None appears
  under the "Forwarding address" heading.

  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

 Displays 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 select 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:  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]
       SET NOMAIL_DIRECTORY
       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
  and mailing address, 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 PERSONAL_NAME "text-string"
       SET NOPERSONAL_NAME
       SHOW PERSONAL_NAME

Additional information available:

ParametersQualifiersExamples

 "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  alphabetic character and avoid two consecutive embedded
  spaces within the string.  The length of  the  "text-string"  should
  not  exceed  127 characters.

Additional information available:

/ALL/USER

 /ALL

 Lists personal name information or displays a message if the specified
  user has not entered a personal name.

 /USER=username

 Allows a user with SYSNAM privilege to see personal names set by other
  users. The user name can be specified, or you
  can use the wildcard characters (* or %) to search for names with a
  particular string in common.

  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-1988 15:34
       To:      FLAXEN::STARCK

  This example shows how a user named Bellini sets her  personal  name
  to Catherine the Great.
  2.
       MAIL> SHOW PERSONAL_NAME/ALL/USER=A*N
       Username              Fullname
       ACKEN                 Joe Joe
       ANDERSON              Hans Christian
       ARRON                 None

  This example shows a wildcard search for all users whose names begin
  with the letter 'A' and end with letter 'N'. Since the /ALL qualifier
  has been specified, all users are listed, even if they have not
  entered a personal name. ARRON has not entered a personal name,
  therefore, None appears under the "Fullname" heading.

  Sets the default print queue field in the user profile. SET NOQUEUE
  clears the previously defined print queue and sets the queue
  to SYS$PRINT, the default print queue. See your system manager for
  valid queue names on your system.

   Format:

       SET QUEUE queue-name
       SET NOQUEUE
       SHOW QUEUE

Additional information available:

Examples

  1.
       MAIL> SHOW QUEUE
       Your default queue is SYS$PRINT.

       MAIL> SET QUEUE LASER$PRINT

       MAIL> SHOW QUEUE
       Your default print queue is LASER$PRINT

       MAIL> 4
       MAIL> PRINT
       MAIL> exit
        Job MAIL (queue LASER$PRINT, entry 43) started on LASER$PRINT

  This example shows set your default queue to LASER$PRINT and print
  message 4. The PRINT command sends the print job to the queue
  specified by the SET QUEUE command.

  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 WASTEBASKET_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".
       Your editor is TPU.
       CC prompting is disabled.
       Automatic copies to yourself are disabled.
       Automatic deleted message purge is enabled.
       Your default print queue is SYS$PRINT.
       You have not specified a default print form.


  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 she receives a CC: prompt when sending mail

  o  Whether or not you 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)

  o  The default print queue

  o  The default print form when she prints her mail messages