Parameter hinzufügen

Über die Seite Parameter hinzufügen im Assistenten für Programmaufruf können Sie einen Parameter definieren, der vom aufzurufenden Programmobjekt oder Serviceprogrammobjekt benötigt wird. Die maximale Anzahl von Parametern für ein Serviceprogramm ist 7. Wählen Sie das Markierungsfeld Erweitert aus, um die erweiterten Attribute für einen Parameter anzuzeigen. Weitere Informationen zu jedem Feld finden Sie in den Informationen zur IBM Toolbox for Java unter PCML-Tag 'data'.

Option Beschreibung
Parametername Der Name des Parameters. Hierbei muss es sich um einen gültigen Java-Variablennamen handeln.
Datentyp Der für den Parameter verwendete Datentyp:
Zeichen:
Wird als java.lang.String zurückgegeben. Der Standardwert für den Datentyp ist 'Zeichen'. Bei diesem Datentyp wird ein einziges Byte für jedes Zeichen verwendet.
UCS-2/Grafik
Wird als java.lang.String zurückgegeben. Bei diesem Datentyp werden zwei Byte für jedes Zeichen verwendet.
Ganze Zahl:
Wird als java.lang.Long zurückgegeben.
Gepackt dezimal:
Wird als java.math.BigDecimal zurückgegeben.
Gezont dezimal:
Wird als java.math.BigDecimal zurückgegeben.
Gleitkomma:
Wird als java.lang.Float zurückgegeben, wenn die Länge 4 angegeben ist; andernfalls wird es für die Länge 8 als java.lang.Double zurückgegeben.
Byte:
Wird als Feldgruppe mit Bytewerten zurückgegeben (byte[]). Die Daten werden nicht konvertiert.
Struktur:
Der Datentyp ist eine Struktur, wenn der Parameter eine Struktur ist.
Strukturname:
Der Name der Struktur. Um einen Parameter mit dem Datentyp Struktur angeben zu können, müssen Sie die Struktur zunächst durch Anklicken von Struktur hinzufügen definieren. Wenn die Struktur definiert ist und Sie den Datentyp 'Struktur' verwendet haben, wird eine Liste mit Strukturnamen im Feld Strukturname angezeigt.
Länge Die vom Parameter geforderte Länge. Siehe Werte für Länge und Genauigkeit. Sie können einen numerischen Wert eingeben oder einen Wert aus der Dropdown-Liste auswählen. Die Werte in der Liste sind Datenelemente des Typs int, auf die von Ihrem Programm verwiesen wird.
Genauigkeit Die Anzahl Byte für die Genauigkeit bei manchen numerischen Datentypen. Siehe Werte für Länge und Genauigkeit.
Anzahl Die Größe der Feldgruppe. Wenn das Feld Anzahl leer bleibt, ist der Parameter nicht als Feldgruppe definiert, obgleich er unter Umständen als Element einer Struktur definiert sein kann, die wiederum als Feldgruppe definiert ist.
Verwendung Verwendung des Parameters (Zeichen und numerische Datentypen werden konvertiert):
Eingabe:
Eingabe für das Hostprogramm.
Ausgabe:
Ausgabe aus dem Hostprogramm. Zeichen und numerische Datentypen werden konvertiert.
Eingabe & Ausgabe:
Sowohl Eingabe als auch Ausgabe. Dies ist der Standardwert.
Übernehmen:
Die Verwendung wird aus dem Elternelement übernommen. Hat die Struktur kein Elter, wird Eingabe & Ausgabe verwendet.
Anfangswert Der Anfangswert für den Parameter, wenn er nicht explizit vom Anwendungsprogramm definiert wird und für die Verwendung des Parameters Eingabe oder Eingabe & Ausgabe gilt. Siehe Attribut init in PCML-Tag 'data'.
Ausgabegröße Die Anzahl Byte, die für Ausgabedaten für den Parameter reserviert werden sollen. Dieses Feld sollte bei Ausgabeparametern mit fester Größe leer bleiben. Siehe Attribut outputsize in PCML-Tag 'data'.
Trimmung

Leerzeichen aus Zeichendaten entfernen:

Rechts:
Abschließende Leerzeichen entfernen. Dies ist der Standardwert.
Links:
Führende Leerzeichen entfernen.
Beide:
Führende und abschließende Leerzeichen entfernen.
Keine:
Keine Leerzeichen entfernen.
Bidi-Zeichenfolgeart Die bidirektionale Zeichenfolgeart für Parameter mit dem Datentyp Zeichen. Siehe Attribut bidistringtype in PCML-Tag 'data'.
Min. Version Die niedrigste Version von IBM i, auf der dieses Element vorhanden ist. Siehe Attribut minvrm in PCML-Tag 'data'.
Max. Version Die höchste Version von IBM i, auf der dieses Element vorhanden ist. Siehe Attribut maxvrm in PCML-Tag 'data'.
Abstand Der Abstand zum Element innerhalb eines Ausgabeparameters. Siehe Attribut offset in PCML-Tag 'data'.
Abstand von Die Basisposition relativ zum Abstandsattribut. Siehe Attribut offsetfrom in PCML-Tag 'data'.
CCSID Host-ID für codierten Zeichensatz für den Parameter mit Datentyp 'Zeichen'. Wenn dieses Feld leer bleibt, wird die Standard-CCSID der Hostumgebung verwendet. Siehe Attribut ccsid in PCML-Tag 'data'.
Übergeben von Gibt an, wie der Parameter übergeben wird. (Nur für Serviceprogrammaufrufparameter)
Referenz:.
Der Parameter wird anhand der Referenz übergeben. Beim Aufruf des Programms wird dem Programm ein Zeiger zum Parameterwert übergeben.
Wert:
Der Parameter wird anhand eines ganzzahligen Werts übergeben. Dieser Wert ist beim Datentyp Ganze Zahl und einer Länge von 4 zulässig.

Werte für Länge und Genauigkeit

Die Attribute für die Länge und Genauigkeit haben unterschiedliche Werte für jeden Datentyp. In der folgenden Tabelle ist jeder Datentyp mit einer Beschreibung der möglichen Werte für die Länge und Genauigkeit aufgeführt.

Datentyp Länge Genauigkeit
Zeichen Die Anzahl Zeichen für diesen Parameter Nicht gültig
UCS-2/Grafik Die Anzahl Zeichen für diesen Parameter Nicht gültig
Ganze Zahl Die Anzahl Byte für diesen Parameter. Gibt die Anzahl Bit für die Genauigkeit an. Außerdem wird angegeben, ob die ganze Zahl Vorzeichen hat oder nicht.
2 Byte Verwenden Sie die Genauigkeit 15 für eine aus zwei Byte bestehende ganze Zahl mit Vorzeichen (Standardwert).

Verwenden Sie die Genauigkeit 16 für eine aus zwei Byte bestehende ganze Zahl ohne Vorzeichen.

4 Byte Verwenden Sie die Genauigkeit 31 für eine aus vier Byte bestehende ganze Zahl mit Vorzeichen.

Verwenden Sie die Genauigkeit 32 für eine aus vier Byte bestehende ganze Zahl ohne Vorzeichen.

8 Byte Verwenden Sie die Genauigkeit 63 für eine aus acht Byte bestehende ganze Zahl mit Vorzeichen.
Gepackt dezimal oder gezont dezimal Die Anzahl Datenziffern für diesen Parameter Die Anzahl Dezimalziffern für den Parameter. Diese Zahl muss größer-gleich Null und kleiner-gleich der im Feld Länge angegebenen Anzahl von Ziffern sein.
Gleitkomma Die Anzahl Byte für diesen Parameter: 2, 4 oder 8 Nicht gültig
Byte Die Anzahl Datenbyte für diesen Parameter Nicht gültig
Struktur Nicht zulässig Nicht gültig

Die folgende Tabelle zeigt die entsprechende Länge und Genauigkeit für die Deklaration ganzer Zahlen in einem RPG-Programm:

3 Byte 1 Nicht gültig
5 Ganze Zahl 2 15 für 'mit Vorzeichen', 16 für 'ohne Vorzeichen'
10 Ganze Zahl 4 31 für 'mit Vorzeichen', 32 für 'ohne Vorzeichen'
20 Ganze Zahl 8 63 für 'mit Vorzeichen'

Die folgende Tabelle zeigt die entsprechende Länge und Genauigkeit für die Deklaration ganzer Zahlen einem COBOL-Programm:

PIC 9(1) bis PIC 9(4) Ganze Zahl 2 15
PIC 9(5) bis PIC 9(9) Ganze Zahl 4 31
PIC 9(10) bis PIC 9(18) Ganze Zahl 8 63

Feedback