Manuel des Scripts Automation Engine > Organisation fonctionnelle > Elaboration et traitement des Scripts > :GENERATE

:GENERATE

Instruction de script : Contrôle le traitement des lignes de script pendant l'exécution du script.

Syntaxe

:GEN[ERATE]Generation Mode

Syntaxe

Description/format

Mode de génération

Modes de génération pour la reprise :

  • ON_RESTART_ALWAYS
    Les lignes de script sont toujours exécutées, indépendamment du point de reprise.
  • ON_RESTART_CHECK
    Les lignes de script ne sont pas exécutées lorsqu'elles se trouvent avant le point de reprise.
  • ON_RESTART_NEVER
    Les lignes de script ne sont jamais exécutées, indépendamment du point de reprise.

Modes de génération pour les lignes DATA :

  • UPPER_CASE
    Convertit le texte de toutes les lignes DATA en majuscules.
  • LOWER_CASE
    Convertit le texte de toutes les lignes DATA en minuscules.
  • CASE_UNCHANGED
    Rétablit l'état initial de la casse (lettres minuscules et majuscules).

Remarques

Plusieurs expressions peuvent être passées à l'instruction :GENERATE en tant que mode de génération. Le mode de génération contrôle d'une part la manipulation des lignes de script pendant la reprise d'un objet activable. D'autre part, il permet de définir la casse dans les lignes DATA.

Redémarrage d'objets activables

Le mode de génération peut être utilisé lors de la reprise d'objets activables pour définir la manière dont les lignes de script doivent être gérées lors de l'exécution du script.

Si :GENERATE n'est pas utilisée pour reprendre un objet, toutes les lignes de script sont traitées jusqu'à la première instruction :RESTART et aussi les lignes qui se trouvent après le point de reprise indiqué.

Majuscules et minuscules

En général, le texte des lignes DATA est conservé et transféré au système cible tel quel. Les variables de script qui apparaissent dans les lignes DATA constituent une exception. Ces variables sont fournies avec des valeurs (en format modifié) lors de l'activation d'un objet contenant un tel script.

Certains systèmes cibles requierent un certain format pour les lignes DATA. Par exemple, le système d'exploitation BS2000 ne traite les instructions JCL (Job Control Language) que si elles sont en majuscules, de sorte que les scripts d'Automation Engine doivent être formatés en conséquence. L'instruction :GENERATE met à votre disposition différents modes de génération permettant de créer des scripts indépendamment des restrictions de chaque système cible.

Exemples

Le premier exemple comment :GENERATE peut être utilisé pour reprendre un objet, puis les différentes sorties dans le rapport qui résultent des points de reprise sont affichées.

:PRINT "Script start"

:RESTART R1
:PRINT "Point R1"

:GENERATE ON_RESTART_ALWAYS
:PRINT "ON_RESTART_ALWAYS"

:GENERATE ON_RESTART_CHECK
:RESTART R2
:PRINT "Point R2"
:RESTART R3
:PRINT "Point R3"

:GENERATE ON_RESTART_NEVER
:PRINT "Script end"

Reprise à partir de R1 :

2005-01-31 12:17:05 - U0020408 Script start
2005-01-31 12:17:05 - U0020408 Point R1
2005-01-31 12:17:05 - U0020408 ON_RESTART_ALWAYS
2005-01-31 12:17:05 - U0020408 Point R2
2005-01-31 12:17:05 - U0020408 Point R3

Reprise à partir de R2 :

2005-01-31 12:17:23 - U0020408 Script start
2005-01-31 12:17:23 - U0020408 ON_RESTART_ALWAYS
2005-01-31 12:17:23 - U0020408 Point R2
2005-01-31 12:17:23 - U0020408 Point R3

Reprise à partir de R3 :

2005-01-31 12:17:48 - U0020408 Script start
2005-01-31 12:17:48 - U0020408 ON_RESTART_ALWAYS
2005-01-31 12:17:48 - U0020408 Point R3

 

Le second exemple montre la transformation du texte des lignes DATA d'un script en majuscules.

:GEN UPPER_CASE
fs $AE.

 

Rubriques connexes :

Elément de script Description

:RESTART

Définit des points de reprise dans un objet activable.

Eléments de script - Structure et traitement des scripts

Redémarrage d'objets activables

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