GENERIX.INI : personnaliser votre environnement de travail Client/Serveur

Les données nécessaires au fonctionnement global d’ACE, et notamment les répertoires de travail ou encore les éléments de connexion, sont définies au sein d’un fichier, « GENERIX.INI » que l’on trouve, en mode Client/Serveur, sur tout poste Client ainsi que tous les serveurs.

Ce fichier de configuration, indispensable pour votre environnement de travail, permet de déterminer :

• Les variables communes à toute l’application (nombre d’occurrences maximal sur une recherche multicritères, titre de l’application, temporisation de saisie,…),
• Les données relatives au système (limite de compression, nombre de connexions, période de scrutation, superviseur,…),
• Les répertoires, côté Client et côté Serveur (fichiers temporaires, éditions et suivi des éditions, icônes, aide,…),
• La personnalisation (couleurs, polices de caractères, barre d’outils, touches fonctions pour les terminaux alphanumériques,…).

Toutes ces informations sont découpées en sections regroupant des clés de même nature :

Applications

Barre_Outils

Barre_Popup

Batchs

Bdd_Trace

Cles_XX

Client_Serveur

Couleurs

Editeur_Windows

e-gx

Global

Image_Fond

Initialisations

Interscan

Licences

Localisation

Polices

Repertoires

Repertoires_X

RF

Scrutateur

Societes

Systeme

Tables_XX

TERM_XXX

Afin de distinguer les clés des sections dans le fichier « Generix.ini », les sections sont toujours entourées de crochets de ce type : [section].

Pour des raisons de compatibilité, les noms utilisés pour les sections comme pour les clés ne sont pas accentués. Par contre, les noms des sections et des clés peuvent être en minuscules comme en majuscules. Les valeurs des clés, quant à elle, doivent respecter la casse.

Sous VMS

Sous UNIX

Sous NT

Sur un poste CLIENT

Lorsqu’ACE est livré, toutes les données figurent sur le serveur. Un répertoire, réservé au client (CSRV), vous permet de dupliquer des données sur le serveur ou sur les postes clients.

Grâce notamment à ce fichier « Generix.ini », ACE est un produit souple et complet que l’on peut personnaliser sur site en fonction de l’activité de l’entreprise et du métier de chaque agent.

Pour appréhender toutes les fonctionnalités offertes par ACE en matière de mise à jour des informations, de navigation au sein des fonctions, et enfin de personnalisation de ses outils, nous vous recommandons de consulter la documentation de référence « Utiliser ACE ».

Le fichier GENERIX.INI est au format texte. Il vous est donc possible d’en modifier le contenu par un éditeur quelconque.

Si l’un des paramètres par défaut vous convient, il est inutile de le modifier voire de le faire apparaître dans la section concernée.

Pour inhiber un paramètre de manière temporaire, il vous suffit d’insérer un point-virgule en début de ligne. Les caractères qui suivent ce point-virgule jusqu’au prochain saut de ligne deviennent des commentaires.

Légende

Temporisation de saisie (5 minutes par défaut)

Spécifie le temps sans aucune saisie au bout duquel l’opération est abandonnée.

Temporisation Menu

Spécifie le temps au bout duquel le menu s’efface lorsque aucune valeur n’est entrée dans un champ du menu. La valeur par défaut, à savoir 0, permet d’inhiber l’abandon dans le menu.

Titre Application (aucun titre par défaut)

Cette clé permet d’afficher le tout premier titre du menu, avant toute connexion. Ce titre sera par la suite remplacé par la valeur contenue dans la base.

Si la clé est renseignée dans le Generix.ini, un maximum de 40 caractères peuvent être donnés au titre.

Mode Multisociété (par défaut à N, en mono-société)

Indique si vous utilisez le mode multi-sociétés (sauvegarde dans une même base des informations concernant des sociétés différentes).

En mode client/serveur, la clé doit apparaître dans le fichier "Generix.ini" du serveur.

En mode mono-société, il vous est possible d’utiliser plusieurs sociétés, à condition de les positionner dans des bases différentes (ce qui interdit tout partage d’informations entre sociétés).

Société de référence (par défaut à 1)

Spécifie le numéro de la société (de 1 à 9999) utilisée lors de l’initialisation du menu avant toute saisie.

Elle ne doit apparaître que si le numéro de société de référence est différent.

Le numéro de la société de référence doit absolument correspondre au numéro de la base dans laquelle elle se trouve.

Exemple :

[Global]

Societe de Reference=1

[Societes]

societe_1=1

TERM (par défaut à vt100)

Cette clé n’est utilisée qu’en deuxième lieu sous UNIX et sous VMS, dans le cas où une « variable d’environnement » nom_UNX ou nom_VMS n’est pas déjà spécifiée. Elle permet de faire référence à une section contenant la redéfinition de l’ensemble des séquences d’échappement écran, clavier, ainsi que des caractères semi-graphiques.

Exemple :

Donner la valeur « test » à la clé sur le Generix.ini client dans le cas du client/serveur permet de définir le fonctionnement de l’application à partir du clavier en redéfinissant les touches dans la section [test_WNT].

La clé ne doit apparaître que dans le cas où on désire la redéfinir.

La valeur ne doit pas dépasser 76 caractères (80c - 4c pour le suffixe).

Taille Fenetre Popup (par défaut à 10 lignes)

Cette clé permet de définir le nombre maximum de lignes pouvant apparaître dans un popup.

En mode client/serveur, si le nombre effectif de lignes dépasse ce plafond, des sous-menus sont automatiquement crées.

En mode alphanumérique, pour visualiser l’ensemble des lignes du popup il faut déplacer la sélection avec les flèches du curseur ou avec les touches « page suivante » et « page précédente ».

Mode de Saisie (mode « Insertion » par défaut)

Cette clé permet de définir si on est par défaut en mode Insertion (les caractères saisis s’insèrent à l’endroit où le curseur est positionné) ou Overwrite (les nouveaux caractères saisis remplacent les anciens caractères). Cette notion n’est utilisée qu’en alphanumérique (I ou O).

La clé ne doit apparaître que si vous souhaiter passer par défaut en mode Overwrite.

Touche Rappel (par défaut à 100)

Utilisée uniquement en mode alphanumérique, la touche Rappel permet, lorsqu’elle est actionnée, de répéter dans un champ la dernière valeur saisie dans des champs de même nom. Cette clé permet de définir le nombre de valeurs de champs mémorisés pour le fonctionnement de la touche rappel.

En client/serveur, on laisse le soin à l’utilisateur d’utiliser la fonctionnalité du « copier/coller ».

Date du Jour : la valeur donnée dans cette clé est prioritaire par rapport à la date effective donnée par le système. Elle permet, dans le cas où un problème serait survenu pendant un lourd traitement de nuit par exemple, de simuler à nouveau l’exécution de binaires à une date antérieure à la date système.

Le format de la date donnée est JJMMAAAA.

La clé ne doit apparaître que de manière temporaire, dans un cadre d’utilisation bien déterminé.

Heure du Jour : en prévision d’un fonctionnement exceptionnel, en corrélation avec “ Date de Début ” et “ Heure de Début ”.

Date de Début : en prévision d’un fonctionnement exceptionnel, en corrélation avec “ Heure du Jour ” et “ Heure de Début ”.

Heure de Début : en prévision d’un fonctionnement exceptionnel, en corrélation avec “ Heure du Jour ” et “ Date de Début ”.

Maximum Recherche (par défaut à 200)

La valeur de cette clé permet de spécifier le nombre maximum d’éléments pouvant être rapatriés lors d’une recherche.

Procédures Stockées (par défaut à NON)

Cette clé permet de spécifier si l’on désire ou non utiliser les procédures stockées (notion utilisée uniquement en environnement SYBASE).

Explorateur

: spécifie le chemin logique complet permettant d’accéder au navigateur HTML utilisé pour consulter l'aide en ligne.

Le répertoire sous lequel on trouve le binaire explorateur, est indiqué par un nom de répertoire physique dont on trouve la correspondance physique dans la section [Repertoires]

Langue Utilisée : peut prendre 2 valeurs “ Utilisateur ”, “ Societe ”, pour spécifier si la langue utilisée dans les écrans de l’application est la langue associée à l’utilisateur, ou alors la langue associée à la société courante.

Demarrage automatique du SPVR : permet de demander le démarrage automatique du superviseur “ client ” lors de l’activation du menu de l’application, ou du process “ login_rf ” associé à l’architecture RadioFréquence (RF)

La valeur par défaut est “ OUI ”. en règle général, cette clé doit avoir cette valeur et n’a donc pas à être spécifiée dans le Generix.ini.

Toutefois, sur un poste client, faisant office de serveur TSE, il peut être intéressant de ne pas autoriser systématiquement les connexions à l’architecture ACE en interdisant le démarrage automatique du superviseur. Cette fonctionnalité permet d’arrêter les connexions via un serveur TSE, pour des raisons d’exploitation par exemple.

Intervalle date_Fonction_Société : permet de définir un intervalle de dates. Un contrôle automatique peut ainsi être effectué au moment de la saisie d’une date par rapport à cet intervalle de dates. On peut ainsi vérifier que la date saisie est incluse dans un intervalle défini. L’intérêt est d’éviter de saisir une date non cohérente (ex : 02/01/3005).

Il est possible d’affiner le paramétrage de cet intervalle par société et par fonction.

Intervalle date_Fonction_Société=Nbjours ; Nbjours

avec Nbjours correspond à un nombre de jours à partir de la date courante.

Le contrôle est effectué de la façon suivante :

(Date du jour + Nombre de jours) < dates saisies < (Date du jour + Nombre de jours)

Exemple :

[Global]

Intervalle date=-15;+25

Intervalle date_GCOV_9999=-250;+300

Dans quel « Generix.ini » cette clé doit-elle se trouver (client ou serveur) ?

Cette nouvelle clé doit être définie au niveau du serveur dans la section Global, section qui contient déjà la définition de la « Date du jour ».

Dans le cadre d’une configuration Client/Serveur, il est possible de paramétrer le(s) intervalle(s) dans le « Generix.ini » du client, qui sera prioritaire à celui du serveur.

Dans le cadre d’une configuration C/S léger (TSE), le « Generix.ini » client étant commun à tous les utilisateurs clients, la lecture de la clé se fera au niveau du « Generix.ini » du serveur.

Comment s’effectue la lecture de l’intervalle dans le cas où plusieurs clés seraient présentes ?

Exemple :

[Global]

Intervalle date=-15;+25 Œ

Intervalle date_GART= -25 

Intervalle date_9999=;+3 Ž

Intervalle date_GCOV_9999=-250;+300 

Avec date courante = 17/02/2004

A quel moment la lecture de la clé est effectuée ?

La clé est lue dans le « Generix.ini » du client ou du serveur une et une seule fois au premier appel du contrôle, après avoir saisi une date. L’intervalle sera propre à la fonction donc réactualisé à chaque lancement de fonction.

Le contrôle se déclenche à chaque fois que l'on quitte un champ et qu'on a modifié sa valeur par le clavier. Il s'effectue en fonction de la présence ou non des clés de paramétrage.

Compteur Validation

La valeur de cette clé permet de déterminer la fréquence des commits et de la mise à jour du compteur de reprise.

Ces deux opérations ont alors lieu tous les n enregistrements, où n correspond à la valeur de la clé. Cela permet d’optimiser le traitement, en évitant de faire les commits et mise à jour à chaque boucle.

La valeur par défaut de cette clé est de 1, ce qui signifie que « commit » et mise à jour sont systématiquement effectués. La clé ne doit apparaître que dans le cas où on désire en modifier la valeur.

Le commit et la mise à jour de fin de boucle sont toujours effectués.

Periode de Scrutation (par défaut à 60)

La valeur de la clé détermine une durée en secondes. Cette période correspond pour le scrutateur à une « période de sommeil » entre deux scrutations. Une scrutation est la période pendant laquelle le scrutateur cherche à exécuter des traitements différés en attente.

Scrutateur en service

La valeur de la clé indique si le scrutateur doit ou non rester en service. Quand le scrutateur se réveille, il vérifie cette valeur, et s'arrête si elle est égale à NON.

Nombre de Tentatives de Connexion (V 4.5-00)

Cette clef permet de définir le nombre maximal de tentatives de connexion à la base de données avant de considérer le problème de connexion comme une erreur (valeur par défaut = 10 tentatives).

Periode entre 2 Tentatives (V 4.5-00)

La valeur de cette clé détermine une durée en secondes. Elle permet de définir la durée à attendre entre deux tentatives de connexion à la base de données. (valeur par défaut = 1 seconde)

Deconnexion Repos (V 4.5-00)

Cette clef permet d’activer ou non (valeurs « OUI » ou « NON ») la déconnexion à la base de données lorsque le scrutateur a terminé sa boucle de scrutation de toutes les sociétés et va se mettre en « sommeil ». (valeur par défaut : OUI).

Nombre maximum de sociétés

Cette clef rend paramétrable le nombre maximum de sociétés à « scruter » par UEXP via le Generix.ini

Niveau de trace

L’activation du mode trace ne se fait plus via la variable d’environnement SCRUTDBG mais via le Generix.ini. Il est possible d’indiquer un niveau de trace (OFF, INFO, DEBUG, FULL). Ce niveau de trace est relu à chaque « boucle de scrutation ». Il devient donc possible de passer le scrutateur en mode debug sans devoir le relancer.

La signification des niveaux de trace est la même que pour UERP (Off, Info, Debug et Full).

Rattrapage procedure automatique (clé disponible depuis la version 5.0-00)

Cette clef permet d’activer ou non le rattrapage automatique des procédures automatiques. La valeur par défaut est :

• « OUI », pour les versions comprises entre 5.0-00 et ACE 1.2,
• « NON », pour les versions postérieures ou égales à ACE 1.3.

Par exemple, prenons le cas d'une procédure automatique dont la fréquence d'activation est de 5 minutes. Si elle vient à être interrompue pendant une heure, alors lors de sa réactivation (sans précaution) par le scrutateur (en mode par défaut), celle-ci va chercher à « rattraper le temps perdu » et va s’exécuter au minimum 12 fois sans "temps mort" contribuant ainsi à la potentielle saturation de la CPU.

Maximum FileSize (clé disponible depuis la version 162, patché jusqu’en 140 au 10/2012)

Cette clef permet d’activer le découpage du fichier log du scrutateur de la façon suivante :

Au démarrage (de même que sans cette clé), le fichier log courant du scrutateur est nommé « scrutateur_o.log ». A chaque tour de scrutation, si le fichier « scrutateur_o.log » a atteint la taille précisée dans la clé, celui-ci est renommé dans un nom composé suivant la clé « Archive Mode » (mode DATE par défaut si non présence de la clé « Archive Mode »), et un nouveau fichier « scrutateur_o.log » est créé.

Archive Mode (clé disponible depuis la version 162, patché jusqu’en 140 au 10/2012)

Cette clef permet, en présence de la clé «Maximum FileSize », d’indiquer la méthode de nommage des fichiers de découpage du fichier scrutateur_o.log

Les valeurs possibles sont :

• « DATE » (valeur par défaut)

Le fichier de « découpage » dépendra de la date et de l’heure

scrutateur_o.log.<AAAAMMJJ>-<HHMMSS>

Exemple :

scrutateur_o.log.20121009-175720)

• « NUMERICAL »

Le fichier de « découpage » reprendra un numéro d’ordre correspondant au nombre de découpages depuis le démarrage du scrutateur

scrutateur_o.log.<NNN>

Le fichier le plus récent aura le numéro 1

Exemple (par ordre de création des fichiers) :

scrutateur_o.log.3, scrutateur_o.log.2, scrutateur_o.log.1

(2) : Les 2 valeurs client et serveur de traitements DOIVENT être identiques. La clé Serveur Traitement est obligatoire sur les postes clients en C/S. Elle est optionnelle sur le serveur de traitements.

(3) : La clé existe sur le serveur de traitements et est recopiée sur les postes clients (Voir source xdr_rel.c)

Programme Superviseur

Cette clé indique le numéro de programme sous lequel doit être enregistré le superviseur dans la portmap. Ce numéro, ainsi que le numéro de version du superviseur (toujours 1) et le protocole (toujours TCP/IP) vont servir à obtenir le numéro de port auquel doivent être envoyées les données pour communiquer avec le superviseur.

La clé doit apparaître côté client et côté serveur. Sa valeur doit être connue avant toute connexion, il ne sera donc pas possible de la supprimer du fichier « Generix.ini » client.

Sa valeur par défaut (0x22222222) ne devrait jamais être modifiée dans la très grande majorité des cas. Son but est de permettre le multi-version, c’est à dire faire tourner plusieurs superviseurs et serveurs associés sur une même machine mais sur des environnements différents.

Pour la modifier, il vous faut respecter la plage de valeurs détaillée ci-dessous :

Programme Serveur

Cette clé indique le numéro de programme sous lequel doit être enregistré le serveur_rpc dans la portmap. Ce numéro, ainsi que le numéro de version du serveur_rpc (automatiquement retourné par le superviseur au client lors de la demande de création de serveur) et le protocole (toujours TCP/IP) vont servir à obtenir le numéro de port auquel doivent être envoyées les données pour communiquer avec ce serveur_rpc.

Sa valeur par défaut (0x33333333) ne devrait jamais être modifiée dans la très grande majorité des cas. Son but est de permettre le multi-version, c’est à dire faire tourner plusieurs superviseurs et serveurs associés sur une même machine sur des environnements différents.

Pour la modifier, il vous faut respecter la plage de valeurs détaillée dans la clé « Programme Superviseur ».

Fichier Trace (« superviseur.log » par défaut)

Cette clé permet de définir le nom du fichier dans lequel le superviseur et les serveurs vont écrire les informations au fur et à mesure de l’utilisation de l’application (les créations / destructions de serveurs, les problèmes rencontrés,...).

Il vous est possible de modifier le nom du fichier Trace, à condition de respecter les règles concernant les noms de fichier pour le système.

Limite de compression (par défaut est 300)

Cette clé permet de définir la taille en dessous de laquelle les buffers de données échangées ne sont pas compressés. La compression de buffers trop petits ne serait pas rentable. En effet, le temps mis pour effectuer la compression ne peut absolument pas être amorti par le gain apporté par la diminution des buffers à échanger.

Pour affiner cette valeur, des mesures doivent être effectuées afin de déterminer le meilleur compromis dans un cadre d’utilisation donné. Par exemple, pour l’exécution de 90 accès simultanés aux fonctions, la somme de l’échange (données envoyées dans les deux sens) varie de 116560 à 117216 octets pour des valeurs de la clé allant de 0 à 250 alors qu’elle varie de 157676 à 158020 pour des valeurs de la clé allant de 300 à 1000.

Nb Fetchs/Groupe

La valeur par défaut de la clé est de 200. Il n’est pas utile a priori de la modifier sauf si la clé « maximum recherche » l’est elle même (afin de synchroniser les deux valeurs).

La plage de valeurs que peut prendre cette clé s’étend de 1 à 65535. Il s’agit bien d’un nombre d’enregistrements à stocker en mémoire, attention donc à l’espace mémoire que risque d’utiliser le buffer pour des enregistrements de grande taille.

Buffer de Messages Erreurs, « Buffer de Messages Questions, Buffer de Messages Messages (par défaut à 40)

Ces clés permettent de définir la taille des zones mémoires créées, pour enregistrer les messages d’erreur, question et messages au sein de buffers circulaires.

Octets par Trame : utilisée pour l’instant uniquement pour la copie de fichiers en mode Client Serveur. Elle permet de définir le nombre d’octets « utiles » (en dehors des headers de trame) composant une trame. (Dépend des couches 1 à 3 OSI). Cette clé ne devrait pas être modifiée.

Serveur TSE : positionne un poste client comme poste client de type serveur TSE, donc acceptant plusieurs sessions interactives simultanées déportées.

Serveur Traitement Bufferisation Rel : spécifie le nombre d’enregistrements ramenés sur le client lors des boucles lire_premier, lire_suivant, lire_fin. La clé « Nb Fetchs/Groupe » anticipe la lecture des enregistrements dans la base, et stocke les résultats dans la mémoire allouée par le process “ bdd_serveur ”. Cette clé, anticipe elle aussi, la lecture des enregistrements, en stockant des enregistrements côté client. Cela permet de minimiser les accès réseau et donc d’optimiser les performances.

Version Winsock : spécifie la version de la bibliothèque Winsock.dll utilisée pour les échanges réseau. La valeur de cette clé ne doit pas être modifiée sans consulter la maintenance système Aurea.

Trace LoginRF : permet de spécifier le nom d’un fichier servant de fichier journal au traitement différé “ login_rf.exe ”. Ce process s’exécute sur un poste client, et sert à l’initialisation des connexions avec les terminaux RadioFréquence (RF)

Serveur SQL : utilisée uniquement dans le contexte de l’utilisation du SGBD Oracle (V7 et V8), permet d’utiliser une machine “ Serveur de traitements ” différente de la machine hébergeant la base de données ACE . Le bdd_serveur communique alors avec la base distante via des mécanismes SQLNET d’Oracle.

Cette clé doit être positionnée au nom de l'alias Oracle,, uniquement selon l’indication de l’équipe de maintenance système ACE .

Patch Oracle 804

« O » est la lettre (O pour Oui) et non le chiffre zéro.

Start port

Début de la plage de ports réservés à l’utilisation d’ACE.

Cette clé permet de limiter et préciser la plage de ports (utile notamment dans le cas d'un firewall).

Exclude port

Permet de retirer, parmi la plage de ports réservés à l’utilisation d’ACE, des plages de ports ou un port donné (mode expert).

End port

Fin de la plage de ports réservés à l’utilisation d’ ACE .

Exemple :

Start port=2300

Exclude port=2350-2400;2503 (on rejette alors le port {2503} et les ports contenus dans la plage : [2350-2400])

End port=2500

ACE peut alors prendre les ports contenus dans la plage : [2300 – 2350[ U ]2400 - 2500] - {2503}

WaitLock Timeout

Cette clé permet de fixer le délai maximal (en secondes) avant d’interdire l’accès à la ressource (« lock »). Son utilisation vient en complément de l’option « BDD_NOWAIT_TEMPO » des tables de type REL qui permet d’effectuer plusieurs tentatives d’accès à la ressource (afin de ne pas sortir dès le premier accès indisponible).

Langue (par défaut : FRA)

La valeur de la clé indique la langue dans laquelle on désire afficher le menu. Elle est utilisée avant la première identification (connexion avec un nom utilisateur).

Pour spécifier une langue, il s'agit d'indiquer en majuscules les trois premières lettres de la langue exprimée dans la langue (ENG pour l'anglais -ENGlish-).

Répertoire Aides (ap$hlp par défaut)

La valeur de cette clé correspond à un nom logique de répertoire dans lequel va être trouvé le fichier d'aide, si l'aide est activée avant toute identification.

La valeur de cette clé ne devrait pas, à priori, être modifiée.

Fenetre Fonction (MAXIMIZE)

Permet de forcer l'ouverture des fenêtres de fonction ACE en plein écran.

Pas de valeur par défaut.

Splash des Fonctions

Permet de désactiver l’affichage de la splash window lors de l’exécution d’une fonction.

Splash du Lanceur

Permet de désactiver l’affichage de la splash window lors de l’exécution du lanceur.

XX correspond à un numéro de société.

Cette section permet d’affiner la notion de « Nb Fetchs/Groupe » introduite par la clé correspondante dans la section Système, dont la valeur s’appliquait à toutes les tables pour toutes les clés.

Grâce à cette section, des tailles vont pouvoir être spécifiées pour créer des buffers mémoire différents, qui seront fonction des tables et des clés.

En effet, les clés que l’on peut trouver dans cette section correspondent en fait à des noms de table. La valeur des clés correspond à une liste de tailles de buffers mémoire associés aux numéros de clé définis pour ces tables.

Il n’y a pas de valeur par défaut pour ces clés. La section est optionnelle et n’est utilisée que si elle existe.

Plage de valeurs pouvant être prise par chacune des clés de la section : le numéro de la clé doit correspondre à une clé définie pour la table référencée, la taille du buffer s’étend sur le même intervalle que celui défini pour Nb Fetchs/Groupe.

Exemple :

[Cles_2]

ut_fcg=3:240,4:100

Pour la société 2, un buffer mémoire de 240 enregistrements est associé à la clé 3 pour la table ut_fcg, et un autre de 100 enregistrements est associé à la clé 4 pour la même table.

Depuis la version 1.4, il n'est plus obligatoire de référencer toutes les sociétés dans le "Generix.ini", mais uniquement la société de référence.

Exemple avant ACE 1.4 :

[Global]

Societe de Reference=1

Maximum Recherche=200

…

[Societes]

societe_1=1

societe_11=1

societe_111=1

societe_1111=1

societe_1112=1

societe_1113=1

societe_12=1

societe_121=1

societe_1211=1

Exemple depuis ACE 1.4 :

[Global]

Societe de Reference=1

Maximum Recherche=200

…

[Societes]

societe_1=1

societe_XX

Les clés de cette section, au format « société_XX » où XX correspond à un numéro de société, permettent d’associer les numéros de société aux numéros de bases.

Exemple :

[Societes]

Société_2=1

indique que la société 2 se trouve dans la base 1.

Les clés de cette section sont obligatoires en mode multi-sociétés et dans une version strictement antérieure à ACE 1.4, afin d’indiquer où trouver les différentes sociétés.

[Societe]

Cette section permet d’associer une société logique à une base physique :

societe_<n° société logique>=<n° base physique>

De cette manière, on peut ensuite partager des tables entre sociétés logiques, via la section [tables_xx]

Société Physique

Une société physique est une base Oracle sur laquelle on se connecte avec « socX/inforX », X étant le numéro de base physique. Ce concept est appelé BASE.

Société logique

Une société Logique est un lien vers une base physique. Si Y est le numéro de la base logique on ne peut pas se connecter directement sous Oracle avec « socY/inforY ». Ce concept est appelé SOCIETE.

Société de référence

La société de référence est une société au sens ACE, donc une société LOGIQUE.

Cette société de référence est utilisée par les fonctions et le scrutateur comme point d'entrée. La société de référence associe toutes les autres sociétés via la table ut_soc (nota : le scrutateur ne "scrute" que les sociétés avec le champ SGBD <> "NOSCRUT" et le champ ES="ES").

L'algorithme est le suivant :

• connexion à la société de référence Y,
• connexion à la base physique associée X (socX/inforX),
• depuis le menu, on saisit un numéro de société logique (utilisateur/mot de passe),
• le système recherche la base physique associée à la base logique (grâce à la table ut_soc),
• connexion à la nouvelle société logique Z,
• connexion à la base physique associée T (socT/inforT).

Format_date_<codsoc> (V 4.5-00)

Cette clef permet d'activer le changement de localisation pour la saisie des dates dans ACE.

Il n'existe qu'une seule valeur possible : « US » qui permet d'obtenir un affichage des dates en américain (jour et mois inversés).

Exemple : 11/24/2005 pour le 24 novembre 2005.

En mode multi-entités (paramètre MULENT avec N5=0), qui est le mode par défaut, la section [Tables_xxx] n’a plus d’utilité dans le Generix.ini.

XX correspond à un numéro de société. Cette section permet le partage de tables dans le cadre du multi-société. Les clés correspondent à des noms de tables, leur valeur correspond à des numéros de société.

[Tables_<n° société logique 2>]

<nom de la table>=<n° société logique 1>

Exemple :

[Tables_5]

ut_fcg=2

Les données seront lues dans la société 2 pour la table ut_fcg de la société 5.

Il n’y a pas de valeur par défaut pour ces clés :la section étant optionnelle.

Pour le partage des tables entre sociétés, voir les documentation de référence « USOC » et « Multi-Entités ».

Barre Position

Cette clé permet de donner la position initiale de la barre d’outils en client/serveur, barre que l’on peut déplacer à sa guise (à l’aide de la souris) pour la placer en haut en bas à droite ou à gauche.

La valeur par défaut de cette clé correspond à HAUT, les autres valeurs possibles sont BAS, DROITE, GAUCHE.

Une valeur par défaut (sans doute la plus couramment utilisée) étant définie pour cette clé, il est inutile de la faire apparaître dans le fichier « Generix.ini »

Liste Fonctions

Cette clé permet de définir la liste des fonctions à afficher dans la barre d’outils. Les noms de fonctions doivent correspondre à des fonctions définies dans la base de données (via UFCT) et être séparés par des virgules.

Il n’y a pas de valeur par défaut pour cette clé, qui doit donc apparaître dans le fichier « Generix.ini » client si on désire voir apparaître des icônes de fonction dans la barre d’outils.

Barre Position : précise la position initiale de la barre d’icônes associés aux options popup en client/serveur, barre que l’on peut déplacer à sa guise (à l’aide de la souris) pour la placer en haut en bas à droite ou à gauche.

Les valeurs possibles sont : HAUT, BAS, DROITE et GAUCHE.

Une valeur par défaut (la position la plus couramment utilisée) est définie pour cette clé. Il est donc inutile de faire apparaître cette clé dans le Generix.ini.

Les couleurs par défaut correspondent aux couleurs standards de Windows. La section [Couleurs] n’est pas obligatoire si vous souhaitez conserver ces couleurs standards. Pour visualiser quelques exemples de jeux de couleurs, consultez la documentation Jeux de couleurs du Generix.ini .

Attributs vidéo

La gestion des attributs vidéo (Gras, Souligné, Clignotant et Inverse vidéo) adopte le comportement suivant :

• Attribut GRAS :

Caractérisé par une police plus épaisse.

• Attribut SOULIGNE :

Caractérisé par un trait sous le libellé.

• Attribut CLIGNOTANT :

Caractérisé par une couleur spécifique paramétrable par les clés :

• Texte Champ Affichage Clignotant
• Texte Champ Obligatoire Clignotant
• Texte Champ Saisie Clignotant

• Attribut INVERSE VIDEO :

Caractérisé par une inversion de la couleur du fond du champ avec la couleur du texte. Il est possible de donner des couleurs spécifiques (prioritaires) paramétrable par les clés :

• Fond Champ Affichage Inverse et Texte Champ Affichage Inverse
• Fond Champ Obligatoire Inverse et Texte Champ Obligatoire Inverse
• Fond Champ Saisie Inverse et Texte Champ Saisie Inverse.

Si le champ est en Saisie/Affichage, la couleur est le complément de la ligne "Fond Champ Saisie" ou "Fond Champ Affichage".

Charset : cette clé permet de modifier le jeu de caractères utilisé pour créer les polices utilisées en client-serveur. Il existe une valeur par défaut affichant les langues traduites en standard. Pour celles qui ne sont pas compatibles, il est nécessaire de modifier le jeu de caractères (caractères accentués...).

Valeurs autorisées :

• ANSI_CHARSET : valeur par défaut utilisée ppour les langues "standards" (FRA, ENG, DEU, ITA, POR, ESP, DUT).
• DEFAULT_CHARSET : récupère le jeu de caractères courant. Pour un poste français, elle équivaut à l'ANSI_CHARSET. L'utilisation de cette valeur n'est cependant pas recommandée sur les postes 95/98.
• OEM_CHARSET : récupère un jeu de caractères dépendant de l'OS (choisi lors de l'installation).
• EASTEUROPE_CHARSET : récupère un jeu de caractères permettant d'afficher les langues d'Europe de l'Est. Cette valeur n'a été testé QUE pour le hongrois.

D'autres valeurs existent mais leur utilisation doit faire l'objet d'une validation par un expert d’Aurea.

Couleurs au format RGB

Les différentes clés composant cette section permettent de définir les couleurs à utiliser pour le menu et les fonctions (uniquement pour le client/serveur...). Les couleurs sont définies au format RGB (Red Green Blue) et correspondent donc à une liste de 3 valeurs séparées par des virgules.

Chaque valeur du triplet RGB est comprise entre 0 et 255.

Description de différentes clés

Epaisseur du trait de relief (par défaut à 1, ce qui correspond à l’affichage le moins chargé)

Cette clé permet de définir l’épaisseur du trait de relief : de 1 à 10.

La clé ne doit apparaître dans le Generix.ini que si on désire en modifier la valeur.

Fond Tableau Ligne Paire, Fond Tableau Ligne Impaire et Fond Tableau Ligne Selectionnée

Dans un tableau en visualisation, on ne tient pas compte des attributs du champ (saisissable, saisie obligatoire et accessible) pour déterminer sa couleur d'affichage. Tous les champs d'une même ligne ont ainsi une couleur commune. Le type d’affichage vidéo du champ reste toujours paramétrable (inverse vidéo, souligné, clignotant).

La couleur des lignes paires correspond à la couleur des champs en Affichage (clé "Fond Champ Affichage").

La couleur des lignes impaires et sélectionnées étant calculée par rapport à la couleur de la ligne paire.

La couleur du texte est celle du "Texte Champ Affichage".

Utilisation de la variable « gnx_debug »

Texte Splash : lors du lancement d’une fonction par le menu C/S, une « splash window » (ou « splash screen ») s'affiche pendant le temps d’activation de la fonction pour signifier à l'utilisateur que le système n'est pas bloqué et que l’application est en train de s'activer.

La clé « Texte Splash » (valeur par défaut égale à la valeur de la clé "Texte Mire") vous permet de définir la couleur du texte qui apparaît dans cette boîte de dialogue.

Texte Mire : permet de définir la couleur du texte apparaissant sur la mire de connexion.

Texte Lanceur : lors du lancement d’une fonction depuis une page HTML ou votre bureau (le lanceur), une « splash window » (ou « splash screen ») s'affiche pendant le temps d’activation de la fonction pour signifier à l'utilisateur que le système n'est pas bloqué et que l’application est en train de s'activer.

La clé « Texte Lanceur » (valeur par défaut égale à la valeur de la clé "Texte Mire") vous permet de définir la couleur du texte qui apparaît dans cette boîte de dialogue.

Les clés de cette section permettent de spécifier des polices différentes pour l’affichage (client/serveur uniquement...). Se référer à la liste des clés pour connaître les divers textes paramétrables.

La valeur de chaque clé correspond à un nom de police, sachant que l’application exige des polices fixes (et non proportionnelles) pour fonctionner. Si un nom de police proportionnelle est donné, c’est la police fixe s’en rapprochant le plus qui sera choisie. Si un nom de police inexistante est indiqué, une police fixe sera choisie.

Réduire ou agrandir une Police

Il est possible de faire varier la taille d’une police en renseignant un coefficient de réduction ou un coefficient d’agrandissement de la manière suivante :

[Polices]

Police de fond d'ecran=Times New Roman,0.8,0.9

Le premier coefficient permet de jouer sur la hauteur du caractère et le second, sur la largeur.

L’exemple ci-dessus signifie que la hauteur sera réduite de 0.8 (20%) et la largeur de 0.9 (10%) avec l’hypothèse que la valeur par défaut soit 1.0.

Si aucun coefficient n’est renseigné, les valeurs par défaut seront prises en compte, en sachant que ces valeurs correspondent aux coefficients définis directement par programme.

Exemples :

Illustrations

Cette section vous permet notamment de préciser les éditeurs associés aux différents formats de fichiers Multimédia. Cette fonctionnalité vous offre la possibilité d’associer aux caractéristiques d'un produit ou d'un tiers par exemple, une image au format GIF, un son au format WAV permettant d’illustrer le produit ou le tiers (paramètre MEDIA).

Pour toutes les clés de cette section, aucune valeur par défaut n’est définie.

Deux clés sont obligatoires :

Editeur de base

La valeur de la clé correspond à un paramètre qui est "@nom_fichier". Ce paramètre sera remplacé par le nom du fichier à charger lors de l'appel de la commande. L'association avec l'application à utiliser est dynamique.

Exemple :

Editeur de Base=@nom_fichier

Visualisation de différents types de fichiers d’édition (écran UEDI_1)

Au moment de l’exécution, Windows fait le lien entre l’extension du fichier et le programme de visualisation paramétré. Si ce lien n’existe pas, Windows affichera un message d’erreur.

Les clés ap$tmp et ap$log définies dans la section [Repertoires] doivent pointer vers des répertoires existants sur le poste client.

Impression de base

La valeur de la clé correspond au nom complet (avec le chemin) d'un éditeur sans serveur DDE suivi de la syntaxe correcte pour lancer directement l'impression à partit de l'éditeur suivi d'un paramètre qui est "@nom_fichier". Ce paramètre sera remplacé par le nom du fichier à charger lors de l'appel de la commande.

Exemple :

Impression de Base=c:\Program Files\Accessoires\Wordpad.exe /p @nom_fichier

Les autres clés sont optionnelles :

Editeur Chemin

Quand cette clé est renseignée, toutes les clés décrites ci-après (dans cette section) sont utilisées, et les clés obligatoires définies ci-dessus ne le sont plus.

La valeur de la clé correspond au nom complet (avec le chemin) d'un éditeur avec serveur DDE.

Une valeur courante pour la clé est :

Editeur Chemin=c:\Msoffice\winword\winword.exe

Editeur [nom]

Permet d’associer une extension de fichier à un outil (exécutable) (voir paramètre MEDIA).

Pour exemple :

Editeur XLS=excel$exe:excel.exe

Editeur DOC=word$exe:winword.exe

Editeur WAV=wmp$exe:mplayer2.exe

Editeur WEB=ap$explo:iexplore.exe

Editeur PDF=pdf$exe:AcroRd32.exe

Editeur Nom Serveur DDE

La valeur de la clé correspond au nom du serveur DDE de l’éditeur qui réceptionnera les macros définies ci-dessous.

Une valeur courante pour la clé est :

Editeur Nom Serveur DDE=WinWord

Editeur Nom Fenêtre

La valeur de cette clé correspond au titre de l'éditeur (texte indiqué dans la barre de titre de la fenêtre principale). Elle permet d'éviter de relancer l'éditeur à chaque demande d'édition.

Les macros suivantes sont écrites dans le format reconnu par le serveur DDE de l'éditeur. Quand on a besoin de référencer le fichier de travail dans la macro, on écrit "@nom_fichier".

Une valeur courante pour la clé est :

Editeur Nom Fenetre=Microsoft Word

Macro Impression

Lancer l'impression

Exemple de Macro Word Française

Macro Impression=[FichierNouveauDéfaut][FichierImprimer .ArrièrePlan=1 ,.Etendue=0 ,.NomFichier="@nom_fichier"]

Macro Editeur Activation

Mettre l'éditeur en avant plan.

Exemple de Macro Word Française

Macro Editeur Activation=[FenAppAgrandissement]

La gestion du mode "Aperçu avant Impression" de Word 2000 est différente de celle de Word 97.

Pour corriger le problème sous Word 97, il est nécessaire de forcer Word à repasser en mode "non aperçu". Ceci implique une modification du fichier .INI

Pour Word 97 : [AppMaximize "Microsoft Word" ,1][On Error Resume Next][ClosePreview]

Pour Word 2000 : [AppMaximize "Microsoft Word" ,1]

Macro Chargement Fichier

Permet de charger un fichier dans l'éditeur.

Exemple de Macro Word Française

Macro Chargement Fichier=[FichierOuvrir .Nom="@nom_fichier"]

Macro Fichier Lecture Seule

Permet de charger un fichier dans l'éditeur en lecture seule.

Exemple de Macro Word Française

Macro Fichier Lecture Seule=[FichierOuvrir .Nom="@nom_fichier",.LectureSeule=1,.DéjàOuvert=1]

Macro Fichier 132 colonnes

Permet d'ajuster la taille du caractère pour être capable de visualiser des fichiers ayant jusqu'à 132 colonnes.

Exemple de Macro Word Française

Macro Fichier 132 colonnes=[FormatCaractères .Points=6 ,.Défaut][AfficherTout 1][AfficherTout 0]

Macro Fichier 80 colonnes

Permet d'ajuster la taille du caractère pour être capable de visualiser des fichiers ayant jusqu'à 80 colonnes.

Exemple de Macro Word Française

Macro Fichier 80 colonnes=[FormatCaractères .Points=10 ,.Défaut]

Separateur Excel CSV

Permet de définir le séparateur utilisé par Excel. Voir aussi paramètre VIDEXC.

Ex : Separateur Excel CSV= ;

ACE est livré avec un comportement standard des touches fonction mais il vous est possible de le personnaliser en modifiant cette section TERM_XX.

"TERM" correspond à la valeur de la clé TERM défini dans la section Global, et _XXX au suffixe pour le système. Par exemple, pour Windows, avec la valeur par défaut de TERM, le nom de la section doit être vt100_WNT.

Trois types de clés peuvent apparaître :

Clés c_YYYY pour le paramétrage des caractères semi-graphiques.

Clés e_YYYY pour le paramétrage des séquences d'échappement écran.

Clés t_YYYY pour le paramétrage des séquences d'échappement clavier.

En client/serveur, seules les clés t_ sont utilisées, si elles se trouvent dans le Generix.ini du client.

Liste des clés existantes :

Comportement des touches pouvant être paramétrées par l'utilisateur dans son "Generix.ini'

Ce tableau regroupe :

• le code de la touche,
• sa valeur en Alpha et en Windows,
• son éventuel clef associée dans le "Generix.ini",
• sa valeur par défaut,
• le comportement qui lui est associé selon l'objet dans lequel on se trouve.

Action déclenchée selon l’objet

• "Non" signifie que la fonctionnalité n'existe pas pour cet environnement : il est donc inutile d'en définir une.
• "Néant" signifie qu'il n'existe pas de touche prédéfinie.
• "Filière" signifie que vu le nombre de paramètres qui entrent en ligne de compte (filière, type de tableau, intervention d’un développement spécifique), il est impossible de dénombrer tous les comportements.

Syntaxe de définition d'une touche de fonction

clé = <code touche> + <code touche2> + <touche 3>

Cette syntaxe signifie qu'il faut appuyer successivement sur les touches définies pour activer la fonctionnalité dans ACE .

Exemple :

t_EXEC = F5

Pour activer le rappel des dernières saisie sur un champ, il faut appuyer sur la touche clavier F5.

Si pour définir une touche de fonction, on utilise les touches SHIFT, ALT ou CTRL, l'activation de la fonction se fait par l'action simultanée de ces touches avec une autre touche du clavier.

Exemple :

t_F13= SHIFT + F3

signifie que la fonction F13 est simulée par l'action simultanée de SHIFT et de F3.

Séparateur Milliers (la virgule par défaut)

Cette clé permet de paramétrer le symbole utilisé pour séparer les milliers.

La valeur de la clé peut correspondre à un caractère quelconque.

Séparateur Décimal (le point par défaut)

Cette clé permet de paramétrer le symbole à utiliser pour séparer les valeurs décimales des valeurs entières. La valeur de la clé peut correspondre à un caractère quelconque.

(2) : Les 2 valeurs client et serveur de traitements DOIVENT être identiques. La clé Serveur Traitement est obligatoire sur les postes clients en C/S. Elle est optionnelle sur le serveur de traitements.

Cette section est obligatoire, que vous utilisiez ou non la version client/serveur d’ ACE . Même dans un environnement totalement alphanumérique, il faut la renseigner dans le fichier Generix.ini du serveur.

Il n’y a pas de valeur par défaut pour les clés de cette section qui doivent obligatoirement apparaître dans le « Generix.ini » du poste client.

D’une manière systématique, la clé “ Serveur Traitement ” est obligatoire sur toutes les machines.

Les valeurs données à ces clés doivent correspondre à des noms de serveurs définis dans le fichier Hosts de la machine. Il n’est pas question d’indiquer ici des adresses IP.

Serveur Traitement : Nom de la machine Windows NT, UNIX ou VMS offrant les services de traitements, les services d’accès aux données, les services d’édition, les services d’impression.

Mise à jour des machines TSE

Sur le serveur

Serveur Traitement=NOM_DU_SERVEUR

(1) : En mode C/S, cette clé peut apparaître sur le .INI des postes client et le .INI des différents serveurs. Les valeurs peuvent être identiques ou différentes. La signification est locale à la machine sur laquelle s’exécute le binaire qui utilise cette clé. Les valeurs par défaut peuvent être utilisées.

Les clés de cette section permettent d’indiquer les répertoires physiques à associer aux répertoires logiques. Se référer au tableau détaillant la liste des répertoires pour plus de détails.

Où x est remplacé par une lettre indiquant la base de données :

• O pour Oracle,
• S pour Sybase,
• I pour Ingres,

On y trouve la clé ap$ser, qui indique où se trouve l’exécutable correspondant au bdd_serveur.

Cette section ne doit pas apparaître dans le fichier « Generix.ini » des postes clients mais uniquement sur le serveur.

Mise à jour des machines TSE

Sur les postes clients, ACE utilise certaines DLL du système pour pouvoir accéder à la mémoire partagée. Pour ce faire, il faut ajouter au fichier Generix.ini de chaque poste client ou serveur TSE la clé ap$dll pointant vers le répertoire système de Windows.

Dans la section [Repertoires], ajoutez la clé ap$dll comme suit :

Poste sous Windows NT : ap$dll=c:\winnt\system32\

Poste sous Windows 95 : ap$dll=c:\windows\system\

Aide en ligne

Il vous faut préciser les répertoires physiques où se trouvent :

• le navigateur utilisé pour consulter l'aide en ligne au format HTML,
• l'aide en ligne de vos propres fonctions (ap$hlp_xxx_cli où xxx correspond au code langue).
• l'aide en ligne des fonctions standard et des paramètres (ap$hlp_xxx_std où xxx correspond au code langue).

• Exemple d'un extrait de fichier GENERIX.INI de poste-client :

[Repertoires]

ap$aide=c:\Program Files\Plus!\Microsoft Internet\

ap$hlp_fra_cli=c:\Doc Client\

ap$hlp_fra_std=c:\Doc Standard\

NB : Pour que l'aide en ligne soit cherchée sur le poste client, il ne faut pas qu'il y ait la Clé 'Serveur Aide' sur le Generix.ini du serveur (section Client Serveur).

• Messages d'erreurs :

EXPINEX

Message : "Clé 'Explorateur' inexistante ou introuvable"

Cause : Section [Global] inconnue ou Clé 'Explorateur' inconnue.

FICINEX

Message : "Fichier inexistant ou introuvable"

Cause : Répertoire invalide ou inexistant OU fichier invalide ou inexistant.

Oracle

La version 4.3-00 étant disponible uniquement en version 8 d’Oracle, il est inutile de gérer deux bdd_serveur.

Exemple :

[Repertoires_o]

ap$ser=e:\ACE\exe_h\

Multimédia (voir paramètre MEDIA)

Exemple de répertoires :

pdf$exe=C:\Program Files\Adobe\Acrobat 4.0\Reader\

wmp$exe=C:\Program Files\Windows Media Player\

excel$exe=c:\program files\microsoft office\office\

Image en fond d'écran

A l'instar du papier peint sur le bureau de Windows, il vous est possible de mettre une image de fond en spécifiant sa position à l’écran.

Pour ce faire, il faut indiquer la clé « ap$img » dans le fichier "Generix.ini", côté Client, pour spécifier le répertoire dans lequel sera stockée l'image.

La clé « ap$img » ne doit contenir QUE le nom du répertoire.

Il vous faut également renseigner les clés de la section [Image_Fond].

Image de la « splash window » de lancement d’une fonction

Lors du lancement d’une fonction par le menu Client/Serveur, une « splash window » (ou « splash screen ») s'affiche pendant le temps d’activation de la fonction pour signifier à l'utilisateur que le système n'est pas bloqué et que l’application est en train de s'activer.

Pour personnaliser l’image apparaissant dans ces boîtes de dialogue, il suffit de placer, dans le répertoire ap$img (côté Client), une image au format BMP nommée : « splash.bmp ».

Automatiquement, si un fichier de ce nom est trouvé dans ce répertoire, la splash window affichera l’image correspondante.

Si aucun fichier n’est trouvé, l’image utilisée est l’image par défaut (logo du produit ACE ).

Image de la « splash window » du lanceur

Lors de l’exécution du lanceur, une « splash window » (ou « splash screen ») s'affiche pendant le temps d’activation du lanceur pour signifier à l'utilisateur que le système n'est pas bloqué et que l’application est en train de s'activer.

Pour personnaliser l’image apparaissant dans ces boîtes de dialogue, il suffit de placer, dans le répertoire ap$img (côté Client), une image au format BMP nommée : « lanceur.bmp ».

Automatiquement, si un fichier de ce nom est trouvé dans ce répertoire, la splash window affichera l’image correspondante.

Si aucun fichier n’est trouvé, l’image utilisée est l’image par défaut (logo du produit ACE ).

Image de la mire de connexion

Pour personnaliser l’image apparaissant dans la mire de connexion, il suffit de placer, dans le répertoire ap$img (côté Client), une image au format BMP nommée : « mire.bmp ».

Automatiquement, si un fichier de ce nom est trouvé dans ce répertoire, la splash window affichera l’image correspondante.

Si aucun fichier n’est trouvé, l’image utilisée est l’image par défaut (logo du produit ACE ).

Paramétrage utilisateur des écrans tableaux

ACE vous permet de manipuler facilement les tableaux. En effet, pour tout un ensemble d'écrans, les en-têtes des colonnes peuvent se retailler et se déplacer après que l'écran ait été chargé.

Chaque utilisateur a la possibilité de conserver sa personnalisation une fois l'écran fermé. A son prochain appel, les colonnes reprendront automatiquement les mêmes dimensions et le même ordre.

De manière concrète, l’utilisateur peut à tout moment enregistrer ou supprimer son paramétrage par appel de popups. Il suffit de renseigner, dans la section [repertoires] du fichier "Generix.ini" client, la clé « ap$usr » qui spécifie le répertoire propre à l’utilisateur, où seront enregistrés toutes les personnalisations de tableaux.

L’emplacement du répertoire est important. Dans la plupart des utilisations, il est conseillé de pointer vers un répertoire qui se situe sur le poste de l’utilisateur.

Mais si un même utilisateur est susceptible de travailler sur plusieurs postes, le répertoire peut être commun aux différentes machines. Ainsi, les utilisateurs récupèrent leur paramétrage quel que soit leur poste de travail.

[Repertoires]

ap$usr=ap/langue/fra/usr (serveur unix)

Sur le poste Client, un répertoire est systématiquement créé pour chaque langue, sous la forme :

langue/xxx/usr (xxx=langue)

Format du fichier

Le nom du fichier est formé de quatre identifiants : le numéro de société, le nom de l’agent, le nom de la fonction et le nom de l’écran. Ce qui donne : soc_agent_fonction_ecran. Ces fichiers ont l’extension usr (comme USER).

Ces fichiers contiennent les informations nécessaires au paramétrage utilisateur, plus des informations de vérification telle que la version.

Configuration de l’environnement

Les informations de configuration de l’environnement, modifiables par le client, sont regroupées dans un même répertoire, désigné par la clé ap$site.

Cette fonctionnalité permet :

• des mises à jour simplifiées du répertoire des agents d’exploitation,
• de partager les agents d’exploitation entre plusieurs environnements,
• de sauvegarder facilement les informations de configuration.

Répertoires YODAN (Retail Analytics)

ap$ra_proc=\\ssss\...\proc_ra\ Répertoire des procédures Retail Analytics, coté serveur de traitement,

ap$ra_seasonality_trend=\\yyyy\...\CALCUL-PREVISION\

ap$ra_cross_effects==\\yyyy\...\CALCUL-PREVISION\

ap$ra_product_grouping=\\yyyy\...\CALCUL-PREVISION\

ap$ra_ice=\\yyyy\...\CALCUL-PREVISION\

ap$ra_prevision=\\yyyy\...\CALCUL-PREVISION\

ap$ra_simulation= \\yyyy\...\\CALCUL-SIMULATION\

ap$ra_gs_parameterisation=\\yyyy\...\CALCUL-PREVISION\

ap$ra_gs_forecast_prev=\\yyyy\...\CALCUL-PREVISION\

ap$ra_gs_forecast_sim=\\yyyy\...\CALCUL-SIMULATION\

ap$ra_recursive=\\yyyy\...\CALCUL-PREVISION\

• avec \\ssss\...\ représentant le répertoire principal du serveur de traitement.
• avec \\yyyy\...\ représentant le répertoire partagé entre le serveur de traitement et le serveur Retail Analytics.

Les clés de cette section permettent de dimensionner les zones de mémoire partagées et le contrôle des licences. Les données alimentées à ce niveau doivent être en accord avec votre contrat Aurea.

Nombre de Files Batchs (par défaut 0 sur un poste client et 1 sur le serveur de traitement)

En limitant le nombre de files batchs supportées par l’applicatif, cette valeur permet de dimensionner la zone de mémoire partagée associée aux files batchs.

La valeur doit correspondre à la somme des files batchs déclarées dans l’applicatif ajouté au nombre d’éditions directes pouvant être lancées simultanément.

Nombre de Batchs Simultanes (par défaut 0 sur un poste client et 5 sur le serveur de traitement)

Cette clé vous permet de limiter le nombre de traitements différés pouvant s’exécuter simultanément dans une file rapide (voir documentation de référence UERP).

Dès le démarrage de la fonction UERP, et en cas de dépassement de ce seuil, la capacité de la file rapide est automatiquement limitée. Un message est d’ailleurs inscrit dans le fichier « UERP.LOG ».

Attention : en cas d’utilisation de l'instruction LANCE_INTEGR (lancement direct de l'intégration) dans un batch lancé en mode Rapide depuis l’application web, la clé « Nombre de Batchs Simultanes » (de la section [Licences] duGenerix.ini) doit être paramétré avec le Maximum (du « Nbre Max Traitement » des files rapides) X Nombre de batchs chainés potentiel d’un batch principal.

Nombre de Sessions Interactives Locales

• Poste Client

Ä 1 pour un client classique.

Ä n pour une machine TSE, où n correspond au nombre de sessions potentielles.

• Serveur

Ä correspond au nombre de sessions sur la machine locale.

Ä dans le cas de la version alphanumérique, la valeur indique le nombre de sessions depuis lesquelles on peut utiliser ACE .

Nombre de Fonctions Simultanees Locales

Nombre de fonctions pouvant être utilisées simultanément dans chacune des sessions en plus du menu.

Nombre Maximum de Machines ACE

Nombre maximum de machines pouvant utiliser ACE : le serveur de traitement en est une, chaque poste client classique en est une, un serveur TSE en vaut une (et non pas n où n correspond au nombre de sessions TSE).

Nombre de Sessions Interactives Globales

Somme des nombres de sessions interactives locales déclarées sur chacune des machines utilisant ACE.

Cette valeur « Nombre de Sessions Interactives Globales » étant cryptée, il faut la remplacer par une clé (spécifique à chaque client) délivrée par Aurea.

Ce clé est une suite de chiffres et de lettres qui déterminent le nombre maximum de sessions interactives autorisées et permettent de vérifier les droits de l’utilisateur à utiliser sa licence sur sa configuration.

Pour obtenir votre clé, reportez-vous au document « Enregistrement de licences » qui vous est systématiquement remis à toute livraison.

En fonction de ces informations, nous vous communiquons une clé qui vous est réservée.

Remarque : Il est possible de faire tourner sur une même machine physique plusieurs instances d’ACE en différenciant les superviseurs par leur numéro.

Ce fonctionnement, auparavant réservé à un usage purement interne, notamment pour faire cohabiter plusieurs versions sur la même machine; peut être étendu et utilisé sur votre site, grâce au mécanisme de contrôle des licences.

Il vous faudra une clé de licence par instance sur votre serveur de traitement, puisque le numéro de programme superviseur est contrôlé par la clé licence.

Dans la colonne « localisation » pour cette clé "nombre de sessions interactives globales", il y a « traitement ». Pour la machine de traitement, il faut effectivement une clé licence..

Nombre de Fonctions Simultanees Globales

Nombre maximum de fonctions ACE qui seront utilisées à un instant t sur l’ensemble des postes clients en mode client/serveur.

Cette section correspond à l’option Exécution Logistique. (voir aussi la section [Systeme], clé « Trace LoginRF »).

Serveur Interscan : spécifie le nom de la machine hébergeant les process PowWow.

Numero LoginRF : spécifie le numéro de module avec lequel le process “ login_rf.exe ” se référence dans PowWow.

Tous les échanges Terminaux RF/ Login_rf.exe se feront alors sur la base de ce numéro de module.

Port LoginRF : spécifie le port TCP/IP sur lequel le dialogue module/PowWow se réalise. Ce numéro de port ne doit être modifié que si la configuration de PowWow est modifiée.

Timeout LoginRF : spécifie le délai d’attente (exprimé en minutes) de réception des process login_rf.exe en mode dialogue RF. Lorsque ce délai d’attente est écoulé, sans que le login_rf n’ait recu de nouveau message, ce process se termine normalement.

Numero ServeurRF : spécifie le premier numéro de module avec lequel les process “ serveur_rf.exe ” en mode dialogue RF, se référencent dans PowWow.

Tous les échanges Terminaux RF/ serveur_rf.exe se feront alors sur la base de ce numéro de module auquel on ajoute le numéro de slot en mémoire partagée globale associé au process serveur_rf.exe

Si le “ Numero ServeurRF ” vaut 600, si le process serveur_rf associé au terminal RF, s'active sur le numéro de slot 14 en mémoire partagée, le numéro de module associé à ce process dans PowWow est 614. Il convient donc de s'assurer du non chevauchement de numéro de module du LoginRF et ServeurRF. Nous recommandons : "Numero ServeurRF" > "Numero LoginRF”.

Port ServeurRF : spécifie le port TCP/IP sur lequel le dialogue module/PowWow se réalise. Ce numéro de port ne doit être modifié que si la configuration de PowWow est modifiée.

Timeout ServeurRF : spécifie le délai d’attente (exprimé en minutes) de réception des process serveur_rf.exe en mode dialogue RF. Lorsque ce délai d’attente est écoulé, sans que le serveur_rf n’ait recu de nouveau message, ce process se termine normalement.

Agent_numsoc (version 4.5-00) : permet d'activer la trace du serveur_rf et la trace SQL de son bdd_serveur associé.

Numsoc correspond au numéro de la société.

La valeur par défaut (code_agent ) correspond au nom de l'agent RF.

Il n'est pas possible, contrairement aux traces interactives "standards", de préciser un nom de fonction. Cette notion n'existe pas dans l'architecture RF.

Depuis la version 4.5-00, il y a une trace pour le serveur RF qui écrit dans le fichier toutes les API RF reçus.

Les noms des fichiers traces générés dans le répertoire du "Generix.ini" du serveur de traitement sont :

• TRC_RPCSER_<i>.LOG avec i étant le numéro de module (num_rpc) comme pour les serveur_rpc. => trace sql
• TRC_RFSRV_<i>.LOG avec i étant le numéro de connexion à POWWOW (500 + x). => Trace RF

Connexion Multi Terminaux : autorise un utilisateur utilisant la RF à se connecter simultanément à ACE avec plusieurs terminaux RF. Il est recommandé de laisser la valeur par défaut (“Non”), sauf pour Powwow Entreprise où la valeur “Oui” est obligatoire.

Utilisation NextRec : permet l’utilisation de « Next record » (inutilisé par ACE). En positionnant cette clef à « Non », il vous est possible de réduire le trafic du réseau PowWow et donc d’améliorer les temps de réponse.

Cette section RF permet de gérer le mode radio-fréquence (RF) en technologie web.

Port ServeurRF : premier numéro de port TCP/IP avec lequel les process “ serveur_rf.exe ” se mettent en écoute de dialogue RF e-Gx.

Tous les échanges entre le navigateur internet et le “serveur_rf.exe” se réalisent alors sur la détermination d’un port TCP/IP libre à partir de ce numéro de base.

La valeur par défaut est le numéro de port utilisé par UERP.

Timeout ServeurRF : délai d’attente (exprimé en minutes) de réception des process « serveur_rf.exe » dans le mode de dialogue RF e-Gx. Lorsque ce délai d’attente est écoulé, sans que le “serveur_rf » n’ait reçu de nouveau message, ce process se termine normalement.

Connexion Multi Navigateur : cette clé permet d’autoriser un utilisateur utilisant la RF à se connecter simultanément à ACE avec plusieurs navigateurs WEB (sur des terminaux différents).

Niveau de Trace : cette clé permet de sélectionner le niveau de trace des process « serveur_rf ». Il est possible d’indiquer un niveau de trace. La signification des niveaux de trace est la même que pour l’outil UERP / Scrutateur (voir documentation UERP) : OFF, INFO, DEBUG et FULL.

Agent_numsoc : permet d'activer la trace du serveur_rf et la trace SQL de son bdd_serveur associé.

numsoc correspond au numéro de la société.

La valeur par défaut (code_agent ) correspond au nom de l'agent RF.

Exemple : Agent_1=GNC

Il n'est pas possible, contrairement aux traces interactives "standards", de préciser un nom de fonction. Cette notion n'existe pas dans l'architecture RF.

Les noms des fichiers traces générés dans le répertoire du "Generix.ini" du serveur de traitement sont :

• TRC_RPCSER_<i>.LOG => trace sql
• TRC_RFSRV_<i>.LOG => Trace RF

Cette section est optionnelle (possibilité d'accéder une base de données Oracle via SQLNET et trace SQL)

Trace Scrutateur : cette clé, positionnée sur le serveur de traitements, permet d’obtenir une trace associée aux ordres SQL exécutés par le process scrutateur. La valeur par défaut est “ NON ”.

Trace Reduite : cette clé, positionnée sur le serveur de traitements, permet d’obtenir une trace plus réduite, satisfaisante lorsque les binaires n’exécutent que des accès SGBD via des RELs et non satisfaisante, lorsque des ordres SQL dynamiques complexes sont utilisés.

Fonction_xxx (xxx représente le numéro de société) : enregistre les ordres SQL des fonctions s’exécutant avec un agent connecté sur la société “ xxx ” et dont le code fonction appartient à la liste des codes fonctions spécifiés par cette clé.

Les différents codes fonction sont séparés par une virgule.

Agent_xxx (xxx représente le numéro de société) : enregistre les ordres SQL de toutes les fonctions s’exécutant avec un agent connecté sur la société “ xxx ” et dont le code agent appartient à la liste des codes agent spécifiée par cette clé.

Les différents codes agent sont séparés par une virgule.

Batch_xxx (xxx représente le numéro de société) : enregistre les ordres SQL des fonctions batch s’exécutant avec un agent connecté sur la société “ xxx ” et dont le numéro de batch appartient à la liste de numéros spécifiée par cette clé.

Les différents numéros sont séparés par une virgule.

Trace Superviseur (V 4.4-00)

Permet la gestion du mode trace du bdd_serveur pour le superviseur

La clé "Trace Superviseur" permet de l'activer (par défaut, la valeur est à NON).

Trace Superviseur=OUI

Comme pour la trace du scrutateur (Trace Scrutateur=OUI), la "Trace Superviseur" est positionnée pour son bdd_serveur, et pas pour le fonctionnement interne du superviseur.

Cette clé doit surtout être utilisée en phase de premiers démarrages après toute nouvelle installation.

Trace UERP : cette clé permet d’enregistrer tous les accès effectués à la base de données, via UERP mais aussi d’ajouter des messages de debug dans la trace « UERP.LOG » Le nom du fichier trace généré dans le répertoire du "Generix.ini" est « TRC_UERP_x.LOG ».

Cette opération nécessite un arrêt/redémarrage du process par ACE MANAGER pour être pris en compte.

Trace Performance : permet l'affichage de l'heure de réception et de l'heure de la fin d'exécution d'un ordre SQL dans la trace du bdd_serveur.

Trace MonoLigne : permet d'afficher, sur une seule ligne, la trace SQL. La valeur par défaut est “ NON ”.

e-Gx

L’un des exemples les plus représentatifs de passerelles entre le produit ACE "classique" et les autres applications concerne e-GX. Un utilisateur peut en effet travailler quasiment indifféremment en mode web et ACE classique en passant facilement de l'un à l'autre.

Cette fonctionnalité nécessite de définir certaines clés obligatoires dans la section [e-gx] du fichier « Generix.ini », côté Client :

Cette description vous permet notamment de définir les écrans de la fonction à partir desquels il vous est possible d’effectuer des appels externes vers une page HTML (voir écran GPEV_8).

Comme le papier peint sur le bureau de Windows, il vous est possible d’afficher une image de fond dans ACE en spécifiant sa position à l’écran.

Pour ce faire, il faut, dans le fichier Generix.ini, côté Client :

• spécifier le répertoire dans lequel sera stockée l'image (section [repertoires],
• renseigner certaines clés de la section [Image_Fond]).

[Image_Fond]

Image Nom=

Image Nom codsoc=

Image Nom agent=

Ces trois clés indiquent le nom du fichier image sans extension. Il vous est possible de réaliser un paramétrage par société ou par agent. Cela permet donc d’afficher une image spécifique selon l’agent ou la société identifié(e), ce qui peut se révéler fort intéressant en mode multi-entités.

ACE affiche en priorité l’image associée à l’agent, puis l’image associée à la société, et enfin l’image définie quels que soient l’agent et la société connectés.

Image Position=

Cette clé spécifie la position de l’image à l’écran (en bas et au centre par défaut). Vous pouvez choisir parmi les valeurs suivantes :

• CENTRE : place l’image dans sa taille d’origine au centre,
• HAUT DROIT : place l’image dans sa taille d’origine dans le coin en haut à droite,
• HAUT GAUCHE : place l’image dans sa taille d’origine dans le coin en haut à gauche,
• BAS DROIT : place l’image dans sa taille d’origine dans le coin en bas à droite,
• BAS GAUCHE : place l’image dans sa taille d’origine dans le coin en bas à gauche,
• BAS CENTRE : place l’image dans sa taille d’origine en bas au centre (position par défaut),
• MOSAIQUE : place l’image dans sa taille d’origine au format mosaïque centré, c’est-à-dire que la première image est au centre (contrairement à Windows qui démarre dans le coin haut droit de l’écran ),
• PLEIN ECRAN : place l’image avec comme dimension la taille de l’écran
• ETIRE : place l’image dans sa dimension maximale en respectant sa proportionnalité.

=> Exemple d’utilisation :

Image Position BEB=haut droit,

Image Position 0022=haut gauche,

Image Position=bas gauche.

La position de l’image suit les mêmes priorités que la référence de l’image : d’abord celle de l’agent, puis celle de la société, et enfin la position par défaut pour l’ensemble des agents et sociétés connectés.

Même si, les données logiques sont cloisonnées par société, il vous est possible de les partager voire d’en partager une partie (informations Clients par exemple).

Après avoir défini les sociétés, grâce à la fonction USOC, il vous faut paramétrer le fichier « GENERIX.INI » du serveur. Ensuite, vous pourrez charger les données grâce à VISU CS (outil U).

A toute société physique (réelle) correspond une base de données. A cette société physique, vous pouvez rattacher des sociétés logiques qui utiliseront la même base de données.

SOCIETE_1 = 1

SOCIETE_2 = 1

SOCIETE_3 = 1