IBM MQ szolgáltatásmeghatározás tulajdonságai
A szolgáltatásmeghatározásokhoz tulajdonságokat és attribútumokat állíthat be, amikor új szolgáltatásmeghatározást hoz létre, vagy amikor egy meglévő szolgáltatásmeghatározást szerkeszt.
Bizonyos attribútumok csak akkor érhetőek el, amikor a szolgáltatásmeghatározás egy adott kötéstípusba vagy üzenetcsere mintába tartozik. Az alábbi hivatkozások segítségével megtekintheti a szolgáltatásmeghatározások egyes tulajdonságlapjain található tulajdonságokat:
- Általános
- Művelet
- Bemeneti cél
- Bemeneti üzenetséma
- Bemeneti üzenetfejléc
- Kimeneti cél
- Kimeneti üzenetséma
- Kimeneti üzenetfejléc
Minden attribútumhoz tartozik egy rövid leírás arról, hogy mikor lehet szüksége az attribútum beállítására.
Általános oldal
Az alábbi táblázat felsorolja mindazokat az attribútumokat, amelyeket beállíthat a Szolgáltatásmeghatározás tulajdonságai párbeszédablak Általános oldalán.
Attribútum | Leírás |
---|---|
Névtér | A szolgáltatáshoz tartozó névteret határozza meg. Már hozzá van rendelve egy ideiglenes alapértelmezett érték. |
Név | Az új szolgáltatásmeghatározás egyedi neve. A szolgáltatásmeghatározás nevében a kis- és nagybetűk nincsenek megkülönböztetve, de a kis- és nagybetűket vegyesen tartalmazó név megmarad. |
Üzenetcsere minta | Az Üzenetcsere minta leírja a szolgáltatás hívása
során küldött és fogadott üzenetek irányát.
Két lehetséges
választás van:
|
Kötési típus | A IBM® MQ szolgáltatásmeghatározás specifikáció verziószámát adja meg. |
Megjegyzés | Megadhat egy megjegyzést, ami feljegyzésre kerül a szolgáltatáshoz a WSDL fájlban. |
Művelet oldal
Az alábbi táblázat felsorolja mindazokat az attribútumokat, amelyeket beállíthat a Szolgáltatásmeghatározás tulajdonságai párbeszédablak Művelet oldalán. Minden egyes szolgáltatásmeghatározáshoz csak egyetlen művelet tartozik.
Attribútum | Leírás |
---|---|
Művelet neve | A művelet nevét adja meg. A tulajdonság értékének megadása kötelező a szolgáltatásmeghatározás létrehozásához. |
Művelet | A szolgáltató használja a szolgáltatási kérések
elindításához. Például: Több szolgáltatás telepítésének engedélyezése egyetlen cél
használatával, lehetővé téve a szolgáltató számára, hogy megfelelően
indítsa a célon érkező kéréseket. Amikor a kötési típus MQ, akkor a Művelet a targetAction. |
Megjegyzés | Megadhat egy megjegyzést, ami feljegyzésre kerül a művelethez a WSDL fájlban. |
Bemeneti cél oldal
Az alábbi táblázat felsorolja mindazokat az attribútumokat, amelyeket beállíthat a Szolgáltatásmeghatározás tulajdonságai párbeszédablak Bemeneti cél oldalán. A bemenet oldalak határozzák meg a szolgáltatás által várt üzenet részleteit, valamint a célt, ahonnan az beolvasásra kerül.
Attribútum | Leírás |
---|---|
Bemeneti cél neve | Annak a cél sornak vagy cél témakörnek a nevét adja meg, amelybe a
kérés elküldésre kerül. Például: Az
IBM MQ IRI queue-dest vagy
topic-dest része, úgymint:
|
Cél sorkezelő neve | A cél sorkezelő nevét adja meg. |
Kapcsolati sorkezelő | Annak a sorkezelőnek a nevét adja meg, amelyhez a kérő szolgáltatás csatlakozik. Ez az MQCONN() és az MQCONNX() hívásokon használt QmgrName paraméternek felel meg. |
Ügyfél csatlakozási tulajdonságai | Az ügyfél csatlakozási tulajdonságai részletes kötéseket határoznak meg, amelyek olyan információkat tartalmaznak, hogy egy szolgáltatáskérő hogyan kötődik egy adott géphez vagy csatornához. Bizonyos esetekben hasznos az ügyfélkötések és a csatornanevek megadásának képessége, ugyanakkor a szolgáltatás túlzott meghatározása korlátozó lehet. Ezen probléma a szolgáltatásmeghatározásba befoglalt összerendelési információk mennyiségének minimálisra csökkentésével orvosolható, illetve amikor csak lehetséges, az alapul szolgáló infrastruktúra vagy IBM MQ üzenettovábbításának engedélyezésével. |
Csatornatábla neve | Az ügyfél csatornatábla fájljának nevét adja meg,
ami a csatorna kapcsolat azonosításához kell.
|
Csatornatábla könyvtára | Az ügyfél csatornatábla elérési útját adja meg.
|
Ügyfélcsatorna kapcsolat neve | Megadja a használandó kapcsolat karaktersorozatot, amikor
egy szolgáltatáskérő IBM MQ MQI
ügyfélkötés kapcsolatot alakít ki. TCP/IP esetén a kapcsolat formátuma egy hosztnév, amelyet egy
portszám követ, például:
Ha a
portszám nincs megadva, akkor az 1414-es alapérték kerül felhasználásra.
|
Ügyfélcsatorna neve | Megadja a használandó csatornát, amikor egy
IBM MQ szolgáltatáskérő
IBM MQ MQI ügyfélkötés kapcsolatot
létesít.
|
Ügyfélcsatorna szállítási típusa | Azt a szállítástípust adja meg, amelyet akkor kell
használni, amikor IBM MQ
szolgáltatáskérő IBM MQ MQI
ügyfél-összerendelés kapcsolatot alakít ki.
|
Bemeneti üzenetséma oldal
Az alábbi táblázat felsorolja mindazokat az attribútumokat, amelyeket beállíthat a Szolgáltatásmeghatározás tulajdonságai párbeszédablak Bemeneti üzenetséma oldalán. Ezekkel lehet meghatározni az üzenet hasznos tartalomra vonatkozó sémát.
Attribútum | Leírás |
---|---|
Bejövő adatok típusa | A várt bejövő adattípust adja meg. Egyszerű típusok esetén ez a
beépített XML xsd típusokkal modellezhető, például xsd:string
vagy xsd:int .
Összetettebb típusok esetén az adattípus külső fájlból importálható a
Sémafájl importálása és Névtér
importálása megadásával. |
Importált sémafájl | Az importálandó sémafájlt adja meg. |
Importált névtér | Az importálandó névteret adja meg. |
Bemeneti üzenetfejléc oldal
Az alábbi táblázat felsorolja mindazokat az attribútumokat, amelyeket beállíthat a Szolgáltatásmeghatározás tulajdonságai párbeszédablak Bemeneti üzenetfejléc oldalán. A bemenet oldalak határozzák meg a szolgáltatás által várt üzenet részleteit, valamint a célt, ahonnan az beolvasásra kerül. A tulajdonságok egy része csak az MQ kötési típusba tartozó szolgáltatásmeghatározásokra vonatkozik.
Attribútum | Leírás |
---|---|
CCSID | Azt a kódolt karakterkészlet azonosítót adja meg, ami megfelel a CodedCharSetId mezőnek az MQMD adatszerkezetben. Ha ez az érték nincs megadva, akkor a szolgáltatáskérő és a szolgáltató azt az értéket használja, ami megfelel az üzenet adatok karakterkészletének. |
Formátum | Az üzenet adatok formátumnevét adja meg. Ez a
tulajdonság az MQRFH2 formátum mezőnek felel meg,
illetve az MQMD formátum mezőnek, ha nincs jelen
MQRFH2. Az érték egy 0 és 8 karakter közötti
hosszúságú, A-Z és 0-9 karakterekből álló karaktersorozat. A Formátum tetszőleges értékre beállítható a következő helyen található útmutatások szerint: Formátum mező. |
Felhasználói tulajdonságok | A IBM MQ szolgáltatás üzenetekben átvitt,
felhasználó által meghatározott adatokat adja meg. Az értékeket az RFH2
mappa elemekhez megengedett formátumban kell megadni; három elemből álló
készletekként, XML-hez hasonló szintaxis szerint kódolva. Például:
A dt="datatype " elem nem kötelező, ha kihagyja, akkor
karaktersorozatnak tekinti a rendszer. Így az alábbiak szerint adhat meg
elemeket:
Például:
A megengedett adattípusokkal és a formátummal
kapcsolatos további információkért tekintse meg az
IBM Knowledge Center
NameValueData ( MQCHARn ) témakörét.
Biztonságra
érzékeny tulajdonságokat, például felhasználói azonosítót vagy jelszót
nem javasolt befoglalni. |
Üzenettípus | A küldött üzenet típusát adja meg.
Ez tulajdonság a MsgType tulajdonságnak felel meg az MQMD szerkezetben.
Az öt lehetséges érték:
|
Megőrzés | Megadja, hogy az üzenet megőrzött-e vagy sem. A
Megőrzés mezőnek felel meg az MQMD
adatszerkezetben. A három lehetséges érték:
|
Üzenetazonosító | Az üzenetazonosítót adja meg. Ez az
MsgId mezőnek felel meg az MQMD adatszerkezetben. Az üzenetazonosító segítségével lehetőség van bizonyos specializált IBM MQ alkalmazások leírására szolgáltatásként (például: olyan alkalmazások, amelyek egy bemeneti soron osztoznak, és egy előre meghatározott msgId érték alapján választják ki a nekik szánt üzeneteket). A szolgáltatásmeghatározásokban előre meghatározott msgId értékek problémákat okozhatnak, például amikor egy kérés-válasz Üzenetcsere minta adja vissza a kérés msgId értékét. Az üzenetazonosító lehet karaktersorozat vagy bináris érték. A bináris értékek legfeljebb 24, kétkarakteres hexadecimális értékből álló karaktersorozatok lehetnek.Kattintson a Szerkesztés gombra egy párbeszédablak megnyitásához, ahol beírhatja az értéket szövegként vagy byte sorozatként. |
Korrelációazonosító | A korrelációazonosítót adja meg. Ez a CorrelId
mezőnek felel meg az MQMD adatszerkezetben. A korrelációazonosító lehet karaktersorozat vagy bináris érték. A bináris
értékek legfeljebb 24, kétkarakteres hexadecimális értékből álló
karaktersorozatok lehetnek. Kattintson a Szerkesztés gombra egy párbeszédablak megnyitásához, ahol beírhatja az értéket szövegként vagy byte sorozatként. |
Lejárat | Az üzenet élettartamát adja meg. Előjeles egész
szám, tizedmásodpercben mérve. A Lejárat tartomány 1 és 2
147 483 647 között van. A Korlátlan speciális érték azt jelzi, hogy az üzenet nem jár le. Ekkor a -1 érték kerül kiírásra a WSDL fájlba. A Nincs megadva azt jelenti, hogy nem kerül kiírásra érték a WSDL fájlba. Ez az alapértelmezett érték. |
Prioritás | Az üzenethez tartozó prioritást adja meg. A
priority mezőnek felel meg az MQMD
adatszerkezetben.
Egy 0 és 9 közötti egész számként kell megadni, ahol a 0 a legalacsonyabb,
a 9 pedig a legmagasabb prioritás. A Korlátlan speciális érték azt jelzi, hogy az üzenetprioritás értéket annak az első sornak a meghatározásából veszi a rendszer, amelybe az üzenet kerül. Ekkor a -1 érték kerül kiírásra a WSDL fájlba. A Nincs megadva azt jelenti, hogy nem kerül kiírásra érték a WSDL fájlba. Ez az alapértelmezett érték. |
Kódolás | Az üzenetadatok numerikus kódolását adja meg. Az
Encoding mezőnek felel meg az MQMD adatszerkezetben.
|
Jelentési beállítások | Azt adja meg, hogy a szolgáltató hogyan állítja be
az üzenet- és korrelációazonosítót a válasz- vagy hibaüzenetben.
Ez a
tulajdonság a Report mezőnek felel meg az MQMD
adatszerkezetben.
Négy lehetséges érték van:
|
Kimeneti cél oldal
Az alábbi táblázat felsorolja mindazokat az attribútumokat, amelyeket beállíthat a Szolgáltatásmeghatározás tulajdonságai párbeszédablak Kimeneti cél oldalán. A kimenet oldalak határozzák meg a szolgáltatás által a bemeneti üzenetre válaszként küldött üzenet részleteit, valamint a célt, ahová az elhelyezésre kerül. A kimeneti cél előtagja sorok esetén 'msg/queue/', témakörök esetén 'msg/topic/'.
Attribútum | Leírás |
---|---|
Kimeneti cél neve | Annak a cél sornak vagy cél témakörnek a nevét adja meg, amelybe a
válaszüzenet elküldésre kerül. A ReplyToQ és a ReplyToQMgr mezőnek felel
meg az MQMD adatszerkezetben. A cél neve IBM MQ URI queue-dest vagy
topic-dest részlet formátumú lehet, például:
|
Cél sorkezelő neve | A cél sorkezelő nevét adja meg. |
Kapcsolati sorkezelő | Annak a sorkezelőnek a nevét adja meg, amelyhez a kérő szolgáltatás csatlakozik. Ez az MQCONN() és az MQCONNX() hívásokon használt QmgrName paraméternek felel meg. |
Ügyfél csatlakozási tulajdonságai | Az ügyfél csatlakozási tulajdonságai részletes kötéseket határoznak meg, amelyek olyan információkat tartalmaznak, hogy egy szolgáltatáskérő hogyan kötődik egy adott géphez vagy csatornához. Bizonyos esetekben hasznos az ügyfélkötések és a csatornanevek megadásának képessége, ugyanakkor a szolgáltatás túlzott meghatározása korlátozó lehet. Ezen probléma a szolgáltatásmeghatározásba befoglalt összerendelési információk mennyiségének minimálisra csökkentésével orvosolható, illetve amikor csak lehetséges, az alapul szolgáló infrastruktúra vagy IBM MQ üzenettovábbításának engedélyezésével. |
Csatornatábla neve | Az ügyfél csatornatábla fájljának nevét adja meg,
ami a csatorna kapcsolat azonosításához kell.
|
Csatornatábla könyvtára | Az ügyfél csatornatábla elérési útját adja meg.
|
Ügyfélcsatorna neve | Megadja a használandó kapcsolat karaktersorozatot, amikor
egy szolgáltatáskérő IBM MQ MQI
ügyfélkötés kapcsolatot alakít ki. TCP/IP esetén a kapcsolat formátuma egy hosztnév, amelyet egy
portszám követ, például:
Ha a
portszám nincs megadva, akkor az 1414-es alapérték kerül felhasználásra.
|
Ügyfélcsatorna kapcsolat neve | Megadja a használandó csatornát, amikor egy
IBM MQ szolgáltatáskérő
IBM MQ MQI ügyfélkötés kapcsolatot
létesít.
|
Ügyfélcsatorna szállítási típusa | Azt a szállítástípust adja meg, amelyet akkor kell
használni, amikor IBM MQ
szolgáltatáskérő IBM MQ MQI
ügyfél-összerendelés kapcsolatot alakít ki.
|
Kimeneti üzenetséma oldal
Az alábbi táblázat felsorolja mindazokat az attribútumokat, amelyeket beállíthat a Szolgáltatásmeghatározás tulajdonságai párbeszédablak Kimeneti üzenetséma oldalán. Ezekkel lehet meghatározni az üzenet hasznos tartalomra vonatkozó sémát.
Attribútum | Leírás |
---|---|
Kimenő adatok típusa | A várt kimenő adattípust adja meg |
Importált sémafájl | Az importálandó sémafájlt adja meg. |
Importált névtér | Az importálandó névteret adja meg. |
Kimeneti üzenetfejléc oldal
Az alábbi táblázat felsorolja mindazokat az attribútumokat, amelyeket beállíthat a Szolgáltatásmeghatározás tulajdonságai párbeszédablak Kimeneti üzenetfejléc oldalán. A kimenet oldalak határozzák meg a szolgáltatás által a bemeneti üzenetre válaszként küldött üzenet részleteit, valamint a célt, ahová az elhelyezésre kerül. A tulajdonságok egy része csak az MQ kötési típusba tartozó szolgáltatásmeghatározásokra vonatkozik.
Attribútum | Leírás |
---|---|
CCSID | Azt a kódolt karakterkészlet azonosítót adja meg, ami megfelel a CodedCharSetId mezőnek az MQMD adatszerkezetben. Ha ez az érték nincs megadva, akkor a szolgáltatáskérő és a szolgáltató azt az értéket használja, ami megfelel az üzenet adatok karakterkészletének. |
Formátum | Az üzenet adatok formátumnevét adja meg. Ez a
tulajdonság az MQRFH2 formátum mezőnek felel meg,
illetve az MQMD formátum mezőnek, ha nincs jelen
MQRFH2. Az érték egy 0 és 8 karakter közötti
hosszúságú, A-Z és 0-9 karakterekből álló karaktersorozat. A Formátum tetszőleges értékre beállítható a következő helyen található útmutatások szerint: Formátum mező. |
Felhasználói tulajdonságok | A IBM MQ szolgáltatás üzenetekben átvitt,
felhasználó által meghatározott adatokat adja meg. Az értékeket az RFH2
mappa elemekhez megengedett formátumban kell megadni; három elemből álló
készletekként, XML-hez hasonló szintaxis szerint kódolva. Például:
A dt="datatype " elem nem kötelező, ha kihagyja, akkor
karaktersorozatnak tekinti a rendszer. Így az alábbiak szerint adhat meg
elemeket:
Például:
A megengedett adattípusokkal és a formátummal
kapcsolatos további információkért tekintse meg az
IBM Knowledge Center
NameValueData ( MQCHARn ) témakörét.
Biztonságra
érzékeny tulajdonságokat, például felhasználói azonosítót vagy jelszót
nem javasolt befoglalni. |
Üzenettípus | A küldött üzenet típusát adja meg.
Ez tulajdonság a MsgType tulajdonságnak felel meg az MQMD szerkezetben.
Az öt lehetséges érték:
|
Megőrzés | Megadja, hogy az üzenet megőrzött-e vagy sem. A
Megőrzés mezőnek felel meg az MQMD
adatszerkezetben. A három lehetséges érték:
|
Üzenetazonosító | Az üzenetazonosítót adja meg. Ez az
MsgId mezőnek felel meg az MQMD adatszerkezetben. Az üzenetazonosító segítségével lehetőség van bizonyos specializált IBM MQ alkalmazások leírására szolgáltatásként (például: olyan alkalmazások, amelyek egy bemeneti soron osztoznak, és egy előre meghatározott msgId érték alapján választják ki a nekik szánt üzeneteket). A szolgáltatásmeghatározásokban előre meghatározott msgId értékek problémákat okozhatnak, például amikor egy kérés-válasz Üzenetcsere minta adja vissza a kérés msgId értékét. Az üzenetazonosító lehet karaktersorozat vagy bináris érték. A bináris értékek legfeljebb 24, kétkarakteres hexadecimális értékből álló karaktersorozatok lehetnek.Kattintson a Szerkesztés gombra egy párbeszédablak megnyitásához, ahol beírhatja az értéket szövegként vagy byte sorozatként. |
Korrelációazonosító | A korrelációazonosítót adja meg. Ez a CorrelId
mezőnek felel meg az MQMD adatszerkezetben. A korrelációazonosító lehet karaktersorozat vagy bináris érték. A bináris
értékek legfeljebb 24, kétkarakteres hexadecimális értékből álló
karaktersorozatok lehetnek. Kattintson a Szerkesztés gombra egy párbeszédablak megnyitásához, ahol beírhatja az értéket szövegként vagy byte sorozatként. |
Lejárat | Az üzenet élettartamát adja meg. Előjeles egész
szám, tizedmásodpercben mérve. A Lejárat tartomány 1 és 2
147 483 647 között van. A Korlátlan speciális érték azt jelzi, hogy az üzenet nem jár le. Ekkor a -1 érték kerül kiírásra a WSDL fájlba. A Nincs megadva azt jelenti, hogy nem kerül kiírásra érték a WSDL fájlba. Ez az alapértelmezett érték. |
Prioritás | Az üzenethez tartozó prioritást adja meg. A Priority
mezőnek felel meg az MQMD adatszerkezetben.
Egy 0 és 9 közötti egész számként kell megadni, ahol a 0 a legalacsonyabb,
a 9 pedig a legmagasabb prioritás. A Korlátlan speciális érték azt jelzi, hogy az üzenetprioritás értéket annak az első sornak a meghatározásából veszi a rendszer, amelybe az üzenet kerül. Ekkor a -1 érték kerül kiírásra a WSDL fájlba. A Nincs megadva azt jelenti, hogy nem kerül kiírásra érték a WSDL fájlba. Ez az alapértelmezett érték. |
Kódolás | Az üzenetadatok numerikus kódolását adja meg. Az
Encoding mezőnek felel meg az MQMD adatszerkezetben.
|
Jelentési beállítások | Azt adja meg, hogy a szolgáltató hogyan állítja be
az üzenet- és korrelációazonosítót a válasz- vagy hibaüzenetben.
Ez a
tulajdonság a Report mezőnek felel meg az MQMD
adatszerkezetben.
Négy lehetséges érték van:
|