Manuel des Scripts Automation Engine > Organisation fonctionnelle > Activation d'objets > FORECAST_OBJECT

FORECAST_OBJECT

Fonction de script : Création d'une simulation pour l'objet indiqué.

Syntaxe

FORECAST_OBJECT(Object Name, Title, Date, Start Time, [Registrations], [Group_ERT])

Syntaxe

Description / format

Nom d'objet

Nom de l'objet.
Format : littéral de script ou variable de script

Titre

Nom de la simulation
Format : littéral de script ou variable de script

Format de date

Indication d'un format de date
Valeur par défaut : ''AAMMJJ" et ''AAAAMMJJ"

: ou ;

Séparateur entre le format de date et la date.

Date

Date de début logique au format "AAMMJJ" ou "AAAAMMJJ"

Format : littéral de script ou variable de script

Il est possible d'indiquer la date dans un autre Format de date. Saisissez ainsi en premier le format de date souhaité suivi d'un séparateur (: ou ;) puis la date. L'indication du format de date est facultative.

Heure de début

Heure de début de la tâche au format "HHMMSS".

Format : littéral de script ou variable de script 

Il est possible d'indiquer l'heure dans un autre Format d'heure. Saisissez ainsi en premier le format d'heure souhaité suivi d'un séparateur (;) puis l'heure. L'indication du format d'heure est facultative.

Entrées

Paramètre indiquant si les entrées (des groupes) doivent être prises en compte.
Format : littéral de script ou variable de script

Valeurs autorisées : "Y", "N" (valeur par défaut)

ERT_groupes

Durée moyenne estimée (ERT) des groupes. Cette valeur est utilisée si les entrées sont définies sur "N".

Valeurs autorisées :
"0" - L'ERT du groupe est utilisée. (valeur par défaut)
De "1" à "7199" - Valeur fixe en secondes.


Code retour

"0" - La simulation a pu être créée avec succès.

Commentaires

Il est possible de créer une simulation de la durée d'exécution pour chaque objet activable. Vous pouvez la créer manuellement dans l'interface utilisateur en utilisant la commande appropriée du menu contextuel de l'explorateur. Après indication de certains critères, le système crée une simulation pour l'objet. Vous pouvez aussi utiliser la fonction de script correspondante.

Comme dans la saisie manuelle, vous devez indiquer le nom de la simulation (en majuscules, sans espace), ainsi que les date et heure de début. Pour ces dernières, servez-vous de la possibilité qui vous est offerte de définir un format de votre choix. Si nécessaire, vous pouvez définir les paramètres Entrées et ERT_groupes pour les tâches appartenants à un groupe. Attention : le titre de la simulation doit être unique.

Le code retour de cette fonction est un numéro à 16 chiffres commençant par des zéros. La valeur "0000000000000000" est renvoyée après la réussite de la création de la simulation.

Afin de créer une simulation pour des tâches courantes, utilisez le script FORECAST_TASK.

Cette instruction de script écrit toutes les transactions ouvertes du script dans la base de données AE.

Exemples

La ligne suivante crée une simulation pour un transfert de fichier, avec indication des formats de date et d'heure.

:SET &RET# = FORECAST_OBJECT("C70.WINDOWS","FORECAST_FT_C70.WINDOWS","MM/DD/YY:11/03/03","HH:MM;12:30")

Le second exemple crée la simulation d'un Job exécuté au sein d'un groupe. Vous ne devez pas utiliser l'ERT de ce Job, mais une valeur fixe de 60 secondes.

:SET &RET# = FORECAST_OBJECT("T91.REM.03","FORECAST_T91.REM.03","MM/DD/YY:11.07/03","200000","Y",60)

 

Rubriques connexes :

Elément de script Description

AUTOFORECAST

Calcule les données de simulation pour des activités futures.

FORECAST_TASK

Crée une simulation pour la tâche indiquée.

Eléments de script - Activation d'objets

Simulation
Détermination de la durée d'exécution

Généralités sur les scripts
Eléments de script - Liste alphabétique

Eléments de script - Répartition fonctionnelle