Manuel d'administration > Configuration > Organisation des fichiers de configuration > Agent GCOS8

Agent GCOS8

Des valeurs par défaut ont été attribuées à la plupart des paramètres. Vous pouvez les modifier si nécessaire. Les paramètres que vous devez en tous cas adapter à l'environnement de votre système sont mis en évidence en caractères rouges.

Structure du fichier INI UCXJGC8I

Section/paramètre Description
[GLOBAL]  
name=

Nom de l'agent. 

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

Le nom d'hôte est utilisé si ce paramètre n'est pas défini. Les minuscules sont 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.

system=

Nom du système AE.
Cette entrée doit être identique à l'entrée dans le fichier INI du Automation Engine.

logging= Chemin et nom de fichier du fichier log.

Les caractères numériques servent de caractère de remplacement pour une numérotation croissante. Les fichiers log sont renommés au démarrage de l'agent et le fichier log le plus récent porte toujours le numéro "00".

logcount= Nombre des fichiers log sauvegardés.
helplib= Chemin et nom du fichier des messages.
licence_class= Classe de licence qui correspond à la licence acquise, au matériel et logiciel déployés.

Valeurs autorisées : "1" à "9"
"1" à "9" : classe de la licence de l'agent.
language=

Langue utilisée pour le log. Vous pouvez spécifier une langue primaire et secondaire. 

Valeurs autorisées : "E", "D", "F"
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.

userid_type=

Ce paramètre peut être utilisé pour autoriser ou rejeter certains utilisateurs.

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

"INCL" : l'autorisation d'accès doit être spécifiée pour chaque utilisateur dans la section [USERID].
"EXCL" : l'accès est interdit aux utilisateurs spécifiés sous [USERID]. Tous les autres utlisateurs peuvent démarrer des jobs.

RSM=

RSM8 doit être installé pour le transfert du rapport de job à AE. Si vous ne possédez pas le programme, vous devez utiliser ce paramètre, sinon les jobs sont bloqués ! Sans RSM8, des fichiers, contenant quelques informations de base, au nom du rapport sont créés.

Valeurs autorisées : "N" et "X"

"N" - un fichier est enregistré dans le catalogue OUT.
"X" - le premier caractère du nom de rapport du Job est remplacé par la lettre "X". Le fichier est ensuite enregistré dans le catalogue OUT.

Si vous utilisez RSM8, le paramètre RSM= ne doit pas être défini !

active_Jobreport_count=

Nombre maximal de rapports de Job pouvant être envoyés simultanément à Automation Engine.

Valeur par défaut : "10"

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. Le nouveau protocole de transfert de fichier ajoute un ID de fichier afin d'obtenir un nom de fichier unique parce que fondamentalement, seul un RunID est fourni. Il n'est renommé qu'après le transfert réussi des fichiers.
"no" : l'agent attribue le nom de fichier final lorsque le transfert de fichier commence.

[AUTHORIZATION]  
InitialPackage=

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.

KeyStore=

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

[USERID]

Spécification des utilisateurs GCOS8 autorisés au format :
nom d'utilisateur
=START

Spécification des utilisateurs GCOS8 non-autorisés au format :
nom d'utilisateur
=NO_START

[VARIABLES] Dans cette section se trouvent des variables d'agent contenant des informations et des paramètres pour l'agent.

SNUMB_SUFFIX=

Caractère devant être ajouté au numéro de séquence du job si l'utilisateur ne l'indique pas dans l'objet job.

[MISC]

 

TRCOPENCLOSE=

Paramètre pour le traitement du fichier de trace.

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

"0" : Le fichier est ouvert à la définition d'une trace et fermé lorsque la trace est fermée ou l'agent arrêté (recommandé).
"1" - Le fichier est ouvert en plus et fermé en cas d'informations à enregistrer.

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

[TRACE]

 

file= Chemin et nom du fichier de trace.

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

trccount= Nombre des fichiers de trace sauvegardés.

tcp/ip=
filetransfer=
Job=
event=
variable=
controlflow=
message=
dump=
misc=
msgconv=

Indicateurs de trace de l'agent.

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.

[TCP/IP]

 

connwait=

Durée en secondes durant laquelle l'agent attend une réponse de son partenaire de communication (CP ou un autre agent). Si cette durée est dépassée, la connexion au partenaire de communication est à nouveau supprimée.

Défaut : 10 secondes

port= Numéro de port de l'agent.

Les autres agents et le messager de job établissent une connexion avec l'agent en utilisant ce numéro de port.

connect=

Intervalle de temps en secondes durant lequel l'agent tente d'établir une connexion au Automation Engine. Concerne l'établissement d'une connexion lors d'un redémarrage ou après une perte de connexion.

Valeur par défaut : 20 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 au Automation Engine

cp=

Adresse du processus de communication du serveur AE auquel l'agent doit se connecter.

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

Job_check_count=

Nombre de contrôles périodiques de job que l'agent doit attendre à la fin du Job. Ce n'est qu'après que le Job est annoncé comme ayant disparu (statut ENDED_VANISHED).

Valeurs autorisées : "0" - "32767"
Valeur par défaut : "3"

"0" : l'agent n'utilise pas ce paramètre.

[CP_LIST]

Liste des processus de communication

Cette liste est créée au démarrage de l'agent et étendue dès 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]).

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

Exemple de fichier INI

[GLOBAL]
system=uc4
name=GCOS8
logcount=4
logging=<catalog>/TMP/LOG##
language=(E,D)
helplib=<catalog>/bin/UCMSL
licence_class=1
; USERID Type = INCL/EXCL
userid_type=EXCL
ft_temp_file=yes


[AUTHORIZATION]
InitialPackage=
KeyStore=


[USERID]
;AUSTRIA=NO_START


[VARIABLES]
UC_HOST_CODE=UC_CODE
UC_HOST_JCL_VAR=GCOS8
UC_EX_PATH_BIN=<catalog>/bin
UC_EX_PATH_TEMP=<catalog>/tmp/
UC_EX_PATH_JOBREPORT=<catalog>/out/
UC_EX_JOB_MD=<catalog>/build/UCXJGC8M


[HOSTS]
; <AE-name>=<dns-name> or
; <AE-name>=<ip-addr>


[TRACE]
; DON'T REMOVE THE TRACE FLAGS !!!

file=<catalog>/TMP/TRC##
trccount=4
tcp/ip=9
filetransfer=9
job=9
event=9
variable=9
controlflow=9
message=9
dump=9
misc=9
msgconv=0


[TCP/IP]
; Agent's listen port
port=2017
; try all n seconds to connect to server
connect=20
report = 60
cp=PC01:2217
job_check_count=5


[CP_LIST]
2218=PC01

 

Rubriques connexes :

Conseils d'adaptation des fichiers de configuration