Dieses Kapitel behandelt die folgenden Themen:
Um eine Konversation zu eröffnen:
Geben Sie auf der Client-Seite ein
OPEN
CONVERSATION-Statement an.
Geben Sie in dem OPEN CONVERSATION-Statement eine
Liste von Diensten (Services, die in Form von Subprogrammen realisiert sind)
als Teilnehmer dieser Konversation an.
Das OPEN CONVERSATION-Statement weist der
Systemvariablen *CONVID
ein eindeutige Konversationskennung zu.
Es kann mehr als eine Konversation parallel geöffnet sein. Wenn
Subprogramme sich gegenseitig stören, sind die Anwendungsprogramme dafür
zuständig, die verschiedenen Konversationen zu verwalten, indem sie die
entsprechende Systemvariable *CONVID setzen, die
vom CALLNAT-Statement
ausgewertet wird.
Ist das Subprogramm Teil der aktuellen Konversation (durch
*CONVID referenziert), wird es in der Server-Task
ausgeführt, die ausschließlich für diese Konversation reserviert ist.
Ist es nicht Teilnehmer der aktuellen Konversation, wird es in einer anderen Server-Task ausgeführt. Dies gilt auch für unterschiedliche Konversationen.
Eine Konversation kann auf jeder Programmebene geöffnet werden und
CALLNAT-Statements innerhalb dieser Konversation können auf jeder
anderen Programmebene darunter oder darüber ausgeführt werden.
Es ist möglich, eine Client-Konversation innerhalb eines entfernt
(remote) auf einem Server ausgeführten CALLNAT zu öffnen, so dass
der Server als Agent fungiert. Da der Client nur seine eigenen Konversationen
kontrolliert und nicht die des Servers, muss der Anwendungsprogrammierer
sicherstellen, dass die Konversation auf dem Server ordnungsgemäß beendet wird,
bevor der Haupt-Client geschlossen wird.
Der konversationelle RPC kann noch lokal getestet werden. Um das
Verhalten identisch zu halten, wenn Sie einen konversationellen
CALLNAT entfernt (remote) oder lokal ausführen, gelten die
folgenden zusätzlichen Einschränkungen:
Ein CLOSE
CONVERSATION ist nicht möglich innerhalb eines Objekts, das
gerade als Teilnehmer an dieser Konversation läuft. Dies entspricht der
Einschränkung, dass es nicht möglich ist, eine Konversation aus einem entfernt
(remote) laufenden Programm heraus zu beenden.
Es ist nicht möglich, ein konversationelles
CALLNAT, das Mitglied der Konversation ist, aus einem anderen
(oder demselben) Teilnehmer an dieser Konversation heraus auszuführen. Dies
entspricht der Einschränkung, dass es nicht möglich ist, ein konversationelles
CALLNAT, das Mitglied der Konversation des Clients ist, von einem
Server-Subprogramm aus auszuführen.
Es wird nicht empfohlen, eine Konversation aus einem Subprogramm einer anderen Konversation heraus zu eröffnen.
Um eine Konversation zu beenden:
Geben Sie ein CLOSE
CONVERSATION-Statement auf der Client-Seite an.
Damit kann der Client eine bestimmte Konversation oder alle Konversationen schließen. Alle Kontextvariablen der beendeten Konversation werden dann freigegeben und die Server-Task ist wieder für einen anderen Client verfügbar.
Wenn Sie Natural beenden, schließen Sie damit implizit alle Konversationen.
Wenn ein Server ein CLOSE CONVERSATION-Anforderung
erhält, gibt er ein CLOSE CONVERSATION ALL-Statement aus, so dass
alle Konversationen, die der Server (als Agent) geöffnet haben könnte,
ebenfalls geschlossen werden.
Wenn ein CLOSE CONVERSATION-Statement ausgeführt wird,
wird standardmäßig die Rollback-Option zusammen mit dem CLOSE
CONVERSATION-Statement an den Server gesendet. Dies führt am Ende der
Konversationsverarbeitung zu einem impliziten
BACKOUT
TRANSACTION auf der Server-Seite.
Sie können die in der Library SYSEXT verfügbare
Anwendungsprogrammierschnittstelle USR2032N verwenden, um ein
implizites END
TRANSACTION auf der Serverseite auszulösen.
Die Anwendungsprogrammierschnittstelle muss vor der Ausführung des
nächsten CLOSE CONVERSATION-Statement aufgerufen werden. Dies hat
zur Folge, dass die Commit-Option zusammen mit dem CLOSE
CONVERSATION-Statement an den Server gesendet wird und der Server am
Ende der Konversationsverarbeitung ein END TRANSACTION-Statement
ausführt.
Die Commit-Option gilt für das nächste CLOSE
CONVERSATION-Statement, das von der Client-Anwendung ausgeführt wird.
Nachdem die Konversation(en) beendet wurde(n), wird wieder die Standardoption
verwendet. Das bedeutet, dass das folgenden CLOSE
CONVERSATION-Statement wieder zu einem
BACKOUT
TRANSACTION-Statement führt.
Während einer Konversation können die Subprogramme, die Mitglieder dieser Konversation sind, einen gemeinsamen Kontextbereich auf diesem Server nutzen.
Dazu deklarieren Sie in jedem der betroffenen Unterprogramme einen
Datenbereich mit dem
DEFINE DATA
CONTEXT-Statement.
Die Subprogramme, die einen Kontextbereich verwenden, verhalten sich
so, als ob die Konversation lokal oder remote wäre. Das
DEFINE DATA
CONTEXT-Statement entspricht weitgehend dem
DEFINE DATA
INDEPENDENT-Statement. Alle Regeln, die für die Definition
von AIV-Variablen gelten,
gelten auch für Kontextvariablen, mit der Ausnahme, dass einer Kontextvariablen
kein Pluszeichen (+) vorangestellt werden muss.
Der Compiler prüft keine Format-/Längendefinition, da dies voraussetzt, dass die Variablen durch Ausführen eines Programms erstellt werden, das alle Definitionen für diese Anwendung enthält (wie bei AIVs üblich). Bei Kontextvariablen hat dies keinen Sinn, da eine Library, die RPC-Service-Routinen enthält, normalerweise nicht anwendungsabhängig ist.
Im Gegensatz zu AIVs werden die Kontextvariablen des Aufrufers nicht
über CALLNAT-Grenzen
hinweg übergeben. Kontextvariablen werden durch ihren Namen und die
Kontextkennung, für die sie gelten, referenziert. Eine Kontextvariable wird von
allen Service-Routinen, die sich innerhalb einer Konversation auf denselben
Variablennamen beziehen, gemeinsam genutzt. Daher hat jede Konversation ihren
eigenen Satz an Kontextvariablen. Kontextvariablen können nicht von
verschiedenen Konversationen gemeinsam genutzt werden, auch wenn sie denselben
Variablennamen haben.
Der Kontextbereich wird auf die Anfangswerte zurückgesetzt, wenn ein
OPEN
CONVERSATION-Statement oder ein nicht-konversationelles
CALLNAT-Statement ausgeführt wird.
Die Systemvariable *CONVID
(Format I4) wird durch das OPEN
CONVERSATION-Statement gesetzt und kann durch das
Anwendungsprogramm geändert werden.
Eine Änderung von *CONVID ist nur
notwendig, wenn Sie mehrere Konversationen parallel verwenden.