Riepilogo verbo APPC

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

Verbi per l'avvio di conversazioni

ALLOCAREo MC_ALLOCATE
Emesso 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 l'allocazione della 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 il tp locale è in corso. 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'unità lu locale, inviando il contenuto del buffer all'unità 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 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 l'invio dei 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 si riempie.

• Il tp locale rilascia FLUSH, MC_FLUSH, CONFIRM, MC_CONFIRM, DEALLOCATE, MC_DEALLOCATE o un altro verbo che scarica il buffer di invio dell'UNITÀ 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'unità 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 emette questo verbo, APPC restituisce immediatamente il controllo al tp. Quando vengono soddisfatte le condizioni specificate, viene segnalato l'evento Win32® specificato come parametro 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'unità lu locale ed emette un verbo RECEIVE_IMMEDIATE o RECEIVE_AND_WAIT per ricevere effettivamente i dati o la notifica sullo 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 arrivano ancora all'unità lu locale.

L'emissione di questo verbo mentre la conversazione è in stato SEND scarica il buffer di invio dell'unità di elaborazione 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 è nello stato RECEIVE fa sì che il tp locale riceva tutti i dati attualmente disponibili dal partner TP. 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'unità di elaborazione 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 MC_REQUEST_TO_SEND o una notifica.

Verbi per la conferma dei dati o la segnalazione di 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 nel buffer. APPC continua a usare questo buffer man mano che arrivano FMH7 successivi fino a quando non viene fornito con un altro buffer (ovvero fino a quando 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 chiamata, 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 particolare lu remoto.

GET_STATE
Usato 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 TP può decidere se emettere verbi di conversazione di base o mappati.

SET_TP_PROPERTIES
Utilizzato per 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 usando 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 TP locali e partner. Notifica all'APPC che il tp sta terminando. L'emissione di questo verbo termina anche qualsiasi conversazione attiva.