
             RXCLUS 5.0 - DOCUMENTATION (dcembre 1993)


                     ***  1. INTRODUCTION  ***


1.0. GENERALITES


       Le programme  RXCLUS sert  la rception en mode non connect
d'informations  transmises   par  le  systme  PacketCluster,  qu'il
s'agisse  de   celles  adresses     un   (ou  des)  utilisateur(s)
connect(s)  sur  un  cluster  ou  de  celles  changes,  selon  un
protocole spcial, entre deux serveurs PacketCluster. Cette dernire
possibilit est  particulirement intressante  de  nuit,  car  elle
permet de  recevoir les informations mme si aucun utilisateur n'est
connect sur le cluster.

       Les  informations  cluster  de  type  DX,  WWV  et  ANN  sont
identifies parmi  le flux  de  donnes  passant  sur  la  frquence
coute et elles seules sont affiches  l'cran. Chaque information
n'est bien  sr affiche  qu'une seule  fois  l'cran, mme si elle
est rpte  de nombreuses fois sur la frquence suite  la prsence
de plusieurs  utilisateurs. Ainsi, vous obtenez le mme rsultat que
si vous  tiez vous  mme connect  au cluster,  mais sans problmes
d'encombrement de  la frquence ou de rupture de link. Le partage de
la frquence  avec d'autres  applications (BBS,  etc...) ne  gne en
rien.

       Une restriction  bien sr:  n'tant pas  connect au cluster,
vous ne  pouvez pas  l'interroger ! Mais RXCLUS permet de pallier en
bonne partie   cet inconvnient: les informations DX et WWV peuvent
tre enregistres  dans des  bases  de  donnes  consultables  selon
divers critres  de recherche. Une base de donnes couvrant tous les
pays du  monde permet  de plus d'effectuer localement divers calculs
effectus par  les clusters:  azimut et  distance d'un  pays,  heure
locale, affichage des zones WAZ et ITU.

       Comme  vous  vous  en  doutez  peut-tre,  le  projet  de  ce
programme avait t lanc pour rendre service aux SWLs passionns de
DX, mais  RXCLUS peut tout aussi bien tre utile  l'OM licenci qui
n'a momentanment  pas besoin  de tous les services d'un cluster. Il
est par  exemple pratique  de laisser  "tourner" RXCLUS  pendant les
heures de travail et de retrouver sur son PC  son retour toutes les
informations qui ont t transmises pendant la journe.


1.1. DERNIERES AMELIORATIONS :


V4.0 :  adjonction  de  recherches  dans  les  commentaires  et  par
expditeur dans  la base  de donnees  DX, possibilit de ne recevoir
les informations  DX  que  sur  les  bandes  qui  vous  intressent,
informations 23  cm supportes,  nouvelle structure  plus souple  du
fichier de configuration, conomiseur d'cran.

V5.0 :  support multilingue  (franais, anglais et allemand fournis,
traduction dans  d'autres langues  possible par l'utilisateur), base
de donnes sur tous les pays du monde.


                     ***  2. INSTALLATION  ***


2.1. EQUIPEMENT NECESSAIRE.


- Un ordinateur compatible IBM (PC/XT/AT), monochrome ou couleur.
  Un disque dur est vivement conseill si vous souhaitez enregistrer
  les informations.
- Un TNC se branchant sur un port srie du PC et assurant lui-mme
  l'assemblage/dsassemblage des paquets (TNC-2, PK-88, PK-232,
  KAM, etc...). Les cartes internes (par exemple DRSI) ou les modems
  ncessitant un driver spcifique (comme BayCom) ne peuvent pas
  tre utiliss.
- Un rcepteur pouvant recevoir une frquence sur laquelle passe du
  trafic cluster (vers des utilisateurs ou vers un autre cluster).


2.2. COMPATIBILITE AVEC LES ANCIENNES VERSIONS.


       Les bases  de donnes de la version 4 (fichiers DXINFO.DAT et
WWVINFO.DAT) peuvent tre rutilises, alors que celles des versions
2.x et  3.x ne  sont  plus  utilisables,  le  format  ayant  chang.
Le format  du fichier  de configuration  RXCLUS.CFG est  nouveau. Si
vous avez  celui d'une ancienne version, quelle qu'elle soit, il est
conseill de  conserver sous  un autre  nom afin  de pouvoir  vous y
rfrer pour la personnalisation du programme.


2.3. INSTALLATION.


       Il suffit  de copier  le fichier  archive  auto-dcompactable
RXCLU50.EXE dans  le rpertoire  de votre  choix et de l'y excuter.
Vous obtiendrez alors les fichiers suivants :

RXCLUS50.EXE   programme excutable
RXCLUS.CFG     fichier de configuration/personnalisation
RXCLUS50.TXT   le fichier d'explications en franais
RXC50ENG.TXT   le fichier d'explications en anglais
MESSAGES.TXT   textes dans la langue choisie (par dfaut: anglais)
MESSAGES.FRA   textes en franais
MESSAGES.ENG   textes en anglais
MESSAGES.DEU   textes en allemand
COUNTRY.DAT    base de donnes des pays
DXINFO.DAT     base de donnes DX.
WWVINFO.DAT    base de donnes WWV


2.4. SUPPORT MULTILINGUE.


       La version  5.0 de  RXCLUS est  multilingue.  Trois  fichiers
langue sont fournis. Ils ont tous MESSAGES pour nom et une extension
identifiant leur  langue (FRA=franais,  ENG=anglais, DEU=allemand).
Pour choisir  une langue,  il faut  copier (ou  renommer, mais c'est
plus dangereux  !) le  fichier choisi  en MESSAGES.TXT. Par exemple,
pour que RXCLUS parle anglais, utiliser la commande:

                   COPY MESSAGES.ENG MESSAGES.TXT

       Il est  possible d'diter  ces fichiers  textes pour apporter
des modifications mineures aux phrases ou pour les traduire dans une
autre langue.  Prudence toutefois:  la  suppression  ou  l'ajout  de
lignes  empchent   le  dmarrage  du  programme  ou  provoquent  un
fonctionnement  anormal.   Crez  donc   avant  toute  tentative  de
modification une copie de scurit du fichier concern !

       L'auteur recevrait  avec plaisir des fichiers textes traduits
dans d'autres langues que celles fournies, ce qui permettrait de les
inclure avec les prochaines versions.


2.5. PARAMETRAGE ET PERSONNALISATION.


       Dans sa  nouvelle forme,  le fichier  RXCLUS.CFG contient des
lignes de commandes prcdes chaque fois d'un commentaire indiquant
sa fonction et les valeurs permises. Dans RXCLUS, il est possible de
changer presque  tout ce que vous pouvez vouloir changer (paramtres
de communication  mais aussi  couleurs, bandes qui vous intressent,
etc...). Les conventions suivantes sont utilises dans ce fichier :

- Les lignes de commentaires (qui doivent commencer par le
  symbole "#") et les lignes vides sont ignores par le programme.
- Les lignes de commande contiennent toujours un nom de paramtre,
  le signe "=" (obligatoire) et une valeur  attribuer  ce
  paramtre.
- Aucun commentaire ne peut tre ajout sur les lignes de commande.
- L'ordre d'apparition des commandes dans le fichier est sans
  importance.

       Si vous  souhaitez tester  le programme  le  plus  simplement
possible, vous n'avez le plus souvent mme pas besoin de modifier ce
fichier, ceci  pour autant  que votre  TNC soit  branch sur COM 1 
9600 Bd.  Vous pourrez  toujours effectuer  des adaptations  par  la
suite.


2.6. PARAMETRAGE DU TNC.


La quasi totalit des paramtres du TNC sont sans importance, sauf:

- MONITOR doit ABSOLUMENT tre ON
- Si, en mode Monitor, les lignes sont affiches les unes par dessus
  les autres, mettez AUTOLF sur ON.
- Si vous avez dfini MFILTER pour rejeter certains codes ASCII,
  veuillez  ce que les Ctrl-G (ASCII 7) ne soient pas dans la liste
  de rejet.



                     ***  3. MODE D'EMPLOI  ***


3.1 MODE RECEPTION :


       Ce mode  est actif  par dfaut  au lancement du programme. Il
permet de  recevoir les  informations DX  (sur les  bandes de  votre
choix), WWV et les annonces (selon configuration dans RXCLUS.CFG) au
fur et   mesure  de leur  passage sur  la  frquence  coute.  Les
informations  DX   et  WWV   sont  ajoutes  aux  bases  de  donnes
correspondantes si cette fonction a t active dans RXCLUS.CFG. Les
commandes disponibles sont :

F1    : affiche un rsum des commandes.
F2    : accs  la base de donnes DX (fichier DXINFO.DAT).
F3    : accs  la base de donnes WWV (fichier WWVINFO.DAT).
F4    : recherche DX par indicatif ou fragment d'indicatif.
        Par dfaut, la chane de caractres entre est recherche au
        dbut des indicatifs. En faisant prcder ou suivre ce
        fragment d'indicatif d'une toile (p.ex. *HB ou HB*), il est
        alors recherch en n'importe quelle position dans les
        indicatifs.
F5    : recherche DX par bande. La bande doit tre entre en MHz.
        Pour les bandes s'tendant sur plusieurs MHz (10, 6 et 2 m
        ainsi que 70 cm), chaque segment de 1 MHz fait l'objet d'une
        recherche spare (p.ex. 144 MHz entrane la recherche de
        144  145 MHz et 145 MHz celle de 145  146 MHz, ce qui
        permet d'isoler les informations satellite).
F6    : recherche DX selon les commentaires accompagnant les
        informations DX. Utile par exemple pour rechercher les infos
        contenant une route QSL.
F7    : recherche DX selon l'expditeur des informations.
F9    : sortie temporaire en DOS (DOS-Shell). Si l' conomiseur
        d'cran a t activ, il est dsactiv temporairement
        pendant la sortie en DOS.
F10   : Affichage d'informations sur un pays dsign par un prfixe
        (deux lettres suffisent en gnral) : zones WAZ et ITU,
        latitude et longitude, distance et azimut, heure locale
        (heures d't non prises en compte).
Up    : accs au mode revue avec visualisation de la dernire page
        d'informations reues.
PgUp  : accs au mode revue avec visualisation de l'avant-dernire
        page d'informations reues.
Home  : accs au mode revue avec visualisation de la plus ancienne
        page d'informations reues.
Alt-G : commute l'utilisation du son lors de la rception d'une
        information ou lors d'une modification d'une base de
        donnes.
Alt-M : accs au mode Monitor.
Alt-P : activation/dsactivation de l'imprimante (doit tre
        connecte sur LPT1)
Alt-X : quitter le programme.

       Toutes ces  fonctions peuvent tre aussi appeles au moyen de
la souris en cliquant sur le nom ou l'abrviation de la fonction sur
la ligne  suprieure ou sur la ligne infrieure. La touche droite de
la souris a presque toujours le mme effet que la touche ESC.


3.2. MODE REVUE :


       Possibilit de  revoir  les  informations  reues  depuis  le
dernier dmarrage  du programme.  Ces informations  (max. 400)  sont
stockes en RAM, d'o un accs trs rapide et une disponibilit mme
si l'criture sur disque n'est pas active.

       Les touches Up, Down, PageUp, PageDn et Home permettent de se
dplacer parmi les informations. Il est aussi possible d'utiliser la
souris en  cliquant sur  les mots  ou les  symboles reprsentant ces
fonctions sur la ligne en bas de page.

       Ce mode se quitte par Esc, End, ou en cliquant sur FIN:ESC.


3.3. MODE TRAITEMENT DE BASE DE DONNEE (DX ou WWV) :


       Lors de  l'entre dans  ce mode, les 23 informations les plus
rcentes sont  affiches, l'une  d'entre elles apparaissant en vido
inverse.

       Les dplacements  dans la  base de  donnes  s'effectuent  au
moyen des  touches habituelles (Up, Down, PageUp, PageDn, Home, End)
ou au  moyen  de  la  souris  en  cliquant  sur  l'un  des  symboles
reprsentant ces  fonctions sur  la ligne  au bas de l'cran. Il est
aussi possible  de slectionner  directement  une  information  dj
visible  l'cran en cliquant sur la ligne correspondante.

Les fonctions de gestion suivantes sont disponibles :

F2 : EDIT : permet de modifier l'information en surbrillance, en
     gnral dans le but de corriger une erreur, et crit la
     modification sur disque.
F3 : MARK : marque l'information en surbrillance comme devant tre
     supprime. Ce marquage peut tre annul en utilisant la mme
     commande une seconde fois.
F4 : PURGE : supprime physiquement les enregistrements marqus de
     la base de donnes (aprs demande de confirmation). L'ancienne
     base de donnes est sauvegarde avec l'extension .BAK.
F5 : TRIM : tronque la base de donnes (aprs demande de confirma-
     tion), c--d. limine toutes les informations plus anciennes
     que l'information slectionne. L'ancienne base de donnes est
     sauvegarde avec l'extension .BAK.

Ces quatre fonctions peuvent tre appeles avec la souris, en
cliquant sur leur nom. La procdure EDIT impose toutefois l'emploi
du clavier.

Ce mode se quitte par ESC ou en cliquant sur FIN:ESC.


3.4. MODE MONITOR :


       Vous communiquez directement avec le TNC et voyez tout ce que
ce dernier  envoie   l'ordinateur. Les infos cluster qui pourraient
arriver   ce moment  sont mmorises  normalement.  Dans  ce  mode,
RXCLUS fonctionne  comme un  terminal rudimentaire (sans possibilit
de revoir  le trafic  ayant dj  disparu de l'cran, etc...). Cette
fonction n'est  en principe  prvue qu' des fins de contrle du bon
fonctionnement de la liaison TNC/ordinateur ou pour pouvoir modifier
des  paramtres  du  TNC  sans  devoir  utiliser  d'abord  un  autre
programme;  il   existe  par   contre  de   nombreux  programmes  de
communication offrant de multiples commodits qui ne sont pas le but
de ce programme spcialis.

       Ce mode  se quitte  par Esc ou en cliquant sur "R" (pour mode
Rception) ou Fin:Esc.



               ***  4. RESOLUTION DES PROBLEMES  ***


4.1. PROBLEMES AU LANCEMENT DU PROGRAMME.


4.1.1.  Message   :  "Configuration  file  RXCLUS.CFG  not  found...
                     program aborted".

Le fichier RXCLUS.CFG est introuvable. Vrifiez qu'il se trouve bien
dans le mme rpertoire que le programme excutable.


4.1.2. Message  :  "Configuration  file  MESSAGES.TXT  not  found...
                    program aborted".

Le fichier  MESSAGES.TXT est  introuvable. Vrifiez  qu'il se trouve
bien dans  le mme  rpertoire que  le programme  excutable. Si  ce
fichier  n'est  pas  prsent,  copiez  le  fichier  MESSAGES.FRA  en
MESSAGES.TXT (cf. paragraphe 2.4).


4.1.3  Message  :  "Missing  line(s)  in  MESSAGES.TXT,  cannot  run
                    RXCLUS".

Le fichier MESSAGES.TXT est incomplet. Vous y avez peut-tre apport
une modification  malheureuse, ou  alors le fichier a t endommag.
Recopiez le  fichier MESSAGES.FRA  en MESSAGES.TXT  (cf.  paragraphe
2.5).


4.1.4 Message: "COM x non trouv".

Le port que vous avez spcifi dans RXCLUS.CFG n'est pas prsent sur
votre ordinateur.  Modifiez en  consquence la  ligne  "PORT  ="  de
RXCLUS.CFG.


4.1.5 Message commenant par: "*** RXCLUS.CFG :...".

Vous avez  spcifi une  valeur non admise pour le paramtre indiqu
dans la  suite du message d'erreur. Modifiez en consquence la ligne
incrimine dans RXCLUS.CFG.


4.2. PROBLEMES DE RECEPTION.


4.2.1   Aucune   information   reue   en   mode   rception,   mais
        fonctionnement normal en mode monitor.

- pas de trafic cluster sur la frquence coute
- le paramtre MFILTER filtre les Ctrl-G (code ASCII 7)


4.2.2. Communication  possible avec  le TNC  (en mode monitor), mais
       aucun trafic n'apparat  l'cran.

Mettez le paramtre MONITOR de votre TNC sur ON.


4.2.3. Mme  la communication  avec  le  TNC  en  mode  monitor  est
       impossible.

- Les  paramtres de  la communication  srie dans  RXCLUS.CFG  sont
  incorrects. Vrifiez les valeurs de PORT, SPEED, PARITY, STOPBITS,
  DATABITS et HANDSHAKE.
- Votre  type de TNC n'est pas utilisable avec RXCLUS (BayCom, DRSI,
  etc...), cf. paragraphe 2.1.


4.2.4. En  mode Monitor,  toutes les  lignes sont affiches les unes
       par dessus les autres.

Mettez le paramtre AUTOLF de votre TNC sur ON.



4.3. PROBLEMES DE BASES DE DONNEES.


4.3.1. Message inattendu "la base de donnes est vide".

- vous n'avez pas lanc RXCLUS depuis le rpertoire contenant les
  bases de donnes DXINFO.DAT ou WWVINFO.DAT (le PATH du DOS n'a
  pas d'effet pour les fichiers de donnes !).
- vous avez effac ou renomm par erreur la base de donnes.



                  ***  5. DROIT D'UTILISATION  ***


       Ce logiciel  appartient   la catgorie  "Freeware". Il  peut
tre  librement  utilis  et  copi,  pour  autant  que  les  copies
effectues soient  compltes et que l'indication de l'auteur ne soit
pas supprime ou modifie.
       L'auteur ne  cherche pas  en tirer un profit financier, mais
les utilisateurs  de la  rgion de  Genve qui voudraient manifester
concrtement leur  soutien peuvent, si ce n'est dj fait, adhrer 
l'IAPC (International  Amateur Packet  Club,  P.O.  Box  2435,  1211
Genve 2,  Suisse), qui exploite entre autres le DX-Cluster HB9IAC-8
et les digis qui y donnent accs.

       Les suggestion  d'amliorations  de  RXCLUS,  ainsi  que  les
traductions du fichier de messages,  sont toujours les bienvenues !

       Bonne  rception   des  informations  DX  et,  pour  les  OMs
licencis, ne  perdez quand mme pas totalement la bonne habitude de
vous connecter sur votre cluster prfr !


                                      Robert CHALMAS, HB9BZA
                                         Case postale 1225
                                          1227 Carouge/GE
                                              SUISSE

                                           MYBBS: HB9IAP
                                     Sysop DX-Cluster HB9IAC-8

