Mustercode 'CICS Transaction Server for z/OS Channel Connectivity' konfigurieren
Zur Einrichtung des Mustercodes 'CICS Transaction Server for z/OS
Channel Connectivity' müssen Sie die Verbindung zwischen IBM
WebSphere Message Broker und CICS Transaction Server for z/OS
mit dem konfigurierbaren Service 'CICSConnection' konfigurieren. Anschließend können Sie das CICS-Programm 'WMBCHAN1' übersetzen, kompilieren und verknüpfen und danach in Ihrer CICS-Zielregion implementieren.
Bevor Sie den Mustercode 'CICS Transaction Server for
z/OS Connectivity' importieren und implementieren, müssen Sie mit dem konfigurierbaren Service 'CICSConnection' die Verbindung zwischen WebSphere Message Broker und CICS konfigurieren:
Vor der Ausführung des Mustercodes 'CICS Transaction Server for z/OS Channel Connectivity' müssen Sie das Programm 'WMBCHAN1' übersetzen, kompilieren und mit Ihrer CICS-Zielregion verknüpfen:
Mit den folgenden Schritten wird die Mindestkonfiguration vorgenommen, die für den Import und die Implementierung des Mustercodes erforderlich ist.
Erstellen Sie mit dem Befehl mqsicreateconfigurableservice oder mithilfe von WebSphere Message Broker Explorer den konfigurierbaren CICSConnection-Service CICSSampleConnectionService.
Konfigurierbaren CICSConnection-Service mit dem Befehl mqsicreateconfigurableservice erstellen
- Mit dem folgenden Befehl können Sie einen konfigurierbaren CICSConnection-Service für die am Port 12345 in mycicsregion.com aktive CICS-Instanz. Der Broker wird über die Anwendungs-ID (APPLID) BRKApp und das Qualifikationsmerkmal BRKQual angegeben.
mqsicreateconfigurableservice MB8BROKER -c CICSConnection -o CICSSampleConnectionService -n cicsServer -v tcp://mycicsregion.com:12345
- Starten Sie den Broker erneut im WebSphere Message Broker Explorer
oder über die Befehle mqsistop und
mqsistart, beispielsweise:
mqsistop MB8BROKER
mqsistart MB8BROKER
- Weitere Informationen zum Erstellen eines konfigurierbaren Service, auf den der CICSRequest-Knoten oder der Nachrichtenfluss hinsichtlich der Verbindungsangaben 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.
Konfigurierbaren CICSConnection-Service mithilfe von WebSphere Message Broker Explorer erstellen
- Erweitern Sie in der Navigatoransicht den Broker, dem ein neuer konfigurierbarer Service hinzugefügt werden soll.
- Klicken Sie mit der rechten Maustaste auf den Ordner 'Konfigurierbare Services' und klicken Sie anschließend auf Neu > Konfigurierbarer Service. Daraufhin wird das Fenster 'Konfigurierbarer Service' geöffnet.
- Geben Sie in das Feld Name CICSSampleConnectionService als Namen für den konfigurierbaren ervice ein.
- Wählen Sie im Feld Typ CICSConnection als den konfigurierbaren Servicetyp aus, der erstellt werden soll.
- Wählen Sie im Feld Schablone CICSConnectionTemplate als den Schablonentyp aus, der erstellt werden soll.
- Geben Sie den Wert für die Eigenschaft cicsServer des konfigurierbaren Service im Format tcp://mycicsregion.com ein, wobei mycicsregion für Ihre CICS-Region steht.
- Klicken Sie auf Finish (Fertigstellen), um den neuen konfigurierbaren Service zu erstellen.
- Starten Sie den Broker im WebSphere Message Broker Explorer
oder über die Befehle mqsistop und
mqsistart neu, beispielsweise:
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 Channel Connectivity'.
Führen Sie zur Übersetzung, Kompilierung und Verknüpfung des CICS-Programms 'WMBCHAN1' die folgenden Schritte aus.
- Das CICS-Programm ist im Musterprojekt 'CICSConnectivity Channel
Message Flow' enthalten und heißt WMBCHAN1.c. Extrahieren Sie diese Datei und stellen Sie sie in eine MVS-Datengruppe.
- CICS bietet eine JCL-Musterprozedur, mit der das Musterprogramm kompiliert werden kann. Wenn Sie diese Prozedur nutzen möchten, befolgen Sie die Anweisungen im CICS
Transaction Server for z/OS Version 4.1 Infocenter
unter der Überschrift Sample JCL to install C application programs (Muster-JCL zur Installation von Anwendungsprogrammen in der Programmiersprache C).
- Passen Sie die unter <cicshlq>.SDFHPROC(DFHYITDL) enthaltene Muster-JCL an und stellen Sie sie in Ihre Prozedurenbibliothek.
- Passen Sie WMBCHAN1.c an, um den richtigen Jobsteuerungsheader und die korrekten Übersetzeroptionen festzulegen (halten Sie sich dabei an die Anweisungen im CICS-Information Center).
- Passen Sie den Namen des Lademoduls unten in WMBCHAN1.c an und übergeben Sie ihn als Job.
- Überprüfen Sie, ob die Antwort erfolgreich ist; falls nicht, lesen Sie den Abschnitt Sample JCL to install C application programs (Muster-JCL zur Installation von Anwendungsprogrammen in der Programmiersprache C) im CICS Transaction Server for z/OS
Version 4.1 Infocenter.
- Nach der erfolgreichen Übersetzung und Kompilierung des Programms und dessen Verknüpfung mit dem Lademodul müssen Sie sicherstellen, dass das Lademodul in der Anweisung DFHRPL JCL für die CICS-Region genannt wird.
- Erstellen Sie eine PROGRAM-Definition für das neue WMBCHAN1-Programm und installieren Sie die Definition.
Der Mustercode 'CICS Transaction for z/OS Connectivity' kann jetzt ausgeführt werden. Weitere Informationen finden Sie im Abschnitt Mustercode 'CICS Transaction Server for z/OS Connectivity' ausführen.
Zurück zum Beginn des
Mustercodes