Working with Workload Objects › Application and Web Services Jobs › POJO Jobs › Define a POJO Job

Define a POJO Job

You can define a POJO job to create a Java object instance with no arguments, invoke a method on the object instance, and store the method's output.

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

To define a POJO job

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 POJO job from the Application and Web Services group in the Palette view, and drag the job to the workspace.

   The POJO icon appears on the Application workspace view.

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

   The Basic page of the POJO 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.

   Class name

   Specifies the Java class to instantiate.

   Example: java.lang.String

   Method

   Specifies the Java method to call on the instance of the Java object.

   Example: concat

5. (Optional) Specify the following additional information:

   Output destination

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

   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, as required:

   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 POJO job is defined.

Example: Define a POJO Job

Suppose that you want to define a POJO job that creates an empty java string, and calls the method parseInt on it with the argument “5”.

To define a POJO job

1. Enter the following required information in the Basic page:
   • Name—IGNORE
   • Agent name—AGENT
   • Class name—java.lang.Integer
   • Method name—parseInt
2. Add the following parameter in the Method Parameters page:
   • Parameter Type—java.lang.String
   • Parameter Value—5
3. Click OK.

More information:

POJO Jobs

Payload Producing and Payload Consuming Jobs