Überblick 1. Systemkonfiguration 2. Funktionsweise 3 PM-OPEN HOST/S. Connectivity Tools for SAP R/3. Systembeschreibung Version 6. Ausgabe:

Transkript

1 Überblick 1 Systemkonfiguration 2 PM-OPEN HOST/S Connectivity Tools for SAP R/3 Funktionsweise 3 4 Version Ausgabe:

2 PM-CONTROL Inhaltsverzeichnis 1 Überblick Seite Allgemeines Seite R/3 System Connectivity Tool Seite Konzept des R/3 System Connectivity Tools Seite R/3 PM Connectivity Tool Seite Konzept des R/3 PM Connectivity Tools Seite Systemkonfiguration Seite Systemkonfiguration mit SIMATIC WinCC Seite Funktionsweise Seite Allgemeines Seite PM-OPEN HOST/S Configuration Seite PM-OPEN HOST/S Applicationserver Seite Data Dictionary Objekte Seite PM-OPEN HOST/S Configuration Seite Allgemeines Seite R/3 System Connectivity Tool Seite Anmeldeinformationen für das R/3 System Connectivity Tool Seite Transferauftrag zum Senden von Variableninhalten Seite Empfangsschnittstelle in SAP R/3 Seite Sendeschnittstelle in SAP R/3 Seite R/3 PM Connectivity Tool Seite Anmeldeinformationen für das R/3 PM Connectivity Tool Seite Transferauftrag zum Senden von Zählerständen Seite Erzeugen von Störmeldungen in SAP R/3 Seite PM-OPEN HOST/S Applicationserver Seite Allgemeines 5.2 Statusmeldungen zum R/3 System Connecitvity Tool Seite Datentransfer von WinCC zu SAP R/3 Seite Datenempfang in WinCC von SAP R/3 Seite Statusmeldungen zum R/3 PM Connectivity Tool Seite RFC-Trace für PM-OPEN HOST/S Applicationserver Seite Data Dictionary Objekte 6.1 Allgemeines Seite Domänen Seite Datenelemente Seite Datenbanktabellen Seite Funktionsbausteine Seite Allgemeine Funktionsbausteine Seite Funktionsbausteine des Sendemoduls Seite Funktionsbausteine des Empfangsmoduls Seite Beispielprojekt 7.1 WinCC Beispielprojekt Seite 7-1 Siemens Aktiengesellschaft gültig ab Seite I-1

3 1 Überblick 1.1 Allgemeines PM-OPEN HOST/S bietet dem Anwender zukunftsweisende, flexible Kommunikationslösungen zwischen der Automatisierungsebene und SAP R/3. Damit sind Aufgabenstellungen im Bereich vertikaler Systemintegration in industriellen Unternehmen schnell, flexibel und kostengünstig realisierbar. PM-OPEN HOST/S nutzt die Offenheit des Prozessvisualisierungssystems SIMATIC WinCC, um Daten aus Automatisierungssystemen zu erhalten oder Daten in diese zu schreiben. Die Kommunikation mit SAP R/3 basiert auf der SAP Standardtechnologie Remote Function Calls (RFC). RFC bildet die Grundlage für die Integration mehrerer SAP-Systeme, als auch die bidirektionale Anbindungsmöglichkeit externer Systeme mit entsprechender Datenversorgung. Somit bietet diese Technik des entfernten Funktionsaufrufes als Standardschnittstelle die Möglichkeit, Funktionsbausteine in entfernten SAP-Systemen auszuführen Funktionen und Daten werden für die Verwendung in und aus anderen Systemen verfügbar gemacht. PM-OPEN HOST/S beinhaltet Connectivity Tools, die unterschiedliche in SAP R/3 abgebildete Szenarien bzw. Geschäftsprozesse mit Daten aus den Automatisierungssystemen unterstützen. 1.2 R/3 System Connectivity Tool Das R/3 System Connectivity Tool unterstützt unterschiedlichste Szenarien in der Kommunikation zwischen Automatisierungssystem und SAP R/3: Übertragen von Produktions- bzw. Prozessaufträgen aus den SAP R/3 Modulen PP und PP-PI an das Automatisierungssystem. Übertragen von Produktionsdaten wie z.b. produzierte und verbrauchte Materialien aus dem Automatisierungssystem an das Modul SAP R/3 MM. Übertragen von Stichprobenwerten aus der Produktion über das Automatisierungssystem an das Modul SAP R/3 QM. Übertragen von Maschineninformationen, vor allem Maschinenzuständen, aus den Melde- und Alarmmodulen des Automatisierungssystems an das Modul SAP R/3 CS. Weitere Szenarien sind ebenfalls realisierbar. Für diese Szenarien ist additiv die Entwicklung kundenspezifischer ABAP/4-Programme notwendig. In der aktuellen Version von PM-OPEN HOST/S sind zwei Connectivity Tools enthalten: R/3 System Connectivity Tool zur flexiblen, modulneutralen Kommunikation mit dem Basissystem von SAP R/3 1. R/3 PM Connectivity Tool zur Kommunikation mit dem Instandhaltungsmodul SAP R/3 PM. 1 Details zu den freigegebenen Systemen befinden sich in der aktuellen Produktinformation zu PM-OPEN HOST/S. Siemens Aktiengesellschaft gültig ab Seite 1-1

4 1 Überblick Konzept des R/3 System Connectivity Tools Wie aus nachfolgender Abbildung ersichtlich ist, können Parameterdatensätze (z. B. Produktionsdaten) bidirektional zwischen WinCC und SAP R/3 ausgetauscht werden. Für die Übertragung von Werten aus WinCC nach SAP R/3 werden Inhalte aus WinCC Variablen über den Schnittstellenbaustein RFC Receive in die InputTable eingetragen. Von dort erfolgt die Verteilung und Weiterverarbeitung der Daten durch kundenspezifische ABAP/4-Reports. Um Daten aus SAP R/3 in WinCC Variablen zu übertragen, müssen diese Werte in die OutputTable eingetragen werden. Das geschieht durch kundenspezifische ABAP/4-Reports, die anschließend die Übertragung der Daten durch den Aufruf des Schnittstellenbausteins RFC Send initiieren. INPUT-Tabelle, OUTPUT-Tabelle und RFC-Bausteine sind unter DataDictionary Objekte im Lieferumfang von PM-OPEN HOST/S enthalten. Abbildung: Konzept des R/3 System Connectivity Tools Siemens Aktiengesellschaft gültig ab Seite 1-2

5 1 Überblick 1.3 R/3 PM Connectivity Tool Das R/3 PM Connectivity Tool nutzt die SAP Standardschnittstelle PM-PCS und bildet das SAP Szenario Messwert- und Zählerstandübertragung sowie das Erstellen von Instandhaltungsmeldungen ab. über einen RFC-Baustein der SAP Standardschnittstelle PM-PCS. Im SAP R/3 System werden die Betriebsstunden- bzw. Schaltspielezähler in Messpunkten abgelegt, die mit Equipments oder Technischen Plätzen verknüpft sind Konzept des R/3 PM Connectivity Tools Zählerstände, wie z.b. Betriebsstunden- oder Schaltspielezähler, die mit WinCC Variablen verbunden sind, können zyklisch oder ereignisgesteuert gelesen und an SAP R/3 übertragen werden. Die Übertragung erfolgt Mit Hilfe dieser Maschineninformationen können leistungsabhängige Wartungspläne in SAP R/3 PM erstellt werden. Abbildung: Konzept des R/3 PM Connectivity Tools Siemens Aktiengesellschaft gültig ab Seite 1-3

6 2 Systemkonfiguration 2.1 Systemkonfiguration mit SIMATIC WinCC PM-OPEN HOST/S ist lauffähig auf einem WinCC Einplatzsystem oder auf einem WinCC Server. Die Anbindung der Automatisierungssysteme, auch von Fremdherstellern, erfolgt über die zahlreichen Kommunikationskanäle des WinCC Systems. In Verbindung mit einem redundanten WinCC/PCS7 Serverpaar kann PM-OPEN HOST/S auf beiden Servern als separate Lizenz installiert werden. Der Abgleich der Konfigurationsdaten sowie die Übernahme der Kommunikation im Falle eines Masterwechsels muss projektspezifisch realisiert werden. Systemkonfiguration: PM-OPEN HOST/S mit Basissystem Siemens Aktiengesellschaft gültig ab Seite 2-1

7 3 Funktionsweise 3.1 Allgemeines Die Systemsoftware von PM-OPEN HOST/S besteht aus zwei Softwaremodulen und den Data Dictionary Objekten zum Datenaustausch: PM-OPEN HOST/S Configuration die Projektierungskomponente PM-OPEN HOST/S Applicationserver die Runtimekomponente Data Dictionary Objekte Transportdateien zur Kommunikation zwischen WinCC und SAP R/3 Der Datenaustausch wird in Form von Transferaufträgen durchgeführt. In der Projektierungskomponente definieren Sie die Transferaufträge, die von der Runtimekomponente automatisch abgearbeitet werden. 3.2 PM-OPEN HOST/S Configuration In der Projektierungskomponente werden die Verbindungsdaten zum SAP R/3 System angegeben und entsprechende Transferaufträge definiert. Zum Senden bzw. Empfangen von WinCC Variableninhalten definieren Sie Transferaufträge zum R/3 System Connectivity Tool. Unter dem R/3 PM Connectivity Tool konfigurieren Sie Transferaufträge zur Übertragung von Schaltspiele-, Betriebsstundenzählerständen und Instanzmeldungen. Alle konfigurierten Transferaufträge werden übersichtlich in einer Baumstruktur abgebildet. 3.3 PM-OPEN HOST/S Applicationserver Der Applicationserver läuft als Hintergrundkomponente und arbeitet die konfigurierten Transferaufträge zum Datenaustausch zwischen WinCC und SAP R/3 ab. Die Applikation hat keine Bedienoberfläche. In der Programmoberfläche werden Statusmeldungen zur Abwicklung der Transferaufträge angezeigt. Ansicht: PM-OPEN HOST/S Applicationserver 3.4 Data Dictionary Objekte Data Dictionary Objekte werden in Form von zwei Transportdateien im Lieferumfang zur Verfügung gestellt. Diese beiden Dateien müssen über das SAP Transportsystem in das SAP Zielsystem importiert werden. Im Repository Browser über die Transaktion >>SE80<< können die Data Dictionary Objekte dargestellt werden. Sie befinden sich in der Entwicklungsumgebung ZPM_OPEN_HOST. Nach Initialisierung der Datenbanktabellen und Einrichten einer RFC Destination kann eine Verbindung zu SAP hergestellt werden. Ansicht: PM-OPEN HOST/S Configuration Ansicht: SAP System Siemens Aktiengesellschaft gültig ab Seite 3-1

8 4 PM-OPEN HOST/S Configuration 4.1 Allgemeines Die komplette Konfiguration von PM-OPEN HOST/S wird im Softwaremodul PM-OPEN HOST/S Configuration durchgeführt. Der Konfigurationsmodus wird über eine Schaltfläche aktiviert, die per Kennwort geschützt ist. Sowohl für das R/3 System Connectivity Tool, als auch für das R/3 PM Connectivity Tool sind Anmeldeinformationen für die Kommunikation zu SAP R/3 einzustellen. In Form von Transferaufträgen werden die Details zum Datentransfer definiert. Im Register SAP R/3 Verbindung wird der Name des Mandanten auf dem SAP R/3 Zielsystem angegeben, an den die Daten gesendet werden sollen. Bei Benutzername und Kennwort sind die Anmeldedaten erforderlich, unter denen sich der PM-OPEN HOST/S Applicationserver beim SAP R/3 System anmeldet. Der Benutzername muss als CPI-C oder Dialog-Benutzer im SAP R/3 Customizing eingetragen sein. Im Bereich System sind die Daten des SAP R/3 Zielsystems zu konfigurieren. 4.2 R/3 System Connectivity Tool Im R/3 System Connectivity Tool werden Anmeldeinformationen für den bidirektionale Datenaustausch definiert. Details zum Senden von WinCC Variableninhalten an SAP R/3 werden in Transferaufträgen konfiguriert. Die Transferaufträge beschreiben über RFC-Bausteine eine INPUT-Tabelle, die vom SAP System über kundenspezifisch erstellte ABAP/4 Progamme ausgelesen wird. Für den Empfang von Daten in WinCC füllt das SAP- System über entsprechende ABAP/4 Programme eine OUTPUT-Tabelle. Ein RFC-Baustein wertet den Tabelleninhalt aus und schreibt die Daten in die angegebenen WinCC Variablen. Eigenschaften System Connectivity: SAP R/3 Verbindung Anmeldeinformationen für das SAP R/3 System Connectivity Tool In den Eigenschaften zum Objekt System Connectivity stellen Sie die Anmeldeinformationen zum SAP Zielsystem ein. Informationen zu Übertragungsfehler und Übertragungsstatus können über WinCC Variablen ausgelesen werden. Die Einstellungen zum Datenempfang aus SAP R/3 werden im Register SAP R/3 Empfang konfiguriert. Die Programm ID entspricht der definierten RFC Destination im SAP R/3 Zielsystem. Weiterhin sind die Angaben zur IP-Adresse des Gateway Hosts und zum Namen des Gateway Prozesses erforderlich. Der Datenempfang aus SAP kann über eine WinCC Variable freigegeben bzw. gesperrt werden. Eigenschaften System Connectivity: Allgemeines Eigenschaften System Connectivity: SAP R/3 Empfang Siemens Aktiengesellschaft gültig ab Seite 4-1

9 4 PM-OPEN HOST/S Configuration Transferauftrag zum Senden von Variableninhalten In einem Transferauftrag werden Transfereigenschaften und Transferwerte zum Senden von Variableninhalten konfiguriert. Der Transferauftrag wird mit einem eindeutigen Namen bezeichnet. PM-OPEN HOST/S generiert automatisch eine eindeutige Auftragsnummer. Die Angabe einer Zielmodul-ID erlaubt die Zuordnung des Transferauftrags zu einem bestimmten SAP R/3 Zielmodul oder SAP- Scenario. In einem Transferauftrag können die Inhalte mehrerer WinCC Variablen übertragen werden. Zur Auswahl der Variablen besteht Zugriff auf den WinCC Variablenhaushalt. Die Angabe eines Sekundär Index als Textattribut für jede WinCC Variable ermöglicht eine direkte Zuordnung auf eine Ziel-Datenbankzelle in SAP R/3. Die Ausführung des Transferauftrags kann wahlweise zyklisch in Abhängigkeit eines einstellbaren Zeitrasters oder bei Wertänderung einer WinCC Variablen erfolgen. Transferauftrag: Transferwerte Transferauftrag: Eigenschaften Siemens Aktiengesellschaft gültig ab Seite 4-2

10 4 PM-OPEN HOST/S Configuration Empfangsschnittstelle in SAP R/3 Attribut Bezeichnung Die Empfangsschnittstelle besteht aus dem RFC Baustein RFC Receive (ZPM_OPEN_RECEIVE) und der Input-Tabelle (ZPM_INPUT). Diese Data Dictionary Objekte sind im Lieferumfang von PM-OPEN HOST/S enthalten. Zum Auslesen der empfangenen Parameter und deren Verteilung an die Zielmodule innerhalb von SAP R/3 sind entsprechende kundenspezifische ABAP/4 Programme erforderlich. ENTRY_NO Eindeutige Eintragsnummer (Primary Key), erzeugt vom SAP R/3 System ENTRY_DATE Datumsstempel von PM-OPEN HOST/S (= Messdatum) ENTRY_TIME Zeitstempel von PM-OPEN HOST/S (= Messzeit) TAID Transaktions-ID, erzeugt vom SAP R/3 System Struktur der Input-Tabelle In dieser Tabelle wird für jeden empfangenen WinCC- Parameter ein Datensatz angelegt. Die Bündelung der zusammengehörigen Parameter wird durch die jeweils gleiche Transaktions-ID (Attribut TAID) erreicht. TAGNAME TAGVALUE TAGSTATE SECINDEX APPID STATION Name der WinCC Variablen Aktueller Wert der WinCC Variablen Status der WinCC Variablen Textattribut, parameterspezifische Zusatzinformation Textattribut, transferspezifische Zusatzinformation Zusatzinformation, die den sendenden PMOPEN HOST/S Applicationserver kennzeichnet Abbildung: Konzept des R/3 System Connectivity Tools Siemens Aktiengesellschaft gültig ab Seite 4-3

11 4 PM-OPEN HOST/S Configuration Sendeschnittstelle in SAP R/3 Das Übertragen von Parameterwerten aus SAP R/3 an WinCC Variable erfolgt über die Output-Tabelle. Mit kundenspezifisch erstellten ABAP/4 Programmen wird die Output-Tabelle beschrieben und anschließend der Baustein RFC Send aufgerufen, um die Übertragung ins Prozessabbild von WinCC anzustoßen. Die Parameterwerte werden direkt in die angegebenen WinCC Variablen geschrieben. Über eine konfigurierbare Sperrvariable kann der Schreibvorgang gesperrt werden. Die DataDictionary Objekte ZPM_OUTPUT und ZPM_OPEN_TRANSMIT sind im Lieferumfang von PM- OPEN HOST/S enthalten. Struktur der Output-Tabelle In dieser Tabelle wird für jeden zu sendenden Parameter ein Datensatz angelegt. Die Bündelung der zusammengehörigen Parameter wird durch die jeweils gleiche Transaktions-ID (Attribut TAID) erreicht. Attribut ENTRY_NO Bezeichnung Eindeutige Eintragsnummer (Primary Key), erzeugt vom SAP R/3 System TAID Transaktions-ID, erzeugt vom SAP R/3 Systems RFC_DEST RFC Destination, in die der Parameterdatensatz übertragen werden soll Zur Vorsorgung der Output-Tabelle mit den zu sendenden Parameterwerten sind entsprechende kundenspezifische ABAP/4 Programme erforderlich. TAGNAME TAGVALUE SECINDEX Name der WinCC Variablen Wert, der in die WinCC Variable geschrieben wird Textattribut, parameterspezifische Zusatzinformation Abbildung: Konzept des R/3 System Connectivity Tools Siemens Aktiengesellschaft gültig ab Seite 4-4

12 4 PM-OPEN HOST/S Configuration 4.3 R/3 PM Connectivity Tool Für das R/3 PM Connectivity Tool werden Anmeldeinformationen für die Datenübertragung zu SAP R/3 definiert. Details zum Senden der Daten an SAP R/3 werden in Transferaufträgen konfiguriert. Die Übertragung erfolgt über einen RFC-Baustein der SAP Standardschnittstelle PM-PCS Anmeldeinformationen für das SAP R/3 PM Connectivity Tool In den Eigenschaften zum Objekt PM Connectivity stellen Sie die Anmeldeinformationen zum SAP Zielsystem ein. Informationen zu Übertragungsfehler und Übertragungsstatus können über WinCC Variablen ausgelesen werden. Eigenschaften PM-Connectivity: Meldungsübertragung Im Register SAP R/3 Verbindung wird der Name des Mandanten auf dem SAP R/3 Zielsystem angegeben, an den die Daten gesendet werden sollen. Bei Benutzername und Kennwort sind die Anmeldedaten erforderlich, unter denen sich der PM-OPEN HOST/S Applicationserver beim SAP R/3 System anmeldet. Der Benutzername muss als CPI-C oder Dialog-Benutzer im SAP R/3 Customizing eingetragen sein. Im Bereich System sind die Daten des SAP R/3 Zielsystems zu konfigurieren. Eigenschaften PM-Connectivity: PM-Connectivity Die Meldungsübertragung wird generell aktiviert bzw. deaktiviert. Informationen zu Übertragungsfehler und Übertragungsstatus können über WinCC Variablen ausgelesen werden. Im Bereich Meldungsreferenzen unter Zuordnungsdaten werden alle vorhandenen Messstellenkennzeichen (MKZ) und deren zugehörigen Technische Plätze in Form einer ASCII-Datei gepflegt. Unter Schadensdaten sind die Daten für Instandhaltungsmeldungen zu hinterlegen. Eigenschaften PM-Connectivity: SAP R/3 Verbindung Siemens Aktiengesellschaft gültig ab Seite 4-5

13 4 PM-OPEN HOST/S Configuration Transferauftrag zum Senden von Zählerständen Zur Auswahl der Variablen besteht Zugriff auf den WinCC Variablenhaushalt. In einem Transferauftrag werden Transfereigenschaften und Transferwerte zum Senden der Zählerstände von Schaltspiele- oder Betriebsstundenzählern konfiguriert. Der Transferauftrag wird mit einem eindeutigen Namen bezeichnet. PM-OPEN HOST/S generiert automatisch eine eindeutige Auftragsnummer. Die Angabe einer Zielmodul-ID erlaubt die Zuordnung des Transferauftrags zu einem bestimmten SAP R/3 Zielmodul oder SAP- Scenario. Die Ausführung des Transferauftrags kann wahlweise zyklisch in Abhängigkeit eines einstellbaren Zeitrasters oder bei Wertänderung einer WinCC Variablen erfolgen. Transferauftrag: Messpunkte Transferauftrag: Eigenschaften In einem Transferauftrag können mehrere Werte übertragen werden. Für jeden Wert sind folgende Daten anzugeben: Attribut Messpunkt Erfassungseinheit Variablenname Sekundär Index Kurztext Beschreibung Messpunktnummer in SAP R/3, die den Variablenwert aufnimmt Einheit des Messwerts wie in SAP R/3 hinterlegt Name der WinCC Variablen mit dem Zählerstandwert Textattribut als Zusatzinformation Erläuterung Konfiguration eines Messpunkts Siemens Aktiengesellschaft gültig ab Seite 4-6

14 4 PM-OPEN HOST/S Configuration Erzeugen von Störmeldungen in SAP R/3 PM Zum Erzeugen von Meldungen sind die C-Funktionen CreateNotificationEx und CreateAndCloseNotificationEx zum Aufruf aus WinCC V7 im Lieferumfang von PM- OPEN HOST/S enthalten. Diese Funktionen generieren über die zertifizierte Schnittstelle BAPI in SAP R/3 PM Störmeldungen. Die Funktion CreateNotificationEx legt eine Störmeldung vom Typ M2 mit dem Status Offen in SAP R/3 PM an. Die Funktion CreateAndCloseNotificationEx erzeugt eine Störmeldung vom Typ M2 mit dem Status Offen und wieder Geschlossen. Die entsprechende Funktion wird in WinCC in eine Global Script Funktion eingebunden und mit den entsprechenden Daten versorgt. Zur Versorgung der Funktionen mit Daten können Meldungen aus dem WinCC Alarm Logging herangezogen werden. DWORD WINAPI CreateNotificationEx(DWORD dwwinccmsgno, SYSTEMTIME stwincctimestamp, TCHAR* szwinccinstance, TCHAR* szwinccobjectid, TCHAR* Plangroup, TCHAR* Planplant, TCHAR* Sender, TCHAR* User, TCHAR* Short_Text, TCHAR* Notif_Date, TCHAR* Notiftime, TCHAR* Strmlfndate, TCHAR* Strmlfntime, TCHAR* Endmlfndate, Struktur der Funktion CreateNotificationEx In der Online-Hilfe von PM-OPEN HOST/S werden die Parameter der Funktion und die Abbildung auf die korrespondierenden SAP Datenfelder detailliert beschrieben. TCHAR* Endmlfntime, TCHAR* Breakdown, TCHAR* Longtext ); Siemens Aktiengesellschaft gültig ab Seite 4-7

15 5 PM-OPEN HOST/S Applicationserver 5.1 Allgemeines Der PM-OPEN HOST/S Applicationserver ist die Runtimekomponente, die die konfigurierten Transferaufträge bearbeitet und den Datentransfer zwischen WinCC und SAP R/3 abwickelt. Der Applicationserver ist als Hintergrundkomponente aktiv. In seiner Programmoberfläche werden sowohl Status-, als auch Fehlermeldungen zum Datentransfer angezeigt. 5.2 Statusmeldungen zum R/3 System Connecitvity Tool Datentransfer von WinCC zu SAP R/3 Transferaufträge von WinCC zum SAP R/3 Basissystem werden mit zwei Meldeeinträgen dokumentiert, wobei jeder Transfervorgang mit einer TAID (Transaktions-ID) gekennzeichnet wird. Ein Meldeeintrag beschreibt das Erzeugen des Transferauftrags durch PM-OPEN HOST/S mit Zeitstempel und erzeugter Source-TAID. Ein weiterer Meldeeintrag zeigt mit Zeitstempel den Datenempfang von SAP R/3 an und dokumentiert die HOST-TAID, die SAP für die empfangenen Daten generiert hat. Die Kennung (SC) im Meldetext signalisiert, dass der Meldeeintrag dem R/3 System Connectivity Tool zu zuordnen ist. 5.3 Statusmeldungen zum R/3 PM Connectivit Tool Transferaufträge von WinCC zu SAP R/3 PM werden mit drei Meldungen dokumentiert. Der erste Meldeeintrag enthält die Source-TAID, die von PM-OPEN HOST/S beim Abschicken des Transferauftrags erzeugt wurde. Daraufhin folgt die Mitteilung, welcher Messwert zu welchem Messpunkt übertragen wurde und die Angabe der Messbelegnummer. Abschließend wird der Erfolg der Datenübertragung bestätigt. Alle Meldungen enthalten den aktuellen Zeitstempel. Die Kennung (PM) im Meldetext signalisiert, dass der Meldeeintrag dem R/3 PM Connectivity Tool zu zuordnen ist. Meldungen zum Senden an SAP R/3 PM Eventuell auftretende Fehler bei der Datenübertragung werden im Meldetext mit einem entsprechenden RFC- Fehlercode kommentiert. Weiterhin werden zur fehlgeschlagenen Messpunktübertragung RFC- EXCEPTIONS von SAP zur Fehleranalyse ausgegeben. Meldungen zum Senden an SAP R/3 Eventuell auftretende Fehler bei der Datenübertragung werden im Meldetext mit einem entsprechenden RFC- Fehlercode kommentiert Datenempfang in WinCC von SAP R/3 Jeder Parameter, der von SAP R/3 in WinCC empfangen wurde, wird mit einem Meldungseintrag dokumentiert. Dieser enthält die von SAP R/3 für diesen Parameter generierte HOST-TAID. Parameter mit gleicher HOST- TAID wurden zu einem Parameterdatensatz gebündelt. 5.4 RFC-Trace für PM-OPEN HOST/S Applicatio server Im Problemfall oder zur Inbetriebnahme kann der RFC- Trace aktiviert werden. Bei aktiviertem Trace werden alle gesendeten und empfangenen Daten zwischen PM- OPEN HOST/S Applikationserver und dem SAP-System protokolliert. Aus Performancegründen sollte eine Aktivierung im Normalbetrieb nicht erfolgen. Auch im SAP-System bestehen Möglichkeiten, die Daten der RFC-Schnittstelle zur protokollieren. Z.B. können Berechtigungsprobleme des Schnittstellenbenutzers diagnostiziert werden. Siemens Aktiengesellschaft gültig ab Seite 5-1

16 6 Data Dictionary Objekte 6.1 Allgemeines Zum Datenaustausch zwischen dem PM-OPEN HOST/S R/3 System Connectivity Tool und SAP R/3 sind Data Dictionary Objekte in Form von zwei Transportdateien im Lieferumfang enthalten. Der Installationsvorgang ist mit dem SAP R/3 Transportsystem durchzuführen. Der Lieferumfang umfasst folgende Objekte: Domänen Datenelemente Datenbanktabellen Programme Funktionsbausteine 6.2 Domänen ZPM_D_C255 ZPM_D_C128 ZPM_D_C32 ZPM_D_NC10 ZPM_D_NC2 ZPM_D_DAT S ZPM_D_TIMS 6.3 Datenelemente Domäne für eine Zeichenkette der Länge 255 Zeichen Domäne für eine Zeichenkette der Länge 128 Zeichen Domäne für eine Zeichenkette der Länge 32 Zeichen Domäne für eine numerische Zeichenkette der Länge 10 Zeichen Domäne für eine numerische Zeichenkette der Länge 2 Zeichen Domäne für eine Datums- Zeichenkette der Länge 8 Zeichen (Format: JJJJMMTT, Jahr, Monat; Tag) Domäne für eine Datums- Zeichenkette der Länge 8 Zeichen (Format: SSMMSS, Stunde, Minute, Sekunde) ZPM_E_DATS ZPM_E_TIMS 6.4 Datenbanktabellen ZPM_CNTRL ZPM_INPUT ZPM_OUTPUT ZPM_LOGTAB ZPM_HELP Datenelement für eine Datums- Zeichenkette der Länge 8 Zeichen (Format: JJJJMMTT, Jahr, Monat; Tag) Datenelement für eine Datums- Zeichenkette der Länge 8 Zeichen (Format: SSMMSS, Stunde, Minute, Sekunde) Steuertabelle für das R/3 System Connectivity Tool für die Verwaltung von Datenbank-IDs und Transaktions-IDs Tabelle, in die vom Sendemodul die WinCC Transferwerte eingetragen werden Tabelle, aus der die SAP Parameter vom Empfangsmodul an PM-OPEN HOST/S übertragen werden Tabelle, in die Diagnoseeinträge vom Empfangs- und vom Sendemodul eingetragen werden Test-Tabelle 6.5 Funktionsbausteine Die mitgelieferten Funktionsbausteine sind als RFC (remote function call) fähige Bausteine in der Funktionsgruppe ZPM_OPEN_HOST_FCTS hinterlegt Allgemeine Funktionsbausteine Z_PMOPEN_INIT_CONTROL_TABLE Initialisiert die Steuertabelle ZPM_CNTRL und muss bei der Inbetriebnahme des R/3 System Connectivity Tools einmal aufgerufen werden. ZPM_E_C255 ZPM_E_C128 ZPM_E_C32 ZPM_E_NC10 ZPM_E_NC2 Datenelement für eine Zeichenkette der Länge 255 Zeichen Datenelement für eine Zeichenkette der Länge 128 Zeichen Datenelement für eine Zeichenkette der Länge 32 Zeichen Datenelement für eine numerische Zeichenkette der Länge 10 Zeichen Datenelement für eine numerische Zeichenkette der Länge 2 Zeichen Z_PMOPEN_GET_ID Liefert aktuelle, eindeutige Eintragsnummern (Primary Keys) und Transaktions-IDs. Z_PMOPEN_LOG Fügt einen Satz in die Ereignisprotokoll-Tabelle ZPM_LOGTAB ein. Z_PMOPEN_GET_LOG_STAT Prüft, ob das Ereignisprotokoll aktiviert ist und Ereignisse in der Tabelle ZPM_LOGTAB mitgeschrieben werden sollen. Siemens Aktiengesellschaft gültig ab Seite 6-1

17 6 Data Dictionary Objekte Funktionsbausteine des Sendemoduls PM- OPEN HOST/S: Z_PMOPEN_RECEIVE Diese Funktion wird vom R/3 System Connectivity Tool aufgerufen, um Parameter von WinCC in die Tabelle ZPM_INPUT zu übertragen. Z_PMOPEN_RECEIVE_ERR_LOG_ON Mit dieser Funktion kann innerhalb des SAP R/3 Systems das Mitschreiben von Fehlerereignissen in die Tabelle ZPM_LOG_TAB eingeschaltet werden. Z_PMOPEN_RECEIVE_ERR_LOG_OFF Mit dieser Funktion kann innerhalb des SAP R/3 Systems das Mitschreiben von Fehlerereignissen in die Tabelle ZPM_LOG_TAB ausgeschaltet werden. Z_PMOPEN_RECEIVE_LOG_ON Mit dieser Funktion kann innerhalb des SAP R/3 Systems das Mitschreiben von Ereignissen in die Tabelle ZPM_LOG_TAB eingeschaltet werden. Z_PMOPEN_RECEIVE_LOG_OFF Mit dieser Funktion kann innerhalb des SAP R/3 Systems das Mitschreiben von Ereignissen in die Tabelle ZPM_LOG_TAB ausgeschaltet werden Funktionsbausteine des Empfangsmoduls von PM-OPEN HOST/S: Z_PMOPEN_PCS_RCV Funktionsbeschreibung des Empfangsbausteins von PM- OPEN HOST/S. Diese Funktion wird von Z_PMOPEN_TRANSMIT aufgerufen, um Parameter aus der Tabelle ZPM_OUTPUT an PM-OPEN HOST/S zu übertragen und in WinCC Variablen zu schreiben. Z_PMOPEN_TRANSMIT Diese Funktion wird innerhalb des SAP R/3 Systems aufgerufen und überträgt die Inhalte der Tabelle ZPM_OUTPUT an die Funktion Z_PMOPEN_PCS_RCV von PM-OPEN HOST/S, die diese Parameter in WinCC Variablen schreibt. Z_PMOPEN_TRANSMIT_ERR_LOG_ON Mit dieser Funktion kann innerhalb des SAP R/3 Systems das Mitschreiben von Fehlerereignissen in die Tabelle ZPM_LOG_TAB eingeschaltet werden. Z_PMOPEN_TRANSMIT_ERR_LOG_OFF Mit dieser Funktion kann innerhalb des SAP R/3 Systems das Mitschreiben von Fehlerereignissen in die Tabelle ZPM_LOG_TAB ausgeschaltet werden. Z_PMOPEN_TRANSMIT_LOG_ON Mit dieser Funktion kann innerhalb des SAP R/3 Systems das Mitschreiben von Ereignissen in die Tabelle ZPM_LOG_TAB eingeschaltet werden. Z_PMOPEN_TRANSMIT_LOG_OFF Mit dieser Funktion kann innerhalb des SAP R/3 Systems das Mitschreiben von Ereignissen in die Tabelle ZPM_LOG_TAB ausgeschaltet werden. Siemens Aktiengesellschaft gültig ab Seite 6-2

18 7 Beispielprojekt 7.1 Bespielprojekt Um den Einstieg in die Konfiguration zu PM-OPEN HOST/S zu erleichtern, ist im Lieferumfang ein WinCC Bespielprojekt enthalten. Das Beispielprojekt zeigt einen Variablenaustausch zu SAP R/3 und das Senden von Betriebsstunden- und Schaltspielezählern zu SAP R/3 PM. Zur vollen Funktionalität ist eine Verbindung zu einem SAP R/3 System erforderlich. Entsprechende Data Dictionary Objekte und Datenbanktabellen müssen importiert und initialisiert werden. Die erforderlichen Installationen und die Handhabung des Beispielprojekts sind in der Online-Hilfe zu PM-OPEN HOST/S ausführlich dokumentiert. Siemens Aktiengesellschaft gültig ab Seite 7-1

19 Process Management System Wirtschaftlich automatisieren mit Standardsoftware PM-CONTROL Rezeptur-/Produktdatenverwaltung, Auftragssteuerung PM-QUALITY Auftrags-/Chargenorientierte Archivierung und Protokollierung PM-MAINT Intelligentes Instandhaltungsmanagementsystem PM-ANALYZE Analyse von Meldungen und Prozess-/ Produktionsdaten PM-OPEN Kommunikations- und Integrationslösungen SIMATIC WinCC ist eine Marke der Siemens AG. Die übrigen Bezeichnungen in dieser Druckschrift können Marken sein, deren Benutzung durch Dritte für deren Zwecke die Rechte der Inhaber verletzen können. Weitere technische Infos? Ihr Vertriebspartner: Ihr autorisiertes WinCC Competence Center Mannheim Telefon: (+49) (+49) (+49) Fax: (+49) Internet: Siemens AG Siemens Deutschland Industry Sector Industry Solutions Division WinCC Competence Center Dynamostraße 4 D Mannheim Die Informationen in diesem Produktkatalog enthalten Beschreibungen bzw. Leistungsmerkmale, welche im konkreten Anwendungsfall nicht immer in der beschriebenen Form zutreffen bzw. welche sich durch Weiterentwicklung der Produkte ändern können. Die gewünschten Leistungsmerkmale sind nur dann verbindlich, wenn sie bei Vertragsschluss ausdrücklich vereinbart werden. Liefermöglichkeiten und technische. Alle Erzeugnisbezeichnungen können Marken oder Erzeugnisnamen der Siemens AG oder anderer, zuliefernder Unternehmen sein, deren Benutzung durch Dritte für deren Zwecke die Rechte der Inhaber verletzen kann. Siemens AG 2010 Printed in Germany Best.-Nr. 9AE WE02-0AA0