<MSG itmcmd >history

Zweck:    Verwaltet den Umlauf von Protokolldaten in Dateien für Text mit Trennzeichen.

Syntaxhinweise:  [ optional ]  gegenseitig|ausschließend

Umlauf:
  itmcmd history [ -h CANDLEHOME ] -C [ -L nnn[Kb|Mb] ] [ -t masken*,etc ] [ -D trennzeichen ] [ -H|+H ] [ -N n ]
  [ -i instanz|-p tems-name ] produktcode

Umlaufzeitplan:
  itmcmd history -A?
  itmcmd history [ -h CANDLEHOME ] -A pro_tag|0 [ -W tage ] [ -L nnn[Kb|Mb] ] [ -t masken*,etc ] [ -D trennzeichen ]
  [ -H|+H ] [ -N n ] [ -i instanz|-p tems-name ] produktcode

Die Optionen können gemäß der UNIX-Standardkonventionen kombiniert und angeordnet werden.
Die Bedeutung der drei folgenden ist identisch:

  -t "tabelle liste"  -ttabelle:liste  -ttabelle,liste

Allgemeine Optionen:

  -h  CANDLEHOME-Verzeichnis. Falls -h als einzige Option ohne Wert angegeben wird,
      wird die Hilfefunktion aufgerufen.

  -i instanz   Protokolldaten werden verarbeitet, die von einer bestimmten Instanz
              von 'produktcode' erfasst wurden.


  -p tems-name  Protokolldaten werden verarbeitet, die vom TEMS namens
               'tems-name' erfasst wurden. Optional. Bitte beachten Sie,
               dass diese Option mit dem Produktcode 'ms' verwendet werden
               muss. Standardaktion ist die Verarbeitung von Daten, die
               vom Agenten von 'produktcode' erfasst wurden.

  produktcode  Zweistelliger Produktcode (z. B. mq) des Produkts, für
             das der Umlauf erfolgen soll.

  -t  Liste von Tabellen oder entsprechender ksh-Muster, durch Komma,
      Doppelpunkt, Schrägstrich oder Punkt getrennt (in Anführungszeichen
      bei Leerzeichen oder falls das Muster mit einer Datei übereinstimmen
      kann). Tabellennamen stehen immer in Großbuchstaben, aber die Option
      -t ignoriert die Groß-/Kleinschreibung.

Hinweise zum Umlauf:

  Beim Umlauf werden Protokolldateien für ausgewählte Tabellen eines Produkts
  in Dateien mit begrenzter Satzlänge konvertiert, die in einem
  Tabellenkalkulationsprogramm oder einem ähnlichen Produkt verwendet
  werden können. Der Umlauf kann jederzeit ausgeführt werden; der
  Agent muss hierzu nicht aktiv sein.

  Es wird nicht überprüft, ob Einträge in der Tabellenliste aussagekräftig sind
  oder tatsächlich verwendet werden. Jede Tabelle wird nur ein Mal pro Ausführung
  des Befehls 'itmcmd history -C' ausgeführt, auch wenn sie mit mehreren
  Tabellenmasken übereinstimmt.

Parameter für den Umlauf:

  -C  Gibt an, dass es sich um einen Aufruf für den Protokollumlauf handelt.
      Diese Option ist erforderlich.

  -L  Es werden nur Protokolldateien verarbeitet, deren Größe eine
      bestimmte Anzahl von KB oder MB überschreitet. Das Suffix kann
      entweder nicht angegeben werden oder K, Kb, M bzw. Mb lauten.
      Falls es nicht angegeben ist, wird KB impliziert.

  -H  Spaltenüberschriften werden ausgeschlossen. Der Standardwert
      ist 'attribut'.

  +H  Gruppennamen (lange Tabellennamen) werden in Spaltenüberschriften
      aufgenommen. Das Format lautet 'gruppenbeschreibung.attribut'.
      Standardwert ist nur die Angabe des Attributs.

  -N  Die Generierungen 0-n der Ausgabe werden beibehalten
      (Standardwert ist 9).

  -D  Zu verwendender Begrenzer für die Ausgabe (Standardwert ist ein
      Tabulatorzeichen).  Bei Leerzeichen müssen Anführungszeichen oder
      Escapezeichen verwendet werden (d. h. -D ' ').

Hinweise zur Umlaufplanung:

  Sie können den Protokollumlauf so konfigurieren, dass er über die UNIX-
  Zeitplanungsfunktion 'crontab' ausgeführt wird, wenn Sie zur Verwendung
  von 'crontab' berechtigt sind. Details erhalten Sie nach Aufruf von
  'man crontab'.

  Einträge der Funktion 'crontab' sind für die UNIX-ID eindeutig, von
  der sie erstellt wurden.

  -A  Gibt an, dass es sich um einen Aufruf der Zeitplanung für den Protokollumlauf
      handelt. Diese Option ist erforderlich. Der Umlauf wird täglich automatisch
      so häufig ausgeführt, wie über 'crontab' angegeben. Erforderliche Werte:

      -A n  n ist 1-24. Anzahl der täglichen Ausführungen, die auf den nächsten
       Teiler von 24 aufgerundet wird (-A 7 bedeutet beispielsweise 1 Ausführung
       alle 3 Stunden).

      -A 0  Bricht alle automatischen Umläufe für die angegebene(n)
       Tabellen(n) ab.

      -A ?  Listet die Umlaufeinträge von 'crontab' für alle Tabellen auf.

      Der Befehl 'itmcmd history' vergleicht die Tabellenmusterlisten der
      aktuellen und früheren Ausführungen. Für jeden Eintrag in der
      Tabellenmusterliste DIESES Aufrufs von 'itmcmd history' mit der
      Option -A wird das Muster mit den Zeichen verglichen, die ältere
      Muster definierten, jedoch NICHT mit allen möglichen Erweiterungen
      des älteren Musters. Beispiel: 
        Alter Aufruf:  itmcmd history -A 2 -t quack*,moo*
        Neuer Aufruf:  itmcmd history -A 1 -t   qua*,moo1*

        Beabsichtigt ist eine Änderung von 2 Ausführungen auf 1 Ausführung
        pro Tag. Da die Angabe 'qua*' mit 'quack*' übereinstimmt, kann sie
        verwendet werden, obwohl sie auch mit Tabellen übereinstimmen könnte,
        die mit der Angabe 'quack*' nicht übereinstimmen. Die Angabe 'moo1*'
        stimmt jedoch nicht mit den Literalen 'moo*' überein und stoppt die
        zweimalige Ausführung des Umlaufs von Tabellen namens 'moo*' nicht,
        auch wenn beide Masken mit der Tabelle 'MOO123' übereinstimmen.
        Bei Zweifelsfällen funktioniert das folgende Verfahren immer:

          itmcmd history -A0  # Alles abbrechen
          itmcmd history -A1 -t "wirklich_gewünschte_tabellen..."

        Der Befehl 'itmcmd history' behält die vorhandenen Einstellungen
        für Datum, Monat und (bei Ausschluss der Option -W) Wochentag
        bei, falls eine Tabelle im aktuellen Aufruf mit einem vorhandenen
        Eintrag für 'crontab' übereinstimmt. Wird dieses Verhalten nicht
        gewünscht, müssen Sie den Eintrag löschen und erneut erstellen.

        Andere Optionen (z. B. -D, -L und -H) werden NICHT beibehalten. 
        Sie müssen bei jedem Aufruf des Befehls 'itmcmd history' mit der
        Option -A erneut angegeben oder mit Standardwerten definiert
        werden.

  -W  Wochentag im Format von 'crontab' (0=So, 1=Mo... 6=Sa). Die Argumente für
      diese Option können eine Liste von entsprechenden Zahlen oder Bereichen
      mit Kommatrennzeichen sein. Beispiel:
      -W 1,3-5 bedeutet Mo, Mi, Do, Fr. Standardwert ist 1-6 (Mo-Sa).

   Hinweis zu manuellen Aktualisierungen von 'crontab': Der Befehl
   'itmcmd history -A' ist die einfachste Methode für die Verwaltung der
   automatischen Umlaufausführung mit 'itmcmd history'. Die Funktion 'crontab'
   ermöglicht jedoch eine Flexibilität bei der Zeitplanung, die vom Befehl
   'itmcmd history -A' nicht geboten wird. Sie können Befehle 'itmcmd history'
   in 'crontab' manuell erstellen. Falls Sie jedoch diese Einträge mit dem
   Befehl 'itmcmd history -A' auflisten oder ändern wollen, muss das erste
   Wort nach dem Befehl im Eintrag von 'crontab', das mit einem Leerzeichen als
   Trennzeichen angegeben wird '-Ct' lauten. Der Befehl 'itmcmd history -A'
   behält diese Zeitplanungsoptionen bei erfolgreichen Aktualisierungen bei.
</MSG>
