BEA Logo BEA MessageQ Release 5.0

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy


   MessageQ Doc Home   |   Client for Windows User's Guide   |   Previous Topic   |   Next Topic   |   Contents   |   Index

Installing the MessageQ Client


This chapter describes how to install the MessageQ Client for Windows software. It includes the following topics:

Installation Prerequisites

To successfully install MessageQ Client software on your client machine, you must ensure that your environment meets the following installation requirements:

Hardware Requirements

To perform the installation, you need the following hardware:

Software Requirements

Your system must meet the following software requirements before you can run the MessageQ Client software.

For a complete description of MessageQ server systems and TCP/IP transports supported by the MessageQ Client, see the MessageQ Client for Windows Release Notes.

Platforms and Transports Supported

This section describes the hardware, operating systems, and network transports supported by MessageQ Client for Windows, Version 5.0.

Client Platforms Supported

The MessageQ Client supports operating system and network environments as listed in Table 2-1.

Table 2-1 Supported Client Platforms

Operating System


Windows NT 4.0 (Intel or Alpha)

Windows NT TCP/IP

Windows 95/98

Windows 95 TCP/IP

MessageQ Server Compatibility

The MessageQ Client runs with all MessageQ, Version 2.1 or higher message server implementations with the following exceptions:

Disk Space Requirements

MessageQ Client systems require approximately 3 megabytes of free disk space to hold the MessageQ installation files.

Backing Up Your System Disk

We recommend that you back up your system disk before installing any software. For details on performing a system disk backup, see your Microsoft Windows system documentation.

Installing on Systems Already Running the MessageQ Client

If you have a previous version of the MessageQ Client already installed on your system, we recommend that you install Version 5.0 software in the default installation directory, c:\...\BEA Systems\MessageQ.

Regardless of the directory in which the product is installed, the icons for the Program Manager are overwritten to point to the new installation. If a previous version is installed, you will not be able to access it from the Program Manager using the icons.

Installing the MessageQ Client

The following procedure describes how to install MessageQ Client for Windows software.

Note: You can stop the installation procedure at any time by clicking Exit in the Installation Options dialog. You can also return to the previous dialog by clicking Back.

  1. Log into the Administrator account.

  2. Load the MessageQ distribution CD-ROM into the CD reader.

  3. Open Windows Explorer.

  4. Double-click the applicable folder based on your system processor: WinNT for the Intel version and AlphaNT for the Alpha version.

  5. Double-click setup.exe to start the installation.

  6. Click Next after the SETUP utility displays the dialog box that welcomes you to the MessageQ software installation.

  7. If you have BEA TUXEDO installed on your system, select a BEA TUXEDO version to install upon and click Next. You can also install MessageQ as a standalone product.

  8. Choose the destination location and click Next. The default installation for MessageQ is C:\Program Files\BEA Systems\BEA MessageQ.

  9. Choose between a Compact or Custom installation and click Next. (The Compact installation installs the MessageQ Client for Windows files and the Release Notes. The Custom installation allows you to choose specific components to install.)

  10. If you select a Custom installation, you are prompted to select the components you want to install and click Next. The Select Components box displays a description of the selected component and shows you information on space required and space available.

  11. Choose the Program Folder name and click Next.

  12. After BEA MessageQ has been successfully installed and all files are transferred to your system, click Finish to complete the installation.

Figure 2-1 shows the MessageQ program group created after a Typical installation is complete.

Figure 2-1 MessageQ Program Group Server Icons

Table 2-2 describes the program group utility icons.

Table 2-2 Utility Group Programs

MessageQ Icon


MessageQ Client Configuration Utility

Windows-based program that lets you configure automatic failover, message recovery services, minimize network packets (MPP) protocol, logging, and tracing.

MessageQClient MRS Utility

Windows-based program that lets you view the contents of local store-and-forward (SAF) journals.

MessageQ CLS Security Utility

Windows-based program that allows a MessageQ administrator to define a list of MessageQ client systems that can attach to CLS.

MessageQ Client Test Utility

Windows-based program that enables you to test message exchanges between the queues you configured.

If you encounter a problem while using MessageQ and you believe the error is caused by a problem with MessageQ, contact BEA Customer Support for assistance.

Adding the MessageQ Client File Drive and Directory to Your Path

After completing the installation procedure, you can verify that the MessageQ Client software is successfully installed on your system.

Ensure that the files listed in Table 2-3 are located in directories identified by the PATH environment variable:

Table 2-3 PATH Environment Variable

Windows NT or Windows 95


dmq.ini (Optional: Configuration can be stored in the Registry)


Uninstalling the MessageQ Client

To remove the MessageQ Client from your system, use the Add/Remove Programs utility on your system's Control Panel.