itmcmd history

Zweck: Verwaltet die Umlagerung von Protokolldaten in Textdateien mit Trennzeichen. 

Hinweise zur Syntax: [ optional ]  gegenseitig|ausschließend 

Umlagerung (Rolloff):
  itmcmd history [ -h CANDLEHOME ] -C [ -L nnn[Kb|Mb] ] [ -t masken*,etc ] [ -D begrenzer ] [ -H|+H ] [ -N n ]
  [ -i instanz|-p tems_name ] [-x] prod_code 

Terminierung der Umlagerung:
  itmcmd history -A?
  itmcmd history [ -h CANDLEHOME ] -A ausf_pro_tag|0 [ -W wochentage ] [ -L nnn[Kb|Mb] ] [ -t masken*,etc ] [ -D begrenzer ]
  [ -H|+H ] [ -N n ] [ -i instanz|-p tems_name ] [-x] prod_code 

Die Optionen können entsprechend der üblichen UNIX-Konventionen kombiniert und
durch Leerzeichen voneinander getrennt werden. Die folgenden drei Angaben
haben dieselbe Bedeutung: 

  -t "table list"  -ttable:list  -ttable,list

Allgemeine Optionen: 

  -h CANDLEHOME - Das CANDLEHOME-Verzeichnis. Wird '-h' als einzige Option
                  ohne Wert angegeben, wird die Hilfe aufgerufen. 

  -i instanz    - Verarbeitet die Protokolldaten, die von einer bestimmten
                  Instanz des Produkts 'prod_code' erfasst wurden.  

  -p tems_name  - Verarbeitet die Protokolldaten, die vom TEMS 'tems_name'
                  erfasst wurden. Optional. Mit dieser Option muss der Produktcode
                  "ms" verwendet werden. Die Standardaktion ist die Verarbeitung
                  der vom 'prod_code'-Agenten erfassten Daten. 

  prod_code     - Der aus zwei Zeichen bestehende Produktcode (z. B. mq)
                  des Produkts, für das die Umlagerung ausgeführt werden soll.  

  -t            - Liste der Tabellen oder ksh-Muster der Tabellen. Trennzeichen
                  sind Kommas, Doppelpunkte, Schrägstriche oder Leerzeichen
                  (Anführungszeichen bei Begrenzung durch Leerzeichen oder
                  wenn das Muster mit einer Datei übereinstimmen darf).
                  Tabellennamen werden immer groß geschrieben; für -t wird
                  die Groß-/Kleinschreibung jedoch ignoriert. 

  -x            - Schließt die Attribute SAMPLES und INTERVAL in der
                  Ausgabedatei aus. 

Hinweise zur Umlagerung: 

  Die Umlagerung (Rolloff) wandelt Protokolldateien für ausgewählte Tabellen
  eines Produkts in Dateien mit begrenzter Satzlänge um, die in einem
  Spreadsheet oder einem ähnlichen Produkt verwendet werden können. Die
  Umlagerung kann jederzeit ausgeführt werden; der Agent muss dazu nicht aktiv
  sein. 

  Es wird nicht überprüft, ob die Einträge in der Tabellenliste aussagekräftig
  sind oder tatsächlich verwendet werden. Jede Tabelle wird bei jeder Ausführung
  von 'itmcmd history -C' nur einmal umgelagert, auch wenn mehrere Tabellenmasken
  mit der Tabelle übereinstimmen. 

Parameter für die Umlagerung: 

  -C  Identifiziert dies als Aufruf zur Protokollumlagerung. Diese Angabe
      ist erforderlich. 

  -L  Verarbeitet nur Protokolldateien, die größer sind als eine angegebene
      Anzahl an Kb oder Mb. Als Suffix kann K, Kb, M oder Mb verwendet werden.
      Wird kein Suffix angegeben, wird Kb verwendet. 

  -H  Schließt Spaltenüberschriften aus. Der Standardwert ist "attribute". 

  +H  Nimmt Gruppennamen (lange Tabellennamen) in Spaltenüberschriften auf. Das
      Format ist "Gruppenbeschreibung.Attribut". Standardmäßig wird nur das
      Attribut verwendet. 

  -N  Behält die älteren Versionen 0-n der Ausgabe bei (der Standardwert ist 9). 

  -D  Der zu verwendende Begrenzer für die Ausgabe (der Standardwert ist das
      Tabulatorzeichen). Leerzeichen müssen in Anführungszeichen oder
      Escapezeichen eingeschlossen werden. Beispiel: -D ' '. 

Hinweise zur Terminierung der Umlagerung: 

  Sie können die Ausführung der Umlagerung von Protokolldaten mithilfe von
  crontab (der UNIX-Zeitplanungsfunktion) konfigurieren, sofern Sie zur
  Verwendung von crontab berechtigt sind. Geben Sie den Befehl "man crontab"
  ein, um die detaillierte Hilfe aufzurufen. Crontab-Einträge gelten nur für
  die UNIX-ID, von der die Einträge erstellt wurden. 

  -C  Identifiziert dies als Aufruf für die Terminierung der Protokollumlagerung. Diese Angabe
      ist erforderlich. Führt die Umlagerung mithilfe von crontab mit der
      angegebenen Häufigkeit pro Tag automatisch aus. Die folgenden Werte müssen
      angegeben werden: 

      -A n  - n ist 1-24. Die Anzahl der Ausführungen pro Tag, aufgerundet auf
              den nächsten Teiler von 24. Beispiel: -A 7 bedeutet, dass die
              Umlagerung alle drei Stunden ausgeführt wird. 

      -A 0  - Storniert alle automatischen Umlagerungen für die angegebenen
              Tabellen. 

      -A ?  - Listet die crontab-Einträge zur Umlagerung für alle Tabellen auf. 

      Der Befehl 'itmcmd history' vergleicht die Liste der Tabellenmuster der
      aktuellen und der früheren Ausführungen. Für jeden Eintrag in der Liste
      der Tabellenmuster für den aktuellen Aufruf 'itmcmd history -A' wird das
      Muster mit den Zeichen verglichen, die die einzelnen älteren Muster
      definiert haben; Der Vergleich wird jedoch NICHT für jede mögliche
      Erweiterung des älteren Musters durchgeführt. Beispiel: 

        Alter Aufruf: itmcmd history -A 2 -t quack*,moo*
        Neuer Aufruf: itmcmd history -A 1 -t   qua*,moo1* 

        Es wird beabsichtigt, von 2 Ausführungen pro Tag auf eine Ausführung
        pro Tag umzustellen. Da qua* mit quack* übereinstimmt ist diese
        Umstellung möglich, auch wenn möglicherweise Übereinstimmungen mit
        Tabellen vorhanden sind, für die es keine Übereinstimmung mit quack*
        gab. moo1* stimmt jedoch nicht mit den Literalzeichen moo* überein und
        stoppt die Umlagerung der 'moo*'-Tabellen zwei Mal am Tag nicht, auch
        wenn beide Masken mit dem Tabellennamen MOO123 übereinstimmen würden. Im
        Zweifelsfall erzielt das folgende Verfahren immer die gewünschten
        Ergebnisse: 

          itmcmd history -A0  # Storniert alle Ausführungen
          itmcmd history -A1 -t Tabellen, die umgelagert werden sollen..." 

        Der Befehl 'itmcmd history' behält die Einstellung für das vorhandene
        Datum, den vorhandenen Monat und (sofern die Option -W nicht angegeben
        wird) den vorhandenen Wochentag bei, wenn eine beliebige Tabelle im
        aktuellen aufruf mit einem vorhandenen crontab-Eintrag übereinstimmt. Wenn
        dies nicht das gewünschte Verhalten ist, müssen Sie den Eintrag löschen
        und erneut erstellen. 

        Andere Optionen, wie beispielsweise -D, -L und -H werden NICHT
        beibehalten. Sie müssen mit jedem Aufruf von itmcmd history -A erneut
        angegeben werden; andernfalls erden die Standardeinstellungen verwendet.


  -W  Wochentag im crontab-Format (0=Sonntag, 1=Montag ... 6=Samstag). Die
      Argumente für diese Option können in einer durch Kommas begrenzten Liste
      mit Zahlen oder Zahlenbereichen angegeben werden. Beispiel: -W 1,3-5
      bedeutet Montag, Mittwoch, Donnerstag und Freitag. Der Standardwert ist
      1-6 (Montag bis Samstag). 

   Hinweis zu manuellen crontab-Aktualisierungen: Der Befehl 'itmcmd history -A'
   stellt die einfachste Methode zum Verwalten der automatischen Ausführung
   der Umlagerung über den Befehl 'itmcmd history' dar. Die Funktion 'crontab'
   ermöglicht jedoch eine Flexibilität der Terminierung, die mit dem Befehl
   'itmcmd history -A' nicht bereitgestellt wird. Sie können 'itmcmd history'-Befehle
   in crontab manuell erstellen.  Wenn Sie jedoch jemals den Befehl 'itmcmd history -A'
   verwenden wollen, um diese Einträge aufzulisten oder zu bearbeiten, muss
   das erste durch Leerzeichen begrenzte Wort nach dem Befehl im crontab-Eintrag
   "-Ct" lauten. Der Befehl 'itmcmd history -A' behält diese Terminierungsoptionen
   bei nachfolgenden Aktualisierungen bei.
