C-LANG Statements › REMOTECLASSNAME Statement—Specify a Remote Class Name

REMOTECLASSNAME Statement—Specify a Remote Class Name

The REMOTECLASSNAME statement specifies the naming class of the Java object you want to invoke a method on in an RMI job.

Supported Job Type

This statement is required for the RMI job type.

Syntax

This statement has the following format:

REMOTECLASSNAME remote_class

remote_class

Specifies the reference location of the object you want to invoke a method on. The format is the following:

rmi://[host:port/]name

host

(Optional) Specifies the name of the local or remote computer where the RMI registry that hosts the remote object runs.

Default: local host

port

(Optional) Specifies the RMI registry port number the host uses to listen for requests.

Default: 1099, the default port of the host's RMI registry

name

Specifies the name of a remote object.

Limits: Up to 1024 characters; case-sensitive

Example: rmi://smith:5000/test

Note: Enclose values that contain delimiters (such as spaces) in double quotation marks.

Example: Invoke a Method to Start a Remote Server

Suppose that you want to invoke a method that starts a remote server using remote object activation. You want the server to start immediately.

AGENT APPAGENT
REMOTECLASSNAME rmi://remotehost/Test
METHOD startserver
PARAMETER TYPE(String) VALUE(now)