UC_HOSTCHAR_DEFAULT - Caractéristiques de l'hôte

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, respectivement

Les paramètres ANONYMOUS_FE, ANONYMOUS_FT et ANONYMOUS_JOB ne sont pris en charge que pour les agents OS/400, UNIX et Windows.

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

Valeurs autorisées : Y et N (par défaut).

Ces paramètres peuvent être utilisés pour définir si les informations d'identification enregistrées dans 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, respectivement. Le comportement dépend également des paramètres définis dans les paramètres du fichier INI de l'agent :

Pour les transferts de fichiers, vous pouvez définir le privilège suivant dans l'objet Utilisateur :

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

Ce privilège permet même d'exécuter les transferts de fichier sans l'objet Login. Ces transferts de fichiers sont exécutés sous l'utilisateur du système d'exploitation de l'agent.
Condition : ANONYMOUS_FT=Y et logon=0 (Windows) ou login_check=no (UNIX).

Pour les événements de fichiers, vous pouvez définir le privilège suivant dans l'objet Utilisateur :

Evénement fichier : Exécuter sans spécification d'un objet Login

Ce privilège permet même d'exécuter les événements de fichiers sans l'objet Login. Ces événements de fichiers sont exécutés sous l'utilisateur du système d'exploitation de l'agent.
ANONYMOUS_FE et les paramètres du fichier de configuration, tels que logon (Windows) or login_check (UNIX) ou check_logon (OS/400) sont ignorés.

Aucun privilège de l'objet Utilisateur ne permet de lancer des jobs sans l'objet Login. Ainsi, même en définissant ANONYMOUS_JOB=Y, les jobs sans objets Login sont interrompus.

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
• Agents Windows et UNIX : Connexion email via SMTP

Valeur par défaut : ERP_LOGIN

Agent

Heure de la journée à laquelle la durée de vie du dossier de sauvegarde est vérifiée.

Tous les fichiers et répertoires plus anciens que BACKUP_RETENTION_LIFETIME sont 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'agentUC_EX_PATH_BACKUP dans le fichier INI de l'agent.

La page Rollback vous permet de spécifier les fichiers à copier 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:00"

Durée de vie en jours du contenu du dossier de sauvegarde

Ce code vous permet de déterminer 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. Tout contenu plus ancien est supprimé.

Concerne uniquement les agents Windows et UNIX.

Valeurs autorisées : "0" - "99"
Valeur par défaut : "14"

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 (valeur par défaut) et NO

YES : le Workflow est bloqué.
NO : le Workflow n'est pas bloqué automatiquement.

Non

Nombre de jours au delà duquel les fichiers journaux de l'agent sont changés.

Valeurs autorisées : "1" à "32767"
Valeur par défaut : "14"

Uniquement disponible pour les agents basés Java, les agents Windows et les agents Unix.

Taille en Mo après laquelle les fichiers journaux sont changés.

Valeurs autorisées : "1" à "32767"
Valeur par défaut : "20"

Uniquement disponible pour les agents basés Java, les agents Windows et les agents Unix.

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 (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. Gardez cela à l'esprit quand vous exécutez des jobs / transferts de fichier et si le paramètre DISCONNECT_AFTER_FT est défini à "NO". Il est recommandé d'utiliser la valeur "YES".

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

Intervalle en secondes pendant lequel l'agent vérifie périodiquement 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 augmente automatiquement si la vérification d'une condition dure plus longtemps que l'intervalle spécifié.

EXECUTE_ON_ASSIGNMENT
EXECUTE_ON_END
EXECUTE_ON_LOST
EXECUTE_ON_START

Utilisez ces codes pour lancer n'importe quelobjet exécutable dans les cas suivants.

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

• EXECUTE_ON_START : l'agent démarre.
• EXECUTE_ON_END : l'agent s'arrête.
• EXECUTE_ON_LOST : tâche terminée avec ENDED_LOST
• EXECUTE_ON_ASSIGNMENT (voir Page Autorisations)

Valeur par défaut :

• EXECUTE_ON_START: UC_EXECUTOR_START
• EXECUTE_ON_END: UC_EXECUTOR_END
• EXECUTE_ON_LOST: UC_EXECUTOR_LOST
• EXECUTE_ON_ASSIGNMENT: UC_EXECUTOR_ASSIGNMENT

Les variables de script suivantes peuvent être utilisées dans les objets :

• &uc_ex_host : nom de l'agent

Les variables de script suivantes ne peuvent être utilisées que dans les objets affectés à EXECUTE_ON_ASSIGNMENT :

• &uc_ex_auth_mode# : Type de modification
  Valeurs autorisées :
  "AUTO" : la modification a été effectuée automatiquement par un objet Affectation agent/client.
  "MANUAL" : la modification a été effectuée manuellement, 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").
  Exemple : "RnX" : l'agent peut lire et exécuter.

Vous pouvez utiliser la fonction de script STR_CUT pour accéder à chaque chiffre.

Utilisez l'instruction de script :READ pour extraire les valeurs de variables de scripts.
Par exemple :

:READ &uc_ex_host,,
:PRINT &uc_ex_host

Remarques :

Les objets seront recherchés et activés dans tous les clients dans lesquels l'agent est autorisé, à l'exception du client système 0000. Mais EXECUTE_ON_ASSIGNMENT recherche tous les clients dans lesquels des autorisations ont été modifiées.

Notez que les objets affectés à EXECUTE_ON_START, EXECUTE_ON_END, EXECUTE_ON_LOST et EXECUTE_ON_ASSIGNMENT démarrent dans les clients où ils se trouvent, mais sont exécutés sous l'utilisateur UC/UC du client système 0000 avec ces autorisations clients. Les autorisations de niveau objet sont donc ignorées (Page Autorisations).

Non

Ces codes sont utilisés avec le CAU - Procédure de mise à niveau.

Vous pouvez utiliser ces codes pour exécuter des objets dans les cas suivants :

• Après l'exécution complète d'un déploiement CAU entier :
  EXECUTE_ON_DEPLOYMENT_RUN
  

• Après la fin d'un déploiement d'agent unique :
  EXECUTE_ON_DEPLOYMENT_AGENT

Variables utilisant l'instruction de script :READ

Vous pouvez utiliser les variables suivantes dans l'objet exécuté avec l'instruction de script :READ :

• EXECUTE_ON_DEPLOYMENT_AGENT
• &uc_ex_host# : nom de l'agent / hôte (mise à niveau de niveau agent)
• &uc_ex_deployment_runId# : RunID de l'enfant / mise à niveau de l'agent
• &uc_ex_deployment_status# : (Numéro) de statut de l'enfant / mise à niveau de l'agent
• &uc_ex_cau_runId# : RunID d'exécution de la CAU (parent de la mise à niveau de l'agent)
• &uc_ex_cau_name# : Texte personnalisé de mise à niveau d'agent
• EXECUTE_ON_DEPLOYMENT_RUN
• &uc_ex_cau_name# : Texte personnalisé de mise à niveau d'un agent
• &uc_ex_cau_runId# : RunID d'exécution de la CAU (parent de la mise à niveau de l'agent)

• &uc_ex_cau_status# : (Numéro) de statut de l'exécution CAU entière

Exemples de scripts

Utilisez la fonction de script PREP_PROCESS_REPORT et

• le paramètre CAU afin de traiter l'intégralité du rapport d'exécution CAU :
  
  :SET&HND#=PREP_PROCESS_REPORT(,&uc_ex_cau_runid, "CAU")
  :PROCESS&HND#
  : SET&RET#=GET_PROCESS_LINE(&HND#)
  : PRINT&RET#
  :ENDPROCESS
  
• le paramètre REP pour traiter le rapport détaillé d'une mise à niveau d'agent unique :
  
  :SET&HND#=PREP_PROCESS_REPORT(,&uc_ex_deployment_runid#, "REP")
  :PROCESS&HND#
  : SET&LINE#=GET_PROCESS_LINE(&HND#)
  : PRINT&LINE#
  :ENDPROCESS

Vous permet de déterminer la version de la fonctionnalité d'événement fichier à utiliser.

Valeurs autorisées : "1" ou "2" (par défaut)

"1" : La fonctionnalité d'événement fichier des versions antérieures à v11.1 est utilisée lorsqu'aucun objet Login n'est nécessaire. Assurez-vous que le privilège "Événement fichier : Démarrage sans objet Login spécifié" est activé dans l'objet Utilisateur correspondant. Le paramètre ANONYMOUS_FE est ignoré pour les exécutions d'événements fichiers

"2" : Cette version de la fonctionnalité d'événement fichier permet d'utiliser les objets Login. L'événement fichier est exécuté sous l'utilisateur spécifié dans l'objet Login. Notez que les paramètres de ANONYMOUS_FE s'appliquent également. Si le privilège "Événement fichier : Démarrage sans objet Login spécifié" est accordé, l'objet Login peut être ignoré - dans ce cas, l'événement fichier est exécuté sous l'utilisateur Agent.

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 lorsque la réception des paquets envoyés a été confirmée. L'expéditeur et le destinataire ajustent leurs vitesses 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ètre 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 : 1, 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.

FT_COMPRESS

Type de compression pour les transferts de fichiers (voir Transferts de fichier (JOBF)).

Valeurs autorisées : NO (par défaut) et NORMAL

Agent

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

Remarque : Il est recommandé 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.

Taille d'un bloc de rapport pour les rapports de transferts de fichiers.

Valeur minimale : 2048
Valeur par défaut : 31744

Intervalle de temps, en secondes, pendant lequel l'agent envoie des blocs de rapport.

Valeur minimale : 1

Valeur par défaut : 60

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 à l'échéance de la durée de vie spécifiée avec le code FT_RESTARTINFO_LIFETIME .

Valeur par défaut : 0:00:00

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

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

Intervalle en secondes au cours duquel l'agent envoie les informations de statut des transferts de fichier au serveur.

Le statut des transferts de fichiers apparaît dans les détails de la tâche (voir Afficher le détail des objets et des tâches).

Valeur minimale : 1
Valeur par défaut :60 secondes

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 (valeur par défaut) et N

JOB_CHECKINTERVAL

Intervalle de temps pendant lequel les agents vérifient les exécutions de jobs.

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.

N'oubliez pas qu'un intervalle inférieur à 60 secondes augmentera la charge du serveur, ce qui affectera sa performance.

Agent

KEEP_ALIVE

Intervalle du signal de vie utilisé entre un agent et son CP.

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 devient 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. Perspective Administration affiche systématiquement la valeur qui a été définie en utilisant KEEP_ALIVE.

Agent

Détermine si les fichiers journaux de l'agent doivent ou non être envoyés à la base de données Automation Engine. Voir aussi la description de REPORT_TIME.

Valeurs autorisées : Y (valeur par défaut) et N

Y : L'agent envoie ses messages de fichiers journaux également à Automation Engine d'où ils sont accessibles sous forme de rapports de l'objet Agent.
N : l'agent n'envoie pas de message du log à Automation Engine. Ce paramètre optimise les performances du système Automation Engine.

Maximum de fichiers trouvés dans les événements fichiers.

Valeurs autorisées : 0 - 100000
Valeur par défaut : 1000

0 : Illimité

Si des caractères génériques sont utilisés ou si des sous-répertoires sont inclus dans la recherche, les vérifications renverront une énorme quantité de fichiers. Pour des raisons de performances, vous pouvez spécifier le nombre maximum de fichiers trouvés.

L'agent ne vérifie les fichiers que dans la limite de ce nombre si les conditions spécifiées s'appliquent et, le cas échéant, déclenche le contenu de la page Script d'événement.

MAX_REPORT_SIZE

Nombre maximum de blocs de rapports de jobs transférés vers la base de données Automation Engine.

Valeurs autorisées : 1 - 10000
Valeur par défaut : 120 blocs

Le code REPORT_BLKSIZE peut être utilisé pour spécifier le nombre maximum d'octets par bloc.

Par exemple :

Taille d'un bloc : 8000 octets
Nombre de blocs de rapport : 120

A partir de ces valeurs, on obtient une taille de rapport maximale de 937 ko.

Après exécution du job, un rapport de job peut être enregistré localement dans le système de fichiers et / ou transféré vers Automation Engine qui l'enregistre alors dans sa base de données. Ceci est défini dans la page spécifique à l'hôte du job. Lorsqu'un rapport doit être transféré vers Automation Engine, les paramètres REPORT_BLKSIZE et MAX_REPORT_SIZE s'appliquent et le rapport est tronqué en conséquence s'il excède le nombre maximal de blocs. Dans ce cas, un rapport incomplet est enregistré dans la base de données.

- Si seule l'option "Rapport de job" - "Base de données" est sélectionnée, le fichier est supprimé dans le système de fichiers, une fois le transfert effectué avec succès.

- Si l'option "Rapport de job" - "Fichier" est sélectionnée, les paramètres REPORT_BLKSIZE et MAX_REPORT_SIZE ne sont pas pris en compte. Dans ce cas, le rapport complet est enregistré dans le système de fichiers.

Lorsque l'agent est actif, ce paramètre peut être défini temporairement dans la page Options avancées, champ Blocs de rapport max. Dès que l'agent se reconnecte, le paramètre de MAX_REPORT_SIZE s'applique de nouveau.

Agent

RECONNECT_TIME

Intervalle de temps pendant lequel l'agent tente régulièrement de rétablir une connexion avec Automation Engine en cas de nouveau démarrage ou d'interruption des connexions.

Valeurs autorisées : 1 - 3600
Valeur par défaut : 600 secondes

Lorsque l'agent est actif, ce paramètre peut être défini temporairement dans la page Options avancées, champ Intervalle de vérification. Dès que l'agent se reconnecte, le paramètre de RECONNECT_TIME s'applique de nouveau.

Agent

REPORT_BLKSIZE

Taille d'un bloc de rapport. Voir aussi la description de MAX_REPORT_SIZE.

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

Agent

REPORT_TIME

Intervalle de temps pendant lequel l'agent met à jour les messages de journalisation de l'agent dans le système Automation Engine. Voir aussi la description de LOG_TO_DATABASE.

Valeurs autorisées : 1 - 3600
Valeur par défaut : 60 secondes

Agent

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 traitent les commandes SQL sur une base de données externe et renvoient leurs résultats sous forme de valeurs.
VAR_TIMEOUT spécifie 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

Nombre maximal de ressources que l'agent fournit pour les transferts de fichiers (voir Page Attributs).

Valeurs autorisées : -1 à 100 000

Valeur par défaut : -1

La valeur -1 correspond à UNLIMITED et signifie que les paramètres des ressources sont ignorés lors de l'exécution des transferts de fichiers.

Les valeurs supérieures à 100 000 sont interprétées comme -1.

Lorsque l'agent est actif, ce paramètre peut être défini temporairement dans la page Options avancées, champ Ressources max. des transferts de fichiers. Dès que l'agent se reconnecte, le paramètre de WORKLOAD_MAX_FT s'applique de nouveau

Nombre maximal de ressources que l'agent fournit pour les jobs (voir Page Attributs).

Valeurs autorisées : -1 à 100 000

Valeur par défaut : -1

La valeur -1 correspond à "UNLIMITED" et signifie que les paramètres des ressources sont ignorés pour les jobs.

Les valeurs supérieures à 100 000 sont interprétées comme -1.

Lorsque l'agent est actif, ce paramètre peut être défini temporairement dans la page Options avancées, champ Ressources max. des jobs. Dès que l'agent se reconnecte, le paramètre de WORKLOAD_MAX_JOB s'applique de nouveau