Hitachi

Hitachi Advanced Database Application Development Guide


10.5.12 setApName(String name)

Organization of this subsection

(1) Function

This method specifies the application identifier for connecting to the HADB server.

(2) Format

public synchronized void setApName(String name) throws SQLException

(3) Arguments

String name

Specifies an application identifier as a character string with a length of 1 to 30 bytes. If a space, a character string with a length of zero, or null is specified, the JDBC driver assumes that no application identifier is specified by this method.

If an application program is connected to the HADB server without its application identifier being specified anywhere, "********" is set for the application identifier.

(4) Return value

None.

(5) Exceptions

If the value specified for name is invalid (such as a character string of more than 30 bytes), the JDBC driver throws an SQLException.

(6) Notes

The application identifier specified by this method is converted in accordance with the Java Virtual Machine's (JVM) default conversion character set. Therefore, we recommend that you specify an application identifier consisting exclusively of alphanumeric characters that do not depend on the conversion character set.