A J2C adatkötés varázsló használata helyett J2C kötés osztályok
parancssori felület, a Kötegelt importáló segítségével is létrehozhatók és
elérhetők. A Kötegelt importáló a munkaterületről is futtatható.
A Kötegelt importáló segítségével J2C kötés osztályok állíthatók
elő a
CICS
ECI és
IMS
erőforrás illesztőkhöz. A J2C adatkötés varázsló használata helyett J2C
kötés osztályok parancssori felület, a Kötegelt importáló segítségével is
létrehozhatók és elérhetők. A Kötegelt importáló a munkaterületről is
futtatható.
Áttérés V6 Ant parancsfájlokról az új J2C V7 Ant
parancsfájlokra: A
Rational
alkalmazásfejlesztési termékek V7.0 verziója új munkamenet
rögzítési szolgáltatást tartalmaz, amely Ant parancsfájlokat állít
elő. A V6 verziójú Ant parancsfájlok konvertáláshoz az új, V7 J2C Ant
parancsfájl formátumba áttérési eszköz áll rendelkezésre. Az új Ant
parancsfájlok rugalmasabbak és könnyeben használhatóak, ezért
használatuk ajánlott.
Az áttérési eszköz futtatása
- A forrást cserélje le a régi V6 Ant parancsfájlra, amelyet
át kíván venni.
- Hajtsa végre a migration.xml fájlt a
munkaterületen belül, vagy megjelenítés nélküli módot használva
futtassa a parancssorból.
<?xml version="1.0" encoding="UTF-8"?>
<project name="Migration" default="default" xmlns:j2c="http://com.ibm.adapter.j2c">
<--
A forrásfájl útvonalának a munkaterületből kiindulónak vagy teljes rendszerútvonalnak kell lennie.
Az eredeti fájl (forrás) .bak kiterjesztésűre lesz átnevezve.
-->
<target name="default">
<j2c:migrate source="/Script/batchImport_deprecated.xml"/>
</target>
</project>
Kötegelt importáló
parancsfájlok kezelése
- Öt fájlban található paramétereket kell módosítania,
hogy adott környezete igényeit kielégítse. Ezek a fájlok az <installdir>\IBM\SDP70Shared\plugins/com.ibm.adapter/j2c.commad_6.1.0*/runtime
és az
<installdir>\IBM\SDP70Shared\plugins/com.ibm.adapter/j2c.commad_6.1.0*/sample/batch_import
helyekről szerezhetők be. A következő fájlokra van szüksége:
- CICSECI_PlatformProperties.xml: Ez a fájl az
alapértelmezésben meghívandó C vagy COBOL forrásfájl paramétereket
határozza meg, a Kötegelt importáló futtatásához használt platformtól
függetlenül (NT,
AIX
vagy
MVS).
- CICSECI_cobolSample.xml: Ez a fájl a Kötegelt importáló
által használandó szolgáltatás tulajdonságokokat határozza meg.
- EISProject
- név: A szolgáltatás projekt neve, amely az új vállalati
szolgáltatást tartalmazni fogja. Ha a szolgáltatás projekt nem létezik,
akkor automatikusan létrehozásra kerül.
Megjegyzés: A mintafájl az
EISProject elemen belül ImportPropertyArray elemet tartalmaz. Az
itt található importálási tulajdonságok a PlatformProperties.xml fájlban
lévő értékeket újradefiniálják. Ha a PlatformProperties.xml fájlban a
szolgáltatáshoz beállított alapértelmezések helyesek, akkor az
ImportPropertyArray elem eltávolítható.
- EISService (vegye figyelembe, hogy minden egyes EISProject elemhez
több EISService elem is definiálható):
- név: A vállalati szolgáltatás neve. A C vagy COBOL fájlok
importálása után minden szolgáltatáshoz három WSDL fájl kerül
létrehozásra (felület, kötés, és szolgáltatás fájlok).
- típus: A szolgáltatáshoz használt erőforrás illesztő neve. Ez
annak a kapcsolat projektnek a neve, amelyik a RAR fájlt tartalmazza.
- targetNameSpace: A cél névtér URL címe (http://...). Ezenkívül
a szolgáltatás projektben az előállított fájlokat tartalmazó csomag kerül
előállításra a targetNameSpace alapján.
- generateHelpers: Ha az importált natív adatok összetett
adattípusokból állnak (például C szerkezetek), akkor a szolgáltatás
futtatásakor szükség lesz segédosztályokra. Ha a beállítás értéke "igaz",
akkor a kötegelt importáló program ezeket a segédosztályokat
automatikusan előállítja és lefordítja.
- Művelet (vegye figyelembe, hogy minden egyes EISService
elemhez több Művelet elem is definiálható):
- név: A művelet neve.
- típus: A művelet típusa. Ez REQUEST_RESPONSE vagy ONE_WAY
lehet.
Megjegyzés: A Művelet típusától függően, ONE_WAY műveletnek InputMessage
meghatározást kell tartalmaznia, míg a REQUEST_RESPONSE műveletnek
InputMessage és OutputMessage meghatározást is tartalmaznia
kell. Ha az InputMessage és az OutputMessage ugyanazon a
típusdefiníción osztozik, akkor egyetlen InputOutputMessage
meghatározás kerül felhasználásra.
- ...Üzenet
- importFile: A vállalati szolgáltatás művelet létrehozásához
használandó meghatározást tartalmazó fájl neve. Ez a fájl C vagy COBOL
forrásfájl lehet.
- importDirectory: Az importFile elemet tartalmazó útvonal. Ha az
importDirectory attribútum nincs megadva, akkor az importFile keresése az
inputdir és az aktuális könyvtárakban történik.
- nativeTypeName : Az importFile elemben megadott fájlból
importálandó adattípus neve. COBOL esetében például a nativeTypeName
értéke valószínűleg DFHCOMMAREA. Ha az importFile értelmezése után a
nativeTypeName érvényes adattípusként nem kerül azonosításra, akkor a
rendszer hibát ad vissza.
- név: Az importált típushoz használandó név. Ha a DFHCOMMAREA
például vásárlói adatokat képvisel, akkor a nevet beállíthatja
Ügyfél értékre.
- generationPackage: Elhagyható attribútum, amely az előállított
segédosztályok ( azaz a komponensek és formátumkezelők) számára eltérő
csomagnév megadását teszi lehetővé. Így a felület WSDL fáljban
előállított séma számára eltérő névteret biztosít.
- sampleContainer.xml : Ez a fájl a
Kötegelt importálónak argumentumként lesz átadva és a feldolgozandó
fájlok (ImportDefinitions) listáját tartalmazza. Az ImportDefinitionArray
elem a következő attribútumokkal rendelkezik:
- platform: A hosztrendszeren lévő operációs rendszert nevezi
meg. Értéke NT,
AIX vagy OS390 lehet.
- platformProperties: A platform tulajdonságfájl nevét adja
meg.
- importBatch.bat (win) vagy importBatch.sh (linux):
Ez maga a Kötegelt importáló programfájl a következő paraméterekkel:
- containerFile: a
c lépésben
meghatározott fájl.
- Választható paraméterek
- generationStyle
- 0: az alapértelmezett érték, ami a
WebSphere
Studio V5.0 stílusnak felel meg.
- 1: a VisualAge® for Java™ előállítási beállításoknak
felel meg: közvetlen, nincs értesítés, nincs belső osztály, nincs
névrövidítés, primitív típusú tömbökkel.
- 2: a
VisualAge
for
Java
előállítási beállításoknak felel meg: közvetlen, nincs értesítés, nincs
belső osztály, névrövidítés, primitív típusú tömbökkel.
- munkaterület: az importáláshoz használandó
munkaterület teljes képzésű elérési útja
- RAD_installdir: a Rational Application
Developer telepítési könyvtára.
- C vagy COBOL forrásfájl: Ezt a COBOL (TADERC99.ccp) vagy C
forrásfájlt fogja használni az adatkötés és felület fájok előállításához
a Kötegelt importáló segítségével
- A Kötegelt importáló futtatása a parancssorból: A Kötegelt
importáló indításához a parancssorból tegye a
következőket:
- Győződjön meg róla, hogy a használni kívánt erőforrás illesztő
importálva lett a munkaterületre.
- Az 1. lépésben
említett fájok tárolására hozzon létre könyvtárat. A hátralévő lépések
erre a könyvtárra inputdir könyvtárként fognak
hivatkozni.
- Állítsa be a hosztrendszer nyelvi és kapcsolati
beállításait a platform tulajdonságfájlban. Másolja a megfelelő platform
tulajdonságfájlt (CICSECI_PlatformProperties.xml vagy
IMS_PlatformProperties.xml) a
%PROGRAMFILES%/IBM/SDP70Shared/plugins/com.ibm.adapter.j2c.command_6.1.0/sample/batch_import
könyvtárból (ahol az x a
Rational
fejlesztő szoftver telepítési könyvtárára utal) az
inputdir könyvtárba és szövegszerkesztő segítségével
nyissa meg. A célkörnyezetet tükröző alapértelmezett tulajdonságokat ebben
a fájlban kell beállítani. Az ebben a fájlban beállított bármely
tulajdonság a következő lépésben leírt szolgáltatás definíciós fájlban
újradefiniálható. A nem használt platform definíciókat nem kell
törölnie.
- Másolja a megfelelő minta szolgáltatás definíciós
fájlt (CICSECI_cSample.xml, CICSECI_cobolSample.xml vagy
IMS_cobolSample.xml) az inputdir könyvtárba a fájlt
igény szerint átnevezve.
- Másolja a sampleContainer.xml tárolófájlt az
inputdir könyvtárba a fájlt igény szerint átnevezve. Nyissa
meg az eredményül kapott fájlt szövegszerkesztő segítségével és állítsa
be a megfelelő platformot, majd a
d. lépésben
létrehozott minden egyes szolgáltatás definíciós fájlhoz adjon hozzá
ImportDefinition elemet, amely a létrehozott szolgáltatás definíciós
fájlra utal.
- Ha a
Rational
Application Developer cél munkaterületet használó példánya fut, akkor
zárja azt be.
- A parancssorból indítsa az importBatch parancsot a következő
beállításokkal: importBatch -file=containerFile [-style=generationStyle]
[-d workspace] [-e RAD_installdir]
Megjegyzés: A -file paraméterben a containerFile teljes fájlrendszer
útvonalát meg kell adni
- A Kötegelt importáló futtatása a munkaterületről:
A Kötegelt importáló indításához a munkaterületről tegye a
következőket:
- Győződjön meg róla, hogy a használni kívánt erőforrás illesztő
importálva lett a munkaterületre.
- Hozzon létre egyszerű projektet (nevezze el
Temp-nek) az
1. lépésben említett
fájlok tárolására. A hátralévő lépések erre a könyvtárra
inputdir könyvtárként fognak hivatkozni.
- Hajtsa végre a
c. lépést, a
d. lépést és az
e. lépést a
Kötegelt importáló futtatása a parancssorból című részből.
- Másolja a batchImport.xml fájlt a
%PROGRAMFILES%/IBM/SDP70Shared/plugins/com.ibm.adapter.command_6.0.0/script
könyvtárból az inputdir könyvtárba. A
sampleContainer.xml fájlt módosítsa saját tárolófájljának nevére.
- Kattintson a jobb egérgombbal a batchImport.xml fájlra, majd
válassza az előugró menü Futtatás >
2 Ant összeépítés menüpontját. A megnyíló ablakban
válassza ki a JRE, majd a Futtatás a
munkaterületével megegyező JRE környezetben lehetőséget. Kattintson
az Alkalmaz majd a Bezárás
elemre. Ezt a lépést csak egyszer kell végrehajtani.
- Kattintson a jobb egérgombbal a batchImport.xml fájlra, majd
válassza az előugró menü Futtatás >
1 Ant összeépítés menüpontját.
A Kötegelt importáló a COBOL és C fájlokat importálja, majd a
projektben (EISProject) előállítja a kötésfájlokat és az XML fájlban
meghatározott (a targetNameSpace elemből származtatott) csomagot .
Megjegyzés: A parancssorból indított Kötegelt importáló végrehajtási folyamata
hasonló, mint a munkaterületről futtatott importáló esetében. Ennek
szemléltetésére nyissa meg a munkaterületet, amelyben a fájlok az
1. lépésben
előállításra kerültek. Megfigyelheti, hogy ugyanezen fájlokat tartalmazó
Temp nevű projekt került kézi úton
importálásra a
3.
lépésben.