Método IcomLUO.Receive

Recibe datos salientes en una sesión LU0.

Sintaxis

  
void Receive(  
   int timeout,  
   ref int datasize,  
   out int indication,  
   out short seqno,  
   ref System.Array data  
)

Parámetros

Importancia	Descripción
`timeout`	Período de tiempo en milisegundos que el subproceso puede esperar a que lleguen los datos. Al establecer `dataSize`, puede indicar si la aplicación está dispuesta a aceptar datos parciales después de un tiempo de espera. Escribir 0xffffffff en `howLong` indica un período infinito de tiempo.
`datasize`	Cantidad máxima de datos que la aplicación está dispuesta a aceptar. Si `dataSize` se reciben bytes de datos antes de que el tiempo de espera se competi, Receive devolverá la cadena parcial. Cuando este método devuelve, contiene el número de bytes presentes en el búfer de datos.
`indication`	Una o varias marcas en un OR bit a bit que contiene información adicional sobre la secuencia de datos saliente. Para obtener más información, vea la sección Comentarios.
`seqno`	Cuando este método vuelve, contiene el número de secuencia SNA de la cadena. Si NEG_RESPONSE se establece en `indication`, `seqno` puede contener en su lugar el número de secuencia de la cadena a la que el host envió una respuesta. El valor devuelto en se puede usar en `seqno` IcomLU0.SendResponse para transmitir una respuesta SNA.
`data`	Matriz que contiene los datos que se van a recibir.

Valor devuelto

Importancia	Descripción
S_OK	Una cadena de datos completa, o bien el resto de una cadena parcial de datos se recibió en el búfer de datos.
CLU0_S_PARTIAL_CHAIN	Se recibió una cadena parcial de datos en el búfer de datos.
CLU0_S_TIMEOUT	No se recibió ningún dato dentro del tiempo de espera especificado. Debe emitir otra recepción.
CLU0_E_SESSIONFAILURE	Error en la sesión lu0.
CLU0_E_SERVER_FAILURE	La sesión de TSS ya no es válida. La aplicación debe liberar el identificador de sesión.
CLU0_E_WAITING	Otro subproceso ha emitido una llamada Receive para este método y aún no se ha devuelto.
CLU0_E_SESSION_FAILED	Error en la sesión de SNA subyacente, posiblemente debido a una interrupción del vínculo u otro error transitorio. Debe desconectar y liberar la sesión del servidor. Como alternativa, puede llamar a IcomLU0.Offline para restablecer la sesión y, a continuación, llamar a IcomLU0.Online para reactivar la sesión.
CLU0_E_NOTCONNECTED	El cliente comLU0 no está conectado a una sesión a través de una llamada a Icom3270.Connect.
CLU0_E_BADPARAM	Uno de los parámetros contenía un valor no válido.
CLU0_E_SYSERROR	Error en el método debido a un error interno.

Excepciones

Observaciones

Normalmente, Receive se bloquea hasta que haya disponible una cadena completa de datos de SNA. Sin embargo, la aplicación puede controlar el bloque a través howLongde , maxDatay incompleteData.

Receive devuelve solo los datos de nivel de aplicación. En concreto, Receive no devolverá los encabezados SNA TH y RH.

En la siguiente tabla se describen los posibles valores de indication.

Importancia	Descripción
SESSION_STARTED	Uno de los siguientes: - Se ha activado la sesión iniciada por SSCP. - Un SDT ha reiniciado una sesión que ha restablecido un CLEAR. - Una sesión que recibió previamente un UNBIUND se ha reactivado mediante BIND y SDT.
BEGIN_BRACKET	El host inició un nuevo corchete.
END_BRACKET	El host finalizó el corchete actual.
SEND	El host ha concedido permiso para enviar.
DATA_COMPLETE	Los datos representan una cadena de datos completa o el final de una cadena de datos.
DATA_INCOMPLETE	Los datos representan una cadena de datos incompleta.
CANCELAR	Se canceló la última cadena del host.
NO_RESPONSE	La aplicación no debe enviar una respuesta a los datos.
EXCEPTION_RESPONSE1/2	La solicitud puede enviar una respuesta negativa para rechazar los datos o una confirmación de cortesía.
DEFINITE_RESPONSE1/2	La aplicación debe enviar una respuesta a los datos.
POS_RESPONSE	El host envió una respuesta positiva.
NEG_RESPONSE	El host envió una respuesta negativa.
EXR_REQUEST	El servidor SNA convirtió la solicitud de host en una solicitud de excepción.
PERSECUCIÓN	El host solicita que se envíen todas las respuestas pendientes.
NORMAL_DATA	Los datos se recibieron en el flujo de datos normal.
EXPEDITED_DATA	Los datos se recibieron en el flujo de datos acelerado.
APPL_DATA	Los datos son datos de aplicación (FMD).
FM_DATA	Los datos son datos de Administración de funciones (FMH).
LU_DATA	Los datos se recibieron en la sesión de LU.
SSCP_DATA	Los datos se recibieron en la sesión de SSCP.
CLEAR	El host ha borrado la sesión.
QUIESCE	El host ha inactivo la sesión.
SHUTDOWN	El host está apagando la sesión.
LANZAMIENTO	El host canceló el estado de inactividad o apagado.
UNBIND	El host desenlazó la sesión de LU-LU.

Véase también

Métodos IcomLU0
Integrador de sesiones para LU0

Last updated on 2026-03-25