Up ! Object Request Broker peut être invoqué soit :
Up ! Object Request Broker peut être aussi invoqué ponctuellement pour réaliser des opérations sur les annuaires. En ce cas, le mode serveur n'est pas activé.
Quelles que soient les plates-formes, Up ! Object Request Broker possède les mêmes paramètres cités dans la section suivante. La commande est, selon les plates-formes, upsorb, upsorb.exe ou upsorb.com.
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}
/ 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 paramètres peuvent être préfixés par UpsOrb.
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 ! Object Request Broker, merci de se référer à la fiche Source d'Up ! Object Request Broker.
Voici la liste des valeurs possibles :
| Action | Valeur de l'option |
| Créer un annuaire. | CreerAnnuaire |
| Exporter le contenu de l'annuaire. | ExporterAnnuaire |
| Importer le contenu de l'annuaire. | ImporterAnnuaire |
| Supprimer un annuaire. | SupprimerAnnuaire |
Action=CreerAnnuaire
Quand le paramètre Action est renseigné, le programme Up ! Object Request Broker n'est pas lancé en mode serveur mais en interactif. En conséquence, le paramètre PasDOrb d'Up ! Network est fixé à Vrai.
Ce paramètre est utilisé pour l'action ExporterAnnuaire.
Chemin=/applications
Detail=Oui
Entete=Oui
Ce paramètre est obligatoire pour les actions AjouterAnnuaire, ExporterAnnuaire, ImporterAnnuaire et SupprimerAnnuaire.
NomAnnuaire=mon-annuaire
Ce paramètre est obligatoire pour les actions ExporterAnnuaire et ImporterAnnuaire.
Source=${UPS_HOME}/upsorb/resources/${UPS_LANGUAGE}/mon-annuaire.upl
NbPersistantsMax=10
NomNoeud=lune
URINoeud=UpsTcp://lune:1632
Cette option est obligatoire.
URINoeudMaitre=UpsTcp://andromede:1632
Etant donné que plusieurs serveurs peuvent être démarrés automatiquement, le paramètre Serveur est suivi d'un index.
Serveur peut correspondre également aux extensions serveur d'Up ! Network :
| Valeur de Serveur | Module |
| UpsFts | Up ! File Transfer Service |
| UpsCns | Up ! Content Service |
| UpsDrs | Up ! Directory Service |
| UpsMls | Up ! Mail Service |
Serveur1=Finances Serveur2=ResHum Serveur3=UpsCns
Annuaire=mon-annuaire.upl
Cet annuaire correspond à la variable AnnuaireLocal.
Voici la liste des valeurs possibles :
| Format | Valeur de l'option |
| Uniquement format texte en Up ! 5GL. | FormatRessourceUps5GL |
| Uniquement format binaire. | FormatRessourceBinaire |
| Format texte en Up ! 5GL s'il est plus récent que le format binaire. Format binaire sinon. | FormatRessourceAutomatique |
Par défaut, la sélection du format est automatique.
FormatAnnuaire=FormatRessourceUps5GL
Avec un serveur d'annuaire, il est enregistré localement dans ce serveur mais exploitables par tous les ordinateurs désignant ce serveur d'annuaire.
URIServeurAnnuaire=UpsOrb://andromede.finances
| Type | Conservation possible | Taille par défaut du segment |
| IAnnuaire | Oui. | 2. |
Quand un nouvel objet du type est demandé, il est prélevé de l'anté-moire s'il en existe un pré-construit. Cela évite de réaliser des enchaînements de destruction / libération / ... / allocation / création d'objets de ce type trop fréquents.
Par défaut, les objets ne sont pas conservés en anté-mémoire.
ConserverObjetsIAnnuaire=Non
TailleSegment spécifie la taille d'un segment de mémoire dédié à un objet du type concerné en spécifiant le nombre d'objets de ce dernier par segment de mémoire. Ce nombre ne peut excéder la capacité du ramasse-miettes définie par TailleBloc*NbBlocs.
La valeur est 0 signifie que le type n'a pas ses propres buffers et que les objets du type sont alloués dans le tas commun.
TailleSegmentI=4
Source Annuaire "Exemple de l'emploi des annuaires" Version 4.0.0;
Annuaire MonAnnuaire
/******************/
Debut
EcrireEntree("/coucou", "/COUCOU");
EcrireEntree("/hello", "/HELLO");
EcrireEntree("/guten tag", "/GUTEN TAG");
EcrireEntree("/coucou/coucou", "/COUCOU/COUCOU");
EcrireEntree("/hello/coucou", "/HELLO/COUCOU");
EcrireEntree("/coucou/hello", "/COUCOU/HELLO");
EcrireEntree("/hello/hello", "/HELLO/HELLO");
EcrireEntree("/hello/guten tag", "/HELLO/GUTEN TAG");
EcrireEntree("/coucou/guten tag", "/COUCOU/GUTEN TAG");
EcrireEntree("/guten tag/coucou", "/GUTEN TAG/COUCOU");
EcrireEntree("/guten tag/hello", "/GUTEN TAG/HELLO");
EcrireEntree("/guten tag/guten tag", "/GUTEN TAG/GUTEN TAG");
EcrireEntree("/divers/enumere", Enumere(1));
EcrireEntree("/divers/entier", Entier(10));
EcrireEntree("/divers/date", Date(24,3,2006,16,02,32,0));
EcrireEntree("/divers/reel", Reel(100.10));
EcrireEntree("/divers/liste" , Liste(Type("UpsKrn", "Caractere"), 3, "bonjour", "hello", "guten tag"));
Fin Annuaire
; -------------------------------------------------------------------
; Fichier : upsaps.ini
; Objet : Initialisation d'Up ! Virtual Technical Machine.
;
; Module : Up ! Application System.
; Auteur-Date : DUVAL Jean-Pierre - Novembre 2003.
; -------------------------------------------------------------------
; Observations
;
;
; -------------------------------------------------------------------
[UpsOrb]
ConserverObjetsIAnnuaire=Non
FormatAnnuaire=FormatRessourceUps5GL
NomAnnuaire=mon-annuaire.upl
TailleSegmentI=4
URIServeurAnnuaire=UpsOrb://andromede.finances
; -------------------------------------------------------------------
; Fichier : upsorb.ini
; Objet : Initialisation d'Up ! Object Request Broker.
;
; Module : Up ! Application System.
; Auteur-Date : DUVAL Jean-Pierre - Novembre 2003.
; -------------------------------------------------------------------
; Observations
;
;
; -------------------------------------------------------------------
[UpsOrb]
NbPersistantsMax=100
URINoeudMaitre=UpsTcp://local:1632
Serveur1=Finances
Serveur2=ResHum
[Noeud1]
NomNoeud=soleil
URINoeud=UpsTcp://soleil:1632
[Noeud2]
NomNoeud=venus
URINoeud=UpsTcp://venus:1632
[Noeud3]
NomNoeud=jupiter
URINoeud=UpsTcp://jupiter:1632
[Noeud4]
NomNoeud=terre
URINoeud=UpsTcp://terre:1632
[Noeud5]
NomNoeud=mars
URINoeud=UpsTcp://mars:1632
[Noeud6]
NomNoeud=saturne
URINoeud=UpsTcp://saturne:1632