zosConnectService - Koncový bod z/OS Connect (zosConnectService)

Definuje nastavení konfigurace koncového bodu služby.

NameTypeDefaultDescription
idřetězecJedinečné ID konfigurace.
serviceNamestringNázev, který je přidružený ke koncovému bodu služby. Tento název identifikuje koncový bod služby pro klienta.
serviceRefOdkaz na prvek nejvyšší úrovně localAdaptersConnectService (řetězec).Referenční název, který identifikuje koncový bod služby registrovaný v produktu z/OS Connect.
serviceDescriptionstringPopis, který je přidružený ke koncovému bodu služby.
serviceGroupingNamestringNázev, který lze použít k seskupení či vzájemnému přidružení sady koncových bodů služeb.
runGlobalInterceptorsbooleantrueUdává, zda se mají pro požadavky přidružené ke koncovému bodu služby spouštět globální zachytávače. Standardně z/OS Connect zpracovává všechny globální zachytávače i zachytávače specifických koncových bodů služeb.
invokeURIstringIdentifikátor URI nebo seznam identifikátorů URI oddělených čárkami, který se má přidružit ke koncovému bodu služby. Identifikátory InvokeURI mohou končit zástupným znakem ve formě /a/b/* nebo x/y*, které genericky určí vyvolání koncového bodu služby. Zadání více zástupných znaků (tj. /a/b/**) nebo zadání zástupných znaků uprostřed identifikátoru requestURI (tj. /a/*/c) podporováno není. Pokud jsou koncové body služeb s nakonfigurovanými identifikátory invokeURI používajícími zástupné znaky přidružené k identifikátorům invokeURI, které se navzájem překrývají, použije se koncový bod služby, jemuž odpovídá nejspecifičtější identifikátor invokeURI. Pokud je například vydán požadavek na koncový bod služby s https://host:port/a/b/c směřující na server s touto konfigurací: service1 -> invokeURI="/a/b/c/*" and service2 -> invokeURI="/a/b/*", přiřadí z/OS Connect tento požadavek ke službě service1. Nakonfigurované identifikátory invokeURI musí začínat znakem /. Použití identifikátoru invokeURI je ekvivalentem požadavku na službu, kde je určen parametr dotazu action=invoke.
adminGroupstringNázev administrativní skupiny, která je přidružena ke koncovému bodu služby. Jedná se o název skupiny zabezpečení, jejímž členem musí uživatel být, aby mu byly povoleny administrativní funkce. Pokud je zároveň nakonfigurován jeho globální protějšek, atribut globalAdminGroup definovaný v prvku zosConnectManager, použije se hodnota definovaná pro adminGroup.
operationsGroupstringNázev skupiny operací, která je přidružena ke koncovému bodu služby. Jedná se o název skupiny zabezpečení, jejímž členem musí uživatel být, aby měl povoleny operace jako spustit, zastavit nebo stav. Pokud je zároveň nakonfigurován jeho globální protějšek, globalOperationsGroup definovaný v prvku zosConnectManager, použije se hodnota definovaná pro operationsGroup.
invokeGroupstringNázev skupiny vyvolání, která je přidružena ke koncovému bodu služby. Obsahuje název skupiny zabezpečení, jejímž členem musí uživatel být, aby mohl volat vyvolání. Pokud je zároveň nakonfigurován jeho globální protějšek, atribut globalInvokeGroup definovaný v prvku zosConnectManager, použije se hodnota definovaná pro InvokeGroup.
dataXformRefOdkaz na prvek nejvyšší úrovně zosConnectDataXform (řetězec).Referenční název, který identifikuje obslužnou rutinu transformací dat přidruženou ke koncovému bodu služby. Pokud je zároveň nakonfigurována i globální obslužná rutina transformace dat globalDataXformRef definovaná v prvku zosConnectManager, použije se transformátor dat definovaný pro daný koncový bod služby.
serviceAsyncRequestTimeoutČasové období s přesností na milisekundyHodnota časového limitu, která je při zpracování asynchronní práce přidružena ke koncovému bodu služby. Určuje dobu v milisekundách, v jejímž průběhu musí být dokončeny požadavky. Tato hodnota časového limitu potlačuje hodnotu atributu asyncTimeoutDefault webového kontejneru. Pokud není nakonfigurován atribut asyncRequestTimeout ani asyncTimeoutDefault, použije se jako časový limit výchozí hodnota atributu asyncTimeoutDefault (tj. 30 sekund). Pokud není nakonfigurován atribut asyncRequestTimeout, ale atribut asyncTimeoutDefault ano, použije se nakonfigurovaná hodnota atributu asyncTimeoutDefault. Pokud je zároveň nakonfigurován jeho globální protějšek, asyncRequestTimeout definovaný v prvku zosConnectManager, použije se hodnota definovaná pro serviceAsyncRequestTimeout. K uplynutí časového limitu může dojít kdykoli v průběhu zpracování požadavku produktem z/OS Connect. Po zjištění uplynutí časového limitu a odeslání odezvy klientovi může být požadavek nadále aktivní. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m), sekunda (s) nebo milisekunda (ms). Například 500 milisekund zadejte jako 500ms. Do jedné položky můžete zahrnout více hodnot. Například 1s500ms je ekvivalentní 1,5 sekundy.
requireSecurebooleanOznačuje, zda musí být požadavky přidružené ke koncovému bodu služby provedeny pomocí zabezpečeného kanálu HTTPS. Pokud je zároveň nakonfigurován jeho globální protějšek requireSecure definovaný v prvku zosConnectManager, použije se hodnota definovaná pro koncový bod služby.
requireAuthbooleanOznačuje, zda musí uživatelé zadat pověření zabezpečení, aby mohl produkt z/OS Connect zpracovat požadavky přidružené ke koncovému bodu služby. Pokud je zároveň nakonfigurován jeho globální protějšek requireAuth definovaný v prvku zosConnectManager, použije se hodnota definovaná pro koncový bod služby.

interceptorsRef

Referenční název, jenž identifikuje sadu nakonfigurovaných zachytávačů, která je přidružena ke koncovému bodu služby. Pokud je zároveň nakonfigurován jeho globální protějšek pro zachytávače globalInterceptorsRef definovaný v prvku zosConnectManager, zpracuje z/OS Connect obě sady zachytávačů. Pokud je atribut runGlobalInterceptors pro daný koncový bod služby nastaven na hodnotu false, zpracuje z/OS Connect pouze sadu zachytávačů nakonfigurovanou pro tento koncový bod služby.