mqseries_begin

(PECL mqseries >= 0.10.0)

mqseries_begin — MQseries MQBEGIN

説明

function mqseries_begin(
    resource $hconn,
    array $beginOptions,
    resource &$compCode,
    resource &$reason
): void

mqseries_begin() (MQBEGIN) をコールすると、作業ユニットを開始します。これはキューマネージャが扱うものですが、外部のリソースマネージャを使用することもあります。

mqseries_begin() は作業ユニットを開始します。作業ユニットを終了させるには mqseries_back() あるいは mqseries_cmit() を使用します。

パラメータ

hConn

接続ハンドル。

このハンドルは、キューマネージャへの接続を表します。

compCode

完了コード。

reason

compCode の原因を表すコード。

戻り値

値を返しません。

例

例1 mqseries_begin() の例

<?php
    $mqbo = array();
    mqseries_begin( $conn,
                    $mqbo,
                    $comp_code,
                    $reason);
    if ($comp_code !== MQSERIES_MQCC_OK) {
        /* コード 2121 は警告を表します。詳細は MQSeries のリファレンスマニュアルを参照ください */
        if ($reason !== 2121) {
            printf("CompCode:%d Reason:%d Text:%s<br>\n", $comp_code, $reason, mqseries_strerror($reason));
        }
    }
?>

注意

注意:
mqseries_begin() は、MQSeries Client を使用して Queueu Manager に接続した場合には動作しません。

参考

mqseries_conn() - MQSeries MQCONN
mqseries_connx() - MQSeries MQCONNX
mqseries_back() - MQSeries MQBACK
mqseries_cmit() - MQSeries MQCMIT

関連キーワード:

mqseries begin reason MQSeries MQseries back resource compCode 作業ユニットマネージャ接続コード comp code 開始キュー cmit ハンドル mqbo conn hconn beginOptions 外部リソース