home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / mhs184.exe / SYS.EXE / MHSUSER.DOC < prev    next >
Text File  |  1993-08-10  |  9KB  |  247 lines
  1. MHSUSER -- MHS 1.5N
  2. Copyright 1991, Novell, Inc.
  3. Copyright 1984, 1990, Action Technologies, Inc.
  4. All rights reserved worldwide.
  5.  
  6. Usage: MHSUSER -X## Required and optional switches
  7.  
  8. X options:                            Required and {optional} switches
  9.   00  Show MHS configuration                                         {-D} {-V}
  10.  
  11.   01  Define new user of application   -U -S -A  {-P} {-E} {-O} {-Y} {-D} {-V}
  12.  
  13.         The -Y switch works as follows:
  14.  
  15.         -Y omitted:
  16.             Work as in MHSUSER 1.1: If application is a managed
  17.             application, then place as one of the "also-uses"
  18.             applications.  If all 4 also-uses applications are
  19.             used, then fail.  If application is an unmanaged
  20.             application, then add a directory for the user for
  21.             this application.
  22.  
  23.         -Y0:
  24.             Add application as preferred application and slide
  25.             any existing applications down removing any empty
  26.             application entries in the process.  If user already
  27.             has 5 applications, then fail.  If application is an
  28.             unmanaged application, then fail.
  29.  
  30.         -Y1:
  31.             Add as first available free managed application for
  32.             user.  If user already has 5 managed applications,
  33.             fail.  If specified application is an unmanaged
  34.             application, then fail.
  35.  
  36.   02  Delete user                      -U -S -A                      {-D} {-V}
  37.  
  38.   03  Query for list of users         {-U}  {-A}                     {-D} {-V}
  39.  
  40.   04  Verify user                      -U   {-A} {-P}                {-D} {-V}
  41.  
  42.   05  Change user's password           -U         -P  [-Q | -S]      {-D} {-V}
  43.  
  44.   10  Register/modify application         -S -A   -E  {-M} {-C}      {-D} {-V}
  45.  
  46.   11  Remove application                  -S -A                      {-D} {-V}
  47.  
  48.   21  Create Unique Message IDs                  {-I}                {-D} {-V}
  49.  
  50.   31  Add/Modify host               -H -T -S -E  {-R} {-U} {-P} {-C} {-D} {-V}
  51.  
  52.       This function will fail, returning exit errorlevel 33 if MHS Server 0
  53.       (the MHS Router) is running.
  54.  
  55.     -H    Host name to be added or modified
  56.     -T  Host type:
  57.             0 = HOST: Host reached via telephone call FROM that host
  58.             1 = HVIA: Host reached via an intermediary
  59.             2 = HUB:  Host reached via telephone call TO that host
  60.             3 = INET: Host reached via Internet path
  61.             4 = GTW:  Gateway
  62.  
  63.     -S  Admin's password
  64.     -E  Description (0 to 24 characters, use "_"  to enter spaces)
  65.     -R  Route:
  66.             HOST: optional "don't care" switch
  67.             HVIA: name of intermediary host
  68.             HUB:  telephone number of host
  69.             INET: internet path
  70.             GTW:  optional gateway commands
  71.     -U  NetWare username for NetWare internet sessions
  72.     -P  NetWare password for NetWare internet sessions
  73.         Remote host's password for other host types
  74.     -C  Optional host version (61 through 70 are valid -- 64 is default)
  75.  
  76.   32  Delete host                      -H -S                         {-D} {-V}
  77.  
  78.       This function will fail, returning exit errorlevel 33 if MHS Server 0
  79.       (the MHS Router) is running.
  80.  
  81.   33  List host table                     -S     {-H} {-T}           {-D} {-V}
  82.  
  83.   41  Add/Modify user routing          -U -S -E   -R                 {-D} {-V}
  84.  
  85.       This function will fail, returning exit errorlevel 33 if MHS Server 0
  86.       (the MHS Router) is running.
  87.  
  88.   42  Delete user routing              -U -S                         {-D} {-V}
  89.  
  90.       This function will fail, returning exit errorlevel 33 if MHS Server 0
  91.       (the MHS Router) is running.
  92.  
  93.   43  List user routings                  -S     {-U}                {-D} {-V}
  94.  
  95.   51  Add/Modify affiliated workgroup  -W -S -E                      {-D} {-V}
  96.  
  97.       This function will fail, returning exit errorlevel 33 if MHS Server 0
  98.       (the MHS Router) is running.
  99.  
  100.   52  Delete affiliated workgroup      -W -S                         {-D} {-V}
  101.  
  102.       This function will fail, returning exit errorlevel 33 if MHS Server 0
  103.       (the MHS Router) is running.
  104.  
  105.   53  List affiliated workgroups          -S     {-W}                {-D} {-V}
  106.  
  107.   60  Change schedule time             -B -S                         {-D} {-V}
  108.  
  109.       This function will fail, returning exit errorlevel 33 or 1 if MHS
  110.       Server 0 (the MHS Router) is running.
  111.  
  112.   61  Set MHS administrator            -U -S                         {-D} {-V}
  113.  
  114.   62  Verify MHS administrator         -U        {-S}                {-D} {-V}
  115.  
  116.   70  Repost                              -S     {-H}                {-D} {-V}
  117.  
  118.       This function will fail, returning exit errorlevel 33 if MHS Server 0
  119.       (the MHS Router) is running.
  120.  
  121.       Repost without the -h switch reposts all queues.  Repost with -h
  122.       reposts only the queue for the host specified after the -h switch.
  123.  
  124.  
  125. Example:
  126.  
  127. MHSUSER -X01 -Ujsmith -Spandora -Aatc -Pxyz -Ojims -V
  128.  
  129. This defines the MHS user jsmith with the password xyz.  The MHS
  130. administrator's password is pandora.  The rights to jsmith are assigned to the
  131. NetWare user jims.
  132.  
  133.  
  134. Switches:
  135.  
  136. -A            Application name; e.g., ATC, FWMAIL, DVSEMAIL
  137.  
  138. -B            Schedule Every: in "Set Up Transport
  139.                         Server" - the MHS cyle duration in second.
  140.  
  141. -C                      Compatibility version of MHS; i.e., 64
  142.                         for MHS 1.1n, 70 for MHS 1.5n.
  143.  
  144. -D                      The MV directory. (The parent directory of MHS).
  145.  
  146. -E                      A description of the application.  Any
  147.                         text will do.  The text does not need to
  148.                         match any previous description.
  149.  
  150. -H                      An MHS hostname.
  151.  
  152. -I                      The number of message-ids to generate.  If the -I
  153.                         switch is omitted, only one message-id is created.
  154.  
  155. -M                      Used for limiting the number of users
  156.                         that can be specified in MHS for a managed application
  157.  
  158. -O                      NetWare user to whom rights should be assigned for a
  159.                         local user being defined.
  160.  
  161. -P                      For defining a local user, the user's MHS password.
  162.                         For defining Internets, the password of the NetWare
  163.                         user on the remote file server.
  164.  
  165. -Q                      When changing a user's MHS password, the user's
  166.                         current MHS password.
  167.  
  168. -R                      For defining of hosts, -R varies according to the host
  169.                         type being defined.  (See 31, above).  For defining
  170.                         user routes, the host to which mail should be routed.
  171.  
  172. -S            The MHS administrator's password.
  173.  
  174. -T                      The type of host being defined (see 31, above.)
  175.  
  176. -U                      For defining a local user, the user's MHS password.
  177.                         For defining an Internet, the NetWare username with
  178.                         which an attachment to the remote file server will be
  179.                         made.
  180.  
  181. -V             Causes MHSUSER to return an error report after
  182.                         performing an operation. (See error level codes,
  183.             below).
  184.  
  185. -W                      The name of the workgroup being defined.
  186.  
  187. -Y                      The method with which a new application should be
  188.                         associated with users. (See 01, above.)
  189.  
  190.  
  191. MHSUSER error levels:
  192.  
  193. Errorlevel
  194.  
  195.         Meaning
  196.  
  197.  0  Definition, modification, deletion, or verification succeeded
  198.  
  199.  1  Definition, modification, deletion, or verification failed
  200.  
  201.  2  Cannot add entry (it already exists)
  202.  
  203.  3  Inexistent or invalid username (not a local user, illegal characters, too
  204.       long, reserved name)
  205.  
  206.  4  Inexistent or invalid application name (no users of this application,
  207.       illegal characters, too long, reserved name)
  208.  
  209.  5  Invalid password
  210.  
  211.  6  Cannot add user (exceeded user number limit for application)
  212.  
  213.  7  Cannot add application (exceeded managed application limit for user)
  214.  
  215.  8  Cannot modify application's entry
  216.  
  217.  9  Incorrect MHS version
  218.  
  219.  10 Could not build directory
  220.  
  221.  11 Could not delete (insufficient access rights, file system error)
  222.  
  223.  12 Could not search (insufficient access rights, not LAN supervisor,
  224.       inexistent directory, invalid or inexistent MV)
  225.  
  226.  13 Could not assign rights to specified LAN user
  227.  
  228.  14 Inexistent or invalid LAN username
  229.  
  230.  15 Either NETBIOS is not present, or cannot access network clock.
  231.  
  232.  16 Not used
  233.  
  234.  17 Unknown error or Invalid command line parameters
  235.  
  236.  18 Inexistent or invalid host name
  237.  
  238.  19 Inexistent or invalid workgroup name
  239.  
  240.  20 Inexistent or invalid LAN username
  241.  
  242.  31 Cannot delete your Workgroup
  243.  
  244.  33 Mail services are operating! Cannot proceed.
  245.  
  246. 255 Unknown error
  247.