17.10.9 setUapName
(1) 機能
UAP名称を設定します。
(2) 形式
public void setUapName ( String uap_name ) throws SQLException
(3) 引数
- String uap_name：
-
UAP名称を指定します。
ナル値の場合は，このメソッドによって現在までに設定したUAP名称を無効とし，初期状態に戻します。
(4) 戻り値
なし。
(5) 機能詳細
UAP名称を設定します。
指定されたUAP名称は，次の箇所で使用されます。
-
各種トレース情報への出力情報
-
pdlsコマンドに-d prcオプションを付与して実行したときに出力されるUAPの識別名称
次のどちらかの場合は，このメソッドによるUAP名称の設定がないものとみなします。設定がない場合の扱いについては，「接続情報の優先順位」を参照してください。
-
引数uap_nameにナル値を指定した場合
-
引数uap_nameに長さ0の文字列，又は半角スペースだけの文字列を指定した場合
(6) 発生する例外
なし。
(7) 注意事項
このメソッドで指定したUAPは，setEncodeLangメソッドで指定された変換文字セットでエンコードされ，エンコード後のUAP名称の先頭から30バイトがHiRDBサーバに転送されます（30バイト目が文字の途中であっても，30バイトで打ち切られます）。そのため，HiRDBサーバで取得できるUAP名称は，エンコード後の先頭30バイトまでです。