Manuel d'administration > Configuration > Organisation des fichiers de configuration > Fichier INI de l'Agent SAP

Agent SAP

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

Section/paramètre Description
[GLOBAL]  
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 vous ne saisissez pas de paramètre. 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 du fichier INI de Automation Engine.

language=

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.

logging=

Chemin et nom de fichier 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".

logcount=

Nombre des fichiers log sauvegardés.

Valeur par défaut : 1

LogMaxSize=

The maximum size of the log file in bytes.

A new log file will be created when the limit that has been defined here is reached.

Default value: 10 MB

The default value will be used when you set the value "0".

You can use one of the following prefixes with this value:
k...kilo, M...mega, G...giga

Examples: 100k corresponds to 100 kilobytes, 20M to 20 megabytes and 1G to 1 gigabyte.

The agent reads LogMaxSize, if a value is set, and is not 0, the value is used. If LogMaxSize doesn't exist, or is 0, the agent uses the max_logging_kb setting.

max_logging_kb=

Taille maximale du fichier log

Un nouveau fichier est créé si le fichier log atteint la taille spécifiée ici.

Valeur par défaut : 1 000 Ko

L'agent lit LogMaxSize, si une valeur non nulle est définie, la valeur est utilisée. Si LogMaxSize n'existe pas ou si elle est nulle, l'agent utilise le paramètre max_logging_kb.

helplib= Nom du fichier des messages.
helpcache= Disponibilité des messages et des chaînes de caractères en langues étrangères.

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

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

lower_case=

Ce paramètre convertit les entrées des attributs d'un Workflow en majuscules.

Valeurs autorisées : "YES" et "NO" (valeur par défaut)

"YES" : les entrées doivent être écrites en majuscules. Les minuscules ne sont pas converties automatiquement en majuscules.
"NO" : les minuscules sont converties automatiquement en majuscules.

maxEventTimeSpan=

Intervalle en secondes que l'agent utilise pour lire d'anciens événements SAP après une perte de connexion au système SAP.

Valeur par défaut : 600 secondes

Les événements de console surveillent les événements déclenchés dans SAP. Si l'agent perd sa connexion au système SAP, un certain nombre d'événements SAP s'accumulent et l'agent ne peut pas les transmettre aux événements de console. Une fois la connexion rétablie, l'agent vérifie à nouveau et rapporte ces événements SAP aux événements de console concernés.

L'agent ne lit pas tous les événements SAP en une seule fois en raison de la grande qualtité de données qui peut être impliquée. Chaque événement SAP est déclenché à un instant donné. L'agent récupère tous les événements SAP déclenchés pendant la perte de connexion dans l'historique des événements de SAP. Il utilise l'intervalle qui a été défini dans le paramètre maxEventTimeStamp=.

Par exemple :

La valeur pour maxEventTimeStamp= est définie à 600. Cela correspond à 10 minutes. JOB_CHECKINTERVAL est défini à 60, ce qui correspond à 1 minute. L'agent n'est pas connecté au système SAP entre 10 h 00 et 10 h 30. Les événements SAP qui se sont déclenchés pendant cette période sont récupérés de la façon suivante :

Les événements SAP entre 10h00 et 10h10 sont récupérés à 10h30.
A 10h31, ceux déclenchés entre 10h10 et 10h20.
A 10h32, ceux déclenchés entre 10h20 et 10h30.
A 10h33, ceux déclenchés entre 10h30 et 10h33.
A 10h34, ceux déclenchés entre 10h33 et 10h34.
etc.

Joblog_blocksize=

Nombre de lignes de rapport devant être transférées en blocs vers AE.

Valeur par défaut : 0 ligne

La valeur "0" signifie que le rapport du job est transféré dans son intégralité.

Le paramètre a été implémenté sur AIX en raison d'un problème de mémoire de la bibliothèque RFC de SAP (pour plus d'informations, reportez-vous à la note 792767). Dans SAP, vous pouvez limiter les rapports de job. Cette solution n'est pas adaptée pour les clients qui utilisent un planificateur de tâches comme AE, car l'ensemble du rapport de job doit être transféré. Ainsi, AE fournit une solution de contournement sous la forme de ce paramètre. Les rapports de jobs longs sont transférés vers AE blocs par blocs, évitant ainsi les problèmes de mémoire car cette méthode consomme moins de mémoire.  Notez que plus de ressources SAP sont nécessaires dans ce cas. Ce contournement ne s'applique que pour l'interface AE car AE n'a aucune influence sur l'interface XBP de SAP.

userid_type=

Paramètre complémentaire qui permet d'autoriser ou de rejeter 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.

SAP_language=

Vous devez vous reconnecter à SAP si le langage a été modifié.

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

"0" : les langues qui sont spécifiées dans le paramètre language= sont utilisées.
"1" : l'agent utilise le langage défini dans le job pour se connecter à SAP.

Download_dir=

Répertoire dans lequel les listes de spool doivent être enregistrées.

Ce paramètre concerne les éléments de script suivants dans lesquels la requête de la liste de spool est activée avec le paramètre GET_SPOOL :

  • R3_ACTIVATE_REPORT
  • R3_ACTIVATE_JOBS
  • R3_ACTIVATE_INTERCEPTED_JOBS
  • BW_ACTIVATE_CHAIN
  • BW_RESTART_CHAIN

Les listes de spool sont enregistrées sous forme de fichiers texte, le nom de fichier suivant est alors utilisé :
<Numéro de job SAP>_<numéro de step>_<numéro de spool>.txt

Si ce paramètre n'est pas défini, le répertoire temp de l'agent est utilisé.

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

Les Agents Java (SAP, RA, base de données et JMX) exécutés sous UNIX créent le fichier de certificat avec l'autorisation "-rw-r--r—". D'autres utilisateurs du système d'Exploitation peuvent ainsi éventuellement accéder à ce fichier !

[USERID]

Spécification des utilisateurs SAP autorisés au format :
Numéro de client
/nom d'utilisateur=START

Spécification des utilisateurs SAP non-autorisés au format :
Numéro de client
/nom d'utilisateur=NO_START

[SAP_BW]

Paramètre pour SAP BW.

Enabled=

Utilisation de l'interface

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

"0" : l'interface n'est pas utilisée
"1" : l'interface est utilisée

[SAP_XI]

 

Enabled=

Utilisation de l'interface

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

"0" : l'interface n'est pas utilisée
"1" : l'interface est utilisée

[SAP_BCA]

 

Enabled=

Utilisation de l'interface

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

"0" : l'interface n'est pas utilisée
"1" : l'interface est utilisée

[SAP_BASIS]  
Version=

Version logicielle du système SAP.

Par défaut, ce paramètre et cette section ne sont pas inclus dans le fichier INI. Ce paramètre est utilisé pour définir la variable d'agent UC_HOST_SW_VERS. La valeur spécifiée ici est affichée dans la supervision système dans la colonne "Version SW" de l'agent.

Par exemple : L'agent s'exécute sur une plateforme SAP dotée de la version 7.0 du logiciel.

[SAP_BASIS]
Version=7.00

[SAP_SMSE]  
WebStartURL=

URL de l'application web qui contient l'interface utilisateur.

Pour appeler l'interface utilisateur directement via le Manager de solutions SAP, vous devez spécifier ce paramètre. Vous trouverez plus d'informations à ce sujet dans les Intégration de l'Automation Engine à SAP Solution Manager.

[TRACE]  Les indicateurs de trace ne doivent être définis qu'en coopération étroire avec le support Automic.
file= Chemin et 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".

trccount=

Nombre des fichier de trace sauvegardés.

Valeur par défaut : 1

max_trace_kb=

Taille maximale du fichier de trace

Un nouveau fichier de trace est créé quand le fichier atteint la taille spécifiée ici.

Valeur par défaut : 1 000 Ko

tcp/ip=
jcl=
Indicateurs de trace pour la communication TCP/IP de l'agent.

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

rfc=

Trace RFC

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

Utilisez les paramètres SAP suivants pour éviter que la trace du système SAP soit acceptée :

rdisp/accept_remote_trace_level = 0

Ce paramètre peut également être intéressant à cet égard : gw/accept_remote_trace_level (voir également le conseil SAP 357683).

[TCP/IP]

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

bindaddr=

 

connect=

 L'intervalle de temps en secondes durant lequel l'agent tente d'établir une connexion au Automation Engines concerne l'établissement de la connexion lors d'un redémarrage ou après une perte de connexion.

Valeur par défaut : 60

Ce paramètre est valide uniquement jusqu'à la première connexion réussie de l'agent au système AE. Ensuite, vous pouvez utiliser le paramètre RECONNECT_TIME de la caractéristique de l'hôte.

report=

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

Valeur par défaut : 60

CP=

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

[VARIABLES]

Cette section inclut les variables d'agent contenant des informations et des paramètres pour l'agent.

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

Le processus de communication qui a été 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

Exemple de fichier INI

[GLOBAL]
name=SAP01
system=UC4
language=(E,D)
logging=..\TEMP\UCXJR3X_LOGG_SID_##.TXT
logcount=10
helplib=uc.msl
helpcache=ALL
lower_case=NO
maxEventTimeSpan=600
joblog_blocksize=0

[AUTHORIZATION]
InitialPackage=
KeyStore=

[SAP_BW]
Enabled=0

[SAP_XI]
Enabled=1

[SAP_BCA]
Enabled=0

[TRACE]
file=..\TEMP\UCXJR3X_TRACE_##.TXT
trccount=10
tcp/ip=0
jcl=
rfc=0

[TCP/IP]
bindaddr=
bindlocal=0
connwait=20
connect=60
report=60
cp=uc4srv01:2217

[VARIABLES]
UC_HOST_CODE=UC_CODE
UC_HOST_JCL_VAR=SAP
UC_EX_PATH_BIN=C:\AUTOMIC\AGENTS\SAP\BIN\
UC_EX_PATH_TEMP=C:\AUTOMIC\AGENTS\SAP\TEMP\
UC_EX_PATH_JOBREPORT=C:\AUTOMIC\AGENTS\SAP\TEMP\
UC_EX_JOB_MD=

[CP_LIST]
22187=PC01 

 

Rubriques connexes :

Conseils d'adaptation des fichiers de configuration