GET_LU_STATUS

GET_LU_STATUS谓词 (LU) 返回特定逻辑单元的状态。 仅当支持同步点对话时,此会话谓词才可用。

以下结构描述了GET_LU_STATUS谓词使用的谓词控制块 (VCB )

语法

  
struct get_type {  
    unsigned short   opcode;  
    unsigned char    opext;  
    unsigned char    reserv2;  
    unsigned short   primary_rc;  
    unsigned long    secondary_rc;  
    unsigned char    tp_id[8];  
    unsigned char    plu_alias[8];  
    unsigned short   active_sess;  
    unsigned char    zero_sess;  
    unsigned char    local_only;  
    unsigned char    synchpoint;  
    unsigned char    pool_member;  
    unsigned char    reserv3[7];  
};   

成员

opcode
提供的参数。 指定谓词操作代码,AP_GET_LU_STATUS。

opext
GET_LU_STATUS谓词未使用此字段。

reserv2
保留字段。

primary_rc
返回的参数。 指定在谓词完成时由 APPC 设置的主要返回代码。 有效的返回代码因发出的 APPC 谓词而异。 有关此谓词的有效错误代码,请参阅“返回代码”。

secondary_rc
返回的参数。 指定在谓词完成时由 APPC 设置的次要返回代码。 有效的返回代码因发出的 APPC 谓词而异。 有关此谓词的有效错误代码,请参阅“返回代码”。

tp_id
提供的参数。 标识 TP) (本地事务程序。 此参数的值由调用 TP 中的 TP_STARTED 或调用的 TP 中的RECEIVE_ALLOCATE 或RECEIVE_ALLOCATE_EX返回。

plu_alias
提供的参数。 提供此 TP 正在查询的 LU 的标识符。 此参数的值由调用 TP 中的 MC_ALLOCATEALLOCATE 或调用的 TP 中的 RECEIVE_ALLOCATE 返回。

如果local_only设置为 AP_YES,则不需要

active_sess
返回的参数。 提供此 LU 上的活动会话数。

zero_sess
返回的参数。 指示此 LU 上是否为零个会话。 值AP_YES或AP_NO。

active_sess
返回的参数。

zero_sess
返回的参数。

local_only
如果此字段设置为 AP_YES则无需指定plu_alias,谓词仅返回本地 LU 信息 - syncpoint 和 default_pool。

synchpoint
返回的参数。

pool_member
如果此字段设置为 AP_YES则无需指定plu_alias,谓词仅返回本地 LU 信息 - syncpoint 和 default_pool。

reserv3
一个保留字段。

返回代码

AP_OK
主要返回代码;谓词已成功执行。

AP_PARAMETER_CHECK
主要返回代码;由于参数错误,谓词未执行。

AP_BAD_LU_ALIAS

辅助返回代码; plu_alias 的值与 APPC 分配的任何 LU 不匹配。

AP_BAD_TP_ID

辅助返回代码; tp_id 的值与 APPC 分配的 TP 标识符不匹配。

AP_COMM_SUBSYSTEM_ABENDED
主要返回代码;指示以下状况之一:

  • 此对话使用的节点遇到了 ABEND。

  • TP 与 PU 2.1 节点之间的连接已断开(LAN 错误)。

  • TP 计算机上的 SnaBase 遇到了 ABEND。

    系统管理员应检查错误日志以确定发生 ABEND 的原因。

    AP_INVALID_VERB_SEGMENT
    主要返回代码;VCB 超出了数据段的末尾。

    AP_STACK_TOO_SMALL
    主要返回代码;应用程序的堆栈大小太小,无法执行谓词。 增加应用程序的堆栈大小。

    AP_CONV_BUSY
    主返回代码;任何对话一次只能有一个未完成的对话谓词。 如果本地 TP 具有多个线程,并且多个线程使用相同的 conv_id发出 APPC 调用,则可能会发生这种情况。

    AP_UNEXPECTED_DOS_ERROR
    主要返回代码;操作系统在处理来自本地 TP 的 APPC 调用时向 APPC 返回了错误。 已通过 secondary_rc 返回了操作系统返回代码。 此返回代码是以 Intel 字节交换顺序显示的。 如果问题持续出现,请咨询系统管理员。

备注

当 TP 发出此谓词时,会话可以处于除 RESET 之外的任何状态。

没有状态更改。

当前版本的 GET_LU_STATUS 允许应用程序检索本地 APPC LU 的配置参数。

若要在发出RECEIVE_ALLOCATE_EX谓词之前检查特定本地 LU 的配置,应发出以下谓词序列:

  • TP_STARTED (指定感兴趣的本地 LU)

  • local_only 设置为 AP_YES) 的GET_LU_STATUS (

  • TP_ENDED (AP_SOFT)