Cette variable est utilisée pour définir les configurations d'un ou plusieurs agents.
Pour les paramètres des transferts de fichiers, la colonne Protocole FT indique si les paramètres s'appliquent pour l'ancien et / ou le nouveau protocole.
La variable est fournie dans le client système 0000. Ses paramètres s'appliquent à l'ensemble du système AE et ne peuvent être modifiés que dans le client système 0000.
La variables des caractéristiques standard de l'hôte est nommée UC_HOSTCHAR_DEFAULT est fournie dans le dossier HOST_VARIABLES et s'applique à tous les agents. Si un agent utilise une configuration différente, vous pouvez créer vos propres variables dont le nom pourra comporter tout terme excepté DEFAULT.
Les agents sont assignés aux caractéristiques de l'hôte dans la variable UC_EX_HOSTCHAR.
Clé |
Valeur |
Redémarrage nécessaire |
Protocole FT | ||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ANONYMOUS_FE |
Influence l'utilisation des données de connexion pour l'exécution des jobs, des événements du système de fichiers et des transferts de fichier. Ce paramètre n'est pris en charge que pour les agents OS/400, z/OS, UNIX et Windows. La clé ANONYMOUS_FE n'est pas prise en charge sur les systèmes z/OS.
Valeurs autorisées : Y et N (par défaut). Notez qu'indépendamment des paramètres définis ici, le système Automation Engine vérifie toujours au début de l'exécution d'un objet, si un objet Login est disponible comportant une entrée pour la plate-forme concernée. S'il n'y a pas d'entrée correspondante, le job s'interrompt. Ce paramètre peut être utilisé pour définir si les données de connexion issues de l'objet Login doivent être utilisées pour exécuter des jobs, des événements du système de fichiers et des transferts de fichiers. Le comportement dépend également des paramètres définis dans le fichier INI de l'agent :
Les transferts de fichiers dépendent du paramètre de privilège suivant de l'objet utilisateur : Les événements du systèmes de fichiers dépendent du privilège correspondant : |
Agent | Ancien et nouveau | ||||||||||||||||||||||||||||||||||||||
APPLICATION_LOGIN |
Nom d'un objet Login. Les données de connexion de l'objet Login sont utilisées aux fins suivantes :
Valeur par défaut : ERP_LOGIN |
Agent |
|||||||||||||||||||||||||||||||||||||||
BACKUP_RETENTION_CHECK |
Heure à laquelle la durée de vie du dossier de sauvegarde est vérifiée. Tous les fichiers et répertoires plus anciens que la durée de vie définie dans BACKUP_RETENTION_LIFETIME seront supprimés. Le dossier de sauvegarde stocke les fichiers du rollback des fichiers des jobs et des transferts de fichiers. Vous pouvez définir le dossier de sauvegarde à l'aide de la variable d'agent UC_EX_PATH_BACKUP dans le fichier INI de l'agent. Dans l'onglet Rollback, définissez quels fichiers doivent être copiés dans le dossier de sauvegarde. La sauvegarde s'effectue automatiquement à chaque exécution de transfert de fichier ou du job. Concerne uniquement les agents Windows et UNIX. Valeurs autorisées : Heure valide au format HH:MM |
Agent | |||||||||||||||||||||||||||||||||||||||
BACKUP_RETENTION_LIFETIME |
Durée de vie en jours du contenu du dossier de sauvegarde Définit la durée de stockage des fichiers et répertoires dans le dossier de sauvegarde. Le système vérifie ce paramètre tous les jours à l'heure définie dans BACKUP_RETENTION_CHECK. Tous les fichiers / répertoires qui se trouvent dans le dossier de sauvegarde depuis plus longtemps que le nombre de jours défini sont supprimés. Concerne uniquement les agents Windows et UNIX. Valeurs autorisées : 0 à 99 |
Agent | |||||||||||||||||||||||||||||||||||||||
BLOCK_ON_LOST |
Cette entrée permet de définir l'action qu'un Workflow doit effectuer si un de ses jobs prend le statut ENDED_LOST. Valeurs autorisées : YES (par défaut) et NO YES : le Workflow est bloqué. |
Non |
|||||||||||||||||||||||||||||||||||||||
DISCONNECT_AFTER_FT |
Définit si la connexion entre les agents doit se terminer après un transfert de fichier. YES : la connexion est terminée après un transfert de fichier (valeur par défaut) Ce paramètre n'a d'effet que sur la connexion et n'empêche pas l'exécution du transfert de fichier. Le système vérifie toujours si une connexion vers l'agent cible existe AVANT le début du transfert de fichier. Une connexion est établie si elle n'est pas disponible. Dans l'agent UNIX 32 bits pour Sun Solaris, le nombre de descripteurs de fichiers (connexions et fichiers ouverts) est limité à 253 . Veuillez en tenir compte lors de l'exécution de jobs / transferts de fichier et lorsque le paramètre DISCONNECT_AFTER_FT est défini sur "NO". Dans ce cas, la valeur YES est recommandée. Ce paramètre n'est vérifié que si l'ancien protocole de transfert de fichier est utilisé.Dans le nouveau protocole, la connexion est toujours terminée automatiquement. |
Agent |
Ancien | ||||||||||||||||||||||||||||||||||||||
EVENT_CHECKINTERVAL |
Intervalle en secondes pendant lequel l'agent vérifie les conditions "FILE_CHANGED" et "FILE_STABLE" dans ses événements du système de fichiers. Valeurs autorisées : 60 à 100000 Si vous sélectionnez "FILE_CHANGED" ou "FILE_STABLE" dans un événement du système de fichier, cet intervalle est utilisé pour toutes les vérifications de conditions. L'intervalle sera automatiquement augmenté si la vérification de la condition dure plus longtemps que celui-ci. |
Agent | |||||||||||||||||||||||||||||||||||||||
EXECUTE_ON_ASSIGNMENT |
Utilisez ces clés pour démarrer un objet activable dans les situations suivantes : Au démarrage ou à l'arrêt d'un agent :
Pour les tâches sans terminaison définie :
Lors de la modification des droits client d'un agent :
Valeur par défaut : aucun objet n'est démarré. L'objet sera cherché et activé dans tous les clients dans lesquels l'agent possède une autorisation. Exception faite du client système 0000, dans lequel aucune activation d'objet n'est autorisée. Avec EXECUTE_ON_ASSIGNMENT, tous les clients dans lesquels une autorisation a été modifiée sont analysés. L'objet sera démarré sous l'utilisateur UC/UC du client système 0000. Pour cette raison, ne donnez aucune autorisation au niveau des objets. L'objet que vous définissez ici pour les agents doit attendre le temps défini dans RECONNECT_TIME, à l'aide de l'instruction de script :WAIT. Par la suite, vous pouvez utiliser SYS_HOST_ALIVE pour vérifier si l'agent s'est à nouveau connecté et agir en conséquence. Notez que EXECUTE_ON_START et EXECUTE_ON_END peuvent être utilisés par l'objet pour lire la variable de script &uc_ex_host dans le tampon de lecture. Cette variable contient le nom de l'agent et elle peut être utilisée dans le script de l'objet. Par exemple : :READ &uc_ex_host,, EXECUTE_ON_ASSIGNMENT peut être utilisée pour lire les variables suivantes :
|
Agent |
|||||||||||||||||||||||||||||||||||||||
FE_VERSION |
Définit la version de la fonction événement fichier du système AE, déterminant les capacités des agents systèmes. Valeurs autorisées : "1" ou "2" Valeur par défaut : "2" Afin d'exécuter un objet événement système de fichier dans un agent Unix sous un utilisateur différent de celui spécifié dans le Login, cette clé doit être définie à 2. |
||||||||||||||||||||||||||||||||||||||||
FT_ASYNC_QUIT_MAX, FT_ASYNC_QUIT_MIN, FT_ASYNC_QUIT_NUM |
Paramètres pour le transfert synchrone/asynchrone entre l'expéditeur et l'agent destinataire des transferts de fichier. Par défaut, le transfert est asynchrone. Transfert synchrone : les paquets de données ne sont envoyés que lorsqu'une confirmation (accusé de réception) est reçue pour les paquets envoyés précédemment. L'expéditeur et le destinataire ajustent leur vitesse de transmission. Un comportement synchrone est programmé lorsque le paramètre FT_ASYNC_QUIT_NUM est égal à FT_ASYNC_QUIT_MAX. Transfert asynchrone : les paquets de données sont envoyés même s'il reste des confirmations en attente pour les paquets envoyés. Cela permet un transfert plus rapide car par exemple un expéditeur plus rapide ou une connexion lente sont mieux exploités. Le cache TCP/IP de l'agent (paramètres du fichier INI : SendBufferSize= et RecvBufferSize= ) doit être augmenté en conséquence.
Plus la valeur de FT_ASYNC_QUIT_MIN est élevée, plus l'agent destinataire est libéré, lorsque FT_ASYNC_QUIT_MAX est atteint. Ces options ne sont valables que pour les agents OS/400, NSK, UNIX, Windows et z/OS. FT_ASYNC_QUIT_MAX FT_ASYNC_QUIT_MIN FT_ASYNC_QUIT_NUM Notez que la valeur du paramètre MIN ne doit pas dépasser celle du paramètre MAX. Par exemple : FT_ASYNC_QUIT_MIN / MAX / NUM: |
Non | Nouveau | ||||||||||||||||||||||||||||||||||||||
FT_COMPRESS |
Type de compression pour les transferts de fichiers. Valeurs autorisées : "NO" (valeur par défaut) et "NORMAL" |
Agent |
Ancien et nouveau | ||||||||||||||||||||||||||||||||||||||
FT_CONNECTION_TIMEOUT |
Durée en secondes après laquelle une connexion de transfert de fichier non utilisée entre deux agents est fermée automatiquement. Valeur par défaut : 300 secondes Automic recommande d'augmenter la valeur par défaut de ce paramètre (5 min) si vous transférez de très gros fichiers (> 3,8 Go) de NSK. Sinon la connexion risque de se couper prématurément. |
Agent | Nouveau | ||||||||||||||||||||||||||||||||||||||
FT_REPORT_TIME |
Intervalle de temps, en secondes, pendant lequel l'agent envoie des blocs de rapport. Valeur minimale : 1 |
Agent | Nouveau | ||||||||||||||||||||||||||||||||||||||
FT_RESTARTINFO_CHECK |
Heure UTC à laquelle la durée de vie des informations de reprise d'un transfert de fichier est vérifiée. La vérification a lieu tous les jours. Ces informations de reprise sont stockées localement sous forme de fichiers StatusStore (extension *.sts) dans le répertoire temp de l'agent local. Ces fichiers sont supprimés en fonction de la durée de vie paramétrée avec la clé FT_RESTARTINFO_LIFETIME. Valeur par défaut : 0:00:00 |
Agent | Nouveau | ||||||||||||||||||||||||||||||||||||||
FT_RESTARTINFO_LIFETIME |
Nombre de jours durant lesquels les informations de reprise des transferts de fichier restent enregistrées (durée de vie). Valeur minimale : 1 |
Agent | Nouveau | ||||||||||||||||||||||||||||||||||||||
FT_RESTARTINFO_INTERVAL |
Intervalle en secondes au cours duquel les agents enregistrent les points de reprise pendant un transfert de fichier. Valeur minimale : 1 |
Agent | Nouveau | ||||||||||||||||||||||||||||||||||||||
FT_STATUS_INTERVAL |
Intervalle en secondes au cours duquel l'agent envoie les informations de statut des transferts de fichier au serveur. Le statut des transferts de fichier est affiché dans la fenêtre de détails de la tâche. Valeur minimale : 1
|
Agent | Nouveau | ||||||||||||||||||||||||||||||||||||||
FT_USE_MD5 |
Utilisation du checksum MD5 pour vérifier les données transférées des transferts de fichier. Cette méthode permet aussi de garantir que les fichiers transférés correspondent aux fichiers source après une reprise de transfert de fichier. Pour des raisons de performance, le checksum MD5 n'est jamais calculé pour les fichiers inférieurs à 1 Mo. Ce comportement est toujours valable, peu importe les définitions effectuées dans ce paramètre. Valeurs autorisées : Y (par défaut) et N |
Agent | Nouveau | ||||||||||||||||||||||||||||||||||||||
JOB_CHECKINTERVAL |
L'exécution du job est vérifiée périodiquement par les agents. Vous définissez l'intervalle de temps de la vérification dans cette entrée. Valeur minimale : 1 Il n'existe pas de limite supérieure pour ce paramètre. La valeur par défaut est utilisée si 0 est défini. Vous pouvez réduire cet intervalle à moins de 60 secondes, si la vérification des statuts du job doit être effectuée à de courts intervalles. |
Agent |
|||||||||||||||||||||||||||||||||||||||
KEEP_ALIVE |
Intervalle de temps pour la vérification périodique d'Automation Engine. Valeurs autorisées : au delà de 60 secondes La valeur définie ici ne doit pas être inférieure à 60 secondes. Si non la valeur par défaut est utilisée. La valeur doit correspondre à des minutes entières, par exemple : 60, 120, 180 etc. Si elle ne correspond pas à une minute entière, le système arrondit à la minute suivante. Une valeur de 99 secondes deviendrait ainsi 120 secondes. Une valeur fixe de 60 secondes est toujours ajoutée à la valeur configurée. Le minimum réel est donc une valeur de 120 secondes. La supervision système affiche toujours la valeur qui a été définie en utilisant KEEP_ALIVE. (voir aussi : Supervision système) |
Agent |
|||||||||||||||||||||||||||||||||||||||
LOG_TO_DATABASE |
Enregistrement du log de l'agent dans la base de données AE. Valeurs autorisées : Y (par défaut) et N Y : l'agent envoie aussi à Automation Engine les messages qu'il écrit dans le fichier log. Celui-ci la met dans le rapport de l'objet agent. |
Agent | |||||||||||||||||||||||||||||||||||||||
MAX_FILE_COUNT |
Nombre maximal de fichiers récupérés dans les événements du système de fichiers. Valeurs autorisées : 0 à 100 000 0 : pas de limitation du nombre de fichiers à trouver Un fichier peut être trouvé plusieurs fois si des caractères génériques sont utilisés ou si la recherche est étendue aux sous-répertoires. Pour des raisons de performances, vous pouvez indiquer un nombre maximum de fichiers trouvés. Par exemple : 100 fichiers L'agent vérifie si la condition est remplie pour les 100 premiers fichiers trouvés et déclenche alors ou non le script. |
Agent | |||||||||||||||||||||||||||||||||||||||
MAX_REPORT_SIZE |
Nombre maximal de blocs de rapport devant être transférés dans la base de données AE. Valeurs autorisées : 1 à 10 000 La clé REPORT_BLKSIZE peut être utilisée pour spécifier le nombre maximum d'octets que compte un bloc. Par exemple : Taille d'un bloc : 8000 octets A partir de ces valeurs, on obtient une taille de rapport maximale de 937 ko. Dans les onglets spécifiques aux hôtes des jobs, il est possible de définir si l'agent doit enregistrer le rapport dans la base de données AE et/ou dans un fichier. Le rapport est tronqué et stocké dans la base de données si sa taille dépasse le nombre maximum de blocs spécifié. Si seule l'option "Rapport de job" - "Base de données" est sélectionnée, le fichier est supprimé sur la machine de l'agent une fois le transfert effectué avec succès. Un rapport incomplet est stocké dans la base de données si sa taille dépasse le nombre maximum de blocs. L'indication effectuée dans MAX_REPORT_SIZE n'est pas prise en compte lors de l'enregistrement du rapport de job sous forme de fichier. Dans ce cas, le rapport complet est enregistré dans le système de fichiers. (voir aussi : Supervision système) |
Agent |
|||||||||||||||||||||||||||||||||||||||
RECONNECT_TIME |
Intervalle de temps durant lequel l'agent tente d'établir une connexion. Ceci concerne l'établissement d'une connexion lors d'un redémarrage ou après une perte de connexion. Valeurs autorisées : 1 à 3600 |
Agent |
|||||||||||||||||||||||||||||||||||||||
REPORT_BLKSIZE |
Cette entrée contient la taille d'un bloc de rapport. Valeurs autorisées : 1 à 8000 |
Agent |
|||||||||||||||||||||||||||||||||||||||
REPORT_TIME |
Utilisez REPORT_TIME pour définir l'intervalle de temps durant lequel l'agent envoie le log au système AE. Valeurs autorisées : 1 à 3600 |
Agent |
|||||||||||||||||||||||||||||||||||||||
VAR_TIMEOUT |
Durée maximale, en secondes, pour la résolution des objets variable avec les sources BACKEND et SQL Les variables Backend exécutent une commande sur un système d'exploitation (Windows, UNIX) et fournissent le résultat en tant que valeurs. Les variables SQL exécutent des commandes SQL sur une base de données externe et renvoient leurs résultats. Valeurs autorisées : 1 à 600 |
Agent | |||||||||||||||||||||||||||||||||||||||
WORKLOAD_MAX_FT |
Nombre maximal deressources que l'agent fournit pour les transferts de fichiers. Valeurs autorisées : -1 à 100 000 La valeur "-1" correspond à "UNLIMITED" et signifie que lors de l'exécution du transfert de fichier, le paramètre des ressources est ignoré. Les valeurs supérieures à 100 000 sont interprétées comme -1. Vous pouvez également définir temporairement la valeur de WORKLOAD_MAX_FT dans la Supervision système. |
Non | |||||||||||||||||||||||||||||||||||||||
WORKLOAD_MAX_JOB |
Nombre maximal de ressources que l'agent prépare pour les jobs. Valeurs autorisées : -1 à 100 000 La valeur "-1" correspond à "UNLIMITED" et signifie que lors de l'exécution du Job, le paramètre des ressources est ignoré. Les valeurs supérieures à 100 000 sont interprétées comme -1. Vous pouvez également définir temporairement la valeur de WORKLOAD_MAX_JOB dans la Supervision système. |
Agent |
See also:
Overview of all variables in Table Form
Variable