Programmschnittstelle zur Administration

Mit der Programmschnittstelle KDCADMI, die openUTM zur Verfügung stellt, können Sie Administrationsprogramme selbst erstellen, die speziell auf Ihre Anwendung zugeschnitten sind. Da die Programmschnittstelle der Administration für die Programmierung eigener Administrationsprogramme mächtige Aufrufe zur Verfügung stellt, die zudem individuell eingesetzt werden können, bieten selbst erstellte Administrationsprogramme mehr Möglichkeiten als die Basis-Administrationsfunktionen:

• Als Informationsbasis steht nahezu die gesamte Generierungsinformation zur Verfügung.

• Aus dieser Basis können genau die Informationen abgerufen, ausgewertet und weiterverarbeitet werden, die im konkreten Anwendungsfall von Interesse sind.

• In selbst erstellten Administrationsprogrammen lassen sich die Aufrufe zur dynamischen Konfigurierung nutzen (siehe unten).

• Für Administrationsdialoge können Formate verwendet werden.

Die Aufrufe der Programmschnittstelle sind unabhängig von der Plattform, auf der das Administrationsprogramm abläuft. So ist es z.B. möglich, von einer UTM-Anwendung auf einem Windows-System aus eine oder auch mehrere UTM-Anwendungen zu administrieren, die auf Unix- oder Linux-Systemen oder auf BS2000-Systemen ablaufen, und umgekehrt. Da zudem in Hinblick auf zukünftige openUTM-Versionen Source-Kompatibilität garantiert wird, müssen selbst erstellte Administrationsprogramme weder bei einem Plattformwechsel noch beim Umstieg auf neue openUTM-Versionen angepasst werden.

Der Aufwand für die Programmierung eigener Administrationsprogramme ist gering:
Die Aufrufe der Programmschnittstelle können in C-, C++- oder COBOL-Teilprogramme integriert werden. Sowohl Dialog- als auch Asynchron-Programme sind möglich.
Ein Programm kann beliebig viele Administrationsaufrufe enthalten. Die jeweils benötigten Datenstrukturen sind bereits vordefiniert und stehen als Include-Dateien bzw. COPY-Elemente zur Verfügung.

Dynamische Konfigurierung

Die Programmschnittstelle KDCADMI stellt Aufrufe bereit, mit denen Sie die Konfiguration der Anwendung „on-the-fly“ ändern können: Clients, Drucker, Benutzerkennungen, Services, usw. können im laufenden Betrieb in die Konfiguration neu aufgenommen oder aus der Konfiguration gelöscht werden, die Verfügbarkeit des Systems wird dadurch in keiner Weise beeinträchtigt.

Für alle dynamisch konfigurierbaren Objekte können - online oder offline - entsprechende KDCDEF-Anweisungen erzeugt werden (inverser KDCDEF). Da diese Anweisungen dann als Input für das Generierungstool KDCDEF zur Verfügung stehen, lassen sich alle dynamischen Änderungen der Konfiguration bei einer Neu-Generierung problemlos einbeziehen.

 

Übersicht: Administrationsfunktionen der Programmschnittstelle KDCADMI

Operationscode	Funktion
KC_CHANGE_APPLICATION	gesamtes Anwendungsprogramm im laufenden Betrieb austauschen
KC_CREATE_DUMP	UTM-Dump erzeugen
KC_CREATE_OBJECT	dynamisch neue Objekte (Teilprogramme, Terminals, Benutzer usw.) in die Konfiguration aufnehmen
KC_CREATE_STATEMENTS	im laufenden Betrieb (online) KDCDEF-Steueranweisung für dynamisch konfigurierbare Objekte erzeugen
KC_DELETE_OBJECT	Objekte der Anwendung löschen, d.h. aus der Konfiguration der Anwendung herausnehmen
KC_ENCRYPT	RSA-Schlüsselpaar erzeugen, löschen, auslesen
KC_GET_OBJECT	Information über Objekte und Parameter der Anwendung abfragen
KC_LOCK_MGMT	Sperre der Cluster-User-Datei aufheben
KC_MODIFY_OBJECT	Eigenschaften von Objekten oder Anwendungsparametern ändern
KC_ONLINE_IMPORT	Anwendungsdaten online importieren (nur für Cluster-Anwendungen)
KC_PTC_TA	Transaktion im Zustand PTC zurücksetzen
KC_SHUTDOWN	Anwendung beenden
KC_SPOOLOUT	Verbindung zu Druckern automatisch aufbauen, für die Nachrichten vorliegen
KC_SYSLOG	System-Protokolldatei SYSLOG administrieren
KC_UPDATE_IPADDR	IP-Adresse aktualisieren
KC_USLOG	im laufenden Betrieb die Benutzer-Protokolldatei(en) auf die nächste Dateigeneration umschalten
folgenden Operationscode gibt es nur in openUTM auf BS2000-Systemen:
KC_SEND_MESSAGE	Systemzeilen-Nachricht an ein oder mehrere Dialog-Terminals senden

Beispielprogramme

openUTM bietet Ihnen folgende C-Beispielprogramme, in denen die Nutzung der KDCADMI-Schnittstelle demonstriert wird:

• SUSRMAX (show users and modify MAX values)

• ENCRADM (encryption administration)

• ADJTCLT (adjust tacclass tasks)

• HNDLUSR (handle user data, nur auf BS2000-Systemen verfügbar)

Für COBOL gibt es das Beispielprogramm COBUSER.
Da die Beispiele auch als Source-Code ausgeliefert werden, können Sie sie individuell anpassen oder als Vorlage für eigene Administrationsprogramme verwenden. Die Beispielprogramme lassen sich jedoch auch unverändert einsetzen, z.B. um Informationen zu Benutzerkennungen und MAX-Werten abzufragen, aktuelle Einstellungen zu ändern oder um Benutzerkennungen dynamisch zu konfigurieren.

Auf Unix-, Linux- und Windows-Systemen sind die Beispielprogramme ENCRADM, SUSRMAX und ADJTCLT in die Beispielanwendung bzw. das Quick Start Kit integriert, das Beispiel COBUSER finden Sie im utmpfad unter sample/src bzw. sample\src. Auf BS2000-Systemen sind alle Beispiele in der Bibliothek SYSLIB.UTM.070.EXAMPLE enthalten. Was Sie für den Einsatz der Programme wissen müssen, ist am Anfang des jeweiligen Source-Codes in Kommentaren beschrieben.