MQCLOSE命令　−　オブジェクトのクローズ

C言語の場合

MQCLOSE(MQHCONN Hconn, PMQHOBJ Hobj, MQLONG Options,
        PMQLONG CompCode, PMQLONG Reason)

COBOL言語の場合

CALL 'MQCLOSE' USING HCONN, HOBJ, OPTIONS, COMPCODE, REASON.

●　Hconn（MQHCONN型）　−input

コネクションハンドルです。

キューマネジャへの接続を示すハンドルです。MQCONN命令の戻り値を指定してください。

●　Hobj（MQHOBJ型）　−input/output

オブジェクトハンドルです。

クローズするオブジェクトを示すハンドルです。どんなオブジェクトタイプでもかまいません。MQOPEN命令の戻り値を指定してください。

命令が成功すると，この引数には次の値が返されます。

MQHO_UNUSABLE_HOBJ

使用できないオブジェクトハンドル

●　Options（MQLONG型）　−input

MQCLOSE命令の動作を制御するクローズオプションです。

オブジェクトのクローズの方法を示します。永続的動的キューの場合だけ，キューを残す方法または削除する方法のどちらかでクローズできます。なお，永続的動的キューは，DefinitionType属性がMQQDT_PERMANENT_DYNAMICのキューです。クローズオプションについては，表2-1に示します。

次のどれかの値を取れます。

MQCO_NONE

特別なクローズオプションを要求しません。

次の場合に指定します。

• キュー以外のオブジェクト

• 定義済みキュー

• 一時的動的キュー（ただし，Hobjのハンドルが，そのキューを生成したMQOPEN関数で返されたハンドルと異なる場合だけ指定できます）

• 配布リスト

上記の場合，オブジェクトは削除されないで残されます。

このオプションを一時的動的キューに指定した場合で，Hobjのハンドルがそのキューを生成したMQOPEN命令で返されたハンドルのとき，キューは削除されます。そのほかのハンドルのときは，キューは残ります。

このオプションを永続的動的キューに指定した場合，キューは削除されないで残ります。

MQCO_DELETE

キューを削除します。

次のどちらかの場合，キューは削除されます。

• 永続的動的キューで，メッセージを格納しないで，かつコミットしていないトランザクションからの登録・取り出しがない場合

  ほかのアプリケーションによる登録・取り出しがない場合も含みます。

• 一時的動的キューで，Hobjのハンドルがそのキューを生成したMQOPEN命令で返されたハンドルの場合

上記以外の場合，理由コードMQRC_OPTION_NOT_VALID_FOR_TYPEで命令は失敗します。このとき，キューは削除されません。

MQCO_DELETE_PURGE

キューを強制的に削除します。

次のどちらかの場合，キューは削除されます。

• 永続的動的キューで，コミットしていないトランザクションからの登録・取り出しがない場合

  ほかのアプリケーションによる登録・取り出しがない場合も含みます。

• 一時的動的キューで，Hobjのハンドルがそのキューを生成したMQOPEN命令で返されたハンドルの場合

上記以外の場合，理由コードMQRC_OPTION_NOT_VALID_FOR_TYPEで命令は失敗します。この場合，キューは削除されません。

クローズオプションとオブジェクトの関係を次の表に示します。

表2‒1　クローズオプションとオブジェクトの関係

オブジェクト	クローズオプション
	MQCO_NONE	MQCO_DELETE	MQCO_DELETE_PURGE
キュー以外	1	2	2
定義済みキュー	1	2	2
永続的動的キュー	1	3	4
一時的動的キュー （作成者）	5	5	5
一時的動的キュー （作成者以外）	1	2	2
配布リスト	1	2	2

●　CompCode（MQLONG型）　−output

完了コードです。

次のどれかが返されます。

• MQCC_OK：成功

• MQCC_WARNING：警告（一部成功）

• MQCC_FAILED：失敗

●　Reason（MQLONG型）　−output

理由コードです。

CompCode引数がMQCC_OKの場合

理由コード	数値	意味
MQRC_NONE	0	理由コードはありません。

CompCode引数がMQCC_WARNINGの場合

理由コード	数値	意味
MQRC_INCOMPLETE_GROUP	2241	メッセージグループが完全ではありません。
MQRC_INCOMPLETE_MSG	2242	論理メッセージが完全ではありません。

CompCode引数がMQCC_FAILEDの場合

理由コード	数値	意味
MQRC_HCONN_ERROR	2018	コネクションハンドルが不正です。
MQRC_HOBJ_ERROR	2019	オブジェクトハンドルが不正です。
MQRC_OBJECT_DAMAGED	2101	オブジェクトが破損しています。
MQRC_OPTION_NOT_VALID_FOR_TYPE	2045	オブジェクトタイプに適合しないオプションが指定されました。
MQRC_OPTIONS_ERROR	2046	オプションが不正です。または，指定されていません。
MQRC_Q_NOT_EMPTY	2055	キューに一つ以上のメッセージがあります。または，キューに対する登録・取り出し要求がコミットしていません。
MQRC_RESOURCE_PROBLEM	2102	システム資源が不足しています。
MQRC_STORAGE_NOT_AVAILABLE	2071	記憶容量が不足しています。
MQRC_UNEXPECTED_ERROR	2195	予期しないエラーが発生しました。

詳細は，「付録B.2　理由コード」を参照してください。