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

Transkript

1 Tutorial MQ2a 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. Auf dem Server ork-win.cs.uni-tuebingen.de befindet sich bereits eine installierte Version des WebSphere MQ Explorers. Auf ork-win läuft ein Windows Server 2008, auf den wir über eine Remotedesktopverbindung zugreifen können. Innerhalb des WSI-Netzes geht dies einfach mit dem Befehl rdesktop ork win. Wollen wir zum Beispiel von zu Hause aus auf ork-win zugreifen, müssen wir zunächst einen SSH-Tunnel aufbauen. Für Windows ist hier zum Beispiel Putty zu empfehlen ( Die einzelnen Schritte hierzu sind: Unter Linux: SSH-Tunnel aufbauen: ssh L 3389:ork win:3389 <wsi login>@sshgw.informatik.uni tuebingen.de rdesktop starten: rdesktop localhost 1

2 Unter Windows: Tunnel einrichten: Putty starten Connection SSH auswählen Checkbox bei Enable compression aktivieren und protocol version 2 auswählen auf das kleine + -Zeichen vor SSH klicken und Tunnels auswählen Als Source port wählen wir: 33890; Destination:ist ork-win:3389 Auf Add klicken Zu Sessions wechseln und als Hostname sshgw.informatik.uni-tuebingen.de eingeben sowie als Connection type SSH auswählen jetzt geben wir noch bei Saved sessions einen (vielsagenden) Namen ein und klicken auf Save. Auf diese Art können wir immer auf die eben gemachten Einstellungen zurückgreifen Remotedesktop verbinden: Wir starten unseren eben erstellten Tunnel mit Putty. Bei Windows XP starten wir eine Remotedesktopverbindung mit einem Klick auf Start Zubehör Remotedesktopverbindung. Bei Computer geben wir "localhost:33890" ein und klicken auf Verbinden. Wir loggen uns mit unseren Daten auf ork-win ein und sehen dort auf dem Desktop eine Verknüpfung zum WebSphere MQ Explorer. Diesen werden wir in Tutorial MQ3 benötigen. Zunächst können wir uns jedoch wieder von ork-win abmelden. 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 1). 1 Designing and Programming CICS Applications. O`Reilly,

3 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 1: 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 2: CICS1-Startbildschirm 3

4 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 3). 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 3: 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 4). nact DFHCE3549 Sign on is complete (Language ENU). Abbildung 4: Start der NACT-Transaktion 4

5 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 5). 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 5: 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 Prakt-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. 5

6 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 drei 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. 6