createSIBWSEndpointListener command

Use the createSIBWSEndpointListener command to create a new service integration bus-enabled web services endpoint listener configuration.

For every server or cluster that is to host an endpoint listener, you must install and configure a Service Data Objects (SDO) repository on the stand-alone server, or (for a server or cluster that is part of a managed cell) on the WebSphere® Application Server Network Deployment cell.

If you want to change the default HTTP endpoint listener security role, do so before you configure the SOAP over HTTP endpoint listener.

Before you configure a SOAP over JMS endpoint listener, you should configure the associated JMS resources.

You can configure any number of endpoint listeners with values of your own choosing, including the values given in Example values for endpoint listener configuration.

You can create a new endpoint listener configuration by using the wsadmin tool as described in this topic, or by using the administrative console as described in Creating a new endpoint listener configuration.
Note: If you want to create an endpoint listener configuration for your own endpoint listener application, rather than for one of the listeners that is supplied with WebSphere Application Server, you must use the wsadmin tool.

To run the command, use the AdminTask object of the wsadmin scripting client.

[IBM i][IBM i]The wsadmin scripting client is run from Qshell. [IBM i]For more information, see Configuring Qshell to run WebSphere scripts using wsadmin scripting.

Command-line help is provided for service integration bus commands:
  • For a list of the available bus-enabled web services commands, plus a brief description of each command, enter the following command at the wsadmin prompt:

    print AdminTask.help('SIBWebServices')

  • For overview help on a given command, enter the following command at the wsadmin prompt:

    print AdminTask.help('command_name')

After using the command, save your changes to the master configuration by using the following command:

AdminConfig.save()

Purpose

This command creates an endpoint listener configuration.

Target object

ObjectName of the server or cluster on which the endpoint listener is created.

The SIBWSEndpointListener object that is created has no associated SIBWSBusConnectionProperty objects. Use the administrative console to connect one or more service integration buses to this endpoint listener, as described in Modifying an existing endpoint listener configuration.

Required parameters

-name
The name of the endpoint listener within the server. If you are installing your own endpoint listener application, rather than one that is supplied with WebSphere Application Server, then this name must match the name given in the endpoint listener application that you have installed (that is, the display name of the endpoint module within the endpoint application EAR file).
-urlRoot
The root of the web address that should be used to build the endpoint addresses within WSDL documents to direct requesters to this endpoint listener.
-wsdlUrlRoot
The root of the web address for the WSDL files of the inbound services that are provided by this endpoint listener.

Conditional parameters

-earFile
The location of the endpoint listener application. Specify this parameter if you are configuring an endpoint listener other than those supplied with WebSphere Application Server.

Optional parameters

None.

Example

  • Using Jython:
    epl = AdminTask.createSIBWSEndpointListener(server, ["-name", "soaphttp1",
     "-urlRoot", "http://myserver.com/wsgwsoaphttp1",
     "-wsdlUrlRoot", "http://myserver.com/wsgwsoaphttp1"] )
  • Using Jacl:
    set epl [$AdminTask createSIBWSEndpointListener $server {-name "soaphttp1"
     -urlRoot "http://myserver.com/wsgwsoaphttp1"
     -wsdlUrlRoot "http://myserver.com/wsgwsoaphttp1"}]

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: March 5, 2017 17:54
File name: rjw_cli_epl_new.html