Automation Engine Script-Leitfaden > AE JCL für SQL > SQL_ON_ROWCOUNT_ZERO

SQL_ON_ROWCOUNT_ZERO

Setzt den Rückgabewert, wenn eine SQL-Anweisung keine Treffer liefert.

Syntax

SQL_ON_ROWCOUNT_ZERO RETCODE=...

Syntax

Beschreibung/Format

RETCODE=

Rückgabewert

Standardwert: 1

Kommentare

Mit diesem Script-Sprachmittel können Sie den Job mit einem definierten Rückgabewert abbrechen, wenn eine SQL-Anweisung wie z.B: SELECT oder UPDATE keine Treffer liefert. Die Einstellung, die Sie mit SQL_ON_ROWCOUNT_ZERO setzen, gilt für alle folgenden SQL-Anweisungen bis zum Job-Ende oder bis zur nächsten SQL_ON_ROWCOUNT_ZERO-Anweisung.

Setzen sie den RETCODE auf "0", so wird die Trefferanzahl bei SQL-Anweisungen ignoriert und der Job fortgesetzt.

SQL_ON_ROWCOUNT_ZERO kann nur für SELECT, UPDATE, INSERT und DELETE eingesetzt werden. Andere SQL-Anweisungen wie z.B: CREATE TABLE liefern auch im Normalfall keine Treffer. Wenn Sie SQL_ON_ROWCOUNT_ZERO im Job verwenden, müssen Sie daher jeweils vor den genannten SQL-Anweisungen daher immer RETCODE auf den Wert "0" setzen.

Beim Abbruch des Jobs werden alle SQL-Anweisungen bis zum letzten COMMIT rückgängig gemacht.

Beispiele

Liefert eine der drei SQL-Anweisungen "0" Treffer zurück, so wird der Job mit dem Rückgabewert "1" abgebrochen.

SQL_ON_ROWCOUNT_ZERO RETCODE=1;
select * from person;
insert into person values (1,'Smith');
update person set address = '403 E. Main Street'
where name = 'Spencer';

 

Siehe auch:

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH