Specifica interazione ECI

La classe InteractionSpec è una classe specifica di CICS utilizzata per gestire l'interazione tra l'applicazione Java e CICS.

L'applicazione J2C utilizza l'interfaccia Interaction per collegarsi a un programma del server. L'adattatore risorse ECI fornisce un'implementazione dell'interfaccia Interaction, ma l'applicazione non la utilizza direttamente; utilizza, invece, la classe ECIInteractionSpec per definire le proprietà dell'interazione:

Come per ECIConnectionSpec, è possibile impostare le proprietà su una classe ECIInteractionSpec al momento della costruzione o utilizzando metodi setter. Diversamente da ECIConnectionSpec, la classe ECIInteractionSpec è stata progettata come bean Java. In un ambiente gestito, quindi, il server può fornire gli strumenti che consentono di definire tali proprietà utilizzando una GUI senza dover scrivere codice.

Proprietà ECIInteractionSpec

• TPNName: TPNName si riferisce al nome della transazione PTN CICS in cui si desidera vengano eseguiti tutti i programmi avviati dall'adattatore risorse. Se vengono specificati sia TranName che TPNName, TPNName ha la precedenza. Se TPNName viene impostato su ECIInteractionSpec, quest'ultimo sostituisce tutti i valori impostati al momento della distribuzione (o su managedConnectionFactory, se non gestito).
• commareaLength: commareaLength si riferisce alla lunghezza dell'elemento dati,
• executeTimeout: per specificare un valore per il timeout ECI, impostare la proprietà ExecuteTimeout della classe ECIInteractionSpec sul valore del timeout ECI. I valori consentiti sono:
  • 0 (senza timeout), il valore predefinito.
  • Un numero intero positivo (che esprime il tempo in millisecondi).
  Nota: Se si utilizza CICS Transaction Gateway su z/OS, non è possibile specificare un valore per il timeout ECI. In alternativa è possibile impostare il parametro TIMEOUT nella tabella opzioni EXCI DFHXCOPT
• functionName: imposta la proprietà FunctionName sul nome del programma server CICS.
• interactionVerb: interactionVerb imposta il tipo di interazione che verrà eseguita dalla transazione. I valori consentiti sono:
  • SYNC_SEND per una chiamata asincrona,
  • SYNC_RECEIVE per richiamare una risposta da una chiamata asincrona.
  • SYNC_SEND_RECEIVE per una chiamata sincrona.
    • Quando una chiamata SYNC_SEND viene emessa con il metodo execute() di un particolare oggetto ECIInteraction, tale istanza di ECIInteraction non può eseguire un altro SYNC_SEND o SYNC_SEND_RECEIVE, finché non viene eseguito SYNC_RECEIVE.
    • Chiamate asincrone contemporanee per la stessa connessione sono consentite purché ciò non causi due chiamate asincrone in sospeso nello stesso ambito di transazione. In tal caso viene generata una LocalTransactionException.
    • Se si utilizza l'adattatore in modalità locale con WebSphere Application Server per z/OS, ed è richiesto un supporto transazionale, specificare il tipo di interazione SYNC_SEND_RECEIVE. Utilizzando SYNC_SEND e SYNC_RECEIVE per emettere richieste asincrone, le richieste ECI verranno emesse con sync on return, e saranno esterne all'ambito della transazione globale corrente. In modalità remota, le chiamate asincrone funzionano normalmente.
      • Impostare la proprietà CommareaLength sul valore della lunghezza di COMMAREA passato a CICS. Se tale valore non viene fornito, viene utilizzato un valore predefinito:
        • SYNC_SEND, SYNC_SEND_RECEIVE -- Lunghezza dei dati del record di input
        • SYNC_RECEIVE -- Il valore di ReplyLength
      • Impostare la proprietà ReplyLength sulla lunghezza del flusso di dati che il daemon Gateway deve restituire all'applicazione J2C. Ciò può ridurre i dati trasmessi nella rete se i dati restituiti da CICS sono inferiori alla dimensione totale di COMMAREA, e si conosce in anticipo la dimensione dei dati. L'applicazione JCA riceve ancora una COMMAREA completa della dimensione specificata in CommareaLength, solo che la quantità di dati inviati nella rete è ridotta. Questo metodo equivale al metodo setCommareaInboundLength() disponibile per la classe ECIRequest. Se non viene impostato ReplyLength, CICS Transaction Gateway elimina automaticamente gli zeri finali dalla COMMAREA inviata dal daemon Gateway all'applicazione J2C, senza che sia necessario conoscere in anticipo le dimensioni dei dati.
• replyLength: la proprietà ReplyLength imposta la lunghezza del flusso di dati che il daemon Gateway deve restituire all'applicazione J2C. È possibile ridurre i dati trasmessi nella rete se i dati restituiti da CICS sono inferiori della dimensione totale di COMMAREA, e si conoscono in anticipo le dimensioni dei dati.
• tranName: il nome della transazione CICS in cui si desidera vengano eseguiti i programmi avviati dall'adattatore risorse. Il programma richiamato viene eseguito in una transazione mirror, ma è ad essa collegato dal nome della transazione tranName. Questo nome è disponibile per la richiesta dell'ID di transazione da parte del programma richiamato. Alcuni server utilizzano l'ID di transazione per stabilire gli attributi delle prestazioni e della sicurezza per il programma richiamato. In alcuni server, si raccomanda di utilizzare questo parametro per controllare l'elaborazione dei programmi richiamati. L'impostazione di tranName in ECIInteractionSpec sostituisce il valore impostato al momento della distribuzione (o su ManagedConnectionFactoryif se non gestito).