cjdeleteapp (delete J2EE application)
- Organization of this page
Format
- For an application
cjdeleteapp [<server-name>] [-nameserver <provider-URL>] -name J2EE-application-name [-name J2EE-application-name ...]
- For EJB-JAR, WAR, or RAR files included in an application
cjdeleteapp [server-name] [-nameserver provider-URL] -type {ejb|war|rar} -name J2EE-application-name -resname display-name [-resname display-name ...]
- For filters contained in a WAR in an application
cjdeleteapp [server-name] [-nameserver provider-URL] -type filter -name J2EE-application-name -resname WAR-file-display-name/filter-display-name [-resname WAR-file-display-name/filter-display-name ...]
Function
- For an application, EJB-JAR, WAR, or RAR file
-
This command deletes a J2EE application or EJB-JAR, WAR, or RAR file included in the J2EE application from the specified J2EE server. This command can delete multiple files concurrently, in which case the files are processed in the sequence in which they are specified.
- For a filter contained in a WAR file in a J2EE application
-
This command deletes a filter contained in a WAR file in a J2EE application. The filter to be deleted is specified in a HITACHI Filter Property File. This command can delete multiple filters concurrently, in which case the filters are processed in the sequence in which they are specified.
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.
- -type {ejb|war|rar|filter}
-
Specifies the file type when an EJB-JAR, WAR, or RAR file is to be deleted from a J2EE application:
-
ejb: EJB-JAR file
-
war: WAR file
-
rar: RAR file
If a filter is to be deleted from a WAR file in a J2EE application, the following file type is specified:
filter: Filter
-
- -name J2EE-application-name
-
Specifies the name of the J2EE application to be deleted.
- -resname display-name
-
Specifies the display name of EJB-JAR file, WAR file, RAR file, or filter that is to be deleted.
Input examples
- For an application
cjdeleteapp MyServer -name App1
- For an EJB-JAR file
cjdeleteapp MyServer -name App1 -type ejb -resname accountJsp
- For a WAR file
cjdeleteapp MyServer -name App1 -type war -resname account-war
- For a RAR file
cjdeleteapp MyServer -name App1 -type rar -resname account-rar
- For a filter
cjdeleteapp MyServer -name App1 -type filter -resname account-war/account-filter
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).
Notes
-
If the target J2EE application has been started, this command terminates with an error.
-
If the specified J2EE application does not exist, this command terminates with an error.
-
If this command is executed for an application in exploded archive format, the application is deleted from the J2EE server but the application directory is not.
-
If this command is executed for an application in the exploded archive format, an EJB-JAR, WAR, or RAR file included in the application cannot be deleted.
-
If multiple files are to be deleted concurrently, this command attempts to delete all of the files, even if there are files that cannot be deleted. If there is even one file that cannot be deleted, the termination code becomes 1 (abnormal termination).
-
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 display-name -resname); also, you cannot specify an option name in conjunction with a non-corresponding value (for example, you cannot specify -nameserver display-name -resname 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 cannot delete WAR from a WAR application. If you specify a WAR application in the -name option, the command terminates abnormally.