Pourquoi et quand exécuter cette tâche
Vous pouvez compiler un ou plusieurs membres dans un
Projet i en soumettant un travail par lots ou en effectuant une compilation immédiate.
Lors de la compilation, le plan de travail commence, par défaut, par insérer les modifications apportées au projet sur le serveur
IBM® i avant de compiler les membres sélectionnés. Vous pouvez modifier les options de construction et de compilation dans les préférences
Projet i . Les deux options disponibles sont
Insérer toutes les ressources modifiées dans le projet (option par défaut) et
Insérer les ressources sélectionnées en cas de modification.
Pour compiler un seul membre :- Développez le Projet i pour afficher les membres à compiler.
- Cliquez avec le bouton droit de la souris, sélectionnez Actions à distance et l'une des options suivantes :
- Compiler pour compiler le membre sans invite. Le membre est compilé via la commande de compilation associée au type de la source.
- Compiler (Invite) pour compiler le membre avec une invite, qui permet d'indiquer des paramètres supplémentaires.
- Sélection de la commande de compilation pour affecter une commande spécifique au type de la source.
- Gestion des commandes de compilation pour ajouter, modifier ou supprimer les commandes de compilation associées.
Pour compiler plusieurs membres :- Développez le Projet i pour afficher les membres à compiler.
- Sélectionnez les membres en cliquant sur chaque membre tout en maintenant la touche Ctrl enfoncée.
- Cliquez avec le bouton droit de la souris, sélectionnez Actions à distance et l'une des options suivantes :
- Compiler pour soumettre une commande de compilation à chaque membre sélectionné conformément à l'ordre correspondant à leur type. Vous pouvez modifier l'ordre dans les préférences, comme indiqué ci-dessous. Pour plus d'informations, voir Modification des préférences d'ordre de compilation en bas de page. Les membres sont compilés via la commande de compilation associée au type de la source.
- Gestion des commandes de compilation pour ajouter, modifier ou supprimer les commandes de compilation associées.
Que faire ensuite
Mode différé (par lots) ou immédiat :
- Si vous compilez des membres en mode différé, tous les membres sélectionnés sont compilés dans un même travail par lots. La vue Etat du travail affiche la progression du travail soumis.
- Si vous compilez des membres en mode différé et que vous utilisez OPTION(*EVENTF) dans les commandes de compilation, les erreurs de compilation sont consignées dans un fichier événements combiné que vous pouvez récupérer à l'issue de l'opération. Vous pouvez réparer les erreurs de compilation en cliquant avec le bouton droit de la souris sur l'identificateur du travail, dans la vue Etat du travail, puis en sélectionnant .
- Si vous compilez des membres en mode immédiat, les commandes de compilation sont soumises en série. Dans la liste d'erreurs, les erreurs de compilation éventuelles sont répertoriées dans un onglet distinct pour chaque membre.
Dans la page de préférences de style de construction, vous pouvez modifier la préférence Mode différé (par lots) ou immédiat. Cliquez sur dans le
menu du plan de travail. Développez
Projets i, puis sélectionnez
Création et compilation. Notez la présence de la case à cocher
Exécuter les compilations en tant que travaux de traitement par lots. Si vous sélectionnez cette option, les compilations de
Projets i sont soumises sous la forme de travaux par lots. Sinon, elles sont exécutées immédiatement.
Modification des préférences d'ordre de compilation :
Si vous compilez plusieurs membres source à la fois, l'ordre de compilation correspond à l'ordre du type de membre défini dans la page des préférences Exécution de commande d'IBM i. Pour accéder aux préférences, cliquez sur dans le menu du plan de travail. Développez ensuite , puis cliquez sur Exécution de commande. Dans la section Compiler les types de membre dans l'ordre suivant, vous pouvez sélectionner et déplacer plusieurs types de membre dans la liste.
Personnalisation des constructions de projet qui utilisent le style de construction du programme CL :
Pour soumettre une construction après génération ou modification manuelle du membre COMPILE.CLLE, cliquez avec le bouton droit de la souris sur le projet, puis cliquez sur . Le membre COMPILE.CLLE
est compilé, ainsi que le membre BIND.CLLE
s'il existe. Le programme COMPILE est alors exécuté. Le programme BIND est exécuté, s'il existe,
après le programme COMPILE, mais uniquement si aucune erreur de compilation n'a été détectée lors de l'exécution de ce dernier. Pour déterminer cela, surveillez la valeur de la variable d'environnement QRB_NUMBER_FAILED.
Pour forcer l'exécution du programme BIND même en cas d'erreurs de compilation, vous pouvez définir cette variable d'environnement sur 0 à la fin du programme COMPILE
ou, tout simplement, supprimer les instructions de mise à jour.
La création ou la modification des fichiers constitue un problème car les commandes de création de fichier ne comportent pas de paramètre *REPLACE. Une procédure de construction personnalisée est parfois requise par ces commandes.
Les utilisateurs peuvent modifier COMPILE.CLLE pour supprimer les fichiers générés avant de les recréer ou exécuter un test CHKOBJ avec une autre commande (par exemple, CHGPF au lieu de CRTPF).
Les fichiers logiques créés au-dessus de ces fichiers physiques empêchent parfois certaines modifications et devront donc, sans doute, être supprimés les premiers.
Si les fichiers physiques comportent des données, elles doivent parfois être conservées par des précautions adéquates. Vous pouvez par exemple renommer l'ancien fichier, puis copier son contenu dans le fichier généré, en mappant les zones lors de cette opération.
Remarque : Il est recommandé de répartir les fichiers physiques, les fichiers logiques et les fichiers programme dans leurs projets respectifs pour qu'ils puissent être compilés séparément. Tous les projets peuvent être affectés à la même bibliothèque associée.
Si vous écrivez un membre COMPILE.CLLE personnalisé, veillez à désactiver sa génération automatique pour le projet concerné dans les propriétés du projet.