AutoMediate Command Syntax and Options

The AutoMediate command uses concrete WSDL file or directory locations as input and generates a composite application that provides pass-through mediation capabilities for existing web services.

Syntax

AutoMediate [-projectName project_name] [-projectDir project_dir] [-serviceHost host_name] [-servicePort port] wsdl location

AutoMediate Command Options
Option Description
-projectName

The name of the SOA project:

  • If you specify a name, a single SOA project is created. A single project is created even if you specify multiple WSDL files.
  • If you do not specify a name, all the projects are generated based on the @name attribute of the WSDL definitions element.

    If the @name attribute is not specified in the WSDL, the name of the WSDL file is used.

-projectDir

The directory where generated projects are to be created.

If this option is not specified, generated projects are created in the current working directory.

-serviceHost

The host name for the service endpoint using SOAP over JMS.

If this option is specified, the AutoMediate Command Line tool overwrites the host name field in the Naming Provider URL field in the generated resource template.

-servicePort

The port number for the service endpoint using SOAP over JMS.

If this option is specified, the AutoMediate Command Line tool overwrites the port in the Naming Provider URL in the generated resource template.

wsdl location

Specify the location of the source WSDL files:

  • If you use a single WSDL file, specify the name of the source WSDL file or directory location.
  • If you use multiple WSDL files, specify the name of the directory containing the source WSDL files.

    If you do not specify a -projectName when you use multiple WSDL files, the AutoMediate Command Line tool creates one ActiveMatrix SOA project for each concrete WSDL file in the source directory.

-httpConnectorName

The name of the HTTP connector for services bound using SOAP over HTTP.

If this option is not specified, HTTP connector name is the service name plus the port name. It is ignored for web services that are bound using SOAP over JMS.

-serviceJmsConFactoryJndiName (optional)

The JMS connection factory JNDI name for the resource template that is generated to configure a SOAP over JMS service endpoint.

If this field is specified, the AutoMediate Command Line tool will overwrite the connection factory JNDI name in the generated JMS connection factory resource template for the service endpoint.

-serviceJmsDestJndiName (optional)

The JMS destination JNDI name for the resource template that is generated to configure a SOAP over JMS service endpoint.

If this field is specified, the AutoMediate Command Line tool will overwrite the destination JNDI name in the generated JMS destination resource template for the service endpoint.

-refJmsConFactoryJndiName (optional)

The JMS connection factory JNDI name for the resource template that is generated to configure a SOAP over JMS reference endpoint.

If this field is specified, the AutoMediate Command Line tool will overwrite the connection factory JNDI name in the generated JMS connection factory resource template for the reference endpoint.

-refJmsDestJndiName (optional)

The JMS destination JNDI name for the resource template that is generated to configure a SOAP over JMS reference endpoint.

If this field is specified, the AutoMediate Command Line tool will overwrite the destination JNDI name in the generated JMS destination resource template for the reference endpoint.

-daaOnly (optional) Used to generate only the DAA file.
AutoMediate Command Examples
Example Description
AutoMediate -projectName SOA webservice.wsdl Automatically mediates one or more web services defined by single WSDL file.
AutoMediate -projectName SOA webservice.wsdl webservice1.wsdl webservice2.wsdl
AutoMediatec:/tibco/SOAP/wsdls
  • c:/tibco/SOAP/wsdls1
  • c:/tibco/SOAP/wsdls2

AutoMediate webservice.wsdl c:/tibco/SOAP/wsdls webservice1.wsdl

Automatically mediates web services.
AutoMediate -projectDir C:/tibco/SOA/mediation/workspace webservice.wsdl Automatically mediates one or more web services and writes generated SOA project to a specific directory.
AutoMediate -projectDir C:/tibco/SOA/mediation/workspace -serviceHost localhost -servicePort 9897 webservice.wsdl Automatically mediates one or more web services, generates a SOA project in a specific directory, and updates the host and port for the service.
AutoMediate -projectDir C:/tibco/SOA/mediation/workspace

c:/tibco/wsdls

Automatically mediates web services defined by the WSDL files contained in the specified folder.
AutoMediate webservice.wsdl -daaOnly -projectDir

C:/tibco/SOA/mediation/workspace

Automatically mediates one or more web services and generates the DAA in the specified directory.
AutoMediate Command-Line Exception
Exception Description
WSDLFileNotFoundException The WSDL location passed to the AutoMediate Command Line tool is invalid.
NoWSDLServiceDefinedException

The WSDL passed to the AutoMediate Command Line tool does not have any services defined.

AutoMediate Command Line supports only concrete WSDLs for this add-on pack release.

NoWSDLServiceBindingException

The port child element of a WSDL service element has a missing binding attribute.

Binding must be provided for AutoMediate Command Line to generate a fully functional composite application.

NoWSDLBindingPortTypeException

A WSDL binding has a missing port type attribute.

The port type must be provided for AutoMediate Command Line to generate a fully functional composite application.