Compartir a través de

RECEIVE_IMMEDIATE

  • Artículo

El verbo RECEIVE_IMMEDIATE recibe los datos disponibles actualmente del programa de transacciones de asociados (TP). Si no hay datos disponibles, el TP local no espera. Para evitar bloquear la conversación, el sistema operativo Microsoft Windows puede emitir RECEIVE_AND_WAIT junto con WinAsyncAPPC.

En la estructura siguiente se describe el bloque de control de verbo utilizado por el verbo RECEIVE_IMMEDIATE .

Sintaxis

  
struct receive_immediate {  
    unsigned short      opcode;  
    unsigned char       opext;  
    unsigned char       reserv2;  
    unsigned short      primary_rc;  
    unsigned long       secondary_rc;  
    unsigned char       tp_id[8];  
    unsigned long       conv_id;  
    unsigned short      what_rcvd;  
    unsigned char       rtn_status;  
    unsigned char       fill;  
    unsigned char       rts_rcvd;  
    unsigned char       reserv4;  
    unsigned short      max_len;  
    unsigned short      dlen;  
    unsigned char FAR * dptr;  
    unsigned char       reserv5[5];  
};

Miembros

opcode
Parámetro proporcionado. Especifica el código de operación de verbo, AP_B_RECEIVE_IMMEDIATE.

opext
Parámetro proporcionado. Especifica la extensión de la operación de verbo, AP_BASIC_CONVERSATION.

reserv2
Campo reservado.

primary_rc
Parámetro devuelto. Especifica el código de retorno principal que establece APPC al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo APPC que se emita. Consulte la sección de códigos de retorno para obtener los códigos de error válidos para este verbo.

secondary_rc
Parámetro devuelto. Especifica el código de retorno secundario que establece APPC al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo APPC que se emita. Consulte la sección de códigos de retorno para obtener los códigos de error válidos para este verbo.

tp_id
Parámetro proporcionado. Identifica el TP local. El valor de este parámetro lo devuelve TP_STARTED en el TP invocado o por RECEIVE_ALLOCATE en el TP invocado.

conv_id
Parámetro proporcionado. Proporciona el identificador de conversación. Allocate devuelve el valor de este parámetro en el TP invocado o por RECEIVE_ALLOCATE en el TP invocado.

what_rcvd
Parámetro devuelto. Contiene información recibida con los datos entrantes. Los valores posibles se enumeran después de la sección Miembros.

rtn_status
Parámetro proporcionado. Indica si se deben devolver tanto los indicadores de estado de los datos como de la conversación dentro de una llamada API.

Use AP_NO para especificar que los indicadores se deben devolver individualmente en invocaciones independientes del verbo.

Use AP_YES para especificar que los indicadores deben devolverse juntos, siempre que ambos estén disponibles. Ambos se pueden devolver cuando:

  • El búfer de recepción es lo suficientemente grande como para contener todos los datos que preceden al indicador de estado.

  • El parámetro fill especifica BUFFER o LL, y los datos son el último registro lógico antes del indicador de estado.

    fill
    Parámetro proporcionado. Especifica la manera en que el TP local recibe datos. Solo se usa para RECEIVE_IMMEDIATE.

    Use AP_BUFFER para indicar que el TP local recibe datos hasta que se alcanza el número de bytes especificados por max_len o hasta el final de los datos. Los datos se reciben sin tener en cuenta el formato de registro lógico.

    Use AP_LL para indicar que los datos se reciben en formato de registro lógico. Los datos recibidos pueden ser un registro lógico completo, una parte de max_len byte de un registro lógico o el final de un registro lógico.

    rts_rcvd
    Parámetro devuelto. Contiene el indicador de solicitud a envío. Los valores posibles son:

  • AP_YES indica que el TP del asociado ha emitido REQUEST_TO_SEND, que solicita que el TP local cambie la conversación al estado RECEIVE.

  • AP_NO indica que el TP del asociado no ha emitido REQUEST_TO_SEND.

    max_len
    Parámetro proporcionado. Indica el número máximo de bytes de datos que puede recibir el TP local. El intervalo va de 0 a 65535.

    Para el sistema operativo Windows, este valor no debe superar la longitud del búfer para contener los datos recibidos.

    Al emitir RECEIVE_IMMEDIATE con max_len establecido en cero, el TP local puede determinar si el TP del asociado tiene datos para enviar, buscar confirmación o ha cambiado el estado de conversación.

    dlen
    Parámetro devuelto. Proporciona el número de bytes de datos recibidos. Los datos se almacenan en un búfer especificado por dptr. Una longitud de cero indica que no se recibió ningún dato.

    dptr
    Parámetro proporcionado. Dirección del búfer que contiene los datos recibidos por el TP local.

    Para el sistema operativo Windows, el búfer de datos puede residir en un área de datos estática o en un área asignada globalmente. El búfer de datos debe caber completamente dentro de esta área.

    Valores devueltos por el parámetro what_rcvd

  • AP_CONFIRM_DEALLOCATE indica que el TP de asociado ha emitido DEALLOCATE con dealloc_type establecido en AP_SYNC_LEVEL y el nivel de sincronización de la conversación, establecido por ALLOCATE, se AP_CONFIRM_SYNC_LEVEL. Al recibir este valor, el TP local normalmente emite CONFIRMADO.

  • AP_CONFIRM_SEND indica que el TP del asociado ha emitido PREPARE_TO_RECEIVE con ptr_type establecido en AP_SYNC_LEVEL y el nivel de sincronización de la conversación, establecido por ALLOCATE, está AP_CONFIRM_SYNC_LEVEL. Tras recibir este valor, el TP local normalmente emite CONFIRMADO y comienza a enviar datos.

  • AP_CONFIRM_WHAT_RECEIVED indica que el TP del asociado ha emitido CONFIRM. Al recibir este valor, el TP local normalmente emite CONFIRMADO.

  • AP_DATA se devuelve para conversaciones básicas RECEIVE_IMMEDIATE si el relleno está establecido en AP_BUFFER. El TP local recibió datos hasta que se alcanzó max_len o el final de los datos. Para obtener más información, vea "RECEIVE_IMMEDIATE fin de los datos" al final de este tema.

  • AP_DATA_COMPLETE indica, para RECEIVE_IMMEDIATE con relleno establecido en AP_LL en conversaciones básicas, que el TP local ha recibido un registro lógico completo o el final de un registro lógico.

    Al recibir este valor, el TP local normalmente vuelve a emitir RECEIVE_IMMEDIATE o emite otro verbo de recepción. Si el TP del asociado ha enviado más datos, el TP local comienza a recibir una nueva unidad de datos.

    De lo contrario, el TP local examina la información de estado si primary_rc contiene AP_OK y what_rcvd contiene cualquiera de estos valores:

    AP_SEND

    AP_CONFIRM_SEND

    AP_CONFIRM_DEALLOCATE

    AP_CONFIRM_WHAT_RECEIVED

    Consulte la descripción del valor en Códigos de retorno de este tema para obtener la siguiente acción que normalmente realiza el TP local.

    Si primary_rc contiene AP_DEALLOC_NORMAL, la conversación se ha desasignado en respuesta a DEALLOCATE emitido por el TP del asociado.

  • AP_DATA_INCOMPLETE indica para RECEIVE_IMMEDIATE en conversaciones asignadas que el TP local ha recibido un registro de datos incompleto. El parámetro max_len especificó un valor menor que la longitud del registro de datos (o menos que el resto del registro de datos si no es el primer verbo de recepción para leer el registro).

    Para RECEIVE_IMMEDIATE con relleno establecido en AP_LL en conversaciones básicas, este valor indica que el TP local ha recibido un registro lógico incompleto.

    Al recibir este valor, el TP local normalmente vuelve a emitir RECEIVE_IMMEDIATE (o emite otro verbo de recepción) para recibir la siguiente parte del registro.

  • AP_NONE indica que el TP no recibió datos ni indicadores de estado de conversación.

  • AP_SEND indica, para el TP del asociado, la conversación ha entrado en estado RECEIVE. Para el TP local, la conversación ahora está en estado SEND. Al recibir este valor, el TP local normalmente usa SEND_DATApara empezar a enviar datos.

Códigos de retorno

AP_OK
Código de retorno principal; el verbo se ha ejecutado correctamente.

Cuando rtn_status es AP_YES , se puede devolver el código de retorno anterior o uno de los siguientes códigos de retorno.

AP_DATA_COMPLETE_SEND
Código de retorno principal; se trata de una combinación de AP_DATA_COMPLETE y AP_SEND.

AP_DATA_COMPLETE_CONFIRM_SEND
Código de retorno principal; se trata de una combinación de AP_DATA_COMPLETE y AP_CONFIRM_SEND.

AP_DATA_COMPLETE_CONFIRM
Código de retorno principal; se trata de una combinación de AP_DATA_COMPLETE y AP_CONFIRM_WHAT_RECEIVED.

AP_DATA_COMPLETE_CONFIRM_DEALL
Código de retorno principal; se trata de una combinación de AP_DATA_COMPLETE y AP_CONFIRM_DEALLOCATE.

AP_DATA_SEND
Código de retorno principal; se trata de una combinación de AP_DATA y AP_SEND.

AP_DATA_CONFIRM_SEND
Código de retorno principal; se trata de una combinación de AP_DATA y AP_CONFIRM_SEND.

AP_DATA_CONFIRM
Código de retorno principal; se trata de una combinación de AP_DATA y AP_CONFIRM_WHAT_RECEIVED.

AP_DATA_CONFIRM_DEALLOCATE
Código de retorno principal; se trata de una combinación de AP_DATA y AP_CONFIRM_DEALLOCATE.

AP_UNSUCCESSFUL
Código de retorno principal; no hay datos disponibles inmediatamente en el TP del asociado.

AP_DEALLOC_NORMAL
Código de retorno principal; el TP del asociado ha desasignado la conversación sin solicitar confirmación. El TP de asociado emitió DEALLOCATE con dealloc_type establecido en uno de los siguientes:

  • AP_FLUSH

  • AP_SYNC_LEVEL con el nivel de sincronización de la conversación especificada como AP_NONE

    Si rtn_status AP_YES, examine también what_rcvd .

    AP_PARAMETER_CHECK
    Código de retorno principal; el verbo no se ha ejecutado debido a un error en un parámetro.

    AP_BAD_CONV_ID

    Código de retorno secundario; el valor de conv_id no coincide con un identificador de conversación asignado por APPC.

    AP_BAD_TP_ID

    Código de retorno secundario; el valor de tp_id no coincide con un identificador de TP asignado por APPC.

    AP_BAD_RETURN_STATUS_WITH_DATA

    Código de retorno secundario; APPC no reconoció el valor de rtn_status especificado.

    AP_INVALID_DATA_SEGMENT

    Código de retorno secundario; la longitud especificada para el búfer de datos era mayor que el segmento asignado para contener el búfer.

    AP_RCV_IMMD_BAD_FILL

    Código de retorno secundario para una conversación básica; El parámetro fill se estableció en un valor no válido.

    AP_STATE_CHECK
    Código de retorno principal; el verbo no se ejecutó porque se emitió en un estado no válido.

    AP_RCV_IMMD_BAD_STATE

    Código de retorno secundario; la conversación no estaba en estado RECEIVE.

    AP_ALLOCATION_ERROR

    Código de retorno secundario; APPC no ha podido asignar una conversación. El estado de la conversación se establece en RESET.

    Este código se puede devolver a través de un verbo emitido después de ALLOCATE.

    AP_ALLOCATION_FAILURE_NO_RETRY

    Código de retorno secundario; la conversación no se puede asignar debido a una condición permanente, como un error de configuración o un error de protocolo de sesión. Para determinar el error, el administrador del sistema debe examinar el archivo de registro de errores. No vuelva a intentar la asignación hasta que se haya corregido el error.

    AP_ALLOCATION_FAILURE_RETRY

    Código de retorno secundario; No se pudo asignar la conversación debido a una condición temporal, como un error de vínculo. El motivo del error se registra en el registro de errores del sistema. Vuelva a intentar la asignación.

    AP_CONVERSATION_TYPE_MISMATCH

    Código de retorno secundario; la unidad lógica de asociado (LU) o TP no admite el tipo de conversación (básico o asignado) especificado en la solicitud de asignación.

    AP_PIP_NOT_ALLOWED

    Código de retorno secundario; la solicitud de asignación especificó datos pip, pero el TP del asociado no requiere estos datos o la LU del asociado no la admite.

    AP_PIP_NOT_SPECIFIED_CORRECTLY

    Código de retorno secundario; el TP del asociado requiere datos pip, pero la solicitud de asignación no especificó datos pip ni un número incorrecto de parámetros.

    AP_SECURITY_NOT_VALID

    Código de retorno secundario; el identificador de usuario o la contraseña especificados en la solicitud de asignación no fue aceptado por la LU del asociado.

    AP_SYNC_LEVEL_NOT_SUPPORTED

    Código de retorno secundario; el TP del asociado no admite el sync_level (AP_NONE o AP_CONFIRM_SYNC_LEVEL) especificado en la solicitud de asignación o no se reconoció el sync_level .

    AP_TP_NAME_NOT_RECOGNIZED

    Código de retorno secundario; la LU del asociado no reconoce el nombre de TP especificado en la solicitud de asignación.

    AP_TRANS_PGM_NOT_AVAIL_NO_RETRY

    Código de retorno secundario; la LU remota rechazó la solicitud de asignación porque no pudo iniciar el TP del asociado solicitado. La condición es permanente. El motivo del error se puede registrar en el nodo remoto. No vuelva a intentar la asignación hasta que se haya corregido el error.

    AP_TRANS_PGM_NOT_AVAIL_RETRY

    Código de retorno secundario; la LU remota rechazó la solicitud de asignación porque no pudo iniciar el TP del asociado solicitado. La condición puede ser temporal, como un tiempo de espera. El motivo del error se puede registrar en el nodo remoto. Vuelva a intentar la asignación.

    AP_COMM_SUBSYSTEM_ABENDED
    Código de retorno principal; indica una de las condiciones siguientes:

  • El nodo utilizado por esta conversación encontró una anulación.

  • La conexión entre el TP y el nodo PU 2.1 se interrumpió (un error de LAN).

  • El proceso SnaBase que se ejecuta en el equipo del TP encontró una anulación.

    El administrador del sistema debe examinar el registro de errores a fin de determinar el motivo de la anulación.

    AP_COMM_SUBSYSTEM_NOT_LOADED
    Código de retorno principal; no se pudo cargar un componente necesario o se ha terminado mientras se procesa el verbo. Por tanto, no se pudo establecer la comunicación. Consulte al administrador del sistema para aplicar una acción correctiva.

    Cuando este código de retorno se usa con ALLOCATE, puede indicar que no se puede encontrar ningún sistema de comunicaciones para admitir la LU local. (Por ejemplo, el alias de LU local especificado con TP_STARTED es incorrecto o no se ha configurado). Tenga en cuenta que si lu_alias o mode_name tiene menos de ocho caracteres, debe asegurarse de que estos campos estén llenos de espacios a la derecha. Este error se devuelve si estos parámetros no se rellenan con espacios, ya que no hay ningún nodo disponible que pueda satisfacer la solicitud ALLOCATE .

    Cuando ALLOCATE genera este código de retorno para un sistema cliente de Host Integration Server configurado con varios nodos, hay dos códigos de retorno secundarios de la siguiente manera:

    0xF0000001

    Código de retorno secundario; no se ha iniciado ningún nodo.

    0xF0000002

    Código de retorno secundario; se ha iniciado al menos un nodo, pero la LU local (cuando se emite TP_STARTED ) no está configurada en ningún nodo activo. El problema podría ser cualquiera de los siguientes:

  • No se inicia el nodo con la LU local.

  • La LU local no está configurada.

    AP_CONV_FAILURE_NO_RETRY
    Código de retorno principal; la conversación se finalizó debido a una condición permanente, como un error de protocolo de sesión. El administrador del sistema debe examinar el registro de errores del sistema para determinar la causa del error. No vuelva a intentar la conversación hasta que se corrija el error.

    AP_CONV_FAILURE_RETRY
    Código de retorno principal; la conversación se finalizó debido a un error temporal. Reinicie el TP para ver si el problema se produce de nuevo. Si es así, el administrador del sistema debe examinar el registro de errores para determinar la causa del error.

    AP_CONVERSATION_TYPE_MIXED
    Código de retorno principal; el TP ha emitido verbos de conversación básicos y asignados. Solo se puede emitir un tipo en una sola conversación.

    AP_INVALID_VERB_SEGMENT
    Código de retorno principal; el bloque de control de verbo (VCB) se ha extendido más allá del final del segmento de datos.

    AP_PROG_ERROR_NO_TRUNC
    Código de retorno principal; el TP del asociado ha emitido SEND_ERROR con err_type establecido en AP_PROG mientras la conversación estaba en estado SEND. Los datos no se han truncado.

    AP_PROG_ERROR_PURGING
    Código de retorno principal; mientras que en ESTADO RECEIVE, PENDING, PENDING_POST, CONFIRM, CONFIRM_SEND o CONFIRM_DEALLOCATE, el TP de asociado emitido SEND_ERROR con err_type establecido en AP_PROG. Los datos enviados pero aún no recibidos se purgan.

    AP_PROG_ERROR_TRUNC
    Código de retorno principal; en estado SEND, después de enviar un registro lógico incompleto, el TP del asociado emitió SEND_ERROR con err_type establecido en AP_PROG. El TP local puede haber recibido la primera parte del registro lógico a través de un verbo receive.

    AP_STACK_TOO_SMALL
    Código de retorno principal; el tamaño de la pila de la aplicación es demasiado pequeño para ejecutar el verbo. Aumente el tamaño de pila de la aplicación.

    AP_CONV_BUSY
    Código de retorno principal; solo puede haber un verbo de conversación pendiente a la vez en cualquier conversación. Esto puede ocurrir si el TP local tiene varios subprocesos y más de un subproceso emite llamadas APPC con la misma conv_id.

    AP_UNEXPECTED_DOS_ERROR
    Código de retorno principal; el sistema operativo devolvió un error a APPC al procesar una llamada de APPC desde el TP local. El código de retorno del sistema operativo se devuelve a través de secondary_rc. Aparece en el orden de intercambio de bytes de Intel. Si el problema persiste, consulte con el administrador del sistema.

    AP_DEALLOC_ABEND_PROG
    Código de retorno principal; la conversación se ha desasignado por uno de los siguientes motivos:

  • El TP del asociado ha emitido DEALLOCATE con dealloc_type establecido en AP_ABEND_PROG.

  • El TP del asociado ha encontrado un ABEND, lo que hace que la LU del asociado envíe una solicitud DEALLOCATE .

    AP_DEALLOC_ABEND_SVC
    Código de retorno principal; la conversación se ha desasignado porque el TP del asociado emitió DEALLOCATE con dealloc_type establecido en AP_ABEND_SVC.

    AP_DEALLOC_ABEND_TIMER
    Código de retorno principal; la conversación se ha desasignado porque el TP del asociado emitió DEALLOCATE con dealloc_type establecido en AP_ABEND_TIMER.

    AP_SVC_ERROR_NO_TRUNC
    Código de retorno principal; mientras que en estado SEND, el TP de asociado (o LU del asociado) emitió SEND_ERROR con err_type establecido en AP_SVC. Los datos no se han truncado.

    AP_SVC_ERROR_PURGING
    Código de retorno principal; el TP de asociado (o LU del asociado) emitido SEND_ERROR con err_type establecido en AP_SVC mientras se encuentra en RECEIVE, PENDING_POST, CONFIRM, CONFIRM_SEND o CONFIRM_DEALLOCATE estado. Es posible que se hayan purgado los datos enviados al TP del asociado.

    AP_SVC_ERROR_TRUNC
    Código de retorno principal; en el estado SEND, después de enviar un registro lógico incompleto, el TP de asociado (o LU del asociado) emitió SEND_ERROR. El TP local puede haber recibido la primera parte del registro lógico.

Comentarios

El TP local recibe datos a través del siguiente proceso:

  1. El TP local emite un verbo de recepción hasta que termina de recibir una unidad completa de datos. Los datos recibidos pueden ser:

    • Un registro lógico.

    • Un búfer de datos recibidos independientemente de su formato de registro lógico.

      Es posible que el TP local tenga que emitir el verbo de recepción varias veces para recibir una unidad completa de datos. Una vez recibida una unidad completa de datos, el TP local puede manipularlos.

      Los verbos de recepción son RECEIVE_AND_POST, RECEIVE_AND_WAIT y RECEIVE_IMMEDIATE.

  2. El TP local emite de nuevo el verbo receive. Esto tiene uno de los siguientes efectos:

    • Si el TP del asociado ha enviado más datos, el TP local comienza a recibir una nueva unidad de datos.

    • Si el TP del asociado ha terminado de enviar datos o está esperando confirmación, la información de estado (disponible a través de what_rcvd) indica la siguiente acción que normalmente realiza el TP local.

    La conversación debe estar en estado RECEIVE cuando el TP emite este verbo.

    El nuevo estado viene determinado por primary_rc. Si primary_rc es AP_OK , el nuevo estado viene determinado por what_rcvd.

    En la tabla siguiente se detallan los cambios de estado cuando se AP_OK el primary_rc .

what_rcvd Nuevo estado
AP_CONFIRM_DEALLOCATE CONFIRM_DEALLOCATE
AP_DATA_COMPLETE_CONFIRM_DEALL CONFIRM_DEALLOCATE
AP_DATA_CONFIRM_DEALLOCATE CONFIRM_DEALLOCATE
AP_CONFIRM_SEND CONFIRM_SEND
AP_DATA_COMPLETE_CONFIRM_SEND CONFIRM_SEND
AP_DATA_CONFIRM_SEND CONFIRM_SEND
AP_CONFIRM_WHAT_RECEIVED CONFIRMAR
AP_DATA_COMPLETE_CONFIRM CONFIRMAR
AP_DATA_CONFIRM CONFIRMAR
AP_DATA Sin cambios
AP_DATA_COMPLETE Sin cambios
AP_DATA_INCOMPLETE Sin cambios
AP_SEND ENVIAR
AP_DATA_COMPLETE_SEND SEND_PENDING

En la tabla siguiente se detallan los cambios de estado cuando el primary_rc no está AP_OK.

primary_rc Nuevo estado
AP_ALLOCATION_ERROR RESET
AP_CONV_FAILURE_RETRY RESET
AP_CONV_FAILURE_NO_RETRY RESET
AP_DEALLOC_ABEND RESET
AP_DEALLOC_ABEND_PROG RESET
AP_DEALLOC_ABEND_SVC RESET
AP_DEALLOC_ABEND_TIMER RESET
AP_DEALLOC_NORMAL RESET
AP_PROG_ERROR_PURGING Sin cambios
AP_PROG_ERROR_NO_TRUNC Sin cambios
AP_SVC_ERROR_PURGING Sin cambios
AP_SVC_ERROR_NO_TRUNC Sin cambios
AP_PROG_ERROR_TRUNC Sin cambios
AP_SVC_ERROR_TRUNC Sin cambios
AP_UNSUCCESSFUL Sin cambios

RECEIVE IMMEDIATE End of Data

En conversaciones básicas, si el TP local emite RECEIVE_IMMEDIATE y establece rellenar en AP_BUFFER, la recepción de los datos finaliza cuando se alcanza max_len o el final de los datos. El final de los datos se indica mediante:

  • Parámetro primary_rc con un valor distinto de AP_OK (por ejemplo, AP_DEALLOC_NORMAL).

  • Un parámetro what_rcvd con uno de los siguientes valores:

    AP_SEND

    AP_CONFIRM_SEND

    AP_CONFIRM_DEALLOCATE

    AP_CONFIRM_WHAT_RECEIVED

    AP_DATA_CONFIRM_SEND

    AP_DATA_CONFIRM_DEALLOCATE

    AP_DATA_CONFIRM

    Para determinar si se ha alcanzado el final de los datos, el TP local vuelve a emitir RECEIVE_IMMEDIATE. Si el nuevo parámetro primary_rc contiene AP_OK y what_rcvd contiene AP_DATA, no se ha alcanzado el final de los datos. Sin embargo, si se ha alcanzado el final de los datos, primary_rc o what_rcvd indicarán la causa del final de los datos.