In diesem Thema werden die Parameter aufgelistet, mit denen Administratoren die verschiedenen AE-Dienstprogramme im Batch-Betrieb starten können. Sie können sie entweder über den Java-Loader oder das Dienstprogramm zuweisen.
Dieses Thema beinhaltet Folgendes:
Überblick
Beim Aufruf der Dienstprogramme AE DB Client Copy, AEDB Archive oder AE DB Reorg findet Batch-Modus eine Berechtigungsprüfung für den Single-Login statt. Beispiel: Existiert für den angemeldeten Betriebssystem-Benutzer kein entsprechendes Benutzer-Objekt im AE-System, bricht das Dienstprogramm den Batchaufruf ab. Diese Prüfung wird immer durchgeführt, auch wenn die Systemvariable UC_USER_LOGON alle relevanten Einträge enthält. Ein Single-Login bietet erhöhte Sicherheit im Batch-Modus. Wenn ein Programm mit demAutomic Web Interface, Single-Login beginnt, erhöht sich die Benutzerfreundlichkeit.
Windows
Standardmäßig starten die Dienstprogramme im Batch-Betrieb, wenn Sie die entsprechenden *.EXE-Dateien verwenden. Dateien, die mit *G.EXE enden, starten die Dienstprogramme im Normalmodus. Trotzdem können Sie den *G.EXE-Dateien Parameter zuweisen. Beispiel: Sie möchten eine bestimmte INI-Datei aufrufen. Der Parameter -B darf in diesem Fall nicht verwendet werden.
Unix
Standardmäßig starten die Dienstprogramme im Batch-Betrieb, wenn Sie die entsprechenden *.sh-Dateien verwenden. Dateien ohne Dateiendung können verwendet werden, um Startparameter für die Batch-Aufrufe zuzuweisen.
Java-Loader
Programm: Java-Loader
Die folgenden Startparameter stehen zur Verfügung:
- -F0Dateiname
Unterdrückt den Splash-Screen - -IPfad und Dateiname
Pfad und Name der INI-Datei für den Java-Loader - -JParameter
Parameter des Dienstprogramms - die Parameterkette
- Pfadangaben, die Leerzeichen enthalten.
Sie können den Java-Loader verwenden, um dem Dienstprogramm Parameter zuzuweisen, wie unten beschrieben. Diese Parameter werden dem Abschnitt cmd in der INI-Datei hinzugefügt. Das bedeutet, dass Sie eine Standardeinstellung in der INI-Datei angeben und bestimmte Situationen über den Java-Loader behandeln können.
Es ist zwingend erforderlich, doppelte Anführungszeichen zu verwenden für
Beispiel:
-J"-I""C:\AUTOMIC\my utilities\UCYBDBAR.ini"""
Beispiele
Stellen Sie die Sprache über eine Verknüpfung ein:
cmd="javaw" -jar -cp .;.\UC4LAF.jar UCYBDBar.jar
Legen Sie die Sprache über eine Verknüpfung fest:
UCYBDBarg.exe -F0 -J"-LD"
Bei der Vorgabe einer INI-Datei für das Dienstprogramm müssen Sie den Parameter -I zwei Mal angeben, auch wenn der Java-Loader und das Dienstprogramm dieselbe INI-Datei verwenden.
Java-Loader und Dienstprogramm verwenden die gleiche INI-Datei:
ucybdbccg -IUCYBDBCC.ini -J"-IUCYBDBCC.ini"
Es werden verschiedene INI-Dateien verwendet:
ucybdbccg -IUCYBDBCC.ini -J"-Iclientcopy.ini"
Dieses Dienstprogramm archiviert Nachrichten, Reports und Statistiken. Details hierzu finden Sie unter AEDB Archive
Syntax
- Archivierungsmodus
UCYBDBAR [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -Smmmm
- Reportmodus
UCYBDBAR [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -Smmmm -XModus
UCYBDBAR [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -Smmmm -Xlist [-OPfad und Dateiname] [-YZahl]
UCYBDBAR [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -Smmmm -Xunload [-OPfad und Dateiname] [-YZahl] -RRunID [-TZeitzone] [-TYReporttyp]
UCYBDBAR [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -Smmmm -Xmark -RRunID [-TYReporttyp]
UCYBDBAR [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -Xreport -NObjektname [-T1jjjjmmtthhmmss] [-T2jjjjmmtthhmmss] [-PDateipräfix]
Programm: UCYBDBAR
Die folgenden Startparameter stehen zur Verfügung:
- -V
Gibt die Automation Engine -Version samt Hotfixnummer in folgendem Format aus: - -VPfad und Dateiname
Gibt die Automation Engine-Version samt Hotfixnummer in die Datei in folgendem Format aus: - -IDateiname
Pfad und Name der INI-Datei - -LSprache
Sprachenparameter
Erlaubte Werte: D (Deutsch, E (Englisch), F (Französisch)Wird der Parameter nicht angegeben, so wird die Sprache verwendet, die in der INI-Datei gesetzt ist.
- -B
Batch Modus
UCYBDBar-Version Automation Engine-Version plus Hotfixnummer
UCYBDBar-Version Automation Engine-Version plus Hotfixnummer
Im Archivierungsmodus:
- -Smmmm
Nummer des Mandanten, der archiviert werden soll - -Dmmmm
(nur Windows) Nummer des Mandanten, der archiviert werden soll
Wichtig! Der Benutzer, der das Dienstprogramm im Batchmodus startet, muss ein Benutzer-Objekt in diesem Mandanten besitzen.
Beispiel: Für den Betriebssystem-Benutzer MEIER muss ein Benutzer-Objekt namens MEIER/Abteilungsname existieren. Beachten Sie, dass kein anderes Benutzer-Objekt mit MEIER beginnen darf. Es ist nicht möglich, MEIER/AE und MEIER/TEST zu verwenden.
Wichtig! Der Benutzer, der das Dienstprogramm im Batchmodus startet, muss ein Benutzer-Objekt in diesem Mandanten besitzen.
Beispiel: Für den Betriebssystem-Benutzer MEIER mit der Domain AE muss ein Benutzer-Objekt namens MEIER/AE existieren.
Im Reportmodus:
- -Smmmm
-Dmmmm
Im Reportmodus muss außer für -Xreport immer ein Mandant angegeben werden. Für die Parameter -S und -D gelten dieselben Vorgaben wie im Archivierungsmodus. - -Xlist
Mandant dessen Reports aufgelistet werden soll - -Xunload und -Xmark
Der Mandant wird für die Anmeldeprüfung verwendet. Es muss ein Benutzer-Objekt vorhanden sein. Andernfalls bricht das Dienstprogramm den Vorgang ab. - -XModus
Art der Reportbehandlung - list
Reports werden aufgelistet - unload
Report wird entladen - mark
Report wird als archiviert gekennzeichnet und aus der Datenbank-Tabelle „XRO“ entfernt. - report
Aus den Logeinträgen von Serverprozessen werden Dateien erzeugt - Parameter für -Xlist
- -OPfad und Dateiname
Pfad und Name der CSV-Datei- Wird kein Dateiname angegeben, wird der Name uc_XROlist.csv verwendet.
- Wenn Sie keinen Pfad angeben, wird die Datei in dem Ordner gespeichert, in dem sich das Dienstprogramm befindet.
- -YZahl
Filter für die Reportselektierung
- -OPfad und Dateiname
- Parameter für -Xunload
- -OPfad und Dateiname
Pfad und Name der Textdatei
Das Punktzeichen (.) wird als Trennzeichen zwischen dem Dateinamen und der Erweiterung verwendet. Wenn der Name mehrere Punktsymbole enthält, wird das letzte als Trennzeichen zwischen dem Dateinamen und der Erweiterung betrachtet. Der Text nach dem Punkt wird als Dateiendung behandelt.
Pro Report der Aufgabe wird im angegebenen Ordner eine Datei mit dem zusätzlichen Suffix _Reporttyp im Dateinamenteil erstellt.
Beispiele:
-OOutputfile.txt -> Outputfile_ACT.txt
-OOutputfile.job.name.txt -> Outputfile.job.name_ACT.txt
-OOutputfile.job123456 -> Outputfile_ACT.job123456
oder generisch:
-OOutputfilename.extension (the last dot is used as extension separator) -> Outputfilename_ReportType.extension
Wird kein Dateiname angegeben, wird der Name uc_XROreport_Reporttyp.txt verwendet. Standardmäßig werden die Dateien im Ordner des Dienstprogramms abgelegt.
- -YZahl
Setzen einer Zahl für die spätere Filterung - -RRunID
RunID der Aufgabe - -TZeitzone
Name eines Zeitzonenobjekts
Standardwert: Die Universalzeit (UTC) wird in entladenen Reports verwendet. Mit diesem Parameter können Sie die Zeitangaben in eine andere Zeitzone umrechnen.
Wenn das Zeitzonenobjekt nicht im angegebenen Mandanten existiert, wird UTC verwendet.
- -TYReporttypen
Typ des Reports (z.B. ACT)
Wird kein Reporttyp angegeben, so werden alle Reports der Aufgabe jeweils in eine eigene Datei exportiert.
- -OPfad und Dateiname
- Parameter für -Xmark
- -RRunID
RunID der Aufgabe - -TYReporttypen
Typ des Reports (z.B. ACT)
Wird dieser Parameter nicht angegeben, so werden alle Reporttypen archiviert. Für jeden Reporttyp wird eine eigene Datei erstellt. Namen enden mit _Reporttyp (Beispiel: _ACT).
- -RRunID
- Parameter für -Xreport
- -NObjektname
Name eines Objektes oder Filter mit (*) auf mehrere Objekte.
Mehrere Angaben sind mit Beistrichen zu trennen.
- -T1jjjjmmtthhmmss
Startdatum und -zeit für die zu selektierenden Serverreports
Standardwert: Liefert das aktuelle Datum und die aktuelle Uhrzeit 00:00:00
- -T2jjjjmmtthhmmss
Enddatum und -zeit für die zu selektierenden Serverreports
Standardwert: Das aktuelle Datum und die aktuelle Uhrzeit.
- -PPfad und Dateipräfix
Pfad und Dateipräfix für die Zieldatei
Standardwert: Die Zieldateien erhalten das Präfix unload. Sie werden im Ordner des Dienstprogramms gespeichert.
Der Dateiname setzt sich wie folgt zusammen: Präfix.Objektname_Datum_Uhrzeit.txt
- -NObjektname
Je nach verwendetem Reportmodus hat die Angabe des Mandanten eine andere Bedeutung:
Zur Zusammenfassung von Log- und Trace-Dateien:
Beispiele
Der Mandant 1 wird archiviert.
UCYBDBar -B -S0001
Das Dienstprogramm erstellt eine Reportliste und schreibt sie in die Datei report01.csv.
UCYBDBar -B -Xlist -S1000 -OC:\AUTOMIC\REPORT\report01.csv
Der Report mit der Nummer 1791029 wird in eine Textdatei entladen und erhält den Status 123.
UCYBDBar -B -Xunload -S1000 -R1791029 -Y123
AE DB Archive kennzeichnet den Report mit der Nummer 1791029 als archiviert und entfernt ihn aus der Datenbanktabelle.
UCYBDBar -B -Xmark -S1000 -R1791029
Alle Serverreports des 15. März 2018 sollen entladen werden.
UCYBDBar -B -Xreport -N"UC4#CP*,UC4#WP*" -T120180315000000 -T220180315235959 -P"C:\AUTOMIC\report\server"
Das Dienstprogramm soll nur die Reports der Arbeitsprozesse WP001 und WP002 entladen.
UCYBDBar -B -Xreport -N"UC4#WP001,UC4#WP002" -T120070315000000 -T220070315235959
Dieses Dienstprogramm ändert Objekte, die mit dem Transportkoffer transportiert wurden. Details hierzu finden Sie unter AE DB Change
Syntax
UCYBCHNG [-V[Pfad und Dateiname]] -B -1Scriptdatei-2Transportdatei [-3Ausgabedatei] [-LSprache]
Programm: UCYBCHNG.EXE
Die folgenden Startparameter stehen zur Verfügung:
- -V
Gibt die Automation Engine -Version samt Hotfixnummer in folgendem Format aus:
UCYBChng-Version Automation Engine-Version plus Hotfixnummer
- -VPfad und Dateiname
Gibt die Automation Engine-Version samt Hotfixnummer in die Datei in folgendem Format aus: - -B
Batch Modus - -1Script-Datei
Die Datei enthält die Anweisungen (REPLACE) für die Änderungen. - -2Transportdatei
Beinhaltet die Original-Daten des Exportes
Standardwert: UC_DATA.TXT - -3Output-Datei
In diese Datei werden die geänderten Daten geschrieben - -LSprache
Sprachenparameter
Erlaubte Werte: D (Deutsch, E (Englisch), F (Französisch)Wird der Parameter nicht angegeben, so wird die Sprache verwendet, die in der INI-Datei gesetzt ist.
UCYBChng-Version Automation Engine-Version plus Hotfixnummer
Beispiel
ucybchng -b -1c:\AUTOMIC\uc_change.txt -2c:\AUTOMIC\uc_transport.txt -3c:\AUTOMIC\uc_transport_new.txt
Dieses Dienstprogramm kopiert und löscht Mandanten. Details hierzu finden Sie unter AE DB Client Copy
Syntax
- Kopiermodus
- Löschmodus
UCYBDBCC [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -C -Smmmm -Tmmmm -O [-M][-A][-R] [-V] [-W]
UCYBDBCC [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -E -Smmmm
UCYBDBCC [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -E -Tmmmm
Programm: UCYBDBCC
Die folgenden Startparameter stehen zur Verfügung:
- -V
Gibt die Automation Engine-Version samt Hotfixnummer in folgendem Format aus: - -VPfad und Dateiname
Gibt die Automation Engine-Version samt Hotfixnummer in die Datei in folgendem Format aus: - -IDateiname
Pfad und Name der INI-Datei - -LSprache
Sprachenparameter
Erlaubte Werte: D (Deutsch, E (Englisch), F (Französisch)Wird der Parameter nicht angegeben, so wird die Sprache verwendet, die in der INI-Datei gesetzt ist.
- -B
Im Batchmodus starten, Single-Logon wird verwendet - -V
Gibt die Automation Engine-Version und Hotfixnummer aus
UCYBDBcc-Version Automation Engine-Version plus Hotfixnummer
UCYBDBcc-Version Automation Engine-Version plus Hotfixnummer
Im Kopiermodus:
- -C
Mandanten kopieren - -Smmmm
Nummer des Quellmandanten - -Dmmmm
(nur Windows) Nummer des Quellmandanten - Die Parameter -D und -S dürfen nicht zusammen verwendet werden.
- Der Systemmandant 0, der das Dienstprogramm im Batchmodus startet, muss ein Benutzer-Objekt in diesem Mandanten besitzen.
Hinweis: Der Betriebssystem-Benutzer muss in beiden Datenbanken als AE-Benutzer im Systemmandanten 0000 vorhanden sein. Andernfalls wird der Prozess mit einer Fehlermeldung abgebrochen.
Wichtig: Der Systemmandant 0, der das Dienstprogramm im Batchmodus startet, muss ein Benutzer-Objekt in diesem Mandanten besitzen.
Beispiel: Für den Betriebssystem-Benutzer MEIER muss ein Benutzer-Objekt namens MEIER/Abteilungsname existieren. Beachten Sie, dass kein anderes Benutzer-Objekt mit MEIER beginnen darf. Es ist nicht möglich, MEIER/AE und MEIER/TEST zu verwenden.
Wichtig:
Beispiel: Für den Betriebssystem-Benutzer MEIER mit der Domain AE muss ein Benutzer-Objekt namens MEIER/AE existieren.
- -Tmmmm
Nummer des Zielmandanten - -O
Objekte kopieren - -M
Nachrichten kopieren - -A
Statistiken und Reports kopieren - -R
Passwort zurücksetzen - -V
Versionsobjekte kopieren - -W
Arbeitsdateien nach erfolgreichem Kopieren löschen
Für den Benutzer gelten dieselben Voraussetzungen wie beim Parameter -S.
Im Löschmodus:
- -E
Mandanten löschen - -Smmmm, -Dmmmm, -Tmmmm
In der INI-Datei können Sie verschiedene Datenbanken für Quelle und Ziel definieren.- -S oder -D
Löscht den Mandanten in der Quelldatenbank - -T
Löscht die Zieldatenbank
Für diese Parameter gelten dieselben Voraussetzungen wie im Kopiermodus.
- -S oder -D
Wichtig! Der Betriebssystem-Benutzer muss in beiden Datenbanken als AE-Benutzer im Systemmandanten 0 vorhanden sein. Andernfalls wird der Prozess mit einer Fehlermeldung abgebrochen.
Beispiele
Mandanten kopieren:
Die Objekte, Statistiken und Reports des Mandanten 38 werden in einen neuen Mandanten mit der Nummer 2 kopiert:
UCYBDBcc -B -C -S0038 -T0002 -O -A
Mandanten löschen:
Der Mandant 2 wird in der Zieldatenbank gelöscht.
UCYBDBcc -B -E -T0002
Dieses Dienstprogramm lädt Daten in die Datenbank. Details hierzu finden Sie unter AE DB Load
Syntax
- Laden von Transportkoffer / Initialdaten
- Setzen der Authentifizierungsmethode
UCYBDBLD [-V[Pfad und Dateiname]] [-IDateiname] [-FOrdnerverwaltung] [-LSprache] -B -Cmmmm [-EModus] [-UName/Abteilung] [-GName] [-AZugang] [-MZugang] -XDateiname
UCYBDBLD [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B-TAuthentifizierungsmethode-KZeichenfolge für den Company Key
Programm: UCYBDBLD
Die folgenden Startparameter stehen zur Verfügung:
-
-V
Gibt die Automation Engine-Version und die Hotfixnummer aus
Format: UCYBDBld-Version Automation Engine-Version plus Hotfixnummer
-
-VPfad und Dateiname
Gibt die Automation Engine-Version samt Hotfixnummer in die angegebene Datei aus
Format: UCYBDBld-Version Automation Engine-Version plus Hotfixnummer
-
-IDateiname
Pfad und Name der INI-Datei
-
-FOrdnerverwaltung
Definiert das Verhalten von DB Load in Bezug auf Ordner. Beim Ersetzen von Objekten oder verknüpften Objekten bleiben die Daten des Benutzerverzeichnisses und der verknüpften Objekte des Transportkoffers erhalten.
Erlaubter Wert: OT
Wichtig! Wenn dieser Wert gesetzt ist, überschreiben die Daten, die in der Datendatei des Transportkoffers enthalten sind, bereits vorhandene Objekte in der Automation Engine-Datenbank .
-
-LSprache
Sprachenparameter
Erlaubte Werte: D (Deutsch, E (Englisch), F (Französisch)
Wird der Parameter nicht angegeben, so wird die Sprache verwendet, die in der INI-Datei gesetzt ist.
-
-B
Batch Modus
-
-ILM
ILM installieren
-
-N[X]
Anzahl der aktiven Partitionen
-
-SAH_part1|AH_part2|AH_part3
Liste der AH-Partitionen getrennt durch |
-
-RRH_part1>RH_part2|RH_part3
Liste der RH-Partitionen getrennt durch |
-
-OMisc_part1|Misc_part2|Misc_part3
Liste der sonstigen Partitionen getrennt durch |
-
-D
Switch-In durchführen
Beispiel
ucybdbld.exe -B -ILM -N3 "-SAH_1|AH_2|AH_3" "-RRH_1|RH_2|RH_3" "-OMisc_1|Misc_2|Misc_3" -D -X..\db\general\12.0\UC_UPD.TXT
-
-
-Cmmmm
Nummer des Mandanten für Verarbeitung
-
-C-1
Behält Mandanten
-
-Cmmmm
Spielt den Transportkoffer in Mandanten mmmm ein
-
-
-EModus
Verarbeitungsmodus bei bereits vorhandenen Objekten
Hinweis: Nur im Batch-Modus verfügbar
Erlaubte Werte:
-
IGNORE Das Objekt wird übersprungen (Standardwert)
Wichtig: IGNORE verlangt, dass das Originalobjekt und das zu ladende Objekt vom gleichen Typ sind. Andernfalls wird die Verarbeitung abgebrochen, bevor der Ladevorgang beginnt.
-
ABEND Die Verarbeitung wird abgebrochen
-
REPLACE Das vorhandene Objekt wird ersetzt
-
-
-UName/Abteilung
Name und Abteilung eines Standard-Benutzers
Wenn ein Benutzer auf Objektebene keine Zugriffsberechtigungen hat, kann er durch einen Standard-Benutzer ersetzt werden.
-
-GName
Name einer Standard-Benutzergruppe
Wenn die Benutzergruppe auf Objektebene keine Zugriffsberechtigungen hat, kann sie durch eine Standard-Benutzergruppe ersetzt werden.
-
-AZugriff
Zugriffsberechtigungen auf Objektebene laden. Siehe Seite „Berechtigungen“
Erlaubte Werte:
-
Y (Standardwert)
-
N Zugriffsberechtigungen auf Objektebene werden nicht geladen
-
-
-MZugriff
Zugriffsberechtigungen, die auf fehlende Benutzer und Benutzergruppen verweisen, ignorieren
Erlaubte Werte:
-
Y ignoriert Zugriffsberechtigungen für fehlende Benutzer und Benutzergruppen. Sie werden nicht geladen.
-
N (Standardwert) Bricht den Ladevorgang für die Zugriffsberechtigung fehlender Benutzer und Benutzergruppen ab
-
-
-XDateiname
Name der zu ladenden Datei Dieser Startparameter ist obligatorisch.
-
-TAuthentifizierungsmethode und
-KZeichenfolge für den Company Key Authentifizierungsdetails
Wichtig! Das Dienstprogramm ist nur dann mit diesen Startparametern aufzurufen, wenn Sie eine Neuinstallation ohne die Hilfe des Automic Web Interface vornehmen.
Beide Parameter müssen zusammen verwendet werden:
-
-T
Einstellen der Authentifizierungsmethode
Erlaubte Werte: NO, LOCAL, LOCAL_REMOTE
So exportieren Sie eine Datei, die den Authentifizierungskey enthält:
Erlaubter Wert: PACKAGE
-
-K Bildet den Company Key
Erlaubte Werte: Beliebige Zeichen
Maximale Länge: 32
Tipp: Geben Sie immer eine Zeichenfolge für den Company Key an, auch wenn Sie keine Authentifizierung (-TNO) verwenden. Es wird empfohlen, den AE-Systemnamen als Company Key zu verwenden.
Wichtig!
Beachten Sie, dass die Zeichenfolge in Anführungszeichen angegeben werden muss, wenn sie Sonderzeichen enthält. Möchten Sie innerhalb der Zeichenfolge ein Anführungszeichen verwenden, müssen Sie vor diesem ein weiteres Anführungszeichen (unter Windows) bzw. einen „\“ (unter Unix) setzen.
Die Verwendung dieser Startparameter führt zu einem Fehler beim erstmaligen Laden der Initialdaten. Verwenden Sie das Dienstprogramm, um das Schema zu erstellen, und starten Sie es dann neu, um die Authentifizierungsdaten festzulegen.
Beispiel:
Step 1: java -jar ucybdbld.jar -B -XC:\AE\Utility\db\general\12.1\UC_UPD.TXT
Step 2: java -jar ucybdbld.jar -B -TNO -KabcAlternativ können Sie auch die grafische Oberfläche des Dienstprogramms verwenden.
-
Beispiele
Die Datei UC_DATA.TXT wird in den Mandanten 11 geladen, wobei bestehende Objekte ersetzt werden.
UCYBDBld -B -C0011 -XC:\AUTOMIC\UTILITY\temp\UC_DATA.TXT -EREPLACE
Die Authentifizierungsmethode Server und Agent soll im AE-System eingestellt werden.
UCYBDBld -B -TLOCAL_REMOTE -KUC4PROD
Dieses Dienstprogramm reorganisiert Nachrichten, Reports, Statistiken und Objektversionen. Details hierzu finden Sie unter AE DB Reorg
Syntax
UCYBDBRE [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -Smmmm
Programm: UCYBDBRE
Die folgenden Startparameter stehen zur Verfügung:
- -V
Gibt die Automation Engine-Version samt Hotfixnummer in folgendem Format aus:
UCYBDBre-Version Automation Engine-Version plus Hotfixnummer
- -VPfad und Dateiname
Gibt die Automation Engine-Version samt Hotfixnummer in die Datei in folgendem Format aus:
UCYBDBre-Version Automation Engine-Version plus Hotfixnummer
- -IDateiname
Pfad und Name der INI-Datei - -LSprache
Sprachenparameter
Erlaubte Werte: D (Deutsch, E (Englisch), F (Französisch)Wird der Parameter nicht angegeben, so wird die Sprache verwendet, die in der INI-Datei gesetzt ist.
- -B
Batch Modus - -Smmmm
Nummer des Mandanten, der reorganisiert werden soll
Wichtig! Der Benutzer, der das Dienstprogramm im Batchmodus startet, muss ein Benutzer-Objekt in diesem Mandanten besitzen.
Beispiel: Für den Betriebssystem-Benutzer MEIER muss ein Benutzer-Objekt namens MEIER/Abteilungsname existieren. Beachten Sie, dass kein anderes Benutzer-Objekt mit MEIER beginnen darf. Es ist nicht möglich, MEIER/AE und MEIER/TEST zu verwenden.
- -Dmmmm
(nur Windows) Nummer des Mandanten, der reorganisiert werden soll
Wichtig! Der Benutzer, der das Dienstprogramm im Batchmodus startet, muss ein Benutzer-Objekt in diesem Mandanten besitzen.
Beispiel: Für den Betriebssystem-Benutzer MEIER mit der Domain AE muss ein Benutzer-Objekt namens MEIER/AE existieren
Beispiel
Der Mandant 98 wird reorganisiert.
UCYBDBre -B -S0098
Dieses Dienstprogramm erleichtert benutzerdefinierte AE-Abfragen.
Syntax
UCYBDBRT [-IDateiname] [-LSprache] [-Cmmmm]-XPfad und Dateiname [-Rjjjjmmtt[hhmm]] [-S] [-OPfad und Dateiname] [-TDateityp]
Programm: UCYBDBRT.EXE
Die folgenden Startparameter stehen zur Verfügung:
- -Cmmmm
Nummer des Mandanten für die Verarbeitung
Der Mandant, welcher in der Definition der Abfrage angegeben wurde, wird dadurch überschrieben. - -XPfad und Dateiname
Pfad und der Name der XML-Datei - -I Pfad und Dateiname
Pfad und Name der INI-Datei - -LSprache
Sprachenparameter
Erlaubte Werte: D (Deutsch), E (Englisch), F (Französisch) - -Rjjjjmmtt[hhmm]
Referenzdatum und -uhrzeit für Auswertungen von Statistiken und Prognosen
Auch dieser Parameter überschreibt die Definition in der Abfrage.
Tipp: Beachten Sie, dass die Einträge der AE-Datenbank in der Zeitzone UTC gespeichert sind. Geben Sie daher den Referenz-Zeitpunkt ebenfalls in dieser Zeitzone an.
- -S
Liefert die Anzahl der ausgegebenen Zeilen - -OPfad und Dateiname
Pfad und Name der Ausgabedatei - -TDateityp
Typ der Ausgabedatei
Erlaubte Werte: CSV und HTML
Beispiel
Aus der Abfrage, die in der Datei jobtop10.d.xml definiert wurde, wird für den Mandanten 100 eine Auswertung erstellt.
UCYBDBRT -C0100 -XC:\AUTOMIC\Utilities\analyses\jobtop10.d.xml
Dieses Dienstprogramm erstellt Revisionsreports.
Syntax
UCYBDBRR [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -Cmmmm [-OPfad und Dateiname] [-FTyp1,Typ2,...] [-D1jjjjmmtthhmmss] [-D2jjjjmmtthhmmss] [-A] [-X]
Programm: UCYBDBRR.EXE
Die folgenden Startparameter stehen zur Verfügung:
- -V
Gibt die Automation Engine-Version samt Hotfixnummer in folgendem Format aus:
UCYBDBRR-Version Automation Engine-Version plus Hotfixnummer
- -VPfad und Dateiname
Gibt die Automation Engine-Version samt Hotfixnummer in die Datei in folgendem Format aus:
UCYBDBRR-Version Automation Engine-Version plus Hotfixnummer
- -IPfad und Dateiname
Pfad und Name der INI-Datei - -LSprache
Sprachenparameter
Erlaubte Werte: D (Deutsch, E (Englisch), F (Französisch)Wird der Parameter nicht angegeben, so wird die Sprache verwendet, die in der INI-Datei gesetzt ist.
- -B
Batch Modus - -Cmmmm
Nummer des Mandanten für die Verarbeitung - -OPfad und Dateiname
Pfad und Name des Revisionsreports
Standardwert: Standardmäßig wird der Report unter dem Namen UCYBDBRRoutput.txt im Ordner des Dienstprogrammes abgelegt.
- -FTyp1,Typ2,...
Steuerung der gewünschten Inhalte des Revisionsreports. Geben Sie die gewünschten Inhaltstypen mit Komma getrennt an. - ACCESS
Unerlaubte Zugriffe - CANCEL
Abbruch von Aufgaben - CREATE
Neuanlegen von Objekten - DELETE
Löschen von Objekten - IMPORT
Import von Objekten - MOVE
Verschieben von Objekten - OBJ_MOD
Änderungen von Objekten - RENAME
Umbenennen von Objekten - RESTART
Wiederanlauf von Aufgaben - RESTORE
Wiederherstellen von Objekten - RUN_MOD
Modifikationen zur Laufzeit - START
Start von Aufgaben - TRNSPRT
Transport von Objekten - USER
Erfolgreiche An- und Abmeldungen von Benutzern - -D1jjjjmmtthhmmss
Startdatum und -zeit für die Protokollierung
Erlaubte Werte:
Das Dienstprogramm gibt alle Inhalte in den Revisionsreport aus, wenn Sie diesen Parameter nicht verwenden oder -F* angeben.
Standardwert: Die Selektion wird nicht durch einen Startzeitpunkt eingeschränkt. Es wird empfohlen, einen Startzeitpunkt anzugeben, da der Revisionsreport sonst sehr groß wird.
Als Zeitzone wird die des Mandanten verwendet. Ist dort keine eingetragen, kommt die Zeitzone des Systemmandanten 0000 zur Anwendung. Fehlt dort ebenfalls die Zeitzone, wird UTC verwendet.
Alle Änderungsdaten werden in den Report geschrieben, wenn die Zeitparameter -D1 und -D2 nicht verwendet werden. Die Filter -F und -X werden berücksichtigt.
- -D2jjjjmmtthhmmss
Enddatum und -zeit für die Protokollierung
Standardwert: Aktuelles Datum und Uhrzeit.
Als Zeitzone wird die des Mandanten verwendet. Ist dort keine eingetragen, kommt die Zeitzone des Systemmandanten 0 zur Anwendung. Fehlt dort ebenfalls die Zeitzone, wird UTC verwendet.
Alle Änderungsdaten werden in den Report geschrieben, wenn die Zeitparameter -D1 und -D2 nicht verwendet werden. Die Filter -F und -X werden berücksichtigt.
- -A
Der Parameter bewirkt, dass Archivkennzeichen gesetzt werden. Er steht in Zusammenhang mit dem Parameter -X.
Der Start von Aufgaben wird aus den Statistiksätzen ermittelt, siehe Startparameter -FSTART. Daher kann das Dienstprogramm für diese Datensätze keine Archivkennzeichen setzen.
- -X
Geben Sie diesen Parameter an, so werden nur jene Revisionseinträge in den Report geschrieben, die zuvor noch nie durch das Dienstprogramm ausgegeben wurden, d.h. kein Archivkennzeichen aufweisen.
Beispiele
Sämtliche Revisionsinformationen des Mandanten 1 zwischen 01.05 00:00 und dem aktuellen Datum werden in einen Report ausgegeben.
UCYBDBRR -B -C0001 -O/uc4/reports/report01.txt -D120170501000000
Sämtliche Start- und Wiederanlaufpunkte zwischen 01.10. 08:00 und 01.10. 12:00 werden in einen Report ausgegeben.
UCYBDBRR -B -LD -C0100 -FSTART,RESTART -D120171001080000 -D220171001200000
Dieses Dienstprogramm entlädt Daten. Details hierzu finden Sie unter AE DB Unload
Syntax
UCYBDBUN [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -BModus [-D][-Cmmmm] [-XDateiname] [-K]
Programm: UCYBDBUN
Die folgenden Startparameter stehen zur Verfügung:
- -V
Gibt die Automation Engine-Version samt Hotfixnummer in folgendem Format aus:
UCYBDBun-Version Automation Engine-Version plus Hotfixnummer
- -VPfad und Dateiname
Gibt die Automation Engine-Version samt Hotfixnummer in die Datei in folgendem Format aus:
UCYBDBun-Version Automation Engine-Version plus Hotfixnummer
- -IDateiname
Pfad und Name der INI-Datei - -LSprache
Sprachenparameter
Erlaubte Werte: D (Deutsch, E (Englisch), F (Französisch)Wird der Parameter nicht angegeben, so wird die Sprache verwendet, die in der INI-Datei gesetzt ist.
- -BModus
Batch-Modus und Verarbeitungsmodus - NORMAL
Es werden alle Daten aller Tabellen der Datenbank entladen. - INITIAL
Die Daten werden aus dem Mandanten 0 übernommen. Es werden nur initiale Daten wie XREQs entladen. -
Standarddaten des Systems werden entladen (z.B. Mandant 0, Initialbenutzer und Benutzergruppe). - REPAIR
Die Ordnerstruktur des Explorers wird überprüft und repariert. - REORG
Die Datenbank wird reorganisiert. - TRANSPORT
Der Transportkoffer ist entladen. - TRANSPORTALL
Alle Objekte werden transportiert. Um Objekte nach dem Entladevorgang aus dem Transportkoffer zu entfernen, verwenden Sie -D. - RESETARCHIVE
Archivkennzeichen werden zurückgesetzt. Siehe AEDB Archive - RESETREORG
Löschkennzeichen werden zurückgesetzt. Siehe AE DB Reorg - -D
Dieser Startparameter entfernt nach dem Entladevorgang alle Objekte aus dem Transportkoffer. - -Cmmmm
Nummer des Mandanten für das Entladen des Transportkoffers - -XDateiname
Name der Datei, welche die zu entladenden Daten aufnimmt
Über das gesamte AE-System:
Sowohl über das gesamte AE-System als auch mandantenabhängig:
Alle Mandanten werden entladen, wenn Sie hier keinen Mandanten definieren.
Wichtig! Sie können den Mandanten 0 nicht entladen. Selbst wenn Sie -C0 verwenden, werden Mandanten mit Ausnahme des Mandanten 0 entladen.
Wird dieser Parameter nicht angegeben, verwendet das Dienstprogramm den Namen und Pfad der Datei, die im Parameter-Output = in der INI-Datei festgelegten wurde.
Wichtig! Dieser Parameter kann nicht in Zusammenhang mit -BREORG verwendet werden, da diese speziellen Dateien einer vorgegebenen Namenskonvention unterliegen.
- -K
Das Setzen dieses Parameters bewirkt, dass gelöschte Objekte auch nach dem Entladen noch im Papierkorb vorhanden sind.
Beispiele
Die AE-Datenbank wird reorganisiert.
UCYBDBun -BREORG
Der Transportkoffer des Mandanten 11 wird entladen und das Dienstprogramm verwendet den Pfad und die Dateinamen, die unter OUTPUT= der INI-Datei des Dienstprogramms angegeben sind. Der Transportkoffer wird anschließend geleert.
UCYBDBun -BTRANSPORT -D -C0011
Das Dienstprogramm hat mit der Meldung U0021148 auf einen Fehler in der Ordnerstruktur eines Mandanten aufmerksam gemacht. Die Korrekur-Funktion soll daher aufgerufen werden.
UCYBDBun -BREPAIR
Dieses Dienstprogramm kombiniert Reports, Protokolle und Trace-Dateien. Details hierzu finden Sie unter AE.LogMix - Zusammenfassen von Report-, Log- und Trace-Dateien
Syntax
UCYBLGMX [-V[Pfad und Dateiname]] -B-LPfad und Namen der Log- und Trace-Dateien -FPfad und Name der Zieldatei
Programm UCYBLGMX
Die folgenden Startparameter stehen zur Verfügung:
- -V
Gibt die Automation Engine-Version mit der Hotfixnummer im folgenden Format aus: - -VPfad und Dateiname
Gibt die Automation Engine-Version samt Hotfixnummer in die Datei in folgendem Format aus: - -B
Batch Modus - -LPfade und Namen der Log- und Trace-Datei
Log- bzw. Trace-Dateien, die zu einer Zieldatei zusammengeführt werden sollen - Pfad Datei1, Datei2, Datei3
Der Pfad der ersten Datei wird auch für die nachfolgenden Dateien verwendet. - Pfad und Datei1, Pfad und Datei2, Pfad und Datei3
UCYBLGMX-Version Automation Engine-Version plus Hotfixnummer
UCYBLGMX-Version Automation Engine-Version plus Hotfixnummer
Die Dateien können auf zwei Arten angegeben werden:
Das Platzhalterzeichen „*“ kann in Dateinamen verwendet werden.
Geben Sie den Pfad nicht an, so wird der Ordner verwendet, aus dem Sie das Dienstprogramm aufrufen.
- -FPfad und Name der Zieldatei
Pfad und Name der Zieldatei:
Der Pfad kann weggelassen werden, wenn die Zieldatei im selben Ordner wie das Dienstprogramm erstellt werden soll.
Eine bereits vorhandene gleichnamige Datei wird überschrieben.
Beispiel
Der Logdateien mit dem Präfix server werden in der Zieldatei AE.txt zusammengefasst.
UCYBLGMX -B -L"C:\AUTOMIC\report\server*" -F"C:\AUTOMIC\report\AE.txt"
Siehe auch: