Manual Pages for UNIX Operating System command usage for man imqusermgr

System Administration Commands                     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 a Message Queue mes-
     sage 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
               repository.


     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
               repository.


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



SunOS 5.11          Last change: 23 Mar 2004                    1






System Administration Commands                     imqusermgr(1M)



                        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  sub-
                        commmand.


     -f                 Perform action without user confirmation.

                        Use  this  option  with  the  delete  and
                        update subcommmands.


     -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 command line.


     -i brokerName      Specify the broker instance user  reposi-
                        tory to which the command applied. If you
                        do not specify  brokerName,  the  default
                        brokerName is assumed.

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


     -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 subcommands.


     -u userName        Specify user name.

                        userName  cannot  contain  the  following



SunOS 5.11          Last change: 23 Mar 2004                    2






System Administration Commands                     imqusermgr(1M)



                        characters: asterisk (*), colon (:), NEW-
                        LINE, 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] [-i brokerName]

         Add a new user and associated password  to  the  reposi-
         tory, and optionally specify the user's group.


     delete -u userName [-s] [-f] [-i brokerName]

         Delete a user from the repository.


      list [-u user_name] [-i brokerName]

         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] [-i
     brokerName]
     update -u userName -a state [-p password] [-s] [-f] [-i
     brokerName]

         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




SunOS 5.11          Last change: 23 Mar 2004                    3






System Administration Commands                     imqusermgr(1M)



     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                | SUNWiq                      |
    |_____________________________|_____________________________|


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


     Sun Java System Message Queue Administrator's Guide
























SunOS 5.11          Last change: 23 Mar 2004                    4