Guide d'installation rapide de VSoup v1.2.8 et Yarn v0.92 pour OS/2

La traduction, les fautes et les erreurs sont de moi :-) 

V0.02

By Steve Withers                                         20 janvier 1996
   Internet Marketing Specialist
   IBM New Zealand
   steve.withers@ibm.net

Voici la seconde pré-version du Guide d'installation de VSoup et Yarn. Scott Katzer m'a fait plusieurs excellentes suggestions, et m'a envoyé ses propres scripts pour télécharger les news --- entre autre.

J'utilise VSOUP et YARN uniquement pour consulter les newsgroups USENET. J'utilise Post Road Mailer v1.03a pour lire mon courrier. Ces instructions n'indiquent pas comment configurer YARN pour recevoir du courrier --- bien que, bien sûr, je doive utiliser YARN pour faire parvenir mes réponses à des messages USENET auquels je souhaite répondre par mail. Je pense que ces instructions devraient fonctionner aussi pour le courrier, mais je n'ai pas essayé. Scott pense que cela doit marcher, parce que c'est très proche de sa propre configuration. Essayez, et faites-moi part de votre expérience.

Ce n'est peut-être pas la procédure d'installation la plus élégante ou intelligente, mais je la mets à la disposition de ceux qui se sont demandés comment configurer VSoup et Yarn/2 en n'ayant que les documentations fournies à leur disposition. Ce guide est destiné à compléter les documents fournis, pas à les remplacer.

Contenu

Attention!!!!

Pensez à ajuster les IDs d'unité dans les scripts REXX de sorte qu'ils correspondent à votre installation. Assurez-vous que vos variables d'environnement contiennent les bons chemins et unités

NE TENEZ PAS COMPTE DES COMMENTAIRES DESTINÉS AUX CONFIGURATIONS MULTI-UTILISATEURS SAUF SI VOUS EN AVEZ RÉELLEMENT BESOIN. Vous pourrez toujours ajouter cette fonction après, lorsque vous vous serez habitués à Yarn et VSoup. De plus... je ne les ai pas encore testées. :-)

Fichiers nécessaires maintenant

D'abord, obtenez ces fichiers : 

vsoup128.zip - via ftp - hobbes.nmsu.edu   /pub/os2/apps/internet/suite
yrn2_092.zip           - hobbes.nmsu.edu   /os2/comm

(Les bibliothèques d'exécutions d'EMX)
emxrt.zip    - via ftp - hobbes.nmsu.edu   /pub/os2/dev/emx/v0.9c

(Les compacteurs/décompacteurs Info ZIP et UNZIP)
zip22x.zip   - via ftp - hobbes.nmsu.edu   /pub/os2/util/archiver
unz532.exe             - hobbes.nmsu.edu   /pub/os2/util/archiver

Vous pouvez également trouver ces fichiers sur de nombreux autres serveurs, mais j'ai personnellement vérifié ceux-çi.

Configuration initiale

  1. Décompactez le fichier EMXRT.ZIP. (Ne créez pas au préalable un sous-répertoire EMX, cela sera fait automatiquement --- sinon, vous obtiendrez \EMX\EMX..... :-)
  2. Assurez-vous que les DLLs d'EMX soient accessibles via votre LIBPATH. VSoup ne peut fonctionner sans elles. Je les ai placées dans x:\OS2\APPS\DLL.

    Vous pouvez supprimer le répertoire \EMX et son contenu si vous avez procédé comme moi --- ou mettez le répertoire \EMX\DLL dans votre LIBPATH, et ne le supprimez pas.

  3. Assurez-vous qu'UNZIP.EXE et ZIP.EXE soient accessibles via votre PATH. Je les ai placés dans x:\OS2\APPS.

    Créez les répertoires dont vous aurez besoin. Je les ai placés sur la même partition/unité. 

       md x:\souper
   md x:\yarninst
   md x:\yarn
   md x:\upload

Configuration de Souper

  1. Décompactez SOUPER??.ZIP ou VSOUP??.ZIP dans le répertoire x:\SOUPER ;
  2. Copiez SOUPER.EXE ou VSOUP.EXE dans x:\OS2\APPS --- ou quelque part dans votre PATH ;
  3. Supprimez le répertoire x:\SOUPER\SOURCE si vous le souhaitez ;
  4. Créez le fichier NEWSRC pour Souper dans le répertoire \SOUPER (le répertoire référencé par la variable d'environnement HOME). Spécifiez alt.test comme premier et seul newsgroup. Plus tard, vous pourrez ajouter ceux que vous désirez. Pour le moment, la seule ligne du fichier doit être : 
       alt.test:
    (NOTE: Spécifiez 'NO REPLY' dans le sujet des messages que vous postez dans alt.test --- sinon, vous recevrez des réponses automatiques pendant des jours et des jours...)

FACULTATIF : NE LE FAITES PAS SI VOUS N'EN AVEZ PAS BESOIN ! Cela ne fait que compliquer les choses.

Si vous souhaitez une configuration multi-utilisateurs, créez un répertoire \SOUPER\<utilisateur> et placez-y votre fichier NEWSRC. Vous aurez aussi besoin d'un répertoire \SOUPER\<utilisateur>\YARN contenant le fichier 'config' de Yarn (précisant vos préférences). Le fichier de configuration de Yarn est créé par la commande ADDUSER, que nous verrons dans la prochaine section. Vous pourrez éditer ce fichier manuellement par la suite. Le script MSOUP.CMD contient une instruction (non activée par défaut) qui vous permet de valuer la variable d'environnement HOME, afin que vous puissiez passer à une configuration multi-utilisateurs. Chaque utilisateur devra avoir son propre script 'Mutilisateur.CMD'.

NE LE FAITES PAS SI VOUS N'EN AVEZ PAS BESOIN ! Cela ne fait que compliquer les choses.

Configuration de Yarn

  1. Décompactez YRN2_0??.ZIP dans le répertoire x:\YARNINST ;
  2. À partir du répertoire x:\YARNINST, entrez : FRANCAIS x:\YARN ;
  3. Maintenant, supprimez le répertoire x:\YARNINST si vous le souhaitez ;
  4. Copiez YARN.EXE, IMPORT.EXE et EXPIRE.EXE dans un répertoire accessible via votre PATH. Je les ai placés dans \OS2\APPS ;
  5. Allez dans le répertoire x:\YARN et exécutez le programme ADDUSER. Remplissez le formulaire :
    1. Spécifiez le répertoire comme étant x:\SOUPER (à moins que vous ne soyez dans une configuration multi-utilisateurs... auquel cas il faut indiquer \SOUPER\<utilisateur>) ;
    2. J'utilise X comme éditeur (je déteste avoir des éditeurs qui apparaissent n'importe où). Comme je souhaite spécifier un fichier de macro-commandes, j'ai entré comme paramètre x.exe /Cyarn.
    3. Spécifiez le fichier/répertoire des réponses : x:\UPLOAD\REPLY.ZIP

      (Dans une configuration multi-utilisateurs, il faut changer cela, sinon, un utilisateur pourrait accidentellement remplacer les réponses d'un autre. Ce paramètre est défini dans le fichier 'config' de chaque utilisateur --- dont le lieu est contrôlé par la variable d'environnement HOME. Si elle vaut par exemple \SOUPER\FRED, alors le fichier 'config' se trouvera dans \SOUPER\FRED\YARN) ;

  6. Ajoutez au moins les variables d'environnement suivantes dans le fichier CONFIG.SYS : (Ce sont les seules dont j'ai besoin --- j'utilise les services Internet d'IBM.) 
       SET HOME=x:\SOUPER
   SET NNTPSERVER=news2.ibm.net
   SET YARN=x:\YARN
   SET TZ=EST5EDT  - ou une valeur approprié 
                     (Si cette valeur est incorrecte, vous 
                      pourriez obtenir une erreur 441, indiquant
                      que vous postez dans l'avenir)

    
   (dans une configuration multi-utilisateur, la variable HOME 
    devra être redéfinie dans chaque M<utilisateur>.CMD --- en 
    première instruction.)

The Home Stretch

Si vous avez opté pour VSoup, remplacez les appels à souper par vsoup. Selon votre liaison --- vitesse du modem, FAI, etc. --- vous pouvez ajuster le nombre de connexions simultanées, qui est de 4 par défaut en ajoutant comme paramètre -t n où n est le nombre de connexions souhaitées.
  1. Arrêtez puis relancez le système, afin que les variables d'environnement soient définies globalement ;
  2. Connectez vous à Internet ;
  3. Testez Souper. Exécutez cette commande pour marquer comme lus tous les messages sauf les cinq derniers. Je suggère juste cinq parceque, parfois, il peut y en avoir beaucoup, suivant qui a testé quoi... 
       souper -c 5  (Cela met à niveau TOUS les newsgroups du fichier NEWSRC)
  4. Si tout s'est bien passé...et c'est ce qui devrait être si tout a été correctement configuré, essayez de charger ces cinq messages : 
       souper -m -k 4096   (« -m » - ne pas s'occuper du courrier)
                       (« -k » spécifie le volume maximum à charger,
                        en Ko, avec « 0 » --- zéro --- indiquant PAS de 
                        limite.  La valeur par défaut est 2048Ko ---
                        environ 1000 messages.)

    Est-ce que quelques messages ont été chargés ? Vous devriez avoir vu quelque chose comme ça : 

    	[E:\souper]souper -m -k 4096
	souper:    5 unread articles in alt.test
	20%
    Parfait....vous y êtes presque.
  5. Maintenant, ajoutez les newsgroups que vous voulez dans le fichier NEWSRC du répertoire \SOUPER (ou \SOUPER\<utilisateur> dans une configuration multi-utilisateurs).

    N'oubliez pas de les mettre à niveau au nombre de message que vous pensez pouvoir suivre... en général pas plus de cinquante pour, disons, dix newsgroups. Cela fait cinq cent messages. Mais ce sont vos affaires...

    De même... si Souper essaye de charger des messages qui ne sont plus sur votre serveur de news, il pourra sembler ne rien faire, jusqu'à ce qu'il atteigne les messages qui seront encore sur le serveur.

  6. À partir de maintenant, vous devriez pouvoir utiliser les scripts qui suivent pour d'abord obtenir les messages, et ensuite envoyer vos propres messages et réponses.

Voici mes scripts MSOUP.CMD ('make soup') et SSOUP.CMD ('send soup') pour obtenir et envoyer les messages et réponses.

Ils peuvent être appelés à partir de n'importe quel répertoire s'ils sont accessibles via votre PATH. J'utilise un objet programme pour le faire, appelé OBTENIR NEWS.

(Si vous êtes dans une configuration multi-utilisateurs, alors spécifiez la valeur de la variable d'environnement HOME. J'ai inclu un exemple, en commentaire.)

J'ai placé ces scripts dans mon PATH, en x:\OS2\APPS.

MSOUP.CMD --- Obtenir les messages, et les importer pour Yarn

Si vous avez opté pour VSoup, remplacez la ligne 'souper -m' par 'vsoup -m -t 4' pour autoriser le chargement simultané de quatre articles (ajustez ce dernier nombre en fonction de votre serveur de news). 
/* MSOUP.CMD */

/* 'SET HOME=x:\SOUPER\STEVE' */ 

/* ** Change to my HOME directory ** */
'x:'
'cd \SOUPER'

/* ** Download the news ** */
'souper -m'

/* ** ZIP the news prior to import to YARN ** */
'zip -0m soup.zip areas *.msg'

/* ** Backup the downloaded news - just in case. ** */
'copy soup.zip soupbkp.zip'

/* ** import the news into Yarn - NOTE: import deletes soup.zip ** */
'import soup.zip'

SSOUP.CMD --- Envoyer les messages et les réponses

/* ** Upload Responses ** */

'x:'
'cd \upload'
'unzip -o x:\upload\reply.zip'

/* ** These statements backup my reply files "just in case". ** */
'copy reply1.zip reply2.zip'
'copy reply.zip reply1.zip'

/* ** Delete the reply file ** */
'del x:\upload\reply.zip'

/* ** Upload my news and mail responses. ** */
'souper -s'
'cd\souper'

Lancer Yarn

Maintenant, vous pouvez appeler Yarn de n'importe où pour lire les news (et y répondre). Ou, vous pouvez utiliser un object programme --- le mien s'appelle LIRE NEWS. Lorsque vous quittez Yarn, le fichier REPLY.ZIP que nous avons spécifié précédemment va être créé dans le répertoire x:\UPLOAD. (x:\UPLOAD\<utilisateur> dans une configuration multi-utilisateur.)

Vous pouvez consulter la documentation de Yarn (la version anglaise est plus à jour que la version française --- NDT) pour modifier les couleurs et ce genre de choses. Cela se fait en modifiant le fichier 'config'. Je trouve qu'utiliser Yarn ressemble beaucoup à TRN... surtout pour répondre et enchaîner.

YARN.X --- Macro-commandes pour X2

/* yarn.x -- macros for using X as Yarn's editor               971120 */

'EXTRACT /NAME'
If right(name.1,4) \= '.snd' then
  exit

'TOP'                                           /* Checking newsgroups*/
'/Newsgroups/q'
'EXTRACT /CURLINE/'
if pos('comp.',curline.1) > 0 & pos('.sex',curline.1) > 0 then
  'INPUT_ERRORLINE ***Warning: comp. and .sex found!***'
if pos('.test',curline.1) > 0 then
  'INPUT_ERRORLINE ***Warning: .test found!***'
if pos('fr.comp.os.os2',curline.1) > 0 then
  infcoo = 1

'TOP'
'MA 1 70 1 70'
'/Lines:/q'
'EXTRACT /CURLINE/'
if left(curline.1,6) = 'Lines:' then
  do
  'DELETE'
  '//flq'
  'DOWN'
  exit
  end

'BOTTOM'
'INPUT'
'INPUT Martin'
'INPUT --'
'INPUT lafaix@ibm.net'
'INPUT Team OS/2'
if infcoo = 1 then
  'INPUT http://www.mygale.org/~lafaix/os2.html'
else
  'INPUT http://www.mygale.org/~lafaix'

'TOP'
'//flq'
'UP'
'INPUT X-Newsreader: Yarn/2 v0.92'
'DOWN'
'DOWN'

Autres Outils

YEP (dans ftp.oce.com /incoming) - un programme OS/2 qui vous permet de modifier l'entête de vos messages pour ajouter des champs comme X-Newsreader, afin de faire savoir au monde que vous utilisez Yarn ! Scott Katzer l'a essayé, et a trouvé que ça marchait bien

YES (dans ftp.oce.com /pub/yarn) - «Un programme DOS qui a des fonctionnalités plus étendues que Yep. Je ne l'ai pas encore essayé.» (Scott dixit).

YarnUtil (dans ftp.oce.com /pub/yarn) - «un autre ensemble d'utilitaires. Je ne les ai pas encore essayés non plus.» (idem).

YarnDial (dans hobbes.nmsu.edu /os2/comm) - Pour se connecter et gérer les news avec yrn2_0XX et souper.

(c) Steve Withers - 1996 - All Rights Reserved.
Permission to distribute widely and for free is granted! :-)
[Document d'accueil OS/2 |Trucs et Astuces |FTP |Développement |Team OS/2 |(c)]

ML