Structure du fichier INI de l'Automation Engine

Longueur maximale 8 caractères. Sont autorisés les majuscules de A à Z, les chiffres et "_".

Le nom du système ne doit pas contenir le caractère "_" si vous utilisez l'agent z/OS avec la technique SMF. Par défaut, les Includes de job convertissent "_" en "#". Si vous désirez utiliser "_", saisissez le nom du système dans le moniteur d'événement en le remplaçant par "#".

Valeurs autorisées : "E", "D", "F"
Valeur par 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.

$$ est remplacé par le type de processus serveur (WP ou CP)
* est remplacé par le numéro du processus à 3 chiffres
## est remplacé par 00 après que les numéros correspondants des fichiers log existants aient été incrémentés de 1 au démarrage. Pendant le démarrage d'un processus serveur, les fichiers log prennent un nom de fichier temporaire jusqu'à ce que le numéro de processus ait été déterminé.

Les règles suivantes seront applicables pour la dénomination des fichiers log si un agent de base de données qui accède à ce fichier INI est utilisé pour les variables (section [DB_SERVICE] ) :
$$ est remplacé par "DB_SERVICE".
* ne possède aucune fonctionnalité et est ignoré. Les noms de fichier log ne comportent aucun caractère à cet emplacement.
## est remplacé par 00 au démarrage de l'agent, les numéros des anciens fichiers log sont incréentés de un.

Pour l'indication d'un chemin relatif, le système utilise le répertoire d'installation de l'agent quand il crée le fichier log de l'agent de la base de données.

Valeurs autorisées : "ALL" (valeur par défaut), "NONE", "CONTROLS"

"ALL" : l'ensemble du fichier des messages est stocké dans la RAM.
"NONE" : le fichier des messages est toujours lu sur le disque dur.
"CONTROLS" : toutes les chaînes de caractères en langues étrangères nécessaires à l'affichage d'un programme de dialogue sont stockées dans la RAM (ne concerne pas Automation Engine ).

Mode de démarrage du système AE.

Valeurs autorisées : "NORMAL" (valeur par défaut) et "COLD"

"NORMAL" : démarrage normal d'AE
"COLD" : démarrage à froid d'AE. Toutes les queues des tâches sont vidées.

Ce paramètre peut également être contrôlé avec le dialogue du gestionnaire de services. Dans ce cas-là, les valeurs du fichier INI sont ignorées.

snmp=

Connexion SNMP.

Valeur autorisée : "0", "1", "2"
"0" : pas de connexion SNMP
"1" : la connexion SNMP est active
"2" : la connexion SNMP est active. Les interruptions SNMP sont de plus journalisées dans l'affichage d'événements de Windows.

Un événement est généré dans le journal des applications de l'observateur des événements Windows (en plus de l'interruption) si Automation Engine est interrompu (interruption 3410). Cette entrée n'est écrite dans le log d'application que si snmp=2 a été défini.

nodename=

Description de l'environnement du processus de dialogue.

Valeur par défaut : UC4_1

PrimaryMode=

Mode pour le processus de travail primaire (PWP).
Le processus de travail primaire sert au traitement de messages spéciaux. Ce paramètre vous permet de contrôler s'il doit également fonctionner comme processus de travail.

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

"1" : le PWP traite uniquement les messages qui lui sont destinés. Cela n'est possible que si un autre processus de travail est actif.
"0" : les messages que les processus de travail peuvent traiter sont également traités par le PWP.

exception=

Contrôle les contenus valides dans les messages internes

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

"0" : la vérification interne des messages a été désactivée.
"1" : les messages sont vérifiés et mis en quarantaine si nécessaire.

Si vous sélectionnez cette option, les messages qui ont interrompu un processus serveur sont interceptés. Votre système AE est ainsi protégé car ces messages n'ont pas d'effet sur vos processus serveur.

Notez que ce paramètre peut nuire aux performances d'UNIX.

SystemStop=

Traitement des clients après le démarrage des processus serveur

Valeurs autorisées : "NORMAL" (valeur par défaut) et "YES".

"NORMAL" : le statut des clients reste inchangé.
"YES" : tous les clients sont arrêtés après le démarrage du processus serveur.

Notez que la valeur "YES" remplace les paramètres définis dans la clé STARTUP_ACTION de la variable UC_CLIENT_SETTINGS.

Ce paramètre peut également être contrôlé avec le dialogue du gestionnaire de services. Dans ce cas-là, la valeur spécifiée dans le fichier INI est ignorée.

[CPMsgTypes]

srvquery=

Optimisation de la performance lors de la connexion simultanée de nombreux agents (plusieurs milliers)

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

"0" : le processus de travail primaire traite les messages actifs des agents.
"1" : les processus de communication peuvent également traiter ces messages spécifiques, ils augmentent de la sorte la performance du système AE.

[CACHE]

$$ est remplacé par le type de processus serveur (WP ou CP)
* est remplacé par le numéro du processus à 3 chiffres
## est remplacé par 00 après que les numéros correspondants des fichiers trace existants aient été incrémentés de 1, au démarrage,.

tcp/ip=
database=
trc03=
srcall=
memio=
jcl=
memsv=
snmp=
zuxml=
cache=
trc11=
ucds=
xscript=
uc4global=
trc15=
trc16=

Les indicateurs de trace ne doivent être définis qu'en coopération étroire avec le support Automic.

bindaddr=

Adresse IP ou nom d'hôte pour la connexion aux processus serveur.

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

Tous les processus de travail, y compris le processus de travail primaire, doivent être liés à la même adresse IP.

Vous pouvez également spécifier l'adresse IP ou le nom d'hôte dans pwpport= et dans tous les paramètres de la section [PORTS] (format : pwpport=adresse IP:port ou nom DNS:port). Les spécifications de bindaddr= sont alors ignorées.

bindlocal=

Prise en compte de l'hôte local (127.0.0.1)

Ce paramètre doit être utilisé en relation avec bindaddr=.

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

"0" : aucun socket d'écoute n'est créé.
"1" : un socket d'écoute supplémentaire est créé sur l'hôte local.

report=

Intervalle de temps en secondes durant lequel Automation Engine écrit le logging dans la base de données.

Valeur par défaut : 20 secondes

Valeur par défaut : 120 secondes

Encryptage des transferts.

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

"0" : transfert non crypté.
"1" : les transferts sont cryptés.

Format : (nombre, période)
Valeur par défaut : (3,10)

Nombre : nombre maximal de tentatives pour obtenir un port libre de la liste des ports.
Période : temps d'attente en secondes entre les essais.

retrywaitpwp=

Ce paramètre est uniquement utilisé par les processus de travail. Ils essayent cycliquement de se connecter au port du processus de travail primaire lors du démarrage et en cas de perte de connexion.

Format : (nombre, période)
Valeur par défaut : (3,10)

Nombre : nombre maximal de tentatives pour obtenir un port libre de la liste des ports.
Période : temps d'attente en secondes entre les tentatives.

hostname=

Si vous utilisez ce paramètre, les interfaces utilisateur, le CallAPI et les agents reçoivent l'information des CP connus du système via leur nom d'hôte et leur port, et non via l'adresse IP et le port durant la phase de sélection CP, lorsque la connexion à l'Automation Engine a été établie. Cela permet de contourner les problèmes de NAT et de pare-feu.

Spécifiez nom d'hôte=*OWN si vous voulez que le système d'exploitation récupère le nom d'hôte sur lequel le CP est exécuté. 

alivetimeout=

Durée en secondes pendant laquelle le serveur AE.Nonstop attend un message du processus de travail primaire. Si cette durée est dépassée, le serveur AE.Nonstop devient le processus de travail primaire.

Valeur par défaut : 600 secondes

Faites attention quand vous modifiez ce paramètre. Le laps de temps choisi doit être suffisamment élevé car le processus de travail primaire est occupé pendant un certain temps si d'importantes transactions de base de données sont en cours et qu'il ne peut pas envoyer de sigaux de vie.

Numéro de port utilisé par Automation Engine pour connecter le sous-agent SNMP AE.

Assurez-vous que le même numéro de port est spécifié dans le fichier INI du sous-agent SNMP AE sous le paramètre stream_port=.

Intervalle de temps en secondes nécessaire au système pour rétablir la connexion au sous-agent SNMP AE après une perte de connexion.

Valeur par défaut : 500 secondes

Nombre maximum de requêtes de connexion dans la liste d'attente.

La requête est sauvegardée dans une liste d'attente, dans la période d'attente entre la réception de la requête d'un composant AE et la confirmation de la connexion. Ce paramètre peut être utilisé pour définir le nombre maximal de requêtes pouvant être sauvegardées dans la file simultanément.

Valeur par défaut : 2030

Longueur maximale des messages (en octets) qu'un CP (processus de communication du serveur) accèpte.

Valeur par défaut : 3 145 728 (3 Mo)

Ceci vérifie si la connexion TCP/IP avec un partenaire a été saisie dans la table MQSRV de la base de données AE et si l'adresse IP qui spécifiée dans la base de données correspond à l'adresse IP de cette connexion.
Le paramètre doit être désactivé si les ordinateurs utilisés possèdent plusieurs adresses IP.

Valeurs autorisées : "0" (valeur par défaut), "1"
"0" : la connexion TCP/IP et l'adresse IP ne sont pas vérifiées.
"1" : la requête est activée.

Nom de la zone réseau des processus serveur

Valeur par défaut : Nom du système AE

Cette valeur influence la sélection CP des composants comme les agents. For more detailed information about this parameter, see Net Areas in AE.

Notez que seuls les CP peuvent utiliser différentes zones réseau. Tous les WP d'un système AE doivent posséder la même définition NetArea.

The name of the net areas is shown in the System Overviewof the server processes.

Définit l'utilisation de l'algorithme de Nagle pour les connexions de l'Automation Engine.

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

"0" : activation de l'algorithme de Nagle
"1" : cette procédure n'est pas utilisée

Ne définissez ce paramètre en étroite coopération avec le support Automic.

Intervalle de temps en secondes pendant lequel les signaux de vie sont envoyés pour conserver les connexions.

La valeur par défaut qui dépend de l'environnement système est utilisée si le paramètre n'est pas indiqué ou s'il est défini à 0.

Ne définissez ce paramètre en étroite coopération avec le support Automic.

Taille du cache TCP/IP pour les messages à envoyer (en octets).

La valeur par défaut qui dépend de l'environnement système est utilisée si le paramètre n'est pas indiqué ou s'il est défini à 0.

Ne définissez ce paramètre en étroite coopération avec le support Automic.

Taille du cache TCP/IP pour les messages à recevoir (en octets).

La valeur par défaut qui dépend de l'environnement système est utilisée si le paramètre n'est pas indiqué ou s'il est défini à 0.

Ne définissez ce paramètre en étroite coopération avec le support Automic.

[PORTS]

Le numéro de port au sein du système AE doit être unique, même si le système est réparti sur plusieurs machines.  

Attribution de processus de travail et de numéros de port.

Le numéro de port au sein du système AE doit être unique, même si le système est réparti sur plusieurs machines.

ODBCVAR - Zone de commande à huit chiffres pour contrôler les accès à la base de données.

1. Position= N - Ne pas utiliser le curseur du serveur.
1. Position= S - Utiliser le curseur du serveur (MS SQL Server 2000).
2. Position= N - Ne pas rétablir la connexion avec la base de données après 1000 essais.
2. Position= D - Déconnecter la base de données après 1000 essais (éventuellement en cas de problèmes de mémoire).
3. Position= N - Nom des champs comparés selon la casse (Oracle).
3. Position= J - Nom des champs non comparés selon la casse (Oracle).
4. Position= N - Non utilisé.
5. Position= N - Type de la connexion base de données : ODBC.
5. Position= I - type de connexion à la base de données : OCI/CLI.
6. Position= N - Accès à la base de données sans ID utilisateur.
6. Position= O - Accès à la base de données avec ID utilisateur.
7. Position= N - Compression désactivée.
7. Position= R - Compression activée.
8. Position = Type de syntaxe SQL; N - Serveur SQL MS.
8. Position = Type de syntaxe SQL; O - Oracle.
8. Position = Type de syntaxe SQL; D - DB2.

DSN - Nom d'alias de la connexion à la base de données.
UID - ID utilisateur pour l'accès à la base de données.
PWD - mot de passe pour l'accès à la base de données. Doit toujours (aussi "") être affiché crypté.See: Encoding passwords

Uniquement pour MS SQL Server 2005 :
Automic recommande d'utiliser l'option MARS_CONNECTION=Yes pour atteindre une performance optimale.

Par exemple :
(par manque de place, les paramètres de connexion ont été répartis sur deux lignes. Il faut bien entendu les écrire sur une seule ligne dans le fichier INI.)

SQLDRIVERCONNECT=ODBCVAR=NNNNNNRN,DSN=UC4;UID=uc4;
PWD=--1037B2E22BF022EBE2;Mars_Connection=Yes

Définissez la 1ère position du ODBCVAR à "S" si vous n'utilisez pas cette option.

 Notez que le client natif de SQL Server 2005 doit être utilisé si vous MARS est défini. Créez une nouvelle source de données ODBC en utilisant le client natif. MARS est une fonctionnalité nécessitant SQL Server 2005 du côté client et serveur.

Uniquement pour ORACLE :
Le paramétrage de la page de codes doit correspondre à celui de la base de données. Automic recommande d'utiliser la variable NLS_LANG ou le paramètre SP=.

Syntaxe:
SP=NLS_LANGUAGE=langue,NLS_TERRITORY=territoire,CODESET=jeu de caractères,RECONNECT=intervalle en minutes

RECONNECT est la période utilisée pour rétablir la connexion à la base de données. Ce paramètre est prioritaire même si un "D" a été spécifié en deuxième position de ODBCVAR (voir ci-dessus).

Par exemple :

(Par manque de place, les paramètres de connexion ont été répartis sur deux lignes. Il faut bien entendu les écrire sur une seule ligne dans le fichier INI.)

SQLDRIVERCONNECT=ODBCVAR=NNJNIORO,DSN=UC4;UID=uc4;PWD=--1037B2E22BF022EBE2;
SP=NLS_LANGUAGE=AMERICAN,NLS_TERRITORY=AMERICA,CODESET=WE8ISO8859P15

Rubriques connexes : Paramétrage de la base de données ORACLE

Cette section contient des paramètres spécifiques pour l'agent de la base de données qui démarre en mode de résolution de variables. Le Guide d'installation de l'agent décrit comment l'agent doit être démarré.

Le paramètre logging= peut être utilisé pour spécifier le chemin et le nom des fichiers log de l'agent et des processus serveur. Reportez-vous également aux notes spécifiques dans la section [GLOBAL].

Notez que ce fichier INI ne peut être utilisé que pour les agents de base de données. Copiez ce fichier de configuration pour utiliser plusieurs agents de base de données pour les variables.

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

Nom de l'agent de base de données qui doit être utilisé pour la résolution des variables

Le nom de la machine agent (nom d'hôte) est utilisé si rien n'a été défini.

Le nom de l'agent est limité à 32 caractères. Les caractères suivants sont autorisés : A-Z, 0-9, $, @, _, -, .

Le trait d'union "-" peut être utilisé dans les noms d'agent dans le fichier de configuration pour des raisons de compatibilité avec les versions antérieures de Automation Engine. Le nom des nouveaux agents ne doit pas contenir de trait d'union.

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'en coopération étroire avec le support Automic.

Chemin et nom du fichier contenant le package d'authentification. 

L'agent lit ce fichier au démarrage et enregistre les informations qu'il contient dans le fichier spécifié dans le paramètre KeyStore=. Ensuite, le fichier d'origine est supprimé.

Intervalle de temps en secondes durant lequel l'agent tente d'établir une connexion au 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. Afterwards, the parameter RECONNECT_TIME can be used in the host characteristics.

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

Le nombre spécifié dans ce paramètre indique le nombre de tentatives de connexion de l'agent à la base de données. 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.

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

Database optimization, optimization means, that if you select data with a key, the db-service automatically optimizes the query to a new statement where the given key is part of the statement. If the query does not return any data or results in an error, the original query is executed.

Allowed values: "0", "1" (default value)

"0" - Database optimization off.
"1" - Database optimization on.