Manuel d'administration > Configuration > Organisation des fichiers de configuration > Fichier INI de l'Agent OS/400

Agent OS/400

Des valeurs par défaut ont été attribuées à la plupart des paramètres. Vous pouvez les modifier en fonction de vos besoins. 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 UCXJO41

Section/paramètre Description
[GLOBAL]  

SYSTEM=

Nom du système AE.

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

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

Si vous ne saisissez pas de paramètre, le nom d'hôte est automatiquement utilisé. Les minuscules sont ainsi 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.

CheckLogon=

Vérification de l'objet Login

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

"0" - L'objet Login n'est pas vérifié.
"1" - Les données utilisateur dans l'objet Login sont vérifiées avant l'exécution des Tâches.

Attention: lorsque vous fixez ce paramètre sur "1", chaque profil d'Utilisateur, présenté dans l'objet Login, doit être activé sur la plateforme OS/400. Sinon, il n'est pas possible de démarrer les Jobs.

logcount=

Nombre des fichiers log sauvegardés.

logging=

Nom du fichier log.

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 ; de cette manière, le fichier log le plus récent porte toujours le numéro "00".

Si aucun nom de fichier n'est indiqué, le journal est écrit dans le spoolfile du Job de l'Agent.

language= Langue dans laquelle le logging est exécuté. Indication de la 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.

helplib=

Nom du fichier des messages.

LICENSE_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 licence acquise pour l'Agent.

spool= Spoolfiles d'une exécution de Job :
"delete" = supprimer les spoolfiles.
"keep" = laisser les spoolfiles dans le spool.
dqname=

Nom de la file de données du Job de l'Agent.
Valeur par défaut : "DQ"

Si plusieurs instances d'un Agent sont activées à partir d'une seule et même bibliothèque, un nom de file de données particulier doit être attribué pour chaque instance. Si cette entrée est désactivée dans le fichier INI, le nom de file de données est attribué par l'Agent sous la forme "DQ######" (###### = numéro de Job à 6 chiffres).

SBMJOB=

Paramètre définissant si le Job Submit doit être écrit dans le fichier log.

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

"0" - le Job Submit ne figure pas dans le fichier log.
"1" - les lignes du Job Submit sont générées dans le fichier log.

SBMMSK=

Paramètre de démarrage pour le Job Submit.

console=

Nom de la file d'attente des messages devant être surveillée avec un Evènement du type "console".

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 sous [USERID].
"EXCL" = les Utilisateurs indiqués sous [USERID] sont interdits. Des Jobs peuvent être démarrés avec tous les autres Utilisateurs.

ft_temp_file_ifs=

Création de fichiers temporaires lors du Transfert de Fichier

Ce paramètre ne peut être défini que lorsque IFS est utilisé comme système de fichiers!

Valeurs autorisées : "yes" et "no" (valeur par défaut)

"yes" : le fichier est d'abord nommé avec un nom commençant par la lettre "T" suivie du RunID converti en lettres. Lors d'un nouveau protocole de Fichier de Transfert, un ID de fichier est également attaché afin de conserver un nom de fichier univoque dans la mesure où il n'y a qu'un seul RunID. Le fichier est renommé une fois le Transfert de Fichier réussi.

"no" : l'Agent attribue au fichier son nom définitif dès le début du Transfert de Fichier.

tcp_nodelay=

Utilisation de l'algorithme de Nagle pour les transferts de Transfert de Fichier ou pour tous les autres Sockets des Agents.

Valeurs autorisées : "yes" (valeur par défaut) et "no"

"no" - Activation de l'algorithme de Nagle
"yes" - le processus n'est pas employé

Grâce à l'activation de l'algorithme de Nagle, la performance de Transfert de Fichier peut être améliorée. Ceci est principalement remarquable lorsque de nombreux petits fichiers sont transférés.

L'Agent BS2000 utilise toujours l'algorithme de Nagle et ne possède d'ailleurs pas ce paramètre INI.

Ce paramètre ne doit être défini qu'après accord définitif du support !

[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]

Indication des Utilisateurs OS/400 autorisés au format :
nom utilisateur
=START

Indication des Utilisateurs OS/400 interdits au format :
nom utilisateur
=NO_START

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

[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= Nom de fichier 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=
CONTROLFLOW=
VARIABLE=
MESSAGE=
DUMP=
MISCELLANEOUS=
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'après accord définitif du support !

[TCP/IP]

 

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

Ce numéro de port est utilisé par d'autres Agents et par l'Agent Job pour entrer en contact avec l'Agent.

bindaddr=

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

Utilisez ce paramètre si la connexion doit se faire 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 avec port= (format : port=adresse IP:port ou. nom DNS:port). L'indication de bindaddr= est ainsi ignorée.

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 de liste n'est créé.
"1" - un socket de liste 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 Serveurs AE. Concerne l'établissement d'une connexion lors d'un redémarrage ou après une perte de connexion.

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

maxrepcnt= Nombre maximal de blocs de rapport qui doivent être transférés simultanément au AutomationEngine.

Valeur par défaut : 8 blocs
maxMsgSize=

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

Valeur par défaut : 500 000

SendBufferSize=

Taille en octets du cache TCP/IP pour les messages à envoyer.

Valeur par défaut : 1048576 octets

RecvBufferSize=

Taille en octets du cache TCP/IP pour les messages à recevoir.

Valeur par défaut : 1048576 octets

CP=

Adresse du processus de communication primaire dans le 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

[CP_LIST]

Liste des processus de communication

La liste est établie au démarrage de l'Agent et étendue dès lors 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]).

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

Exemple de fichier INI

[GLOBAL]
SYSTEM=UC4
NAME=AS400
CheckLogon=1
logcount=10
logging=UC4/TMP(UCXJ_LOG##)
language=(E,D)
helplib=UC4/MSL
LICENSE_CLASS=9
spool=delete
dqname=DQ
console=QSYS/QSYSOPR
userid_type=EXCL
ft_temp_file_ifs=yes


[AUTHORIZATION]
InitialPackage=
KeyStore=


[USERID]
; MEIER=NO_START


[VARIABLES]
UC_HOST_CODE=EBCDIC_00273
UC_HOST_JCL_VAR=OS400
UC_EX_PATH_BIN=UC4
UC_EX_PATH_TEMP=UC4/TMP
UC_EX_PATH_JOBREPORT=UC4/TMP
UC_EX_JOB_MD=UC4/UCXJO41M


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


[TRACE]
file=UC4/TMP(UCXJ_TRC##)
trccount=10
tcp/ip=0
filetransfer=0
job=0
event=0
CONTROLFLOW=0
VARIABLE=0
MESSAGE=0
DUMP=0
MISCELLANEOUS=0


[TCP/IP]
port=2300
connect=120
maxrepcnt=8
CP=PC01:2217


[CP_LIST]
2218=PC01

 

Rubriques connexes :