itmcmd history

But : gère la conversion des données d'historique en fichiers texte délimités.



Notes de syntaxe : [ facultatif ] s'excluent|mutuellement



Conversion :
  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

Planification de conversion :
  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

Les options peuvent être combinées et espacées selon la convention UNIX standard.
Les trois écritures suivantes ont des significations identiques :

  

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



Options générales :

  

  -h CANDLEHOME  Répertoire. Si -h apparaît comme option unique sans valeur, c'est un appel d'aide.

  

  -i instance  Traite les données d'historique collectées par une instance particulière de prod_code.  

  -p tems_name  Traite les données d'historique collectées par TEMS tems_name.  Facultatif.  Notez qu'un prod_code "ms" doit être utilisé avec cette option. L'action par défaut consiste à traiter les données collectées par l'agent prod_code.

  

  prod_code  Code de produit de 2 caractères (par exemple mq) du produit que vous voulez convertir.

  

  -t  Liste de tables ou masques ksh de tables, délimités par une virgule, un signe deux-points, une barre oblique ou un blanc (entre apostrophes si le nom délimité par des blancs ou le masque peut correspondre à un fichier). Les noms de table sont toujours en majuscules, mais -t ne distingue pas entre minuscules et majuscules.



  -x  Exclut les attributs SAMPLES et INTERVAL dans le fichier de sortie.

Notes sur la conversion :

  

  La conversion convertit les fichiers historiques pour des tables sélectionnées d'un produit en fichiers délimités pouvant être utilisés dans un tableur ou un produit similaire. La conversion peut être exécutée à tout moment. Il n'est pas nécessaire que l'agent soit actif.

  

  Aucun contrôle n'est opéré pour vérifier que les entrées de la liste du tableau sont significatives ou effectivement utilisées. Chaque table sera convertie une seule fois par exécution d'itmcmd history -C, même si plusieurs masques y correspondent.



Paramètres de conversion :

  

  -C identifie cela comme un appel de conversion d'historique. Obligatoire.  

  -L Traiter uniquement les fichiers historiques dont la taille est supérieure à un nombre défini de kilobits ou mégabits.
      Le suffixe peut être néant, k, ko, M, Mo, néant signifiant ko.

  

  -H Exclure les en-têtes de colonnes. La valeur par défaut est "attribute".

  

  +H Inclure les noms de groupe (table longue) dans les en-têtes de colonnes. Le format est "Group_desc.Attribute". La valeur par défaut est uniquement attribute.

  

  -N Conserver les générations 0-n de la sortie (la valeur par défaut est 9).

  -D Délimiteur de sortie à utiliser (la valeur par défaut est le caractère de tabulation). Apostrophe ou espace vide : (c'est-à-dire  -D ' ').

Notes de planification de la conversion :

  

  Vous pouvez configurer la conversion d'historique pour qu'elle soit exécutée à l'aide de crontab (la fonction de la planification UNIX) à condition d'être autorisé à utiliser crontab. Consultez la section sur "man crontab" pour plus de détails. Les entrées Crontab sont uniques pour l'ID UNIX qui les a créés.

  -A Identifie un appel de planification de conversion de l'historique. Obligatoire. En mode automatique, exécute la conversion le nombre de fois défini par jour à l'aide de crontab. Les valeurs doivent être :



      -A n  n is 1-24. Nombre d'exécutions par jour, arrondi au diviseur de 24 le plus proche (par exemple -A 7 signifie exécuter toutes les trois heures).



            -A 0 Annule toutes les conversions automatiques pour la ou les tables spécifiées.



      -A ? Affiche les entrées crontab de la conversion pour toutes les tables.



      La commande itmcmd history compare les listes table-masque des exécutions en cours et antérieures. 
      Pour chaque élément de la liste table-masque de CET appel itmcmd history -A, le masque est comparé aux caractères qui définissait chaque masque plus ancien, mais NON à chaque extension possible du masque plus ancien. Exemple :

        Appel antérieur : itmcmd history -A 2 -t quack*,moo*
        Nouvel appel : itmcmd history -A 1 -t  qua*,moo1*



        L'objectif est de passer de 2 exécutions par jour à une exécution par jour. qua* correspondant à quack*, cette méthode fonctionne mais pourrait inclure des tables que quack* n'aurait pas incluses. 
Cependant moo1* ne correspond pas aux caractères littéraux moo* et n'arrête pas les deux conversions quotidiennes des tables moo*, mêmes si les deux masques correspondent à la table MOO123. En cas de doute, la solution suivante fonctionne toujours :



          itmcmd history -A0 # Tout annuler
          itmcmd history -A1 -t "tables dont j'ai vraiment besoin..."

        La commande itmcmd history préserve les paramètres de date, mois et (si vous omettez -W) jour de la semaine si une table de l'appel en cours correspond à une entrée crontab existante. 
        S'il ne s'agit pas du comportement désiré, supprimez et recréez l'entrée.

        Les autres options, telles que -D, -L et -H ne sont PAS conservées. Elles doivent être redéfinies ou être définies par défaut avec chaque appel itmcmd history -A.

  

  -W Jour de la semaine en format crontab (0=dim, 1=lun... 6=sam). Les arguments de cette option peuvent être une liste délimitée par des virgules de nombres ou d'intervalles de nombres.  Exemple :
      -W 1,3-5 signifie lun, mer, jeu, ven. La valeur par défaut est 1-6 (lun-sam).

   

   Note sur les mises à jour manuelles de crontab : itmcmd history -A est le moyen le plus simple de gérer automatiquement l'exécution de la conversion d'itmcmd history. Cependant, crontab permet une souplesse de planification qu'itmcmd history -A n'offre pas. Vous pouvez créer manuellement des commandes itmcmd history dans crontab. Cependant, si vous voulez utiliser itmcmd history -A pour afficher ou modifier ces entrées, le premier mot délimité par des blancs après la commande dans l'entrée crontab doit être "-Ct". La commande itmcmd history -A préserve ces options de planification pour les mises à jour suivantes.
