INCLUDE

Inclure source CL

En bref

La commande INCLUDE (Inclure une source CL) inclut un texte externe dans le programme source en cours de compilation.

Syntaxe minimale

INCLUDE

Paramètres

SRCMBR Membre source
SRCSTMF Fichier STREAM source
SRCFILE Fichier source

Astuce : dans une session 5250, tapez INCLUDE 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 INCLUDE (Inclure une source CL) inclut un texte externe dans le programme source en cours de compilation. Le texte externe doit correspondre à des commandes CL valides, admises dans une source CL compilée. Ces commandes peuvent être des instructions de déclaration (comme DCL ou DCLF), des instructions flux de contrôle (comme IF ou Select) ou des commandes CL régulières (comme CRTLIB ou RMVM). Toutefois, le texte inclus ne peut pas entraîner l'affichage de commandes de déclaration à la suite de commandes autres que des commandes de déclaration.

Restrictions :

La commande INCLUDE est valide uniquement dans un programme CL ou une procédure CL ILE.
Vous devez disposer du droit *USE sur le fichier indiqué au paramètre Fichier source (SRCFILE) ou Fichier STREAM source (SRCSTMF) et du droit (*EXECUTE) sur la bibliothèque contenant le fichier source.
La longueur d'enregistrement du fichier source indiqué pour le paramètre SRCFILE doit être égale ou inférieure à la longueur d'enregistrement du fichier source contenant le programme source CL racine en cours à compiler. Les enregistrements copiés à partir du fichier source INCLUDE et dont la longueur excède la longueur d'enregistrement du fichier source CL racine seront tronqué à droite. Ceci pourra conduire à des erreurs lors de la compilation ou à des comportements inattendus en cours d'exécution du programme CL ou de la procédure CL.
Les paramètres Membre source (SRCMBR) et Fichier source (SRCFILE) ne peuvent pas être indiqués avec le paramètre Fichier STREAM source (SRCSTMF).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
SRCMBR	Membre source	Nom	Facultatif, positionnel 1
SRCSTMF	Fichier STREAM source	Chemin d'accès	Facultatif
SRCFILE	Fichier source	Valeurs uniques: INCFILE Autres valeurs: Nom d'objet qualifié*	Facultatif, positionnel 2
	Qualificatif 1: Fichier source	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB

Membre source (SRCMBR)

Indique le membre source contenant le source du programme CL à inclure.

nom: Indiquez le nom du membre source.

Fichier STREAM source (SRCSTMF)

Indique le chemin d'accès au fichier STREAM contenant le source CL à inclure.

Le nom du chemin d'accès peut être absolu ou relatif. Un nom de chemin d'accès absolu commence par '/' ; un nom de chemin d'accès relatif commence par un caractère autre que '/'.

S'il est absolu, le nom de chemin d'accès est complet.

S'il est absolu, le nom de chemin d'accès est complété par l'ajout du répertoire d'inclusion sur lequel porte la recherche. Les répertoires d'inclusion sur lesquels doit porter la recherche sont indiqués au paramètre INCDIR. Le système utilisera l'ordre suivant pour rechercher le fichier source d'inclusion :

Le répertoire source.
Les répertoires indiqués au paramètre INCDIR.

Fichier source (SRCFILE)

Indique le fichier source qui contient le membre source à inclure.

Valeur uniques

*INCFILE: Le fichier indiqué pour le paramètre INCLUDE file (INCFILE) de la commande CL utilisée pour appeler le compilateur CL est utilisé.

Qualificatif 1 : Fichier source

nom: Indiquez le nom du fichier source.

Qualificatif 2: Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier source. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom: Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Exemples

Exemple 1 : Inclusion d'un source CL à l'aide d'un fichier INCLUDE par défaut

INCLUDE   SRCMBR(DCLSET1)  SRCFILE(*INCFILE)

Avec cette commande, le source du programme CL est inclus dans le membre DCLSET1 lors de la compilation. Le membre DCLSET1 doit se trouver dans le fichier indiqué pour le paramètre INCFILE dans la commande CL qui a appelé le compilateur CL.

Exemple 2 : Inclusion d'un source CL à partir d'un fichier spécifié

INCLUDE   SRCMBR(SUBR1)  SRCFILE(MYLIB/COMMONSUBR)

Avec cette commande, le source du programme CL est inclus dans le membre SUBR1 lors de la compilation. Le membre SUBR1 doit se trouver dans le fichier COMMONSUBR de la bibliothèque MYLIB.

Exemple 3 : Inclusion d'un source CL à partir d'un fichier STREAM spécifié

INCLUDE   SRCSTMF('/dir/pay_data.cl')

Avec cette commande, le source du programme CL dans le fichier STREAM '/dir/pay_data.cl' est inclus lors de la compilation.

Messages d'erreur

Aucun