MQDLTMH-删除消息句柄

语法

MQDLTMH（Hconn、Hmsg、DltMsgHOpts、CompCode、Reason）

参数

Hconn

类型 :MQHCONN-输入

此句柄表示与队列管理器的连接。

该值必须与用于创建 Hmsg 参数中指定的消息句柄的连接句柄相匹配。

如果消息句柄是使用 MQHC_UNASSOCIATED_HCONN 创建的，那么必须在删除消息句柄的线程上建立有效连接，否则调用将失败并导致 MQRC_CONNECTION_BROKEN。

赫消息

类型 :MQHMSG-输入/输出

这是要删除的消息句柄。 该值由先前的 MQCRTMH 调用返回。

成功完成调用时，句柄将设置为环境的无效值。 此值为:

MQHM_UNUSABLE_HMSG

不可用的消息句柄。

如果传递了同一消息句柄的另一个 IBM® MQ 调用正在进行中，那么无法删除该消息句柄。

DltMsgHOpts

类型 :MQDMHO-输入

请参阅 MQDMHO 以获取详细信息。

CompCode

类型：MQLONG - 输出

完成代码；此完成代码为以下其中一项：

MQCC_OK

成功完成。

MQCC_FAILED

调用失败。

原因

类型：MQLONG - 输出

如果 CompCode 为 MQCC_OK:

MQRC_NONE

(0, X'000') 没有要报告的原因。

如果 CompCode 为 MQCC_FAILED:

MQRC_ADAPTER_NOT_AVAILABLE

(2204，X'089C'）适配器不可用。

MQRC_ADAPTER_SERV_LOAD_ERROR

(2130, X'852') 无法装入适配器服务模块。

MQRC_ASID_MISMATCH

(2157, X'86D') 主 ASID (Primary ASID) 与主 ASID (home ASID) 不同。

MQRC_CALL_IN_PROGRESS

(2219，X'08AB'） MQI 呼叫在前一个呼叫完成前进入。

MQRC_CONNECTION_BROKEN

(2009，X'07D9'）与队列管理器的连接丢失。

MQRC_DMHO_ERROR

(2462,X'099E') 删除报文句柄选项结构无效。

MQRC_HMSG_ERROR

(2460,X'099C') 信息句柄指针无效。

MQRC_MSG_HANDLE_IN_USE

(2499,X'09C3') 消息句柄已在使用中。

MQRC_OPTIONS_ERROR

(2046,X'07FE') 选项无效或不一致。

MQRC_STORAGE_NOT_AVAILABLE

(2071, X'817') 没有足够的存储空间可用。

MQRC_UNEXPECTED_ERROR

(2195, X'893') 发生了意外错误。

有关这些代码的详细信息，请参阅 消息和原因码。

C 调用

MQDLTMH (Hconn, &Hmsg, &DltMsgHOpts, &CompCode, &Reason);

MQHCONN  Hconn;       /* Connection handle */
MQHMSG   Hmsg;        /* Message handle */
MQDMHO   DltMsgHOpts; /* Options that control the action of MQDLTMH */
MQLONG   CompCode;    /* Completion code */
MQLONG   Reason;      /* Reason code qualifying CompCode */

COBOL 调用

CALL 'MQDLTMH' USING HCONN, HMSG, DLTMSGHOPTS, COMPCODE, REASON.

**  Connection handle
01   HCONN   PIC S9(9) BINARY.

**  Options that control the action of MQDLTMH
01   DLTMSGHOPTS.
COPY CMQDMHOL.

**  Completion code
01  COMPCODE   PIC S9(9) BINARY.

** Reason code qualifying COMPCODE
01   REASON      PIC S9(9) BINARY.

PL/I 调用

call MQDLTMH (Hconn, Hmsg, DltMsgHOpts, CompCode, Reason);

dcl Hconn          /* Connection handle */
dcl Hmsg           /* Message handle */
dcl DltMsgHOpts like MQDMHO;    /* Options that control the action of MQDLTMH */
dcl CompCode       /* Completion code */
dcl Reason         /* Reason code qualifying CompCode */

高级汇编程序调用

CALL MQDLTMH,(HCONN,HMSG,DLTMSGHOPTS,COMPCODE,REASON)

HCONN          DS        F  Connection handle
HMSG           DS        D  Message handle
DLTMSGHOPTS    CMQDMHOA  ,  Options that control the action of MQDLTMH
COMPCODE       DS        F  Completion code
REASON         DS        F  Reason code qualifying COMPCODE