LUA_COMMON

2025-06-05

以下结构列出了所有逻辑单元应用程序（LUA）谓词使用的通用数据结构参数。

struct LUA_COMMON {  
    unsigned short lua_verb;  
    unsigned short lua_verb_length;  
    unsigned short lua_prim_rc;  
    unsigned long  lua_sec_rc;  
    unsigned short lua_opcode;  
    unsigned long  lua_correlator;  
    unsigned char  lua_luname[8];  
    unsigned short lua_extension_list_offset;  
    unsigned short lua_cobol_offset;  
    unsigned long  lua_sid;  
    unsigned short lua_max_length;  
    unsigned short lua_data_length;  
    char FAR *     lua_data_ptr;  
    unsigned long  lua_post_handle;  
    struct LUA_TH  lua_th;  
    struct LUA_RH  lua_rh;  
    struct LUA_FLAG1 lua_flag1;  
    unsigned char  lua_message_type;  
    struct LUA_FLAG2 lua_flag2;  
    unsigned char  lua_resv56[7];  
    unsigned char  lua_encr_decr_option;  
} LUA_COMMON;

注解

成员

lua_verb
提供的参数。包含谓词代码，LUA_VERB_RUI请求单元接口（RUI）谓词或会话级别接口（SLI）谓词的LUA_VERB_SLI。对于这两个宏，值0x5200。

lua_verb_length
提供的参数。指定 LUA VCB 的长度（以字节为单位）。它必须包含所发出的谓词记录的长度。

lua_prim_rc
在谓词完成时由 LUA 设置的主要返回代码。有效的返回代码因颁发的 LUA 谓词而异。

lua_sec_rc
在谓词完成时由 LUA 设置的辅助返回代码。有效的返回代码因颁发的 LUA 谓词而异。

lua_opcode
提供的参数。包含要发出的谓词的 LUA 命令代码（谓词作代码），例如，RUI_BID谓词 LUA_OPCODE_RUI_BID 。

lua_correlator
提供的参数。包含一个用户提供的值，该值将谓词与其他用户提供的信息链接在一起。 LUA 不使用或更改此信息。此参数是可选的。

lua_luname
提供的参数。指定 Windows LUA 会话使用的本地 LU 的 ASCII 名称。

SLI_OPEN 和 RUI_INIT 需要此参数。如果lua_sid为零，其他 Windows LUA 谓词只需要此参数。

如果名称短于 8 个字符，则此参数长度为 8 字节，用空格（0x20）在右侧填充。

lua_extension_list_offset
指定从 VCB 开始到用户提供的动态链接库（DLL）扩展列表的偏移量。主机集成服务器中的 RUI 未使用，应设置为零。

lua_cobol_offset
COBOL 扩展的偏移量。主机集成服务器中 LUA 未使用，应为零。

lua_sid
提供并返回的参数。指定会话标识符，并由 SLI_OPEN 和 RUI_INIT返回。其他谓词使用此参数标识用于命令的会话。如果其他谓词使用 lua_luname 参数标识会话，请将 lua_sid 参数设置为零。

lua_max_length
指定接收RUI_READ和 SLI_RECEIVE的缓冲区长度。对于其他 RUI 和 SLI 谓词，它未使用，应设置为零。

lua_data_length
返回的参数。指定RUI_BID谓词lua_peek_data中返回的数据长度。

lua_data_ptr
指向应用程序提供的缓冲区的指针，其中包含要为SLI_SEND和RUI_WRITE发送的数据，或者接收SLI_RECEIVE和RUI_READ的数据。对于其他 RUI 和 SLI 谓词，此参数未使用，应设置为零。

lua_post_handle
提供的参数。如果异步通知由事件完成，则用于 Windows 下。此变量包含要发出信号的事件句柄或窗口句柄。

lua_th
返回的参数。包含已发送或接收的消息的 SNA 传输标头（TH）。为写入函数设置各种子参数，并为读取和投标函数返回。

lua_th.flags_fid

格式标识类型 2,4 位。

lua_th.flags_mpf

分段映射字段，两位。

lua_th.flags_odai

发起地址字段 -目标地址字段（OAF–DAF）分配器指示器，一位。

lua_th.flags_efi

加速流指示器，一位。

lua_th.daf

目标地址字段（DAF），一个无符号字符。

lua_th.oaf

发起地址字段（OAF），一个无符号字符。

lua_th.snf

序列号字段，无符号字符[2]。

lua_rh
返回的参数。包含已发送或接收的消息的 SNA 请求/响应标头（RH）。它为写入函数设置，并由读取和投标函数返回。

lua_rh.rri

请求-响应指示器，一位。

lua_rh.ruc

RU 类别，两位。

lua_rh.fi

格式指示器，一位。

lua_rh.sdi

感知数据包括指示器，一位。

lua_rh.bci

开始链指示器，一位。

lua_rh.eci

结束链指示器，一位。

lua_rh.dr1i

明确响应 1 指示器，一位。

lua_rh.dr2i

明确响应 2 指示器，一位。

lua_rh.ri

异常响应指示器（对于请求），或响应类型指示器（对于响应），一位。

lua_rh.qri

排队响应指示器，一位。

lua_rh.pi

Pacing 指示器，一位。

lua_rh.bbi

开始方括号指示器，一位。

lua_rh.ebi

端括号指示器，一位。

lua_rh.cdi

更改方向指示器，一位。

lua_rh.csi

代码选择指示器，一位。

lua_rh.edi

加密的数据指示器，一位。

lua_rh.pdi

填充的数据指示器，一位。

lua_flag1
提供的参数。包含包含应用程序提供的消息标志的数据结构。此参数由 RUI_BID、 RUI_READ、 RUI_WRITE、 SLI_BID、 SLI_RECEIVE和 SLI_SEND使用。对于其他 LUA 谓词，此参数未使用，应设置为零。

lua_flag1.bid_enable

投标启用指示器，一位。

lua_flag1.close_abend

关闭即时指示器，一位。

lua_flag1.nowait

没有等待数据标志，一位。

lua_flag1.sscp_exp

SSCP 加速流，一位。

lua_flag1.sscp_norm

SSCP 正常流，一位。

lua_flag1.lu_exp

LU 加速流，一位。

lua_flag1.lu_norm

LU 正常流，一位。

lua_message_type
指定入站或出站 SNA 命令和数据的类型。这是RUI_INIT和SLI_OPEN的返回参数，也是SLI_SEND提供的参数。对于其他 LUA 谓词，此变量未使用，应设置为零。

可能的值为：

LUA_MESSAGE_TYPE_LU_DATA

LUA_MESSAGE_TYPE_SSCP_DATA

LUA_MESSAGE_TYPE_BID

LUA_MESSAGE_TYPE_BIND

LUA_MESSAGE_TYPE_BIS

LUA_MESSAGE_TYPE_CANCEL

LUA_MESSAGE_TYPE_CHASE

LUA_MESSAGE_TYPE_CLEAR

LUA_MESSAGE_TYPE_CRV

LUA_MESSAGE_TYPE_LUSTAT_LU

LUA_MESSAGE_TYPE_LUSTAT_SSCP

LUA_MESSAGE_TYPE_QC

LUA_MESSAGE_TYPE_QEC

LUA_MESSAGE_TYPE_RELQ

LUA_MESSAGE_TYPE_RQR

LUA_MESSAGE_TYPE_RTR

LUA_MESSAGE_TYPE_SBI

LUA_MESSAGE_TYPE_SHUTD

LUA_MESSAGE_TYPE_SIGNAL

LUA_MESSAGE_TYPE_SDT

LUA_MESSAGE_TYPE_STSN

LUA_MESSAGE_TYPE_UNBIND

SLI 通过 LUA 接口扩展例程接收和响应 BIND、CRV 和 STSN 请求。

LU_DATA、LUSTAT_LU、LUSTAT_SSCP和SSCP_DATA不是 SNA 命令。

lua_flag2
返回的参数。包含 LUA 返回的消息的标志。此参数由 RUI_BID、 RUI_READ、 RUI_WRITE、 SLI_BID、 SLI_RECEIVE和 SLI_SEND返回。对于其他 LUA 谓词，此参数未使用，应设置为零。

lua_flag2.bid_enable

指示如果设置为 1，则已成功重新启用 RUI_BID 。

lua_flag2.async

指示 LUA 接口谓词在设置为 1 时异步完成。

lua_flag2.sscp_exp

指示 SSCP 加速流（如果设置为 1）。

lua_flag2.sscp_norm

如果设置为 1，则指示 SSCP 正常流。

lua_flag2.lu_exp

指示设置为 1 的 LU 加速流。

lua_flag2.lu_norm

如果设置为 1，则指示 LU 正常流。

lua_resv56
提供的参数。 SLI_OPEN和RUI_INIT使用的保留字段。对于所有其他 LUA 谓词，此参数保留，应设置为零。

lua_encr_decr_option
加密选项的字段。 在RUI_INIT，仅支持以下各项：

lua_encr_decr_option = 0
lua_encr_decr_option = 128

对于所有其他 LUA 谓词，此参数保留，应设置为零。

通过

LUA_COMMON

注解

成员

其他资源