IM Centro de Informações do Relationship Resolution, Versão 4.2

Sintaxe de Comando do Utilitário de Fila

Os comandos do utilitário de fila são compostos de operações e modificadores.

A sintaxe básica de um comando de utilitário de fila é:
qutil -operation qname -modifier
qname é o nome da fila.

Operações de Comando

Operações definem as várias funções do utilitário de fila. Você pode incluir somente uma operação em um comando qutil.

-C
Cria uma nova fila. Exige um nome exclusivo para qname. Deve ser um C em maiúscula.
-f
Copia stdin na fila. Requer um qname.
-i
Copia stdin em várias filas. Requer o nome da seção conforme definido no arquivo qutil.ini. Especifica uma seção do qutil.ini a ser carregada para mensagens de entrega para várias filas.
-k
Limpe a conta para cada registro. Requer um qname. Pode ser utilizado em conjunto com o modificador -c para limitar o número de registros processados.
-p
Contagem de pico para cada registro. Não remove registros da fila. Requer um qname. Grava em stdout. Pode ser utilizado em conjunto com o modificador -c para limitar o número de registros processados.
-r
Lê a contagem de cada registro. Remove registros da fila. Requer um qname. Grava em stdout. Pode ser utilizado em conjunto com o modificador -c para limitar o número de registros processados.
-s
Status da fila. Requer um qname.
-x
Excluir qname. Requer um qname.
Por exemplo,

Para saída para várias filas dos dados adquiridos diretamente de um processo (como AFP).

qutil -i sectionname < sourcefile

Modificadores de Comando

Modificadores configuram parâmetros adicionais para uma operação do utilitário de fila. Você pode utilizar mais de um modificador em um comando qutil.
-T
Transacional Especifica se uma fila é transacional.

Por padrão, todas as novas filas não são transacionais, a menos que especificadas após a criação como transacional como um modificador -T.

Filas transacionais não devem ser utilizadas quando uma fila tiver que receber informações de roteamento de um monitor de aplicativos. As filas transacionais no Microsoft Message Queueing não permitem que mensagens sejam priorizadas ou processadas em outra ordem que não seja aquela em que elas são recebidas.

-c
Contagem Especifica uma parada após a contagem de registros ter sido processada. Requer um inteiro. Deve ser um c minúsculo.
-l
Prioridade Especifica o nível de prioridade para cada registro. Requer um inteiro.
  • Os níveis de prioridade do Microsoft Message Queueing são 0 - 7, em que 0 é o mais baixo, 7 é o mais alto e 3 é o padrão.
  • Os níveis de prioridade do IBM Websphere MQ são 0 - 9, em que 0 é o mais baixo e 9 é o mais alto. O valor padrão depende de uma propriedade da fila. Você pode alterar essa propriedade no seu gerenciador de filas.
-m (Apenas UNIX)
Gerenciador de Filas Especifica o gerenciador de filas.
-o
Expirar Especifica o número de segundos antes de uma mensagem expirar. Requer um inteiro.
-t
Pausar Especifica o número de milissegundos que deve ser aguardado entre cada registro. Requer um inteiro.

Relacionamentos entre o Modificador e a Operação dos Comandos

Determinados modificadores são recomendados apenas para uso com determinadas operações. A seguinte tabela descreve o relacionamento de cada operação com seus modificadores em potencial:
Tabela 1. Relacionamentos entre o Modificador e a Operação dos Comandos do Utilitário de Fila
Operação Modificadores Válidos
-C
-T
EXEMPLO: qutil -C qname [-T]
-f
-c, -t, -l, -o
EXEMPLO: qutil -f qname [-c count] [-t pause] [-l priority] [-o expire]
-i
NONE EXEMPLO: qutil -i configsection
-k
-c
EXEMPLO: qutil -k qname [-c count]
-p
-c
EXEMPLO: qutil -p qname [-c count]
-r
-c
EXEMPLO: qutil -r qname [-c count]
-s
NONE EXEMPLO: qutil -s qname
-x
NONE EXEMPLO: qutil -x qname
Conceitos relacionados
Utilitário de Fila


Feedback

Última atualização: 2007