RPG-Prozedur im LPEX-Editor für ferne Systeme erstellen

Sie können eine RPG-Hauptprozedur oder eine RPG-Unterprozedur erstellen, während Sie eine beliebige RPGLE-Teildatei im LPEX-Editor für ferne Systeme editieren. Eine Prozedur ist ein Teil des Codes, der mit einem Bindeaufruf, im Wesentlichen mit dem Operationscode CALLP, aufgerufen werden kann.
Gehen Sie wie folgt vor, um die Prozedur zu erstellen:
  1. Erweitern Sie Ihre Verbindung, bis Sie die Datei finden, in der die RPG-Prozedur erstellt werden soll.
  2. Klicken Sie doppelt auf die Datei, um sie im LPEX-Editor für ferne Systeme zu öffnen.
  3. Wenn sich der Cursor in der Editorsicht befindet, klicken Sie mit der rechten Maustaste und wählen Sie Neu > Prozedur aus. Sie können auch im Workbench-Menü auf Quelle > Neu > Prozedur klicken.
  4. Wählen Sie im Assistenten für RPG-Prozedur den Prozedurtyp im Dropdown-Menü Prozedurtyp aus.
  5. Geben Sie einen gültigen ILE RPG-Namen in das Feld Prozedurname ein.
  6. Im Feld Externer Name (EXTPROC) können Sie einen der folgenden Werte eingeben:
    1. Programm (EXTPGM)
    2. Hauptprozedur (EXTPROC)
    3. Unterprozedur (EXTPROC)
    4. Unterprozedur mit CLLE-Aufrufkonventionen (EXTPROC(*CL))
    5. Unterprozedur mit C-Aufrufkonventionen und Parametererweiterung (EXTPROC(*CWIDEN))
    6. Unterprozedur mit C-Aufrufkonventionen und ohne Parametererweiterung (EXTPROC(*CNOWIDEN))
  7. (Optional) Geben Sie einen Zweck als Beschreibung der Prozedur ein. Diese Beschreibung wird in den Headerkommentaren des Codes angezeigt.
  8. Wählen Sie das Markierungsfeld Für Verwendung mit anderem Code exportierbar (EXPORT) aus, wenn diese Prozedur für die Verwendung mit anderem Code exportiert werden kann. Beachten Sie jedoch, dass bei Auswahl dieses Markierungsfelds der Assistent sowohl den Prototyp- als auch den Prozedurcode in die aktuelle Datei stellt. Nach Beendigung des Assistenten müssen Sie den Prototyp manuell in eine COPY-Datei stellen, damit Prozeduren diesen Prototyp aufrufen können. Außerdem müssen Sie eine Anweisung COPY an der Stelle in den Prozedurcode eingeben, an der der Prototypcode entfernt wurde.
  9. Wählen Sie das Markierungsfeld Rechenbestimmungen mit freiem Format generieren aus, wenn der Abschnitt mit den Rechenoperationen in Ihrer RPG-Prozedur Code mit freiem Format statt Code mit festem Format enthalten soll. Der Rest der generierten Quelle (D- und P-Bestimmungen) enthält Code mit festem Format. Weitere Informationen befinden sich unter ILE RPG-Code von festem Format in freies Format konvertieren.
  10. Klicken Sie auf Hinzufügen, um Ihrer Prozedur einen Parameter hinzuzufügen. Füllen Sie das Dialogfenster aus, um den Parameter zu definieren, und klicken Sie auf OK.
  11. (Optional) Wählen Sie das Markierungsfeld Wert zurückgeben aus, wenn ein Rückgabewert definiert werden soll. Mit dieser Aktion wird die Schaltfläche Weiter aktiviert. Klicken Sie andernfalls auf Fertig stellen.
Hatten Sie Wert zurückgeben ausgewählt, gehen Sie wie folgt vor:
  1. Klicken Sie auf Weiter, um die Seite Rückgabewert des Assistenten für RPG-Prozedur aufzurufen.
  2. Müssen Sie Typ und Länge des Werts nicht angeben, können Sie das Feld Definiert wie auswählen und den Namen eines Felds, einer Datenstruktur oder eines Satzformats eingeben, der als Modell für den zurückgegebenen Wert verwendet werden soll. Möchten Sie alle diese Informationen selbst angeben, wählen Sie das Markierungsfeld Rückgabewert nicht aus und fahren Sie mit dem nächsten Schritt fort.
  3. Wählen Sie einen Rückgabewerttyp aus der Dropdown-Liste Typ aus. Der ausgewählte Typ füllt automatisch eine Reihe anderer Felder auf dieser Seite des Assistenten aus und lässt einige der Felder inaktiviert, wenn sie für den ausgewählten Typ von Wert nicht zutreffen. Falls gewünscht, können Sie jeden der Werte in den aktivierten Feldern ändern. Lesen Sie die F1-Hilfe für die verschiedenen Felder dieses Assistenten, wenn Sie sich über die Eingabe im Unklaren sind.
    Anmerkung: Ist der ausgewählte Typ Datum oder Zeit, wird der Formatkennsatz auf DATFMT (für Datum) oder TIMFMT (für Zeit) gesetzt. Anschließend können Sie das Format und das Trennzeichen für Ihren Datums- oder Zeitkennsatz auswählen. Ist der ausgewählte Typ Daten, wird ein Feld Klasseneintrag aktiviert, in dem Sie eine gültige Java-Klasse angeben können.
  4. (Optional) Geben Sie eine Beschreibung für den Rückgabewert ein. Diese Beschreibung wird in den Headerkommentaren des Codes angezeigt.
  5. Klicken Sie auf Fertig stellen.
Zugehörige Konzepte
Editierung
Zugehörige Tasks
RPG-, COBOL-, CL-, C-, C++- und DDS-Teildateien editieren
RPG-Definitionsbestimmung im LPEX-Editor für ferne Systeme erstellen
RPG-Java-Methodenaufruf im LPEX-Editor für ferne Systeme erstellen
ILE RPG-Code von festem Format in freies Format konvertieren
Automatisches CL-Formatierungsprogramm anpassen