Dieses Kapitel stellt die API RPC-CNTX
vor, die zur
Bereitstellung eines RPC-Kontexts von der Natural RPC-Client-Seite aus
verwendet werden kann.
Die API RPC-CNTX
kann verwendet werden, um einen
Kontext für RPC-Aufrufe bereitzustellen, wie es in Testprogrammen geschieht,
die mit dem webMethods EntireX Natural Wrapper generiert werden.
RPC-CNTX
kombiniert die Funktionalität mehrerer APIs
und ist in der Library SYSTEM
verfügbar. Es sind keine
zusätzlichen Vorbereitungen wie das Festlegen einer Steplib oder das Kopieren
von APIs aus der Library SYSEXT
in die User Libraries
erforderlich.
Um RPC-CNTX zu nutzen:
Specify a DEFINE
DATA
statement
Geben Sie ein DEFINE
DATA
-Statement an, wobei die Ebene 01
durch
01 RPC-CNTX-AREA
definiert ist, und geben Sie die folgenden
Parameter auf Ebene 02
an:
Parameter | Format | I/O | Beschreibung | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
FUNCTION | A2 | I |
|
||||||||||||
BROKERID | A dynamic | I/O | Geben Sie den Broker-Namen an.
Siehe den Schlüsselwort-Subparameter
|
||||||||||||
CLASS | A32 | I | Geben Sie die Klasse des Servers
an. Bei Natural RPC Servern ist dies RPC . Siehe den
Schlüsselwort-Subparameter SRVNAME des
Profilparameters RPC .
|
||||||||||||
SERVER | A32 | I/O | Geben Sie den Namen des Servers an.
Siehe den Schlüsselwort-Subparameter
SRVNAME des
Profilparameters RPC .
|
||||||||||||
SERVICE | A32 | I | Geben Sie den Typ des Servers an.
Bei Natural RPC Servern ist dies CALLNAT .
|
||||||||||||
COMPRESSLEVEL | A1 | I/O | Komprimierungsstufe erfordert API-Version 7. | ||||||||||||
RESERVED | I1 | I/O | Reserviert für künftige Verwendung. | ||||||||||||
RPC-LIBRARY | A8 | I | |||||||||||||
RPC-RELIABLE-STATE | N1 | I/O |
|
||||||||||||
NAT-LOGON | A11 | I/O | |||||||||||||
EXX-USERID | A32 | I | |||||||||||||
EXX-PASSWORD | A32 | I | |||||||||||||
RPC-USERID | A32 | I | |||||||||||||
RPC-PASSWORD | A32 | I | |||||||||||||
ERR-CODE | I4 | O | Der Ursprung eines Fehlercodes kann
anhand der folgenden Identifikatoren ermittelt werden:
|
||||||||||||
ERR-TEXT | A dynamisch | O | |||||||||||||
RPC-ETID | A8 | I | Impersonation ohne Passwortüberprüfung zulassen (optional). |
Anmerkung:
Die wichtigsten Funktionscodes sind 'SL'
und
'LF'
. Der Funktionscode 'SL'
ist eine Kombination aus
dem Setzen des RPC-Kontextes ('SC'
) und einer Anmeldung am EntireX
Broker ('LO'
).
Geben Sie im aufrufenden Programm auf der Client-Seite das folgende Statement an:
CALLNAT 'RPC-CNTX' RPC-CNTX-AREA
Weitere Informationen finden Sie unter Syntax-Beschreibung
beim CALLNAT
-Statement in der
Statements-Dokumentation.
Die Einstellung des RPC-Kontextes wird wie folgt verarbeitet:
Legen Sie die Anmeldeinformationen für den RPC-Server durch
Angabe von RPC-USERID
und RPC-PASSWORD
fest (API
USR1071N
).
Setzen Sie den Modus für Reliable RPC durch Angabe von
RPC-RELIABLE-STATE
(API USR6304N
).
Setzen Sie die Daten für den RPC-Standard-Server einschließlich
der Logon-Option durch Angabe
von BROKERID
, SERVER
und NAT-LOGON
(API
USR2007N
).
Ändern Sie den Library-Namen auf dem RPC-Server für die
Anmeldung durch Angabe von RPC-LIBRARY
(API
USR4008N
). Wenn der Name leer gelassen wird, wird die API nicht
aufgerufen.
Setzen Sie die Parameter für EntireX COMPRESSLEVEL
,
indem Sie API USR4009N
verwenden. Wenn keine Werte angegeben
werden, wird die API nicht aufgerufen.
Legen Sie optional eine ETID fest, indem Sie
RPC-ETID
(API USR4371N
) angeben, wenn für den Natural
RPC Server Impersonation ohne Passwortprüfung aktiv ist.
Für die Anmeldung am EntireX Broker geben Sie
BROKERID
, EXX-USERID
und EXX-PASSWORD
an, die dann an USR2071N
übergeben werden.
Nachdem Sie die Arbeit an der RPC-Verbindung beendet haben, müssen
Sie sich über RPC-CNTX
mit dem Funktionscode 'LF'
beim EntireX Broker abmelden.