# INTERSTAR TECHNOLOGIES INC.
# XmUser, sample for for XMedius Java Api Module (XmediusJavaApi.jar)
# 2004


A) The files

   The sample contains the following files:

   - XmBase.java: Java source code
   - XmContants.java: Java source code
   - XmUser.java: Jave source code

   - BUILD.bat: command file for building the sample
   - XMUSER.bat: command file for using the sample

   - input.txt: sample input file
   - readme.txt: this file


B) Build the sample

   1) Install the XMedius Java Api Module if not already done;
   2) At the command prompt, type BUILD from the sample's directory.  The
      BUILD.bat command file will compile the Java source code files and
      package then inside the XmUser.jar file.


C) Use the sample

   1) To run the sample, you need the following files

   - XMUSER.bat
   - XmUser.jar (must be in the same directory as XMUSER.bat or update the 
     XMJAVAAPI_CLASSPATH value to the location of the jar files)

   2) Type XMUSER -h at the command line to see the operations available.


D) Usage

   1) List all users

      XmUser {LoginInfo} -l

   2) Get information on one user

      XmUser {LoginInfo} -i "smtpAddress"

   3) Add one user

      XmUser {LoginInfo} -a "smtpAddress,profileName[,assocNtAccount[,webPassword]]"

   4) Add one or more users

      XmUser {LoginInfo} -a -f "fileName"

   5) Add or modify a user

      XmUser {LoginInfo} -am "smtpAddress,profileName[,assocNtAccount[,webPassword]]"

   6) Add or modify one or more users

      XmUser {LoginInfo} -am -f "fileName"

   7) Modify a user

      XmUser {LoginInfo} -m "smtpAddress,profileName[,assocNtAccount[,webPassword]]"

   8) Modify one or more users

      XmUser {LoginInfo} -m -f "fileName"

   9) Remove a user

      XmUser {LoginInfo} -r "smtpAddress"

   10) Remove one or more users

      XmUser {LoginInfo} -r -f "fileName"


   Where {LoginInfo} is: -LoginName "system_admin_name" -LoginPwd "pwd" -Site "target_site_name" -LoginServers "server1[,server2]"
                     or: -LoginName "site_admin_name" -LoginPwd "pwd" -LoginSite "site_name" -LoginServers "server1[,server2]"

   The login information, as well as all other command line arguments, can be:

   - entered each time at the commande line, and/or
   - hardcoded in the XMUSER.bat file, and/or
   - hardcoded in the XmUser.jar file by modifying the XmConstants.LOGIN_STRING
     before building the jar file.
