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.
© Copyright 2024