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
Using 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 "" }}}