(a) Function

Sets a UAP name.

(b) Format

 
public void setUapName ( String uap_name ) throws SQLException
 

(c) Argument

String uap_name

Specifies a UAP name.

If the null value is specified, the current UAP name that had been set with this method is invalidated, and the setting is returned to its initial status.

(d) Return value

None.

(e) Functional detail

Sets a UAP name.

The specified UAP name is used for the following purposes:

• In the output information to each type of trace information
• In the UAP identification information that is output when the -d prc option is specified in the pdls command

In the following cases, the JDBC driver assumes that no UAP name has been set by this method (for details about how the JDBC driver handles the situation when there is no setting, see 17.11 Connection information priorities):

• When the null value is specified in the uap_name argument
• When a character string whose length is 0 or a character string consisting of only single-byte spaces is specified in the uap_name argument

(f) Exceptions

None.

(g) Notes

The UAP specified by this method is encoded using the conversion character set specified by the setEncodeLang method, and the first 30 bytes of the encoded UAP name are transferred to the HiRDB server (the name is truncated after 30 bytes even if the 30th byte is only part of a character). The UAP name that can be obtained by the HiRDB server is only the first 30 bytes after encoding.