Histórico do itmcmd

Propósito: gerencia a movimentação de dados históricos nos arquivos de texto delimitado.

Notas de sintaxe: [ opcional ]  mutuamente|exclusiva

Movimentação:
histórico do itmcmd [ -h CANDLEHOME ] -C [ -L nnn[Kb|Mb] ] [ -t masks*,etc ] [ -D delim ] [ -H|+H ] [ -N n ]
  [ -i instance|-p tems_name ] [-x] prod_code

Planejamento de Movimentação:
-A do histórico do itmcmd?
  Histórico do itmcmd [ -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

As opções podem ser combinadas e espaçadas por convenção padrão do UNIX.
Estas três podem ter significados idênticos:

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

Opções gerais:

  -h diretório CANDLEHOME.  Se -h aparecer como a única opção sem um valor, será uma chamada de ajuda.

  -i dados do histórico de processo da instância coletados por uma instância específica de prod_code.  

  -p tems_name dados do histórico de processo coletados pelo tems_name do TEMS.  Opcional.  Observe que um prod_code de "ms" deve ser usado com essa opção.  A ação padrão destina-se aos dados de processo coletados pelo agente prod_code.

  prod_code código do produto de dois caracteres (por exemplo, mq) do produto que você deseja mover.

  -t  Lista de tabelas ou seus padrões ksh, delimitado por vírgula, dois pontos, barra ou espaço em branco (aspas, se o espaço em branco delimitado ou o padrão puder corresponder a um arquivo).  Os nomes da tabela têm sempre distinção entre maiúsculas e minúsculas, mas o -t ignora a distinção entre maiúsculas e minúsculas.

  -x Exclua os atributos SAMPLES e INTERVAL no arquivo de saída.

Notas de movimentação:

  A movimentação converte os arquivos históricos para tabelas selecionadas de um produto para arquivos delimitados a serem usados em um produto de planilha ou semelhante.   A movimentação pode ser executada a qualquer momento; o agente não deve estar ativo.

  Não há verificação para assegurar que as entradas na lista de tabelas sejam significativas ou realmente usadas.  Cada tabela será movida apenas uma vez por execução -C do histórico do itmcmd, mesmo se diversas máscaras de tabela corresponderem a ela.

Parâmetros de movimentação:

  -C Identifica isso como uma chamada de movimentação de histórico.  Exigido.

  -L Apenas os arquivos históricos do processo cujo tamanho esteja acima de um número especificado de Kb ou Mb.
      O sufixo pode ser qualquer um de none, K, Kb, M, Mb e none implica em Kb.

  +-H  Exclua os cabeçalhos da coluna.  O padrão é "atributo".

  +H  Inclua os nomes do grupo (tabela longa) nos cabeçalhos da coluna.  O formato é "Group_desc.Attribute".  O padrão é apenas atributo.

  -N Mantenha as gerações 0-n de saída (O padrão é 9).

  -D O delimitador de saída a ser usado (O padrão é caractere de tabulação).  Aspas ou espaço em branco de escape (por exemplo,  -D ' ').

Notas de planejamento de movimentação:

  É possível configurar a movimentação de histórico para execução por meio de crontab (o recurso de planejamento do UNIX) fornecida, desde que você seja autorizado a usar crontab.  Veja "man crontab" para obter detalhes.  
  As entradas de crontab são exclusivas para o ID do UNIX que as criou.

  -A Identifica isso como uma chamada de planejamento de movimentação de histórico.  Exigido.  Executa automaticamente a movimentação do número de vezes especificado por dia por meio de crontab.  Os valores devem ser:

      -A n  n é de 1 a 24.  Número de execuções por dia, arredondado para o divisor mais próximo de 24 (por exemplo, -A 7 significa execução a cada três horas).

      -A 0 Cancela todas as movimentações automáticas para a(s) tabela(s) especificada(s).

      -A ?  Lista as entradas de crontab de movimentação para todas as tabelas.

      O histórico do itmcmd compara as listas padrão de tabelas das execuções atuais e anteriores.  
      Para cada item na lista padrão de tabela da DESSA chamada -A do histórico do itmcmd, o padrão é comparado com os caracteres que definiram cada padrão mais antigo, mas NÃO com cada expansão possível do padrão mais antigo.  Por exemplo:

        Chamada antiga: -A do histórico do itmcmd 2 -t quack*,moo*
        Chamada nova: -A do histórico do itmcmd 1 -t qua*,moo1*

        A intenção é alterar de duas execuções por dia para uma execução por dia.  Desde que qua* corresponda a quack*, funcionará, embora possa corresponder a tabelas que quack* não correspondeu.  
        Mas, moo1* não corresponde aos caracteres literais moo* e não para a movimentação duas vezes por dia das tabelas moo*, embora ambas as máscaras correspondam à tabela MOO123.  Se tiver dúvidas, isto sempre funciona:

          -A0 do Histórico do itmcmd # Cancelar tudo
-A1 do Histórico do itmcmd -t "tabelas que realmente desejo..."

        O histórico do itmcmd preserva a data existente, as configurações de mês e (se omitir o -W) dia da semana, se qualquer tabela nas chamadas atuais corresponder a uma entrada de crontab existente.  
        Se esse não for o comportamento desejado, exclua e recrie a entrada.

        Outras opções, como por exemplo, -D, -L e -H NÃO são preservadas.  Elas devem ser especificadas novamente ou padronizadas com cada chamada -A do histórico do itmcmd.

  -W Dia da semana no formato de crontab (0=Dom, 1=Seg... 6=Sáb).  Os argumentos para essa opção podem ser uma lista de números delimitados por vírgula ou seus intervalos.  Exemplo: -W 1,3-5 significa Seg, Qua, Qui, Sex.  O padrão é de 1 a 6 (Seg-Sáb).

   Nota sobre atualizações de crontab manual: -A do histórico do itmcmd é a maneira mais fácil de gerenciar a execução de movimentação do histórico do itmcmd automático.  No entanto, o crontab permite a flexibilidade de planejamento que o -A do histórico do itmcmd não permite.  É possível criar manualmente comandos do histórico do itmcmd no crontab.  No entanto, se ainda desejar usar o -A do histórico do itmcmd para listar ou modificar essas entradas, a primeira palavra delimitada por espaço em branco após o comando na entrada de crontab deve ser "-Ct".  O comando -A do histórico do itmcmd preserva essas opções de planejamento nas próximas atualizações.
