mqseries_begin()
启动与 IBM MQ 服务器之间的连接
函数名：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() 函数关闭连接。