'location' im Element 'callLink'
Die Eigenschaft location im Element callLink im Verbindungsoptionsabschnitt gibt an, wie die Position eines aufgerufenen Programms während der Ausführung bestimmt wird. Die Eigenschaft location betrifft die Generierung des aufrufenden Programms. Die Eigenschaft location ist in folgenden Situationen anwendbar:
- Der Wert der Eigenschaft type lautet 'ejbCall' oder remoteCall;
- Der Wert der Eigenschaft remoteComType lautet CICSECI, CICSSSL, CICSJ2C, DIRECT, DISTINCT, IMS2J2C, IMSTCP, JAVA400, JCICS oder TCPIP.
- Wenn Sie einen Java™-Wrapper generieren, bezieht sich pgmName auf ein Programm, das mithilfe des Java-Wrappers aufgerufen wird.
Wählen Sie den Wert aus dieser Liste aus:
- PROGRAMCONTROLLED
- Gibt an, dass die Position des aufgerufenen Programms von der Systemfunktion sysVar.remoteSystemID abgerufen wird, wenn der Aufruf erfolgt.
- system name
- Gibt die Position an, an der sich das aufgerufene Programm befindet. Falls Sie ein CICS-COBOL-Programm generieren, gelten die folgenden Regeln für den Systemnamen:
- Sie können den Namen der Verbindungsdefinition angeben, der die folgenden Merkmale aufweist:
- Der Name ist in der CICS-Region installiert, in der das aufrufende Programm ausgeführt wird. UND
- Der Name definiert die Verbindung mit der CICS-Region, in der das aufgerufene Programm ausgeführt wird.
- Wenn Sie weder den Wert PROGRAMCONTROLLED noch eine Verbindungsdefinition angeben, wird die Position des aufgerufenen Programms mithilfe des Eintrags für das aufgerufene Programm in der PPT (CICS Processing Program Table) oder im Eintrag RDO PROGRAM bestimmt.
Wenn Sie ein Java-Programm oder einen Wrapper generieren, hängt die Bedeutung der Eigenschaft location auf folgende Weise von der Eigenschaft remoteComType ab:
- Wenn der Wert der Eigenschaft remoteComType JAVA400 ist, bezieht sich location auf die iSeries-System-ID.
- Wenn der Wert der Eigenschaft remoteComType CICSECI, CICSEXCI, CICSSSL oder JCICS lautet, bezieht sich location auf die CICS-System-ID.
- Wenn der Wert für die Eigenschaft remoteComType
CICSJ2C lautet, bezieht sich location auf den JNDI-Namen des ConnectionFactory-Objektes, das Sie mit dem Aufruf für die CICS-Transaktion gestartet haben. Sie etablieren dieses ConnectionFactory-Objekt, wenn Sie den J2EE-Server wie in J2EE-Server für CICSJ2C-Aufrufe konfigurieren beschrieben erstellen. Der Name des ConnectionFactory-Objekts beginnt standardmäßig mit eis/. Beispiel:
eis/CICS1 - Wenn der Wert für die Eigenschaft remoteComType
IMSJ2C lautet, bezieht sich location auf den JNDI-Namen des ConnectionFactory-Objekts, das Sie mit dem Aufruf für die IMS-Transaktion erstellt haben.
Sie erstellen dieses ConnectionFactory-Objekt, wenn Sie den J2EE-Server wie im Abschnitt "J2EE-Server für
IMSJ2C-Aufrufe konfigurieren" in der Liste der zugehörigen Abschnitte unten beschrieben einrichten. Der Name des ConnectionFactory-Objekts beginnt standardmäßig mit eis/. Beispiel:
eis/IMS1 - Wenn der Wert der Eigenschaft remoteComType IMSTCP lautet, hat location den folgenden Wert:
host:portNumber/dataStoreName- host
- Der TCP/IP-Hostname oder die TCP/IP-Hostadresse, die sich auf das System bezieht, auf dem das aufgerufene Programm unter IMS ausgeführt wird.
- portNumber
- Die Nummer des Ports, der von der IMS Connect-Zielinstallation für TCP/IP-Verbindungen verwendet wird.
- dataStoreName
- IMS-Zieldatenspeichername, der mit dem ID-Parameter des Datenspeicherelements übereinstimmen muss, das im Konfigurationsmember von IMS Connect angegeben ist.
- Wenn der Wert der Eigenschaft remoteComType TCPIP lautet, bezieht sich location auf den TCP/IP-Hostnamen oder die TCP/IP-Adresse.
- Wenn der Wert der Eigenschaft remoteComType DEBUG lautet, bezieht sich location auf den Hostnamen des Systems, in dem die Eclipse-Workbench ausgeführt wird.
- Wenn der Wert der Eigenschaft remoteComType DISTINCT lautet, wird location nur in der iSeries-Umgebung verwendet, in der es den Namen der Bibliothek enthält, die wiederum die DLL oder das Programm enthält. Die Eigenschaft library enthält den Namen der DLL oder des Programms.
- Wenn alle nachfolgenden Bedingungen gelten, dann bezieht sich location auf die Bibliothek des aufgerufenen Programms.
- Das aufrufende Programm ist ein mit EGL generiertes Java-Programm, das unter iSeries ausgeführt wird.
- Der Wert der Eigenschaft remoteComType lautet DIRECT oder DISTINCT.
- Der Wert für remotePgmType lautet EXTERNALLYDEFINED;
- Sie können den Namen der Verbindungsdefinition angeben, der die folgenden Merkmale aufweist: