ENDSUBR

Arrêter sous-programme

En bref

La commande ENDSUBR indique la fin d'un sous-programme et doit être appariée à une commande SUBR précédente.

ENDSUBR se lit END (Arrêter) + SUBR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ENDSUBR

Paramètres

RTNVAL Valeur renvoyée par CPP

Astuce : dans une session 5250, tapez ENDSUBR puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute :

Programme batch (*BPGM)
Programme interactif (*IPGM)

Compatible multitâche : Oui

La commande ENDSUBR indique la fin d'un sous-programme et doit être appariée à une commande SUBR précédente. Lorsque la commande ENDSUBR est traitée, le contrôle est renvoyé à la commande suivant immédiatement la commande CALLSUBR ayant appelé le sous-programme. Si une valeur doit être renvoyée, par exemple, un code d'erreur, cette valeur doit pouvoir être stockée dans une variable CL de nombre entier signé à 4 octets. Le paramètre RTNVAL (Valeur renvoyée par CPP) peut être une variable ou une constante. Si aucun paramètre RTNVAL n'est défini, la valeur par défaut est zéro.

Restrictions :

Cette commande est valide uniquement dans un programme CL ou une procédure CL ILE.
Le sous-programme doit être défini dans une procédure et doit figurer à la fin de celle-ci.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
RTNVAL	Valeur renvoyée par CPP	Entier, 0	Facultatif

Valeur renvoyée par CPP (RTNVAL)

Indique la valeur à renvoyer depuis le sous-programme. Il peut s'agir d'une variable ou d'une constante pouvant être stockée dans une variable CL de nombre entier signé à 4 octets. Si la commande CALLSUBR ayant appelé le sous-programme indiquait une Variable pour valeur retour, la variable est définie d'après cette valeur.

0: Le sous-programme renvoie la valeur zéro.
constante-entière: Indiquez la valeur entière de la constante pour la valeur de retour.
nom-variable-CL: Indiquez le nom de la variable CL devant contenir la valeur de retour provenant du sous-programme appelé. Il doit s'agir d'une variable CL de nombre entier signé.

Exemples

PGM
 :
SUBR SUBR1
 :
ENDSUBR
ENDPGM

Ce sous-programme CL est identifié par une commande SUBR contenant le nom du sous-programme, SUBR1, et se termine par la commande ENDSUBR.

PGM
 :
SUBR SUBR1
 :
ENDSUBR RTNVAL(-1)
ENDPGM

Ce sous-programme CL comporte une commande ENDSUBR qui renvoie la valeur -1.

Messages d'erreur

Aucun