WebSphere WebSphere Business Integration Message Service Clients for C/C++ Version 1.2.7 and .NET Version 1.2.6 Operating Systems: AIX, Linux, Solaris, Windows

Installing Message Service Client for C/C++ using the installation wizard

The installation for Message Service Client for C/C++ uses an InstallShield MultiPlatform 5 installer. Two setup options are available, so that you can choose either a complete or a custom installation.

Before you begin

The installed client requires 100 MB of disk space on AIX, Linux, Solaris, and Windows.

Why and when to perform this task

To install Message Service Client for C/C++ on AIX, Linux, Solaris, or Windows, follow this procedure. You can click Cancel at any time during the install setup process to stop the installation process from continuing, but note that the Cancel option is not available while the product is actually being installed.

Steps for this task

  1. If you are installing from a SupportPac, complete the following steps, otherwise proceed directly to step 2;
    1. On AIX, Linux, or Solaris, log in as root.  On Windows, log on as an administrator.
    2. Create a temporary directory and extract the contents of the zipped file supplied with Message Service Client for C/C++ into the directory.

      A subdirectory of the temporary directory is created. The subdirectory is called gxixms_install and contains the files needed for the installation.

    3. Run the setup file:
      • AIX On AIX, run the file called setupAix.bin that is in the gxixms_install directory.
      • Linux On Linux, run the file called setuplinuxia32/setuplinux-x86_64 that is in the gxixms_install directory.
      • Solaris On Solaris, run the file called setupsolaris that is in the gxixms_install directory.
      • Windows On Windows, run the file setup.exe that is in the gxixms_install directory.

      Messages in the command prompt window inform you that the installer is searching for, and preparing, a Java Virtual Machine (JVM). Message Service Client for C/C++ provides a JVM for the installer; you do not need to provide one.

  2. Wait for the installation wizard to open and display the following message:
    Welcome to the IBM Message Service Client for C/C++ installation wizard.

    Click Next.

  3. If the wizard asks you to read the licence agreement, and you accept the terms of the licence agreement, click I accept the terms in the licence agreement, and then click Next. On Windows only, the installer asks you where you want to install GSKit.
  4. If you are installing on Windows and you want to install GSKit in the directory suggested, click Next ; otherwise, choose another directory. The installation wizard asks you where you want to install Message Service Client for C/C++.
  5. To install Message Service Client for C/C++ in the directory suggested, click Next; otherwise choose another directory. If you choose to install Message Service Client for C/C++ in a directory that does not currently exist, the installation wizard creates the directory for you.

    The installation wizard asks you to choose the setup type that best suits your needs.

  6. Select the type of setup that you require:
    • To install all program features, click Complete.
    • To choose which features you want to install, click Custom.
  7. Click Next.

    If you select the complete install option, the installation wizard displays details of the installation options that you have selected, and you can proceed as described in step 9. If you select the custom install option, the installation wizard asks you which features you want to install, and you must complete step 8 before moving on to step 9.

  8. For a custom install only, select the Message Service Client for C/C++ features that you want to be installed and then click Next.

    If you want to develop XMS applications, ensure that you select the Development Tools and Samples feature. This feature provides the sample applications, and the libraries and header files needed to compile C and C++ applications. If you do not select this feature, only the files needed to run XMS applications are installed.

    The installation wizard displays details of the installation options that you have selected.

  9. When you are happy with your selected installation options, click Next to start the installation. Note that Cancel becomes unavailable when the installation has started.
    The installation wizard displays a bar showing the progress of the installation. Wait for the progress bar to complete. When the installation completes successfully, the wizard displays the following message:
    The installation wizard has successfully installed IBM Message Service Client 
    for C/C++. Choose Finish to exit the wizard.
  10. Click Next . If you want to view the readme file for Message Service Client for C/C++, select View Readme before clicking Next.
  11. Click Finish to close the installation wizard.

Result

You have now successfully installed Message Service Client for C/C++, which is ready to use.

What to do next

Before running any XMS applications, including the sample applications provided with XMS, you must set up the messaging server environment as described in Setting up the messaging server environment.
Related concepts
JNDI Lookup Web service
Related tasks
Setting up the messaging server environment
Using the XMS sample applications

Task topic

Terms of Use | Rate this page

Last updated: 18 Jun 2008

© Copyright IBM Corporation 2005, 2008. All Rights Reserved.