应用程序连接属性

应用程序连接的属性显示在“应用程序连接”属性对话框中。您不能编辑这些属性中的任何属性的值。

以下各表列出了应用程序连接的所有属性:

对于每个属性,都有一个简短描述来说明它所表示的含义。此表给出了 DISPLAY CONN 命令的等效 MQSC 参数。有关 MQSC 命令的更多信息,请参阅 IBM® MQ 联机产品文档中的脚本 (MQSC) 命令

“常规”页面

下表列出了“应用程序连接属性”对话框的常规页面上的属性。

属性 含义 MQSC 参数
应用程序名称 一个字符串,它包含连接至队列管理器的应用程序的标记。它可以是下列其中一项:z/OS® 批处理作业名称、TSO USERID、CICS® APPLID、IMS™ 区域名称、通道启动程序作业名称、OS/400® 作业名称、UNIX 进程或 Windows 进程。此应用程序名称表示已连接至队列管理器的进程的名称或作业的名称。如果通过通道连接此进程或作业,那么此应用程序名称表示远程进程名或作业名,而不是本地通道进程名或作业名。 APPLTAG
应用程序类型 一个字符串,它指示连接至队列管理器的应用程序的类型。批处理表示使用批处理连接的应用程序;RRSBATCH 表示使用批处理连接并由 RRS 协调的应用程序;CICS 表示 CICS 事务;IMS 表示 IMS 事务;CHINIT 表示通道启动程序;系统表示队列管理器;用户表示用户应用程序。 APPLTYPE
进程标识 打开此队列的进程的标识。该属性在 HP Integrity NonStop Serverz/OS 上无效。 PID
线程标识 已打开此队列的应用程序进程中线程的标识。星号表示此队列已使用共享连接打开。该属性在 HP Integrity NonStop Serverz/OS 上无效。 TID
用户标识 与句柄关联的用户标识。 USERID
选项 这些是此应用程序连接当前使用的连接选项。 CONNOPTS
通道名称 拥有句柄的通道的名称。如果没有与此句柄关联的通道,那么此值为空。仅当句柄属于通道启动程序时才显示此值。 CHANNEL
连接名称 与拥有句柄的通道关联的连接名称。如果没有与此句柄关联的通道,那么此值为空。仅当句柄属于通道启动程序时才显示此值。 CONNAME
PSB 名称 这是与正在运行的 IMS 事务相关联的程序规范块 (PSB) 的 8 字符名称。 PSBNAME
连接标识 这是允许 IBM MQ 可靠识别应用程序的 24 字节唯一连接标识。当应用程序首次连接至队列管理器时,队列管理器会设置此连接标识。 CONN 和 EXTCONN

“工作单元”页面

下表列出了“应用程序连接属性”对话框的工作单元页面上的属性。工作单元页面显示与所选连接关联的工作单元的信息。

属性 含义 MQSC 参数
工作单元类型 队列管理器可以看到的恢复单元类型。它是下列项之一:CICS(仅限z/OS)、XARRS(仅限z/OS)、IMS(仅限z/OS)或队列管理器 URTYPE
工作单元启动日期 这是启动与连接关联的事务的日期。 UOWSTDA
工作单元启动时间 这是启动与连接关联的事务的时间。 UOWSTTI
起源工作单元标识 由发起方指定的恢复单元标识。它是一个 8 字节值。 NID
起源名称 此属性标识线程的发起方,但在应用程序类型属性设置为 RRSBATCH 的情况下例外,这时将忽略此属性。 NID
日志扩展数据块名称 这是与连接关联的事务首次写入的日志扩展数据块的文件名。 UOWLOG
首次日志访问日期 这是与连接关联的事务首次写入日志的日期。 UOWLOGDA
首次日志访问时间 这是与连接关联的事务首次写入日志的时间。 UOWLOGTI
工作单元状态 工作单元的状态。表示没有工作单元;活动表示工作单元处于活动状态;已准备表示工作单元正处于落实过程;未解析表示工作单元正处于两阶段落实操作的第二个阶段,IBM MQ 代表它挂起了资源,需要外部干预来对它进行解析。处理这个问题可能很简单,通过启动恢复协调程序(例如,CICSIMS 或 RRS)就可解决,或者,它可能涉及更复杂的操作,例如,要使用 RESOLVE INDOUBT 命令。未解析值只会在 z/OS 上出现。 UOWSTATE
队列管理器工作单元标识 队列管理器指定的恢复单元。在 z/OS 上,这是一个 8 字节日志 RBA,而在其他平台上,这是一个 8 字节事务标识,显示为 16 个十六进制字符。 QMURID
外部工作单元标识 与连接关联的外部恢复单元标识。它是在外部同步点协调程序中已知的恢复标识。其格式由工作单元类型属性的值确定。 EXTURID
异步状态 此对象句柄上异步使用者的状态。一共有五个可能的值:

活动:MQCB 调用已设置回调函数以通过异步方式处理消息,并且连接句柄已启动,因此异步消息使用可以继续。

不活动:MQCB 调用已设置回调函数以通过异步方式处理消息,但连接句柄尚未启动或者已停止或暂挂,因此异步消息使用当前无法继续。

已暂挂:异步使用回调已暂挂,因此异步消息使用当前无法在此对象句柄上继续。 这可能是因为应用程序已经对此对象句柄发出带有 MQOP_SUSPEND 操作的 MQCB 调用,或者是因为该调用已经被系统暂挂。如果系统已暂挂该调用,那么在暂挂异步消息使用的过程中,将调用该回调函数,并且返回原因码,说明导致暂挂的问题。这样会在传递到回调函数的 MQCBC 结构的 Reason 字段中进行报告。为了使异步消息使用继续,应用程序必须发出操作参数已设置为 MQOP_RESUME 的 MQCB 调用。

临时暂挂:系统已临时暂挂异步使用回调,因此异步消息使用当前无法在此对象句柄上继续。 在暂挂异步消息使用的过程中,将调用该回调函数,并且返回原因码,说明导致暂挂的问题。这样会在传递到回调函数的 MQCBC 结构的 Reason 字段中进行报告。当临时情况解决后,系统恢复异步消息使用时,将再次调用该回调函数。

:尚未对此句柄发出 MQCB 调用,因此未在此句柄上配置异步消息使用。这是缺省值。

ASTATE
恢复单元处置 (仅限 z/OS )此参数用于过滤已返回的连接列表。有 3 个选项可供选择:
  • 所有意味着返回所有连接。这是缺省值。
  • 意味着已返回的连接将仅包含该命令所针对的组中的连接。
  • 队列管理器意味着已返回的连接将仅包含该命令所针对的队列管理器上的连接。
URDISP

“句柄”页面

下表列出了“应用程序连接属性”对话框的句柄页面上的属性。句柄页面显示所选应用程序已打开的对象的信息。

属性 含义 MQSC 参数
连接标识 这是允许 IBM MQ 可靠识别应用程序的 24 字节唯一连接标识。当应用程序首次连接至队列管理器时,队列管理器会设置此连接标识。 CONN 和 EXTCONN
对象名 这是连接已打开的对象的名称。 OBJNAME
对象类型 这是连接已打开的对象的类型,例如,队列通道存储类 OBJTYPE
打开选项

这些是连接用于打开对象的选项。

绑定为队列定义表示应用程序使用队列定义的缺省值打开队列以获取消息;共享输入表示应用程序通过共享访问打开队列以获取消息;独占输入表示应用程序通过独占访问打开队列以获取消息;浏览表示应用程序打开队列以浏览队列上的消息;输出表示应用程序打开队列以将消息放置到队列;查询表示应用程序打开对象以获取对象属性的列表;设置表示应用程序打开队列以设置此队列的属性。

打开时绑定表示在打开队列时,本地队列管理器将队列句柄绑定至目标队列的特定实例,以便使用此句柄放置的所有消息都通过相同路由发送至目标队列的同一实例;绑定不固定表示本地队列管理器不将队列句柄绑定至目标队列的特定实例,因此,使用此句柄的后续 MQPUT 调用可能导致消息发送至目标队列的不同实例,或发送至同一实例,但路由不同;作为队列缺省值绑定表示本地队列管理器以队列的“缺省绑定类型”属性所定义的方式来绑定队列句柄。

保存所有上下文表示使用此句柄检索的来自任何消息的上下文信息都与此句柄关联;传递标识上下文表示当处理的消息放置到队列时,来自一个消息的标识上下文信息可传递至此被处理的消息;传递所有上下文表示当处理的消息放置到队列时,来自一个消息的标识上下文信息和原始上下文信息可传递至此被处理的消息;设置标识上下文表示当消息放置到队列时,应用程序可设置与此消息关联的标识上下文信息;设置所有上下文表示当消息放置到队列时,应用程序可设置与此消息关联的标识上下文信息和原始上下文信息。有关消息上下文的更多信息,请参阅 IBM MQ 联机产品文档中的 消息上下文

备用用户权限表示根据 MQOPEN 调用中指定的用户标识验证此调用;如果停顿则失败表示如果队列管理器处于停顿状态,那么 MQOPEN 调用会失败。

OPENOPTS
QSG 处置 只读。对象的队列共享组处置。队列管理器表示对象定义仅可用于托管它的队列管理器;意味着对象定义存储在共享库中,并且队列共享组中的每个队列管理器都有一个此定义的副本;副本意味着对象定义是队列管理器的在共享库中的定义的副本;共享意味着对象定义存储在队列共享组的耦合设施中,并且可用于队列共享组中的所有队列管理器。 QSGDISP
句柄状态 句柄的当前状态。活动表示当前正在对此对象执行来自此连接的 API 调用。如果对象是队列,那么当执行 MQGET WAIT 调用时,可能出现此情况。如果存在未完成的 MQGET 信号,那么单凭此属性并不能表示句柄是活动的。不活动表示当前未在对此对象执行来自此连接的任何 API 调用。如果对象是队列,那么当未执行任何 MQGET WAIT 调用时,可能出现此情况。 HSTATE
主题字符串 已解析的主题字符串。此参数与具有 OBJTYPE(TOPIC) 的句柄相关。对于任何其他对象类型,此参数为空。 TOPICSTR
预订名称 与句柄相关联的应用程序的唯一预订名称。此参数仅与预订主题的句柄相关。并非所有预订都将具有预订名称。 SUBNAME
预订标识 预订的内部全天候唯一标识。此参数仅与预订主题的句柄相关。并非所有预订均出现在 DISPLAY CONN 中;仅具有向预订开放的当前句柄的预订才会出现。您可以使用 DISPLAY SUB 命令来查看所有预订。 SUBID
目标队列管理器 发布至此预订的消息的目标队列管理器。此参数仅与预订主题的句柄相关。如果 DEST 是在本地队列管理器上主管的队列,那么此参数将包含该本地队列管理器名称。如果 DEST 是在本地队列管理器上主管的队列,那么此参数将包含该远程队列管理器的名称。 DESTQMGR
目标名称 发布至此预订的消息的目标队列。此参数仅与预订主题的句柄相关。 DEST
异步状态 此对象句柄上异步使用者的状态。一共有五个可能的值:

活动:MQCB 调用已设置回调函数以通过异步方式处理消息,并且连接句柄已启动,因此异步消息使用可以继续。

不活动:MQCB 调用已设置回调函数以通过异步方式处理消息,但连接句柄尚未启动或者已停止或暂挂,因此异步消息使用当前无法继续。

已暂挂:异步使用回调已暂挂,因此异步消息使用当前无法在此对象句柄上继续。 这可能是因为应用程序已经对此对象句柄发出带有 MQOP_SUSPEND 操作的 MQCB 调用,或者是因为该调用已经被系统暂挂。如果系统已暂挂该调用,那么在暂挂异步消息使用的过程中,将调用该回调函数,并且返回原因码,说明导致暂挂的问题。这样会在传递到回调函数的 MQCBC 结构的 Reason 字段中进行报告。为了使异步消息使用继续,应用程序必须发出操作参数已设置为 MQOP_RESUME 的 MQCB 调用。

临时暂挂:系统已临时暂挂异步使用回调,因此异步消息使用当前无法在此对象句柄上继续。在暂挂异步消息使用的过程中,将调用该回调函数,并且返回原因码,说明导致暂挂的问题。这样会在传递到回调函数的 MQCBC 结构的 Reason 字段中进行报告。当临时情况解决后,系统恢复异步消息使用时,将再次调用该回调函数。

:尚未对此句柄发出 MQCB 调用,因此未在此句柄上配置异步消息使用。这是缺省值。

ASTATE
预读 预读连接状态。一共有四个可能的值:

:不为此对象启用非持久消息预读。这是缺省值。

:为此对象启用非持久消息预读,并且高效率地使用。

储备:为此对象启用非持久消息预读。由于向客户机发送大量未使用的消息,所以预读未被高效率地使用。

已禁止:应用程序已请求预读,但由于第一个 MQGET 调用上指定的选项不兼容,所以预读被禁止。
READA

参考 参考

反馈

时间戳记图标 最近一次更新时间: Wednesday, 14 February 2018
http://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm.mq.explorer.doc/com.ibm.mq.explorer.doc/e_properties_appconn.htm