itmcmd history

Przeznaczenie:  zarzdza przenoszeniem kocowym danych historycznych do plikw
                tekstowych z ogranicznikami.

Uwagi dotyczce skadni:  [ opcjonalne ]  wzajemnie|wykluczajce_si

Przenoszenie kocowe:
  itmcmd history [ -h CANDLEHOME ] -C [ -L nnn[Kb|Mb] ] [ -t maski*,itp. ]
  [ -D ogranicznik ] [ -H|+H ] [ -N n ] [ -i instancja|-p nazwa_tems ] kod_prod

Planowanie przenoszenia kocowego:
  itmcmd history -A?
  itmcmd history [ -h CANDLEHOME ] -A perday|0 [ -W dni ] [ -L nnn[Kb|Mb] ]
  [ -t maski*,itd. ] [ -D ogranicznik] [ -H|+H ] [ -N n ] [ -i instancja|-p nazwa_tems ] kod_prod

Opcje mog by skadane i rozdzielane spacjami zgodnie ze standardow konwencj obowizujc w systemie UNIX.
Wymienione poniej trzy przykadowe zapisy maj to samo znaczenie:

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

Opcje oglne:

  -h  katalog CANDLEHOME.  Jeli -h jest jedyn opcj bez wartoci, oznacza
      wywoanie pomocy.

  -i instancja  przetwarzanie danych historycznych zebranych przez konkretn
     instancj produktu kod_prod.  

  -p nazwa_tems  przetwarzanie danych historycznych zebranych przez TEMS
     nazwa_tems.  Opcjonalne.  Uwaga: z t opcj musi by uywany kod_prod "ms".  Dziaaniem domylnym jest przetwarzanie danych zebranych przez agenta
     kod_prod.

  kod_prod  2-znakowy kod produktu (np. mq), ktrego ma dotyczy przenoszenie
     kocowe.

  -t Lista tabel lub ich wzorcw ksh rozdzielonych przecinkami,
     dwukropkami, ukonikami lub odstpami (ujta w cudzysw, jeli elementy
     s oddzielone spacjami lub mog by zidentyfikowane jako plik).  Nazwy
     tabel s zawsze pisane wielkimi literami, ale w opcji -t wielko liter
     jest ignorowana.

Uwagi dotyczce przenoszenia kocowego:

  Operacja przenoszenia kocowego polega na przeksztaceniu plikw historii
  wybranych tabel produktu w pliki z ogranicznikami nadajce si do uycia w
  arkuszu kalkulacyjnym lub podobnym programie.   Przenoszenie kocowe mona
  uruchomi w dowolnym momencie; agent nie musi by aktywny.

  Nie jest przeprowadzana sprawdzenie, czy wpisy na licie tabel s moliwe do
  zinterpretowania ani czy s faktycznie uywane.  Kada z tabel zostanie
  przeniesiona tylko raz w kadym wykonaniu komendy itmcmd history -C, nawet
  jeli jej nazwa jest zgodna z wicej ni jedn mask.

Parametry przenoszenia kocowego:

  -C  Identyfikuje wywoanie jako danie przeniesienia kocowego danych
      historycznych.  Wymagany.

  -L  Powoduje przetwarzanie tylko tych plikw historii, ktrych rozmiar
      przekracza podan liczb kB lub MB.
      Dozwolone s przyrostki: K, Kb, M, Mb oraz brak przyrostkam ktry oznacza
      KB.

  -H  Wyklucza nagwki kolumn.  Warto domylna to "attribute".

  +H  Uwzgldnia nazwy grup (dugich tabel) w nagwkach kolumn.  Obowizuje
      format "Opis_grupy.Atrybut."  Ustawienie domylne to sam atrybut.

  -N  Zachowuje generacj 0-n danych wyjciowych (domylnie 9).

  -D  Ogranicznik danych wyjciowych, ktry ma by uywany (domylnie znak
      tabulatora).  Znak spacji naley uj w pojedynczy cudzysw lub
      poprzedzi znakiem zmiany znaczenia (tj.  -D ' ').

Uwagi dotyczce planowania przenoszenia kocowego:

  Istnieje moliwo skonfigurowania przenoszenia kocowego w taki sposb, by
  byo uruchamiane przez crontab (mechanizm planowania w systemie UNIX), pod
  warunkiem e uytkownik ma uprawnienia do uywania crontab.  Aby uzyska
  szczegowe informacje, uyj komendy "man crontab".  
  Wpisy crontab s unikalne dla identyfikatora uytkownika systemu UNIX,
  ktry je utworzy.

  -A  Identyfikuje wywoanie jako danie zaplanowania przenoszenia kocowego.  Wymagany.  Automatycznie uruchamia przenoszenie kocowe okrelon liczb
      razy dziennie, uywajc mechanizmu crontab.  Dozwolone wartoci:

      -A n  n naley do przedziau 1-24.  Liczba uruchomie na dzie,
            zaokrglona w gr do najbliszego podzielnika 24 (np. -A 7 oznacza
            uruchamianie co trzy godziny).

      -A 0  Anuluje automatyczne przenoszenie kocowe okrelonych tabel.

      -A ?  Wywietla list wpisw crontab przenoszenia kocowego dla
            wszystkich tabel.

      Komenda itmcmd history porwnuje listy wzorcw tabel z biecego i
  poprzednich uruchomie.  
      Dla kadego elementu listy wzorcw tabel w TYM
  wywoaniu itmcmd history -A wzorzec jest porwnywany ze znakami, ktre
  definioway kady wczeniejszy wzorzec, ale NIE z kadym moliwym
  rozwiniciem wczeniejszych wzorcw.  Przykad:

        Poprzednie wywoanie:  itmcmd history -A 2 -t quack*,moo*
        Nowe wywoanie:        itmcmd history -A 1 -t   qua*,moo1*

        Takie dziaanie ma na celu eliminacj jednego z dwch uruchomie w tym
  samym dniu.  Poniewa wzorzec qua* jest zgodny z quack*, wywoanie dziaa,
  mimo e moe by te zgodny z tabelami, z ktrymi nie jest zgodny wzorzec
  quack*.  
        Z kolei wzorzec moo1* nie jest zgodny z literaem moo* i nie
  zapobiega dwukrotnemu przenoszeniu tabel moo* w tym samym dniu, mimo e obie
  maski s zgodne np. z t sam nazw MOO123.  W razie wtpliwoci mona
  skorzysta z rozwizania, ktre dziaa zawsze:

          itmcmd history -A0  # Anuluje wszystko
          itmcmd history -A1 -t "tabele, o ktre nam faktycznie chodzi..."

        Komenda itmcmd zachowuje istniejce ustawienie daty, miesica oraz
  (jeli pominito -W) dnia tygodnia, jeli ktrakolwiek z tabel w biecym
  wywoaniu jest zgodna z istniejcym wpisem crontab.  
        Jeli nie jest to oczekiwany sposb dziaania, naley usun i ponownie
  utworzy wpis.

        Pozostae opcje, takie jak -D, -L i -H, NIE s zachowywane.  Naley je
  okreli ponownie lub zaakceptowa ich wartoci domylne przy kadym
  wywoaniu itmcmd history -A.

  -W  Dzie tygodnia w formacie crontab (0=nie, 1=pon... 6=sob).  Argumenty
      tej opcji mog mie posta rozdzielanej przecinkami listy liczb lub
      zakresw liczb.  Przykad:
      -W 1,3-5 oznacza poniedziaek, rod, czwartek, pitek.  Zakres domylny
               to 1-6 (pon-sob).

   Uwaga na temat rcznych aktualizacji wpisw crontab: komenda itmcmd history
   -A to najatwiejszy sposb zarzdzania automatycznym przenoszeniem kocowym
   danych historycznych.  Jednak narzdzie crontab oferuje wiksz elastyczno
   planowania ni komenda itmcmd history -A.  Moliwe jest rczne utworzenie
   komend itmcmd history w tabeli crontab.  Jeli jednak w przyszoci komenda
   itmcmd history -A bdzie kiedykolwiek uywana do wywietlania lub
   modyfikowania tych wpisw, pierwszym oddzielonym odstpem sowem po
   komendzie we wpisie crontab musi by "-Ct".  Komenda itmcmd history -A
   zachowuje te opcje planowania w kolejnych aktualizacjach.
