MQXCLWLN 的参数-浏览集群工作负载记录

MQXCLWLN 调用中参数的描述。

ExitParms ( MQWXP ) -输入/输出
出口参数块。

此结构包含与出口调用相关的信息。 出口设置此结构中的信息以指示如何管理工作负载。

CurrentRecord ( MQPTR ) -输入
当前记录的地址。

此结构包含与出口当前正在检查的记录的地址相关的信息。 该记录必须是下列其中一种类型:

  • 集群工作负载目标记录 ( MQWDR )
  • 集群工作负载队列记录 ( MQWQR )
  • 集群工作负载集群记录 ( MQWCR )
NextOffset ( MQLONG ) -输入
下一条记录的偏移量。

此结构包含与下一个记录或结构的偏移量相关的信息。 NextOffset 是当前记录中相应偏移量字段的值,必须是下列其中一个字段:

  • MQWDR中的ChannelDefOffset 字段
  • MQWDR中的ClusterRecOffset
  • MQWQR中的ClusterRecOffset
  • MQWCR中的ClusterRecOffset
NextRecord ( MQPTR ) -输出
下一个记录或结构的地址。

此结构包含与下一个记录或结构的地址相关的信息。 如果 CurrentRecordMQWDR的地址, NextOffsetChannelDefOffset值, NextRecord 是通道定义结构 (MQCD) 的地址。

如果没有下一个记录或结构,那么队列管理器会将 NextRecord 设置为空指针,并且调用会返回完成代码 MQCC_WARNING 和原因码 MQRC_NO_RECORD_AVAILABLE

CompCode ( MQLONG ) -输出
完成代码。
完成代码具有下列其中一个值:
MQCC_OK
成功完成。
MQCC_WARNING
警告(部分完成)。
MQCC_FAILED
调用失败。
原因 ( MQLONG ) -输出
原因码限定 CompCode
如果 CompCodeMQCC_OK:
MQRC_NONE
( 0, X'0000')
没有理由报告。
如果 CompCodeMQCC_WARNING:
MQRC_NO_RECORD_AVAILABLE
( 2359, X'0937')
没有可用的记录。 从集群工作负载出口发出了 MQXCLWLN 调用,以获取链中下一条记录的地址。 当前记录是链中的最后一条记录。 更正操作: 无。
如果 CompCodeMQCC_FAILED:
MQRC_CURRENT_RECORD_ERROR
( 2357, X'0935')
CurrentRecord 参数无效。 从集群工作负载出口发出了 MQXCLWLN 调用,以获取链中下一条记录的地址。 CurrentRecord 参数指定的地址不是有效记录的地址。
CurrentRecord 必须是目标记录, MQWDR,队列记录 ( MQWQR ) 或集群记录 ( MQWCR ) 的地址 驻留在集群高速缓存中。 更正操作: 确保集群工作负载出口传递驻留在集群高速缓存中的有效记录的地址。
MQRC_ENVIRONMENT_ERROR
( 2012, X'07DC')
调用在环境中无效。 发出了 MQXCLWLN 调用,但未从集群工作负载出口发出。
MQRC_NEXT_OFFSET_ERROR
( 2358, X'0936')
NextOffset 参数无效。 从集群工作负载出口发出了 MQXCLWLN 调用,以获取链中下一条记录的地址。 NextOffset 参数指定的偏移量无效。 NextOffset 必须是以 下字段之一的值:
  • MQWDR中的ChannelDefOffset 字段
  • MQWDR中的ClusterRecOffset
  • MQWQR中的ClusterRecOffset
  • MQWCR中的ClusterRecOffset
更正操作: 确保为 NextOffset 参数指定的值是先前列示的其中一个字段的值。
MQRC_NEXT_RECORD_ERROR
( 2361, X'0939')
NextRecord 参数无效。
MQRC_WXP_ERROR
( 2356, X'0934')
工作负载出口参数结构无效。 从集群工作负载出口发出了 MQXCLWLN 调用,以获取链中下一条记录的地址。 由于下列其中一个原因,工作负载出口参数结构 ExitParms 无效:
  • 参数指针无效。 并非总是能够检测到无效的参数指针; 如果未检测到,那么会发生不可预测的结果。
  • StrucId 字段不是 MQWXP_STRUC_ID
  • 版本 字段不是 MQWXP_VERSION_2
  • 上下文 字段不包含队列管理器传递到出口的值。
更正操作: 确保为 ExitParms 指定的参数是调用出口时传递到出口的 MQWXP 结构。