Mit dieser GET_RELATION lassen sich in Zusammenhang mit der 4020-GET_RELATION Send und Beende-Aktionen ausführen.
Es muss also immer zuerst mit der GET_REL4020 eine Kommunikation mit StartServer=J gestartet werden.
GET_RELATION [4021!PortName!Action!SendDaten!]
Ausführen einer Aktion mit einer offenen Kommunikation
PortName ▶ Name der zuvor bei der Registrierung von GET_RELATION[4020..] angegeben wurde.
Action(S/C) ▶ S=Sende Daten C=Close (Port schließen)
Senddaten ▶ Bei Action = S werden hier die Daten übergeben, die an den Kommunikationsport gesendet werden sollen.
Beispiele für die Benutzung der GET_RELATIONs 4020 + 4021
Für die Named-Pipe Tests stehen Ihnen im Verzeichnis bin\wws\test\ die Programme wwpipe.exe und wwpipesrv.exe zur Verfügung.
Mit wwpipe.exe können Sie Daten vom WWCC testweise empfangen und ausgeben. Mit der wwpipesrv.exe können Sie den WWCC simulieren und bei Ihre eigene Umgebung testen.
Beispiel1: Sende einen Wert an einen WWCC-Kommunikationsport mit Named-Pipe
GET_RELATION[4020!N!S!P!TESTPIPE!!13:10!40:50!WLRECV!Ich bin der Daten Stream!]
Mit dem obigen Befehl wird eine Named-Pipe Verbindung auf dem WWCC eröffnet und der Text „Ich bin der Daten Stream“ an die Ziel-Pipe \\.\PIPE\TESTPIPE gesendet.
Sie können dies auf dem WWCC mit Hilfe des Programmes bin\wws\test\WWPIPE.exe empfangen. Hierzu muss das Programm mit folgenden Parametern aufgerufen werden: WWPIPE.exe r\\.\pipe\testpipe
Beispiel2: Verwende einen Named-Pipe-Server und sende mehrere Daten
GET_RELATION[4020!J!S!P!TESTPIPE!!13:10!40:50!WWLRECV!Ich bin der erste Satz!]
Öffne eine Named-Pipe Verbindung mit dem Namen \\.\PIPE\TESTPIPE auf dem WWC und sende den Text „Ich bin der erste Satz“ über die Verbindung.
Nach erfolgreicher Übertragung bleibt der Sende- Server bestehen
GET_RELATION[4021!TESTPIPE!S!Ich bin die 2. Zeile bzw. Satz!]
Rufe den bestehenden Named-Pipe-Server \\.\PIPE\TESTPIPE auf dem WWCC auf und übertrage den Satz „Ich bin die 2. Zeile bzw. Satz“.
GET_RELATION[4021!TESTPIPE!C!!]
Beende den Named-Pipe-Server über den WWCC mit dem Namen \\.\PIPE\TESTPIPE
Sie können die Ausgaben mit Hilfe des Programms bin\wws\test\WWPipe.exe empfangen
WWPIPE.exe r \\.\pipe\testpipe
Falls Sie beim Aufruf bzw. der Erzeugung der Kommunikation einen WFL-Receiver angegeben haben, wird beim Beenden der Verbindung eine Ende-Meldung übergeben.
Beispiel3: Lese eine Named-Pipe einmal aus
Hierbei wird auf dem WWCC einmalig eine Named-Pipe abgefragt. Erst wenn Daten vorhanden sind, erfolgt eine Rückgabe. Ist ein Wert vorhanden, so wird dieser Wert an den beim Aufruf angegeben Rückruf-Workflow übergeben. Ebenso kommt danach ein Aufruf, dass der Port geschlossen wurde (CLS).
GET_RELATION[4020!N!R!P!TESTPIPE!!13:10!40:50!WL0001!]
Die eingehenden Meldungen werden dann beim Aufruf des Rückruf-Callback (WL0001) übergeben. Sie erhalten dort 2 Parameter.
Parameter 1 ist der Name des Port’s (TESTPIPE), der 2. Parameter ist eine Zahl von 0 bis 9. Mit dieser Zahl können Sie durch Aufruf der GET_RELATION[4015!TESTPIPE!PARA2] den Namen der temporären Datei erhalten, in dem sich die gelesenen Daten befinden.
Beispiel4: Lese alle Meldungen einer Named-Pipe aus
Diese Meldung unterscheidet sich nur durch die Angabe von StartServer==StartServer.
Dabei wird die Verbindung lokal ständig abgefragt und immer wenn ein Datensatz über NamedPipe gelesen wurde, wird dieser übergeben.
Es können dabei maximal 10 Meldungen anstehen, es gibt also hier je Named-Pipe 10 lokale temporäre Dateien, die ihnen jeweils mit dem Aufruf Ihres Rückruf-Callback (WL0001) gemeldet werden.
Sind mehr als 10 Meldungen anstehend, also nicht von Ihnen bearbeitet, so wird die älteste Nachricht überschrieben.
GET_RELATION[4020!J!R!P!TESTPIPE!!13:10!40:50!WL0001!]
Wenn Sie einen Server Beenden wollen, so rufen Sie folgende Funktion auf
GET_RELATION[4021!TESTPIPE!C!!]