---------------------------------------------------------------------------
                      -- T R A N S I T Y   A T A R I --

                                Version 2.1
                            Du 16 Janvier 1993.
---------------------------------------------------------------------------


Le protocole TRANSITY est copyright Européenne de Télématique.
(protocole adapté sur ATARI par I. Hernoux.)

Interfacage & routines générales : I. Hernoux.
Documentation & test             : Ch. Hernoux.



I) PRESENTATION.
----------------

TRANSITY ATARI est un logiciel de communication. Il vous permet de
tirer le meilleur parti de vos connexions sur les serveurs utilisant
ce protocole (MCOM, TILT, ATARI etc..).

Toute utilisation commerciale est interdite sans l'accord 
prealable de l'auteur.

La lecture de cette documentation est importante, elle vous permettra de 
tirer le meilleur parti de ce logiciel.

TRANSITY ATARI fonctionne sur tous types de materiels ATARI ST(e), TT, FALCON
en moyenne ou haute resolution.

L'archive contient TRANSITY.PRG - Le programme
                   TRANSITY.CFG - La configuration 
                   TRANSITY.RSC - Le fichier ressource
                   TRANSITY.HLP - L'aide



II) QU-EST-CE-QUE LE TELECHARGEMENT ?
-------------------------------------

Le telechargement est une operation qui consiste a transferer des 
fichiers entre un ordinateur et un autre, a travers un reseau de 
transmissions de donnees. Dans notre cas, il s'agit du serveur 
d'une part, et de votre ST(e) d'autre part, qui communiquent par 
l'intermediaire de Teletel, grace a un terminal 'le Minitel'. 

La perfection des lignes telephoniques n'etant pas encore de ce 
monde, il peut y avoir des imperfections lors du transfert. La 
premiere tache d'un protocole de telechargement est de s'assurer 
qu'il n'y pas eu d'erreurs, et dans le cas ou il y en aurait eu 
une, de redemander la partie du fichier dans laquelle il a detecte 
cette erreur.

La transmission de donnees a grande vitesse n'etant pas non plus 
accessible au commun des mortels, et encore moins aux utilisateurs 
du Minitel, le protocole de telechargement se doit d'utiliser au 
mieux les possibilites de ce terminal.

Mais dans l'absolu, la vitesse de telechargement reste faible, et 
un telechargement peut être relativement long. Il est donc 
agreable de pouvoir telecharger un fichier en plusieurs fois, ce 
qui est possible grace a la reprise (Crash Recovery) 
dont dispose TRANSITY ATARI. 



III) MATERIEL.
--------------

Tout d'abord, il faut que votre Minitel soit un M1B, un M10B, un 
M2, un M5 ou un M12. Les autres modeles (M1 et M10) sont d'une 
fiabilite toute relative, et nous vous conseillons de l'echanger 
contre un modele plus recent des que possible (contactez votre 
agence commerciale au 14, appel gratuit). Un test simple pour 
savoir quel est votre modele: cherchez les touches ESC, FNCT et 
CTRL. Si vous n'en avez pas, c'est que vous avez un M1 ou un M10 
(ce dernier ayant un telephone integre).

Ensuite, il faut que le Minitel soit relie au ST(e) par l'intermediaire 
d'un cable approprie. La connexion se fait par la prise serie du ST(e)
et par la DIN 5 broches sur le Minitel.



IV) INSTALLATION
----------------

Il est temps d'effectuer une copie de sauvegarde de la disquette 
originale de TRANSITY ATARI. Celle-ci doit être protegee en ecriture, 
afin d'eviter tout probleme (la petite "fenetre" dans le coin haut
gauche de la disquette doit etre ouverte). Prenez une disquette vierge, 
formatez-la en simple face, et copiez la disquette de TRANSITY ATARI
dessus. Si vous ne savez pas comment effectuer cette operation, 
consultez le manuel fourni avec votre ordinateur. Une fois la 
copie faite, mettez l'original en lieu sur, et n'utilisez plus que 
la copie que vous venez d'effectuer. Celle-ci ne doit par contre  
pas être protegee en ecriture (petite "fenetre" fermee).

Maintenant, placez la disquette de TRANSITY dans le lecteur A, et 
allumez le ST(e) (ou effectuez un "reset" en utilisant le petit 
bouton situe a l'arriere du ST(e)) et le Minitel. Vous devriez voir 
apparaitre a l'ecran une fenetre contenant en particulier 
TRANSITY.PRG. Double-cliquez sur ce dernier, et attendez le 
chargement de l'ensemble des fichiers. 
ATTENTION assurez vous que le fichier TRANSITY.RSC se trouve dans le 
meme catalogue (endroit) que le programme.

Si vous utilisez votre ST(e) en couleur, il est possible que le 
bureau apparaisse en basse resolution alors qu'il devrait etre en 
moyenne (en basse, les titres de la barre de menu en haut de 
l'ecran occupent toute la largeur, en moyenne, seulement la 
moitie). Si c'est le cas, allez dans le menu intitule "Options", 
et choisissez "Definir les preferences". Cliquez sur le bouton 
"Moyenne" et confirmez.

A l'ecran apparait alors la boite de dialogue principale de 
TRANSITY ATARI. Tout d'abord, il ne sera jamais precise quel bouton 
de la souris utiliser, ce sera toujours celui de gauche.

On peut immediatement separer ce menu en sept parties:

   1) Recevoir un fichier (Download)
   2) Emettre un fichier  (Upload)   
   3) Configurer RS 232
   4) Repertoire de sauvegarde
   5) Clavier
   6) Test du minitel 
   
   7) Quitter

Remarque
========
TRANSITY ATARI fonctionne en accessoire. Il suffit de renommer TRANSITY.PRG 
en TRANSITY.ACC, et de le copier,avec sa ressource, a la racine de 
votre disque de boot (disquette a inserer au demarrage ou partition 
C du disque dur).

Attention: le fonctionnement en accessoire peut poser de TRES gros 
problemes avec un TOS 1.0 (anciennes ROMs, reconnaissables a 
l'absence de repetition automatique des scrollings dans une fenêtre, 
sur le bureau par exemple).


V) TELECHARGEMENT.
------------------

Cette description est indentique pour le download et l'upload.
La seule difference est :
   - Download : le fichier a telecharger est choisi sur le serveur.
   - Upload   : le fichier a telecharger est choisi sur votre ordinateur.
   
Nous allons maintenant nous attaquer a la partie de communication 
proprement dite.

A l'aide de votre telephone, composez le 3615, et appuyez sur la touche
Connexion/Fin de votre Minitel.  Une fois sur la page d'accueil Teletel, 
tapez le code d'acces au serveur (ATARI par exemple).

Allez dans la rubique telechargement.

Apres avoir selectionne sur ce serveur le fichier a telecharger, un 
'clic' sur le bouton ou le texte "Recevoir" lance alors 
le telechargement. Les phases de telechargement proprement dites 
se materialisent par l'affichage d'une grande boite contenant de 
nombreuses informations sur le transfert en cours.

Dans cette boite, une ligne est importante. Elle se nomme Status Ligne
C'est elle qui vous indique le suivi du telechargement :

"Attente de transfert" indique que la demande du fichier a ete envoyee, 
et que TRANSITY ATARI attend de la part du serveur des informations 
confirmant le transfert, qui marquent le debut de celui-ci.

"Lecture information fichier" indique que le transfert lui-même est 
en cours,et precise le nom et la taille dudit fichier. 
Pendant cette phase, les informations suivantes sont affichees : 

* Nom du fichier a telecharger.
* Temps restant a telecharger.
* Nombre d'octets du fichier.
* Pourcentage de la taille du fichier telecharge.

* Affichage des trames recues et valides. 
  Celui-ci n'est donne qu'a titre indicatif, 
  il doit normalement evoluer de 1 a 32 de façon cyclique. S'il 
  s'ecarte de cette logique, il y a fort a parier qu'il s'est 
  produit un probleme, qui aura des repercutions sur le debit de transfert.
* Debit, en octets par minute, deduit des informations precedentes. 
  Celui-ci evolue generalement beaucoup au debut d'un transfert, et finit 
  par se stabiliser apres une dizaine de trames.
* Debit maximun constate.

Si vous desirez interrompre un telechargement, il vous faut simplement 
pressez la touche ESC. TRANSITY ATARI adresse alors au serveur un message 
le lui indiquant, et attend confirmation.  



VI) CONFIGURER RS 232.
----------------------

Vous retrouverez les reglages habituels de la RS 232. 

Je rapelle les commandes pour etre compatible Minitel :

 Mode        : Asynchrone
 Vitesse     : 1200 Bds
 Bits/Car    : 7 Bits
 Parite      : Paire
 Bit de stop : 1
 Handshake   : Aucun
 Duplex      : Half 
 
Ce sont les reglages par defaut.



VII) REPERTOIRE DE SAUVEGARDE. 
------------------------------

Avec cette option vous definissez, grace au selecteur de fichiers,
l'endroit ou sera sauvegarde le fichier telecharge. 
Par defaut c'est sur "A:\"



VIII) EMULATION CLAVIER.
-----------------------

Avec ce choix vous pourrez a partir du clavier de votre ordinateur emuler
le clavier du minitel.

IX) TEST DU TYPE DE MINITEL
---------------------------
Cette fonction vous permet de tester le type de minitel que vous possedez
et la liaison ST-MINITEL.
Vous pouvez quitter le test en cours en appuyant sur ESC.
Si le test se passe mal une boite d'alerte vous le signalera sinon une
autre boite vous indiquera les caracteristiques de votre minitel.




Softement votre ....

                      Janvier 1993.



MISE A JOUR
===========
      
Version           Date           
-------         -------- 
 5.5.0          02/12/91 
 . Fin de dev. de Transity en 'download'.
 
 5.5.0          20/12/91            
 . Interface Gem.
 
 5.5a           05/01/92
 . Configuration RS et repertoire de sauvegarde.
 
 5.5b           20/01/92
 . Correction bugs.
    - Affichage correcte des blocks recus.
    - Test chargement correcte RSC.
 . Test si place disponible avant le telechargement
 . Fonctions disque operationnelles.
 
 5.5c           17/02/92            
 . Corrections bugs.
    - Erreur dans le protocole de telechargement
    - Mauvaise reprise des blocks errones.

 5.5d           26/04/92
 . Corrections bugs.
    - Afichage correcte des textes status
    - Sauvegarde des parametres incorrectes
 . Ajout du test du type de minitel
 . Sauvegarde lorsque l'on quitte TRANSITY ATARI.

 5.5e           29/05/92
 . Corrections bugs.
    - Premier calcul du temps de telechargement faux.
    - Lors du test du type de minitel on ne boucle plus 
      si minitel non branche.
 . Plus ergonomique.

 2.0            14/07/92
 . Suite demande Atari France passage du numero de version 5.5e en 2.0.
 . Corrections bugs.
    - blocage des redraws intenpestifs lors de l'utilisation en ACC

 2.1            19/11/92
 . Suite demande Atari France
    - Emulation clavier.
    - Touche 'defaut' pour parametres configuration RS pour
      l'utilisation d'un minitel.
    - Une aide

 2.1            16/01/93
 . Corrections bugs.
   - Correction de l'affichage de l'aide dans la fenetre GEM.
   - Corection de l'envoi de la sequence d'arret par ESC.
     Si le telechargement s'est bien passé, on n'envoie pas la sequence
     d'arret de telechargement lorsque que l'on quitte la fenetre UPLOAD.
   - Lors d'un telechargement d'une liste de fichiers, il etait 
     impossible de telecharger les fichiers suivants si on se
     trouvait dans l'emulateur clavier. Les informations affiches 
    (temps de telechargement, nom de fichier) etaient fausses.
    
    
