Paramètres de démarrage - Utilitaires

Javaloader de l'utilitaire

-F0

Suppression du Splashscreen

-IChemin et nom de fichier

Chemin et nom du fichier INI pour Javaloader

-JParamètres

Paramètres de l'utilitaire

Il est également possible de passer des paramètres à l'utilitaire via Javaloader (voir ci-dessous). Ces derniers sont ajoutés à l'appel cmd du fichier INI. Il est ainsi possible d'indiquer un paramètre par défaut dans le fichier INI et de contrôler des options spéciales via Javaloader.

Veillez à respecter les points suivants :

• La chaîne de paramètres doit être écrite entre guillemets.
• de plus, les chemins contenant des espaces doivent également comporter des guillemets doubles (par exemple -J"-I""C:\AUTOMIC\mes Utilitaires\UCYBDBAR.ini""").

Exemples :
la langue correspondante doit être définie au moyen d'un lien.

Extrait du fichier INI :

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

La langue est préréglée dans le lien :

UCYBDBarg.exe -F0 -J"-LD"

Lors de la spécification d'un fichier INI pour l'utilitaire, le paramètre -I doit être spécifié deux fois. C'est aussi nécessaire lorsque Javaloader et l'utilitaire utilisent le même fichier INI.

Exemples :

Les deux utilisent le même fichier INI :

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

Des fichiers INI différents sont utilisés :

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

Utility for database archiving
UCYBDBAR.JAR

-V

Prints the Automation Engine version and hotfix number in the following format:

"UCYBDBar version Automation Engine version plus hotfix number"

-VPath and file name

Prints the Automation Engine version and hotfix number to the specified file in the following format:

"UCYBDBar version Automation Engine version plus hotfix number"

-IFile name

The path and the name of the INI file.

-LLanguage

Language

Allowed values: "D", "E", "F"
"D" = German (Deutsch), "E" = English, "F" = French

The language that is specified in the INI file is used if you do not specify this parameter.

-B

Batch mode.

Archiving mode

-Smmmm

The number of the client that should be archived.

This client must include a User object for the user who starts this utility in batch mode.

For example: There must be the User object "SMITH/department name for the OS user Smith. Note that no other User object must start with "SMITH" (for example, SMITH/UC4 and SMITH/TEST is not possible).

-Dmmmm

The number of the client that should be archived (only Windows).

This client must include a User object for the user who starts this utility in batch mode.

For example: There must be the User object "SMITH/UC4" for the OS user SMITH of the domain UC4.

Report mode

-Smmmm
-Dmmmm

A client must always be specified in report mode (except for -Xreport). The same rules apply for the two parameters as in archiving mode.

Depending on the report mode that is used, the client specification can have a different meaning:

"-Xlist" - Client whose reports should be listed.

"-Xunload" and "-Xmark" - The client is used for checking login data. A User object must be available, as otherwise the utility cancels the process.

-XMode

The type of  report handling.

For Output Management systems:

"list" - Reports are listed.
"unload" - Report is unloaded.
"mark" - Report is marked archived and removed from the database table "XRO".

For the  combination of log and trace files:

"report" - Files are generated from the log entries of server processes.

Parameters for -Xlist

-OPath and file name

The path and the name of the CSV file.

The name "uc_XROlist.csv" is used if you do not specify a file name. If you do not specify a path, the file is stored in the folder in which the utility is stored.

-YNumber

The filter for the report selection.

Parameters for -Xunload

-OPath and file name

The path and the name of the text file.

A file with the additional prefix "_Report type" is created in the specified folder for each report of the task.

The name "uc_XROreport.txt_Report type" is used if you do not specify a file name. By default, the files are stored in the folder in which the utility is stored.

-YNumber

This sets a number for later filtering.

-RRunID

The RunID of the task.

-TTimeZone

The name of a TimeZone object.

By default, Universal Time (UTC) is used in unloaded reports. The parameter can be used to convert the time specifications to other time zones.

UTC is used if this TimeZone object does not exist in the specified client.

The type of the report (such as ACT).

All reports of the task are exported to a separate file if you do not specify a report type.

Parameters for -Xmark

-RRunID

The RunID of the task.

The type of the report (such as ACT).

All report types are archived if this parameter has not been specified. A separate file is created for each report type (names end with _report type, for example, _ACT).

Parameters for -Xreport

-NObject

The name of an object or filter using "*" for several objects.

Several specifications that should be separated with commas.

-T1yyyymmddhhmmss

The start date and the time for the Server reports that should be selected.

Standard value: current date and time 00:00:00

-T2yyyymmddhhmmss

The end date and the time for the Server reports that should be selected.

Standard value: Current date and time

-PPath and file prefix

The path and the file prefix for the target file.

By default, the target files obtain the prefix "unload". They are stored in the utility folder.

The file name is composed as follows:
Prefix.object name_date_time.txt

Examples:

Client 1 is archived.

UCYBDBar -B -S0001

The utility creates a report list and writes it to the file report01.csv.

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

Report number 1791029 is unloaded to a text file and obtains status 123.

UCYBDBar -B -Xunload -S1000 -R1791029 -Y123

AE DB Archive marks the report as archived using the number 1791029 and removes it from the database table.

UCYBDBar -B -Xmark -S1000 -R1791029

All Server reports of March 15th, 2007 should be unloaded.

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

The utility should only unload reports of the work processes "WP001" and "WP002".

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

Utility for the modification of exported data
UCYBCHNG.EXE

-V

Prints the Automation Engine version and the hotfix number in the following format:

"UCYBChng version Automation Engine version plus hotfix number"

-VPath and file name

Prints the Automation Engine version and the hotfix number to the specified file in the following format:

"UCYBChng version Automation Engine version plus hotfix number"

-B

Batch mode.

-1Script File

This file contains modification instructions (REPLACE).

-2Transport File

Contains the original export data (UC_DATA.TXT by default).

-3Output File

Modified data is written to this file.

-LLanguage

Language

Allowed values: "D", "E", "F"
"D" = German (Deutsch), "E" = English, "F" = French

The language that is specified in the INI file is used if you do not specify this parameter.

For example:

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

Utility for copying and deleting clients
UCYBDBCC.JAR

-V

Prints the Automation Engine version and the hotfix number in the following format:

"UCYBDBcc version Automation Engine version plus hotfix number"

-VPath and file name

Prints the Automation Engine version and hotfix number to the specified file in the following format:

"UCYBDBcc version Automation Engine version plus hotfix number"

-IFile name

The path and the name of the INI file.

-LLanguage

Language

Allowed values: "D", "E", "F"
"D" = German (Deutsch), "E" = English, "F" = French

The language that is specified in the INI file is used if you do not specify this parameter.

-B

Start in batch mode, single logon is used.

-V

Outputs the Automation Engine version and hotfix number.

Copy mode

-C

Copies the client; the OS user must exist as an AE user in both databases in system client 0000. Otherwise, the process aborts with an error message.

-Smmmm

The number of the source client.

The system client 0000 must include a User object for the user who starts this utility in batch mode.

For example: There must be the User object "SMITH/department name for the OS user Smith. Note that no other User object must start with "SMITH" (for example, SMITH/AE and SMITH/TEST is not possible).

-Dmmmm

The number of the source client (only Windows).

Note that the parameters -D and -S must not be used together.

The system client 0000 must include a User object for the user who starts this utility in batch mode.

For example: There must be the User object "SMITH/AE" for the OS user SMITH of the domain AE.

-Tmmmm

The number of the target client.

The same requirements apply to the user as described for the parameter -S.

-O

Copies objects.

-M

Copies messages.

-A

Copies statistics and reports.

-R

Resets password.

-V

Copies version objects.

-W

Deletes the work files after a successful copying process.

Deletion mode

-E

Deletes a client; the OS user must exist as an AE user in both databases in the system client 0000. Otherwise, the process aborts with an error message.

-Smmmm
-Dmmmm
-Tmmmm

You can define different databases for the source and the target in the INI file. When you use the parameters -S or -D, the client in the source database will be deleted; -T deletes the target database.

The same requirements apply for these parameters as in copy mode.

Examples:

Copy client:

The objects, statistics and reports of client 38 are copied to the new client number 2:

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

Delete client:

Client 2 is deleted in the target database.

UCYBDBcc -B -E -T0002

Utilitaire pour le chargement de la base de données
UCYBDBLD.JAR

-V

Affiche la version Automation Engine, y compris le numéro de correctif, au format suivant :

"UCYBDBld version Automation Engineversion plus numéro de correctif"

-VChemin et nom de fichier

Affiche la version Automation Engine, y compris le numéro de correctif, au format suivant :

"UCYBDBld version Automation Engineversion plus numéro de correctif"

-Inom de fichier

Chemin et nom du fichier INI

Définit le comportement du DB Load selon le dossier. Quand les objets ou les objets liés sont remplacés, les données du dossier initial et les objets liés du conteneur de transport sont conservés.

Valeur autorisée : = "OT"

Quand cette valeur est définie, les données du fichier de données du conteneur transport écraseront les objets existants dans la base de données Automation Engine.

-LLangue

Langue

Valeurs autorisées : "D", "E", "F"
"D" = allemand, "E" = anglais, "F" = français

Si le paramètre n'est pas indiqué, le langage défini dans le fichier INI est utilisé.

-B

Mode batch.

-Cmmmm

Numéro du Client pour le traitement.

Avec-C-1, les Clients sont conservés,avec-Cmmmm, le conteneur Transport est enregistré dans le Client mmmm

-Emode

Mode de traitement pour les objets existants déjà.
Uniquement en mode batch.

Valeurs autorisées : "IGNORER", "INTERROMP", "REPLACE"
"IGNORER" = L'objet est ignoré (valeur par défaut).
"ABEND" = Le traitement est interrompu.
"REPLACE" = L'objet existant est remplacé.

Attention : pour le paramètre "IGNORE", l'objet original et l'objet à charger doivent présenter le même type. Dans le cas contraire, le processus est interrompu avant le chargement.

-Unom/département

Nom et département d'un Utilisateur standard.

Si l'utilisateur n'a pas de droit d'accès au niveau de l'objet, l'utilisateur par défaut peut être utilisé à la place.  

-Gnom

Nom d'un groupe d'utilisateurs par défaut.

Si le groupe d'utilisateurs n'a pas de droit d'accès au niveau de l'objet, le groupe par défaut peut être utilisé à la place.

-Aaccès

Chargement d'autorisations d'accès au niveau de l'objet.

Valeurs autorisées : "Y", "N"
"Y" = Charger les autorisations d'accès au niveau de l'objet (valeur par défaut).
"N" = Ne pas charger les autorisations d'accès au niveau de l'objet.

-Maccès

Les autorisations d'accès qui renvoient à des utilisateurs et à des groupes d'utilisateurs manquants sont ignorées.

Valeurs autorisées : "Y", "N"
"Y" : ignore les autorisations d'accès des utilisateurs et des groupes d'utilisateurs manquants. Ne pas charger.
"N" : interrompt la procédure de chargement des autorisations d'accès des utilisateurs et des groupes d'utilisateurs manquants (valeur par défaut).

-Xnom de fichier

Chemin et nom du fichier à charger. Attention : ce paramètre doit toujours être spécifié.

Définition de l'authentification

L'utilitaire ne peut être appelé avec ces paramètres de démarrage que si une nouvelle installation est faite sans utiliser l'interface utilisateur.

Les deux paramètres doivent être indiqués.

Valeurs autorisées pour -T : "NO", "LOCAL", "LOCAL_REMOTE" et "PACKAGE"

Les paramètres "NO", "LOCAL" et "LOCAL_REMOTE" permettent de définir la méthode d'authentification. Le paramètre "PACKAGE" renvoie un fichier comportant la clé Company.

Valeur autorisée pour -K : chaîne de caractères quelconque (max. 32 caractères)

La clé Company est formée de cette chaîne de caractères.

Vous devez également indiquer une chaîne de caractères pour la clé Company si vous ne souhaitez pas utiliser d'authentification. Nous recommandons d'utiliser le nom du système AE comme clé Company.

Veuillez noter que l'utilisation de ce paramètre de démarrage génère une erreur lorsque les données initiales sont chargées pour la première fois ! Exécutez d'abord l'utilitaire pour créer un schéma de base de données et redémarrez-le ensuite pour définir l'authentification.
Par exemple : 

Première étape : java -jar ucybdbld -B -X/uc4/9.00A/Utility/db/general/9.00A/UC_UPD.TXT
Deuxième étape : java -jar ucybdbld -B -TNO -Kabc

Une autre alternative consiste à utiliser l'interface graphique.

Attention : la chaîne de caractères doit être incluse entre guillemets simples si elle contient des caractères spéciaux. Pour utiliser des guillemets simples à l'intérieur de la chaîne de caractères, précédez-les de guillemets simples supplémentaires (sous Windows) ou d'une barre oblique inversée "\" (sous Unix).

Exemples :

Le fichier UC_DATA.TXT est chargé dans le Client 11 ce qui a pour effet de remplacer les objets existants.

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

La méthode d'authentification "Serveur et Agent" doit être définie dans le système AE.

UCYBDBld -B -TLOCAL_REMOTE -KUC4PROD

Utility for database reorganization
UCYBDBRE.JAR

-V

Prints the Automation Engine version and hotfix number in the following format:

"UCYBDBre version Automation Engine version plus hotfix number"

-VPath and file name

Prints the Automation Engine version and hotfix number to the specified file in the following format:

"UCYBDBre version Automation Engine version plus hotfix number"

-IFile name

The path and the name of the INI file.

-LLanguage

Language

Allowed values: "D", "E", "F"
"D" = German (Deutsch), "E" = English, "F" = French

The language that is specified in the INI file is used if you do not specify this parameter.

-B

Batch mode.

-Smmmm

The number of the client that should be reorganized.

This client must include a User object for the user who starts this utility in batch mode.

For example: There must be the User object "SMITH/department name for the OS user Smith. Note that no other User object must start with "SMITH" (for example, SMITH/AE and SMITH/TEST is not possible).

-Dmmmm

The number of the client that should be reorganized (only Windows).

This client must include a User object for the user who starts this utility in batch mode.

For example: There must be the User object "SMITH/AE" for the OS user SMITH of the domain AE.

Examples:

Client 98 is reorganized.

UCYBDBre -B -S0098

Utility for defining queries
UCYBDBRT.EXE

-Cmmmm

The client number for processing.

Overwrites the client specified in the query definition.

-XPath and file name

The path and the name of the XML file.

-IPath and file name

The path and the name of the INI file.

-LLanguage

Language

Allowed values: "D", "E", "F"
"D" = German, "E" = English, "F" = French

-Ryyyymmdd[hhmm]

The reference date for the analysis of statistics and forecasts.

Overwrites the query definition.

Note that the entries of the AE database are stored in UTC. Therefore, Automic recommends using this time zone also for specifying the reference time.

-S

This returns the number of output lines.

-OPath and file name

The path and the name of the output file.

-TFile type

The type of the output file.

Allowed values: "CSV" and "HTML"

For example:

The analysis defined in the file jobtop10.d.xml is created for client 100.

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

Utility for  creating a revision report
UCYBDBRR.EXE

-V

Prints the Automation Engine version and hotfix number in the following format:

"UCYBDBRR version Automation Engine version plus hotfix number"

-VPath and file name

Prints the Automation Engine version and hotfix number to the specified file in the following format:

"UCYBDBRR version Automation Engine version plus hotfix number"

-IPath and file name

The path and the name of the INI file.

-LLanguage

Language

Allowed values: "D", "E", "F"
"D" = German (Deutsch), "E" = English, "F" = French

The language that is specified in the INI file is used if you do not specify this parameter.

-B

Batch mode.

-Cmmmm

The client number for processing.

-OPath and file name

The path and the name of the revision report.

By default, the report is stored as UCYBDBRRoutput.txt in the utility folder.

-FType1,Type2,...

This handles the required contents of the auditing report. Indicate your preferred content types separated by commas.

Allowed values:

"ACCESS" - Unauthorized access
"CANCEL" - Aborts tasks
"CREATE" - Creates new objects
"DELETE" - Deletes objects
"IMPORT" - Imports objects
"MOVE" - Moves objects
"OBJ_MOD" - Object modifications
"RENAME" - Renames objects
"RESTART" - Restarts tasks
"RESTORE" - Restores objects
"RUN_MOD" - Modifies at runtime
"START" - Starts tasks
"TRNSPRT" -Transports objects
"USER" - Successful user logons and logoffs

The utility outputs all contents to the revision report if this parameter is omitted or if -F* is used.

-D1yyyymmddhhmmss

The start date and time for logging.

Note that by default, the selection is not limited by a start time. Automic strongly recommends specifying a start time, as otherwise the Revision Report becomes very voluminous.

The client's time zone is used. If there is no time zone specification, the time zone of system client 0000 is used. If there is also no time zone specification, UTC is used.

-D2yyyymmddhhmmss

The end date and the time for logging.

Default value: current date and time

The client's time zone is used. If there is no time zone specification, the time zone of system client 0000 is used. If there is also no time zone specification, UTC is used.

All modification data is written to the report if the two time parameters are not used. The filters -F and -X are taken into account.

-A

Archive flags are set when you use this parameter It is closely connected to the parameter -X.

Note that the start of tasks (see start parameter -FSTART) is retrieved from the statistical records. Therefore, the utility cannot set archive flags for these data records.

-X

You can use this parameter to have only modification entries that have never been output by the utility before (for example, because they have no archive flag) written to the report.

Examples:

All revision information of client 1 between 01.05 00:00 and the current date are output to a report.

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

All start and restart points between 01.10. 08:00 and 01.10. 12:00 are output in a report.

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

Utilitaire pour le déchargement de la base de données UCYBDBUN.JAR

-V

Affiche la version d'Automation Engine et le numéro de correctif, au format suivant :

"UCYBDBun version Automation Engineversion plus numéro de correctif"

-VChemin et nom de fichier

Affiche la version Automation Engine, y compris le numéro de correctif, au format suivant :

"UCYBDBun version Automation Engineversion plus numéro de correctif"

-Inom de fichier

Chemin et nom du fichier INI

-LLangue

Langue

Valeurs autorisées : "D", "E", "F"
"D" = allemand, "E" = anglais, "F" = français

Si le paramètre n'est pas indiqué, le langage défini dans le fichier INI est utilisé.

-Bmode

Mode batch et de traitement.

Sur l'ensemble du système :
"NORMAL" = toutes les données de toutes les tables de la base de données sont déchargées.
"INITIAL" = Les données sont prises du client 0. Toutfois, le client 0 n'est pas complètement déchargé, seulement les données initiales, par exemple XREQs.
"DEFAULT" = Les données par défaut du système sont déchargées, c'est-à-dire le client 0, l'utilisateur initial et le groupe d'utilisateurs
"REPAIR" : la structure des dossiers de l'exploreur est vérifiée et corrigée si besoin.

Sur l'ensemble du système AE et selon les Clients :
"REORG" = la base de données est réorganisée.
"TRANSPORT" = le conteneur Transport est déchargé.
"TRANSPORTALL" = tous les objets sont transportés.
"RESETARCHIVE" = les indicateurs d'archivage sont réinitialisés (AE DB Archive).
"RESETREORG" = les indicateurs de suppression sont réinitialisés (AE DB Reorg).

-D

Lorsque vous utilisez ce paramètre de démarrage, tous les objets sont supprimés après le déchargement du conteneur Transport.

-Cmmmm

Numéro du Client pour le déchargement du conteneur Transport.

Si vous n'indiquez aucun Client, le déchargement est effectué pour tous les Clients.

Si dans le fichier INI, le paramètre suppress_output= est défini sur la valeur "1", vous pouvez également utiliser le paramètre -C pour réorganiser les Clients individuellement.

Le déchargement de données du Client 0 n'est pas possible. Si -C0 est malgré tout saisi, tous les Clients, y compris les Clients système, sont utilisés pour un processus d'export. 

-Xnom de fichier

Nom du fichier accueillant les données à décharger.

Si ce paramètre n'est pas spécifié, l'utilitaire utilise le nom et le chemin du fichier défini dans le fichier INI (OUTPUT=).

Ce paramètre ne peut pas être utilisé en relation avec -BREORG, étant donné que ces fichiers spécifiques sont soumis à une convention donnée d'affectation des noms.

Exemples :

La base de données AE est réorganisée.

UCYBDBun -BREORG

Le Client 100 est réorganisé. L'utilitaire peut exécuter cet appel, étant donné que dans son fichier INI, le paramètre suppress_output=1 est défini.

UCYBDBun -BREORG -C0100

Le conteneur de transport du client 11 est déchargé et l'utilitaire utilise le chemin et le nom de fichier spécifiés dans la section OUTPUT= du fichier INI de l'utilitaire. Le conteneur Transport est ensuite vidé.

UCYBDBun -BTRANSPORT -D -C0011

Avec le message U0021148, l'utilitaire vous a averti d'une erreur dans la structure des dossiers d'un Client. La fonction de correction est donc exécutée.

UCYBDBun -BREPAIR

Utility for  combining log and trace files UCYBLGMX

-V

Outputs the Automation Engine version including the hotfix number in the following format:

"UCYBLGMX version Automation Engine version plus hotfix number"

-VPath and file name

Prints the Automation Engine version and hotfix number to the specified file in the following format:

"UCYBLGMX version Automation Engine version plus hotfix number"

-B

Batch mode

-LPaths and names of log and trace file

The log files and the trace files that should be integrated in a target file.

The files can be specified in two ways:

"Path file1, file2, file3"

The path that is used for the first file is also used for the subsequent files.

"Path and file1, path and file2, path and file3"

You can also indicate the path for each individual file.

The wildcard character "*" can be used in file names.

The folder from which the utility is called (working directory) is used if no path has been specified.

-FPath and name of the target file

The path and the name of the target file.

The path can be omitted if the target file has been stored in the same folder as the utility.

Existing files of the same name are overwritten.

For example:

Log files with the prefix "server" are combined in the target file uc4.txt.

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