Opciones de mensajes Get de MQ

Las opciones de mensajes Get de MQ controlan la acción de MQGET.

Puede especificar una opción, varias o ninguna de las opciones que se describen a continuación en esta sección. Si necesita más de una opción, los valores pueden ser:
  • Añadido (no añadir la misma constante más de una vez), o
  • Combinado utilizando la operación OR bit a bit (si el lenguaje de programación da soporte a operaciones de bits).

El valor inicial del campo Opciones es MQGMO_NO_WAIT además de MQGMO_PROPERTIES_AS_Q_DEF.

Opciones de propiedad

Las opciones siguientes hacen relación a las propiedades del mensaje:
MQGMO_PROPERTIES_AS_Q_DEF

Las propiedades del mensaje, excepto las que se encuentran en el descriptor de mensajes (o extensión) se deben representar según se haya definido en la propiedad de cola PropertyControl. Si se proporciona un valor MsgHandle, se hará caso omiso de esta opción y las propiedades del mensaje estarán disponibles utilizando MsgHandle, a menos que el valor de la propiedad de cola PropertyControl sea MQPROP_FORCE_MQRFH2.

Se trata de la acción predeterminada si no se especifican opciones de propiedad.

MQGMO_PROPERTIES_IN_HANDLE

Las propiedades del mensaje deben estar disponibles utilizando MsgHandle. Si no se proporciona ningún manejador de mensajes, la llamada fallará con la razón MQRC_HMSG_ERROR.

MQGMO_NO_PROPERTIES

No se recuperará ninguna propiedad del mensaje, salvo las que se encuentran en el descriptor de mensajes (o extensión). Si se proporciona MsgHandle, se hará caso omiso del mismo.

MQGMO_PROPERTIES_FORCE_MQRFH2

Las propiedades del mensaje, salvo las que se encuentran en el descriptor de mensajes (o extensión) se deben representar utilizando las cabeceras MQRFH2. Esto proporciona compatibilidad con versiones anteriores para aplicaciones que esperan recuperar propiedades pero que no se pueden cambiar para que utilicen manejadores de mensajes. Si se proporciona MsgHandle, se hará caso omiso del mismo.

MQGMO_PROPERTIES_COMPATIBILITY
Si el mensaje contiene una propiedad con un prefijo de "mcd.", "jms.", "usr." o "mqext.", todas las propiedades de mensajes se entregarán a la aplicación en una cabecera MQRFH2. De lo contrario, todas las propiedades del mensaje, excepto las que se encuentran en el descriptor de mensaje (o extensión), se descartan y dejan de estar accesibles para la aplicación.

Opción predeterminada

Si no es necesaria ninguna de las opciones descritas anteriormente, se puede utilizar la opción siguiente:
MQGMO_NONE
Utilice este valor para indicar que no se han especificado otras opciones; todas las opciones toman sus valores predeterminados. MQGMO_NONE ayuda a la documentación del programa; no se pretende que se utilice esta opción con ninguna otra, pero como su valor es cero, no se puede detectar el uso.