IBM i Distributed Program Calls

Das Programmiermodell IBM i Remote Command and Distributed Program Calls (DPC) ermöglicht es den meisten IBM i-Anwendungen, mit TI in Anforderungsantwort-Mode (nur clientinitiiert) mit minimalen Änderungen zu interagieren. DPC ist ein dokumentiertes Protokoll, das die Programmintegration auf einem IBM i unterstützt, auf das über PC-basierte Anwendungen mithilfe des TCP/IP-Netzwerkprotokolls problemlos zugegriffen werden kann.

Die folgende Abbildung fasst den Workflow zusammen, der zwischen dem Client, dem Standard-DPC-Server und dem IBM i Transaction-Programm erfolgt. Die Zahlen in Klammern geben die ungefähre Reihenfolge an, in der Ereignisse auftreten. Eine detailliertere Beschreibung der Ereignisse folgt der Abbildung.

IBM i-Modellfluss

Zusammenfassendes Ablaufdiagramm für das IBM i DPC-Programmiermodell

Das IBM i DPC-Programmiermodell funktioniert wie folgt:

1. Eine Anwendung ruft eine Methode in einer TI-Komponente auf, die in Component Services oder .NET Framework konfiguriert ist.

2. Die TI-Laufzeit ruft den TI Automation-Proxy auf.

3. Wenn die Anwendung eine COM+-Komponente ist, ist der TI Automation-Proxy:

   1. Liest die Typbibliotheken, die zuvor vom TI-Designer erstellt wurden.

   2. Ordnet die Automatisierungsdatentypen den IBM i RPG-Datentypen zu.

      Wenn die Anwendung eine .NET Framework-Assembly ist, dann der TI Automation-Proxy:

   3. Liest die zuvor vom TI Designer erstellte Assembly und Metadaten ein.

   4. Ordnet die .NET Framework-Datentypen den IBM i RPG-Datentypen zu.

      Der TI-Automatisierungsproxy:

   5. Ruft die Konvertierungsroutinen auf, um die Anwendungsdaten in IBM i RPG-Typen zu konvertieren.

   6. Erstellt den parametrisierten Nachrichtenpuffer, der die RPG-PLIST darstellt.

   7. Übergibt die Nachricht an die IBM i DPC-Transportkomponente.

4. Der TI TCP-Transport sendet eine Verbindungsanforderung an das DPC Server-System mithilfe der IP-Adresse (Internet Protocol) des IBM i-Computers und der Portadresse des Servers. Der TI-TCP-Transport wartet dann auf eine Antwort.

5. Der DPC-Server auf der IBM i akzeptiert die Sitzungsanforderung und gibt einen Empfang aus. Der DPC-Server wartet dann auf die Startserveranforderung.

6. Der TI-Automatisierungsproxy sendet dem DPC-Server eine Startserveranforderung und gibt einen Empfang aus. Der TI-TCP-Transport wartet dann auf eine Antwort auf den Startserver.

7. Der DPC-Server verarbeitet die Startserveranforderung, sendet eine Antwort auf den Startserver und gibt dann einen Empfang aus. Der DPC-Server wartet dann auf eine Exchange-Attributanforderung.

8. Die TI-Laufzeitumgebung verarbeitet die Startserver-Antwort, sendet die Attributanforderung und führt einen Empfang durch. Die TI-Laufzeit wartet dann auf eine Antwort auf einen Austausch von Attributen.

9. Der DPC-Server verarbeitet die Anforderung der Exchange-Attribute, sendet eine Antwort auf die Exchange-Attribute und führt dann einen Empfang aus. Der DPC wartet dann auf eine Remoteprogrammanrufanforderung.

10. Die TI-Runtime verarbeitet die Antwort auf die Attribute des Austauschs und sendet dann eine Remote-Programmanrufanforderung, gefolgt von der Antwort auf den Remote-Programmanruf und den konvertierten Daten.

11. Der DPC-Server verarbeitet die Anforderung, sendet die Remoteprogrammanrufantwort gefolgt von Remoteprogrammaufrufparametern und -daten.

12. Der TI Automation-Proxy empfängt die Antwortdaten und verarbeitet die Antwort. Der TI-Automatisierungsproxy:

    1. Empfängt die Nachricht von der TCP-Transportkomponente.

    2. Liest den Nachrichtenpuffer.

       Wenn es sich bei der Anwendung um eine COM+-Komponente handelt, ist der TI Automation-Proxy:

    3. Ordnet die IBM i-Datentypen den Automatisierungsdaten zu.

    4. Ruft die Konvertierungsroutinen auf, um die IBM i RPG-Typen in die Anwendungsdaten zu konvertieren.

       Wenn es sich bei der Anwendung um eine .NET-Assembly handelt, ist der TI Automation-Proxy:

    5. Ordnet die IBM i-Datentypen den .NET Framework-Datentypen zu.

    6. Ruft die Konvertierungsroutinen auf, um die IBM i RPG-Typen in die Anwendungsdaten zu konvertieren.

13. Die TI-Laufzeit sendet die konvertierten Daten zurück an die COM- oder .NET Framework-Anwendung, die die Methode aufgerufen hat.

    Hinweis

    Die maximale Größe einer Nachricht beträgt 32.767 Bytes, einschließlich Feldkopfzeilen und Daten.

    Hinweis

    Der RMTPGMCALL kann maximal 35 Parameter als IN oder OUT oder in beliebiger Kombination als IN/OUT übergeben.

    Hostintegrationsserver enthält Beispielcode, der zeigt, wie das IMS Connect-Programmiermodell implementiert wird. Der Beispielcode befindet sich im \Installationsverzeichnis\SDK\Samples\AppInt. Starten Sie Microsoft Visual Studio, öffnen Sie das Lernprogramm, das Sie verwenden möchten, und folgen Sie den Anweisungen in der Infodatei.

    Informationen zum Konfigurieren der Groß- und Schreibserveranwendungen für IBM IBM ie finden Sie im ILE RPG/400 Programmers Guide Version 4 (IBM Document #SC09-2507-02) und der ILE RPG/400 Reference Version 3 (IBM Document #SC09-2077-01).

Siehe auch

Transaktionsintegratorkomponenten
Konvertieren von Datentypen von RPG in Automatisierungsprozesse
Konvertieren von Datentypen von Automatisierungssystemen zu RPG
IBM i Security
COMTIContext-Schnittstelle
TI-Laufzeit
Auswählen des geeigneten Programmiermodells
Programmiermodelle