Registerkarten zur Dokumentation

Variable

Variablen-Attribute

---

Verwendung von Variablen-Objekten

Die Verwendung von Variablen-Objekten ist an verschiedenen Stellen im Automation Engine System möglich. Dazu sind einige Besonderheiten zu beachten.

Variablen-Objekte und deren Werte können an folgenden Stellen eingesetzt werden:

• Objektattribute (ausführbare Objekte): über vordefinierte Variablen
• Registerkarte Variablen & Prompts: vordefinierte Variablen
• Variablen-Objekte (SQL)-Registerkarte Variable- SQL-Anweisungen: vordefinierte Variablen
• Workflow - Eigenschaften der Objekte - Registerkarte Pre-Conditions und Post-Conditions (für Parameter): vordefinierte Variablen
• PromptSet -Registerkarte Designer - Standardwert: vordefinierte Variablen
• PromptSet-Objekte: Als Datenreferenz
• Cockpit-Objekte: Als Datenreferenz für die Elemente
• Datenbank-Ereignisse
• Script: PREP_PROCESS_VAR, PREP_PROCESS_VAR_XML, GET_VAR, :PUT_VAR, :PUT_VAR_COL und :DELETE _VAR (schreibend kann nur auf statische Variablen zugegriffen werden)

Direkte Verwendung in Objekten

Mit vordefinierten Variablen ist es möglich, Werte von Variablen-Objekten zur Laufzeit in ausführbaren Objekten einzusetzen. Dazu dient folgender Variablenname, der sich aus dem Namen des VARA-Objektes zusammensetzt:
{ Variablen-Objekt [, Key [, Spaltenummer ]] }

Dieser Platzhalter wird bei der Durchführung des Objektes durch den entsprechenden Wert des Variablen-Objektes ersetzt. Key und Nummer der Spalte sind dabei optional. Erfolgt keine Angabe einer bestimmten Spalte, wird der Wert automatisch aus der Result-Spalte (bei dynamischen Variablen) bzw. ersten Werte-Spalte (bei statischen Variablen) bezogen. Wenn der Key weggelassen wird, so wird die erste Zeile verwendet.

Vordefinierte Variablen können im UserInterface über den Dialog Variablen-Auswahl eingefügt werden.

Das Verhalten, wenn die angegebene Variable nicht gefunden werden kann, kann mit der Einstellung VARA_ERROR_ON_REPLACEMENT in der Variable UC_CLIENT_SETTINGS festgelegt werden. Standardmäßig wird die Prozessierung abgebrochen.

Die Verwendung dieser Platzhalter ist nicht in den Form-Registerkarten möglich! In den Forms werdennur vordefinierte Variablen für System- und Objektwerte unterstützt.

Platzhalter für Variablen-Objekte werden im Script nicht unterstützt!Um auf Variablen-Objekte zuzugreifen, verwenden Sie das Sprachmittel GET_VAR. Die Werte von dynamischen Variablen werden dabei immer direkt von der Datenquelle ermittelt. Die Verwendung von :PUT_VAR, :PUT_VAR_COL und :DELETE _VAR ist nur für statische Variablen möglich.

Auflösung von dynamischen Variablen

Bei der Auflösung von dynamischen Variablen-Objekten werden die Werte direkt von der Datenquelle (Datenbank, Variable, Agent) abgeholt und für das Objekt zur Verfügung gestellt. Dieser Prozess wird bei jedem Variablenzugriff durchgeführt, da die Werte nicht im Objekt gespeichert bleiben. Das selbe Verhalten gilt auch für den Wiederanlauf von Aufgaben.

Die Auflösung erfolgt zum Generierungszeitpunkt der Aufgabe, welche die Variable verwendet, und hängt daher von der Einstellung "Generieren zur Laufzeit" ab.

Bei der Auflösung von Variablen werden diese zuerst im aktuellen Mandanten gesucht, bevor auf den Systemmandanten zugegriffen wird.

Beachten Sie, dass keine Auflösung erfolgt, wenn ein Attribut mit dem Script-Sprachmittel GET_ATT gelesen wird, das einen Variablen-Platzhalter enthält. Der Attributwert wird wie angegeben übernommen.

Ist bei der Ausführung kein Agent für die Variablentypen "SQL" und "Dateiliste" verfügbar, wechselt die Aufgabe in einen Wartezustand ("Warten auf Variablen-Service"). Bei ungültigen Verzeichnisangaben oder SQL-Anweisungen bricht die Aufgabe mit einem Fehler ab. Überprüfen Sie daher die Einstellungen des Variablen-Objektes und stellen Sie sicher, dass der Agent gestartet wurde.

Aufgaben im Zustand "Warten auf Fortsetzung der Variablenauflösung" können nicht abgebrochen werden! Überprüfen Sie in diesem Fall, ob der Agent aktiv ist und die Einstellungen in den Objekten stimmen (je nach Variablen-Typ: Variablen-, Login- und/oder Verbindungs-Objekt).

Die Variablen-Auflösung wird fortgesetzt, sobald der Agent wieder aktiv ist. Lag das Problem am Verbindungs-Objekt oder an der Datenbank (bei Variablen mit der Quelle "SQL"), so wird die Prüfung nach dem mit VARIABLE_SERVICE_CHECK_INTERVAL(UC_SYSTEM_SETTINGS) definierten Zeitintervall wiederholt.

Attribute für vordefinierte Variablen

Folgende Auflistung zeigt jene Objekt-Attribute, welche die Verwendung der Platzhalter für Variablen-Objekte unterstützen.

Allgemeine Attribute

[Allgemeine Attribute] [FileTransfer-Attribute] [Ereignis-Attribute] [Jobspezifische Attribute]

FileTransfer-Attribute

[Allgemeine Attribute] [FileTransfer-Attribute] [Ereignis-Attribute] [Jobspezifische Attribute]

Ereignis-Attribute

[Allgemeine Attribute] [FileTransfer-Attribute] [Ereignis-Attribute] [Jobspezifische Attribute]

Jobspezifische Attribute

[Allgemeine Attribute] [FileTransfer-Attribute] [Ereignis-Attribute] [Jobspezifische Attribute]

	Attribut	Attributname	Plattform
	AGENT_ID	MBean Server - Agent ID	JMX
	DATA_SOURCE	Verbindung - Dateiname	Datenbank
	DATABASE_NAME	Verbindung - Datenbank	Datenbank
	ENTER_PARAMS, ENTER_PAR, EP	Laufzeit-Optionen - Enter-Parameter	BS2000
	ENTERPRISE_SERVER	Start-Parameter - Enterprise Server	Siebel
	GATEWAY_SERVER	Start-Parameter - Gateway Server	Siebel
	GCOS8_IDENT	Start-Paramter - IDENT	GCOS8
	GCOS8_JCLJOB	Start-Paramter - Include Job	GCOS8
	HOME_TERMINAL	Start-Parameter - Virtuelles Terminal	NSK
	INITIAL_CONTEXT_FACTORY	MBean Server - Initial Context Factory	JMX
	JCL_SOURCE	Laufzeit-Optionen - z/OS Dateiname	z/OS
	JOB_CLASS, JC	Laufzeit-Optionen - Job-Klasse	BS2000
	JOB_NAME, JN	Startparameter/Laufzeit-Optionen - Auftragsname/Jobname	BS2000, MPE, z/OS, OS/400, SAP, VMS
	MPE_OTHER	Laufzeit-Optionen - Sonstige	MPE
	MPE_QUEUE	Laufzeit-Optionen - Queue	MPE
	MVS_ACCOUNT	Laufzeit-Optionen - Account	z/OS
	MVS_JOB_PARAMS	Laufzeit-Optionen - Job-Parameter	z/OS
	MVS_NOTIFY	Laufzeit-Optionen - Benachrichtigungen	z/OS
	MVS_PROG_NAME	Laufzeit-Optionen - Prog-Name	z/OS
	OA_APPL_NAME	Zuständigkeit - Anwendungskurzname	Oracle Applications
	OA_RESP_NAME	Zuständigkeit - Key	Oracle Applications
	OS400_JOBD	Laufzeit-Optionen - Jobbeschreibung	OS/400
	OS400_JOBQ	Laufzeit-Optionen - Jobwarteschlange	OS/400
	OS400_RTGDTA	Laufzeit-Optionen - Leitwegdaten	OS/400
	SAP_DST_SYSTEM	Start-Parameter - Zielsystem	SAP
	SAP_RECIPIENT	Spoollistenempfänger - Adresse	SAP
	SERVER_NAME	Verbindung - Server	Datenbank
	SERVER_URL	MBean Server - Server URL	JMX
	SIEBEL_SERVERS	Start-Parameter - Siebel Servers	Siebel
	UNIX_CMD	Start-Parameter - Kommando	UNIX
	UNIX_SHELL_OPTIONS	Start-Parameter - Shell-Optionen	UNIX
	VMS_QUEUE_NAME	Start Paramter - Queuename	VMS
	WIN_CMD	Start-Parameter - Kommando	Windows
	WIN_WORK_DIR	Start Paramter - Arbeitsverzeichnis	Windows