cjrenameapp (rename application)

Format

cjrenameapp [server-name] [-nameserver provider-URL] 
      -name application-name -newname new-application-name

To Page Top

Function

This command renames a specified J2EE application.

Renaming an application enables you to manage the application's generation and version.

If you rename the application that does not contain application.xml, application.xml is created. Therefore, the renamed J2EE application becomes the application containing application.xml.

To Page Top

Arguments

server-name

Specifies the name of a connected J2EE server. If the server name is omitted, the host name is assumed.

-nameserver provider-URL

Specifies the access protocol for the CORBA Naming Service, the name of the host running the CORBA Naming Service, and the port number being used by the host. These items are specified in the following format:

protocol-name: : host-name: port-number

For details on the specification items, see 2.1.2 Provider URL.

-name application-name

Specifies the name of the J2EE application to be renamed.

-newname new-application-name

Specifies the new J2EE application name, as one or more characters.

You can use alphanumeric characters (0-9, A-Z, or a-z) or the following special characters in the name:

plus (+), hyphen (-), period (.), caret (^), underscore (_)

To Page Top

Input examples

cjrenameapp MyServer -name App1 -newname App2

To Page Top

Return values

0:

The command terminated normally.

1:

The command terminated abnormally.

2:

The command could not be executed because of an exclusion error.

3:

A timeout occurred.

9:

The command could not be executed because there are no administrator privileges (in Windows).

To Page Top

Notes

• When you specify a server name in the command arguments, you must specify it immediately after the command name. You can specify the other arguments in any order as long as they are subsequent to the server name (or subsequent to the command name if the server name is omitted). However, you cannot switch the sequence of an option name and its corresponding value (for example, you cannot specify application-name -name); also, you cannot specify an option name in conjunction with a non-corresponding value (for example, you cannot specify -nameserver application-name -name provider-URL).

• When you specify a server name in the command arguments, you must specify a case-sensitive character string that matches a server name specified in a cjsetup (set up or unsetup J2EE server).

• You must stop the application to be renamed before you execute this command.

• When an application is renamed, its lookup name is also changed. Therefore, modification becomes necessary if an EJB client uses the lookup name or if a path is processed by the Naming Service switching functionality.

• This command can execute application renaming even for applications created with an old version.

• If the same name is specified for application-name and new-application-name, the application name does not change.

• If the specified application name is more than 255 characters, an error will occur.

• You cannot change the name of a WAR application. If you specify a WAR application in the -name option, the command terminates abnormally.

To Page Top