C-LANG Statements › CREATEPARAMETER Statement—Specify Create Parameters

CREATEPARAMETER Statement—Specify Create Parameters

The CREATEPARAMETER statement specifies the create parameters in an Entity Bean and Session Bean job. You can specify create parameters to create an entity bean in a relational database on your application server or to access a stateful session bean.

Supported Job Types

This statement is optional for the following workload objects:

• Entity Bean
• Session Bean

Note: To access stateful session beans, you must specify create parameters.

Syntax

This statement has the following format:

CREATEPARAMETER {TYPE(type) VALUE(value)}
                {TYPE(type) ARRAY(value,value,...)} 
                {URI(uri)}

TYPE(type)

Specifies the Java class of the parameter.

Limits: Up to 1024 characters; case-sensitive

Examples: String, java.lang.String, Integer

Note: If the package is not specified, java.lang is assumed.

Value(value)

Specifies the String value for the method parameter.

Limits: Up to 1024 characters; case-sensitive

ARRAY(value,value,...)

Specifies a set of string values for the method parameter.

Limits: Up to 1024 characters per array value; case-sensitive

Note: If you specify the ARRAY operand, the statement value cannot exceed 3588 characters.

URI(uri)

Specifies the location (URI) of the binary output produced by a payload producing job. A payload producing job is a job that produces binary output that is persisted as a serialized Java object. The serialized Java object is stored as a file on the agent computer. The URI can be passed as input to a payload consuming job.

Limits: Up to 255 characters; case-sensitive

Example: 'FS:c:\Program Files\Common Files\System\ADO\input.txt'

Note: For more information about retrieving the URI of a payload producing job, see the documentation for your scheduling manager.

Notes:

• Enclose values that contain delimiters (such as spaces) in double quotation marks.
• To specify multiple parameters, use multiple CREATEPARAMETER statements. Order is important. For example, if the method contains three parameters, specify the first parameter in the first statement, the second parameter in the second statement, and the third parameter in the third statement. The job fails if the parameters are listed in the wrong order.

Example: Specify Create Parameter to Access a Stateful Session Bean

Suppose that you want to access a stateful session bean for an online shopping cart. The createaddbook method creates the Shoppingcart stateful bean for the duration of the job. The addbook method adds books to the shopping cart using the book's ISBN number. In this example, the Session Bean job adds two books to the shopping cart with ISBN numbers 1551929120 and 1582701709. When the job runs, two books are added to the shopping cart.

AGENT APPAGENT
INITIAL_CONTEXT com.ibm.websphere.naming.WsnInitialContextFactory
LOCATION iiop://172.24.0.0:2809
BEAN Shoppingcart
CREATEMETHOD createaddbook
METHOD addbook
CREATEPARAMETER TYPE(String) VALUE(ISBN)
PARAMETER TYPE(Integer) ARRAY(1551929120,1582701709)