Paramètres de Up ! Mail Service

Up ! Mail Service est le service réseau multi plates-formes de messagerie. Ce service est une extension d'Up ! Network.

Up ! Mail Service peut être invoqué soit :

Up ! Mail Service peut être aussi invoqué ponctuellement pour réaliser des opérations sur l'annuaire électronique. En ce cas, le mode générique n'est pas activé.

Quel que soit son mode d'invocation, Up ! Mail Service possède les mêmes paramètres cités dans la section suivante. La commande est, selon les plates-formes, upsmls, upsmls.exe ou upsmls.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}

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 ' .

Les formats des Uniform Resource Identifier pour un accès en Internet Message Access Protocol, Post Office Protocol ou Simple Mail Transfer Protocol sont les suivants :

imap://${NomServeur}:${Port}
pop://${NomServeur}:${Port}
smtp://${NomServeur}:${Port}

Avec :

Paramètres d'exécution

Mode commande

Action

Action permet de spécifier l'action en ligne de commande à exécuter. Il n'y a pas de valeur par défaut et cette option est obligatoire pour réaliser une opération sur un annuaire électronique.

Voici la liste des valeurs possibles :

ActionValeur de l'option
Ajout d'une adresse électronique associée à la boîte aux lettres électronique.AjouterAdresseElectronique
Compactage de la boîte aux lettres.CompacterBoiteAuxLettresElectronique
Création de la boîte aux lettres électronique.CreerBoiteAuxLettresElectronique
Exportation de l'annuaire électronique.ExporterAnnuaireElectronique
Importation de l'annuaire électronique.ImporterAnnuaireElectronique
Modification d'une adresse électronique associée à la boîte aux lettres électronique.ModifierAdresseElectronique
Réparation de la boîte aux lettres électronique.ReparerBoiteAuxLettresElectronique
Suppression d'une adresse électronique associée à la boîte aux lettres électronique.SupprimerAdresseElectronique
Suppression de la boîte aux lettres électronique.SupprimerBoiteAuxLettresElectronique
Vérification de la boîte aux lettres électronique.VerifierBoiteAuxLettresElectronique

Action=CreerBoiteAuxLettresElectronique

AdresseElectronique

AdresseElectronique permet de spécifier l'adresse électronique à ajouter ou à supprimer pour la boîte aux lettres électronique.

Ce paramètre est utilisé pour les actions AjouterAdresseElectronique et SupprimerAdresseElectronique.

AdresseElectronique=mon-adresse@mon-domaine.com

AncienneAdresseElectronique

AncienneAdresseElectronique permet de spécifier l'ancienne adresse électronique à modifier pour la boîte aux lettres électronique.

Ce paramètre est utilisé pour l'action ModifierAdresseElectronique.

AncienneAdresseElectronique=mon-ancienne-adresse@mon-domaine.com

Detail

Detail permet d'afficher le détail des opérations effectuées par Up ! Mail Service en mode commande. Par défaut, le détail n'est pas affiché.

Detail=Oui

Entete

Entete permet d'afficher l'en-tête précisant la date en mode commande. Par défaut, l'en-tête n'est pas affiché.

Entete=Oui

NomUtilisateur

NomUtilisateur permet de spécifier le nom de l'utilisateur dont il faut créer, modifier ou supprimer la boîte aux lettres électronique.

Ce paramètre est obligatoire pour les actions AjouterAdresseElectronique, CompacterBoiteAuxLettresElectronique, CreerBoiteAuxLettresElectronique, ModifierBoiteAuxLettresElectronique, ReparerBoiteAuxLettresElectronique, SupprimerAdresseElectronique, SupprimerBoiteAuxLettresElectronique et VerifierBoiteAuxLettresElectronique.

NomUtilisateur=mon-utilisateur

NouvelleAdresseElectronique

NouvelleAdresseElectronique permet de spécifier la nouvelle adresse électronique issue de la modification pour la boîte aux lettres électronique.

Ce paramètre est utilisé pour l'action ModifierAdresseElectronique.

NouvelleAdresseElectronique=ma-nouvelle-adresse@mon-domaine.com

MotDePasse

MotDePasse permet de spécifier le mot de passe associé à l'utilisateur dont il faut créer, modifier ou supprimer la boîte aux lettres électronique.

Ce paramètre est utilisé pour les actions AjouterAdresseElectronique, CompacterBoiteAuxLettresElectronique, CreerBoiteAuxLettresElectronique, ModifierBoiteAuxLettresElectronique, ReparerBoiteAuxLettresElectronique, SupprimerAdresseElectronique, SupprimerBoiteAuxLettresElectronique et VerifierBoiteAuxLettresElectronique.

MotDePasse=mon-mot-de-passe

Source

Source permet de spécifier le fichier source en Up ! 5GL pour Up ! Mail Service comportant la liste des commandes à exécuter en batch.

Ce paramètre est obligatoire pour les actions ExporterAnnuaireElectronique et ImporterAnnuaireElectronique.

Source=${UPS_HOME}/upsnet/upsnet/${UPS_LANGUAGE}/monannuaire.upl

Mode générique

Archiver

Archiver permet de spécifier que les boîtes aux lettres d'Up ! Mail Service sont des archives portant le nom du propriétaire et localisées dans RepertoireMessagerie et non des sous-répertoires.

Par défaut, il s'agit d'archives.

Archiver=Non

AutoriserAnonymous

AutoriserAnonymous a pour valeur vraie si la connexion par anonymous est autorisée pour Imap. La valeur par défaut est Non.

Le mot de passe est alors l'adresse électronique du client.

AutoriserAnonymous=Oui

AutoriserRoutage

AutoriserRoutage a pour valeur vraie si le routage est autorisé pour Smtp. La valeur par défaut est Non.

AutoriserRoutage=Oui

FormatAnnuaireElectronique

FormatAnnuaireElectronique permet de spécifier le format du fichier annuaire électronique demandé.

Voici la liste des valeurs possibles :

FormatValeur 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.

FormatAnnuaireElectronique=FormatRessourceUps5GL

LatenceServeur

LatenceServeur est le temps à partir duquel une tâche serveur inactive est détruite. La valeur par défaut est 60 secondes.

LatenceServeur=30

NbClients

NbClients permet de spécifier le nombre de sessions clientes que chaque serveur est sait gérer simultanément. Au delà, la session au serveur est refusée par Up ! Mail Service. Les requêtes des clients sont gérées à tour de rôle selon le principe du tourniquet. Par défaut, la valeur est 8.

NbClients=100

NbServeurs

NbServeurs permet de spécifier le nombre de tâches serveurs maximal qu'Up ! Mail Service peut lancer pour traiter les demandes en paralèlle. Les demandes d'au plus NbClients*NbServeurs clients seront traitées simultanément, tant qu'il existe une place dans une file d'attente d'un serveur.

Les tâches serveurs sont ajoutées dynamiquement en fonction de la charge du serveur. Quand elles ne sont plus nécessaires, elles sont supprimées. Quand un nouveau client se connecte, le serveur élu est celui qui est le moins chargé.

Par défaut, il y a un unique serveur si le programme en technologie Up ! Virtual Technical Machine est de type serveur i.e. il a été généré avec l'option Lancement=Serveur et zéro sinon.

NbServeurs=4

Port

Port permet de spécifier le début de la plage de ports de communication réservés à l'applicatif. Il y a autant de ports de communication réservés qu'il y a de sessions déclarées par le paramètre NbSessions. Par défaut, la valeur est 2048.

Port=2000

RepertoireMessagerie

RepertoireMessagerie permet de spécifier dans lequel sont conservés les boîtes aux lettres d'Up ! Mail Service. Ce paramètre est obligatoire.

La valeur par défaut est ${UPS_HOME}/upsnet/resources.

RepertoireMessagerie=/users/mail

SecretPop

SecretPop permet de spécifier le secret partagé par les clients et le serveur Pop pour s'identifier auprès d'Up ! Mail Service au lieu d'utiliser un couple (nom d'utilisateur, mot de passe) classique.

Par défaut, il n'y a pas de secret Pop et l'identification s'effectue par le couple (nom d'utilisateur, mot de passe) correspondant à un compte d'Up ! Application System.

SecretPop=MonSecret

ServiceDefaut

ServiceDefaut permet de spécifier le comportement par défaut d'Up ! Mail Service quand aucun module tiers ne veut traiter un ordre Imap, Pop ou Smtp via une méthode de rappel.

Par défaut, le serveur offre les services de messagerie standard au regard des valeurs des paramètres RepertoireMessagerie.

ServiceDefaut=Non

SupprimerMessagesServeur

SupprimerMessagesServeur a pour valeur vraie s'il faut supprimer les messages sur le serveur quand il ont été lu par le client en Pop. La valeur par défaut est Non.

SupprimerMessagesServeur=Oui

TracerCommunication

TracerCommunication permet de tracer les communications effectuée par le programme. La valeur par défaut est Non.

Cette trace est inscrite dans le fichier ${UPS_HOME}/log/${UPS_LANGUAGE}/${UPS_APPLICATION}-upsmls-${UPS_SESSION}.log en mode mono-utilisateur ou dans le fichier ${UPS_HOME}/log/${UPS_USER}/${UPS_APPLICATION}-upsmls-${UPS_SESSION}.log en mode multi-utilisateur.

TracerCommunication=Oui

URIServeurImap

URIServeurImap spécifie l'Uniform Resource Identifier d'écoute du serveur Imap.

Le service d'écoute Imap est uniquement lancé si URIServeurImap est renseigné.

URIServeurImap=imap://soleil:143

URIServeurPop

URIServeurPop spécifie l'Uniform Resource Identifier d'écoute du serveur Pop.

Le service d'écoute Pop est uniquement lancé si URIServeurPop est renseigné.

URIServeurPop=pop://soleil:110

URIServeurSmtp

URIServeurSmtp spécifie l'Uniform Resource Identifier d'écoute du serveur Smtp.

Le service d'écoute Smtp est uniquement lancé si URIServeurSmtp est renseigné.

URIServeurSmtp=smtp://soleil:25

Optimisation du cycle de vie des objets

TypeConservation possibleTaille par défaut
du segment
AbonnementElectroniqueOui.4.
BoiteAuxLettresElectroniqueOui.2.
CourrierElectroniqueOui.8.
ClientMessagerieOui.8.
IServeurMessagerieOui.2.
ServeurMessagerieImapOui.2.
ServeurMessageriePopOui.2.

ConserverObjets, quand le paramètre est possible, spécifie qu'au plus TailleSegment objets du type sont conservés pré-construits en anté-mémoire au lieu d'être détruits.

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.

ConserverObjetsAbonnementElectronique=Oui
ConserverObjetsBoiteAuxLettresElectronique=Non
ConserverObjetsCourrierElectronique=Oui
ConserverObjetsClientMessagerie=Non
ConserverObjetsIServeurMessagerie=Oui
ConserverObjetsServeurMessagerieImap=Non
ConserverObjetsServeurMessageriePop=Oui

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.

TailleSegmentAbonnementElectronique=8
TailleSegmentBoiteAuxLettresElectronique=4
TailleSegmentCourrierElectronique=16
TailleSegmentClientMessagerie=16
TailleSegmentIServeurMessagerie=4
TailleSegmentServeurMessagerieImap=4
TailleSegmentServeurMessageriePop=4

Exemple de contenu d'un annuaire électronique

Profil de sécurité

Source Securite "Exemple de l'emploi des annuaires" Version 4.0.0;

Securite MaSecurite
/*****************/
Debut
AjouterUtilisateur("scott", "Description de scott", Nul, Nul, Nul);
AjouterUtilisateur("allen", "Description de allen", Nul, Nul, Nul);
AjouterUtilisateur("smith", "Description de smith", Nul, Nul, Nul);
AjouterUtilisateur("clark", "Description de clark", Nul, Nul, Nul);
AjouterUtilisateur("king", "Description de king", Nul, Nul, Nul);
Fin Securite

Contenu de l'annuaire

Source AnnuaireElectronique "Exemple de l'emploi des annuaires" Version 4.0.0;

AnnuaireElectronique MonAnnuaireElectronique
/******************************************/
Debut
AjouterAdresseElectronique("allen", "allen@mon-domaine.com");
AjouterAdresseElectronique("clark", "clark@mon-domaine.com");
AjouterAdresseElectronique("king", "king@mon-domaine.com");
AjouterAdresseElectronique("scott", "scott@mon-domaine.com");
AjouterAdresseElectronique("scott", "contact@mon-domaine.com");
AjouterAdresseElectronique("smith", "smith@mon-domaine.com");

AjouterAbonnementElectronique("info", "info@mon-domaine.com", "Informations générales");
AjouterAbonne("info", "allen@mon-domaine.com");
AjouterAbonne("info", "clark@mon-domaine.com");
AjouterAbonne("info", "king@mon-domaine.com");
AjouterAbonne("info", "scott@mon-domaine.com");
Fin AnnuaireElectronique

Exemple de configuration d'Up ! Mail Service

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

[UpsMls]
AutoriserAnonymous=Oui
AutoriserRoutage=Oui
ConserverObjetsAbonnementElectronique=Oui
ConserverObjetsBoiteAuxLettresElectronique=Non
ConserverObjetsCourrierElectronique=Oui
ConserverObjetsClientMessagerie=Non
ConserverObjetsIServeurMessagerie=Oui
ConserverObjetsServeurMessagerieImap=Non
ConserverObjetsServeurMessageriePop=Oui
FormatAnnuaireElectronique=FormatRessourceUps5GL
NbClients=4
NbServeurs=2
LatenceServeur=30
Port=2048
RepertoireMessagerie=/users/mail
SupprimerMessagesServeur=Oui
SecretPop=MonSecret
TailleSegmentAbonnementElectronique=8
TailleSegmentBoiteAuxLettresElectronique=4
TailleSegmentCourrierElectronique=16
TailleSegmentClientMessagerie=16
TailleSegmentIServeurMessagerie=4
TailleSegmentServeurMessagerieImap=4
TailleSegmentServeurMessageriePop=4
TracerCommunication=Oui
URIServeurImap=imap://soleil:143
URIServeurPop=pop://soleil:110
URIServeurSmtp=smtp://soleil:25