Agent z/OS

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

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.

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

Mettez ce paramètre en commentaires ; ainsi le fichier log sera enregistré dans le JES. Reportez-vous à la description du paramètre logpurgeclass= ci-dessous.

Les paramètres suivants peuvent être ajoutés si le log est écrit dans un jeu de données (après le nom du jeu de données et séparés par des points-virgules) :

"recfm" = (les 27 formats d'enregistrement de z/OS ainsi que * et A sont tous valides)
"lrecl" = (0, chaque nombre positif jusqu'à 32760 et X pour chaque Reclen)
"blksize" = (0, chaque nombre positif jusqu'à 32760)
"space" = ([CYL,TRK],(prim,sec,répertoire))  

logpurgeclass=

Classe MVS Sysout pour les fichiers log.

Valeurs autorisées : A-Z et 0-9
Valeur par défaut : "A"

Ce paramètre peut être utilisé pour renvoyer les fichiers log vers la classe MVS Sysout spécifiée.

La classe Sysout n'est prise en compte que si le paramètre logging= est mis en commentaires (";").

Le paramètre logcount= joue également un rôle important dans le renvoi des fichiers log. Autant de fichiers log sont créés que le nombre défini dans ce paramètre. Si ce nombre est dépassé, le fichier log le plus ancien est transféré à la classe Sysout.

Par exemple :

Le paramètre logcount= est défini à 3. Le premier fichier est renvoyé à la classe Sysout quand le quatrième fichier log est créé.

helplib=

Nom du fichier des messages

Valeurs autorisées : "ALL" (valeur par défaut), "NONE", "CONTROLS"

"ALL" : l'ensemble du fichier des messages est stocké en RAM.
"NONE" : le fichier des messages est toujours lu sur le disque dur.
"CONTROLS" : toutes les chaînes en langues étrangères nécessaires à l'affichage d'un programme de dialogue sont stockées en RAM (ne concerne pas les agents).

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

askRACF=

Vérification des autorisations d'accès avec RACF pour les jobs et les transferts de fichiers avant le démarrage de l'agent (vérification du mot de passe pour l'utilisateur du job ou du transfert de fichiers et vérification des autorisations du jeu de données lors du transfert de fichiers). Cela génère des messages d'erreur de l'agent plus précis et évite un démarrage inutile de la tâche si l'autorisation appropriée fait défaut. Le système de sécurité vérifie le job en cours d'exécution dans tous les cas.

Vosu pouvez désactiver cette entrée avec la valeur "0" si RACF n'est pas installé sur cet hôte.

Valeurs autorisées : "0" à "15"
Valeur par défaut : "7"

Valeur	Contrôle de Login pour les jobs	Contrôle de Login pour les transferts de fichiers	Contrôle d'accès au fichier pour les transferts de fichiers avec l'ID utilisateur du login	Contrôle d'accès au fichier pour transferts de fichiers avec l'ID utilisateur de l'agent
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

completeJobout=

Ce paramètre détermine la complexité du rapport du job

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

"0" : seules les statistiques JES (JESMSGLG, JESJCL et JESYSMSG) sont enregistrées dans AE.
"1" : le rapport de job complet (statistiques JES + rapport de job) est enregistré dans AE.

Ce paramétre peut être remplacé dans l'objet job et dans le script par des attributs. Vous trouverez plus d'informations dans le document qui décrit les  classes de message.

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

"0" : le rapport du job reste tel quel dans le JES
"1" : le rapport du job est supprimé de JES

Ce paramétre peut être remplacé dans l'objet job et dans le script par des attributs. Vous trouverez plus d'informations dans le document qui décrit les  classes de message.

relMsgClass=

Ce paramètre libère le log du job pour l'impression.

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

"0" : le log du job n'est pas libéré.
"1" : le log du job est libéré pour l'impression.

Ce paramétre peut être remplacé dans l'objet job et dans le script par des attributs. Vous trouverez plus d'informations dans le document qui décrit les  classes de message.

getMsgClass=

Classes de message devant être lues et renvoyées par la suite.

Indiquez une ou plusieurs classes de message. Exemples : "A", "ABC", "X1". L'ordre ne joue ici aucun rôle.

Ce paramètre peut être remplacé dans l'objet job ou dans le script par des attributs. Vous trouverez plus d'informations dans le document qui décrit les classes de message.

routeMsgClass=

Classes de message vers lesquelles un renvoi est nécessaire.

Après le transfert dans AE, le log du job peut aussi être renvoyé vers les classes de message spécifiées (par exemple pour un système de gestion des sorties).

Saisissez une ou autant de classes de messages que vous avez spécifiées dans le paramètre getMsgClass=.L'ordre joue ici un rôle important.

Par exemple :

Les classes de message suivantes sont lues : "ABC"
et renvoyées comme suit : "DEF"

La classe "A" devient classe "D", "B" devient "E" et "C" devient "F".

Ce paramètre peut être remplacé dans l'objet job et dans le script en utilisant des attributs. Vous trouverez plus d'informations dans le document qui décrit les classes de message.

jes=

Job Entry Subsystem (JES) qui a été installé sur l'hôte.

Valeurs autorisées : "JES2" (valeur par défaut), "JES3"

JobACF2=

Génération de la carte de job au format ACF2.

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

"0" : aucune génération de la carte de job au format ACF2.
"1" : la carte de job est générée au format ACF2.

userid_type=

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

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

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

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

"0" : pas d'ajout de parenthèse aux informations de compte.
"1" : des parenthèses sont ajoutées aux informations de compte.

JobCancel=

Commande d'interruption pour les jobs envoyée à la console.

Valeurs autorisées :

$C &01 : le nom du job est inséré à la place de la variable &01.
$C &02 : l'ID du job est inséré au format JOB12345 à la place de la variable &02 (valeur par défaut).
$CJ&03 : l'ID du job aux formats 12345 ou 1234 est inséré à la place de la variable &03.

Tous les paramètres prennent en charge des ID de job comportant 5, 6 ou 7 caractères.

JobOutputAllocation=

Allocation du rapport du job (première extension des cylindres, cylindres secondaires).

Format : (nombre de cylindres,nombre de cylindres)

Valeur par défaut : (1,1)

Le paramètre "jobSubmitContext=" peut être défini à l'une de ces valeurs :

AGENT (par défaut): le job est soumis au lecteur interne dans le contexte de l'agent.

UTILISATEUR : le job est soumis au lecteur interne dans le contexte de l'utilisateur du job spécifié dans l'objet Login utilisé dans le job.

Format : chaîne de caractères

vanishedRetry=

Si l'agent s'exécute pendant un changement de statut ou un échec de récupération du statut lors de la vérification d'un job (situation rare), le statut du job ne pourrait pas être clairement déterminé. Ce paramètre permet de spécifier le nombre de tentatives de vérification du statut effectuées par l'agent avant qu'il ne signale le statut "ENDED_VANISHED".

Valeurs autorisées : 0 – 9999
Valeur par défaut : "6"

waitSpoolRetry=

Répétition de la durée d'attente (voir paramètre waitSpoolReady).

Valeurs autorisées : 0 – 99
Valeur par défaut : "6"

waitSpoolReady=

Durée d'attente du spool en centièmes de seconde.

Parfois, la préparation du spool peut prendre un peu de temps si l'agent fonctionne sur un autre LPAR dans un Sysplex parallèle. Ce paramètre permet de rallonger la durée d'attente.

Valeurs autorisées : 0 – 9999
Valeur par défaut : "50"

WaitOnJobEnd=

Attend la fin du job.

Par défaut, l'agent attend que le job arrive dans la queue de sortie ou qu'il disparaisse. Dans certains cas, le Job est déjà terminé, mais ne se trouve pas encore dans la file de sortie parce qu'il est en attente d'un événement de système (par ex. changement de bande). Vous pouvez utiliser ce paramètre pour définir si l'agent doit vérifier le statut de fin du job quand il est terminé. Si le job ne se trouve pas dans la queue de sortie, il est surveillé via la vérification périodique du job.

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

"0" : l'agent n'attend pas.
"1" : l'agent attend la fin du job.

ignoreEmptyJCL=

Traitement des lignes vides dans le JCL.

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

"0" : le JCL reste inchangé.
"1" : l'agent supprime automatiquement les blancs du JCL avant de l'exécuter.

ft_temp_file=

Création de fichiers temporaires lors du transfert de fichier

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

"yes" : le fichier reçoit un nom temporaire composé du nom du jeu de données du fichier à transférer et d'un suffixe. Le suffixe comprend la lettre "T" et une chaîne alphabétique provenant du RunID. 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 est renommé une fois le transfert de fichier réussi.

Si le nom temporaire du fichier excède les 44 caractères autorisés dans z/OS, le fichier reçoit immédiatement son nom définitif.

"no" : l'agent attribue le nom de fichier définitif dès le début du transfert de fichier.

Si le système de fichiers USS est utilisé, le paramètre file_temp_file_uss doit alors être appliqué !

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 !

EventCheckIntervall=

Vérification périodique d'événement en secondes

Valeur par défaut : 3600

Ne sélectionnez pas une valeur trop faible afin d'éviter de surcharger inutilement le serveur.

Utilisation de majuscules et de minuscules dans les mots de passe

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

"0" : l'agent convertit tous les mots de passe en majuscules.
"1" : le mot de passe reste inchangé.

Veillez à ce que les paramétres du mot de passe s'accorde avec ceux de votre système, sans quoi la connexion de l'agent échouerait.

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

Default value: "No"

Allowed values: "Yes" or "No"

• Value "No": The authorization of the user starting the FileTransfer will be checked, but the FileTransfer will be executed with the authorization of the user starting the agent.
• Value "Yes": On starting the FileTransfer a switch inside the FileTransfer's thread will be executed to the user context of the user, whose data has been entered in the Login object, which is referenced in the FileTransfer object. Any input and output will be executed with the permissions of the user starting the FileTransfer.

(JCL-EXIT)

name=

Nom du module Exit JCL basé sur l'assembleur.

Le module basé sur l'assembleur est utilisé lorsque vous ne spécifiez pas l'Exit JCL basé sur le C (le paramètre ExitModul= est manquant ou ne contient pas de valeur).

maxJclRecords=

Taille de la zone de sortie

Nom du fichier DLL ou du module Exit JCL basé sur le langage de programmation C.

L'Exit JCL basé sur l'assembleur est utilisé lorsque vous ne précisez pas ce paramètre ou lorsqu'il ne comprend pas de valeur.

Nom de la fonction du module qui implémente l'Exit JCL.

Il fait référence au module Exit JCL qui est spécifié dans le paramètre ExitModul=.

L'agent appelle cette fonction avant d'exécuter le JCL du job. Si cette fonction renvoie un code autre que 0, le JCL ne sera pas traité et le job est interrompu.

Valeur par défaut : "jcl_exit"

Fonction qui initialise le module Exit du JCL (allocation de mémoire, par exemple) et qui est appelée lorsque l'agent démarre.

Si cette fonction renvoie un code autre que 0, l'Exit JCL basé sur C est désactivé.

Ce paramètre est facultatif et fait référence au module Exit JCL qui est spécifié dans le paramètre ExitModul=.

Fonction qui doit être appelée lorsque l'agent se termine afin d'exécuter des traitements finaux tels que la libération de mémoire).

Ce paramètre est facultatif et fait référence au module Exit JCL qui est spécifié dans le paramètre ExitModul=.

(USERID)

Indication des utilisateurs z/OS autorisés au format :
Nom d'utilisateur=START

Indication des utilisateurs z/OS interdits au format :
Nom d'utilisateur=NO_START

(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 en cours ait toujours le numéro "00".

Les paramètres suivants peuvent être ajoutés (après le nom du jeu de données, séparés par des points-virgules) si le log est écrit dans un jeu de données :

"recfm" = (les 27 formats d'enregistrement de z/OS ainsi que * et A sont tous valides)
"lrecl" = (0, chaque nombre positif jusqu'à 32760 et X pour chaque Reclen)
"blksize" = (0, chaque nombre positif jusqu'à 32760)
"space" = ([CYL,TRK],(prim,sec,répertoire))  

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

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

trcmode=

Méthode selon laquelle les fichiers de trace sont générés.

Valeurs autorisées : "0" à "3"
Valeur par défaut : "1"

"0" : le fichier de trace est écrit normalement.
"1" : tous les tampons de fichier sont écrits sur le disque après chaque ligne de trace.
"2" : close/open est utilisé sur le fichier de trace après chaque ligne de trace. N'utilisez pas cette option si vous travaillez avec des événements de système de fichiers, car elle crée un événement pour chaque ligne, ce qui peut entraîner la création de boucles infinies récursives !
"3" : les sorties de trace sont également écrites dans le fichier log.

(TCP/IP)

cp=

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

Formats autorisés :
Nom DNS:numéro de port
Adresse TCP/IP:numéro de port

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 de 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 avec port=
(format : port=adresse IP:port ou. nom DNS:port). La valeur de bindaddr= est alors 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 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 avec les Automation Engine (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 (voir 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

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

Valeur par défaut : 20 secondes

AsyncConnect=

L'agent essaie de se connecter à un processus de communication si la connexion a été perdue. S'il n'y parvient pas, il essaie de se connecter à un autre processus de communication après une certaine durée d'attente. Automic recommande de spécifier AsyncConnect=1, car cela permet de raccourcir la durée d'attente.

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

Valeur par défaut : 500 000

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

Valeur par défaut : 262144 octets

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

Valeur par défaut : 262144 octets

Paramétrage des signaux de vie pour le maintien de la connexion entre l'agent et le moniteur d'événements.

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.

Specifies the maximum number of connection requests queued for the listening socket of the agent.

This parameter cannot be used to provide a higher number than the system parameter SOMAXCONN.

For example, if Listen=500 is set here, and the system parameter SOMAXCONN is set to 10, the maximum of 10 is used.

Therefore, it makes the most sense to set both parameters to the same value. The value depends on the number of parallel connections of messengers and file transfers. However, the recommended technique is to use the SMF based messaging technique rather than IP messenger.

For more information on the SOMAXCONN statement in the system's TCP/IP profile, see http://www-01.ibm.com/support/knowledgecenter/SSLTBW_2.1.0/com.ibm.zos.v2r1.halz001/somaxconnstatement.htm.

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

(CP_LIST)

Liste des processus de communication

La liste est créée au démarrage de l'agent et étendue quand de nouveaux processus de communication sont activés. Vous trouverez plus d'informations sur l'établissement de 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 des CP.

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