NAME

MQSeries::Message::XML-Dumper -- OO Class for sending and receiving perl references as MQSeries message application data in XML format, using the XML::Dumper module

SYNOPSIS

use MQSeries::Message::XML-Dumper;
my $message = MQSeries::Message::XML-Dumper->new
  (
   Data 		=> 
   {
    some 		=> "big ugly",
    complicated 	=>
    {
     data 		=> [0..5],
     structure 	=> [6..10],
    },
   },
  );

DESCRIPTION

This is a simple subclass of MQSeries::Message which support the use of perl references as data structures in the message. These references have to be converted to a string of data which can be written to an MQSeries message as application data, and for this the XML::Dumper module is used.

METHODS

PutConvert, GetConvert

Neither of these methods are called by the users application, but are used internally by MQSeries::Queue::Put() and MQSeries::Queue::Get(), as well as MQSeries::QueueManager::Put1().

PutConvert() calls XML::Dumper::pl2xml to convert the perl reference (which can be arbitrarily deep) to a scalar buffer which is then passed to MQPUT() or MQPUT1().

GetConvert() calls XML::Dumper::xml2pl to convert the contents of a message retreived from a queue via MQGET() to a perl reference, which is then inserted into the Data structure of the message object.

SEE ALSO

MQSeries(3), MQSeries::QueueManager(3), MQSeries::Queue(3), MQSeries::Message(3), XML::Dumper(3)