'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:

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 lautet, bezieht sich location auf die System-ID von iSeries.
  • Wenn der Wert der Eigenschaft remoteComType CICSECI, CICSEXCI oder CICSSSL lautet, bezieht sich location auf die System-ID von CICS.
  • 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;

Feedback