APIs zur Verwendung beim Natural RPC

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 USR9171N.

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 (LOGON) in Verbindung mit dem Schlüsselwort-Subparameter SRVUSER des Profilparameters RPC oder dem Parameter-Makro NTRPC verwendet wird.

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 USR9175N.

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 USR8208N und USR9176N.

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 client commit gesetzt wurde.

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 USR2075N unter Verwendung des leistungsfähigeren Kommandos shutdown service bei EntireX.

Siehe Anwendungsprogrammierschnittstelle USR8208N verwenden in Beenden eines Natural RPC Servers.

Eine verbesserte Version dieser API finden Sie unter USR9176N.

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 USR9177N in Beenden eines Natural RPC Servers.

Eine verbesserte Version dieser API finden Sie unter USR9177N.

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 USR1071N mit der Möglichkeit, längere Passwörter zu benutzen.

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 USR2073N mit der Möglichkeit, längere Passwörter zu benutzen und den Trace Level eines Natural RPC-Servers abzufragen oder zu setzen.

Siehe Anwendungsprogrammierschnittstelle USR9175N verwenden in Beenden eines Natural RPC Servers.

USR9176N Beenden eines EntireX Broker Service.

Verbesserte Version der API USR8208N mit der Möglichkeit, längere Passwörter zu benutzen.

Siehe Anwendungsprogrammierschnittstelle USR9176N verwenden in Beenden eines Natural RPC Servers.

USR9177N Beenden eines EntireX Broker Service mit fortlaufender Nummer.

Verbesserte Version der API USR8213N mit der Möglichkeit, längere Passwörter zu benutzen.

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.