Merge pull request #68 from ibm-messaging/MQ9.1.1

Mq9.1.1

Author: ibmmqmet

CHANGELOG.md

@@ -1,11 +1,21 @@
 # Changelog
 
-=======
-### November 2018
+## November 2018 - v3.2.0
+* 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
+
+## November 2018 - v3.1.0
 * Added functions to mqmetric to issue DISPLAY QSTATUS for additional stats
 * Added z/OS capability for minimal status
 
-### October 2018
+## October 2018
 * Allow compilation against MQ v8
 
 ## October 2018 - v3.0.0
@@ -20,7 +30,6 @@
 * Updated build comments
 
 ## July 2018 - v2.0.0
-
 * Corrected package imports
 * Formatted go code with `go fmt`
 * Rearranged this file
@@ -30,58 +39,47 @@
 * 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](cmd/mq_json/README.md) 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](cmd/mq_aws/README.md) for more details.
 
 ## 12 Aug 2016
-
 * Added a OpenTSDB monitor. See the [README](cmd/mq_opentsdb/README.md) for more details.
 * Added a Collectd monitor. See the [README](cmd/mq_coll/README.md) for more details.
 * Added MQI MQCNO/MQCSP structures to support client connections and password authentication with MQCONNX.
@@ -90,17 +88,14 @@
 * 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](cmd/mq_influx/README.md) 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](cmd/mq_prometheus/README.md) 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
@@ -112,5 +107,4 @@
 * Added MQItoString function for some maps of values to constant names
 
 ## 08 Jul 2016
-
 * Initial release

README.md

@@ -28,8 +28,8 @@ as MQCHAR48 are represented by the native Go string type. Conversion between the
 types is handled within the ibmmq package itself, removing the need for Go programmers
 to know about it.
 
-A short program in the samples/mqitest directory gives an example of using this interface,
-to put and get messages and to subscribe to a topic.
+Sample programs are provided to demonstrate various features of using the MQI. See the
+README in the `samples` directory for more information about those programs.
 
 The mqmetric directory contains functions to help monitoring programs access MQ status and
 statistics. This package is not needed for general application programs.
@@ -118,17 +118,15 @@ for the C compiler to recognise those directories. For example,
 
   `go build -o bin/mqitest ./src/github.com/ibm-messaging/mq-golang/samples/mqitest/*.go`
 
-At this point, you should have a compiled copy of the program in `$GOPATH/bin`.
+At this point, you should have a compiled copy of the program in `$GOPATH/bin`. See the
+`samples` directory for more sample programs.
 
 ## Limitations
 
-Not all of the MQI verbs are available through the `ibmmq` package. This
-implementation concentrates on the core API calls needed to put and get messages.
+Almost all of the MQI verbs are now available through the `ibmmq` package.
 Currently unavailable verbs include:
 
-* MQSET
-* All of the message property manipulators
-* MQCB
+* MQCB/MQCTL
 
 There are also no structure handlers for message headers such as MQRFH2 or MQDLH.