Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • to invoke the Wizard that is available from the job properties tab in the Configuration view and to select the JITL SQLPlusJob SQLPLUSJob and respective arguments from the Wizard

...

The following example shows basic use of the SQLPlusJob SQLPLUSJob. It executes SQL*Plus code from an .sql file and writes output to the stdout channel.


The job arguments can be specified as follows:

...

Documentation

Job Documentation including the full list of argumentshttps://www.sos-berlin.com/doc/JS7-JITL/SQLPlusJob.xml

The SQLPlusJob SQLPLUSJob class accepts the following arguments:

...

Name

Purpose

Required

Default Value

Example

command_script_file

Path to the SQL script that should be executed

true


c:\app\bin\sqls\get_upd_count.sql

db_url

Database service name or instance name

true


DORCL01

db_user

User name for database access

true


scott

db_password

Password for database access

true


tiger
shell_commandPath to the SQL*Plus command line utilitytrue
sqlplus

variable_parser_reg_expr

Regular expression to parse output and to set order variables for subsequent jobs

false^SETs+(\\s)\\s*ISs(.*)$



command_line_optionsSQL*Plus command line optionsfalse
-S -L
ignore_ora_messagesIgnore Oracle error messagesfalse

ignore_sp2_messagesIgnore sp2 error messagesfalse

include_filesCode blocks that should be included before executing the SQL*Plus scriptfalse

credential_store_fileLocation of a credential store database (*.kdbx)false
./config/private/jobs.kdbx
credential_store_keyLocation of a credential store key file (*.key)false
./config/private/jobs.key


The SQLPLUSJob can be used with a credential store to hold sensitive arguments. For use of the credential_store_* arguments see JS7 - Use of Credential Store with JITL Jobs.

...

As a result an Order Variable with the name my_variable and the value some_value is created. This pattern can be applied to any number of lines each creating a new Order Variable order variable for subsequent instructions and jobs.

...

The std_out_output variable holds the messages spooled to the stdout channel by SQL*Plus.

Return Variable: std_err_output

The std_err_output variable contains the messages spooled to the stderr channel by SQL*Plus.

Return Variable: exit_code

...