[函数]mqseries_begin()函数—用法及示例

函数名：mqseries_begin()

适用版本：PHP 4 >= 4.0.5, PHP 5, PHP 7

函数描述：mqseries_begin() 函数用于启动与 IBM MQ 服务器之间的连接。

用法：

resource mqseries_begin ( resource $hconn , array &$beginopts , int &$compcode , int &$reason )

参数：

• $hconn：连接到 IBM MQ 服务器的资源句柄，通过 mqseries_connx() 函数获取。
• $beginopts：一个关联数组，用于指定与启动连接相关的选项。具体选项如下：
  • MQSERIES_MQOO_INPUT_AS_Q_DEF：使用默认的输入队列选项。
  • MQSERIES_MQOO_INPUT_SHARED：使用共享的输入队列选项。
  • MQSERIES_MQOO_INPUT_EXCLUSIVE：使用独占的输入队列选项。
  • MQSERIES_MQOO_OUTPUT：使用输出队列选项。
  • MQSERIES_MQOO_INQUIRE：使用查询选项。
  • MQSERIES_MQOO_SET：使用设置选项。
  • MQSERIES_MQOO_SAVE_ALL_CONTEXT：使用保存所有上下文选项。
  • MQSERIES_MQOO_PASS_IDENTITY_CONTEXT：使用传递身份上下文选项。
• $compcode：一个引用变量，用于接收操作完成的结果。如果操作成功，则值为 MQSERIES_MQCC_OK。
• $reason：一个引用变量，用于接收操作失败的原因代码。如果操作成功，则值为 MQSERIES_MQRC_NONE。

返回值：

• 如果连接成功，则返回一个与 IBM MQ 服务器之间的连接相关的资源句柄。
• 如果连接失败，则返回 FALSE。

示例：

$queueManager = "QMGR1";
$connOptions = array(
    MQSERIES_MQOO_INPUT_AS_Q_DEF,
    MQSERIES_MQOO_OUTPUT,
    MQSERIES_MQOO_INQUIRE
);

$conn = mqseries_connx($queueManager, $connOptions);
if ($conn === false) {
    echo "连接到队列管理器失败！";
    exit;
}

$beginOptions = array(
    MQSERIES_MQOO_INPUT_AS_Q_DEF,
    MQSERIES_MQOO_OUTPUT
);

$compCode = 0;
$reason = 0;
$queue = mqseries_begin($conn, $beginOptions, $compCode, $reason);

if ($compCode === MQSERIES_MQCC_OK) {
    echo "连接成功！";
} else {
    echo "连接失败，原因代码：" . $reason;
}

mqseries_close($conn);

以上示例中，我们首先通过 mqseries_connx() 函数连接到队列管理器，然后使用 mqseries_begin() 函数启动与服务器的连接。如果连接成功，$compCode 的值将为 MQSERIES_MQCC_OK，否则将输出连接失败的原因代码。最后，我们使用 mqseries_close() 函数关闭连接。