Agent Windows

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

Si vous ne saisissez pas de paramètre, le nom d'hôte est automatiquement utilisé. Les minuscules sont ainsi converties en majuscules.

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.

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

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

Voir la description des paramètres ANONYMOUS_FT ou ANONYMOUS_JOB de la variable UC_HOSTCHAR_DEFAULT

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.

Les caractères xx du nom de fichier sont des caractères de remplacement. Ils représentent le code à deux caractères de la variante Windows en question. Rubriques connexes : Terminologie.

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 ; de cette manière, le fichier log le plus récent porte toujours le numéro "00".

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

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

Classe de licence qui correspond à la licence acquise, au matériel et logiciel déployés.

Valeurs autorisées : "1" à "9", "S", "V"

"1" à "9" = classe de licence de l'Agent.
"S" = Agent utilisé pour les Tâches d'administration sur le Serveur.
"V" = classe de licence virtuelle pour l'Agent.

Attention : la fin du fichier doit être indiquée sans point !

Valeurs autorisées : "INCL", "EXCL"

"INCL" = l'accès doit être autorisé pour chaque Utilisateur sous [USERID].
"EXCL" = les Utilisateurs indiqués sous [USERID] sont interdits. Des Jobs peuvent être démarrés avec tous les autres Utilisateurs.

useJobObject=

Configuration spécifiant si les Jobs sont démarrés dans un objet Job Windows. La valeur entrée ici est utilisée par défaut pour tous les Jobs sous Windows. Il est de plus possible de procéder au paramétrage dans l'onglet Job qui est alors valide pour ce Job.

Valeurs autorisées : "0" et "1"

"0" - L'objet Job Windows n'est pas utilisé.
"1" - L'objet Job Windows est utilisé. De plus amples informations sont disponibles sur le Job et ses sous-Jobs. Un des autres avantages réside dans de meilleures possibilités de reprise. Attention : le Job est terminé uniquement lorsque tous les sous-Jobs sont terminés.

HomeDirCache=

Ce paramètre vous permet d'influencer l'enregistrement du répertoire de base de l'utilisateur connecté.

Indiquez une durée en minutes durant laquelle l'Agent doit enregistrer la désignation du répertoire de base. Cela améliore la performance. Lorsque vous spécifiez "0", ces informations ne sont pas sauvegardées.

Valeur par défaut : 10 minutes

Attention : une modification du répertoire de base n'entre en vigueur qu'après la durée entrée ici !

ft_temp_file=

Création de fichiers temporaires lors du Transfert de Fichier

Valeurs autorisées : "yes" (valeur par défaut) et "no"

"yes" : le fichier est d'abord nommé avec un nom commençant par la lettre "T" suivie du RunID converti en lettres. Lors d'un nouveau protocole de Fichier de Transfert, un ID de fichier est également attaché afin de conserver un nom de fichier univoque dans la mesure où il n'y a qu'un seul RunID. Il n'est renommé qu'après le transfert réussi des fichiers.
"no" : dès le début du Transfert de Fichier, l'Agent assigne au fichier le nom valide.

Vérification de l'espace disque avant l'exécution du Transfert de Fichier

Valeurs autorisées :
"y" (valeur par défaut) - Le système vérifie si l'espace disque mis à disposition est suffisant pour les fichiers à transférer. Le Transfert de Fichiers est uniquement démarré si l'espace est suffisant. Sinon, le Transfert de Fichier s'interrompt et affiche un message approprié.
"n" - pas de vérification.

Sur les lecteurs réseau, il se peut qu'un résultat erroné se produise.

Utilisation de l'algorithme de Nagle pour les transferts de Transfert de Fichier ou pour tous les autres Sockets des Agents.

Valeurs autorisées : "yes" (valeur par défaut) et "no"

"no" - Activation de l'algorithme de Nagle
"yes" - le processus n'est pas employé

Grâce à l'activation de l'algorithme de Nagle, la performance de Transfert de Fichier peut être améliorée. Ceci est principalement remarquable lorsque de nombreux petits fichiers sont transférés.

L'Agent BS2000 utilise toujours l'algorithme de Nagle et ne possède d'ailleurs pas ce paramètre INI.

Ce paramètre ne doit être défini qu'après accord définitif du support !

Limite de temps en secondes pour la recherche de fichiers des Evènements du système de Fichiers

Si la limite de temps indiquée est atteinte, la recherche de fichiers de l'exécution actuelle de l'évènement est annulée.

Si le paramètre est défini sur "0" (valeur par défaut) ou "-1", il n'y aucune limite de temps.

Le paramètre est important pour les Evènements du système de Fichiers avec les paramètres FILE_SIZE, FILE_STABLE, FILE_CHANGED.

Niveau maximal de sous-répertoires pour les Evènements du système de Fichiers

Ce paramètre vous permet de définir l'étendue de la recherche de la structure du répertoire lors de la recherche de fichiers des Evènements du système de fichiers. Le niveau maximal de sous-répertoires, en partant du répertoire de recherche, doit alors être indiqué.

Une restriction du niveau de répertoires peut permettre d'améliorer la performance des Evènements du système de fichiers, en particulier pour une structure de dossiers profondément imbriquée avec de nombreux fichiers.

Valeurs autorisées :
"0" (valeur par défaut) = aucune restriction
"1" = Les fichiers sont recherchés uniquement dans le répertoire de recherche, les sous-répertoires ne sont pas pris en compte.
"2" = Répertoire de recherche et un niveau de répertoires vers le Bas
"3" = Répertoire de recherche plus deux niveaux de sous-répertoires
, etc.

Le paramètre est important pour les Evènements du système de Fichiers avec les paramètres FILE_SIZE, FILE_STABLE, FILE_CHANGED.

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

[STATUS_CHECK]

time=

Cycle de chronométrage interne pour vérifier si le Job est déjà terminé, si ce dernier fonctionne dans un objet Job Windows.

Valeur par défaut : 1 seconde

Dans cet intervalle, le tableau interne des Jobs de l'Agent est exécuté. La réalisation d'une vérification finale pour le Job dépend de la durée de ce dernier. La vérification est effectuée au cours de l'exécution du Job à des intervalles croissants (doublement de la valeur "time"), mais ne dépassant cependant jamais la valeur enregistrée dans la caractéristique de l'hôte JOB_CHECKINTERVAL pour l'Agent.

Par ex. : time=1, JOB_CHECKINTERVAL=60
L'exécution du tableau des Jobs est effectuée chaque seconde
Vérification du statut toutes les 1 s, 2 s, 4 s,..., 60 s, 60 s....

[USERID]

Indication des utilisateurs Windows autorisés au format :
Nom d'utilisateur/Domaine=START

Indication des utilisateurs Windows interdits au format :
Nom d'utilisateur/Domaine=NO_START

[VARIABLES]

Dans cette section se trouvent des Variables d'Agent contenant des informations et des paramètres pour l'Agent.

[TRACE]

Les caractères xx du nom de fichier sont des caractères de remplacement. Ils représentent le code à deux caractères de la variante Windows en question. Rubriques connexes : Terminologie

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

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 !

Ce numéro de port est utilisé par d'autres Agents et par l'Agent Job pour entrer en contact avec l'Agent.

bindaddr=

Adresse IP ou nom d'hôte pour la connexion à l'Agent.

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

Sinon, vous pouvez aussi indiquer l'adresse IP ou le nom de l'hôte avec port= (format : port=adresse IP:port ou. nom DNS:port). L'indication de bindaddr= est ainsi ignorée.

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" (valeur par défaut), "1"

"0" - aucun socket de liste n'est créé.
"1" - un socket de liste supplémentaire est créé sur l'hôte local.

connect=

Intervalle de temps en secondes durant lequel l'Agent tente d'établir une connexion aux Serveurs AE. 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é.

report=

Intervalle de temps en secondes durant lequel l'Agent envoie le logging à Automation Engine.

Valeur par défaut : 60 secondes

Longueur maximale des messages en octets qui accepte l'Agent.

Valeur par défaut : 500 000

cp=

Adresse du processus de communication du système AE auquel l'Agent doit se connecter.

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

SendBufferSize=

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

Valeur par défaut : 1048576 octets

RecvBufferSize=

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

Valeur par défaut : 1048576 octets

[HOSTS]

Attribution du nom d'un Agent en fonction de son adresse (Nom DNS ou adresse TCP/IP), lorsque celle-ci n'est pas accessible directement par l'Agent avec l'adresse connue dans le serveur. Plusieurs attributions sont indiquées en fonction de lignes; il n'y a aucune restriction pour le nombre.

Le AutomationEngine envoie à un Agent l'adresse interne de l'Agent partenaire lors du Transfert de Fichier. Celui-ci la remplace par l'adresse externe définie ici.

Ce paramètre n'est alors uniquement utile lorsque des Transferts de Fichiers sont exécutés avec des Agents qui ne peuvent pas créer entre eux de connexion TCP/IP directe grâce à l'adresse obtenue du serveur. Cette condition peut par exemple se produire lorsque les Agents impliqués dans le Transfert de Fichier se trouvent dans différents réseaux ou si un pare-feu est utilisé.

[CP_LIST]

Liste des processus de communication

La liste est établie au démarrage de l'Agent et étendue dès lors 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]).

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