itmcmd historial

Propsito:  gestiona la acumulacin de datos de historial en archivos de texto delimitados.

Notas de sintaxis:  [ opcional ]  mutualmente|excluyentes

Acumulacin:
  itmcmd historial [ -h CANDLEHOME ] -C [ -L nnn[Kb|Mb] ] [ -t mscaras*,etc ] [ -D delim ] [ -H|+H ] [ -N n ]
  [ -i instancia|-p nombre_tems ] cdigo_prod

Planificacin de acumulacin:
  itmcmd historial -A?
  itmcmd historial [ -h CANDLEHOME ] -A porda|0 [ -W das ] [ -L nnn[Kb|Mb] ] [ -t mscaras*,etc ] [ -D delim ]
  [ -H|+H ] [ -N n ] [ -i instancia|-p nombre_tems ] cdigo_prod

Las opciones se pueden combinar y espaciar segn el convenio estndar de UNIX.
Las tres siguientes tienen el mismo significado:

  -t "tabla lista"  -ttabla:lista  -ttabla,lista

Opciones generales:

  -h  Directorio de CANDLEHOME.  Si -h aparece como la nica opcin sin ningn valor,
      llama a la ayuda.

  -i instancia  datos de historial de proceso recopilados por una instancia
                especfica de cdigo_prod.  

  -p nombre_tems  datos de historial de proceso recopilador por TEMS nombre_tems.  Opcional.  Tenga en cuenta que con esta opcin se debe utilizar
                  un cdigo_prod de "ms".  La accin predeterminada es procesar
                  los datos recopilados por el agente cdigo_producto.

  cdigo_prod     cdigo de producto de 2 caracteres (por ej., mq) del
                  producto para el que desea realizar la acumulacin.

  -t  Lista de tablas o patrones ksh de las mismas, delimitados por coma,
      punto y coma, guin o espacio en blanco (comilla si delimitado por
      espacios en blanco o el patrn puede coincidir con un archivo).  Los
      nombre de tabla van siempre en maysculas, pero -t no distingue entre
      maysculas y minsculas.

Notas sobre la acumulacin:

  La acumulacin convierte los archivos de historial para las tablas seleccionadas
  de un producto en archivos delimitados para que sean utilizados en una hoja de
  clculo o producto similar.   La acumulacin se puede ejecutar en cualquier
  momento; no es necesario que el agente est activo.

  No existe ninguna comprobacin para garantizar que las entradas de la tabla
  tengan significado o que realmente se utilicen.  Cada tabla se acumular
  slo una vez por ejecucin de itmcmd history -C incluso si varias
  mscaras de tabla coinciden con la misma.

Parmetros de la acumulacin:

  -C  Identifica esto como una llamada de acumulacin de historial.  Necesario.

  -L  Slo procesa archivos de historial cuyo tamao sea superior a un nmero
      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 slo
      atributo.

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

  -D  Delimitador de salida a utilizar (El valor predeterminado es un carcter
      de tabulacin.).  Comilla o espacio en blanco de escape (por ej.,  -D ' ').

Notas sobre la planificacin de la acumulacin:

  Puede configurar la acumulacin de historial para ejecutarse mediante crontab (el
  recurso de planificacin de UNIX) siempre que est autorizado a utilizar crontab.  Consulte "man crontab" para ver los detalles.  
  Las entradas de crontab son exclusivas al ID de UNIX que las ha creado.

  -A  Identifica esto como una llamada de planificacin de acumulacin de historial.  Necesario.  Ejecuta automticamente la acumulacin el nmero especificado de
      veces por da mediante crontab.  Los valores deben ser:

      -A n  n es 1-24.  Nmero de ejecuciones por da, redondeado al divisor ms cercado a
       24 (por ej., -A 7 significa que se ejecuta cada tres horas).

      -A 0  Cancela todas las acumulaciones automticas para las tablas especificadas.

      -A ?  Lista las entradas de crontab de retrotraccin para todas las tablas.

      El historial de itmcmd compara las listas de patrones de tabla de la ejecucin
      actual y de las ejecuciones anteriores.  
      Para cada elemento de la lista de patrones de tabla de ESTA llamada -A de
      historial itmcmd, el patrn se compara con los caracteres que definan cada
      patrn antiguo pero NO cada posible expansin del patrn ms antiguo.  Ejemplo:

        Llamada anterior:  itmcmd history -A 2 -t quack*,moo*
        Llamada nueva:  itmcmd history -A 1 -t   qua*,moo1*

        La intencin es cambiar de 2 ejecuciones por da a una ejecucin por da.  Debido a que qua* coincide con quack*, funciona, aunque podra coincidir con
        tablas con las que quack* no lo hiciera.  
        Pero moo1* no coincide con los
        caracteres literales moo* y no detiene la acumulacin, realizada dos veces al
        da, de las tablas moo*, aunque ambas mscaras coincidiran con la tabla MOO123.  En caso de duda, esto siempre funciona:

          itmcmd history -A0  # Cancelar todo
          itmcmd history -A1 -t "tablas que deseo realmente..."

        itmcmd history conserva la fecha, mes y da de la semana (si omite -W) existentes
        si alguna tabla en la llamada actual coincide con una entrada crontab existente.  
        Si ste no es el comportamiento que se desea, suprima la entrada y vuelvala a
        crear.

        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  Da de la semana en formato crontab (0=Dom, 1=Lun... 6=Sab).  Los argumentos
      de esta opcin pueden ser una lista delimitada por comas de nmeros 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
   ms sencilla de gestionar la ejecucin de acumulacin automtica de itmcmd history.  Sin embargo, crontab permite flexibilidad de planificacin 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 despus del manato en la entrada
   crontab debe ser "-Ct".  El mandato itmcmd history -A conserva estas opciones de
   planificacin en las actualizaciones sucesivas.
