Home

 

setmqscp (set service connection points)

 

 

Purpose

The setmqscp command applies to WebSphere MQ for Windows only.

Use the setmqscp command to configure and administer support for publishing client connection channel definitions in an Active Directory.

Initially, this command is used by a domain administrator to:

• Prepare the Active Directory for WebSphere MQ use

• Grant WebSphere MQ users and administrators the relevant authorities to access and update the WebSphere MQ Active Directory objects

We can also use the setmqscp command to display all the currently configured client connection channel definitions available on the Active Directory.

 

Syntax

>>-setmqscp--+--------------------------+----------------------->
             '- -a --+----------------+-'   
                     '- -m --QMgrName-'     

>--+--------------------------+--+------+----------------------><
   '- -r --+----------------+-'  '- -d -'   
           '- -m --QMgrName-'               

 

Optional parameters

You must specify one of -a (add), -r (remove) or -d (display).

-a

Adds the WebSphere MQ client connections Active Directory container, if it does not already exist. You must be a user with the appropriate privileges to create subcontainers in the System container of your domain. The WebSphere MQ folder is called CN=IBM-MQClientConnections. Do not delete this folder in any other way than by using the setmqscp -r command.

-d

Displays the service connection points.

-r

Removes the service connection points. If you omit -m, and no client connection definitions exist in the IBM-MQClientConnections folder, the folder itself is removed from the Active Directory.

-m [ * | qmgr ]

Modifies the specified parameter (-a or -r) so that only the specified queue manager is affected.

* | qmgr

* specifies that all queue managers are affected. This enables you to migrate a specific client connection table file from one queue manager alone, if required.

 

Examples

The following command creates the IBM-MQClientConnections folder and allocates the required permissions to WebSphere MQ administrators for the folder, and to child objects created subsequently:

setmqscp -a

The following command migrates existing client connection definitions from a local queue manager, Paint.queue.manager, to the Active Directory:

setmqscp -a -m Paint.queue.manager

The following command migrates all client connection definitions on the local server to the Active Directory:

setmqscp -a -m *

 

Parent topic:

The control commands

fa16060_

 

Home