Manuel Utilisateur > Objets > Liste alphabétique > Variables d'Agent

Variables d'Agent

De nombreux paramètres et informations sur les Agents sont enregistrés dans des Variables d'Agent. Ceux-ci sont aussi disponibles comme objets Variable dans le Client système 0000 ou sont directement enregistrés dans la base de données. Dans le dernier cas, on parle de Variables d'Agent virtuelles. Elles peuvent être lues avec le script GET_VAR mais ne peuvent pas être définies avec l'instruction :PUT_VAR.

The correct syntax is: GET_VAR (Agent variable,Agent name)

For example: :SET &jobreport# = GET_VAR('UC_EX_PATH_JOBREPORT','WIN01')

L'administrateur peut spécifier toutes les variables de l'agent dans le fichier INI de l'agent (section [VARIABLES]). Les valeurs sont ainsi définies en fonction de l'environnement.

Par exemple :

[VARIABLES]
UC_HOST_CODE=UC_CODE
UC_HOST_JCL_VAR=NSK
UC_EX_PATH_BIN=$data01.uc4

UC_EX_PATH_CACHE=c:\AE11\agents\windows\CACHE\0100\
UC_EX_PATH_JOBREPORT=$data01.
UC_EX_JOB_MD=$data01.uc4.ucxjns1r

 

Variables d'Agent dans le Client système 0000

Variable d'Agent

Description

UC_EX_ERP_CONNECT

Contient les données de connexion pour chaque Enterprise Business Solution.

UC_EX_HOSTCHAR

Contient des paramètres déterminés pour un ou plusieurs Agents.

Variables d'Agent virtuelles

Les variables d'agent virtuelles sont en général définies dans le fichier INI de l'agent dans la section [VARIABLES]. Les valeurs de certaines variables d'agent sont automatiquement récupérées par l'agent. Dans ce cas, il n'est pas nécessaire de les définir dans le fichier INI (voir le tableau ci-dessous).
Au démarrage de l'agent, toutes les variables virtuelles sont transmises à l'Automation Engine.

Veuillez noter que vous ne pouvez pas définir les variables qui ne sont pas répertoriées ci-dessous. Bien que vous puissiez créer des variables définies par l'utilisateur, il est impossible de les lire.

Variable d'Agent

Description

Définition dans le fichier INI

UC_EX_DAYLIGHT

Demande si c'est l'heure d'été actuellement.

L'agent récupère cette information de l'heure système et la transmet à l'Automation Engine.

Valeurs valides : "Y" et "N"
"Y" - Changement d'heure été/hiver
"N" - Heure d'hiver

La valeur de ce variable est déterminée de façon automatique et ne peut pas être définie dans le fichier INI.

Non

UC_EX_HOST_ROLE

Rôle de l'agent

N'importe quelle désignation pouvant servir de critère de filtrage dans les groupes d'agents. Les noms de rôles sont séparés par ";". Ils ne doivent pas comporter plus de 256 caractères !

Attention : les rôles doivent être écrits en majuscules !

Cette définition n'affecte pas l'agent même.

Oui

UC_EX_IP_ADDR

Adresse IP ou nom d'hôte

Lorsque l'agent démarre, il récupère l'adresse IP de l'ordinateur sur lequel il est exécuté automatiquement. Il passe cette information à l'Automation Engine où elle est enregistrée dans cette variable.

L'Automation Engine utilise l'adresse IP de l'agent et le numéro de port (variable UC_EX_IP_PORT) dans les Includes d'en-tête et de queue et transmet cette information au messager de job. Le messager de job utilise ces données pour se connecter à l'agent.

L'agent utilise en général ces valeurs uniquement pour les configurations Sysplex d'un système de l'ordinateur central z/OS (agent z/OS).

Si l'agent est exécuté dans un cluster, vous pouvez saisir l'adresse IP virtuelle de ce cluster ici.

Non

UC_EX_IP_PORT

Numéro de port de l'agent.

Pour de plus amples informations, voir également la description d'UC_EX_IP_ADDR.

Non

UC_EX_JOB_MD

Chemin et nom de fichier du messager de job.

Cette variable doit être définie. Lorsque l'agent démarre, il vérifie cette valeur et s'arrête lorsque le chemin n'est pas valide.

Cette valeur est utilisée dans les objets En-tête et Queue qui incluent les appels du messager au début et à la fin du job.

Obligatoire

UC_EX_LICENCE_CLASS

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

Lorsqu'une classe de licence est définie à ''S'', l'agent transmet la valeur ''127.0.0.1'' au démarrage au lieu de l'adresse IP réelle de l'hôte.

Oui

UC_EX_MIB_INFO

Informations supplémentaires de l'agent pour la MIB (7.1.1.16).

Non

UC_EX_MIB_MONITORING

La variable indique si la disponibilité de l'agent est surveillée.

Valeurs valides : "0" et "1"
"0" : la disponiblité de l'agent n'est pas surveillé.
"1" : la disponibilité de l'agent est surveillée.

Non
UC_EX_PATH_BACKUP

Répertoire dans lequel sont stockés les fichiers de sauvegarde du rollback basé sur des fichiers de jobs et de transferts de fichier.

Concerne uniquement les Agents Windows et UNIX.

Valeur par défaut :
"..\BACKUP" (Windows) ou "../backup" (UNIX)

Si le répertoire n'existe pas, il est créé au démarrage de l'agent.

Dans le dossier de sauvegarde, les fichiers sont stockés dans la structure suivante /<Client>/<Date>/<RunID>/

Le répertoire de sauvegarde pour le rollback basé sur des fichiers est créé automatiquement lorsque vous démarrez l'agent. Ce répertoire n'est pris en charge que pour les jobs et les transferts de fichiers. Vous pouvez définir le chemin du répertoire de sauvegarde dans la variable de l'agent UC_EX_PATH_BACKUP. Notez que pour l'utilisation du rollback des fichiers, vous devez disposer de l'utilisateur du système d'exploitation sous lequel les jobs connexes et les transferts de fichiers sont lancés, et écrire l'accès au répertoire de sauvegarde.

Oui

UC_EX_PATH_BIN

Répertoire dans lequel l'agent a été installé.

Cette variable doit être définie. Lorsque l'agent démarre, il vérifie cette valeur et s'arrête lorsque le chemin n'est pas valide.

Veuillez noter que le chemin d'accès au répertoire de travail peut être défini de façon relative ou absolue. Si tous les variables d'agent ont été définies, vous pouvez utilisez l'une des deux variantes de définition de chemin.

Obligatoire
UC_EX_PATH_CACHE

Dans le répertoire de ressources sur l'ensemble du client, vous devez vous-même nettoyer les fichiers non utilisés.


Le cache spécifique au job sera nettoyé par le système Automation Engine, car ses ressources seront exclusivement utilisées par le job en question.

Oui

UC_EX_PATH_JOBREPORT

Répertoire dans lequel l'agent stocke les rapports des jobs.

Cette variable doit être définie. Lorsque l'agent démarre, il vérifie cette valeur et s'arrête lorsque le chemin n'est pas valide.

L'agent SAP enregistre également le fichier de redémarrage dans ce répertoire.

Obligatoire

UC_EX_PATH_TEMP

Répertoire dans lequel l'agent enregistre temporairement les jobs générés.

Cette variable doit être définie. Lorsque l'agent démarre, il vérifie cette valeur et s'arrête lorsque le chemin n'est pas valide.

Obligatoire
UC_EX_PATH_TEMP_IFS

Répertoire IFS dans lequel les fichiers StatusStore des transferts de fichier doivent être enregistrées.

Pertinent uniquement pour les agents OS/400, et juste lorsque la valeur ''IFS'' est définie dans le paramètre de fichier INI store_type=.

Oui

UC_EX_SIM_IDENT

Spécification pour l'instruction $ IDENT.

Pertinent uniquement pour l'agent GCOS.

Oui

UC_EX_VERSION

Version de l'agent.

L'agent récupère cette valeur de façon automatique.

Non

UC_HOST_CODE

Nom de la table de codes du client système 0000.

Valeur par défaut : UC_CODE

La conversion de caractères qui y est définie est utilisée lors du transport des jobs vers l'hôte et pour le transfert de fichier automatique du rapport du job.

Oui
UC_HOST_CONN_ABAP Objet Connexion pour la base ABAP qui doit être entré dans l'objet Agent. Oui
UC_HOST_CONN_JAVA Objet Connexion pour la base Java qui doit être entré dans l'objet Agent. Oui
UC_HOST_CONN_PI Objet Connexion pour l'intégration des processus qui doit être entré dans l'objet Agent. Oui
UC_HOST_CONN_SLD Objet Connexion pour le système Landscape Directory qui doit être entré dans l'objet Agent Oui

UC_HOST_HW

Informations matérielles de l'ordinateur (par ex. système, nombre de processeurs, type de processeur).

L'agent récupère cette valeur de façon automatique.

Non

UC_HOST_JCL_VAR

Référence aux Includes qui sont utilisés lors de la génération du Job.

Il s'agit par défaut des Includes HEADER.*, TRAILER.* et RESTART.* du client système 0000. Toutefois, vous pouvez également définir vos propres Includes.

Oui

UC_HOST_SW

Système d'exploitation de l'ordinateur.

L'agent récupère cette valeur de façon automatique.

Non

UC_HOST_SW_VERS

Version du système d'exploitation.

L'agent récupère cette valeur de façon automatique.

Non

UC_SIEBEL_LOGPATH

Répertoire de stockage des fichiers log de Siebel.

Oui

UC_SIEBEL_SRVRMGR

Répertoire dans lequel se trouve le Manager du serveur Siebel (srvmgr.exe).

Oui

 

Rubriques connexes :

Agent