Agent VMS

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 xx du nom de fichier sont des caractères de remplacement. Ils représentent le code à deux caractères de la version de VMS. Rubriques connexes : Terminologie.

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 telle manière que le fichier log en cours porte toujours le numéro "00".

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

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

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

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

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

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

"INCL" : l'accès doit être autorisé pour chaque utilisateur AE sous [UC_USER].
"EXCL" : l'accès est refusé aux utilisateurs AE spécifiés sous [USERID]. Tous les autres utlisateurs AE peuvent démarrer des jobs.

Valeur par défaut : 30 secondes

uc4_logical=

Définition du nom logique (saisie convertie en majuscules).

Si ce paramètre n'est pas spécifié, le nom logique est créé comme suit :
UC4_nom du système AE_nom de l'agent_Agent

ReadUserAlways=

Vous pouvez autoriser ou rejeter des ID utilisateurs en utilisant le paramètre userid_type= dans la section [USERID]. Vous pouvez utiliser le paramètre ReadUserAlways= pour spécifier si cette section doit toujours être lue avant le démarrage d'un job ou une seule fois au démarrage de l'agent. La lecture de cette section une seule fois accroît la performance et représente donc la valeur par défaut. 

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

yes : l'agent lit la section [USERID] avant chaque démarrage de job.
no : la section est lue uniquement au démarrage de l'agent.

ft_temp_file=

Création de fichiers temporaires lors du  transferts de fichier.

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

yes : le fichier obtient un nom temporaire composé de la lettre "T" suivie du RunID converti en lettres. Le nouveau transfert de fichier ajoute un ID de fichier pour obtenir un nom de fichier unique parce que seul un RunID est fourni. Le fichier 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.

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 !

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

[USERID]

Saisie des utilisateurs VMS autorisés au format :
Nom d'utilisateur=START

Saisie des utilisateurs VMS interdits au format :
Nom d'utilisateur=NO_START

Saisie des utilisateurs AE autorisés au format :
ID utilisateur=NO_START

Cette section contient des variables d'agent comprenant des informations et des paramètres relatifs à l'agent.

La variable UC_EX_JOB_MD permet de définir le nom du programme du messager de job (par défaut : UCXJVxxM).
xx étant l'abréviation de la plateforme correspondante.. Sous VMS, ce caractère de remplacement ne permet pas de trouver automatiquement le messager de job approprié (contrairement à UNIX). Cette variable d'agent doit par conséquent être définie dans le fichier INI, en fonction du système VMS sur lequel l'agent est exécuté :

• OpenVMS (IA64) :
  UC_EX_JOB_MD = UCXJVI8M
  
• Alpha :
  UC_EX_JOB_MD = UCXJVA7M
  
• VAX :
  UC_EX_JOB_MD = UCXJVV7M

Les caractères xx du nom de fichier sont des caractères de remplacement. Ils représentent le code à deux caractères de la version de VMS. Rubriques connexes :Terminologie.

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 manière à ce que le fichier de trace en cours porte toujours le numéro "00".

tcp/ip=
event=
job_debug=
ft_debug=
ex_init=
signal=
memory=

Valeurs autorisées : "0" (valeur par défaut) à "9"

Les indicateurs de trace doivent être utiisés en coopération avec le support Automic.

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

[TCP/IP]

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 au processus serveur

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 avec port=

(format : port=adresse IP:port ou. nom DNS:port). Les spécifications de 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. Ceci concerne l'établissement d'une connexion lors d'un redémarrage ou après une perte de connexion.
Pour des raisons de compatibilité, le nom du paramètre précédent alarme= est encore valide.

Valeur par défaut : 60 secondes

maxrepcnt=

Nombre maximal de blocs de rapport qui doivent être transférés simultanément aux Automation Engine.

Valeur par défaut : 8 blocs

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

Valeur par défaut : 500 000

Intervalle de temps en secondes pendant lequel les signaux de vie sont envoyés pour conserver les connexions.

La valeur par défaut qui dépend de l'environnement système est utilisée si le paramètre n'est pas défini ou s'il est défini à 0.

Si l'agent est exploité sous VAX, le paramètre n'aura aucun effet.

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

[STARTCMD]

SUBMIT=

Commande VMS pour démarrer le job en mode batch. Peut être adapté à l'utilisateur à l'aide d'autres paramètres SUBMIT.

Vous pouvez par exemple configurer une queue batch propre à AE, définir sa priorité et la spécifier ici comme paramètre.Exemple : /QUEUE=UC4$BATCH

Si aucun paramètre queue n'est indiqué, les jobs démarrent dans la queue par défaut SYS$BATCH.

ACCESS=

Indication des attributs de fichiers pour les transferts de fichiers.

Valeurs autorisées : "alq", "deq", "mbc", "mbf" et "fop"

"alq" : nombre de blocs de disque utilisés par défaut par le transfert de fichier (1 bloc = 512 octets).
"deq" : nombre de blocs de disque pour l'extension de la mémoire nécessaire.
"mbc" : nombre de blocs alloués au tampon d'E/S.
"mbf" : nombre de tampons d'E/S à allouer.
"fop" : cet attribut de fichier supporte les paramètres suivants : cbt (contiguous-best-try), ctg (contiguous) et tef (truncate at end-of-file). Ils sont séparés par une virgule (par exemple, fop=ctg,tef).

Automic recommande d'utiliser les valeurs suivantes : alq=5000,deq=5000,mbc=64,mbf=64

Notez que le paramètre du fichier INI est lu à chaque exécution du transfert de fichier. Les attributs du fichier peuvent être modifiés au cours de l'exécution de l'agent.

Si vous pécifiez les attributs du fichier directement dans le transfert de fichier, ils seront utilisés à la place des attributs définis dans le fichier INI.

[JOBREPORT]

reportname=

Définition du nom du rapport de job.

Les caractères de remplacement autorisés dans le nom de fichier sont : "&userid", "&vms-Jobname", "&AE-Jobname", "&client" et "&runnr"

"&userid" : ID utilisateur de l'exécution du job
"&vms-Jobname" : nom du job dans VMS
"&AE-Jobname" : nom de l'objet job AE
"&client" : numéro du client dans lequel le job a été démarré
"&runnr" : RunID (numéro d'exécution) du job.

Avec la variable d'agent UC_EX_PATH_JOBREPORT, vous pouvez définir le répertoire dans lequel les rapports du job doivent être enregistrés.

[MISC]

FileNameLowerCase=

Le nom du fichier est important pour la fonction de script PREP_PROCESS_FILENAME et pour les transferts de fichier génériques. Ce paramètre permet de définir si l'agent doit laisser le nom de fichier inchangé ou s'il doit être converti en minuscules.

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

"yes" : les noms de fichier sont toujours convertis en minuscules.
"no" : l'agent ne modifie pas la casse du nom du fichier.

TraceFileSize=

Taille maximale d'un fichier de trace. Si cette valeur est atteinte, l'agent crée un nouveau fichier.

Valeur par défaut : "32M"

Saisissez un chiffre suivi d'un "K" pour kilooctets ou d'un "M" pour mégaoctets. L'agent interprète le nombre comme des octets si l'unité de mesure n'a pas été spécifiée.

FileEndDelimiter=

Ajoute un retour à la ligne (LF) à la fin des fichiers texte qui ont été transférés via le transfert de fichier.

Dans VMS, chaque fichier texte nécessite un retour à la ligne à sa fin.

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

"yes" : lors du transfert de fichier, l'agent insère toujours un retour à la ligne (LF) à la fin des fichiers texte s'il est le destinataire. Cela dépend de la présence d'un retour à la ligne à la fin des fichiers.
"no" : les fichiers sont transférés sans modification.

[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 inclus dans la liste.

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