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 |
Anmeldedaten für RPC-Server festlegen: Benutzerkennung,
Passwort und Ticket-Kriterien für Natural RPC. Senden von Anmeldedaten an den
Natural RPC Server, wenn der Client kein NSC 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. |
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 Commits 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 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
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. |
USR2074N |
Ändern des Natural Security-Passworts auf dem RPC-Server
über eine Natural RPC-Service-Anfoderung.
Siehe Passwort ändern in Verwendung von Security. |
USR2075N |
Beenden eines EntireX-Broker-Dienstes aus Ihrer Anwendung
heraus.
Eine erweiterte Version der API Siehe Anwendungsprogrammierschnittstelle USR2075N in Beenden eines Natural RPC Servers. |
USR2076N |
Abrufen oder Festlegen des RPC
TIMEOUT-Werts.
|
USR4008N |
Auf der Client-Seite: Übergeben eines alternativen
Library-Namens an den Natural RPC Server zwecks Anmeldung.
Siehe 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 Servers.
Siehe Laufzeiteinstellungen eines Servers abrufen in Betrieb einer Natural RPC-Umgebung . |
USR4012N |
Anwendungsfehler beim RPC-Server setzen. |
USR4371N |
Auf der Client-Seite: Festlegen der
Benutzerkennung und ETID für Natural RPC Server, die mit Impersonation = A
(automatische Anmeldung) konfiguriert wurden.
Wenn für den Natural RPC Server Impersonation ohne Passwortüberprüfung aktiv ist, kann der Client optional eine ETID an den Natural RPC Server übergeben. |
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 |
Erweiterte Version der API
USR2075N.
Beendet einen EntireX-Broker-Dienst. Pingt einen RPC-Server an oder beendet einen EntireX Broker-Dienst. Zeigt die EntireX Broker-Version und andere Informationen aus dem EntireX Broker Command and Information Service (CIS) an. Siehe Anwendungsprogrammierschnittstelle USR8220N verwenden in Beenden eines Natural RPC Servers. Eine erweiterte Version der API |
USR8220N |
Auslösen der Beendigung des Natural RPC-Servers auf der
Server-Seite.
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.
|
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.