LUA_COMMON

Artículo
07/21/2023

En la estructura siguiente se enumeran los parámetros de estructura de datos comunes utilizados por todos los verbos de la aplicación de unidad lógica (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;

Comentarios

Miembros

lua_verb
Parámetro proporcionado. Contiene el código de verbo, LUA_VERB_RUI para verbos de interfaz de unidad de solicitud (RUI) o LUA_VERB_SLI para verbos de interfaz de nivel de sesión (SLI). Para ambas macros, el valor es 0x5200.

lua_verb_length
Parámetro proporcionado. Especifica la longitud en bytes del VCB lua. Debe contener la longitud del registro de verbo que se va a emitir.

lua_prim_rc
Código de retorno principal establecido por LUA al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo LUA emitido.

lua_sec_rc
Código de retorno secundario establecido por LUA al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo LUA emitido.

lua_opcode
Parámetro proporcionado. Contiene el código de comando LUA (código de operación de verbo) para el verbo que se va a emitir, por ejemplo, LUA_OPCODE_RUI_BID para el verbo RUI_BID .

lua_correlator
Parámetro proporcionado. Contiene un valor proporcionado por el usuario que vincula el verbo con otra información proporcionada por el usuario. LUA no usa ni cambia esta información. Este parámetro es opcional.

lua_luname
Parámetro proporcionado. Especifica el nombre ASCII de la LU local usada por la sesión de LUA de Windows.

SLI_OPEN y RUI_INIT requieren este parámetro. Otros verbos luA de Windows solo requieren este parámetro si lua_sid es cero.

Este parámetro tiene ocho bytes de longitud, rellenado a la derecha con espacios (0x20) si el nombre tiene más de ocho caracteres.

lua_extension_list_offset
Especifica el desplazamiento desde el inicio del VCB a la lista de extensiones de bibliotecas de vínculos dinámicos (DLL) proporcionadas por el usuario. No se usa por RUI en Host Integration Server y debe establecerse en cero.

lua_cobol_offset
Desplazamiento de la extensión COBOL. LuA no se usa en Host Integration Server y debe ser cero.

lua_sid
Parámetro proporcionado y devuelto. Especifica el identificador de sesión y lo devuelve SLI_OPEN y RUI_INIT. Otros verbos usan este parámetro para identificar la sesión usada para el comando . Si otros verbos usan el parámetro lua_luname para identificar sesiones, establezca el parámetro lua_sid en cero.

lua_max_length
Especifica la longitud del búfer recibido para RUI_READy SLI_RECEIVE. Para otros verbos RUI y SLI, no se usa y se debe establecer en cero.

lua_data_length
Parámetro devuelto. Especifica la longitud de los datos devueltos en lua_peek_data para el verbo RUI_BID .

lua_data_ptr
Puntero al búfer proporcionado por la aplicación que contiene los datos que se van a enviar para SLI_SEND y RUI_WRITE o que recibirán datos para SLI_RECEIVE y RUI_READ. Para otros verbos RUI y SLI, este parámetro no se usa y debe establecerse en cero.

lua_post_handle
Parámetro proporcionado. Se usa en Windows si los eventos van a realizar notificaciones asincrónicas. Esta variable contiene el identificador del evento que se va a indicar o un identificador de ventana.

lua_th
Parámetro devuelto. Contiene el encabezado de transmisión SNA (TH) del mensaje enviado o recibido. Se establecen varios subparámetres para las funciones de escritura y se devuelven para las funciones de lectura y puja.

lua_th.flags_fid

Tipo de identificación de formato 2, cuatro bits.

lua_th.flags_mpf

Campo de asignación de segmentación, dos bits.

lua_th.flags_odai

Indicador de asignador de campo de dirección de origen:campo de dirección de destino (OAF–DAF), un bit.

lua_th.flags_efi

Indicador de flujo acelerado, un bit.

lua_th.daf

Campo de dirección de destino (DAF), un carácter sin signo.

lua_th.oaf

Campo de dirección de origen (OAF), un carácter sin signo.

lua_th.snf

Campo número de secuencia, un char sin signo[2].

lua_rh
Parámetro devuelto. Contiene el encabezado de solicitud/respuesta de SNA (RH) del mensaje enviado o recibido. Se establece para la función de escritura y la devuelven las funciones de lectura y puja.

lua_rh.rri

Indicador de solicitud-respuesta, un bit.

lua_rh.ruc

Categoría ru, dos bits.

lua_rh.fi

Indicador de formato, un bit.

lua_rh.sdi

Los datos de detección incluyen un indicador, un bit.

lua_rh.bci

Indicador de cadena de inicio, un bit.

lua_rh.eci

Indicador de cadena final, un bit.

lua_rh.dr1i

Indicador de respuesta definitiva 1, un bit.

lua_rh.dr2i

Indicador de respuesta definitiva 2, un bit.

lua_rh.ri

Indicador de respuesta de excepción (para una solicitud) o indicador de tipo de respuesta (para una respuesta), un bit.

lua_rh.qri

Indicador de respuesta en cola, un bit.

lua_rh.pi

Indicador de velocidad, un poco.

lua_rh.bbi

Indicador de corchete inicial, un bit.

lua_rh.ebi

Indicador de corchete final, un bit.

lua_rh.cdi

Indicador de dirección de cambio, un bit.

lua_rh.csi

Indicador de selección de código, un bit.

lua_rh.edi

Indicador de datos cifrado, un bit.

lua_rh.pdi

Indicador de datos rellenado, un bit.

lua_flag1
Parámetro proporcionado. Contiene una estructura de datos que contiene marcas para los mensajes proporcionados por la aplicación. Este parámetro lo usan RUI_BID, RUI_READ, RUI_WRITE, SLI_BID, SLI_RECEIVE y SLI_SEND. Para otros verbos LUA, este parámetro no se usa y debe establecerse en cero.

lua_flag1.bid_enable

Indicador de habilitación de puja, un bit.

lua_flag1.close_abend

Cierre el indicador inmediato, un bit.

lua_flag1.nowait

No espere a la marca de datos, un bit.

lua_flag1.sscp_exp

Flujo acelerado de SSCP, un bit.

lua_flag1.sscp_norm

Flujo normal de SSCP, un bit.

lua_flag1.lu_exp

Flujo acelerado de LU, un bit.

lua_flag1.lu_norm

Flujo normal de LU, un bit.

lua_message_type
Especifica el tipo de los comandos y datos de SNA entrantes o salientes. Se trata de un parámetro devuelto para RUI_INIT y SLI_OPEN y un parámetro proporcionado para SLI_SEND. Para otros verbos LUA, esta variable no se usa y debe establecerse en cero.

Los valores posibles son:

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

El SLI recibe y responde a las solicitudes BIND, CRV y STSN a través de las rutinas de extensión de interfaz LUA.

LU_DATA, LUSTAT_LU, LUSTAT_SSCP y SSCP_DATA no son comandos SNA.

lua_flag2
Parámetro devuelto. Contiene marcas para los mensajes devueltos por LUA. Este parámetro lo devuelve RUI_BID, RUI_READ, RUI_WRITE, SLI_BID, SLI_RECEIVE y SLI_SEND. Para otros verbos LUA, este parámetro no se usa y debe establecerse en cero.

lua_flag2.bid_enable

Indica que RUI_BID se ha vuelto a habilitar correctamente si está establecido en 1.

lua_flag2.async

Indica que el verbo de interfaz LUA se completó de forma asincrónica si se establece en 1.

lua_flag2.sscp_exp

Indica el flujo acelerado de SSCP si se establece en 1.

lua_flag2.sscp_norm

Indica el flujo normal de SSCP si se establece en 1.

lua_flag2.lu_exp

Indica el flujo acelerado de LU si se establece en 1.

lua_flag2.lu_norm

Indica el flujo normal de LU si se establece en 1.

lua_resv56
Parámetro proporcionado. Campo reservado usado por SLI_OPEN y RUI_INIT. Para todos los demás verbos LUA, este parámetro está reservado y debe establecerse en cero.

lua_encr_decr_option
Campo para las opciones de criptografía. En RUI_INIT, solo se admite lo siguiente:

lua_encr_decr_option = 0
lua_encr_decr_option = 128

Para todos los demás verbos LUA, este parámetro está reservado y debe establecerse en cero.

LUA_COMMON

Comentarios

Miembros

Recursos adicionales