Manuel d'administration > Configuration > Paramètres avec les Variables > UC_HOSTCHAR_DEFAULT - Caractéristique de l'hôte

UC_HOSTCHAR_DEFAULT - Caractéristiques de l'hôte

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
ANONYMOUS_FT
ANONYMOUS_JOB

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.

  • ANONYMOUS_FE : concerne le fichier des événements
  • ANONYMOUS_FT : concerne le transfert de fichiers
  • ANONYMOUS_JOB : concerne les jobs

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 :

Fichier INI ANONYMOUS_FE
ANONYMOUS_FT
ANONYMOUS_JOB
Windows Y N
[GLOBAL]
logon=0

Les jobs et/ou les transferts de fichier et/ou les événements du système de fichiers démarrent sous l'utilisateur du système d'exploitation de l'agent. Les données de connexion de l'objet Login ne sont pas vérifiées.

Attention : Automic recommande de ne pas utiliser ce paramètre.

Utilisation des données de connexion de l'objet Login
[GLOBAL]
logon=1
Utilisation des données de connexion de l'objet Login
UNIX    
[GLOBAL]
login_check=no

Les jobs et/ou les transferts de fichiers et/ou les événements du système de fichiers sont exécutés sous l'utilisateur du système d'exploitation qui est spécifié dans l'objet Login. Le mot de passe n'est pas vérifié.

Prérequis : L'agent fonctionne sous un utilisateur privilégié

Attention : Automic recommande de ne pas utiliser ce paramètre.

Utilisation des données de connexion de l'objet Login
[GLOBAL]
login_check=yes
Utilisation des données de connexion de l'objet Login
OS/400 Y N
[GLOBAL]
CheckLogon=0

Les jobs et/ou les transferts de fichier et/ou les événements du système de fichiers démarrent sous l'utilisateur du système d'exploitation de l'agent. Les données de connexion de l'objet Login ne sont pas vérifiées.

Attention : Automic recommande de ne pas utiliser ce paramètre.

Utilisation des données de connexion de l'objet Login
[GLOBAL]
CheckLogon=1


Utilisation des données de connexion de l'objet Login
z/OS ANONYMOUS_FT
ANONYMOUS_JOB
 
  Y N

[GLOBAL]
askRACF=1,3,5,7,9,11,13 ou 15

Les jobs et/ou les transferts de fichier et/ou les événements du système de fichiers démarrent sous l'utilisateur du système d'exploitation de l'agent. Les données de connexion de l'objet Login ne sont pas vérifiées.

La clé ANONYMOUS_FE n'est pas prise en charge sur les systèmes z/OS.

Utilisation des données de connexion de l'objet Login
[GLOBAL]
askRACF=2,3,6,710,11,14 ou 15
Utilisation des données de connexion de l'objet Login

Les transferts de fichiers dépendent du paramètre de privilège suivant de l'objet utilisateur :

Transfert de fichier : exécuter sans spécification d'un objet Login

Si ce privilège est disponible, les transferts de fichiers auxquels aucun objet Login n'a été attribué peuvent être effectués.
Prérequis : ANONYMOUS_FT=Y et connexion=0 (Windows) ou login_check=no (UNIX).

Les événements du systèmes de fichiers dépendent du privilège correspondant :

Evénements du système de fichiers : exécuter sans spécification d'un objet Login


Si ce privilège est disponible, les événements du système de fichiers auxquels aucun objet Login n'a été attribué peuvent être traités.
Prérequis : ANONYMOUS_FE=Y et connexion=0 (Windows) ou login_check=no (UNIX).

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 :

  • Agent PS : Données de connexion pour PeopleSoft
  • Agent OA : données de connexion pour Oracle Applications
  • Agent Windows et UNIX : connexion e-mail via SMTP

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
Valeur par défaut : "00:00"

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
Valeur par défaut : 14

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é.
NO : le Workflow n'est pas bloqué automatiquement.

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)
NO : la connexion est maintenue après le transfert.

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
Valeur par défaut : 60

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
EXECUTE_ON_END
EXECUTE_ON_LOST
EXECUTE_ON_START

Utilisez ces clés pour démarrer un objet activable dans les situations suivantes :

Au démarrage ou à l'arrêt d'un agent :

  • EXECUTE_ON_END : l'agent s'arrête.
  • EXECUTE_ON_START : l'agent démarre.

Pour les tâches sans terminaison définie :

  • EXECUTE_ON_LOST : la tâche a été terminée avec ENDED_LOST.

Lors de la modification des droits client d'un agent :

  • EXECUTE_ON_ASSIGNMENT

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,,
:
PRINT &uc_ex_host

EXECUTE_ON_ASSIGNMENT peut être utilisée pour lire les variables suivantes :

  • &uc_ex_host : nom de l'agent
  • &uc_ex_auth_mode : type de la modification
    Valeurs autorisées :
    AUTO : la modification a été faite via un objet d'affectation agent/client
    MANUAL : la modification a été faite directement dans l'objet agent
  • &uc_ex_auth : nouveaux droits sous la forme d'une chaîne de 3 caractères (les droits absents sont représentés par "n")
    Par exemple : "RnX" : l'agent peut lire et exécuter.
    Utilisez la fonction de script STR_CUT, pour modifier la chaîne.

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.
Un comportement asynchrone est atteint lorsque FT_ASYNC_QUIT_MAX est un multiple de FT_ASYNC_QUIT_NUM.

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
Nombre maximal de paquets de données non confirmés que l'expéditeur envoie à l'agent destinataire.
Valeur minimale : 1, valeur par défaut : 60, valeur maximale : 100

FT_ASYNC_QUIT_MIN
Nombre de paquets de données non confirmés à partir duquel l'expéditeur les envoie au destinataire.
Valeur minimale : 0, valeur par défaut : 30, valeur maximale : 50

FT_ASYNC_QUIT_NUM
Nombre de paquets de données qui sont confirmés par accusé de réception.
Valeur minimale : 0, valeur par défaut : 5, valeur maximale : 50

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:
0 / 1 / 1 : transfert de fichier synchrone
0 / 10 / 5 : transfert peu asynchrone. L'agent expéditeur peut envoyer au maximum 10 paquets de données non confirmés. Lorsque ce nombre est atteint, l'agent expéditeur attend que tous les accusés de réception soient arrivés avant de poursuivre l'envoi.
30 / 60 / 5 : transfert fortement asynchrone. L'expéditeur peut envoyer jusqu'à 60 paquets de données non confirmés maximum au destinataire. Les réceptions sont confirmées par 5 paquets. L'expéditeur attend toujours que 30 paquets de données non confirmés soient ouverts avant de commencer le transfert.

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
Valeur par défaut : 60

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
Valeur par défaut : 14 jours

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
Valeur par défaut :60 secondes

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
Valeur par défaut :60 secondes

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
Valeur par défaut :60 secondes

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.
Il faut cependant souligner qu'un intervalle inférieur à 60 secondes augmentera la charge des messages EXSTAJ, ce qui affectera la performance du serveur.

Agent

 

KEEP_ALIVE

Intervalle de temps pour la vérification périodique d'Automation Engine.

Valeurs autorisées : au delà de 60 secondes
Valeur par défaut :600 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.
N : l'agent n'envoie pas de message du log à Automation Engine. Les performances du système AE sont ainsi améliorées.

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
Valeur par défaut : 1000

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
Valeur par défaut : 120 blocs

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
Blocs de rapport : 120 blocs

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
Valeur par défaut : 600 secondes

Agent

 

REPORT_BLKSIZE

Cette entrée contient la taille d'un bloc de rapport.

Valeurs autorisées : 1 à 8000
Valeur par défaut : 8000 octets

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
Valeur par défaut : 60 secondes

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.
Le paramètre VAR_TIMEOUT permet de définir la limite de temps de ces actions. Si cette limite est dépassée, le traitement et la tâche qui utilise la variable sont interrompus.

Valeurs autorisées : 1 à 600
Valeur par défaut : 600

Agent  
WORKLOAD_MAX_FT

Nombre maximal deressources que l'agent fournit pour les transferts de fichiers.

Valeurs autorisées : -1 à 100 000
Valeur par défaut : -1

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
Valeur par défaut : -1

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