Configurazione uscite API
Un'uscita API è un modulo di codice, un file .dll, che viene fornito dall'utente e viene eseguito immediatamente prima o dopo le chiamate MQI.
Informazioni su questa attività
Quando IBM® MQ riceve una chiamata da un programma a uno dei suoi punti di ingresso API, IBM MQ richiama l'uscita API. L'uscita API viene eseguita prima o dopo l'esecuzione di MQI, in base a come è stata configurata l'uscita.
È possibile configurare una o più uscite (o anche nessuna) da richiamare ed è possibile configurare anche la sequenza in cui verranno richiamate. Su Windows e Linux® (piattaforme x86 e x86-64), è possibile configurare le uscite API utilizzando IBM MQ Explorer. I dettagli di configurazione vengono memorizzati nei file .ini.
- Configurare un'uscita API in IBM MQ Explorer.
- Sovrascrivere un'uscita API comune con un'uscita API locale.
Esistono tre tipi di definizioni di uscite API:
- Comune (ApiExitCommon)
- Una serie di definizioni per computer. Quando viene avviato il gestore code, le uscite API definite, se presenti, vengono lette e applicate al gestore code. Configurare le uscite API comuni nella finestra di dialogo delle proprietà di IBM MQ. Le uscite comuni sono visualizzate nella tabella Uscite API locali nella finestra delle proprietà di ciascun gestore code locale.
- Modello (ApiExitTemplate)
- Una serie di definizioni per computer. Quando viene creato un gestore code, le uscite API definite, se presenti, vengono copiate sul gestore code appena creato come uscite locali. Configurare le uscite API modello nella finestra di dialogo delle proprietà di IBM MQ.
- Locali (ApiExitLocal)
- Una serie di definizioni per gestore code. Quando viene avviato il gestore code, le eventuali uscite API definite sovrascrivono le uscite comuni se gli attributi Nome sono gli stessi e se è stata specificata l'opzione di sovrascrittura. Quando un'uscita API comune viene sovrascritta, nessuno dei campi nella definizione comune viene salvato, anche se all'attributo facoltativo Dati è stato assegnato un valore. Configurare le uscite API locali nella finestra delle proprietà del gestore code.
Quando si configurano le uscite API nelle finestre di dialogo delle proprietà IBM MQ e del gestore code, i valori degli attributi vengono aggiunti alle stanze ApiExitCommon, ApiExitTemplate e ApiExitLocal nei file di configurazione o nel registro Windows.
Attributo | Significato | Chiave stanza |
---|---|---|
Nome | Specifica il nome descrittivo dell'uscita API inviato all'uscita API nel campo ExitInfoName della struttura MQAXP. Questo nome deve essere univoco, ha una lunghezza massima di 48 caratteri e deve contenere solo i caratteri validi per il nome degli oggetti IBM MQ, quali i nomi coda. | Nome |
Tipo | Specifica il tipo di uscita: common , template , local o override . |
(Non una chiave della stanza separata) |
Sequenza | Questo attributo è un valore numerico non formato che definisce la sequenza con cui questa uscita API è chiamata a confronto con le altre uscite API. Un'uscita API con un numero di sequenza basso viene richiamata prima di un'uscita con un numero di sequenza maggiore. L'ordine in cui le diverse uscite API con lo stesso numero di sequenza vengono richiamate non è definito. Questo è il valore perfetto per cui esistono dei divari nei numero di sequenza delle uscite API definite per un gestore code. | Sequenza |
Modulo | Specifica il modulo che contiene il codice per l'uscita API. Se questo campo contiene il percorso completo del modulo, questo verrà visualizzato così come è. Se questo campo contiene solo il nome del modulo, il modulo viene individuato utilizzando lo stesso metodo delle uscite dei canali, ovvero utilizzando il valore nel campo Percorso predefinito uscita nella pagina Uscite della finestra delle proprietà del gestore code. | Modulo |
Funzione | Specifica il punto di ingresso della funzione nel modulo che contiene il codice per l'uscita API. Questo punto di ingresso è la funzione MQ_INIT_EXIT. La lunghezza di questo campo è limitata a MQ_EXIT_NAME_LENGTH. | Funzione |
Dati | Se viene specificato questo attributo, gli spazi all'inizio e alla fine della riga vengono rimossi, la stringa rimanente viene troncata a 32 caratteri e il risultato viene inviato all'uscita nel campo ExitData della struttura MQAXP. Se invece l'attributo non viene specificato, il valore predefinito di 32 caratteri viene inviato all'uscita nel campo ExitData della struttura MQAXP. | Dati |