Aller au contenu

SUBR

Sous-programme

En bref

La commande SUBR est utilisée dans un programme CL ou une procédure CL ILE, avec la commande ENDSUBR, pour délimiter le groupe de commandes qui définissent un sous-programme.

Syntaxe minimale

SUBR SUBR(…)

Paramètres

  • SUBR Sous-programme obligatoire

Astuce : dans une session 5250, tapez SUBR 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 SUBR est utilisée dans un programme CL ou une procédure CL ILE, avec la commande ENDSUBR, pour délimiter le groupe de commandes qui définissent un sous-programme. La commande SUBR définit le début d'un sous-programme. Les sous-programmes ne peuvent pas être imbriqués. Par conséquent, une commande ENDSUBR doit terminer le sous-programme en cours avant que la commande SUBR suivante ne puisse commencer un nouveau sous-programme. Un label spécifié dans une commande SUBR ou dans une commande indéfinie précédant la commande SUBR, peut être utilisée en tant que cible d'une commande GOTO définie dans le même sous-programme. Cette commande GOTO, lorsqu'elle est exécutée, transmet le contrôle à la première instruction exécutable du sous-programme.

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
SUBR Sous-programme Nom simple Obligatoire, positionnel 1

Sous-programme (SUBR)

Indique le nom du sous-programme. Il s'agit du nom qui doit être spécifié dans une commande CALLSUBR.

Ce paramètre est obligatoire.

nom-simple
Indiquez le nom du sous-programme. Un nom de variable CL ne peut pas être utilisé pour indiquer le nom de sous-programme.

Exemples 

PGM
 :
SUBR SUBR1
 :
ENDSUBR
ENDPGM

Cette commande SUBR définit le début d'un sous-programme nommé SUBR1.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.