DCE configuration

 


To use the supplied name service component, have the OSF Distributed Computing Environment (DCE) Directory Service configured. This service enables applications that connect to one queue manager to open queues that belong to another queue manager in the same DCE cell.

You can configure WebSphere MQ to use the DCE name service as follows:

  1. Ensure that DCE is started. To do this, on the command line type:
      
    $ dcecp
      dcecp> host catalog
    

    You are presented with a list of hosts in the cell. This indicates that DCE is started.

    Note:
    If DCE is not running, you see the following error message:
      error with socket
    

  2. Log in to DCE as cell_admin and run the sample programs dcesetsv and dcesetkp that define mqm and create a set of directory entries so that the supplied name service can run.

    Both sample programs are located in the following directories:

    For WebSphere MQ for Windows
    C:\MQM\TOOLS\DCE\SAMPLES, where C is the installation drive.

    For UNIX systems
    /usr/mqm/samp on AIX.

    /opt/mqm/samp on HP-UX, Solaris, and Linux.

    Note to users

    You need to install the MQ DCE option if you are using HP-UX, AIX, or Solaris.

    To run sample program dcesetsv, use the following command:

      dcesetsv <mqm's password> <cell_admin's password>
    

    This program sets up mqm as a principal to DCE, creates a set of directory entries for mqm, and gives it access rights to the DCE cell servers. The program can be run from any host in the cell, and is run once for the entire DCE cell.

  3. For each host in the DCE cell that will be using the DCE name service, run sample program dcesetkt using the following command:
      dcesetkt <mqm's password>
    

    This program sets up a system keytable file on the local host that contains information about principal mqm and its password.

    The keytable files are located in the following directories:

    For WebSphere MQ for Windows
    C:\MQM\DCE\KEYTABS\KEYTAB, where C is the installation drive.

    For UNIX systems
    /var/mqm/dce/keytabs/keytab

    Note:
    When the keytable is first created on UNIX systems, it does not have the correct permissions to allow the DCE naming service to be used. Ensure that the correct permissions exist by issuing the following commands from the UNIX command line:
      $ cd /var/mqm/dce/keytabs
      $ chown mqm:mqm keytab
      $ chmod u+rw keytab
      $ chmod g+r keytab
    

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.