itmcmd history

Przeznaczenie:  Zarządza przenoszeniem końcowym danych historycznych
                do plików tekstowych z ogranicznikami.

Opis składni:  [ element opcjonalny ]  opcje|wykluczające_się

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

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

Opcje mogą być łączone i rozmieszczane zgodnie ze standardowymi konwencjami
w systemie UNIX.
Poniższe trzy przykłady mają takie same znaczenie: 

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

Opcje ogólne:

  -h  Katalog CANDLEHOME.  Jeśli opcja -h zostanie podana bez wartości,
      zostanie wyświetlona pomoc. 

  -i instancja  Przetwarza dane historyczne zgromadzone przez określoną
                instancję kodu produktu.  

  -p nazwa_tems Przetwarza dane historyczne zgromadzone przez wskazany serwer
                TEMS.  Opcjonalne.  Z tą opcją należy użyć produktu o kodzie
                "ms".  Domyślnym działaniem jest przetworzenie danych
                zgromadzonych przez agenta produktu o podanym kodzie. 

  kod_produktu  Dwuznakowy kod produktu (np. mq), dla którego ma być wykonana
                operacja przeniesienia. 

  -t  Wyświetla listę tabel lub wzorców powłoki ksh oddzielonych znakami:
      przecinek, dwukropek, ukośnik, spacja (podaj w cudzysłowie, jeśli zawiera
      spację lub jeśli wzorzec może być zgodny z nazwą pliku). Nazwy tabel
      zawsze mają wielkie litery, opcja -t ignoruje wielkość liter. 

  -x  Wyklucza atrybuty SAMPLES i INTERVAL z pliku wyjściowego. 

Uwagi:

  Funkcja przenoszenia przekształca pliki historii dla wybranych tabel produktu
  w pliki z separatorami, które mogą być używane np. w arkuszach
  kalkulacyjnych.   Funkcja przenoszenia może być uruchomiona w dowolnym
  momencie, agent nie musi być aktywny. 

  Nie jest wykonywane sprawdzanie sensowności ani użyteczności listy tabel.
  Każda tabela zostanie przeniesiona tylko raz w jednym wykonaniu komendy
  itmcmd history -C, nawet jeśli będzie wskazywana przez wiele masek. 

Parametry:

  -C  Wskazuje, że wykonywane przenoszenie historii.  Wymagane. 

  -L  Przetwarzane są tylko te pliki historii, których wielkość przekracza
      podany próg. Można podać przedrostek K, Kb, M, Mb, brak przedrostka
      oznacza kilobajty. 

  -H  Wyłącza nagłówki kolumn.  Domyślny: "atrybut".

  +H  Umieszcza nazwy grup (długie tabele) w nagłówkach kolumn.  Format:
      "opis_grupy_.atrybut".  Domyślnie podawany jest tylko atrybut. 

  -N  Przechowuj 0-n generacji danych wyjściowych (domyślnie: 9).

  -D  Separator danych wyjściowych (domyślnie jest to znak tabulacji).  
      Spacje należy umieszczać w cudzysłowie lub poprzedzać znakiem zmiany
      znaczenia (np.  -D ' ').

Uwagi na temat harmonogramu:

  Istnieje możliwość skonfigurowania przenoszenia historii z użyciem funkcji
  planowania w systemie UNIX (crontab), jeśli użytkownik ma odpowiednie
  uprawnienia.  Patrz komenda: "man crontab". Pozycje komendy crontab
  dotyczą użytkownika, który je utworzył. 

  -A  Wskazuje, że wykonywane jest planowanie przenoszenia historii. Wymagane.
      Automatycznie przenosi podaną liczbę razy dziennie, używając programu
      crontab.  Wartości mogą być następujące: 

      -A n, gdzie n jest z zakresu 1-24.  Liczba uruchomień w jednym dniu,
       zaokrąglona do najbliższego podzielnika liczby 24 (czyli -A 7 oznacza
       uruchamianie co 3 godziny).

      -A 0  Anuluje automatyczne przenoszenie dla podanej tabeli.

      -A ?  Wyświetla pozycje programu crontab dla wszystkich tabel. 

      Komenda itmcmd history porównuje listę wzorców tabel bieżącego
      i poprzedniego uruchomienia.  Dla każdego elementu na liście TEJ komendy
      itmcmd history -A, wzorzec jest porównywany ze znakami definiującymi
      starsze wzorce, ale NIE wszystkie możliwe rozwinięcia starszego wzorca.
      Przykład:

        Poprzednie wywołanie:  itmcmd history -A 2 -t kwak*,muu*
        Nowe wywołanie:  itmcmd history -A 1 -t kwa*,muu1*

        Celem komendy jest zmiana z dwóch uruchomień dziennie, na raz dziennie.
        Ponieważ wzorzec kwa* jest zgodny z kwak*, komenda zadziała, chociaż
        może objąć tabele, których nie uwzględniłby wzorzec kwak*.  Wzorzec
        muu1* nie pasuje do znaków literału muu* i nie zatrzymuj przenoszenia
        tabel muu* dwa razy dziennie, mimo tego, że obie maski są zgodne
        z tabelą np. MUU123.  W razie wątpliwości, to zawsze zadziała: 

          itmcmd history -A0  # Anulowanie wszystkiego
          itmcmd history -A1 -t "Tabele, które naprawdę chcę..."

        Komenda itmcmd history zachowuje istniejącą datę, miesiąc i (jeśli
        pominięta zostanie opcja -W) dzień tygodnia, jeśli jakakolwiek tabela
        w bieżącym wywołaniu jest zgodna z istniejącą pozycją crontab. Jeśli
        to nie jest pożądane, usuń i ponownie utwórz pozycję. 

        Inne opcje, takie jak -D, -L i -H, NIE są zachowywane.  Muszą być
        ponownie podane (lub mogą być pominięte) w każdym wywołaniu komendy
        itmcmd history -A.

  -W  Dzień tygodnia w formacie programu crontab (0=niedziela,
      1=poniedziałek... 6=sobota).  Argumenty tej opcji mogą być listą pozycji
      oddzielanych przecinkiem z podanego zakresu.  Na przykład: -W 1,3-5
      oznacza poniedziałek, środę, czwartek i piątek.  Wartość domyślna: 1-6
      (poniedziałek-sobota).

   Informacja na temat ręcznej aktualizacji tabel programu crontab:
   Komenda itmcmd history -A jest najprostszym sposobem zarządzania
   automatycznym przenoszeniem historii.  Należy jednak pamiętać o tym, że
   program crontab ma większą elastyczność, niż komenda itmcmd history -A.
   Można ręcznie utworzyć komendy itmcmd history w tabeli programu crontab.
   Jeśli jednak komenda itmcmd history -A ma być używana do wyświetlania
   listy lub modyfikowania tych pozycji, pierwszym słowem po spacji za komendą
   w tabeli crontab musi być "-Ct".  Komenda itmcmd history -A zachowuje te
   opcje harmonogramu w kolejnych modyfikacjach.
