APIs zur Verwendung beim Natural RPC

#### Search Results

Search

# 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`.
`USR2076N` | Abrufen oder Festlegen des RPC TIMEOUT-Werts. Siehe TIMEOUT-Wert mit API USR2076N abfragen/setzen.
`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` | Herunterfahren eines Servers mit fortlaufender Nummer beim EntireX Broker. Abrufen einer Liste der RPC Server-Replikaten, die bei einem angegebenen EntireX Broker registriert sind. Die Schnittstelle sendet danach eine Anforderung zum Herunterfahren mit ortlaufender Nummer an den EntireX-Broker. Siehe Anwendungsprogrammierschnittstelle USR8213N verwenden Eine verbesserte Version dieser API finden Sie unter `USR9177N`.
`USR8216N` | Pflege des Service Directory. Siehe Beschreibung des Dienstprogramms SYSRPC, Abschnitt API USR8216N zur Pflege des Service Directory.
`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` | Herunterfahren eines Servers mit fortlaufender Nummer beim EntireX Broker. 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.
`USR9202N` | Löschen eines dynamisch geladenen 3GL-Programms. Die API `USR9202N` unterstützt jetzt die Formate (A) `DYNAMIC` und (A70) für die Parameter-Rückgabenachricht. Bei Ausführung der API auf der Server-Seite (siehe auch API `USR9204N`), erfordert die Parameter-Rückgabenachricht das Format (A70).
`USR9204N` | Senden eines Kommandos an einen Natural RPC Server mit fortlaufender Nummer beim EntireX Broker. Siehe Kommando an einen RPC-Server senden in Betrieb einer Natural RPC-Umgebung.

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.