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

Agent BS2000

Rubriques connexes : Conseils d'adaptation des fichiers de configuration

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 adapter à l'environnement de votre système sont écrits en lettres rouges.

Structure du fichier INI x.xxx.UCXJB2?.INI

Section/paramètre Description
(GLOBAL)  

SYSTEM=

Nom du système AE.

Cette entrée doit être identique à l'entrée dans le Automation Enginefichier INI.

NAME=

Nom de l'agent 

Le nom de l'agent est limité à 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.

LOGGING= Nom du fichier log.

L'indication de l'ID utilisateur est possible. Si l'ID utilisateur n'a pas été spécifiée, le fichier log est écrit dans l'ID utilisateur sous lequel les jobs sont exécutés.

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

LOGCOUNT= Nombre de fichiers log sauvegardés.
LANGUAGE=

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

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

LICENCE_CLASS= Classe de licence qui correspond à la licence acquise et au matériel et logiciel déployés.

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

JOINREAD=

Paramètre qui détermine le mot de passe dans BS2000 si aucun mot de passe n'a été trouvé dans l'objet Login.

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

"0" : ne pas indiquer le mot de passe.
"1" : indiquer le mot de passe.

USERID_TYPE=

Possibilité supplémentaire à celles du système d'exploitation d'autoriser ou d'interdire certains utilisateurs.

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

"INCL" : l'accès doit être autorisé pour chaque utilisateur spécifié dans (USERID).
"EXCL" : l'accès est interdit aux utilisateurs spécifiés dans (USERID). Tous les autres utlisateurs peuvent démarrer des jobs.

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 obtient un nom temporaire commençant par la lettre "T" suivie du RunID converti en lettres. Le nouveau protocole de transfert de fichiers ajoute aussi un ID de fichier pour obtenir un nom de fichier unique car, fondamentalement, seul un RunID est fourni. Le fichier est renommé après avoir été transféré avec succès.
"no" : l'agent attribue le nom de fichier final lorsque le transfert de fichier commence.

FileProcessingTimeout=

Limite de temps en secondes pour la recherche de fichiers des Evènements du système de Fichiers

Si la limite de temps indiquée est atteinte, la recherche de fichiers de l'exécution actuelle de l'évènement est annulée.

Si le paramètre est défini sur "0" (valeur par défaut) ou "-1", il n'y aucune limite de temps.

Le paramètre est important pour les Evènements du système de Fichiers avec les paramètres FILE_SIZE, FILE_STABLE, FILE_CHANGED.

FileProcessingMaxDepth=

Niveau maximal de sous-répertoires pour les Evènements du système de Fichiers

Ce paramètre vous permet de définir l'étendue de la recherche de la structure du répertoire lors de la recherche de fichiers des Evènements du système de fichiers. Le niveau maximal de sous-répertoires, en partant du répertoire de recherche, doit alors être indiqué.

Une restriction du niveau de répertoires peut permettre d'améliorer la performance des Evènements du système de fichiers, en particulier pour une structure de dossiers profondément imbriquée avec de nombreux fichiers.

Valeurs autorisées :
"0" (valeur par défaut) = aucune restriction
"1" = Les fichiers sont recherchés uniquement dans le répertoire de recherche, les sous-répertoires ne sont pas pris en compte.
"2" = Répertoire de recherche et un niveau de répertoires vers le Bas
"3" = Répertoire de recherche plus deux niveaux de sous-répertoires
, etc.

Le paramètre est important pour les Evènements du système de Fichiers avec les paramètres FILE_SIZE, FILE_STABLE, FILE_CHANGED.

(AUTORISATION)  
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)

Saisie des utilisateurs BS2000 autorisés au format :
nom d'utilisateur
=START

Saisie des uUtilisateurs BS2000 interdits au format :
nom d'utilisateur
=NO_START

(VARIABLES) Cette section contient les variables d'agent avec les informations et les paramètres de l'agent.

(TRACE)

 

FILE= Nom du fichier de trace.

La saisie de l'ID utilisateur est possible. S"il n'est pas saisi, le fichier de trace est écrit dans l'ID utilisateur sous lequel les jobs sont exécutés.

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 courant porte toujours le numéro "00".

TRCCOUNT= Nombre de fichiers de trace sauvegardés.
TCP/IP=
FILETRANSFER=
UCON=
RFC=
MEMORY=
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'en coopération avec le support Automic.

(TCP/IP)  
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.

BINDADDR=

Adresse IP ou nom d'hôte pour la connexion à l'agent.

Utilisez ce paramètre si la connexion doit être établie via une adresse IP donnée (par exemple si l'ordinateur possède plus d'une carte réseau).

Sinon, vous pouvez aussi indiquer l'adresse IP ou le nom de l'hôte dans PORT=

(format : PORT=adresse IP:port ou nom DNS:port). Les spécifications faites dans BINDADDR= sont alors ignorées.

BINDLOCAL=

Prise en compte de l'hôte local (127.0.0.1)

Ce paramètre doit être utilisé en relation avec BINDADDR=.

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

"0" : aucun socket d'écoute n'est créé.
"1" : un socket d'écoute supplémentaire est créé sur l'hôte local.

CONNECT=

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

Valeur par défaut : 240 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 des caractéristiques de l'hôte est utilisé.

REPORT=

Intervalle de temps en secondes durant lequel l'agent envoie le logging au Automation Engine

Valeur par défaut : 60 secondes

CONNWAIT=

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

Valeur par défaut : 20 secondes

CP=

Adresse du processus de communication du système AE auquel l'agent doit se connecter.

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

MAXMSGSIZE=

Longueur maximale des messages en octets qui accepte l'Agent.

Valeur par défaut : 500 000

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

(RFC)

 

LOGON= Transfert de fichiers : Evaluation de l'ID utilisateur de l'onglet "Paramètres de transfert de fichier".

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

"0" : l'ID utilisateur n'est pas évalué. Le transfert de fichier est exécuté avec les droits de l'agent. Notez qu'AE ne peut pas garantir la capacité complète de vérification lorsque vous utilisez cette fonction car, théoriquement, vous pouvez spécifier n'importe quel utilisateur, même un utilisateur non valide.

"1" : l'ID utilisateur est évalué. Le transfert de fichier est exécuté avec les droits de cet utilisateur. Une entrée supplémentaire (tâche RFC) est aussi démarrée dans l'ID utilisateur respectif.

PORT=  Numéro de port utilisé par la tâche RFC pour établir la connexion à l'agent.
TIMEOUT= Durée d'attente maximale durant laquelle l'agent attend la tâche RFC (en secondes).
ENTERPAR= Paramètres supplémentaires pour la tâche RFC (voir commande d'entrée).

TASKTIMEOUT=

Période en secondes après laquelle une tâche RFC est terminée.

Une tâche RFC démarrée par un agent peut traiter plusieurs ordres de transfert de fichier. Elle se termine si elle ne reçoit pas de tâche pour la période définie ici.

(CP_LIST)

Liste des processus de communication

La 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 plus d'informations sur l'établissement d'une connexion au chapitre Fonctionnement en mode multi-serveur.

Le processus de communication qui est défini dans le paramètre cp= (section (TCP/IP)) n'est pas inclut dans la liste.

Formats :
Numéro de port
=nom DNS
ou
Numéro de port
=adresse TCP/IP

Exemple de fichier INI

(GLOBAL)
SYSTEM=UC4
NAME=BS2000
LOGGING=$UC4.L.LOGG.UCXJBXX.##
LOGCOUNT=10
LANGUAGE=(E,D)
LICENCE_CLASS=6
JOINREAD=1
USERID_TYPE=EXCL
ft_temp_file=yes


(AUTHORIZATION)
InitialPackage=
KeyStore=


(USERID)
TSOS=NO_START


(VARIABLES)
UC_HOST_CODE=BS2000_INTERNATIONAL
UC_HOST_JCL_VAR=BS2000
UC_EX_PATH_BIN=$UC4.UCX24.LIB
UC_EX_PATH_TEMP=$UC4.TEMP.
UC_EX_PATH_JOBREPORT=$UC4.JOB.REPORT.
UC_EX_JOB_MD=*MOD(LIBRARY=$UC4.UCX24.LIB,ELEMENT=UCXJB24M,RUN-MODE=*ADVANCED)


(TRACE)
FILE=$UC4.L.TRACE.UCXJBXX.##
TRCCOUNT=10
TCP/IP=0
FILETRANSFER=0
UCON=0
RFC=0


(TCP/IP)
PORT=2300
CONNECT=120
REPORT=60
CONNWAIT=20
CP=PC01:2217


(HOSTS)
; <AE-NAME>=<DNS-NAME> OR
; <AE-NAME>=<IP-ADDR>


(RFC)
LOGON=0
PORT=2400
TIMEOUT=90
ENTERPAR=,JOB-PRIORITY=8,START=*STD,RESOURCES=*PAR(RUN-PRIORITY=248)
TASKTIMEOUT=900


(CP_LIST)
2218=PC01