TRM ed ELM personalizzati con COMTIContext

Gli sviluppatori dell'integratore delle transazioni (TI) possono passare messaggi di richiesta di transazione formattati personalizzati o messaggi di listener avanzati (ELMS) da un programma client al sistema CICS e ricevere TRMS o VM formattati personalizzati.

Le VM o le macchine virtuali personalizzate vengono passate tramite i dati di contesto. I dati di contesto sono contenuti nel parametro COMTIContext facoltativo definito nel codice dell'applicazione client e devono essere il parametro finale nella chiamata al metodo. Un TRM destinato all'host deve essere definito come tipo definito dall'utente (UDT) per il modello COM o una struttura per il modello .NET Framework. Il nome dell'UDT deve iniziare con i caratteri TRMIN. Una risposta TRM dall'host deve essere definita anche come un'UDT. Il nome dell'UDT deve iniziare con i caratteri TRMOUT. Esempi di nomi TRM validi sono: TRMINMyVeryOwn, TRMINStandard, TRMOUTMyVeryOwn e TRMOUTStandard.

La libreria di tipi o la struttura possono contenere più definizioni TRM, ma è consigliabile includere una sola TRM per ogni direzione, ovvero una TRMIN e una TRMOUT, nel parametro COMTIContext in una singola chiamata al metodo. Ad esempio, in Visual Basic ogni matrice COMTIContext viene dichiarata come una singola matrice dinamica di dimensioni di varianti, ovvero il numero di occorrenze non viene specificato.

Se si definiscono più TRMS per la stessa direzione, l'ora di esecuzione TI usa solo il primo TRM che rileva nella matrice di contesto. In alcune circostanze, il primo TRM rilevato potrebbe non essere sempre il primo che è stato aggiunto alla matrice di contesto. L'ora di esecuzione TI ignora le vm TR rimanenti nella matrice fino a quando il TRM in uso non viene eliminato. Per assicurarsi che il tempo di esecuzione TI usi il TRM corretto, non aggiungere più TRMS destinati alla stessa direzione a una matrice di contesto.

Nota

L'applicazione client che modifica la matrice di contesto deve essere in grado di accedere al file appropriato in fase di esecuzione. Se si usa Visual Basic6.0, l'applicazione deve essere in grado di accedere a COMTIContext.dll. Se si usa Visual Basic .NET, l'applicazione deve poter accedere a Microsoft.HostIntegration.TI.ClientContext.dll.

Nota

Quando si usa Visual Basic .NET, la struttura di dati usata come TRM personalizzata deve essere associata a un parametro all'interno dell'assembly. Pertanto, è necessario creare un metodo fittizio all'interno dell'assembly, un parametro assegnato al metodo e la struttura dei dati da usare come TRM. Se non si esegue questa operazione, si impedisce di fare riferimento alla struttura all'interno dell'applicazione .NET di Visual Basic. L'associazione di un oggetto UDT a un metodo non è necessaria in Visual Basic 6.0 perché Visual Basic 6.0 consente di fare riferimento alle UDT non associate ai metodi.

Vedere anche

Messaggi di richiesta transazione
Come passare un TRM personalizzato