Lance l'exécution d'un programme AS/400.
ASLanceRPC ne concerne que les appels de programmes avec des paramètres.
Pour appeler un programme sans paramètres (ou seulement des paramètres en entrée), voir la fonction ASExec.
Pour appeler une commande de type Retrieve comme RTVJOBA, voir les fonctions ASAppelRTV et ASRésultatRTV.
Pour pouvoir être utilisé par ASLanceRPC, le programme doit avoir été décrit et importé dans l'analyse. Le nombre maximum de paramètres est 200.
On peut aussi paramétrer un temps d'exécution maximum (timeout) pour les appels de programmes depuis la configuration EASYCOM Serveur.
Syntaxe
bResult = ASLanceRPC(NomProgramme)
En anglais : ASRunRPC
Paramètres
bResult
Booléen - Vrai si l'appel au programme a réussi, Faux en cas d'erreur.
NomProgramme
Chaîne - le nom du programme correspondant au fichier importé dans l'analyse.
Remarque : cette fonction utilise nécessairement la connexion associée au programme (fichier) dans l'analyse.
Détail
Pour être exploitable par la fonction ASLanceRPC, le programme AS/400 doit avoir une procédure de description EASYCOM sur l'AS/400 (description faite avec le constructeur RPC-DTAQ) et être importé dans l'analyse du projet WinDev, sous forme de fichier.
Avant exécution, il faut initialiser les paramètres en entrée (In) et en entrée/sortie (In/Out) dans les rubriques correspondantes du buffer du programme, comme n'importe quel fichier.
Après exécution, les paramètres en sortie (Out) et en entrée/sortie (In/Out) sont stockés dans les rubriques correspondantes du buffer du fichier Hyper File.
Avec des champs de saisie liés au programme (fichier), le code suivant va passer les valeurs saisies au programme et afficher les éventuelles valeurs de retour
EcranVersFichier()
ASLanceRPC(RPCSAMPLE)
FichierVersEcran()
Notes
L'exécution du programme est réalisée dans la session de la connexion associée au programme. Les commandes CL lancées par ASExec, et les programmes appelés par ASLanceRPC sont exécutés dans l’environnement du job (voir aussi Job EASYCOM).
Voir l'exemple Appel de programmes.