通过

DEACTIVATE_SESSION

  • 项目

DEACTIVATE_SESSION谓词请求 Microsoft® Host Integration Server 停用本地逻辑单元 (LU) 与指定伙伴 LU 之间的特定会话，或在特定模式下的所有会话。

以下结构描述 DEACTIVATE_SESSION 谓词使用的谓词控制块。

语法

  
typedef struct deactivate_session {  
    unsigned short  opcode;  
    unsigned char   reserv2[2];  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   reserv3[8];  
    unsigned char   lu_alias[8];  
    unsigned char   session_id[8];  
    unsigned char   plu_alias[8];  
    unsigned char   mode_name[8];  
    unsigned char   type;  
    unsigned char   reserv4[3];  
    unsigned short  sense_data;  
    unsigned char   fqplu_name[17];  
    unsigned char   reserv5[19];  
} DEACTIVATE_SESSION;

成员

opcode
提供的参数。 指定谓词操作代码，AP_DEACTIVATE_SESSION。

reserv2
保留字段。

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

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

reserv3
保留字段。

lu_alias
提供的参数。 提供本地用于 LU 的 8 字节 ASCII 名称。

session_id
提供的参数。 提供会话的 8 字节标识符，以停用在ACTIVATE_SESSION谓词) 返回 的 ( 。 如果此字段设置为 8 二进制零，则 Host Integration Server 将停用合作伙伴 LU 和模式的所有会话。

plu_alias
提供的参数。 提供本地用于合作伙伴 LU 的 8 字节 ASCII 名称。 如果要使用默认远程 LU，请用空格填充此参数。 如果要使用 fqplu_name 参数指定伙伴 LU，请使用二进制零填充此参数。

mode_name
提供的参数。 指定 EBCDIC (类型 A) 模式名称。

类型
提供的参数。 指定停用的类型。 可能的值为：

AP_DEACT_CLEANUP
立即停用会话，无需等待会话结束。

AP_DEACT_NORMAL
在使用该会话的所有会话结束之前，请不要停用会话。

sense_data
返回的参数。 指定会话的停用感知数据。

reserv4
保留字段。

fqplu_name
提供的参数。 在本地 节点中未 定义任何plu_alias名称，并且伙伴 LU 位于其他节点时，请在 EBCDIC (类型 A) 中提供合作伙伴 LU 名称。 如果指定 了plu_alias ，则忽略此参数。

reserv5
一个保留字段。

返回代码

AP_OK
主要返回代码；谓词已成功执行。 辅助返回代码指示已建立会话的极性。 可以返回以下值。

AP_PARAMETER_CHECK
主返回代码;由于参数错误（由以下辅助返回代码之一指定）而未执行谓词：

AP_INVALID_LU_ALIAS
辅助返回代码;APPC 在定义的 lu_alias 中找不到指定的lu_alias。

AP_INVALID_PLU_ALIAS
辅助返回代码;APPC 无法识别指定的 plu_alias。

AP_INVALID_SESSION_ID
辅助返回代码;APPC 无法识别指定的 session_id。

AP_INVALID_MODE_NAME
辅助返回代码;APPC 无法识别指定的 mode_name。

AP_INVALID_FQPLU_NAME
辅助返回代码;APPC 无法识别指定的 fqplu_name。

AP_INVALID_TYPE
辅助返回代码;APPC 无法识别指定的 类型。

AP_COMM_SUBSYSTEM_ABENDED
主返回代码;指示发生了以下情况之一：

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

TP 与 PU 2.1 节点之间的连接已断开， () 发生局域网错误。

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

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

AP_COMM_SUBSYSTEM_NOT_LOADED
主要返回代码；处理谓词时无法加载或终止某个必需的组件。 因此无法通信。 请联系系统管理员以执行纠正措施。

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

AP_THREAD_BLOCKING
主要返回代码；调用线程已在某个阻塞调用中。