Ha a Java alkalmazás az IMS rendszerrel működik együtt, akkor biztosítania kell egy beállított IMSInteractionSpec objektumot. Az IMSInteractionSpec objektum tulajdonságainak értékei írják le az együttműködést az IMS rendszerrel. Az IMSInteractionSpec tulajdonságainak értékeit a Common Client Interface (CCI) felületet használó alkalmazás set metódusai közvetlenül biztosíthatják, vagy az értékek átadhatók egy integrált fejlesztői környezet (IDE) varázslójának, ami az alkalmazás számára kódot állít elő. Néhány tulajdonság csak bemeneti, némelyikük bemeneti és kimeneti és néhányuk csak kimeneti tulajdonság. A csak kimeneti tulajdonságokat az (alkalmazásösszetevőnek is nevezett) Java alkalmazás kérdezi le az interakcióval kapcsolatos további információk megállapítása érdekében.
Az alábbi lista leírja az IMSInteractionSpec objektum összes tulajdonságát:
Érték | Megnevezett konstans az IMSInteractionSpecProperties objektumban | Leírás |
---|---|---|
1 | IMS_REQUEST_TYPE_IMS_TRANSACTION |
A kérés egy IMS
tranzakció. Az IMS
által visszaküldött normális tranzakció kimenet használt az alkalmazás
kimeneti üzenetének a feltöltésére. Ha az IMS
egy "DFS"
üzenetet ad vissza, akkor az IMS
erőforrás-illesztő dob egy IMSDFSMessageException kivételt, amely
tartalmazza az "DFS"
üzenetet. Ez az imsRequestType érték használt azokhoz az alkalmazásokhoz, amelyek nem WebSphere Studio MFS támogatással kerültek előállításra. |
2 | IMS_REQUEST_TYPE_IMS_COMMAND | A kérés egy IMS
parancs. Az IMS
által visszaadott parancskimenet, beleértve a "DFS"
üzeneteket is, használt az alkalmazás kimeneti üzenetének a feltöltésére. A
rendszer nem dob IMSDFSMessageException kivételt. Ez az imsRequestType érték használt az IMS parancsokat küldő alkalmazásokhoz. |
3 | IMS_REQUEST_TYPE_MFS_TRANSACTION |
Ez az imsRequestType érték használt azokhoz az alkalmazásokhoz, amelyek WebSphere
Studio MFS támogatással kerültek előállításra. Az IMS által visszaadott parancskimenet, a "DFS" üzenetekkel együtt, használt az alkalmazás kimeneti üzenetének a feltöltésére. A rendszer nem dob IMSDFSMessageException kivételt. |
Érték | Megnevezett konstans az IMSInteractionSpecProperties objektumban | Leírás |
---|---|---|
0 | SYNC_SEND | Az IMS TM erőforrás-illesztő elküldi az ügyfélkérést az IMS felé az IMS Connect programon keresztül és nem várja az IMS válaszát. SYNC_SEND interakció esetén az ügyfélnek nincs szüksége szinkron módon válasz fogadására az IMS rendszertől. A SYNC_SEND érték mind a megosztható, mind a dedikált állandó socket kapcsolatokon támogatott; csak commitMode 0 interakciókkal engedélyezett. Ha az interactionVerb beállítása SYNC_SEND, akkor a végrehajtási időkorlát és socket időkorlát értékek figyelmen kívül maradnak. Megjegyzés: A 2-es típusú imsRequest nem engedélyezett a SYNC_SEND beállítással; ez az eset kivételt okoz. |
1 | SYNC_SEND_RECEIVE | Egy IMS interakció végrehajtása kérést küld az IMS felé és szinkron módon választ fogad. Jellemző SYNC_SEND_RECEIVE interakció az olyan nem párbeszédes IMS tranzakció, amelyben bemeneti rekord (az IMS tranzakció bemeneti üzenet) kerül elküldésre az IMS felé és kimeneti rekordot (az IMS tranzakció kimeneti üzenetet) küld vissza az IMS. A SYNC_SEND_RECEIVE interakciók párbeszédes IMS tranzakciók iterációjához is használtak. A párbeszédes tranzakciók commitMode 1 végrehajtási módot igényelnek. A nem párbeszédes tranzakciók futhatnak commitMode 1 vagy commitMode 0 beállítással is. Dedikált állandó socket-en a commitMode 0 használatakor értéket kell adni az IMSConnectionSpec objektum clientID tulajdonsága számára. Megosztható állandó socket-en a commitMode 0 használata esetén nem szabad értéket adni az IMSConnectionSpec objektum clientID tulajdonsága számára. |
3 | SYNC_END_CONVERSATION | Ha az alkalmazás végrehajt egy interakciót az interactionVerb
SYNC_END_CONVERSATION beállításával, akkor az IMS
TM erőforrás-illesztő üzenetet küld egy IMS
párbeszédes tranzakció kényszerített befejezésére. A IMSInteractionSpec objektum commitMode tulajdonsága és az IMSConnectionSpec objektum clientID tulajdonsága nem érvényes, ha az interactionVerb beállítása SYNC_END_CONVERSATION. |
4 | SYNC_RECEIVE_ASYNCOUTPUT | Az interactionVerb SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT
beállítása mind megosztható állandó, mind dedikált állandó socket
kapcsolatokon érvényes. A SYNC_RECEIVE_ASYNCOUTPUT érték nem kézbesített
aszinkron kimenet lekéréséhez használt. Ha a SYNC_RECEIVE_ASYNCOUTPUT
beállítás dedikált állandó socket-en használt, akkor értéket kell adni az
IMSConnectionSpec objektum clientID tulajdonságának. A SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT interakciónak megosztható állandó socket kapcsolaton ugyanabban az alkalmazásban kell lennie, mint az eredeti SYNC_SEND vagy SYNC_SEND_RECEIVE interakciónak, és ugyanazt a megosztható állandó kapcsolatot kell használnia. Ez elsősorban végrehajtási időtúllépést követően történik. Az ilyen típusú interakció esetén a Java ügyfél csak egyetlen üzenetet fogadhat. Ha a kérés kiadásakor nincs üzenet a clientID azonosítóhoz tartozó IMS OTMA aszinkron várakozási sorban, akkor nem valósul meg további kísérlet az üzenet lekérésére. Nem kerül visszaküldésre üzenet és időtúllépés történik a SYNC_RECEIVE_ASYNCOUTPUT interakció executionTimeout tulajdonságában megadott időtartam letelte után. |
5 | SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT |
A SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT interactionVerb beállítás érvényes mind megosztható, mind dedikált állandó socket kapcsolatokon. Aszinkron kimenet lekérésére használt.A
SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT interakciónak megosztható állandó socket kapcsolaton ugyanabban az alkalmazásban kell lennie, mint az eredeti SYNC_SEND vagy SYNC_SEND_RECEIVE interakciónak, és ugyanazt a megosztható állandó kapcsolatot kell használnia. Ez elsősorban végrehajtási időtúllépést követően történik.Az ilyen típusú interakció esetén a
Java
ügyfél csak egyetlen üzenetet fogadhat. Ha a kérés kiadásakor nincs üzenet
a clientID azonosítóhoz tartozó IMS
OTMA aszinkron várakozási sorban, akkor nem valósul meg további kísérlet
az üzenet lekérésére. Nem kerül visszaküldésre üzenet és időtúllépés
történik a
SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT interakció executionTimeout tulajdonságában megadott időtartam letelte után.Megjegyzés:
A SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT és a
SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT interactionVerb parancsszavak ugyanazt a funkciót valósítják meg. Javasolt mégis aSYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT használata. |
6 | SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT |
A SYNC_RECEIVE_ASYNCOUTPUT_ A
SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT interakciónak megosztható állandó socket kapcsolaton ugyanabban az alkalmazásban kell lennie, mint az eredeti SYNC_SEND vagy SYNC_SEND_RECEIVE interakciónak, és ugyanazt a megosztható állandó kapcsolatot kell használnia. Ez elsősorban végrehajtási időtúllépést követően történik.Az ilyen típusú interakció esetén a Java
ügyfél csak egyetlen üzenetet fogadhat. Ha a kérés kiadásakor nincs üzenet
a clientID azonosítóhoz tartozó IMS
OTMA aszinkron várakozási sorban, akkor az IMS
Connect várakozik, hogy az OTMA üzenetet küldjön vissza. Az IMS
Connect várakozik a
SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_WAIT interakció executionTimeout tulajdonságában megadott időtartamig, mielőtt kivételt adna vissza. |
A J2EE Connection Architecture (JCA) SYNC_RECEIVE (2) értéke jelenleg nem támogatott.
Ha az ügyfélalkalmazás LTERM felülbíráló nevet akar biztosítani, akkor ez a tulajdonság használható. Ez a név az IMS alkalmazás I/O PCB blokkjában található, azzal a szándékkal, hogy az IMS alkalmazás ezen a felülbíráló értéken alapuló döntéseket hozzon.
Ha az ügyfélalkalmazás LTERM felülbíráló nevet akar biztosítani, akkor ez a tulajdonság használható. Ez a név az IMS alkalmazás I/O PCB blokkjában található, azzal a szándékkal, hogy az IMS alkalmazás ezen a felülbíráló értéken alapuló döntéseket hozzon.
A kimenetnél a mapName tulajdonság értéke jellemzően egy MFS Üzenet kimeneti leíró neve, vagy egyszerűen "MOD". Az IMS alkalmazás számára a MOD név az I/O PCB blokkban lesz biztosítva.
A kimenetnél a mapName tulajdonság értéke egy MFS Üzenet kimeneti leíró neve, vagy egyszerűen "MOD". Ez az a MOD név, amelyet az IMS alkalmazás adott meg a tranzakció kimeneti üzenet beillesztésekor az I/O PCB blokkba.
Megjegyzés: Azoknak a Java alkalmazásoknak, amelyek olyan vállalati szolgáltatásokat használnak, amelyek bemeneti és kimeneti üzeneteit a WebSphere Studio MFS támogatás állítja elő, nem kell használniuk a mapName mezőt.
A kimenetnél a mapName tulajdonság értéke jellemzően egy MFS Üzenet kimeneti leíró neve, vagy egyszerűen "MOD". Az IMS alkalmazás számára a MOD név az I/O PCB blokkban lesz biztosítva.
A kimenetnél a mapName tulajdonság értéke egy MFS Üzenet kimeneti leíró neve, vagy egyszerűen "MOD". Ez az a MOD név, amelyet az IMS alkalmazás adott meg a tranzakció kimeneti üzenet beillesztésekor az I/O PCB blokkba.
Azoknak a Java alkalmazásoknak, amelyek olyan vállalati szolgáltatásokat használnak, amelyek bemeneti és kimeneti üzeneteit a WebSphere Studio MFS támogatás állítja elő, nem kell használniuk a mapName mezőt.
Ez a tulajdonság csak olyan, megosztható állandó socket kapcsolatokon futó interakciókra érvényes, amelyek a SYNC_SEND_RECEIVE IMS interakciós parancsszót használják. Dedikált állandó socket kapcsolaton futó interakciók esetén érvénytelen. Végrehajtási mód 0 értéket használó interakciók esetén alkalmazható. Végrehajtási mód 1 értéket használó interakciók esetén nem alkalmazható. Ha azonban a végrehajtási mód 1 értéket használó interakció programközti váltást hajt végre, akkor az elindított program végrehajtási mód 0 értékkel fog futni, ezért a tulajdonság alkalmazható.
Ez a tulajdonság csak olyan, megosztható állandó socket kapcsolatokon futó interakciókra érvényes, amelyek a SYNC_SEND_RECEIVE IMS interakciós parancsszót használják. Dedikált állandó socket kapcsolaton futó interakciók esetén érvénytelen. Végrehajtási mód 0 értéket használó interakciók esetén alkalmazható. Végrehajtási mód 1 értéket használó interakciók esetén nem alkalmazható. Ha azonban a végrehajtási mód 1 értéket használó interakció programközti váltást hajt végre, akkor az elindított program végrehajtási mód 0 értékkel fog futni, ezért a tulajdonság alkalmazható. Ez a tulajdonság dönti el, hogy a kézbesítetlen kimenetet a reRouteName mezőben megadott nevesített címzetthez át kell-e irányítani. Ha a reRoute értéke TRUE, akkor az aszinkron kimenet az előállított clientID TPIPE várakozási sorába nem kerül be. Helyette az aszinkron kimenet a reRouteName mezőben meghatározott címzetthez lesz sorba állítva. A reRoute alapértelmezett értéke FALSE.
Ha a reRoute és a purgeAsyncOutput tulajdonságok értéke egyaránt TRUE, akkor kivétel történik.
A reRouteName tulajdonság csak megosztható állandó socket kapcsolatokon futó SYNC_SEND_RECEIVE interakciók esetén érvényes. Dedikált állandó socket kapcsolaton futó interakciók esetén érvénytelen.