| VERSION.CMD
| Version 1.21 - Juillet 2005

  VERSION (prcdemment SYSVER) est un programme REXX affichant les
  informations SYSLEVEL d'OS/2 dans un format simple et lisible. Il
  est destin  constituer une alternative utile aux deux commandes
  VER et SYSLEVEL : plus informatif que la premire, plus ais et rapide
  que la seconde.


UTILISATION

  Placez VERSION.CMD quelque part dans l'un des chemins figurant
  dans PATH.

  La syntaxe d'utilisation est :

      version [ <option> | <SYSLEVEL fichier> ]

  Vous pouvez soit indiquer le nom d'un fichier SYSLEVEL prcis, ou un de
  ces paramtres :

     /V   Sortie dtaille
     /?   Affichage des informations de version et d'usage

  Si vous indiquez un fichier SYSLEVEL (n'importe lequel de ces fichiers
  ira, du moment que le nom de fichier dbute par 'SYSLEVEL'), VERSION
  affichera les informations suivantes sur plusieurs lignes :

     * Le nom complet du fichier.
     * Le nom du produit dcrit par le fichier.
     * Identifiant de sous-systme du produit.
     * Identifiant de composante du produit.
     * Type de composante du produit.
     * Le numro de version du produit.
     * Le niveau de CSD (service) en cours du produit.
     * Le niveau de CSD (service) prcdent du produit.

  Lorsqu'il est lanc sans paramtres, VERSION affiche un rsum (nom de
  de produit, numro de version, niveau de service en cours et unit sur
  laquelle le produit est install, sur une seule ligne) des informations
  SYSLEVEL pour chacun des produits dtect parmi ceux lists ci-dessous.

  Si vous indiquez l'option /V, VERSION affiche les informations dans le
  format sur plusieurs lignes utilis pour afficher les informations d'un
  seul fichier, en faisant une pause entre les crans (de manire similaire
   la commande SYSLEVEL d'OS/2).

  VERSION tente de dtecter et d'afficher les produit suivants. Contrairement
   la commande SYSLEVEL d'OS/2 (qui recherche habituellement tous les
  fichiers SYSLEVEL de votre systme), il utilise une simple logique pour
  rechercher fichiers SYSLEVEL de produits dans les emplacements prdfinis
  lists. Ceci fait de VERSION une commande bien plus rapide que SYSLEVEL.

  Produit                              Emplacement du fichier SYSLEVEL
  ------------------------------------------------------------------------------
  Information du produit eComStation      <bootdrive>\OS2\INSTALL\SYSLEVEL.ECS
  Systme d'exploitation de base OS/2 IBM <bootdrive>\OS2\INSTALL\SYSLEVEL.OS2
  Pilotes de priphriques de base OS/2   <bootdrive>\OS2\INSTALL\SYSLEVEL.BDD
  Multimedia PM2 (OS/2 Warp 3 uniquement) <mmpath>\INSTALL\SYSLEVEL.MPM
  Support de protocoles et de cartes
                 de rseau local IBM OS/2 <ibmcom>\SYSLEVEL.TRP
  Applications TCP/IP                     <tcpip>\BIN\SYSLEVEL.TCP
  IBM LAN Server                          <ibmlan>\SYSLEVEL.SRV
  Partage de fichiers et
                     d'imprimantes (Peer) <ibmlan>\SYSLEVEL.PER
  IBM LAN Requester                       <ibmlan>\SYSLEVEL.REQ
  Gestionnaire de Profils Utilisateurs    <muglib>\SYSLEVEL.MUG
  LAN Server Advanced (HPFS386)           <bootdrive>\IBM386FS\SYSLEVEL.HFS

  VERSION dtermine l'unit d'amorage en utilisant la fonction REXX
  SysBootDrive si disponible, ou encore en analysant la variable
  d'environnement OS2_SHELL. Le chemin MMPATH est dtermin en vrifiant la
  variable d'environnement du mme nom.  Les chemins d'IBMCOM et IBMLAN sont
  lus tous les deux dans le fichier d'initialisation de produit rseau
  <bootdrive>\IBMLVL.INI. Et enfin, le rpertoire TCPIP est localis en
  recherchant INETD.EXE dans les chemins de la variable PATH.


TABLE DE NOMS DE PRODUITS

  partir de la version 1.2, une nouvelle option nomme "table de noms de
 produit" a t ajoute. 

 Nomalement, VERSION affichera la les noms de noms de produits tels qu'ils 
 sont lus depuis les divers fichiers SYSLEVEL. Cependant, si un fichier
 VERSION.TBL est prsent dans le rpertoire dans lesquel VERSION.CMD est 
 plac, VERSION tentera de lire les noms de produits depuis ce fichier. 
 Ce fichier devrait avoir un format ressemblant  : 

     SYSLEVEL.ECS;Serenity Systems eComStation
     SYSLEVEL.OS2;IBM Base Operating System Files
     SYSLEVEL.BDD;IBM Base Device Drivers
     SYSLEVEL.MPM;IBM Multimedia Presentation Manager/2
     SYSLEVEL.TRP;IBM Base Networking - MPTS Adapters & Protocols
     SYSLEVEL.TCP;IBM TCP/IP Services - Internet Applications
     SYSLEVEL.PER;IBM File and Printer Sharing - Peer
     SYSLEVEL.SRV;IBM OS/2 LAN Server
     SYSLEVEL.REQ;IBM LAN Requester Service
     SYSLEVEL.MUG;IBM User Profile Management
     SYSLEVEL.HFS;IBM LAN Server Advanced - HPFS386

 Ce format est assez vident. Chaque ligne fait rfrence  un produit 
 (sans ordre d'importance), et consiste en le nom du fichier SYSLEVEL 
 du produit, suivi d'un ";" et de la chane qui devrait tre affiche 
 comme nom de produit en mode "rsum". Un exemple de rsultat de sortie 
 vous est donn  la section Exemple ci-dessous. 

 Le but de cette fonctionnalit est de permettre aux administrateurs de 
 personnaliser la sortie de cette commande afin de mieux correspondre 
  leur environnement. Un nom de produit tel que "Convenience Package 
 - Systme d'exploitation de base OS/2 Warp 4" peut ne pas dire grand chose 
 aux utilisateurs, alors que "Systme d'exploitation de base OS/2" pourrait
 tre prfrable. Au lieu de vous forcer  utiliser mes propres noms 
 arbitraires pour chaque produits, j'ai dcid de vous laisser choisir les
 vtres. 

 REMARQUE : ceci s'applique  l'affichage de sortie par dfaut de VERSION 
 (en mode rsum) uniquement. En mode d'affichage dtaill, les noms de 
 produits des fichiers SYSLEVEL sont toujours utiliss. 

 Trois fichiers de table de noms sont fournis en exemple dans ce paquetage.  
 Ils portent les noms SAMPLE1.TBL, SAMPLE2.TBL, et SAMPLE3.TBL. Pour en 
 installer un, copiez simplement l'un d'entre eux vers VERSION.TBL dans le
 rpertoire dans lequel VERSION.CMD est plac. 


EXEMPLES

 Affichage par dfaut (rsum) : 

     [C:\]version

     Nom de la composante installe                    Version  Niv. Service   Unit
     -------------------------------------------------------------------------------
     eComStation Operating System 1.1                  1.1      XR0C004        C:
     Convenience Package - OS/2 Warp 4 Base Operati... 4.52     XR0C004        C:
     IBM OS/2 Base Device Drivers                      4.52     XR04503        C:
     IBM OS/2 LAN Adapter and Protocol Support         6.01     WR08708        C:
     IBM TCP/IP for Warp                               4.32     UN02206        C:
     IBM Peer for OS/2                                 5.2      IP08605        C:
     IBM OS/2 LAN Requester                            5.2      IP08605        C:
     IBM OS/2 User Profile Management - Client         5.2      WR08605        C:

 Affichage par dfaut (mme systme) avec une table de noms de produit 
 VERSION.TBL fournie (comme indiqu  la section prcdente) : 

     [C:\]version

     Nom de la composante installe                    Version  Niv. Service   Unit
     -------------------------------------------------------------------------------
     Serenity Systems eComStation                      1.1      XR0C004        C:
     IBM Base Operating System Files                   4.52     XR0C004        C:
     IBM Base Device Drivers                           4.52     XR04503        C:
     IBM Base Networking - MPTS Adapters & Protocols   6.01     WR08708        C:
     IBM TCP/IP Services - Internet Applications       4.32     UN02206        C:
     IBM File and Printer Sharing - Peer               5.2      IP08605        C:
     IBM LAN Requester Service                         5.2      IP08605        C:
     IBM User Profile Management                       5.2      WR08605        C:


 Affichage dtaill pour un fichier unique : 

     [E:\JAVA131\BIN]version syslevel.jtk

       E:\JAVA131\BIN\SYSLEVEL.JTK
       JDK Toolkit

       Id de sous-systme......: 1000
       Id de composant.........: 5648C9805
       Type....................: 0C

       Version.................: 1.31
       Niveau de CSD en cours..: XR05000
       Niveau de CSD prcdent.: XR05000


HISTORIQUE DES MODIFICATIONS

 1.21
   * Petite modification dans l'ordre d'affichage des produits (MPM est a 
     prsent affich avant BDD).
   * Ajout au paquetage de fichiers .TBL en exemple.

 1.2 (version prive)
   * Ajout de la fonction "table de noms de produits". 
   * Affichage amlior des noms tronqus pour le mode rsum. 
   * Amlioration de l'affichage en mode "dtaill (merci  Guillaume Gay
     pour la suggestion). 

 1.1
   * Premire version publique. Intgration des fonctions de la version 1.1
     jamais publie au prcdent programme SYSVER.CMD. 


INFORMATIONS LGALES ET RCLAMATIONS

  VERSION.CMD est un copyright (C) 2005 Alex Taylor. Vous tes libres de
  l'utiliser, de le distribuer et de modifier ce programme sans restriction
  except que les versions modifies doivent conserver ceci ainsi que les
  notes de copyright suivantes.

  La fonction ReadSysLevel() a t prise dans un script d'installation inclus
  avec le Kit de Dveloppement (SDK) OS/2 d'IBM, est est prsum tre un
  copyright (C) d'IBM Corporation. tant donn que ce mme code est disponible
  dans divers produits, gratuits ou protgs, et n'est pas toujours distribu
  avec un accord de licence, je suppose que mon utilisation de ce code de
  cette faon n'est pas inapproprie. Si IBM ou ses avocats venaient  faire
  cas de cette supposition, qu'ils me contactent  l'adresse lectronique
  ci-dessous.


AUTEUR

  Alex Taylor
  WWW :   http://www.cs-club.org/~alex
  ML :   alextaylor41[]rogers[point]com

TRADUCTION FRANAISE

  Guillaume Gay
  ML:  guillaume[point]gay[]bigfoot[point]com

