Working with Workload Objects › Application and Web Services Jobs › RMI Jobs › Define an RMI Job

Define an RMI Job

You can define the RMI job to call a method on a remote server and store the method's output.

Note: To run these jobs, your system requires CA WA Agent for UNIX, Linux, or Windows and CA WA Agent for Application Services.

Follow these steps:

1. Open the Application that you want to add the job to in the Define perspective.

   The Application appears in the workspace.

2. Select the RMI job from the Application and Web Services group in the Palette view, and drag the job to the workspace.

   The RMI icon appears on the Application workspace view.

3. Right-click the RMI icon, and select Edit from the pop-up menu.

   The Basic page of the RMI dialog opens.

4. Complete the following required fields:

   Name

   Defines the name of the job that you want to schedule.

   Limits: 128 alphanumeric characters, plus the special characters commercial at (@), pound (#), dollar sign ($), underscore (_), square brackets ([]), brace brackets ({}), and percent sign (%) as a symbolic variable introducer character.

   Agent name

   Specifies the name of the agent that lets you access a remote server and invoke a method on a Java object.

   RMI URL

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

   rmi://host:port/name

   • (Optional) host is the name of the local or remote computer where the RMI registry that hosts the remote object runs. If you omit the host, the local host is used.
   • (Optional) port is the RMI registry port number the host uses to listen for requests. If you omit the port, the default port of the host's RMI registry, 1099, is used.
   • name is the name of a remote object.

   Example: rmi://nissan:5000/test

   Method name

   Specifies the method of the remote Java class to invoke.

   Example: update

5. (Optional) Specify the following additional information:

   Output destination

   Specifies the location of the Java serialized object produced by the job.

   Limits: Up to 256 characters

   Note: If you do not specify an output destination, the Java serialized object is stored in the spool directory on the agent computer using the job name and a numeric suffix as the file name.

6. (Optional) Click Method Parameters in the left pane.

   The Method Parameters page opens in the right pane.

7. Click New to add parameters for the method.

   The New Parameter dialog opens.

8. Select one of the following parameter options:
   • Value—Identifies a single value
   • Payload producing job—Identifies the name of a predecessor job
   • Array—Identifies more than one value

   The fields related to the option appear.

9. Complete the following fields that apply to the parameter option:

   Type

   Specifies the Java class of the parameter. This field is mandatory for the Value and Array parameter options only.

   Example: Integer

   Value

   (Optional) Specifies the String value for the method parameter. This field is used with the Value parameter option.

   Example: 2

   Payload producing job

   Specifies the name of the predecessor job that produced the Java serialized object to be used as an input parameter. This field is used with the Payload producing job parameter option.

   Note: The job must be defined within the same Application as the job you are defining.

   Example: ANYJOB.URI

   Array

   Specifies a set of string values for the method parameter. Click Add to enter each value. This field is used with the Array parameter option.

   Example: 1, 2, 3

10. Click OK.

    The New Parameter dialog closes and the parameters appear in a list.

11. Click OK.

    The RMI job is defined.

Example: Define an RMI Job

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

To define an RMI job

1. Enter the following required information in the Basic page:
   • Name—START
   • Agent name—AGENT
   • RMI URL—rmi://remotehost/Test
   • Method name—startserver
2. Add the following parameter in the Method Parameters page:
   • Type—String
   • Value—now
3. Click OK.

More information:

Payload Producing and Payload Consuming Jobs

RMI Jobs