<h2>But de ce document</h2>
<p class="spip">Ce document me sert de <strong class="spip">mémo</strong> pour installer <strong class="spip">un</strong> <strong class="spip">terminal 5250 et une imprimante pour un AS400 avec tn5250</strong>. Ce mémo est testé sur une Debian Testing, mais il doit être possible de l’adapter aux autres distributions Linux.</p>

<h2>Pré-requis</h2>
<br /><li> Avoir installé une Debian de Base : <a href="http://www.coagul.org/article.php3?id_article=158" class="spip_out">http://www.coagul.org/article.php3 ?id_article=158</a>
<br /><li> Avoir installé KDE : <a href="http://www.coagul.org/article.php3?id_article=159" class="spip_out">http://www.coagul.org/article.php3 ?id_article=159</a>
<h2>Installation de TN5250</h2>
<h3>Installation / Lancement</h3>
<p class="spip">Le paquet tn5250 est un émulateur de terminal 5250 (AS400). Installation du paquet :</p>

<p class="spip"><code class='spip_code' dir='ltr'># apt-get install tn5250</code></p>

<p class="spip">Commande à exécuter pour se connecter à l’AS400 192.0.0.100</p>

<p class="spip"><code class='spip_code' dir='ltr'>$ tn5250 map=297 192.0.0.100</code></p>

<p class="spip">Commande pour lancer une console séparée</p>

<p class="spip"><code class='spip_code' dir='ltr'>$ konsole -e tn5250 map=297 192.0.0.100</code></p>

<h3>Fichier de configuration ( /.tn5250rc)</h3>
<p class="spip">Le fichier de configuration « <strong class="spip"> /.tn5250rc</strong> »  ou « <strong class="spip">/etc/tn5250</strong> » permet d’éviter de saisir de nombreux paramètres sur la ligne de commande. Par défaut ce fichier n’existe pas. Voici un exemple :</p>

<div style='text-align: left;' class='spip_code' dir='ltr'><code>MonAS400 {<br />
  host=192.0.0.100<br />
  map=297<br />
  green=white<br />
}</code></div>
<p class="spip"><strong class="spip">Remarque </strong> : La dernière ligne permet d’indiquer qu’il faut remplacer la couleur « green » par la couleur « white ».</p>

<p class="spip">La commande suivante permet d’utiliser ce paramétrage :</p>

<p class="spip"><code class='spip_code' dir='ltr'>$ tn5250 MonAS400</code></p>

<h3>Quelques raccourcis claviers utiles : </h3>
<div style='text-align: left;' class='spip_code' dir='ltr'><code>CTRL+q -> Pour quitter l'AS400 une fois sur la mire.<br />
CTRL+r -> Pour restaurer clavier après "Touche de fonction incorrecte"<br />
CTRL+a -> Touche ATTN<br />
CTRL+c -> Appel système<br />
CTRL+p -> Impression Écran<br />
CTRL+x -> Zone suivante en effaçant ce qu'il y a derrière le curseur<br />
TAB    -> Zone suivante </code></div>
<p class="spip">Dans la page de man de tn5250, tous les raccourcis sont indiqués, mais pour arriver à faire par un exemple un « M-a » qui correspond à ATTN, il faut faire :
<br /></p>
<li> Si le clavier est en majuscule : ESC et ensuite la touche a
<br /><li> Si le clavier est en minuscule : ESC et ensuite la touche majuscule et en même temps la touche a
<p class="spip">Pour faire F24, il est indiqué « M-+ » :
<br /></p>
<li> Si le clavier est en majuscule : ESC et ensuite MAJ + +
<br /><li> Si le clavier est en minuscule : CTRL + g et ensuite MAJ + +
<h3>Création de l’icône pour KDE</h3>
<br /><li> Clic droit dans la barre des taches et "Ajouter / Bouton Spécial / Application non KDE"
<br /><li> Mettre "konsole -e tn5250 map=297 192.0.0.100" dans "Exécutable"
<br /><li> Choisir une icône de terminal (ex : alevt)
<h3>Modifier la police par défaut de "Konsole" pour que l’affichage soit plus lisible</h3>
<br /><li> Depuis "Konsole" utiliser le menu "Configuration / Police / Personnalisée"
<br /><li> Sélectionner la police « Courrier New » fournie avec le paquet « msttcorefonts » en taille 17 (il ne faut pas utiliser une police supérieure à 17, car l’impression de l’écran ne tient plus sur une page).
<br /><li> Utiliser le menu "Configuration / Par défaut" pour sauvegarder.
<h2>Personnalisation des couleurs, de la police et du clavier avec xt5250</h2>
<p class="spip">xt5250 est un script permettant de personnaliser les couleurs et le clavier de tn5250.</p>

<p class="spip">xt5250 à besoin du terminal « <strong class="spip"> xterm </strong> » pour fonctionner correctement :</p>

<p class="spip"><code class='spip_code' dir='ltr'># apt-get install xterm </code></p>

<p class="spip">La commande suivante lance tn5250 dans un xterm avec quelques touches du clavier modifiées par défaut :</p>

<p class="spip"><code class='spip_code' dir='ltr'>$ xt5250 MonAS400</code></p>

<p class="spip">La personnalisation du clavier est faite grâce au fichier suivant :</p>

<p class="spip"><code class='spip_code' dir='ltr'>/usr/share/tn5250/XTerm</code></p>

<p class="spip">Par défaut, la personnalisation apporte au moins les deux améliorations suivantes :
<br /></p>
<li> La touche « Echap »  correspond à la touche « ATTN ». Il n’est plus nécessaire de faire CTRL+A.
<br /><li> La touche « CTRL » de gauche permet de restaurer le clavier (Équivalent CTRL+r).
<p class="spip">Pour personnaliser la police et les couleurs, il faut modifier le fichier « <strong class="spip"> /.Xresources</strong> » pour chaque utilisateur ou le fichier « <strong class="spip">/usr/lib/X11/app-defaults/XTerm</strong> » pour tous les utilisateurs. Voici par exemple les lignes que j’ai ajouté à la fin du fichier :</p>

<div style='text-align: left;' class='spip_code' dir='ltr'><code>!** Font Courrier et taille 13 pour tous les XTerm<br />
XTerm*faceName:Courier New<br />
XTerm*faceSize:13<br />
<br />
!** Taille 19, curseur clignote et gris pour xt5250<br />
xt5250*VT100.faceSize:19<br />
xt5250*VT100.cursorBlink:true<br />
xt5250*VT100.cursorColor:grey</code></div>
<p class="spip">Pour personnaliser le clavier, il faut modifier le fichier « <strong class="spip">/usr/share/tn5250/XTerm</strong> ».</p>

<p class="spip"><strong class="spip">Remarque </strong> : La première ligne permet de définir la police « Courrier New » pour tous les xterm et la deuxième définit la taille 19 uniquement pour xt5250.</p>

<p class="spip">La ligne suivante permet de prendre en compte pour chaque utilisateur les modifications sans être obligé de redémarrer X :</p>

<p class="spip"><code class='spip_code' dir='ltr'>$ xrdb -load .Xresources</code></p>

<p class="spip">ou pour tous les utilisateurs en même temps :</p>

<p class="spip"><code class='spip_code' dir='ltr'># xrdb -load /usr/lib/X11/app-defaults/XTerm </code></p>

<p class="spip"><strong class="spip">Remarque </strong> : Pour connaître les paramètres qu’il est possible de personnaliser, il faut regarder la page de man de xterm. Mais de nombreux paramètres ne sont pas pris en compte par xt5250.</p>

<p class="spip"><strong class="spip">ATTENTION</strong> : Suite à une mise à jour de Xorg, le chemin de configuration des « <strong class="spip"> xterm </strong> » a changé. Auparavant c’était « <strong class="spip">/usr/X11R6/lib/X11/app-defaults/XTerm</strong> » mais désormais, c’est « <strong class="spip">/usr/lib/X11/app-defaults/Xterm</strong> ». Dans mon cas , j’ai du créer manuellement le dossier « <strong class="spip">app-defaults</strong> » et le fichier « <strong class="spip">XTerm</strong> ». De plus, toujours suite à cette mise à jour, j’ai du créer le lien symbolique suivant pour faire fonctionner « xt5250 » car il ne trouvait plus la table des couleurs :</p>

<p class="spip"><code class='spip_code' dir='ltr'>ln -s /etc/X11/rgb.txt /usr/X11R6/lib/rgb.txt</code></p>

<p class="spip">Après ces modifications, il faut se déconnecter et se reconnecter de KDE.</p>

<h2>Utiliser « Konsole » comme terminal AS400</h2>
<p class="spip">Configuration de l’affichage :
<br /></p>
<li> Changer la taille de police : Configuration / Police / Sélectionner
<br /><li> Configurer l’encodage des caractères en ISO-8859-1 : Configuration / Encodage / ISO 8859-1
<p class="spip">Créer une nouvelle session pour accéder à l’AS400 :
<br /></p>
<li> Configuration / Configurer Konsole
<br /><li> Onglet « Session »
<ul class="spip"><li class="spip"> Nom = AS400</li><li class="spip"> Exécuter = tn5250 Prodstar</li><li class="spip"> $TERM = xterm</li><li class="spip"> Tabulation = Xfree 4.x</li><li class="spip"> Modèle = Couleur Linux</li><li class="spip"> Cliquer sur « Enregistrer la session »</li></ul>
<p class="spip">Cette nouvelle session est disponible dans le menu « Session »</p>

<p class="spip">Enregistrer les paramètres des sessions :
<br /></p>
<li> Avec le menu « Session », ouvrir une ou plusieurs sessions AS400
<br /><li> Menu « Configuration / Enregistrer les paramètres des sessions » et indiquer par exemple « Profil-AS400 » comme nom de session
<p class="spip">La commande suivante permet d’ouvrir une nouvelle Konsole en utilisant le profite « AS400 » qui lui même utilise une ou plusieurs sessions « AS400 » :</p>

<p class="spip"><code class='spip_code' dir='ltr'>$ konsole --profile Profil-AS400</code></p>

<p class="spip">Il est dons possible de créer une entrée de menu avec KMenuEdit qui exécutera cette commande et démarrera la session AS400</p>

<p class="spip">Pour remplacer l’icône de « Konsole » par un autre, il faut ajouter l’option « &mdash;icon » et indiquer l’icône :</p>

<p class="spip"><code class='spip_code' dir='ltr'>$ konsole --icon alevt --profile Profil-AS400</code></p>

<p class="spip">Pour supprimer dans le titre « Konsole », il faut ajouter l’option « &mdash;caption "" »</p>

<p class="spip"><code class='spip_code' dir='ltr'>$ konsole --icon alevt --caption "" --profile Profil-AS400</code></p>

<p class="spip">Pour que rendre ce profil disponible pour tous les utilisateurs, il faut le déplacer dans la partie système :</p>

<p class="spip"><code class='spip_code' dir='ltr'>mv ~/.kde/share/apps/konsole/profiles/Profil-AS400 /usr/share/apps/konsole/profiles/</code></p>

<p class="spip">Il est possible aussi d’éditer ce fichier manuellement pour effectuer quelques réglages. Dans mon cas, j’ai changé le nom de l’application apparaissant dans la barre de tache :</p>

<p class="spip"><code class='spip_code' dir='ltr'>Title0=AS400</code></p>

<h2>Installation d’une imprimante AS400</h2>
<p class="spip">Pour pouvoir imprimer sur une imprimante installée sur un poste Linux ou Windows, il faut démarrer un émulateur d’imprimantes. Le paquet « <strong class="spip"> tn5250 </strong> » fournit également le programme « lp5250d » permettant d‘émuler une imprimante.</p>

<p class="spip">Avant d’utiliser ce programme, il est nécessaire d’avoir une imprimante correctement configurée sur le poste Linux.</p>

<p class="spip">Par exemple, la ligne suivante permet de créer l’imprimante virtuelle « MONIMPRIMANTE » sur l’AS400 192.0.0.100 de type Laser Jet 4 en utilisant l’imprimante Linux nommée HP1300, lancer</p>

<p class="spip"><code class='spip_code' dir='ltr'>$ lp5250d env.DEVNAME=MONIMPRIMANTE env.IBMMFRTYPMDL=*HP4 outputcommand='scs2ascii | lpr -P HP1300' 192.0.0.100</code></p>

<p class="spip">Un poste linux peut démarrer plusieurs imprimantes en même temps et peut faire office de serveur d’imprimantes AS400 pour toutes les imprimantes disponibles sur les postes Windows et Linux.</p>

<p class="spip">Pour démarrer ces imprimantes automatiquement au démarrage du poste Linux, il est possible d’ajouter une ligne par imprimante dans le fichier « /etc/inittab » :</p>

<div style='text-align: left;' class='spip_code' dir='ltr'><code>pa:2345:wait:/usr/bin/lp5250d env.DEVNAME=IMPCPTA4  env.IBMMFRTYPMDL=*HP4 outputcommand='scs2ascii | lpr -PHP1320' prod<br />
pb:2345:wait:/usr/bin/lp5250d env.DEVNAME=IMPACHAT1 env.IBMMFRTYPMDL=*HP4 outputcommand='scs2ascii | lpr -PHP1100' prod</code></div>
<h2>Problèmes rencontrés</h2>
<br /><li> <strong class="spip">Impossible de faire fonctionner la touche duplication et la touche moins dans certians champs (mais pas dans tous ??)</strong>
<br /><li> <strong class="spip">Problème dans le réglage des couleurs (il manque des couleurs)</strong>
<h2>Liens utiles</h2>
<p class="spip">How-to très complet mais en anglais  
<br /></p>
<li> <a href="http://www.chowhouse.com/~james/tn5250-HOWTO.pdf" class="spip_out">www.chowhouse.com/ james/tn5250-HOWTO.pdf</a>
<p class="spip">Liste de discussion très intéressante mais également en anglais :
<br /></p>
<li> <a href="http://archive.midrange.com/linux5250/" class="spip_out">http://archive.midrange.com/linux5250/</a>
<h2>Historique des modifications</h2>
<table class="spip">
<thead><tr class='row_first'><th scope='col'><strong class="spip">Version</strong></th><th scope='col'><strong class="spip">Date</strong></th><th scope='col'><strong class="spip">Commentaire</strong></th></tr></thead>
<tbody>
<tr class="row_even"><td>0.1</td><td>06/12/04</td><td>Création par Tony GALMICHE</td></tr>
<tr class="row_odd"><td>0.3</td><td>29/07/05</td><td>Ajout chapitre « Installation d’une imprimante AS400 »</td></tr>
<tr class="row_even"><td>0.4</td><td>12/09/05</td><td>Ajout chapitre « Personnalisation des couleurs, de la police et du clavier avec xt5250 »</td></tr>
<tr class="row_odd"><td>0.5</td><td>22/05/06</td><td>Ajout compléments sur la personnalisation des couleurs de xt5250</td></tr>
<tr class="row_even"><td>0.6</td><td>08/09/06</td><td>Correction problème dans les chemins suite à mise à jour de Xorg</td></tr>
<tr class="row_odd"><td>0.7</td><td>18/12/06</td><td>Compréhension partielle du fonctionnement des touches spéciales</td></tr>
<tr class="row_even"><td>0.9</td><td>01/06/08</td><td>Ajout du chapitre : Utiliser « Konsole » comme terminal AS400</td></tr>
</tbody>
</table>