addSIBWSOutboundPort command

Use the addSIBWSOutboundPort command to add a service integration bus-enabled web services outbound port.

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 adds the configuration for an OutboundPort to an OutboundService.

Target object

ObjectName of the OutboundService with which the port is to be associated.

If an OutboundPort for the OutboundService by the given name already exists, or the name of the port does not correspond to a port in the service element of the service provider WSDL (as defined on the OutboundService) the command fails.

The command creates the port destination. If a destination with the specified or default name already exists, the command fails.

Either specify the node and server, or specify the cluster. If there is no messaging engine defined for the specified node and server or cluster, then the command fails.

If the WSDL is to be retrieved through a proxy server, the server on which the command is running must have the system properties that identify the proxy server set correctly. In addition, if the proxy server requires authentication, then the user ID and password can be set as parameters on the command.

If this is the first port for the OutboundService, then it is set as the default, and the service destination default routing is set to point to the port destination.

Required parameters

-name
The name of the port in the service provider WSDL.

Conditional parameters

-node
The node in which the port destination is localized.
-server
The server in which the port destination is localized.
-cluster
The cluster in which the port destination is localized.

Optional parameters

-destination
The name of the port destination.
-userId
The user ID that you use to retrieve the WSDL.
Note: This parameter is no longer required. If you have existing scripts that provide this parameter, they will continue to work.
-password
The password that you use to retrieve the WSDL.
Note: This parameter is no longer required. If you have existing scripts that provide this parameter, they will continue to work.

Example

  • Using Jython:
    outPort = AdminTask.addSIBWSOutboundPort(outService, ["-name", "MyServiceSoap",
     "-node", "MyNode", "-server", "server1"])
  • Using Jacl:
    set outPort [$AdminTask addSIBWSOutboundPort $outService {-name "MyServiceSoap"
     -node "MyNode" -server "server1"}]

Icon that indicates the type of topic Reference topic



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