MQSTS-状态报告结构

MQSTS 结构描述 MQSTAT 命令返回的状态结构中的数据。

概述

字符集和编码：MQSTS 中的字符数据使用本地队列管理器的字符集；这由CodedCharSetIdqueue-manager 属性给出。 MQSTS 中的数字数据采用本机机器编码; 这是由 ENNAT提供的。

用法:MQSTAT 命令用于检索状态信息。 此信息在 MQSTS 结构中返回。 有关 MQSTAT 的信息，请参阅 MQSTAT-检索状态信息。

字段

MQSTS 结构包含以下字段; 这些字段以 字母顺序描述:

STSCC (10 位有符号整数)

这是 MQSTS 结构中报告的第一个错误所生成的完成代码。

这始终是输出字段。 此字段的初始值为 CCOK。

STSFC (10 位带符号整数)

这是失败的异步放置调用数。

这是输出字段。 此字段的初始值为 0。

STSOBJN (48 字节字符串)

这是第一个故障中涉及的对象的局部名。

这是输出字段。 此字段的初始值为 48 个空白字符。

STSOQMGR (48 字节字符串)

这是定义了 STSOBJN 对象的队列管理器的名称。 名称完全为空白，直到第一个空字符或字段的末尾表示应用程序所连接的队列管理器 (本地队列管理器)。

这是输出字段。 此字段的初始值为 48 个空白字符。

STSOO (10 位带符号整数)

用于打开要报告的对象的 STSOO 。 仅在 MQSTS V 2 或更高版本中存在。

STSOO 的值取决于 MQSTAT STYPE 参数的值。
统计信息

零

STATREC

零

状态

发生故障时使用的 STSOO 。 在 MQSTS 结构的 STSCC 和 STSRC 字段中报告失败原因。

STSOO 是输出字段。 其初始值为零。

STSOS (MQCHARV)

要报告的失败对象的长对象名。 仅在 MQSTS V 2 或更高版本中存在。

STSOS 是最大长度为 10240 的 MQCHARV 字段。 有关如何使用 MQCHARV 结构的描述，请参阅 MQCHARV 。

STSOS 的解释取决于 MQSTAT STYPE 参数的值。

统计信息

这是 MQPUT 操作中使用的队列或主题的长对象名，此操作失败。

STATREC

零长度字符串

状态

这是导致重新连接失败的对象的长对象名。

STSOS 是输出字段。 其初始值为零长度字符串。

STSOT (10 位有符号整数)
在 ObjectName中命名的对象的类型。 可能的值为：
OTALSQ
别名队列。
OTLOCQ
本地队列。
OTMODQ
模型队列。
OTQ
队列。
OTREMQ
远程队列。
OTTOP
主题中查看此版本新增功能的摘要。

这始终是输出字段。 此字段的初始值为 OTQ。

STSRC (10 位数字带符号整数)

这是 MQSTS 结构中报告的第一个错误导致的原因码

这始终是输出字段。 此字段的初始值为 RCNONE。

STSROBJN (48 字节字符串)

这是在本地队列管理器解析名称后在 STSOBJN 中指定的目标队列的名称。 返回的名称是由 STSRQMGR标识的队列管理器上存在的队列的名称。

仅当对象是打开用于浏览，输入或输出 (或任何组合) 的单个队列时，才会返回非空白值。 如果打开的对象是下列任何一项，那么 STSROBJN 设置为空白:
  • 主题
  • 队列，但未打开以进行浏览，输入或输出

这是输出字段。 此字段的初始值为 48 个空白字符。

STSRQMGR (48 字节字符串)

这是本地队列管理器解析名称后的目标队列管理器的名称。 返回的名称是拥有由 STSROBJN标识的队列的队列管理器的名称。 STSRQMGR 可以是本地队列管理器的名称。

如果 STSROBJN 是本地队列管理器所属的队列共享组所拥有的共享队列，那么 STSRQMGR 是队列共享组的名称。 如果队列由其他某个队列共享组拥有，那么 STSROBJN 可以是队列共享组的名称，也可以是作为队列共享组成员的队列管理器的名称 (返回的值的性质由本地队列管理器中存在的队列定义确定)。

仅当对象是打开用于浏览，输入或输出 (或任何组合) 的单个队列时，才会返回非空白值。 如果打开的对象是下列任何一项，那么 STSRQMGR 设置为空白:
  • 主题
  • 队列，但未打开以进行浏览，输入或输出
  • 指定了 OOBNDN (或者当 DefBind 队列属性具有值 OOBNDN 时 OOBNDQ 生效) 的集群队列

这是输出字段。 此字段的初始值为 48 个空白字符。

STSSC (10 位有符号整数)

这是成功的异步放置调用数。

这是输出字段。 此字段的初始值为 0。

STSSID (4 字节字符串)
这是结构标识。 该值必须为:
STSSID
状态报告结构的标识。

此字段的初始值为 STSSID。

STSSO (10 位数字带符号整数)

用于打开失败预订的 STSSO 。 仅在 MQSTS V 2 或更高版本中存在。

STSSO 的解释取决于 MQSTAT STYPE 参数的值。
统计信息

零

STATREC

零

状态

发生故障时使用的 STSSO 。 在 MQSTS 结构的 STSCC 和 STSRC 字段中报告失败原因。 如果失败与预订主题无关，那么返回的值为零。

STSSO 是输出字段。 其初始值为零。

STSSUN (MQCHARV)

失败预订的名称。 仅在 MQSTS V 2 或更高版本中存在。

STSSUN 是 maxiumum 长度为 10240 的 MQCHARV 字段。 有关如何使用 MQCHARV 结构的描述，请参阅 MQCHARV 。

STSSUN 的解释取决于 MQSTAT STYPE 参数的值。
统计信息

零长度字符串。

STATREC

零长度字符串。

状态

导致重新连接失败的预订的名称。 如果没有可用的预订名称，或者故障与预订无关，那么这是长度为零的字符串。

STSSUN 是输出字段。 其初始值为零长度字符串。

STSVER (10 位有符号整数)
这是结构版本号。 该值必须为:
STSVR1
状态报告结构的版本号。
以下常量指定当前版本的版本号:
STSVRC
当前版本的状态报告结构。

此字段的初始值为 STSVR1。

STSWC (10 位有符号整数)

这是已完成但有警告的异步放置调用数。

这是输出字段。 此字段的初始值为 0。

初始值

表 1. MQSTS 中字段的初始值
字段名称 常量的名称 常量值
STSSID STSID  
STSVER STSVRC STSVR1
STSCC CCOK 0
STSRC RCNONE 0
STSSC None 0
STSWC None 0
STSFC None 0
STSOT None 0
STSOBJN None 空白
STSOQMGR None 空白
STSROBJN None 空白
STSRQMGR None 空白
STSOS 为 MQCHARV 定义的名称和值  
STSSUN 为 MQCHARV 定义的名称和值  
STSOO None 0
STSSO None 0

RPG 声明

         D*..1....:....2....:....3....:....4....:....5....:....6....:....7..
         D* MQSTS Structure
         D*
         D* Structure identifier
         D  STSSID                 1      4
         D* Structure version number
         D  STSVER                 5      8I 0
         D* Completion code
         D  STSCC                  9     12I 0
         D* Reason code
         D  STSRC                 13     16I 0
         D* Success count
         D  STSSC                 17     20I 0
         D* Warning count
         D  STSWC                 21     24I 0
         D* Failure count
         D  STSFC                 25     28I 0
         D* Object type
         D  STSOT                 29     32I 0
         D* Object name
         D  STSOBJN               33     80
         D* Object queue manager
         D  STSOQMGR              81     128
         D* Resolved object name
         D  STSROBJN             129     176
         D* Resolved object queue manager name
         D  STSRQMGR             177     224
         D* Ver:1 **
         D* Failing object long name
         D* Address of variable length string
         D  STSOSCHRP            225    240*  
         D* Offset of variable length string
         D  STSOSCHRO            241    244I 0
         D* Size of buffer
         D  STSOSVSBS            245    248I 0
         D* Length of variable length string
         D  STSOSCHRL            249    252I 0
         D* CCSID of variable length string
         D  STSOSCHRC            253    256I 0
         D* Failing subscription name
         D* Address of variable length string
         D  STSSUNCHRP           257    272*  
         D* Offset of variable length string
         D  STSSUNCHRO           273    276I 0
         D* Size of buffer
         D  STSSUNVSBS           277    280I 0
         D* Length of variable length string
         D  STSSUNCHRL           281    284I 0
         D* CCSID of variable length string
         D  STSSUNCHRC           285    288I 0
         D* Failing open options
         D  STSOO                289    292I 0
         D* Failing subscription options
         D  STSSO                293    296I 0
         D* Ver:2 **