You can use this statement to get the current setting of an option. It is recommended that you use the CONNECTION_PROPERTY function instead.

Syntax

GET OPTION [ userid.]option-name
{ INTO hostvar | USING DESCRIPTOR sqlda-name }

userid : identifier, string, or hostvar

option-name :  identifier, string, or hostvar

hostvar : indicator variable allowed

sqlda-name : identifier

Remarks

The GET OPTION statement is provided for compatibility with older versions of the software. The recommended way to get the values of options is to use the CONNECTION_PROPERTY system function.

The GET OPTION statement gets the option setting of the option option-name for the user userid or for the connected user if userid is not specified. This is either the user's personal setting or the PUBLIC setting if there is no setting for the connected user. If the option specified is a database option and the user has a temporary setting for that option, then the temporary setting is retrieved.

If option-name does not exist, GET OPTION returns the warning SQLE_NOTFOUND.

Permissions

None required.

Side effects

None.

See also

• SET OPTION statement
• Alphabetical list of system procedures
• CONNECTION_PROPERTY function [System]

Standards and compatibility

Example

The following statement illustrates use of GET OPTION.

EXEC SQL GET OPTION 'date_format' INTO :datefmt;