IBM Business Process Manager, V8.0.1, All platforms > Reference > Commands and scripts > Commands (wsadmin scripting)

createWSRRDefinition command

Use this command to create a WSRR definition.

It is a multistep command in which the steps define the type of connection definition and its specific properties. You can specify only one step, because a WSRR definition can only have one connection definition.

Before you begin

The createWSRRDefinition command is run using the AdminTask object of the wsadmin scripting client.

• Locate the command that starts the wsadmin scripting client: this is found in the install_root\bin directory.

• Run the wsadmin command.

  • If the server is not running, use the -conntype none option.

  • If you are not connecting to the default profile, use the -profileName profile_name option.

Use the following command to list all the WSRR administrative commands.

$AdminTask help SIBXWSRRAdminCommands

Use the following command to get detailed help on a particular command.

$AdminTask help command_name

Syntax

$AdminTask createWSRRDefinition {-paramName paramValue ...}

Required parameters

-name definitionName

The name of the WSRR definition, as a string.

-description defDescription

Brief description of the definition. This is optional, for your own reference.

-connectionType WEBSERVICE

Connection type. Currently the only connection type is WEBSERVICE.

-defaultCacheExpiryTimeout timeout

Timeout of the cache, in seconds. A value of 0 indicates that query results are never cached. Default is 300.

Steps

If you specify more than one step, an exception is thrown.

To set properties for a web service connection associated with the WSRR definition, you can specify values for the registry URL, the authentication alias and the SLL configuration as follows:

-WSConnection {{registryURL authAlias repertoire}}

To use the default registry URL (which is http://localhost:9080/WSRRCoreSDO/services/WSRRCoreSDOPort), specify a pair of double quotation marks ("") for the first value. To omit the authentication alias, specify a pair of double quotation marks ("") for the second value. To omit the repertoire, (the SLL configuration), specify a pair of double quotation marks ("") for the third value.

Examples

Use the default connection:

• Jython example:

  AdminTask.createWSRRDefinition('[-name mydefName -description "my description" 
      -defaultCacheExpiryTimeout 300 -connectionType WEBSERVICE]') 
  

• Jacl example:

  $AdminTask createWSRRDefinition {-name mydefName -description "my description" 
      -defaultCacheExpiryTimeout 300 -connectionType WEBSERVICE}
  

Setting the connection properties:

• Jython example:

  AdminTask.createWSRRDefinition('[-name mydefName -description "my description" 
      -defaultCacheExpiryTimeout 300 -connectionType WEBSERVICE 
      -WSConnection  [-registryUrl http://localhost:9080 -authAlias AUTH_ALIAS1 -repertoire SSL_CONFIG1]]')
  

• Jacl example:

  $AdminTask createWSRRDefinition {-name mydefName -description "my description" 
      -defaultCacheExpiryTimeout 300 -connectionType WEBSERVICE 
      -WSConnection {{ http://localhost:9080 AUTH_ALIAS1 SSL_CONFIG1 }}}
  

Setting one connection property:

Setting one connection property using alternative list syntax.

• Jython example:

  AdminTask.createWSRRDefinition('[-name defName -description "my description" 
      -defaultCacheExpiryTimeout 300 -connectionType WEBSERVICE 
      -WSConnection  [ ["" AUTH_ALIAS1  ""] ]]')
  

• Jacl example:

  $AdminTask createWSRRDefinition {-name defName -description "my description" 
      -defaultCacheExpiryTimeout 300 -connectionType WEBSERVICE 
      -WSConnection {{ "" AUTH_ALIAS1 "" }}}
  

Parent topic: Commands (wsadmin scripting)

Related information:

Obtaining online help using wsadmin scripting
Administrative command invocation syntax using wsadmin scripting
Use the wsadmin scripting tool
Jython script library