Konfigurieren Sie IBM WebSphere Message Broker so, dass mithilfe des konfigurierbaren CICSConnection-Service eine Verbindung zu CICS Transaction Server for z/OS hergestellt wird, und richten Sie FILEA in Ihrer CICS-Zielregion für den Mustercode 'CICS Transaction Server for z/OS' ein.
Bevor Sie den Mustercode 'CICS Transaction Server for z/OS Connectivity' importieren und implementieren, müssen Sie WebSphere Message Broker so konfigurieren, dass mittels des konfigurierbaren CICSConnection-Service eine Verbindung zu CICS hergestellt werden kann.
Bevor Sie den Mustercode 'CICS Transaction Server for z/OS Connectivity' ausführen, müssen Sie FILEA in Ihrer CICS-Zielregion einrichten:
Mit den folgenden Schritten wird die Mindestkonfiguration vorgenommen, die für den Import und die Implementierung des Mustercodes erforderlich ist:
mqsisetdbparms MB8BROKER -n cics::<ID-Name> -u <Benutzername> -p <Kennwort>
Mit dem folgenden Befehl können Sie einen konfigurierbaren CICSConnection-Service für die am Port mycicsregion.cics.ibm.com 12345 aktive CICS-Instanz erstellen. Der Broker wird über die Anwendungs-ID BRKApp und das Qualifikationsmerkmal BRKQual angegeben.
Wenn Sie sich nicht anmelden müssen, um eine Verbindung zu Ihrer CICS-Region herzustellen, führen Sie folgenden Befehl aus:
mqsicreateconfigurableservice MB8BROKER -c CICSConnection -o CICSSampleConnectionService -n cicsServer,clientApplid,clientQualifier -v tcp://mycicsregion.com:12345,BRKApp,BRKQual
Wenn Sie sich anmelden müssen, um eine Verbindung zu Ihrer CICS-Region herzustellen, führen Sie folgenden Befehl aus und ersetzen Sie <ID-Name> mit Ihrem Anmeldenamen:
mqsicreateconfigurableservice MB8BROKER -c CICSConnection -o CICSSampleConnectionService -n cicsServer,clientApplid,clientQualifier,securityIdentity -v tcp://mycicsregion.com:12345,BRKApp,BRKQual,<ID name>
mqsistop MB8BROKER
mqsistart MB8BROKER
Weitere Informationen zum Erstellen eines konfigurierbaren Service, auf den der CICSRequest-Knoten oder der Nachrichtenfluss während der Ausführung verweist, finden Sie im Abschnitt Verbindungsangaben für den CICSRequest-Knoten ändern und Konfigurierbare Serviceeigenschaften in der WebSphere Message Broker-Dokumentation.
mqsistop MB8BROKER
mqsistart MB8BROKER
Weitere Informationen darüber, wie mithilfe von WebSphere Message Broker Explorer ein konfigurierbarer Service erstellt werden kann, auf den vom CICSRequest-Knoten oder vom Nachrichtenfluss zur Ausführungszeit verwiesen werden kann, finden Sie im Abschnitt Neuen konfigurierbaren Service erstellen. Weitere Informationen zu den Eigenschaften für konfigurierbare CICSConnection-Services finden Sie im Abschnitt Eigenschaften von konfigurierbaren Services in der Dokumentation zu WebSphere Message Broker.
Sie können den Mustercode jetzt importieren und implementieren. Weitere Informationen finden Sie im Abschnitt Mustercode 'CICS Transaction Server for z/OS Connectivity'.
Nachdem Sie den Mustercode importiert haben, werden unter Umständen die folgenden Warnungen zum CICS Connectivity-Nachrichtenflussprojekt und zur Datei CICSConnectivity.esql angezeigt:
Unresolvable message field reference "InputBody.data.file" (Nicht auflösbare Nachrichtenfeldreferenz "InputBody.data.file")
Unresolvable message field reference "InputBody.data.file" (Nicht auflösbare Nachrichtenfeldreferenz "InputBody.data.record")
Diese Nachrichten können Sie ignorieren, da der Datenordner nicht im XML-Schema enthalten ist.
Führen Sie folgende Schritte aus, um FILEA in der CICS-Zielregion zu konfigurieren:
Bei der Definition einer CICS-Region werden während der Installation FILEA-Musterdatensätze erstellt, die sich in 'mydsindex.myCICSregion.FILEA' befinden. Ist dieser Datensatz nicht verfügbar, müssen Sie ihn mit dem JCL-Script (Job Control Language) erneut erstellen:
//HCREFILA JOB … card details … //CREFILEA EXEC PGM=IDCAMS,REGION=6144K //SYSPRINT DD SYSOUT=A //AMSDUMP DD SYSOUT=A //SYSIN DD * DEFINE CLUSTER ( - NAME( hlq4filea.FILEA ) - CYL(2,1) - VOLUME(SYSDAV) - KEYS( 6 1 ) - INDEXED - RECORDSIZE( 80 80 ) - FREESPACE( 5 5 ) - SHAREOPTIONS( 2 ) - ) - INDEX ( - NAME( hlq4filea.FILEA.INDEX ) - ) - DATA ( - NAME( hlq4filea.FILEA.DATA ) - ) /* // //HINIFILA JOB … card details … //* ==================== //* LOAD VSAM DATA FILE //* ==================== //INIFILEA EXEC PGM=DFH£LDSP //STEPLIB DD DSN=hlq4cics.SDFHLOAD,DISP=SHR //FILEA DD DISP=SHR,DSN=hlq4filea.FILEA //SYSOUT DD SYSOUT=* //SYSIN DD DISP=SHR,DSN=hlq4cics.SDFHSAMP(DFH£FAIN) //* //
Definieren Sie mithilfe der in CICS bereitgestellten CEDA-Transaktion eine FILE-Ressource. Die Ressource kann auf der FILEA-Musterdefinition des CSD-Befehls in Gruppe DFH£FILA basieren und muss auf den Datensatz verweisen, der im vorherigen Schritt definiert wurde.
Das in CICS bereitgestellte Musterprogramm DFH$AXCS kann mit dem folgenden Befehl installiert werden:
CEDA INSTALL PROG(DFH$AXCS) GROUP(DFH$EXCI)
Der Mustercode 'CICS Transaction for z/OS Connectivity' kann jetzt ausgeführt werden (siehe den Abschnitt Mustercode 'CICS Transaction Server for z/OS Connectivity' ausführen).
Zurück zum Beginn des Mustercodes