itmcmd history

Obiettivo:  gestisce il rolloff dei dati della cronologia in file di testo delimitati.

Note sintassi:  [ optional ]  mutually|exclusive

Rolloff:
  itmcmd history [ -h CANDLEHOME ] -C [ -L nnn[Kb|Mb] ] [ -t masks*,etc ] [ -D delim ] [ -H|+H ] [ -N n ] 
  [ -i instance|-p tems_name ] [-x] prod_code

Pianificazione Rolloff:
  itmcmd history -A?
  itmcmd history [ -h CANDLEHOME ] -A perday|0 [ -W days ] [ -L nnn[Kb|Mb] ] [ -t masks*,etc ] [ -D delim ] 
  [ -H|+H ] [ -N n ] [ -i instance|-p tems_name ] [-x] prod_code

Le opzioni possono essere combinate e intervallate per convenzione UNIX standard.
Queste tre hanno significato identico:

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

Opzioni generali:

  -h  Directory CANDLEHOME.  Se -h compare come la sola opzione senza un valore,
      è una chiamata della guida.

  istanza -i  elabora i dati raccolti da un'istanza specifica di prod_code.  

  -p tems_name  elabora i dati raccolti da TEMS tems_name.  Facoltativo.  Si noti
               che un prod_code di "ms" deve essere utilizzato con questa opzione.  L'azione
               predefinita è l'elaborazione di dati raccolti dall'agent prod_code.

  prod_code  codice di prodotto a due caratteri (es. mq) del prodotto di cui si desidera eseguire il
             rolloff.

  -t  Elenco di tabelle o schemi ksh, delimitati da virgola, due punti, barra o spazio vuoto
      (mettere tra virgolette se delimitato da uno spazio vuoto o lo schema può corrispondere a un file).  I nomi delle tabelle
      sono sempre in maiuscolo, ma -t ignora il maiuscolo e il minuscolo.

  -x  Esclude gli attributi SAMPLES e INTERVAL nel file di output.

Note Rolloff:

  Rolloff converte i file di cronologia per le tabelle selezionate di un prodotto per file delimitati per l'utilizzo in un foglio di calcolo o prodotto simile.   Il Rolloff può essere eseguito in qualsiasi momento; l'agent non deve essere attivo.

  Non esiste alcuna verifica che assicuri che le voci nell'elenco delle tabelle siano significative o realmente utilizzate.  Ad ogni tabella verrà eseguito il rolloff solo una volta per l'esecuzione -C della cronologia itmcmd anche se più maschere di tabelle corrispondono.

Parametri Rolloff:

  -C  Identifica questo elemento come una chiamata di rolloff di cronologia.  Obbligatorio.

  -L  Elabora solo i file di cronologia la cui dimensione è superiore a un numero specificato di Kb o Mb.
      Il suffisso può essere nessuno, K, Kb, M, Mb e nessuno implica Kb.

  -H  Esclude le intestazioni delle colonne.  Il valore predefinito è "attribute".

  +H  Include i nomi dei gruppi (tabella lunga) nelle intestazioni delle colonne.  Il formato è
      "Group_desc.Attribute."  Il valore predefinito è solo attribute.

  -N  Mantiene le generazioni 0-n di output (il valore predefinito è 9.).

  -D  Il delimitatore output da utilizzare (il valore predefinito è il carattere di tabulazione.).  Mettere tra virgolette o evitare gli spazi vuoti (es.  -D ' ').

Note di pianificazione Rolloff:

  È possibile configurare il rolloff della cronologia da eseguire attraverso crontab (la funzione della pianificazione di UNIX)
  se si dispone dell'autorizzazione a utilizzare crontab.  Consultare la documentazione crontab per i dettagli.  
  Le voci Crontab sono univoche per l'ID UNIX che le ha create.

  -A  Identifica questo elemento come una chiamata di pianificazione rolloff di cronologia.  Obbligatorio.  Esegue automaticamente il rolloff del numero di volte al giorno specificato attraverso crontab.  I valori devono essere:

      -A n  n è 1-24.  Numero di esecuzioni al giorno, arrotondato al divisore più vicino al
       24 (es. -A 7 significa esecuzione ogni tre ore).

      -A 0  Elimina tutti i rolloff automatici per le tabelle specificate.

      -A ?  Elenca le voci crontab di rolloff per tutte le tabelle.

      La cronologia itmcmd mette a confronto gli elenchi tabelle-schemi delle esecuzioni correnti e precedenti.  
      Per ogni voce dell'elenco tabelle-schemi di QUESTA chiamata -A della cronologia itmcmd, lo schema
      viene confrontato con i caratteri che hanno definito ogni schema obsoleto ma NON con ogni possibile espansione dello schema
      più obsoleto.  Esempio:

        Chiamata obsoleta:  itmcmd history -A 2 -t quack*,moo*
        Chiamata nuova:  itmcmd history -A 1 -t   qua*,moo1*

        L'intento è di modificare da 2 esecuzioni al giorno a un'esecuzione al giorno.  Poiché qua*
        corrisponde a quack*, funziona, anche se potrebbe corrispondere a tabelle che quack* non corrisponde.  
        Ma moo1* non corrisponde ai caratteri letterali moo* e non arresta
        il rolloff eseguito due volte al giorno delle tabelle moo*, anche se entrambe le maschere corrispondono alla tabella
        MOO123.  Se in dubbio, quanto segue funziona sempre:

          itmcmd history -A0  # Cancel everything
          itmcmd history -A1 -t "tables I really want..."

        La cronologia itmcmd preserva le impostazioni della data esistente, mese e (se di omette -W) giorno della settimana
        se le tabelle nelle chiamata corrente corrispondono a una voce crontab esistente.  
        Se questo non è il comportamento desiderato, eliminare e ricreare la voce.

        Altre opzioni, come -D, -L e -H NON sono preservate.  Devono essere specificate nuovamente o
        impostate su un valore predefinito con la chiamata -A della cronologia itmcmd.

  -W  Giorno della settimana in formato crontab (0=Dom, 1=Lun... 6=Sab).  Gli argomenti di questa opzione
      possono essere un elenco di numeri o intervalli delimitati da virgole.  Esempio:
      -W 1,3-5 significa Lun, Merc, Gio, Ven.  Il valore predefinito è 1-6 (Lun-Sab).

   Nota sugli aggiornamenti manuali di crontab:  -A della cronologia itmcmd è il modo più facile di gestire l'esecuzione di rolloff della cronologia itmcmd automatica.  Tuttavia crontab consente una flessibilità di pianificazione
   che -A della cronologia itmcmd non ha.  È possibile creare manualmente i comandi della cronologia itmcmd
   in crontab.  Tuttavia, se si desidera utilizzare -A della cronologia itmcmd per elencare o
   modificare queste voci, la prima parola delimitata da spazi vuoti dopo il comando nella voce
   crontab deve essere "-Ct".  Il comando -A della cronologia itmcmd conserva queste opzioni di pianificazione negli aggiornamento successivi.
