cjrenameapp(アプリケーション名の変更)
形式
cjrenameapp [<サーバ名称>] [-nameserver <プロバイダURL>] -name <アプリケーション名> -newname <変更後アプリケーション名>
機能
指定したJ2EEアプリケーションの名称を変更します。
アプリケーションの名前を変更することによって,アプリケーションの世代管理やバージョン管理ができます。
なお,application.xmlを省略したアプリケーションの名前を変更した場合,application.xmlが作成されます。そのため,アプリケーション名を変更したJ2EEアプリケーションはapplication.xmlを含むアプリケーションになります。
引数
- <サーバ名称>
-
接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは,ホスト名称がサーバ名称として使用されます。
- -nameserver <プロバイダURL>
-
CORBAネーミングサービスへのアクセスプロトコル,CORBAネーミングサービスが稼働しているホスト名,およびそれが使用しているポート番号を次に示す形式で指定します。
<プロトコル名称>::<ホスト名称>:<ポート番号>
指定内容の詳細については,「2.1.2 プロバイダURLについて」を参照してください。
- -name <アプリケーション名>
-
名称を変更するJ2EEアプリケーション名を指定します。
- -newname <変更後アプリケーション名>
-
変更後のJ2EEアプリケーション名を1文字以上で指定します。
アプリケーション名には,英数字(0〜9,A〜Z,a〜z)または次の特殊文字を使用できます。
プラス(+),ハイフン(-),ピリオド(.),キャレット(^),アンダースコア(_)
入力例
cjrenameapp MyServer -name App1 -newname App2
戻り値
- 0:
-
正常終了しました。
- 1:
-
異常終了しました。
- 2:
-
排他エラーによってコマンドを実行できません。
- 3:
-
タイムアウトが発生しました。
- 9:
-
管理者特権がないため,コマンドが実行できません(Windowsの場合)。
注意事項
-
コマンドの引数にサーバ名称を指定する場合,コマンド名の直後にする必要があります。そのほかの引数は,サーバ名称より後ろ(サーバ名称を省略した場合はコマンド名の後ろ)にあれば順序は任意です。ただし,オプション名と値の順序の入れ替え(例:<アプリケーション名> -name)やオプション名と値を非対応にすること(例:-nameserver <アプリケーション名> -name <プロバイダURL>)はできません。
-
コマンドの引数にサーバ名称を指定する場合,cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。
-
このコマンドを実行する場合,名称変更の対象となるアプリケーションは停止している必要があります。
-
アプリケーション名称を変更した場合,lookup名称も変更されるのでlookup名称を使用しているEJBクライアントやネーミング切り替え機能などでパスを通している場合は,修正が必要となります。
-
旧バージョンで作成されたアプリケーションについても,アプリケーション名を変更できます。
-
<アプリケーション名>と<変更後アプリケーション名>に同じ名前を指定した場合,正常に処理されますが,アプリケーション名は変わりません。
-
指定したアプリケーション名が255文字より大きい場合はエラーとなります。
-
WARアプリケーションの名前を変更することはできません。-nameオプションにWARアプリケーションを指定した場合,このコマンドは異常終了します。