ILM

Fonction de script : Contrôle la fonctionnalité ILM (Information Lifecycle Management).

Syntaxe générale

ILM (Action [,Parameter [, Parameter]] )

Installation

[Installation] [Statut] [Démarrage et arrêt] [Désactivation] [Contrôle] [Suppression d'une partition]

Syntaxe

ILM (INSTALLED)

Syntaxe

Description / format

INSTALLED Demande si la base de données AE a été partitionnée avec ILM

Cette fonction de script renvoie les codes retour suivants :

Y : le partitionnement avec ILM a été installé
N : la base de données AE n'a pas été partitionnée.

Exemple

:SET &ILM# = ILM(INSTALLED)

 

Statut

[Installation] [Statut] [Démarrage et arrêt] [Désactivation] [Vérification] [Suppression d'une partition]

Syntaxe

ILM (ACTIVE)

Syntaxe

Description / format

ACTIVE Demande si ILM est actif

Cette fonction de script renvoie les codes retour suivants :

Y : ILM est actif; c'est à dire que de nouvelles partitions ont été créées et des désactivations ont eu lieu (uniquement MS SQL Server).
N : ILM n'est pas actif, aucun changement de partition n'a lieu, ni aucune désactivation (uniquement MS SQL Server).

Exemple

:SET &ILM# = ILM(ACTIVE)

 

Démarrage et arrêt

[Installation] [Statut] [Démarrage Démarrage et arrêt] [Désactivation] [Vérification] [Suppression d'une partition]

Syntaxe

ILM (START)
ILM (STOP)

Syntaxe

Description / format

START Active ILM
STOP Désactive ILM

Si ILM est actif, de nouvelles partitions sont créées et des désactivations ont lieu (uniquement MS SQL Server).

Si ILM n'est pas actif, aucun changement de partition n'a lieu, ni aucune désactivation (uniquement MS SQL Server).

Cette fonction de script renvoie la valeur "0" lorsque le démarrage ou l'arrêt ont été correctement exécutés, ou le numéro de l'erreur qui s'est produite.

Exemple

ILM doit être désactivé.

:SET &ILM# = ILM(STOP)

 

Désactivation

[Installation] [Statut] [Démarrage et arrêt] [Désactivation] [Vérification] [Suppression d'une partition]

Syntaxe

ILM (SWITCHOUT [, check])

Syntaxe

Description / format

SWITCHOUT Désactive la partition la plus ancienne.
Check

Paramètre indiquant si une vérification doit être exécutée avant la désactivation des données

Valeurs autorisées : CHECK (valeur par défaut) et NOCHECK

CHECK : le système vérifie si la partition concernée contient des enregistrements de tâches encore actives avant de commencer sa désactivation. La désactivation n'est pas exécutée si elle contient des tâches actives.
NOCHECK : la désactivation est exécutée sans vérification préalable.

La désactivation des données est une fonctionnalité spécifique à MS SQL Server. Elle n'est pas pertinente pour les bases de données Oracle.

Notez que cette fonction de script déclenche une désactivation mais elle n'attend pas sa terminaison.

Cette fonction de script renvoie la valeur "0" lorsque la désactivation a été correctement exécutée, ou le numéro de l'erreur qui s'est produite.

Notez que le nombre de partitions en ligne spécifié par l'administrateur (variable UC_ILM_SETTINGS, clé ONLINE_PARTITIONS) n'est pas pris en compte.

Exemple

Quatre partitions sont en ligne. En exécutant plusieurs fois la fonction de script, vous pouvez obtenir qu'il ne reste plus que trois, deux ou une seule partition en ligne.

Vous ne pouvez pas désactiver les données de la partition courante. Il doit toujours y avoir au moins une partition en ligne.

Notez que la désactivation des données d'une partition qui contient les enregistrements de données de tâches actives entraîne la perte de données.

Contactez l'équipe d'assistance si vous voulez forcer des désactivations qui impliquent des tâches actives.

Exemple

Une vérification a lieu avant la désactivation, car la valeur par défaut du second paramètre est CHECK.

:SET &ILM# = ILM(SWITCHOUT)

Vérification

[Installation] [Statut] [Démarrage et arrêt] [Désactivation] [Vérification] [Suppression d'une partition]

Syntaxe

ILM (CHECK, Partition number)

Syntaxe

Description / format

CHECK

Vérifie si la partition indiquée inclut des objets actifs.

Partition number Numéro de la partition
Format : littéral de script ou variable de script

Cette fonction de script retourne "0" si la partition indiquée ne contient aucun objet actif.

Exemple

La partition "25" est vérifiée.

:SET &ILM# = ILM(CHECK, "25")

Suppression d'une partition

[Installation] [Statut] [Démarrage et arrêt] [Désactivation] [Vérification] [Suppression d'une partition]

Syntaxe

ILM (DROP, Partition [, Check])

Syntaxe

Description / format

DROP Supprime la partition indiquée
Partition

Nom ou numéro de la partition
Format : littéral de script ou variable de script

Si vous spécifiez le nom d'une table de staging individuelle (MS SQL Server), l'utilisateur de la base de données ILM n'est pas utilisé pour le processus de suppression. A la place, on utilise l'utilisateur de la base de données spécifié dans le fichier INI de Automation Engine dans la section [ODBC]. Notez que cet utilisateur doit disposer des autorisations correspondantes pour cela.

Check

Paramètre qui définit si une vérification doit être effectuée avant de supprimer la partition (uniquement pour les bases de données Oracle)

Valeurs autorisées : CHECK (valeur par défaut) et NOCHECK

CHECK : le système vérifie si la partition concernée contient des enregistrements de tâches encore actives avant de démarrer la suppression de la partition. Aucune suppression n'est exécuté si la partition inclut des tâches actives.
NOCHECK : la partition est supprimée sans vérification préalable.

Le paramètre de vérification Check n'est pas pertinent pour MS SQL Server. Dans MS SQL Server, seules des tables de staging peuvent être supprimées. Ces tables ont déjà été vérifiées lorsqu'elles sont désactivées.

Notez que vous ne pouvez supprimer une partition sans perte de données que si la partition ne contient aucun enregistrement de tâches actives.

Cette fonction de script renvoie "0" si la partition spécifiée a été supprimée avec succès.

Exemple

La partition "25" est supprimée.

:SET &ILM# = ILM(DROP, "25")

Voir aussi :