Startparameter – Dienstprogramme

In diesem Thema werden die Parameter aufgelistet, mit denen Administratoren die verschiedenen AE-Dienstprogramme im Batch-Betrieb von der Kommandozeile aus starten können, sodass Sie sie regelmäßig automatisieren und einplanen können. Sie können sie entweder über den Java-Loader oder das Dienstprogramm zuordnen. Alternativ können Sie die Benutzeroberfläche des Dienstprogramms für die meisten Parameter verwenden.

Wichtig!

  • Um Dienstprogramme im Batch-Betrieb starten zu können, müssen Sie Ihre spezifischen Einstellungen einmal auf der Benutzeroberfläche des Dienstprogramms angeben.

  • Sie können auch UTF-8 verwenden, wenn Sie den Namen der INI-Datei und ihren Pfad (-I) angeben.

Diese Seite beinhaltet Folgendes:

Übersicht

Wenn die Dienstprogramme AE DB Client Copy, AE DB Archive oder AE DB Reorg im Batch-Betrieb gestartet werden, führen sie eine Autorisierungsprüfung für Single Sign-On durch. Weitere Informationen finden Sie unter AE DB Client Copy, AE DB Archive oder AE DB Reorg.

Beispiel: Existiert für den Betriebssystembenutzer, der beim AE-System angemeldet ist, kein Benutzerobjekt, bricht das Dienstprogramm ab. Das Dienstprogramm prüft auf das Vorhandensein des Benutzerobjekts, selbst wenn die Variable UC_USER_LOGON alle relevanten Einträge enthält. Ein Single Sign-on bietet erhöhte Sicherheit im Batch-Modus. Wenn ein Programm mit der Automic Web Interface gestartet wird, erhöht das Single-Login die Benutzerfreundlichkeit. Weitere Informationen finden Sie unter UC_USER_LOGON - Single Logon.

Windows

Dienstprogramme starten standardmäßig im Batch-Modus, wenn Sie die entsprechenden *.exe-Dateien verwenden. Dateien, die auf *g.exe enden, starten die Dienstprogramme im normalen Modus und Sie können ihnen Parameter zuordnen. *.jar-Dateien sollten nicht im Batch-Modus verwendet werden.

Beispiel: Sie möchten eine bestimmte INI-Datei aufrufen. Der Parameter "-B" darf in diesem Fall nicht verwendet werden.

Unix

Dienstprogramme starten standardmäßig im Batch-Modus, wenn Sie die entsprechenden *.sh-Dateien verwenden. Sie können Dateien ohne Dateiendung verwenden, um Startparameter für Batch-Aufrufe zuzuordnen.

Java-Loader (Java-Loader)

Die folgenden Startparameter stehen zur Verfügung:

  • -F0 Dateiname

    Unterdrückt den Splash-Screen.

  • -I Pfad und Dateiname

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

  • -J Parameter

    Parameter des Dienstprogramms.

    • Sie können den Java-Loader verwenden, um dem Dienstprogramm Parameter zuzuordnen. Diese Parameter werden dem Abschnitt "cmd" der INI-Datei hinzugefügt. Dadurch können Sie eine Standardeinstellung in der INI-Datei angeben und bestimmte Situationen über den Java-Loader bearbeiten.

    Es ist zwingend erforderlich, doppelte Anführungszeichen für Pfadangaben zu verwenden, die Leerzeichen enthalten. 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 zweimal angeben, auch wenn der Java-Loader und das Dienstprogramm dieselbe INI-Datei verwenden.

Java-Loader und Dienstprogramm verwenden dieselbe INI-Datei:

ucybdbccg -IUCYBDBCC.ini -J-IUCYBDBCC.ini

Es werden verschiedene INI-Dateien verwendet:

ucybdbccg -IUCYBDBCC.ini -J-Iclientcopy.ini

AE DB Archive (UCYBDBAR.EXE)

Dieses Dienstprogramm archiviert Meldungen, Reports und Ausführungsdaten. Weitere Informationen finden Sie unter AE DB Archive.

Syntax

  • Archivierungsmodus

    • UCYBDBAR -B -Smmmm [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache]

  • Reportmodus

    • UCYBDBAR -B -Smmmm -XModus [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache]

    UCYBDBAR -B -Smmmm -Xlist [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] [-OPfad- und Dateiname] [-YZahl]

    UCYBDBAR -B -Smmmm -Xunload [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] [-OPfad und Dateiname] [-YZahl] -RRunID [-TZeitzone] [-TYReporttyp]

    UCYBDBAR -B -Smmmm -Xmark -RRunID [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] [-TYReporttyp]

    UCYBDBAR -B -Xreport -NObjekt [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] [-T1yyyymmddhhmmss] [-T2yyyymmddhhmmss] [-PPfad und Dateipräfix]

Startparameter

Die folgenden Startparameter stehen zur Verfügung:

  • -B

    Batch-Modus

  • -V

    (Optional) Gibt die Automation Engine-Version und Hotfixnummer im folgenden Format aus:

    • UCYBDBar version Automation Engine-Version plus Hotfixnummer

  • -V Pfad und Dateiname

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

    • UCYBDBar version Automation Engine-Version plus Hotfixnummer

  • -I Dateiname

    (Optional) Pfad und Name der INI-Datei

  • -L Sprache

    (Optional) Sprachparameter

    Zulässige Werte: D (Deutsch), E (Englisch), F (Französisch)

    Wenn Sie diesen Parameter nicht definieren, verwendet das Dienstprogramm die Sprache, die in der INI-Datei angegeben ist.

Im Archivierungsmodus:

  • -Smmmm

    Nummer des Mandanten, der archiviert werden soll

    • Wichtig! Dieser Mandant muss ein Benutzerobjekt für den Benutzer umfassen, der dieses Dienstprogramm im Batch-Modus startet.

    Beispiel: Für den Betriebssystembenutzer MEIER muss ein Benutzerobjekt namens MEIER/Abteilungsname existieren. Kein anderes Benutzerobjekt darf mit MEIER beginnen. Es ist nicht möglich, MEIER/AE und MEIER/TEST zu verwenden.

  • -D mmmm

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

    • Wichtig! Dieser Mandant muss ein Benutzerobjekt für den Benutzer umfassen, der dieses Dienstprogramm im Batch-Modus startet.

    Beispiel: Für den Betriebssystembenutzer MEIER mit der Domäne AE muss ein Benutzerobjekt namens MEIER/AE existieren.

Im Reportmodus:

  • -S mmmm

    -D mmmm

    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.

    • 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 Prüfung der Anmeldedaten verwendet. Es muss ein Benutzerobjekt vorhanden sein. Andernfalls bricht das Dienstprogramm den Vorgang ab.

  • -X Modus

    Art der Reportverarbeitung

    • Für Ausgabemanagement-Systeme (siehe Offene Schnittstelle zu Ausgabemanagement-Systemen):

    • list

      Reports werden aufgelistet.

    • unload

      Report wird entladen.

    • mark

      Der Report ist als archiviert markiert und wird aus der XRO-Datenbanktabelle entfernt.

    Zur Zusammenfassung von Log- und Trace-Dateien (siehe ):

    • report

      Aus den Logeinträgen von Serverprozessen werden Dateien erzeugt.

  • Parameter für "-Xlist"

    • -O Pfad und Dateiname

      (Optional) 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.

    • -Y Zahl

      (Optional) Filter für die Reportauswahl

  • Parameter für "-Xunload"

    • -O Pfad und Dateiname

      (Optional) 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 in ihrem 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 (der letzte Punkt wird als Trennzeichen für die Erweiterung verwendet) -> 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.

    • -Y Zahl

      (Optional) Legt eine Zahl fest, die das spätere Filtern ermöglicht.

    • -R RunID

      RunID der Aufgabe

    • -T Zeitzone

      (Optional) Name eines Zeitzonenobjekts

      • Standard: In entladenen Reports wird UTC (Universal Time) verwendet. Mit diesem Parameter können Sie die Zeitangaben in eine andere Zeitzone umrechnen.

      Wenn das Zeitzonenobjekt im angegebenen Mandanten nicht existiert, wird UTC verwendet.

    • -TY Reporttyp

      (Optional) Typ von Report (z. B. ACT)

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

  • Parameter für "-Xmark"

    • -R RunID

      RunID der Aufgabe

    • -TY Reporttyp

      (Optional) Typ von Report (z. B. ACT)

      • Wenn Sie diesen Parameter nicht angeben, werden alle Reporttypen archiviert. Für jeden Reporttyp wird eine eigene Datei erstellt. Namen enden mit "_ Reporttyp" (Beispiel: _ACT).

  • Parameter für "-Xreport"

    • -N Objekt
      Name eines Objekts oder Filters, der ein Sternsymbol (*) für mehrere Objekte verwendet.

      • Mehrere Angaben sind mit Kommas zu trennen.

    • -T1 jjjjmmtthhmmss
      (Optional) Startdatum und -zeit für die auszuwählenden Server-Reports

      • Standard: das aktuelle Datum und die aktuelle Uhrzeit im Format 00:00:00

    • -T2 jjjjmmtthhmmss
      (Optional) Enddatum und -zeit für die auszuwählenden Server-Reports

      • Standard: das aktuelle Datum und die aktuelle Uhrzeit

    • -P Pfad und Dateipräfix
      (Optional) Pfad und Dateipräfix für die Zieldatei

      • Standard: Die Zieldateien erhalten das Präfix unload. Sie werden im Ordner des Dienstprogramms gespeichert.

      Der Dateiname ist wie folgt aufgebaut: Präfix.Objektname_ Datum _ Zeit.txt

Beispiele

Dieses Beispiel archiviert Mandant 1:

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 vom 15. März 2021 werden entladen:

UCYBDBar -B -Xreport -N"UC4#CP*,UC4#WP*" -T120210315000000 -T220210315235959 -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 (UCYBCHNG.EXE)

Dieses Dienstprogramm ändert Objekte, die mit dem Transportkoffer transportiert wurden. Weitere Informationen finden Sie unter AE DB Change.

Syntax

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

Startparameter

Die folgenden Startparameter stehen zur Verfügung:

  • -V

    (Optional) Gibt die Automation Engine-Version und die Hotfixnummer im folgenden Format aus:

    • UCYBChng version Automation Engine-Version plus Hotfixnummer

  • -V Pfad und Dateiname

    (Optional) Gibt die Automation Engine-Version und die Hotfixnummer in folgendem Format in die angegebene Datei aus:

    • UCYBChng version Automation Engine-Version plus Hotfixnummer

  • -B

    Batch-Modus

  • -1 Script-Datei

    Die Datei enthält Änderungsanweisungen (REPLACE).

  • -2 Transportdatei

    Beinhaltet die ursprünglichen Exportdaten.

    Standard: UC_DATA.TXT

  • -3 Ausgabedatei

    (Optional) In diese Datei werden die geänderten Daten geschrieben.

  • -L Sprache

    (Optional) Sprachparameter

    Zulässige 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.

Beispiel

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

AE DB Client Copy (UCYBDBCC.EXE)

Dieses Dienstprogramm kopiert und löscht Mandanten. Weitere Informationen finden Sie unter AE DB Client Copy.

Syntax

  • Kopiermodus

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

  • Löschmodus

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

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

Startparameter

Die folgenden Startparameter stehen zur Verfügung:

  • -B

    Startet das Dienstprogramm im Batchmodus, Single Sign-On wird verwendet

  • -V

    (Optional) Gibt die Automation Engine-Version und die Hotfixnummer im folgenden Format aus:

    • UCYBDBcc version Automation Engine-Version plus Hotfixnummer

  • -V Pfad und Dateiname

    (Optional) Gibt die Automation Engine-Version samt Hotfixnummer in folgendem Format in die angegebene Datei aus:

    • UCYBDBcc version Automation Engine-Version plus Hotfixnummer

  • -I Dateiname

    (Optional) Pfad und Name der INI-Datei

  • -L Sprache

    (Optional) Sprachparameter

    Zulässige 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.

Im Kopiermodus:

  • -C

    Mandanten kopieren

    • Hinweis: Der Betriebssystembenutzer muss in beiden Datenbanken in Systemmandant 0 als AE -Benutzer vorhanden sein. Andernfalls wird der Prozess mit einer Fehlermeldung abgebrochen.

  • -S mmmm

    Nummer des Quellmandanten

    • Wichtig: Systemmandant 0 muss ein Benutzerobjekt für den Benutzer enthalten, der dieses Dienstprogramm im Batchmodus startet.

    Beispiel: Für den Betriebssystembenutzer MEIER muss ein Benutzerobjekt namens MEIER/Abteilungsname existieren. Beachten Sie, dass kein anderes Benutzerobjekt mit MEIER beginnen darf. Es ist nicht möglich, MEIER/AE und MEIER/TEST zu verwenden.

  • -D mmmm

    (nur Windows) Nummer des Quellmandanten

    • Wichtig! 

    • Verwenden Sie die Parameter -D und -S nicht zusammen.

    • Systemmandant 0 muss ein Benutzerobjekt für den Benutzer enthalten, der dieses Dienstprogramm im Batchmodus startet.

      • Beispiel: Für den Betriebssystembenutzer MEIER mit der Domäne AE muss ein Benutzerobjekt namens MEIER/AE existieren.

  • -T mmmm

    Nummer des Zielmandanten

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

  • -O

    Kopiert Objekte.

  • -M

    (Optional) Kopiert Meldungen

  • -A

    (Optional) Kopiert Statistiken und Reports

  • -R

    (Optional) Setzt das Kennwort zurück

  • -V

    (Optional) Kopiert Versionsobjekte.

  • -W

    (Optional) Löscht die Arbeitsdateien nach einem erfolgreichen Kopieren

Im Löschmodus:

  • -E

    Mandant löschen

    • Wichtig! Der BS-Benutzer muss in beiden Datenbanken im Systemmandant 0 als AE-Benutzer vorhanden sein. Andernfalls wird der Prozess mit einer Fehlermeldung abgebrochen.

  • -S mmmm, -Dmmmm, -Tmmmm

    In der INI-Datei können Sie verschiedene Datenbanken als 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.

Beispiele

Mandant kopieren: Die Objekte, Statistiken und Reports von Mandant 38 werden in einen neuen Mandanten mit der Nummer 2 kopiert:

UCYBDBcc -B -C -S0038 -T0002 -O -A

Mandant löschen: Mandant 2 wird in der Zieldatenbank gelöscht.

UCYBDBcc -B -E -T0002

AE DB Load (UCYBDBLD.EXE)

Dieses Dienstprogramm lädt Daten in die Datenbank. Weitere Informationen finden Sie unter AE DB Load.

Hinweis: Um die Datenbank für Rapid Automation-Lösungen zu laden, müssen Sie den .jar-Loader (ucybdbld.jar) verwenden. Das Laden mit dem Dienstprogramm unter Verwendung der binären ausführbaren Dateien (ucybdbld.exe für Windows oder ucybdbld für Unix) im Batch-Modus ist nicht möglich.

Wenn Sie die Initialdaten laden, können Sie gleichzeitig Automic Automation-Administratorbenutzern alle verfügbaren Berechtigungen gewähren. Dazu müssen Sie die Benutzer mit der Umgebungsvariablen ADMIN_USERS angeben, unter Verwendung von Apostrophen. Wenn Sie mehr als einen Benutzer definieren möchten, geben Sie sie in einer kommagetrennten Liste an.

Beispiele

Einzelner Benutzer: 'USER1/DEV'

Mehrere Benutzer: 'USER1/DEV','USER2/DEV','USER3/PO'

Syntax

  • Transportkoffer/Initialdaten laden

    • UCYBDBLD -B -Cmmmm -XDateiname [-V[Pfad und Dateiname]] [-IDateiname] [-FOrdner-Behandlung] [-LSprache] [-EModus] [-UName/Abteilung] [-GName] [-AZugriff] [-MZugriff] [-YCodierungswert] [-ZTablespace-Name]

  • Authentifizierungsmethode festlegen

    • UCYBDBLD -B -TAuthentifizierungsmethode -KUnternehmens-Schlüsselstring [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache]

Startparameter

Die folgenden Startparameter stehen zur Verfügung:

  • -B

    Batch-Modus

  • -C mmmm

    Nummer des Mandanten zur Verarbeitung

    • -C-1

      Behält Mandanten

    • -C mmmm

      Lädt den Transportkoffer in Mandant mmmm

  • -X Dateiname

    Name der zu ladenden Datei. Dieser Startparameter ist obligatorisch.

  • -T Authentifizierungsmethode und

    -K Schlüsselstring des Unternehmens, Authentifizierungsdetails, siehe Authentifizierung von Agenten

    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

      Festlegen der Authentifizierungsmethode

      Zulässige Werte: NO, LOCAL, LOCAL_REMOTE

      So exportieren Sie eine Datei, die den Authentifizierungsschlüssel enthält:

      Zulässiger Wert: PACKAGE

    • -K Bildet den Company Key

      Zulässige Werte: Beliebige Zeichen

      Maximale Länge: 32

      Tipp: Geben Sie immer einen String als Unternehmensschlüssel an, auch wenn Sie keine Authentifizierung (-TNO) verwenden.

      Wichtig!

      Beachten Sie, dass der String in Anführungszeichen angegeben werden muss, wenn er Sonderzeichen enthält. Möchten Sie innerhalb des Strings 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 Authentifizierungsdetails festzulegen. Weitere Informationen finden Sie unter AE DB Load.

    Beispiel

    java -jar ucybdbld.jar -B -TNO -Kabc

  • -V

    (Optional) Gibt die Automation Engine -Version und die Hotfixnummer aus.

    Format: UCYBDBld version Automation Engine-Version plus Hotfixnummer

  • -V Pfad und Dateiname

    (Optional) Gibt die Automation Engine-Version samt Hotfixnummer in die angegebene Datei aus.

    Format: UCYBDBld version Automation Engine-Version plus Hotfixnummer

  • -I Dateiname

    (Optional) Pfad und Name der INI-Datei

  • -F Ordnerverarbeitung

    (Optional) Definiert das Verhalten von "DB Load" in Bezug auf Ordner. Beim Ersetzen von Objekten oder verknüpften Objekten werden die Daten des Benutzerverzeichnisses und der verknüpften Objekte des Transportkoffers beibehalten.

    Zulässiger 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 .

  • -L Sprache

    (Optional) Sprachparameter

    Zulässige 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.

  • -ILM

    (Optional) 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

      Die vorhandenen statistischen Datensätze werden im System aktiviert und beibehalten.

    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

  • -E Modus

    (Optional) Verarbeitungsmodus für bereits vorhandene Objekte

    Wichtig! Dieser Parameter ist nur im Batch-Modus verfügbar.

    Zulässige 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.

  • -U Name/Abteilung

    (Optional) Name und Abteilung eines Standardbenutzers

    Dieser Standardbenutzer kann verwendet werden, wenn ein Benutzer auf Objektebene keine Zugriffsberechtigungen hat.

  • -G Name

    (Optional) Der Name der Standardbenutzergruppe

    Diese Standardbenutzergruppe kann verwendet werden, wenn eine Benutzergruppe auf Objektebene keine Zugriffsberechtigungen hat.

  • -A Zugriff

    (Optional) Lädt Zugriffsberechtigungen auf Objektebene. Siehe Definieren der Seite "Berechtigungen".

    Zulässige Werte:

    • Y (Standardwert)

    • N Zugriffsberechtigungen auf Objektebene werden nicht geladen.

  • -M Zugriff

    (Optional) Zugriffsberechtigungen, die auf fehlende Benutzer und Benutzergruppen verweisen, werden ignoriert.

    Zulässige 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.

  • -Y Codierungswert

    (Optional) Übergibt die Codierung, die verwendet wird, um die Daten von Versionen vor v23 in UTF-8 zu konvertieren.
    Zulässige Werte:

    • ISO-8859-1
    • ISO-8859-15
    • WINDOWS-1252

    Wichtig!

    • Der Parameter XML_ENCODING des Werts UC_SYSTEM_SETTINGS wird verwendet, wenn dieser Wert nicht festgelegt ist. Weitere Informationen finden Sie unter XML_ENCODING.
    • Dieser Parameter hat keine Auswirkung auf Transportkoffer ab v24.
    • Dieser Parameter ist nur im Batch-Modus verfügbar.

  • -Z Tablespace-Name

    (Optional) Legt alternative Namen für die DB-Tablespaces TS_DATA und TS_INDEX für die AE- und Analytics-Datenbanken fest.

    Beispiel

    UCYBDBld -ZTS_DATA=<AE data tablespace name> -ZTS_INDEX=<AE index tablespace name>

Beispiele

Die Datei "UC_DATA.TXT" wird in Mandant 11 geladen, die Codierung wird angepasst und die vorhandenen Objekte werden ersetzt:

UCYBDBld -B -C0011 -YISO-8859-1 -XC:\AUTOMIC\UTILITY\temp\UC_DATA.TXT -EREPLACE

Die Authentifizierungsmethode LOCAL_REMOTE (Server und Agent) wird im AE-System festgelegt:

UCYBDBld -B -TLOCAL_REMOTE -KUC4PROD

Die Datenbank wird im Batch (UNIX) aktualisiert:

./ucybdbld -B -X/opt/automic/Automation.Platform/Utility/db/general/21.0/UC_UPD.TXT

Die Datenbank wird für eine Rapid Automation-Lösung geladen:

java -jar ucybdbld.jar -B -C0000 -X/tmp/WebService_SOAP_solution.jar

AEDB Reorg (UCYBDBRE.EXE)

Dieses Dienstprogramm reorganisiert Meldungen, Reports, Statistiken und Objektversionen. Weitere Informationen finden Sie unter AE DB Reorg

Syntax

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

Startparameter

Die folgenden Startparameter stehen zur Verfügung:

  • -B

    Batch-Modus

  • -S mmmm

    Nummer des Mandanten, der reorganisiert werden soll

    Wichtig! Dieser Mandant muss ein Benutzerobjekt für den Benutzer umfassen, der dieses Dienstprogramm im Batch-Modus startet.

    Beispiel: Für den Betriebssystembenutzer MEIER mit der Domäne AE muss ein Benutzerobjekt namens MEIER/AE existieren

  • -V

    (Optional) Gibt die Automation Engine-Version und Hotfixnummer im folgenden Format aus:

    • UCYBDBre version Automation Engine-Version plus Hotfixnummer

  • -V Pfad und Dateiname

    (Optional) Gibt die Automation Engine-Version samt Hotfixnummer in folgendem Format in die angegebene Datei aus:

    • UCYBDBre version Automation Engine-Version plus Hotfixnummer

  • -I Dateiname

    (Optional) Pfad und Name der INI-Datei

  • -L Sprache

    (Optional) Sprachparameter

    Zulässige 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.

    • Wichtig! Dieser Mandant muss ein Benutzerobjekt für den Benutzer umfassen, der dieses Dienstprogramm im Batch-Modus startet.

    Beispiel: Für den Betriebssystembenutzer MEIER muss ein Benutzerobjekt namens MEIER/Abteilungsname existieren. Beachten Sie, dass kein anderes Benutzerobjekt mit MEIER beginnen darf. Es ist nicht möglich, MEIER/AE und MEIER/TEST zu verwenden.

  • -D mmmm

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

Beispiel

Im folgenden Beispiel wird Mandant 98 neu organisiert:

UCYBDBre -B -S0098

AE DB Reporting Tool (UCYBDBRT.EXE)

Dieses Dienstprogramm ermöglicht benutzerdefinierte AE-Abfragen. Weitere Informationen finden Sie unter AE DB Reporting Tool.

Syntax

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

Startparameter

Die folgenden Startparameter stehen zur Verfügung:

  • -X Pfad und Dateiname

    Pfad und Name der XML-Datei

  • -C mmmm

    (Optional) Nummer des zu verarbeitenden Mandanten

    Überschreibt den Mandanten, der in der Abfragedefinition angegeben ist.

  • -I Pfad und Dateiname

    (Optional) Pfad und Name der INI-Datei

  • -L Sprache

    (Optional) Sprachparameter

    Zulässige Werte: D (Deutsch), E (Englisch), F (Französisch)

  • -R jjjjmmtt[hhmm]

    (Optional) Referenzdatum und -uhrzeit für Auswertungen von Statistiken und Prognosen

    • Überschreibt die Abfragedefinition.

    Tipp: Die Einträge der AE-Datenbank werden in UTC gespeichert. Geben Sie daher den Referenzzeitpunkt ebenfalls in dieser Zeitzone an.

  • -S

    (Optional) Gibt die Anzahl der Ausgabezeilen zurück.

  • -O Pfad und Dateiname

    Pfad und Name der Ausgangsdatei

  • -T Dateityp

    (Optional) Typ der Ausgangsdatei

    Zulässige Werte: CSV und HTML

Beispiel

Aus der Abfrage, die in der Datei jobtop10.d.xml definiert wurde, wird für den Mandant 100 eine Analyse erstellt.

UCYBDBRT -C0100 -XC:\AUTOMIC\Utilities\analyses\jobtop10.d.xml

AEDB Revision Report (UCYBDBRR.EXE)

Dieses Dienstprogramm erstellt Revisionsreports. Weitere Informationen finden Sie unter AE DB Revision Report.

Syntax

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

Startparameter

Die folgenden Startparameter stehen zur Verfügung:

  • -B

    Batch-Modus

  • -C mmmm

    Nummer des Mandanten für die Verarbeitung

  • -V

    (Optional) Gibt die Automation Engine-Version und Hotfixnummer im folgenden Format aus:

    • UCYBDBRR version Automation Engine-Version plus Hotfixnummer

  • -V Pfad und Dateiname

    (Optional) Gibt die Automation Engine-Version samt Hotfixnummer in folgendem Format in die angegebene Datei aus:

    • UCYBDBRR version Automation Engine-Version plus Hotfixnummer

  • -I Pfad und Dateiname

    (Optional) Pfad und Name der INI-Datei

  • -L Sprache

    (Optional) Sprachparameter

    Zulässige 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.

  • -O Pfad und Dateiname

    (Optional) Pfad und Name des Revisionsreports

    • Standard: Der Report wird unter dem Namen "UCYBDBRRoutput.txt" im Ordner des Dienstprogramms abgelegt.

  • -F Typ1,Typ2,...

    (Optional) Verarbeitet die erforderlichen Inhalte des Prüfberichts. Geben Sie die gewünschten Inhaltstypen an, getrennt durch Kommas. Das Dienstprogramm gibt alle Inhalte in den Revisionsreport aus, wenn Sie diesen Parameter nicht verwenden oder -F* angeben.

    • Zulässige Werte:

    • ACCESS
      Unerlaubter Zugriff

    • CANCEL
      Aufgaben abgebrochen

    • CREATE
      Neue Objekte erstellt

    • DELETE
      Objekte gelöscht

    • IMPORT
      Objekte importiert

    • MOVE
      Objekte verschoben

    • OBJ_MOD
      Objektänderungen

    • RENAME
      Objekte umbenannt

    • RESTART
      Aufgaben neu gestartet

    • RESTORE
      Objekte wiederhergestellt

    • RUN_MOD
      Objekte zur Laufzeit geändert

    • START
      Aufgaben gestartet

    • TRNSPRT
      Objekte transportiert

    • USER
      Erfolgreiche Benutzer-Logins und -Logouts

  • -D1 jjjjmmtthhmmss

    (Optional) Startdatum und -zeit für das Logging

    • Standard: Die Auswahl 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 Zeitzonendefinition des System-Mandanten 0 zur Anwendung. Wenn System-Mandant 0 auch keine Zeitzonendefinition enthält, 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.

  • -D2 jjjjmmtthhmmss

    (Optional) Enddatum und -zeit für das Logging

    • Standard: das aktuelle Datum und die aktuelle Uhrzeit

    Als Zeitzone wird die des Mandanten verwendet. Ist dort keine eingetragen, kommt die Zeitzonendefinition des System-Mandanten 0 zur Anwendung. Wenn System-Mandant 0 auch keine Zeitzonendefinition enthält, 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

    (Optional) 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

    (Optional) Geben Sie diesen Parameter an, damit nur die Revisionseinträge in den Report geschrieben werden, die zuvor noch nie durch das Dienstprogramm ausgegeben wurden, d. h. kein Archivkennzeichen aufweisen.

Beispiele

Sämtliche Revisionsinformationen des Mandatnen 1, die zwischen dem 01.05.2021 00:00 Uhr und dem aktuellen Datum aufgezeichnet wurden, werden in einen Report ausgegeben:

UCYBDBRR -B -C0001 -O/uc4/reports/report01.txt -D120210501000000

Alle Start- und Neustartpunkte zwischen dem 1. Oktober 2021, 08:00 Uhr und dem 12. Oktober 2021, 20:00 Uhr werden in einem Report ausgegeben:

UCYBDBRR -B -LD -C0100 -FSTART,RESTART -D120211001080000 -D220211001200000

AE DB Unload (UCYBDBUN.EXE)

Dieses Dienstprogramm entlädt Daten. Weitere Informationen finden Sie unter AE DB Unload.

Syntax

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

Startparameter

Die folgenden Startparameter stehen zur Verfügung:

  • -B Modus

    Batch-Modus und Verarbeitungsmodus

    • Über das gesamte AE-System:

    • NORMAL

      Es werden alle Daten aus allen Tabellen der Datenbank entladen.

    • INITIAL

      Daten werden von Mandant 0 übernommen. Es werden nur initiale Daten wie XREQs entladen.

    • DEFAULT

      Die Standarddaten des Systems werden entladen (z. B. Mandant 0, Erstbenutzer und Benutzergruppe).

    • REPAIR

      Die Ordnerstruktur im Explorer wird überprüft und repariert.

    Sowohl über das gesamte AE-System als auch mandantenweit:

    • REORG

      Die Datenbank wird reorganisiert.

    • TRANSPORT

      Der Transportkoffer wird entladen.

    • TRANSPORTALL

      Alle Objekte werden transportiert. In diesem Fall müssen Sie sie nicht vorher in den Transportkoffer verschieben. Wenn sie sich jedoch in einem Transportkoffer befinden, können Sie die Objekte nach dem Entladevorgang mit -D aus dem Transportkoffer entfernen.

    • RESETARCHIVE

      Archivkennzeichen werden zurückgesetzt. Siehe AE DB Archive.

    • RESETREORG

      Löschkennzeichen werden zurückgesetzt. Siehe AE DB Reorg.

  • -V

    (Optional) Gibt die Automation Engine-Version und Hotfixnummer im folgenden Format aus:

    • UCYBDBun version Automation Engine-Version plus Hotfixnummer

  • -V Pfad und Dateiname

    (Optional) Gibt die Automation Engine-Version samt Hotfixnummer in folgendem Format in die angegebene Datei aus:

    • UCYBDBun version Automation Engine-Version plus Hotfixnummer

  • -I Dateiname

    (Optional) Pfad und Name der INI-Datei

  • -L Sprache

    (Optional) Sprachparameter

    Zulässige 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.

  • -D

    (Optional) Dieser Startparameter entfernt nach dem Entladevorgang alle Objekte aus dem Transportkoffer.

  • -C mmmm

    (Optional) Nummer des Mandanten für das Entladen des Transportkoffers

    • Alle Mandanten werden entladen, wenn Sie hier keinen Mandanten definieren.

    Wichtig! Mandant 0 kann nicht entladen werden. Selbst wenn Sie "-C0" verwenden, werden alle Mandanten außer Mandant 0 entladen.

  • -X Dateiname

    (Optional) Name der Datei, welche die entladenen Daten aufnimmt

    • Wird dieser Parameter nicht angegeben, verwendet das Dienstprogramm den Namen und Pfad der Datei, die im Parameter output = in der INI-Datei festgelegt wurde.

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

  • -K

    (Optional) 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 von Mandant 11 wird entladen und das Dienstprogramm verwendet den Pfad und die Dateinamen, die im Abschnitt "OUTPUT=" der INI-Datei des Dienstprogramms angegeben sind. Nach dem Entladen werden alle Objekte aus dem Transportkoffer entfernt:

UCYBDBun -BTRANSPORT -D -C0011

Das Dienstprogramm hat mit der Meldung U0021148 auf einen Fehler in der Ordnerstruktur eines Mandanten aufmerksam gemacht. Daher verwenden Sie die Prüf- und Reparaturfunktion:

UCYBDBun -BREPAIR

Siehe auch: