Codici di errore e completamento API

Per ogni chiamata, un codice di completamento e un codice motivo vengono restituiti dal gestore code o da una routine di uscita, per indicare l'esito positivo o negativo della chiamata.

Per ulteriori informazioni sull'API IBM® MQ , vedi Developing applicationse le informazioni di riferimento in Developing applications reference.

Codici di completamento API

Di seguito è riportato un elenco dei codici di completamento (MQCC) restituiti da IBM MQ
0: Completamento riuscito (MQCC_OK)

La chiamata è stata completata completamente; tutti i parametri di output sono stati impostati.

Il parametro Reason ha sempre il valore MQRC_NONE in questo caso.

1: Avvertenza (completamento parziale) (MQCC_WARNING)

La chiamata è stata completata parzialmente. Alcuni parametri di output potrebbero essere stati impostati in aggiunta ai parametri di output CompCode e Reason .

Il parametro Reason fornisce ulteriori informazioni.

2: Chiamata non riuscita (MQCC_FAILED)

L'elaborazione della chiamata non è stata completata e lo stato del gestore code è di norma invariato; le eccezioni sono riportate in modo specifico. Sono stati impostati solo i parametri di output CompCode e Reason ; tutti gli altri parametri non vengono modificati.

Il motivo potrebbe essere un errore nel programma applicativo oppure potrebbe essere il risultato di una situazione esterna al programma, ad esempio l'autorizzazione dell'applicazione potrebbe essere stata revocata. Il parametro Reason fornisce ulteriori informazioni.

Codici di errore API

Il parametro del codice di errore (Reason) è una qualifica del parametro del codice di completamento (CompCode).

Se non vi è alcun motivo speciale per eseguire il report, viene restituito MQRC_NONE. Una chiamata eseguita correttamente restituisce MQCC_OK e MQRC_NONE.

Se il codice di completamento è MQCC_WARNING o MQCC_FAILED, il gestore code riporta sempre un motivo valido; i dettagli vengono forniti sotto ogni descrizione della chiamata.

Quando le routine di uscita utente impostano codici di completamento e motivi, devono rispettare queste regole. Inoltre, i valori dei motivi speciali definiti dalle uscite utente devono essere inferiori a zero, per garantire che non siano in conflitto con i valori definiti dal gestore code. Le uscite possono impostare i motivi già definiti dal gestore code, dove sono appropriati.

I codici di errore si verificano anche in:
  • Il campo Reason della struttura MQDLH.
  • Il campo Feedback della struttura di MQMD
Ogni codice di errore nella sua interezza è supportato su tutte le piattaforme supportate da IBM MQ , a meno che non vi sia:
  • Sono presenti una o più icone della piattaforma all'inizio di un codice di errore, nel qual caso il codice di errore si applica solo a quelle piattaforme visualizzate.
  • È un'icona della piattaforma visualizzata rispetto a una specifica istruzione, nel qual caso tale istruzione si applica solo a quella piattaforma.
Consultare Icone della piattaforma per una descrizione delle icone.
Gli argomenti secondari sono una serie di codici di errore, in ordine numerico, che forniscono informazioni dettagliate che consentono di comprenderli, tra cui:
  • una spiegazione delle circostanze che hanno causato la creazione del codice
  • il codice di completamento associato
  • azioni programmatori suggerite in risposta al codice