Référence d'Up ! Object Request Broker

Up ! Object Request Broker est le module qui regroupe toutes les Application Program Interfaces (API) relatives à la répartition des données et des traitements sur la topologie de l'entreprise.

Lorsqu'un programme désire utiliser les objets d'un module distribué ou lorsque qu'il désire faire appel aux traitements de ce module, il s'adresse à un serveur via Up ! Object Request Broker. Ce dernier se charge de localiser le bon serveur et d'équilibrer les demandes des clients entre les différents serveurs possibles.

Il existe deux types de serveurs :

Ceux desservant les entrepôts publics.
Ils gèrent les concurrences d'accès aux objets de leurs entrepôts et utilisent des mécanismes de réplication de mémoire pour minimiser les transferts sur le réseau.
Ceux offrant des services lors d'accès distants avec l'opérateur @.
Ils exécutent les accès distants demandés par leurs clients.

Up ! Object Request Broker gére également les annuaires d'objets.

Un annuaire est une ressource conservée dans un fichier en marge des applications. Deux applications peuvent partager le même annuaire qui peut être conservé en local ou sur un serveur. Pour ce dernier cas, le paramètre UpsOrb.URIServeurAnnuaire doit être utilisé.

Un annuaire peut être dans deux formats :

Format binaire.
Il a pour extension uob. Par exemple, l'annuaire de nom mon-annuaire aura pour nom de fichier mon-annuaire.uob.
L'avantage du format binaire est qu'il est plus rapide à charger et à enregistrer, sans nécessiter les extensions d'Up ! 5GL Parser et d'Up ! 5GL Generator pour Up ! Object Request Broker. L'inconvénient est que :
- Il n'est pas modifiable manuellement.
- Il ne peut comporter du code en Up ! 5GL mixé.
Format texte en Up ! 5GL.
Il a pour extension upl. Par exemple, l'annuaire de nom mon-annuaire aura pour nom de fichier mon-annuaire.upl.
L'avantage du format texte en Up ! 5GL est que :
- Il est modifiable manuellement.
- Il peut comporter du code en Up ! 5GL mixé.
L'inconvénient est qu'il est plus lent à charger et à enregistrer, nécessitant les extensions d'Up ! 5GL Parser et d'Up ! 5GL Generator pour Up ! Object Request Broker.
Pour connaître la syntaxe de ce format, merci de se référer à la fiche Syntaxe d'Up ! 5GL pour Up ! Object Request Broker.

Il est possible de passer du format binaire au format Up ! 5GL en changeant le mode d'enregistrement.

Les annuaires sont usuellement conservés dans le répertoire ${UPS_HOME}/upsorb/resources/${UPS_LANGUAGE}. Le fichier conservant le contenu de l'annuaire porte le nom de celui-ci.

Il existe un annuaire public géré par le serveur Up ! Object Request Broker maître et autant d'annuaires protégés qu'il existe de serveurs Up ! Object Request Broker esclaves i.e. de noeuds sur la topologie de l'entreprise. Les autres annuaires propres à certains programmes sont privés.

Les modifications apportées au contenu des annuaires protégés sont automatiquement répliquées en temps réel dans l'annuaire public.

L'intérêt d'employer un annuaire est de pouvoir identifier des objets par un nom explicite, ce qui permet de les retrouver lors d'une exécution ultérieure. Cela est d'autant plus important dans une architecture multi-programmes.

Une fois l'annuaire chargé, Up ! Object Request Broker le présente sous forme d'objets du type AnnuaireUpsOrb.

Les annuaires sont automatiquement chargés dès leur premier accès et ils sont automatiquement enregistrés lors de l'arrêt du programme s'ils ont été modifiés.

Voici les répertoires standards d'un annuaire :

Répertoire	Description
/UpsAps	Réservé au fonctionnement d'Up ! Application System.
/UpsAps/UpsMls	Réservé au fonctionnement d'Up ! Mail Service.
/UpsAps/UpsMls/AbonnementElectronique/${NomAbonnement}	Nom de l'abonnement NomAbonnement.
/UpsAps/UpsMls/AbonnementElectronique/${NomAbonnement}/Description	Description de l'abonnement NomAbonnement.
/UpsAps/UpsMls/AbonnementElectronique/${NomAbonnement}/AdresseElectronique	Adresse électronique de l'abonnement NomAbonnement.
/UpsAps/UpsMls/AbonnementElectronique/${NomAbonnement}/ListeAbonnes	Liste des abonnés de l'abonnement NomAbonnement.
/UpsAps/UpsSec/Utilisateur/${NomUtilisateur}	Nom de l'utilisateur NomUtilisateur.
/UpsAps/UpsSec/Utilisateur/${NomUtilisateur}/Description	Description de l'utilisateur NomUtilisateur.
/UpsAps/UpsSec/Utilisateur/${NomUtilisateur}/ListeAdressesElectroniques	Liste des adresses électroniques de l'utilisateur NomUtilisateur.
/UpsAps/UpsSec/Utilisateur/${NomUtilisateur}/ListeAbonnementsElectroniques	Liste des abonnements électroniques de l'utilisateur NomUtilisateur.

Pour connaître les paramètres d'Up ! Object Request Broker, merci de se référer à la fiche Paramètres d'Up ! Object Request Broker.

Pour avoir un exemple complet d'usage d'Up ! Object Request Broker, merci de se référer à la fiche Source d'Up ! Object Request Broker.

Interfaces

IAnnuaire

Types

AnnuaireUpsOrb

Variables

AnnuaireLocal

EstLeServeurMaitre

NomNoeudMaitre NbNoeuds NbSecondesTravaillees NbSecondesTravailleesAuTotal NbServeursPersistantsMax NbTransactions NbTransactionsAuTotal

PourcentageUtilisation

Exceptions

AjoutAnnuaireImpossible AnnuaireInexistant

EcrireEntreeAnnuaireImpossible

FichierAnnuaireInexistant

LireEntreeAnnuaireImpossible

NoeudDejaArrete NoeudDejaDemarre NoeudExisteDeja NoeudInconnu NumeroPersistantImpossible NumeroServeurPersitantExisteDeja

RenommerEntreeAnnuaireImpossible

ServeurExisteDeja SupprimerEntreeAnnuaireImpossible

Procédures et fonctions



Procedure Habilitation Optimiser(PasDEffetDeBord) AjouterModule(NomDuNoeud : Caractere, NomDuServeur : Caractere, NomDuModule : Caractere, VersionDuModule : Entier, RevisionDuModule : Entier, CorrectionDuModule : Entier); 

Procedure Habilitation Optimiser(PasDEffetDeBord) AjouterNoeud(NomDuNoeud : Caractere, AdresseDeLOrbDuNoeud : Caractere);

Procedure Habilitation Optimiser(PasDEffetDeBord) AjouterServeur(NomDuNoeud : Caractere, NomDuServeur : Caractere, AdresseDuServeur : Caractere);

Procedure Habilitation Optimiser(PasDEffetDeBord) ArreterNoeud(NomDuNoeud : Caractere);

Procedure Habilitation ArreterServeursUpsOrb();

Procedure Habilitation ArreterServeursLocaux();

Procedure Habilitation ChargerConfiguration();

Procedure Optimiser(PasDEffetDeBord) ChercherModule(NomDuModule : Caractere, NomDuNoeud : Caractere Sortie, NomDuServeur : Caractere Sortie, AdresseDuServeur : Nul Ou Caractere Entree Sortie);

Procedure Habilitation DemarrerNoeud() ;

Procedure Habilitation EnregistrerConfiguration();

Fonction Habilitation Optimiser(NulAbsorbant, PasDEffetDeBord) LireArborescenceAnnuaireGlobal(Chemin : Nul Ou Caractere) Retourner Nul Ou ListeDe Caractere;

Procedure Habilitation LireConfiguration();

Fonction Habilitation Optimiser(NulAbsorbant, PasDEffetDeBord) LireEntreeAnnuaireGlobal(E : Nul Ou Caractere) Retourner Nul Ou Objet;

Fonction Habilitation ListerAnnuaires(CritereFiltre : Nul Ou Caractere=Nul, CritereTri : Nul Ou Caractere=Nul) Retourner Nul Ou IResultatRequeteDe Nul Ou AnnuaireUpsOrb;

Procedure Habilitation Optimiser(PasDEffetDeBord) SupprimerModule(NomDuNoeud : Caractere, NomDuServeur : Caractere, NomDuModule : Caractere, VersionDuModule : Entier, RevisionDuModule : Entier, CorrectionDuModule : Entier);

Procedure Habilitation Optimiser(PasDEffetDeBord) SupprimerNoeud(NomDuNoeud : Caractere);

Procedure Habilitation Optimiser(PasDEffetDeBord) SupprimerServeur(NomDuNoeud : Caractere, NomDuServeur : Caractere);

Procedure Habilitation Optimiser(PasDEffetDeBord) StatistiquesServeur(NomDuNoeud : Caractere, NomDuServeur : Caractere, NbSecondesTravaillees : Entier, NbSecondesTravailleesAuTotal : Entier, NbSoumissions : Entier, NbSoumissionsAuTotal : Entier, PourcentageUtilisation : Reel);

Adaptateurs

Technologie tierce.	Accès à la classe.	Nom de la classe.
Com.	`fecd0300-8a05-11d0-8e3c-e1043ebbde2b`	`UpsOdb`
Corba.	`IDL:UpsOdb:2.5`	`UpsOdb::UpsOdb`
Java / Ejb.	`upsvtm.jar`	`UpsOdb.UpsOdb`
Pl/Sql.	`-`	`-`
Rfc for Sap.	`-`	`-`
Soap.	`-`	`-`