Agent NSK

[MISC]

Les paramètres de cette section sont utilisés en interne par l'agent. Les valeurs ne doivent pas être modifiées.

[HOSTS]

Attribution d'une adresse externe (nom DNS ou adresse TCP/IP d'un agent) au nom AE de l'agent.

Dans un transfert de fichiers, le Automation Engine envoie l'adresse interne de l'agent partenaire à un agent. Cette adresse est remplacée par l'adresse externe définie ici.

Chaque agent participant au transfert de fichiers doit être saisi ici afin d'éviter des problèmes qui pourraitent se produire lors de la conversion des adresses réseau (par exemple en raison d'un pare-feu).

[GLOBAL]

system=

Nom du système AE.
Cette entrée doit être identique à l'entrée dans le fichier INI du 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 #.

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.

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 et le fichier log le plus récent porte toujours le numéro "00".

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.

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 licence de l'agent.

• vhterm appartient à l'agent
• user_vterm appartient à un job particulier

Le paramètre user_vterm peut être remplacé dans l'objet job et dans le script par des attributs.

Le terminal virtuel "user_vterm" doit de préférence être défini dans le job NSK. Saisissez la valeur directement dans l'objet job ou indiquez-la dans le script avec l'attribut HOME_TERMINAL. Une erreur se produit si le terminal virtuel n'existe ni dans le Job ni dans le fichier INI.

UC4_MACRO_FILE=

Nom de fichier NSK (entièrement qualifié) du fichier contenant des macros TACL fourni avec le CD AE (généralement, le nom de fichier est UC4MACS, le volume et le sous-volume sont propres à chaque installation).

TACL_TIME_TO_LIVE=

Temps (en centièmes de seconde) pendant lequel un processus TACL lancé par un agent est conservé pour être réutilisé.

Si cette valeur est trop élevée, de nombreux processus TACL qui ne sont plus utilisés restent dans le système. Si la valeur est trop faible, de nombreux jobs démarrés entraînent de nombreux démarrages TACL ce qui augmente la charge du système. Automic recommande d'utiliser la valeur 90000 (15 minutes).

COLLECTOR=

Nom du processus NSK du processus AE Output Collector. Ce nom doit être unique dans le système et toujours disponible.
Valeur recommandée: $UC4OC

COLLECTOR_PARAMS=

Ce champ doit toujours rester vide car il ne sert qu'à des fins de diagnostic.

CPU_MASK=

Une chaîne de 16 valeurs 0/1 maximum (par exemple 0001111). Ce paramètre indique les CPU qu'AE peut utiliser pour le traitement batch. La première position correspond à la CPU 0, la deuxième à la CPU 1, etc.  AE ne démarre des processus que dans ces CPU, et facilite ainsi la séparation des applications en ligne et batch. Si aucune des CPU de valeur 1 n'est disponible, AE utilise alors d'autres CPU (le traitement devient prioritaire sur la protection des ressources).

TACL_TIME_RESERVED=

Temps (en centièmes de seconde) dont un TACL démarré par un agent a besoin pour démarrer le traitement d'un job. Un message d'erreur est envoyé et le job est interrompu si cette valeur est dépassée.

COLLECTOR_PRIO=

Priorité de l'Output Collector

COLLECTOR_CPU=

CPU de l'Output Collector Une autre CPU que celle de l'agent doit être sélectionnée ici. Ceci augmente la tolérance de panne du système. Le collecteur de sortie et l'agent se surveillent mutuellement. En cas de défaillance d'un des processus (par exemple à la suite de la défaillance d'une CPU), l'autre processus relance automatiquement le processus défaillant (si EXECUTOR_RESTART a été activé).

EXECUTOR_RESTART=

0 ou 1, indique si le redémarrage automatique de l'agent par le collecteur de sortie est autorisé (valeur 1). La valeur 0 indique qu'une action manuelle est nécessaire en cas de défaillance de l'agent.

DEFAULT_USER_FETCH_INTERVAL=

Intervalle (en secondes), après lequel la tentative (échouée) de connexion de l'utilisateur par défaut est répété par le serveur.

MAX_OPEN_TABLE_SIZE=

Nombre de fichiers que lesjJobs peuvent ouvrir en parallèle.

Valeurs autorisées : "0" à "32767"
Valeur par défaut : 21000

Cette limitation permet d'éviter des problèmes survenant si des jobs ouvrent des fichiers mais ne les ferme pas à cause d'une erreur dans leur JCL.

MAX_OPENS_PER_JOBS=

Nombre de fichiers qu'un seul job peut ouvrir en parallèle.

Valeurs autorisées : "0" à "32767"
Valeur par défaut : 1000

Cette limitation permet d'éviter des problèmes survenant si des jobs ouvrent des fichiers mais ne les ferme pas à cause d'une erreur dans leur JCL.

ft_temp_file=
ft_temp_file_oss=

Ce paramètre crée des fichiers temporaires dans les transferts de fichiers.

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 car seul un RunID est fourni. Le fichier est renommé une fois le transfert réussi.
"no" : l'agent attribue le nom de fichier final lorsque le transfert de fichier commence.

Si le système de fichiers OSS est utilisé, le paramètre file_temp_file_oss doit alors être utilisé.

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 !

Utilisez ce paramètre pour spécifier l'exécutable TACL qui doit être utilisé. L'environnement TACL standard est utilisé si ce paramètre n'est pas spécifié ou si vous n'indiquez aucune valeur.

Chaîne de caractères de sécurité pour les fichiers des jobs

Valeurs autorisées : "N" ou "JSecurity-String"

"N" : les fichiers des jobs doivent être créés avec l'utilisateur qui a démarré l'agent. La sécurité standard de l'utilisateur de l'agent est utilisée.

"JSecurity-String" : les fichiers des jobs doivent être créés avec l'utilisateur de l'objet Login du job. Indiquez la chaîne de caractères de sécurité à utiliser.

Par exemple :

JOBFILE_SEC=JNNNN

Contrôle du mot de passe pour les jobs

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

"Y" : pour chaque job, l'agent vérifie le mot de passe dans l'objet Login.
"N" : l'agent ne contrôle pas les mots de passe des jobs. Ce paramètre est utile si l'agent fonctionne sous super.super et que les mots de passe des utilisateurs des jobs ne sont pas connus ou si les mots de passe sont souvent modifiés.

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.

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

[VARIABLES]

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

[TRACE]

Les fichiers de trace sont limités à 200 Mo. L'agent crée un nouveau fichier si cette valeur a été atteinte.

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

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 : 30 secondes

port=

Numéro de port de l'agent.

Les autres agents et le messager de job se connectent à l'agent via ce numéro de port.

bindaddr=

Adresse IP ou nom d'hôte pour la connexion au processus serveur.

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) pendant 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.

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

report=

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

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

Taille du cache en octets pour les transferts de fichiers.

Valeur par défaut : 33000

Nous recommandons d'utiliser un cache de 33 000 octets pour la mémoire cache avec TCP/IPv6 et de 20 000 octets avec le TCP/IP habituel.

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 !

Envoie des signaux de vie afin que toutes les connexions agent restent actives.

Valeurs autorisées : "N" et "Y" (valeur par défaut)
"Y" : les signaux de vie sont envoyés
"N" : les signaux de vie ne sont pas envoyés.

[CP_LIST]

Liste des processus de communication

La liste est créée au démarrage de l'agent et étendue quand 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

Nom des fichiers StatusStore qui contiennent les informations de reprise.

Le nom du sous-volume est déjà indiqué dans le fichier INSTINI lors de l'installation et généré dans le fichier INI de l'agent avec les noms de fichiers standard (UC4SST, UC4SSD, UC4SSL, UC4SSH).