17.11.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バイトまでです。