[z/OS]

z/OS 上的发布/预订样本

"发布/预订" 样本程序演示了 IBM® MQ中发布和预订功能的使用。

有四个 C 语言和两个 COBOL 编程语言示例程序，演示如何为 IBM MQ 发布/订阅接口编程。 这些程序以 C 和 COBOL 语言形式交付。 应用程序在批处理环境中运行; 请参阅批处理应用程序的 发布/预订样本 。

还有在 CICS® 环境中运行的 COBOL 示例；请参阅 z/OS 上的 CICS 异步消费和发布/订阅示例。

本主题还提供有关如何运行 Publish/Subscribe 样本程序的信息。 这些样本程序包括：

运行 CSQ4BCP1 样本

此程序采用 C 进行编写，它向主题发布消息。 在运行此程序之前，请启动订户样本之一。

此程序最多采用四个参数：
  1. 目标主题字符串的名称（必需）。
  2. 队列管理器名称（可选）。
  3. 打开选项（可选）。
  4. 关闭选项（可选）。

如果未指定队列管理器，那么 CSQ4BCP1 连接到缺省队列管理器。 存在用于运行程序的样本 JCL，它驻留在 CSQ4BCPP 中。

通过标准输入 (SYSIN DD) 提供消息内容。

运行 CSQ4BCP2 样本

此程序采用 C 进行编写，它预订主题并打印收到的消息。

此程序最多采用三个参数：
  1. 目标主题字符串的名称（必需）。
  2. 队列管理器名称（可选）。
  3. MQSD 预订选项（可选）。

如果未指定队列管理器，那么 CSQ4BCP2 连接到缺省队列管理器。 存在用于运行程序的样本 JCL，它驻留在 CSQ4BCPS 中。

运行 CSQ4BCP3 样本

此程序采用 C 进行编写，它使用用户指定的目标队列预订主题并打印收到的消息。

此程序最多采用四个参数：
  1. 目标主题字符串的名称（必需）。
  2. 目标的名称（必需）。
  3. 队列管理器名称（可选）。
  4. MQSD 预订选项（可选）。

如果未指定队列管理器，那么 CSQ4BCP3 连接到缺省队列管理器。 存在用于运行程序的样本 JCL，它驻留在 CSQ4BCPD 中。

运行 CSQ4BCP4 样本

此程序采用 C 进行编写，它通过允许在 MQSUB 调用中使用扩展选项并扩展更简单的 MQSUB 样本 CSQ4BCP2 上可用的选项，从主题预订和获取消息。 除消息有效内容以外，还会接收并显示各消息的消息属性。

此程序采用参数的变量集：
  • -t Topic string.
  • -o Topic object name.
    重要信息: 需要 -t 和/或 -o中的一个
  • -m Queue manager name （可选）。
  • -b Connection binding type (可选) ，其中 type 可以具有以下任何值:
    • standard :MQCNO_STANDARD_BINDING ，这是缺省值
    • shared:MQCNO_SHARED_BINDING  
    • fastpath:MQCNO_FASTPATH_BINDING
    • 已隔离:MQCNO_SOLATED_BINDING    
  • -q Destination queue name （可选）。
  • -w Wait interval on MQGET in seconds (可选) ，其中 seconds 可以具有以下任何值:
    • unlimited：MQWI_UNLIMITED
    • none：无等待
    • n：等待时间间隔（以秒为单位）
    • 未指定值：在未指定值时，缺省值为 30 秒
  • -d Subscription name （可选）。 创建或恢复指定的持久预订。
  • -k （可选）。 在 MQCLOSE 上保留持久预订。

如果未指定队列管理器，那么 CSQ4BCP4 连接到缺省队列管理器。 存在用于运行程序的样本 JCL，它驻留在 CSQ4BCPE 中。

运行 CSQ4BVP1 样本

此程序采用 COBOL 进行编写，它向主题发布消息。 在运行此程序之前，请启动订户样本之一。

此程序不采用任何参数。 SYSIN DD 提供输入主题名称、队列管理器名称和消息内容。

如果未指定队列管理器，那么 CSQ4BVP1 连接到缺省队列管理器。 存在用于运行程序的样本 JCL，它驻留在 CSQ4BVPP 中。

运行 CSQ4BVP2 样本

此程序采用 COBOL 进行编写，它预订主题并打印收到的消息。

此程序不采用任何参数。 SYSIN DD 为主题名称和队列管理器名称提供输入。

如果未指定队列管理器，那么 CSQ4BVP1 连接到缺省队列管理器。 存在用于运行程序的样本 JCL，它驻留在 CSQ4BVPP 中。