(a)　機能

UAP名称を設定します。

(b)　形式

 
public void setUapName ( String uap_name ) throws SQLException
 

(c)　引数

String uap_name：

UAP名称を指定します。

ナル値の場合は，このメソッドによって現在までに設定したUAP名称を無効とし，初期状態に戻します。

(d)　戻り値

なし。

(e)　機能詳細

UAP名称を設定します。

指定されたUAP名称は，次の箇所で使用されます。

• 各種トレース情報への出力情報
• pdlsコマンドに-d prcオプションを付与して実行したときに出力されるUAPの識別名称

次のどちらかの場合は，このメソッドによるUAP名称の設定がないものとみなします。設定がない場合の扱いについては，「18.11　接続情報の優先順位」を参照してください。

• 引数uap_nameにナル値を指定した場合
• 引数uap_nameに長さ0の文字列，又は半角スペースだけの文字列を指定した場合

(f)　発生する例外

なし。

(g)　注意事項

このメソッドで指定したUAPは，setEncodeLangメソッドで指定された変換文字セットでエンコードされ，エンコード後のUAP名称の先頭から30バイトがHiRDBサーバに転送されます（30バイト目が文字の途中であっても，30バイトで打ち切られます）。そのため，HiRDBサーバで取得できるUAP名称は，エンコード後の先頭30バイトまでです。