Der Job führt ein SQL*Plus Skript aus. Der Job startet den SQL*Plus Client in einem eigenen Prozeß. Dabei behält der Job die Kontrolle über den Programmablauf.

Bei der Verwendung des SQL*Plus Clients ist es möglich, zum einen eine dedizierte Fehlerauswertung zu erhalten und zum anderen die Folgesteuerung in einer Job-Kette zu erleichtern. Ebenso nützlich ist es, daß direkt in der Ausgabe des Scripts enthaltene Informationen in Parameter zu transferieren.

Das Skript kann in einer separaten Datei gespeichert sein. Oder es kann als Wert des Parameters sqlplus_script_file angegeben werden.

Bevor der SQL*Plus Client zur Ausführung des Skriptes gestartet wird, wird das Script durch den Job modifiziert. Zunächst wird für jeden Parameter eine "DEFINE" Direktive erzeugt. Diese Direktiven werden in eine temporäre Datei geschrieben. Danach werden die evtl. angegebenen Code-Fragmente (siehe include_files ) als nächsten Block in die temporäre Datei kopiert. Anschliessend werden im Script alle direkt angegebenen Namen der JobScheduler Parameter durch ihren aktuellen Wert substitutiert. Das Skript wird als letzer Teil in die temporäre Datei geschrieben.

Mit der temporären Datei als Eingabedatei wird der Client gestartet.

Parameter des Jobs, also Job- oder Auftrags-Parameter, können im Script auf zwei Arten verwendet werden. Zum einen sind alle Parameter über Ihren Namen, mit einem vorangestelltem "&", im Script anwendbar. Sie werden als SQL*Plus Variable vom Job definiert. Der Job erzeugt für jeden Parameter eine "DEFINE"-Direktive.

Zum anderen können die Namen der JobScheduler Parameter direkt im Skript verwendet werden. Diese Namen werden dann durch den aktuellen Wert des Parameters ersetzt.

Der Inhalt von STDOUT als auch STDERR werden als Werte der entsprechenden Auftrags-Parameter vom Job in den Auftrag übertragen. Damit kann jeder Folge-Schritt in einer Job-Kette auf diese Information zugreifen.

Der Job ergänzt den Auftrag um entsprechende Parameter. Zum einen sind dies statische Parameter, wie sie im Template in dem Abschnitt "return Parameter" beschrieben sind. Zum anderen sind dies dynamische Parameter. Der Job parsiert die Ausgaben des Skripts und extrahiert daraus, unter Verwendung eines regulären Ausdrucks, sowohl die Namen als auch die Werte dieser Parameter. Der reguläre Ausdruck wird mit dem Parameter variable_parser_reg_exp definiert.

Diese Parameter sind von allen Jobs in allen Job-Schritten lesbar. Der Wert der Parameter kann auch von anderen Jobs in später auszuführenden Job-Schritten verändert werden.

Der Job kann Fehler erkennen, die vom SQL*Plus Client gemeldet werden. Diese haben eine Nummer, die mit der Zeichenfolge "SP2-" beginnt.

Ausserdem kann der Job Fehler erkennen, die der DB-Server bei oder nach der Ausführung des Skriptes meldet. Diese beginnen mit der Zeichenfolge "ORA-" und enthalten dann ebenfalls eine Nummer.

Tritt entweder ein SP2- oder ein ORA-Fehler auf, so wird der Job fehlerhaft beendet. Der Return-Code 98 wird gesetzt.

Zusätzlich ist der Fehlertext als Wert des Parameters sql_error in den Auftragsparametern gespeichert.

Es gibt über die Parameter ignore_sp2_messages und ignore_ora_messages die Möglichkeit, alle oder einzelne Fehler zu ignorieren. Sie sind im STDOUT enthalten, auch wenn sie ignoriert werden.

WHENEVER SQLERROR EXIT SQL.SQLCODE
WHENEVER OSERROR EXIT FAILURE

column end_date new_value BCY_DATE
column period new_value PN_YEAR_PERIOD
column period_prev new_value PN_YEAR_PERIOD_PREV

select '0' as end_date from dual;
prompt SET end_date IS &BCY_DATE;
/
select '0' as period from dual;
prompt SET period IS &PN_YEAR_PERIOD;
/
select '0' as period_prev from dual;
prompt SET period_prev IS &PN_YEAR_PERIOD_PREV;
/
prompt SET end_date IS 1;
exit;

• Sprache: java
• Name der Java-Klasse: sos.scheduler.db.SOSSQLPlusJobJSAdapterClass
• → Ressource: com.sos.scheduler-*.jar

The job executes a SQL*Plus script. The job runs the SQL*Plus client in a separate process. It keeps the job in control of the program flow.

The script can be saved to a separate file. Or it can be specified as the value of the parameter sqlplus_script_file .

Before the SQL*Plus client is launched for execution of the script, the script is modified by the job. First, for each parameter a "DEFINE" directive is generated. These directives are written to a temporary file. Thereafter, the specified code fragments (see include_files ) as the next block in the temporary file is copied. Subsequently, all directly specified name of JobScheduler parameters are substituted by their current value. The script is written as the last part to the temporary file.

With the temporary file as input the client is started.

Parameters of the job, job or job parameters, can be used in the script in two ways. Firstly, all parameters of their name, apply with a preceding "&" in the script. They are defined as SQL*Plus variables by the job. The job created for each parameter a "DEFINE" directive.

Secondly, the name of the JobScheduler parameters are used directly in the script. These names are then replaced by the current value of the parameter.

The contents of STDOUT and STDERR are as values ​​of the corresponding order parameters of the job transferred to the order. Thus, every subsequent step in a job chain has access to this information.

The job transfers the appropriate parameters in the order. The first of these are static parameters, such as those in the template docu described in the section "return parameters". On the other hand, these are dynamic parameters. The job analyzing the output of the script, and extracted there from using a regular expression, both Names and the values ​​of these parameters. The regular expression is defined by the parameter variable_parser_reg_exp .

These parameters are readable by all jobs in all job steps. The value of the parameter can be changed by other jobs.

The job can detect errors that are reported by the SQL * Plus client. These have a number that starts with the string "SP2".

Moreover, the job can detect errors that the DB server reported during or after the execution of the script. These begin with the string "ORA" and then also contain a number.

Occurs either SP2 or an ORA-error occurs, the job is terminated abnormally. A return code of 98 is set.

Additionally, the error message is as value of the parameter sql_error stored in the order parameters.

It is possible to ignore errors. There are parameters ignore_sp2_messages and ignore_ora_messages . There the numbers of ignored errors are specified as values​​. The error messages are contained in the STDOUT, ​​even if they are ignored.

WHENEVER SQLERROR EXIT SQL.SQLCODE
WHENEVER OSERROR EXIT FAILURE

column end_date new_value BCY_DATE
column period new_value PN_YEAR_PERIOD
column period_prev new_value PN_YEAR_PERIOD_PREV

select '0' as end_date from dual;
prompt SET end_date IS &BCY_DATE;
/
select '0' as period from dual;
prompt SET period IS &PN_YEAR_PERIOD;
/
select '0' as period_prev from dual;
prompt SET period_prev IS &PN_YEAR_PERIOD_PREV;
/
prompt SET end_date IS 1;
exit;

• Language: java
• Name of Java Class: sos.scheduler.db.SOSSQLPlusJobJSAdapterClass
• → Resource: com.sos.scheduler-*.jar