MQDLTMP - メッセージ・プロパティーの削除

構文

MQDLTMP(Hconn、Hmsg、DltPropOpts、Name、CompCode、Reason)

パラメーター

Hconn

タイプ: MQHCONN - 入力

このハンドルは、キュー・マネージャーに対する接続を表します。 この値は、 Hmsg パラメーターで指定されたメッセージ・ハンドルの作成に使用された接続ハンドルと一致している必要があります。

MQHC_UNASSOCIATED_HCONN を使用してメッセージ・ハンドルが作成された場合は、メッセージ・ハンドルを削除するスレッド上で有効な接続を確立しなければなりません。確立しないと、呼び出しは MQRC_CONNECTION_BROKEN で失敗します。

Hmsg

タイプ: 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') 1 次 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') プロパティー名エンコード文字セット ID が無効である。

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