Manuel des Scripts Automation Engine > JCL d'AE pour SQL > SQL_ON_ROWCOUNT_ZERO

SQL_ON_ROWCOUNT_ZERO

Définit le code retour à afficher si une instruction SQL ne renvoie aucune correspondance.

Syntaxe

SQL_ON_ROWCOUNT_ZERO RETCODE=...

Elément de syntaxe

Description/format

RETCODE=

Code retour

Valeur par défaut : "1"

Remarques

Ce Script permet d'interrompre le Job avec un code retour défini si une instruction SQL comme SELECT ou UPDATE ne renvoie aucune correspondance. Le paramétrage défini avec SQL_ON_ROWCOUNT_ZERO s'applique à toutes les instructions SQL qui suivent, jusqu'à la fin du Job ou jusqu'à l'instruction SQL_ON_ROWCOUNT_ZERO suivante.

Si vous définissez RETCODE sur "0", le nombre de correspondances des instructions SQL est ignoré et le Job se poursuit.

 L'instruction SQL_ON_ROWCOUNT_ZERO ne peut être utilisée qu'avec SELECT, UPDATE, INSERT et DELETE. Les autres instructions SQL comme CREATE TABLE ne renvoient pas non plus de correspondance en temps normal. Par conséquent, si vous utilisez SQL_ON_ROWCOUNT_ZERO dans le Job, vous devez définir RETCODE sur la valeur "0" devant chaque instruction SQL nommée.

 En cas d'interruption du Job, toutes les instructions SQL postérieures à la dernière validation (COMMIT) effectuée sont annulées.

Exemple

Si l'une des trois instructions SQL ne renvoie aucune correspondance, le Job est interrompu avec le code retour "1".

SQL_ON_ROWCOUNT_ZERO RETCODE=1;
select * from person;
insert into person values (1,'Meier');
update person set adresse = 'Hauptstraße 8'
where name = 'Huber';

 

Rubriques connexes :