WebSphere brand IBM WebSphere IP Multimedia Subsystem Connector, Version 6.2

subscribePSIActivation Web service method

This Web service method allows the caller to subscribe for changes to the state (Active or Inactive) of a service provided by an application.

Usage

The IMS Application Server uses this Web service to subscribe or unsubscribe to notifications from the HSS when the PSI Activation, associated with a specific Public Service Identity, has changed states.

Example

URI callbackURI = new URI("http://hostname.example.com:1234/DHADiameterShNotifyTestClient/services/DiameterShNotifyService");
String resultCode = service.subscribePSIActivation( "aaa://host.example.com;protocol=diameter;-117302099;1", "sipintel10.city.example.com", "realmA.example.com", "sips:carol@ws1234.example.com", 0, CallbackURI, null, null); 

Parameters

Parameter Name Type Description
sessionId String

Identifies a specific session. All messages pertaining to a specific session must include only one Session-Id AVP and the same value must be used throughout the life of a session. The Session ID must be globally and eternally unique, as it is meant to uniquely identify a user session without reference to any other information. This may be needed to correlate historical authentication information with accounting information. Example: aaa://host.example.com;protocol=diameter;-117302099;1

destinationHost String

The fully qualified domain name of the HSS that the Sh subscriber profile Web service will send this request to. This input parameter is optional. Examples include: sipintel15.city.example.com or diameter.example.com

This is an optional parameter. If specified, it must be the FQDN of destination Diameter node which handles the request.

destinationRealm String

The realm that this subscriber belongs to. The destination realm is a required parameter and must be a fully qualified domain name. The value specified must match the specific realmName property that is defined in one of the routex properties in the Diameter_Sh.properties file. If the value does not match any of the specific routes, and a DEFAULT route entry is defined, the DEFAULT route will be used.

publicIdentity String
Specifies the public user identity or public service identity. This can be either a SIP URL or a TEL URL. Example:
  • sip:Alice.Smith@example.com:transport=tcp
  • sips:carol@ws1234.example.com
  • sip:+358-555-1234567;postd=pp22@example.com;user=phone
  • sip:alice;day=tuesday@example.com
  • tel:+919-123-4567
  • tel:+358-555-1234567;postd=pp22
subsReqType int
Available subscription status values:
  • 0 = SUBSCRIBE
  • 1 = UNSUBSCRIBE
callbackUri URI

The Web service URI used to deliver notification back to the subscriber; for example: http://example.com:7676/DHADiameterShNotifyService/services/DiameterShNotifyService

userId String

If the IMS™ Application Server Notify Web service is protected, specify the user ID for that Web service.

password String

If the IMS Application Server Notify Web service is protected, specify the password for that Web service.




Terms of use
(C) Copyright IBM Corporation 2009. All Rights Reserved.