Tutoriel : Utilisation d'un projet iSeries pour compiler et exécuter une application sur le serveur iSeries

Ce tutoriel décrit comment créer et peupler un projet iSeries avec un code existant pour une application en mode texte. Pour ce faire, vous devrez éditer et vérifier le code localement, puis le renvoyer vers l'hôte. Enfin, vous enverrez une construction à l'hôte pour compiler votre nouvelle application native.

Application en mode texte HelloWorld *LDA :

L'application HelloWorld *LDA est une simple application en mode texte, qui permet de mettre à jour la zone de données locale (*LDA) du travail courant avec l'heure courante. Elle vous permet également d'afficher le contenu de la zone LDA. Cette application a été codée en langage DDS et CL. Elle ressemble à ceci :

Code source DDS :

Code source CL :

Améliorations nécessaires pour l'application en mode texte :

Vous devez modifier les éléments suivants dans l'application en mode texte :
  1. Ajoutez une troisième option de menu qui efface le contenu de la zone de données locale (LDA).
  2. Remplacez la première option de menu par Mettre à jour la LDA du travail avec l'heure courante.
  3. Supprimez l'arrière-plan d'intensité inverse du titre de l'écran.
Ces modifications signifient que vous devrez mettre à jour et recompiler le code DDS et CL utilisé. Pour ce faire, vous allez créer un projet iSeries, télécharger localement les membres appropriés dans le projet iSeries, les éditer et les vérifier, puis les renvoyer sur l'hôte pour les compiler.

Procédure de développement

Le cycle de développement sous-jacent aux projets iSeries consiste à créer et à peupler un projet iSeries avec des membres source. Ces membres sont ensuite édités localement et la syntaxe vérifiée. Ensuite, les membres sont renvoyés sur le serveur iSeries pour être construits selon le style de construction associé au projet. Vous pouvez récupérer et afficher localement les compilations et modifier les membres en conséquence. Une fois tous les membres compilés sans erreur, vous pouvez les enregistrer sur un serveur coopératif pour la gestion des sources si un développement coopératif est nécessaire. Vous pouvez spécifier le serveur coopératif en associant le projet à un fournisseur coopératif. Le reste du tutoriel décrit chacune de ces étapes de développement et les applique dans le contexte de la mise à jour de l'application HelloWorld existante.

Etape 1 : Ouverture de la perspective Projets iSeries et localisation du code source pour l'application en mode texte

Dans ce tutoriel, le code source de l'application en mode texte figure dans la bibliothèque HelloWorld résidant sur le serveur DemoHost. Pour afficher cette bibliothèque, utilisez la vue Systèmes distants pour créer une connexion et un filtre pour cette bibliothèque :

  1. Dans le menu WebSphere Development Studio Client, sélectionnez Fenêtre > Ouvrir une perspective > Autre et sélectionnez Projets iSeries.
  2. Dans la vue Systèmes distants, développez Nouvelle connexion.
  3. Développez l'entrée iSeries pour ouvrir l'assistant Nouvelle connexion système iSeries.
  4. Entrez le nom de la connexion et du système hôte, puis cliquez sur Terminer.
  5. Développez votre nouvelle connexion, puis cliquez avec le bouton droit de la souris sur Objets iSeries.
  6. Sélectionnez Nouveau > Filtre de bibliothèque.
  7. Tapez HelloWorld comme nom de bibliothèque et cliquez sur Suivant.
  8. Tapez HelloWorld comme nom de filtre et cliquez sur Terminer.

Vous venez de créer un filtre comportant une bibliothèque appelée HelloWorld :

Etape 2 : Création d'un projet iSeries et peuplement avec des membres

Maintenant que vous avez localisé le code source, vous devez l'importer dans un projet iSeries pour l'éditer. Vous pouvez créer un nouveau projet iSeries via l'assistant Nouveau projet iSeries. Dans le navigateur de projet iSeries, cliquez avec le bouton droit de la souris sur un élément de l'arborescence et sélectionnez Nouveau > Projet iSeries. Vous créez ainsi un projet iSeries vide que vous devez peupler. Cette option est particulièrement utile si vous créez un nouveau membre iSeries ne résidant pas encore sur un serveur. Pour ce tutoriel, nous avons une application en mode texte que nous devons importer dans un projet iSeries. Dans le filtre RSE HelloWorld ci-dessus, cliquez avec le bouton droit de la souris sur les fichiers physiques source QCLSRC et QDDSSRC, et sélectionnez Rendre disponible hors connexion.
Remarque : L'action Rendre disponible hors connexion télécharge localement les fichiers ou membres sélectionnés dans leur projet iSeries correspondant. Le projet iSeries correspondant a le même hôte et les mêmes propriétés de bibliothèque que le nom d'hôte et la bibliothèque des membres ou fichiers physiques source sélectionnés. S'il n'existe aucun projet iSeries, un nouveau projet est créé automatiquement. Pour ce tutoriel, cette action a créé un nouveau projet iSeries appelé : connectionName_libraryName. S'il existe déjà un ou plusieurs projets iSeries avec la même connexion et mappés sur la même bibliothèque que la bibliothèque associée, vous êtes invité à sélectionner l'un des projets existants.

Etape 3 : Activation de la vue fusionnée sous un projet iSeries

Une fois que vous avez créé et peuplé le projet iSeries avec des membres et fichiers source, vous pouvez afficher les objets distants qui se trouvent dans la bibliothèque associée du projet en sélectionnant l'action Afficher les objets distants à partir du menu en incrustation. Cette action affiche une vue présentant les fusions de toutes les ressources locales avec l'ensemble des ressources distantes qui se trouvent dans la bibliothèque distante :

Dans l'image ci-dessus, la flèche jaune indique que les objets résident en local sur votre poste de travail et à distance sur le serveur. Si vous sélectionnez Afficher > Objets distants dans le menu déroulant, tous les objets distants sont supprimés de la vue.

Etape 4 : Edition des membres source locaux

L'édition de membres source locaux dans les projets iSeries est identique à l'édition de membres source distants dans l'explorateur de systèmes distants, excepté que les membres ne sont pas verrouillés sur le serveur lorsque vous les éditez dans la perspective Projets iSeries. Pour modifier le code afin d'intégrer toutes les modifications qu'il convient d'apporter aux membres source :
  1. Cliquez deux fois sur DEMO.DSPF pour lancer CODE Designer.
  2. Remplacez la première option par Mettre à jour la LDA du travail avec l'heure courante.
  3. Ajoutez une troisième option : Supprimer le contenu LDA.
  4. Supprimez l'attribut HI pour le titre.
  5. Enregistrez et fermez CODE Designer.
    Remarque : Vous venez de modifier un fichier via un éditeur externe. De ce fait, le contenu de l'espace de travail n'est plus synchronisé avec le contenu réel du système de fichiers. Pour régénérer la vue, cliquez sur le projet avec le bouton droit de la souris et sélectionnez Régénérer. Vous devrez régénérer la vue chaque fois que vous éditerez un fichier directement dans le système de fichiers.
Le type de source d'un membre donné est ajouté comme extension de fichier lorsque vous créez ou téléchargez localement le membre, et l'éditeur approprié se lance lorsque vous cliquez deux fois dessus. Vous pouvez modifier le type d'un membre en le renommant avec une autre extension ou vous pouvez utiliser sa page des propriétés pour modifier cette propriété. CODE Designer n'est pas enregistré comme éditeur externe pour l'affichage des fichiers, mais vous pouvez le faire en l'ajoutant manuellement dans la page des préférences ; il apparaîtra ensuite dans le menu Ouvrir avec. Pour l'ajouter :
  1. Sélectionnez Fenêtre > Préférences dans le menu principal.
  2. Développez Plan de travail.
  3. Sélectionnez Associations de fichiers.
  4. Sélectionnez *dspf à partir de Types de fichier.
  5. Cliquez sur Ajouter en regard de la vue de la liste Editeurs associés.
  6. Sélectionnez Programmes externes, puis naviguez jusqu'à l'emplacement où CODE Designer (codedsu.exe) est installé.
    Remarque : Généralement, CODE Designer figure dans le répertoire racine c:\wdsc.
  7. Cliquez deux fois sur DEMO.CLP.
  8. Editez et sauvegardez le code CL pour manipuler la troisième option que nous venons d'introduire dans l'application en mode texte.

Etape 5 : Vérification de la syntaxe et de la source

A partir du menu principal, sélectionnez Source puis Invite, Vérification syntaxique ou Vérifier, selon le langage que vous utilisez.

Etape 6 : Compilation du projet en envoyant une construction

Comme l'opération implique seulement deux membres et ne requiert aucune étape de liaison, vous avez deux possibilités pour compiler les modifications de code. Vous pouvez compiler un membre individuellement ou l'ensemble du projet. La compilation d'un projet complet dépend du style de construction qui lui est associée.

Pour compiler un seul membre :
  1. Dans le navigateur de projet iSeries, cliquez sur le membre avec le bouton droit de la souris, sélectionnez Compiler et la commande de compilation à exécuter. Toutes les modifications sont insérées sur le serveur. La vue Liste des erreurs iSeries affiche les erreurs éventuelles.
  2. Lorsque vous vous connectez à un serveur via l'explorateur de systèmes distants, la liste des bibliothèques est récupérée à partir de votre profil sur le serveur. Vous pouvez modifier la liste des bibliothèques d'une connexion particulière en cliquant avec le bouton droit de la souris sur la connexion dans la vue Systèmes distants et en sélectionnant Propriétés. Ensuite, sélectionnez Sous-systèmes et Commandes iSeries. Indiquez la liste des bibliothèques et cliquez sur Ajouter.

Pour compiler l'ensemble du projet, cliquez sur le projet avec le bouton droit de la souris et sélectionnez Actions distantes > Envoyer la construction. Le comportement réel du processus de compilation dépend du style de construction associé au projet. Le style de construction par défaut pour les projets iSeries est celui des programmes CL.

Ce style de construction génère un membre COMPILE.CLLE dans un fichier QCLSRC contenant une entrée de compilation pour chaque membre source du projet iSeries. Pour ce tutoriel, cliquez avec le bouton droit de la souris sur un objet quelconque de ce projet et sélectionnez Actions distantes > Envoyer la construction. Cette action, avec la configuration par défaut, exécute les opérations suivantes :
  1. Génère le membre COMPILE.CLLE suivant :

  2. Envoie toutes les modifications du projet au serveur, notamment le membre COMPILE.CLLE nouvellement créé.
  3. Affiche une entrée de travail de construction dans la vue Etat du travail iSeries, indiquant qu'une construction a été envoyée.
  4. Envoie un travail pour compiler le membre COMPILE.CLLE dans la bibliothèque QTEMP et exécute le travail pour compiler le projet.
Cela génère deux objets requis : le fichier d'affichage DEMOLDA et le programme DEMOLDA. Une fois le travail terminé, ouvrez la vue Systèmes distants et régénérez la vue. La bibliothèque HELLOWORLD doit contenir les éléments suivants :



Si des erreurs se sont produites pendant la construction, vous pouvez cliquer avec le bouton droit de la souris sur l'entrée dans la vue Etat du travail iSeries et sélectionner Extraire les erreurs. La liste des erreurs iSeries apparaît et vous pouvez cliquer deux fois sur l'erreur pour ouvrir le membre correspondant.
Remarque : Si vous compilez plusieurs membres source à la fois, l'ordre de compilation correspond à l'ordre du type de membre défini dans la page Préférences d'exécution des commandes iSeries. Pour accéder aux préférences, cliquez sur Fenêtre > Préférences dans le menu de l'espace de travail. Développez Systèmes distants > iSeries et 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.

La commande de compilation générée dans le membre COMPILE.CLLE d'un type de membre spécifique correspond à la dernière commande de compilation utilisée dans la vue Systèmes distants ou dans le navigateur de projet iSeries, ou à la dernière commande sélectionnée via l'option "Sélection de la commande de compilation".

Etape 7 : Exécution de l'application mise à jour

Maintenant que vous avez compilé l'application en mode texte à jour, vous pouvez lancer son exécution.
  1. Cliquez avec le bouton droit de la souris sur DEMOLDA et sélectionnez Exécuter (sans invite) > Interactive. Vous devez sélectionner une exécution interactive car il s'agit d'une application en mode texte, et nous avons choisi l'option Sans invite car cette application n'a pas de paramètres d'entrée.
  2. Vous risquez d'obtenir un message d'erreur lorsque vous tenterez d'exécuter l'application. Cela est dû au fait que vous n'avez pas démarré le serveur de communication RSE. Pour corriger l'erreur, suivez les instructions figurant dans la fenêtre en incrustation.
  3. Vous obtiendrez la fenêtre en mode texte à jour suivante :

Résumé : Vous avez créé et peuplé un projet iSeries avec un code existant pour une application en mode texte. Vous avez édité et vérifié le code en local, puis renvoyé ce dernier sur le serveur. Enfin, vous avez envoyé une construction au serveur pour compiler votre nouvelle application native.