Skip to content

stmassey/mq-cph

 
 

Repository files navigation

mq-cph

The IBM MQ C Performance Harness

Overview

MQ-CPH (the IBM MQ C Performance Harness) is a performance test tool for IBM® MQ. The source can be found on the ibm-messaging GitHub.

Build

After extracting the code from this repository, you can build an image with the latest version of MQ (and copy the executable and all required property files to an installation directory, e.g. ~/cph)

Make Pre-requisites

Before running make, make sure the MQ header files are available. For Unix platforms, the makefile will assume they are in $MQ_INSTALLATION_DIR/inc or /opt/mqm/inc (if MQ_INSTALLATION_DIR is not defined). Alternatively you can set the 'INCLUDE' environment variable to a specific directory.

On Windows, the include directory wil be something like "C:\Program Files\IBM\WebSphere MQ\Tools\c\include"

Build, using the following commands, depending on platform:

Linux

export installdir=~/cph
make

On Linux disributions, g++ is required.

AIX

export installdir ~/cph
gmake

AIX requires the GNU make tool, available here: http://www-03.ibm.com/systems/power/software/aix/linux/toolbox/alpha.html

Windows

On Microsoft Windows, you can use the included VC++ 2005 project.

Post Make Tasks

After running make, the cph executable will be built in the local directory (./Release/...). If you specified an 'installdir' then the cph executable and the required property files (in the 'props' directory) will have been copied to that directory, otherwise you need to copy them yourself. The cph executable needs to be run from the directory in which it is 'installed' to access the property files, unless the CPH_INSTALLDIR environment variable is set to indicate their location.

Usage

Please see (cph.pdf)

Troubleshooting

Please see (cph.pdf)

Issues and contributions

For issues relating specifically to CPH, please use the GitHub issue tracker. For more general issues relating to IBM MQ, please use the messaging community. If you do submit a Pull Request related to this source code, please indicate in the Pull Request that you accept and agree to be bound by the terms of the IBM Contributor License Agreement.

License

The CPH source code and associated scripts are licensed under the Apache License 2.0.

About

The IBM MQ C Performance Harness

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 51.7%
  • C 44.2%
  • Makefile 4.1%