Ruft ein AS400-Programm auf.
Das Login bei Host a erfolgt mit User b und Passwort c. Nach erfolgter Anmeldung wird das Programm d aufgerufen, dem die in eine Liste f geschriebenen Parameter übergeben werden.
Parameter e muss eine Folge positiver Ganzzahlen (mit Pipe | getrennt) enthalten, die die Zeichenlängen der Parameter im List-Objekt in ihrer Reihenfolge beschreiben.
Parameter h gibt, mit Komma getrennt, die Typen der Parameter an. Erlaubt sind: bin2, bin4, float4, float8, array, text, unsignedbin2, unsignedbin4, zoned und packed. Bei array kann zusätzlich noch das Encoding mit angegeben werden. Dazu muss dieses hinter dem Typ noch mit :<encoding> angegeben werden (z. B. bin4,array:UTF16,float4). Bei zoned und packed muss direkt (ohne Leerzeichen) die Anzahl der Nachkommastellen erfolgen, also z. B. packed12 für 12 Stellen nach dem Dezimaltrennzeichen.
Wird Parameter i auf true gesetzt, erfolgt das Logout erst am Ende vom Mapping (Caching der Sitzung).
Wenn in g der Wert -1 übergeben wurde, liefert die Funktion true bei Erfolg, bzw. false beim Scheitern des Aufrufs des AS400-Programms zurück. Wenn in g eine Zahl zwischen 0 und <Parameteranzahl-1> übergeben wurde, wird der so bezeichnete Eingangsparameter bei erfolgreicher Ausführung des AS400-Programms mit dem Ergebnis überschrieben, das dann als Ergebnis des Funktionsaufrufs als String zurück geliefert wird.
Wenn der AS400-Aufruf scheitert, wird die Funktion mit einem Fehler beendet.
Parameter
Parameter | Beschreibung |
|---|---|
a | Host-Name oder IP-Adresse. Hinweis: Verwenden Sie das Präfix secure: für TLS-basierte AS400-Verbindungen. |
b | Benutzername. |
c | Passwort. |
d | Programmname. Die Library muss auch angegeben werden, siehe Beispiele. |
e | Länge für jeden Eingangs-Parameter, durch | getrennt. |
f | Name der Liste, in der die Parameter abgelegt sind. |
g | Index des zurückzugebenden Ausgabeparameters. |
h | (optional) Angabe der Typen der Parameter in f, getrennt durch Komma. Default: text. |
i | true, wenn die Sitzung im Mapping wiederverwendet werden soll. |
j | (optional) Trim-Modus. Default: none. |
k | (optional) Wird hier der Name einer Liste angegeben, dann werden darin die Namen der Output-Variablen eingefügt. |
Beispiele
Parameter a | 192.168.0.123 |
Parameter b | opuser1234 |
Parameter c | secretpass |
Parameter d | /QSYS.LIB/FUXX4TRADE.LIB/WEBVKR6B.PGM |
Parameter e | 124|7 |
Parameter f | partList |
Parameter g | 0 |
Parameter h | bin4,array:UTF16 |
Parameter i | true |
Parameter j | |
Parameter k | |
Ergebnis | Rückgabewert des Programms an 1. Stelle. |