ekaranto-rubywmq 2.0.0

data/Rakefile

@@ -0,0 +1,87 @@
+lib = File.expand_path('../lib/', __FILE__)
+$:.unshift lib unless $:.include?(lib)
+
+require 'rubygems'
+require 'rake/clean'
+require 'rake/testtask'
+require 'date'
+require 'wmq/version'
+
+desc "Build Ruby Source gem"
+task :gem  do |t|
+  excludes = [
+    'lib/wmq/constants.rb',
+    'lib/wmq/constants_admin.rb',
+    'ext/wmq_structs.c',
+    'ext/wmq_reason.c',
+    'ext/Makefile',
+    'ext/*.o',
+    'ext/wmq.so',
+    '*.gem',
+    'nbproject'
+  ]
+
+  gemspec = Gem::Specification.new do |spec|
+    spec.name              = 'ekaranto-rubywmq'
+    spec.version           = WMQ::VERSION
+    spec.platform          = Gem::Platform::RUBY
+    spec.authors           = ['Reid Morrison', 'Edwin Fine']
+    spec.email             = ['reidmo@gmail.com']
+    spec.homepage          = 'https://github.com/reidmorrison/rubywmq'
+    spec.date              = Date.today.to_s
+    spec.summary           = "Native Ruby interface into WebSphere MQ"
+    spec.description       = "RubyWMQ is a high performance native Ruby interface into WebSphere MQ."
+    spec.files             = FileList["./**/*"].exclude(*excludes).map{|f| f.sub(/^\.\//, '')} +
+                             ['.document']
+    spec.extensions        << 'ext/extconf.rb'
+    spec.rubyforge_project = 'rubywmq'
+    spec.test_file         = 'tests/test.rb'
+    spec.has_rdoc          = true
+    spec.required_ruby_version = '>= 1.8.4'
+    spec.add_development_dependency 'shoulda'
+    spec.requirements << 'WebSphere MQ v5.3, v6 or v7 Client or Server with Development Kit'
+  end
+  Gem::Builder.new(gemspec).build
+end
+
+desc "Build a binary gem including pre-compiled binary files for re-distribution"
+task :binary  do |t|
+  # Move compiled files into locations for repackaging as a binary gem
+  FileUtils.mkdir_p('lib/wmq')
+  Dir['ext/lib/*.rb'].each{|file| FileUtils.copy(file, File.join('lib/wmq', File.basename(file)))}
+  FileUtils.copy('ext/wmq.so', 'lib/wmq/wmq.so')
+
+  gemspec = Gem::Specification.new do |spec|
+    spec.name              = 'ekaranto-rubywmq'
+    spec.version           = WMQ::VERSION
+    spec.platform          = Gem::Platform::CURRENT
+    spec.authors           = ['Reid Morrison', 'Edwin Fine']
+    spec.email             = ['reidmo@gmail.com']
+    spec.homepage          = 'https://github.com/reidmorrison/rubywmq'
+    spec.date              = Date.today.to_s
+    spec.summary           = "Native Ruby interface into WebSphere MQ"
+    spec.description       = "RubyWMQ is a high performance native Ruby interface into WebSphere MQ."
+    spec.files             = Dir['examples/**/*.rb'] +
+                             Dir['examples/**/*.cfg'] +
+                             Dir['doc/**/*.*'] +
+                             Dir['lib/**/*.rb'] +
+                             ['lib/wmq/wmq.so', 'tests/test.rb', 'README', 'LICENSE']
+    spec.rubyforge_project = 'rubywmq'
+    spec.test_file         = 'tests/test.rb'
+    spec.has_rdoc          = false
+    spec.required_ruby_version = '>= 1.8.4'
+    spec.add_development_dependency 'shoulda'
+    spec.requirements << 'WebSphere MQ v5.3, v6 or v7 Client or Server with Development Kit'
+  end
+  Gem::Builder.new(gemspec).build
+end
+
+desc "Run Test Suite"
+task :test do
+  Rake::TestTask.new(:functional) do |t|
+    t.test_files = FileList['test/*_test.rb']
+    t.verbose    = true
+  end
+
+  Rake::Task['functional'].invoke
+end

data/examples/each_a.rb

@@ -0,0 +1,16 @@
+#
+# Sample : each() : Retrieve all messages from a queue
+#          If no messages are on the queue, the program
+#          completes without waiting
+#
+require 'rubygems'
+require 'wmq'
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:input) do |queue|
+    queue.each do |message|
+      puts "Data Received: #{message.data}"
+    end
+  end
+  puts 'Completed.'
+end

data/examples/each_b.rb

@@ -0,0 +1,25 @@
+#
+# Sample : each() : Retrieve all messages from a queue that
+#          have the same correlation id
+#
+require 'rubygems'
+require 'wmq'
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:input) do |queue|
+    message = WMQ::Message.new
+
+    # Retrieve First message
+    if queue.get(:message=>message)
+      puts "Data Received: #{message.data}"
+
+      #Retrieve all subsequent messages that have the same correlation id
+      queue.each(:message=>message, :match=>WMQ::MQMO_MATCH_CORREL_ID) do |msg|
+        puts "Matching Data Received: #{msg.data}"
+      end
+    else
+      puts 'No message available'
+    end
+  end
+  puts 'Completed.'
+end

data/examples/each_header.rb

@@ -0,0 +1,22 @@
+#
+# Sample : each() : Retrieve all messages from a queue
+#          If no messages are on the queue, the program
+#          completes without waiting
+#
+require 'rubygems'
+require 'wmq'
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.open_queue(:q_name=>'TEST.DEAD', :mode=>:browse) do |queue|
+    queue.each do |message|
+      puts "Data Received: #{message.data}"
+
+      puts "Message Descriptor:"
+      p message.descriptor
+
+      puts "Headers Received:"
+      message.headers.each {|header| p header}
+    end
+  end
+  puts 'Completed.'
+end

data/examples/files_to_q.cfg

@@ -0,0 +1,24 @@
+dev:
+  qmgr_options:
+    :q_mgr_name: REID
+  output_queue:
+    :q_name: TEST.QUEUE
+  put_options:
+    :new_msg_id: true
+  descriptor:
+    :format: MQSTR
+  source_directory: messages
+
+test:
+  qmgr_options:
+    :q_mgr_name: TEST.QMGR
+    :channel_name: SYSTEM.DEF.SVRCONN
+    :connection_name: remotehost(1414)
+  output_queue:
+    :q_name: TEST.QUEUE
+  put_options:
+    :new_msg_id: true
+  descriptor:
+    :format: MQSTR
+  source_directory: messages
+

data/examples/files_to_q.rb

@@ -0,0 +1,31 @@
+#
+# Example : files_to_q : Place all files in a directory to a queue
+#          Each file is written as a separate message
+#
+require 'rubygems'
+require 'find'
+require 'yaml'
+require 'wmq'
+
+# Call program passing environment name as first parameter
+#   The environment corresponds to an entry in the config file
+env = ARGV[0] || raise("Command line argument 'environment' is required")
+config = YAML::load_file('files_to_q.cfg')[env]
+
+message = WMQ::Message.new
+message.descriptor = config['descriptor'] || {}
+tstart = Time.now
+counter = 0
+WMQ::QueueManager.connect(config['qmgr_options']) do |qmgr|
+  qmgr.open_queue({:mode=>:output}.merge(config['output_queue'])) do |queue|
+    Find.find(config['source_directory']) do |path|
+      unless FileTest.directory?(path)
+        printf("%5d: #{path}\n",counter = counter + 1)
+        message.data = File.read(path)
+        queue.put({:message => message}.merge(config['put_options']))
+      end
+    end
+  end
+end
+duration = Time.now - tstart
+printf "Processed #{counter} messages in %.3f seconds. Average: %.3f messages/second\n", duration, counter/duration

data/examples/get_a.rb

@@ -0,0 +1,19 @@
+#
+# Sample : get() : Retrieve a single message from a queue
+#          If no messages are on the queue, message.data is nil
+#
+require 'rubygems'
+require 'wmq'
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:input) do |queue|
+
+    message = WMQ::Message.new
+    if queue.get(:message => message)
+      puts "Data Received: #{message.data}"
+    else
+      puts 'No message available'
+    end
+  end
+end
+

data/examples/get_client.rb

@@ -0,0 +1,35 @@
+#
+# Sample : get() : Retrieve a single message from a queue
+#          If no messages are on the queue, message.data is nil
+#
+# The Client connection is determined by the :connection_name parameter supplied
+# to QueueManager::connect or QueueManager::new
+#
+# If :connection_name is not present, a WebSphere MQ Server connection will be used
+# I.e. Local server connection
+#
+require 'rubygems'
+require 'wmq'
+
+WMQ::QueueManager.connect(
+            :connection_name => 'localhost(1414)',        # Use MQ Client Library
+            :channel_name    => 'SYSTEM.DEF.SVRCONN',     # Optional, since this is the default value
+            :transport_type  => WMQ::MQXPT_TCP            # Optional, since this is the default value
+       ) do |qmgr|
+  qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:input) do |queue|
+
+    message = WMQ::Message.new
+    if queue.get(:message => message)
+      puts "Data Received: #{message.data}"
+
+      puts "Message Descriptor:"
+      p message.descriptor
+
+      puts "Headers Received:"
+      message.headers.each {|header| p header}
+    else
+      puts 'No message available'
+    end
+  end
+end
+

data/examples/put1_a.rb

@@ -0,0 +1,9 @@
+#
+# Sample : put1() : Put a single message to a queue
+#
+require 'rubygems'
+require 'wmq'
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.put(:q_name=>'TEST.QUEUE', :data => 'Hello World')
+end

data/examples/put1_b.rb

@@ -0,0 +1,17 @@
+#
+# Sample : put1() : Put a single message to a queue
+#
+#          Set the correlation id to a text string
+#
+require 'rubygems'
+require 'wmq'
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+
+  message = WMQ::Message.new
+  message.data = 'Hello World'
+  message.descriptor[:correl_id] = 'My first message'
+
+  qmgr.put(:q_name=>'TEST.QUEUE', :message=>message)
+end
+

data/examples/put1_c.rb

@@ -0,0 +1,16 @@
+#
+# Sample : put() : Put a single request message to a queue
+#
+require 'rubygems'
+require 'wmq'
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  message = WMQ::Message.new
+  message.data = 'Hello World'
+
+  message.descriptor = {
+    :msg_type=> WMQ::MQMT_REQUEST,
+    :reply_to_q=>'TEST.REPLY.QUEUE'}
+
+  qmgr.put(:q_name=>'TEST.QUEUE', :message => message)
+end

data/examples/put_a.rb

@@ -0,0 +1,19 @@
+#
+# Sample : put() : Put a single message to a queue
+#          Open the queue so that multiple puts can be performed
+#
+require 'rubygems'
+require 'wmq'
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
+
+    # First message
+    queue.put(:data => 'Hello World')
+
+    # Second message
+    #   This message will have new message and correlation id's
+    queue.put(:data => 'Hello Again')
+  end
+end
+

data/examples/put_b.rb

@@ -0,0 +1,27 @@
+#
+# Sample : put() : Put two Messages to a queue
+#          Open the queue so that multiple puts can be performed
+#          Ensure that all messages have the same correlation id
+#
+require 'rubygems'
+require 'wmq'
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
+
+    message = WMQ::Message.new
+
+    # First message
+    #   Results in a WMQ generated msg_id and empty correl_id
+    message.data = 'Hello World'
+    queue.put(:message => message)
+
+    # Second message
+    #   new_msg_id will cause the second message to have a new message id
+    #   otherwise both messages will have the same message and correlation id's
+    #   This message will have the same correlation id as the first message (empty)
+    message.data = 'Hello Again'
+    p message.descriptor
+    queue.put(:message => message, :new_msg_id => true)
+  end
+end

data/examples/put_dlh.rb

@@ -0,0 +1,25 @@
+#
+# Sample : put() : Put a message to a queue with a dead letter header
+#          Open the queue so that multiple puts can be performed
+#
+require 'rubygems'
+require 'wmq'
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
+    message = WMQ::Message.new
+    message.data = 'Hello World'
+
+    message.headers = [
+     {:header_type =>:dead_letter_header,
+      :reason      => WMQ::MQRC_UNKNOWN_REMOTE_Q_MGR,
+      :dest_q_name =>'ORIGINAL_QUEUE_NAME',
+      :dest_q_mgr_name =>'BAD_Q_MGR'}
+    ]
+
+    message.descriptor[:format] = WMQ::MQFMT_STRING
+
+    queue.put(:message=>message)
+  end
+end
+

data/examples/put_dynamic_q.rb

@@ -0,0 +1,22 @@
+#
+# Sample : put() : Put a single message to a queue
+#          Create the queue if it does not already exist
+#
+#   Note : The queue name is that of the model queue
+#          The dynamic_q_name is the actual queue name
+#
+#   This sample is more usefull if the model queue was a Permanent Dynamic one.
+#   That way the queue would remain after termination of this code.
+#   In this sample the queue will disappear when this program terminates
+#
+require 'rubygems'
+require 'wmq'
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.open_queue(:q_name => 'SYSTEM.DEFAULT.MODEL.QUEUE',
+                  :dynamic_q_name => 'TEST.QUEUE.SAMPLE',
+                  :mode  => :output
+                  ) do |queue|
+    queue.put(:data => 'Hello World')
+  end
+end

data/examples/put_group_a.rb

@@ -0,0 +1,35 @@
+#
+# Sample : put() : Put multiple Messages to a queue under the same group Id
+#          Open the queue so that multiple puts can be performed
+#          Ensure that all messages have the same group id
+#          Allow MQ to create the unique group id and let it automatically
+#          assign message sequence numbers for each message in the group
+#
+require 'rubygems'
+require 'wmq'
+
+# Put 5 messages in a single group onto the queue
+total = 5
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
+    message = WMQ::Message.new
+    total.times do |count|
+      message.data = "Hello:#{count}"
+
+      # Set the message flag to indicate message is in a group
+      # On the last message, set the last message flag
+      message.descriptor[:msg_flags] = (count < total-1) ? WMQ::MQMF_MSG_IN_GROUP : WMQ::MQMF_LAST_MSG_IN_GROUP
+
+      # new_id => true causes subsequent messages to have unique message and
+      # correlation id's. Otherwise all messages will have the same message and
+      # correlation id's since the same message object is being
+      # re-used for all put calls.
+      #
+      # By setting the put :options => WMQ::MQPMO_LOGICAL_ORDER then MQ will supply a unique Group Id
+      # and MQ will automatically set the message sequence number for us.
+      queue.put(:message => message, :new_id => true, :options => WMQ::MQPMO_LOGICAL_ORDER)
+      p message.descriptor
+    end
+  end
+end

data/examples/put_group_b.rb

@@ -0,0 +1,37 @@
+#
+# Sample : put() : Put multiple Messages to a queue under the same group Id
+#          Open the queue so that multiple puts can be performed
+#          Ensure that all messages have the same group id
+#          Supply our own user-defined group Id.
+#          We also have to supply the message sequence number which starts at 1
+#
+require 'rubygems'
+require 'wmq'
+
+# Put 5 messages in a single group onto the queue
+total = 5
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
+    message = WMQ::Message.new
+    # Supply a unique Group Id, truncated to the MQ maximum for Group Id.
+    message.descriptor[:group_id] = 'MyUniqueGroupId'
+    total.times do |count|
+      #   new_id => true causes subsequent messages to have unique message and
+      #   correlation id's. Otherwise all messages will have the same message and
+      #   correlation id's since the same message object is being
+      #   re-used for all put calls
+      message.data = "Hello:#{count}"
+
+      # Set the message flag to indicate message is in a group
+      # On the last message, set the last message flag
+      message.descriptor[:msg_flags] = (count < total-1) ? WMQ::MQMF_MSG_IN_GROUP : WMQ::MQMF_LAST_MSG_IN_GROUP
+      message.descriptor[:msg_seq_number] = count + 1
+
+      # By setting the put :options => WMQ::MQPMO_LOGICAL_ORDER then MQ will supply a unique Group Id
+      # and MQ will automatically set the message sequence number for us.
+      queue.put(:message => message, :new_id => true)
+      p message.descriptor
+    end
+  end
+end

data/examples/put_rfh.rb

@@ -0,0 +1,51 @@
+#
+# Sample : put() : Put a message to a queue with a Refernce header
+#          Open the queue so that multiple puts can be performed
+#
+require 'rubygems'
+require 'wmq'
+
+# The Rules Format header (MQRFH) allows a list of name value pairs to be sent along
+# with a WMQ message. These name value pairs are represented as follows on the "wire":
+#   Name1 Value1 Name2 Value2 Name3 Value3
+#
+# Ruby WMQ converts the above string of data into a Ruby hash by
+# using the name as the key, as follows:
+# data = {
+#    'Name1' => 'Value1',
+#    'Name2' => 'Value2',
+#    'Name3' => 'Value3'
+# }
+#
+# Since a name can consist of any character except null, it is stored as a String
+#
+# Note: It is possible to send or receive the same Name with multiple values using an array.
+#   E.g.   Name1 Value1 Name2 Value2 Name1 Value3
+#   Becomes:
+# data = {
+#    'Name1' => ['Value1', 'Value3'],
+#    'Name2' => 'Value2'
+# }
+#
+# Note: Since a Hash does not preserve order, reading a Rules Format Header and then writing
+#       it out immediately again could result in re-ordering of the name value pairs.
+#
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
+    message = WMQ::Message.new
+    message.data = 'Hello World'
+
+    message.headers = [
+     {:header_type =>:rf_header,
+      :name_value => {'name1' => 'value1',
+                      'name2' => 'value2',
+                      'name3' => ['value 3a', 'value 3b']}
+     }]
+
+    message.descriptor[:format] = WMQ::MQFMT_STRING
+
+    queue.put(:message=>message)
+  end
+end
+

data/examples/put_rfh2_a.rb

@@ -0,0 +1,27 @@
+#
+# Sample : put() : Put a message to a queue with a Refernce header
+#          Open the queue so that multiple puts can be performed
+#
+require 'rubygems'
+require 'wmq'
+
+# The Rules Format header2 (MQRFH2) allows a an XML-like string to be passed as a header
+# to the data.
+#
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
+    message = WMQ::Message.new
+    message.data = 'Hello World'
+
+    message.headers = [
+     {:header_type =>:rf_header_2,
+      :xml => '<hello>to the world</hello>'
+     }]
+
+    message.descriptor[:format] = WMQ::MQFMT_STRING
+
+    queue.put(:message=>message)
+  end
+end
+

data/examples/put_rfh2_b.rb

@@ -0,0 +1,27 @@
+#
+# Sample : put() : Put a message to a queue with a Refernce header
+#          Open the queue so that multiple puts can be performed
+#
+require 'rubygems'
+require 'wmq'
+
+# The Rules Format header2 (MQRFH2) allows a an XML-like string to be passed as a header
+# to the data.
+#
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
+    message = WMQ::Message.new
+    message.data = 'Hello World'
+
+    message.headers = [
+     {:header_type =>:rf_header_2,
+      :xml => ['<hello>to the world</hello>', '<another>xml like string</another>'],
+     }]
+
+    message.descriptor[:format] = WMQ::MQFMT_STRING
+
+    queue.put(:message=>message)
+  end
+end
+

data/examples/put_xmit_q.rb

@@ -0,0 +1,17 @@
+#
+# Sample : put() : Put a message to a queue with a Transmission header
+#
+require 'rubygems'
+require 'wmq'
+
+WMQ::QueueManager.connect(:q_mgr_name=>'REID') do |qmgr|
+  qmgr.open_queue(:q_name=>'TEST.QUEUE', :mode=>:output) do |queue|
+    message = WMQ::Message.new
+    message.data = "Test message from 'LOCALQMS1'"
+    message.descriptor = {:original_length=>-1, :priority=>0, :put_time=>"18510170", :msg_id=>"AMQ LOCALQMS1   E\233\001\237 \000\003\005", :expiry=>-1, :persistence=>0, :reply_to_q=>"MQMON", :correl_id=>"AMQ LOCALQMS1   E\233\001\237 \000\003\004", :feedback=>0, :offset=>0, :report=>0, :msg_flags=>0, :reply_to_q_mgr=>"LOCALQMS1", :appl_identity_data=>"", :put_appl_name=>"LOCALQMS1", :user_identifier=>"mqm", :msg_seq_number=>1, :appl_origin_data=>"", :accounting_token=>"\026\001\005\025\000\000\000\271U\305\002\261\022\362\321\021D\3206\357\003\000\000\000\000\000\000\000\000\000\000\v", :backout_count=>0, :coded_char_set_id=>437, :put_appl_type=>7, :msg_type=>8, :group_id=>"", :put_date=>"20070109", :format=>"MQSTR", :encoding=>546}
+    message.headers = [{:priority=>0, :remote_q_mgr_name=>"OTHER.QMGR", :put_time=>"18510170", :msg_id=>"AMQ LOCALQMS1   E\233\001\237 \000\003\004", :expiry=>-1, :persistence=>0, :remote_q_name=>"OTHER.Q", :header_type=>:xmit_q_header, :reply_to_q=>"MQMON", :correl_id=>"", :feedback=>0, :report=>0, :reply_to_q_mgr=>"LOCALQMS1", :appl_identity_data=>"", :put_appl_name=>"uments\\MQ\\MQMon\\mqmonntp.exe", :user_identifier=>"mqm", :appl_origin_data=>"", :accounting_token=>"\026\001\005\025\000\000\000\271U\305\002\261\022\362\321\021D\3206\357\003\000\000\000\000\000\000\000\000\000\000\v", :backout_count=>0, :coded_char_set_id=>437, :put_appl_type=>11, :msg_type=>8, :put_date=>"20070109", :encoding=>546}]
+
+    queue.put(:message=>message)
+  end
+end
+

data/examples/q_to_files.cfg

@@ -0,0 +1,17 @@
+dev:
+  qmgr_options:
+    :q_mgr_name: REID
+  input_queue:
+    :mode: :browse
+    :q_name: TEST.QUEUE
+  target_directory: messages
+
+test:
+  qmgr_options:
+    :q_mgr_name: TEST.QMGR
+    :channel_name: SYSTEM.DEF.SVRCONN
+    :connection_name: remotehost(1414)
+  input_queue:
+    :mode: :browse
+    :q_name: TEST.QUEUE
+  target_directory: messages

data/examples/q_to_files.rb

@@ -0,0 +1,32 @@
+#
+# Example: q_to_files:  Copy all messages in a queue to separate files in a directory
+#
+require 'rubygems'
+require 'find'
+require 'yaml'
+require 'wmq'
+require 'fileutils'
+
+# Call program passing environment name as first parameter
+#   The environment corresponds to an entry in the config file
+env = ARGV[0] || raise("Command line argument 'environment' is required")
+config = YAML::load_file('q_to_files.cfg')[env]
+
+# Create supplied path if it does not exist
+path = config['target_directory']
+FileUtils.mkdir_p(path)
+
+message = WMQ::Message.new
+message.descriptor = config['descriptor'] || {}
+tstart = Time.now
+counter = 0
+WMQ::QueueManager.connect(config['qmgr_options']) do |qmgr|
+  qmgr.open_queue(config['input_queue']) do |queue|
+    queue.each do |message|
+      counter = counter + 1
+      File.open(File.join(path, "message_%03d" % counter), 'w') {|file| file.write(message.data) }
+    end
+  end
+end
+duration = Time.now - tstart
+printf "Processed #{counter} messages in %.3f seconds. Average: %.3f messages/second\n", duration, counter/duration