使用 MQOPEN 调用打开对象
使用此信息以了解如何使用 MQOPEN 调用打开对象。
作为 MQOPEN 调用的输入,必须提供:
- 连接句柄。 对于 z/OS®上的 CICS® 应用程序,可以指定常量 MQHC_DEF_HCONN (值为零) ,或者使用 MQCONN 或 MQCONNX 调用返回的连接句柄。 对于其他程序,始终使用 MQCONN 或 MQCONNX 调用返回的连接句柄。
- 要打开的使用对象描述符结构 (MQOD) 的对象的描述。
- 用于控制调用操作的一个或多个选项。
MQOPEN 的输出为:
- 表示您对此对象的访问权的对象句柄。 在任何后续 MQI 调用的输入中使用此对象句柄。
- 修改的对象描述符结构(如果要创建在平台上支持的动态队列)。
- 完成代码。
- 原因码。
对象句柄的作用域
对象句柄 (Hobj) 的作用域与连接句柄 (Hconn) 的作用域相同。
这在 MQCONN 或 MQCONNX 的范围以及与 MQCONNX 的共享(线程独立)连接中有所阐述。 但是,在一些环境中,存在其他注意事项:
- CICS
- 在 CICS 程序中,只能在执行 MQOPEN 调用的同一 CICS 任务中使用句柄。
- IMS 和 z/OS 批处理
- 在 IMS 和批处理环境中,可以在同一任务中使用句柄,但不能在任何子任务中使用句柄。
在 MQOPEN中提供了 MQOPEN 调用参数的描述。
以下部分描述了必须作为 MQOPEN 的输入提供的信息。
标识对象(MQOD 结构)
使用 MQOD 结构标识要打开的对象。 此结构是 MQOPEN 调用的输入参数。 (使用 MQOPEN 调用创建动态队列时,队列管理器会修改此结构。)
有关 MQOD 结构的完整详细信息,请参阅 MQOD。
有关在分发列表中使用 MQOD 结构的信息,请参阅分发列表下的使用 MQOD 结构。