Opciones de mensajes Get de MQ
Las opciones de mensajes Get de MQ controlan la acción de MQGET.
- 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
- 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 utilizandoMsgHandle
, a menos que el valor de la propiedad de cola PropertyControl seaMQPROP_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
- 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.