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 activestate 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 activestate 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 username] [-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:
IMQJAVAHOME 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.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWiqu
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
|
