Uwagi do wydania narzędzi J2C (J2EE connector)

© Copyright International Business Machines Corporation 2006. Wszelkie prawa zastrzeżone. Ograniczone prawa na rzecz rządu Stanów Zjednoczonych - używanie produktów, tworzenie ich duplikatów oraz ujawnianie informacji o nich podlega zastrzeżeniom zawartym w umowie GSA ADP Schedule zawartej z firmą IBM® Corp.

Uwagi do wydania

1.0 Ograniczenia
   1.1 Narzędzia J2C (J2EE connector) obsługują ograniczoną liczbę wersji adapterów zasobów
   1.2 Importer PL/I nie jest obsługiwany w systemie Linux
   1.3 Ograniczenie uruchamiania wielu adapterów na tym samym serwerze wykonawczym
2.0 Znane problemy oraz sposoby ich obejścia
   2.1 Wywoływanie komunikatu o błędzie po wybraniu pozycji wyświetlania na stronie podsumowania migracji
   2.2 Ograniczenie opcji wdrażania usługi Web Service w kreatorach J2C
   2.3 W systemie Linux wyświetlane jest odwzorowanie PL1_TO_Java/MPO_PL1_Mapping
   2.4 Migracja skryptu ant J2C w wersji 6013 do skryptu ant J2C w wersji 7.0

1.0 Ograniczenia

1.1 Narzędzia J2C (J2EE connector) obsługują ograniczoną liczbę wersji adapterów zasobów

Aktualnie obsługiwane są następujące wersje adapterów zasobów:
JCA 1.0                       JCA 1.5                      
IMSICO91014.rar IMSICO91023.rar      
IMSICO91013a.rar   IMSICO91022a.rar    
IMSICO91013.rar        IMSICO91022.rar      
IMSICO91012.rar       IMSICO91021.rar       
IMSICO91011.rar       IMSICO9102.rar      
ECIResourceAdapter 5.1.0.1                  ECIResourceAdapter 6.0.1                          
ECIResourceAdapter 5.0.1                 ECIResourceAdapter 6.0.2
  ECIResourceAdapter 6.0

 Aktualnie obsługiwaną wersją produktu CICS® Transaction Gateway jest wersja 6.0.2.

Oprogramowanie wspomagające CICS Transaction Gateway można uzyskać pod adresem

 http://www-1.ibm.com/support/docview.wss?uid=swg21239203

1.2 Program importujący PL/I nie jest obsługiwany w systemie Linux®

 Program importujący PL/I nie jest obsługiwany na platformie Linux.

1.3 Ograniczenie uruchamiania wielu adapterów na tym samym serwerze wykonawczym

Na serwerze WebSphere® Application Server nie należy instalować wielu autonomicznych adapterów zasobów, zwłaszcza jeśli są one przeznaczone dla tego samego typu systemu EIS (na przykład CICS ECI 5.1 i CICS ECI 6.0). To ograniczenie jest spowodowane tym, że wszystkie autonomiczne adaptery zasobów współużytkują ten sam program ładujący klasy. 

2.0 Znane problemy oraz sposoby ich obejścia

2.1 Wywoływanie komunikatu o błędzie po wybraniu pozycji wyświetlania na stronie podsumowania migracji

W przypadku kliknięcia na stronie podsumowania migracji J2C po przeprowadzonej migracji pliku WSDL usługi Web Service za pomocą kreatora migracji J2C wyświetlony zostanie komunikat o błędzie.

Obejście: Nie należy klikać na stronie podsumowania migracji po przeprowadzeniu migracji pliku WSDL usługi Web Service za pomocą kreatora migracji J2C. Zamiast tego podsumowanie można zapisać.

2.2 Ograniczenie opcji wdrażania usługi Web Service w kreatorach J2C

W przypadku opcji wdrażania usługi Web Service w kreatorze J2C, jeśli serwer docelowy nie zostanie uruchomiony, port określony dla punktu końcowego adresu usługi Web Service może zostać wyznaczony niepoprawnie.

Obejście: Przed rozpoczęciem generowania należy uruchomić serwer docelowy dla projektu WWW, w którym z komponentu bean Java J2C ma zostać wygenerowana usługa Web Service. Chociaż działanie serwera docelowego nie jest wymagane podczas generowania, jego wyłączenie może spowodować, że port dla adresu końcowego usługi Web Service może zostać wyznaczony niepoprawnie. Jeśli serwer nie zostanie uruchomiony, przed wdrożeniem usługi Web Service na serwerze należy się upewnić, czy port punktu końcowego określony w wygenerowanym pliku WSDL usługi Web Service odpowiada poprawnemu portowi na serwerze WebSphere.

2.3 W systemie Linux wyświetlane jest odwzorowanie PL1_TO_Java/MPO_PL1_Mapping

Funkcje programu importującego PL/I nie są obsługiwane w systemie Linux®.

Jeśli jednak użytkownik przejdzie przez kreatory J2C, na stronie programu importującego zobaczy opcję PL1_TO_Java/MPO_PL1_Mapping.

Po jej wybraniu występuje wyjątek pustego wskaźnika.

Obejście: Opcję należy zignorować i nie wybierać jej na platformie Linux.

2.4 Migracja skryptu ant J2C w wersji 6013 do skryptu ant J2C w wersji 7.0

Jeśli wcześniej wykorzystywane były skrypty ant J2C w wersji 6013, dla których użytkownik chce przeprowadzić migrację do skryptów ant J2C w wersji 7.0, należy zapoznać się z tą sekcją.

Poniżej przedstawiono sekcję wiązania interfejsu skryptu ant J2C, w której wykorzystane zostało zadanie <input>. Między zadaniem ant J2C <input> w poniższym skrypcie, a domyślnym zadaniem ant <input> występuje kolizja nazw:

         <createBinding package="com.ibm.test" class="Taderc99Interface">
              <methodElement>
                  <name value="gettaderc99"/>
                  <input value="\${project}\com\ibm\test\Taderc99.java"/>
                  <output value="\${project}\com\ibm\test\Taderc99.java"/>
                  <interactionSpec>
                      <propertyElement name="functionName" value="TADERC99"/>
                  </interactionSpec>
               </methodElement>
               <connectionSpec>
                     <propertyElement name="ServerName" value="rubicon"/>
                     <propertyElement name="ConnectionURL" value="rubicon.torolab.ibm.com"/>
                     <propertyElement name="UserName" value="sysad"/>
                     <propertyElement name="Password" value="sysad"/>
                     </connectionSpec>
               <resourceAdapter project="CICS ECI"/>
         </createBinding>

Skrypt <input> zadania ant J2C nadpisuje domyślne zadanie ant. Domyślne zadanie Ant nie może być wykonane.

W wersji J2C V6013 udostępniona została poprawka rozwiązująca problem kolizji nazw. Zadanie <input> J2C w powyższym skrypcie jest zamieniane na <j2cinput>, aby oba działały poprawnie.

Z powodu zmiany układu skryptów ant J2C w wersji 7.0 produktu, udostępnione zostało narzędzie migracji. Powyższa zmiana nazwy wpływa na narzędzie migracji, które nie rozpoznaje nazwy <j2cinput>. Aby poprawnie przeprowadzić migrację skryptów ant J2C z wersji 6.0.x produktu do nowego układu rozpoznawanego w wersji 7.0, nazwę zadania <j2cinput> należy zmienić z powrotem na <input>.