cjdeleteapp (delete J2EE application)

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 ...]

To Page Top

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.

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.

-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.

To Page Top

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

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

• 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.

To Page Top