ConnectionFactory 属性

下面概括了 ConnectionFactory 对象属性,并提供了指向更详细参考信息的链接。

表 1. 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 用于构成应用程序创建的临时主题名称的前缀。