show

Die Anweisung show zeigt ein Formular oder eine Webseite an.

Die Anweisung ist in den folgenden Arten von Code gültig:

Darüber hinaus können Sie eine Anweisung show in einem Programm mit einer Variablen verwenden, die sich in einer Bibliothek befindet.

Die Anweisung show hat folgende Wirkung:
  1. Sie schreibt wiederherstellbare Ressourcen fest, schließt Dateien und hebt Sperren auf.
  2. Optional übergibt sie einen Basisdatensatz an das zu verwendende Programm. Falls dieser Datensatz verwendet wird, ist er in der Klausel passing der Anweisung show angegeben.
  3. Sie beendet das erste Programm.
  4. Sie stellt entweder ein Textformular oder eine Webseite dar.

Wenn ein Textformular dargestellt wird, führt die Anweisung immer eine verzögerte Übertragung aus: Der Benutzer übergibt das Formular, um ein neues Programm oder eine neue Transaktion aufzurufen. Wird eine Webseite dargestellt, ist die verzögerte Übertragung optional. Ein aufgerufenes Programm, bzw. das erste Programm in einer aufgerufenen Transaktion, ist immer ein Hauptprogramm.

Syntax

Syntaxdiagramm für die Anweisung 'show'
formName
Name eines Textformulars, das für das Programm sichtbar ist. Weitere Informationen zur Sichtbarkeit finden Sie unter Gültigkeitsbereich. Wenn Sie eine Rückgabeklausel in die Anweisung einfügen, muss das Textformat dem Textformular in der Eigenschaft inputForm des aufgerufenen Programms entsprechen.
VGUIRecordName
Name eines UI-Datensatzes, der für das Programm sichtbar ist. Weitere Informationen zur Sichtbarkeit finden Sie unter Gültigkeitsbereich. Wenn Sie eine Klausel returning to in die Anweisung einfügen, muss der UI-Datensatz äquivalent zu dem UI-Datensatz in der Eigenschaft inputUIRecord des aufgerufenen Programms sein.
targetName
Kennung des Programms oder der Transaktion, das bzw. die aufgerufen wird, nachdem der Benutzer das Textformular oder die Webseite gesendet hat. Der Name kann ein Abschnittverweis ohne Anführungszeichen, eine Literalzeichenfolge in Anführungszeichen, eine Konstante oder sysVar.transferName bzw. eine andere Variable sein.
basicRecordName
Name eines Basisdatensatzes. Der Inhalt wird dem Eingabesatz des empfangenden Programms zugeordnet.
properties
Es wird eine Eigenschaft unterstützt. Die Eigenschaft hat nur für Text-UI-Programme Bedeutung, die IMS/VS als Zielplattform verwenden.
isExternal
Boolesche Eigenschaft:
  • NO, der Standardwert, gibt an, dass ein EGL-generiertes Programm das Ziel der verzögerten Übertragung ist.
  • YES gibt an, dass ein nicht-EGL-generiertes Programm das Ziel ist.

Kompatibilität

Tabelle 1. Hinweise zur Kompatibilität für die Anweisung 'show'
Plattform Problem
CICS für z/OS

EGL implementiert die Anweisung mit dem CICS-Befehl START und verwendet die Option COMMAREA dieses Befehls, um den Datensatz zu übergeben. Die Datensatzdaten starten im ersten Byte des allgemeinen CICS-Bereichs und die maximale Datensatzlänge ist '32763'.

targetName verweist auf einen CICS-Transaktionsnamen.

Die Anweisung show bietet keine Unterstützung für eine verzögerte Übertragung an ein nicht-EGL-generiertes Programm.

IBM® i Die Anweisung show bietet keine Unterstützung für eine verzögerte Übertragung an ein nicht-EGL-generiertes Programm.
IMS/VS

Die Anweisung show unterstützt eine verzögerte Übertragung an ein EGL-generiertes Programm oder an ein nicht-EGL-generiertes Programm. targetName verweist auf einen IMS-Transaktionsnamen.

In Bezug auf EGL-generierte Programme gelten die folgenden Regeln:
  • Das Zielprogramm muss für die folgenden Erstellungsdeskriptoroptionen dieselben Werte angeben wie das Quellenprogramm: spaSize, spaADF und spaStatusBytePosition.
  • Die Ziel- und Quellenprogramme müssen dieselbe Formulargruppe haben.

Ein nicht-EGL-generiertes Zielprogramm muss MFS einsetzen, um das übergebene Formular zu empfangen. Der MFS-Zuordnungsname kann derselbe sein wie der EGL-Formularname.

IMS BMP Die Anweisung show wird nicht unterstützt.
z/OS Batch Die Anweisung show wird nicht unterstützt.
Webtransaktionen Die Anweisung show wird für Hauptwebtransaktionen und aufgerufene Webtransaktionen unterstützt. Die Klausel returning to ist in diesem Fall optional und die Eigenschaft isExternal hat keine Wirkung.
Andere Java™-Generierung Die Anweisung show bietet keine Unterstützung für eine verzögerte Übertragung an ein nicht-EGL-generiertes Programm.

Feedback