WebSphere Message Brokers
File: an26220_
Writer: Bill Oppenheimer

Task topic

This build: July 31, 2007 21:34:01

Command environment: Windows platforms

Set up the Windows environment to run WebSphere® Message Broker commands.

On Windows® platforms, the components run as services, therefore they do not inherit the environment that is set for the command prompt from which you start them. The components run the mqsiprofile command when they start, which completes the environment initialization.

The mqsiprofile command is located in the directory install_dir\bin. You must not change the location of the mqsiprofile command, or make user modifications to the command, because it might be replaced if you install service, or an update, to the product. If you need to run your own settings, add one or more command files called your_file_name.cmd to the directory workpath\common\profiles.

When mqsiprofile runs, it automatically calls any additional user-written scripts in this directory.

A typical reason for adding scripts is Running database setup scripts.

When you have configured any additional setup, you can use one of the following methods to initialize the runtime environment for components and commands:

  1. If you have only one installation of the runtime product, open a Command Console by clicking Start > IBM > WebSphere Message Brokers 6.1 > Command Console. The mqsiprofile command initializes the environment and invokes any additional scripts in the common\profiles directory.
  2. If you have one or more installations of the runtime product, open a command prompt window. Locate and run the mqsiprofile.cmd script in the directory in which you installed the appropriate product. The mqsiprofile command initializes the environment and invokes any additional scripts in the common\profiles directory.

Check whether the following conditions apply to your environment:

Running database setup scripts

A broker requires access to a database to maintain operational and state data, and might also require access to user databases from deployed message flows.

When you install a database product on Windows, the relevant settings are typically made to the system environment. However, some database managers provide a profile to perform this setup, or provide details of actions that you must take in their documentation. Always check the database product documentation for environment setup details; the information provided here is for general guidance only.

If a profile is provided for the database that you are using, complete the following steps:

  1. If you can update the profile to provide permanent values for the details that are required (for example, the database server name or the installation directory):
    1. Complete the changes to the database profile.
    2. Copy the profile file to the directory workpath\common\profiles.
  2. If you cannot update the profile permanently, but need to make changes each time, you must run it independently of the mqsiprofile command before you start the component.

When your environment has been set up, see Configuring databases for information about setting up your databases for use with the broker.

Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:34:01

an26220_ This topic's URL is: