Autres utilitaires d'Harmony

xCmu et xCmu2 : Conversion de fichiers Harmony

Les utilitaires Xcmu.dhop et Xcmu2.dhop convertissent un fichier Harmony de type quelconque (longueur d'enregistrements fixe ou variable) en un fichier Dos à enregistrements de longueur fixe.
Ces programmes peuvent être utilisés par exemple pour constituer un fichier de remises en banque lisible par les ordinateurs des banques.
Xcmu et Xcmu2 diffèrent par la méthode de stockage des enregistrements dans le fichier Dos :

• Xcmu les stockent à la queue leu leu, sans séparateur d'enregistrements.

• Xcmu2 termine chaque enregistrement par les caractères séparateurs 0D-0A.

Si un enregistrement Harmony est plus long que la longueur d'enregistrements demandée, il est tronqué. S'il est plus court, il est complété avec des espaces :
Fichier initial Fichier XCMU Fichier XCMU2
En-tête fichier Harmony
(1)-Enreg 1. | Enreg 1. (2) Enreg 1. s
(1)-Enreg 2....... | Enreg 2....... Enreg 2.......s
(1)-Enreg 3.. | Enreg 3.. (2) Enreg 3.. s
(1)-Enreg 4.......... | Enreg 4....... (3) Enreg 4.......s
(1)- ... ... ... s
(1) En-tête propre aux enregistrements Harmony s = 0D-0A (2) Enregistrement complété à espaces (3) Enregistrement tronqué
Mise en oeuvre de Xcmu et Xcmu2
Xcmu ou Xcmu2 demande la saisie de quatre paramètres :

• Fichier en Entrée. Nom du fichier origine (lu séquentiellement).

• Fichier en Sortie. Nom du fichier résultat. S'il n'existe pas, il est automatiquement créé.

• Taille des enregistrements. Taille des enregistrements dans le fichier de sortie. Tous les enregistrements du fichier d'entrée sont recopiés dans le fichier de sortie avec cette taille.

• Programme à Enchaîner. Nom du programme à exécuter une fois la conversion effectuée.

xConfigEnv : Gestion des environnements

Voir Gestion des utilisateurs, profils et environnements dans Harmony | Gestion des environnements (xConfigEnv)

xConfigProfil : Gestion des profils de connexion

Voir Gestion des utilisateurs, profils et environnements dans Harmony | Gestion des environnements (xConfigEnv)

xConsole : Console d'administration

La console d'administration permet de superviser l'activité d'un ou de plusieurs serveurs.
L'utilisateur doit disposer du droit hco pour pouvoir y faire appel.
La documentation de Xconsole.dhop peut être consultée à partir du choix Aide ce cet utilitaire.

xDefautUserForOdbc : Utilisateur par défaut pour Odbc

Cf. Utilisateur par défaut pour Odbc.

xDivaltoMajIni : Mise à jour de Divalto.ini

Voir xDivaltoMajIni : mise à jour de Divalto.ini

xDivaltoPrinters : Configuration des imprimantes

Voir Configuration des imprimantes (xDivaltoPrinters)

xDivaltoRestart : Arrêt et redémarrage d'Harmony sous TSE

xDivaltoRestart.exe est un service que vous pouvez utiliser sous Windows TSE pour arrêter et/ou redémarrer Harmony de manière automatique. L'arrêt peut être précédé de l'envoi d'un message d'avertissement à tous les utilisateurs connectés (hors client léger).
1) Utilisation "ponctuelle" de xDivaltoRestart
Vous pouvez appeler directement le programme xDivaltoRestart, en mode commande (Démarrez : Exécutez) ou dans un raccourci, par : xDivaltoRestart.exe Commande [Commande]*
Le nom du programme doit être suivi d'une ou plusieurs commandes parmi les suivantes :

• -stop Demande l'arrêt d'Harmony (DhsDivalto, DhsXlanServer, DhSession, ...).

• -start Demande le (re)démarrage d'Harmony (Harmony doit être arrêté). Exemple (arrêt et redémarrage immédiat d'Harmony) : xDivaltoRestart.exe -stop -start

• -reboot Demande de rebooter la machine. Exemple (arrêt d'Harmony suivi du reboot) : xDivaltoRestart.exe -stop -reboot

• -show Demande le passage du programme en mode visible (par défaut, xDivaltoRestart tourne en mode caché). Exemple 1 : xDivaltoRestart.exe -show -start -stop Exemple 2 : xDivaltoRestart.exe -show -start -reboot

• -flush Demande le vidage du cache des modules Diva. On exécutera cette commande après l'installation d'une nouvelle version de module opérée "à chaud" (sans re-démarrage de l'ordinateur ou des services Harmony), pour mettre cette nouvelle version à disposition des utilisateurs. A défaut, les utilisateurs continueront d'utiliser l'ancienne version jusqu'au prochain re-démarrage. Exemple : xDivaltoRestart.exe -flush

2) Utilisation en mode automatique
Pour obtenir un fonctionnement automatisé, il faut (sur le serveur TSE) :

1. Vous logger en mode administrateur et écrire un script dans le chapitre [xDivaltoRestart] de Divalto.ini. Exemple 1 (sans reboot du serveur TSE) : [xDivaltoRestart] ;attendre 22 heure 30 avant de lancer les commandes 1=waittime,22,30 ;affichage d'un texte puis de la date, localement 2=texte,Début de l'envoi des commandes 3=textedate ;idem sur les postes client 4=msg,Arrêt dans 10 minutes, il faut sortir des tâches Harmony 5=msgdate ;attendre 10 minutes 10=wait,600000 20=msg,Arrêt d'Harmony en cours 30=wait,5000 ;stop 35=stop 40=wait,5000 ;exécute un programme localement (sauvegarde) 45=run,ntbackup.exe fichier_paramètre_de_backup 46=wait,5000 50=msg,Redémarage d'Harmony 60=start 61=wait,10000 62=msg,Redémarrage de DhSession ;exécute un programme sur les postes client 70=exec,DhSession.exe ;se remet en mode caché 75=hide ;retour au début 80=gotodebut Exemple 2 (avec reboot du serveur TSE) : [xDivaltoRestart] 1=waittime,22,30 2=texte,Début de l'envoi des commandes 3=textedate 4=msg,Arrêt dans 10 minutes, il faut sortir des tâches Harmony 5=msgdate 10=wait,600000 20=msg,Arrêt d'Harmony en cours 30=wait,2000 35=stop 40=wait,2000 45=run,ntbackup.exe fichier_paramètre_de_backup 46=wait,2000 50=msg,L'ordinateur va redémarrer dans 10 minutes, il faut sortir de tout les programmes 60=wait,600000 70=reboot Remarque : les numéros de ligne peuvent être quelconques, à condition d'être croissants.

2. Créer le service xDivaltoRestart par la commande : xDivaltoRestart.exe -create Cet xDivaltoRestart sera "maître" et exécutera le script écrit dans Divalto.ini.

3. Demander le lancement de xDivaltoRestart sur les postes clients en créant un raccourci sur x:\Divalto\Sys\xDivaltoRestart.exe et en mettant ce raccourci dans le menu "ALL USER" de Windows. Ces xDivaltoRestart n'exécuteront pas de script et seront "esclaves" du xDivaltoRestart "maître".

4. Rebooter l'ordinateur.

3) Interruption du service
Pour décharger tous les xDivaltoRestart (maître et esclaves), lancez la commande :
xDivaltoRestart.exe -end
4) Annulation du service
Pour supprimer le lancement automatique de xDivaltoRestart, enlevez le raccourci sur le programme du groupe "ALL USER" de Windows et lancez la commande :
xDivaltoRestart.exe -delete pour supprimer le service.
5) Compte-rendu d'exécution
Par défaut, lorsque xDivaltoRestart est en mode automatique et exécute des commandes, il écrit dans le fichier xDivaltoRestart.log (maître) ou xDivaltoRestartNNN.log (où NNN est un numéro – esclaves).
Si vous désirez invalider ces écritures, ajoutez -nolog à la suite des commandes, dans le raccourci "ALL USER" et au lancement du service.
6) Liste des commandes du script dans Divalto.ini
Il faut distinguer deux types de commandes, celles qui sont uniquement exécutées par le xDivaltoRestart " maître " et celles qui sont transmises aux xDivaltoRestart " esclaves ".
Liste des commandes " maître " :

Liste des commandes " esclaves " :

7) Affichage des erreurs
Si une erreur se produit lors de l'exécution d'une commande, xDivaltoRestart se met automatiquement en mode visible et affiche cette erreur (même en mode service).
8) Autres utilisations de xDivaltoRestart
On peut lancer plusieurs occurrences de xDivaltoRestart (pour exécuter d'autres tâches que celle d'arrêter ou de redémarrer Harmony). Pour ce faire, il faut lancer le programme par : xDivaltoRestart.exe -setN (N = 2, 3, etc.)
Dans ce cas, xDivaltoRestart N lira ses commandes dans le chapitre [xDivaltoRestartN] de Divalto.ini.
Exemple :
[xDivaltoRestart2] 1=waittime,8,00 2=texte,Lancement du programme prog.exe 3=textedate 4=run,prog.exe 10=hide 20=gotodebut

xDivaltoSelectEnv : Choix de l'environnement Harmony

Cf. Choix de l'environnement de travail.

DivaltoViewer : Aperçus avant impression

DivaltoViewer est décrit dans le livre Aperçus avant impression par DivaltoViewer.

Harmony : Menu d'Harmony

Un menu des différents outils d'Harmony peut être obtenu en appelant le programme Harmony.dhop. Le fonctionnement du menu lui-même est documenté dans le livre "Menu Harmony : Guide d'utilisation".
Ce menu propose en particulier les choix suivants :
Administration

• Console d'administration, etc. Ce choix fait appel à la console d'administration de Divalto, etc.

• Divalto License Management Tool Ce choix fait appel à l'utilitaire de gestion des licences Divalto (DLMT).

• Installation et Désinstallation ... Pour installer / désinstaller un serveur Power Search ou Telnet. Pour installer un serveur Client léger Web.

Paramétrage

• Serveurs Ce choix appelle un zoom sur le fichier fconfig.dhfi (ou DivaltoServer.cfg) et permet de déclarer les serveurs Harmony (Xlan ou Windows) auxquels l'ordinateur doit avoir accès.

• Chemins Harmony Ce choix appelle un zoom sur le fichier fconfig.dhfi (ou DivaltoPath.cfg) et permet de définir des chemins Harmony afin de faciliter l'accès aux fichiers et aux programmes.

• Unités V24 Ce choix appelle un zoom sur le fichier /divalto/sys/fconfig.dhfi et permet : - De déclarer et de paramétrer une voie série, qui sera utilisée avec un logiciel de communication. - De déclarer une imprimante utilisée "en direct", c'est à dire sans passer par le spouleur de Windows.

• Test et configuration d'imprimantes Cette fonction appelle l'utilitaire de configuration des imprimantes xDivaltoPrinters.

• Services Diva et Actions des services Paramétrage des services Diva.

• Paramètres XlanSql. Paramétrage pour XlanSql.

• Paramètres Serveur et Vues ODBC, Utilisateur par défaut pour ODBC Paramétrage du serveur de données et des vues Odbc.

• Gestion des chemins implicites Ce choix appelle l'utilitaire Xpath.dhop.

• Gestion des utilisateurs Ce choix appelle l'utilitaire Xlog1.dhop.

• Gestion des environnements. Paramétrage des environnements par l'utilitaire xConfigEnv.dhop.

• Gestion des profils de connexion en client léger. Paramétrage des profils de connexion par l'utilitaire xConfigProfil.dhop.

• Restauration de l'état initial des fenêtres V6 Ce choix appelle l'utilitaire xWindowsSizeReset.exe (applications de génération 6 uniquement).

• Paramètres Office, CTI Paramétrage d'Office et du CTI.

• Paramètres impressions et messageries Cette fonction appelle l'utilitaire DivaltoViewer.

Utilitaires
Ce menu propose la liste des utilitaires principaux d'Harmony (hors utilitaires d'administration et de paramétrage - voir menus précédents). Sélectionner l'un de ses choix lance l'utilitaire correspondant. Il propose aussi un choix permettant d'interpréter un code d'erreur Harmony (ou les codes d'erreur Windows les plus courants).
Documentation
Le premier choix permet d'afficher le manuel de référence d'Harmony.

Liscar : Test d'impression en mode caractères

Le programme Liscar fait un test d'édition en mode caractères.

xLog : Identification d'un utilisateur

Voir le livre XLOG : Identification d'un utilisateur.

xLog1 : Gestion des utilisateurs

Voir le livre XLOG1 : Gestion des utilisateurs.

xMajSession : Mise à jour du paramétrage sur un poste TSE

Cet utilitaire ne concerne que les tâches Harmony s'exécutant sous Windows Terminal Serveur Edition (TSE).
Lorsque vous effectuez des modifications de paramétrage (par exemple, par xDivaltoPrinters) portant sur Divalto.ini et générales à tous les utilisateurs d'un serveur TSE, les modifications ne sont pas partout prises en compte immédiatement. Pour que les modifications soient effectives pour un autre utilisateur que celui pour lequel la modification a été effectuée au départ, il faut ensuite :

• Redémarrer l'ordinateur.

• OU fermer puis rouvrir la session pour cet utilisateur.

• OU lancer le programme xMajSession.exe sur le poste de cet utilisateur.

Remarque : l'ouverture d'une session par un utilisateur non connecté provoquera automatiquement la mise à jour de son Divalto.ini.
Lancement en mode invisible
Le paramètre /Silent permet de lancer le programme sans affichage de fenêtre :
xMajSession.exe /Silent

xNewSession : Initialisation du paramétrage sur un poste TSE

Cet utilitaire ne concerne que les tâches Harmony s'exécutant sous Windows Terminal Serveur Edition (TSE).
L'installateur d'Harmony ne réalise l'installation que pour le compte utilisateur Windows courant. Pour qu'Harmony soit accessible à partir d'un autre compte (ou profil) utilisateur, il faut lancer l'utilitaire xNewSesssion.exe à la première connexion sous cet autre compte.
Voir aussi :
Rubrique Installation d'Harmony sous plusieurs comptes / profils utilisateur.

xPath : Gestion des chemins implicites

Voir le livre XPATH : Gestion des chemins implicites.

xPerf : Analyse des performances

Voir le livre : xPerf : Analyse des performances

xQuit : Fermeture de la fenêtre Harmony

• Tapé à la question Programme, Xquit permet de fermer la fenêtre Harmony courante. Remarque : vous pouvez aussi fermer la fenêtre Harmony en tapant Alt+F4 (ou en cliquant sur le bouton correspondant) ou par le choix <Fermeture> du menu système de la fenêtre.

• Xquit peut être appelé dans l'instruction Diva ProgramGoto pour refermer la fenêtre à la sortie du programme.

• Vous pouvez interdire tout retour à la question Programme en provoquant l'exécution de Xquit de la manière suivante : Dans le chapitre [System] de Divalto.ini, faites figurer la commande : Programme=Xquit

xReof : Régénération des clés et Réorganisation

Voir le livre XREOF : Régénération des clés et Réorganisation.

xRepair : Vérification de la structure des fichiers

Voir le livre xRepair : Vérification de la structure des fichiers.

xTools : Gestionnaire des fichiers Harmony

Voir le livre XTOOLS : Gestionnaire des fichiers Harmony.

xTranslate : Traduction des applications

Voir le livre xTranslate.dhop.

xUpdateConfig / xUpdateConfigCloud : Rechargement de la configuration

Les modifications que vous effectuez sur la table des serveurs ou des chemins ne sont pas prises en compte immédiatement, à moins

• On Premise : de relancer Windows ou de faire appel à l'utilitaire xUpdateConfig

• Saas : de relancer Windows ou de faire appel à l'utilitaire xUpdateConfigCloud

Remarque : lorsque vous quittez le zoom des serveurs / chemins après une modification, celui-ci vous propose de lancer xUpdateConfig/xUpdateConfigCloud de manière automatique.

La commande XupdateConfigCloud renvoie les statuts de retour suivants

• 0 = OK

• 1 = erreur de syntaxe dans la commande

• 2 = erreur de connexion

• 3 = exception lors du dialogue avec xlan

• 4 = autre exception

xVerif : Contrôle d'intégrité des fichiers d'un dossier

Le but de l'utilitaire Xverif.dhop est de contrôler l'intégrité des fichiers Harmony contenus par un dossier. Plus précisément, Xverif :

• Signale les fichiers séquentiels indexés dont les clés ne sont pas en phase avec les données (test de l'erreur 003D = fichier séquentiel indexé verrouillé).

• Vérifie la cohérence interne des données des fichiers dont le nom est spécifié dans le fichier paramètres XRECUPF.txt (test des erreurs 001A = longueur d'enregistrement incorrecte).

Ces types d'erreur peuvent exceptionnellement survenir en cas d'arrêt brutal d'un programme ou de l'ordinateur ou en cas de chevauchement entre deux fichiers dans le cas de l'erreur 001A.
Mise en oeuvre de Xverif
En entrée, Xverif demande de saisir le chemin d'accès au dossier à contrôler. Ce dossier vérifié, il demande la saisie d'un nouveau chemin, et ainsi de suite jusqu'à abandon (touche F9).
Lorsque Xverif détecte une anomalie :

• Il écrit un enregistrement dans le fichier de journalisation des erreurs Ferror.log.

• Il crée une nouvelle ligne dans un tableau, qui peut être consulté à chaque demande de saisie d'un nouveau chemin.

Après abandon, le programme se termine si aucune erreur n'a été détectée ou si au moins un fichier est en erreur 001A. Dans le cas contraire (pas d'erreur 001A mais au moins une erreur 003D), Xverif demande si vous voulez enchaîner au programme Xreof, afin de corriger immédiatement les erreurs 003D.

xWindowsSizeReset : Restauration de l'état initial des fenêtres et des tableaux (version 6)

Applications de génération 6 uniquement.
Si vous le désirez, Harmony sauvegarde l'état (position à l'écran, taille, mode "plein écran") des fenêtres au moment de leur fermeture, dans le but de retrouver cet état lors de leur prochaine réouverture (Cf. rubrique Taille et position des fenêtres Harmony).
De la même manière, Harmony sauvegarde l'état (position et taille des colonnes, taille des lignes, etc.) des tableaux proposés par les applications (par exemple, les grilles affichées par les zooms en mode liste).
Les informations concernant la sauvegarde de l'état des fenêtres et des tableaux sont stockées dans la base de registres de Windows. Si vous désirez, pour une raison ou pour une autre, restaurer l'état initial de toutes les fenêtres et/ou de tous les tableaux, appelez l'utilitaire xWindowsSizeReset.exe.