:STOP

Utilisez l'instruction de script :STOP pour interrompre le traitement d'un script. Cette instruction de script vous permet d'interrompre le script en envoyant ou non un message d'erreur.

Important ! :STOP interrompt l'activation de l'objet contenant le script. N'utilisez pas :STOP dans la page Post-traitement.

Remarque : Cette instruction de script écrit toutes les transactions ouvertes du script dans la base de données AE. Pour plus d'informations, voir Traitement du script.

Conseil : Pour appliquer des modifications par des scripts dans la page Post-traitement, utilisez l'instruction de script :MODIFY_STATE.

Syntaxe

:STOP[Stop Mode]

Paramètres

• :STOP
  Interrompt le traitement du script

• Stop Mode
  (Optionnel) Détermine l'envoie ou non d'un message d'erreur
  Valeurs autorisées :

  • MSG, Numéro d'erreur, Texte d'erreur
    Interrompt l'activation de l'objet et envoie un message d'erreur
    Important !

    •  N'utilisez que les numéros d'erreurs entre 50 et 59. Cette plage est réservée aux utilisateurs. L'utilisation des autres numéros d'erreur entraîne l'interruption du script, avec un message d'erreur.
    •  Le code retour 4 est utilisé pour le numéro d'erreur 50 et le code retour 8 pour les numéros d'erreur de 51 à 59.
    Remarques :
    • Il est important de spécifier un numéro et un message d'erreur pour des objets lancés via AE CallAPI. Les informations retournées représentent la seule information sur l'exécution du script.
    • Les tâches arrêtées de la sorte sont listées dans les données d'exécution en tant que tâches interrompues.

  • NOMSG, numéro du message[, texte du message]
    Interrompt l'activation de l'objet sans erreur
    Remarques :

    • Le numéro de message est nécessaire pour la syntaxe mais n'est pas évalué.
    • Vous pouvez saisir un texte de message. Ce texte est enregistré dans les données d'exécution et envoyé en tant qu'élément de confirmation lors d'un appel via CallAPI.
    • Ce mode peut être utilisé dans des objets qui ne nécessitent pas d'agent pour être traités. Vous pouvez travailler avec des instructions de script uniquement, pour définir des variables, par exemple.

  • Mode sans arrêt
    Si vous ne spécifiez pas le paramètre du mode d'arrêt, :STOP interrompt le traitement du script et consigne le message d'erreur U0010014 dans le rapport d'activation.
    Remarques :

    • Une restauration de la base de données est alors effectuée. Toutes les transactions non spécifiquement exécutées sont restaurées.
    • Les variables utilisées en début de script peuvent déjà avoir de nouvelles valeurs, alors que les fins de script n'en ont pas reçu.

Exemple

L'exemple suivant renvoie un message d'erreur lié à l'activation correcte ou non d'un job.

:SET &ACTNR# = ACTIVATE_UC_OBJECT(JOBS, MM)
:IF &ACTNR# = "0"
: STOP MSG, 50, "Error in activating the job MM."
:ELSE
: PRINT "The job MM was activated with the activation number &ACTNR#."
:ENDIF

Voir aussi :