Manuel des Scripts Automation Engine > Organisation fonctionnelle > Traitement des erreurs et messages > :SET_LAST_ERR

:SET_LAST_ERR

Instruction de script : Définit le numéro et le texte de l'erreur

Syntaxe

:SET_LAST_ERR Number, [Insert]

Syntaxe	Description / format
Nombre	Numéro d'erreur. Format : nombre, variable de script ou fonction de script
Insert	Texte de l'erreur, partie variable du message d'erreur. Format : littéral de script, variable de script ou fonction de script

Remarques

L'instruction de script :SET_LAST_ERR définit le numéro et le texte de l'erreur. Dans ce cas, l'instruction remplace le numéro de l'erreur et/ou la partie variable du dernier message d'erreur. La spécification d'Insert est facultative. Si Insert n'est pas indiqué, la partie variable du message d'erreur est une chaîne vide.

Veillez à indiquer un numéro d'erreur valide. Vous trouverez la liste de tous les messages disponibles, avec leur texte, dans le manuel des messages.

Si le message possède plusieurs parties variables, il faut les séparer par un "|". On trouve également leur ordre dans le manuel des messages.

:SET_LAST_ERR 0 permet de supprimer le numéro et le texte d'erreur.

Vous pouvez récupérer le message d'erreur modifié complet avec GET_MSG_TXT.

Exemple

L'exemple définit le numéro d'erreur "20657" avec les deux parties variables du message.

:SET_LAST_ERR 20657,"MM.DAY|20||OBJECTS"
:SET &ERRINS# = SYS_LAST_ERR_INS()
:SET &ERRNR# = SYS_LAST_ERR_NR()
:SET &MSG# = GET_MSG_TXT(&ERRNR#, &ERRINS#)
:PRINT &MSG#

Extrait du manuel de messages : 20657 : erreur de durée d'exécution dans l'objet '&01' ligne '&02' : Dossier cible '&04' introuvable.

Le résultat de l'instruction de script est :

U0020657 Runtime error in object 'MM.DAY', line '20'. Destination folder 'OBJECTS' not found.

Rubriques connexes :

Elément de script	Description
SYS_LAST_ERR_INS	Fournit la partie variable du message d'erreur pour la dernière erreur survenue.
SYS_LAST_ERR_NR	Renvoie le numéro d'erreur de la dernière erreur survenue.
SYS_LAST_ERR_SYSTXT	Récupère le texte d'erreur du système d'exploitation pour la dernière erreur survenue

Eléments de script - Traitement des erreurs et messages

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