Paramètres d'Up ! Shell

Up ! Shell est l'outil multi-plates-formes d'interprétation en interactif de commandes ou de scripts écrits en Up ! 5GL.

Up ! Shell nécessite un script de démarrage dont le contenu varie selon le contexte d'emploi. Les scripts sont rangés dans le répertoire ${UPS_HOME}/upssdk/sources/${UPS_LANGUAGE} en mode mono-utilisateur ou ${UPS_HOME}/upssdk/sources/${UPS_USER} en mode multi-utilisateur.

Le contexte d'emploi peut être soit :

Le script de démarrage peut comporter des modules importés, des définitions globales, des procédures et des fonctions et des instructions à exécuter au lancement.

En outre, il est possible en interactif de :

Le résultat des commandes tapées interactivement ou exécutées en batch sont formatées en une édition dans la sortie standard qui compte des paramètres de présentation d'Up ! Shell présentés dans la section suivante.

L'édition peut être personnalisée en spécifiant préalablement à son exécution :

Quel que soit son mode d'invocation, Up ! Shell possède les mêmes paramètres cités dans la section suivante. La commande est, selon les plates-formes, upsshl, upsshl.exe ou upsshl.com.

Up ! Shell peut être invoqué soit :

Certains paramètres font référence à des fichiers ou à des chemins d'accès. En ce cas, il est possible d'employer des variables environnement dans l'expression des chemins d'accès. Exemple :

Tmp=${UPS_HOME}/demo/tmp/${UPS_USER}

D'autre part, le séparateur de répertoire est le caractère division / et les noms de fichiers ou de répertoires peuvent utiliser les partitions montées automatiquement par Up ! System.

Les paramètres sont lus successivement dans :

Les valeurs des paramètres comportant des caractères espace doivent être mises entre caractères guillemet " ou entre caractères apostrophe ' .

Pour connaître le source d'Up ! Shell, merci de se référer à la fiche Source d'Up ! Shell.

Paramètres d'interprétation

Up ! Shell étant un programme Up ! Application System particulier, les paramètres de lancement de Up ! Virtual Technical Machine et celles d'exécution de Up ! Kernel s'appliquent. En revanche, la configuration de Up ! Object Management System est imposée. Elle correspond au fichier ${UPS_HOME}/ini/upssdk.ini.

CadreCorpsTableau

CadreCorpsTableau permet de spécifier le style de cadre pour le corps des tableaux produits automatiquement. La valeur par défaut est CadreSimple.

Style de cadre.Valeur du paramètre.
Pas de cadre.CadreAucun
Cadre simple.CadreSimple
Cadre double.CadreDouble
Cadre ombré.CadreOmbre

CadreEnteteTableau=CadreSimple

CadreEnteteTableau

CadreEnteteTableau permet de spécifier le style de cadre pour l'en-tête des tableaux produits automatiquement. La valeur par défaut est CadreDouble.

Style de cadre.Valeur du paramètre.
Pas de cadre.CadreAucun
Cadre simple.CadreSimple
Cadre double.CadreDouble
Cadre ombré.CadreOmbre

CadreEnteteTableau=CadreOmbre

Source

Source permet de spécifier le script en Up ! 5GL qui sert à définir le contexte de l'interprétation. La valeur par défaut est ${UPS_HOME}/upssdk/sources/${UPS_LANGUAGE}/upsshl.upl.

Il s'agit d'un source d'un composant, d'un module ou d'une ressource en Up ! 5GL.

Pour un source d'un composant ou d'un module, si le script comporte :

Source=${UPS_HOME}/demo/sources/${UPS_LANGUAGE}/monscript.upl

TailleCelluleBooleen

TailleCelluleBooleen permet de spécifier la largeur en nombre de caractères d'une cellule d'un tableau produit automatiquement pour une valeur booléenne. La valeur par défaut est permet d'écrire intégralement Oui ou Non dans la langue sélectionnée.

TailleCelluleBooleen=1

TailleCelluleDate

TailleCelluleDate permet de spécifier la largeur en nombre de caractères d'une cellule d'un tableau produit automatiquement pour une valeur de type date. La valeur par défaut est 11.

TailleCelluleDate=11

TailleCelluleDateEtHeure

TailleCelluleDateEtHeure permet de spécifier la largeur en nombre de caractères d'une cellule d'un tableau produit automatiquement pour une valeur de type date et heure. La valeur par défaut est 20.

TailleCelluleDateEtHeure=20

TailleCelluleEntier

TailleCelluleEntier permet de spécifier la largeur en nombre de caractères d'une cellule d'un tableau produit automatiquement pour une valeur entière. La valeur par défaut est la longueur du filtre FiltreEntier.

TailleCelluleEntier=10

TailleCelluleHeure

TailleCelluleHeure permet de spécifier la largeur en nombre de caractères d'une cellule d'un tableau produit automatiquement pour une valeur de type heure. La valeur par défaut est 8.

TailleCelluleHeure=8

TailleCelluleIdentifiant

TailleCelluleIdentifiant permet de spécifier la largeur en nombre de caractères d'une cellule d'un tableau produit automatiquement pour un identifiant i.e. un mot. La valeur par défaut est 15.

TailleCelluleIdentifiant=30

TailleCelluleLibelle

TailleCelluleLibelle permet de spécifier la largeur en nombre de caractères d'une cellule d'un tableau produit automatiquement pour un libellé i.e. plusieurs mots. La valeur par défaut est 25.

TailleCelluleLibelle=50

TailleCelluleReel

TailleCelluleReel permet de spécifier la largeur en nombre de caractères d'une cellule d'un tableau produit automatiquement pour une valeur réelle. La valeur par défaut est la longueur du filtre FiltreReel.

TailleCelluleReel=10

Formatages particuliers

Up ! Shell formate le résultat de certaines Application Program Interface (API) de la sorte à améliorer la lisibilité :

Up ! Shell formate sinon le résultat en fonction de son type :

Up ! Shell formate sinon le résultat par appel à la méthode privée Tracer implémentée automatiquement qui tient compte de l'inflexion Trace.

Script de lancement

Voici le script de lancement par défaut ${UPS_HOME}/upssdk/sources/${UPS_LANGUAGE}/upsshl.upl :

Source Composant "Up ! Shell" Version 4.0.0;

Fonction UpsPs1() Retourner Caractere
/***********************************/
Debut
Retourner LireRepertoireCourant()+" =>";
Fin Fonction

Fonction UpsPs2() Retourner Caractere
/***********************************/
Debut
Retourner LireRepertoireCourant()+" ?>";
Fin Fonction

Principal
/*******/
Debut
Ecran.Ecrire("Up ! Shell - version 4.0.0 - Copyright Up ! Company (c) 2003-2007\n");
Ecran.Ecrire(Caractere(DateSysteme(), "Le %j/%m/%A à %HH:%Mi:%S\n"));
Fin Principal

Exemple de configuration d'Up ! Shell

; -------------------------------------------------------------------
; Fichier : upsshl.ini
; Objet : Initialisation d'Up ! Shell.
;
; Module : Up ! Application System.
; Auteur-Date : DUVAL Jean-Pierre - Novembre 2003.
; -------------------------------------------------------------------
; Observations
;
;
; -------------------------------------------------------------------

[UpsShl]
CadreEnteteTableau=CadreSimple
CadreEnteteTableau=CadreOmbre
Source=${UPS_HOME}/demo/sources${UPS_LANGUAGE}/monscript.upl
TailleCelluleBooleen=1
TailleCelluleDate=11
TailleCelluleDateEtHeure=20
TailleCelluleIdentifiant=30
TailleCelluleEntier=10
TailleCelluleHeure=8
TailleCelluleLibelle=50
TailleCelluleReel=10