Metadati facoltativi

Gli sviluppatori possono scegliere di inviare e ricevere metadati dall'ambiente di runtime di Transaction Integrator (TI) da e verso il programma di transazione mainframe (TP) ed è possibile scegliere il contenuto di tali metadati.

È possibile inviare o ricevere:

• Nessun metadato.

• 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 nel:

• Identificazione del formato dei metadati (informazioni sulla versione).

• Identificazione del nome del metodo utilizzato per richiamare il TP.

• Segnalazione di informazioni dettagliate sull'errore al client.

  I metadati non sono visibili al client di automazione. I metadati vengono recapitati all'host TP (o ricevuti da esso) come parte del messaggio di richiesta inviato al TP (o del messaggio di risposta ricevuto dal TP).

  Il set di metadati include i dati seguenti:

• Versione dell'ambiente di runtime di 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.

  Un GUID, nel formato di carattere, che identifica in modo univoco questo blocco di dati di eccezione. Il GUID supporta la possibilità di avere formati di eccezione aggiuntivi in futuro e consente di garantire che tutti i dati ricevuti siano validi.

• Variabili senza utilizzi assegnati fino ad oggi (riservate):

  • 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, un Numero intero breve per contenere il numero di versione principale e l'altro per contenere il numero di versione secondaria.

• Blocco di eccezioni (usato solo nelle risposte).

  Un GUID in formato binario che identifica in modo univoco questo blocco di dati delle eccezioni. 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 determina anche la chiusura della transazione.

  • 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 del 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.