HTMLUSER.TXT

This file contain 4 sections:
A. User Guide.
B. Registration Guide.
C. Requirement Notes.
D. Release Notes.

------------------------------------------------------------
A. User Guide.

"HTML USER" for Windows(R) NT provides a HTML interface to
a subset of user management functions.  Please see Windows 
NT Help for a full description of the user management 
commands.  

Only members of the Administrators or the Account Operators 
local group can successfully execute this software. This was 
achieved with MIIS by setting the file permissions of 
htmluser.exe for execution by Administrators only.

HTMLUser is intended to be run as a common gateway interface 
(CGI) program, but could also be run at the command prompt.
It provides functions for managing dialin users via a web 
browser.  It is intended as a HTML-interfaced supplement to 
the NT User Manager.

As a console program, it has a subset of the NET USER
commands.

  htmluser [/?]
  htmluser [\\server] /list
  htmluser [\\server] user [password] [options]

  without parameters or with /?, htmluser lists a summary
  of its usage:

  >htmluser
  HTML User 
  htmluser [\\server] /list     lists all accounts
  htmluser [\\server] username [password] [options]
    options:
      /delete                     deletes the account
      /add                        adds a new account
      /fullname:" name"           adds/modifies fullname
      /comment:" text"            adds/modifies comment
      /active:{yes|no}            enables|disables the account
      /dialin:{yes|no}            enables|disables dialin
      /groups:" name[,name]"      adds account to groups
      /localgroups:" name[,name]" adds account to localgroups

  /list
  Lists the user accounts on the server.

  username
  Is the name of the user account to add, delete, modify, or 
  display.  Without other parameters, information about the 
  user will be displayed.

  password
  Assigns or changes a password for the user's account. 

  /delete
  Removes the user account.

  /add
  Adds a user account with "Password Never Expires"
  attribute.

  /fullname:" name", 
  Adds/modifies a user's full name.  Enclose names with more
  than 1 word in quotation marks.

  /comment:" text"
  Adds/modifies a descriptive comment about the user's 
  account. This comment can have as many as 48 characters. 
  Enclose the text in quotation marks. 

  /active:{yes|no}
  Enables or disables the user account. The default is yes 
  (active).

  /dialin:{yes|no}
  Enables or disables the user's dialin privilege with no
  call back.  The default is no (disabled).  

  /groups:" name[,name]"
  Adds the user account to the named global groups.  
  Enclosed names with more than 1 word in quotation marks.  
  Separate names with commas.

  /localgroups:" name[,name]"
  Adds the user account to the named local groups.  
  Enclosed names with more than 1 word in quotation marks.  
  Separate names with commas.

As a CGI program, htmluser can be called via either the POST
or the GET method.  The simplest way to start is to GET
it without inputs eg:

  http://host/cgi/htmluser.exe

or optionally with a server name eg:

  http://hostname/cgi/htmluser.exe?server=\\servername

In either case, htmluser will return a generated page 
comprising a menu of buttons:

  HTML User - Menu
  ------------------------------------------------------------
  [List] | [New] | [Edit:]__________[:Delete] | [Exit]
  ------------------------------------------------------------

where _____ are text boxes and [Label] are buttons.

[List]
  Lists the user accounts on the server below the menu of
  buttons:

  HTML User - List
  ------------------------------------------------------------
  [List] | [New] | [Edit:]__________[:Delete] | [Exit]
  ------------------------------------------------------------

  Username        Full Name                 Descriptions/Comments
  Administrator                             Built-in account for administering the computer/domain
  Guest                                     Built-in account for guest access to the computer/domain
  IUSR_PC1        Internet Guest Account    Internet Server Anonymous Access

[New]
  Displays the form for adding a new user account:

  HTML User - Adding
  ------------------------------------------------------------
  Username     :____________________
  Fullname     :________________________________________
  Description  :________________________________________
  Password     :_______________Confirm:_______________
  Disabled     :[]
  Grant Dialin :[]
  Global Groups:________________________________________
  Local Groups :________________________________________
  [Add] [Clear] [Cancel]
  ------------------------------------------------------------

  [Add]
  Adds the new account
  [Clear]
  Clears all input fields
  [Cancel]
  Cancels adding and returns to the Menu form

[Edit:]
  Edits the account named in the text field via a editing
  form:

  HTML User - Editing 
  ------------------------------------------------------------

  Username     :guest
  Fullname     :________________________________________
  Description  :Built-in account for guest access to the
  Password     :_______________Confirm:_______________
  Disabled     :[]
  Grant Dialin :[]
  Global Groups:None,____________________
  Local Groups :Guests,____________________
  [Save] [Reset] [Cancel]

  ------------------------------------------------------------

  [Save]
  Saves the changes to the account
  [Reset]
  Resets all input fields
  [Cancel]
  Cancels editing and returns to the Menu form

[:Delete]
  Deletes the account named in the text field.  A confirm
  will be sought:

  HTML User - Deleting [guest] 
  ------------------------------------------------------------
  Confirm Deleting? [Confirm] [Cancel]
  ------------------------------------------------------------

  [Confirm]
  Confirms deleting and specified account will be deleted.
  [Cancel]
  Cancels deleting and returns to the Menu form.

[Exit] 
  Returns to the referring page - the page that first 
  called htmluser.exe.

------------------------------------------------------------
B. Registration Guide.

This "HTML User" for Windows(R) NT is copyrighted by TCS 
Operations Research ("TCS OR") with all rights reserved.  
You may examine the software for 30 days.  If at the end of 
that time you are satisfied and would like to use it, you 
should register it.  Registration is encouraged since it 
not only funds further development of the software, but 
also gives you a warm feeling deep down inside.

Before you register please see read the Licence Terms and 
Conditions.

Registration is on a per user basis.  To register, please 
send name or appointment, organisation or company (if 
applicable), email (if any), and address along with a 
registration fee of S$20.00 (Twenty Singapore Dollars) in 
cash or cheque to:

TCS Operations Research
Serangoon Garden P.O. Box 487
Singapore 915533
Republic of Singapore

The author can also be contacted via email:
tohcs@pobox.org.sg

Please add shipping: S$2.00 for Singapore/Malaysia; S$5.00 
all other countries.  A 3.5" diskette containing the most 
recent version will be sent to you.

As a registered user, you will receive support for up to 12 
months from the date of registration.  Support will include 
any upgrades or bug fixes released within that 12 months.  
After 12 months, upgrades for previously registered users 
will cost 25% of the prevailing registration fee.

------------------------------------------------------------
C. Requirement Notes.

Only members of the Administrators or the Account Operators 
local group can successfully execute this software. Only 
members of the Administrators local group can delete an 
Administrators privilege account.

Among others, the program requires msvcrt.dll, netapi32.lib,
rassapi.lib, advapi32.lib & kernel32.lib to be installed on 
the computer.

------------------------------------------------------------
D. Release Notes.

1.0   Apr 1997 
      Initial Version
