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 zuweisen.

Wichtig! Um Dienstprogramme im Batch-Betrieb starten zu können, müssen Sie Ihre spezifischen Einstellungen einmal auf der Benutzeroberfläche des Dienstprogramms 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, AEDB Archive oder AE DB Reorg.

Beispiel: Existiert für den Betriebssystem-Benutzer, der beim AE-System angemeldet ist, kein Benutzer-Objekt, bricht das Dienstprogramm ab. Das Dienstprogramm prüft auf das Benutzer-Objekt, 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 dem Automic Web Interface gestartet wird, erhöht das Single-Login die Benutzerfreundlichkeit. Weitere Informationen finden Sie unter UC_USER_LOGON - Single Logon.

Windows

Standardmäßig starten die Dienstprogramme im Batch-Betrieb, 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 zuweisen. *.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

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

Java-Loader (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

    • Sie können den Java-Loader verwenden, um dem Dienstprogramm Parameter zuzuweisen. 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 das Java-Loader bearbeiten.

    Es ist zwingend erforderlich, doppelte Anführungszeichen für Pfadangaben zu verwenden, die Leerzeichen enthalten. Zum 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

AEDB Archive (UCYBDBAR.EXE)

Dieses Dienstprogramm archiviert Nachrichten, Reports und Statistiken. Weitere Informationen finden Sie unter AEDB 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

  • -IDateiname

    (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 Clients, 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. Kein anderes Benutzer-Objekt darf mit MEIER beginnen. Es ist nicht möglich, MEIER/AE und MEIER/TEST zu verwenden.

  • -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 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 Client angegeben werden. Für die Parameter -S und -D gelten dieselben Vorgaben wie im Archivierungsmodus.

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

    • -Xlist

      Client, dessen Reports aufgelistet werden soll

    • -Xunload und -Xmark

      Der Client wird für die Anmeldeprüfung verwendet. Es muss ein Benutzer-Objekt vorhanden sein. Andernfalls bricht das Dienstprogramm den Vorgang ab.

  • -X Modus

    Art der Reportbehandlung

    • Für Output-Management-Systeme (siehe Offene Schnittstelle zu Output-Management-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

    • -OPfad 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.

    • -YZahl

      (Optional) Filter für die Reportauswahl

  • Parameter für -Xunload

    • -OPfad 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.

    • -YZahl

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

    • -RRunID

      RunID der Aufgabe

    • -TZeitzone

      (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 Client nicht existiert, wird UTC verwendet.

    • -TYReporttypen

      (Optional) Typ des Reports (z. B. ACT)

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

  • Parameter für -Xmark

    • -RRunID

      RunID der Aufgabe

    • -TYReporttypen

      (Optional) Typ des Reports (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 Beistrichen zu trennen.

    • -T1 jjjjmmtthhmmss

      (Optional) Startdatum und -zeit für die auszuwählenden Serverreports

      • Standard: Das aktuelle Datum und die aktuelle Uhrzeit 00:00:00

    • -T2 jjjjmmtthhmmss

      (Optional) Enddatum und -zeit für die auszuwählenden Serverreports

      • 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 AEDB Change.

Syntax

UCYBCHNG [-V[Pfad und Dateiname]] -B -1Scriptdatei-2Transportdatei [-3Ausgabedatei] [-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 die Datei in folgendem Format aus:

    • UCYBChng-Version Automation Engine-Version plus Hotfixnummer

  • -B

    Batch Modus

  • -1Script-Datei

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

  • -2Transportdatei

    Beinhaltet die Original-Daten des Exportes

    Standard: UC_DATA.TXT

  • -3Output-Datei

    (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 die Datei in folgendem Format aus:

    • UCYBDBcc-Version Automation Engine-Version plus Hotfixnummer

  • -IDateiname

    (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

    Clients kopieren

    • Hinweis: Der Betriebssystem-Benutzer muss in beiden Datenbanken alsAEBenutzer im System-Client 0000 vorhanden sein. Andernfalls wird der Prozess mit einer Fehlermeldung abgebrochen.

  • -Smmmm

    Nummer des Quell-Clients

    • Wichtig: Der System-Client 0, der das Dienstprogramm im Batchmodus startet, muss ein Benutzer-Objekt in diesem Client 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 Quellmandanten

    • Wichtig! 

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

    • Der System-Client 0, der das Dienstprogramm im Batchmodus startet, muss ein Benutzer-Objekt in diesem Client besitzen.

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

  • -Tmmmm

    Nummer des Ziel-Clients

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

  • -O

    Objekte kopieren

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

    Client 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 für Quelle und Ziel definieren.

    • -S oder -D

      Löscht den Client in der Quelldatenbank

    • -T

      Löscht die Zieldatenbank

    Für diese Parameter gelten dieselben Voraussetzungen wie im Kopiermodus.

Beispiele

Client kopieren: Die Objekte, Statistiken und Reports des Clients 38 werden in einen neuen Client mit der Nummer 2 kopiert:

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

Client löschen: Der Client 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.

Syntax

  • Laden von Transportkoffer / Initialdaten

    • UCYBDBLD -B -Cmmmm-XDateiname [-V[Pfad und Dateiname]] [-IDateiname] [-FOrdnerverwaltung] [-LSprache] [-EModus] [-UName/Abteilung] [-GName] [-AZugriff] [-MZugriff]

  • Setzen der Authentifizierungsmethode

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

Startparameter

Die folgenden Startparameter stehen zur Verfügung:

  • -B

    Batch Modus

  • -Cmmmm

    Nummer des Clients für Verarbeitung

    • -C-1

      Behält Clients

    • -Cmmmm

      Lädt den Transportkoffer in den Client mmmm

  • -XDateiname

    Name der zu ladenden Datei. Dieser Startparameter ist obligatorisch.

  • -T Authentifizierungsmethode und

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

    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

      Zulässige Werte: NO, LOCAL, LOCAL_REMOTE

      So exportieren Sie eine Datei, die den Authentifizierungskey 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 für den 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 Authentifizierungsdaten 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

  • -IDateiname

    (Optional) Pfad und Name der INI-Datei

  • -F Ordnerverwaltung

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

    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

      Sie können die vorhandenen statistischen Datensätze im System einschalten 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 bei bereits vorhandenen Objekten

    Hinweis: 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 Standard-Benutzers

    Wenn ein Benutzer auf Objektebene keine Zugriffsberechtigungen hat, kann er durch einen Standard-Benutzer ersetzt werden.

  • -G Name

    (Optional) Der Name der Standard-Benutzergruppe

    Wenn die Benutzergruppe auf Objektebene keine Zugriffsberechtigungen hat, kann sie durch eine Standard-Benutzergruppe ersetzt werden.

  • -A Zugriff

    (Optional) Lädt Zugriffsberechtigungen auf Objektebene, siehe Seite "Berechtigungen"

    Zulässige Werte:

    • Y (Standardwert)

    • N Zugriffsberechtigungen auf Objektebene werden nicht geladen

  • -MZugriff

    (Optional) Zugriffsberechtigungen, die auf fehlende Benutzer und Benutzergruppen verweisen, ignorieren

    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

  • -Z Tablespace-Name

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

    Beispiel

    UCYBDBld -ZTS_DATA=<AE-Daten-Tablespace-Name> -ZTS_INDEX=<AE-Index-Tablespace-Name>

Alternativ können Sie auch die Benutzeroberfläche des Dienstprogramms verwenden.

Beispiele

Die Datei UC_DATA.TXT wird in den Client 11 geladen, wobei bestehende Objekte ersetzt werden:

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

Die LOCAL_REMOTE-Authentifizierungsmethode (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 Nachrichten, 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

  • -Smmmm

    Nummer des Clients, 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

  • -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 die Datei in folgendem Format aus:

    • UCYBDBre-Version Automation Engine-Version plus Hotfixnummer

  • -IDateiname

    (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! 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

Beispiel

Im folgenden Beispiel wird Mandant 98 neu organisiert:

UCYBDBre -B -S0098

AE DB Reporting Tool (UCYBDBRT.EXE)

Dieses Dienstprogramm erleichtert 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:

  • -XPfad und Dateiname

    Pfad und Name der XML-Datei

  • -Cmmmm

    (Optional) Nummer des Mandanten für die Verarbeitung

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

  • -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)

  • -Rjjjjmmtt[hhmm]

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

    • Auch dieser Parameter überschreibt die Definition in der Abfrage.

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

  • -S

    (Optional) Gibt die Anzahl der Ausgabezeilen zurück

  • -OPfad und Dateiname

    Pfad und Name der Ausgabedatei

  • -TDateityp

    (Optional) Typ der Ausgabedatei

    Zulässige Werte: CSV und HTML

Beispiel

Aus der Abfrage, die in der Datei jobtop10.d.xml definiert wurde, wird für den Mandanten 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

  • -Cmmmm

    Nummer des Clients 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 die Datei in folgendem Format 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.

  • -OPfad und Dateiname

    (Optional) Pfad und Name des Revisionsreports

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

  • -F Typ1,Typ2,...

    (Optional) Verwaltet den erforderlichen Inhalt des Auditing-Reports. Geben Sie die gewünschten Inhaltstypen mit Komma getrennt an. 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

  • -D1jjjjmmtthhmmss

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

  • -D2jjjjmmtthhmmss

    (Optional) Enddatum und -zeit für die Protokollierung

    • 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 AEDB Unload.

Syntax

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

Startparameter

Die folgenden Startparameter stehen zur Verfügung:

  • -V

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

    • UCYBDBun-Version Automation Engine-Version plus Hotfixnummer

  • -V Pfad 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

  • -L Sprache

    Sprachenparameter

    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.

  • -BModus

    Batch-Modus und Verarbeitungsmodus

    • Über das gesamte AE-System:

    • NORMAL

      Es werden alle Daten aller Tabellen der Datenbank entladen.

    • INITIAL

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

    • DEFAULT

      Standarddaten des Systems werden entladen (z.B. Client 0, Initialbenutzer und Benutzergruppe).

    • REPAIR

      Die Ordnerstruktur des Explorers wird überprüft und repariert.

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

    • 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 Clients für das Entladen des Transportkoffers

    • Alle Clients werden entladen, wenn Sie hier keinen Client definieren.

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

  • -XDateiname

    Name der Datei, welche die zu entladenden Daten aufnimmt

    • 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 Clients 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 Clients aufmerksam gemacht. Die Korrekur-Funktion soll daher aufgerufen werden.

UCYBDBun -BREPAIR

Siehe auch: