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