itmcmd history

But : gre la conversion des donnes d'historique en fichiers texte dlimits.

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

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

Les options peuvent tre combines et espaces selon la convention UNIX standard.
Les trois critures suivantes ont des significations identiques :

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

Options gnrales :

  -h CANDLEHOME directory.  Si -h apparat comme option unique sans valeur, c'est un appel d'aide.

  -i instance traiter les donnes d'historique collectes par une instance particulire de prod_code.  

  -p tems_name traiter les donnes d'historique collectes par TEMS tems_name.  Facultatif.  Notez qu'un prod_code "ms" doit tre utilis avec cette option.  L'action par dfaut consiste  traiter les donnes collectes par l'agent prod_code.

  prod_code code de produit de 2 caractres (par exemple mq) du produit que vous voulez convertir.

  -t Liste de tables ou masques ksh de tables, dlimits par une virgule, un double point, une barre oblique ou un blanc (entre apostrophes si le nom dlimit 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.

Notes sur la conversion :

  La conversion convertit les fichiers historiques pour des tables slectionnes d'un produit en fichiers dlimits pouvant tre utiliss dans un tableur ou un produit similaire.   La conversion peut tre excute  tout moment. Il n'est pas ncessaire que l'agent soit actif.

  Aucun contrle n'est opr pour vrifier que les entres de la liste du tableau sont significatives ou effectivement utilises.  Chaque table sera convertie une seule fois par excution d'itmcmd history -C, mme si plusieurs masques y correspondent.

Paramtres de conversion :

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

  -L Traiter uniquement les fichiers historiques dont la taille est suprieure  un nombre dfini de ko ou Mo.
      Le suffixe peut tre nant, k, ko, M, Mo, nant signifiant ko.

  -H Exclure les en-ttes de colonnes.  La valeur par dfaut est "attribute".

  +H Inclure les noms de groupe (table longue) dans les en-ttes de colonnes.  Le format est "Group_desc.Attribute.".  La valeur par dfaut est uniquement attribute.

  -N Conserver les gnrations 0-n de la sortie (la valeur par dfaut est 9)..

  -D Dlimiteur de sortie  utiliser (la valeur par dfaut est le caractre 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 excute  l'aide de crontab (la fonction de la planification UNIX)  condition d'tre autoris  utiliser crontab.  Voir "man crontab" pour plus de dtails.  
  Les entres de crontab sont uniques pour l'ID UNIX qui les a cres.

  -A Identifie un appel de planification de conversion de l'historique.  Obligatoire.  En mode automatique, excute la conversion le nombre de fois dfini par jour  l'aide de crontab.  Les valeurs doivent tre :

      -A n n est 1-24.  Nombre d'excutions par jour, arrondi au diviseur de 24 le plus proche (par exemple -A 7 signifie excuter toutes les trois heures).

      -A 0 Annule toutes les conversions automatiques pour la ou les tables dfinies.

      -A ?  Affiche les entres crontab de la conversion pour toutes les tables.

      La commande itmcmd history compare les listes table-masque des excutions en cours et antrieures.  
      Pour chaque lment dans la liste table-masque de CET appel itmcmd history -A, le masque est compar aux caractres qui dfinissaient tous les masques plus anciens, mais NON  chaque dveloppement possible du masque plus ancien.  Exemple :

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

        L'objectif est de passer de 2 excutions par jour  une excution par jour.  qua* incluant quack*, cela fonctionne, mais cela pourrait inclure des tables que quack* n'aurait pas incluses.  
        Mais moo1* n'inclut pas les caractres de littral moo* et n'arrte pas la conversion deux fois par jour des tables moo*, mme si les deux masques incluent 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 prserve les paramtres de date, mois et (si vous omettez -W) jour de la semaine si une table de l'appel en cours correspond  une entre crontab existante.  
        Si ce n'est pas le comportement voulu, supprimez et recrez l'entre.

        Les autres options, telles que -D, -L et -H ne sont PAS conserves.  Elles doivent tre redfinies ou tre dfinies par dfaut 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 dlimite par des virgules de nombres ou d'intervalles de nombres.  Exemple :
      -W 1,3-5 signifie lun, mer, jeu, ven.  La valeur par dfaut est 1-6 (lun-sam).

   Note sur les mises  jour manuelles de crontab : itmcmd history -A est le moyen le plus simple de grer automatiquement l'excution de la conversion d'itmcmd history.  Cependant, crontab permet une souplesse de planification qu'itmcmd history -A n'offre pas.  Vous pouvez crer manuellement des commandes itmcmd history dans crontab.  Cependant, si vous voulez utiliser itmcmd history -A pour afficher ou modifier ces entres, le premier mot dlimit par des blancs aprs la commande dans l'entre crontab doit tre "-Ct".  La commande itmcmd history -A prserve ces options de planification pour les mises  jour suivantes.
