Metadati facoltativi
Gli sviluppatori possono scegliere di inviare e ricevere metadati dall'ambiente di runtime di Transaction Integrator (TI) e dal programma di transazione mainframe (TP) ed è possibile scegliere il contenuto di tali metadati.
Nota
I metadati non sono supportati per la chiamata al programma distribuito (DPC).
È possibile inviare o ricevere:
Nessun metadati.
Solo il nome del metodo come metadati.
Tutti i metadati, incluso il nome del metodo.
L'ambiente di runtime TI invia o riceve metadati da o verso il tp come indicato. I metadati supportano il tp in:
Identificazione del formato dei metadati (informazioni sulla versione).
Identificazione del nome del metodo utilizzato per richiamare il tp.
Segnalazione di informazioni dettagliate sugli errori al client.
I metadati non sono visibili al client di Automazione. I metadati vengono recapitati o ricevuti dall'host TP come parte del messaggio di richiesta inviato a (o messaggio di risposta ricevuto dal tp).
Il set di metadati include i dati seguenti:
Versione di runtime ti.
Stringa di caratteri, ad esempio "Microsoft TI versione 1.0.0", che identifica in modo univoco la versione dell'ambiente di runtime TI che ha generato la richiesta.
Nome del metodo (stringa di 32 caratteri) richiamato dal codice dell'applicazione client.
ID blocco di metadati.
GUID, in formato carattere, che identifica in modo univoco questo blocco di dati di eccezione. Il GUID supporta la possibilità di avere altri formati di eccezione in futuro e consente di garantire che tutti i dati ricevuti siano validi.
Variabili senza uso assegnato alla data (riservato):
Flag booleano che indica se il tp è pronto per il commit.
Flag booleano che indica se il tp è pronto per eseguire operazioni aggiuntive.
Due numeri interi brevi per contenere parti del numero di versione dell'ambiente di runtime TI, uno Short Integer per contenere il numero di versione principale e l'altro per contenere il numero di versione secondaria.
Blocco di eccezioni (usato solo nelle risposte).
GUID, in formato binario, che identifica in modo univoco questo blocco di dati di eccezione. Il GUID consente il supporto di altri formati di eccezione in futuro e garantisce che i dati ricevuti siano validi:
Flag booleano che indica se il tp è pronto per il commit.
Flag booleano che indica se il tp è pronto per eseguire operazioni aggiuntive.
Flag booleano che indica se deve essere restituita un'eccezione all'applicazione client. Se impostato, questo flag causa anche la chiusura della transazione.
Numero intero a 16 bit che identifica l'errore (vedere la nota più avanti in questo argomento). È possibile assegnare questo valore, insieme al messaggio di 256 caratteri che descrive l'errore, dal server in modo che il valore assegnato venga restituito quando si verifica un errore di run-time TI.
Numero intero a 32 bit che identifica l'ID di contesto nel file della Guida tp (se presente).
Messaggio di 256 caratteri che descrive l'errore. È possibile assegnare questo valore, insieme all'intero a 16 bit che identifica l'errore dal server, in modo che il valore assegnato venga restituito quando si verifica un errore di run-time TI.
I metadati si trovano sempre all'inizio del messaggio.
Nota
I messaggi di errore TI hanno numeri compresi tra 0 e 9999. I numeri dei messaggi di errore dei metadati restituiti dal mainframe possono rientrare nello stesso intervallo. Per distinguere i messaggi di errore TI dai messaggi di metadati restituiti dal mainframe, TI aggiunge 10000 al numero di eventuali messaggi di errore dei metadati restituiti dal mainframe.