Agent de base de données

Nom de l'agent

Le nom de l'agent peut contenir jusqu'à 32 caractères. Les caractères suivants sont autorisés : "A-Z", "0-9", "_", ".", "$", "@", "-" et "#".

L'utilisation du tiret "-" est uniquement possible dans le nom des Agents ! Ce caractère n'est pas autorisé dans le nom des autres objets.

Nom du système AE.

Cette entrée doit être identique à l'entrée dans le fichier INI du Automation Engine.

Langue dans laquelle le logging est exécuté. Indication de la langue primaire et secondaire.

Valeurs autorisées : "E", "D", "F"
Défaut : "E,D" (langue primaire anglais, langue secondaire allemand)

S'il n'existe pas de message dans la langue primaire, un message est recherché dans la langue secondaire.

Chemin et nom de fichier du fichier log.

Les caractères numériques servent de caractère de remplacement pour une numérotation croissante. Au démarrage de l'agent, les fichiers log sont renommés, le fichier log le plus récent porte toujours le numéro "00".

LogMaxSize=

Taille maximale du fichier log

Si le fichier log atteint la taille spécifiée ici, un nouveau fichier est créé.

Valeur par défaut : 10 Mo

Si vous définissez une valeur de "0", la valeur par défaut sera utilisée

Vous pouvez utiliser les préfixes suivants avec cette valeur :
k...kilo, M...mega, G...giga

Exemples : 100k correspond à 100 kilobytes, 20M à 20 megabytes and 1G à 1 gigabyte

L'agent lit LogMaxSize, si une valeur non nulle est définie, la valeur est utilisée. Si LogMaxSize n'existe pas ou si elle est nulle, l'agent utilise le paramètre max_logging_kb.

Taille maximale du fichier log

Si le fichier log atteint la taille spécifiée ici, un nouveau fichier est créé.

Valeur par défaut : 1 000 Ko

L'agent lit LogMaxSize, si une valeur non nulle est définie, la valeur est utilisée. Si LogMaxSize n'existe pas ou si elle est nulle, l'agent utilise le paramètre max_logging_kb.

log_to_file=

Création de fichiers log

Valeurs autorisées : "0", "1" (valeur par défaut)

"0" : aucun fichier log n'est créé.
"1" : des fichiers log sont créés.

Le contenu du logging est toujours envoyé à Automation Engine, indépendamment de ce paramètre. Vous pouvez l'afficher à partir de la Supervision Système.

helplib=

Nom du fichier des messages.

Chemin et nom du fichier contenant le package d'authentification (Clé Société).

Le paramètre doit être indiqué lorsque vous utilisez la méthode d'authentification "Serveur" ou "Serveur et Agent". Si la Clé Société est introuvable, la connexion échoue.

L'Agent lit le fichier au démarrage et enregistre les informations du fichier que vous indiquez dans le paramètre KeyStore=. Ensuite, il supprime le premier.

Le chemin et le nom du fichier contenant les informations relatives au package d’authentification (voir le paramètre InitialPackage=).

Si le nom du fichier et/ou le chemin ne sont pas indiqués, le système utilise le nom (fichier d’extension *.kstr) ou le chemin du fichier INI de l’agent. Si vous saisissez un nom de fichier, l’extension .kstr n’est pas automatiquement ajoutée.

Le fichier de certificat est créé lorsque l’agent démarre pour la première fois. Le fichier ne doit ensuite pas être supprimé, renommé ni déplacé. Quelle que soit la méthode d’authentification utilisée, toute tentative de connexion échouera si l'agent ne trouve pas ce fichier au démarrage. Dans ce cas, vous devez ouvrir le menu "Renouveler la clé de transfert" dans la Supervision système de l'agent concerné.

Les Agents Java (SAP, RA, base de données et JMX) exécutés sous UNIX créent le fichier de certificat avec l'autorisation "-rw-r--r—". D'autres utilisateurs du système d'Exploitation peuvent ainsi éventuellement accéder à ce fichier !

[TRACE]

Chemin et nom du fichier de trace.

Les caractères numériques servent de caractère de remplacement pour une numérotation croissante. Lors du démarrage d'une trace, les fichiers de trace sont renommés de telle manière que le fichier de trace actuel ait toujours le numéro "00".

Nombre des fichiers de trace sauvegardés.

TraceMaxSize=

Taille maximale du fichier de trace

Si le fichier atteint la taille spécifiée ici, un nouveau fichier de trace est créé.

Valeur par défaut : 10 Mo

Si vous définissez une valeur de "0", la valeur par défaut sera utilisée

Vous pouvez utiliser les préfixes suivants avec cette valeur :
k...kilo, M...mega, G...giga

Exemples : 100k correspond à 100 kilobytes, 20M à 20 megabytes and 1G à 1 gigabyte

tcp/ip=

Indicateurs de trace de l'agent.

Valeurs autorisées : "0" (valeur par défaut) à "9"

Les indicateurs de trace ne doivent être définis qu'après accord définitif du support !

bindaddr=

Adresse IP ou nom d'hôte pour la connexion au processus de communication.

Utilisez ce paramètre si la connexion doit se faire via une adresse IP donnée (par exemple si l'ordinateur possède plus d'une carte réseau).

connect=

Intervalle de temps en secondes durant lequel l'agent tente d'établir une connexion à Automation Engine. Concerne l'établissement d'une connexion lors d'un redémarrage ou après une perte de connexion.

Valeur par défaut : 60 secondes

Ce paramètre est valide uniquement jusqu'à la première connexion réussie de l'agent au système AE. Ensuite, le paramètre RECONNECT_TIME de la caractéristique de l'hôte est utilisé.

cp=

Adresse du processus de communication du serveur AE auquel l'agent doit se connecter.

Formats autorisés :
nom DNS :numéro de port
adresse TCP/IP :numéro de port

[ORACLE]

enable_output=

Transfert des résultats provenant des procédures stockées.

Valeurs autorisées : "0" et "1" (valeur par défaut)

"0" : le résultat n'est pas écrit dans le rapport du job.
"1" : l'agent écrit les résultats dans le rapport du job.

buffer_size=

Taille du cache en octets pour les résultats devant être écrits dans le rapport de job.

Valeur par défaut : 8000

Définit la valeur que l'agent retourne en cas d'instruction SELECT dans la colonne MACHINE de la vue V$SESSION.

La colonne MACHINE est définie comme VARCHAR2(64). Lorsqu'une valeur plus courte est souhaitée, elle peut être définie avec ce paramètre.

Ce paramètre est pertinent uniquement en cas d'utilisation de l'agent Avaloq.

[SQL]

connect=

Intervalle de temps en secondes durant lequel le Job tente d'établir une connexion à la base de données.

retention_time=

Nombre de secondes après lequel une connexion à la base de données non utilisée doit être fermée.

type=

Type de base de données

Valeurs autorisées : "MSSQL", "ORACLE", "DB2", "MYSQL", "INFORMIX", "INGRES", "HANA" and "SYBASE", "POSTGRESQL", "EXASOL"

Nombre de tentatives de connexion à la base de données

L'agent tente de se connecter à la base de données aussi souvent qu'indiqué dans ce paramètre. Si la connexion à la base de données n'a pas pu être établie après la nième tentative, le Job se termine avec le statut ENDED_NOT_OK.

Si ce paramètre n'est pas spécifié dans le fichier INI, l'agent tente toujours de se reconnecter à la base de données. Le Job reste actif tant que la base de données est accessible ou tant qu'il n'est pas interrompu.

Affichage des lignes vides dans le rapport après la sortie de tables

Valeurs autorisées : "0" et "1" (valeur par défaut)

"0" : l'agent n'ajoute pas de ligne vide après un tableau.
"1" - Une ligne vide est ajoutée après chaque sortie de table.

Méthode de connexion à la base de données Oracle

Valeurs autorisées : "0" (valeur par défaut) et "1"

"0" : l'agent ne peut se connecter qu'à une instance de base de données Oracle. L'objet Job contient les données de connexion correspondantes.
"1" : l'agent peut se connecter aux nœuds Oracle RAC. Le fichier Oracle "tnsnames.ora" contient les données de connexion correspondantes.

L'utilisateur Windows sous lequel l'agent a démarré est utilisé pour la connexion à la base de données MS SQL.

Valeurs autorisées : "0" (valeur par défaut), "1"
"0" - Authentification du serveur SQL : Les données Login pour la connexion à la base de données sont fournies par l'objet Login du Job de base de données.
"1" - Windows Authentication : Utilisation du Login Windows de l'utilisateur du système d'exploitation sous lequel est exécuté l'agent.

Prérequis :

• Utilisation d'une base de données MS SQL Server (type=MSSQL)
• L'agent base de données s'exécute sur un système d'exploitation Windows
• UC_HOSTCHAR_DEFAULT : ANONYMOUS_JOB = "Y"

Lors de l'installation du pilote JDBC, il faut également copier le fichier "sqljdbc_auth.dll" dans le répertoire BIN de l'agent de base de données. L'architecture de ce fichier doit ainsi correspondre à chaque machine virtuelle Java utilisée. Par exemple : Si l'agent est démarré avec une JVM avec une architecture x64, la DLL doit être également un fichier x64.

Dans les jobs de base de données, vous devez spécifier un objet Login contenant une entrée adaptée à l'agent correspondant même si vous utilisez l'authentification Windows. L'utilisateur et le mot de passe dans l'objet Login ne sont ni utilisés, ni vérifiés.

[VARIABLES]

Cette section inclut des variables d'agent contenants des informations et des paramètres pour l'agent.

[CP_LIST]

Liste des processus de communication

La liste est créée au démarrage de l'agent et étendue quand que de nouveaux processus de communication sont activés. Vous trouverez de plus amples informations sur l'établissement de connexion au chapitre Fonctionnement en mode multi-serveur.

La liste ne contient aucune entrée pour le processus de communication qui est défini dans le paramètre cp= (section [TCP/IP]).

Format :
numéro de port=nom DNS
ou
numéro de port=adresse TCP/IP