IBM MQ APL functions are used to send data to an IBM WebSphere MQ queue.
MQConnect
This function will open a connection to a queue and queue manager.
MQQueue
...
mqConnect(MQQueueManagerInfo
...
info,
...
string
...
queueName)
Parameters
Parameter | Description |
|---|---|
| The information needed to connect to the queue |
...
manager MQQueueManagerInfo UDR. For further information about |
...
the MQQueueManagerInfo UDR type see MQQueueManagerInfo in IBM MQ UDRs. | |
| The name of the queue |
Returns | Returns |
...
an MQQueue UDR. For further information about |
...
the MQQueue UDR type see MQQueue in IBM MQ UDRs. |
| Note |
|---|
...
Note!If there is no available queue status for some reason, |
...
the MaxDepth and CurrentDepth fields will be assigned the value "-1" and the |
MQPut
This function will put a message on a queue.
If the function fails, it will populate the ErrorDescription field with a description and set isError to true. If the error was generated from an MQ exception it will also update the MqError field in the MQQueue UDRthe MQQueue UDR.
string
...
mqPut(MQQueue
...
queue,
...
MQMessage
...
message)
Parameters
Parameter | Description |
|---|---|
|
...
The MQQueue UDR that is the result from the |
...
the MQQueue UDR type see MQQueue in IBM MQ UDRs | |
| The message to add to the queue. For further information about |
...
the MQMessage UDR type see MQMessage in IBM MQ UDRs. | |
Returns | Returns null if the function was successful and an error message if it failed. |
MQClose
This function closes the connection to the queue manager.
If the function fails, it will populate the ErrorDescription field with a description and set isError to true. If the error was generated from an MQ exception it will also update the MqError field in the MQQueue UDRthe MQQueue UDR.
string
...
mqClose(MQQueue
...
queue)
Parameters
Parameter | Description |
|---|---|
|
...
The MQQueue UDR that is the result from the |
...
the MQQueue UDR type see MQQueue in IBM MQ UDRs. | |
Returns | Returns null if the function was successful and an error message if it failed. |
MQStatus
This function will query the queue for MaxDepth and CurrentDepth and populate the corresponding fields in the MQQueue UDRthe MQQueue UDR.
If the function fails, it will populate the ErrorDescription field with a description and set isError to true. If the error was generated from an MQ exception it will also update the MqError field in the MQQueue UDRthe MQQueue UDR.
string
...
mqStatus(MQQueue
...
queue)
Parameters
Parameter | Description |
|---|---|
|
...
The MQQueue UDR that is the result from the |
...
the MQQueue UDR type see MQQueue in IBM MQ UDRs. | |
Returns | Returns an error message describing the problem, or null if the function was successful. |