Informatica Agent Guide v3.2.0

Informatica
Agent Guide v3.2.0
Automic Software GmbH
ii Copyright
Copyright
Die Marke Automic® und das Automic-Logo® sind Warenzeichen der Automic Software GmbH
(Automic). Die Nutzung sämtlicher Warenzeichen bedarf der ausdrücklichen schriftlichen
Genehmigung und unterliegt den Lizenzbedingungen. Die Software/das Computerprogramm sind
geschütztes Eigentum der Firma Automic. Zugang und Nutzung vorbehaltlich der geprüften
schriftlichen Lizenzbedingungen.
Die Software/das Computerprogramm ist weiters durch internationale Verträge sowie nationale und
internationale Gesetze urheberrechtlich geschützt. Unbefugter Zugang bzw. Nutzung werden zivilund strafrechtlich verfolgt. Unbefugtes Kopieren und andere Formen der auszugsweisen oder
vollständigen Reproduktion, Dekompilierung, Nachbau, Änderung oder die Entwicklung von aus der
Software abgeleiteten Produkten sind strengstens verboten. Die Nichtbeachtung wird strafrechtlich
verfolgt.
Alle Angaben ohne Gewähr. Änderungen, Irrtümer, Satz- und Druckfehler vorbehalten. Nachdruck
auch in Auszügen ist untersagt.
© Copyright Automic Software GmbH. Alle Rechte vorbehalten.
Informatica Agent Guide v3.2.0 iii
Inhaltsverzeichnis
1 Integrationslösung für den Rapid Automation Informatica-Agenten
1
1.1 Einführung zum Rapid Automation Informatica-Agenten
1
1.2 Informationen zu Rapid Automation-Agenten
2
1.3 Speicherort der Hilfedateien und Format des Agenten-Handbuchs
3
2 Verwenden der Informatica Agenten-Integrationslösung
5
2.1 Informatica-Verwaltung
5
2.2 Installieren des Web Service-Agenten in einem vorhandenen Automation EngineSystem
6
2.3 Laden von Rapid Automation Component-JAR-Dateien in Applications Manager v8.0
9
2.4 Erstellen von Informatica Connection-Objekten
11
2.5 Erstellen eines Informatica-Agenten
12
2.6 Automatisches Erstellen von Informatica Workflow-Jobs
14
2.7 Manuelles Erstellen von Informatica Workflow-Jobs
18
2.8 Manuelles Erstellen von Informatica-Sitzungen, -Aufgaben oder Worklet-Jobs
23
2.9 Hinzufügen von Informatica-spezifischen Statusspalten zum AM-Backlog
26
2.10 Anfordern von Jobs, die nicht gleichzeitig in Informatica laufen können
27
2.11 Verwaltung von Ausgabe- und Ausführungsoptionen mit dem RA-Tab
28
2.12 Einrichten des Traces
30
2.13 Debugging-Einstellungen in Applications Manager v8.0
32
iv
Inhaltsverzeichnis
Informatica Agent Guide v3.2.0 1
1 Integrationslösung für den Rapid
Automation Informatica-Agenten
1.1 Einführung zum Rapid Automation
Informatica-Agenten
Informatica ist Marktführer im Bereich der ETL-Tools. Die Integrationslösung für den Rapid
Automation Informatica-Agenten führt Jobs mithilfe des Informatica Integration Service aus. Sie
kann in Verbindung mit der Automation Engine v9/v10, dem Operations Manager und dem
Applications Manager verwendet werden. Sie verfügt über spezielle Bereiche für ConnectionObjekte, Agenten und Jobs.
Zur Integration des Informatica Rapid Automation-Agenten müssen Sie mindestens eines der
folgenden Elemente erstellen:
l
l
l
Connection-Objekte
Agenten
Jobs zur Ausführung von Informatica Workflows, Aufgaben, Sitzungen oder Worklets
Rapid Automation-Bereiche
Die Integrationslösungen für Rapid Automation-Agenten (z. B. für Informatica) sind für folgende
Anwendungen identisch:
l
l
l
l
Automation Engine v10
Automation Engine v9
Operations Manager v8.0
Applications Manager v8.00
Die Funktionalität der Panels ist auf allen drei Automation Platforms identisch.
Dieses Handbuch beschreibt die Verwendung der oben aufgelisteten Objekten, nicht aber jene der
aufgelisteten Anwendungen (Automation Engines). In den jeweiligen Abschnitten zur Erstellung von
Connection-Objekten, Agenten, Jobs usw. werden daher die Rapid Automation-Objekte, nicht
jedoch die Objekterstellung selbst beschrieben.
2
Kapitel 1 Integrationslösung für den Rapid Automation Informatica-Agenten
1.2 Informationen zu Rapid AutomationAgenten
Nachdem Sie eine Rapid Automation-JAR-Datei in der Automation Engine geladen haben, können
Sie für den jeweiligen Agenten Verbindungs-, Agenten- und Job-Objekte mit spezifischen Fenstern
festlegen.
Nachdem Sie eine Rapid Automation-JAR-Datei in der Automation Engine geladen haben, können
Sie für den jeweiligen RA-Agenten Verbindungs-, Agenten- und Job-Objekte mit spezifischen
Fenstern festlegen. In den Handbüchern zu den Rapid Automation Agenten wird die Verwendung
dieser RA-Fenster erläutert, nicht jedoch die Definition von Connection-, Agenten- und JobObjekten. Informationen zum Erstellen dieser Objekte finden Sie in der Hilfe zur Automation Engine.
Einstellungen auf dem Tab bestimmter RA-Agenten außer Kraft
setzen in der Automation Engine v9 und v10
Sie können die Einstellungen auf dem Tab bestimmter RA-Agenten überschreiben (erfordert
Automation Engine v9 Service-Pack 4 oder höher). Die Einstellungen können für folgende Vorgänge
außer Kraft gesetzt werden:
l
l
l
Die einmalige Ausführung eines Rapid Automation-Jobs. Diese Option kann nur für Jobs
aktiviert werden, wenn auf dem Tab RA der Job-Definition die Option Taskparameter
abfragen aktiviert ist. Weitere Informationen finden Sie unter Verwaltung von Ausgabe- und
Ausführungsoptionen mit dem RA-Tab.
Rapid Automation-Jobs, die einem Workflow (vor der Automation Engine v9 Service-Pack 4
auch als AblaufPlan bezeichnet ) als Aufgaben hinzugefügt werden. Weitere Informationen
zum Bearbeiten von Workflow-Aufgaben finden Sie in der Hilfe zur Automation Engine.
Den einmaligen Durchlauf einer gegenwärtig nicht aktiven Aufgabe im Fenster Aktivitäten
durch Rechtsklick und Auswahl der Option Parameter.
Verwendung von Objektvariablen anstelle von :PUT_ATT-Befehlen
im Operations Manager v8.00 sowie in der Automation Engine v9
und v10
Unter Umständen können sich die Attribute von Rapid Automation-Jobs ändern, wenn eine neue
Version der Rapid Automation-Agenten freigegeben wird. In diesem Fall funktionieren die :PUT_
ATT-Befehle nicht mehr, die in früheren Versionen der Agenten definiert wurden. Daher wird
empfohlen, für Feldersetzungen in Rapid Automation-Jobs keine :PUT_ATT-Befehle, sondern stets
Objektvariablen zu verwenden.
Führen Sie folgende Schritte aus, um einen Job von der Nutzung eines :PUT_ATT-Befehls auf eine
Objektvariable umzustellen:
1. Löschen Sie den :PUT_ATT-Befehl auf dem Tab Script oder Pre-Script des Jobs.
2. Fügen Sie auf dem Tab Variablen und Prompts des Jobs eine Variable hinzu.
3. Geben Sie in dem Feld, in dem Sie einen Wert ersetzen möchten, die Objektvariable im
Format &<Variable># ein, wobei <Variable> dem Variablennamen entspricht, den Sie auf
dem Tab Variablen & Prompts eingegeben haben.
Informatica Agent Guide v3.2.0 3
1.3 Speicherort der Hilfedateien und Format
des Agenten-Handbuchs
Die Hilfedateien für alle Rapid Automation-Agenten liegen als JavaHelp-Projekte vor.
Diese Hilfedateien werden bei der Aktualisierung des jeweiligen Agenten auf den neuesten Stand
gebracht, nicht bei der Aktualisierung der Automation Engine. Daher bilden sie ein eigenständiges
JavaHelp-Projekt. Sie können die Hilfe für den Rapid Automation-Agenten öffnen, indem Sie auf die
Hilfeschaltfläche klicken, die sich unten auf dem Tab des jeweiligen Agenten Ihres Agenten- oder
Job-Objekts befindet.
Format des Agenten-Handbuchs
Dieses Agenten-Handbuch ist in verschiedene Themenbereiche gegliedert. Jeder Abschnitt wird
durch eine Überschrift und eine kurze Zusammenfassung eingeleitet. Die Zusammenfassung
enthält die wichtigsten Konzepte, die in dem jeweiligen Abschnitt erläutert werden.
Sie können sich einen schnellen Überblick über ein Kapitel verschaffen, indem Sie die
Zusammenfassung lesen und die Abbildungen samt ihrer Bildunterschriften überfliegen.
4
Kapitel 1 Integrationslösung für den Rapid Automation Informatica-Agenten
Informatica Agent Guide v3.2.0 5
2 Verwenden der Informatica
Agenten-Integrationslösung
2.1 Informatica-Verwaltung
Im Folgenden werden die grundlegenden Schritte zur Implementierung des Rapid Automation
Informatica-Agenten beschrieben.
Die Implementierung des Rapid Automation Informatica-Agenten erfordert unter anderem die
folgenden grundlegenden Schritte:
1. Definieren Sie die folgenden Umgebungsvariablen für den Betriebssystembenutzer, der den
Informatica-Agenten ausführt, wie im unten angeführten Beispiel beschrieben.
Für UNIX/Linux:
INFA_HOME=/informatica/9.x
INFA_DOMAINS_FILE=$INFA_HOME/domains.infa
Für Windows:
INFA_HOME=C:\informatica\9.x
INFA_DOMAINS_FILE=%INFA_HOME%\domains.infa
2. Definieren Sie die Variable des Bibliothekspfades für den Benutzer, der den InformaticaAgenten ausführt, wie im unten angeführten Beispiel beschrieben.
Für UNIX/Linux:
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$INFA_HOME/server/bin
Für AIX:
LIBPATH=$LIBPATH:$INFA_HOME/server/bin
3. Erstellen eines oder mehrerer Informatica Connection-Objekte, die von Ihren InformaticaJobs verwendet werden, um eine Verbindung zum Informatica-Repository herzustellen
4. Erstellen eines Informatica Agenten-Objekts
5. Erstellen von Jobs:
l Manuell für Informatica Workflows, Aufgaben, Sitzungen und Worklets
l Automatisch für Informatica Workflows mit der untergeordneten Registerkarte Jobs
anlegen im Informatica-Agenten
6
Kapitel 2 Verwenden der Informatica Agenten-Integrationslösung
2.2 Installieren des Web Service-Agenten in
einem vorhandenen Automation EngineSystem
In den folgenden Abschnitten erfahren Sie, wie Sie denInformatica -Agenten in einem vorhandenen
Automation Engine-System installieren können.
Dieser Abschnitt ist nicht relevant, wenn der Applications Manager Ihre Automation Engine ist.
Nähere Informationen zum Laden der Rapid Automation .jar files in den Applications Manager
sind verfügbar in Laden von Rapid Automation Component-JAR-Dateien in Applications
Manager v8.0.
Java-Anforderungen
Prüfen Sie bei allen Hosts und Systemen, auf denen ein Automation Engine UserInterface installiert
ist, die aktuelle Version Ihrer Java Virtual Machine (VM) mithilfe des folgenden Befehls:
java -version
Auf allen Systemen wird Java Version 1.6 benötigt.
Genaue Informationen zu plattformspezifischen Java-Anforderungen Ihres Automation EngineSystems finden Sie in den Release Notes der Automation Engine.
Die für die Installation von Java erforderlichen Dateien finden Sie unter
http://www.oracle.com/technetwork/java/index.html.
Bereitgestellte Dateien
Die zum RA-Agenten gehörenden Dateien befinden sich im Verzeichnis
IMAGE:AGENTS\RAPIDAUTOMATION der Automation Engine.
Dateiname Beschreibung
ucxjcitx.jar
Agent für Rapid Automation
ucxjcitx.ini
Konfigurationsdatei
*.jar
Bibliotheken
uc.msl
Meldungsbibliothek
setup.exe
Windows-Installationsdatei
Einrichtung eines neuen oder aktualisierten Agenten
Für die Einrichtung eines RA-Agenten müssen Sie:
l
l
l
l
Eine Lizenz für den Agenten in die Datenbank laden.
Die Dateien des Agenten auf dem Hostsystem ablegen.
Die Datei ucxjcitx.ini bearbeiten.
Die RA-Lösung laden.
Informatica Agent Guide v3.2.0 7
Anforderungen für Lizenzdateien
Lizenzdateien für RA-Agenten müssen die Zeile EX.RA.<AGENT TYPE> enthalten und in die
Datenbank geladen werden. Weitere Informationen zum Laden von Lizenzdateien finden Sie in der
Dokumentation für Ihre Automation Engine.
Ablegen von Agenten-Dateien auf dem Hostsystem
Erstellen Sie auf dem Hostsystem ein Verzeichnis für den RA-Agenten und kopieren Sie die
bereitgestellten Dateien in dieses Verzeichnis. Wir empfehlen dringend, den Agenten in einem
eigenen Verzeichnis zu installieren. Beispiel: AE/Agent/rapidautomation oder
C:\AE\Agent\rapidautomation. In Unix können Sie die Dateien mit dem folgenden Befehl
entpacken:
cat ucxjcitx.tar.gz |uncompress |tar vxf Führen Sie in Windows die Datei setup.exe aus.
Erstellen des Cache-Verzeichnisses
Die für den Agenten verwendete RA-Lösung wird im Verzeichnis cache gespeichert. Erstellen Sie
dieses Verzeichnis im Installationsordner.
Bearbeiten der Datei ucxjcitx.ini
Bearbeiten Sie die erforderlichen Parameter für den RA-Agenten in der Datei ucxjcitx.ini gemäß der
unten aufgeführten Tabelle.
Parameter Beschreibung
system
Der Name des Automation Engine-Systems. Diese Angabe muss mit dem Eintrag
in der INI-Datei des Automation Engine-Servers übereinstimmen.
name
Der Name des Agenten. Der Agentenname darf aus maximal 32 der folgenden
Zeichen bestehen: „A–Z“, „0–9“, „_“, „.“, „$“, „@“, „-“ und „#“.
cache_
directory
Das Verzeichnis, in dem der Agent die RA-Lösungen speichern soll. Der
vorgegebene Standardwert ist cache und kann beibehalten werden.
cp
Die Adresse des Kommunikationsprozesses im Automation Engine-System, mit
dem sich der Agent verbinden soll. Der Eintrag hat das folgende Format:
<DNS-Name oder TCP/IP-Adresse>:<Portnummer>
ra
Wird für das Aktivieren bzw. Deaktivieren von Traces verwendet.
Informationen zu weiteren Parametern in der Datei ucxjcitx.ini finden Sie in der Dokumentation
Ihrer Automation Engine.
Im Folgenden finden Sie ein Beispiel für eine Datei vom Typ ucxjcitx.ini. Die erforderlichen
Parameter werden fett gedruckt angezeigt:
[GLOBAL]
system=AE
name=RA01
logcount=10 logging=../temp/CIT_LOGG_##.TXT
max_logging_kb=50
language=E helplib=uc.msl
8
Kapitel 2 Verwenden der Informatica Agenten-Integrationslösung
[AUTHORIZATION]
InitialPackage=
KeyStore=
[RA]
cache_directory=cache
[TCP/IP]
connect=20
cp=localhost:2217
[VARIABLES]
uc_host_jcl_var=CIT
[TRACE]
file=../temp/CIT_TRACE_##.TXT
max_trace_kb=8000
tcp/ip=0
trccount=10
ra=0
[CP_LIST]
2218=PC01
Laden der RA-Lösung
Starten Sie auf dem Hostsystem das Dienstprogramm AE DB Load, und wählen Sie die JARDatei der RA-Lösung aus. Das Dienstprogramm lädt die Datei in die Datenbank der Automation
Engine. Die JAR-Datei lässt sich über die grafische Oberfläche bzw. den Java-Batchmodus
(ucybdbld.jar) von AE.DB Load laden. Das Laden der Datei mit „AE DB Load“ im Batchmodus
(ucybdbld.exe) in Windows ist nicht möglich.
Der RA-Agent kann ausschließlich mit einer RA-Solution verbunden werden. Wenn Sie mehrere
RA-Lösungen verwenden möchten, wird für jede Lösung ein eigener RA-Agent benötigt.
Die JAR-Datei einer bestimmten RA-Lösung können Sie nicht für andere Systeme nutzen.
Wenn Sie es dennoch versuchen, wird das Dienstprogramm „AE DB Load“ möglicherweise
abgebrochen.
Informatica Agent Guide v3.2.0 9
2.3 Laden von Rapid Automation
Component-JAR-Dateien in Applications
Manager v8.0
Um Rapid Automation Component-JAR-Dateien in Applications Manager zu laden, öffnen Sie das
Menü „Tools“ und wählen Sie die Option „Rapid Automation Loader“. Daraufhin wird das Fenster
„Rapid Automation Loader“ geöffnet. Hier können Sie nach dem Verzeichnis suchen, in dem sich
Komponenten befinden. Wählen Sie eine Komponente aus, um sie zu laden.
Rapid Automation Component-JAR-Dateien lassen sich mit dem Rapid Automation Loader in
Applications Manager laden.
Anforderungen der Datei „keyfile.ini“
In Applications Manager benötigen RA-Agenten zwei Zeilen in der Datei keyfile.ini: eine, mit der
Benutzer die JAR-Datei des Agenten laden können, und eine zweite, die für die Ausführung des
spezifischen Agenten benötigt wird. Wenn Sie einen RA-Agenten gekauft haben, verfügt Ihre
keyfile.ini-Datei bereits über die erforderlichen Zeilen. Wenn die Zeilen nicht vorhanden sind oder
Sie die Datei „keyfile.ini“ von einer anderen Instanz erhalten haben, wird entweder der Menüeintrag
Rapid Automation Loader nicht angezeigt (wenn die RA-Zeile nicht existiert) oder Sie können den
RA-Agenten nicht starten. Text aus einer Musterdatei vom Typ keyfile.ini mit dem RA Loader und
zwei RA-Agenten finden Sie hier:
RA=06-03-2013x12-31-2013x999
FTPAGENT=06-03-2013x12-31-2013x999
BANNERAGENT=06-03-2013x12-31-2013x999
Verwenden des Rapid Automation Loaders
So verwenden Sie den Rapid Automation Loader:
1. Rufen Sie das Menü Tools auf, und wählen Sie Rapid Automation Loader.
In Applications Manager wird das Fenster Rapid Automation Loader geöffnet (siehe
folgende Darstellung).
Suchen Sie nach einem RA-Komponentenverzeichnis, und wählen Sie eine Komponente aus, um sie
zu laden.
2. Suchen Sie im Fenster Rapid Automation Loader mit der Schaltfläche Durchsuchen
nach einem Verzeichnis, in dem sich RA-Komponenten auf Ihrem PC befinden.
3. Wählen Sie im Feld Available Components eine Komponente aus.
10
Kapitel 2 Verwenden der Informatica Agenten-Integrationslösung
4. Optional können Sie eine ID für die Komponenten in das ID-Feld eingeben. Wenn Sie keine
ID eingeben, wird die nächste verfügbare Nummer verwendet.
In den meisten Fällen müssen Sie sich gar nicht um IDs kümmern. Sie müssen nur dann
eine solche Nummer einrichten, wenn ein Agent mit Verweisen aus der Datenbank gelöscht
wird und mit der gleichen Nummer in der Tabelle SO_OPERATORS wiederhergestellt
werden muss. Dies kommt äußerst selten vor.
5. Klicken Sie auf OK oder Übernehmen.
Mit OK werden die Änderungen gespeichert und das Fenster geschlossen. Mit Übernehmen
werden die Änderungen gespeichert, das Fenster bleibt geöffnet. In jedem Fall teilt Ihnen ein
Bestätigungsfenster mit, dass die Komponente geladen und dem Feld Loaded
Components hinzugefügt wurde.
Agenten dieser Art können Sie nun in Applications Manager definieren.
6. Wenn Sie einen vorhandenen RA Agenten-Typen aktualisieren möchten, für den Sie bereits
Agenten definiert haben, müssen Sie für alle zuvor definierten Agenten den Prozess
AgentService stoppen und neu starten.
7. Für manche Agenten (wie zum Beispiel Business Objects) müssen Sie sich beim
Applications Manager Client abmelden und wieder anmelden.
Löschen geladener Komponenten
Um eine geladene Komponente zu löschen, wählen Sie die Komponente aus und klicken Sie auf
„Löschen“. Zum Löschen einer Komponente müssen Sie zunächst alle Objekte aus Applications
Manager löschen, die auf diese Komponente verweisen.
Vergleich von Build-Informationen
Um Build-Informationen von verfügbaren und geladenen Komponenten zu vergleichen, wählen Sie
im Feld Available Components eine verfügbare Komponente auf Ihrem PC sowie im Feld Loaded
Components eine geladene Komponente aus und klicken Sie auf Build Info. Applications
Manager öffnet das Fenster „Build Info“ (siehe unten), in dem Sie die Informationen zu den zwei
Versionen überprüfen können.
Vergleichen Sie die verfügbaren und geladenen Builds im Fenster „Build Info“.
Informatica Agent Guide v3.2.0 11
2.4 Erstellen von Informatica ConnectionObjekten
Informatica Connection-Objekte werden von Informatica Jobs verwendet, um eine Verbindung zum
Informatica-Repository herzustellen.
Um Automation Engine-Jobs aus einem Informatica-Repository zu erstellen, müssen Sie zunächst
ein Informatica Connection-Objekt erstellen (wird im Applications Manager als Anmeldeobjekt
bezeichnet). Ein Informatica Connection-Objekt enthält den Bereich aus der Abbildung A. Die
Zuweisung des Connection-Objekts zu den Jobs erfolgt beim Erstellen der Jobs.
Ein beispielhaftes Informatica Connection-Objekt
Die folgende Tabelle enthält eine Beschreibung der einzelnen Felder.
Feld
Beschreibung
RepositoryName
Name des Informatica-Repository
RepositoryDomäne
Der festgelegte Ort für das Informatica Repository. Wird benötigt, wenn der
Agent nicht auf dem Informatica-Server installiert ist.
SicherheitsDomäne
Legt die verwendete Authentifizierungsmethode fest. Bei der Verwendung von
LDAP erforderlich.
DomänenName
Domänenname
IngetrationsServicename
Name des Integration Service
User Name
Benutzername
Password
Kennwort
Weitere Informationen zur Definition von Connection-Objekten finden Sie in der Dokumentation
Ihrer Automation Engine.
12
Kapitel 2 Verwenden der Informatica Agenten-Integrationslösung
2.5 Erstellen eines Informatica-Agenten
Auf der untergeordneten Registerkarte Allgemein des Informatica-Agenten wird der Pfad zu den
Verzeichnissen pmrep und pmcmd festgelegt, außerdem das Verbindungs-Timeout, das
Abfrageintervall für den Jobstatus.
Installieren Sie auf Ihrer Automation Platform ein Informatica Agenten-Objekt. Der InformaticaAgent muss an einem Ort installiert sein, an dem der Informatica Client oder der Informatica Server
installiert ist.
Informatica-Agenten enthalten eine Registerkarte Informatica mit den untergeordneten
Registerkarten Allgemein und Jobs anlegen.
Festlegen allgemeiner Einstellungen
Die untergeordnete Registerkarte Allgemein für einen beispielhaften Informatica-Agenten wird in
Abbildung A dargestellt.
Die untergeordnete Registerkarte Allgemein eines Informatica-Agenten
Die folgende Tabelle enthält eine Beschreibung der einzelnen Felder.
Feld
Beschreibung
Pfad zu den
Verzeichnissen
pmrep und pmcmd
Der Pfad zu den Verzeichnissen pmrep, pmcmd und infacmd. Dort wird
der Agent installiert.
Timeout nach
Jobstart (Sekunden)
Zeitdauer in Sekunden bevor die Informatica-Jobs nach ihrem Start in der
Automation Engine auf ein Timeout gehen, wenn sie nicht durch das
Integration Service gestartet wurden. Der Standardwert beträgt 180
Sekunden.
Informatica Agent Guide v3.2.0 13
Feld
Beschreibung
Jobstatus
Abfrageintervall
(Sekunden)
Anzahl der Sekunden zwischen Aktualisierungen des Jobstatus. Der
Standardwert liegt bei 20.
Jobende-StatusCheck nach Start
(Sekunden)
Zeitdauer in Sekunden, nach welcher das System prüfen soll, ob der Job
bereits beendet wurde. Sie können einen anderen Wert als 0 definieren,
um Ressourcen für einen neuen bevorzugten Jobstart frei zu bekommen.
Ein anderer Wert als 0 ist hilfreich, wenn viele Jobs zur gleichen Zeit
gestartet werden sollen. Wenige Sekunden genügen für diese Einstellung.
Die Auswirkung auf Ihre Informatica-Jobs wird nur minimal sein, weil
diese ohnehin mehr als ein paar Sekunden bis zu ihrer Beendigung
benötigen (Standardwert = 0).
Übertragungsoption Bestimmt das Standardverhalten beim Übertragen von Workflow-Jobs
für Sitzungslogdurch den Informatica-Agenten. Je nachdem ob Sitzungslogdateien
Übertragungsdateien übertragen werden oder nicht, wird für den Abschluss von Jobs in der
Automation Engine ein unterschiedlich langer Zeitraum benötigt. Folgende
Optionen sind verfügbar:
l
l
l
l
Immer: Überträgt Protokolldateien für alle Sitzungen in
Workflows.
Für fehlgeschlagene Sitzungen oder Workflows: Überträgt
Protokolldateien für fehlgeschlagene Sitzungen in Workflows
und/oder alle Sitzungen für fehlgeschlagene Workflows.
Nur für fehlgeschlagene Sitzungen: Überträgt Protokolldateien
für fehlgeschlagene Sitzungen in Workflows.
Niemals: Überträgt keine Protokolldateien für Sitzungen in
Workflows. Bei Auswahl dieser Option wird der Name der
Protokolldatei nicht im Jobreport aufgelistet. Stattdessen wird
„Null“ angezeigt.
Die von Ihnen gewählte Option kann in einzelnen Job-Definitionen für
Workflows überschrieben werden. Weitere Informationen zu diesem
Thema finden Sie unter Manuelles Erstellen von Informatica WorkflowJobs.
Workflow-Protokolldateien werden immer übertragen.
14
Kapitel 2 Verwenden der Informatica Agenten-Integrationslösung
2.6 Automatisches Erstellen von Informatica
Workflow-Jobs
Sie erstellen Informatica Workflow-Jobs auf der untergeordneten Registerkarte Create Jobs.
Wählen Sie einen Ordner aus, außerdem die Workflows und eine Jobvorlage, und fügen Sie optional
ein Präfix und/oder Suffix für die Jobnamen hinzu. Klicken Sie dann auf Create Jobs.
Sie können mit der untergeordneten Registerkarte Jobs anlegen automatisch Informatica
Workflow-Jobs erstellen. Sie müssen eine Vorlage festlegen, bevor Sie einen Informatica
Workflow-Job erstellen. Die Jobvorlage, die Sie auswählen, legt fest, welche Einstellungen für alle
Registerkarten des Jobs gelten, mit Ausnahme der Registerkarte Informatica.
Automatisches Erstellen von Informatica Workflow-Jobs:
1. Öffnen Sie die Definition des Informatica-Agenten, wählen Sie die Registerkarte Informatica
und daraufhin die untergeordnete Registerkarte Jobs anlegen aus Abbildung A.
Wenn Sie die Automation Engine v9/v10 oder den Operations Manager v8.00 verwenden,
sollten Sie die Ansicht des Informatica-Agenten von dem Mandanten aus wählen, von dem
aus Sie Jobs erstellen möchten.
Die untergeordnete Registerkarte Jobs anlegen des Informatica-Agenten
2. Wählen Sie nun im Fehl Verbindung zum Repository ein Connection-Objekt aus. Durch
das Auswählen des Objektes geschieht Folgendes:
l Die Schaltfläche Auswählen für das Feld Name des Ordners wird aktiviert.
l Die Schaltfläche Auswählen für das Feld Name des Workflows wird aktiviert,
sobald sie einen Ordnernamen im Feld Name des Ordners eingegeben haben.
l Dieses Connection-Objekt wird nun in den Workflow-Jobs, die Sie erstellen werden
verwendet.
Beachten Sie bei der Auswahl des Connection-Objektes, dass sich dieses zum Agenten des
gewählten Jobs verbinden kann (siehe weiter unten im Feld Vorlagen-Job)!
Informatica Agent Guide v3.2.0 15
3. Wählen Sie aus dem Feld Name des Ordners den Informatica-Ordner aus, in dem sich die
Workflows befinden, für die Sie Jobs erstellen möchten. Führen Sie dazu einen der
folgenden Schritte aus:
l Geben Sie den Informatica-Ordnernamen ein.
l Verwenden Sie die Schaltfläche Auswählen, um den Ordner aus einem Pop-upFenster auszuwählen.
4. Wählen Sie aus dem Feld Name des Workflows die Informatica Workflows aus, für die Sie
Jobs erstellen möchten. Führen Sie dazu einen der folgenden Schritte aus:
l Geben Sie die Workflows ein und verwenden Sie Kommas ohne Leerzeichen als
Trennzeichen.
l Verwenden Sie die Schaltfläche Auswählen, um Workflows aus dem Fenster Name
des Workflows auszuwählen, das in Abbildung B dargestellt ist. Wählen Sie im
Fenster Name des Workflows die Workflows aus, und verschieben Sie die Auswahl
vom Bereich Unassigned in den Bereich Assigned mithilfe des Pfeils.
Im Feld Search können Sie die Anfangsbuchstaben einer Suchabfrage eingeben, worauf
anschließend nach dem Wert gesucht wird. Das Feld Search unterstützt auch Reguläre
Ausdrücke in UNIX sowie den Oracle-Platzhalter % für mehrere Zeichen. Weitere
Informationen zum Feld Search finden Sie unter Informationen zu Rapid AutomationAgenten.
Das Fenster Name des Workflows
Die Anzeige des Fensters Name des Workflows ist unterschiedlich, je nachdem, ob das
Kontrollkästchen Schließe existierende Jobs aus auf der untergeordneten Registerkarte
Jobs anlegen aktiviert ist.
Status des
Informatica Workflows, für die bereits Automation EngineKontrollkästchens Jobs erstellt wurden:
Schließe
existierende Jobs
aus:
Aktiviert
(Voreinstellung)
Werden nicht im Bereich Unassigned im Fenster Name des
Workflows aufgelistet.
16
Kapitel 2 Verwenden der Informatica Agenten-Integrationslösung
Status des
Informatica Workflows, für die bereits Automation EngineKontrollkästchens Jobs erstellt wurden:
Schließe
existierende Jobs
aus:
Deaktiviert
Werden im Bereich Unassigned im Fenster Name des Workflows
aufgelistet, und im Kontrollkästchen unter der Spalte Job Existiert
ist der Schreibschutz aktiviert.
Im Operations Manager v8.00 und im Applications Manager v8.0
werden Einträge in der Spalte Job Existiert als richtig oder falsch
angezeigt und nicht in Form von schreibgeschützten Kästchen.
Wenn Sie Jobs für Informatica Workflows mit bereits vorhandenen
Jobs erstellen möchten, müssen Sie sicherstellen, dass eine andere
Syntax im Feld Neuer Jobname auf der untergeordneten
Registerkarte Jobs anlegen vorhanden ist.
5.
6.
7.
8.
Nachdem Sie Workflows zum Erstellen von Jobs im Fenster Name des Workflows
zugewiesen haben, klicken Sie auf OK, um die Einstellungen zu speichern.
Wählen Sie im Feld Vorlagen-Job eine Jobvorlage aus.
Die Jobvorlage ist ein bereits vorhandener Informatica Workflow-Job, der festlegt, welche
Einstellungen für alle Registerkarten des Jobs gelten, mit Ausnahme der Registerkarte
Informatica. Weitere Informationen zur manuellen Erstellung von Informatica WorkflowJobs finden Sie unter Manuelles Erstellen von Informatica Workflow-Jobs.
Fügen Sie im Feld Neuer Jobname optional ein Präfix und/oder Suffix vor oder nach dem
{Workflow}-Ersetzungswert hinzu.
Durch das Hinzufügen eines Präfix und/oder Suffix erhalten die von Ihnen erstellten
Informatica Workflow-Jobs einen individuellen Namen. Dies ist optional, es sei denn, Sie
erstellen zwei oder mehr Automation Engine-Jobs für denselben Informatica Workflow.
Um automatisch Automation Engine Workflow-Jobs aus der untergeordneten Registerkarte
Jobs anlegen für Workflows mit bereits vorhandenen Automation Engine WorkflowJobdefinitionen zu erstellen, müssen Sie folgende Schritte vor der Erstellung von Jobs
ausführen:
l Deaktivieren Sie das Kontrollkästchen Schließe existierende Jobs aus.
l Verwenden Sie ein Präfix und/oder Suffix, das noch nicht für eine bereits vorhandene
Jobdefinition verwendet wurde.
Deaktivieren Sie optional das Kontrollkästchen Schließe existierende Jobs aus. Die
Auswahl beeinflusst, ob Workflows mit für sie erstellten Automation Engine-Jobs im Fenster
Name des Workflows enthalten sind, wenn Sie später Informatica Workflow-Jobs aus der
untergeordneten Registerkarte Jobs anlegen erstellen.
l Bei aktiviertem Kontrollkästchen (Voreinstellung): Workflows, für die bereits
Automation Engine-Jobs vorhanden sind, sind nicht in der Liste im Fenster Name des
Workflows enthalten.
l Bei deaktiviertem Kontrollkästchen: Workflows, für die bereits Automation EngineJobs vorhanden sind, sind in der Liste im Fenster Name des Workflows enthalten.
Optional können Sie auch das Kästchen Überspringe die Befüllung des Parameters
aktivieren.
l Bei aktiviertem Kontrollkästchen: Die Parameterdatei bzw. die Jobparameter
werden nicht aus Informatica heraus zu den Automation Engine-Jobdefinitionen
übertragen. Die Parameterdatei bzw. die Jobparameter können später individuell aus
den Automation Engine-Jobdefinitionen heraus ermittelt werden.
Informatica Agent Guide v3.2.0 17
Bei deaktiviertem Kontrollkästchen (Voreinstellung): Die Parameterdatei bzw.
die Jobparameter werden aus Informatica heraus zu den Automation EngineJobdefinitionen übertragen.
9. Klicken Sie auf Jobs anlegen, um ein oder mehrere Jobobjekte zu erstellen.
In Automation Engine v9/v10 und Operations Manager werden Jobs im Feld <Kein Ordner>
erstellt.
l
18
Kapitel 2 Verwenden der Informatica Agenten-Integrationslösung
2.7 Manuelles Erstellen von Informatica
Workflow-Jobs
Legen Sie manuell Jobs fest, die Informatica Workflows ausführen. Erstellen Sie
WORKFLOWJOB-Jobtypen und verwenden Sie die Registerkarte Informatica für Jobdefinitionen.
So erstellen Sie manuell einen Informatica Workflow-Job:
1. Fügen Sie einen neuen Job hinzu, indem Sie Informatica als Jobtyp wählen und wählen Sie
anschließend WORKFLOWJOB aus.
2. Wählen Sie aus der Jobdefinition Ihren Informatica-Agenten aus.
3. Geben Sie auf der Registerkarte Informatica folgende Informationen ein: Für Informatica
Workflow-Jobs enthält die Registerkarte Informatica den in Abbildung A dargestellten
Bereich.
Registerkarte Informatica für einen beispielhaften WORKFLOWJOB.
Füllen Sie die nachfolgend beschriebenen Felder aus:
Feld
Beschreibung
Verbindung zum
Repository
Das von Ihnen erstellte Connection-Objekt. Beachten Sie bei der
Auswahl des Connection-Objektes, dass sich dieses zum Agenten
des gewählten Jobs verbinden kann!
Name des Ordners
Der Informatica-Ordner, der den Workflow enthält. Dieses Feld ist
inaktiv, solange keine Verbindung zum Repository ausgewählt ist.
Informatica Agent Guide v3.2.0 19
Feld
Beschreibung
Name des
Workflows
Der Workflow, den Sie ausführen möchten. Dieses Feld ist inaktiv,
solange kein Ordnername ausgewählt ist.
Starten bei Aufgabe Eine optionale Aufgabe, Sitzung oder ein Worklet, von wo aus
gestartet wird Aufgaben, von denen aus gestartet wird, enthalten
möglicherweise wiederverwendbare oder nicht wiederverwendbare
Worklets. Weitere Beispiele finden Sie im Folgenden unter Starten
aus einer Aufgabe, Sitzung oder einem Worklet in einem nicht
wiederverwendbaren Worklet.
Parameter
Dateiname
Eine optionale Informatica-Parameterdatei.
Name der
ausgeführten
Instanz
Ein optionales Feld zum Festlegen einer Zeichenfolge, die an den
Informatica Power Center Monitor weitergeleitet wird. Bei
Verwendung des Ersatzwerts {JOB_RUNID} wird die RunID als
Teil der Zeichenfolge verwendet. Wenn das Feld leer ist, wird die
RunID der Automation Engine verwendet.
Abbruch bei
Wenn das Kontrollkästchen aktiviert ist, wird der Job abgebrochen,
abnormaler
sobald ein Kill-Befehl von der Automation Engine ausgegeben wird.
Prozessbeendigung
Agent
Dieses nicht bearbeitbare Feld zeigt den aktuellen Wert für die
Standardeinstellung Einstellung Übertragungsoption für SitzungslogÜbertragungsdateien an, der in der Registerkarte Allgemein des
Informatica-Agenten festgelegt wird. Sie können diese Einstellung
überschreiben, indem Sie das Kontrollkästchen Überschreiben
sowie die sich darunter befindenden Optionsschaltflächen
aktivieren.
20
Kapitel 2 Verwenden der Informatica Agenten-Integrationslösung
Feld
Beschreibung
Überschreiben
Ermöglicht das Überschreiben der Übertragungsoption für
Sitzungslog-Übertragungsdateien aus der Registerkarte Allgemein
des Informatica-Agenten für diesen Job. Die Option legt fest, ob der
Informatica-Agent Sitzungsprotokolle für Workflow-Jobs übertragen
soll. Je nachdem ob Sitzungslogdateien übertragen werden oder
nicht, wird für Abschluss von Jobs in der Automation Engine ein
unterschiedlich langer Zeitraum benötigt.
l Bei aktiviertem Kontrollkästchen: Sie können die
Einstellung Übertragungsoption für SitzungslogÜbertragungsdateien überschreiben, indem Sie eine der
folgenden Optionen auswählen:
l Immer: Überträgt Protokolldateien für alle Sitzungen
in diesem Workflow.
l Für fehlgeschlagene Sitzungen oder Workflows:
Überträgt Protokolldateien für fehlgeschlagene
Sitzungen in diesem Workflow und/oder alle
Sitzungen bei Fehlschlagen des Workflows.
l Nur für fehlgeschlagene Sitzungen: Überträgt
Protokolldateien für fehlgeschlagene Sitzungen in
diesem Workflow.
l Niemals: Überträgt keine Protokolldateien für
Sitzungen in diesem Workflow.
l
Bei deaktiviertem Kontrollkästchen (Voreinstellung): Es
wird der für die Einstellung Übertragungsoption für
Sitzungslog-Übertragungsdateien festgelegte Wert
verwendet.
Weitere Informationen finden Sie im Abschnitt Erstellen eines
Informatica-Agenten.
Workflow-Protokolldateien werden immer übertragen.
4. Fügen Sie Job-Parameter hinzu, oder bearbeiten Sie diese.
Aktion
Anleitung
Verwenden Sie eine
Parameterdatei.
Geben Sie den Namen der Parameterdatei in das oben
beschriebene Feld Parameter Dateiname ein. Wenn eine
Parameterdatei verwendet wird, werden die Parameter in der
Tabelle Jobparameter ignoriert.
Erhalten Sie und
legen Sie Werte für
Parameter fest, die
bereits in Informatica
definiert sind.
Lassen Sie das Feld Parameter Dateiname frei, und klicken Sie
auf Get Parameters, damit die Automation Engine die in
Informatica definierten Parameter zur Tabelle Jobparameter
hinzufügt. Sie können die Parameterwerte über die Wertspalte
bearbeiten.
Hinweis: Für Parameter, die bereits in Informatica definiert sind,
werden Standardwerte verwendet. Diese werden jedoch nicht in
der Spalte Value angezeigt.
Informatica Agent Guide v3.2.0 21
Aktion
Anleitung
Fügen Sie einen
Klicken Sie auf Hinzufügen, damit der Informatica-Agent eine
benutzerdefinierten
Zeile hinzufügt, in der Sie Name und Wert festlegen können.
Parameter zur Tabelle
Jobparameter hinzu.
Bearbeiten Sie einen
benutzerdefinierten
Parameter aus der
Tabelle
Jobparameter.
Bearbeiten Sie die Wertspalte.
Löschen Sie einen
benutzerdefinierten
Parameter aus der
Tabelle
Jobparameter.
Wählen Sie eine Zeile aus, und klicken Sie auf Löschen.
Starten aus einer Aufgabe, Sitzung oder einem Worklet in einem
nicht wiederverwendbaren Worklet
So starten Sie aus einer Aufgabe, Sitzung oder einem Worklet in einem nicht wiederverwendbaren
Worklet:
1. Klicken Sie auf die Schaltfläche Auswählen, um das Feld Start from Task zu öffnen.
2. Wählen Sie im Pop-up-Fenster Task Auswahl, rechts in der Abbildung B dargestellt, die
Aufgabe, Sitzung oder das Worklet, das Sie vom Dropdown-Menü Task starten aus öffnen
möchten.
Eine Sitzung in einem Worklet, im Informatica PowerCenter hervorgehoben und im Fenster Task
Auswahl ausgewählt
Für nicht wiederverwendbare Worklets enthält das Dropdown-Menü Task starten sämtliche:
l Aufgaben, Sitzungen, wiederverwendbare Worklets sowie nicht wiederverwendbare
Worklets
l Aufgaben, Sitzungen und Worklets, die zu nicht wiederverwendbaren Worklets
gehören
Wenn Aufgaben, Sitzungen und Worklets in nicht wiederverwendbaren Worklets enthalten
sind, werden sie im Dropdown-Menü Task starten aufgeführt. Es erscheint dann der
Worklet-Name, gefolgt von einem Punkt und dem Namen. Wenn nicht wiederverwendbare
Worklets verschachtelte nicht wiederverwendbare Worklets enthalten, wird jedes nicht
wiederverwendbare Worklet mit einem Punkt als Trennzeichen aufgelistet. Ein Beispiel
finden Sie in Abbildung B:
22
Kapitel 2 Verwenden der Informatica Agenten-Integrationslösung
l
l
Das nicht wiederverwendbare Worklet NWL21 enthält das nicht wiederverwendbare
Worklet NWL22.
Das nicht wiederverwendbare Worklet NWL22 enthält die Sitzung se_NWL3.
Wenn Sie zum Beispiel aus der Sitzung se_NWL3 aus dem nicht wiederverwendbaren
Worklet NWL22, das im nicht wiederverwendbaren Worklet NWL21 enthalten ist, starten
möchten, wählen Sie NWL21.NWL22.seNWL3 aus dem Feld Task starten.
Informatica Agent Guide v3.2.0 23
2.8 Manuelles Erstellen von InformaticaSitzungen, -Aufgaben oder Worklet-Jobs
Legen Sie Jobs fest, die Informatica Workflows ausführen. Erstellen Sie WORKFLOWJOBJobtypen und verwenden Sie die Registerkarte Informatica für Jobdefinitionen.
So erstellen Sie Informatica-Sitzungen, -Aufgaben oder Worklet-Jobs:
1. Fügen Sie einen neuen Job hinzu, indem Sie Informatica als Jobtyp wählen, und wählen Sie
anschließend SESSIONORTASKJOB aus.
2. Wählen Sie aus der Jobdefinition Ihren Informatica-Agenten aus.
3. Geben Sie auf der Registerkarte Informatica folgende Informationen ein: Für Informatica
Workflow-Jobs enthält die Registerkarte Informatica den in Abbildung A dargestellten
Bereich.
Registerkarte Informatica für einen beispielhaften SESSIONORTASKJOB.
Füllen Sie die nachfolgend beschriebenen Felder aus:
Feld
Beschreibung
Verbindung zum
Repository
Das von Ihnen erstellte Connection-Objekt. Beachten Sie bei der
Auswahl des Connection-Objektes, dass sich dieses zum Agenten
des gewählten Jobs verbinden kann!
Name des Ordners
Der Informatica-Ordner, der den Workflow enthält. Dieses Feld ist
inaktiv, solange keine Verbindung zum Repository ausgewählt ist.
Name des
Workflows
Der der Aufgabe, Sitzung oder dem Worklet zugewiesene
Workflow. Dieses Feld ist inaktiv, solange kein Ordnername
ausgewählt ist.
24
Kapitel 2 Verwenden der Informatica Agenten-Integrationslösung
Feld
Beschreibung
Task- oder Session
name
Die Aufgabe, Sitzung oder das Worklet, das Sie ausführen möchten
Mit diesem Feld können Sie Aufgaben, Sitzungen und Worklets aus
nicht wiederverwendbaren Worklets auswählen. Weitere Beispiele
finden Sie im Folgenden unter Ausführen einer Aufgabe, Sitzung
oder eines Worklet in einem nicht wiederverwendbaren Worklet.
Parameter
Dateiname
Eine optionale Informatica-Parameterdatei.
Name der
ausgeführten
Instanz
Ein optionales Feld zum Festlegen einer Zeichenfolge, die an den
Informatica Power Center Monitor weitergeleitet wird. Bei
Verwendung des Ersatzwerts {JOB_RUNID} wird die RunID als
Teil der Zeichenfolge verwendet. Wenn das Feld leer ist, wird die
RunID der Automation Engine verwendet.
Abbruch bei
Wenn das Kontrollkästchen aktiviert ist, wird der Job abgebrochen,
abnormaler
sobald ein Kill-Befehl der Automation Engine ausgegeben wird.
Prozessbeendigung Wenn das Kontrollkästchen deaktivierto ist (Voreinstellung), wird
der Job angehalten.
4. Fügen Sie Job-Parameter hinzu, oder bearbeiten Sie diese.
Aktion
Anleitung
Verwenden Sie eine
Parameterdatei.
Geben Sie den Namen der Parameterdatei in das oben
beschriebene Feld Parameter Dateiname ein. Wenn eine
Parameterdatei verwendet wird, werden die Parameter in der
Tabelle Jobparameter ignoriert.
Erhalten Sie und
legen Sie Werte für
Parameter fest, die
bereits in Informatica
definiert sind.
Lassen Sie das Feld Parameter Dateiname frei, und klicken Sie
auf Get Parameters, damit die Automation Engine die in
Informatica definierten Parameter zur Tabelle Jobparameter
hinzufügt. Sie können die Parameterwerte über die Wertspalte
bearbeiten.
Für Parameter, die bereits in Informatica definiert sind, werden
Standardwerte verwendet. Diese werden jedoch nicht in der
Wertspalte angezeigt.
Fügen Sie einen
Klicken Sie auf Hinzufügen, damit der Informatica-Agent eine
benutzerdefinierten
Zeile hinzufügt, in der Sie Name und Wert festlegen können.
Parameter zur Tabelle
Jobparameter hinzu.
Bearbeiten Sie einen
benutzerdefinierten
Parameter aus der
Tabelle
Jobparameter.
Bearbeiten Sie die Wertspalte.
Löschen Sie einen
benutzerdefinierten
Parameter aus der
Tabelle
Jobparameter.
Wählen Sie eine Zeile aus, und klicken Sie auf Löschen.
Informatica Agent Guide v3.2.0 25
Ausführen einer Aufgabe, Sitzung oder eines Worklet in einem
nicht wiederverwendbaren Worklet
So führen Sie Aufgaben, Sitzungen oder Worklets in einem nicht wiederverwendbaren Worklet aus:
1. Klicken Sie auf die Schaltfläche Auswählen, um das Feld Task- oder Sessionname zu
öffnen.
2. Wählen Sie im Pop-up-Fenster Task Auswahl, rechts in der Abbildung B dargestellt, die
Aufgabe, Sitzung oder das Worklet, das Sie vom Dropdown-Menü Tasks aus ausführen
möchten.
Eine Sitzung in einem Worklet, im Informatica PowerCenter hervorgehoben und im Fenster Task
Auswahl ausgewählt
Für nicht wiederverwendbare Worklets enthält das Dropdown-Menü Tasks sämtliche:
l Aufgaben, Sitzungen, wiederverwendbare Worklets sowie nicht wiederverwendbare
Worklets
l Aufgaben, Sitzungen und Worklets, die zu nicht wiederverwendbaren Worklets
gehören
Wenn Aufgaben, Sitzungen und Worklets in nicht wiederverwendbaren Worklets enthalten
sind, werden sie im Dropdown-Menü Tasks aufgeführt. Es erscheint dann der WorkletName, gefolgt von einem Punkt und dem Namen. Wenn nicht wiederverwendbare Worklets
verschachtelte nicht wiederverwendbare Worklets enthalten, wird jedes nicht
wiederverwendbare Worklet mit einem Punkt als Trennzeichen aufgelistet. Ein Beispiel
finden Sie in Abbildung B:
l Das nicht wiederverwendbare Worklet NWL21 enthält das nicht wiederverwendbare
Worklet NWL22.
l Das nicht wiederverwendbare Worklet NWL22 enthält die Sitzung se_NWL3.
Wenn Sie zum Beispiel aus der Sitzung se_NWL3 aus dem nicht wiederverwendbaren
Worklet NWL22, das im nicht wiederverwendbaren Worklet NWL21 enthalten ist, ausführen
möchten, wählen Sie NWL21.NWL22.seNWL3 aus dem Feld Task starten.
Beenden von fehlgeschlagenen Jobs des Typs Sitzungen oder
Aufgaben
Wenn ein Job des Typs SESSIONORTASKJOB in Informatica fehlschlägt und der Befehl zum
Abbrechen aus der Automation Engine v9/v10 oder dem Operations Manager oder ein Kill-Befehl
aus dem Applications Manager ausgegeben wird, beendet der Informatica-Agent den Workflow,
welcher der Sitzung oder Aufgabe übergeordnet ist. Das geschieht, weil diese Workflows nur eine
Sitzung oder Aufgabe enthalten. So stimmt der Workflow-Status mit dem seiner untergeordneten
Elemente überein.
26
Kapitel 2 Verwenden der Informatica Agenten-Integrationslösung
2.9 Hinzufügen von Informatica-spezifischen
Statusspalten zum AM-Backlog
Fügen Sie die Spalten SO_REF1 und SO_APPLICATION_STATUS zum AM-Backlog und AMVerlauf hinzu, um den Status der Informatica-Ausführungs-ID und des Informatica-Workflows
anzuzeigen.
Es gibt zwei Informatica-Spalten, die Sie zum Applications Manager-Backlog und -Verlauf
hinzufügen können:
l
l
SO_REF1: Zeigt die Informatica-Ausführungs-ID an.
SO_APPLICATION_STATUS: Zeigt den Informatica-Workflow-Status an.
So fügen Sie diese Spalten zum Backlog hinzu:
1. Öffnen Sie auf dem Applications Manager-Desktop das Menü Options, und wählen Sie
Tables aus.
2. Wählen Sie Backlog aus.
Der Applications Manager zeigt das Fenster Setup: Backlog an, das in Abbildung A zu
sehen ist.
Anzeigen der Informatica-Spalten im Backlog
3. Suchen Sie im unteren Fenster die Einträge SO_REF1 und SO_APPLICATION_STATUS in
der Spalte DB_NAME, und klicken Sie auf die Felder in der Spalte VISIBLE.
4. Alternativ können Sie auch die Spalten in „Status der Ausführungs-ID“ und „WorkflowStatus“ umbenennen.
5. Um die Änderungen zu speichern, klicken Sie auf OK.
6. Sie können den Vorgang auch für den AM-Verlauf wiederholen.
Informatica Agent Guide v3.2.0 27
2.10 Anfordern von Jobs, die nicht
gleichzeitig in Informatica laufen können
Wenn Sie einen Job anfordern, der keine gleichzeitige Ausführung in Informatica ermöglicht, und
eine andere Instanz bereits ausgeführt wird, wird die Aufgabe nicht ausgeführt, und die
nachstehende Meldung wird in der Ausgabedatei im System der Aufgabe angezeigt.
Wenn Sie einen Job anfordern, der keine gleichzeitige Ausführung in Informatica ermöglicht, und
eine andere Instanz bereits ausgeführt wird, wird die Aufgabe nicht ausgeführt, und eine Meldung,
die der unten aufgeführten ähnelt, wird in der Ausgabedatei im System der Aufgabe angezeigt:
java.lang.RuntimeException: workflow start error: pmcmd> ERROR:
Workflow [RepFolder1:wf_for_tail[version CheckedOut]]: Could not
acquire the execute lock for Workflow [wf_for_tail] []. Please check
the Integration Service log for more information.
pmcmd> ERROR: Unknown command [ENDENDENDENDENDENDEND!!].
28
Kapitel 2 Verwenden der Informatica Agenten-Integrationslösung
2.11 Verwaltung von Ausgabe- und
Ausführungsoptionen mit dem RA-Tab
Sie können im Operations Manager v8.00 sowie in der Automation Engine v9 und v10 festlegen,
wie Job-Reports gespeichert werden (z. B. mit oder ohne Agenten-Logdaten) und ob die
Informationen des RA-Agenten-spezifischen Tabs angezeigt werden, wenn der Job mit dem RATab ausgeführt wird.
Sie können festlegen, wie Job-Reports gespeichert werden (zum Beispiel mit oder ohne AgentenLogdaten) und ob die Informationen des RA-Agenten-spezifischen Tabs angezeigt werden, wenn
der Job mit dem Tab RA ausgeführt wird. Der RA-Tab eines Jobs kann zum Beispiel
folgendermaßen aussehen:
Beispiel-Tab RA für einen Job
Die Optionen des RA-Tabs für Jobs werden in der folgenden Tabelle beschrieben.
Feld
Beschreibung
Datenbank
Bei Aktivierung dieser Option wird der Job-Report in der Automation Engine
verwaltet. Nach der Ausführung eines Jobs wird das Prozessprotokoll per
Dateiübertragung in die Datenbank der Automation Engine gesendet.
Datei
Bei Aktivierung dieser Option wird der Job-Report in der Automation Engine
verwaltet. Nach der Ausführung eines Jobs ist das Prozessprotokoll im
Zielsystem als Datei aufrufbar.
Nur im
Fehlerfall
generieren
Bei Aktivierung dieser Option werden der Job-Report in der Datenbank der
Automation Engine und/oder eine Datei im Zielsystem gespeichert, falls der Job
abgebrochen wurde. Diese Funktion ist ausschließlich dann verfügbar, wenn
die Optionen „Datenbank“ und/oder „Datei“ aktiviert sind.
Agentenlog
Bei Aktivierung dieser Option weisen Job-Reports einen Tab für das Agentenlog
auf. Wenn Fehler aufgetreten sind, werden diese im Agentenlog aufgeführt. Wir
empfehlen, dieses Kästchen für die Fehlerbehebung aktiviert zu lassen.
Informatica Agent Guide v3.2.0 29
Feld
Beschreibung
Taskparameter Bei Aktivierung dieser Option werden die Daten aus dem RA-Agentenabfragen
spezifischen Tab eines Jobs in einem Pop-Up-Fenster angezeigt, sobald Sie
den Job ausführen. In diesem Fenster können Sie einmalige Änderungen für
einzelne Job-Instanzen vornehmen. Manche Felder der RA-Agentenspezifischen Tabs lassen sich ausschließlich in Job-Definitionen konfigurieren.
Diese Felder sind nicht Bestandteil des Pop-Up-Fensters, wenn bei einer
Abfrage des Jobs die Option „Taskparameter abfragen“ aktiviert ist. Ein PopUp-Fenster für einen Job kann wie folgt aussehen.
Diese Option ist ab der Automation Engine v9 Service-Pack 4 verfügbar.
Wenn die Option „Taskparameter abfragen“ aktiviert ist, können Sie die Daten des RA-spezifischen Tabs
eines Jobs für eine einzelne Instanz bearbeiten (bei Ausführung des Jobs).
30
Kapitel 2 Verwenden der Informatica Agenten-Integrationslösung
2.12 Einrichten des Traces
Wenn Sie mit der Automation Engine v10, Automation Engine v9 oder dem Operations Manager
v8.00 Probleme im Zusammenhang mit einem Rapid Automation-Agenten beheben
möchten,können Sie für AGENT- und JOB-Objekte Traces von Rapid Automation aktivieren –
entweder im Fenster „Systemübersicht“ des UserInterface der Automation Engine oder mit der
Datei „ucxjcitx.ini“. Traces des Rapid Automation UserInterface können Sie mit der Datei
„uc4config.xml“ aktivieren.
Aktivieren oder Deaktivieren des Traces von Rapid Automation im
Fenster „Systemübersicht“
Zur Aktivierung des Traces für AGENT- und JOB-Objekte von Rapid Automation im UserInterface
rufen Sie das Fenster Systemübersicht auf, klicken mit der rechten Maustaste auf den Agenten
und wählen Eigenschaften aus. Im nun angezeigten Fenster setzen Sie RA auf 9, um den Trace zu
aktivieren, bzw. auf 0, um den Trace zu deaktivieren.
Aktivieren oder Deaktivieren des Traces von Rapid Automation
mit der Datei „ucxjcitx.ini“
So aktivieren Sie Traces für AGENT- und JOB-Objekte von Rapid Automation mit der Datei
ucxjcitx.ini:
1. Stoppen Sie die Agenten im Fenster ServiceManager oder mit der Befehlszeile.
2. Bearbeiten Sie die Datei ucxjcitx.ini.
So aktivieren Sie das Trace-Log: Setzen Sie für:
Ein
ra=9
Aus
ra=0
3. Im folgenden Code sorgt ra=9 für eine Aktivierung der Traces von Rapid Automation:
[TRACE]
file=..\temp\RA_TRACE_##.TXT
max_trace_kb=8000
tcp/ip=0
ra=9
trccount=10
4. Starten Sie die Agenten neu.
Aktivieren von Traces des UserInterface von Rapid Automation
So aktivieren Sie Traces des UserInterface von Rapid Automation:
1. Verlassen Sie das UserInterface der Automation Engine.
2. Ergänzen Sie in der Datei uc4config.xml die Trace-Zeile um ra="9", sodass sie wie folgt
aussieht:
<trace ra="9" count="10" xml="0" tcp="0">..\temp\UCDJ_TRC_
##.TXT</trace>
3. Öffnen Sie das UserInterface.
Informatica Agent Guide v3.2.0 31
Deaktivieren von Traces des UserInterface von Rapid Automation
So deaktivieren Sie Traces des UserInterface von Rapid Automation:
1. Verlassen Sie das UserInterface der Automation Engine.
2. Ergänzen Sie in der Datei uc4config.xml die Trace-Zeile um ra="0", sodass sie wie folgt
aussieht:
<trace ra="0" count="10" xml="0" tcp="0">..\temp\UCDJ_TRC_
##.TXT</trace>
3. Öffnen Sie das UserInterface.
Weitere Informationen zum Aktivieren von Traces finden Sie in der Dokumentation der Automation
Engine.
32
Kapitel 2 Verwenden der Informatica Agenten-Integrationslösung
2.13 Debugging-Einstellungen in
Applications Manager v8.0
Wenn Sie Fehler beheben müssen, gibt es verschiedene Debugging-Einstellungen.
Für Rapid Automation existieren unterschiedliche Arten von Debugging-Einstellungen, die sich in
Applications Manager festlegen lassen.
Weitere Informationen zum Festlegen der Debugging-Einstellungen finden Sie in der
Dokumentation für Applications Manager.
Debugging
einrichten für:
Vorgehensweise:
Einen Agenten
Aktivieren Sie in der Agentendefinition auf dem Tab Allgemein das Feld
Agent Debug.
Eine JobÜbertragung und Ausführung für
eine
Einzelaufgabe
Wählen Sie im Fenster Submit im Feld Debug Level eine Option aus.
Eine JobÜbertragung und Ausführung für alle
Aufgaben
Ergänzen Sie die Datei awenv.ini des Agenten um radebuglevel=9. Um
das Debugging zu deaktivieren, verwenden Sie radebuglevel=0.
Debugging-Informationen werden in die Systemausgabeprotokolldatei der
Aufgabe geschrieben.