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



Fin

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 WSSDA , successeur de Websphere studio et de VisualAge pour JAVA.

il vous permet

WDSc, est la version OS/400 de ce produit, comprenant :

 

Installation

  • Insérez simplement le premier CD ou le DVD

si Windows Installer n' est pas présent sur votre PC, il sera d' abord installé, puis WDSc.

  • Acceptez la licence

 

  • Confirmez le répertoire d' installation

 

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

l' installation se poursuit :

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

allez chercher ensuite les derniers correctifs à ftp.software.ibm.com/as400/products/ad/wdt400/v4/sp/html/update.html

RSE
(ou Remote System Explorer)

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 , WDSc va vous demander (si c'est la première connexion), un nom de profil.
ce profil vous identifie 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)
  • le type de système (ici iSeries)
  • votre ID utilisateur
  • Une description pour cette connexion.

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 voyez alors dans la partie haute, nommée "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 :

  1. la liste de bibliothèques à mettre en place (Addlible)
  2. la bibliothqèue en cours (bib de création par défaut)
  3. une commande à lancer à la connexion

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 (ou un nom gen* ou *ALL) d'objet 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 est déja renseigné en fonction de la connexion)

Voilà le résultat , remarquez la hiérarchie biliothè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 :


Vvous 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 click droit)

Sur une biblitohèque :
  • Nouveau : création d'un fichier source
  • afficher dans une table : afficher une liste (ici d'objets)



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'arboresence (de l'objet) affiche aussi la liste des formats et des zones :

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

 

 

enfin, sur un membre source
   (ici un DSPF)


Editer un membre source

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

 

  1. LPEX, éditeur interne à WDSc
    (gère mieux le CL)
  2. CODE/400, éditeur externe et plus ancien.plus puissnat pour le RPG et les PRTF/DSPF, mais
    gère mal les CLP 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 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'editeur 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 doucle click 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'occurences 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 suivantes 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.

Compiler un membre source

pour compiler un membre source, utilisez l'option suivante (toujours click 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 évenement (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 click 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.

 

Pour avoir de l'aide en général nous avons vu qu'il fallait ouvrir une nouvelle perspective (Perspectives / Ouvrir / Autres...) et choisissez Aide :

• l'onglet composant vous affiche l'aide général du produit (IDE, Editeur LPEX, RSE, etc...)

• l'onglet "outils classiques" affiche lui l'aide CODE/400, VisualAge RPG ET la syntaxe de chaque langage (sous la rubrique CODE)

• L'onglet recherche, propose une recherche approfondie.

ATTENTION , à la première utilisation, un index est construit (à peu près 15 Minutes)


puis :


Le bouton Avancée... propose de cibler votre recherche sur certains sujets uniquement.

 

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 fournit un émulateur 5250 écrit en java)

la fenêtre suivante va apparaitre.
(mais tout cela fonctionne très bien avec PC5250 ou tout autre produit)

Une fois signé(e), tapez la commande STRRSESVR :

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éér un nouveau filtre :

il faut nommer le filtre

Puis indiquez vos critères :


affichage initial

exemple

Résultat :

 

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...)

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 actuel 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éfinit 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 une commande de création
(laissez à blanc, si vous n'en avez pas)

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 un source sur l'AS/400 (push)

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

->

 

Début

©AF400