Do tworzenia klas wiązania J2C i uzyskiwania do nich dostępu nie trzeba używać kreatora powiązań danych J2C. Można to również zrobić za pośrednictwem interfejsu wiersza komend o nazwie Batch Importer. Narzędzie Batch Importer można też uruchomić z poziomu środowiska roboczego.
Narzędzie Batch Importer pozwala generować klasy wiązania J2C dla adapterów zasobów CICS
ECI oraz IMS. Do tworzenia klas wiązania J2C i uzyskiwania do nich dostępu nie trzeba używać kreatora powiązań danych J2C. Można to również zrobić za pośrednictwem interfejsu wiersza komend o nazwie Batch Importer. Narzędzie Batch Importer można też uruchomić z poziomu środowiska roboczego.
Migracja ze skryptów narzędzia Ant w wersji 6 do nowych skryptów J2C w wersji 7: Produkty programistyczne Rational w wersji 7.0 oferują nową funkcję rejestrowania sesji, generującą skrypty narzędzia Ant. Dostępne jest narzędzie migracji pozwalające przekształcić skrypty Ant w wersji 6 do nowego formatu skryptów J2C Ant w wersji 7. Nowe skrypty narzędzia Ant są bardziej elastyczne i prostsze w użyciu, dlatego zaleca się korzystanie właśnie z nich.
Uruchamianie narzędzia migracji
- Nadaj parametrowi source wartość wskazującą plik ze starym skryptem narzędzia Ant w wersji 6, który ma zostać poddany migracji.
- Wykonaj plik migration.xml albo w środowisku roboczym, albo w trybie nienadzorowanym w wierszu komend.
<?xml version="1.0" encoding="UTF-8"?>
<project name="Migracja" default="default" xmlns:j2c="http://com.ibm.adapter.j2c">
<--
Ścieżka do pliku źródłowego musi być albo ścieżką względną w stosunku do obszaru roboczego, albo pełną ścieżką w systemie plików.
Nazwa oryginalnego pliku (source) zostanie zmieniona na rozszerzenie .bak.
-->
<target name="default">
<j2c:migrate source="/Script/batchImport_deprecated.xml"/>
</target>
</project>
Praca ze skryptami narzędzia Batch Importer
- Przystosowanie narzędzia do pracy w danym środowisku wymaga zmodyfikowania parametrów w pięciu plikach. Znajdują się one w katalogach <katalog_instalacyjny>\IBM\SDP70Shared\plugins/com.ibm.adapter/j2c.commad_6.1.0*/runtime
i <katalog_instalacyjny>\IBM\SDP70Shared\plugins/com.ibm.adapter/j2c.commad_6.1.0*/sample/batch_import.
Pliki, które trzeba zmodyfikować to:
- CICSECI_PlatformProperties.xml: Ten plik określa parametry plików źródłowych
w języku C lub COBOL, które będą stosowane domyślnie, w zależności od platformy, na której jest uruchamiane narzędzie Batch Importer (NT, AIX lub MVS).
- CICSECI_cobolSample.xml: W tym pliku zdefiniowane są właściwości usługi, które będą używane przez narzędzie Batch Importer:
- EISProject:
- name: Nazwa projektu usługi, który będzie zawierał nową usługę korporacyjną. Jeśli wskazany projekt usługi nie istnieje, zostanie on utworzony automatycznie.
Uwaga: W pliku przykładowym projekt EISProject zawiera element
ImportPropertyArray.
Właściwości importu określone w tym miejscu przesłaniają wartości ustawione w pliku PlatformProperties.xml.
Jeśli ustawienia domyślne zdefiniowane w pliku PlatformProperties.xml są poprawne dla danej usługi, element ImportPropertyArray można usunąć.
- EISService (należy zauważyć, że dla każdego elementu
EISProject można zdefiniować wiele elementów EISService):
- name: Nazwa usługi korporacyjnej. Po zaimportowaniu plików w języku C lub COBOL dla każdej usługi zostaną utworzone trzy pliki WSDL (plik interfejsu, wiązania i usługi).
- type : Nazwa adaptera zasobów używanego dla danej usługi. Jest to nazwa projektu konektora, w którym znajduje się plik RAR.
- targetNameSpace: Adres URL docelowej przestrzeni nazw (http://...). Dodatkowo w projekcie usługi zostanie utworzony pakiet, oparty na przestrzeni nazw targetNameSpace, w którym zostaną umieszczone wygenerowane pliki wsdl.
- generateHelpers: Jeśli importowane rodzime dane obejmują złożone typy danych, takie jak struktury w języku C, wówczas do prawidłowego działania usługi niezbędne są klasy pomocnicze. Gdy ta opcja ma wartość "true", wówczas narzędzie Batch Importer automatycznie wygeneruje i skompiluje wszystkie potrzebne klasy pomocnicze.
- Operation (należy zauważyć, że dla każdego elementu
EISProject można zdefiniować wiele elementów Operation):
- name: Nazwa operacji.
- type: Typ operacji. Opcja ta przyjmuje wartość REQUEST_RESPONSE lub ONE_WAY.
Uwaga: W zależności od typu operacji powinna ona zawierać albo definicję klasy InputMessage (operacja ONE_WAY), albo definicje klas InputMessage i OutputMessage (operacja REQUEST_RESPONSE). Jeśli klasy InputMessage i OutputMessage dzielą tę samą definicję typu,
stosuje się pojedynczą definicję klasy InputOutputMessage.
- ...Message
- importFile: Nazwa pliku zawierającego definicję, na podstawie której zostanie utworzona operacja usługi korporacyjnej. Może to być plik źródłowy w języku C lub
COBOL.
- importDirectory: Ścieżka do pliku importFile. Jeśli nie zostanie podany atrybut importDirectory, wówczas
plik importFile będzie wyszukiwany w katalogu wejściowym i w katalogu bieżącym.
- nativeTypeName : Nazwa typu danych, który ma zostać zaimportowany z pliku importFile. Na przykład dla języka COBOL parametr nativeTypeName ma najczęściej wartość DFHCOMMAREA.
Jeśli po analizie pliku importFile okaże się, że typ nativeTypeName nie jest poprawnym typem danych, wówczas zostanie zwrócony błąd.
- name: Nazwa dla zaimportowanego typu. Jeśli na przykład typ DFHCOMMAREA
reprezentuje dane klienta, można nadać parametrowi name wartość Klient.
- generationPackage: Opcjonalny parametr umożliwiający określenie innej nazwy pakietu, w którym zostaną umieszczone wygenerowane klasy pomocnicze (komponenty bean i procedury obsługi formatów). W ten sposób można zapewnić schematowi, który jest generowany w pliku interfejsu WSDL, inną przestrzeń nazw.
- sampleContainer.xml : Ten plik jest przekazywany do narzędzia
Batch Importer jako argument i zawiera listę plików (listę elementów ImportDefinition), które należy przetworzyć. Element ImportDefinitionArray
ma następujące atrybuty:
- platform: Nazwa platformy hosta. Dozwolone wartości to: NT, AIX oraz OS390.
- platformProperties: Określa nazwę pliku właściwości platformy.
- importBatch.bat (win) lub importBatch.sh (linux):
Plik wykonywalny narzędzia Batch Importer. Przyjmuje on następujące parametry:
- plikKontenera: To plik zdefiniowany w kroku c.
- Parametry opcjonalne
- stylGenerowania
- 0: Ustawienie domyślne, odpowiadające stylowi produktu WebSphere Studio, wersja 5.0.
- 1: Ustawienie odpowiadające następującym opcjom generowania produktu VisualAge® for Java™: bezpośrednie, bez powiadamiania, bez klas wewnętrznych, bez skracania nazw, z tablicami typów podstawowych.
- 2: Ustawienie odpowiadające następującym opcjom generowania produktu VisualAge for Java: bezpośrednie, bez powiadamiania, bez klas wewnętrznych, ze skracaniem nazw, z tablicami typów podstawowych.
- obszarRoboczy: Pełna ścieżka do obszaru roboczego, który ma zostać użyty przy imporcie.
- kat_inst_RAD: Katalog, w którym zainstalowano produkt Rational Application
Developer.
- Plik źródłowy w języku C lub COBOL: Ten plik źródłowy w języku COBOL (TADERC99.ccp)
lub C będzie używany do wygenerowania za pośrednictwem narzędzia Batch Importer plików wiązań danych oraz plików interfejsów.
- Uruchamianie narzędzia Batch Importer z poziomu wiersza komend: Aby uruchomić narzędzie Batch Importer w wierszu komend, wykonaj następujące czynności:
- Sprawdź, czy adapter zasobów, który ma zostać użyty, został zaimportowany do obszaru roboczego.
- Utwórz katalog, w którym będą przechowywane pliki wymienione w kroku
1. W kolejnych krokach procedury katalog ten będzie określany jako katalog_wejściowy.
- Ustaw właściwości języka i połączeń hosta w pliku z właściwościami platformy. Skopiuj odpowiedni plik z właściwościami platformy
(CICSECI_PlatformProperties.xml lub IMS_PlatformProperties.xml)
z katalogu %PROGRAMFILES%/IBM/SDP70Shared/plugins/com.ibm.adapter.j2c.command_6.1.0/sample/batch_import
(gdzie x oznacza katalog, w którym zostało zainstalowane środowisko programistyczne Rational) do katalogu katalog_wejściowy i otwórz go w edytorze tekstu. W pliku tym ustawia się domyślne właściwości,
odzwierciedlające środowisko docelowe.
Wszelkie właściwości ustawione w tym pliku mogą zostać przesłonięte przez plik definicji usługi omówiony w następnym kroku. Definicji platform, które nie są używane, nie trzeba usuwać.
- Skopiuj odpowiedni przykładowy plik definicji usługi
(CICSECI_cSample.xml, CICSECI_cobolSample.xml lub IMS_cobolSample.xml)
do katalogu katalog_wejściowy, zmieniając dowolnie jego nazwę.
- Skopiuj przykładowy plik kontenera, sampleContainer.xml,
do katalogu katalog_wejściowy, zmieniając dowolnie jego nazwę. Otwórz plik w edytorze tekstu i ustaw w nim odpowiednią platformę, a następnie dodaj element ImportDefinition, zawierający odwołanie do pliku definicji usługi, na każdy taki plik, jaki został utworzony w kroku
d.
- Jeśli uruchomiona jest instancja produktu Rational Application Developer wykorzystująca docelowy obszar roboczy, zamknij ją.
- Wywołaj komendę importBatch w wierszu komend z następującymi opcjami: importBatch -file=plikKontenera [-style=stylGenerowania]
[-d obszarRoboczy] [-e kat_inst_RAD]
Uwaga: Parametr -file wymaga podania pełnej ścieżki w systemie plików
do pliku plikKontenera.
- Uruchamianie narzędzia Batch Importer w obszarze roboczym: Aby uruchomić narzędzie Batch Importer z poziomu obszaru roboczego, wykonaj następujące czynności:
- Sprawdź, czy adapter zasobów, który ma zostać użyty, został zaimportowany do obszaru roboczego.
- Utwórz prosty projekt (nazwij go Temp), w którym zostaną umieszczone pliki wymienione w kroku
1. W kolejnych krokach procedury katalog ten będzie określany jako katalog_wejściowy.
- Wykonaj krok
c, krok d i krok e procedury "Uruchamianie narzędzia Batch Importer z poziomu wiersza komend".
- Skopiuj plik batchImport.xml z katalogu %PROGRAMFILES%/IBM/SDP70Shared/plugins/com.ibm.adapter.command_6.0.0/script
do katalogu katalog_wejściowy. Zmień nazwę pliku sampleContainer.xml na nazwę odpowiadającą plikowi kontenera.
- Kliknij plik batchImport.xml prawym przyciskiem myszy i wybierz opcje Uruchom > 2 Budowanie Ant. W otwartym oknie wybierz opcje JRE i
Uruchom w tym samym środowisku JRE co obszar roboczy. Kliknij przycisk Zastosuj, a następnie przycisk Zamknij.
Ten krok jest wymagany tylko raz.
- Kliknij plik batchImport.xml prawym przyciskiem myszy i wybierz opcje Uruchom > 1 Budowanie Ant.
Narzędzie Batch Importer zaimportuje pliki w języku COBOL
i C oraz wygeneruje pliki wiązania w ramach projektu (EISProject) i pakietu (wywodzącego się z docelowej przestrzeni nazw targetNameSpace) określonych w pliku XML.
Uwaga: Działanie narzędzia
Batch Importer uruchomionego w wierszu komend i uruchomionego z poziomu obszaru roboczego jest podobne. Aby się o tym przekonać, wystarczy otworzyć obszar roboczy, w którym zostały wygenerowane pliki z
kroku 1. Widoczny będzie projekt o nazwie
Temp zawierający te same pliki, które zostały zaimportowane ręcznie w
kroku
3.