Macro GETLIST pour programme TSTHOST

Mise à jour 04 / 2002

Le but de cet utilitaire, associé à des fonctions macro-commande de TSTHOST, est de permettre la récupération directe d'une liste des messages type "BBS FBB" sans utiliser le système de balise "UNPROTO LIST".

Le système "Unproto List" n'est véritablement efficace que si les stations sont effectivement à l'écoute "H24". On constate en pratique que ce n'est pas le cas d'où de très nombreuses demandes de "resynchro" et une multiplication des répétitions de trames <UI>. En effet à chaque mise en route d'une station il faut , de toutes façons , renouveler l'envoi de la liste à l'aide de nouveaux messages balises (!) ...

Cela se traduit généralement par une augmentation de l'encombrement de la QRG et un temps de mise à jour important de la "liste unproto" (ULIST). Il semblerait, par expérience, qu'il soit nettement plus efficace d'enregistrer la liste des nouveaux messages par une connexion directe au BBS.

La mise à jour dans TSTHOST sera faite à l'aide de l'option "MERGE" de la commande ULIST.

En utilisation locale on pourra ensuite réactiver le mode "liste unproto" (ULIST ENABLE) et bénéficier du "broadcast" durant toute la durée d'utilisation de TSTHOST.

Cas particulier de la récupération de liste BBS via réseau :
Cette méthode de récupération de la liste des messages "par connexion" est intéressante dans le cas où le BBS distant n'est accessible que par un réseau. Il faut alors programmer dans la partie "macro GETLIST"  la mise en place d'une connexion réseau.

Remarque importante :
Une gestion "connexion BBS via réseau"  permettant  la  récupération des messages sélectionnés (commande ULIST GET), ainsi que l'envoi de messages en "forward", est également à prévoir dans le fichier   <Votre_bbs>.CON   .

(Se reporter à la documentation de TSTHOST pour la programmation des fichiers du type ".CON" ).

 
Fichier macro TSTHOST.MAC et GETLIST.EXE :
Le programme GETLIST.EXE, que l'on placera dans le répertoire de TSTHOST, analyse le fichier <votre_bbs>.ULS  et va simplement extraire le numéro du dernier message de la liste.

Ce numéro sera incrémenté de 1 et servira à créer dans un fichier texte une ligne de commande qui sera envoyée au BBS .

Syntaxe: GETLIST <lecteur:chemin\votre_bbs.ULS> [/v]               ( L'option /v permet d'afficher le numéro de message ).

N.B.:  On peut objecter qu'en principe le serveur FBB connaît le numéro du dernier message lu, et qu'une simple commande "L" est suffisante. Par l'analyse du fichier .ULS on a  la certitude de bien synchroniser la liste TSTHOST d'une manière indépendante du serveur.


Téléchargement de l'utilitaire   GETLIST.EXE    (11Ko) .


Exemple d'utilisation :
Le  HOMEBBS déclaré étant F6FBB-1, le fichier "ULIST" sera F6FBB.ULS. On considère que le numéro du dernier message de cette liste est  54321.

L'appel   GETLIST C:\TSTH\F6FBB.ULS  va créer le fichier texte GETLIST.CMD qui contiendra la commande suivante:   " LR 54322- "

En expédiant ensuite le fichier GETLIST.CMD au serveur FBB on pourra de cette manière lister les nouveaux messages :-) .Il ne reste plus qu'à automatiser tout cela dans une "macro" que l'on insère dans le fichier texte TSTHOST.MAC.
 
 

Macro TSTHOST activée par la commande  getlist   et qui utilise ici le port radio no 1 :

##########################################
# Macro mise à jour ULIST (HOME BBS F6FBB)
##########################################
:getlist 1
10 ulist disable
20 del getlist.txt
30 run getlist c:\tsth\f6fbb.uls
40 waitdisc
50 connect F6FBB-1
60 delay 1
70 +waitstring 180 (1000) :F6FBB>
80 +record getlist.txt
90 +send c:\tsth\getlist.cmd
100 +iffilesend 100
105 +waitstring 3600 (1000) :F6FBB>
110 +say b
120 +waitdisc
125 delay 1
130 ulist enable
140 ulist merge getlist.txt
150 mabort
################# deconnexion
1000 DISC

################## FIN FICHIER MACRO ##############
 

Commentaires :

LIGNE 10  : On désactive la ULIST par précaution .
LIGNE 20  : On efface le fichier GETLIST.TXT qui est utilisé pour récupérer la
            liste des nouveaux messages . ( Ce fichier se situera dans le
            répertoire défini par la commande WORKDIR dans TSTHOST.CFG ).
LIGNE 30  : Analyse du fichier .ULS par GETLIST.EXE et création de la ligne
            de commande dans le fichier texte GETLIST.CMD .
            ( Option : /v pour afficher le numéro de message )
LIGNE 40  : On vérifie que le canal soit déconnecté.
LIGNE 50  : Connexion au BBS .
LIGNE 60  : Délais de 1 à 3 secondes (à tester) .
LIGNE 70  : Attente du "prompt" du BBS ( ici :F6FBB> ) pendant 180 secondes
            sinon "goto 1000" et déconnexion .
LIGNE 80  : On ouvre en enregistrement un fichier texte(ici GETLIST.TXT)
LIGNE 90  : On expédie le fichier texte GETLIST.CMD qui contient la commande
            "LR <numero_msg>- " .
LIGNE 100 : Par précaution boucle sur 100 pendant ce transfert.
LIGNE 105 : Attente fin transfert liste et du retour du prompt.
LIGNE 110 : Emet la commande "bye" vers le serveur.
LIGNE 120 : Attente déconnexion. ( Fermeture automatique de l'enregistrement )
LIGNE 125 : Délais 2 secondes
LIGNE 130 : Autorise maintenant le mode ULIST.
LIGNE 140 : Effectue la mise à jour de la liste à partir du fichier GETLIST.TXT
            par l'option MERGE de ULIST .
LIGNE 150 : Fin macro.
 
 

* IMPORTANT * IMPORTANT * IMPORTANT * IMPORTANT * IMPORTANT * IMPORTANT *

1) Ne pas oublier de MODIFIER la "macro GETLIST"  (à ajouter dans le fichier TSTHOST.MAC) en fonction de :

2) Dans le fichier TSTHOST.CFG  après le paramétrage des fonctions ULIST on précisera ULIST DIS  pour ne pas activer  les balises UI  de "synchro" dès la mise en route de TSTHOST.

3) Il faut  impérativement DÉSACTIVER le mode pagination au niveau du BBS.