应用程序连接属性

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

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

对于每个属性,都有一个简短描述来说明它所表示的含义。 此表给出了 DISPLAY CONN 命令的等效 MQSC 参数。 有关 MQSC 命令的更多信息,请参阅 IBM Documentation中的 使用 MQSC 命令管理 IBM® MQ

“常规”页面

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

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

“工作单元”页面

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

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

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

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

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

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

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

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

“句柄”页面

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

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

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

Bind as queue definition 表示应用程序已打开队列以使用队列定义的缺省值来获取消息;Input shared 表示应用程序已打开队列以使用共享访问权获取消息;Input exclusive 表示应用程序已打开队列以使用独占访问权获取消息;Browse 表示应用程序已打开队列以浏览队列上的消息; Output 表示应用程序已打开队列以在队列上放入消息;Inquire 表示应用程序已打开对象以获取对象的属性列表;Set 表示应用程序已打开队列以设置队列的属性。

Bind on open 表示在打开队列时,本地队列管理器将队列句柄绑定到目标读系列的特定实例,从而将使用此句柄的所有消息放入都按相同路由发送到目标队列的相同实例;Bind not fixed 表示本地队列管理器不会将队列句柄绑定到目标队列的特定实例,因此使用此句柄的连续 MQPUT 调用可能导致将消息发送到目标队列的不同实例,或者发送到相同实例但路由不同;Bind as queue default 表示本地队列管理器以队列的缺省绑定类型属性所定义的方式绑定队列句柄。

OPENOPTS
 

Save all context 表示使用此句柄检索的任何消息中的上下文信息与此句柄相关联;Pass identity context 表示在将消息放入队列时,可以将消息中的标识上下文信息传递到已处理的消息;Pass all context 表示在将消息放入队列时,可以将消息中的标识和源上下文信息传递到已处理的消息;Set identity context 表示在将消息放入队列时,应用程序可以设置与消息相关联的标识上下文信息;Set all context 表示在将消息放入队列时,应用程序可以设置与消息相关联的标识和源上下文信息。 有关消息上下文的更多信息,请参阅 IBM Documentation 中的 信息背景

Alternate user authority 表示已针对调用中指定的用户标识验证 MQOPEN 调用;Fail if quiescing 表示如果队列管理器处于停顿状态,那么 MQOPEN 调用将失败。

 
QSG 处置 只读。 对象的队列共享组处置。 Queue manager 表示对象定义仅可用于托管该对象定义的队列管理器;Group 表示对象定义存储在共享存储库中,并且队列共享组中的每个队列管理器都具有定义的副本;Copy 表示对象定义是共享存储库中定义的队列管理器副本;Shared 表示对象定义存储在队列共享组的耦合设施中,并且适用于队列共享组中的所有队列管理器。 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 调用。

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

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

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

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

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

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

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