Move samples to seperate repository

Author: parrobe

CHANGES.md

@@ -5,8 +5,9 @@
 * Released v1.0.0 of this repository for use with golang dependency management tools
 * Corrected package imports
 * Formatted go code with `go fmt`
-* Added glide files and vendor directory to handle content dependencies
 * Rearranged this file
+* Removed logging from golang package `mqmetric`
+* Moved samples to a separate repository
 
 ## March 2018
 
@@ -24,24 +25,19 @@
 ## 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.
+* 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.
+
+* 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.
+* 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
@@ -51,46 +47,36 @@ for an example of using the MQCD.
 
 ## 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.
+* 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 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.
+* 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.
+* 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.
 * 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]
-(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.
+* 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
+* 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
 

README.md

@@ -4,9 +4,9 @@ This repository demonstrates how you can call IBM MQ from applications written i
 
 > **NOTICE**: Please ensure that you use a dependency management tool such as [dep](https://github.com/golang/dep) or [Glide](http://glide.sh/), and add a specific version dependency.  The current content has been marked as version 1.0.0, and a new version with breaking changes will be released soon.  By using a dependency manager, you can continue to use the old version if you want to.
 
-The repository also includes programs to export MQ statistics to some monitoring packages including Prometheus, InfluxDB and OpenTSDB.
+This repository previously contained sample programs that exported MQ statistics to some monitoring packages. These have now been moved to a new [GitHub repository called mq-metric-samples](https://github.com/ibm-messaging/mq-metric-samples).
 
-A minimum level of MQ V9 is required to build this package.
+A minimum level of MQ V9 is required to build these packages.
 The monitoring data published by the queue manager is not available before that version; the interface also assumes availability of MQI structures from that level of MQ.
 
 ## Health Warning
@@ -25,7 +25,7 @@ Feedback on the utility of this package, thoughts about whether it should be cha
 
 ## Using the package
 
-To use code in this repository, you will need to be able to build Go applications, and have a copy of MQ installed to build against. It uses cgo to access the MQI C structures and definitions. It assumes that MQ has been installed in the default location on a Linux platform (/opt/mqm) but you can easily change the cgo directives in the source files if necessary.
+To use code in this repository, you will need to be able to build Go applications, and have a copy of MQ installed to build against. It uses cgo to access the MQI C structures and definitions. It assumes that MQ has been installed in the default location on a Linux platform (`/opt/mqm`) but you can easily change the cgo directives in the source files if necessary.
 
 Some Windows capability is also included. This has been tested with Go 1.10 compiler, which now permits standard Windows paths (eg including spaces) so the CGO directives can point at the normal MQ install path.
 
@@ -94,9 +94,13 @@ If you are unfamiliar with Go, the following steps can help create a working env
 
   ```go install ./src/github.com/ibm-messaging/mq-golang/mqmetric```
 
-* Compile the components you are interested in. For example
+* Use git to get a get a copy of the MQ samples metric clients in a new directory in the workspace.
 
-  ```go install ./src/github.com/ibm-messaging/mq-golang/cmd/mq_prometheus```
+  ```git clone https://github.com/ibm-messaging/mq-metric-samples.git src/github.com/ibm-messaging/mq-metric-samples```
+
+* Compile the sample programs you are interested in. For example:
+
+  ```go install ./src/github.com/ibm-messaging/mq-metric-samples/cmd/mq_prometheus```
 
 At this point, you should have a compiled copy of the code in `$GOPATH/bin`.