Manuel des Scripts Automation Engine > Organisation fonctionnelle > Statuts et utilisation du système > ILM

ILM

Fonction de script : Contrôle la fonctionnalité ILM.

Installation

Syntaxe

ILM (INSTALLED)

Syntaxe

Description / format

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

Remarques

Cette fonction de script renvoie les codes retour suivants :

"Y" - Le partitionnement a été installé avec ILM
"N" - La base de données AE n'a pas été partitionnée

Exemple

:SET &ILM# = ILM(INSTALLED)

 


Statut

Syntaxe

ILM (ACTIVE)

Syntaxe

Description / format

ACTIVE Demande si ILM est actif

Remarques

Cette fonction de script renvoie les codes retour suivants :

"Y" - ILM est actif. Autrement dit, de nouvelles partitions ont été créées et des désactivations ont eu lieu (ne concerne que le Serveur MS SQL Server).
"N" - ILM n'est pas actif, aucun changement de partition n'a lieu, ni aucune désactivation (cette dernière ne concerne que le Serveur MS SQL Server).

Exemple

:SET &ILM# = ILM(ACTIVE)

 


Démarrage et arrêt

Syntaxe

ILM (START)
ILM (STOP)

Syntaxe

Description / format

START Active ILM
STOP Désactive ILM

Remarques

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

Si ILM n'est pas actif, aucun changement de partition n'a lieu, ni aucune désactivation (cette dernière ne concerne que le Serveur 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 est désactivé.

:SET &ILM# = ILM(STOP)

 


Désactivation

Syntaxe

ILM (SWITCHOUT [, vérification])

Syntaxe

Description / format

SWITCHOUT Désactive la partition la plus ancienne.
Vérification

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

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. Si tel est le cas, la désactivation n'est pas exécutée.
"NOCHECK" - La désactivation est exécutée sans vérification préalable.

Remarques

Les désactivations appartiennent au Serveur MS SQL Server. L'exécution de cette fonction n'est donc 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.

Attention : le nombre de partitions en ligne que l'administrateur définit dans la Variable UC_ILM_SETTINGS avec la clé ONLINE_PARTITIONS n'est pas pris en compte.

Par exemple :

Il existe 4 partitions en ligne. En exécutant plusieurs fois la fonction de script, vous pouvez obtenir qu'il ne reste plus que 3, 2 ou 1 partition en ligne.

La désactivation ne peut pas être effectuée pour la partition actuelle. Il doit toujours y avoir au moins une partition en ligne.

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

Contactez le support Automic si vous voulez forcer une désactivation qui implique 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

ILM (CHECK, Partition number)

Syntaxe

Description / format

CHECK

Vérifie si des objets actifs sont disponibles dans la partition indiquée.

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

Remarques

La fonction de script indique "0" si aucun objet actif n'est disponible dans la partition indiquée.

Exemple

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

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

 


Suppression d'une partition

Syntaxe

ILM (DROP, Partition [, Vérification])

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 

Lorsque vous indiquez le nom d'une table d'importation 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, l'utilisateur de la base de données utilisé est celui que vous avez défini dans le fichier INI de Automation Engine dans la section [ODBC]. Ce dernier doit disposer des droits requis !

Vérification

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

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

"CHECK" : le système vérifie avant la suppression si la partition concernée contient des enregistrements de tâches encore actives. Si tel est le cas, le processus de suppression n'est pas exécuté.
"NOCHECK" - Le processus de suppression est exécuté sans vérification préalable.

Remarques

Le paramètre Vérification n'est pas pertinent pour MS SQL Server, car seules des tables de Staging peuvent ici être supprimées. La vérification de ces tables a déjà eu lieu lors de la désactivation.

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

La fonction de script indique "0" si la partition indiquée a pu être supprimée avec succès.

Exemple

La partition "25" est supprimée.

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

 

Rubriques connexes :