5.1.11 MQSeries Built-In Functions

The MQSeries Built-In Functions allow messages to be read from a message queue and transferred across to the loaded service for processing. Also, XML responses can be transferred from the loaded service and put into a message queue.

Note: The LANSA Shipped MQSeries Built-In Functions use IBM's Dynamic linkage (compatibility mode) mode of operation, provided by the programs in library QMQM (QMQM, MQCLOSE, MQCONN, MQDISC, MQGET, MQINQ, MQOPEN, MQPUT, MQPUT1, MQSET).

All Built-in functions return at least a status and message. The status is a string value or an MQ API reason code prefixed with the string MQR.

• OK
• ERROR
• FATAL
• MQR2002 - Already connected
• MQR2033 - No messages
• MQR2058 - Queue manager name not valid or not known
• MQR2086 - Unknown Queue Manager
• MQR2079 - Truncated message accepted
• MQR2080 - Truncated message failed

     and so on..

The connection and queue handle parameters are 4 byte binary values and cannot be sent across to the loaded service, so the fields that hold these values must be named with the JSM prefix to exclude them from the service field list data transfer.

The Built-In Functions are:

MQ_CONN Opens a connection to a queue manager and returns a connection handle. MQ_DISC Closes the connection to the queue manager. MQ_BEGIN Begins a unit of work that is coordinated by the queue manager. MQ_CMIT Indicates to the queue manager that the application has reached a syncpoint, and that all the message gets and puts that have occurred since the last syncpoint are to be made permanent.   MQ_BACK Indicates to the queue manager that all message gets and puts that have occurred since the last syncpoint are to be backed out. MQ_OPEN Opens a message queue and returns a queue handle. MQ_CLOSE Closes the queue specified by the handle. MQ_GET Gets a message from the queue and passes it to the loaded service. MQ_PUT Gets a message response from the loaded service and puts it into the queue. MQ_DEPTH Returns the number of messages in the queue.