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
| Value | 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 se competi el tiempo de espera, 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 el flujo de datos saliente. Para obtener más información, vea la sección Comentarios. |
seqno |
Cuando este método devuelve, 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
| Value | 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 ha devuelto. |
| CLU0_E_SESSION_FAILED | Error en la sesión de SNA subyacente, posiblemente debido a una interrupción de 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.
| Value | 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 ha sido reactivada por bind y SDT. |
| BEGIN_BRACKET | El host inició un nuevo corchete. |
| END_BRACKET | El host finalizó el corchete actual. |
| ENVIAR | 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 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. |
| CHASE | 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 puesto en modo incedido la sesión. |
| SHUTDOWN | El host está cerrando la sesión. |
| RELEASE | El host canceló el estado de inactividad o apagado. |
| DESVINCULAR | El host desenlaza la sesión lu-LU. |