Konfigurieren des BizTalk-Adapters für Hostanwendungen
Im Dialogfeld BizTalk Adapter Bor Host Application Configuration können Sie Verbindungen zu Remote- IBM CICS-, IMS- oder iSeries-Systemen definieren und verwalten. Es wird gestartet, wenn Sie auf das Feld für den Eigenschaftswert Verbindungszeichenfolgen klicken. Sie können das Dialogfeld BizTalk-Adapter für die Host-Anwendungskonfiguration verwenden, um eine TI.NET-Assembly hinzuzufügen. Sie können es als Teil des Mappings verwenden, um Mappings zu importieren, zu exportieren und zu löschen, Verbindungszeichenfolgen zu bearbeiten und die Eigenschaften einer TI .NET Assembly anzuzeigen.
Die Komponenten des Dialogfelds Hostanwendungskonfiguration enthalten eine Symbolleiste, ein Menü, ein Datenraster und einen Ergebnisbereich. Dieses Thema enthält die folgenden Abschnitte, in denen die verschiedenen Aufgaben beschrieben werden, die Sie ausführen können.
Befehle für Symbolleiste und Menü
Erstellen und Verwalten von Mappings
Einstellungen für Verbindungszeichenfolgen und Mappings
Aktualisierung von früheren Versionen des Host Integration Servers
Symbolleiste und Menübefehle
Sie können anhand der Symbolleisten und kontextsensitiven Menüs auf Befehle zum Erstellen und Verwalten von Verbindungszeichenfolgen zugreifen. Sie können mit der rechten Maustaste auf eine beliebige Stelle im Datenraster klicken, um kontextabhängige Menüs aufzurufen. Wenn Sie z. B. mit der rechten Maustaste auf eine Verbindungszeichenfolge klicken, können Sie Mappings anzeigen, bearbeiten, löschen, importieren und exportieren. Sie können einen Doppelklick auf die Verbindungszeichenfolge ausführen, um sie im Bearbeitungsmodus aufzurufen. Die LÖSCHEN-Taste löscht das aktuell ausgewählte Element, und die F1-Taste ruft die Online-Hilfe auf.
Die folgende Liste beschreibt die Aktionen, die Sie ausführen können:
Fügen Sie eine TI .NET-Assembly aus dem globalen Assembly-Cache (GAC) oder über den lokalen Dateipfad zum Mapping hinzu. Die Spalten werden mit den Standardwerten aufgefüllt, die von der Assembly widergespiegelt werden. Die Standardverbindungszeichenfolge ist nicht verwendbar, wenn Sie die erforderlichen Werte nicht eingeben.
Die ausgewählten Mappings löschen. Es erscheint ein Dialogfeld zur Bestätigung des Löschvorgangs.
Bearbeiten Sie den Verbindungszeichenfolgen-Teil des Mappings, wenn ein Mapping ausgewählt ist. Öffnen Sie das Dialogfeld Verbindungszeichenfolge, um die Verbindungszeichenfolge zu bearbeiten.
Der Export von Mappings zu XML ermöglicht das Sichern von Mappings. Sie können sie später anhand der Mapping-Import-Funktion wiederherstellen. Anhand den Import/Export-Funktionen können Sie Mappings zwischen den Endpunkten teilen.
Mappings oder REs importieren ermöglicht den Import von XML, das vom Dialogfeld BizTalk Adapter für die Host-Anwendungskonfiguration exportiert wurde. Sie können auch RE-Definitionen importieren, die vom TI-Manager exportiert werden, wenn ein Mapping ausgewählt ist.
TI .NET Assembly-Eigenschaften anzeigen zeigt die Eigenschaften der Assembly an. Das XML-Tag zeigt den Namen des Eingangs-/Ausgangsdokuments an, das von dieser Assembly unterstützt wird. Der Methodenname ist Teil des Tag-Namens, wird aber bei der Suche nach einem Mapping nicht verwendet. Alle Eigenschaften sind schreibgeschützt.
Mapping-Datenraster-Fenster
Das Mapping Datenraster-Dialogfeld enthält die folgenden Elemente:
Zustand (vollständig oder unvollständig). Wenn in der Verbindungszeichenfolge Verbindungsinformationen fehlen, erscheint eine Warnung, die anhand eines roten Kreises mit einem weißen Ausrufezeichen angezeigt wird. Nachdem die fehlenden Informationen hinzugefügt wurden, verschwindet die Warnung.
ClassName und Schnittstellen-Namen der TI-Assembly, die als Teil des Mappings verwendet werden.
Name der Assembly. Der starke Name der Assembly, wenn die Assembly aus dem GAC geladen wird, oder der vollständige Pfad zur Assembly, wenn es sich um eine lokale Assembly handelt. Dieses Feld wird automatisch ausgefüllt, wenn eine Assembly hinzugefügt wird, und ist schreibgeschützt.
Remote-Umgebung definiert die Verbindungszeichenfolge. Dies stellt die Eigenschaften eines Remote-Systems dar, das Anforderungen vom BizTalk-Hostanwendungsadapter erhält. Die Verbindungszeichenfolge besteht aus dem Typ der Remote-Umgebung, dem Programmiermodell, der Identifikation des Remote-Hosts, dem Netzwerktransport und anderen Einstellungen, die bei der Kommunikation mit dem Remote-Host verwendet werden.
Remote-Endpunkt DNS-Name oder IP-Adresse des Remote-IBM-Hosts.
Im Ergebnisbereich werden die Werte für die Verbindungszeichenfolge des aktuell ausgewählten Mappings angezeigt.
Erstellen und Verwalten von Mappings
In diesem Abschnitt werden Aufgaben beschrieben, die Sie durchführen können.
Fügen Sie Assemblys hinzu, um eine Verbindungszeichenfolge zu erstellen
Klicken Sie auf der Symbolleiste auf das Ordnersymbol, und wählen Sie dann Assemblys aus GAC hinzufügen oder Lokale Assembly hinzufügenaus. Assemblys aus GAC hinzufügen startet ein Dialogfeld, in dem alle Assemblys im GAC aufgelistet sind, die Sie auswählen können. Wenn Sie Lokale Assembly hinzufügenauswählen, können Sie die lokal installierten Assemblys durchsuchen.
Assemblys können auch anhand der Optionen GAC hinzufügen oder lokale Assemblys hinzufügen aus dem Menü hinzugefügt werden.
Löschen einer Verbindungszeichenfolge
Wählen Sie das(die) zu löschende(n) Mapping(s) aus. Klicken Sie auf der Symbolleiste auf das Symbol [X], um die ausgewählten Mappings zu löschen. Es wird ein Dialogfeld angezeigt, in dem Sie den Löschvorgang bestätigen können.
Sie können Mappings auch anhand der Option Mappings löschen im Menü löschen.
Verbindungszeichenfolge bearbeiten
Die Verbindungszeichenfolge wird verwendet, um die RE-Instanz zu hydratisieren. Sie wird mit Standardwerten aufgefüllt, wenn eine Assembly angegeben wird. Doppelklicken Sie auf das ausgewählte Mapping, wählen Sie Bearbeitenaus, oder wählen Sie das Menü Verbindungszeichenfolge bearbeiten aus, um das Dialogfeld Verbindungszeichenfolge zu öffnen. Hiermit können Sie die Verbindungszeichenfolge für die angegebene RE bearbeiten. Wenn die erforderlichen Werte nicht eingegeben werden, wird ein Fehlerkennzeichen angezeigt.
Das RE-Objekt validiert die minimal erforderlichen Eigenschaftswerte. Die Zelle Verbindungszeichenfolge wird gekennzeichnet, wenn die erforderlichen Eigenschaftswerte nicht festgelegt sind. Die erforderlichen Eigenschaften sind im Abschnitt Einstellungen und Mappings der Verbindungszeichenfolge in diesem Thema aufgeführt. Die RE-Überprüfung ist im Gültigkeitsbereich eingeschränkt, und unzulässige Werte können zu TI-Laufzeitfehlern führen.
Das Dialogfeld zeigt editierbare und nicht editierbare Eigenschaften in einem Raster an. Das schreibgeschützte Textfeld am unteren Rand zeigt die Verbindungszeichenfolge an, die auf der Grundlage der im Eigenschaftsraster eingegebenen Werte erstellt wird. Eigenschaften werden auf der Grundlage der vom RE-Objekt definierten öffentlichen Methoden gesammelt, wobei die Werte vom Objekt selbst definiert werden. Einige Typkonverter und Eigenschaftseditoren werden bereitgestellt, um die Bearbeitung von Eigenschaftswerten zu erleichtern.
Die Remote-Umgebung zeigt Eigenschaften an, die für die Verbindung mit dem Host erforderlich sind. Diese sind in der Eigenschaftsraster mit einem Sternchen (*) gekennzeichnet. Wenn eine oder mehrere Eigenschaften fehlen, wird im Datenraster ein roter Kreis mit einem weißen Ausrufezeichen angezeigt. Diese Warnung weist Sie darauf hin, dass die fehlenden Eigenschaften anhand der Verwendung von Außerkraftsetzungen zum Zeitpunkt der Ausführung bereitgestellt werden können.
Die Sicherheitseinstellungen werden durch vordefinierte Sicherheitsaufzählungen gesteuert, die mit dem OR-Operator kombiniert werden können, um neue Sicherheitseinstellungen zu erstellen.
Das Aus-Banner ist ausschließlich für den Client, das Package und den Anwender verfügbar. Aus wird deaktiviert, sobald jegliche der anderen drei markiert wurden. Sobald Aus markiert wird, werden alle anderen drei Optionen gelöscht.
Der SSO-Anwendungseditor wurde aus einer früheren Version mit geringfügigen Änderungen übertragen. Sie können eine verbundene Anwendung direkt im Eigenschaftsraster angeben oder mit dem Editor eine bereits erstellte auswählen.
Verbindungszeichenfolgen-Einstellungen und Mappings
In den folgenden Tabellen werden die unterstützten Eigenschaften angezeigt, welche die Hostumgebung und das Programmiermodell definieren. Die erforderlichen Eigenschaften werden mit Sternchen gekennzeichnet.
Die Standardwerte werden von den RE-Objekten selbst definiert, und es wird eine begrenzte Validierung durchgeführt.
SNA Anwenderdaten
| Eigenschaft | Wert |
|---|---|
| Eigenschaft | Wert |
| CodePage | 37 |
| Gebietsschema | 1033 |
| **LocalLUName* | |
| **ModeName* | PA62TKNU |
| Name | SNAUserData. Schreibgeschützt. |
| **RemoteLUName* | |
| Security | Aus |
| SSOAnwendung | |
| SynLevel2Supported | False |
| TimeOut | 0 |
*Pflichtfeld.
SNA-Link
| Eigenschaft | Wert |
|---|---|
| Eigenschaft | Wert |
| AdministrationFlags | 0 |
| CodePage | 37 |
| Gebietsschema | 1033 |
| **LocalLUName* | |
| MirrorTranId | CSMI |
| **ModeName* | PA62TKNU |
| Name | SNALink. Schreibgeschützt. |
| **RemoteLUName* | |
| Security | Aus |
| SSOAnwendung | |
| SyncLevel2Supported | False |
| TimeOut | 0 |
*Pflichtfeld.
HTTP-Anwenderdaten
| Eigenschaft | Wert |
|---|---|
| Eigenschaft | Wert |
| AliasTransactionId | |
| AllowRedirects | False |
| CodePage | 37 |
| **HttpPort* | |
| **Ipaddress* | |
| Gebietsschema | 1033 |
| Name | HttpUserData. Schreibgeschützt. |
| Security | Aus |
| SSOAnwendung | |
| TimeOut | 0 |
| UserAgent | |
| UseSsl | False |
*Pflichtfeld.
HTTP-Link
| Eigenschaft | Wert |
|---|---|
| Eigenschaft | Wert |
| AliasTransactionId | |
| AllowRedirects | False |
| CodePage | 37 |
| Converter | |
| **HttpPort* | |
| **Ipaddress* | |
| Gebietsschema | 1033 |
| MirrorProgramName | |
| Name | HttpLink. Schreibgeschützt. |
| Security | Aus |
| SSOAnwendung | |
| TimeOut | 0 |
| UseConverter | False |
| UserAgent | |
| UseSsl | False |
*Pflichtfeld.
IMS LU6.2
| Eigenschaft | Wert |
|---|---|
| Eigenschaft | Wert |
| CodePage | 37 |
| Gebietsschema | 1033 |
| **LocalLUName* | |
| **ModeName* | PA62TKNU |
| Name | IMSLU62. Schreibgeschützt. |
| **RemoteLUName* | |
| Security | Aus |
| SSOAnwendung | |
| TimeOut | 0 |
*Pflichtfeld.
IMS Connect
| Eigenschaft | Wert |
|---|---|
| Eigenschaft | Wert |
| CodePage | 37 |
| ImsFormatModName | |
| **Ipaddress* | |
| ItocExitName | |
| Gebietsschema | 1033 |
| Name | IMSConnect. Schreibgeschützt. |
| OtmaSystemId | |
| Security | Aus |
| SSOAnwendung | |
| **TCPPorts* | |
| TimeOut | 0 |
*Pflichtfeld.
TRM-Anwenderdaten/-Link
| Eigenschaft | Wert |
|---|---|
| Eigenschaft | Wert |
| CodePage | 37 |
| ConcurrentServerTransactionId | MSCS |
| **Ipaddress* | |
| Gebietsschema | 1033 |
| Name | TRMUserData. Schreibgeschützt. |
| Security | Aus |
| SSOAnwendung | |
| **TCPPorts* | |
| TimeOut | 0 |
*Pflichtfeld.
TRM-Anwenderdaten/-Link
| Eigenschaft | Wert |
|---|---|
| Eigenschaft | Wert |
| CodePage | 37 |
| **Ipaddress* | |
| Gebietsschema | 1033 |
| Name | ELMUserData. Schreibgeschützt. |
| Security | Aus |
| SSOAnwendung | |
| **TCPPorts* | |
| TimeOut | 0 |
*Pflichtfeld.
Verteilter Programmaufruf
| Eigenschaft | Wert |
|---|---|
| Eigenschaft | Wert |
| CodePage | 37 |
| **Ipaddress* | |
| Gebietsschema | 1033 |
| Name | DistributedProgramCall. Schreibgeschützt. |
| Security | Aus |
| SSOAnwendung | |
| **TCPPorts* | |
| TimeOut | 0 |
*Pflichtfeld.
System Z Sockets Anwenderdaten/Link
| Eigenschaft | Wert |
|---|---|
| Eigenschaft | Wert |
| CodePage | 37 |
| **Ipaddress* | |
| Gebietsschema | 1033 |
| Name | SystemzSocketsAnwenderDaten. Schreibgeschützt. |
| Security | Aus |
| SSOAnwendung | |
| **TCPPorts* | |
| TimeOut | 0 |
*Pflichtfeld.
System-I Sockets-Anwenderdaten
| Eigenschaft | Wert |
|---|---|
| CodePage | 37 |
| **Ipaddress* | |
| Gebietsschema | 1033 |
| Name | SystemSocketAnwenderDaten. Schreibgeschützt. |
| Security | Aus |
| SSOAnwendung | *TCPPorts |
| TimeOut | 0 |
*Pflichtfeld.
Mappings-Import
Um Mappings zu importieren, die vom BizTalk-Adapter für die Hostanwendungskonfiguration exportiert wurden, klicken Sie auf das Symbol Mappings oder REs importieren. Wählen Sie Mappings importieren, oder wählen Sie Mappings importieren aus dem Datei-Menü aus. Sie können dann nach dem XML suchen, das vom Dialogfeld BizTalk Adapter für die Host-Anwendungskonfiguration exportiert wurde. Auswählen der zu importierenden Datei. Der Importvorgang überschreibt keine bestehenden Mappings.
Import der RE-Definition
Verwenden Sie diese zum Importieren von RE-Definitionen, die vom TI-Manager exportiert wurden. Wenn eine Mapping ausgewählt ist, klicken Sie auf das Symbol Mapping oder REs importieren. Wählen Sie REs importieren oder wählen Sie REs importierenaus dem Dateimenü aus. Sie können dann nach dem vom TI-Manager exportierten XML-Code suchen. Ein Dialogfeld wird angezeigt, in dem die RE-Definitionen aufgeführt sind, die Sie auswählen können. Es werden nur RE-Definitionen angezeigt, die das gleiche Programmmodell wie das ausgewählte Mapping aufweisen.
Mappings exportieren
Um Mappings zu einer XML-Datei zu exportieren, klicken Sie auf das Symbol Mappings zu XML exportieren oder wählen Sie Mappings exportieren aus dem Dateimenü aus. Sie können dann zu dem Speicherort navigieren, an dem die Datei gespeichert werden kann. Sie können diese Datei anhand der Mapping-Import-Funktion importieren.
Assembly-Eigenschaften
Sie können relevante Eigenschaften der Assembly sowie den XML-Tag-Namen des Eingangs-/Ausgangsdokuments anzeigen, das von diesem Assembly unterstützt wird. Der Methodenname ist Teil des Tag-Namens, wird aber bei der Suche nach einem Mapping nicht verwendet. Alle Eigenschaften sind schreibgeschützt. Wählen Sie das Mapping aus und klicken Sie dann auf das Symbol für die Assembly-Eigenschaften oder wählen Sie im Menü die Option Assembly-Eigenschaften anzeigen aus.
Aktualisierung von früheren Versionen des Host Integration Servers
In diesem Abschnitt wird beschrieben, wie Sie vorhandene BAHA-Anwendungen zur Verwendung der Verbindungszeichenfolge migrieren:
Wenn Standard-RE in BAHA verwendet wurde, exportieren Sie die Konfiguration anhand des TI-Managers, und importieren Sie die Konfiguration dann anhand des Dialogfelds Verbindungszeichenfolgen.
Wenn nicht-standardmäßige RE verwendet wurde, ordnen Sie das Bereitstellungsobjekt dem neuen RE im TI-Manager zu, und exportieren Sie die Konfiguration zum TI-Manager. Importieren Sie die Konfiguration anhand des Dialogfelds Verbindungszeichenfolgen.
Sie können REs in BizTalk Server Administration nicht auswechseln, ohne die Verbindungszeichenfolge zu verwenden, da das Dialogfeld Hosttyp entfernt wurde.
RE-Overrides über die BizTalk Server-Verwaltung wird nicht unterstützt. Obwohl Sie den Nachrichtenkontext verwenden können, um den RE-Override zu erzielen, wird dies nicht empfohlen. Wir empfehlen die Verwendung von Verbindungszeichenfolgen.
Wenn eine nicht standardmäßige SSO-Anwendung angegeben wird, können Sie den TI-Manager verwenden, um die RE der nicht-standardmäßigen SSO-Anwendung zuzuordnen und weiterhin statisches RE zu verwenden. Alternativ können Sie es auch in der Verbindungszeichenfolge angeben.
Importieren von vom TI-Manager exportierten XML
DER TI-Manager ist nur erforderlich, wenn Sie eine Migration ausführen. Sie können die Definition von REs und WIP-Objekten in eine XML-Datei exportieren, die über das Dialogfeld Verbindungszeichenfolgen importiert werden kann.
Warnung
Bei TI .NET Assemblys, die in Mappings verwendet werden, muss die Include Context Parameter-Eigenschaft auf True gesetzt sein, andernfalls schlägt der TI-Methodenaufruf zur Ausführungszeit fehl.
Der BizTalk-Adapter für die Hostanwendungskonfiguration verwendet die dynamische RE-Funktion, die im Host Integration Server 2009 eingeführt wurde. Bei dynamischen RE können die von der TI-Ausführungszeit benötigten Host-Informationen kurz vor dem Methodenaufruf angegeben werden, sofern die Host-Verbindungsinformationen bekannt sind. Die .NET-Client-Assembly muss nicht bereitgestellt und einer vordefinierten RE im TI-Manager zugeordnet werden, bevor ihre Methoden aufgerufen werden können.
Für BAHA kann die Verbindungsinformation in eine Verbindungszeichenfolge integriert werden, die analysiert und auf das RE-Objekt festgelegt wird, das zur Ausführungszeit erstellt wird. Informationen zu einer RE können angegeben werden, wenn der Port konfiguriert ist, der den Hostanwendungsadapter hostet. Sie werden als Teil der Port-Einstellungsinformationen gespeichert, die von der BizTalk-Anwenderverwaltung verwaltet werden. Bei diesem Ansatz, bei dem BAHA zur Integration von .NET-Anwendungen mit Host-Anwendungen verwendet wird, müssen Sie lediglich den TI-Designer verwenden, um die TI .NET-Client-Assemblys zu erstellen. Alle anderen Aufgaben können im BizTalk Server erledigt werden.
Die folgende Tabelle beschreibt die Menüs und Aktionen der Symbolleiste.
| Toolleiste/Menü | Aktionen |
|---|---|
| Fügen Sie Assemblys hinzu, um eine Verbindungszeichenfolge zu erstellen | Fügen Sie eine TI .NET-Assembly entweder aus dem GAC oder über den lokalen Dateipfad zum Mapping hinzu. Alle Spalten werden mit den aus der Assembly übernommenen Standardwerten aufgefüllt. Die Standard-Verbindungszeichenfolge ist nicht verwendbar, wenn Sie einige der erforderlichen Werte nicht eingeben. |
| Löschen einer Verbindungszeichenfolge | Löscht die ausgewählten Mappings. Ein Dialogfeld wird zur Bestätigung des Löschvorgangs angezeigt. |
| Bearbeiten der Verbindungszeichenfolge | Bearbeiten Sie den Verbindungszeichenfolgen-Teil des Mappings. Wenn eine Mapping ausgewählt ist, rufen Sie das Verbindungszeichenfolge-Dialogfeld auf, um die Verbindungszeichenfolge zu bearbeiten. |
| Exportieren von Mappings zu XML | Der Export ermöglicht das Sichern von Mappings. Mappings können zu einem späteren Zeitpunkt anhand der Funktion Mapping-importieren importiert werden. Die Import/Export-Features bieten eine erleichterte Freigabe von Mappings zwischen den Endpunkten. |
| Mappings oder REs importieren | Wird verwendet, um XML zu importieren, das vom Dialogfeld BizTalk-Adapter für die Hostanwendungskonfiguration exportiert wurde. Wird auch verwendet, um RE-Definitionen zu importieren, die von TI Manager exportiert wurden, wenn eine Mapping ausgewählt ist. |
| Die Eigenschaften der TI-.NET-Assembly anzeigen | Zeigt die relevanten Eigenschaften der Assembly und den XML-Tag-Namen des Eingangs-/Ausgangsdokuments an, das von dieser Assembly unterstützt wird. Der Methodenname ist Teil des Tag-Namens, wird aber bei der Suche nach einem Mapping nicht verwendet. Alle Eigenschaften sind schreibgeschützt. |