itmcmd history

Účel: spravuje úklid historických dat do textových souborů s oddělovači.

Poznámky syntaxe:  [ volitelné ]  vzájemné|výlučné 

Úklid dat:
  itmcmd history [ -h CANDLEHOME ] -C [ -L nnn[Kb|Mb] ] [ -t masky*, atd. ] [ -D oddělovač ] [ -H|+H ] [ -N n ]
  [ -i instance|-p název_tems ] [-x] kód_produktu

Plánování úklidu dat:
  itmcmd history -A?
  itmcmd history [ -h CANDLEHOME ] -A za den|0 [ -W dny ] [ -L nnn[Kb|Mb] ] [ -t masky*, atd. ] [ -D oddělovač ]
  [ -H|+H ] [ -N n ] [ -i instance|-p název_tems ] [-x] kód_produktu

Volby lze kombinovat a rozmístit podle standardní konvence systému UNIX.
Tyto tři mají identický význam:

  -t "tabulka seznam"  -ttabulka:seznam  -ttabulka,seznam

Obecné volby:

  -h  adresář CANDLEHOME. Pokud se -h objeví pouze jako volba bez hodnoty,
      jedná se o volání nápovědy.

  -i instance   historická data procesu shromážděná specifickou instancí kód_produktu.  

  -p název_tems historická data procesu shromážděná serverem TEMS s názvem název_tems. Volitelné. Všimněte si,
                že kód produktu "ms" se musí použít s touto volbou. Výchozí akce je zpracování dat
                shromážděných agentem pro kód_produktu.

  kód_produktu  2-znakový kód produktu (např. mq), který chcete uklidit.

  -t  Seznam tabulek nebo vzorků ksh oddělených čárkou, dvojtečkou, lomítkem
      nebo mezerou (uveďte, jsou-li oddělené mezerou, nebo zda vzorek odpovídá souboru). Názvy
      tabulek jsou vždy velkými písmeny, ale -t ignoruje velká a malá písmena.

  -x  Vyloučí atributy SAMPLES a INTERVAL z výstupního souboru.

Poznámky k úklidu dat:

  Úklid dat převádí soubory historie vybraných tabulek produktu do souborů s oddělovači, aby se daly použít
  v tabulkovém kalkulátoru nebo v podobném produktu. Úklid dat lze spustit v jakémkoli čase;
  agent nemusí být aktivní.

  Neexistuje žádná kontrola, která zajistí, že položky v seznamu tabulek jsou smysluplné nebo aktuálně použité.
  Každá tabulka bude uklizena pouze jednou za provedení příkazu itmcmd history -C,
  dokonce i pokud vyhovuje více masek tabulek. 

Parametry úklidu dat:

  -C  Identifikuje to jako volání úklidu dat historie. Povinné. 

  -L  Pouze soubory historie procesu, jejichž velikost přesahuje zadané číslo Kb nebo Mb.
      Přípona může být jakákoli z hodnot žádná, K, Kb, M, Mb. Žádná znamená Kb.

  -H  Vyloučit záhlaví sloupců. Výchozí je "atribut".  

  +H  Zahrnout názvy skupiny (velká tabulka) do záhlaví sloupců. Formát je
      "Popis_skupiny.Atribut."  Výchozí je pouze atribut. 

  -N  Zachovat generace 0-n výstupu. Výchozí je 9.

  -D  Oddělovač výstupu, který se má použít. Výchozí je znak tabulátoru.  Uvozovky nebo mezery (např. -D ' ').

Poznámky plánování úklidu dat:  

  Můžete konfigurovat úklid dat historie, aby se spustila pomocí zadané služby crontab (služba plánování systému UNIX),
  ke které máte autorizaci. Podrobnosti viz  "man crontab". 
  Položky služby crontab jsou jedinečné pro ID systému UNIX, který je vytvořil.

  -A  Identifikuje to jako volání plánování úklidu dat historie. Povinné. Automaticky spouští úklid dat v uvedeném počtu
      za den pomocí služby crontab. Hodnoty musí být:

      -A n  n je 1-24. Počet spuštění za den, zaokrouhlený k nejbližšímu děliteli
       24 (např. -A 7 znamená spustit každé tři hodiny). 

      -A 0  Ruší všechny automatické úklidy dat pro uvedenou tabulku. 

      -A ?  Vypíše seznam položek služby crontab pro úklid dat všech tabulek. 

      Příkaz itmcmd history porovnává seznamy tabulkových vzorků aktuálních a dřívějších spuštění. 
      Pro každou položku seznamu vzorků tabulky TOHOTO volání itmcmd history -A platí,      že se vzorek porovnává se znaky, které definovali každý starší vzorek, ale NEPOROVNÁVÁ se
      s možným rozšířením staršího vzorku. Příklad:

        Staré volání:  itmcmd history -A 2 -t quack*,moo*
        Nové volání :  itmcmd history -A 1 -t   qua*,moo1*

        Účelem je změnit dvě spuštění za den na jedno spuštění za den. Poněvadž qua*
        se shoduje s quack*, funguje to, i když to mohlo odpovídat tabulkám, které quack* nebyly. 
        Hodnota moo1* ale neodpovídá literálním znakům moo* a nezastavuje úklid dat
        tabulek moo*, prováděných dvakrát denně, i když by masky mohly odpovídat
        tabulce MOO123. Pokud jste na pochybách, toto vždy funguje:

          itmcmd history -A0  # Zrušit všechno
          itmcmd history -A1 -t "tabulky, které skutečně chci..."

        Příkaz itmcmd history zachovává existující nastavení pro datum, měsíc a (vynecháte-li -W) den týdne,
        pokud se některá tabulka v aktuálním volání shoduje s existující položkou crontab. 
        Jestliže toto není požadované chování, odstraňte a znovu vytvořte položku.

        Jiné volby, jako -D, -L a -H NEJSOU zachovány. Musí se zadat znovu nebo
        selžou při každém volání itmcmd history -A.

  -W  Den týdne ve formátu služby crontab (0=Ne, 1=Po... 6=So). Argumentem k této volbě
      může být seznam čísel oddělených čárkami nebo jejich rozsahy. Příklad:
      -W 1,3-5 znamená Po, St, Čt, Pá. Výchozí je 1-6 (Po-So). 

   Všimněte si na ručních aktualizacích služby crontab:  Příkaz itmcmd history -A je nejlehčí způsob
   správy automatického provedení úklidu dat pomocí příkazu itmcmd history. Služba Crontab však umožňuje
   flexibilitu, kterou příkaz itmcmd history -A nemá. Ve službě crontab můžete ručně vytvořit příkazy
   itmcmd history. Pokud však někdy budete chtít použít příkaz itmcmd history -A k vypsání nebo úpravě
   těchto položek, první mezerou oddělené slovo po příkazu v položce crontab musí být "-Ct". Příkaz
   itmcmd history -A zachovává tyto volby plánování na úspěšných aktualizacích.
