Die Systemvariable 'sysVar.remoteSystemID' enthält den Systemnamen für die Position einer fernen Entität, z. B. eines Programms, einer Datendatei, einer asynchronen Transaktion oder einer Warteschlange mit transienten Daten. Diese Variable unterstützt keine dynamische Definition von Dateien oder Programmen, bietet jedoch Unterstützung für dynamische Auswahl aus einer vordefinierten Gruppe von Positionen. Die Variable ist als CHAR(256) definiert; für COBOL-Generierung wird die Länge auf CHAR(8) abgeschnitten.
'sysVar.remoteSystemID' wird mit Leerzeichen initialisiert und muss gesetzt werden, bevor ein Aufruf, die Funktion 'vgLib.startTransaction()' oder eine Datei-E/A-Funktion abgesetzt wird, für den/die diese Variable verwendet werden muss.
sysVar.remoteSystemID = "myWin";
// Auflösung ergibt 'false'
if (sysVar.remoteSystemID == "MYWIN")
record1.resourceAssociation = "myCorp.txt";
end
Der Wert von 'sysVar.remoteSystemID' bietet nur dann Zugriff auf die ferne Entität, wenn in dem zur Generierungszeit verwendeten Verbindungsoptionsabschnitt PROGRAMCONTROLLED als Wert für die Positionseigenschaft (location) im Element 'callLink' oder PROGRAMCONTROLLED als Wert für die Eigenschaft 'locationSpec' im Element 'asynchLink' oder 'fileLink' angegeben wird. Weitere Informationen zu Verbindungsoptionsabschnitten finden Sie im Handbuch für EGL-Generierung.
In der CICS-Umgebung können Sie 'sysVar.remoteSystemID' nur für den Zugriff auf ferne Dateien, Warteschlangen mit transienten Daten oder Transaktionen verwenden. Details hierzu finden Sie unter 'Kompatibilität' weiter unten.
sysVar.remoteSystemID = "myCICS";
call myRemoteProgram myRecord;
end
| Plattform | Problem |
|---|---|
| Java™-Generierung und -Debugging | 'sysVar.remoteSystemID' bietet nur dann Zugriff auf einen Fernaufruf an ein CICS-Programm, wenn die Eigenschaft 'locationSpec' des Elements 'callLink' im Verbindungsoptionsabschnitt auf PROGRAMCONTROLLED gesetzt ist. 'sysVar.remoteSystemID' hat keine Auswirkung auf die Funktion 'vgLib.startTransaction()' und ferne VSAM-Dateien. |
| CICS für z/OS | Das Programm, die Transaktion oder die Datei muss in der entsprechenden CICS-Tabelle definiert sein. 'sysVar.remoteSystemID' bietet nur dann Zugriff auf einen Fernaufruf an ein CICS-Programm, wenn die Eigenschaft 'locationSpec' des Elements 'callLink' im Verbindungsoptionsabschnitt auf PROGRAMCONTROLLED gesetzt ist. 'sysVar.remoteSystemID' bietet nur dann Zugriff auf eine ferne VSAM-Datei oder Warteschlange mit transienten Daten, wenn in dem zur Generierungszeit verwendeten Verbindungsoptionsabschnitt die Eigenschaft 'locationSpec' für das Element 'fileLink' auf PROGRAMCONTROLLED gesetzt ist. Für ferne Dateien ist der Systemname die CICS-System-ID. 'sysVar.remoteSystemID'
bietet nur im folgenden Fall Zugriff auf eine ferne CICS-Transaktion:
|
| IMS BMP | Wird nicht unterstützt. 'sysVar.remoteSystemID' hat keine Auswirkung, weil der Zugriff auf ferne Programme und Dateien nicht unterstützt wird. |
| IMS/VS | Wird nicht unterstützt. 'sysVar.remoteSystemID' hat keine Auswirkung, weil der Zugriff auf ferne Programme und Dateien nicht unterstützt wird. |
| iSeries COBOL | Nicht unterstützt |
| z/OS Batch | Nicht unterstützt |