Skip to content

Commit fe06a09

Browse files
authored
Merge pull request #10 from ibm-messaging/mq-9.2
Update to MQ v9.2 client and update readme links
2 parents f916771 + 6c91c03 commit fe06a09

File tree

4 files changed

+10
-8
lines changed

4 files changed

+10
-8
lines changed

.gitignore

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,2 @@
1-
mq-golang-jms20
21
mq-golang-jms20.test
32
vendor

README.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -130,7 +130,7 @@ go test -run TestSampleSendReceiveWithErrorHandling
130130
## Getting started
131131

132132
### Installing the pre-requisites
133-
The IBM MQ client on which this library depends is supported on Linux and Windows, and is [now available for development use on MacOS](https://developer.ibm.com/messaging/2019/02/05/ibm-mq-macos-toolkit-for-developers/)).
133+
The IBM MQ client on which this library depends is supported on Linux and Windows, and is [now available for development use on MacOS](https://developer.ibm.com/components/ibm-mq/tutorials/mq-macos-dev/)).
134134

135135
1. Install Golang
136136
- This library has been validated with Golang v1.13.11. If you don't have Golang installed on your system you can [download it here](https://golang.org/doc/install) for MacOS, Linux or Windows
@@ -152,7 +152,7 @@ The IBM MQ client on which this library depends is supported on Linux and Window
152152
- If you have an existing queue manager then you can continue to use that
153153
- You can also deploy a queue manager using one of the following simple approaches
154154
- Select the Lite plan to deploy a free queue manager using the [IBM MQ on Cloud service](https://cloud.ibm.com/catalog/services/mq) (IBM SaaS offering)
155-
- Deploy IBM MQ for Developers for free in a container using the sample Docker container as described in the [Ready, Set, Connect - Docker tutorial](https://developer.ibm.com/messaging/learn-mq/mq-tutorials/mq-connect-to-queue-manager/#docker)
155+
- Deploy IBM MQ for Developers for free in a container using the sample Docker container as described in the [Ready, Set, Connect - Docker tutorial](https://developer.ibm.com/tutorials/mq-connect-app-queue-manager-containers/)
156156
- Install IBM MQ for Developers for free on [Windows](https://ibm.biz/mqdevwindows), [Linux](https://ibm.biz/mqdevlinuxrpm) or [Ubuntu](https://ibm.biz/mqdevubuntu)
157157

158158
### Configuring your environment
@@ -170,7 +170,7 @@ export CGO_LDFLAGS_ALLOW="-Wl,-rpath.*"
170170

171171
**If your client install is not located in the default installation location**, for example `/opt/mqm` then you also need to set the follow environment variables to point at your installation location. For example on Linux or MacOS;
172172
```bash
173-
export MQ_INSTALLATION_PATH=$HOME/9.1.5.0-IBM-MQC-Redist-LinuxX64
173+
export MQ_INSTALLATION_PATH=$HOME/9.2.0.0-IBM-MQC-Redist-LinuxX64
174174
export CGO_CFLAGS="-I$MQ_INSTALLATION_PATH/inc"
175175
export CGO_LDFLAGS="-L$MQ_INSTALLATION_PATH/lib64 -Wl,-rpath,$MQ_INSTALLATION_PATH/lib64"
176176
```
@@ -186,10 +186,10 @@ This project includes a series of tests that validate the successful operation o
186186

187187
The test cases use the `CreateConnectionFactoryFromDefaultJSONFiles` method to obtain details of a queue manager to connect to from two JSON files in your `/Downloads` directory;
188188
- `connection_info.json` contains information like the hostname/port/channel
189-
- If you are using the MQ on Cloud service you can download a pre-populated file directly from the queue manager details page as [described here](https://cloud.ibm.com/docs/services/mqcloud/mqoc_jms_tls.html#connection_info-json)
189+
- If you are using the MQ on Cloud service you can download a pre-populated file directly from the queue manager details page as [described here](https://cloud.ibm.com/docs/mqcloud?topic=mqcloud-mqoc_jms_tls#connection_info-json)
190190
- Otherwise you can insert details of your own queue manager into [this sample file](./config-samples/connection_info.json) and copy it to your `/Downloads` directory
191191
- `applicationApiKey.json` contains the Application username and password that will be used to connect to your queue manager
192-
- If you are using the MQ on Cloud service you can download a pre-populated file directly from the Application Permissions tab in the service console as [described here](https://cloud.ibm.com/docs/services/mqcloud/mqoc_jms_tls.html#apikey-json)
192+
- If you are using the MQ on Cloud service you can download a pre-populated file directly from the Application Permissions tab in the service console as [described here](https://cloud.ibm.com/docs/mqcloud?topic=mqcloud-mqoc_jms_tls#apikey-json)
193193
- Otherwise you can insert details of your own queue manager into [this sample file](./config-samples/applicationApiKey.json) and copy it to your `/Downloads` directory
194194

195195
Once you have added the details of your queue manager and user credentials into the two JSON files and placed them in your `/Downloads` directory you are ready to run the test, which is done in the same way as any other Go tests.
@@ -256,7 +256,7 @@ areas where the exact spelling has diverged a little from the Java form.
256256
* JMS 2.0 makes use of java.lang.AutoCloseable to automatically close objects
257257
* Golang doesn't have a direct equivalent so we recommend using "defer" to ensure that objects are automatically closed when the function completes
258258
* Method overloading
259-
* JMS 2.0 makes extensive use of method overloading in Java to define multiple methods with the same name but different parameters (for example the five different "send" methods on a [JMSProducer](https://github.com/eclipse-ee4j/jms-api/blob/master/src/main/java/javax/jms/JMSProducer.java#L87))
259+
* JMS 2.0 makes extensive use of method overloading in Java to define multiple methods with the same name but different parameters (for example the five different "send" methods on a [JMSProducer](https://github.com/eclipse-ee4j/jms-api/blob/master/api/src/main/java/jakarta/jms/JMSProducer.java#L87))
260260
* Golang doesn't allow method overloading so we have introduced slightly different methods names, such as Send and SendString in the [Golang JMSProducer object](./jms20subset/JMSProducer.go)
261261
* Generics
262262
* Similarly, JMS 2.0 has used Generics in Java to allow you to receive a [message body directly without casting](https://javaee.github.io/jms-spec/pages/JMS20MeansLessCode#receiving-synchronously-can-receive-mesage-payload-directly)

go.mod

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,6 @@ module github.com/ibm-messaging/mq-golang-jms20
33
go 1.13
44

55
require (
6-
github.com/ibm-messaging/mq-golang/v5 v5.0.0
6+
github.com/ibm-messaging/mq-golang/v5 v5.1.2
77
github.com/stretchr/testify v1.4.0
88
)

go.sum

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,11 @@
1+
github.com/davecgh/go-spew v1.1.0 h1:ZDRjVQ15GmhC3fiQ8ni8+OwkZQO4DARzQgrnXU1Liz8=
12
github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
23
github.com/ibm-messaging/mq-golang v1.0.1-0.20190820103725-19b946c185a8 h1:kUwSXeftVen12FRnShG+Ykhb2Kd6Cd/DbpWwbYal7j0=
34
github.com/ibm-messaging/mq-golang v1.0.1-0.20190820103725-19b946c185a8/go.mod h1:qjsZDb7m1oKnbPeDma2JVJTKgyCA91I4bcJ1qHY+gcA=
45
github.com/ibm-messaging/mq-golang/v5 v5.0.0 h1:9J8bsDoCo60rbSgB7ZAURPG3L5Kpr+F8dYNOwQ7Qnnk=
56
github.com/ibm-messaging/mq-golang/v5 v5.0.0/go.mod h1:ywCwmYbJOU/E0rl+z4GiNoxVMty68O+LVO39a1VMXrE=
7+
github.com/ibm-messaging/mq-golang/v5 v5.1.2 h1:u0e1Vce2TNqJpH088vF77rDMsnMRWnGaOIlxZo4DMZc=
8+
github.com/ibm-messaging/mq-golang/v5 v5.1.2/go.mod h1:ywCwmYbJOU/E0rl+z4GiNoxVMty68O+LVO39a1VMXrE=
69
github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
710
github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
811
github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=

0 commit comments

Comments
 (0)