For a user ID to configure, start, and stop the WebSphere® MQ agent, the user ID must belong to the
mqm group, which has full administrative privileges over IBM® MQ (WebSphere MQ). Also, for a
non-root user or a non-administrator user, you must grant users the access to the IBM MQ (WebSphere MQ)
objects by using the IBM MQ (WebSphere MQ) control command.
About this task
On AIX® or Linux®
system, you must add the user ID to the mqm group and then grant the user ID
appropriate access to the IBM MQ (WebSphere MQ) objects
with the setmqaut command.
On Windows systems, you must add the user ID to the
mqm group. If the user ID does not belong to the Administrator user group,
you must also use the Registry Editor to grant permissions to the user ID to start or stop the
agent.
Procedure
-
On AIX or Linux
system, complete the following steps:
-
Log on to the AIX or Linux system by using the root ID.
-
Add the user ID that is used to run the agent to the mqm group.
-
(WebSphere MQ V7.5 or later): If the user ID is a
non-root user on the AIX or Linux system, set the appropriate level of authority for the user ID to access the IBM MQ (WebSphere MQ) objects by running the following
command:
setmqaut -m queue_manager -t qmgr -p user_ID +inq +connect +dsp +setid
where
queue_manager is the name of the queue manager of WebSphere MQ V7.5 or later and
user_ID is the non-root
or non-administrator user ID to run the agent.
-
On Windows systems, complete the following
steps:
-
Log on to the Windows systems as a system
administrator.
-
Add the user ID that is used to run the agent to the mqm group.
-
If the user ID that you use to start, run, and stop the agent is not a member of the
Administrators group, use the Registry Editor to set permissions for a user ID to ensure that the
agent can be started and stopped successfully:
- Click , and then type regedit.exe to open the Registry Editor.
- In the Registry Editor, locate the key,
HKEY_LOCAL_MACHINE\SOFTWARE\Candle
.
- Right-click the key and click Permissions.
- If the user ID for the WebSphere MQ agent is
not in the Group or user names list, click Add to add the user ID to the
list.
- Click the user ID in the list.
- In the Permissions for the user-ID list, where user-ID is
the user ID of WebSphere MQ agent, select
Full Control in the Allow column and click OK.
- In the Registry Editor, locate the key,
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows
NT\CurrentVersion\Perflib
.
- Right-click the key and click Permissions.
- If the user ID for the WebSphere MQ agent is
not in the Group or user names list, click Add to add the user ID to the
list.
- Click the user ID in the Group or user names list.
- In the Permissions for the user-ID list, where user-ID is
the user ID of WebSphere MQ agent, select
Read in the Allow column and click OK.
- Close the Registry Editor.
- Locate the install_dir directory, where install_dir is the
agent installation directory.
- Right-click the directory and click Properties.
- On the Security tab, if the user ID for WebSphere MQ agent is not in the Group or user names list,
click Edit and then Add to add the user ID to the
list.
- Click the user ID in the Group or user names list.
- In the Permissions for the user-ID list, select Full
Control in the Allow column, where user-ID is the user ID of
WebSphere MQ agent.
- Click OK.
What to do next
The next step to configure IBM MQ (WebSphere MQ) for data enablement. See Configuring IBM MQ (WebSphere MQ) for data enablement.