mqseries_connx()函数—用法及示例

函数名称：mqseries_connx()

函数描述：用于在WebSphere MQ队列管理器上建立与队列管理器的连接。

适用版本：PHP 5 >= 5.4.0, PECL mqseries >= 0.10.0

语法：mqseries_connx(string $qManagerName, array $connOptions, resource &$connHandle, resource &$compCode, resource &$reason)

参数：

• $qManagerName：队列管理器的名称，由一个最多48个字节的字符串表示。
• $connOptions：连接选项，是一个关联数组，用于指定连接的参数。可以包含以下键值对：
  • 'Version'：设置WebSphere MQ API的版本，默认值为MQSERIES_MQGMO_VERSION_2。
  • 'Options'：设置连接选项，默认值为MQSERIES_MQOO_INPUT_AS_Q_DEF | MQSERIES_MQOO_OUTPUT。
  • 'ConnOptions'：设置连接选项，默认值为MQSERIES_MQCDO_NONE。
• $connHandle：一个引用变量，用于接收连接句柄。
• $compCode：一个引用变量，用于接收操作完成的返回码。
• $reason：一个引用变量，用于接收返回码的详细信息。

返回值：无

示例：

<?php
$qManagerName = 'QMGR1';
$connOptions = array(
    'Version' => MQSERIES_MQGMO_VERSION_4,
    'Options' => MQSERIES_MQOO_INPUT_AS_Q_DEF | MQSERIES_MQOO_OUTPUT,
    'ConnOptions' => MQSERIES_MQCDO_NONE
);
$connHandle = null;
$compCode = null;
$reason = null;

mqseries_connx($qManagerName, $connOptions, $connHandle, $compCode, $reason);

if ($compCode === MQSERIES_MQCC_OK) {
    echo "成功建立与队列管理器的连接！\n";
    echo "连接句柄：$connHandle\n";
} else {
    echo "建立连接失败！错误码：$reason\n";
}
?>

以上示例演示了如何使用mqseries_connx()函数建立与队列管理器的连接。在这个示例中，我们指定了队列管理器的名称为'QMGR1'，连接选项的版本为MQSERIES_MQGMO_VERSION_4，连接选项为MQSERIES_MQOO_INPUT_AS_Q_DEF | MQSERIES_MQOO_OUTPUT，连接选项为MQSERIES_MQCDO_NONE。函数会返回一个连接句柄，如果连接成功建立，则打印成功消息，并输出连接句柄；如果连接失败，则打印错误消息，并输出错误码。