rcvstore(1mh)															     rcvstore(1mh)

Name
       rcvstore - incorporate new mail asynchronously

Syntax
       rcvstore [ +folder ] [ -[no]create ] [ -help ] [ -sequence name ] [ -[no]public ] [ -[no]zero ]

Description
       The  command  incorporates  a  message from the standard input into an MH folder.  If a +folder argument is not given the file is placed in
       your folder.  The new message being incorporated is assigned the next highest number in the folder.

       If the specified (or default) folder does not exist, it is created if the -create option is specified; otherwise exits.

       If your file contains a Msg-Protect: entry, it is used as the protection on the newly created messages; otherwise the MH default of 0600 is
       used.  During all operations on messages, this initially assigned protection is preserved for each message.  You can use to change the pro-
       tection on an individual message, and the new protection is preserved thereafter.

       The command incorporates anything except zero length messages into your MH folder.

       If the profile entry Unseen-Sequence: is present and non-empty, then adds the newly incorporated message to each sequence named by the pro-
       file entry.  Note that does not zero each sequence prior to adding messages.

Options
       -create
       -nocreate Creates  the  specified  folder.  If you attempt to incorporate mail into a folder that does not exist, creates the folder if you
		 supply the -create option.  If you supply the -nocreate option, the folder is not created and exits.  The default is -create.

       -help	 Prints a list of the valid options to this command.

       -public
       -nopublic Sets the read permissions of sequences.  Normally, when you create a sequence with the -sequence  option,  the  sequence  is  not
		 accessible  to  other	MH  users.  The -public option makes the sequence accessible to other MH users.  You can use the -nopublic
		 option to ensure that the sequence that you create is only accessible to yourself.

       -sequence name
		 Specifies a sequence in which places the messages which it incorporates.  For more information on sequences, see The name of  the
		 sequence must begin with a letter, and must consist entirely of alphabetic or numeric characters; no punctuation is allowed.

       -zero
       -nozero	 Specifies whether to zero existing sequences before adding new messages.  Normally, removes all existing messages from a sequence
		 before adding messages to it.	If you specify the -nozero option, adds the messages it finds to  the  existing  contents  of  the
		 sequence.  This option only works with the -sequence option.

       The defaults for this command are:

	      +folder defaults to
	      -create
	      -nopublic if the folder is read-only, otherwise -public
	      -nozero

Profile Components
       Path:		  To determine your Mail directory
       Folder-Protect:	  To set protections when creating a new folder
       Msg-Protect:	  To set protections when creating a new message
       Unseen-Sequence:   To name sequences denoting unseen messages

Files
       The user profile.

See Also
       chmod(1), inc(1mh), mark(1mh), pick(1mh), mh-mail(5mh), mh_profile(5mh)

																     rcvstore(1mh)