+

Search Tips   |   Advanced Search

getProviderPolicySharingInfo command

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.

(iseries) 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 the 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 WSDL that is obtained by a ?WSDL HTTP Get request.


    Target object

    None.


    Required parameters

    -applicationName

    The name of the application for which 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 to find out how it shares its policy configuration. If we specify this parameter, only the properties for that resource are returned. To retrieve information for the application, specify WebService:/. Alternatively, we 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 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 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]] ]


    Related concepts

  • Web service providers and policy configuration sharing


    Related tasks

  • Configure a service provider to share its policy configuration
  • Use the wsadmin scripting AdminTask object for scripted administration
  • Start the wsadmin scripting client

  • setProviderPolicySharingInfo command
  • getClientDynamicPolicyControl command
  • setClientDynamicPolicyControl command