This parameter controls how the object is closed. Only permanent dynamic queues can be closed in more than one way, being either retained or deleted; these are queues whose DefinitionType attribute has the value MQQDT_PERMANENT_DYNAMIC (see the DefinitionType attribute described in Attributes for queues). The close options are summarized in Table 74.
One (and only one) of the following must be specified:
This must be specified for:
In all the above cases, the object is retained and not deleted.
If this option is specified for a temporary dynamic queue:
If this option is specified for a permanent dynamic queue, the queue is retained and not deleted.
On z/OS, if the queue is a dynamic queue that has been logically deleted, and this is the last handle for it, the queue is physically deleted. See MQCLOSE usage notes for further details.
In all other cases the call fails with reason code MQRC_OPTION_NOT_VALID_FOR_TYPE, and the object is not deleted.
On z/OS, if the queue is a dynamic queue that has been logically deleted, and this is the last handle for it, the queue is physically deleted. See MQCLOSE usage notes for further details.
In all other cases the call fails with reason code MQRC_OPTION_NOT_VALID_FOR_TYPE, and the object is not deleted.
Type of object or queue | MQCO_NONE | MQCO_DELETE | MQCO_DELETE_PURGE |
---|---|---|---|
Object other than a queue | Retained | Not valid | Not valid |
Predefined queue | Retained | Not valid | Not valid |
Permanent dynamic queue | Retained | Deleted if empty and no pending updates | Messages deleted; queue deleted if no pending updates |
Temporary dynamic queue (call issued by creator of queue) | Deleted | Deleted | Deleted |
Temporary dynamic queue (call not issued by creator of queue) | Retained | Not valid | Not valid |
Distribution list | Retained | Not valid | Not valid |
Notices |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
js02439 |