Zanim rozpoczniesz
Procedura
Aby wysłać żądanie do usługi Java MQ:
- Kliknij przycisk Otwórz ogólny klient usług (
) i wybierz stronę Żądania. - Kliknij przycisk Dodaj (
) lub w bibliotece żądań kliknij prawym przyciskiem myszy pozycję EndPoints i wybierz typ żądania do wysłania. - W oknie Konfigurowanie protokołu wybierz opcję WebSphere Java MQ i określ konfigurację transportu. W razie potrzeby utwórz konfigurację transportu dla tego wywołania, klikając przycisk Nowa (patrz sekcja Tworzenie konfiguracji transportu WebSphere Java MQ).
- Wprowadź następujące informacje na karcie Ogólne:
- Kolejka
- Nazwa kolejki zdefiniowana na serwerze WebSphere MQ.
- Typ komunikatu
- Typy komunikatów są następujące:
- Datagram – komunikat nie wymaga odpowiedzi.
- Żądanie – komunikat wymaga odpowiedzi.
- Odpowiedź – komunikat jest odpowiedzią na wcześniejszy komunikat żądania.
- Raport – komunikat zgłasza oczekiwane lub nieoczekiwane zdarzenie, zazwyczaj dotyczące innego komunikatu. Na przykład komunikat żądania zawierający niepoprawne dane.
- Trwałość komunikatu
Ta wartość wskazuje, czy komunikat jest trwały. Trwałe komunikaty są zachowywane w przypadku awarii systemu i restartów menedżera kolejek. Komunikaty nietrwałe są zachowywane, jeśli znajdują się w kolejce z atrybutem NPMCLASS(HIGH). Jednak nawet w przypadku ustawionego atrybutu NPMCLASS(HIGH), komunikat nie jest zachowywany po wystąpieniu klasy QMGR. Nietrwałe komunikaty znajdujące się w kolejkach z atrybutem NPMCLASS(NORMAL) są odrzucane podczas restartowania menedżera kolejek nawet wtedy, gdy komunikat zostanie znaleziony w pamięci dyskowej w trakcie wykonywania procedury restartowania.
- Odpowiedź dynamiczna
- To pole wyboru należy zaznaczyć, aby serwer WebSphere MQ dynamicznie tworzył kolejkę tymczasową jako odpowiedź. Jeśli to pole wyboru nie zostanie zaznaczone, zostanie użyta kolejka podana w polu Kolejka odpowiedzi.
- Kolejka odpowiedzi
Nazwa kolejki komunikatów, do której aplikacja wysyłająca żądanie pobrania komunikatu ma wysłać komunikaty odpowiedzi i raportu.
- Menedżer odpowiedzi
Nazwa menedżera kolejek, w którym zdefiniowano kolejkę zwrotną.
- Właściwości dodatkowe
- Służy do określania dodatkowych właściwości kolejek.
- Opcjonalne: W razie potrzeby podaj następujące informacje na karcie Konfiguracja:
- Priorytet komunikatu
To jest priorytet komunikatu. Najniższy priorytet to 0.
- Kodowanie
Kodowanie danych liczbowych znajdujących się w komunikacie. Ta wartość nie ma zastosowania do danych liczbowych w samej strukturze MQMD.
- Okres ważności
Czas (w dziesiątych sekundy), po którym komunikat kwalifikuje się do odrzucenia, jeśli nie został jeszcze usunięty z kolejki docelowej. Okres ważności jest ustawiany przez aplikację umieszczającą komunikat.
- Zestaw znaków
Identyfikator zestawu znaków dla danych znakowych w komunikacie aplikacji.
- Opcjonalne: Na karcie Raport wybierz komunikaty raportu, które mają być odbierane.
- Opcjonalne: W razie potrzeby podaj następujące informacje na karcie Kontekst:
- Dane tożsamości aplikacji
Te informacje są definiowane przez pakiet aplikacji. Za ich pomocą można podać informacje o komunikacie lub jego nadawcy.
- Dane o pochodzeniu aplikacji
Te informacje są definiowane przez pakiet aplikacji. Za ich pomocą można podać dodatkowe informacje o pochodzeniu komunikatu.
- Znacznik rozliczania
Te informacje są wymagane, aby aplikacja mogła poprawnie rozliczyć pracę wykonaną w wyniku komunikatu.
- Identyfikator użytkownika
Identyfikator użytkownika aplikacji, z której pochodzi komunikat.
- Opcjonalne: Na karcie Identyfikatory w drugiej kolumnie podaj identyfikator w formacie łańcuchowym dla komunikatów, które wymagają binarnych danych wejściowych. Pierwsza kolumna jest wypełniana automatycznie w formacie szesnastkowym.
- Opcjonalne: Na karcie Segmentacja wybierz segment komunikatu i kliknij przycisk Dalej.
- Ten krok nie dotyczy żądań tekstowych. Na stronie Wybieranie elementu głównego wybierz definicję schematu XML (XML Schema Definition - XSD), jeśli usługa jej używa. Jeśli odpowiedni element XSD nie znajduje się na liście, kliknij przycisk Przeglądaj, aby zaimportować plik XSD, i wybierz element główny dla żądania. Jeśli nie ma dostępnego pliku XSD dla usługi, wybierz opcję Brak schematu.
- Kliknij przycisk Zakończ. Żądanie zostanie dodane do sekcji Punkty końcowe w oknie Biblioteka żądań.
- W oknie Biblioteka żądań wybierz element żądania. W ogólnym kliencie usług zostaną wyświetlone trzy kroki: Edycja danych, Wywołanie i Wyświetlanie odpowiedzi. Szczegóły żądania są wyświetlane w kroku Edycja danych.
- Na podstawie żądania wybranego w kroku 2 zmodyfikuj treść żądania na stronie Komunikat, używając widoku Formularz, Drzewo lub Źródło. W każdym widoku te same dane są wyświetlane w inny sposób. Aby dodać lub usunąć elementy XML w widoku Formularz lub Drzewo, należy kliknąć opcję Schemat > Sprawdź poprawność i uruchom asystę. Zapewni to zgodność z definicją schematu XML (XSD) określoną w katalogu schematów.
- Na stronie Transport zmień konfigurację transportu, która ma być używana przez żądanie (o ile jest to konieczne). Aby utworzyć i edytować konfiguracje transportu i zabezpieczeń, należy użyć karty Transport.
- Jeśli w kroku 2 wybrano żądanie SOAP XML, na stronie Stos żądań wskaż, czy chcesz przesłaniać
algorytmy zabezpieczeń lub przetwarzania, które są stosowane w przypadku żądań
wychodzących dla pliku WSDL. Aby dodać stronę Stos odpowiedzi w celu edytowania zabezpieczeń lub algorytmów przetwarzania odpowiedzi przychodzących, kliknij przycisk Pokaż stos odpowiedzi.
Uwaga: Te ustawienia dotyczą tylko bieżącego żądania. Aby zmodyfikować stos żądań lub odpowiedzi dla wszystkich żądań używających bieżącego pliku WSDL, należy kliknąć opcję Edytuj zabezpieczenia WSDL w celu otwarcia okna Edytor zabezpieczeń WSDL.
- Gdy zakończysz wykonywanie poprzedniej czynności, kliknij przycisk Wywołaj, aby wysłać żądanie usługi. Ogólny klient usług wysyła żądanie i wyświetla zwrócony komunikat w kroku Wyświetlanie odpowiedzi.
Co dalej
).