Właściwości definicji usługi produktu IBM MQ
Istnieje możliwość ustawiania właściwości i atrybutów definicji usług podczas tworzenia nowej definicji usługi lub edytowania istniejącej definicji usługi.
Niektóre z atrybutów są dostępne tylko wtedy, gdy definicja usługi dotyczy konkretnego typu powiązania lub wzorca wymiany komunikatów. Aby wyświetlić właściwości poszczególnych stron właściwości definicji usługi, należy użyć następujących odsyłaczy.
- Ogólne
- Operacja
- Wejście docelowe
- Schemat komunikatu wejściowego
- Nagłówek komunikatu wejściowego
- Wyjście docelowe
- Schemat komunikatu wyjściowego
- Nagłówek komunikatu wyjściowego
Dla każdego atrybutu dostępny jest krótki opis sytuacji, w których wymagana jest jego konfiguracja.
Strona Ogólne
Poniższa tabela zawiera listę atrybutów, które można ustawić na stronie Ogólne okna dialogowego Właściwości definicji usługi.
Atrybut | Opis |
---|---|
Przestrzeń nazw | Określa przestrzeń nazw dla usługi. Istnieje już przypisana tymczasowa wartość domyślna. |
Nazwa | Unikalna nazwa nowej definicji usługi. W nazwie definicji usługi nie są rozróżniane wielkości liter, ale nazwa definicji usługi, w której użyto liter o różnych wielkościach, zostaje zachowana. |
Wzorzec wymiany komunikatów | Atrybut ten opisuje kierunek przesyłania i odbierania
komunikatów podczas wywołania usługi.
Można wybrać jedną z dwóch opcji:
|
Typ powiązania | Określa wersję specyfikacji definicji usługi produktu IBM® MQ. |
Komentarz | Komentarz stanowiący adnotację o usłudze w pliku WSDL. |
Strona Operacja
Poniższa tabela zawiera listę atrybutów, które można ustawić na stronie Operacja okna dialogowego Właściwości definicji usługi. Każda definicja usługi zawiera tylko jedną operację.
Atrybut | Opis |
---|---|
Nazwa operacji | Określa nazwę operacji. Aby można było utworzyć definicję usługi, ta właściwość musi zawierać wartość. |
Działanie | Atrybut używany przez dostawcę usług do rozsyłania żądań
usług. Na przykład: umożliwienie wdrożenia wielu usług z użyciem pojedynczego
miejsca docelowego, włączenie rozsyłania przez dostawcę usług żądań
przychodzących do miejsca docelowego w odpowiedni sposób. Jeśli typem powiązania jest MQ, atrybut Działanie ma wartość targetAction. |
Komentarz | Komentarz stanowiący adnotację o operacji w pliku WSDL. |
Strona Wejście docelowe
Poniższa tabela zawiera listę atrybutów, które można ustawić na stronie Wejście docelowe okna dialogowego Właściwości definicji usługi. Na tej stronie są definiowane szczegóły komunikatu oczekiwane przez usługę oraz miejsce docelowe, z którego będą one pobierane.
Atrybut | Opis |
---|---|
Nazwa docelowa wejścia | Określa nazwę kolejki docelowej lub tematu docelowego, do którego jest
wysyłane żądanie, na przykład: Element queue-dest lub topic-dest
identyfikatora IRI produktu
IBM MQ, na przykład:
|
Nazwa menedżera kolejek docelowych | Określa nazwę menedżera kolejek docelowych. |
Menedżer kolejek połączeń | Określa nazwę menedżera kolejek, z którym nawiązuje połączenie usługa zgłaszająca żądanie. Jest odpowiednikiem parametru NazwaMenedżeraKolejek używanego w wywołaniach MQCONN() i MQCONNX(). |
Właściwości połączenia klienta | Właściwości połączenia klienta określają szczegółowe powiązania, które mogą zawierać informacje o sposobie, w jaki requester usługi tworzy powiązania z konkretnym komputerem lub kanałem. Możliwość określenia powiązań klienckich i nazw kanałów jest przydatna w pewnych sytuacjach, jednak nadmierne określenie usługi może stanowić ograniczenie. Rozwiązaniem tego problemu jest zminimalizowanie ilości informacji o powiązaniach włączanych do definicji usługi oraz umożliwienie bazowej infrastrukturze lub produktowi IBM MQ kierowania komunikatów, gdy jest to możliwe. |
Nazwa tabeli kanałów | Określa nazwę pliku tabeli kanałów klienta. Nazwa ta
służy do identyfikacji połączenia kanału.
|
Biblioteka tabeli kanałów | Określa ścieżkę do tabeli kanałów klienta.
|
Nazwa połączenia kanału klienta | Określa łańcuch połączenia używany podczas nawiązywania
przez requester usługi połączenia powiązania klienckiego
IBM MQ MQI. W przypadku
protokołu TCP/IP połączenie ma postać nazwy hosta i numeru portu, na przykład:
Jeśli nie zostanie określony numer portu, będzie użyta wartość domyślna 1414.
|
Nazwa kanału klienta | Określa kanał używany podczas nawiązywania przez
requester usługi IBM MQ
połączenia powiązania klienckiego
IBM MQ MQI.
|
Typ transportu kanału klienta | Określa typ transportu używany podczas nawiązywania przez
requester usługi IBM MQ
połączenia powiązania klienckiego
IBM MQ MQI.
|
Strona Schemat komunikatu wejściowego
Poniższa tabela zawiera listę atrybutów, które można ustawić na stronie Schemat komunikatu wejściowego okna dialogowego Właściwości definicji usługi. Atrybuty te umożliwiają zdefiniowanie schematu dla ładunku komunikatu.
Atrybut | Opis |
---|---|
Typ danych przychodzących | Określa oczekiwany typ danych przychodzących. W przypadku typów prostych
można wykonać modelowanie z użyciem wbudowanych typów XSD języka XML, takich
jak xsd:string lub xsd:int .
W przypadku typów bardziej złożonych typ
danych można zaimportować z zewnętrznego pliku, określając opcje
Plik schematu importu i Przestrzeń nazw
importu dla typu danych. |
Plik schematu importu | Określa plik schematu, który ma zostać zaimportowany. |
Przestrzeń nazw importu | Określa przestrzeń nazw, która ma zostać zaimportowana. |
Strona Nagłówek komunikatu wejściowego
Poniższa tabela zawiera listę atrybutów, które można ustawić na stronie Nagłówek komunikatu wejściowego okna dialogowego Właściwości definicji usługi. Na tej stronie są definiowane szczegóły komunikatu oczekiwane przez usługę oraz miejsce docelowe, z którego będą one pobierane. Niektóre właściwości dotyczą tylko definicji usług o typie powiązania MQ.
Atrybut | Opis |
---|---|
CCSID | Określa identyfikator kodowanego zestawu znaków będący odpowiednikiem pola Identyfikator_kodowanego_zestawu_znaków w strukturze MQMD. Jeśli wartość ta nie zostanie określona, requester usługi i dostawca usługi użyją wartości odpowiadającej zestawowi znaków danych komunikatu. |
Format | Określa nazwę formatu danych komunikatu. Właściwość ta
odpowiada polu formatu MQRFH2, a jeśli brak pola formatu
MQRFH2, odpowiada polu formatu MQMD. Wartość musi być łańcuchem znaków o długości od 0 do 8 znaków złożonym ze
znaków z zakresu A-Z i 0-9. Wartość Format można ustawić na dowolną wartość zgodnie z wytycznymi zawartymi w publikacji Pole formatu. |
Właściwości użytkownika | Określa dane zdefiniowane przez użytkownika przenoszone w
komunikatach usługi IBM MQ. Wartości należy określić w
formacie dozwolonym dla elementów folderu RFH2 - w serii zestawów trzech
elementów kodowanych z użyciem składni zbliżonej do XML, na przykład:
Element dt="typ_danych" jest opcjonalny i jeśli zostanie
pominięty, będzie traktowany jak łańcuch, a elementy można określić
następująco:
Na przykład:
Więcej informacji o dozwolonych typach danych i formatowaniu zawiera sekcja NameValueData (MQCHARn) w Centrum Wiedzy IBM.
Nie zaleca się włączania do komunikatu właściwości dotyczących zabezpieczeń,
takich jak UserId lub passwords. |
Typ komunikatu | Określa typ wysyłanego komunikatu.
Właściwość ta
odpowiada polu Typ_komunikatu w strukturze
MQMD.
Dostępnych jest pięć następujących wartości:
|
Trwałość | Określa, czy komunikat jest trwały. Jest odpowiednikiem
pola Trwałość w strukturze MQMD. Dostępne są trzy następujące wartości:
|
ID komunikatu | Określa identyfikator komunikatu będący odpowiednikiem
pola Identyfikator_komunikatu w strukturze MQMD. Identyfikator komunikatu umożliwia opisywanie niektórych specjalistycznych aplikacji produktu IBM MQ jako usług (na przykład aplikacji, które współużytkują kolejkę wejściową i wybierają przeznaczone dla nich komunikaty na podstawie predefiniowanej wartości msgId). Predefiniowanie wartości Identyfikator_komunikatu w definicjach usług może powodować problemy, na przykład w sytuacji, gdy wzorzec wymiany komunikatów typu żądanie-odpowiedź zwróci wartość Identyfikator_komunikatu żądania. Wartość ID komunikatu może być łańcuchem znaków lub wartością binarną. Wartości binarne muszą być łańcuchami złożonymi z maksymalnie 24 par dwuznakowych wartości szesnastkowych.Aby otworzyć okno dialogowe i wprowadzić wartość w postaci tekstu lub bajtów, należy kliknąć opcję Edytuj. |
ID korelacji | Określa identyfikator korelacji będący odpowiednikiem
pola Identyfikator_korelacji w strukturze MQMD. Wartość ID korelacji może być łańcuchem znaków
lub wartością binarną. Wartości binarne muszą być łańcuchami złożonymi z
maksymalnie 24 par dwuznakowych wartości szesnastkowych. Aby otworzyć okno dialogowe i wprowadzić wartość w postaci tekstu lub bajtów, należy kliknąć opcję Edytuj. |
Utrata ważności | Określa czas życia komunikatu. Musi to być liczba
całkowita ze znakiem i wartość ta jest mierzona w dziesiątych częściach
sekundy. Zakres wartości atrybutu Utrata ważności wynosi od 1
do 2 147 483 647. Aby wskazać, że komunikat nie traci ważności, należy użyć wartości specjalnej Brak ograniczenia. Wartość wynosząca -1 jest zapisywana w pliku WSDL. Wartość wynosząca Nieokreślona oznacza, że w pliku WSDL nie zostanie zapisana żadna wartość. Jest to wartość domyślna. |
Priorytet | Określa priorytet powiązany z komunikatem i odpowiada
polu Priorytet w strukturze MQMD.
Priorytet należy określić
jako liczbę całkowitą z zakresu od 0 do 9, gdzie 0 oznacza najniższy priorytet,
a 9 - najwyższy. Za pomocą wartości specjalnej Brak ograniczenia można wskazać, że priorytet komunikatu jest pobierany z definicji pierwszej kolejki, w której komunikat ten zostanie umieszczony. Wartość wynosząca -1 jest zapisywana w pliku WSDL. Wartość wynosząca Nieokreślona oznacza, że w pliku WSDL nie zostanie zapisana żadna wartość. Jest to wartość domyślna. |
Kodowanie | Określa kodowanie liczbowe danych komunikatu
odpowiadające polu Kodowanie w strukturze MQMD:
|
Opcje raportu | Określa sposób ustawiania przez dostawcę usług
identyfikatorów komunikatów i korelacji w komunikatach odpowiedzi lub
komunikatach o błędzie.
Właściwość jest odpowiednikiem pola Raport w strukturze
MQMD.
Istnieją cztery możliwe wartości:
|
Strona Wyjście docelowe
Poniższa tabela zawiera listę atrybutów, które można ustawić na stronie Wyjście docelowe okna dialogowego Właściwości definicji usługi. Na stronie danych wyjściowych są definiowane szczegóły komunikatu wysyłanego przez usługę w odpowiedzi na komunikat wejściowy, a także miejsce docelowe, w którym zostanie on umieszczony. Nazwa wyjścia docelowego musi zostać poprzedzona łańcuchem msg/queue/ dla kolejek lub msg/topic/ dla tematów.
Atrybut | Opis |
---|---|
Nazwa docelowa wyjścia | Określa nazwę kolejki docelowej lub tematu docelowego, do którego jest
wysyłany komunikat odpowiedzi. Odpowiednik pól Kolejka_zwrotna i
Menedżer_kolejek_zwrotnych w strukturze MQMD. Nazwa miejsca docelowego musi
mieć formę elementu queue-dest lub topic-dest identyfikatora URI produktu
IBM MQ, na przykład:
|
Nazwa menedżera kolejek docelowych | Określa nazwę menedżera kolejek docelowych. |
Menedżer kolejek połączeń | Określa nazwę menedżera kolejek, z którym nawiązuje połączenie usługa zgłaszająca żądanie. Jest odpowiednikiem parametru NazwaMenedżeraKolejek używanego w wywołaniach MQCONN() i MQCONNX(). |
Właściwości połączenia klienta | Właściwości połączenia klienta określają szczegółowe powiązania, które mogą zawierać informacje o sposobie, w jaki requester usługi tworzy powiązania z konkretnym komputerem lub kanałem. Możliwość określenia powiązań klienckich i nazw kanałów jest przydatna w pewnych sytuacjach, jednak nadmierne określenie usługi może stanowić ograniczenie. Rozwiązaniem tego problemu jest zminimalizowanie ilości informacji o powiązaniach włączanych do definicji usługi oraz umożliwienie bazowej infrastrukturze lub produktowi IBM MQ kierowania komunikatów, gdy jest to możliwe. |
Nazwa tabeli kanałów | Określa nazwę pliku tabeli kanałów klienta. Nazwa ta
służy do identyfikacji połączenia kanału.
|
Biblioteka tabeli kanałów | Określa ścieżkę do tabeli kanałów klienta.
|
Nazwa kanału klienta | Określa łańcuch połączenia używany podczas nawiązywania
przez requester usługi połączenia powiązania klienckiego
IBM MQ MQI. W przypadku
protokołu TCP/IP połączenie ma postać nazwy hosta i numeru portu, na przykład:
Jeśli nie zostanie określony numer portu, będzie użyta wartość domyślna 1414.
|
Nazwa połączenia kanału klienta | Określa kanał używany podczas nawiązywania przez
requester usługi IBM MQ
połączenia powiązania klienckiego
IBM MQ MQI.
|
Typ transportu kanału klienta | Określa typ transportu używany podczas nawiązywania przez
requester usługi IBM MQ
połączenia powiązania klienckiego
IBM MQ MQI.
|
Strona Schemat komunikatu wyjściowego
Poniższa tabela zawiera listę atrybutów, które można ustawić na stronie Schemat komunikatu wyjściowego okna dialogowego Właściwości definicji usługi. Atrybuty te umożliwiają zdefiniowanie schematu dla ładunku komunikatu.
Atrybut | Opis |
---|---|
Typ danych wychodzących | Określa oczekiwany typ danych wychodzących |
Plik schematu importu | Określa plik schematu, który ma zostać zaimportowany. |
Przestrzeń nazw importu | Określa przestrzeń nazw, która ma zostać zaimportowana. |
Strona Nagłówek komunikatu wyjściowego
Poniższa tabela zawiera listę atrybutów, które można ustawić na stronie Nagłówek komunikatu wyjściowego okna dialogowego Właściwości definicji usługi. Na stronie danych wyjściowych są definiowane szczegóły komunikatu wysyłanego przez usługę w odpowiedzi na komunikat wejściowy, a także miejsce docelowe, w którym zostanie on umieszczony. Niektóre właściwości dotyczą tylko definicji usług o typie powiązania MQ.
Atrybut | Opis |
---|---|
CCSID | Określa identyfikator kodowanego zestawu znaków będący odpowiednikiem pola Identyfikator_kodowanego_zestawu_znaków w strukturze MQMD. Jeśli wartość ta nie zostanie określona, requester usługi i dostawca usługi użyją wartości odpowiadającej zestawowi znaków danych komunikatu. |
Format | Określa nazwę formatu danych komunikatu. Właściwość ta
odpowiada polu formatu MQRFH2, a jeśli brak pola formatu
MQRFH2, odpowiada polu formatu MQMD. Wartość musi być łańcuchem znaków o długości od 0 do 8 znaków złożonym ze
znaków z zakresu A-Z i 0-9. Wartość Format można ustawić na dowolną wartość zgodnie z wytycznymi zawartymi w publikacji Pole formatu. |
Właściwości użytkownika | Określa dane zdefiniowane przez użytkownika przenoszone w
komunikatach usługi IBM MQ. Wartości należy określić w
formacie dozwolonym dla elementów folderu RFH2 - w serii zestawów trzech
elementów kodowanych z użyciem składni zbliżonej do XML, na przykład:
Element dt="typ_danych" jest opcjonalny i jeśli zostanie pominięty, będzie traktowany jak
łańcuch, a elementy można określić następująco:
Na przykład:
Więcej informacji o dozwolonych typach danych i formatowaniu zawiera sekcja NameValueData (MQCHARn) w Centrum Wiedzy IBM.
Nie zaleca się włączania do komunikatu właściwości dotyczących zabezpieczeń,
takich jak UserId lub passwords. |
Typ komunikatu | Określa typ wysyłanego komunikatu.
Właściwość ta
odpowiada polu Typ_komunikatu w strukturze
MQMD.
Dostępnych jest pięć następujących wartości:
|
Trwałość | Określa, czy komunikat jest trwały. Jest odpowiednikiem
pola Trwałość w strukturze MQMD. Dostępne są trzy następujące wartości:
|
ID komunikatu | Określa identyfikator komunikatu będący odpowiednikiem
pola Identyfikator_komunikatu w strukturze MQMD. Identyfikator komunikatu umożliwia opisywanie niektórych specjalistycznych aplikacji produktu IBM MQ jako usług (na przykład aplikacji, które współużytkują kolejkę wejściową i wybierają przeznaczone dla nich komunikaty na podstawie predefiniowanej wartości msgId). Predefiniowanie wartości Identyfikator_komunikatu w definicjach usług może powodować problemy, na przykład w sytuacji, gdy wzorzec wymiany komunikatów typu żądanie-odpowiedź zwróci wartość Identyfikator_komunikatu żądania. Wartość ID komunikatu może być łańcuchem znaków lub wartością binarną. Wartości binarne muszą być łańcuchami złożonymi z maksymalnie 24 par dwuznakowych wartości szesnastkowych.Aby otworzyć okno dialogowe i wprowadzić wartość w postaci tekstu lub bajtów, należy kliknąć opcję Edytuj. |
ID korelacji | Określa identyfikator korelacji będący odpowiednikiem
pola Identyfikator_korelacji w strukturze MQMD. Wartość ID korelacji może być łańcuchem znaków
lub wartością binarną. Wartości binarne muszą być łańcuchami złożonymi z
maksymalnie 24 par dwuznakowych wartości szesnastkowych. Aby otworzyć okno dialogowe i wprowadzić wartość w postaci tekstu lub bajtów, należy kliknąć opcję Edytuj. |
Utrata ważności | Określa czas życia komunikatu. Musi to być liczba
całkowita ze znakiem i wartość ta jest mierzona w dziesiątych częściach
sekundy. Zakres wartości atrybutu Utrata ważności wynosi od 1
do 2 147 483 647. Aby wskazać, że komunikat nie traci ważności, należy użyć wartości specjalnej Brak ograniczenia. Wartość wynosząca -1 jest zapisywana w pliku WSDL. Wartość wynosząca Nieokreślona oznacza, że w pliku WSDL nie zostanie zapisana żadna wartość. Jest to wartość domyślna. |
Priorytet | Określa priorytet powiązany z komunikatem i odpowiada
polu Priorytet w strukturze MQMD.
Priorytet należy określić
jako liczbę całkowitą z zakresu od 0 do 9, gdzie 0 oznacza najniższy priorytet,
a 9 - najwyższy. Za pomocą wartości specjalnej Brak ograniczenia można wskazać, że priorytet komunikatu jest pobierany z definicji pierwszej kolejki, w której komunikat ten zostanie umieszczony. Wartość wynosząca -1 jest zapisywana w pliku WSDL. Wartość wynosząca Nieokreślona oznacza, że w pliku WSDL nie zostanie zapisana żadna wartość. Jest to wartość domyślna. |
Kodowanie | Określa kodowanie liczbowe danych komunikatu
odpowiadające polu Kodowanie w strukturze MQMD:
|
Opcje raportu | Określa sposób ustawiania przez dostawcę usług
identyfikatorów komunikatów i korelacji w komunikatach odpowiedzi lub
komunikatach o błędzie.
Właściwość jest odpowiednikiem pola Raport w strukturze
MQMD.
Istnieją cztery możliwe wartości:
|