imqusermgr(1M)

NAME

     imqusermgr - command utility for managing  a  Message  Queue
     user repository

SYNOPSIS

     /usr/bin/imqusermgr subcommand [[option]...]

     /usr/bin/imqusermgr -h

     /usr/bin/imqusermgr -v

DESCRIPTION

     The imqusermgr utility manages a file-based user  repository
     to authenticate and authorize users of an Message Queue (MQ)
     message server.

     imqusermgr provides subcommands for adding, deleting, updat-
     ing, and listing user entries in the repository.

     imqusermgr supports four management subcommands. These  sub-
     commands,   and   their  corresponding  options  follow  the
     imqusermgr command  on  the  command  line.  See  USAGE  and
     OPTIONS.

     The following subcommands are supported:

     add   Add a new user and associated password to the  reposi-
           tory.

     delete
           Delete a user from the repository.

     list  Display information users in the repository.

     update
           Update the password or state of a user in the  reposi-
           tory.

OPTIONS

     The following options are supported:

     -a active_state
           Specify if user's state  is  active  or  inactive.  An
           inactive user cannot create connections to the Message
           Queue message server.

           Valid values  for  active_state  are  true  or  false.
           Specify  true  for  active  or false for inactive. the
           default is true.

           Use this option with the update subcommmand.

     -f    Perform action without user confirmation.

           Use this  option  with  the  delete  and  update  sub-
           commmands.

     -g group
           Specify the group of the user.

           Valid values for group are admin, user, and anonymous.

           Use this option with the add subcommmand.

     -h     Display usage help. Exceute nothing else on the  com-
           mand line.

     -p password
           Specify user password.

           Use this option with the add and update subcommmands.

     -s    Silent mode. Display no output

           Use this option with the add, delete, and update  sub-
           commands.

     -u userName
           Specify user name.

           userName  cannot  contain  the  following  characters:
           asterisk (*), colon (:), <NEWLINE>, or <RETURN>.

           Use this option with the add, delete, update and  list
           subcommands.

     -v    Display version information. Exceute nothing  else  on
           the command line.

USAGE

     The following subcommands and corresponding options are sup-
     ported:

     add -u userName -p password [-g group] [-s]
           Add a new user and associated password to the  reposi-
           tory, and optionally specify the user's group.

     delete -u userName [-s] [-f]
           Delete a user from the repository.

      list [-u user_name]
           Display information about the specified  user  in  the
           repository.  If  no  user  is specified, all users are
           displayed.

     update -u userName -p password [-a state] [-s] [-f]

     update -u userName - a state [-p password] [-s] [-f]
           Update the password or state (or both) of a user.

ENVIRONMENT VARIABLES

     The following environment variables affect the execution  of
     this command:

     IMQ_JAVAHOME
           Specify the  Java  2  compatible  runtime.  When  this
           environment  variable  is  not  set,  it  defaults  to
           /usr/j2se.

EXIT STATUS

     The following exit values are returned:

     0     Successful completion.

     >0    An error occurred.

FILES

     /etc/imq/passwd
           Flat-file user repository.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWiqu                     |
    |_____________________________|_____________________________|

SEE ALSO

     imqadmin(1M),  imqbrokerd(1M),   imqcmd(1M),   imqdbmgr(1M),
     imqkeytool(1M), imqobjmgr(1M), attributes(5)

     Sun ONE Message Queue Administrator's Guide