Information Catalog Manager Systemverwaltung

Befehlssprachendateien importieren und exportieren

Sie können die Information Catalog Manager-Befehlssprachendateien in den Informationskatalog importieren.

Sie können auch Objekte und Objektarten von Information Catalog Manager in Form von Befehlssprachendateien aus dem Informationskatalog exportieren.

Informationen über das Importieren und Exportieren von Befehlssprachendateien, die der Metadata Interchange Specification (MDIS) entsprechen, enthält MDIS-konforme Metadaten mit anderen Produkten austauschen.

Befehlssprachendateien importieren

Wichtige Informationen über das Importieren

Führen Sie folgende Schritte aus, um eine Befehlssprachendatei in den Informationskatalog zu importieren. Beginnen Sie im Fenster "Informationskatalog".

  1. Klicken Sie auf Katalog --> Import.

    Das Fenster Importieren wird angezeigt.

  2. Geben Sie in das Feld Pfad und Dateiname für Import den Verzeichnispfad und den Dateinamen der Befehlssprachendatei ein, die Sie importieren wollen.

    Wenn Sie nur den Dateinamen eingeben, nimmt Information Catalog Manager an, daß die Protokolldatei sich auf dem Laufwerk und dem Pfad befindet, die in der Umgebungsvariablen DGWPATH angegeben sind.

  3. Geben Sie in das Feld Symbolpfad den Verzeichnispfad ein, von dem Sie Symboldateien importieren wollen.
  4. Geben Sie einen neuen Verzeichnispfad und einen neuen Dateinamen in das Feld Pfad und Dateiname für Protokoll ein, um die Zieldatei für Nachrichten zu ändern, die während des Imports generiert werden. Wenn Sie nur den Dateinamen eingeben, stellt Information Catalog Manager die Protokolldatei auf das Laufwerk und den Pfad, die in der Umgebungsvariablen DGWPATH angegeben sind.
  5. Geben Sie an, von wo aus Sie den Import der Befehlssprachendatei beginnen möchten:
  6. Klicken Sie auf Importieren, um mit dem Importieren der angegebenen Befehlssprachendatei zu beginnen. Das Fenster Importieren bleibt geöffnet und enthält ein Statusanzeigefeld. Ist das Importieren abgeschlossen, wird eine entsprechende Nachricht angezeigt.

    Wollen Sie das Fenster schließen, ohne eine Befehlssprachendatei zu importieren, klicken Sie auf Abbrechen.

Metadaten exportieren

Beginnen Sie in einem der folgenden Fenster, wenn Sie Information Catalog Manager-Objekte aus dem Informationskatalog in eine Befehlssprachendatei exportieren möchten:

Suchergebnisse
Objektsammlung
Gefunden in
Ansprechpartner
Themen
Baumstruktursicht
Anlagen
Verbunden mit

  1. Klicken Sie mit der rechten Maustaste auf die Objekte, die Sie exportieren wollen. Halten Sie auf Windows-Plattformen die Umschalttaste gedrückt, um mehrere Objekte auszuwählen.
  2. Klicken Sie mit der rechten Maustaste auf eines der ausgewählten Objekte.
  3. Klicken Sie auf Exportieren.

    Das Fenster Exportieren wird angezeigt.

  4. Geben Sie in das Feld Pfad und Dateiname für Export den Verzeichnispfad und den Dateinamen der Befehlssprachendatei ein, in die Sie die ausgewählten Objekte exportieren wollen.

    Wenn Sie nur den Dateinamen eingeben, nimmt Information Catalog Manager an, daß die Protokolldatei sich auf dem Laufwerk und dem Pfad befindet, die in der Umgebungsvariablen DGWPATH angegeben sind.

    Vergeben Sie bei jedem Exportieren von Information Catalog Manager-Objekten einen neuen Namen für die Exportbefehlssprachendatei. Information Catalog Manager fügt Exportbefehlssprachendateien nichts an und überschreibt diese auch nicht.

  5. Geben Sie in das Feld Symbolpfad den Verzeichnispfad ein, in den Sie Symboldateien exportieren wollen.

    Sind bereits Symboldateien auf dem Pfad vorhanden, überschreibt Information Catalog Manager diese mit den neuen Symbolen.

  6. Geben Sie einen neuen Verzeichnispfad und einen neuen Dateinamen in das Feld Pfad und Dateiname für Protokoll ein, um die Zieldatei für Nachrichten zu ändern, die während des Exports generiert werden. Wenn Sie nur den Dateinamen eingeben, stellt Information Catalog Manager die Protokolldatei auf das Laufwerk und den Pfad, die in der Umgebungsvariablen DGWPATH angegeben sind.
  7. (Wahlfrei) Sie haben die Standardexportoptionen für alle Objekte auf der Seite Exportieren des Notizbuchs Information Catalog Manager - Einstellungen angegeben. Wollen Sie für ausgewählte Objekte spezielle Exportoptionen angeben, klicken Sie auf Optionen, um das Fenster "Optionen für Exportieren" zu öffnen.

    Optionen für Exportieren

    Verwenden Sie dieses Fenster zur Angabe weiterer zu exportierender Objekte:

    1. Klicken Sie in der Liste Ausgewählte Objekte auf mindestens ein Objekt.
    2. Wählen Sie in der Liste Optionen mindestens eine Option für die Gruppe der ausgewählten Objekte aus:

      Alle zugrundeliegenden Objekte (Baumstruktur)
      Ein Objekt mit der Kategorie Grouping wird einschließlich aller in ihm enthaltenen Objekte exportiert.

      Alle verbundenen Objekte
      Ein Objekt wird einschließlich aller mit ihm verbundenen Objekte exportiert.

      Alle zugeordneten Ansprechpartner
      Ein Objekt wird einschließlich aller ihm zugeordneten Objekte mit der Kategorie "Ccat;" exportiert.

      Alle zugeordneten Anlagen
      Ein Objekt wird einschließlich aller ihm als Anlage beigefügten Kommentare exportiert.
    3. Klicken Sie auf Anwenden, um Exportoptionen für die ausgewählten Objekte festzulegen.
    4. Wahlfrei: Wiederholen Sie die Schritte 7a bis 7c für verschiedene Objekte.
    5. Klicken Sie auf OK.
  8. Klicken Sie auf Exportieren, um mit dem Exportieren der angegebenen Objekte zu beginnen.

    Das Fenster Exportieren bleibt geöffnet und enthält ein Statusanzeigefeld. Ist das Exportieren abgeschlossen, wird eine entsprechende Nachricht angezeigt.

    Wollen Sie das Fenster schließen, ohne ein Objekt zu exportieren, klicken Sie auf Abbrechen.

Probleme beim Importieren und Exportieren lösen

Manchmal wird das Importieren der Befehlssprachendatei aufgrund eines Fehlers gestoppt. Ist dies der Fall, kann von Information Catalog Manager die Echodatei oder Protokolldatei aufgerufen werden, um festzustellen, warum das Importieren gestoppt wurde. Diese beiden Dateien werden beim Importieren erstellt.

In der Echodatei werden die Zeilen der Befehlssprachendatei aufgezeichnet, die Information Catalog Manager verarbeitet hat. In der Protokolldatei wird aufgezeichnet, welche Vorgänge beim Importieren oder Exportieren ablaufen.

Echodatei lesen

Information Catalog Manager ordnet der Echodatei den Namen der Befehlssprachendatei sowie die Erweiterung ECH zu. Hat die zu importierende Befehlssprachendatei beispielsweise den Namen TABLEOBJ.TAG, erhält die Echodatei den Namen TABLEOBJ.ECH. Information Catalog Manager stellt die Echodatei automatisch auf das Laufwerk und den Pfad, die in der Umgebungsvariablen DGWPATH angegeben sind.

In der Echodatei sind nicht festgeschriebene Änderungen am Informationskatalog aufgeführt. Daher können Sie anhand der Zeilen einer Echodatei feststellen, in welcher Zeile der Befehlssprachendatei das Importieren gestoppt wurde. In Abbildung 15 wird ein Beispiel für eine Echodatei gezeigt.

Abbildung 15. Echodatei mit den Zeilen der Befehlssprachendatei, die Information Catalog Manager verarbeitet hat

:COMMENT. --------------------------------------
:COMMENT. Erstellen eines Lotus Notes-Objekts
:COMMENT. --------------------------------------
:ACTION.OBJTYPE(MERGE)
:OBJECT.TYPE(LOTNOTE)
        CATEGORY(GROUPING)
        EXTNAME(Lotus Notes Datenbank)
        PHYNAME(LOTUSDB)
        ICOFILE(lotusico)
:PROPERTY.SHRTNAME(LNSERVER)
         DT(C) DL(30) UUISEQ(1) NULLS(N) EXTNAME(Lotus Notes Server-Name)
:PROPERTY.SHRTNAME(DBNAME)
         DT(C) DL(15) UUISEQ(2) NULLS(N) EXTNAME(Dateiname Datenbank)
:PROPERTY.SHRTNAME(MANAGERS)
         DT(T) DL(50) UUISEQ(0) NULLS(Y) EXTNAME(Manager)
:PROPERTY.SHRTNAME(POLICY)
         DT(V) DL(4100) UUISEQ(0) NULLS(Y) EXTNAME(Regeln)
:PROPERTY.SHRTNAME(NAME)
         UUISEQ(3)
:COMMIT.CHKPID(Exemplare hinzufügen)

In Abbildung 15 wurde die Objektart LOTNOTE mit fünf Merkmalen erstellt. Das Importieren wurde nach dem Prüfpunkt gestoppt. Jetzt kann die Protokolldatei verwendet werden, in der Nachrichten über die Ursache des Fehlers zu finden sind.

Protokolldatei lesen

In der Protokolldatei wird aufgezeichnet, wann das Importieren oder Exportieren gestartet und gestoppt wurde. Zudem enthält diese Datei Nachrichten über Fehler, die beim Importieren oder Exportieren aufgetreten sind.

Sie können einen Namen für die Protokolldatei angeben. Wenn Sie keinen Namen angeben, verwendet Information Catalog Manager für die Protokolldatei den Namen der Befehlssprachendatei und die Erweiterung LOG. Hat die zu importierende Befehlssprachendatei beispielsweise den Namen TABLEOBJ.TAG, erhält die Protokolldatei den Namen TABLEOBJ.LOG.

Sie können einen Pfad und Dateinamen für die Protokolldatei angeben. Wenn Sie nur den Dateinamen eingeben, stellt Information Catalog Manager die Protokolldatei auf das Laufwerk und den Pfad, die in der Umgebungsvariablen DGWPATH angegeben sind.

In Abbildung 16 wird ein Beispiel für eine Protokolldatei gezeigt.

Abbildung 16. Protokolldatei mit Ursachencodes und erweiterten Codes für Information Catalog Manager-Fehler beim Importieren

**********************************************************************
Importieren gestartet: Befehlssprachendatei -- h:\rxlnotes\dg2lot.tag
     1996/9/28  16:10:30
**********************************************************************
FLG0505: Objektart LOTNOTE kann nicht erstellt werden.
Ursachencode ist 34508.
Erweiterter Code ist 8.
Importieren beendet mit Fehlern. Die Datenbank wurde entweder bis zum
letzten ausgeführten Befehl COMMIT oder an den Anfang der
Befehlssprachendatei zurückgesetzt.
**********************************************************************
Importieren beendet: Befehlssprachendatei -- h:\rxlnotes\dg2lot.tag
     1996/9/28  16:10:39
**********************************************************************

In diesem Beispiel konnte Information Catalog Manager die Objektart LOTNOTE nicht erstellen. Die Ursache ist durch Ursachencode 34508 angegeben. Die Erklärung für den Ursachencode (in der Veröffentlichung DB2 Universal Database Fehlernachrichten) lautet wie folgt:

Der Längenwert ist aufgrund des definierten Datentyps für das
angegebene Merkmal im Definitionsbereich ungültig.

Im Buch wird zudem angegeben, daß im erweiterten Code die Folgenummer des Merkmals angegeben wird, das den Fehler hervorgerufen hat.

Das im erweiterten Code angegebene Merkmal (Merkmal 8) hat eine für den Datentyp ungültige Länge. Da Information Catalog Manager die ersten fünf Merkmale aller Objektarten selbst generiert (OBJTYPID, INSTIDNT, NAME, UPDATIME und UPDATEBY), ist das achte Merkmal das Merkmal MANAGER.

Der Echodatei können Sie entnehmen, daß im Parameter DL für die Länge dieses Merkmals der Wert 50 und im Parameter DT für den Datentyp der Wert T (für TIMESTAMP) definiert wurde. Das Merkmal MANAGER darf jedoch nicht den Datentyp TIMESTAMP haben. Der gültige Datentyp für dieses Merkmal ist C (für CHAR). In diesem Fall müßten Sie die Befehlssprachendatei bearbeiten, den Datentyp korrigieren und das Importieren ab dem letzten festgeschriebenen Prüfpunkt erneut starten.

Sie sollten in regelmäßigen Abständen Prüfpunkte in die Datei einfügen, damit bei einem Fehler das Importieren am letzten erfolgreich festgeschriebenen Prüfpunkt wiederaufgenommen werden kann. Weitere Informationen über Prüfpunkte enthält der Abschnitt Änderungen an der Informationskatalog-Datenbank festschreiben.


[ Seitenanfang | Vorherige Seite | Nächste Seite | Inhaltsverzeichnis | Index ]