Paramètres d'Up ! Archive

Up ! Archive est l'outil permettant d'archiver des fichiers, des répertoires et des autres ressources telles des courriers électroniques dans un fichier binaire via exploité un système de fichiers indépendant de la plate-forme d'exploitation.

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

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 ! Archive, merci de se référer à la fiche Source d'Up ! Archive.

Paramètres d'exécution

Up ! Archive é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.

Action

Action permet de spécifier l'action que l'automate d'archivage doit exécuter. Il n'y a pas de valeur par défaut et cette option est obligatoire.

Voici la liste des valeurs possibles :

Action	Valeur de l'option
Création d'un nouvelle archive.	`Archiver`
Compacte une archive par défragmentation et tronquage.	`Compacter`
Désarchive le contenu d'une archive.	`Desarchiver`
Liste le contenu d'une archive.	`Lister`
Mise à jour d'une archive existante.	`MettreAJour`
Répare la structure d'une archive.	`Reparer`
Vérifie l'intégrité de la structure d'une archive.	`Verifier`

Une archive porte l'extension upa.

Action=Archiver

Compression

Compression précise le mode de compression utilisé pour une nouvelle archive.

Voici la liste des valeurs possibles :

Mode de compression	Valeur de l'option
Pas de compression.	`ModeCompressionAucun`
Mode Huffman.	`ModeCompressionHuffman`
Mode Lw.	`ModeCompressionLzw`
Mode Rle.	`ModeCompressionRle`

Ce paramètre n'est utilisé qu'avec l'action Archiver.

Compression=ModeCompressionLzw

Detail

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

Detail=Oui

Entete

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

Entete=Oui

FiltreArchive

FiltreArchive permet de spécifier :

Actions Archiver< et MettreAJour.
Le filtre sur le nom des fichiers à archiver.
Action Desarchiver.
Le filtre sur le nom des fichiers à désarchiver.

Le filtre comporte un ou plusieurs jokers dont la sémantique est identique à l'instruction Comme.

FiltreArchive=*.upl|*.upi

MotDePasse

MotDePasse permet de spécifier le mot de passe protégeant l'archive contre la lecture ou l'écriture. Par défaut, il n'y a pas de mot de passe.

MotDePasse=tiger

NomArchive

NomArchive permet de spécifier le fichier contenant l'archive. Ce paramètre est obligatoire.

NomArchive=${UPS_HOME}/demo/tmp/${UPS_USER}/monarchive.uar

ReparerAutomatiquement

ReparerAutomatiquement permet de réparer automatiquement une archive endommagée avant son usage. Ceci est le comportement par défaut.

ReparerAutomatiquement=Non

RepertoireArchive

RepertoireArchive permet de spécifier :

Actions Archiver< et MettreAJour.
La racine du répertoire contenant les répertoires et les fichiers à archiver.
Action Desarchiver.
La racine du répertoire recevant les répertoires et les fichiers à désarchiver.

L'archivage ou le désarchivage est récursif i.e. tous les fichiers correspondant au filtre sont archivés ou désarchivés.

RepertoireArchive=/tmp/archive

TracerArchive

TracerArchive permet de tracer chaque opérations sur une archive. Par défaut, il n'y a pas de trace.

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

Cette trace permet de s'assurer que les opérations sur une archive sont correctes.

TracerArchive=Oui

Optimisation du cycle de vie des objets

Type	Conservation possible	Taille par défaut du segment
ArchiveUpsArc	Oui.	2.
IArchive	Oui.	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.

ConserverObjetsArchiveUpsArc=Oui ConserverObjetsIArchive=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.

TailleSegmentArchiveUpsArc=4 TailleSegmentIArchive=4

Exemple de configuration d'Up ! Archive


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

; Fichier    : upsaps.ini                                             

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

; Module      : Up ! Application System.                              

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

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

;                          Observations

;                                                                      

;                                                                      

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



[UpsArc]

Action=Archiver

Compression=Oui

ConserverObjetsArchiveUpsArc=Oui

ConserverObjetsIArchive=Non

Detail=Oui

Entete=Oui

FiltreArchive=*.upl|*.upi

MotDePasse=tiger

NomArchive=${UPS_HOME}/demo/tmp/${UPS_USER}/monarchive.uar

ReparerAutomatiquement=Non

RepertoireArchive=/tmp/archive

TailleSegmentArchiveUpsArc=4

TailleSegmentIArchive=4

TracerArchive=Oui