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.

  1. API kilépési pont beállítása az IBM MQ Explorer termékben.
  2. Á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.
1. Táblázat API kilépési pont attribútumok
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

Eljárás

  • [1. LEHETŐSÉG] API kilépési pont beállítása az IBM MQ Explorer termékben.
    1. Nyissa meg az érintett tulajdonságok párbeszédablakot:
    2. 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.
    3. Írja be a szükséges információkat az API kilépési pont hozzáadása párbeszédablakban.
    4. 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.
    Az új API kilépési pont tulajdonságai megjelennek a táblázatban a Kilépési pontok oldalon.
  • 2. LEHETŐSÉG] Általános API kilépési pont felülbírálása helyi API kilépési ponttal.

    Ha a sorkezelőn meg van adva egy helyi API kilépési pont, amelynek neve egyezik az általános kilépési pont nevével, akkor az általános kilépési pont felülbírálásra kerül. Vagyis az általános kilépési pont nem kerül meghívásra, helyette a felülbíráló helyi kilépési pont lesz meghívva. A véletlen felülbírálás megelőzése érdekében a felhasználói felület szándékos műveletek végrehajtására kényszeríti egy felülbírálás beállításához; ezért például nem vehet fel egy olyan új kilépési pontot, amelynek neve megegyezik egy meglévő kilépési pont nevével, és nem módosíthatja úgy egy kilépési pont nevét, hogy az egyező legyen egy meglévő kilépési pont nevével. 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:

    1. Nyissa meg a sorkezelő-tulajdonságok párbeszédablakának Kilépési pontok oldalát.
    2. 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.
    3. 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.
    4. Í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.
    A helyi kilépési pont most felülbírálja az azonos nevű általános kilépési pontot.