Configurazione del nodo CICSRequest per le transazioni globali sui sistemi distribuiti

Configurare il nodo CICSRequest per le transazioni locali e coordinate globalmente per CICS® su Linux®, UNIX e Windows.

Prima di iniziare

Consultare Nodo CICSRequest per comprendere quali proprietà Modalità transazione è possibile impostare su un nodo CICSRequest per le transazioni.

Piattaforma Linuxpiattaforma UNIXAssicurarsi che l'utente che esegue il gestore delle code di IBM® MQ, solitamente mqm, sia membro del gruppo mqbrkrs.

Informazioni su questa attività

Se si configura un nodo di integrazione che specifica un gestore di code locale IBM MQ, è possibile impostare transazioni coordinate a livello globale per i flussi di messaggi gestiti dal nodo di integrazione. Il gestore code specificato esegue quindi il ruolo di gestore transazioni.

Il gestore delle code garantisce il supporto coordinato delle transazioni, il che significa che un IBM App Connect Enterprise e deve poter accedere a un IBM MQ e mentre elabora i messaggi nel flusso di messaggi. Per ulteriori informazioni sull'utilizzo di IBM MQ con IBM App Connect Enterprise, consultare la guida all'installazione di IBM MQ.

Per configurare il nodo CICSRequest per le transazioni coordinate globalmente:

Procedura

  1. Creare una politica di connessione " CICS " per il nodo CICSRequest (vedere "Creazione di politiche con il toolkit IBM App Connect Enterprise ").
    1. Nella proprietà " Server di integrazione utilizzato per il ripristino di XA ", specificare il server di integrazione per il ripristino di XA e quale deve gestire la connessione. Non è possibile utilizzare alcun altro server di integrazione con la politica. Quando questa propriet ... Š impostata, il nodo CICSRequest viene considerato come una risorsa globale, altrimenti partecipa come una risorsa non globale.
    2. Sulla proprietà CICS server , è possibile scegliere una connessione diretta o una connessione tramite CICS Transaction Gateway.
    3. Nella proprietà Identità di sicurezza (DSN) , impostare un valido ID di sicurezza per autenticare la connessione a CICS (consultare Identità di sicurezza per il server di integrazione che si connette a sistemi esterni).
    Nota: non è necessario utilizzare più politiche di connessione CICS che si connettono allo stesso sistema CICS nella stessa transazione oppure potrebbero verificarsi problemi con i risultati complessivi della transazione.
    Per ulteriori informazioni, consultare CICS Connection policy (CICSConnection).
  2. Nel Toolkit di IBM App Connect Enterprise, passare alla prospettiva "Sviluppo dell'integrazione ".
  3. Nelle proprietà del file BAR, impostare il valore value della proprietà del flusso di messaggi Transazione coordinata su yes.
  4. Nell' editor Flusso di messaggi, impostare la proprietà Modalità transazione su o Automatico per ogni nodo CICSRequest richiesto nella transazione coordinata globalmente.
  5. Copiare il file switch. Il file di switch IIBXASwitch è fornito da IBM App Connect Enterprise e utilizza la registrazione dinamica XA (vedere Configurazione dei database per il coordinamento globale delle transazioni ):
    • In Windows:
      • Se si utilizza la versione a 64 bit di IBM MQ, copiare il file di commutazione IIBXASwitch.dll a 64 bit dalla directory di installazione di IBM App Connect Enterprise (IIB_installation_directory\bin\IIBXASwitch.dll) nella \exits64 sottodirectory della directory di installazione di IBM MQ (MQ_installation_directory\exits64\IIBXASwitch.dll).
      • Se utilizzi la versione a 32 bit di IBM MQ, copia il file di commutazione a 32 bit (IIBXASwitch32.dll) dalla directory di installazione di IBM App Connect Enterprise (IIB_installation_directory\bin\IIBXASwitch32.dll) nella \exits sottodirectory della directory di installazione di IBM MQ e rinominalo in IIBXASwitch.dll (MQ_installation_directory\exits\IIBXASwitch.dll).
    • Su Linux e sistemi UNIX, creare un link simbolico al file switch fornito nella directory install_dir/server/lib .

      install_dir è la directory in cui è stato installato IBM App Connect Enterprise. La posizione predefinita di questa directory è install_dir/ace-13.0.n.0/server su Linux, oppure /opt/IBM/mqsi/13.0.n.0/server sui sistemi UNIX. La directory predefinita include versione, release, modifica e correzione del prodotto, nel formato v.r.m.c (version.release.modifica.correzione).

      Configurare i collegamenti nella cartella /var/mqm/exits64 . Il nome file è libIIBXASwitch.so. Ad esempio:
      ln -s install_dir/server/lib/libIIBXASwitch.so /var/mqm/exits64/libIIBXASwitch.so
      
  6. Aggiungere una stanza al file qm.ini del gestore code per CICS, nel seguente formato:

    Su Linux e UNIX:

    XAResourceManager:
        Name=name
        SwitchFile=libIIBXASwitch.so
        XAOpenString=integrationNodeName,CICS,{policyProjectName}:PolicyName
        XACloseString=
        ThreadOfControl=THREAD
        
    Su Windows:
    XAResourceManager:
        Name=name
        SwitchFile=IIBXASwitch.dll
        XAOpenString=integrationNodeName,CICS,{policyProjectName}:PolicyName
        XACloseString=
        ThreadOfControl=THREAD
    Dove nome è un nome qualsiasi, integrationNodeName è il nome del nodo di integrazione, policyProjectname è il nome del progetto che contiene il file CICS Politica di connessione e policyName è il nome del CICS Politica di connessione.

Cosa fare successivamente

  • Controllare la propria configurazione:
    • Nel flusso dei messaggi, assicurarsi che la proprietà "Transazione coordinata" sia abilitata per il file BAR utilizzando l'editor di archivi di IBM App Connect Enterprise.
    • Assicurarsi che per ogni nodo facente parte della transazione coordinata a livello globale ( XA ) la proprietà «Transaction Mode» sia impostata su un valore valido per le transazioni globali ( Yes o Automatic ).
    • Assicurarsi che l'ID servizio utilizzato per il nodo di integrazione e il gestore code sia lo stesso ID utente.
    • Verificare che il commit a due fasi di CICS funzioni utilizzando il log di attività. Definire una politica di log attività denominando un file e impostando la proprietà RM su CICS.
    • Ricercare i problemi nel log degli errori per il gestore code.
  • Facoltativo: proteggere la connessione del flusso di messaggi; consultare Creazione di un profilo di sicurezza.