MQCTLO-控制回调选项结构

MQCTLO 结构用于指定与控制回调函数相关的选项。 该结构是 MQCTL 调用上的输入和输出参数。

可用性

MQCTLO 结构在以下平台上可用:
  • [AIX]AIX®
  • [HP-UX]HP-UX
  • [IBM i]IBM® i
  • [Linux]Linux®
  • [Solaris]Solaris
  • [Windows]Windows
  • [z/OS]z/OS®
以及用于连接到这些系统的 IBM MQ MQI clients 。

版本

MQCTLO 的当前版本为 MQCTLO_VERSION_1。

字符集和编码

MQCTLO 中的数据必须包含由 MQENC_NATIVE 提供的本地队列管理器的 CodedCharSetId 队列管理器属性和编码提供的字符集。 但是，如果应用程序作为 MQ MQI 客户机运行，那么该结构必须采用客户机的字符集和编码。

字段

注: 在下表中，字段按用法 (而不是按字母顺序) 进行分组。 子主题遵循相同的顺序。
表 1. MQCTLO 中的字段
字段名称和描述 常量的名称 常量的初始值 (如果有)
StrucID (结构标识) MQCTLO_STRUC_ID 'CTLO'
版本 (结构版本号) MQCTLO_VERSION_1 1
选项 (选项) MQCTLO_NONE Null
选项（保留） 保留字段  
ConnectionArea (要使用的回调函数的字段) None 空指针或空字节
备注信息：
  1. 在 C 编程语言中，宏变量 MQCTLO_DEFAULT 包含表中列出的值。 通过以下方式使用它来为结构中的字段提供初始值:
    MQCTLO MyCTLO = {MQCTLO_DEFAULT};

语言声明

MQCTLO 的 C 声明

typedef struct tagMQCTLO MQCTLO;
 struct tagMQCTLO {
  MQCHAR4   StrucId;        /* Structure identifier */
  MQLONG    Version;        /* Structure version number */
  MQLONG    Options;        /* Options that control the action of MQCTL */
  MQLONG    Reserved;       /* Reserved field */
  

MQPTR     ConnectionArea; /* Connection work area passed to the function */
 };

MQCTLO 的 COBOL 声明

** MQCTLO structure
 10  MQCTLO.
** Structure Identifier
 15  MQCTLO-STRUCID                      PIC X(4).
** Structure Version
 15  MQCTLO-VERSION                      PIC S9(9) BINARY.
 ** Options
 15  MQCTLO-OPTIONS                      PIC S9(9) BINARY.
** Reserved
 15  MQCTLO-RESERVED                     PIC S9(9) BINARY.
** ConnectionArea
 15  MQCTLO-CONNECTIONAREA               POINTER

MQCTLO 的 PL/I 声明

dcl
 1 MQCTLO based,
  3 StrucId             char(4),       /* Structure identifier */
  3 Version             fixed bin(31), /* Structure version */
  3 Options             fixed bin(31), /* Options */
  3 Reserved            fixed bin(31), 
  3 ConnectionArea      pointer;       /* Connection work area */