mqseries_put

(PECL mqseries >= 0.10.0)

mqseries_put — MQSeries MQPUT

説明

mqseries_put(
    resource $hConn,
    resource $hObj,
    array &$md,
    array &$pmo,
    string $message,
    resource &$compCode,
    resource &$reason
): void

The mqseries_put() (MQPUT) は、メッセージをキューあるいは配送リストにおきます。キューあるいは配送リストを事前にオープンしておく必要があります。

パラメータ

hConn: 接続ハンドル。このハンドルは、キューマネージャへの接続を表します。
hObj: オブジェクトハンドル。このハンドルは、使用するオブジェクトを表します。
md: メッセージ記述子 (MQMD)。
pmo: Put メッセージのオプション (MQPMO)。
message: 実際にキューに置くメッセージ。
compCode: 完了コード。
reason: compCode の原因を表すコード。

戻り値

値を返しません。

例

例1 mqseries_put() の例

<?php
// キューマネージャへの接続をオープンします
    mqseries_conn('WMQ1', $conn, $comp_code, $reason);
// これで、$conn がキューマネージャへの接続を指すようになります

// testq キューへの接続をオープンします
    mqseries_open(
                $conn,
                array('ObjectName' => 'TESTQ'),
                MQSERIES_MQOO_INPUT_AS_Q_DEF | MQSERIES_MQOO_FAIL_IF_QUIESCING | MQSERIES_MQOO_OUTPUT,
                $obj,
                $comp_code,
                $reason);
// これで、$obj はオブジェクト (TESTQ) を指すようになります

// メッセージ記述子の配列を設定します。MQSeries のリファレンスマニュアルを参照ください
    $md = array(
                'Version' => MQSERIES_MQMD_VERSION_1,
                'Expiry' => MQSERIES_MQEI_UNLIMITED,
                'Report' => MQSERIES_MQRO_NONE,
                'MsgType' => MQSERIES_MQMT_DATAGRAM,
                'Format' => MQSERIES_MQFMT_STRING,
                'Priority' => 1,
                'Persistence' => MQSERIES_MQPER_PERSISTENT);

// Put メッセージのオプションを設定します
    $pmo = array('Options' => MQSERIES_MQPMO_NEW_MSG_ID|MQSERIES_MQPMO_SYNCPOINT);

// 'Ping' というメッセージをキューに置きます
    mqseries_put($conn, $obj, $md, $pmo, 'Ping', $comp_code, $reason);

    if ($comp_code !== MQSERIES_MQCC_OK) {
        printf("put CompCode:%d Reason:%d Text:%s<br>\n", $comp_code, $reason, mqseries_strerror($reason));
    }

// オブジェクトへの参照 $obj を閉じます
    mqseries_close($conn, $obj, MQSERIES_MQCO_NONE, $comp_code, $reason);

// キューマネージャとの接続を切断します
    mqseries_disc($conn, $comp_code, $reason);

?>

参考

mqseries_conn() - MQSeries MQCONN
mqseries_connx() - MQSeries MQCONNX
mqseries_open() - MQSeries MQOPEN
mqseries_get() - MQSeries MQGET