JDBC Librarylist property

The JDBC LibraryList property specifies one or more libraries that you want to add to or replace the library list of the server job, and optionally sets the default library (default schema).

The examples in the following table make these assumptions:
  • A library called MYLIBDAW contains MYFILE_DAW
  • You are running this SQL statment:
         "SELECT * FROM MYFILE_DAW"
Scenario SQL Naming System Naming

Basic Rules

Only one library is searched.

  • If a library is specified on the URL, it is used. It becomes the default library.
  • If no library is specified on the URL, the first library in the 'libraries' property is used. It becomes the default library.
  • If no library on URL and if no libraries property is specified, the library with the same name as the signed-on user profile is used.

The job's library list is updated with the libraries in the libraries property. This may affect the behavior of some triggers and stored procedures. It does not affect unqualified names in statements.

The job's library list is updated with the libraries on the libraries property. If a default library is specified on the URL then that becomes the default library.

1. No library specified anyplace.

Default schema is the user profile name.

No default schema. Job's library list is searched.

2. Default library specified on URL.

Default schema is the specified library.

Default schema is the specified library. Library list is not searched to resolve unqualified name in SQL statements.

3. Default library specified via property.

Default schema is the specified library.

No default schema. All libraries on list searched.

4. Default library specified on URL and property.

Default schema is the library specified on the URL. Library list is ignored.

Default schema is the library specified on the URL. Library list is not searched to resolve unqualified name in SQL statements.

5. Library property specified, lib name is bad

Default schema is the specified library

No default schema. The Library list can not be changed because one of the libraries in the list is not found so the job's library list is used.

6. No library on URL, library property specified, file found in second library in list

Default schema is the first library in the list, rest of libraries ignored.

If all libraries exist , then no default schema, all libraries on list searched, list replaces job's library list.

If one of the libraries on the list does not exist, the job's library list is not changed.

7. Library property specified, list starts with a comma

Default schema is user profile

No default schema, all libraries on list searched, list replaces job's library list.

8. Library property specified, list starts with a *LIBL

Default schema is user profile

No default schema, all libraries on list searched, libraries specified added to end of list

9. Library property specified, list ends with a *LIBL

Default schema is first lib on list, rest of list ignored

No default schema, all libraries on list searched, libraries specified added to beginning of job's library list

10. URL library invalid

No default schema, user profile used

No default schema, job's library list is used

Note: When a default schema is specified on the URL and the libraries property is not used, the default schema is appended before the current library list