itmcmd history

Propósito:  gestiona la acumulación de datos de historial en archivos de texto delimitados.


Notas de sintaxis:  [ opcional ]  mutualmente|excluyentes


Acumulación:
  itmcmd history [ -h CANDLEHOME ] -C [ -L nnn[Kb|Mb] ] [ -t máscaras*,etc ] [ -D delim ] [ -H|+H ] [ -N n ]
  [ -i instancia|-p nombre_tems ] [-x] cód_producto

Planificación de acumulación:
  itmcmd history -A?
  itmcmd history [ -h CANDLEHOME ] -A pordía|0 [ -W días ] [ -L nnn[Kb|Mb] ] [ -t máscaras*,etc ] [ -D delim ]
  [ -H|+H ] [ -N n ] [ -i instancia|-p nombre_tem ] [-x] cód_producto

Las opciones se pueden combinar y espaciar según el convenio estándar de UNIX.
Las tres siguientes tienen el mismo significado:
  

  -t "lista tabla"  -ttable:list  -ttable,list

Opciones generales:
  

  -h  directorio CANDLEHOME.  Si -h aparece como la única opción sin ningún valor,
      llama a la ayuda.
  

  -i instancia  datos de historial de proceso recopilados por una instancia
                específica de código_prod.  

  -p nombre_tems  datos de historial de proceso recopilador por TEMS nombre_tems.  Opcional. Tenga en cuenta que con esta opción se debe utilizar
                  un código_prod de "ms".  La acción predeterminada es procesar
                  los datos recopilados por el agente código_producto.

  

  código_prod     código de producto de 2 caracteres (por ej., mq) del
                  producto para el que desea realizar la acumulación.
  

  -t  Lista de tablas o patrones ksh de las mismas, delimitados por coma,
      punto y coma, guión o espacio en blanco (comilla si delimitado por
      espacios en blanco o el patrón puede coincidir con un archivo).  Los
      nombre de tabla van siempre en mayúsculas, pero -t no distingue entre
      mayúsculas y minúsculas.


  -x  Excluye atributos SAMPLES e INTERVAL en el archivo de salida.

Notas sobre la acumulación:
  

  La acumulación convierte los archivos de historial para las tablas seleccionadas
  de un producto en archivos delimitados para que sean utilizados en una hoja de
  cálculo o producto similar.   La acumulación se puede ejecutar en cualquier
  momento; no es necesario que el agente esté activo.

  

  No existe ninguna comprobación para garantizar que las entradas de la tabla
  tengan significado o que realmente se utilicen.  Cada tabla se acumulará
  sólo una vez por ejecución de itmcmd history -C incluso si varias
  máscaras de tabla coinciden con la misma.



Parámetros de la acumulación:
  

  -C  Identifica esto como una llamada de acumulación de historial.  Necesaria.

  -L  Sólo procesa archivos de historial cuyo tamaño sea superior a un número
      especificado de Kb o Mb.
      El sufijo puede ser cualquiera entre ninguno, K, Kb, M, Mb, y ninguno se
      aplica a Kb.
  

  -H  Excluir cabeceras de columna.  El valor predeterminado es "atributo".
  

  +H  Incluir nombres de grupo (tabla larga) en cabeceras de columna.  El
      formato es "Desc_grupo.Atributo".  El valor predeterminado es sólo
      atributo.
  

  -N  Mantiene generaciones 0-n de salida (el valor predeterminado es 9.).

  -D  Delimitador de salida a utilizar (El valor predeterminado es un carácter
      de tabulación.).  Comilla o espacio en blanco de escape (por ej.,  -D ' ').

Notas sobre la planificación de la acumulación:
  

  Puede configurar la acumulación de historial para ejecutarse mediante crontab (el
  recurso de planificación de UNIX) siempre que esté autorizado a utilizar crontab.  Consulte "man crontab" para ver los detalles. 
  Las entradas de crontab son exclusivas del ID de UNIX que las ha creado. 

  -A  Identifica esto como una llamada de planificación de acumulación de historial.  Necesaria. Ejecuta automáticamente la acumulación el número especificado de
      veces por día mediante crontab.  Los valores deben ser:


      -A n  n es 1-24.  Número de ejecuciones por día, redondeado al divisor más cercado a
       24 (por ej., -A 7 significa que se ejecuta cada tres horas).


            -A 0  Cancela todas las acumulaciones automáticas para las tablas especificadas.


      -A ?  Lista las entradas de crontab de retrotracción para todas las tablas.


        El historial de itmcmd compara las listas de patrones de tabla de la ejecución
      actual y de las ejecuciones anteriores. 
      Para cada elemento en la lista de patrones de tabla de ESTA llamada -A de historial de itmcmd, el patrón
      se compara con los caracteres que han definido cada patrón más antiguo pero NO con cada posible expansión
      del patrón más antiguo.  Ejemplo:

        Llamada antigua:  itmcmd history -A 2 -t quack*,moo*
        Nueva llamada:  itmcmd history -A 1 -t   qua*,moo1*

            La intención es cambiar de 2 ejecuciones por día a una ejecución por día.  Debido a que qua* coincide con quack*, funciona, aunque podría coincidir con
        tablas con las que quack* no lo hiciera. 
        Pero moo1* no coincide con los caracteres literales moo* y no detiene la acumulación
        dos veces por día de tablas moo*, incluso aunque ambas máscaras coincidirían con la tabla
        MOO123.  En caso de duda, esto siempre funciona:

          itmcmd history -A0  # Cancelar todo
          itmcmd history -A1 -t "tables I really want..."

                itmcmd history conserva la fecha, mes y día de la semana (si omite -W) existentes
        si alguna tabla en la llamada actual coincide con una entrada crontab existente. 
        Si este no es el comportamiento deseado, suprima y vuelva a crear la entrada.

            Otras opciones, como por ejemplo -D, -L y -H, NO se conservan.  Se deben
        volver a especificar o volver a los valores predeterminados con cada
        llamada itmcmd history -A.
 

  -W  Día de la semana en formato crontab (0=Dom, 1=Lun... 6=Sab).  Los argumentos
      de esta opción pueden ser una lista delimitada por comas de números o de rangos
      de los mismos.  Ejemplo:
      -W 1,3-5 significa Lun, Mie, Jue, Vie.  El valor predeterminado es 1-6 (Lun-Sab).
   

   Nota sobre las actualizaciones manuales de crontab:  itmcmd history -A es la forma
   más sencilla de gestionar la ejecución de acumulación automática de itmcmd history.  Sin embargo, crontab permite flexibilidad de planificación que itmcmd history -A no
   permite.  Puede crear manualmente mandatos itmcmd history en crontab.  Sin embargo,
   si alguna vez desea utilizar itmcmd history -A para listar o modificar estas entradas,
   la primera palabra delimitada por espacios en blanco después del manato en la entrada
   crontab debe ser "-Ct".  El mandato itmcmd history -A conserva estas opciones de
   planificación en las actualizaciones sucesivas.
