API kilépési pontok beállítása
Az API kilépési pont egy kódmodul (egy .dll fájl), amelyet saját maga biztosít, és amely közvetlenül az MQI hívások előtt vagy után fut.
Erről a feladatról
Amikor az IBM® MQ hívást kap egy programtól az egyik API belépési pontjához, akkor az IBM MQ meghívja az API kilépési pontot. Az API kilépési pont az MQI futása előtt vagy után fut, attól függően, hogy miként állította be a kilépési pontot.
Beállíthat nulla, egy vagy több meghívandó kilépési pontot, és beállíthatja a sorrendet, amelyben a kilépési pontok meghívásra kerülnek. Windows és Linux (x86-os vagy x86-64-es) platformok esetén az API kilépési pontok beállításához használja a IBM MQ Explorer alkalmazást. A konfiguráció részletei .ini fájlokban vannak tárolva.
Három fajta API kilépési pont meghatározás létezik:
- Általános (ApiExitCommon)
- Egy meghatározás készlet számítógépenként. A sorkezelő elindulásakor a megadott API kilépési pontok (ha vannak) beolvasásra kerülnek, és alkalmazásra a sorkezelőn. Az általános API kilépési pontokat a IBM MQ tulajdonságok párbeszédablakban lehet beállítani. Az általános kilépési pontok a Helyi API kilépési pontok táblázatban vannak megjelenítve minden helyi sorkezelő tulajdonságok párbeszédablakában.
- Sablon (ApiExitTemplate)
- Egy meghatározás készlet számítógépenként. Egy sorkezelő létrehozásakor az itt megadott API kilépési pontok (ha vannak) bemásolásra kerülnek az újonnan létrehozott sorkezelőbe helyi kilépési pontként. A sablon API kilépési pontok a IBM MQ tulajdonságok párbeszédablakban állíthatók be.
- Helyi (ApiExitLocal)
- Egy meghatározás készlet sorkezelőnként. A sorkezelő elindulásakor a megadott API kilépési pontok felülbírálják az általános kilépési pontokat, ha a Név jellemzőjük egyezik, és a felülbírálás meg lett adva. Ha egy általános API kilépési pont felülbírálásra kerül, akkor az általános meghatározás egyetlen mezője sem lesz mentve, még ha a választható Adatok jellemzőnek van hozzárendelt értéke. A helyi API kilépési pontokat a sorkezelő tulajdonságok párbeszédablakában lehet beállítani.
API kilépési pont beállítása IBM MQ Explorer alkalmazásban
Erről a feladatról
Eljárás
- Nyissa meg az érintett tulajdonságok párbeszédablakot:
- A Kilépési pontok oldalon kattintson a Hozzáadás... elemre. Az API kilépési pont hozzáadása párbeszédablak megjelenik.
- Írja be a szükséges információkat az API kilépési pont hozzáadása párbeszédablakban.
- Kattintson az OK gombra a kilépési pont létrehozásához és zárja be az API kilépési pont létrehozása párbeszédablakot.
Eredmények
Közöz API kilépési pont felülbírálása helyi API kilépési ponttal
Erről a feladatról
Azonban előfordulhat, hogy szeretne hozzáadni egy helyi API kilépési pontot a sorkezelőhöz azért, hogy az általános API kilépési pont helyett a helyi API kilépési pont kerüljön felhasználásra. Ebben az esetben felül kell bírálnia az általános API kilépési pontot a helyi API kilépési ponttal:
Általános API kilépési pont felülbírálásához egy helyi API kilépési ponttal:Eljárás
- Nyissa meg a sorkezelő tulajdonságok párbeszédablakának Kilépési pontok oldalát.
- Kattintson a közös kilépési pontra, amit felül szeretne bírálni a Helyi API kilépési pontok táblában.
- Kattintson a Felülbírálás lehetőségre. Az API kilépési pont szerkesztése párbeszédablak megjelenik azzal a névvel, amivel a közös API kilépési pont megjelent.
- Írja be a helyi API kilépési pont részleteit az API kilépési pont szerkesztése párbeszédablakban, majd kattintson az OK gombra a változtatások elmentéséhez.
Eredmények
API kilépési pont attribútumok
Erről a feladatról
Attribútum | Jelentés | Szakasz kulcs |
---|---|---|
Név | Az API kilépési pont leíró nevét adja meg, amely átadásra kerül a API kilépési ponthoz az MQAXP struktúra ExitInfoName mezőjében. Ennek a névnek egyedinek kell lennie, legfeljebb 48 karakter hosszúságú lehet, és csak olyan karaktereket tartalmazhat, amelyek érvényesek a IBM MQ objektumok (például sorok) nevében. | Név |
Típus | A kilépési pont típusát adja meg: általános, sablon, helyi, vagy felülbíráló. | (Nem egy önálló szakaszkulcs.) |
Sorrend | Ez az attribútum egy előjel nélküli számérték, amely meghatározza a sorrendet, amelyben ez az API kilépési pont meghívásra kerül a többi API kilépési ponttal összehasonlítva. Az alacsony sorrend számú API kilépési pont a magasabb sorrend számú API kilépési pontok előtt kerül meghívásra. A sorrend, amelyben az egyező sorrend számú API kilépési pontok meghívásra kerülnek, nem definiált. Teljesen elfogadott, hogy a sorkezelő számára meghatározott API kilépési programok sorozatszámaiban kihagyások legyenek. | Sorrend |
Modul | Az API kilépési pont kódját tartalmazó modult határozza meg. Ha a mező a modul teljes elérési útját tartalmazza, akkor az így kerül felhasználásra. Ha a mező csak a modulnevet tartalmazza, akkor a modul megkeresésre kerül ugyanazzal a módszerrel, mint a csatorna kilépési pontok; vagyis a Sorkezelő tulajdonságok párbeszédablak Kilépési pontok oldalán található Kilépési Pont elérési útja mezőben lévő érték felhasználásával. | Modul |
Funkció | A funkció belépési pont nevét határozza meg a modulba, amely az API kilépési pont kódját tartalmazza. Ez a belépési pont az MQ_INIT_EXIT funkció. A mező hossza az MQ_EXIT_NAME_LENGTH értékére korlátozott. | Funkció |
Adatok | Ha megadja ezt az attribútumot, akkor az elülső és hátsó üres karakterek eltávolításra kerülnek, az így megmaradt karaktersorozat 32 karakterre lesz csonkítva, és az eredmény átadásra kerül a kilépési pontnak az MQAXP struktúra ExitData mezőjében. Ha az attribútum nincs megadva, akkor az alapértelmezett 32 üres karakter kerül átadásra a kilépési pontnak az MQAXP struktúra ExitData mezőjében. | Adatok |