应用程序连接属性
应用程序连接的属性显示在“应用程序连接”属性对话框中。 您不能编辑这些属性中的任何属性的值。
以下各表列出了应用程序连接的所有属性:
对于每个属性,都有一个简短描述来说明它所表示的含义。 此表给出了 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);XA ;RRS (仅限 z/OS);IMS (仅限 z/OS);Queue manager 。 |
URTYPE |
工作单元启动日期 | 这是启动与连接关联的事务的日期。 | UOWSTDA |
工作单元启动时间 | 这是启动与连接关联的事务的时间。 | UOWSTTI |
起始工作单元标识 | 由发起方指定的恢复单元标识。 它是一个 8 字节值。 | NID |
起始名称 | 此属性标识线程的发起方,但在应用程序类型属性设置为 RRSBATCH 的情况下例外,这时将忽略此属性。 | NID |
记录扩展数据块名称 | 这是与连接关联的事务首次写入的日志扩展数据块的文件名。 | UOWLOG |
首次记录访问日期 | 这是与连接关联的事务首次写入日志的日期。 | UOWLOGDA |
首次记录访问时间 | 这是与连接关联的事务首次写入日志的时间。 | UOWLOGTI |
工作单元状态 | 工作单元的状态。 None 表示没有工作单元;Active 表示工作单元处于活动状态;Prepared 表示工作单元正在进行落实;Unresolved 表示工作单元处于两阶段落实操作的第二个阶段,IBM MQ 代表其持有资源并且需要外部干预以进行解决。 处理这个问题可能很简单,通过启动恢复协调程序(例如,CICS、IMS 或 RRS)就可解决,或者,它可能涉及更复杂的操作,例如,要使用 RESOLVE INDOUBT 命令。 Unresolved 值只能出现在 z/OS 上。 |
UOWSTATE |
队列管理器工作单元标识 | 队列管理器指定的恢复单元。 在 z/OS 上,这是一个 8 字节日志 RBA,而在其他平台上,这是一个 8 字节事务标识,显示为 16 个十六进制字符。 | QMURID |
外部工作单元标识 | 与连接关联的外部恢复单元标识。 它是在外部同步点协调程序中已知的恢复标识。 其格式由 UOW
type 属性的值确定。 |
EXTURID |
异步状态 | 此对象句柄上异步使用者的状态。 一共有五个可能的值: 活动:MQCB 调用已设置回调函数以通过异步方式处理消息,并且连接句柄已启动,因此异步消息使用可以继续。 不活动:MQCB 调用已设置回调函数以通过异步方式处理消息,但连接句柄尚未启动或者已停止或暂挂,因此异步消息使用当前无法继续。已暂挂:异步使用回调已暂挂,因此异步消息使用当前无法在此对象句柄上继续。 这可能是因为应用程序已经对此对象句柄发出带有 MQOP_SUSPEND 操作的 MQCB 调用,或者是因为该调用已经被系统暂挂。 如果系统已暂挂该调用,那么在暂挂异步消息使用的过程中,将调用该回调函数,并且返回原因码,说明导致暂挂的问题。 这样会在传递到回调函数的 MQCBC 结构的 Reason 字段中进行报告。 为了使异步消息使用继续,应用程序必须发出操作参数已设置为 MQOP_RESUME 的 MQCB 调用。 |
ASTATE |
临时暂挂:系统已临时暂挂异步使用回调,因此异步消息使用当前无法在此对象句柄上继续。 在暂挂异步消息使用的过程中,将调用该回调函数,并且返回原因码,说明导致暂挂的问题。 这样会在传递到回调函数的 MQCBC 结构的 Reason 字段中进行报告。 当临时情况解决后,系统恢复异步消息使用时,将再次调用该回调函数。 无:尚未对此句柄发出 MQCB 调用,因此未在此句柄上配置异步消息使用。 这是缺省值。 |
||
恢复单元处置 | (仅限z/OS)此参数用于过滤已返回的连接列表。 有 3 个选项可供选择:
|
URDISP |
“句柄”页面
下表列出了“应用程序连接属性”对话框的句柄页面上的属性。 句柄页面显示所选应用程序已打开的对象的信息。
属性 | 含义 | MQSC 参数 |
---|---|---|
连接标识 | 这是允许 IBM MQ 可靠地标识应用程序的 24 字节唯一连接标识。 当应用程序首次连接至队列管理器时,队列管理器会设置此连接标识。 | CONN 和 EXTCONN |
对象名 | 这是连接已打开的对象的名称。 | OBJNAME |
对象类型 | 这是连接已打开的对象的类型;例如,Queue 、Channel 、Storage
Class 。 |
OBJTYPE |
打开选项 | 这些是连接用于打开对象的选项。
|
OPENOPTS |
|
||
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 |