Speedware SWS Mode d'emploi

Volume 18 Numéro 2
Juin 2008
Contenu
1
Service d’audit de projets
de modernisation de
Speedware
2
Un mégadétaillant télévisé
est impressionné par les
services de Speedware
Speedware nous a permis
de réussir l’impossible
3
Le SWS, une véritable mine
d’informations
Le site Web du soutien
de Speedware contient
l’information qu’il vous faut
3
Congrès du GHRUG
Conférence du groupe
d’utilisateurs de Houston
au campus Clear Lake
3
Webémission de HP et
Encompass
Sommaire de haut niveau
des nouveautés du marché
e3000
4
Trucs et astuces pour
l’utilisation de Media
Nos experts vous montrent
comment tirer le meilleur
parti de Media
6
Où est passé le lien?
Speedware Autobahn II
vous permet de placer des
liens où vous le voulez
7
Comment tirer profit du
versionnage dans
Speedware
L’expert Michael Rusk
emploie le versionnage
pour les mises à jour et
le débogage
12 Nouvelle option -c de la ligne
de commande d’AMXW
Vous pouvez désormais
exécuter des instructions
nlsh sans être dans nlsh
Service d’audit de projets de modernisation
de Speedware
Afin d’affronter la concurrence actuelle, les
sociétés entreprennent des projets de
modernisation complexes et de grande
envergure visant à améliorer leur rendement
et à mettre à jour des systèmes informatiques
désuets. Selon la taille de l’organisation, ces
projets peuvent coûter des millions de dollars
et s’échelonner sur plusieurs mois ou plusieurs
années. Étant donné les coûts et le temps
requis, la réussite de ces projets constitue un
but qui est souvent difficile à atteindre.
Des études américaines ont démontré que 18 à
31 % des projets de TI sont annulés avant leur
achèvement et que plus de la moitié de ceux-ci
encourent des dépassements de coûts allant de
56 % à 189 %. Des chiffres récents montrent
que la tendance s’améliore, mais le nombre de
projets « mis en doute » demeure constant :
53 % des projets de TI sont terminés en retard,
sans que tous les objectifs aient été atteints.
Les enjeux étant si importants, les entreprises
doivent se munir de systèmes assurant la
réussite de leurs projets de modernisation.
Grâce au service d’audit de Speedware, vous
obtenez une évaluation objective d’un tiers
sur la viabilité de votre projet ainsi que des
recommandations contribuant à sa réussite.
L’audit de Speedware identifie les problèmes
et les défis typiques d’un projet de TI tout en
se concentrant sur la réussite de celui-ci.
Notre évaluation vous fournit aussi des
suggestions et des pratiques exemplaires
à suivre pour améliorer l’organisation et la
gestion de vos projets.
Les gestionnaires, les intervenants ainsi que
toute l’équipe de projet tirent profit d’une
évaluation qui démontre les aspects positifs
du projet ainsi que les points devant être
améliorés pour en assurer la réussite.
Un mégadétaillant télévisé est impressionné
par les services de Speedware
Information sur la
publication
Speedware — Une filiale en
propriété exclusive d’Activant
Solutions Inc.
6380, ch. de la Côte-de-Liesse
Bureau 110
Saint-Laurent (Québec)
Canada H4T 1E3
Tél. :
(+1) 514 747-7007
Téléc. : (+1) 514 747-3380
Courriel :
info@speedware.com
Heures d’affaires du soutien
technique
Comme toujours, de 9 h à 17 h
É.-U., Canada : 1 800 361-6782
Int. : (+1) 514 747-9494
R.-U. 0.800.96.77.14
Téléc. : (+1) 514 747-3380
Courriel :
support@speedware.com
Site Web du soutien
technique :
tsunami.speedware.com/
sws-fr.html
Marques de commerce
AMXW, DBmotion, Decision
Server, EasyReporter,
Esperant, Media, MobileDev,
Speedware, Speedware
Autobahn II, SpeedWeb et
Visual Speedware sont
des marques de commerce
de Speedware ltée.
Tous les autres noms de
produits sont des marques
déposées de leurs fabricants
respectifs.
© 2008 Speedware ltée
SPE-MKPROF18-F2
Versions courantes des
logiciels de Speedware
AMXW
DBmotion
Esperant
Media
Speedware
Speedware Autobahn II
SpeedWeb
Visual Speedware
Volume 18 Numéro 2
8.05.13
3.00.00
5.20.00
5.20.00
7.13.00
5.01.00
3.04.00
4.00.00
« On nous avait dit que ce projet serait impossible à réaliser dans le temps alloué. Or, Speedware
nous a permis de réussir l’impossible. »
Le « client » est un détaillant télévisé reconnu
comme étant un centre d’achats virtuel qui ne
ferme jamais. Un chef de file du marché,
l’entreprise diffuse des émissions thématiques
24 heures sur 24, 7 jours par semaine, attirant
plus de 100 millions de téléspectateurs à
travers le monde.
Le temps pressait
Un client Hewlett-Packard de longue date, le
détaillant utilisait les machines HP e3000 les
plus puissantes, mais les activités approchaient
leur capacité maximale. Qui plus est, HP
annonçait que la plateforme HP e3000 allait
être retirée du marché, deux situations qui ont
obligé la compagnie à trouver une solution de
migration et à l’implanter rapidement.
Vu la complexité de l’environnement
informatique, le service des TI de l’entreprise
a affirmé qu’il serait impossible d’implanter
une solution de migration dans le délai prévu.
À l’écoute du client
Trois critères étaient importants pour le client
dans son choix d’une solution de migration :
le temps, la performance et le risque.
D’abord, il était primordial que la migration soit
réalisée dans un délai de 12 mois. Le détaillant
avait besoin qu’une solution soit mise en place
à temps pour gérer la hausse de volume prévue
l’année suivante lors de la période des fêtes.
Le client accordait également une importance
capitale à la performance, car il fallait que les
applications migrées fonctionnent aussi
rapidement que les applications d’origine.
La transition ne devait pas non plus nuire au
temps de réponse.
Finalement, le client recherchait une solution
à faible risque. Chaque jour, l’entreprise traite
une quantité extraordinaire d’informations.
Ainsi, elle voulait adopter une approche de
migration qui assurerait la continuité de ses
opérations.
La complexité : un défi de taille
La complexité du système de TI de
l’organisation constituait le plus grand défi
du projet. Le centre informatique du détaillant
stocke des quantités impressionnantes de
données, atteignant parfois jusqu’à 19
téraoctets.
En outre, les applications étaient partagées par
trois des entités commerciales de la société.
Chacune de ces entités comportait des
différences régionales et la solution de
migration allait devoir en tenir compte.
Solution de migration de Speedware
Speedware a obtenu ce contrat, car en plus
d’offrir un prix attrayant, la compagnie proposait
une approche novatrice qui prenait en
considération les préoccupations du client.
Grâce à la solution proposée, le détaillant a
pu conserver ses bases de données et ses
structures sans avoir à les réécrire, ce qui a
permis de terminer le projet à temps. De plus,
le client a pu garder certains outils essentiels
à ses opérations.
Faits saillants d’une migration réussie
À la fin du projet, Speedware et le client étaient
conscients qu’ils venaient de réussir ce qui au
départ semblait impossible.
Speedware a complété le projet de migration en
respectant l’échéance. Le détaillant a donc pu
répondre à la hausse des transactions prévue
pour la période des fêtes. Grâce à de nouveaux
et robustes serveurs HP Integrity avec système
d’exploitation HP-UX, la fiabilité n’a
aucunement été compromise et le degré
de performance était supérieur à ce qui avait
été anticipé.
Plus de 2 millions de lignes de code ont été
migrées avec succès. Malgré la complexité
du projet, la transition de HP e3000 vers HP
Integrity s’est déroulée sans problème tout
en assurant la continuité des opérations.
2
Le SWS, une véritable mine d’informations
Le site Web de soutien technique de Speedware contient l’information qu’il vous faut
Le SWS en bref
•
www.speedware.com/sws
•
Recherche dans la
Knowledgebase accessible
à partir de la page d’accueil;
un clic suffit pour accéder
à la recherche avancée
•
Versions les plus récentes
des logiciels et de la
documentation
•
Envoi de notifications en
fonction du dossier
•
La fonction What’s New
vous permet de voir les
nouveaux ajouts depuis
votre dernier accès au SWS
•
Le Learning Center contient
des centaines d’articles
Le site Web de soutien de Speedware (SWS,
à l’adresse www.speedware.com/sws) est un
dépôt qui croît sans cesse et qui contient toutes
les informations relatives à Speedware. Par
exemple :
• Le SWS vous donne accès à toute la
Knowledgebase de demandes de services
de Speedware, pas uniquement celles que
vous avez soumises vous-même. Tous les
problèmes, améliorations, demandes ou
questions techniques sont saisis dans la
Knowledgebase, qui est accessible à tous les
clients pris en charge. Vous pouvez la consulter
en tout temps pour connaître le statut d’un
problème ou d’une amélioration à apporter.
• Le dossier Documentation contient tous les
manuels de référence, guides d’utilisateurs,
etc. Ce dossier était nommé Reference Library
auparavant.
• Des articles de nature technique sont
disponibles dans le dossier Learning Center.
• La fonction Advanced Knowledge Search vous
offre une liste de corrections de bogues
correspondant à la version précise d’un logiciel.
Vous pouvez utiliser cette fonctionnalité en
cliquant sur le lien approprié dans le coin
supérieur gauche de la page d’accueil du SWS.
Sélectionnez ensuite un nom dans la liste
déroulante Product et spécifiez la version dans
le champ Fixed in Version. Cliquez ensuite sur
le bouton View Results.
Outre ces fonctionnalités fort pratiques, le SWS
peut vous informer lorsqu’un correctif, une
nouvelle version ou un nouveau document est
disponible. Il vous suffit d’activer l’option Email
notification dans le SWS.
La fonction E-mail notification est définie pour
des dossiers individuels dans le SWS. Par
exemple, si vous aimeriez être avisé à chaque
fois qu’une mise à jour de Speedware version
classique est disponible pour la plateforme HP
9000, ouvrez simplement le dossier HP 9000
et activez la fonction Email notification. Vous
pouvez activer cette fonction en cliquant sur
l’icône prévue à cet effet dans la barre d’outils
du SWS ou en cliquant sur l’indicateur OFF
dans la ligne Email notification située dans
le coin supérieur droit du SWS. L’indicateur
changera pour ON et les notifications seront
activées pour le dossier en cours.
Gourou du SWS
Congrès du GHRUG
Webémission de HP et Encompass
Speedware a été un fier commanditaire du deuxième
congrès international annuel du Greater Houston Regional
Users Group (GHRUG). Cet événement de deux jours a eu
lieu les 14-15 mars 2008 au campus Clear Lake de
l’université de Houston.
Speedware a été parmi les invités d’une wébémission
présentant les nouveautés dans le marché de la
technologie e3000. Commanditée par Encompass et HP,
la webémission
ciblait le marché
européen et
présentait entre
autres des
nouveautés et des annonces importantes, en plus de
permettre aux clients et partenaires de savoir à quoi
s’attendre sur le plan de la R-D et du soutien au cours des
prochaines années. La webémission a eu lieu le 15 mai et
comportait aussi des discussions sur les migrations ainsi
que les partenaires et les outils en matière de transition.
La conférence de cette année comportait cinq lignes
directrices, dont deux étaient consacrées à la plateforme
HP e3000. Speedware a eu le plaisir de donner deux
présentations : une introduction à ses solutions de
migration ainsi qu’une session d’information sur la gestion
de portefeuilles d’applications (APM).
Volume 18 Numéro 2
3
Trucs et astuces pour l’utilisation de Media
Nos experts vous montrent comment tirer le meilleur parti de Media
Trucs et astuces
Les utilisateurs de Media
expérimentés font appel aux
trucs suivants pour accélérer
leur travail et assurer le bon
fonctionnement de leurs tableaux
de bord. Chaque truc est détaillé
dans cet article.
• Augmenter le nombre de
lignes retournées pour une
table SQL en augmentant le
nombre maximal de points
de données permis
• Définir le contexte pour
chaque utilisateur de
La Knowledgebase de Speedware contient
de nombreux trucs, conseils et astuces vous
permettant de gagner du temps et de
maximiser votre utilisation de Media et de
Media Web. Cet article présente plusieurs
des trucs les plus utiles.
Augmentation du nombre de lignes
retournées pour les tables SQL
Le nombre de lignes retournées par Media
dans une table SQL dépend du nombre de
points de données permis dans les graphiques.
Un point de données est une valeur unique
dans un graphique selon des coordonnées x/y.
Par exemple, un tableau de 10 rangées et de 5
colonnes compte 50 points de données. Dans
Media, la valeur par défaut pour les points de
données dans les tables est de 2000. Afin de
changer cette valeur, suivez ces étapes :
dimension Entrepôts est fixée à New York et la
dimension Années est fixée à 05.
Sélection de la langue au lancement de
Media
Media démarrera en anglais ou en français,
selon les paramètres régionaux définis sur
votre poste. Afin de changer la langue définie,
indiquez ce qui suit dans le raccourci :
chemin_vers_media.exe /lang:fr
ou
chemin_vers_media.exe /lang:en
Media Web
1. Cliquez avec le bouton droit sur l’arrière-plan
• Sélectionner une langue au
lancement de Media
• Résoudre les problèmes
du tableau de bord (ou cliquez sur le menu
Fichier) et sélectionnez Propriétés du tableau
de bord.
liés à la langue/culture avec
2. Cliquez sur l’onglet Graphiques.
Windows Vista
3. Sous Nombre maximal de points de données,
• Actualiser automatiquement
un graphique
• Charger adéquatement la
page d’introduction avec
Media Web
• Éviter l’erreur « Il n’y a plus
de licence disponible. »
• Assurer l’affichage de
toutes les données dans un
graphique Media.
augmentez la valeur de Tableau.
Définition du contexte pour chaque
utilisateur de Media Web
Lorsque vous installez Media V5.2 sur
Windows Vista et que vous lancez le
programme, vous pourriez obtenir l’erreur
suivante :
Unknown culture (en:-US), .NET system default
used
Vous pouvez utiliser un fichier de configuration
afin de définir le contexte pour chaque
utilisateur dans Media Web. Créez le fichier
dans le même emplacement que le fichier
users.dat. Appelez-le usersettings.ini. Le fichier
possède le format suivant :
Ouvrez alors les propriétés du raccourci (cihaut) et, dans le champ Target, enlevez les
deux-points supplémentaires qui ont été
ajoutés à la ligne. La ligne devrait alors être
la suivante :
[\vue_de_données\tableau_de_bord]
util=dimension=valeur dimension=valeur, etc.
Actualisation automatique d’un
graphique
Par exemple :
[\LBMDemo\LBMdemo.dsh]
admin=Entrepôts="New York" Années=05
Si vous désirez actualiser un graphique à
toutes les n minutes, cliquez à droite sur celuici, choisissez Propriétés dans le menu et
cliquez sur l’onglet Rafraîchir. Sélectionnez
l’option « Rafraîchir le graphique
automatiquement » et indiquez à quelle
fréquence le graphique devrait être actualisé.
Ceci précise le contexte pour l’utilisateur
« admin ». Chaque fois qu’un utilisateur admin
ouvre le tableau de bord via Media Web, la
Volume 18 Numéro 2
Pour éviter les problèmes liés à la
langue/culture avec Windows Vista
chemin_vers_media.exe /lang:en
4
Trucs et astuces pour l’utilisation de Media (suite)
Nos experts vous montrent comment tirer le meilleur parti de Media
Chargement de la page Intro.htm dans Media Web
[License]
Lorsque vous tentez de charger votre page Media Web V5, il se
peut que vous ne voyiez qu’un bouton de connexion, sans texte.
Afin de charger la page correctement, votre navigateur doit
accepter le langage JavaScript. Suivez ces étapes pour activer
JavaScript dans Internet Explorer :
LSServerIP=addresse_IP
LSServerPortNum=numéro_de_port
2. Assurez-vous que LSServerIP correspond à l’adresse IP où
License Server est installé, et LSServerPortNum spécifie le port
d’écoute du License Server (8187 par défaut). Cette information
1. Choisissez Tools > Internet Options à partir du menu principal.
2. Cliquez sur l’onglet Security.
3. Cliquez sur le bouton Custom level...
4. Défilez vers le bas jusqu’à la section Scripting.
a été fournie lors de l’installation du License Server. Au besoin,
vérifiez cette information auprès de votre administrateur de
système.
Notez que si vous spécifiez localhost en tant qu’adresse IP du
License Server, vous pourriez aussi recevoir le message d’erreur.
5. Activez la fonction Active scripting.
Il est toujours préférable de spécifier l’adresse IP réelle de
l’ordinateur.
Affichage de toutes les données dans un graphique
Media
Afin d’activer JavaScript dans Mozilla Firefox :
Si vous utilisez Media avec Decision Server dans une
configuration client-serveur, il pourrait arriver qu’un graphique ne
comprenne pas toutes les valeurs qui s’afficheraient en local
(sans Decision Server). Dans ce cas, essayez d’augmenter la
taille maximum des fichiers cache dans Decision Server:
1. Choisissez Tools > Options à partir du menu principal de Firefox.
1. Ouvrez le Gestionnaire de services Speedware.
2. Dans la boîte de dialogue Options, cliquez sur Web Features.
2. Sélectionnez le service approprié dans la liste. Il s’agit du service
pour le dépôt qui contient votre tableau de bord.
3. Cliquez sur Enable JavaScript.
Une fois que vous avez effectué le changement, chargez de
nouveau la page Intro.htm de Media Web V5. Elle devrait
s’afficher correctement.
3. Cliquez sur Modifier. Dans la boîte de dialogue Propriétés du serveur,
trouvez le champ Taille maximale des fichiers cache (octets).
4. Augmentez la taille du fichier et redémarrez le service.
Message d’erreur « Il n’y a plus de licence disponible »
Vous cliquez sur le bouton Connexion au serveur afin de lancer
Media Web, mais l’erreur suivante apparaît parfois :
Il n’y a plus de licence disponible.
Ce message s’affiche généralement lorsque Media Web ne peut
pas atteindre le License Server. Vous devez vérifier l’exactitude
de l’adresse IP du fichier ls.ini. Suivez ces étapes :
1. Ouvrez le fichier ls.ini à l’emplacement suivant :
C:\Documents and Settings\All Users\Application Data\
Speedware\Media5\
Vinay Sethi
Le fichier contient l’information suivante :
Volume 18 Numéro 2
Consultant au soutien technique
5
Où est passé le lien?
Speedware Autobahn II vous permet de placer des liens où vous le voulez
Speedware Autobahn II vous fournit une grande flexibilité pour la
création d’applications, de programmes et de liens. Les assistants
d’Autobahn font la majeure partie du travail pour vous. Par contre,
il arrive que vous vouliez effectuer certains choix par vous-même.
Par exemple, avez-vous déjà ajouté un lien avec le Link Wizard
d’Autobahn sans vouloir que celui-ci se retrouve au bas de la
liste? Le Link Wizard vous permet de placer un lien à l’endroit
de votre choix sur votre page HTML sans avoir à accéder au
Document Editor. Suivez simplement ces étapes :
1. Ouvrez le Document Editor de la page où vous créerez le lien.
Le Document Editor affiche le code HTML de la page.
2. Placez le curseur dans le code HTML à l’endroit où vous souhaitez
que le lien apparaisse.
Cette fonctionnalité est surtout utile lorsque vous développez des
pages Web, car vous n’avez pas à modifier les liens après les
avoir ajoutés.
Il arrive souvent dans une page Web que vous voulez incorporer
un lien dans un paragraphe de texte. Autobahn vous permet de
placer le curseur dans le texte et de créer le lien à cette position
exacte.
Quelques pièges
Vous pouvez placer les liens où vous voulez, mais faites attention
aux points suivants :
• En utilisant cette méthode, tout le code des liens est généré à
l’endroit où vous avez placé le curseur, et non pas à l’emplacement
par défaut. Vous devez éviter que des liens soient incorporés dans
d’autre code qui pourrait modifier le comportement de votre page.
3. Dans la fenêtre Application Map, créez un lien à partir du
programme en cours vers un autre programme.
4. Le code du lien apparaîtra dans le Document Editor à l’endroit
où votre curseur était positionné au lieu d’apparaître au bas de
• Tenez compte des SPWBLOCK, car ils déterminent parfois la
façon dont votre lien s’affiche ou si celui-ci apparaît ou non.
Faites-en l’essai. Cette fonction accélère et simplifie le
développement de pages Web dans Speedware Autobahn.
la page.
Tony Aversa
Consultant au soutien technique
Dans la page Web générée, le lien apparaît à
l’endroit exact où vous l’avez créé.
Pour un programme donné, ouvrez Document
Editor et placez le curseur à l’endroit où vous
voulez que le lien apparaisse. Utilisez ensuite
le Link Wizard afin de créer le lien dans la
fenêtre Application Map.
Volume 18 Numéro 2
6
Comment tirer profit du versionnage dans Speedware
L’expert Michael Rusk emploie le versionnage pour les mises à jour et le débogage
On demande très souvent aux programmeurs de supprimer des
fonctionnalités qui ne sont plus utilisées. La mesure de protection
consiste à conserver les segments de code de ces applications et
à les traiter en tant que commentaires. Par contre, au fil du temps,
le programme devient si chargé de données qu’il est difficile de
distinguer le code des commentaires. Il est alors avisé de créer
une nouvelle version, exempte de code désuet et facile à lire.
Plusieurs trouvent qu’il est compliqué de créer et gérer plusieurs
versions d’un programme, mais les avantages sont
considérables :
• Il est facile de revenir à la version précédente du programme sans
avoir à trouver et à supprimer tout le code non nécessaire.
• Vous pouvez supprimer le code désuet du programme sans perdre
le code nécessaire.
Je suis un grand partisan du versionnage, et ce procédé est facile
à mettre en application avec Speedware. J’ai eu la chance de
rencontrer Steve Reeve de Londres, qui est responsable de
l’architecture de Speedware Designer. Sa connaissance de
Designer et de ses outils et fonctionnalités dépasse largement
ce que le client moyen en retire. Son savoir est exposé ici en
partie pour vous permettre de tirer profit des avantages de
Designer en matière de versionnage.
de programme. Maintenant, dites-moi : est-ce possible de le
faire sans afficher le code si l’introduction et le journal des
changements sont intégrés au code réel? Ça me semble peu
probable, à moins que vous prévoyiez passer de longues heures
dans un centre de copies avec des ciseaux, de la colle et un
photocopieur!
À la fin de cet article, je vous montrerai le script Sysdoc qui vous
permettra d’avoir ce résultat, pourvu que vous soyez ouverts à
mes conseils et à la vision de Steve Reeve pour Designer.
Saisies d’écrans dans cet article
Les saisies d’écrans dans cet article proviennent du système
HP 9000 de Virginia International Terminals. Ce sont des
programmes de simulation conçus pour illustrer mes idées.
Implantation du versionnage dans Speedware
Commencez à partir de l’écran Application Definition et assurezvous que vous ne créez pas des applications avec *All inscrit
dans la liste de programmes, tel qu’affiché ci-dessous.
Importance de la documentation
En plus d’être un adepte du versionnage, je crois aussi
énormément en l’importance d’avoir une bonne documentation,
si bien que certains m’ont donné le surnom de Monsieur
Documentation.
Comme vous verrez dans cet article, un bon contrôle des versions
dépend beaucoup de la qualité de la documentation. À ce
chapitre, ma méthode est simple : j’utilise des modèles pour avoir
une longueur d’avance lors de la création d’un programme. Je
mettrai donc l’accent sur la documentation, mais gardez en tête
que c’est toujours dans l’optique d’avoir un bon contrôle des
versions.
Un dernier point : beaucoup des programmeurs de Speedware
insèrent les introductions de programme et le journal des
changements à un endroit quelconque dans le haut du code. Ils
le font par habitude, mais il existe une meilleure façon de faire.
Supposons, par exemple, que la haute direction vous demande
de produire un rapport pour un audit éventuel. Le rapport doit
contenir l’identification du programme, son nom, l’introduction,
le journal des changements ainsi que le format, mais aucun code
Volume 18 Numéro 2
N’utilisez pas *All. Vous devez indiquer vos programmes dans Application
Designer si vous voulez utiliser plusieurs versions.
Assurez-vous également que vous ne placez pas les
programmes d’une application dans la liste avec l’option Cascade
activée, tel qu’illustré ci-dessous :
N’utilisez pas Cascade. Rappelez-vous que tous les programmes
doivent être affichés
7
Comment tirer profit du versionnage dans Speedware (suite)
Comment déterminer qu’une nouvelle version est requise
Pourquoi ces restrictions? Je vous répondrai en vous posant une
question : vous êtes-vous déjà demandé à quoi servait la
troisième colonne nommée Substitute dans l’écran Application
Definition? Elle est destinée spécifiquement au versionnage.
Toutefois, afin d’en tirer profit, chaque programme de votre
application doit figurer dans la liste. Ainsi, vous savez exactement
quels programmes se trouvent dans l’application donnée et
surtout, n’importe quel programme de l’application peut être
substitué par un nouveau programme avec un nom différent.
Nouvelle version requise?
Comment décider qu’il est temps de créer une nouvelle version?
Il n’y a pas de réponse facile, car il faut tenir compte de plusieurs
facteurs.
Voici une liste de questions que je me pose afin de déterminer s’il
serait avantageux de créer une nouvelle version plutôt que de
modifier le programme existant :
1. Est-ce que le programme doit subir beaucoup de changements?
2. Les changements sont-ils majeurs?
Petite parenthèse au sujet des dépôts
Tandis qu’il est question de l’identification des programmes
contenus dans une application, j’aimerais m’adresser aux
programmeurs qui associent encore un seul dépôt de données
(design) à chaque application Speedware. Jusqu’à la version 5
3. La structure du programme est-elle mauvaise ou difficile à suivre?
4. Le programme est-il chargé de code désuet sous forme de
commentaires?
5. Le programme comporte-t-il un bogue? Dois-je ajouter le traçage
pour effectuer un débogage?
inclusivement, Speedware possédait une architecture dictant une
application par design. Cette restriction a été éliminée à la version
6, mais beaucoup de développeurs continuent toujours de s’y
soumettre.
Je crois que les programmeurs ont souvent peur de perdre leurs
programmes dans une vaste mer. Isoler leurs programmes en
utilisant une application par design semble être la solution logique.
Il s’agit en effet d’une solution, mais c’est sans doute la pire.
Pourquoi? Parce qu’ils gèrent alors plusieurs dépôts avec de
nombreux profils et catalogues, ce qui se traduit par la duplication
des définitions de bases de données et de fichiers et souvent par
la duplication de programmes. La duplication est déconseillée, car
elle engendre plus de travail et plus de problèmes. Steve Reeve a
créé une entité nommée Category pour chaque objet dans le
dépôt de Speedware.
Une fois que vous comprenez comment utiliser efficacement la
fonction Category dans Designer, vous verrez comment regrouper
logiquement des programmes et objets liés à une fonction
spécifique. C’est comme si vous aviez un design logique à
l’intérieur de votre design physique.
Volume 18 Numéro 2
Bien entendu, si vous n’avez qu’un changement mineur à
apporter, le versionnage n’est pas nécessaire, même si 3 ou plus
des énoncés ci-dessus s’avèrent exacts. Par contre, si le temps
vous le permet, vous pourriez tout de même créer une nouvelle
version simplement pour faciliter la lecture du code.
Lorsque le point 5 se révèle vrai, vous devriez toujours créer
une nouvelle version. Vous ne voudriez pas un programme de
production chargé d’instructions CREATE vers un fichier plat pour
suivre les événements et ensuite être obligé de les retracer après
avoir résolu le problème. Vous voulez simplement avoir une
version temporaire de débogage qui peut être utilisée à des fins
précises pour ensuite être remplacée par la version précédente.
Les rouages du versionnage : un exemple
Ma méthode de versionnage est-elle la plus efficace qui soit?
Je n’en suis pas certain, mais mon expérience au sein de
Speedware et les consultations que j’ai effectuées auprès de
nombreux clients importants m’ont permis de perfectionner ma
méthode. J’ai toujours constaté qu’elle facilitait le travail.
L’exemple que j’utiliserai dans le reste de cet article est très
simple et servira à démontrer les concepts fondamentaux du
versionnage dans Speedware. L’accent sera mis sur un écran
de client simple avec une version secondaire du programme ainsi
qu’un rapport de client et sa version secondaire.
8
Comment tirer profit du versionnage dans Speedware (suite)
Utilisation de Sysdoc pour faire le suivi de plusieurs versions
Première étape : la documentation
La documentation est essentielle au versionnage. Au bas de cette
page, le curseur du Program Definition pour l’écran Customer est
positionné sur le champ Sys Doc. La plupart des programmeurs
ne nomment pas leur documentation de système, mais nous
avons utilisé le nom CUSTSCRNSYSDOC. Lorsque vous utilisez
un nom, vous créez un objet de document indépendant qui peut
être référencé n’importe où dans Designer. Ce document vous
permet de faire le suivi de vos versions.
En fait, une fois que le document est lié au programme de base, il
sera préservé à chaque fois que vous copierez le programme afin
d’en faire une nouvelle version. Même si vous avez dix versions
différentes du programme, elles se partageront toutes le
document, lequel affichera les modifications historiques pour
chaque version. De plus, peu importe la version de programme
que vous ouvrez, la documentation et l’historique que vous voyez
seront toujours les mêmes, car le document est lié et partagé par
toutes les versions. Pas mal comme concept, n’est-ce pas?
L’écran en bas à droite affiche une partie de l’objet
CUSTSCRNSYSDOC. Il contient l’introduction de base du
programme, son nom, sa date de création ainsi que l’information
sur les versions (nom de la version de base et des versions
subséquentes). Cette information est importante, car le nom de
la version de base correspond au nom de programme utilisé
dans l’application d’origine, et Designer change ce nom pour le
nouveau nom que vous spécifiez. Voilà pourquoi le contrôle des
versions est si facile dans Speedware : vous n’avez pas à faire
un suivi de toutes les références (menus, touches de fonction,
logique, etc.) et changer tout le code CUSTOMERS pour
CUSTOMERS-V1. Qui plus est, vous pouvez créer le document
à partir d’un modèle. Ainsi non seulement le document est-il
cohérent et utile, mais aussi facile à créer : il suffit de remplir
les champs!
Deuxième étape : implantation de nouvelles versions
Après avoir créé de nouvelles versions de vos programmes,
implantez-les dans votre application Speedware. À la page
suivante, vous verrez de nouveau l’écran Application Definition,
qui différera un peu cette fois-ci. L’écran présente désormais tous
les programmes de l’application, ce qui signifie que vous pouvez
ajouter des versions à partir du champ Substitute.
Dans le document Sysdoc, saisissez toutes les données sur les
versions pour le programme afin de savoir quelle est la version
de base et pourquoi les autres versions ont été créées.
Dans PD, utilisez le champ Sys Doc afin
de donner un nom descriptif au document.
Ce document sera lié à toutes les versions
du programme et servira à consigner les
versions et les modifications.
Volume 18 Numéro 2
9
Comment tirer profit du versionnage dans Speedware (suite)
Implantation de nouvelles versions de vos programmes
Ci-dessous, vous pouvez voir que les versions plus récentes ont
été remplacées par les programmes originaux. Lorsque Designer
génère l’application, il code SCREEN-CUSTOMERS et REPORTCUSTREPORT dans le fichier spec mais effectue une
correspondance avec les nouveaux noms à travers tout le code.
Dans la liste des codes du fichier spec, Designer insère des
commentaires pour indiquer les nouveaux noms de sections.
Aussi souvenez-vous de toujours copier la dernière version d’un
programme lorsque vous créez une nouvelle version et de mettre
à jour la documentation en conséquence.
User Doc, un autre outil utile
Vous devriez aussi ajouter de la documentation sur les versions
dans le User Doc de l’application. Vous pouvez toujours voir les
versions dans la liste de l’Application Designer, mais si
l’application est volumineuse, il vous faudra peut-être naviguer
à travers de nombreux écrans afin de trouver ce dont vous avez
besoin. L’image ci-dessous présente le contenu de la portion User
Doc de l’application VERAPP. Cette documentation présente
simplement les programmes originaux ainsi que les versions
actuelles qui s’y rattachent. Gardez à l’esprit que le rapport
Sysdoc standard d’une application n’affiche pas les substitutions.
Toutefois, en plaçant les données dans les champs User Doc ou
Sys Doc, elles figureront dans le rapport AREP.
Cette méthode de versionnage repose évidemment sur une
documentation de qualité afin de faire le suivi du contenu d’une
application. Avec les outils de Designer et un peu de pratique,
vous y parviendrez facilement. L’avantage principal de cette
stratégie est la possibilité de revenir à n’importe quelle version
précédente en saisissant simplement le nom de programme de
la version précédente dans le champ Substitute, puis en générant
de nouveau l’application. Si vous n’avez qu’une seule version
précédente, supprimez simplement la valeur du champ Substitute
et vous reviendrez au programme d’origine.
Il se peut que vous souhaitiez mettre à jour votre dépôt lorsque
votre version originale devient trop désuète. Supprimez alors
l’original, copiez la version la plus récente vers le nom d’origine
et supprimez la substitution. Vous aurez ainsi un nouveau
programme de base comprenant toutes les révisions.
Les versions les plus récentes des
programmes sont indiquées dans le champ
Substitute
SCREEN-CUSTOMERS:LISTING;
(* Substituted by CUSTOMERS-V1 *)
(* Release Label (3) *)
SET TITLE ("Customer Master Screen");
SET WINDOW(ROW=2,COL=0,HEIGHT=19,WIDTH=80,LINE=SINGLE,FORE=BLACK,
BACK=MAGENTA,COORDROW=UP,COORDCOL=LEFT);
...
Le fichier spec indique où
les substitutions ont eu lieu
REPORT-CUSTREPORT:LISTING;
(* Substituted by CUSTREPORT-V1 *)
(* Release Label (1) *)
SET TITLE ("Customer Report");
SET WINDOW;
DCLPRINTER PRINTER ASSIGN(DEVICE=WINDOW,WIDTH=132,HEIGHT=60);
...
User Doc spécifie les
versions en cours d’utilisation
Volume 18 Numéro 2
10
Comment tirer profit du versionnage dans Speedware (suite)
Pour en revenir au fameux script Sysdoc...
Script Sysdoc
En résumé
J’ai presque oublié! Au début de cet article, je vous ai promis le
script d’un rapport indiquant l’identification du programme, sa
description, son format ainsi que la documentation Sysdoc. Afin
d’exécuter ce script, vous devez posséder une licence d’utilisation
des outils Sysdoc dans Speedware. Ces outils vous aident à
extraire des informations utiles du dépôt avec des scripts simples.
Il m’est déjà arrivé d’utiliser Sysdoc et User Doc pour produire le
manuel d’utilisateur complet d’une application que j’ai conçue
pour American Airlines. Le script est affiché au bas de cette page.
Cet article servait d’introduction aux capacités de Speedware
en matière de versionnage. Vous avez des lignes directrices
à suivre, telles que l’identification de tous les objets d’une
application et la création d’une documentation adéquate pour
assurer le suivi des versions, mais autrement les décisions vous
appartiennent.
Dans ce cas, le script présentera chaque programme dans le
dépôt dont la catégorie est « AR », le type de programme est un
« Report », et il indiquera la référence du programme, son nom,
la date et l’heure de la modification, la dernière personne qui a
modifié le programme, le format de celui-ci et finalement la
documentation du système.
Je suis d’avis que lorsque vous commencerez à comprendre les
concepts et les avantages du versionnage, vous y ferez appel
pour faciliter votre travail de développement. Même si vous
l’utilisez uniquement pour le débogage (où vous ajoutez du code
pour les programmes de traçage), le versionnage en vaut la
peine. Faites-en l’essai : vous ne voudrez plus vous en passer.
Michael Rusk
Virginia International Terminals, Inc.
#HEADING 0,2
Virginia International Terminals
Visual Programs Listing
=============================================================
#ENDHEADING
#FOOTING 2,0
=============================================================
!TIMESTAMP[1:12]
#ENDFOOTING
#FOR PROGRAM WHERE '!CATEGORY' = 'AR' AND \
'!TYPE' = 'REPORT' ORDER BY REF SELECTED
Program Reference: !REF____________ Program Name: !NAME
Modification Info: !MODTIME___________ !MODIFIER
Program Format
#
LISTFORMAT
# LISTSYSDOC
#ENDFOR
Volume 18 Numéro 2
11
Nouvelle option -c de la ligne de commande d’AMXW
Vous pouvez désormais exécuter des instructions nlsh sans être dans nlsh
Avez-vous déjà souhaité exécuter des instructions nlsh sans être dans nlsh? Désormais, dans
AMXW V8.05.12, l’option -c de la ligne de commande vous le permet.
L’avantage principal de cette fonctionnalité est la possibilité d’exécuter des instructions nlsh à
l’intérieur d’un script UNIX. Grâce à l’option -c de la ligne de commande, vous pouvez communiquer
de l’information entre l’environnement UNIX et l’environnement nlsh.
La syntaxe est l’une des suivantes :
nlsh -c instruction_amxw
nlsh INFO="-c instruction_amxw"
Le saviez-vous?
AMXW V8.05.12 comprend les
mises à jour suivantes :
Où instruction_amxw est :
• N’importe quelle instruction AMXW (BUILD, LISTF, etc.)
• !CMD (où CMD est une variable d’environnement déjà définie)
•
•
Option -c de la ligne de
• Des programmes AMXW
commande
• Des instructions UNIX
Soutien pour l’instruction
LIMIT avec HP-UX et AIX
•
Amélioration de la gestion
des fichiers spoule
•
• Des fichiers de commandes
La première forme de la syntaxe est normalement utilisée à l’extérieur de nlsh. Il est possible de
l’utiliser dans nlsh ou dans un fichier job, mais vous recevrez un message d’erreur si l’emplacement
est défini dans la variable HPPATH ou si votre répertoire courant est PUB.NEWLAB. Le message
d’erreur est le suivant :
Changement des
permissions
•
• Des commandes définies par l’utilisateur
Amélioration de
This is not a valid keyword for this command. (CIERR 10007)
Si vous devez utiliser nlsh -c à l’intérieur d’un environnement AMXW, vous pouvez éviter cette erreur
de deux façons :
l’instruction COPY
• Utilisez la deuxième syntaxe (avec INFO=), ou
•
et bien d’autres...
• Supprimez PUB.NEWLAB de HPPATH et ne travaillez pas à partir de PUB.NEWLAB.
•
Pour plus d’informations
Voici un exemple de base d’un script UNIX nommé TESTSCRPT qui est exécuté à partir de nlsh et
qui définit une variable globale dans votre environnement nlsh. Le SHOWVAR dans nlsh démontre
que la variable existe maintenant dans votre environnement nlsh.
sur les nouvelles fonctions,
voir les AMXW Release
Notes 8.05.12 sur le SWS
de Speedware.
::cat TESTSCRPT
echo mon script unix
nlsh -c "SETVAR ABC '123'"
nlsh -c "SHOWVAR ABC"
::TESTSCRPT
mon script unix
ABC = 123
::SHOWVAR ABC
ABC = 123
Volume 18 Numéro 2
12
Nouvelle option -c de la ligne de commande d’AMXW
Utilisation des barres verticales pour combiner les instructions nlsh et UNIX
Dans nlsh, les barres verticales UNIX vous permettent aussi de combiner les instructions nlsh avec
les utilitaires UNIX. L’exemple suivant montre comment utiliser la barre verticale UNIX et
l’instruction grep pour retrouver uniquement les fichiers binaires d’une instruction LISTF @,2.
::LISTF NEW@,2
À l’aide de la barre verticale
UNIX, l’instruction grep reçoit
les résultats de l’instruction
LISTF @,2 et recherche des
fichiers binaires fixes (FB).
ACCOUNT=
NEWLAB
FILENAME
CODE
NEWFILE
NEWFILE2
GROUP=
DEMO
------------LOGICAL RECORD----------SIZE TYP
EOF
LIMIT R/B
128W
72B
FB
FA
::nlsh -c "LISTF @,2" | grep " FB "
NEWFILE
128W FB
----SPACE---SECTORS #X MX
8
4
1023
1023
1
1
8
2
1
1
*
*
0
1023
1
0
1
*
Cet exemple affiche tous les fichiers ASCII à longueur fixe ne contenant aucun enregistrement.
Semblable à l’exemple ci-haut
nlsh -c LISTF @,2 | grep " FA " | awk '{ if ($4 == 0) \
print $1" " $2 " " $4 }'
L’exemple suivant montre comment utiliser les barres verticales UNIX pour interrompre toutes les
tâches planifiées ou en cours :
Cet exemple construit une
instruction que nlsh exécute
finalement avec l’option -c.
nlsh -c
| xargs
nlsh -c
| xargs
SHOWJOB | grep "#J" | grep "SCHED" | awk '{ print "ABORTJOB " $1 }' \
-n2 nlsh -c
SHOWJOB | grep "#J" | grep "EXEC" | awk '{ print "ABORTJOB " $1 }' \
-n2 nlsh -c
L’option -c gère aussi les arguments STDIN et STDLIST afin de rediriger respectivement les
données d’entrée et de sortie en utilisant des mots-clés MPE. Veuillez noter que l’argument
STDLIST doit pointer vers un fichier existant. Par exemple :
Ex. utilisant la première syntaxe
nlsh STDLIST=OUT -c LISTF NEWFILE,2
Même exemple avec la chaîne
INFO. Notez que seule
l’instruction est entre guillemets
dans la chaîne INFO
nlsh INFO="-c LISTF NEWFILE,2" STDLIST=OUT
nlsh STDIN=input_file
STDIN implicite
nlsh input_file
Nlsh peut aussi être utilisé en tant que shell implicite dans un script UNIX. Lors de l’exécution, UNIX
démarrera nlsh et tentera d’exécuter toutes les lignes qui suivent. Le fichier script peut donc
contenir toute instruction normalement disponible à l’invite nlsh. Par exemple :
La première ligne, débutant par
#!, identifie nlsh comme étant
l’interpréteur d’instructions
subséquentes dans le fichier.
#! ../../NEWLAB/PUB/nlsh
BUILD NEWFILE
touch unixFile
rm unixFile
LISTF NEWFILE,2
Tony Aversa
Consultant au soutien technique
Volume 18 Numéro 2
13
">