Use the getProviderPolicySharingInfo command
to find out whether an application or service that is a web service
provider can share its policy configuration, and list the properties
that apply to sharing that configuration.
To run the command, use the AdminTask object of the wsadmin
scripting client.
The wsadmin scripting client is run
from Qshell. For more information, see the topic "Configure Qshell
to run WebSphere® Application Server scripts".
This command is valid only when it is used with WebSphere Application Server Version 7
and later application servers. Do not use it with earlier versions.
For a list of the available policy set management administrative
commands, plus a brief description of each command, enter the following
command at the wsadmin prompt:
print AdminTask.help('PolicySetManagement')
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. For example, use the following command:
AdminConfig.save()
Purpose
Use the getProviderPolicySharingInfo command
to find out how a web services application, or a service in a Web
services application, shares its policy configuration with clients,
service registries, or services that support the WS-Policy specification.
The policy configuration is shared in WS-PolicyAttachments format.
The
command returns properties that show whether the policy configuration
of the resource can be shared with clients through a WS-MetadataExchange
request or through Web Services Description Language (WSDL) that is
obtained by a ?WSDL HTTP Get request.
Required parameters
- -applicationName
- The name of the application for which you want to find out how
it shares its policy configuration. The application must be a service
provider. (String)
Optional parameters
- -resource
- The name of the resource for which you want to find out how it
shares its policy configuration. If you specify this parameter, only
the properties for that resource are returned. To retrieve information
for the application, specify WebService:/.
Alternatively, you can specify a service, endpoint or operation. However,
policy sets are attached only at the application or service level,
so the properties returned for an endpoint or operation are the settings
that are inherited from the service. (String)
Return value
Returns a list of properties
that include the resource name and that show whether the policy configuration
of the resource can be shared. The following properties can be returned:
- wsMexPolicySetName
- The name of the policy set that specifies message-level security
when the resource shares its policy configuration through a WS-MetadataExchange
request. This property is returned if the value of the sharePolicyMethods property
is wsMex and a policy set to provide message-level
security was specified.
- wsMexPolicySetBinding
- The name of the binding that is applied when the resource shares
its policy configuration through a WS-MetadataExchange request. This
property is returned if the value of the sharePolicyMethods property
is wsMex and a binding to provide message-level security
was specified.
- resource
- The resource that you specified.
- directSetting
- How the properties apply to the resource. Valid values for this
property are:
- true
- The properties apply directly to the resource.
- false
- The properties are inherited from the parent application or service.
- sharePolicyMethods
- How the policy configuration of the resource can be shared. Valid
values for this property are:
- httpGet
- The resource shares its policy configuration through an HTTP Get
request.
- wsMex
- The resource shares its policy configuration through a WS-MetadataExchange
request.
Example
The following command displays the
policy sharing configuration properties for the EchoService service
in the WSSampleServices application. The provider is configured to
share its policy through an HTTP Get request, and a WS-MetadataExchange
request with message-level security. Message-level security for the
WS-MetadataExchange request is provided by using the SystemWSSecurityDefault
policy set and the "Provider sample" general binding.
AdminTask.getProviderPolicySharingInfo(['-applicationName', 'WSSampleServices',
'-resource', 'WebService:/SampleServicesSei.war:{http://example_path/}EchoService'])
.
.
[ [wsMexPolicySetName SystemWSSecurityDefault] [wsMexPolicySetBinding [Provider sample]]
[resource WebService:/SampleServicesSei.war:{http://example_path/}EchoService/]
[directSetting true] [sharePolicyMethods [httpGet wsMex]] ]