Startparameter - Dienstprogramme

In diesem Thema werden die Parameter aufgelistet, mit denen Administratoren die verschiedenen AE-Dienstprogramme im Batch-Betrieb starten können. Sie können sie entweder über den Java-Loader oder das Dienstprogramm zuweisen.

Diese Seite beinhaltet Folgendes:

Übersicht

Beim Aufruf der Dienstprogramme AE DB Client Copy, AE DB Archive oder AE DB Reorg findet Batch-Modus eine Berechtigungsprüfung für den Single-Login statt. Weitere Informationen finden Sie unter AE DB Client Copy, AEDB Archive oder AE DB Reorg.

Beispiel

Existiert für den am Betriebssystem angemeldeten Benutzer kein entsprechendes Benutzer-Objekt im AE-System, bricht das Dienstprogramm den Batchaufruf ab. Diese Prüfung wird immer durchgeführt, auch wenn die Systemvariable UC_USER_LOGON alle relevanten Einträge enthält. Ein Single-Login bietet erhöhte Sicherheit im Batch-Modus. Wenn ein Programm mit dem Automic Web Interface beginnt, erhöht ein 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 mit *g.exe enden, starten die Dienstprogramme im Normalmodus. Trotzdem können Sie den *g.exe-Dateien Parameter zuweisen. Die *.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. Dateien ohne Dateiendung können verwendet werden, um Startparameter für die Batch-Aufrufe zuzuweisen.

Java-Loader

Programm: Java Loader

Die folgenden Startparameter stehen zur Verfügung:

-F0Dateiname
Unterdrückt den Startbildschirm
-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, wie unten beschrieben. Diese Parameter werden dem Abschnitt cmd in der INI-Datei hinzugefügt. Das bedeutet, dass Sie eine Standardeinstellung in der INI-Datei angeben und bestimmte Situationen über den Java-Loader behandeln können.

Es ist zwingend erforderlich, doppelte Anführungszeichen 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

Dieses Dienstprogramm archiviert Nachrichten, Reports und Statistiken. Weitere Informationen finden Sie unter AEDB Archive.

Syntax

Archivierungsmodus

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

Reportmodus

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

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

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

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

UCYBDBAR [-V[Pfad und Dateiname]] [-IDateiname] [-LSprache] -B -Xreport -NObjektname [-T1YYYYMMDDhhmmss] [-T2YYYYMMDDhhmmss] [-PDateipräfix]

Programm: UCYBDBAR

Die folgenden Startparameter stehen zur Verfügung:

-V
Gibt dieAutomation Engine-Version und Hotfixnummer im folgenden Format aus:

UCYBDBar-Version Automation Engine-Version plus Hotfixnummer

-VPfad und Dateiname
Gibt die Automation Engine-Version und Hotfixnummer für die angegebene Datei im folgenden Format aus:

UCYBDBar-Version Automation Engine-Version plus Hotfixnummer

-IDateiname
Pfad und Name der INI-Datei
-LSprache
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.
-B
Batch-Modus

Im Archivierungsmodus:

-Smmmm
Nummer des Mandanten, der archiviert werden soll

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

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

-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 müssen Sie immer einen Mandanten definieren, außer für -Xreport. 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
Der Mandant, dessen Reports aufgelistet werden sollen
-Xunload und -Xmark
Der Mandant wird für die Überprüfung der Login-Daten verwendet. Es muss ein Benutzer-Objekt vorhanden sein. Andernfalls bricht das Dienstprogramm den Vorgang ab.

-XModus
Typ der Reportverarbeitung

Für Output-Management-Systeme (siehe Offene Schnittstelle zu Output-Management-Systemen ):

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

Zum Kombinieren von Log- und Trace-Dateien (siehe AE.LogMix - Zusammenfassen von Report-, Log- und Trace-Dateien):

report
Aus den Logeinträgen von Serverprozessen werden Dateien erzeugt

Parameter für -Xlist
- -OPfad und Dateiname
  Pfad und Name der CSV-Datei
  - Wird kein Dateiname angegeben, wird der Name uc_XROlist.csv verwendet.
  - Wenn Sie keinen Pfad angeben, wird die Datei in dem Ordner gespeichert, in dem sich das Dienstprogramm befindet.
- -YZahl
  Filter für die Reportauswahl
Parameter für -Xunload
- -OPfad und Dateiname
  Pfad und Name der Textdatei
- -YZahl
  Legt eine Zahl für ein späteres Filtern fest
- -RRunID
  RunID der Aufgabe
- -TZeitzone
  Name eines Zeitzonen-Objekts
- -TYReporttyp
  Typ des Reports (z. B. ACT)
Parameter für -Xmark
- -RRunID
  RunID der Aufgabe
- -TYReporttyp
  Typ des Reports (z. B. ACT)
Parameter für -Xreport
- -NObjekt
  Name eines Objekts oder Filters, der ein Sternsymbol (*) für mehrere Objekt verwendet.
- -T1yyyymmddhhmmss
  Startdatum und -zeit für die auszuwählenden Serverreports
- -T2YYYYMMDDhhmmss
  Enddatum und -zeit für die auszuwählenden Serverreports
- -PPfad und Dateipräfix
  Pfad und Dateipräfix für die Zieldatei

Beispiele

Der Client 1 wird archiviert.

UCYBDBar -B -S0001

Das Dienstprogramm erstellt eine Reportliste und schreibt sie in die Datei report01.csv.

UCYBDBar -B -Xlist -S1000 -OC:\AUTOMIC\REPORT\report01.csv

Der Report mit der Nummer 1791029 wird in eine Textdatei entladen und erhält den Status 123.

UCYBDBar -B -Xunload -S1000 -R1791029 -Y123

AE DB Archive kennzeichnet den Report mit der Nummer 1791029 als archiviert und entfernt ihn aus der Datenbanktabelle.

UCYBDBar -B -Xmark -S1000 -R1791029

Alle Serverreports des 15. März 2018 sollen entladen werden.

UCYBDBar -B -Xreport -N"UC4#CP*,UC4#WP*" -T120180315000000 -T220180315235959 -P"C:\AUTOMIC\report\server"

Das Dienstprogramm soll nur die Reports der Arbeitsprozesse WP001 und WP002 entladen.

UCYBDBar -B -Xreport -N"UC4#WP001,UC4#WP002" -T120070315000000 -T220070315235959

AE DB Change

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 [-3Ausgabedatei] [-LSprache]

Programm: UCYBCHNG. EXE

Die folgenden Startparameter stehen zur Verfügung:

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

UCYBChng-Version Automation Engine-Version plus Hotfixnummer

-VPfad und Dateiname
Gibt die Automation Engine-Version und Hotfixnummer für die angegebene Datei im folgenden Format aus:

UCYBChng-Version Automation Engine-Version plus Hotfixnummer

-B
Batch-Modus
-1Script-Datei
Diese Datei enthält Änderungsanweisungen (REPLACE).
-2Transportdatei
Enthält die ursprünglichen Exportdaten
Standard: UC_DATA.TXT
-3Ausgabedatei
Geänderte Daten werden in diese Datei geschrieben
-LSprache
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

Dieses Dienstprogramm kopiert und löscht Mandanten. Weitere Informationen finden Sie unter 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: UCYBDBCC

Die folgenden Startparameter stehen zur Verfügung:

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

UCYBDBcc-Version Automation Engine-Version plus Hotfixnummer

-VPfad und Dateiname
Gibt die Automation Engine-Version und Hotfixnummer für die angegebene Datei im folgenden Format aus:

UCYBDBcc-Version Automation Engine-Version plus Hotfixnummer

-IDateiname
Pfad und Name der INI-Datei
-LSprache
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.
-B
Im Batchmodus starten, Single-Logon wird verwendet
-V
Gibt die Automation Engine-Version und Hotfixnummer aus

Im Kopiermodus:

-C
Kopiert den Mandanten

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

-Smmmm
Nummer des Quellmandanten

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/AEund MEIER/TEST zu verwenden.

-Dmmmm
(Nur Windows) Nummer des Quellmandanten

Wichtig!

Die Parameter -D und -S dürfen nicht zusammen verwendet werden.

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 Zielmandanten

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

-O
Kopiert Objekte
-M
Kopiert Meldungen
-A
Kopiert Statistiken und Reports
-R
Setzt das Passwort zurück
-V
Kopiert Versionsobjekte
-W
Löscht die Arbeitsdateien nach einem erfolgreichen Kopieren

Im Löschmodus:

-E
Löscht einen Mandanten

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

-Smmmm, -Dmmmm, -Tmmmm
Sie können unterschiedliche Datenbanken für die Quelle und das Ziel in der INI-Datei 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

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

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 [-V[Pfad und Dateiname]] [-IDateiname] [-FOrdnerverwaltung] [-LSprache] -B -Cmmmm [-EModus] [-UName/Abteilung] [-GName] [-AZugang] [-MZugang] -XDateiname

Setzen der Authentifizierungsmethode

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

Programm: UCYBDBLD

Die folgenden Startparameter stehen zur Verfügung:

-V

Gibt die Automation Engine-Version und die Hotfixnummer aus

Format: UCYBDBld-Version Automation Engine-Version plus Hotfixnummer
-VPfad und Dateiname

Gibt die Automation Engine-Version samt Hotfixnummer in die angegebene Datei aus

Format: UCYBDBld-Version Automation Engine-Version plus Hotfixnummer
-IDateiname

Pfad und Name der INI-Datei
-FOrdnerverwaltung

Definiert das Verhalten von DB Load in Bezug auf Ordner. Beim Ersetzen von Objekten oder verknüpften Objekten bleiben die Daten des Benutzerverzeichnisses und der verknüpften Objekte des Transportkoffers erhalten.

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

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

Batch Modus
-ILM

ILM installieren
- -N[X]
  
  Anzahl der aktiven Partitionen
- -SAH_part1|AH_part2|AH_part3
  
  Liste der AH-Partitionen getrennt durch |
- -RRH_part1>RH_part2|RH_part3
  
  Liste der RH-Partitionen getrennt durch |
- -OMisc_part1|Misc_part2|Misc_part3
  
  Liste der sonstigen Partitionen getrennt durch |
- -D
  
  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
-Cmmmm

Nummer des Clients für Verarbeitung
- -C-1
  
  Behält Clients
- -Cmmmm
  
  Lädt den Transportkoffer in den Client mmmm
-EModus

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
-UName/Abteilung

Name und Abteilung eines Standard-Benutzers

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

Name einer Standard-Benutzergruppe

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

Lädt Zugriffsberechtigungen auf Objektebene, siehe Seite "Berechtigungen"

Zulässige Werte:
- Y (Standardwert)
- N Zugriffsberechtigungen auf Objektebene werden nicht geladen
-MZugriff

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

Name der zu ladenden Datei. Dieser Startparameter ist obligatorisch.
-TAuthentifizierungsmethode und

-KSchlü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

Alternativ können Sie auch die grafische Oberflä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 Authentifizierungsmethode Server und Agent soll im AE-System eingestellt werden.

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

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

Syntax

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

Programm: UCYBDBRE

Die folgenden Startparameter stehen zur Verfügung:

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

UCYBDBre-Version Automation Engine-Version plus Hotfixnummer

-VPfad und Dateiname
Gibt die Automation Engine-Version und Hotfixnummer für die angegebene Datei im folgenden Format aus:

UCYBDBre-Version Automation Engine-Version plus Hotfixnummer

-IDateiname
Pfad und Name der INI-Datei
-LSprache
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.

-B
Batch-Modus
-Smmmm
Nummer des Mandanten, der reorganisiert werden soll

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

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

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

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

Beispiel

der Client 98 wird reorganisiert.

UCYBDBre -B -S0098

AE DB Reporting Tool

Dieses Dienstprogramm erleichtert benutzerdefinierte AE-Abfragen. Weitere Informationen finden Sie unter AE DB Reporting Tool.

Syntax

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

Programm: UCYBDBRT.EXE

Die folgenden Startparameter stehen zur Verfügung:

-Cmmmm
Mandantennummer für die Verarbeitung
Sie überschreibt den Mandanten, der in der Abfragedefinition angegeben wurde.
-XPfad und Dateiname
Pfad und Name der XML-Datei
-IPfad und Dateiname
Pfad und Name der INI-Datei
-LSprache
Sprachparameter
Zulässige Werte: D (Deutsch), E (Englisch), F (Französisch)
-RYYYYMMDD[hhmm]
Referenzdatum für die Analyse 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
Gibt die Anzahl der ausgegebenen Zeilen zurück
-OPfad und Dateiname
Pfad und Name der Ausgabedatei
-TDateityp
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 Client 100 eine Analyse erstellt.

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

AEDB Revision Report

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

Syntax

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

Programm: UCYBDBRR.EXE

Die folgenden Startparameter stehen zur Verfügung:

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

UCYBDBRR-Version Automation Engine-Version plus Hotfixnummer

-VPfad und Dateiname
Gibt die Automation Engine-Version und Hotfixnummer für die angegebene Datei im folgenden Format aus:

UCYBDBRR-Version Automation Engine-Version plus Hotfixnummer

-IPfad und Dateiname
Pfad und Name der INI-Datei
-LSprache
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.

-B
Batch-Modus
-Cmmmm
Mandantennummer für die Verarbeitung
-OPfad und Dateiname
Pfad und Name des Revisionsreports

Standard: Der Report wird 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.

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

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

-D1YYYYMMDDhhmmss
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 Zeitzone des System-Clients 0000 zur Anwendung. Fehlt dort ebenfalls die Zeitzone, wird UTC verwendet.

Alle Änderungsdaten werden in den Report geschrieben, wenn die Zeitparameter -D1 und -D2 nicht verwendet werden. Die Filter -F und -X werden berücksichtigt.

-D2YYYYMMDDhhmmss
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 Zeitzone des System-Clients 0 zur Anwendung. Fehlt dort ebenfalls die Zeitzone, wird UTC verwendet.

Alle Änderungsdaten werden in den Report geschrieben, wenn die Zeitparameter -D1 und -D2 nicht verwendet werden. Die Filter -F und -X werden berücksichtigt.

-A
Der Parameter bewirkt, dass Archivkennzeichen gesetzt werden. Er steht in Zusammenhang mit dem Parameter -X.

Der Start von Aufgaben wird aus den Statistiksätzen ermittelt, siehe Startparameter -FSTART. Daher kann das Dienstprogramm für diese Datensätze keine Archivkennzeichen setzen.

-X
Geben Sie diesen Parameter an, 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 Clients 1 zwischen 01.05 00:00 und dem aktuellen Datum werden in einen Report ausgegeben.

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

Sämtliche Start- und Wiederanlaufpunkte zwischen 01.10. 08:00 und 01.10. 12:00 werden in einen Report ausgegeben.

UCYBDBRR -B -LD -C0100 -FSTART,RESTART -D120171001080000 -D220171001200000

AE DB Unload

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

Syntax

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

Programm: UCYBDBUN

Die folgenden Startparameter stehen zur Verfügung:

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

UCYBDBun-Version Automation Engine-Version plus Hotfixnummer

-VPfad und Dateiname
Gibt die Automation Engine-Version und Hotfixnummer für die angegebene Datei im folgenden Format aus:

UCYBDBun-Version Automation Engine-Version plus Hotfixnummer

-IDateiname
Pfad und Name der INI-Datei
-LSprache
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.
-BMode
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. Mandant 0, anfänglicher Benutzer 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 Mandanten 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

AE.LogMix

Dieses Dienstprogramm kombiniert Reports, Protokolle und Trace-Dateien. Weitere Informationen finden Sie unter AE.LogMix - Zusammenfassen von Report-, Log- und Trace-Dateien.

Syntax

UCYBLGMX [-V[Pfad und Dateiname]] -B-LPfad und Namen der Log- und Trace-Dateien -FPfad und Name der Zieldatei

Programm: UCYBLGMX

Die folgenden Startparameter stehen zur Verfügung:

-V
Gibt die Automation Engine-Version mit der Hotfixnummer im folgenden Format aus:

UCYBLGMX-Version Automation Engine-Version plus Hotfixnummer

-VPfad und Dateiname
Gibt die Automation Engine-Version und Hotfixnummer für die angegebene Datei im folgenden Format aus:

UCYBLGMX-Version Automation Engine-Version plus Hotfixnummer

-B
Batch-Modus
-LPfad und Namen der Log- und Trace-Datei
Die Log-Dateien und die Trace-Dateien, die in eine Zieldatei integriert 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

Das Platzhalterzeichen "*" kann in Dateinamen verwendet werden.

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

-FPfad und Name der Zieldatei
Pfad und Name der Zieldatei

Der Pfad kann weggelassen werden, wenn die Zieldatei im selben Ordner wie das Dienstprogramm erstellt werden soll.

Eine bereits vorhandene gleichnamige Datei wird überschrieben.

Beispiel

Der Logdateien mit dem Präfix server werden in der Zieldatei AE.txt zusammengefasst.

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

Siehe auch: