Come TI consente ai programmi di transazione di restituire eccezioni
TI fornisce un meccanismo di meta data per restituire eccezioni da applicazioni server di automazione come applicazioni TI. TI usa questo meccanismo per fornire allo sviluppatore mainframe un modo facoltativo per restituire informazioni sugli errori del mainframe (noti anche come dati di eccezione) tramite l'applicazione normale.
Un programma di transazione (TP) restituisce informazioni di errore come metadati facoltativi che includono un blocco di eccezioni come parte del messaggio di risposta. Il blocco di eccezioni contiene informazioni, in un formato standard, che può essere usato per popolare una struttura di eccezioni di Automazione.
I messaggi di errore TI hanno numeri nell'intervallo 0-9999. I numeri di messaggio di errore di meta dati restituiti dal mainframe possono rientrare nello stesso intervallo. Per distinguere i messaggi di errore TI dai messaggi di errore Meta restituiti dal mainframe, TI aggiunge 10000 al numero di qualsiasi messaggio di errore di meta data restituito dal mainframe.
Un TP può anche usare questo meccanismo per fornire informazioni sullo stato TP per l'ambiente di runtime TI. In particolare, un TP può indicare se il TP:
È disposto a eseguire il commit del lavoro eseguito finora (e deallocare la conversazione).
Non è possibile eseguire più operazioni sulla conversazione corrente e si prevede che il client possa preparare e eseguire il commit.
Si è verificato un errore che impedirà il commit della transazione.
Anche se è sempre possibile deallocare la conversazione bruscamente, le eccezioni TI consentono di restituire informazioni dettagliate sull'errore all'applicazione client chiamante.
TI usa le informazioni contenute nel blocco di eccezioni per aggiornare le informazioni sullo stato nell'ambiente di runtime TI e (se richiesto) restituiscono un'eccezione all'applicazione client.
Nella tabella seguente vengono illustrati i campi nella struttura di eccezioni EXCEPINFO.
| Campo | Descrizione |
|---|---|
| wCode | Il codice di errore restituito nel blocco di eccezioni. |
| bstrSource | Generato automaticamente da TI in base alle informazioni sull'oggetto del cliente e sul TP remoto. |
| bstrDescription | Dal blocco di eccezioni. Questa descrizione dell'errore proviene dal TP remoto. |
| bstrHelpFile | Formato prendendo il percorso della Guida associato alla libreria dei componenti dell'oggetto (nel Registro di sistema) e combinandolo con un nome di file non qualificato incluso come informazioni personalizzate nella libreria dei componenti. Ciò consente allo sviluppatore di identificare il nome del file della Guida durante la creazione, dando all'amministratore il controllo finale sulla posizione in cui è installato il file della Guida durante la distribuzione. |
| dwHelpContext | Dall'eccezione. |
| scode | Uguale a wCode. |
È possibile che il TP restituisca informazioni sullo stato senza generare effettivamente un'eccezione. Per mantenere il codice TP mainframe il più semplice possibile, i dati dell'eccezione fanno parte dei metadati facoltativi e vengono restituiti in tutti i casi, indipendentemente dal fatto che si verifichi o meno un errore.