Tutoial MQ2b. Tutorial MQ2b. Vorbereitende Maßnahmen für Tutorial MQ3

Transkript

1 Tutorial MQ2b Vorbereitende Maßnahmen für Tutorial MQ3 Hinweis: Dieses Tutorial wurde unter Verwendung der Benutzer-ID "PRAK222" erstellt. In allen Dateinamen müssen Sie "PRAK222" durch Ihre eigene Benutzer-ID ersetzen. Außerdem wird oft in den Erklärungen PRAKxxx verwendet, wobei die xxx Ihre Praktikumsnummer sein soll. Bei Anweisungen, die sich auf Eingaben beziehen, sind die Anführungszeichen nicht mit einzugeben. Aufgabe: Arbeiten Sie nachfolgendes Tutorial durch. Dieses Tutorial besteht aus drei Teilen. 1. der Vorstellung des WebSphere MQ Explorers 2. dem Starten der CICS-Transaktion NACT und dem Anlegen eines Kontos 3. dem Übersetzen des Java-Client WebSphere MQ Explorer Für das folgende Tutorial MQ3 benötigen wir eine Version des WebSphere MQ Explorers. Eine installierbare Version steht auf den Seiten zu den Tutorials zum Download bereit. Wir laden also die entsprechende Datei herunter, entpacken sie und starten den Installationsvorgang (Setup). Unter Windows XP läuft die Installation wie folgt ab: 1

2 Abbildung 1: WebSphere MQ Launchpad Nach dem Start des Setup-Programms sehen wir das WebSphere MQ Launchpad (Abbildung 1). Wir schauen uns zunächst die Softwarevoraussetzungen an. Hier sehen wir, dass eine Komponente noch fehlt, die WebSphere Eclipse Platform (Abbildung 2). Abbildung 2: Softwarevoraussetzungen Wir klicken auf CD-ROM und wählen unsere gewünschte Setupsprache. Nachdem wir die Lizenzvereinbarungen gelesen und akzeptiert haben, wählen wir einen Installationspfad und installieren die WebSphere Eclipse Platform. 2

3 Nachdem die Installation der WebSphere Eclipse Platform abgeschlossen ist, aktualisieren wir die Softwarevoraussetzungen und sehen, dass wir nun bereit sind, fortzufahren (Abbildung 3). Abbildung 3: Softwarevoraussetzungen (2) Als Nächstes klicken wir auf die Netzwerkkonfiguration (Abbildung 4). Im Normalfall können wir hier die Option Nein auswählen. Abbildung 4: Netzwerkkonfiguration 3

4 Wenn wir jetzt auf WebSphere MQ-Installation klicken gelangen wir zum Screen in Abbildung 5. Wir sind jetzt bereit, die Installation durchzuführen. Wir starten sie mit einem Klick auf Installation von IBM WebSphere MQ starten. Die restliche Installation läuft wie gewohnt ab. Abbildung 5: WebSphere MQ-Installation Nach der Installation startet der WebSphere MQ-Vorbereitungsassistent. Wir bestätigen jeweils mit Weiter, eine Standardkonfiguration müssen wir nicht erstellen, WebSphere MQ Erste Schritte interessiert uns auch nicht. Der WebSphere MQ Explorer startet nun. Sobald er gestartet ist, können wir ihn auch schon wieder beenden, wir benötigen ihn erst später. Wenn wir eine Firewall aktiviert haben, müssen wir dem WebSphere MQ Explorer den Zugriff erlauben. Wir wollen später den Port 1416 benutzen, schalten als diesen Port frei. CICS-NACT Die CICS-Transaktion NACT wurde von John Horswill und anderen Entwicklern bei IBM Hursley basierend auf der älteren Beispiel-Transaktion ACCT entwickelt 1. Es handelt sich dabei um das Beispiel einer Kundendatenbank der (fiktiven) Firma KanDoIT. Für jeden Kunden wird hierbei ein eigenes Konto mit einzigartiger Kontennummer angelegt. In Tutorial MQ3 werden wir mit einem Java-Client darauf zugreifen. Auf unserem System hobbit ( ) läuft die NACT-Transaktion auf dem CICS- Subsystem CICS1. Wir verbinden uns also, mit einem entsprechenden TN3270-Emulator, mit der z/os- Maschine und loggen uns dort mit L CICS1 (die 1 am Ende nicht vergessen!) im CICS1 ein (Abbildung 6). 1 Designing and Programming CICS Applications. O`Reilly,

5 z/os Z18 Level 0609 IP Address = VTAM Terminal = SC0TCP84 Application Developer System // OOOOOOO SSSSS // OO OO SS zzzzzz // OO OO SS zz // OO OO SSSS zz // OO OO SS zz // OO OO SS zzzzzz // OOOOOOO SSSS System Customization ADCD.Z18.* ===> Enter "LOGON" followed by the TSO userid. Example "LOGON IBMUSER" or ===> Enter L followed by the APPLID ===> Examples: "L TSO", "L CICS", "L IMS3270 l cics1 Abbildung 6: Login-Screen auf hobbit Nach der erfolgreichen Verbindung mit dem CICS1-Subsystem erscheint der CICS- Willkommensbildschirm. Noch sind wir aber nicht eingeloggt. Wir beenden zunächst den Startbildschirm, indem wir auf dem Keypad des Emulators (bei x3270 z.b. klicken wir hierfür das Tastatur-Icon rechts oben an, bei wc3270 klicken wir auf Keypad ) die Clear -Taste anklicken. WELCOME TO CICS 20:23:30 ******\ ******\ ******\ ******\(R) ********\ ******\ ********\ ********\ **\\\\**\ **\\\ **\\\\**\ **\\\\**\ **\ \\ **\ **\ \\ **\ \\ **\ **\ **\ *******\ **\ **\ **\ *******\ **\ **\ **\ \\\\**\ **\ **\ **\ **\ **\ **\ **\ ********\ ******\ ********\ ********\ ******\\ ******\ ******\\ ******\\ \\\\\\ \\\\\\ \\\\\\ \\\\\\ Abbildung 7: CICS1-Startbildschirm 5

6 Es erscheint ein schwarzer Bildschirm. Auf diesem geben wir (durch einen Druck auf die Tabulator-Taste gelangen wir zum Eingabe-Cursor) den Befehl CESN ein. Dies ruft die CICS-SIGN ON-Transaktion auf (Abbildung 8). Signon to CICS APPLID CICS1 WELCOME TO CICS Type your userid and password, then press ENTER: Userid.... prak222 Groupid... Password... Language... New Password... DFHCE3520 Please type your userid. F3=Exit Abbildung 8: Sign-on auf CICS1 Wir geben hier unsere Praktikums-ID und unser Passwort ein und bestätigen mit der Eingabetaste. Es erscheint die Meldung DFHCE3549 Sign on is complete (Language ENU). und wir können unsere Transaktion jetzt starten. Wir geben hierfür NACT ein und bestätigen wieder mit der Eingabetaste (Abbildung 9). nact DFHCE3549 Sign on is complete (Language ENU). Abbildung 9: Start der NACT-Transaktion 6

7 Wir gelangen ins NACT-Account Menu. Hier legen wir nun unser Konto an. Wir geben hierfür bei REQUEST TYPE A für Add und als Account unsere Kontonummer 10xxx ein (oder 100xx, wobei xx unsere Praktikumsnummer ist), das Feld PRINTER ID lassen wir leer. Wir bestätigen mit der Eingabetaste. Sollten wir jetzt die Meldung THIS ACCOUNT NUMBER ALREADY EXISTS bekommen, müssen wir das bestehende Konto bearbeiten. Hierfür ändern wir REQUEST TYPE auf M (Modify) und bestätigen wieder mit der Eingabetaste. Wir können jetzt unsere Daten eintragen. Wichtig ist hierbei, dass die Vor- und Nachnamen aller Mitarbeiter an dieser Aufgabe, eingetragen werden (Abbildung 10). ACCOUNTS ADD ACCOUNT NUMBER SURNAME : MUSTERMANN (18 CHRS) TITLE : (4 CHRS OPTIONAL) FIRST NAME : MAX (12 CHRS) MIDDLE INIT: A (1 CHR OPTIONAL) TELEPHONE : (10 DIGS) ADDRESS LINE1: MUSTERSTRASSE (24 CHRS) LINE2: 1 (24 CHRS) LINE3: (24 CHRS OPTIONAL) CARDS ISSUED : 5 (1 TO 9) CARD CODE : E (1 CHR) DATE ISSUED : (MM DD YY) REASON CODE: S (N,L,S,R) APPROVED BY : BEC (3 CHRS) UPTO 4 OTHERS WHO MAY CHARGE (EACH 32 CHRS OPTIONAL) O1: MARC BECKER O2: TOBIAS BUSSE O3: O4: SPECIAL CODE1: X CODE2: CODE3: (EACH 1 CHR OPTIONAL) NO HISTORY AVAILABLE AT THIS TIME CHARGE LIMIT STATUS N NOTE: DETAILS IN BRACKETS SHOW MAXIMUM NO. CHARACTERS ALLOWED AND IF OPTIONAL MAKE CHANGES AND PRESS "ENTER", OR "CLEAR" TO CANCEL Abbildung 10: Konto hinzufügen Wenn wir alles Notwendige eingetragen haben, bestätigen wir mit der Eingabetaste. Wir landen wieder im ACCOUNTS MENU der NACT-Transaktion. Hier sehen wir jetzt die Meldung ACCOUNT NUMBER ADDED oder MODIFIED. Mit der Clear -Taste auf der virtuellen Tastatur beenden wir die Transaktion und können uns jetzt von CICS abmelden. Hierzu benutzen wir den Befehl CESF LOGOFF. Aufgabe: Loggen Sie sich in das CICS1-Subsystem des z/os-servers "hobbit" ein und starten Sie dort die Transaktion NACT. Legen Sie für sich ein Konto mit der Nummer "100xx" oder "10xxx" an, wobei die xx oder xxx für die Nummer Ihres Prak-Accounts auf hobbit stehen. Sollte das zu Ihrer Account-Nr. gehörende Konto schon existieren, so modifizieren Sie dieses Konto. Füllen Sie alle notwendigen Felder aus. Ihr Vor- und Zuname (oder alle Vor- und Zunamen der Teilnehmer, die gemeinsam dieses Tutorial bearbeiten) müssen in die Felder eingetragen werden. Bei allen anderen Feldern können Sie gerne kreativ sein. 7

8 Java-Client Den Quellcode für die Java-Anwendung erhalten wir im Rahmen der Übung. Alles was wir benötigen, befindet sich in der gepackten Datei Tutor_mq3.zip. Zusätzlich ist ein installiertes Java SDK erforderlich. Zunächst entpacken wir die Datei. Sie beinhaltet zwei Verzeichnisse (images und jar) sowie die sechs Java-Dateien: AccountHistory.java AccountHistoryTableModel.java, AccountRecord.java DisplayField.java MQClient.java MQCommunicator.java Um die Java-Anwendung erfolgreich kompilieren zu können, benötigen wir fünf MQ-Klassenbibliotheken. Diese befinden sich im Unterverzeichnis jar. Wir müssen also zunächst die Umgebungsvariablen entsprechend setzen. Unter Windows gehen wir in die Eingabeaufforderung und geben folgenden Befehl ein (<Pfad> ist hierbei der Pfand zum Verzeichnis der entpackten Datei): >set classpath=<pfad>\jar\connector.jar;<pfad>\jar\com.ibm.mq.jar;<pfad>\jar\com.ibm.mq. jmqi.jar;<pfad>\jar\com.ibm.mq.headers.jar;<pfad>\jar\com.ibm.mq.commonservices.jar ;. Unbedingt zu beachten ist an dieser Stelle der abschließende Punkt. In der bash-shell lautet der entsprechende Befehl: export CLASSPATH=$CLASSPATH:<Pfad>... In der tcsh-shell wäre der Aufruf: set CLASSPATH=($CLASSPATH:<Pfad>...) Wenn wir die Umgebungsvariablen richtig gesetzt haben, können wir als nächstes die Anwendung kompilieren: javac g MQClient.java Wenn dieser Vorgang fehlerfrei beendet wurde, können wir mit Tutorial MQ3 fortfahren. Sollten Fehler ausgegeben werden, überprüfen wir noch einmal die von uns gesetzten Umgebungsvariablen. Testen können wir den Client an dieser Stelle noch nicht, dies folgt in Tutorial MQ3. 8