callAS400Program(host a, user b, passwd c, progName d, lengthList e, paramListName f, responseParamNr g, types of params h, re-use connection i)
Gruppe |
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 Named List 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.
Parameterbeschreibung
Parameter |
Beschreibung |
a |
Host-Name oder IP-Adresse. |
b |
Benutzername. |
c |
Passwort. |
d |
Programmname. |
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, getreennt durch Komma. Default: text. |
i |
true, wenn die Sitzung im Mapping wiederverwendet werden soll. |
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 |
Ergebnis |
Rückgabewert des Programms an 1. Stelle. |