Paramètres de Up ! Named Pipes

Tous les programmes en technologie Up ! Virtual Technical Machine possèdent les paramètres énumérés ci-après. 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 variables environnement.
Le fichier d'initialisation.
${UPS_HOME}/ini/${UPS_LANGUAGE}/upsaps.ini en mode mono-utilisateur ou ${UPS_HOME}/ini/${UPS_USER}/upsaps.ini en mode multi-utilisateur. Si le programme comporte un profil d'exécution particulier, les paramètres sont lus dans ce profil au lieu de upsaps.ini.
La section est UpsNap.
Le fichier de paramètres.
S'il existe.
La ligne de commande.
Il s'agit soit de :
- La ligne de commande stricto sensu.
- La valeur de la variable environnement QUERY_STRING.
  En ce cas, le programme s'exécute automatiquement et obligatoirement en mode batch en respectant la norme Common Gateway Interface (CGI).
Les paramètres peuvent être préfixés par UpsNap.

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

Paramètres d'exécution

Le format d'une Uniform Resource Identifier pour un accès en Named Pipes est le suivant :

UpsNap://local:${Port}/${NomTuyau}

Avec :

NomTuyau représente le nom du tuyau de communication.
Port représente le numéro du port.
Ce numéro est utilisé par Up ! Named Pipes pour distinguer les sessions qui identifient de façon unique les tâches.

Port

Port permet de spécifier le début de la plage de ports de communication réservés à l'applicatif. Il y a au plus autant de ports de communication réservés qu'il y a de sessions déclarées par le paramètre UpsOms.NbSessions et d'entrepôts protégés ou publics.

Par défaut, la valeur est 0.

Port=2000

Cette plage de ports est uniquement utile si le programme fonctionne :

En tant que client d'Up ! Object Management System.
En mode multi-processus i.e. s'il comporte des entrepôts protégés ou publics.

URIServeur

Pour un programme serveur d'Up ! Object Management System, URIServeur permet de spécifier l'URI de communication avec celui-ci. La valeur par défaut du port est 0.

URIServeur=UpsNap://local/mon-tuyau

Optimisation du cycle de vie des objets

Type	Conservation possible	Taille par défaut du segment
CanalTuyauNomme	Oui.	4.

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.

ConserverObjetsCanalTuyauNomme=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.

TailleSegmentCanalTuyauNomme=8

Exemple de configuration d'Up ! Named Pipes


; ------------------------------------------------------------------- 

; Fichier    : upsaps.ini                                             

; Objet      : Initialisation d'Up ! Virtual Technical Machine.        
   
;                                                                     

; Module      : Up ! Application System.                              

; Auteur-Date : DUVAL Jean-Pierre - Novembre 2003.                    

; ------------------------------------------------------------------- 

;                          Observations

;                                                                      

;                                                                      

; ------------------------------------------------------------------- 



[UpsNap]

ConserverObjetsCanalTuyauNomme=Oui

Port=2000

TailleSegmentCanalTuyauNomme=8

URIServeur=UpsNap://local/mon-tuyau