The Reference Message sample programs

 

The Reference Message samples allow a large object to be transferred from one node to another (usually on different systems) without the need for the object to be stored on WebSphere MQ queues at either the source or the destination nodes.

A set of sample programs is provided to demonstrate how Reference Messages can be put to a queue, received by message exits, and taken from a queue. The sample programs use Reference Messages to move files. If you want to move other objects such as databases, or if you want to perform security checks, define your own exit, based on our sample, amqsxrm. The following sections describe the Reference Message sample programs.

There version of the Reference Message exit sample program to use depends on the platform on which the channel is running. On all platforms, use amqsxrma at the sending end. Use amqsxrma at the receiving end if the receiver is running under any WebSphere MQ product except WebSphere MQ for iSeries; use amqsxrm4 if the receiver is running under WebSphere MQ for iSeries.

• Notes for i5/OS users
  

• Running the Reference Message samples
  

• Design of the Put Reference Message sample (amqsprma.c, AMQSPRM4)
  

• Design of the Reference Message Exit sample (amqsxrma.c, AMQSXRM4)
  

• Design of the Get Reference Message sample (amqsgrma.c, AMQSGRM4)
  

 

Parent topic:

Sample programs (all platforms except z/OS)

fg17330_