Opções de Obtenção de Mensagens do MQ
As opções de Obtenção de mensagens do MQ controlam a ação do MQGET.
- Incluídos (não inclua a mesma constante mais de uma vez), ou
- Combinados usando a operação OR bit a bit (se a linguagem de programação suportar operações de bits).
O valor inicial do campo Options
é MQGMO_NO_WAIT mais MQGMO_PROPERTIES_AS_Q_DEF.
Opções de propriedade
- MQGMO_PROPERTIES_AS_Q_DEF
As propriedades da mensagem, exceto aquelas contidas no descritor de mensagens (ou na extensão), devem ser representadas conforme definido pela propriedade da fila PropertyControl. Se um
MsgHandle
for fornecido, essa opção será ignorada e as propriedades da mensagem estarão disponíveis usando oMsgHandle
, a menos que o valor da propriedade de fila PropertyControl sejaMQPROP_FORCE_MQRFH2
.Essa será a ação padrão, se nenhuma opção da propriedade estiver especificada.
- MQGMO_PROPERTIES_IN_HANDLE
As propriedades da mensagem devem ser disponibilizadas usando
MsgHandle
. Se não for fornecido nenhum identificador de mensagem, a chamada falhará com a razão MQRC_HMSG_ERROR.- MQGMO_NO_PROPERTIES
Nenhuma propriedade da mensagem, exceto as propriedades contidas no descritor de mensagens (ou extensão), é recuperada. Se um
MsgHandle
for fornecido, ele será ignorado.- MQGMO_PROPERTIES_FORCE_MQRFH2
As propriedades da mensagem, exceto as propriedades contidas no descritor de mensagens (ou extensão), devem ser representadas usando os cabeçalhos MQRFH2. Isso fornece compatibilidade com versões anteriores para aplicativos que estão esperando recuperar propriedades, mas não podem ser alterados para usar identificadores de mensagens. Se um
MsgHandle
for fornecido, ele será ignorado.- MQGMO_PROPERTIES_COMPATIBILITY
- Se a mensagem contém uma propriedade com um prefixo de "mcd.", "jms.", "usr.", ou "mqext.", todas as propriedades da mensagem são entregues para o aplicativo em um cabeçalho MQRFH2 . Caso contrário, todas as propriedades da mensagem, exceto aquelas contidas no descritor de mensagens (ou extensão), serão descartadas e não serão mais acessíveis ao aplicativo.
Opção Padrão
- MQGMO_NONE
- Use esse valor para indicar que nenhuma outra opção foi especificada. Todas as opções assumem seus valores-padrão. MQGMO_NONE auxilia a documentação do programa; esta opção não tem o objetivo de ser usada com qualquer outra, mas como seu valor é zero, tal uso não pode ser detectado.