Um in den laufenden Betrieb eingreifen zu können, stehen dem Systemverwalter Administrationsanweisungen und -kommandos zur Verfügung:
mit Hilfe DBH-spezifischer Administrationsanweisungen und -kommandos kann der Systemverwalter die DBH-Session administrieren
bei der verteilten Verarbeitung mit SESAM/SQL-DCN (siehe "Verteilte Verarbeitung mit SESAM/SQL-DCN") kann der Systemverwalter mit SESDCN-spezifischen Administrationanweisungen und -kommandos die Verteilkomponente SESDCN administrieren.
Will der Systemverwalter gezielt Informationen zum Datenbankbetrieb abfragen, so steht ihm das SESAM/SQL-Dienstprogramm SESMON zur Verfügung. Die DBH-Statistik von SESMON bietet Informationen, mit deren Hilfe der Systemverwalter die DBH-Session überwachen und die optimale Einstellung der DBH-Optionen ermitteln kann. Informationen zum SESDCN-Betrieb bietet die SESDCN-Statistik (siehe Abschnitt „Betriebsdaten ausgeben mit SESMON“).
Eingabe der Administrationsanweisungen und -kommandos
Für die Eingabe der Administrationsanweisungen bzw. -kommandos gibt es folgende Möglichkeiten:
über das Administrationsprogramm SESADM, das als eigener Prozess läuft, aber auch als Unterprogramm des Utility-Monitors verfügbar ist
über das BS2000-Kommando INFORM-PROGRAM
über CALL-DML-Anweisungen innerhalb eines CALL-DML-Programms
Zugang zum Administrationsprogramm SESADM erhalten Sie auch aus dem World Wide Web, siehe "Komfortable Administration".
Die Bedienung von SESADM ist im Handbuch „ Datenbankbetrieb“ beschrieben.
Eingabe-Format
Je nachdem, über welche Schnittstelle die Administration erfolgen soll, muss der Systemverwalter Administrationsanweisungen oder Administrationskommandos eingeben.
Administrationsanweisungen stehen für die Administration über SESADM zur Verfügung. Das Administrationsprogramm SESADM liest die Eingaben mit Hilfe der Dialogschnittstelle SDF ein. Die Syntax der Administrationsanweisungen folgt daher den Regeln von SDF (z.B. SHOW-INACTIVE-SQL-USERS).
Bei der Administration über INFORM-PROGRAM bzw. innerhalb eines CALL-DML-Programms stehen dem Systemverwalter Administrationskommandos im ISP-Format zur Verfügung (z.B. USER,INACT).
Administrationsanweisungen bieten nahezu den gleichen Funktionsumfang wie Administrationskommandos. In den folgenden Übersichten werden daher nur Administrationsanweisungen berücksichtigt. Eine Kurzbeschreibung der entsprechenden Administrationskommandos finden Sie im Handbuch „ Datenbankbetrieb“.
Ausgabe der Administrationsanweisungen und -kommandos
Große Datenbankkonfigurationenen liefern z.B. in den SHOW-Anweisungen von SESADM auch umfangreiche Ausgaben. Mit der Anweisung MODIFY-OUTPUT-MODE im DBH- und im DCN-Menü können Sie die Ausgabe von Administrationsanweisungen auf SYSOUT/SYSLST oder in eine temporäre Datei steuern.
Die Informationsausgaben der meisten SHOW-Anweisungen können in S-Variablen ausgegeben und in S-Prozeduren weiter verarbeitet werden.
Unter SESADM sind alle Ausgaben vollständig. Bei Administration über INFORM-PRO-GRAM oder ein CALL-DML-Programm hat ein Ausgabeabschnitt (eine sogenannte Anwort) eine maximale Größe von 32000 Byte. Größere Ausgabemengen werden in mehrere Antworten aufgeteilt. Die Folgeantworten können Sie mit dem Administrationskommando NEXT abrufen.
Resultat der Administrationsanweisungen
Rückmeldungen und Fehlermeldungen werden bei einem Ablauf im Dialog nach SYSOUT und SYSLST, bei einem Ablauf im Batchbetrieb auf die Bedienstation und nach SYSLST ausgegeben. Zusätzlich wird die Meldungsnummer der letzten Antwort des DBH oder von SESDCN auf eine Administrationsanweisung in der S-Variablen SESAM-RESULT und in der Jobvariablen #SESAM.SESADM.JV vermerkt. Dies erlaubt eine automatisierte Administration mit SESADM. Siehe Handbuch „ Datenbankbetrieb“.
Administrationsanweisungen des DBH
Die folgenden Tabellen zeigen eine Übersicht der Administrationsanweisungen des DBH.
Die ausführliche Beschreibung von Syntax und Bedeutung der DBH-Administrationsanweisungen finden Sie im Handbuch „ Datenbankbetrieb“. Dort finden Sie auch eine zuordnende Gegenüberstellung von Administrationsanweisungen und -kommandos.
Die drei Tabellen sind nach folgenden Gesichtspunkten aufgeteilt:
Tabelle 62 beschreibt alle Administrationsanweisungen, die für den Auftraggeber spezifische Auskünfte geben
Tabelle 63 fasst alle Administrationsanweisungen zusammen, die die eingestellten DBH-Startanweisungen und -Optionen anzeigen oder ändern (siehe Abschnitt „Steuerung und Überwachung der Session“)
Tabelle 64 zeigt alle übrigen Anweisungen, die steuernd in den SESAM/SQL-Betrieb eingreifen.
Administrationsanweisung | Kurzbeschreibung |
SHOW-USER-SPACES | Ausgabe der vom Anwender genutzten und damit gesperrten |
SHOW-CALL-DML-SUBORDERS | Anzahl der CALL-DML-OPEN-Aufträge ausgewählter Auftraggeber |
SHOW-CATALOG-USERS | Anzahl aktiver Auftraggeber zu ausgewählten Datenbanken |
SHOW-INACTIVE-SQL-USERS | alle inaktiven SQL-Auftraggeber ausgeben |
SHOW-SPACE-USERS | alle aktiven Auftraggeber eines ausgewählten Space mit |
SHOW-TRANSACTIONS | alle offenen Transaktionen ausgewählter Auftraggeber mit |
SHOW-USERS | alle aktiven Auftraggeber mit entsprechender Zusatzinformation |
SHOW-CATID-LIST | Ausgabe der aktuellen CATID-Liste |
Tabelle 62: DBH-Administrationsanweisungen für auftraggeber-spezifische Auskünfte
Administrationsanweisung | Kurzbeschreibung |
ADD-OLD-TABLE-CATALOG-ENTRY | Eintrag in das CALL-DML-Tabellenverzeichnis hinzufügen |
ADD-SQL-DB-CATALOG-ENTRY | Eintrag in das SQL-Datenbankverzeichnis hinzufügen |
MODIFY-ADMINISTRATION | Administrationsberechtigung ändern |
MODIFY-CATALOG-ACCESS-RIGHTS | Zugriffsrechte für benannte Datenbank ändern |
MODIFY-REQUEST-CONTROL | Parameter für die Prioritätensteuerung ändern |
MODIFY-RESTART-CONTROL | beeinflusst die Dauer eines möglichen Wiederanlaufs |
MODIFY-RETRIEVAL-CONTROL | Kriterium für die Unterbrechung und den Abbruch von |
MODIFY-SQL-SORT-LIMIT | Grenzwert modifizieren für die Anzahl Sort |
MODIFY-SUBORDER-LIMIT | Grenzwert modifizieren für die maximale Anzahl |
MODIFY-MSG-OUTPUT | Ausgabe des DBH ändern |
MODIFY-OLD-TABLE-CATALOG-LIMIT | Maximalzahl der Einträge im CALL-DML-Tabellenverzeichnis |
MODIFY-RECOVER-OPTIONS | Optionen für nachfolgende RECOVER- oder RE- |
MODIFY-SECURITY | Maximalzahl erlaubter Kennwortverstöße ändern |
MODIFY-SERVICE-TASKS | Anzahl und Attribute der Service-Tasks ändern |
MODIFY-SESSION-LOGGING-ID | Kennzeichnung session-bezogener Dateien ändern |
MODIFY-STORAGE-SIZE | Maximalgröße von Transfer- und Work-Container |
MODIFY-TRANSACTION-SECURITY | Parameter der Transaktionssicherung ändern |
RECONFIGURE-DBH-SESSION | DBH-Optionen dynamisch ändern |
RELOAD-DBH-SESSION | DBH-Module neu laden |
REMOVE-OLD-TABLE-CATALOG- | Eintrag aus CALL-DML-Tabellenverzeichnis löschen |
REMOVE-SQL-DB-CATALOG-ENTRY | Eintrag aus SQL-Datenbankverzeichnis löschen |
REUSE-OLD-TABLE-CATALOG-ENTRY | Gültigen Verweis auf einen bereits vorhandenen |
REUSE-PARTITIONS | Verfügbarkeit von Partitionen wiederherstellen |
SAVE-DBH-OPTIONS | Sichern der aktuellen DBH-Optionen |
SET-ACCOUNTING-PARAMETER | Protokollierung der Auftragsabrechnung für das |
SET-REQUEST-CONTROL | Prioritätensteuerung ein- oder ausschalten |
SET-USER-INACTIVE-TIME | Zeitspanne festlegen, nach der offene, aber inaktive |
SHOW-DBH-MEDIA-CATALOG | aktuell gültige DBH-Option MEDIA-CATALOG ausgeben |
SHOW-DBH-OPTIONS | aktuell gültige DBH-Optionen ausgeben, mit Ausnahme |
SHOW-OLD-TABLE-CATALOG- | Einträge im CALL-DML-Tabellenverzeichnis anzeigen |
SHOW-PARTITIONS | Verfügbarkeit von Partitionen ausgeben |
SHOW-SQL-DB-CATALOG-ENTRIES | Einträge im SQL-Datenbankverzeichnis anzeigen |
Tabelle 63: Administrationsanweisungen für DBH-Startanweisungen und -Option
Administrationsanweisung | Kurzbeschreibung |
ABORT-LOCK-SEQUENCE | Locksequenz eines anderen Auftraggebers beenden |
ASSIGN-SYSLST | SYSLST-Datei wechseln |
BEGIN-LOCK-SEQUENCE | Locksequenz beginnen |
CANCEL-STATEMENT | DML-Anweisung abbrechen |
CHANGE-CATLOG | CAT-LOG-Datei und DA-LOG-Dateien wechseln |
CHANGE-DALOG | DA-LOG-Dateien wechseln |
CLOSE-SPACE | Anwender-Space physikalisch schließen |
COMMIT-PTC-TRANSACTION | PREPARE-TO-COMMIT-Transaktion beenden |
CREATE-DUMP | Hauptspeicherauszug (Dump) erzeugen |
END-FOREIGN-COPY | Zustand „copy pending“ auf Spaces nach Fremdkopie |
END-LOCK-SEQUENCE | Locksequenz beenden |
HOLD-TRANSACTION-ADMISSION | keine weiteren Transaktionen zulassen |
MODIFY-CATID-LIST | aktualisiert die CATID-Liste |
PREPARE-FOREIGN-COPY | Schließen einer Datenbank, um eine Fremdkopie |
RELEASE-USER-RESOURCES | alle Betriebsmittel eines Auftraggebers zurücksetzen |
RESUME-TRANSACTION-ADMISSION | Transaktionsbetrieb wieder zulassen |
ROLLBACK-PTC-TRANSACTION | PREPARE-TO-COMMIT-Transaktion eines |
ROLLBACK-TRANSACTION | Transaktion eines Auftraggebers zurücksetzen |
SET-DBH-MSG-TRACE | Protokollierung von Nachrichten des DBH steuern |
SET-DIAGNOSIS-DUMP-PARAMETER | Erstellung eines Dump steuern |
SET-SESSION-DIAGNOSIS | Deadlock-Analyse steuern |
SET-SQL-DB-CATALOG-STATUS | Status einer Datenbank ändern |
SET-TUNING-TRACE | Auftragsprotokollierung steuern |
STOP-DBH | DBH-Session beenden |
Tabelle 64: Weitere DBH-Administrationsanweisungen, die den Datenbankbetrieb steuern
Administrationsanweisungen von SESDCN
Die folgende Tabelle zeigt eine Übersicht aller Administrationsanweisungen, die für die Administration von SESDCN zur Verfügung stehen. Die ausführliche Beschreibung von Syntax und Bedeutung der SESDCN-Administrationsanweisungen finden Sie im Handbuch „ Datenbankbetrieb“. Dort finden Sie auch die Zuordnung der Administrationsanweisungen zu den entsprechenden Administrationskommandos.
Administrationsanweisung | Kurzbeschreibung |
ADD-DISTRIBUTION-RULE-ENTRY | weitere Datenbank in die Verteilregel eintragen |
CREATE-DUMP | Hauptspeicherauszug (Dump) erzeugen |
HOLD-TRANSACTION-ADMISSION | keine weiteren Transaktionen zulassen |
HOLD-USER-ADMISSION | keine weiteren Auftraggeber zulassen |
MODIFY-ADMINISTRATION | Administrationsberechtigung ändern |
MODIFY-DISTRIBUTION-RULE-ENTRY | Rechnernamen in der Verteilregel ändern |
REMOVE-DISTRIBUTION-RULE-ENTRY | Datenbankeintrag bzw. -einträge aus der Verteilregel |
RESUME-TRANSACTION-ADMISSION | Transaktionsbetrieb wieder zulassen |
RESUME-USER-ADMISSION | neue Auftraggeber wieder zulassen |
ROLLBACK-TRANSACTION | Transaktion eines Auftraggebers zurücksetzen |
SET-USER-CALL-TRACE | Protokollierung der Anweisungen ausgewählter |
SET-USER-MSG-TRACE | Protokollierung von SESAM-Nachrichten ausgewählter |
SHOW-DISTRIBUTION-RULE-ENTRIES | aktive Datenbanken der Verteilregel anzeigen |
SHOW-TRANSACTIONS | alle offenen Transaktionen ausgewählter Auftraggeber |
SHOW-USERS | alle aktiven Auftraggeber mit entsprechender |
STOP-DCN | SESDCN beenden |
Tabelle 65: SESDCN-Administrationsanweisungen