 |
|
|
|
||||
|
|||||
|
|
||||||
| Related Syntax | Other Library Functions | |||||
| function |
mq-close |
|
Library: Interfaces, MQSeries access (OMMQI)
Include: ommqi.xin |
define external function mq-close
object value mq-object object
options value integer options
Argument definitions
Use mq-close to close a connection to an IBM MQSeries object.
You must include the following line at the beginning of your OmniMark program:
include "ommqi.xin"
The object must be open (else external exception OMMQI0013).
This function corresponds to the MQCLOSE function in the MQSeries API.
The CompCode and Reason parameters of MQCLOSE are integrated into the OMMQI error handling.
This function is implicitly called when a mq-object variable goes out of scope.
Close an opened queue.
include "ommqi.xin"
process
local mq-connection a-connection
local mq-object a-object
local stream od-fields variable
local mq-object-descriptor a-mqod
; Connect to queue manager QM_desthost
set a-connection to mq-connect to "QM_desthost"
; Set up MQOD structure
set new od-fields {"ObjectName"} to "default"
mq-set-object-descriptor a-mqod to od-fields
; Open queue
set a-object to mq-open connection a-connection
object-descriptor a-mqod
options (MQOO_OUTPUT union MQOO_INPUT_AS_Q_DEF)
; Perform some operations on the queue
; ...
; Close the queue
mq-close object a-object options MQCO_NONE
