C-LANG Statements › LOCATION Statement—Specify a Service Provider URL

LOCATION Statement—Specify a Service Provider URL

The LOCATION statement specifies the URL of the service provider using dotted decimal notation or DNS name in an Entity Bean, Session Bean, and JMS job. The service provider implements a context or initial context. This context can be plugged in dynamically to the JNDI architecture used by the JNDI client.

Supported Job Types

This statement is required for the following job types:

• Entity Bean
• JMS Publish
• JMS Subscribe
• Session Bean

Syntax

This statement has the following format:

LOCATION location

location

Specifies the JNDI service provider URL.

• For WebLogic servers, the format is the following:

  t3://WLIPAddress[:ORBPort]
  

  WLIPAddress

  Specifies the IP address or domain name of the WebLogic Application Server.

  ORBPort

  (Optional) Specifies the ORB port.

  Default: 7001

  Example: t3://localhost:7001

• For WebSphere servers, the format is the following:

  iiop://WSIPAddress[:ORBPort]
  

  WSIPAddress

  Specifies the IP address or domain name of the WebSphere Application Server.

  ORBPort

  (Optional) Specifies the ORB port.

  Default: 2809

  Example: iiop://172.24.0.0:2809

Limits: Up to 1024 characters; case-sensitive

Notes:

• Enclose values that contain delimiters (such as spaces) in double quotation marks.
• PROVIDER_URL is an alias of LOCATION.

Example: Specify the Service Provider URL for a WebLogic Application Server

Suppose that you want to create an entity bean that stores information about a customer such as the customer ID and phone number. The initial context factory supplied by the JNDI service provider is weblogic.jndi.WLInitialContextFactory. The service provider's URL is t3://localhost:7001, where localhost is the domain name of the WebLogic application server and 7001 is the ORB port. When the job runs, the entity bean instance is created.

AGENT APPAGENT
INITIAL_CONTEXT weblogic.jndi.WLInitialContextFactory
LOCATION t3://localhost:7001
BEAN customer
CREATEMETHOD createcustomer
OPERATIONTYPE CREATE
CREATEPARAMETER TYPE(String) VALUE(customerid)
CREATEPARAMETER TYPE(String) VALUE(800-555-0100)

Example: Specify the Service Provider URL for a WebSphere Application Server

Suppose that you want to invoke the reverse method on the CybEJBTestBean stateless session bean. The reverse method has one parameter, with type java.lang.String and value a23. The output from the reverse method is saved to the C:\Makapt15 file. The initial context factory supplied by the JNDI service provider is com.ibm.websphere.naming.WsnInitialContextFactory. The service provider's URL is iiop://172.24.0.0:2809, where 172.24.0.0 is the IP address of the WebSphere application server and 2809 is the ORB port. When the job runs, the output of the reverse method is stored in the output destination file.

AGENT APPAGENT
INITIAL_CONTEXT com.ibm.websphere.naming.WsnInitialContextFactory
LOCATION iiop://172.24.0.0:2809
BEAN CybEJBTestBean
METHOD reverse
DESTINATION C:\Makapt15
JNDIUSER cyberuser
PARAMETER TYPE(java.lang.String) VALUE(a23)