cjgetstubsjar (get RMI-IIOP stub and interface for application)

Format

cjgetstubsjar [server-name] [-nameserver provider-URL]
       -name application-name
       -d path-of-stub-and-interface-storage-destination-directory

To Page Top

Function

This command obtains the RMI-IIOP stub and interface for a J2EE application. The command can be executed regardless of the application's status (stopped or running).

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 for which the RMI-IIOP stub and interface are to be obtained.

-d path-of-stub-and-interface-storage-destination-directory

Specifies the path of the directory that stores the RMI-IIOP stub and interface. The following files are created under the specified directory:

• stubs.jar (file name of RMI-IIOP stub)

• ?.jar (file name of RMI-IIOP interface)

  A sequential number starting from 1 is assigned to ?.

  For example, if there are three interfaces, the file names are 1.jar, 2.jar, and 3.jar.

To Page Top

Input examples

cjgetstubsjar MyServer -name App1 -d temp

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

• If a file already exists on the specified path, it is overwritten.

• If the specified path does not exist, an error results.

• If the RMI-IIOP stub and interface are obtained while the application is stopped, they may not be the latest values.

• If the application specified by the -name option has never been started, an error results.

• If the J2EE application does not contain an Enterprise Bean that has a remove interface, an error occurs.

• For the following J2EE applications, the RMI-IIOP stub and interface cannot be retrieved from the Web browser. You use the cjgetstubsjar command to acquire RMI-IIOP stubs and interfaces:

  • A J2EE application exported by an old version that is being imported

  • A newly created application

  • An application that was renamed with the cjrenameapp (rename application)

• If you obtain the RMI-IIOP stubs and interfaces for J2EE applications in recommended mode or V9 compatibility mode, you cannot use the RMI-IIOP stubs and interfaces in other modes.

To Page Top