Présentation de WDSc.
(Websphere Dev. Studio CLIENT V5.0)



Fin BoTTom

WDSc est un produit IBM faisant partie du produit 5722WDS

Il est basé sur ECLIPSE, un IDE en licence publique d' initiative IBM, comprenant :.

Au dessus d'éclipse, IBM vend un produit WSSD , successeur de Websphere studio et de VisualAge pour JAVA.

il vous permet

WDSc, est la version Iseries de ce produit, livrée en V5 avec la V5R20 de l'OS/400 et comprenant :

 

Installation

  • Insérez simplement le premier CD ou le DVD

Windows Installer est installé et configuré, puis installation de WDSc.

  • Acceptez la licence

  • Confirmez le répertoire d' installation

 

  • Et cliquez sur Installer sur cet écran de confirmation.

l' installation se poursuit en deux temps comme précisé ci-dessus

  1. installation de websphere studio (WSSD), pour lequel il faudra indiquer les options choisies

  2. puis installation des extensions pour Iseries

       cette option (CD 3 & 4) s'exécute sans dialogue

  3. ensuite rebooter votre PC ...

    au redémarrage, on vous affiche cette fenêtre


    cliquez "Terminer l'installation..." si vous utilisez CODE/400 (y compirs CODE DESIGNER) ou VisualAge RPG,
    Ce qui ne nécessite pas de redémarrer votre poste

 

En cas de problème, allez dans panneau de configuration et demandez la réparation du produit...
puis rebootez encore votre PC.


allez chercher ensuite les derniers correctifs à ftp://ftp.software.ibm.com/as400/products/ad/wdt400/v5/sp/

particulièrement le fichier sp0/wdsc50sp0.exe, si vous êtes en 5.0, qui est un prérequis à l'installation des autres correctifs.
(pour plus de détails, voyez ftp.software.ibm.com/as400/products/ad/wdt400/v5/sp/501/readme.htm)

A noter :

Le site softlanding.com (http://www.softlanding.com/free_plugins) propose des plug-in
(gestion des spools et des messages) accessibles depuis la même perspective.

Découverte du produit

WDS Client affiche une fenêtre contenant des perspectives, chaque perspective contient des vues.

Une perspective correspond à un type de travail à réaliser (souvent un projet), comme :

Pour passer d'une perspective à l'autre :

  • la première icône permet d'ouvrir une nouvelle perspective
  • les icones 2 et 3 correspondent respectivement à :
    • RSE
    • WebFacing
  • La dernière, mise à jour du produit, est active

Revenons à la perspective RSE (celle par défaut dans le cadre d'une installation OS/400)

Nous pouvons ajouter des vues, par Fenêtre/Autres

Par exemple :

cela va ajouter deux nouvelle vues, donc deux nouveaux onglets :

Réorganisez et déplacez, si vous le souhaitez, puis sauvegardez cette organisation sous une nouvelle perspective :

    

 

Perspective RSE
 (ou Remote System Explorer)

 

A chaque lancement, le produit vous laisse le choix de l'endroit de stockage de l'espace de travail

Cochez la case pour ne plus voir cette fenêtre

Au premier lancement du produit , vous verrez :

.
vous pouvez fermer la page d' accueil, vous la ferez réapparaître à tout moment par :

• la première tâche, va consister à définir une nouvelle connexion , ici Iseries.

WDSc va vous demander (la première fois), un nom de profil. Ce profil vous permet de partager vos définitions lors d'un travail en équipe.

puis indiquez

  • un nom de profil :
    • le votre si vous souhaitez ne pas partager cette définition
    • Team (qui existe en standard) dans le cas contraire
  • le nom de la connexion et le nom du système AS/400 à connecter (hôte)
  • Une description pour cette connexion
  • s'il faut vérifier que votre système est accessible maintenant .

 

vous remarquerez les propriétés de cette connexion dans la fenêtre basse à gauche

, cette fenêtre affiche toujours les propriétés de l'élément actif.

 

Vous pouvez définir un utilisateur par défaut :


Vous verrez ensuite dans la fenêtre "systèmes distants" ce que WDSc appelle des sous-systèmes (rien avoir avec les objets *SBSD).

Sur chacun d'entre eux vous pourrez paramétrer votre connexion à l'AS/400


Particulièrement (comme sur les propriétés du système):

  1. la liste de bibliothèques à mettre en place (Addlible)
  2. la bibliothèque en cours (bib de création par défaut)
  3. une commande à lancer à la connexion
  4. Ainsi que les variables d'environnement à renseigner automatiquement.

Cliquons sur Objets Iseries

  • Vos bibliothèques...
    crée un filtre sur un nom (ou début de nom) de bibliothèque.
  • Vos objets...
    un filtre sur un nom d'objet (ou un nom gen* ou *ALL) dans une bibliothèque.
  • Vos membres...
    un filtre basé sur un nom de membre dans un fichier source.
  • Liste de bibliothèques permet de travailler à partir de *LIBL

• Filtre de bibliothèques

la grande différence par rapport à PDM, c'est que vous pouvez mémoriser plusieurs chaines consécutives.

toutes les bibliothèques commencant par PAI (PAI*) et celles commencant par CPTA (CPTA*), etc ...

Le filtre est ajouté :      
et à la première utilisation, il faut vous signer (l'utilisateur peut être déja renseigné)

Voilà le résultat , remarquez la hiérarchie bibliothèque/objets/membres

• Un filtre Objets

si vous indiquez *LIBL *USRLIBL ou *ALLUSR,

vous pourrez parcourir avec le bouton situé à droite :

sur la fenêtre de conception du filtre, vous pouvez aussi être sélectif sur le nom de l'objet (ou nom générique) et sur le couple type / attribut :

et vous pouvez aussi tester votre filtre (cliquez sur Tester, obtenir la liste)

 

résultat (tous les objets de la bibliothèque FORMATION9)

• Un filtre Membres


en cliquant sur Ajouter, vous retrouverez les différents critères possibles pour un membre source :
(y compris des filtres sur les types de membre)

Résultat (tous les membres source des fichiers Q* de FORMATION9)

 

 

• enfin l'option Liste de bibliothèques vous permet de travailler à partir de *LIBL
tout en offrant la possibilité de descendre au niveau objet puis membre :


Vous pouvez aussi passer directement des commandes OS/400, en utilisant la fenêtre Commandes :

tapez votre commande dans la zone de saisie :

les messages seront affichés dans la partie principale, suite à l'exécution :

 

Pour chaque élément, vous remarquerez la fenêtre propriétés :
(ici l'élement actif est une bibliothèque, contenant 99 objets)



Sur chaque élément, un menu contextuel est proposé (avec un clic droit)

Sur une biblitohèque :
  • Nouveau
    • création d'un fichier source
    • création d'un fichier message*
    • création d'une DTAQ*
    • création dune DTAARA*

  • afficher dans une table : afficher une liste (ici d'objets)

* : nouveauté V5



ces fenêtres peuvent être déplacées, de manière flottante :

ou au contraire en superposition (cela génère alors un nouvel onglet en bas du cadre)

pour revenir à l'affichage par défaut :

, il faut ensuite confirmer.

 

Retournons au menu contextuel :

Liste des zones :

ici un fichier physique ou TABLE SQL ici un DSPF.

A NOTER que pour les DSPF, l'arborescence (de l'objet) affiche aussi la liste des formats et des zones :

et dans la fenêtre propriétés, le détail d'une zone

et en V5R1, la liste des modules et des procédures ou fonctions, pour un pgm ILE

 

enfin, sur un membre source
   (ici un source de type DSPF)



La nouveauté V5 est la vue "TABLE Iseries", offrant un affichage et des options proches de PDM :


Choisissez Gestion puis liste de bibliothèques ,d'objets ou de membres .

(ici, membres)
Tapez directement vos critères (il ne sont PAS mémorisés)

la liste vous est affichée (dans le cadre en bas à droite, l'explorateur RSE reste affiché et inchangé)


Sur cette vue ,vous pourrez

C'est à dire filtrer

et vous positionner

Le bouton , permet de remonter d'un cran (des membres aux objets ou des objets aux bibliothèques),

un double clique sur une bibliothèque affiche sont contenu (même chose pour les fichiers sources)


Ce bouton ( ) rafraîchit le fenêtre, ceux là ( ) permettent d'afficher la liste précédente ou suivante .

Le bouton (s'il est inactif), rend cette fenêtre sensible au choix fait dans l'explorateur RSE




Les options disponibles sont les suivantes :


ainsi que VOS options personnalisées (comme PDM, avec les mêmes variables de substitution)

Ceci est valable aussi dans les filtres RSE, sous le même nom : Interventions de l'utilisateur

 

Vous retrouverez ici toutes les variables de substitutions PDM, particulièrement :

  1. &L la bibliothèque
  2. &N l'élement en cours (objet ou membre source)
  3. &F le fichier source
  4. &O la bibliothèque objets (de création)
  5. Ctrl+Espace lors d'une saisie vous affiche la liste complète


Le bouton "Modifier" permet de créer vos propres types de ressources (ensemble de types de source)

Ce dernier apparait maintenant sur la fenêtre Gérer les actions de l'utilisateur

Et voilà !

Autres nouveautés liées à la version 5 du produit :

 

Editer un membre source

pour éditer un membre source, pointez votre source dans l'arborescence et choisissez :

 

  1. LPEX, éditeur interne à WDSc
    (le plus moderne)
  2. CODE/400, éditeur externe et plus ancien.Il possède encore quelques atouts , mais gère mal les CL et les Commandes.

regardons le fonctionnement de LPEX :

il affiche une colorisation syntaxique et fonctionne (par défaut) comme SEU. [voyez Fenêtre/Préférence/LPEX editor]

les ordres admis sont I (insertion) D (suppression), C (copie), M (move) et A/B (After/Before) , etc..

, ce qui donne

 

• Pour vous déplacer, vous pouvez utiliser :

• F4 (ou Shift+F4) affiche l'invite, c'est à dire une aide à la saisie (ici sur du RPG4)

et fonctionne aussi avec du CL, par exemple : F4 sur une commande DCL dans un CLP

il s'agit d'une classe JAVA (la même que sous Operation Navigator) qui utilise une API OS/400 retournant la description de la commande au format XML (voir QCDRCMDDD sur Information Center).

 

Dans l'éditeur remarquez en haut , la première ligne de la fenêtre d'édition

qui vous indique :

Chaque modification peut être annulée par CTRL+Z.

Le menu Edition propose (en plus des traditionnels CTRL+C / CTRL+V et CTRL+X .) :

  • Recherche et remplacement (CTRL+F)
  • Recherche multi-membres (CTRL+H)
    sur les membre sources OUVERTS !
  • Sélection de la totalité du source (CTRL+A)
  • Sélection avancée

Exemple de sélection d'un rectangle:

vous pouvez ensuite :

un double clic sur un mot, sélectionne le mot en question :

 

• recherche par CTRL+F (échap. efface cette fenêtre) :

remarquez la case Expression régulière , qui permet des recherches avancées (comme sur Unix).


ces expressions régulières utilisent des caractères spéciaux :

. (le point) représente n'importe quel caractère

* indique un nombre d'occurrences consécutives du caractère précédent ,ou du groupe entre ( ), précédent .

par exemple :

a* veut dire a ou aa ou aaa (etc...)
.* veut dire n'importe quel caractères, x fois (x pouvant être zéro)

expr? : expr doit être présent entre 0 et x fois

expr+ : expr doit être présent entre 1 et x fois

expr1 | expr2: expr1 OU expr2 doit être présent

[abc] représente une série (ici un a, ou un b, ou un c)

[^abc] n'appartient PAS à la série

^ indique un début de ligne (^ab, si la chaîne ab est en début de ligne)

$ indique une fin de ligne

\ déspécialise le caractère suivant

ainsi "^fi[ic].*\.txt" recherche une ligne commencant par fi suivit de soit un i soit un c puis contenant plus loin .txt
(le deuxième point n'est pas une expression régulière à cause de \.)

• recherche par CTRL+H (sur les membres ouverts)

la fenêtre suivante s'affiche dans la zone de contrôle (en bas à droite)

 

Remarquez les flèches et , permettant de passer d'une occurence à l'autre dans l'éditeur.

• et enfin, les options de comparaison :

choisissez "Editer/Comparaison" :


(dans notre exemple, nous visualisons un TP donné aux stagiaires, quelques lignes sont à remplir)

puis sélectionnez le membre source à comparer

(le source choisi est le corrigé)

les différences sont alors affichées :

pour passer d'une différence à l'autre :

L'option effacer, reviens à l'affichage du premier source uniquement.

 

<>Si vous éditez plus d'un source, les fenêtres sont affichées en superposition ( ) et non en cascade. Pour déplacer une fenêtre soyez attentif au pointeur de la souris :

par exemple, nous cherchons à afficher deux sources en même temps l'un en dessous de l'autre (facon F15 sous SEU)

tant que nous survolons la fenêtre de l'éditeur, le pointeur indique un affichage en superposition

mais quand nous arrivons à l'intersection des deux fenêtres (ici, entre éditeur et vue table) le pointeur nous indique un déplacement possible.

résultat :

 

 

Là aussi, la V5 propose de nouvelles options :

• Vérification de syntaxe

Vous pouvez demander (option Fenêtre/Préférences) à voir en plus un résultat sous forme de listing :

ce qui vous affiche

• Affichage du source indenté (dans une fenêtre à part, non modifiable)

par contre vous pouvez demander un affichage rapide pour cette fenêtre,

clic droit sur la barre de titre , la fenêtre est alors masquée,

mais une icone apparait dans la liste des perspectives et permet de la faire réapparaitre à tout moment.


• Ctrl+Espace, pour obtenir l'assistant de contenu , qui vous affichera en fonction du contexte


la liste des ordres ou des fonctions (intégrées au langage ou vos propres fonctions)



ou bien la liste de vos variables


• si la ligne active est une spécif F, vous pouvez demander à voir la liste des zones dans une fenêtre TABLE


Mais vous pouvez aussi obtenir cette liste dans la fenêtre structure (complétement à droite)


Ainsi que la liste des DS, des champs, des indicateurs, des paramètres et des sous programmes

(un clic, vous transfert sur la ligne de déclaration)

• Contenu d'un /COPY

• Filtrer la vue (affichage partiel, utiliser l'option afficher tout pour annuler)

• Sous programmes


Utilisez ensuite les boutons + pour naviguer

• Instructions SQL

• Contrôles

• Aide contextuelle

F1, le curseur positionné sur CHAIN sur un source RPG, affiche l'aide associée.

Paramétrage et personnalisation du produit et de l'éditeur LPEX :

Le paramétrage se fait par Fenêtre/Préférences

• Association de fichier afin d'associer un traitement à une extension.
vous remarquarez qu'il peux y en avoir plusieurs

• Perspectives, permet d'ouvrir chaque perspective dans une nouvelle fenêtre

• Données, pour assigner un driver JDBC, par défaut

• Débogage Iseries, indique la vaelur par défaut de UPDPROD()

• Editeur, permet de choisir le comportament, par défaut de l'éditeur

• Analyseur syntaxique assure la correspondance entre un langage source et la classe Java associée dans WDSc.

• Association d'analyseur syntaxique fournit la correspondance entre un type de source et un langage.

• Options de comparaison de deux sources

• Options d'impression de source

• Options de recherche

• Internet pour définir les coordonnées du proxy (important pour les mises à jour)

• Système distant/fichiers, permet de définir le type de transfert à réaliser pour les sources

• Système distant/Iseries/ Analyseur d'éditeur LPEX
.

ICI vous trouverez des informations importantes concernant l'edition de source :

• Système distant/Iseries/ cache , indique les paramètres de mise en cache de l'invite des commandes

• Système distant/Iseries/ Options d'exécution de commandes

• Système distant/Iseries/ objet , permet de demander l'affichage du type d'objet en tant qu'extension

 

Tout ce paramétrage pouvant être exporter / importer (fichiers à l'extension .epf)

 

 

L'aide s'affiche par le menu "Aide/Table des matières de l'aide"et s'affiche dans une fenêtre à part (en V5):

• l'aide est classée par grands chapitres

  1. Development Studio Client for iseries vous affiche l'aide du produit (RSE)
  2. Informations sur la programmation de iseries contient la références des langages RPG, COBOL, ...
  3. les autres options représentent l'aide du produit de base WSSD orienté Java/JSP
• vous pouvez lancer une recherche globale


• ou bien utiliser recherche approfondie,
qui permet d'être sélectif

 

• le dernier onglet permet de faire un lien entre l'aide contextuel affiché sur certaines fenêtres
et le contenu de l'aide détaillé

Compiler un membre source

pour compiler un membre source, utilisez l'option suivante (toujours clic droit)

un DSPF (un seul choix)


 Un SQLRPGLE (choix multiples)

Gérer les commandes, permet de gérer la liste des commandes associées à un type de source

 

Si vous choisissez Compiler (et non Compilation sans invite)

Option *EVENTF, va générer un événement (une notion purement CODE/400 reportée à WDSc) afin de prevenir le produit que la compilation est terminée (elle est soumie par défaut) . Vous verrez alors :

puis dans les fenêtres basses :

le message d'erreur si la commande n'a pas aboutie

ainsi que la liste détaillée des erreurs

Un double clic sur l'une des erreurs, lance LPEX et affiche l'erreur dans son contexte.


enfin, si la compil. se passe bien vous verrez :

Une fenêtre vide

 OU la liste des messages d'info.


Voir la base de données

La perspective Explorateur de systèmes distants permet mal de travailler avec la base de données.

Passer des commandes

Pour passer des commandes utilisez l'option Commandes Iseries

ici, nous cliquons sur ajouter une bibliothèque, ce qui nous affiche l'invite (comme vu plus haut)

plus surprenante est la possibilité de lancer une commande dans un session 5250.

pour cela il faut lancer une session
(WDSc V4 fournissait un petit émulateur 5250 écrit en java, qui disparaît en V5)

lancez votre émulateur habituel et tapez :



Indiquez dans

 

La session 5250 est alors monopolisée et aux ordres de RSE (du client/serveur à l'envers).

Lancons ensuite une nouvelle commande
(cliquez sur votre(vos) commande(s) )

avec le bouton ajouter, indiquons la commande à lancer (vous remarquerez que l'on peut en enchaîner plusieurs)

 

Il faut indiquer :

  • la commande (éventuellement paramétrée)
  • s'il faut afficher l'invite à l'exécution (la commande sera mémorisée :  ?commande )
  • l'environnement
    • Normale
      Exécution dans le JOB serveur répondant à RSE sur l'AS/400
    • par lot (SBMJOB)
    • Interactif (dans une session 5250)
      implique ce que nous venons de voir

au lancement, il vous sera affiché :

effectivement, dans la session 5250

Cette fonctionnalité mise en place, nous pouvons aussi, lancer des programmes à partir d'une liste d'objets.
Par exemple :

  1. création d'une nouvelle commande ADDLIBLE sur la session 5250

  2. Exécution

  3. localisation du programme et lancement

  4. voilà !

    tout cela sera bien pratique pour le debug.

En cas d'erreurs, celles-ci vous sont affichées comme suit :

• Pour rendre disponible la session 5250 (couper le lien avec RSE) :


Gérer les travaux

Pour gérer les job sur AS/400, prenons l'option suivante dans l'arborescence :

Vos travaux actifs

affiche les travaux où vous êtes l'utilisateur
EN COURS...
Vos travaux

affiche les travaux où vous êtes l'utilisateur de démarrage
(comme WRKUSRJOB)

A partir de là, vous pouvez :

  • Déboger le JOB
    (voir le débogage avec WDSc)
  • arrêter le job
    *CNTRLD ou *IMMED
  • suspendre/libérer
  • et voir la LOG

cette dernière vous est affichée dans la partie basse de l'écran:

• Pour créer un nouveau filtre :

il faut nommer le filtre

Puis indiquez vos critères :


affichage initial

exemple

Résultat :

 

Vous aurez la même possibilité de gestion des interventions utilisateur

 

 

Gérer les fichiers IFS

Pour gérer les fichiers stream, utilisons la dernière option :

  • Système de fichiers montre les différents systèmes de fichiers montés à l'IPL.


  • Système de fichiers racine, travaille à partir de root ( / )


  • Accueil, à partir de /home

 

Vous pouvez bien sûr créer un nouveau filtre (c'est toujours le même principe)

  1. nommez le

  2. puis indiquez la chaîne de filtrage

  3. Résultat

Quand vous cliquez sur un fichier, cela lance l'application PC qui est associée à l'extension.

(IE ou Netscape pour .htm et .html, notepad pour .txt , etc...)

là aussi des actions peuvent être mémorisées :

(remarquez le type commandes Shell (comme QSH), permettant de passer des commandes type Unix

voici ce qu'affiche l'invite (ici la commande jar qui "zip" un fichier)

 

si vos filtres sont trop nombreux dans un sous-système, utilisez alors la notion de Pool.

un pool mémorise un ensemble de filtres, vos filtres actuels sont dans un pool nommé "Pool de filtres par défaut".

Commencez par demander la visualisation des pools

Ce qui vous affiche :

ensuite, définissez un nouveau pool

qui n'est défini que par un nom unique.
(ici le pool Formation contient un filtre de bibliothèques "Formation*")

si vous enlevez l'affichage des pools , tous les filtres sont à nouveau affichés de manière linéaire

 

l'intéret est de pouvoir organiser et partager (ou non) un ensemble de filtres entre plusieurs connexions.

Sur une nouvelle connexion, sélectez un sous-système et choisissez Sélectionner les pools de filtre...

la hiérarchie des composants RSE est la suivante :

le composant de plus haut niveau est le profil (Team/dft) :

+ Profils
 | 
 |---+ pools de filtres
 |    |
 |    |---+ filtres
 |         |
 |         |--- chaines de filtrage
 |
 |
 |---+ connexions
      |
      |---+ sous systèmes
           |
           |---+ références aux pools de filtres

 


Pour terminer, la notion de Projet Iseries.

il s'agit d'un projet au sens ECLIPSE du mot.

  1. Bénéficiant de sa propre perspective.
  2. Les sources étant stockés localement
  3. Pouvant faire l'objet d'une synchronisation dans le cadre d'un travail en équipe : il vous faut un produit additionnel. (pour gérer les versions, utilisez CVS , par exemple)
  4. Les éléments seront transférés sur votre AS/400 suivant une technique de "push" (c'est vous qui décidez du transfert).
  5. Vous pouvez associer au projet une commande de reconstruction (compilation globale).

Choisissez Nouveau/ Projet ..

indiquez un nom et une bibliothèque sur le serveur,

puis un système (en choisissant un nom de connexion),

enfin un style de création

Il s'agit d'indiquer comment doit se faire la recompilation du projet lors d'une action de push

 

vous pouvez créer un fichier source par Nouveau / fichier source iseries, cela va créer un répertoire local qui deviendra un fichier source sur l'AS/400 au prochain "push", ou bien importer un fichier source existant :

ce qui nous affiche :

 

pour transférer sur l'AS/400 (push)
(vous remarquerez la première option permettant la création de COMPILE.CLLLE)


la commande de compilation (CRTBDNRPG ou CRTRPGMOD, par ex.) est la dernière utilisée pour ce type de source.

  vous devez créer BIND.CLLE "à la main" et ces deux programmes seront compilés dans QTEMP et exécutés après le transfert

  lors du transfert, on détecte les conflits (source modifié dans le projet et sur le serveur) et on vous demande si vous confirmez.

Autre solution pour travailler, demander à voir les membres sources distants en cliquant sur le projet,

->

 

le fait qu'un membre source soit local vous permet de vous appuyer sur un produit de gestion de version (CVS par exemple), mais aussi tout simplement d'utiliser la notion d'historique local (implémenté pour les sources Java par exemple) et vous affichent les différents états (un état correspond à une sauvegarde) avec leur contenu.

 

Début Top

©AF400