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:
- Erweitern Sie Ihre Verbindung, bis Sie die Datei finden, in der die
RPG-Prozedur erstellt werden soll.
- Klicken Sie doppelt auf die Datei, um sie im LPEX-Editor für ferne
Systeme zu öffnen.
- 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.
- Wählen Sie im Assistenten für RPG-Prozedur den Prozedurtyp im
Dropdown-Menü Prozedurtyp aus.
- Geben Sie einen gültigen ILE RPG-Namen in das Feld Prozedurname ein.
- Im Feld Externer Name (EXTPROC) können Sie einen der
folgenden Werte eingeben:
- Programm (EXTPGM)
- Hauptprozedur (EXTPROC)
- Unterprozedur (EXTPROC)
- Unterprozedur mit CLLE-Aufrufkonventionen (EXTPROC(*CL))
- Unterprozedur mit C-Aufrufkonventionen und Parametererweiterung
(EXTPROC(*CWIDEN))
- Unterprozedur mit C-Aufrufkonventionen und ohne Parametererweiterung
(EXTPROC(*CNOWIDEN))
- (Optional) Geben Sie einen Zweck als Beschreibung der Prozedur ein. Diese Beschreibung
wird in den Headerkommentaren des Codes angezeigt.
- 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.
- 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.
- 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.
- (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:
- Klicken Sie auf Weiter, um die Seite Rückgabewert des
Assistenten für RPG-Prozedur aufzurufen.
- 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.
- 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.
- (Optional) Geben Sie eine Beschreibung für den Rückgabewert ein. Diese Beschreibung
wird in den Headerkommentaren des Codes angezeigt.
- Klicken Sie auf
Fertig stellen.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.