SCIACQUONE

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

La struttura seguente descrive il blocco di controllo verbo (VCB) usato dal verbo FLUSH .

Sintassi

  
struct 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_B_FLUSH.

opext
Parametro fornito. Specifica l'estensione dell'operazione verba, AP_BASIC_CONVERSATION.

reserv2
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 rilasciato. Per questo verbo, vedere Codici restituiti per i 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 rilasciato. Per questo verbo, vedere Codici restituiti per i codici di errore validi.

Tp_id
Parametro fornito. Identifica il TP locale. Il valore di questo parametro viene restituito da TP_STARTED nella chiamata 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 ALLOCATE nella chiamata 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 rilasciato 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 rilasciato verbi di conversazione di base e mappati. È possibile rilasciare un solo tipo in una singola conversazione.

  AP_INVALID_VERB_SEGMENT
  Codice restituito primario; VCB esteso 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; c'è solo un verbo di conversazione in sospeso alla volta su qualsiasi conversazione. Ciò può verificarsi se il TP locale ha più thread e più thread eseguono chiamate APPC usando la stessa conv_id.

  AP_UNEXPECTED_DOS_ERROR
  Codice restituito primario; il sistema operativo ha restituito un errore all'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 di byte Intel. Se il problema persiste, consultare l'amministratore di sistema.

Commenti

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

• I problemi TP locali SCARICAno (o altri verbi che scaricano il buffer di invio dell'LU).

• Il buffer è pieno.

  La richiesta generata da ALLOCATE viene inoltre memorizzata nel buffer.

  La conversazione deve essere in stato SEND quando il TP emette questo verbo.

  Non esiste alcuna modifica dello stato.