Commandes pour utiliser ADAPT Windows:

Un Atelier de développement est disponible pour ADAPT Windows. Il permet l'édition de vos programmes ADAPT et leur compilation. Il aide à la correction des erreurs et permet de lancer vos programmes.

L'Atelier est aussi capable de compiler des fichiers paramètres d'applications Seconde (.LOK, .DIC, .ZON).

Le programme ATELIER.EXE doit être installé dans le même répertoire que WINADAPT.EXE et que ATELIER.HLP..

L'Atelier communique avec ADAPT:

- si ADAPT n'exécute pas, ATELIER le lance en spécifiant ce qui doit être fait dans la ligne de commande

- si ADAPT exécute déjà, ATELIER lui envoie des requêtes DDE qui suivent la même syntaxe.

Vos programmes MS-Windows peuvent faire de même.

La ligne de commande comporte quatre paramètres positionnels et plusieurs paramètres optionnels:

WINADAPT directivescompilées entrée sortie application.PAR

Sous Windows, nous avons remplacé l'écran "caractères" de MS-DOS par une fenêtre "Terminal" qui comprend les commandes de positionnement ANSI.

Tout programme réalisé pour la version DOS peut être utilisé avec la version Windows sans modification. La version Windows de Adapt permet en plus:

- d'utiliser le presse papier

- d'être client ou serveur DDE

- de spécifier une chaîne de caractères comme fichier d'entrée

Une dernière nouveauté de la version Adapt Windows est de pouvoir exécuter un programme Adapt soit en mode normal, soit en suivant l'exécution des directives dans une fenêtre indépendante.

Paramètres de la ligne de commande

Deux types de syntaxes sont admises pour la ligne de commandes:

Soit une syntaxe semblable à DOS:

WINADAPT fichier-directives fichier-Source fichier-Résultat Application-Seconde.PAR

Par exemple: WINADAPT DB2C CLIENT.DB CLIENT.C

Soit une syntaxe non positionnelle:

Chaque paramètre est spécifé par une instruction de la forme /L=x. Chaque instruction de la ligne de commandes est séparée par un espace.

Par exemple: WINADAPT /P=DB2C /I=CLIENT.DB /O=CLIENT.C

/P=FichierDirective

Le fichier de directives compilées est le programme Adapt qui contient les règles de transformation du fichier source en un fichier résultat. Ce fichier doit être un fichier normal. (Disque:\Chemin\nom.ext). Par exemple: /P=DB2C

/I=FichierSource

Le fichier-source est le fichier source de la transformation.

Ce fichier peut être:

- soit un fichier classique,

- soit con: le fichier-source correspond aux caractères introduits au clavier jusqu'au premier CR rencontré ou jusqu'au 255 premiers caractères,

- soit clp:format le fichier source correspond au presse papier, la version format devant être utilisée

- soit mem:handle le fichier source est une zone de la mémoire,

- soit "chine de caractères" le fichier source est composé des caractères entre apostrophes.

Par exemple: /I=CLIENT.DB

/O=FichierResultat

Le fichier résultat est le fichier obtenu par application des directives au fichier source.

Ce fichier peut être:

- soit un fichier classique,

- soit con: le résultat est affiché sur le terminal,

- soit clp: le résultat est copié dans le presse papier,

- soit mem: le résultat est copié dans une zone de la mémoire,

- soit dde: le résultat est retourné par la requète DDE.qui a demandé cette exécution

Par exemple: /O=CLIENT.DBC

/E=FichierPARpourSeconde

Le fichier PAR et sa localisation définit l'application Seconde à laquelle ADAPT devra éventuellement accéder.

/D ou /D+

permet de spécifier dans la ligne de commande que ADAPT doit être exécuté en mode déboggage.

Par exemple: /D+ permet d'activer le mode déboggage.

Remarque: Si plusieurs instructions /Dx se trouvent dans la ligne de commande, seule la dernière est prise en compte.

/F=B

indique que, après l'exécution d'un programme, Adapt termine directement son exécution.

/F=S

indique que ADAPT est exécuté en mode Serveur (réponses aux requêtes DDE). Le bordereau de Adapt est minimisé.

/F=N

indique que Adapt est exécuté en normalement.

Remarque: Seule la dernière instruction /F=x est prise en compte.

/C=n

permet d'indiquer la page de code.

Remarque: La version actuelle ne permet pas de changer de page de code (437)

/T=mxn

permet de préciser la taille du terminal par défaut. La largeur du terminal est m et la hauteur est n. En général, la taille du terminal est 80x25

Par exemple Adapt /T=40x100 pour un terminal de 100 lignes de 40 caractères

/M ou /M+

permet d'indiquer que le terminal doit être réduit lors de l'exécution.

/M-

permet d'annuler l'instruction précédente, le terminal est montré lors de l'exécution.

Remarque: seule la dernière instruction /Mx est prise en compte

/Vvar=val

permet de modifier l'Environnement d'exécution. Cette instruction assigne à la variable var la valeur val. Ceci permet d'utiliser des variables d'environnement dans les noms de fichier apparaissant dans vos directives ADAPT.

Par exemple Adapt /VADP=c:\adapt /VDATA=c:\data\client /VFACT=c:\facture ajoute dans l'environnement de Adapt les trois variables ADP, DATA et FACT

/A

permet d'activer le bordereau. Cette option est utile lorsque Adapt est déja en cours d'exécution mais qu'il est caché par d'autres fenêtres: /A rend la fenêtre de Adapt visible et active. Cette option est utile pour les requêtes DDE.

/S=NomServeur

Cette option permet de préciser le nom du serveur DDE ADAPT. Il ne peut y avoir qu'une et une seule instance de Adapt avec un nom de serveur donné. Par défaut, le nom du serveur est ADAPT. Cette option permet d'avoir plusieurs instances de ADAPT à un instant donné.

Le bordereau de paramétrage de Adapt

Le bordereau de paramétrage de ADAPT est une boîte de dialogue classique de Windows.

Elle contient dans son centre quatre rectangles (champs d'édition):

- le nom du fichier des directives

- le nom du fichier d'entrée

- le nom du fichier de sortie

- le nom du fichier .PAR si on accède à une application SECONDE.

A côté de chaque champs, il y a un bouton qui permet d'accéder à une boîte de dialogue d'ouverture de fichier. Pour passer d'un champ à l'autre ou d'un bouton à l'autre, il faut utiliser la souris ou alors utiliser les touches TAB pour passer au suivant ou SHIFT- TAB pour passer au précédent.

En dessous de la zone prévue pour l'introduction des noms de fichier, il y a 4 boutons:

- "Exécuter" permet de lancer l'exécution de Adapt proprement dite avec les paramètres spécifiés dans le bordereau.

- "Historique" permet d'accéder à la liste des dix exécutions précédentes et d'en reprendre une.

- "Quitter" permet de terminer ADAPT

- "Aide" donne accès à ce texte.

Lorsqu'ADAPT est en train d'effectuer un traitement, ces 4 boutons disparraissent et le bouton "Annuler" apparaît. Ce bouton permet d'interrompre le traitement et correspond à CTRL-BREAK sous MS-DOS.

Le bordereau contient aussi des options:

- Une case permet d'indiquer si l'on désire que le terminal soit affiché durant l'exécution (correspond à /M+ ou /M-)

- Une autre permet de préciser si l'on veut executer en mode déboggage ou non (/D+ ou /D-)

- Une liste permet de choisir une page de code (seul 437 est permis pour l'instant)

- Un bouton permet d'accéder à la modification des variables "environnement".

La boîte de dialogue "Historique"

Ceci affiche une liste avec les dix dernières lignes de commandes effectuées. Lorsqu'une de ces lignes est sélectionnée et que l'on clique le bouton OK, les paramètres sélectionnés sont copiés dans le bordereau principal. Le bouton "Annuler" revient sans modifier.

La boîte de dialogue "Environnement"

Cette boîte de dialogue permet de modifier l'environnement. Elle contient une liste qui contient l'environnement actuel. La sélection d'un élément de cette liste permet de garnir les champs "Variable" et "Valeur".

- Le champs "Variable" contient le nom de la variable à modifier ou à supprimer.

- Le champs "Valeur' contient la valeur à associer à la variable.

- Le bouton 'Enregistrer' permet d'enregistrer les modifications

- Le bouton "Supprimer" permet de supprimer une variable

Le bouton OK permet de quitter cette boîte de dialogue.