Administratorhandbuch > Startparameter > Dienstprogramme

Startparameter - Dienstprogramme

Hier finden Sie eine Auflistung und Beschreibung der Startparameter für die AE-Dienstprogramme.

Bei den Dienstprogrammen AE DB Client Copy, AE DB Archive und AE DB Reorg erfolgt beim Aufruf per Batch eine Berechtigungsprüfung (Single-Logon). Existiert für den angemeldeten Betriebssystem-Benutzer kein entsprechendes Benutzer-Objekt im Automation Engine System, bricht das  Dienstprogramm den Batchaufruf ab. Beachten Sie, dass dieser Vorgang unabhängig von den Einträgen in der Variable UC_USER_LOGON ist.

Im Batchmodus bringt die Notwendigkeit des Single-Logons mehr Sicherheit, im Programmstart mit Oberfläche mehr Komfort.

Der Batchaufruf der Dienstprogramme erfolgt über die *.EXE-Datei. Dateien mit der Endung *G.EXE starten die Dienstprogamme im Normalmodus. Auch diesen Dateien können die Startparameter übergeben werden, um z. B. eine bestimmte INI-Datei aufzurufen. Das Dienstprogramm startet aber dennoch im Normalmodus. Beachten Sie, dass der Parameter -B daher nicht anzugeben ist!

Startparameter

Die Startparameter können auch über den Javaloader an das Dienstprogramm übergeben werden:

Programm

Startparameter

Beschreibung

Javaloader des Dienstprogramms

-F0

Unterdrückt den Splashscreen

 

-IPfad und Dateiname

Pfad und Name der INI-Datei für den Javaloader.

 

-JParameter

Parameter des Dienstprogramms.

Dem Dienstprogramm können auch über den Javaloader Parameter (siehe unten) übergeben werden. Diese werden an den cmd-Aufruf in der INI-Datei angehängt. So ist es möglich, in der INI-Datei eine Standardeinstellung vorzugeben und spezielle Optionen über den Javaloader zu steuern.

Beachten Sie, dass:

  • die Parameterkette unter doppelte Hochkommata zu setzen ist.
  • die Pfadangaben, die Leerzeichen beinhalten, zusätzlich noch unter zweifach doppelte Hochkomma zu setzen sind (Beispiel: -J"-I""C:\AUTOMIC\meine Dienstprogramme\UCYBDBAR.ini""").

Beispiele:
Über eine Verknüpfung soll die jeweilige Sprache eingestellt werden.

Auszug aus der INI-Datei:

cmd="javaw" -jar -cp .;.\UC4LAF.jar UCYBDBar.jar

In einer Verknüpfung wird die Sprache voreingestellt:

UCYBDBarg.exe -F0 -J"-LD"

Bei der Vorgabe einer INI-Datei für das Dienstprogramm müssen Sie den Parameter -I zwei Mal angeben. Dies ist auch dann erforderlich, wenn sowohl der Javaloader als auch das Dienstprogramm dieselbe INI-Datei verwenden.

Beispiele:

Beide verwenden dieselbe INI-Datei:

ucybdbccg -IUCYBDBCC.ini -J"-IUCYBDBCC.ini"

Unterschiedliche INI-Dateien kommen zum Einsatz:

ucybdbccg -IUCYBDBCC.ini -J"-Iclientcopy.ini"

AE DB 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 -NObjekt [-T1yyyymmddhhmmss] [-T2yyyymmddhhmmss] [-PPfad und Dateipräfix]

Programm

Startparameter

Beschreibung

Dienstprogramm zum Archivieren der Datenbank
UCYBDBAR.JAR

-V

Gibt die Automation Engine-Version samt Hotfixnummer in folgendem Format aus:

"UCYBDBar version Automation Engine-Version plus Hotfixnummer"

 

-VPfad und Dateiname

Gibt die Automation Engine-Version samt Hotfixnummer in die Datei in folgendem Format aus:

"UCYBDBar version Automation Engine-Version plus Hotfixnummer"

 

-IPfad und Dateiname

Pfad und Name der INI-Datei.

 

-LSprache

Sprache

Erlaubte Werte: "D", "E", "F"
"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

Batchmodus.

 

Archivierungsmodus

 

 

-Smmmm

Nummer des Mandanten, der archiviert werden soll.

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 (z.B: MEIER/DEV und MEIER/TEST)!

 

-Dmmmm

Nummer des Mandanten, der archiviert werden soll (nur Windows).

Der Benutzer, der das Dienstprogramm im Batchmodus startet, muss ein gleichnamiges Benutzer-Objekt in diesem Mandanten besitzen.

Beispiel: Für den Betriebssystem-Benutzer MEIER mit der Domain UC4 muss ein Benutzer-Objekt namens "MEIER/DEV" existieren.

 

Reportmodus

 

 

-Smmmm
-D
mmmm

Im Reportmodus muss immer ein Mandant angegeben werden (außer für -Xreport). Für die beiden Parameter gelten dieselben Vorgaben wie im Archivierungsmodus.

Je nach verwendetem Reportmodus hat die Angabe des Mandanten eine andere Bedeutung:

"-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, ansonsten bricht das Dienstprogramm den Vorgang ab.

 

-XModus

Art der Reportbehandlung

Für Output-Managementsysteme:

"list" - Reports werden aufgelistet
"unload" - Report wird entladen
"mark" - Report wird als archiviert gekennzeichnet und aus der Datenbank-Tabelle "XRO" entfernt.

Für die Zusammenfassung von Log- und Tracedateien:

"report" - Aus den Logeinträgen von Serverprozessen werden Dateien erzeugt.

 

Parameter für -Xlist

 

 

-OPfad und Dateiname

Pfad und Name für die CSV-Datei

Wird kein Dateiname angegeben, so wird der Name "uc_XROlist.csv" verwendet. Fehlt der Pfad, so wird die Datei in jenem Ordner gespeichert, in welchem sich auch das Dienstprogramm befindet.

 

-YZahl

Filter für die Reportselektierung.

 

Parameter für -Xunload

 

 

-OPfad und Dateiname

Pfad und Name für die Textdatei

Pro Report der Aufgabe wird eine Datei mit dem zusätzlichen Prefix "_Reporttyp" im angegebenen Ordner erstellt.

Wird kein Dateiname angegeben, wird der Name "uc_XROreport.txt_Reporttyp" 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 des Zeitzonen-Objektes.

Standardmäßig sind die Zeitangaben von entladenen Reports in UTC. Mit dem Parameter können Sie diese in eine andere Zeitzone umrechnen.

Wenn das Zeitzonen-Objekt nicht im angegebenen Mandanten existiert, wird UTC verwendet.

  -TYReporttyp

Typ des Reports (z.B: ACT)

Wird kein Reporttyp angegeben, so werden alle Reports der Aufgabe jeweils in eine eigene Datei exportiert.

 

Parameter für -Xmark

 

 

-RRunID

RunID der Aufgabe

  -TYReporttyp

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, deren Name mit _Reporttyp endet (Beispiel: _ACT).

 

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: Aktuelles Datum und Uhrzeit 00:00:00

 

-T2jjjjmmtthhmmss

Enddatum und -zeit für die zu selektierenden Serverreports.

Standardwert: Aktuelles Datum und aktuelle Uhrzeit

 

-PPfad und Dateipräfix

Pfad und Dateipräfix für die Zieldatei

Standardmäßig erhalten die Zieldateien das Präfix "unload" und werden im Ordner des Dienstprogrammes abgelegt.

Der Dateiname setzt sich wie folgt zusammen:
Präfix.Objektname_Datum_Uhrzeit.txt

 

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

Das 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, die in den 15.03.2007 fallen, sollen in Dateien entladen werden.

UCYBDBar -B -Xreport -N"UC4#CP*,UC4#WP*" -T120070315000000 -T220070315235959 -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

AE DB Change

Syntax

UCYBCHNG [-V[Pfad und Dateiname]] -B -1Scriptdatei -2Transportdatei [-3Ausgabedatei] [-LSprache]

Programm

Startparameter

Beschreibung

Dienstprogramm zum Ändern von exportierten Daten
UCYBCHNG.EXE

-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:

"UCYBChng version Automation Engine-Version plus Hotfixnummer"

 

-B

Batchmodus.

 

-1Scriptdatei

Die Datei enthält die Anweisungen (REPLACE) für die Änderungen.

 

-2Transportdatei

Beinhaltet die Original-Daten des Exportes (standardmäßig UC_DATA.TXT).

 

-3Ausgabedatei

In diese Datei werden die geänderten Daten geschrieben.

 

-LSprache

Sprache

Erlaubte Werte: "D", "E", "F"
"D" = Deutsch, "E" = Englisch, "F" = Französisch

Wird der Parameter nicht angegeben, so wird die Sprache verwendet, die in der INI-Datei gesetzt ist.

 

Beispiel:

ucybchng -b -1c:\AUTOMIC\uc_change.txt -2c:\AUTOMIC\uc_transport.txt -3c:\AUTOMIC\uc_transport_new.txt

AE DB Client Copy

Syntax

Kopiermodus:

UCYBDBCC [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -C -Smmmm -Tmmmm -O [-M][-A][-R] [-V] [-W]

Löschmodus:

UCYBDBCC [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -E -Smmmm
UCYBDBCC [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -E -Tmmmm

Programm

Startparameter

Beschreibung

Dienstprogramm zum Kopieren und Löschen von Mandanten
UCYBDBCC.JAR

-V

Gibt die Automation Engine-Version samt Hotfixnummer in folgendem Format aus:

"UCYBDBcc version Automation Engine-Version plus Hotfixnummer"

 

-VPfad und Dateiname

Gibt die Automation Engine-Version samt Hotfixnummer in die Datei in folgendem Format aus:

"UCYBDBcc version Automation Engine-Version plus Hotfixnummer"

 

-IPfad und Dateiname

Pfad und Name der INI-Datei.

 

-LSprache

Sprache

Erlaubte Werte: "D", "E", "F"
"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 (es wird mit Single Logon gestartet)

 

-V

Gibt die Automation Engine-Version samt Hotfixnummer aus.

 

Kopiermodus

 

 

-C

Mandanten kopieren; der Betriebssystem-Benutzer muss in beiden Datenbanken als AE-Benutzer im Systemmandanten 0000 vorhanden sein, da ansonsten mit einer Fehlermeldung abgebrochen wird.

 

-Smmmm

Nummer des Quellmandanten

Der Benutzer, der das Dienstprogramm im Batchmodus startet, muss ein Benutzer-Objekt im Systemmandanten 0000 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 (z.B: MEIER/DEV und MEIER/TEST)!

 

-Dmmmm

Nummer des Quellmandanten (nur Windows)

Beachten Sie, dass die Parameter -D und -S nicht gemeinsam verwendet werden dürfen!

Der Benutzer, der das Dienstprogramm im Batchmodus startet, muss ein gleichnamiges Benutzer-Objekt im Systemmandanten 0000 besitzen.

Beispiel: Für den Betriebssystem-Benutzer MEIER mit der Domain AE muss ein Benutzer-Objekt namens "MEIER/DEV" existieren.

 

-Tmmmm

Nummer des Zielmandanten

Für den Benutzer gelten dieselben Voraussetzungen wie beim Parameter -S.

 

-O

Objekte kopieren

 

-M

Meldungen kopieren

 

-A

Statistiken und Reports kopieren

 

-R

Passwort zurücksetzen

 

-V

Versionsobjekte kopieren

 

-W

Löschen der Arbeitsdateien nach erfolgreichem Kopieren

 

Löschmodus

 

 

-E

Mandanten löschen; der Betriebssystem-Benutzer muss in beiden Datenbanken als AE-Benutzer im Systemmandanten 0000 vorhanden sein, da ansonsten mit einer Fehlermeldung abgebrochen wird.

 

-Smmmm
-D
mmmm
-T
mmmm

In der INI-Datei können Sie verschiedene Datenbanken für Quelle und Ziel definieren. Geben Sie daher die Parameter -S oder -D an, so wird der Mandant in der Quelldatenbank gelöscht. Bei -T erfolgt die Löschung in der Zieldatenbank.

Für diese Parameter gelten dieselben Vorausetzungen wie beim Kopieren eines Mandanten.

 

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

AE DB Load

Syntax

Laden von Transportkoffer/Initialdaten:

UCYBDBLD [-V[Dateiname]] [-IDateiname] [-FFolder handling] [-LSprache] -B -Cmmmm [-EModus] [-UName/Abteilung] [-GName] [-AZugriff] [-MZugriff] -XDateiname

Setzen der Authentifizierungsmethode:

UCYBDBLD [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B-TAuthentifizierungsmethode-KZeichenfolge für den Company Key

Programm

Startparameter

Beschreibung

Dienstprogramm zum Laden der Datenbank
UCYBDBLD.JAR

-V

Gibt die Automation Engine-Version samt Hotfixnummer in folgendem Format aus:

"UCYBDBld version Automation Engine-Version plus Hotfixnummer"

 

-VPfad und Dateiname

Gibt die Automation Engine-Version samt Hotfixnummer in die Datei in folgendem Format aus:

"UCYBDBld version Automation Engine-Version plus Hotfixnummer"

 

-IPfad und Dateiname

 

Pfad und Name der INI-Datei.

  -FFolder handling

Definiert, wie sich DB Load in Bezug auf Ordner verhält. Werden Objekte oder verknüpfte Objekte ersetzt, bleiben der Home-Ordner und die verknüpften Objekte des Transportkoffers erhalten.

Erlaubter Wert: "OT"

Wurde dieser Wert gesetzt, überschreiben die Daten, die sich im Datenfile des Transportkoffers befinden, bereits vorhandene Objekte in der Automation Engine-Datenbank.

 

-LSprache

Sprache

Erlaubte Werte: "D", "E", "F"
"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

Batchmodus

 

-Cmmmm

Nummer des Mandanten für Verarbeitung.

Bei -C-1 wird bzw. werden die Mandanten beibehalten, bei -Cmmmm wird der Transportkoffer in Mandant mmmm eingespielt.

 

-EModus

Verarbeitungsmodus bei bereits vorhandenen Objekten.
Nur im Batchmodus.

Erlaubte Werte: "IGNORE", "ABEND", "REPLACE"
"IGNORE" = Das Objekt wird übersprungen (Standardwert).
"ABEND" = Die Verarbeitung wird abgebrochen.
"REPLACE" = Das vorhandene Objekt wird ersetzt.

Beachten Sie, dass bei der Einstellung "IGNORE" das Orginalobjekt und das zu ladende Objekt denselben Typ aufweisen müssen. Ist dies nicht der Fall, wird bereits vor dem Ladevorgang abgebrochen.

 

-UName/Abteilung

Name und Abteilung eines Standard-Benutzers.

Wenn für Zugriffsberechtigungen auf Objektebene der Benutzer nicht vorhanden ist, kann er durch einen Standard-Benutzer ersetzt werden.  

 

-GName

Name einer Standard-BenutzerGruppe.

Wenn für Zugriffsberechtigungen auf Objektebene die BenutzerGruppe nicht vorhanden ist, kann sie durch eine Standard-BenutzerGruppe ersetzt werden.

 

-AZugriff

Zugriffsberechtigungen auf Objektebene laden.

Erlaubte Werte: "Y", "N"
"Y" - Zugriffsberechtigungen auf Objektebene laden (Standardwert).
"N" = Zugriffsberechtigungen auf Objektebene nicht laden.

 

-MZugriff

Zugriffsberechtigungen, die auf fehlende Benutzer und BenutzerGruppen verweisen, ignorieren.

Erlaubte Werte: "Y", "N"
"Y" = Zugriffsberechtigungen auf fehlende Benutzer und BenutzerGruppen ignorieren und nicht laden.
"N" = Den Ladevorgang bei Zugriffsberechtigungen auf fehlende Benutzer und BenutzerGruppen abbrechen (Standardwert).

 

-XDateiname

Pfad und Name der zu ladenden Datei. Bitte beachten Sie, dass dieser Parameter immer anzugeben ist.

  -TAuthentifizierungsmethode
-KZeichenfolge für den Company Key

Angabe zur Authentifizierung

Das Dienstprogramm ist nur dann mit diesen Startparametern aufzurufen, wenn Sie eine Neuinstallation ohne die Hilfe des Installers vornehmen.

Beide Parameter müssen gemeinsam angegeben werden.

Erlaubte Werte bei -T: "NO", "LOCAL", "LOCAL_REMOTE" und "PACKAGE"

Sie stellen mit "NO", "LOCAL" und "LOCAL_REMOTE" die Authentifizierungsmethode ein. Wenn Sie "PACKAGE" verwenden, erhalten Sie eine Datei, in der sich der Company Key befindet.

Erlaubter Wert bei -K: Beliebige Zeichenfolge (maximal 32 Zeichen)

Der Company Key wird aus dieser Zeichenfolge gebildet.

Sie müssen auch dann eine Zeichenfolge für den Company Key angeben, wenn Sie keine Authentifizierung (-TNO) nutzen möchten. Wir empfehlen den Namen des Automation Engine Systems als Company Key zu verwenden.

Beachten Sie, dass die Verwendung dieser Startparameter zu einem Fehler führt, wenn die Initialdaten zum ersten Mal geladen werden! Rufen Sie das Dienstprogramm zuerst auf, um das Datenbankschema zu erstellen, und starten Sie es anschließend noch einmal, um die Authentifizierung zu setzen.
Beispiel: 

Erster Schritt: java -jar ucybdbld -B -X/uc4/9.00A/Utility/db/general/9.00A/UC_UPD.TXT
Zweiter Schritt: java -jar ucybdbld -B -TNO -Kabc

Eine andere Möglichkeit besteht darin, die grafische Oberfläche des AE DB Load zu verwenden.

Beachten Sie, dass die Zeichenfolge in Hochkommata angegeben werden muss, wenn sie Sonderzeichen enthält! Möchten Sie innerhalb der Zeichenfolge ein Hochkomma verwenden, müssen Sie vor diesem ein weiteres Hochkomma (unter Windows) bzw. einen "\" (unter Unix) setzen.

 

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 Automation Engine System eingestellt werden.

UCYBDBld -B -TLOCAL_REMOTE -KUC4PROD

AE DB Reorg

Syntax

UCYBDBRE [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -Smmmm

Programm

Startparameter

Beschreibung

Dienstprogramm zum Reorganisieren der Datenbank
UCYBDBRE.JAR

-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"

 

-IPfad und Dateiname

Pfad und Name der INI-Datei.

 

-LSprache

Sprache

Erlaubte Werte: "D", "E", "F"
"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

Batchmodus.

 

-Smmmm

Nummer des Mandanten, der reorganisiert werden soll.

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 (z.B: MEIER/DEV und MEIER/TEST)!

 

-Dmmmm

Nummer des Mandanten, der reorganisiert werden soll (nur Windows).

Der Benutzer, der das Dienstprogramm im Batchmodus startet, muss ein gleichnamiges Benutzer-Objekt in diesem Mandanten besitzen.

Beispiel: Für den Betriebssystem-Benutzer MEIER mit der Domain AE muss ein Benutzer-Objekt namens "MEIER/DEV" existieren.

 

Beispiele:

Der Mandant 98 wird reorganisiert.

UCYBDBre -B -S0098

AE DB Reporting Tool

Syntax

UCYBDBRT [-IDateiname] [-LSprache] [-Cmmmm]-XPfad und Dateiname [-Rjjjjmmtt[hhmm]] [-S] [-OPfad und Dateiname] [-TDateityp]

Programm

Startparameter

Beschreibung

Dienstprogramm zum Erstellen von Auswertungen
UCYBDBRT.EXE

-Cmmmm

Nummer des Mandanten für die Verarbeitung.

Der Mandant, welcher in der Definition der Auswertung angegeben wurde, wird dadurch überschrieben.

 

-XPfad und Dateiname

Pfad und Name der XML-Datei.

 

-IPfad und Dateiname

Pfad und Name der INI-Datei.

 

-LSprache

Sprache

Erlaubte Werte: "D", "E", "F"
"D" = Deutsch, "E" = Englisch, "F" = Französisch

 

-Rjjjjmmtt[hhmm]

Referenzdatum und -uhrzeit für Auswertungen von Statistiken und Prognosen

Auch dieser Parameter überschreibt die Definiton in der Auswertung.

Beachten Sie, dass die Einträge der 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

AE. Revisionsreport

Syntax

UCYBDBRR [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -Cmmmm [-OPfad und Dateiname] [-FTyp1,Typ2,...] [-D1jjjjmmtthhmmss] [-D2jjjjmmtthhmmss] [-A] [-X]

Programm

Startparameter

Beschreibung

Dienstprogramm zum Erstellen des Revisionsreports
UCYBDBRR.EXE

-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

Sprache

Erlaubte Werte: "D", "E", "F"
"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

Batchmodus.

 

-Cmmmm

Nummer des Mandanten für die Verarbeitung.

 

-OPfad und Dateiname

Pfad und Name des Revisionsreportes.

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.

Erlaubte Werte:

"ACCESS" - Unerlaubter Zugriff
"CANCEL" - Bricht Aufgaben ab
"CREATE" - Legt Objekte neu an
"DELETE" - Löscht Objekte
"IMPORT" - Import von Objekten
"MOVE" - Verschiebt Objekte
"OBJ_MOD" - Änderungen von Objekten
"RENAME" - Benennt Objekte um
"RESTART" - Wiederanlauf von Aufgaben
"RESTORE" - Stellt Objekte wieder her
"RUN_MOD" - Modifiziert zur Laufzeit
"START" - Startet Aufgaben
"TRNSPRT" - Transportiert Objekte
"USER" - Erfolgreiche An- und Abmeldungen von Benutzern

Das Dienstprogramm gibt alle Inhalte in den Revisionsreport aus, wenn Sie diesen Parameter nicht verwenden oder -F* angeben.

 

-D1jjjjmmtthhmmss

Startdatum und -zeit für die Protokollierung.

Beachten Sie, dass die Selektion standardmäßig nicht durch einen Startzeitpunkt eingeschränkt wird! Geben Sie daher immer einen Startzeitpunkt an, da ansonsten der Revisionsreport sehr umfangreich wird!

Als Zeitzone wird die des Mandanten verwendet. Haben Sie dort keine eingetragen, kommt die Zeitzone des Systemmandanten 0000 zur Anwendung. Fehlt dort ebenfalls die Zeitzone, wird UTC verwendet.

 

-D2jjjjmmtthhmmss

Enddatum und -zeit für die Protokollierung.

Standardwert: Aktuelles Datum und Uhrzeit

Als Zeitzone wird die des Mandanten verwendet. Haben Sie dort keine eingetragen, kommt die Zeitzone des Systemmandanten 0000 zur Anwendung. Fehlt dort ebenfalls die Zeitzone, wird UTC verwendet.

 

Verwenden Sie beide Zeitparameter nicht beim Aufruf, so werden sämtliche Revisionsdaten unter Berücksichtigung der Filter -F und -X in den Report geschrieben.

 

-A

Der Parameter bewirkt, dass bei den selektierten Datensätzen Archivkennzeichen gesetzt werden. Er steht in Zusammenhang mit dem Parameter -X.

Beachten Sie, dass der Start von Aufgaben (siehe Startparameter -FSTART) aus den Statistiksätzen ermittelt wird. Das Dienstprogramm kann für diese Datensätze kein 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 -D120040501000000

Vom Mandanten 100 werden alle Start- und Wiederanlaufzeitpunkte zwischen 01.10. 08:00 und 01.10. 12:00 in einen Report ausgegeben.

UCYBDBRR -B -LD -C0100 -FSTART,RESTART -D120041001080000 -D220041001200000

AE DB Unload

Syntax

UCYBDBUN [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -BModus [-D][-Cmmmm] [-XDateiname] [-K]

Programm

Startparameter

Beschreibung

Dienstprogramm zum Entladen der Datenbank UCYBDBUN.JAR

-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"

 

-IPfad und Dateiname

 

Pfad und Name der INI-Datei.

 

-LSprache

Sprache

Erlaubte Werte: "D", "E", "F"
"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

Batchmodus und Verarbeitungsmodus.

Über das gesamte Automation Engine-System:
"NORMAL" = Es werden alle Daten aller Tabellen der Datenbank entladen.
"INITIAL" = Daten werden vom Mandanten 0 genommen. Allerdings werden nicht alle Daten vom Mandanten 0 geladen, sondern nur die Initialdaten, z. B. XREQs.
"DEFAULT" = Standarddaten des Systems sind entladen, z. B. Mandant 0, erster Benutzer und Benutzergruppe.

"REPAIR" = Die Ordnerstruktur des Explorers wird geprüft und gegebenenfalls korrigiert.

AE systemweit und mandantenweit:
"REORG" = Die Datenbank wird reorganisiert.
"TRANSPORT" = Der Transportkoffer wird entladen.
"TRANSPORTALL" = Alle Objekte werden transportiert.
"RESETARCHIVE" = Archivkennzeichen werden zurückgesetzt (AE DB Archiv).
"RESETREORG" = Löschkennzeichen werden zurückgesetzt (AE DB Reorg).

 

-D

Bei Verwendung dieses Startparameters werden alle Objekte nach dem Entladen aus dem Transportkoffer entfernt.

 

-Cmmmm

Nummer des Mandanten für das Entladen des Transportkoffers.

Geben Sie keinen Mandanten an, so erfolgt die Entladung über alle Mandanten.

Wenn in der INI-Datei der Parameter suppress_output= auf den Wert "1" gesetzt ist, können Sie den Parameter -C auch verwenden, um einzelne Mandanten zu reorganisieren.

Das Entladen von Daten des Mandanten 0 ist nicht möglich. Wird -C0 trotzdem angegeben, werden alle Mandanten bis auf den Systemmandanten für den Exportvorgang verwendet.

 

-XDateiname

Name der Datei, welche die zu entladenden Daten aufnimmt.

Wird dieser Parameter nicht angegeben, verwendet das Dienstprogramm den Namen und Pfad der in der INI-Datei festgelegten Datei (OUTPUT=).

Dieser Parameter kann nicht in Zusammenhang mit -BREORG verwendet werden, da diese speziellen Dateien einer vorgegebenen Namenskonvention unterliegen.

  -K Wenn dieser Parameter gesetzt ist, werden gelöschte Objekte nach dem Entladevorgang im Papierkorb des UserInterface belassen und nicht entfernt.

 

Beispiele:

Die Datenbank wird reorganisiert.

UCYBDBun -BREORG

Der Mandant 100 wird reorganisiert. Das Dienstprogramm kann diesen Aufruf durchführen, da in seiner INI-Datei der Parameter suppress_output=1 gesetzt ist.

UCYBDBun -BREORG -C0100

Der Transportkoffer des Mandanten 11 wird entladen. Dabei verwendet das Dienstprogramm jenen Pfad und Dateinamen, die in der INI-Datei mit OUTPUT= festgelegt wurden. 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 wird daher aufgerufen.

UCYBDBun -BREPAIR

AE Log Mix

Syntax

UCYBLGMX [-V[Pfad und Dateiname]] -B-LPfad und Namen der Log- bzw. Tracedateien -FPfad und Name der Zieldatei

Programm

Startparameter

Beschreibung

Dienstprogramm zum Zusammenfassen von Log- und TracedateienUCYBLGMX

-V

Gibt die Automation Engine-Version samt Hotfixnummer in folgendem Format aus:

"UCYBLGMX version Automation Engine-Version plus Hotfixnummer"

 

-VPfad und Dateiname

Gibt die Automation Engine-Version samt Hotfixnummer in die Datei in folgendem Format aus:

"UCYBLGMX version Automation Engine-Version plus Hotfixnummer"

 

-B

Batchmodus

 

-LPfad und Namen der Log- bzw. Tracedateien

Log- bzw. Tracedateien, die zu einer Zieldatei zusammengeführt werden sollen.

Die Dateien können auf zwei Arten angegeben werden:

"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"

Oder Sie geben bei jeder Datei den Pfad an.

Im Dateinamen ist die Verwendung des Wildcardzeichens "*" erlaubt.

Geben Sie den Pfad nicht an, so wird der Ordner verwendet aus dem Sie das Dienstprogramm aufrufen (Arbeitsverzeichnis).

 

-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 UC4.txt zusammengefasst.

UCYBLGMX -B -L"C:\AUTOMIC\report\server*" -F"C:\AUTOMIC\report\uc4.txt"

Siehe auch:

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH