WebSphere MQ (MQSeries) The Message Queueing Interface (MQI)

Größe: px

Ab Seite anzeigen:

Download "WebSphere MQ (MQSeries) The Message Queueing Interface (MQI)"

Claus Baum
vor 7 Jahren
Abrufe

1 Hanseatic Mainframe Summit 2008 WebSphere MQ (MQSeries) The Message Queueing Interface (MQI) Marcel Amrein, IBM SWG Technical Sales Copyright IBM Corporation 2006,2008 This material may not be reproduced in whole or in part without the prior written permission of IBM 402

2 Die MQI-Philosophie Einfache CALL-Schnittstelle Begrenzte Anzahl von Aufrufen Funktionsvielfalt Sinnvolle Standard- und Anfangswerte Mitgelieferte 'Include' und 'Copy'-Dateien für die Definitionen von: Strukturen Konstanten

3 Notation WebSphere MQ-Application Programming Reference MQPUT1 (Hconn, ObjDesc, MsgDesc, PutMsgOpts, BufferLength, Buffer, CompCode, Reason) Äquivalent in C MQPUT1 (Hconn, &ObjDesc, &MsgDesc, &PutMsgOpts, BufferLength, Buffer, &CompCode, &Reason); Äquivalent in COBOL CALL "MQPUT1" USING HCONN, OBJDESC, MSGDESC, PUTMSGOPTS, BUFFERLENGTH, BUFFER, COMPCODE, REASON

4 MQCONN-Aufruf Anwendung MQCONN Connection Handle Completion Code Reason Code Queue Manager-Name Verbindung Queue Manager

5 MQCONNX-Aufruf Anwendung MQCONNX Connection Handle Completion Code Reason Code Queue Manager-Name Connection Options Verbindung Queue Manager

6 Remote Queue Manager Local Queue Anwendung : MQCONN : Local Queue Manager Remote Queue Manager Remote Queue Remote Queue Remote Manager Queue

7 MQOPEN-Aufruf Connection Handle Objektdeskriptor Optionen Anwendung MQOPEN Verbindung Queue manager Zugriff Object handle Completion Code Reason Code

8 MQPUT-Aufruf Connection Handle Object handle Nachrichtendeskriptor Put-Message-Optionen Anwendungsdaten Anwendung MQPUT Verbindung Queue Manager Zugriff Completion Code Reason Code Nachricht

9 MQGET-Aufruf Connection Handle Object Handle Get-Message-Optionen Anwendung MQGET Verbindung Queue Manager Zugriff Nachrichtendeskriptor Anwendungsdaten Completion Code Reason Code Nachricht

10 Get-Message-Optionen (GMO) Warten Signal setzen Ab Queue-Start anzeigen Ab aktueller Position in Queue anzeigen Nachricht unter Browse-Cursor abrufen Innerhalb Syncpoint-Steuerung Ausserhalb Syncpoint-Steuerung Abgekürzte Nachricht akzeptieren Anwendungsdaten konvertieren

11 MQPUT1-Aufruf Connection Handle Objektdeskriptor Nachrichtendeskriptor Put-Message-Optionen Anwendungsdaten Anwendung MQPUT1 Verbindung Queue Manager Zugriff Completion Code Reason Code Nachricht

12 MQINQ-Aufruf Connection Handle Object Handle Attributselektoren Anwendung MQINQ Verbindung Queue Manager Zugriff Attributwerte Completion Code Reason Code Prozessobjekt Queue- Manager- Objekt Attributwerte

13 MQSET-Aufruf Connection Handle Object handle Attributselektoren Attributwerte Anwendung MQSET Verbindung Queue Manager Zugriff Completion Code Reason Code Attributwerte

14 Zusätzliche MQI-Aufrufe MQBEGIN MQCMIT MQBACK

15 Einige Felder im Nachrichtendeskriptor Nachrichtendeskriptor Anwendungsdaten Persistenz Priority MsgId CorrelId Report Feedback ReplyToQ ReplyToQMgr Expiry GroupId MsgSeqNumber Offset Format Encoding CodedCharSetId

16 Nachrichten-Persistenz Persistente Nachricht Anwendung Queue Manager Protokoll MQPUT Nicht-persistente Nachricht CC/RC CC/RC MQPUT

17 Abruf nach Priorität 0 3 FIFO Prioritäten 3-9 FIFO FIFO Priorität 2 1 3

18 Antworten und Reports Lokaler Queue Manager Remote Queue Manager Programm MQOPEN MQPUT Remote Queue Definition CC/RC CC/RC Transmission Queue Reply-to Queue Ziel-Queue Reports Ausnahme/Exception Verfall/Expiration COA COD

19 Ablaufzeitpunkt = Expiration MQPUT MQGET Anwendung A Anwendung B Abgelaufene Zeit

20 Nachrichtengruppe und Segmentierung Nachrichtengruppe Logische Nachricht 1 Logische Nachricht 2 Logische Nachricht 3 Segment 1 Segment 2 Eine Nachrichtengruppe: Besteht aus einer oder mehreren logischen Nachrichten Eine logische Nachricht ist: Eine physische Nachricht (wenn keine Aufteilung in Segmente vorgenommen wurde) durch die Felder GroupId und MsgSeqNumber im Nachrichtendeskriptor gekennzeichnet Dies ist notwendig zur: Sicherstellung der Sortierung beim Abruf (wenn diese nicht bereits gewährleistet ist) Ermöglichung der Gruppierung von verwandten Nachrichten durch die Anwendung Segmentierung ist erforderlich, wenn eine Nachricht zu gross ist Segmentierung und Zusammensetzung kann durch die Anwendung und QMGR erfolgen

21 Verteilerliste (Distribution List) CALL MQOPEN CALL MQPUT HURSLEY? DALLAS PARIS? Verteilerliste ObjectName MAIL_IN_HURSLEY ObjectQMgrName DALLAS SEATTLE MAIL_IN_PARIS MAIL_IN_DALLAS MAIL_IN_SEATTLE MAIL_IN MAIL_IN

22 Zusammenfassung Eine begrenzte Anzahl von MQI-Verben bietet umfangreiche Funktionalität MQI-Aufrufe sind portierbar MQI erlaubt den Programmen die Steuerung der Zustellung der Nachricht Statusberichte über die Nachrichtenzustellung können angefordert werden

Ähnliche Dokumente

Enterprise Computing Einführung in das Betriebssystem z/os. Prof. Dr. Martin Bogdan Prof. Dr.-Ing. Wilhelm G. Spruth WS2012/2013. WebSphere MQ Teil 4

UNIVERSITÄT LEIPZIG Enterprise Computing Einführung in das Betriebssystem z/os Prof. Dr. Martin Bogdan Prof. Dr.-Ing. Wilhelm G. Spruth WS2012/2013 WebSphere MQ Teil 4 MQI API el0100 Copyright W. G. Spruth,