MHS Librarian! Admin Help.
--------------------------

The MHS Librarian! is used to allow users to request information from 
one MHS site to be forwarded to them at another.  The MHS Librarian! is an 
MHS gateway that is run on the MHS Server.  When mail is received by the  
gateway, MHS Librarian! will generate a reply message to the originator 
with the requested file attached.  



   ADDRESSING THE MESSAGE
   ----------------------

   The MHS username for the MHS Librarian! Gateway will vary, based upon the 
   installation, but for this discussion, we will assume LIBRARY @ HOST.

   MHS Librarian! assumes that it is to send the information requested to the 
   return address of the sender of the request, unless specified otherwise 
   in the TO: field using MHS's extended address scheme.

   Addressing Examples:

        LIBRARY @ HOST  

        will generate a message with the requested file attached and 
        address it to the sender of the request.

        LIBRARY @ HOST {USERNAME@REMOTE} 
        
        will generate a message with the requested file attached and 
        send it to USERNAME @ REMOTE.  


        LIBRARY @ HOST {USER2@HOST2 | more address junk} 

        Creates a message addressed to USER2 @ HOST2 {more address junk}.



   REQUESTING A FILE
   -----------------
      
       FOR FILES IN THE INDEX

       A library index can be created for access by users, identifying 
       the files that you would like to make available for requests.  The 
       source file for the index is a simple ASCII file that contains the 
       keyword, optional password, description, and the path and filename 
       for each item.  Each keyword in your list can have a separate 
       password.  
       
       You can also specify that the file (or files) be compressed before 
       they are sent.

       You make your requests on the subject line of your e-mail system, 
       using the form:
      
         KEYWORD
         KEYWORD=PASSWORD
   
       
       FOR FILES *NOT* IN THE INDEX

       System administrators can also configure MHS Librarian! so that 
       select users can request files or directory listings other than 
       those in the index.  This is useful for accessing files you 
       accidentally left at work or other location.  
      
       Security for this level of access is provided by the included 
       PASSWORD.EXE program, your own password program, or a password 
       data file that you create.  The PASSWORD.EXE program that ships 
       with MHS Librarian! can accept a variable you chose that gets 
       merged with it's password to insure a unique password, and will 
       generate a new password every day of operation.
       
       To request a file that is not in the index, use the form 
       PASSWORD=DRIVE:\PATH\FILENAME.EXT as the subject line of your
       message.  The filename *must* include the complete path to the file.  
       
       Example:

          PASSWORD=F:\PUBLIC\INIT.BAT

       If you want MHS Librarian! to compress the file, and have a copy of 
       PKZIP in the search path, you can add the option /ZIP in the subject.  
       
       Example:

         PASSWORD=F:\PUBLIC\INIT.BAT /ZIP

       NOTE:  Optionally, with the /ZIP option, you can request multiple 
              files.  This is the only means to get more than one file with 
              one request.


   SPECIAL REQUESTS
   ----------------
    
      DIRECTORY LISTINGS
    
      MHS Librarian! will allow you to request a directory of files for a 
      given directory by specifying the password, path and file mask on 
      the subject line.  
      
      Example:

        PASSWORD=F:\PUBLIC\*.* /DIR


      REQUESTING THE LOG

      To request that the Activity Log be sent to you and the Admin User,
      specify /LOG in the subject.  
      
      Example:

        PASSWORD=/LOG


