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 Opções
é 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 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
- 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.