Complete MQI verbs

This version creates wrappers for the remaining MQI verbs (MQCB/CTL for async callback, MQBEGIN). It also adds a generator/parser for an MQI header structure, the DLH.

More MQI function support, and new MQ version compatibility

Added GetPlatform to mqmetric so it can be used as a label/tag in collectors
Added sample programs demonstrating specific operations such as put/get of message
Fixed conversion of some C strings into Go strings
Update MQI header files for MQ V9.1.1 and give more platform variations
Add support for MQSTAT and MQSUBRQ functions
Add support and sample for Message Property functions
Add InqMap as alternative (simpler) MQINQ operation. Inq() should be considered deprecated
Add support for MQSET function
Add discovery of translated versions of the mqmetric descriptions

v3.1.0: Merge pull request #66 from ibm-messaging/qstatus

Add QSTATUS queries, to enable minimal z/OS monitoring

Work with MQ V8

v3.0.1

Compile error

v3.0.0

Changelog

October 2018 - v3.0.0

• Added functions to the mqmetric package to assist with collecting channel status
• Better handle truncated messages when listing the queues that match a pattern

October 2018

• Corrected heuristic for generating metric names

August 2018

• Added V9.1 constant definitions
• Updated build comments

July 2018 - v2.0.0

• Corrected package imports
• Formatted go code with go fmt
• Rearranged this file
• Removed logging from golang package mqmetric
• Moved samples to a separate repository
• Added build scripts for ibmmq and mqmetric packages and ibmmq samples
• Added unit tests for ibmmq and mqmetric packages

March 2018 - v1.0.0

• Added V9.0.5 constant definitions
• Changed #cgo directives for Windows now the compiler supports standard path names
• Added mechanism to set MQ userid and password for Prometheus monitor
• Released v1.0.0 of this repository for use with golang dependency management tools

October 2017

• Added V9.0.4 constant definitions - now generated from original MQ source code
• Added MQSC script to show how to redefine event queues for pub/sub
• Prometheus collector has new parameter to override the first component of the metric name
• Prometheus collector can now process channel-level statistics

18 May 2017

• Added the V9.0.3 constant definitions.
• Reinstated 64-bit structure "length" fields in cmqc.go after fixing a bug in the base product C source code generator.

25 Mar 2017

• Added the metaPrefix option to the Prometheus monitor. This allows selection of non-default resources such as the MQ Bridge for Salesforce included in MQ 9.0.2.

15 Feb 2017

• API BREAKING CHANGE: The MQI verbs have been changed to return a single error indicator instead of two separate values. See mqitest.go for examples of how MQRC/MQCC codes can now be tested and extracted. This change makes the MQI implementation a bit more natural for Go environments.

10 Jan 2017

• Added support for the MQCD and MQSCO structures to allow programmable client connectivity, without requiring a CCDT. See the clientconn sample program for an example of using the MQCD.
• Moved sample programs into subdirectory

14 Dec 2016

• Minor updates to this README for formatting
• Removed xxx_CURRENT_LENGTH definitions from cmqc

07 Nov 2016

• Added a collector that prints metrics in a simple JSON format. See the README for more details.
• Fixed bug where freespace metrics were showing as non-integer bytes, not percentages

17 Oct 2016

• Added some Windows support. An example batch file is included in the mq_influx directory; changes would be needed to the MQSC script to call it. The other monitor programs can be supported with similar modifications.
• Added a "getting started" section to this README.

23 Aug 2016

• Added a collector for Amazon AWS CloudWatch monitoring. See the README for more details.

12 Aug 2016

• Added a OpenTSDB monitor. See the README for more details.
• Added a Collectd monitor. See the README for more details.
• Added MQI MQCNO/MQCSP structures to support client connections and password authentication with MQCONNX.
• Allow client-mode connections from the monitor programs
• Added Grafana dashboards for the different monitors to show how to query them
• Changed database password mechanism so that "exec" maintains the PID for MQ services

04 Aug 2016

• Added a monitor command for exporting MQ data to InfluxDB. See the README for more details
• Restructured the monitoring code to put common material in the mqmetric package, called from the Influx and Prometheus monitors.

25 Jul 2016

• Added functions to handle basic PCF creation and parsing
• Added a monitor command for exporting MQ V9 queue manager data to Prometheus. See the README for more details

18 Jul 2016

• Changed structures so that most applications will not need to use cgo to imbed the MQ C headers
  • Go programs will now use int32 where C programs use MQLONG
  • Use of message handles, distribution lists require cgo for now
• Package ibmmq now includes the numeric #defines as a Go file, cmqc.go, for easier use
• Removed "src/" prefix from tree in github repo
• Removed need for buffer length parm on Put/Put1
• Updated comments
• Added MQINQ
• Added MQItoString function for some maps of values to constant names

08 Jul 2016

• Initial release

v2.0.0

Changes in this release:

• Add full repository path in go import statements for easier building
• Formatted go code with go fmt
• Rearranged CHANGELOG.md
• Removed logging from golang package mqmetric
• Added error returns to most functions
• Moved metric gathering samples to a separate repository - ibm-messaging/mq-metric-samples
• Added build scripts for ibmmq and mqmetric packages and ibmmq samples
• Added unit tests for ibmmq and mqmetric packages
• Added V9.0.5 constant definitions
• Changed #cgo directives for Windows now the compiler supports standard path names
• Added mechanism to set MQ userid and password for Prometheus monitor

v1.0.0

First release of the MQ Go library. Includes a wrapper around the MQI, PCF, and example code for managing MQ metrics.

This code will be re-factored in a future release, so it's recommended to use a dependency manager such as dep or Glide, and add a specific version dependency. By using a dependency manager, you can continue to use this version for as long as you want to.