MC_SEND_DATA

Artículo
07/21/2023

El MC_SEND_DATA verbo coloca los datos en el búfer de envío (LU) de la unidad lógica local para la transmisión al programa de transacciones de asociado (TP).

En la estructura siguiente se describe el bloque de control de verbos (VCB) usado por el verbo MC_SEND_DATA .

Sintaxis

  
struct mc_send_data {  
    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 char       rts_rcvd;  
    unsigned char       data_type;  
    unsigned short int  dlen;  
    unsigned char FAR * dptr ;  
    unsigned char       type;  
    unsigned char       reserv4;  
};

Miembros

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

opext
Parámetro proporcionado. Especifica la extensión de operación de verbo, AP_MAPPED_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.

El valor de este parámetro lo devuelve MC_ALLOCATE en el TP invocado o por RECEIVE_ALLOCATE en el TP invocado.

rts_rcvd
Parámetro devuelto. Proporciona el indicador de solicitud a envío recibido.

AP_YES indica que el TP del asociado ha emitido MC_REQUEST_TO_SEND, que solicita que el TP local cambie la conversación al estado RECEIVE. Para cambiar al estado RECEIVE, el TP local puede usar MC_PREPARE_TO_RECEIVE, MC_RECEIVE_AND_WAIT o MC_RECEIVE_AND_POST.
AP_NO indica que el TP del asociado no ha emitido MC_REQUEST_TO_SEND.

data_type
Parámetro proporcionado. Especifica el tipo de datos que se enviarán si se admite el punto de sincronización. Los parámetros válidos son:

AP_APPLICATION

AP_USER_CONTROL_DATA

AP_PS_HEADER

dlen
Parámetro proporcionado. Especifica el número de bytes de datos que se van a colocar en el búfer de envío de la LU local. El intervalo va de 0 a 65535.

dptr
Parámetro proporcionado. Especifica la dirección del búfer que contiene los datos que se van a colocar en el búfer de envío de la LU 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 ajustarse completamente dentro de esta área.

type
Parámetro proporcionado. Permite que un TP envíe datos y realice otras funciones dentro de una llamada API. Por ejemplo, puede combinar MC_SEND_DATA con el tipo establecido en CONFIRM para lograr el mismo objetivo que emitir MC_SEND_DATA seguido de MC_CONFIRM.
AP_SEND_DATA_CONFIRM corresponde a MC_SEND_DATA seguido de MC_CONFIRM.
AP_SEND_DATA_FLUSH corresponde a MC_SEND_DATA seguido de MC_FLUSH.
AP_SEND_DATA_DEALLOC_ABEND corresponde a MC_SEND_DATA seguido de MC_DEALLOCATE con un dealloc_type de AP_ABEND.
AP_SEND_DATA_DEALLOC_FLUSH corresponde a MC_SEND_DATA seguido de MC_DEALLOCATE con un dealloc_type de AP_FLUSH.
AP_SEND_DATA_DEALLOC_SYNC_LEVEL corresponde a MC_SEND_DATA seguido de MC_DEALLOCATE con un dealloc_type de AP_SYNC_LEVEL.
AP_SEND_DATA_P_TO_R_FLUSH corresponde a MC_SEND_DATA seguido de MC_PREPARE_TO_RECEIVE con un ptr_type de AP_FLUSH.
AP_SEND_DATA_P_TO_R_SYNC_LEVEL corresponde a MC_SEND_DATA seguido de MC_PREPARE_TO_RECEIVE con un ptr_type de AP_SYNC_LEVEL y bloqueos establecidos en AP_SHORT.

Códigos de retorno

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

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_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_SEND_DATA_INVALID_TYPE

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

AP_SEND_DATA_CONFIRM_SYNC_NONE

Código de retorno secundario; el tipo CONFIRM no está permitido para una conversación que se asignó con una sync_level de NONE.

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

AP_SEND_DATA_NOT_SEND_STATE

Código de retorno secundario; el TP local emitido MC_SEND_DATA, pero la conversación no estaba en estado SEND.

AP_ALLOCATION_ERROR
Código de retorno principal; 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 MC_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; El LU del asociado 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 MC_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 de MC_ALLOCATE .

Cuando MC_ALLOCATE genera este código de retorno para un sistema cliente de Microsoft 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_PURGING
Código de retorno principal; mientras que en ESTADO RECEIVE, PENDING, PENDING_POST, CONFIRM, CONFIRM_SEND o CONFIRM_DEALLOCATE, el TP de asociado emitió MC_SEND_ERROR. Los datos enviados pero aún no recibidos se purgan.

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_THREAD_BLOCKING
Código de retorno principal; el subproceso que llama ya está en una llamada de bloqueo.

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
Código de retorno principal; la conversación se ha desasignado por uno de los siguientes motivos:
El TP de asociado emitido MC_DEALLOCATE con dealloc_type establecido en AP_ABEND.
El TP del asociado encontró un ABEND, lo que hace que la LU del asociado envíe una solicitud de MC_DEALLOCATE .

Comentarios

La conversación debe estar en estado SEND cuando el TP emite este verbo. Los cambios de estado, basados en primary_rc, se resumen en la tabla siguiente.

primary_rc	Nuevo estado
AP_OK	Sin cambios
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_PROG_ERROR_PURGING	RECEIVE
AP_SVC_ERROR_PURGING	RECEIVE

MC_SEND_DATA puede esperar indefinidamente porque el TP del asociado no ha emitido un verbo de recepción. Si esto ocurre, el búfer de envío puede rellenarse.

Los datos recopilados en el búfer de envío de la LU local se transmiten a la LU del asociado (y el TP del asociado) cuando se produce una de las siguientes acciones:

El búfer de envío se rellena.
Los problemas de TP locales MC_FLUSH, MC_CONFIRM o MC_DEALLOCATE (u otro verbo que vacía el búfer de envío de la LU).

Compartir a través de

MC_SEND_DATA

Sintaxis

Miembros

Códigos de retorno

Comentarios

Recursos adicionales