TP_ENDED

Il verbo TP_ENDED viene emesso sia dal programma di transazione richiamato (TP) che avvisa l'APPC che il TP termina.

Per Microsoft® Windows® versione 3. x system, è consigliabile usare la funzione WinAsyncAPPC anziché la versione di blocco di questa chiamata.

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

Sintassi

  
struct tp_ended {  
    unsigned short  opcode;  
    unsigned char   opext;  
    unsigned char   reserv2;  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   tp_id[8];  
    unsigned char   type;  
};   

Members

Opcode
Parametro fornito. Specifica il codice dell'operazione verbo, AP_TP_ENDED.

opext
Parametro fornito. Specifica l'estensione dell'operazione verbo. Questo campo non viene usato dal verbo TP_ENDED .

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 è stato restituito da TP_STARTED nella chiamata TP o da RECEIVE_ALLOCATE nel TP richiamato.

type
Parametro fornito. Specifica il tipo di terminazione da eseguire. I valori seguenti sono consentiti:

• AP_HARD indica che tutti i verbi attivi per il TP vengono terminati; le sessioni usate dalle conversazioni vengono terminate. Sia il TP locale che il TP partner possono ricevere codici restituiti di errore di conversazione (AP_DEALLOC_ABEND per conversazioni mappate e AP_DEALLOC_ABEND_PROG per conversazioni di base).

• AP_SOFT indica che il TP attende il completamento di tutti i verbi attivi; la sessione usata dalla conversazione rimane attiva.

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_TP_ID

Codice restituito secondario; APPC non riconosceva la tp_id come identificatore TP assegnato.

AP_BAD_TYPE

Codice restituito secondario; il valore del tipo specificato non è stato riconosciuto da APPC.

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_COMM_SUBSYSTEM_NOT_LOADED
  Codice restituito primario; Impossibile caricare o terminare un componente obbligatorio durante l'elaborazione del verbo. Pertanto, la comunicazione non poteva essere eseguita. Contattare l'amministratore di sistema per un'azione correttiva.

  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_TP_BUSY
  Codice restituito primario; il TP locale ha rilasciato una chiamata all'APPC mentre APPC stava elaborando un'altra chiamata per lo stesso TP. Ciò può verificarsi se il TP locale ha più thread e più thread eseguono chiamate APPC usando la stessa tp_id.

  AP_THREAD_BLOCKING
  Codice restituito primario; il thread chiamante è già in una chiamata di blocco.

  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

In risposta a TP_ENDED, APPC libera le risorse usate dal TP. Dopo l'esecuzione di questo verbo, l'identificatore TP non è più valido; il TP non può emettere altri verbi di conversazione APPC.

La conversazione può essere in qualsiasi stato quando il TP emette questo verbo.

Se la conversazione è in stato SEND, TP_ENDED esegue la funzione DEALLOCATE o MC_DEALLOCATE con dealloc_type impostata su AP_FLUSH .

Se la conversazione si trova in uno stato diverso da RESET o SEND, TP_ENDED esegue la funzione DEALLOCATEoMC_DEALLOCATE con dealloc_type impostata su AP_ABEND (per una conversazione mappata) o AP_ABEND_PROG (per una conversazione di base).

Dopo l'esecuzione riuscita (primary_rc è AP_OK), non esiste alcun stato APPC.