rubywmq 0.3.0-sparc-solaris2.8-mq5.3
Sign up to get free protection for your applications and to get access to all the features.
- data/LICENSE +13 -0
- data/README +73 -0
- data/examples/each_a.rb +31 -0
- data/examples/each_b.rb +40 -0
- data/examples/each_header.rb +37 -0
- data/examples/files_to_q.cfg +24 -0
- data/examples/files_to_q.rb +47 -0
- data/examples/get_a.rb +34 -0
- data/examples/get_client.rb +50 -0
- data/examples/put1_a.rb +24 -0
- data/examples/put1_b.rb +32 -0
- data/examples/put1_c.rb +31 -0
- data/examples/put_a.rb +34 -0
- data/examples/put_b.rb +42 -0
- data/examples/put_dlh.rb +40 -0
- data/examples/put_dynamic_q.rb +37 -0
- data/examples/put_rfh.rb +66 -0
- data/examples/put_rfh2_a.rb +42 -0
- data/examples/put_rfh2_b.rb +42 -0
- data/examples/put_xmit_q.rb +32 -0
- data/examples/request.rb +59 -0
- data/examples/server.rb +96 -0
- data/lib/wmq/wmq.so +0 -0
- data/lib/wmq/wmq_const.rb +697 -0
- data/lib/wmq/wmq_const_admin.rb +275 -0
- data/lib/wmq/wmq_temp.rb +197 -0
- data/lib/wmq.rb +25 -0
- data/tests/test.rb +299 -0
- metadata +73 -0
data/LICENSE
ADDED
@@ -0,0 +1,13 @@
|
|
1
|
+
Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
2
|
+
|
3
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
you may not use this file except in compliance with the License.
|
5
|
+
You may obtain a copy of the License at
|
6
|
+
|
7
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
|
9
|
+
Unless required by applicable law or agreed to in writing, software
|
10
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
See the License for the specific language governing permissions and
|
13
|
+
limitations under the License.
|
data/README
ADDED
@@ -0,0 +1,73 @@
|
|
1
|
+
== Description
|
2
|
+
rubywmq - Ruby WMQ is a Ruby interface into WebSphere MQ, previously called MQSeries
|
3
|
+
|
4
|
+
== Synopsis
|
5
|
+
require 'wmq'
|
6
|
+
|
7
|
+
WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
|
8
|
+
qmgr.put(:q_name=>'TEST.QUEUE', :data => 'Hello World')
|
9
|
+
end
|
10
|
+
|
11
|
+
== Building Ruby WMQ
|
12
|
+
Building Ruby WMQ on UNIX/Linux
|
13
|
+
-------------------------------
|
14
|
+
The following is required to build from source code
|
15
|
+
� A �C� compiler
|
16
|
+
� The WebSphere MQ Software development toolkit
|
17
|
+
|
18
|
+
Extracting the source code package:
|
19
|
+
� unzip package.zip
|
20
|
+
� tar -xvf �package.tar
|
21
|
+
|
22
|
+
cd ext/wmq
|
23
|
+
Edit the file build.sh and edit the location of WebSphere MQ (if not in /opt/mqm)
|
24
|
+
Also edit extconf.rb and extconf_client.rb with the location of WebSphere MQ (if not in /opt/mqm)
|
25
|
+
|
26
|
+
Run build.sh
|
27
|
+
|
28
|
+
For any questions, or to report build errors, submit a new Support Request:
|
29
|
+
http://rubywmq.rubyforge.org
|
30
|
+
|
31
|
+
Building Ruby WMQ on Windows
|
32
|
+
----------------------------
|
33
|
+
The following is required to build from source code
|
34
|
+
� The Visual C++ 6.0 compiler
|
35
|
+
� The WebSphere MQ Software development toolkit
|
36
|
+
|
37
|
+
cd ext\wmq
|
38
|
+
Edit the file build.bat and edit the location of WebSphere MQ
|
39
|
+
(if not in C:\Program Files\IBM\WebSphere MQ)
|
40
|
+
and the location of Visual C++ 6 (if not C:\Program Files\Microsoft Visual Studio\VC98)
|
41
|
+
Also edit extconf.rb and extconf_client.rb with the location of WebSphere MQ (if not in C:\Program Files\IBM\WebSphere MQ)
|
42
|
+
|
43
|
+
Run build.bat
|
44
|
+
|
45
|
+
== Support
|
46
|
+
For any questions, or to report build errors, submit a new Support Request:
|
47
|
+
http://rubywmq.rubyforge.org
|
48
|
+
|
49
|
+
== Future Plans
|
50
|
+
Add more formatting option contants and related methods.
|
51
|
+
|
52
|
+
== License
|
53
|
+
Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
54
|
+
|
55
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
56
|
+
you may not use this file except in compliance with the License.
|
57
|
+
You may obtain a copy of the License at
|
58
|
+
|
59
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
60
|
+
|
61
|
+
Unless required by applicable law or agreed to in writing, software
|
62
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
63
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
64
|
+
See the License for the specific language governing permissions and
|
65
|
+
limitations under the License.
|
66
|
+
|
67
|
+
== Copyright
|
68
|
+
(C) 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
69
|
+
All Rights Reserved
|
70
|
+
|
71
|
+
== Author
|
72
|
+
Reid Morrison
|
73
|
+
rubywmq at gmail dot com
|
data/examples/each_a.rb
ADDED
@@ -0,0 +1,31 @@
|
|
1
|
+
################################################################################
|
2
|
+
# Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
3
|
+
#
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
# you may not use this file except in compliance with the License.
|
6
|
+
# You may obtain a copy of the License at
|
7
|
+
#
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
#
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
# See the License for the specific language governing permissions and
|
14
|
+
# limitations under the License.
|
15
|
+
################################################################################
|
16
|
+
|
17
|
+
#
|
18
|
+
# Sample : each() : Retrieve all messages from a queue
|
19
|
+
# If no messages are on the queue, the program
|
20
|
+
# completes without waiting
|
21
|
+
#
|
22
|
+
require 'wmq/wmq'
|
23
|
+
|
24
|
+
WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
|
25
|
+
qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:input) do |queue|
|
26
|
+
queue.each do |message|
|
27
|
+
puts "Data Received: #{message.data}"
|
28
|
+
end
|
29
|
+
end
|
30
|
+
puts 'Completed.'
|
31
|
+
end
|
data/examples/each_b.rb
ADDED
@@ -0,0 +1,40 @@
|
|
1
|
+
################################################################################
|
2
|
+
# Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
3
|
+
#
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
# you may not use this file except in compliance with the License.
|
6
|
+
# You may obtain a copy of the License at
|
7
|
+
#
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
#
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
# See the License for the specific language governing permissions and
|
14
|
+
# limitations under the License.
|
15
|
+
################################################################################
|
16
|
+
|
17
|
+
#
|
18
|
+
# Sample : each() : Retrieve all messages from a queue that
|
19
|
+
# have the same correlation id
|
20
|
+
#
|
21
|
+
require 'wmq/wmq'
|
22
|
+
|
23
|
+
WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
|
24
|
+
qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:input) do |queue|
|
25
|
+
message = WMQ::Message.new
|
26
|
+
|
27
|
+
# Retrieve First message
|
28
|
+
if queue.get(:message=>message)
|
29
|
+
puts "Data Received: #{message.data}"
|
30
|
+
|
31
|
+
#Retrieve all subsequent messages that have the same correlation id
|
32
|
+
queue.each(:message=>message, :match=>WMQ::MQMO_MATCH_CORREL_ID) do |msg|
|
33
|
+
puts "Matching Data Received: #{msg.data}"
|
34
|
+
end
|
35
|
+
else
|
36
|
+
puts 'No message available'
|
37
|
+
end
|
38
|
+
end
|
39
|
+
puts 'Completed.'
|
40
|
+
end
|
@@ -0,0 +1,37 @@
|
|
1
|
+
################################################################################
|
2
|
+
# Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
3
|
+
#
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
# you may not use this file except in compliance with the License.
|
6
|
+
# You may obtain a copy of the License at
|
7
|
+
#
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
#
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
# See the License for the specific language governing permissions and
|
14
|
+
# limitations under the License.
|
15
|
+
################################################################################
|
16
|
+
|
17
|
+
#
|
18
|
+
# Sample : each() : Retrieve all messages from a queue
|
19
|
+
# If no messages are on the queue, the program
|
20
|
+
# completes without waiting
|
21
|
+
#
|
22
|
+
require 'wmq/wmq'
|
23
|
+
|
24
|
+
WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
|
25
|
+
qmgr.open_queue(:q_name=>'TEST.DEAD', :mode=>:browse) do |queue|
|
26
|
+
queue.each do |message|
|
27
|
+
puts "Data Received: #{message.data}"
|
28
|
+
|
29
|
+
puts "Message Descriptor:"
|
30
|
+
p message.descriptor
|
31
|
+
|
32
|
+
puts "Headers Received:"
|
33
|
+
message.headers.each {|header| p header}
|
34
|
+
end
|
35
|
+
end
|
36
|
+
puts 'Completed.'
|
37
|
+
end
|
@@ -0,0 +1,24 @@
|
|
1
|
+
dev:
|
2
|
+
qmgr_options:
|
3
|
+
:q_mgr_name: REID
|
4
|
+
output_queue:
|
5
|
+
:q_name: TEST.DEAD.BACKUP
|
6
|
+
put_options:
|
7
|
+
:new_msg_id: true
|
8
|
+
descriptor:
|
9
|
+
:format: MQSTR
|
10
|
+
source_directory: samples
|
11
|
+
|
12
|
+
test:
|
13
|
+
qmgr_options:
|
14
|
+
:q_mgr_name: TEST.QMGR
|
15
|
+
:channel_name: SYSTEM.DEF.SVRCONN
|
16
|
+
:connection_name: remotehost(1414)
|
17
|
+
output_queue:
|
18
|
+
:q_name: TEST.DEAD.BACKUP
|
19
|
+
put_options:
|
20
|
+
:new_msg_id: true
|
21
|
+
descriptor:
|
22
|
+
:format: MQSTR
|
23
|
+
source_directory: samples
|
24
|
+
|
@@ -0,0 +1,47 @@
|
|
1
|
+
################################################################################
|
2
|
+
# Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
3
|
+
#
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
# you may not use this file except in compliance with the License.
|
6
|
+
# You may obtain a copy of the License at
|
7
|
+
#
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
#
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
# See the License for the specific language governing permissions and
|
14
|
+
# limitations under the License.
|
15
|
+
################################################################################
|
16
|
+
|
17
|
+
#
|
18
|
+
# Sample : files_to_q : Place all files in a directory to a queue
|
19
|
+
# Each file is written as a separate message
|
20
|
+
#
|
21
|
+
require 'find'
|
22
|
+
require 'yaml'
|
23
|
+
require 'wmq/wmq'
|
24
|
+
|
25
|
+
# Call program passing environment name as first parameter
|
26
|
+
# The environment corresponds to an entry in the config file
|
27
|
+
# Defaults to dev
|
28
|
+
env = ARGV[0] || raise("Command line argument 'environment' is required")
|
29
|
+
config = YAML::load_file('files_to_q.cfg')[env]
|
30
|
+
|
31
|
+
message = WMQ::Message.new
|
32
|
+
message.descriptor = config['descriptor'] || {}
|
33
|
+
tstart = Time.now
|
34
|
+
counter = 0
|
35
|
+
WMQ::QueueManager.connect(config['qmgr_options']) do |qmgr|
|
36
|
+
qmgr.open_queue({:mode=>:output}.merge(config['output_queue'])) do |queue|
|
37
|
+
Find.find(config['source_directory']) do |path|
|
38
|
+
unless FileTest.directory?(path)
|
39
|
+
printf("%5d: #{path}\n",counter = counter + 1)
|
40
|
+
message.data = File.read(path)
|
41
|
+
queue.put({:message => message}.merge(config['put_options']))
|
42
|
+
end
|
43
|
+
end
|
44
|
+
end
|
45
|
+
end
|
46
|
+
duration = Time.now - tstart
|
47
|
+
printf "Processed #{counter} messages in %.3f seconds. Average: %.3f messages/second\n", duration, counter/duration
|
data/examples/get_a.rb
ADDED
@@ -0,0 +1,34 @@
|
|
1
|
+
################################################################################
|
2
|
+
# Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
3
|
+
#
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
# you may not use this file except in compliance with the License.
|
6
|
+
# You may obtain a copy of the License at
|
7
|
+
#
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
#
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
# See the License for the specific language governing permissions and
|
14
|
+
# limitations under the License.
|
15
|
+
################################################################################
|
16
|
+
|
17
|
+
#
|
18
|
+
# Sample : get() : Retrieve a single message from a queue
|
19
|
+
# If no messages are on the queue, message.data is nil
|
20
|
+
#
|
21
|
+
require 'wmq/wmq'
|
22
|
+
|
23
|
+
WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
|
24
|
+
qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:input) do |queue|
|
25
|
+
|
26
|
+
message = WMQ::Message.new
|
27
|
+
if queue.get(:message => message)
|
28
|
+
puts "Data Received: #{message.data}"
|
29
|
+
else
|
30
|
+
puts 'No message available'
|
31
|
+
end
|
32
|
+
end
|
33
|
+
end
|
34
|
+
|
@@ -0,0 +1,50 @@
|
|
1
|
+
################################################################################
|
2
|
+
# Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
3
|
+
#
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
# you may not use this file except in compliance with the License.
|
6
|
+
# You may obtain a copy of the License at
|
7
|
+
#
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
#
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
# See the License for the specific language governing permissions and
|
14
|
+
# limitations under the License.
|
15
|
+
################################################################################
|
16
|
+
|
17
|
+
#
|
18
|
+
# Sample : get() : Retrieve a single message from a queue
|
19
|
+
# If no messages are on the queue, message.data is nil
|
20
|
+
#
|
21
|
+
# The Client connection is determined by the :connection_name parameter supplied
|
22
|
+
# to QueueManager::connect or QueueManager::new
|
23
|
+
#
|
24
|
+
# If :connection_name is not present, a WebSphere MQ Server connection will be used
|
25
|
+
# I.e. Local server connection
|
26
|
+
#
|
27
|
+
require 'wmq/wmq'
|
28
|
+
|
29
|
+
WMQ::QueueManager.connect(
|
30
|
+
:connection_name => 'localhost(1414)', # Use MQ Client Library
|
31
|
+
:channel_name => 'SYSTEM.DEF.SVRCONN', # Optional, since this is the default value
|
32
|
+
:transport_type => WMQ::MQXPT_TCP # Optional, since this is the default value
|
33
|
+
) do |qmgr|
|
34
|
+
qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:input) do |queue|
|
35
|
+
|
36
|
+
message = WMQ::Message.new
|
37
|
+
if queue.get(:message => message)
|
38
|
+
puts "Data Received: #{message.data}"
|
39
|
+
|
40
|
+
puts "Message Descriptor:"
|
41
|
+
p message.descriptor
|
42
|
+
|
43
|
+
puts "Headers Received:"
|
44
|
+
message.headers.each {|header| p header}
|
45
|
+
else
|
46
|
+
puts 'No message available'
|
47
|
+
end
|
48
|
+
end
|
49
|
+
end
|
50
|
+
|
data/examples/put1_a.rb
ADDED
@@ -0,0 +1,24 @@
|
|
1
|
+
################################################################################
|
2
|
+
# Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
3
|
+
#
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
# you may not use this file except in compliance with the License.
|
6
|
+
# You may obtain a copy of the License at
|
7
|
+
#
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
#
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
# See the License for the specific language governing permissions and
|
14
|
+
# limitations under the License.
|
15
|
+
################################################################################
|
16
|
+
|
17
|
+
#
|
18
|
+
# Sample : put1() : Put a single message to a queue
|
19
|
+
#
|
20
|
+
require 'wmq/wmq'
|
21
|
+
|
22
|
+
WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
|
23
|
+
qmgr.put(:q_name=>'TEST.QUEUE', :data => 'Hello World')
|
24
|
+
end
|
data/examples/put1_b.rb
ADDED
@@ -0,0 +1,32 @@
|
|
1
|
+
################################################################################
|
2
|
+
# Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
3
|
+
#
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
# you may not use this file except in compliance with the License.
|
6
|
+
# You may obtain a copy of the License at
|
7
|
+
#
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
#
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
# See the License for the specific language governing permissions and
|
14
|
+
# limitations under the License.
|
15
|
+
################################################################################
|
16
|
+
|
17
|
+
#
|
18
|
+
# Sample : put1() : Put a single message to a queue
|
19
|
+
#
|
20
|
+
# Set the correlation id to a text string
|
21
|
+
#
|
22
|
+
require 'wmq/wmq'
|
23
|
+
|
24
|
+
WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
|
25
|
+
|
26
|
+
message = WMQ::Message.new
|
27
|
+
message.data = 'Hello World'
|
28
|
+
message.descriptor[:correl_id] = 'My first message'
|
29
|
+
|
30
|
+
qmgr.put(:q_name=>'TEST.QUEUE', :message=>message)
|
31
|
+
end
|
32
|
+
|
data/examples/put1_c.rb
ADDED
@@ -0,0 +1,31 @@
|
|
1
|
+
################################################################################
|
2
|
+
# Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
3
|
+
#
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
# you may not use this file except in compliance with the License.
|
6
|
+
# You may obtain a copy of the License at
|
7
|
+
#
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
#
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
# See the License for the specific language governing permissions and
|
14
|
+
# limitations under the License.
|
15
|
+
################################################################################
|
16
|
+
|
17
|
+
#
|
18
|
+
# Sample : put() : Put a single request message to a queue
|
19
|
+
#
|
20
|
+
require 'wmq/wmq'
|
21
|
+
|
22
|
+
WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
|
23
|
+
message = WMQ::Message.new
|
24
|
+
message.data = 'Hello World'
|
25
|
+
|
26
|
+
message.descriptor = {
|
27
|
+
:msg_type=> WMQ::MQMT_REQUEST,
|
28
|
+
:reply_to_q=>'TEST.REPLY.QUEUE'}
|
29
|
+
|
30
|
+
qmgr.put(:q_name=>'TEST.QUEUE', :message => message)
|
31
|
+
end
|
data/examples/put_a.rb
ADDED
@@ -0,0 +1,34 @@
|
|
1
|
+
################################################################################
|
2
|
+
# Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
3
|
+
#
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
# you may not use this file except in compliance with the License.
|
6
|
+
# You may obtain a copy of the License at
|
7
|
+
#
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
#
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
# See the License for the specific language governing permissions and
|
14
|
+
# limitations under the License.
|
15
|
+
################################################################################
|
16
|
+
|
17
|
+
#
|
18
|
+
# Sample : put() : Put a single message to a queue
|
19
|
+
# Open the queue so that multiple puts can be performed
|
20
|
+
#
|
21
|
+
require 'wmq/wmq'
|
22
|
+
|
23
|
+
WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
|
24
|
+
qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
|
25
|
+
|
26
|
+
# First message
|
27
|
+
queue.put(:data => 'Hello World')
|
28
|
+
|
29
|
+
# Second message
|
30
|
+
# This message will have new message and correlation id's
|
31
|
+
queue.put(:data => 'Hello Again')
|
32
|
+
end
|
33
|
+
end
|
34
|
+
|
data/examples/put_b.rb
ADDED
@@ -0,0 +1,42 @@
|
|
1
|
+
################################################################################
|
2
|
+
# Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
3
|
+
#
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
# you may not use this file except in compliance with the License.
|
6
|
+
# You may obtain a copy of the License at
|
7
|
+
#
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
#
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
# See the License for the specific language governing permissions and
|
14
|
+
# limitations under the License.
|
15
|
+
################################################################################
|
16
|
+
|
17
|
+
#
|
18
|
+
# Sample : put() : Put two Messages to a queue
|
19
|
+
# Open the queue so that multiple puts can be performed
|
20
|
+
# Ensure that all messages have the same correlation id
|
21
|
+
#
|
22
|
+
require 'wmq/wmq'
|
23
|
+
|
24
|
+
WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
|
25
|
+
qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
|
26
|
+
|
27
|
+
message = WMQ::Message.new
|
28
|
+
|
29
|
+
# First message
|
30
|
+
# Results in a WMQ generated msg_id and empty correl_id
|
31
|
+
message.data = 'Hello World'
|
32
|
+
queue.put(:message => message)
|
33
|
+
|
34
|
+
# Second message
|
35
|
+
# new_msg_id will cause the second message to have a new message id
|
36
|
+
# otherwise both messages will have the same message and correlation id's
|
37
|
+
# This message will have the same correlation id as the first message (empty)
|
38
|
+
message.data = 'Hello Again'
|
39
|
+
p message.descriptor
|
40
|
+
queue.put(:message => message, :new_msg_id => true)
|
41
|
+
end
|
42
|
+
end
|
data/examples/put_dlh.rb
ADDED
@@ -0,0 +1,40 @@
|
|
1
|
+
################################################################################
|
2
|
+
# Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
3
|
+
#
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
# you may not use this file except in compliance with the License.
|
6
|
+
# You may obtain a copy of the License at
|
7
|
+
#
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
#
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
# See the License for the specific language governing permissions and
|
14
|
+
# limitations under the License.
|
15
|
+
################################################################################
|
16
|
+
|
17
|
+
#
|
18
|
+
# Sample : put() : Put a message to a queue with a dead letter header
|
19
|
+
# Open the queue so that multiple puts can be performed
|
20
|
+
#
|
21
|
+
require 'wmq/wmq'
|
22
|
+
|
23
|
+
WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
|
24
|
+
qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
|
25
|
+
message = WMQ::Message.new
|
26
|
+
message.data = 'Hello World'
|
27
|
+
|
28
|
+
message.headers = [
|
29
|
+
{:header_type =>:dead_letter_header,
|
30
|
+
:reason => WMQ::MQRC_UNKNOWN_REMOTE_Q_MGR,
|
31
|
+
:dest_q_name =>'ORIGINAL_QUEUE_NAME',
|
32
|
+
:dest_q_mgr_name =>'BAD_Q_MGR'}
|
33
|
+
]
|
34
|
+
|
35
|
+
message.descriptor[:format] = WMQ::MQFMT_STRING
|
36
|
+
|
37
|
+
queue.put(:message=>message)
|
38
|
+
end
|
39
|
+
end
|
40
|
+
|
@@ -0,0 +1,37 @@
|
|
1
|
+
################################################################################
|
2
|
+
# Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
3
|
+
#
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
# you may not use this file except in compliance with the License.
|
6
|
+
# You may obtain a copy of the License at
|
7
|
+
#
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
#
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
# See the License for the specific language governing permissions and
|
14
|
+
# limitations under the License.
|
15
|
+
################################################################################
|
16
|
+
|
17
|
+
#
|
18
|
+
# Sample : put() : Put a single message to a queue
|
19
|
+
# Create the queue if it does not already exist
|
20
|
+
#
|
21
|
+
# Note : The queue name is that of the model queue
|
22
|
+
# The dynamic_q_name is the actual queue name
|
23
|
+
#
|
24
|
+
# This sample is more usefull if the model queue was a Permanent Dynamic one.
|
25
|
+
# That way the queue would remain after termination of this code.
|
26
|
+
# In this sample the queue will disappear when this program terminates
|
27
|
+
#
|
28
|
+
require 'wmq/wmq'
|
29
|
+
|
30
|
+
WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
|
31
|
+
qmgr.open_queue(:q_name => 'SYSTEM.DEFAULT.MODEL.QUEUE',
|
32
|
+
:dynamic_q_name => 'TEST.QUEUE.SAMPLE',
|
33
|
+
:mode => :output
|
34
|
+
) do |queue|
|
35
|
+
queue.put(:data => 'Hello World')
|
36
|
+
end
|
37
|
+
end
|
data/examples/put_rfh.rb
ADDED
@@ -0,0 +1,66 @@
|
|
1
|
+
################################################################################
|
2
|
+
# Copyright 2006 J. Reid Morrison. Dimension Solutions, Inc.
|
3
|
+
#
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
# you may not use this file except in compliance with the License.
|
6
|
+
# You may obtain a copy of the License at
|
7
|
+
#
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
#
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
# See the License for the specific language governing permissions and
|
14
|
+
# limitations under the License.
|
15
|
+
################################################################################
|
16
|
+
|
17
|
+
#
|
18
|
+
# Sample : put() : Put a message to a queue with a Refernce header
|
19
|
+
# Open the queue so that multiple puts can be performed
|
20
|
+
#
|
21
|
+
require 'wmq/wmq'
|
22
|
+
|
23
|
+
# The Rules Format header (MQRFH) allows a list of name value pairs to be sent along
|
24
|
+
# with a WMQ message. These name value pairs are represented as follows on the "wire":
|
25
|
+
# Name1 Value1 Name2 Value2 Name3 Value3
|
26
|
+
#
|
27
|
+
# Ruby WMQ converts the above string of data into a Ruby hash by
|
28
|
+
# using the name as the key, as follows:
|
29
|
+
# data = {
|
30
|
+
# 'Name1' => 'Value1',
|
31
|
+
# 'Name2' => 'Value2',
|
32
|
+
# 'Name3' => 'Value3'
|
33
|
+
# }
|
34
|
+
#
|
35
|
+
# Since a name can consist of any character except null, it is stored as a String
|
36
|
+
#
|
37
|
+
# Note: It is possible to send or receive the same Name with multiple values using an array.
|
38
|
+
# E.g. Name1 Value1 Name2 Value2 Name1 Value3
|
39
|
+
# Becomes:
|
40
|
+
# data = {
|
41
|
+
# 'Name1' => ['Value1', 'Value3'],
|
42
|
+
# 'Name2' => 'Value2'
|
43
|
+
# }
|
44
|
+
#
|
45
|
+
# Note: Since a Hash does not preserve order, reading a Rules Format Header and then writing
|
46
|
+
# it out immediately again could result in re-ordering of the name value pairs.
|
47
|
+
#
|
48
|
+
|
49
|
+
WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
|
50
|
+
qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
|
51
|
+
message = WMQ::Message.new
|
52
|
+
message.data = 'Hello World'
|
53
|
+
|
54
|
+
message.headers = [
|
55
|
+
{:header_type =>:rf_header,
|
56
|
+
:name_value => {'name1' => 'value1',
|
57
|
+
'name2' => 'value2',
|
58
|
+
'name3' => ['value 3a', 'value 3b']}
|
59
|
+
}]
|
60
|
+
|
61
|
+
message.descriptor[:format] = WMQ::MQFMT_STRING
|
62
|
+
|
63
|
+
queue.put(:message=>message)
|
64
|
+
end
|
65
|
+
end
|
66
|
+
|