Liste der Agentenvariablen

Agentenvariablen speichern Agenteninformationen und -einstellungen. Sie sind entweder als VARA-Objekte im Mandanten 0 verfügbar oder werden direkt in der Datenbank gespeichert. In letzterem Fall spricht man von virtuellen Agentenvariablen. Informationen zu Agentenvariablen und deren Syntax finden Sie unter Virtuelle Agenten-VARA-Objekte.

Dieses Thema enthält die Liste der verfügbaren Agentenvariablen.

Agentenvariablen in Mandant 0

• UC_EX_ERP_CONNECT - Verbindung zu Enterprise Business Solutions

  Enthält die Verbindungsdaten zur jeweiligen Enterprise Business Solution.

• UC_HOSTCHAR_DEFAULT - Host-Charakteristik

  Beinhaltet bestimmte Einstellungen für einen oder mehrere Agenten.

Virtuelle Agentenvariablen

Virtuelle Agentenvariablen werden im Allgemeinen im Abschnitt [VARIABLES] der INI-Datei des Agenten definiert. Es gibt auch Agentenvariablen, deren Werte automatisch vom Agenten ermittelt werden. In diesem Fall sind sie nicht in der INI-Datei anzugeben (siehe Tabelle unten).
Beim Start des Agenten werden alle virtuellen Variablen an die Automation Engine übermittelt.

Wichtig! Es ist nicht möglich, andere Variablen zu definieren, als die unten aufgeführten. Werden trotzdem benutzerdefinierte Variablen erstellt, so können diese nicht ausgelesen werden.

Folgende Agentenvariablen stehen zur Verfügung:

• UC_EX_DAYLIGHT

  • Beschreibung:Prüft, ob derzeit Sommerzeit ist. Der Agent ermittelt aus der Systemzeit, ob Sommerzeit ist und übermittelt diese Information an die Automation Engine.

  • Erlaubte Werte: Y und N, wo

    • Y = Sommerzeit
    • N = Winterzeit
      
  • Definition via INI-Datei: Der Wert dieser Variable wird automatisch gesetzt und kann daher nicht über die INI-Datei festgelegt werden.

• UC_EX_HOST_ROLE

  • Beschreibung: Rolle des Agenten, d. h. Name, der in Agentengruppen (HOSTG) als Filter verwendet werden kann. Wenn Sie mehrere Rollennamen eingeben, trennen Sie diese mit einem ";". Kleinbuchstaben werden automatisch in Großbuchstaben umgewandelt.

    Auf den Agenten selbst hat diese Angabe keine Auswirkung.

  • Erlaubte Werte: Maximal 256 Zeichen.

  • Definition via INI-Datei: Ja

• UC_EX_IP_ADDR

  • Beschreibung: IP-Adresse oder Name des Agenten.

    Der Agent ermittelt beim Start die IP-Adresse seines Rechners automatisch und übermittelt diese an die gespeichert wird. Er gibt diese Informationen an Automation Engine weiter, wo sie in dieser Variable gespeichert werden.

    Die Automation Engine verwendet die IP-Adresse und die Portnummer des Agenten (Variable UC_EX_IP_PORT) in den Header- und Trailer-Includes und gibt diese Informationen an den Jobmelder weiter. Der Jobmelder versucht mit diesen Verbindungsdaten den Agenten zu erreichen.

    Läuft der Agent in einem Cluster, kann hier die virtuelle IP-Adresse des Clusters eingetragen werden. Details dazu finden Sie unter Automation Engineund Cluster

    (z/OS-Agent) Vom Agenten selbst werden diese Werte nur bei Sysplex-Konfigurationen eines z/OS Mainframe-Systems verwendet.

  • Definition via INI-Datei: Nein

• UC_EX_IP_PORT

  • Beschreibung: Port des Agenten.
  • Definition via INI-Datei: Nein

• UC_EX_JOB_MD

  • Beschreibung: Pfad und Dateiname des Jobmelders. Der Agent prüft beim Start den Wert und wird beendet, wenn der Pfad ungültig ist.

    Der Wert wird in den Header- und Trailer-Objekten verwendet, in welchen die Melderaufrufe für den Start und das Ende des Jobs definiert sind.

  • Erlaubte Werte:

  • Definition via INI-Datei: Pflichtfeld

• UC_EX_MIB_INFO

  • Beschreibung: Zusätzliche Informationen zum Agenten für die MIB (7.1.1.16).
  • Definition via INI-Datei: Nein

• UC_EX_MIB_MONITORING

  • Beschreibung: Gibt an, ob die Verfügbarkeit des Agenten überwacht wird.

  • Erlaubte Werte: 0 und 1, wo

    • 0 = Die Verfügbarkeit des Agenten wird nicht überwacht.
    • 1 = Die Verfügbarkeit des Agenten wird überwacht.
  • Definition via INI-Datei: Nein

• UC_EX_PATH_BACKUP

  Nur Windows- und UNIX-Agenten.

  • Beschreibung: Verzeichnis, in dem die Backup-Dateien des dateibasierten Rollbacks von Jobs und Dateiübertragungen abgelegt werden. Details dazu finden Sie auf der Seite „Rollback“.

    Existiert das Verzeichnis nicht, so wird es beim Agentenstart angelegt.

    Innerhalb des Backup-Ordners sind die Dateien in folgender Struktur abgelegt /<Mandant>/<Datum>/<RunID>/.

    Beim Start des Agenten wird automatisch das Backup-Verzeichnis angelegt, welches für das dateibasierte Rollback verwendet wird. Dieses ist bei Jobs & Dateiübertragungen verfügbar. Der Pfad des Backup-Verzeichnisses wird mit der Agentenvariable UC_EX_PATH_BACKUP festgelegt.

    Hinweis: Wollen Sie das dateibasierte Rollback nutzen, so benötigen die Betriebssystem-Benutzer, unter welchem die Jobs und Dateiübertragungen dafür gestartet werden, Schreibrechte auf das Backup-Verzeichnis.

  • Standardwert:

    • (Windows) ..\BACKUP"
    • (UNIX) ../backup
  • Definition via INI-Datei: Ja

• Agentenvariable: UC_EX_PATH_BIN

  • Beschreibung: Verzeichnis, in das der Agent installiert wurde. Der Agent prüft beim Start den Wert in diesen Variablen und wird beendet, wenn der Pfad ungültig ist.

  • Erlaubte Werte: Der Pfad zum Arbeitsverzeichnis kann als relativer oder absoluter Pfad definiert werden. Wenn alle Agentenvariablen definiert sind, ist die Definition als absoluter oder relativer Pfad möglich.

  • Definition via INI-Datei: Pflichtfeld

• Agentenvariable: UC_EX_PATH_CACHE

  • Beschreibung: Das Verzeichnis dient zum Speichern von mandantenweiten Ressourcen.

    Im mandantenweiten Ressourcenverzeichnis müssen Sie unbenutzte Dateien selbst bereinigen.
    Der jobspezifische Cache wird vom Automation Engine-System bereinigt, da dessen Ressourcen jeweils nur von dem betreffenden Job genutzt werden.

  • Definition via INI-Datei: Ja

• Agentenvariable: UC_EX_PATH_JOBREPORT

  • Beschreibung: Verzeichnis, in das der Agent Job-Reports speichert. Der Agent prüft beim Start den Wert und wird beendet, wenn der Pfad ungültig ist.

    Hinweis: Der SAP-Agent legt in diesem Verzeichnis auch die Restart-Dateien ab.

  • Definition via INI-Datei: Pflichtfeld

• Agentenvariable: UC_EX_PATH_TEMP

  • Beschreibung: Verzeichnis, in das der Agent temporär die generierten Jobs speichert. Der Agent prüft beim Start den Wert und wird beendet, wenn der Pfad ungültig ist
  • Definition via INI-Datei: Pflichtfeld

• Agentenvariable: UC_EX_PATH_TEMP_IFS

  OS/400-Agenten nur, wenn IFS im store_key-Parameter in der INI-Datei gesetzt ist. Information dazu finden Sie unter Agent OS/400 .

  • Beschreibung: IFS-Verzeichnis, in welchem die StatusStore-Dateien von Dateiübertragungen abgelegt werden.

  • Definition via INI-Datei: Ja

• Agentenvariable: UC_EX_VERSION

  • Beschreibung: Version des Agenten. Der Wert wird durch den Agenten automatisch ermittelt.
  • Definition via INI-Datei: Nein

• Agentenvariable: UC_HOST_CODE

  • Beschreibung: Name der Codetabelle des Mandanten 0. Die darin definierte Zeichenumsetzung wird beim Transport des Jobs zum Agenten und bei der automatischen Dateiübertragung des Job-Reports verwendet.

  • Standardwert: UC_CODE

  • Definition via INI-Datei: Ja

• Agentenvariable: UC_HOST_CONN_ABAP

  • Beschreibung: Verbindungsobjekt für die ABAP-Basis, das im Agentenobjekt eingetragen werden soll.
  • Definition via INI-Datei: Ja

• Agentenvariable: UC_HOST_CONN_JAVA

  • Beschreibung: Verbindungsobjekt für die Java-Basis, das im Agentenobjekt eingetragen werden soll.
  • Definition via INI-Datei: Ja

• Agentenvariable: UC_HOST_CONN_PI

  • Beschreibung: Verbindungsobjekt für die Process Integration, das im Agentenobjekt eingetragen werden soll.
  • Definition via INI-Datei: Ja

• Agentenvariable: UC_HOST_CONN_SLD

  • Beschreibung: Verbindungsobjekt für das System Landscape Directory, das im Agentenobjekt eingetragen werden soll.
  • Definition via INI-Datei: Ja

• Agentenvariable: UC_HOST_HW

  • Beschreibung: Hardware-Informationen des Rechners. Zum Beispiel Systemtyp, Anzahl der Prozessoren, Prozessortyp. Der Wert wird durch den Agenten automatisch ermittelt
  • Definition via INI-Datei: Nein

• Agentenvariable: UC_HOST_JCL_VAR

  • Beschreibung: Verweis auf Includes, die bei der Jobgenerierung verwendet werden. Dies sind im Allgemeinen die folgenden Includes: HEADER.*, TRAILER.* und RESTART.* des Mandanten 0. Es können aber auch eigene Includes eingesetzt werden.
  • Definition via INI-Datei: Ja

• Agentenvariable: UC_HOST_SW

  • Beschreibung: Betriebssystem des Rechners. Der Wert wird durch den Agenten automatisch ermittelt.
  • Definition via INI-Datei: Nein

• Agentenvariable: UC_HOST_SW_VERS

  • Beschreibung: Version des Betriebssystems. Der Wert wird durch den Agenten automatisch ermittelt.
  • Definition via INI-Datei: Nein

• Agentenvariable: UC_SIEBEL_LOGPATH

  • Beschreibung: Verzeichnis, in dem die Logdateien von Siebel abgelegt werden.
  • Definition via INI-Datei: Ja

• Agentenvariable: UC_SIEBEL_SRVRMGR

  • Beschreibung: Verzeichnis, in dem sich der Siebel Server Manager (srvrmgr.exe) befindet.
  • Definition via INI-Datei: Ja

Siehe auch:

• Variablen und VARA-Objekte
• VARA-Objekte
• Liste der VARA-Objekte für System- und Mandantenwerte
• Liste der Variablen für System- und Objektwerte
• Liste der vordefinierten Read-Buffer-Variablen