Principe de l’outil d’installation
L’outil d’installation se compose du programme XML2SRC et de la commande associée XML2SRC. L’outil permet de lancer l’installation d’un programme ou ensemble de programmes mis en ligne sur XDOCS400 sous la forme d’un fichier suffixé par XML.
Pour effectuer l’installation d’un programme ou ensemble de programmes utilitaires mis en ligne sur le site, vous devez donc disposer sur votre AS400 de l’outil d’installation présenté par le présent article, mais aussi d’un fichier suffixé par XML mis en ligne sur xdocs400 qui contient l’utilitaire à installer.
Il vous faudra indiquer à la commande XML2SRC :
- une bibliothèque où seront stockés les sources des outils livrés.
- une bibliothèque où seront stockés les objets compilés des outils livrés. Ce peut être le même nom que la bibliothèque source.
- le mode de débogage (par défaut *SOURCE) à prendre en compte lors de la compilation.
- le script d’installation mis à disposition sur le site pour l’un ou l’autre des outils proposés, que vous aurez téléchargé et mis dans un répertoire de l’IFS.
Objectif de l’outil d’installation
Le but pour nous est de disposer d’un moyen simplifié de mettre en ligne un ensemble de sources, facile à installer par les internautes, mais aussi il faut bien le dire, aisément exportables dans un script par les intervenants du site.
Fonctionnement général
Lorsque vous lancez la commande d’installation pour un script XML, l’outil :
- crée les bibliothèques sources et objets si elles n’existent pas.
- crée le répertoire de liage MYBNDDIR dans la bibliothèque des objets, si le script XML le précise, et s’il n’existe pas déjà .
- crée les fichiers sources traités dans le script XML.
- Supprime tous les membres sources qui sont traités dans le script XML, lorsqu’ils existent.
- Crée tous les membres sources qui sont traités dans le script XML.
- Exécute toutes les compilations des sources pour placer les objets dans la bibliothèque des objets.
Conseil d’installation des outils téléchargés sous forme de script XML
- Pour ne pas risquer de supprimer des sources et/ou objets qui existeraient sur votre AS400, nous vous conseillons de créer une ou deux bibliothèques spécifiques pour installer les outils que nous mettons en ligne : MYBIBSRC et MYBIBOBJ ou MYBIB seulement si vous comptez placer les sources et les objets au même endroit.
- Quel que soit votre choix, si vous installez plusieurs utilitaires, utilisez toujours l’outil d’installation en précisant la même bibliothèque objet, car dans le cas contraire, le répertoire de liage MYBNDDIR serait créé dans plusieurs bibliothèques.
Installation de l’outil sur votre AS400
- Le fichier joint au format zip contient le fichier xml2src.savf. Extraire ce fichier sous le répertoire C:\ de votre disque dur sous le nom xml2src.savf
- Attention, la V2 du fichier crée les fichier QRPGLESRC à 112 de long au lieu de 92. Préférez cette version.
- Ouvrez une fenêtre MSDOS
- Tapez FTP MONAS400
- Vous êtes invité à vous connecter. Entrez votre login utilisateur, puis votre mot de passe lorsqu’il vous est demandé.
- Vous devez obtenir le prompt FTP (>). Lorsque c’est le cas, poursuivez en entrant scrupuleusement les commandes suivantes (MYBIB est la bibliothèque AS400 où vous souhaitez copier le SAVF) :
- > quote site namefmt 1
- > lcd C:\
- > cd MYBIB.lib
- > binary
- > put xml2src.savf xml2src.savf
- > bye
Le SAVF doit maintenant se trouver sur votre AS400 dans la bibliothèque MYBIB. Tapez la commande suivante sur une ligne de commande de votre AS400 pour vous en assurer :
DSPSAVF FILE(MYBIB/XML2SRC)
Le savf contient un programme et une commande associée. Restaurez ces deux objets dans une bibliothèque d’outils (dans l’exemple ci dessous, MYBIB) avec la commande suivante :
RSTOBJ OBJ(*ALL)
SAVLIB(BIBDME)
DEV(*SAVF)
OBJTYPE(*ALL)
SAVF(MYBIB/XML2SRC)
RSTLIB(MYBIB)
Bon, c’est un peu fastidieux, mais une fois fait, les installations des différents utilitaires proposés seront facilitées.
J’ai installé l’outil, qu’est ce que j’en fait ?
- Placer le script XML d’installation de l’utilitaire téléchargé dans un répertoire de l’IFS. Par exemple /HOME/MYREP/XDOCS400_F4SQLV1M0.xml
- Placer la bibliothèque qui contient l’outil d’installation en ligne et tapez la commande XML2SRC + F4.
- Renseigner la bibliothèque qui accueillera les sources. Par exemple MYBIBSRC.
- Renseigner la bibliothèque qui accueillera les objets. Par exemple MYBIBOBJ.
- Laisser la valeur par défaut pour le mode de débogage.
- Renseigner le nom du script xml de l’utilitaire à installer, y compris le chemin de l’IFS.
- Cela vous donne une commande comme cela
XML2SRC BIBSRC(MYBIBSRC)
BIBOBJ(MYBIBOBJ)
SCRIPT('/home/myrep/xdocs400_F4SQLV1M0.xml')
L’installation se fait en interactif. Vous pouvez bien sur soumettre la commande en batch.
Un outil d’installation sans rien à installer, cela ne sert pas à grand chose. Donc, voici le premier utilitaire mis en ligne que vous pouvez installer via ce système : 422