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.

É possível especificar nenhuma, uma ou mais das opções descritas posteriormente nessa seção. Se precisar de mais de uma opção, os valores poderão ser:
  • 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 Opções é MQGMO_NO_WAIT mais MQGMO_PROPERTIES_AS_Q_DEF.

Opções de propriedade

As opções a seguir são relacionadas às propriedades da mensagem:
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 o MsgHandle, a menos que o valor da propriedade de fila PropertyControl seja MQPROP_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 contiver uma propriedade com um prefixo "mcd.", "jms.", "usr." ou "mqext.", todas as propriedades de mensagens serão fornecidas ao 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

Se nenhuma das opções descritas anteriormente for necessária, a opção a seguir poderá ser usada:
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.