Connection parameters

The primary function of the connection parameters is to specify the location and transport information for the Web service on the network. Web services provide two separate mechanisms for doing this. OpenEdge supports both mechanisms through the Web service connection parameters.

This is the Web service syntax for the connection-parameters string:

-WSDL wsdl-document[ -WSDLUserid user-id[ -WSDLPassword password]]
{
     {
        [ -Service service-name[ -ServiceNamespace service-namespace]]
        [ -Port port-name]
     }
  |
     {
        [[ -Binding binding-name[ -BindingNamespace binding-namespace]]
            -SOAPEndpoint URL-endpoint ]
     }
}
[ -SOAPEndpointUserid user-id
[ -SOAPEndpointPassword password]]
[ -TargetNamespace targetNamespace]
[ -maxConnections num-connections]
[ -connectionLifetime nSeconds]
[ -nohostverify ]
[ -nosessionreuse ]
[ -pf filename]

The only fully required element is the -WSDL parameter to identify the WSDL document for the Web service. This syntax might seem confusing, since the required elements, -Service and -Port or -Binding and -SOAPEndpoint, contain only optional elements. This situation arises because the WSDL file can directly supply some of this information.

Basically a complete binding can be specified by one of these mechanisms:

1. A valid service and port (transport and Web service URL location) specification (the most common mechanism)
2. A valid binding (transport) and SOAP endpoint (Web service URL location) specification (sometimes used to bind a SOAP viewer between the client and the Web service, or to provide a consortia of equivalent Web service locations)

The connection parameters only need to contain enough information to uniquely specify a target. If a WSDL only contains a single service, you can dispense with the -Service option. If a WSDL only contains a single port type, you can dispense with the -Port option. The same pattern applies for the -Binding/-SOAPEndpoint options. When a WSDL contains multiple choices for an option, the connection parameters must specify a unique value for that option.

A CONNECT( ) method fails, if any of the following happen:

• You include both valid -Service/-Port and valid -Binding/-SOAPEndpoint options in the connection parameters.
• The service, port, or binding options do not match the corresponding WSDL entries exactly with respect to namespace, local name, and letter case.
• The WSDL contains multiple services, ports, or bindings, and you fail to specify a valid, unique set of -Service/-Port or -Binding/-SOAPEndpoint options.

The following table provides a short description for each parameter in the Web service connection parameter string, in the order they appear in the syntax. For more information on these parameters, see the CONNECT( ) method entry in OpenEdge Development: ABL Reference.