home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / comm / Mail+News / UMS11 / Doc / english / import.man < prev    next >
Text File  |  1995-04-23  |  2KB  |  72 lines
  1.  
  2.                 IMPORT (V 2.4)
  3.                 ~~~~~~
  4.  
  5. Format:   IMPORT <name> <password> [SERVER <server>] [<file>]
  6. ~~~~~~~   [GROUP <grouppattern>] [RESTORE] [NOUPDATE]
  7.  
  8. Template: USER/A,PASSWORD/A,SERVER/K,FILE,GROUP/K,RESTORE/S,NOUPDATE/S
  9. ~~~~~~~~~
  10.  
  11. Purpose:  Import messages to a UMS message-base
  12. ~~~~~~~~
  13.  
  14. Specification:
  15. ~~~~~~~~~~~~~~
  16. Files written by EXPORT or UMSDOCTOR can be imported to a UMS message-
  17. base with IMPORT.
  18.  
  19. For  advantages  of using EXPORT and IMPORT for transportings messages
  20. between   dirrefent   message-bases   and   making   backups  see  the
  21. documentation for EXPORT.
  22.  
  23. File  created  by  UMSDOCTOR  can  be  imported  to  a (newly created)
  24. message-base, too.
  25.  
  26.  
  27. Invocation:
  28. ~~~~~~~~~~~
  29. you  must  specify a username and password to log into the (optionally
  30. specified) UMS server that the messages are written to.
  31.  
  32. If you specify the filename <file>, this will be the file that is read
  33. from.  Otherwise input will be taken from stdin.
  34.  
  35. The  GROUP  option  allows you to give an AmigaDOS style pattern, that
  36. the  groups  of  imported messages are matched against.  Only messages
  37. with  matching  groups  are  imported,  others are ignored.  Note that
  38. private  messages  have  no  group.  This matches like an empty string
  39. (pattern "%").
  40.  
  41. When  restoring  from  a  backup  or  a file created by UMSDOCTOR, you
  42. should use the RESTORE keyword. This makes IMPORT behave differently:
  43.  - the Receive-Date will be set to the original one, if possible
  44.  - messages will become "old" to all users
  45.  - access rights will be calculated differently by the umsserver
  46.  
  47. The  NOUPDATE  option  makes  imported  messages  "new"  even  for the
  48. importing user.
  49.  
  50.  
  51. Examples:
  52. ~~~~~~~~~
  53.  
  54. 1)
  55. Restore messages after a MB breakdown from a file created by
  56. UMSDOCTOR:
  57.  
  58.   1> import sysop password Spool:umsdoctor.export restore
  59.  
  60.  
  61. 2)
  62. Retrieve all groups with substring "UMS" from an archive on tape:
  63.  
  64.   1) import sysop password btntape:r group "#?ums#?" noupdate
  65.  
  66.  
  67. Other examples:  see the documentation for EXPORT
  68.  
  69.  
  70. See Also: EXPORT, UMSDOCTOR
  71. ~~~~~~~~~
  72.