MC_FLUSH

Il verbo MC_FLUSH invia il contenuto del buffer di invio dell'unità logica locale al lu partner e al programma di transazione (TP). Se il buffer di invio è vuoto, non viene eseguita alcuna azione.

Nella struttura seguente viene descritto il blocco di controllo verbo (VCB) utilizzato dal verbo MC_FLUSH .

Sintassi

  
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;  
};   

Members

Opcode
Parametro fornito. Specifica il codice dell'operazione verbo AP_M_FLUSH.

opext
Parametro fornito. Specifica l'estensione dell'operazione verbo AP_MAPPED_CONVERSATION.

reserv2
Un campo riservato.

Primary_rc
Parametro restituito. Specifica il codice restituito primario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC emesso. Per questo verbo, vedere Codici restituiti per codici di errore validi.

Secondary_rc
Parametro restituito. Specifica il codice restituito secondario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC emesso. Per questo verbo, vedere Codici restituiti per codici di errore validi.

Tp_id
Parametro fornito. Identifica il tp locale. Il valore di questo parametro viene restituito da TP_STARTED nella chiamata di TP o da RECEIVE_ALLOCATE nel tp richiamato.

Conv_id
Parametro fornito. Fornisce l'identificatore della conversazione. Il valore di questo parametro viene restituito da MC_ALLOCATE nella chiamata di TP o da RECEIVE_ALLOCATE nel tp richiamato.

Codici restituiti

AP_OK
Codice restituito primario; il verbo eseguito correttamente.

AP_PARAMETER_CHECK
Codice restituito primario; il verbo non è stato eseguito a causa di un errore di parametro.

AP_BAD_CONV_ID

Codice restituito secondario; il valore di conv_id non corrisponde a un identificatore di conversazione assegnato da APPC.

AP_BAD_TP_ID

Codice restituito secondario; il valore di tp_id non corrisponde a un identificatore TP assegnato da APPC.

AP_STATE_CHECK
Codice restituito primario; il verbo non è stato eseguito perché è stato emesso in uno stato non valido.

AP_FLUSH_NOT_SEND_STATE

Codice restituito secondario; la conversazione non era in stato SEND.

AP_COMM_SUBSYSTEM_ABENDED
Codice restituito primario; indica una delle condizioni seguenti:

• Il nodo usato da questa conversazione ha rilevato un ABEND.

• La connessione tra il tp e il nodo pu 2.1 è stata interrotta (errore LAN).

• SnaBase nel computer tp ha rilevato un ABEND.

  L'amministratore di sistema deve esaminare il log degli errori per determinare il motivo di ABEND.

  AP_CONVERSATION_TYPE_MIXED
  Codice restituito primario; il tp ha emesso verbi di conversazione di base e mappati. È possibile emettere un solo tipo in una singola conversazione.

  AP_INVALID_VERB_SEGMENT
  Codice restituito primario; VCB si estende oltre la fine del segmento di dati.

  AP_STACK_TOO_SMALL
  Codice restituito primario; le dimensioni dello stack dell'applicazione sono troppo piccole per eseguire il verbo. Aumentare le dimensioni dello stack dell'applicazione.

  AP_CONV_BUSY
  Codice restituito primario; può essere presente un solo verbo di conversazione in sospeso alla volta in qualsiasi conversazione. Ciò può verificarsi se il tp locale ha più thread e più thread eseguono chiamate APPC usando lo stesso conv_id.

  AP_UNEXPECTED_DOS_ERROR
  Codice restituito primario; il sistema operativo ha restituito un errore ad APPC durante l'elaborazione di una chiamata APPC dal tp locale. Il codice restituito dal sistema operativo viene restituito tramite il secondary_rc. Viene visualizzato nell'ordine di scambio dei byte Intel. Se il problema persiste, consultare l'amministratore di sistema.

Commenti

I dati elaborati da MC_SEND_DATA si accumulano nel buffer di invio dell'unità lu locale fino a quando non si verifica una delle operazioni seguenti:

• Il tp locale rilascia MC_FLUSH (o un altro verbo che scarica il buffer di invio dell'unità lu).

• Il buffer è pieno.

  Anche la richiesta generata da MC_ALLOCATE viene memorizzata nel buffer.

  La conversazione deve essere in stato SEND quando il tp rilascia questo verbo.

  Non esiste alcuna modifica dello stato.