MC_FLUSH

El verbo MC_FLUSH envía el contenido del búfer de envío de la unidad lógica local (LU) al lu del asociado y al programa de transacciones (TP). Si el búfer de envío está vacío, no se realiza ninguna acción.

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

Sintaxis

  
struct mc_flush {  
    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;  
};   

Miembros

Opcode
Parámetro proporcionado. Especifica el código de operación de verbo, AP_M_FLUSH.

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

reserv2
Un campo reservado.

primary_rc
Parámetro devuelto. Especifica el código de retorno principal establecido por APPC al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo APPC emitido. Consulte Códigos de retorno para obtener códigos de error válidos para este verbo.

secondary_rc
Parámetro devuelto. Especifica el código de retorno secundario establecido por APPC al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo APPC emitido. Consulte Códigos de retorno para obtener 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 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 RECEIVE_ALLOCATE en el TP invocado.

Códigos de retorno

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

AP_PARAMETER_CHECK
Código de retorno principal; el verbo no se ejecutó debido a un error de 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 tp asignado por APPC.

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

AP_FLUSH_NOT_SEND_STATE

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

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

• El nodo usado por esta conversación encontró un ABEND.

• La conexión entre el TP y el nodo PU 2.1 se ha interrumpido (error laN).

• SnaBase en el equipo del TP encontró un ABEND.

  El administrador del sistema debe examinar el registro de errores para determinar el motivo del ABEND.

  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 VCB se extendió más allá del final del segmento de datos.

  AP_STACK_TOO_SMALL
  Código de retorno principal; el tamaño de pila de la aplicación es demasiado pequeño para ejecutar el verbo. Aumente el tamaño de la 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 el mismo conv_id.

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

Observaciones

Los datos procesados por MC_SEND_DATA se acumulan en el búfer de envío de la LU local hasta que se produzca una de las siguientes acciones:

• El TP local emite MC_FLUSH (u otro verbo que vacía el búfer de envío de la LU).

• El búfer está lleno.

  La solicitud generada por MC_ALLOCATE también se almacena en búfer.

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

  No hay ningún cambio de estado.