jmsActivationSpec - Specyfikacja aktywowania JMS (jmsActivationSpec)

Definiuje konfigurację specyfikacji aktywowania JMS.

NameTypeDefaultDescription
idłańcuchUnikalny identyfikator konfiguracji.
authDataRefOdwołanie do elementu authData najwyższego poziomu (łańcuch).Domyślne dane uwierzytelniania dla specyfikacji aktywowania.
maxEndpointsint
Min: 0
500Maksymalna liczba punktów końcowych dla rozesłania.
autoStartbooleantruePozwala skonfigurować to, czy punkty końcowe komunikatów powiązane z tą specyfikacją aktywowania są uruchamiane automatycznie czy trzeba je uruchamiać ręcznie przy użyciu komendy resume.

authData

Domyślne dane uwierzytelniania dla specyfikacji aktywowania.

NameTypeDefaultDescription
userstringNazwa użytkownika używana podczas nawiązywania połączenia z systemem informacyjnym przedsiębiorstwa (EIS).
passwordHasło zakodowane odwracalnie (łańcuch)Hasło użytkownika nawiązującego połączenie z systemem informacyjnym przedsiębiorstwa (EIS). Wartość może być przechowywana jako jawny tekst lub w postaci zakodowanej. Zalecane jest zakodowanie hasła. Można do tego użyć narzędzia securityUtility z opcją encode.

properties.wasJms

Specyfikacja aktywowania JMS jest powiązana z jednym lub większą liczbą komponentów bean sterowanych przez komunikaty i udostępnia konfigurację niezbędną do odbierania komunikatów.

NameTypeDefaultDescription
acknowledgeMode
  • Auto-acknowledge
  • Dups-ok-acknowledge
Auto-acknowledgeTryb potwierdzania wskazuje, w jaki sposób ma być potwierdzany komunikat otrzymywany przez komponent bean sterowany komunikatami.
Auto-acknowledge
Auto-acknowledge
Dups-ok-acknowledge
Dups-ok-acknowledge
busNamestringdefaultBusNazwa magistrali podczas nawiązywania połączenia z magistralą integracji usług na serwerze pełnego profilu.
destinationType
  • javax.jms.Queue
  • javax.jms.Topic
javax.jms.QueueTyp miejsca docelowego: javax.jms.Queue lub javax.jms.Topic.
javax.jms.Queue
javax.jms.Queue
javax.jms.Topic
javax.jms.Topic
maxConcurrencyint
Min: 1

Max: 2147483647
5Maksymalna liczba punktów końcowych, do których komunikaty są dostarczane współbieżnie. Zwiększenie tej liczby może zwiększyć wydajność, ale także zwiększa liczbę wątków używanych w określonym czasie. Jeśli kolejność komunikatów musi zostać zachowana dla wszystkich nieudanych prób dostarczenia, należy ustawić maksymalną liczbę współbieżnych punktów końcowych na wartość 1.
readAhead
  • AlwaysOn
  • AlwaysOff
  • Default
DefaultOdczyt z wyprzedzeniem to mechanizm optymalizacji, który pozwala przypisywać komunikaty do konsumentów z odpowiednim wyprzedzeniem. Powoduje to szybsze przetwarzanie żądań konsumentów.
AlwaysOn
AlwaysOn
AlwaysOff
AlwaysOff
Default
Default
retryIntervalOkres z dokładnością do sekundy30sOpóźnienie (w sekundach) między próbami połączenia z mechanizmem przesyłania komunikatów. Dotyczy zarówno połączenia początkowego, jak i wszelkich kolejnych prób nawiązania lepszego połączenia. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
subscriptionDurability
  • NonDurableShared
  • Durable
  • DurableShared
  • NonDurable
NonDurableTyp subskrypcji tematu JMS. Może to być jedna z następujących wartości: Durable DurableShared NonDurable NonDurableShared.
NonDurableShared
NonDurableShared
Durable
Durable
DurableShared
DurableShared
NonDurable
NonDurable
targetTransportChain
  • InboundBasicMessaging
  • InboundSecureMessaging
InboundBasicMessagingŁańcuchy transportowe określają protokoły komunikacyjne, których można używać na potrzeby komunikacji z magistralą integracji usług na serwerze pełnego profilu.
InboundBasicMessaging
InboundBasicMessaging
InboundSecureMessaging
InboundSecureMessaging
clientIdstringIdentyfikator klienta JMS wymagany w przypadku trwałych (i współużytkowanych nietrwałych) subskrypcji tematów dla wszystkich połączeń. Identyfikator jest wymagany, jeśli aplikacja wykonuje trwałe (i współużytkowane nietrwałe) przesyłanie komunikatów w trybie publikowania/subskrypcji.
connectionFactoryLookupstringTej właściwości można użyć do określenia nazwy wyszukiwania zdefiniowanego administracyjnie obiektu javax.jms.ConnectionFactory, javax.jms.QueueConnectionFactory lub javax.jms.TopicConnectionFactory używanego do nawiązywania połączenia z dostawcą JMS, z którego punkt końcowy (komponent bean sterowany komunikatami) może odbierać komunikaty.
destinationstringOdwołanie do miejsca docelowego JMS
destinationLookupstringTej właściwości można użyć do określenia nazwy wyszukiwania zdefiniowanych administracyjnie obiektów javax.jms.Queue lub javax.jms.Topic definiujących kolejkę lub temat JMS, z którego punkt końcowy (komponent bean sterowany komunikatami) może odbierać komunikaty.
destinationRefOdwołanie do elementu adminObject najwyższego poziomu (łańcuch).Odwołanie do miejsca docelowego JMS
maxBatchSizeint
Min: 1

Max: 2147483647
Maksymalna liczba komunikatów otrzymywanych z mechanizmu przesyłania komunikatów w pojedynczej partii.
messageSelectorstringSelektor komunikatów JMS używany do określania, które komunikaty są odbierane przez komponent bean sterowany komunikatami. Wartość ta jest łańcuchem używanym w celu wybrania podzbioru dostępnych komunikatów.
remoteServerAddressstringAdres serwera zdalnego w postaci rozdzielonych przecinkami trójek w formacie nazwa_hosta:numer_portu:nazwa_łańcucha, który jest używany do nawiązywania połączenia z serwerem startowym. Przykład: Merlin:7276:BootstrapBasicMessaging. Jeśli nazwa hosta nie zostanie określona, wartością domyślną będzie localhost. Jeśli numer portu nie zostanie określony, wartością domyślną będzie 7276. Jeśli nazwa łańcucha nie zostanie określona, wartością domyślną będzie BootstrapBasicMessaging. Więcej informacji można znaleźć w Centrum informacyjnym.
shareDurableSubscriptionstringOkreśla, czy trwałe subskrypcje mogą być współużytkowane przez połączenia.
subscriptionNamestringNazwa subskrypcji wymagana w przypadku subskrypcji trwałych (i współużytkowanych nietrwałych). To pole jest wymagane w przypadku używania trwałej (i współużytkowanej nietrwałej) subskrypcji tematu. Nazwa subskrypcji musi być unikalna w ramach danego identyfikatora klienta.

properties.wmqJms

Specyfikacja aktywowania JMS produktu WebSphere MQ

NameTypeDefaultDescription
destinationRefOdwołanie do elementu adminObject najwyższego poziomu (łańcuch).Miejsce docelowe
CCSIDint
Min: 1
819Identyfikator kodowanego zestawu znaków dla połączenia.
channelstringSYSTEM.DEF.SVRCONNNazwa kanału MQI, który ma być używany.
cloneSupport
  • DISABLED
  • ENABLED
DISABLEDOkreśla, czy dozwolone jest równoczesne działanie dwóch lub większej liczby instancji tego samego trwałego subskrybenta tematu.
DISABLED
DISABLED
ENABLED
ENABLED
destinationType
  • javax.jms.Queue
  • javax.jms.Topic
javax.jms.QueueTyp miejsca docelowego - javax.jms.Queue lub javax.jms.Topic
javax.jms.Queue
javax.jms.Queue
javax.jms.Topic
javax.jms.Topic
headerCompression
  • SYSTEM
  • NONE
NONELista technik, które mogą być używane do kompresji danych nagłówka w połączeniu.
SYSTEM
SYSTEM
NONE
NONE
hostNamestringlocalhostNazwa hosta lub adres IP systemu, na którym rezyduje menedżer kolejek. Jeśli zostanie podana właściwość ConnectionNameList, zastępuje ona właściwość nazwy hosta i numeru portu.
messageCompression
  • RLE
  • NONE
NONELista technik, które mogą być używane do kompresji danych komunikatu w połączeniu.
RLE
RLE
NONE
NONE
pollingIntervalOkres z dokładnością do milisekundy5sJeśli kolejka żadnego obiektu nasłuchiwania w ramach sesji nie zawiera odpowiedniego komunikatu, jest to maksymalny odstęp czasu (w milisekundach) między kolejnymi próbami pobrania komunikatu z kolejki przez każdy z obiektów nasłuchiwania komunikatów. Jeśli często dochodzi do sytuacji, w której dla żadnego z obiektów nasłuchiwania w ramach sesji nie jest dostępny odpowiedni komunikat, należy rozważyć zwiększenie wartości tej właściwości. Ta właściwość ma zastosowanie tylko wtedy, gdy wartością parametru TRANSPORT jest BIND lub CLIENT. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m), sekundy (s) lub milisekundy (ms). Na przykład określ 500 milisekund jako 500ms. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1s500ms oznacza 1,5 sekundy.
poolTimeoutOkres z dokładnością do milisekundy5mCzas (w milisekundach), przez jaki nieużywana sesja serwera jest przechowywana w puli sesji serwera jako sesja otwarta, zanim zostanie zamknięta z powodu nieaktywności. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m), sekundy (s) lub milisekundy (ms). Na przykład określ 500 milisekund jako 500ms. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1s500ms oznacza 1,5 sekundy.
portint
Min: 1
1414Port, na którym nasłuchuje menedżer kolejek. Jeśli zostanie podana właściwość ConnectionNameList, zastępuje ona właściwość nazwy hosta i numeru portu.
providerVersion
  • unspecified
  • 6
  • 7
unspecifiedWersja, wydanie, poziom modyfikacji i pakiet poprawek menedżera kolejek, z którym aplikacja ma nawiązać połączenie.
unspecified
unspecified
6
6
7
7
rescanIntervalOkres z dokładnością do milisekundy5sGdy konsument komunikatów w domenie typu punkt z punktem używa selektora komunikatów do wybierania komunikatów, które mają być odbierane, w klasach WebSphere MQ classes for JMS odbywa się wyszukiwanie odpowiednich komunikatów w kolejce produktu WebSphere MQ w kolejności określonej przez atrybut MsgDeliverySequence kolejki. Po znalezieniu odpowiedniego komunikatu i dostarczeniu go do konsumenta klasy WebSphere MQ classes for JMS wznawiają wyszukiwanie następnego odpowiedniego komunikatu od bieżącej pozycji w kolejce. Klasy WebSphere MQ classes for JMS przeprowadzają wyszukiwanie w kolejce w ten sposób, aż zostanie osiągnięty koniec kolejki lub upłynie czas określony za pomocą wartości tej właściwości. W obu przypadkach klasy WebSphere MQ classes for JMS wracają do początku kolejki, aby kontynuować wyszukiwanie, a odliczanie czasu rozpoczyna się od nowa. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m), sekundy (s) lub milisekundy (ms). Na przykład określ 500 milisekund jako 500ms. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1s500ms oznacza 1,5 sekundy.
shareConvAllowedbooleantrueOkreśla, czy połączenie klienta może współużytkować gniazdo z innymi połączeniami JMS najwyższego poziomu z tego samego procesu do tego samego menedżera kolejek, jeśli definicje kanału są zgodne.
startTimeoutOkres z dokładnością do milisekundy10sKonfiguruje przedział czasu (w milisekundach), w którym wykonanie musi zostać uruchomione. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m), sekundy (s) lub milisekundy (ms). Na przykład określ 500 milisekund jako 500ms. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1s500ms oznacza 1,5 sekundy.
transportType
  • BINDINGS
  • CLIENT
CLIENTOkreśla, czy połączenie z menedżerem kolejek używa trybu klienta, czy trybu powiązań.
BINDINGS
BINDINGS
CLIENT
CLIENT
failIfQuiescebooleantrueOkreśla, czy wywołania pewnych metod nie powiodą się, jeśli menedżer kolejek będzie w stanie wyciszania.
maxMessagesint
Min: 0
1Maksymalna liczba komunikatów, które można jednocześnie przypisać do sesji serwera. Jeśli w specyfikacji aktywowania ustawione jest dostarczanie komunikatów do komponentu MDB w transakcji XA, niezależnie od ustawienia tej właściwości zostanie użyta wartość 1.
maxPoolDepthint
Min: 0
10Właściwość maxPoolDepth w specyfikacji aktywowania definiuje liczbę dostępnych instancji komponentów MDB (Message Driven Bean). Zmniejszenie wartości tej właściwości powoduje zmniejszenie liczby komunikatów, które mogą być dostarczane współbieżnie.
messageSelection
  • BROKER
  • CLIENT
CLIENTOkreśla, czy wybór komunikatów jest dokonywany przez klasy WebSphere MQ classes for JMS, czy przez broker.
BROKER
BROKER
CLIENT
CLIENT
receiveCCSIDint
Min: 0
0Właściwość miejsca docelowego, która określa docelowy identyfikator kodowanego zestawu znaków na potrzeby konwersji komunikatów menedżera kolejek. Wartość ta jest ignorowana, chyba że właściwość RECEIVECONVERSION ma wartość WMQ_RECEIVE_CONVERSION_QMG.
receiveConversion
  • QMGR
  • CLIENT_MSG
CLIENT_MSGWłaściwość miejsca docelowego, która określa, czy konwersja danych ma być wykonana przez menedżer kolejek.
QMGR
QMGR
CLIENT_MSG
CLIENT_MSG
sslResetCountint
Min: 0

Max: 999999999
0Łączna liczba bajtów wysłanych i odebranych przez połączenie SSL przed ponownym negocjowaniem kluczy tajnych używanych w połączeniu SSL.
cleanupLevel
  • NONDUR
  • FORCE
  • SAFE
  • NONE
  • STRONG
SAFEPoziom czyszczenia dla składnicy subskrypcji opartej na brokerze.
NONDUR
NONDUR
FORCE
FORCE
SAFE
SAFE
NONE
NONE
STRONG
STRONG
sparseSubscriptionsbooleanfalseSteruje strategią pobierania komunikatów obiektu TopicSubscriber.
statusRefreshIntervalOkres z dokładnością do milisekundy1mOdstęp czasu (w milisekundach) między odświeżeniami długotrwałej transakcji wykrywającej moment, w którym subskrybent traci połączenie z menedżerem kolejek. Ta właściwość ma zastosowanie tylko wtedy, gdy wartością parametru subscriptionStore jest QUEUE. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m), sekundy (s) lub milisekundy (ms). Na przykład określ 500 milisekund jako 500ms. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1s500ms oznacza 1,5 sekundy.
subscriptionStore
  • BROKER
  • MIGRATE
  • QUEUE
BROKEROkreśla miejsce, w którym klasy WebSphere MQ classes for JMS przechowują trwałe dane dotyczące aktywnych subskrypcji.
BROKER
BROKER
MIGRATE
MIGRATE
QUEUE
QUEUE
wildcardFormat
  • CHAR
  • TOPIC
TOPICOkreśla wersję składni znaku wieloznacznego, która ma być używana.
CHAR
CHAR
TOPIC
TOPIC
applicationNamestringNazwa, pod którą aplikacja jest zarejestrowana w menedżerze kolejek.
ccdtURLstringAdres URL, który identyfikuje nazwę i położenie pliku zawierającego tabelę definicji kanału klienta oraz określa, w jaki sposób można uzyskać dostęp do tego pliku.
clientIdstringIdentyfikator klienta dla połączenia.
connectionNameListstringLista nazw połączeń TCP/IP w formacie nazwa_hosta(port) używanych do komunikacji. Właściwość ConnectionNameList zastępuje właściwości nazwy hosta i numeru portu.
localAddressstringW przypadku połączenia z menedżerem kolejek ta właściwość określa lokalny interfejs sieciowy, który ma być używany, i/lub port lokalny albo zakres portów lokalnych, który ma być używany.
messageBatchSizeint
Min: 0
Maksymalna liczba komunikatów do przetworzenia w jednej partii.
queueManagerstringNazwa menedżera kolejek, z którym ma zostać nawiązane połączenie.
subscriptionDurability
  • Durable
  • NonDurable
Określa, czy komunikaty mają być dostarczane do komponentu MDB subskrybującego temat w ramach trwałej, czy w ramach nietrwałej subskrypcji.
Durable
Durable
NonDurable
NonDurable
subscriptionNamestringNazwa trwałej subskrypcji
messageRetentionbooleanOkreśla, czy konsument połączenia przechowuje niepożądane komunikaty w kolejce wejściowej.
messageSelectorstringOkreśla, czy wybór komunikatów jest dokonywany przez klasy WebSphere MQ classes for JMS, czy przez broker. Wybór komunikatów przez broker nie jest obsługiwany, jeśli właściwość brokerVersion ma wartość 1.
sslCertStoresstringSerwery Lightweight Directory Access Protocol (LDAP), na których są przechowywane listy odwołań certyfikatów do użycia w połączeniu SSL.
sslCipherSuitestringZestaw algorytmów szyfrowania do użycia dla połączenia SSL.
sslFipsRequiredbooleanOkreśla, czy w połączeniu SSL musi być używany zestaw algorytmów szyfrowania obsługiwany przez dostawcę IBM Java JSSE FIPS (IBMJSSEFIPS).
sslPeerNamestringW przypadku połączenia SSL, szablon, który jest używany do sprawdzania nazwy wyróżniającej w certyfikacie cyfrowym udostępnianym przez menedżer kolejek.
brokerCCDurSubQueuestringNazwa kolejki, z której pobierane są komunikaty nietrwałej subskrypcji dla konsumenta połączenia (obiektu ConnectionConsumer).
brokerCCSubQueuestringNazwa kolejki, z której konsument połączenia odbiera komunikaty nietrwałej subskrypcji.
brokerControlQueuestringNazwa kolejki sterującej brokera
brokerPubQueuestringNazwa kolejki, do której wysyłane są publikowane komunikaty (kolejka strumienia).
brokerQueueManagerstringNazwa menedżera kolejek, w którym działa broker.
brokerSubQueuestringNazwa kolejki, z której konsument nietrwałych komunikatów odbiera komunikaty.
brokerVersion
  • 1
  • 2
Wersja używanego brokera
1
1
2
2
cleanupIntervalOkres z dokładnością do milisekundyOdstęp czasu (w milisekundach) między kolejnymi uruchomieniami w tle programu narzędziowego do czyszczenia publikowania/subskrypcji. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m), sekundy (s) lub milisekundy (ms). Na przykład określ 500 milisekund jako 500ms. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1s500ms oznacza 1,5 sekundy.
receiveExitstringIdentyfikuje program wyjścia odbierania kanału lub sekwencję programów wyjścia odbierania, które mają być uruchamiane jeden po drugim.
receiveExitInitstringDane użytkownika, które są przekazywane do programów wyjścia odbierania kanału podczas ich wywoływania.
securityExitstringIdentyfikuje program wyjścia zabezpieczeń kanału
securityExitInitstringDane użytkownika, które są przekazywane do programu wyjścia zabezpieczeń podczas jego wywoływania.
sendExitstringIdentyfikuje program wyjścia wysyłania kanału lub sekwencję programów wyjścia wysyłania, które mają być uruchamiane jeden po drugim.
sendExitInitstringDane użytkownika, które są przekazywane do programów wyjścia wysyłania kanału podczas ich wywoływania.