MQAIR-认证信息记录

MQAIR 结构允许作为 IBM® MQ MQI client 运行的应用程序指定有关要用于客户机连接的认证程序的信息。该结构是 MQCONNX 调用上的输入参数。

可用性

MQAIR 结构可用于以下客户机:

AIX®
HP-UX
Linux®
Solaris
Windows

字符集和编码

MQAIR 中的数据必须采用本地队列管理器的字符集和编码; 这些数据由 CodedCharSetId 队列管理器属性和 MQENC_NATIVE 提供。

字段

注: 在下表中，字段按用法 (而不是按字母顺序) 进行分组。子主题遵循相同的顺序。

表 1. MQAIR 中的字段
字段名称和描述	常量的名称	常量的初始值 (如果有)
StrucId (结构标识)	MQAIR_STRUC_ID	`'AIR¬'`
版本 (结构版本号)	MQAIR_VERSION_1	`1`
AuthInfoType（验证信息类型）	MQAIT_CRL_LDAP	`1`
AuthInfoConnName（LDAP CRL 服务器的连接名称）	None	空字符串或空白
LDAPUserNamePtr（LDAP 用户名地址）	None	空指针或空字节
LDAPUserNameOffset（LDAP 用户名从 MQSCO 开始的偏移量）	None	`0`
LDAPUserNameLength（LDAP 用户名长度）	None	`0`
LDAPPassword (用于访问 LDAP 服务器的密码)	None	空字符串或空白
注: 如果 `V` 小于 MQAIR_VERSION_2，那么将忽略其余字段。
OCSPResponderURL （OCSP响应程序可被访问URL	None	空字符串或空白
备注信息：符号 `¬` 表示单个空白字符。在 C 编程语言中，宏变量 MQAIR_DEFAULT 包含表中列出的值。通过以下方式使用它来为结构中的字段提供初始值: `MQAIR MyAIR = {MQAIR_DEFAULT};`

语言声明

MQAIR 的 C 声明

typedef struct tagMQAIR MQAIR;
struct tagMQAIR {
  MQCHAR4    StrucId;             /* Structure identifier */
  MQLONG     Version;             /* Structure version number */
  MQLONG     AuthInfoType;        /* Type of authentication
                                     information */
  MQCHAR264  AuthInfoConnName;    /* Connection name of CRL LDAP
                                     server */
  PMQCHAR    LDAPUserNamePtr;     /* Address of LDAP user name */
  MQLONG     LDAPUserNameOffset;  /* Offset of LDAP user name from start
                                     of MQAIR structure */
  MQLONG     LDAPUserNameLength;  /* Length of LDAP user name */
  MQCHAR32   LDAPPassword;        /* Password to access LDAP server */
  MQCHAR256  OCSPResponderURL;    /* URL of OCSP responder */

};

MQAIR 的 COBOL 声明

**   MQAIR structure
  10 MQAIR.
**    Structure identifier
   15 MQAIR-STRUCID            PIC X(4).
**    Structure version number
   15 MQAIR-VERSION            PIC S9(9) BINARY.
**    Type of authentication information
   15 MQAIR-AUTHINFOTYPE       PIC S9(9) BINARY.
**    Connection name of CRL LDAP server
   15 MQAIR-AUTHINFOCONNNAME   PIC X(264).
**    Address of LDAP user name
   15 MQAIR-LDAPUSERNAMEPTR    POINTER.
**    Offset of LDAP user name from start of MQAIR structure
   15 MQAIR-LDAPUSERNAMEOFFSET PIC S9(9) BINARY.
**    Length of LDAP user name
   15 MQAIR-LDAPUSERNAMELENGTH PIC S9(9) BINARY.
**    Password to access LDAP server
   15 MQAIR-LDAPPASSWORD       PIC X(32).
**    URL of OCSP responder
   15 MQAIR-OCSPRESPONDERURL   PIC X(256).

MQAIR 的 Visual Basic 声明

Type MQAIR
  StrucId            As String*4   'Structure identifier'
  Version            As Long       'Structure version number'
  AuthInfoType       As Long       'Type of authentication information'
  AuthInfoConnName   As String*264 'Connection name of CRL LDAP server'
  LDAPUserNamePtr    As MQPTR      'Address of LDAP user name'
  LDAPUserNameOffset As Long       'Offset of LDAP user name from start'
                                   'of MQAIR structure'
  LDAPUserNameLength As Long       'Length of LDAP user name'
  LDAPPassword       As String*32  'Password to access LDAP server'
End Type