MQDLTMP-删除消息属性

MQDLTMP 调用从消息句柄中删除属性，并且是 MQSETMP 调用的反向调用。

语法

MQDLTMP （ Hconn、 Hmsg、 DltPropOpts、 名称、 CompCode、 原因 ）

参数

Hconn

类型 :MQHCONN-输入

此句柄表示与队列管理器的连接。该值必须与用于创建 Hmsg 参数中指定的消息句柄的连接句柄相匹配。

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

赫消息

类型 :MQHMSG-输入

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

DltPropOpts

类型 :MQDMPO-输入

有关详情，请参阅 MQDMPO 数据类型。

名称

类型 :MQCHARV-输入

要删除的属性的名称。请参阅属性名以获取有关属性名的更多信息。

属性名称中不允许使用通配符。

CompCode

类型：MQLONG - 输出

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

MQCC_OK: 成功完成。
MQCC_WARNING: 警告（部分完成）。
MQCC_FAILED: 调用失败。

原因

类型：MQLONG - 输出

如果 CompCode 为 MQCC_OK:

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

如果 CompCode 为 MQCC_WARNING:

mqrc_property_not_available: (2471，X'09A7'）属性不可用。
mqrc_rfh_format_error: (2421 ， X'0975 ') 无法解析包含属性的 MQRFH2 文件夹。

如果 CompCode 是 MQCC_FAILED:

MQRC_ADAPTER_NOT_AVAILABLE: (2204，X'089C'）适配器不可用。
MQRC_ADAPTER_SERV_LOAD_ERROR: (2130 ， X'0852 ') 无法装入适配器服务模块。
MQRC_ASID_MISMATCH: (2157，X'086D'）主 ASID 和主 ASID 不同。
MQRC_CALL_IN_PROGRESS: (2219，X'08AB'）MQI 呼叫在前一个呼叫完成前进入。
MQRC_CONNECTION_BROKEN: (2009, X'07D9') 与队列管理器的连接丢失。
mqrc_dmpo_error: (2481, X'09B1') 删除报文属性选项结构无效。
mqrc_hmsg_error: (2460, X'099C') 报文句柄无效。
mqrc_msg_handle_in_use: (2499, X'09C3') 消息句柄已在使用中。
mqrc_options_error: (2046，X'07FE'）选项无效或不一致。
mqrc_property_name_error: (2442, X'098A') 属性名称无效。
mqrc_source_ccsid_error: (2111, X'083F') 属性名编码字符集标识符无效。
MQRC_UNEXPECTED_ERROR: (2195 ， X'0893 ') 发生意外错误。

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

C 调用

MQDLTMP (Hconn, Hmsg, &DltPropOpts, &Name, &CompCode, &Reason)

按如下所示声明参数：

MQHCONN Hconn;       /* Connection handle */
MQHMSG  Hmsg;        /* Message handle */
MQDMPO  DltPropOpts; /* Options that control the action of MQDLTMP */
MQCHARV Name;        /* Property name */
MQLONG  CompCode;    /* Completion code */
MQLONG  Reason;      /* Reason code qualifying CompCode */

COBOL 调用

CALL 'MQDLTMP' USING HCONN, HMSG, DLTPROPOPTS, NAME, COMPCODE, REASON.

按如下所示声明参数：

**   Connection handle
 01  HCONN    PIC S9(9) BINARY.
**   Message handle
 01  HMSG		 PIC S9(18) BINARY.
**   Options that control the action of MQDLTMP
 01  DLTPROPOPTS.
     COPY CMQDMPOV.
**   Property name
 01  NAME.
     COPY CMQCHRVV.
**   Completion code
 01  COMPCODE PIC S9(9) BINARY.
**   Reason code qualifying COMPCODE
 01  REASON   PIC S9(9) BINARY.

PL/I 调用

call MQDLTMP (Hconn, Hmsg, DltPropOpts, Name, CompCode, Reason);

按如下所示声明参数：

dcl Hconn       fixed bin(31); /* Connection handle */
dcl Hmsg        fixed bin(63); /* Message handle */
dcl DltPropOpts like MQDMPO;   /* Options that control the action of MQDLTMP */
dcl Name        like MQCHARV;  /* Property name */
dcl CompCode    fixed bin(31); /* Completion code */
dcl Reason      fixed bin(31); /* Reason code qualifying CompCode */

高级汇编程序调用

CALL MQDLTMP,(HCONN,HMSG,DLTPROPOPTS,NAME,COMPCODE,REASON)

按如下所示声明参数：

HCONN        DS         F     Connection handle
HMSG         DS         D     Message handle
DLTPROPOPTS  CMQDMPOA   ,     Options that control the action of MQDLTMP
NAME         CMQCHRVA   ,     Property name
COMPCODE     DS         F     Completion code
REASON       DS         F     Reason code qualifying COMPCODE