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 FilaOperaçã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 |