
Verbindungsfactory-Eigenschaften für optimierte lokale Adapter in Liberty
Verwenden Sie die WOLA-Eigenschaften (WebSphere Optimized Local Adapters, optimierte lokale WebSphere-Adapter), um eine Verbindungsfactory zu konfigurieren, wenn Sie WOLA in Ihrem Liberty-Server aktivieren.
Zum Aktivieren der optimierten lokalen Adapter unter z/OS müssen Verbindungsfactorys für die Unterstützung eingehender und abgehender Anforderungen konfiguriert werden, obwohl die Verbindungsfactory nur direkt für abgehende Anforderungen verwendet wird. Informationen zum Konfigurieren einer Verbindungsfactory finden Sie unter Liberty-Serverumgebung die Verwendung optimierter lokaler Adapter ermöglichen.
Eigenschaft | Werte | Beschreibung |
---|---|---|
RegisterName | Eine aus 1 bis 12 Zeichen bestehende alphanumerische Zeichenfolge. | Diese Eigenschaft definiert den WOLA-Registrierungsnamen, der für Verbindungen verwendet werden soll, die über die Verbindungsfactory abgerufen werden. |
Username | Zeichenfolge. Weitere Einschränkungen unterstützter Werte richten sich nach der zugeordneten Benutzerregistry. | Diese Eigenschaft definiert eine Benutzer-ID, die die Benutzer-ID überschreibt, die über die Verbindungsfactory gesendet wird. Die Eigenschaft Username wird mit der Eigenschaft Password verwendet, um den Benutzer zu authentifizieren und die entsprechende MVS-Benutzer-ID anzufordern. |
Password | Eine beliebige Zeichenfolge. | Diese Eigenschaft definiert das Kennwort, das mit der Eigenschaft Username zur Authentifizierung des Benutzers verwendet wird. |
LinkTaskTranID | Eine beliebige aus 4 Zeichen bestehende Zeichenfolge. | Wenn Sie einen CICS-Link-Server (Customer Information Control System) verwenden definiert diese Eigenschaft den Namen CICS-Transaktion, die die Link-Task startet, die über die Verbindungsfactory abgesetzte Anforderungen verarbeitet. Diese Eigenschaft überschreibt die Transaktions-ID für die Link-Task, die beim Start des CICS-Link-Servers von der Steuertransaktion (BBOC) angegeben wurde. |
UseCICSContainer | true, false | Wenn Sie einen CICS-Link-Server verwenden, definiert diese Eigenschaft, ob die Ein- und Ausgabenachrichten an das
CICS-Zielprogramm in einem Kommunikationsbereichsobjekt (COMMAREA) oder in einem Containerobjekt (CONTAINER) übergeben werden.
Wenn diese Eigenschaft auf true gesetzt ist, werden die Nachrichten in einem
Containerobjekt übergeben. Wenn diese Eigenschaft auf false gesetzt ist, werden die Nachrichten in einem Kommunikationsbereichsobjekt übergeben.
Anmerkung: Wenn die Ein- und Ausgabenachrichten mit der Schnittstelle "javax.resource.cci.MappedRecord"
angegeben werden, werden die Nachrichten immer in einem Containerobjekt übergeben.
|
LinkTaskReqContID | Eine aus 1 bis 16 Zeichen bestehende Zeichenfolge, die dem in CICS definierten Containernamen entspricht. | Wenn Sie einen CICS-Link-Server verwenden, definiert diese Eigenschaft den Namen des Containerobjekts, das
an das CICS-Programm gesendete Eingabenachrichten enthält. Anmerkung: Um diese Eigenschaft verwenden zu können, muss die Eigenschaft UseCICSContainer auf true gesetzt sein.
|
LinkTaskReqContType | 0, 1 | Wenn Sie einen CICS-Link-Server verwenden, legt diese Eigenschaft fest, ob das Eingabecontainerobjekt als CHAR- oder BIT-Container definiert wird. Wenn diese Eigenschaft auf 0 gesetzt ist, erwartet das Zielprogramm einen CHAR-Container. Wenn diese Eigenschaft auf 1 gesetzt ist, erwartet das Zielprogramm einen BIT-Container. Wenn ein CHAR-Container angefordert wird, wird angenommen, dass die Eingabedaten in der ASCII-Codepage angegeben sind, und die Daten werden bei der Erstellung des Containers in EBCDIC konvertiert. |
LinkTaskRspContID | Eine aus 1 bis 16 Zeichen bestehende Zeichenfolge, die dem in CICS definierten Containernamen entspricht. | Wenn Sie einen CICS-Link-Server verwenden, definiert diese Eigenschaft den Namen des Containers,
der die Ausgabenachricht des CICS-Programms enthält. Anmerkung: Um diese Eigenschaft verwenden zu können, muss die Eigenschaft UseCICSContainer auf true gesetzt sein.
|
LinkTaskRspContType | 0, 1 | Wenn Sie einen CICS-Link-Server verwenden, legt diese Eigenschaft fest, ob der Ausgabecontainer als CHAR- oder BIT-Container definiert ist. Wenn diese Eigenschaft auf 0 gesetzt ist, sendet das Zielprogramm einen CHAR-Container. Wenn diese Eigenschaft auf 1 gesetzt ist, sendet das Zielprogramm einen BIT-Container. Wird ein CHAR-Container angefordert, wird angenommen, dass die Daten des CICS-Programms in der EBCDIC-Codepage angegeben sind, und die Daten werden beim Abrufen der Daten vom Container in ASCII konvertiert. |
LinkTaskChanID | Eine aus 1 bis 16 Zeichen bestehende Zeichenfolge, die dem in CICS definierten Kanalnamen entspricht. | Wenn Sie einen CICS-Link-Server verwenden, definiert diese Eigenschaft den Namen des Kanals,
der die Ein- und Ausgabecontainerobjekte enthält. Anmerkung: Um diese Eigenschaft verwenden zu können, muss die Eigenschaft UseCICSContainer auf true gesetzt sein.
|
LinkTaskChanType | 0, 1 | Wenn Sie einen CICS-Link-Server verwenden, definiert diese Eigenschaft, ob die Ein- und Ausgabecontainerobjekte
als CHAR- oder BIT-Container definiert sind. Wenn diese Eigenschaft
auf 0 gesetzt ist, sendet und empfängt das Zielprogramm
CHAR-Container. Wenn diese Eigenschaft auf 1 gesetzt ist, sendet und empfängt das Zielprogramm BIT-Container. Wenn ein CHAR-Container angefordert wird, wird angenommen, dass die Eingabedaten in der ASCII-Codepage
angegeben sind, und die Daten
werden bei der Erstellung der Container in EBCDIC konvertiert. Ebenso
wird angenommen, dass die Daten des CICS-Programms in der
EBCDIC-Codepage angegeben sind, und die Daten werden beim Abrufen der Daten von den Containern in ASCII
konvertiert. Anmerkung: Verwenden Sie diese Eigenschaft nur, wenn die Ein- und Ausgabenachrichten mit der Schnittstelle "javax.resource.cci.MappedRecord"
angegeben werden.
|
ConnectionWaitTimeout | Eine ganze Zahl zwischen 0 und 2147483647. | Diese Eigenschaft definiert die maximale Anzahl an Sekunden, die eine Anforderung darauf wartet, dass ein
Servicename verfügbar wird. Der Servicename
wird in Interaktionsobjekten in Verbindungen angegeben, die über die Verbindungsfactory
angefordert werden. Wenn der Servicename nach Verstreichen der angegebenen Anzahl an Sekunden nicht verfügbar ist,
wird eine Ausnahme vom Typ "javax.resource.ResourceException" ausgegeben.
Wird diese Eigenschaft auf 0 gesetzt, wird der Zeitgeber inaktiviert. Der Standardwert für diese Eigenschaft ist 30. |
OTMAGroupID | Zeichenfolge aus 1 bis 8 Zeichen, die mit dem IMS-XCF-Gruppennamen übereinstimmt, der mit IMS definiert ist. | Wenn Sie IMS (IBM Information Management System) verwenden, definiert diese Eigenschaft den Gruppennamen, den die IMS-Region verwendet, um eine Verbindung zur XCF-Funktion (Cross-System Coupling-Facility) herzustellen. Der Wert muss mit dem im IMSPBxxx-PROCLIB-Member für den Parameter mit dem Namen GRNAME deklarierten Wert übereinstimmen. |
OTMAServerName | Zeichenfolge aus 1 bis 16 Zeichen, die mit dem IMS-XCF-Systemnamen übereinstimmt, der mit IMS definiert ist. | Wenn Sie IMS (IBM Information Management System) verwenden, definiert diese Eigenschaft den Systemnamen, den die IMS-Region verwendet, um eine Verbindung zur XCF-Funktion (Cross-System Coupling-Facility) herzustellen. Der Wert muss mit dem im IMSPBxxx-PROCLIB-Member für den Parameter mit dem Namen OTMANM deklarierten Wert übereinstimmen. |
OTMAClientName | Zeichenfolge aus 1 bis 16 alphanumerischen Zeichen, einschließlich nationalen Sonderzeichen. Nimmt standardmäßig den Wert der Zeichenfolge DEFAULT ein. | Wenn Sie IMS (IBM Information Management System) verwenden, definiert diese Eigenschaft den Systemnamen, den der Liberty-Server verwendet, um eine Verbindung zur XCF-Funktion (Cross-System Coupling-Facility) herzustellen. Der Wert muss innerhalb der XCF-Gruppe eindeutig sein, die von der IMS-Region, zu der Sie eine Verbindung herstellen, verwenden. |
OTMASyncLevel | 0, 1 | Wenn Sie IMS (IBM Information Management System) verwenden, steuert diese Eigenschaft die Synchronisationsebene, die zum Senden von Nachrichten an und aus IMS verwendet wird. Der Wert 0 verwendet die Synchronisationsebene NONE und der Wert 1 verwendet die Synchronisationsebene CONFIRM. |
OTMAMaxSegments | Eine ganze Zahl zwischen 0 und 2147483647. | Wenn Sie IMS (IBM Information Management System) verwenden, steuert diese Eigenschaft die maximale Anzahl von Segmenten, die in einer Antwortnachricht enthalten sein dürfen. Der Standardwert ist 1. |
OTMAMaxRecvSize | Eine ganze Zahl zwischen 0 und 2147483647. | Wenn Sie IMS (IBM Information Management System) verwenden, steuert diese Eigenschaft die maximale Anzahl von Bytes, die in einer Antwort enthalten sein dürfen. Der Standardwert ist 32768. |
OTMARequestLLZZ | 0, 1 | Wenn Sie IMS (IBM Information Management System) verwenden, steuert diese Eigenschaft das Format der Anforderungsnachricht, die an IMS gesendet wird. Der Wert 1 (Standardwert) gibt an, dass die Anforderung mit dem Headerformat LLZZ beginnt. Der Wert 0 gibt an, dass die Anforderung mit einem LLLLZZ-Header beginnt. |
OTMAResponseLLZZ | 0, 1 | Wenn Sie IMS (IBM Information Management System) verwenden, steuert diese Eigenschaft das Format der Antwortnachricht, die von IMS empfangen wird. Der Wert 1 gibt an, dass die Antwort mit dem Headerformat LLZZ beginne. Der Wert 0 (Standardwert) gibt an, dass die Anforderung mit dem LLLLZZ-Header beginnt. |