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.
- API kilépési pont beállítása az IBM MQ Explorer termékben.
- Általános API kilépési pont felülbírálása helyi API kilépési ponttal.
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.
Amikor API kilépési pontokat állít be a
IBM MQ és sorkezelő tulajdonságok
párbeszédablakokban, a megadott jellemző értékek hozzáadásra kerülnek az
ApiExitCommon, ApiExitTemplate és
ApiExitLocal szakaszokhoz a konfigurációs fájlokban vagy a
Windows rendszerleíró adatbázisban.
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 |