Riepilogo verbo APPC

Questa sezione descrive brevemente ogni verbo APPC, raggruppato per funzione.

Verbi per l'avvio di conversazioni

ALLOCAREo MC_ALLOCATE
Rilasciato dal programma di transazione locale (TP). Questo verbo alloca una sessione tra l'unità logica locale (LU) e un lu partner e stabilisce una conversazione tra il tp locale e il tp del partner.

ALLOCATE può stabilire una conversazione di base o mappata. MC_ALLOCATE può avviare solo una conversazione mappata. Dopo aver allocato la conversazione, APPC usa questo verbo per restituire un identificatore di conversazione (conv_id).

RECEIVE_ALLOCATE
Rilasciato dal partner TP. Questo verbo conferma che il tp del partner è pronto per iniziare una conversazione con il tp locale che ha emesso ALLOCATE o MC_ALLOCATE. Al termine dell'esecuzione, questo verbo restituisce un identificatore tp (tp_id) per il tp partner e il conv_id.

TP_STARTED
Rilasciato dal tp locale. Questo verbo notifica all'APPC che viene avviato il tp locale. Al termine dell'esecuzione, questo verbo restituisce un tp_id per il tp locale.

Verbi per l'invio di dati

CONFIRMo MC_CONFIRM
Invia il contenuto del buffer di invio dell'lu locale e una richiesta di conferma al tp del partner.

FLUSHo MC_FLUSH
Scarica il buffer di invio dell'lu locale, inviando il contenuto del buffer all'lu partner e al tp. Se il buffer di invio è vuoto, non viene eseguita alcuna azione.

PREPARE_TO_RECEIVEo MC_PREPARE_TO_RECEIVE
Modifica lo stato della conversazione da SEND a RECEIVE. Prima di modificare lo stato della conversazione, questo verbo esegue l'equivalente di FLUSH, MC_FLUSH, CONFIRM o MC_CONFIRM. Dopo l'esecuzione di questo verbo, il tp locale può ricevere i dati.

REQUEST_TO_SENDo MC_REQUEST_TO_SEND
Informa il partner TP che il tp locale vuole inviare i dati. Il tp locale deve attendere fino a quando il tp del partner non rilascia PREPARE_TO_RECEIVE, MC_PREPARE_TO_RECEIVE, RECEIVE_AND_WAIT o MC_RECEIVE_AND_WAIT e lo stato della conversazione cambia in RECEIVE per il tp del partner, prima che il tp locale inizi a inviare i dati.

SEND_DATAo MC_SEND_DATA
Inserisce i dati nel buffer di invio dell'unità lu locale per la trasmissione al tp del partner.

I dati raccolti nel buffer di invio dell'lu locale vengono trasmessi al partner LU e al partner TP quando si verifica una delle condizioni seguenti:

• Il buffer di invio viene riempito.

• Il tp locale rilascia FLUSH, MC_FLUSH, CONFIRM, MC_CONFIRM, DEALLOCATE, MC_DEALLOCATE o un altro verbo che scarica il buffer di invio dell'lu locale.

Verbi per la ricezione di dati

POST_ON_RECEIPT o MC_POST_ON_RECEIPT
L'emissione di questo verbo consente all'applicazione di ricevere una notifica quando i dati o lo stato arrivano all'lu locale senza riceverlo contemporaneamente. Questo verbo può essere emesso solo quando è in stato RECEIVE e non causa mai una modifica dello stato della conversazione.

Quando il tp rilascia questo verbo, APPC restituisce immediatamente il controllo al tp. Quando vengono soddisfatte le condizioni specificate, l'evento Win32® specificato come parametro viene segnalato e il verbo viene completato. Il tp esamina quindi il codice restituito nel blocco di controllo verbo per determinare se i dati o le notifiche sullo stato sono arrivati all'lu locale e genera un RECEIVE_IMMEDIATE o un verbo RECEIVE_AND_WAIT per ricevere effettivamente i dati o la notifica dello stato.

RECEIVE_AND_POSTo MC_RECEIVE_AND_POST
L'emissione di questo verbo mentre la conversazione è in stato RECEIVE modifica lo stato della conversazione in PENDING_POST e fa sì che il tp locale riceva i dati in modo asincrono. Ciò consente al tp locale di procedere con l'elaborazione mentre i dati vengono ancora arrivati all'unità lu locale.

L'emissione di questo verbo mentre la conversazione è in stato SEND scarica il buffer di invio del lu e modifica lo stato della conversazione in PENDING_POST. Il tp locale inizia quindi a ricevere i dati in modo asincrono.

RECEIVE_AND_WAITo MC_RECEIVE_AND_WAIT
L'emissione di questo verbo mentre la conversazione è in stato RECEIVE fa sì che il tp locale riceva tutti i dati attualmente disponibili dal tp del partner. Se non sono disponibili dati, il tp locale attende l'arrivo dei dati.

L'emissione di questo verbo mentre la conversazione è in stato SEND scarica il buffer di invio dell'lu e modifica lo stato della conversazione in RECEIVE. Il tp locale inizia quindi a ricevere i dati.

RECEIVE_IMMEDIATEo MC_RECEIVE_IMMEDIATE
Riceve tutti i dati attualmente disponibili dal tp del partner. Se non sono disponibili dati, il tp locale non attende.

TEST_RTSo MC_TEST_RTS
Determina se è stata ricevuta una REQUEST_TO_SEND o un MC_REQUEST_TO_SEND o una notifica.

Verbi per confermare i dati o segnalare errori

CONFERMATOo MC_CONFIRMED
Risponde a una richiesta di conferma dal tp del partner. Informa il partner TP che il tp locale ha ricevuto ed elaborato i dati senza errori.

RECEIVE_LOG_DATAo MC_RECEIVE_LOG_DATA
L'emissione di questo verbo consente all'utente di registrarsi per ricevere i dati di log associati a un report di errore dell'intestazione di gestione delle funzioni in ingresso 7 (FMH7). Il verbo passa un buffer ad APPC e tutti i dati di log ricevuti vengono inseriti in tale buffer. APPC continua a usare questo buffer man mano che arrivano FMH7 successivi fino a quando non viene fornito con un altro buffer( ovvero finché il tp non rilascia un altro RECEIVE_LOG_DATA o MC_RECEIVE_LOG_DATA specificando un buffer diverso o nessun buffer.

SEND_CONVERSATIONo MC_SEND_CONVERSATION
Rilasciato dal tp di richiamo, questo verbo alloca una sessione tra lu locale e lu partner, invia i dati nella sessione e quindi dealloca la sessione.

SEND_ERRORo MC_SEND_ERROR
Notifica al partner TP che il tp locale ha rilevato un errore a livello di applicazione.

Verbi per ottenere e impostare informazioni

GET_ATTRIBUTESo MC_GET_ATTRIBUTES
Usato da un tp per ottenere gli attributi della conversazione.

GET_LU_STATUS
Usato per segnalare lo stato di un'unità lu remota specifica.

GET_STATE
Utilizzato da un tp per interrogare lo stato di una conversazione specifica.

GET_TP_PROPERTIES
Restituisce gli attributi del tp e della transazione corrente.

GET_TYPE
Usato da un tp per determinare il tipo di conversazione (di base o mappato) di una conversazione specifica. Con queste informazioni, il tps può decidere se emettere verbi di conversazione di base o mappati.

SET_TP_PROPERTIES
Consente di impostare gli attributi del tp e della transazione corrente.

Verbi che forniscono funzioni di gestione

ACTIVATE_SESSION
Attiva una sessione tra l'lu locale e un lu partner specificato, utilizzando una modalità specificata.

CNOS(Modifica numero di sessioni)
Stabilisce i limiti di sessione APPC LU 6.2.

DEACTIVATE_SESSION
Disattiva una determinata sessione o tutte le sessioni in una determinata modalità.

VISUALIZZAZIONE
Restituisce le informazioni di configurazione e i valori operativi correnti per il nodo SNA.

Verbi per le conversazioni finali

DEALLOCATEo MC_DEALLOCATE
Dealloca una conversazione tra due TP. Prima di deallocare la conversazione, questo verbo esegue l'equivalente di FLUSH, MC_FLUSH, CONFIRM o MC_CONFIRM.

TP_ENDED
Rilasciato dai provider di servizi di transazione locali e partner. Notifica all'APPC che il TP termina. L'emissione di questo verbo termina anche tutte le conversazioni attive.