|
dbname
Name der Datenbank
realmname
Name des Realms
kennwort
kennwort darf bis zu vier byte lang sein und wird folgendermaßen dargestellt:
C’xxxx’:
xxxx sind ein bis vier alphanumerische Zeichen und Sonderzeichen
X’nnnnnnnn’:
nnnnnnnn sind ein bis acht Sedezimalziffern
d:
d ist eine Dezimalzahl mit höchstens acht Ziffern und Vorzeichen, deren Wert zu einem Binärwert umgesetzt wird
Es gilt die BS2000-Syntax (siehe die Kommando-Handbücher zu „BS2000 OSD/BC“, ADD-PASSWORD)
admkennwort
admkennwort kann bis zu vier byte lang sein und wird folgendermaßen dargestellt:
C’xxxx’:
xxxx sind ein bis vier alphanumerische Zeichen und Sonderzeichen
X’nnnnnnnn’:
nnnnnnnn sind ein bis acht Sedezimalziffern
d:
d ist eine Dezimalzahl mit höchstens acht Ziffern und Vorzeichen, deren Wert zu einem Binärwert umgesetzt wird
Es gilt die BS2000-Syntax (siehe die Kommando-Handbücher zu „BS2000 OSD/BC“, ADD-PASSWORD)
Mit dem Kommando DROP kann der Datenbankadministrator Datenbanken, Realms und Kennwörter aus einer laufenden Session ausschließen.
Datenbank ausschließen
DROP DB=dbname
Ausschließen der genannten Datenbank. Alle beteiligten Realms erreichen einen Konsistenzpunkt. Damit wird die aktuelle DB-Konfiguration verändert.
Wenn die angegebene Datenbank nicht angeschlossen ist, und für sie kein Auftrag zum Anschließen vorliegt, wird dieses Kommando sofort zurückgewiesen.
Wenn ein Auftrag zum Anschließen eines Datenbankexemplars (Original oder Kopie) vorliegt, das derzeit nicht angeschlossen ist, so wird dieser Auftrag durch DROP DB widerrufen.
Wenn die Datenbank ausgeschlossen wird, werden die Anzahl der DML-Anweisungen pro Datenbank und die Anzahl der Ein- und Ausgaben pro Datenbank nach SYSOUT ausgegeben.
Beispiele
1. DROP DB für die VERSAND-Datenbank
//EXECUTE-DAL-CMD CMD=DROP DB=VERSAND % UDS0347 UDS-ADMINISTRATION LOGON = UAD@0E9P (OPDM239,12:58:52/0E9X) % UDS0220 UDS HAT FOLGENDES KOMMANDO ENTGEGENGENOMMEN: DROP DB=VERSAND (OPOX073,12:58:52/0E9X) % UDS0218 UDS HAT DIE BEARBEITUNG DES DAL-KOMMANDOS ABGESCHLOSSEN. (OPCC074,12:58:52/0E9X) //EXECUTE-DAL-CMD CMD=PERFORM % UDS0220 UDS HAT FOLGENDES KOMMANDO ENTGEGENGENOMMEN: PERFORM (OPOX073,12:58:52/0E9X) % UDS0206 UDS HAT DAS KOMMANDO ANGENOMMEN (OPCC012,12:58:52/0E9X) % UDS0356 UDS DURCHFUEHRUNG DER AUFTRAEGE FUER CONFBSPL STARTED (OPCC309,12:58:53/0E9X) % UDS0722 UDS AUFTRAG DROP DB=VERSAND WIRD AUSGEFUEHRT (OPCC283,12:58:53/0E9X) % UDS0758 ANZAHL DER DML-ANWEISUNGEN UND I/O-ZAEHLER PRO DATENBANK (OPCC758,12:58:53/0E9X) 0E9X: DATABASE NAME DMLS LOG READ PHYS READ LOG WRITE PHYS WRITE 0E9X: ------------------------------------------------------------------------ 0E9X: VERSAND 0 65 57 3 3 % UDS0356 UDS DURCHFUEHRUNG DER AUFTRAEGE FUER CONFBSPL TERMINATED (OPCC309,12:58:55/0E9X) % UDS0218 UDS HAT DIE BEARBEITUNG DES DAL-KOMMANDOS ABGESCHLOSSEN. (OPCC074,12:58:56/0E9X)
2. DROP DB für mehrere Datenbanken
//EXECUTE-DAL-CMD CMD=DROP DB=VERSAND % UDS0220 UDS HAT FOLGENDES KOMMANDO ENTGEGENGENOMMEN: DROP DB=VERSAND (OPOX073,12:59:00/0E9X) % UDS0218 UDS HAT DIE BEARBEITUNG DES DAL-KOMMANDOS ABGESCHLOSSEN. (OPCC074,12:59:00/0E9X) //EXECUTE-DAL-CMD CMD=DROP DB=KUNDEN % UDS0220 UDS HAT FOLGENDES KOMMANDO ENTGEGENGENOMMEN: DROP DB=KUNDEN (OPOX073,12:59:00/0E9X) % UDS0218 UDS HAT DIE BEARBEITUNG DES DAL-KOMMANDOS ABGESCHLOSSEN. (OPCC074,12:59:00/0E9X) //EXECUTE-DAL-CMD CMD=PERFORM % UDS0220 UDS HAT FOLGENDES KOMMANDO ENTGEGENGENOMMEN: PERFORM (OPOX073,12:59:00/0E9X) % UDS0206 UDS HAT DAS KOMMANDO ANGENOMMEN (OPCC012,12:59:00/0E9X) % UDS0356 UDS DURCHFUEHRUNG DER AUFTRAEGE FUER CONFBSPL STARTED (OPCC309,12:59:00/0E9X) % UDS0722 UDS AUFTRAG DROP DB=VERSAND WIRD AUSGEFUEHRT (OPCC283,12:59:03/0E9X) % UDS0722 UDS AUFTRAG DROP DB=KUNDEN WIRD AUSGEFUEHRT (OPCC283,12:59:03/0E9X) % UDS0758 ANZAHL DER DML-ANWEISUNGEN UND I/O-ZAEHLER PRO DATENBANK (OPCC758,12:59:03/0E9X) 0E9X: DATABASE NAME DMLS LOG READ PHYS READ LOG WRITE PHYS WRITE 0E9X: ------------------------------------------------------------------------ 0E9X: VERSAND 0 65 50 3 3 0E9X: KUNDEN 0 29 22 2 2 % UDS0356 UDS DURCHFUEHRUNG DER AUFTRAEGE FUER CONFBSPL TERMINATED (OPCC309,12:59:03/0E9X) % UDS0218 UDS HAT DIE BEARBEITUNG DES DAL-KOMMANDOS ABGESCHLOSSEN. (OPCC074,12:59:03/0E9X)
Realm ausschließen
DROP RN=realmname
[,DB=dbname]
Der DBH notiert einen Auftrag zum Ausschließen des mit realmname angegebenen Realms bzw. streicht einen vorliegenden ADD-Auftrag. Der Realm erreicht vor dem Ausschließen einen Konsistenzpunkt.
Die Angabe von DB=dbname ist nur nötig, wenn der Realm-Name nicht innerhalb der gesamten DB-Konfiguration eindeutig ist. Sie spezifiziert dann die gewünschte Datenbank.
Das DROP RN-Kommando kann nicht ausgeführt werden, wenn mit
PP DBNAME=dbname,SHA die Datenbank für ändernde Zugriffe gesperrt wurde. Zwischen den DBHs, die auf diese Datenbank parallel zugreifen, findet keine Kommunikation statt.
Das Ausschließen von Realms ist sinnvoll:
bei Geräte-Engpässen:
Realms können in konsistentem Zustand sowohl logisch als auch physisch ausgeschlossen werden.bei Hardwarefehlern, bei denen der DBH den Realm nicht automatisch ausschließt:
Der Datenbankadministrator kann dann nach dem DROP-Kommando mit anschließendem PERFORM parallel zur laufenden Session mit BMEND den Realm rekonstruieren. Dazu müssen alle zur Reparatur nötigen ALOG-Dateien vorhanden sein. Wenn die gerade aktuelle ALOG-Datei der zugehörigen Datenbank zur Reparatur gebraucht wird, muss zusätzlich ein CHECKPOINT-Kommando gegeben werden.
Die Aufträge zu DROP DB und DROP RN werden erst ausgeführt, wenn ihre Ausführung mit dem PERFORM-Kommando angestoßen wird.
Das Ausschließen eines Realm ist erst dann ausfallsicher im DBDIR protokolliert, wenn der Auftrag komplett abgearbeitet wurde. Ausfallsicher heißt, es überdauert Session-Unterbrechungen und das DBH-Ende.
Das DROP-Kommando ist ein direktes Gegenstück zum ADD-Kommando. Ein vorangegangenes ADD-Kommando kann solange durch DROP widerrufen werden, wie die Bearbeitung des ADD-Auftrags noch nicht durch PERFORM eingeleitet wurde.
Der Realm DBDIR kann nicht ausgeschlossen werden.
Kennwort für Dateien ausschließen
DROP PW=kennwort
Ausschließen des genannten Datei-Kennworts aus der Menge der Kennwörter.
Bei DROP PW prüft der DBH, ob das angegebene Datei-Kennwort bereits bekannt ist. Wenn dies der Fall ist, streicht der DBH das angegebene Datei-Kennwort.
Das DROP PW-Kommando wird von DBH zurückgewiesen, wenn das angegebene Datei-Kennwort nicht bekannt ist.
Datei-Kennwörter sollten Sie erst ausschließen, nachdem Sie die entsprechenden Dateien ausgeschlossen haben (siehe Abschnitt „Kennwörter für UDS/SQL-Dateien vergeben“).
Kennwort für die Administration ausschließen
DROP ADM=admkennwort
Ausschließen des genannten Datenbankadministrator-Kennworts.
Bei DROP ADM prüft der DBH, ob das angegebene Datenbankadministrator-Kennwort bereits vorhanden ist. Wenn dies der Fall ist, streicht der DBH das angegebene Kennwort. Das DROP ADM-Kennwort wird vom DBH zurückgewiesen, wenn das angegebene Kennwort nicht bekannt ist.
Die Kommandos DROP PW und DROP ADM werden sofort ohne PERFORM ausgeführt.