imqusermgr(1m)

1imqusermgr(1M)          System Administration Commands          imqusermgr(1M)
2
3
4

NAME

6       imqusermgr  - command utility for managing a Message Queue user reposi‐
7       tory
8

SYNOPSIS

10       /usr/bin/imqusermgr subcommand [[option]...]
11
12
13       /usr/bin/imqusermgr -h
14
15
16       /usr/bin/imqusermgr -v
17
18

DESCRIPTION

20       The imqusermgr utility manages a file-based user repository to  authen‐
21       ticate and authorize users of a Message Queue message server.
22
23
24       imqusermgr  provides  subcommands  for  adding, deleting, updating, and
25       listing user entries in the repository.
26
27
28       imqusermgr supports four management subcommands. These subcommands, and
29       their  corresponding  options follow the imqusermgr command on the com‐
30       mand line. See USAGE and OPTIONS.
31
32
33       The following subcommands are supported:
34
35       add       Add a new user and associated password to the repository.
36
37
38       delete    Delete a user from the repository.
39
40
41       list      Display information users in the repository.
42
43
44       update    Update the password or state of a user in the repository.
45
46

OPTIONS

48       The following options are supported:
49
50       -a active_state    Specify if user's state is active  or  inactive.  An
51                          inactive  user cannot create connections to the Mes‐
52                          sage Queue message server.
53
54                          Valid values for active_state  are  true  or  false.
55                          Specify  true  for active or false for inactive. the
56                          default is true.
57
58                          Use this option with the update subcommmand.
59
60
61       -f                 Perform action without user confirmation.
62
63                          Use this option with the delete and update  subcomm‐
64                          mands.
65
66
67       -g group           Specify the group of the user.
68
69                          Valid  values  for group are admin, user, and anony‐
70                          mous.
71
72                          Use this option with the add subcommmand.
73
74
75       -h                  Display usage help. Exceute  nothing  else  on  the
76                          command line.
77
78
79       -i brokerName      Specify the broker instance user repository to which
80                          the command applied. If you do not  specify  broker‐
81                          Name, the default brokerName is assumed.
82
83                          Use  this  option  with  the  add, delete, list, and
84                          update subcommmands.
85
86
87       -p password        Specify user password.
88
89                          Use this option with the  add  and  update  subcomm‐
90                          mands.
91
92
93       -s                 Silent mode. Display no output
94
95                          Use  this  option  with  the add, delete, and update
96                          subcommands.
97
98
99       -u userName        Specify user name.
100
101                          userName cannot contain  the  following  characters:
102                          asterisk (*), colon (:), NEWLINE, or RETURN.
103
104                          Use  this  option  with  the add, delete, update and
105                          list subcommands.
106
107
108       -v                 Display version information. Exceute nothing else on
109                          the command line.
110
111

USAGE

113       The following subcommands and corresponding options are supported:
114
115       add -u userName -p password [-g group] [-s] [-i brokerName]
116
117           Add  a  new  user  and  associated  password to the repository, and
118           optionally specify the user's group.
119
120
121       delete -u userName [-s] [-f] [-i brokerName]
122
123           Delete a user from the repository.
124
125
126        list [-u user_name] [-i brokerName]
127
128           Display information about the specified user in the repository.  If
129           no user is specified, all users are displayed.
130
131
132       update -u userName -p password [-a state] [-s] [-f] [-i brokerName]
133       update -u userName -a state [-p password] [-s] [-f] [-i brokerName]
134
135           Update the password or state (or both) of a user.
136
137

ENVIRONMENT VARIABLES

139       The  following  environment variables affect the execution of this com‐
140       mand:
141
142       IMQ_JAVAHOME    Specify the Java 2 compatible runtime. When this  envi‐
143                       ronment variable is not set, it defaults to /usr/j2se.
144
145

EXIT STATUS

147       The following exit values are returned:
148
149       0     Successful completion.
150
151
152       >0    An error occurred.
153
154

FILES

156       /etc/imq/passwd    Flat-file user repository.
157
158

ATTRIBUTES

160       See attributes(5) for descriptions of the following attributes:
161
162
163
164
165       ┌─────────────────────────────┬─────────────────────────────┐
166       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
167       ├─────────────────────────────┼─────────────────────────────┤
168       │Availability                 │SUNWiqu                      │
169       └─────────────────────────────┴─────────────────────────────┘
170