ConnectionFactory 属性
下面概括了 ConnectionFactory 对象属性,并提供了指向更详细参考信息的链接。
| 属性的名称 | 描述 |
|---|---|
| XMSC_ASYNC_EXCEPTIONS | 此属性确定仅在连接中断时还是在 XMS API 调用出现异步异常时,XMS 通知 ExceptionListener。 此属性适用于通过该 ConnectionFactory 创建的且已注册 ExceptionListener 的所有连接。 |
| XMSC_CLIENT_ID | 连接的客户机标识。 |
| XMSC_CONNECTION_TYPE | 与应用程序相连的消息传递服务器的类型。 |
| XMSC_PASSWORD | 可用于在应用程序尝试连接到消息传递服务器时对其进行认证的密码。 |
| XMSC_RTT_BROKER_PING_INTERVAL | XMS .NET 检查与实时消息传递服务器的连接以检测任何活动前的时间间隔(以毫秒计)。 |
| XMSC_RTT_CONNECTION_PROTOCOL | 与代理程序的实时连接所使用的通信协议。 |
| XMSC_RTT_HOST_NAME | 运行代理程序的系统的主机名或 IP 地址。 |
| XMSC_RTT_LOCAL_ADDRESS | 与代理程序的实时连接所使用的本地网络接口的主机名或 IP 地址。 |
| XMSC_RTT_MULTICAST | 连接工厂或目标的多点广播设置。 |
| XMSC_RTT_PORT | 代理程序侦听入局请求所使用的端口号。 |
| XMSC_USERID | 可用于在应用程序尝试连接到消息传递服务器时对其进行认证的用户标识。 |
| XMSC_WMQ_BROKER_CONTROLQ | 代理程序使用的控制队列的名称。 注: 此属性可以与 IBM® Message Service Client for .NET V 2.0 配合使用,但对于连接到 IBM WebSphere® MQ 7.0 队列管理器的应用程序不起作用,除非连接工厂的 XMSC_WMQ_PROVIDER_VERSION 属性设置为小于 7 的版本号。
|
| XMSC_WMQ_BROKER_PUBQ | 受代理程序监控且应用程序将其发布的消息发送到的队列的名称。 注: 此属性可以与 IBM Message Service Client for .NET V 2.0 配合使用,但对于连接到 IBM WebSphere MQ 7.0 队列管理器的应用程序不起作用,除非连接工厂的 XMSC_WMQ_PROVIDER_VERSION 属性设置为小于 7 的版本号。
|
| XMSC_WMQ_BROKER_QMGR | 代理程序连接到的队列管理器的名称。 注: 此属性可以与 IBM Message Service Client for .NET V 2.0 配合使用,但对于连接到 IBM WebSphere MQ 7.0 队列管理器的应用程序不起作用,除非连接工厂的 XMSC_WMQ_PROVIDER_VERSION 属性设置为小于 7 的版本号。
|
| XMSC_WMQ_BROKER_SUBQ | 非持久消息使用者的订户队列的名称。 注: 此属性可以与 IBM Message Service Client for .NET V 2.0 配合使用,但对于连接到 IBM WebSphere MQ 7.0 队列管理器的应用程序不起作用,除非连接工厂的 XMSC_WMQ_PROVIDER_VERSION 属性设置为小于 7 的版本号。
|
| XMSC_WMQ_BROKER_VERSION | 应用程序针对连接或目标使用的代理程序类型。 注: 此属性可以与 IBM Message Service Client for .NET V 2.0 配合使用,但对于连接到 IBM WebSphere MQ 7.0 队列管理器的应用程序不起作用,除非连接工厂的 XMSC_WMQ_PROVIDER_VERSION 属性设置为小于 7 的版本号。
|
| XMSC_WMQ_CCDTURL | 统一资源定位符 (URL),用于标识包含客户机通道定义表的文件的名称和位置并指定该文件的访问方式。 |
| XMSC_WMQ_CHANNEL | 连接要使用的通道的名称。 |
| XMSC_WMQ_CLIENT_RECONNECT_OPTIONS | 此属性可为该工厂所创建的新连接指定客户机重新连接选项。 |
| XMSC_WMQ_CLIENT_RECONNECT_TIMEOUT | 此属性可指定客户机连接尝试重新连接的持续时间(以秒计)。 |
| XMSC_WMQ_CONNECTION_MODE | 应用程序连接到队列管理器所使用的方式。 |
| XMSC_WMQ_CONNECTION_NAME_LIST | 此属性可指定客户机在中断连接后尝试重新连接的主机。 |
| XMSC_WMQ_FAIL_IF_QUIESCE | 当应用程序连接到的队列管理器处于停顿状态时,某些方法调用是否会失败。 |
| XMSC_WMQ_HOST_NAME | 运行队列管理器的系统的主机名或 IP 地址。 |
| XMSC_WMQ_LOCAL_ADDRESS | 对于到队列管理器的连接,该属性指定要使用的本地网络接口和/或要使用的本地端口/本地端口范围。 |
| XMSC_WMQ_MESSAGE_SELECTION | 确定消息选择是由 XMS 客户机完成还是由代理完成。 注: 此属性可以与 IBM Message Service Client for .NET V 2.0 配合使用,但对于连接到 IBM WebSphere MQ 7.0 队列管理器的应用程序不起作用,除非连接工厂的 XMSC_WMQ_PROVIDER_VERSION 属性设置为小于 7 的版本号。
|
| XMSC_WMQ_MSG_BATCH_SIZE | 在使用异步消息传递时要成批从队列中检索的最大消息数。 注: 此属性可以与 IBM Message Service Client for .NET V 2.0 配合使用,但对于连接到 IBM WebSphere MQ 7.0 队列管理器的应用程序不起作用,除非连接工厂的 XMSC_WMQ_PROVIDER_VERSION 属性设置为小于 7 的版本号。
|
| XMSC_WMQ_POLLING_INTERVAL | 如果会话中的每个消息侦听器在其队列中都没有合适的消息,那么此值是每个消息侦听器再次尝试从其队列中获取消息前经过的最大时间间隔(以毫秒计)。 注: 此属性可以与 IBM Message Service Client for .NET V 2.0 配合使用,但对于连接到 IBM WebSphere MQ 7.0 队列管理器的应用程序不起作用,除非连接工厂的 XMSC_WMQ_PROVIDER_VERSION 属性设置为小于 7 的版本号。
|
| XMSC_WMQ_PROVIDER_VERSION | 应用程序要连接到的队列管理器的版本、发行版、修订版级别和修订包。 |
| XMSC_WMQ_PORT | 队列管理器侦听入局请求的端口号。 |
| XMSC_WMQ_PUB_ACK_INTERVAL | 发布者在 XMS 客户机请求代理程序应答之前发布的消息数。 注: 此属性可以与 IBM Message Service Client for .NET V 2.0 配合使用,但对于连接到 IBM WebSphere MQ 7.0 队列管理器的应用程序不起作用,除非连接工厂的 XMSC_WMQ_PROVIDER_VERSION 属性设置为小于 7 的版本号。
|
| XMSC_WMQ_PUT_ASYNC_ALLOWED | 此属性确定是否允许消息生产者使用异步放置来将消息发送到此目标。 |
| XMSC_WMQ_QMGR_CCSID | 编码字符集或代码页的标识 (CCSID) ,其中在消息队列接口 (MQI) 中定义的字符数据字段在 XMS 客户机与 IBM MQ 客户机之间交换。 |
| XMSC_WMQ_QUEUE_MANAGER | 要连接到的队列管理器的名称。 |
| XMSC_WMQ_RECEIVE_EXIT | 标识要运行的通道接收出口。 |
| XMSC_WMQ_RECEIVE_EXIT_INIT | 调用通道接收出口时传递到通道接收出口的用户数据。 |
| XMSC_WMQ_SECURITY_EXIT | 标识通道安全出口。 |
| XMSC_WMQ_SECURITY_EXIT_INIT | 调用通道安全出口时传递到通道安全出口的用户数据。 |
| XMSC_WMQ_SEND_CHECK_COUNT | 单个非事务性 XMS 会话内两次检查异步放置错误之间允许的 Send 调用次数。 |
| XMSC_WMQ_SEND_EXIT | 标识通道发送出口。 |
| XMSC_WMQ_SEND_EXIT_INIT | 调用通道发送出口时传递到通道发送出口的用户数据。 |
| XMSC_WMQ_SHARE_CONV_ALLOWED | 如果通道定义匹配,那么客户机连接是否可以与从同一进程到同一队列管理器的其他顶级 XMS 连接共享其套接字。 根据应用程序开发、维护或运行方面的需要,使用此属性可在不同套接字中完全隔离连接。 |
| XMSC_WMQ_SSL_CERT_STORES | 用于保存与队列管理器的 SSL 连接上使用的证书撤销列表 (CRL) 的服务器的位置。 |
| XMSC_WMQ_SSL_CIPHER_SPEC | 到队列管理器的安全连接上要使用的 CipherSpec 名称。 |
| XMSC_WMQ_SSL_CIPHER_SUITE | 到队列管理器的 TLS 连接上要使用的 CipherSuite 名称。 协商安全连接时使用的协议取决于指定的 CipherSuite。 |
| XMSC_WMQ_SSL_CRYPTO_HW | 下面是连接到客户机系统的加密硬件的配置详细信息。 |
| XMSC_WMQ_SSL_FIPS_REQUIRED | 该属性的值将决定应用程序能否使用符合非 FIPS 标准的密码套件。 如果将该属性设置为 true,那么客户机/服务器连接只能使用 FIPS 算法。 |
| XMSC_WMQ_SSL_KEY_REPOSITORY | 用于存储密钥和证书的密钥数据库文件的位置。 |
| XMSC_WMQ_SSL_KEY_RESETCOUNT | KeyResetCount 表示在重新协商密钥之前在 SSL 对话期间发送和接收的未加密字节总数。 |
| XMSC_WMQ_SSL_PEER_NAME | 到队列管理器的 SSL 连接上要使用的对等方名称。 |
| XMSC_WMQ_SYNCPOINT_ALL_GETS | 是否必须从同步点控制范围内的队列中检索所有消息。 |
| XMSC_WMQ_TARGET_CLIENT | |
| XMSC_WMQ_TEMP_Q_PREFIX | 用于构成在应用程序创建 XMS 临时队列时创建的 IBM MQ 动态队列的名称的前缀。 |
| XMSC_WMQ_TEMP_TOPIC_PREFIX | 创建临时主题时, XMS 将生成格式为 "TEMP/TEMPTOPICPREFIX/unique_id" 的主题字符串,或者如果此属性包含缺省值,那么将生成此字符串 "TEMP/unique_id"。 通过指定非空值,可以定义特定的模型队列,以便为在该连接下创建的临时主题的订户创建受管队列。 |
| XMSC_WMQ_TEMPORARY_MODEL | 应用程序创建 XMS 临时队列时从中创建动态队列的 IBM MQ 模型队列的名称。 |
| XMSC_WPM_BUS_NAME | 对于连接工厂,这是应用程序连接到的服务集成总线的名称;对于目标,这是存在目标的服务集成总线的名称。 |
| XMSC_WPM_CONNECTION_PROXIMITY | 连接的连接距离设置。 |
| XMSC_WPM_DUR_SUB_HOME | 用于管理连接或目标的所有持久预订的消息传递引擎的名称。 |
| XMSC_WPM_LOCAL_ADDRESS | 对于到服务集成总线的连接,该属性指定要使用的本地网络接口和/或要使用的本地端口/本地端口范围。 |
| XMSC_WPM_NON_PERSISTENT_MAP | 通过连接发送的非持久消息的可靠性级别。 |
| XMSC_WPM_PERSISTENT_MAP | 通过连接发送的持久消息的可靠性级别。 |
| XMSC_WPM_PROVIDER_ENDPOINTS | 由引导程序服务器的一个或多个端点地址组成的序列。 |
| XMSC_WPM_TARGET_GROUP | 消息传递引擎的目标组名称。 |
| XMSC_WPM_TARGET_SIGNIFICANCE | 消息传递引擎的目标组的重要性。 |
| XMSC_WPM_TARGET_TRANSPORT_CHAIN | 应用程序连接到消息传递引擎时必须使用的入站传输链的名称。 |
| XMSC_WPM_TARGET_TYPE | 消息传递引擎的目标组类型。 |
| XMSC_WPM_TEMP_Q_PREFIX | 用于构成应用程序创建 XMS 临时队列时在服务集成总线中创建的临时队列的名称的前缀。 |
| XMSC_WPM_TEMP_TOPIC_PREFIX | 用于构成应用程序创建的临时主题名称的前缀。 |