[IBM i]

A tabela de regras do manipulador de DLQ no IBM i

A tabela de regras do manipulador de filas de dead-letter define como o manipulador de DLQ processa mensagens que chegam no DLQ IBM® i .

A tabela de regras do manipulador de fila de mensagens não entregues define como o manipulador de fila de mensagens não entregues irá processar mensagens que chegam à fila de mensagens não entregues. Há dois tipos de entrada em uma tabela de regras:
  • A primeira entrada na tabela, que é opcional, contém dados de controle.
  • Todas as outras entradas na tabela são regras para o manipulador de fila de mensagens não entregues seguir. Cada regra consiste em um padrão (um conjunto de características da mensagem) em relação ao qual uma mensagem é correspondida e uma ação a ser tomada quando uma mensagem na fila de mensagens não entregues corresponder ao padrão especificado. Deve haver pelo menos uma regra em uma tabela de regras.

Cada entrada na tabela de regras é composta por uma ou mais palavras-chave.

Dados de controle

Essa seção descreve as palavras-chave que é possível incluir em uma entrada de dados de controle em uma tabela de regras do manipulador DLQ. Observe o seguinte :
  • O valor padrão para uma palavra-chave, se houver, é sublinhado.
  • A linha vertical (|) separa alternativas. É possível especificar somente um deles.
  • Todas as palavras-chave são opcionais.
INPUTQ ( QueueName|' ' (padrão) )
O nome da fila de mensagens não entregues que você deseja processar:
  1. Qualquer valor UDLMSGQ (ou *DFT) que você especificar como um parâmetro para o comando STRMQMDLQ substitui qualquer valor INPUTQ na tabela de regras.
  2. Se você especificar um valor UDLMSGQ em branco como um parâmetro para o comando STRMQMDLQ, o valor INPUTQ na tabela de regras é utilizado.
  3. Se você especificar um valor UDLMSGQ em branco como um parâmetro para o comando STRMQMDLQ e um valor INPUTQ em branco na tabela de regras, a fila de mensagens não entregues padrão do sistema será utilizada.
INPUTQM ( QueueManagerName|' ' (padrão) )
O nome do gerenciador de filas que possui a fila de mensagens não entregues nomeada na palavra-chave INPUTQ.

Se você não especificar um gerenciador de filas ou se você especificar INPUTQM(' ') na tabela de regras, o sistema utiliza o gerenciador de filas padrão para a instalação.

RETRYINT ( Intervalo| 60 (padrão))
O intervalo, em segundos, no qual o manipulador da fila de mensagens não entregues deve tentar reprocessar as mensagens na fila de mensagens não entregues que não puderam ser processadas na primeira tentativa e para o qual as tentativas repetidas foram solicitadas. Por padrão, o intervalo de novas tentativas é 60 segundos.
WAIT ( YES (padrão) |NO|nnn )
Se o manipulador de fila de mensagens não entregues deve aguardar a chegada de novas mensagens na fila de mensagens não entregues quando ele detecta que não há mensagens adicionais que possa processar.
SIM
Faz com que o manipulador da fila de mensagens não entregues aguarde indefinidamente.
NÃO
Faz com que o manipulador da fila de mensagens não entregues finalize quando ele detectar que a fila de mensagens não entregues está vazia ou não contém mensagens que ele pode processar.
nnn
Faz com que o manipulador da fila de mensagens não entregues aguarde nnn segundos pela chegada do novo trabalho antes de finalizar após detectar que a fila está vazia ou que não contém mensagens que possa processar.
Especifique WAIT (YES) para DLQs ocupadas e WAIT (NO) ou WAIT (nnn) para DLQs que possuem um baixo nível de atividade. Se o manipulador da fila de mensagens não entregues tem permissão para encerrar, chame-o novamente usando o acionamento.

É possível fornecer o nome da fila de mensagens não entregues como um parâmetro de entrada para o comando STRMQMDLQ, como uma alternativa para incluir dados de controle na tabela de regras. Se algum valor for especificado na tabela de regras e na entrada para o comando STRMQMDLQ, o valor especificado no comando STRMQMDLQ terá precedência.

Nota: Se uma entrada de controle de dados for incluída na tabela de regras, ela deverá ser a primeira entrada na tabela.