MQ Get üzenet beállításai

Az MQ Get üzenet beállításai vezérlik az MQGET műveletét.

A fejezetben később leírt beállítások közül tetszőleges számú beállítást adhat hozzá. Ha több beállításra van szükség, akkor az értékek a következők lehetnek:
  • Hozzáadva (ne adja hozzá többször ugyanazt a konstanst), vagy
  • Bitenkénti OR művelettel kombinálva (ha a programozási nyelv támogatja a bitműveleteket).

A Beállítások mező kezdőértéke MQGMO_NO_WAIT plusz MQGMO_PROPERTIES_AS_Q_DEF.

Tulajdonságbeállítások

Az alábbi beállítások vonatkoznak az üzenet tulajdonságaira:
MQGMO_PROPERTIES_AS_Q_DEF

Az üzenet tulajdonságait a PropertyControl sor tulajdonság által meghatározott módon kell ábrázolni, kivéve az üzenetleíróban (vagy kiterjesztésben) szereplő tulajdonságokat. MsgHandle megadása esetén ez a beállítás figyelmen kívül marad, és az üzenet tulajdonságai a MsgHandle tulajdonság használatával érhetők el, kivéve, ha a PropertyControl sor tulajdonság értéke MQPROP_FORCE_MQRFH2.

Ez az alapértelmezett művelet, ha nincsenek megadva tulajdonságbeállítások.

MQGMO_PROPERTIES_IN_HANDLE

Az üzenet tulajdonságait a MsgHandle tulajdonsággal kell elérhetővé tenni. Ha nincs megadva üzenetazonosító, akkor a hívás MQRC_HMSG_ERROR okkal meghiúsul.

MQGMO_NO_PROPERTIES

Semmilyen üzenettulajdonság nem kerül lekérésre, kivéve az üzenetleíróban (vagy kiterjesztésben) találhatók tulajdonságokat. MsgHandle megadása esetén az figyelmen kívül marad.

MQGMO_PROPERTIES_FORCE_MQRFH2

Az üzenet tulajdonságait MQRFH2 fejlécekkel kell ábrázolni, kivéve az üzenetleíróban (vagy kiterjesztésben) szereplő tulajdonságokat. Ez kompatibilitást biztosít a korábbi verziószámú alkalmazásokhoz, amelyek tulajdonságok lekérését várják, de nem módosíthatók úgy, hogy üzenetazonosítókat használjanak. MsgHandle megadása esetén az figyelmen kívül marad.

MQGMO_PROPERTIES_COMPATIBILITY
Ha az üzenet tartalmaz egy "mcd.", "jms.", "usr." vagy "mqext." előtaggal rendlekező tulajdonságot, akkor az összes üzenet tulajdonság egy MQRFH2 fejlécben lesz kézbesítve az alkalmazásnak. Más esetben az üzenet összes tulajdonsága, kivéve az üzenetleíróban (vagy kiterjesztésben) tartalmazott tulajdonságokat, eldobásra kerül, és többé nem lesz elérhető az alkalmazás számára.

Alapértelmezett beállítás

Ha a korábban ismertetett egyik beállítás sem szükséges, akkor az alábbi beállítás használható:
MQGMO_NONE
Ezzel az értékkel jelezheti, hogy nincs megadva semmilyen más beállítás; az összes beállítás alapértelmezett értékét kell venni. Az MQGMO_NONE a program dokumentálását segíti; nem arra tervezték, hogy bármilyen más beállítással együtt használja, de mivel értéke nulla, az ilyen használat nem állapítható meg.