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
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).
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.
Input examples
cjgetstubsjar MyServer -name App1 -d temp
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 Server 2012, Windows Server 2008, Windows 8, Windows 7, or Windows Vista).
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)