Der Zweck von Natural-Anwendungsprogrammierschnittstellen (APIs) ist
es, Informationen abzurufen oder zu ändern oder Dienste zu nutzen, die nicht
über Natural-Statements zugänglich sind. Die folgenden in der Natural Library
SYSEXT
verfügbaren Anwendungsprogrammschnittstellen sind für die
Verwendung beim Natural RPC vorgesehen. Einträge, die mit einem Link versehen
sind, entsprechen APIs, die in der Natural-Dokumentation dokumentiert sind.
Darüber hinaus können Sie eine Beschreibung zu einer API in der
Natural Library SYSEXT unter dem Namen
USRnnnnT
finden.
Eine Erläuterung der Natural-Objekttypen, die normalerweise zu jeder API verfügbar sind, können Sie der Dokumentation der Natural Utility SYSEXT entnehmen.
API | Zweck |
---|---|
USR1071N |
Festlegen der Anmeldedaten für RPC-Server:
Benutzerkennung, Passwort und Ticket-Kriterien für Natural RPC.
Senden von Anmeldedaten an den Natural RPC Server, wenn der Client kein Natural Security (NCS) hat, oder, wenn der Client NSC hat, für die Verwendung einer anderen Benutzerkennung und eines anderen Passworts auf der Server-Seite. Siehe Verwendung von Security. Eine verbesserte Version dieser API finden Sie unter
|
USR2007N |
Abrufen oder Setzen von Daten für den RPC-Standardserver,
einschließlich der Logon-Option.
Festlegen einer Standard-Serveradresse, die immer dann verwendet werden soll, wenn ein entferntes Programm nicht über das Service Directory angesprochen werden kann. Siehe Festlegen einer Standard-Serveradresse innerhalb einer Natural-Sitzung in Betrieb einer Natural RPC-Umgebung . |
USR2032N |
Unterstützung des Commit bei einem
CLOSE
CONVERSATION -Statement auf der Client-Seite. Beim Aufruf
dieser API wird am Ende der einzelnen Konversation ein implizites END
TRANSACTION ausgelöst.
Siehe Datenbank-Transaktionen im Kapitel Einführung in Natural RPC, Abschnitt Konversationeller CALLNAT. |
USR2035N |
Abrufen oder Festlegen der Parameter für die
SSL-Unterstützung.
Setzen des erforderlichen SSL-Parameterstring, wenn Secure Socket Layer (SSL) für die TCP/IP-Kommunikation mit dem EntireX Broker verwendet wird. Siehe Secure Socket Layer verwenden in Betrieb einer Natural RPC-Umgebung . |
USR2071N |
Unterstützung von EntireX Security auf der Client-Seite.
Anmeldung beim EntireX Broker.
Muss im Falle von Nicht-Natural-Security-Clients aufgerufen werden, um Anmeldedaten anzugeben, die dann an den Server übergeben werden. Siehe Natural RPC mit Natural Security verwenden in Verwendung von Security. |
USR2072N |
Unterstützung von EntireX Security auf der Server-Seite.
Festlegen eines Passworts, das für die Anmeldung
( Siehe Server-Seite in Verwendung von Security, Abschnitt Natural RPC mit EntireX Security verwenden. |
USR2073N |
Anpingen oder Beenden eines RPC-Servers aus Ihrer
Anwendung heraus.
Siehe Anwendungsprogrammierschnittstelle USR2073N verwenden in Beenden eines Natural RPC Servers. Eine verbesserte Version dieser API finden Sie unter
|
USR2074N |
Ändern des Natural Security-Passworts auf dem RPC-Server
über eine Natural RPC-Service-Anforderung.
Siehe Passwort ändern in Verwendung von Security. |
USR2075N |
Beenden eines EntireX-Broker-Dienstes aus Ihrer Anwendung
heraus.
Siehe Anwendungsprogrammierschnittstelle USR2075N in Beenden eines Natural RPC Servers. Eine verbesserte Version dieser API finden Sie unter
|
USR2076N |
Abrufen oder Festlegen des RPC
TIMEOUT-Werts.
Siehe TIMEOUT-Wert mit API USR2076N abfragen/setzen in Betrieb einer Natural RPC-Umgebung . |
USR4008N |
Auf der Client-Seite: Übergeben eines alternativen
Library-Namens an den Natural RPC Server zwecks Anmeldung.
Siehe Bei einer anderen Library anmelden unter Logon-Option benutzen in Betrieb einer Natural RPC-Umgebung . |
USR4009N |
Abrufen oder Festlegen von Parametern für EntireX in
einer Natural RPC-Client- oder -Server-Umgebung.
Siehe Parameter für EntireX setzen/abfragen in Betrieb einer Natural RPC-Umgebung . |
USR4010N |
Auf der Client-Seite: Abrufen der Laufzeiteinstellungen
eines RPC-Servers.
Siehe Laufzeiteinstellungen eines Servers abrufen in Betrieb einer Natural RPC-Umgebung. |
USR4012N |
Anwendungsfehler beim RPC-Server setzen.
Siehe Anwendungsfehler beim RPC-Server setzen in Einrichten einer Natural RPC-Umgebung. |
USR4371N |
Auf der Client-Seite: Festlegen der
Benutzerkennung und ETID für Natural RPC Server, die mit Impersonation =
A (automatische Anmeldung) konfiguriert wurden.
Siehe Natural RPC mit Natural Security verwenden in Verwendung von Security. |
USR6304N |
Setzen oder Abrufen des Modus für Reliable Natural RPC.
Siehe Reliable RPC auf der Natural RPC-Client-Seite in Reliable RPC. |
USR6305N |
Commit oder Rollback einer Arbeitseinheit (Unit of Work),
die mit CLIENT_COMMIT erstellt wurde.
Diese API ist erforderlich, wenn der Status des Reliable RPC
auf Siehe Reliable RPC auf der Natural RPC-Client-Seite in Reliable RPC. |
USR6306N |
Abrufen des Status aller Reliable RPC-Nachrichten des
Benutzers, der gerade am EntireX Broker angemeldet ist.
Siehe Reliable RPC auf der Natural RPC Server-Seite in Reliable RPC. |
USR8208N |
Beenden eines EntireX-Broker-Dienstes.
Pingt einen RPC-Server an oder beendet einen EntireX Broker Service. Zeigt die EntireX Broker-Version und andere Informationen aus dem EntireX Broker Command and Information Service (CIS) an. Verbesserte Version der API
Siehe Anwendungsprogrammierschnittstelle USR8208N verwenden in Beenden eines Natural RPC Servers. Eine verbesserte Version dieser API finden Sie unter
|
USR8213N |
Beenden eines EntireX-Broker-Dienstes.
Abrufen einer Liste der RPC Server-Replikas, die bei einem angegebenen EntireX Broker registriert sind. Die Schnittstelle sendet danach eine Abschaltanforderung mit der fortlaufenden Nummer an den EntireX-Broker. Siehe Anwendungsprogrammierschnittstelle USR8213N verwenden Eine verbesserte Version dieser API finden Sie unter
Eine verbesserte Version dieser API finden Sie unter
|
USR8220N |
Auslösen der Server-seitigen Beendigung des Natural
RPC-Servers, der diese API ausführt.
Siehe Anwendungsprogrammierschnittstelle USR8220N verwenden in Beenden eines Natural RPC Servers. |
USR8225N |
Zugang zur Pflege der EntireX-Parameter
MESSAGE_ID und CORRELATION_ID in
einer Natural RPC Client- oder Server-Umgebung zur Verfügung stellen.
Siehe Message ID und Correlation ID von EntireX verwalten in Betrieb einer Natural RPC-Umgebung. |
USR9171N |
Festlegen der Passwortphrase des Benutzers.
Festlegen der Anmeldedaten für RPC-Server. Verbesserte
Version der API Siehe Natural RPC mit Natural Security verwenden in Verwendung von Security. |
USR9175N |
Pingen, Beenden oder Verfolgen (Trace) eines Natural
RPC-Server.
Verbesserte Version der API
Siehe Anwendungsprogrammierschnittstelle USR9175N verwenden in Beenden eines Natural RPC Servers. |
USR9176N |
Beenden eines EntireX Broker Service.
Verbesserte Version der API
Siehe Anwendungsprogrammierschnittstelle USR9176N verwenden in Beenden eines Natural RPC Servers. |
USR9177N |
Beenden eines EntireX Broker Service mit fortlaufender
Nummer.
Verbesserte Version der API
Siehe Anwendungsprogrammierschnittstelle USR9177N verwenden in Beenden eines Natural RPC Servers. |
Beachten Sie, dass die RPC-spezifischen APIs alle Werte auch im
gemischten Modus akzeptieren. Eine Umsetzung in Großbuchstaben findet nur
statt, wenn das Beispielprogramm
USRnnnnP
(Source-Objekt) verwendet
wird, um das entsprechende Subprogramm
USRnnnnN
aufzurufen. Ausnahme: Alle
USRnnnnP
-Programme, die mit Passwörtern
arbeiten, bieten die Möglichkeit, die Passwörter in gemischter Schreibweise
einzugeben.