This Web service method is used by an IMS™ Application Server to subscribe to notifications of changes in the filter criteria. The notifications are specific to a particular public identity and application server combination.
This Web service method returns a string which contains the result code of the action.
URI callbackUri = new URI("http://hostname.example.com:1234/DHADiameterShNotifyTestClient/services/DiameterShNotifyService"); String resultCode = service.subscribeInitialFilterCriteria( "aaa://host.example.com;protocol=diameter;-117302099;1", "sipintel10.city.example.com", "realmA.example.com", "sips:carol@ws1234.example.com", 0, new URI("sip:siphappens.example.com"), callbackUri, null, null);
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 |
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. |
publicUserIdentity | String | A subscriber is allocated one or more public
user identities, which are created by the home operator. A public user identity
is either a SIP URL (as defined in RFC 3261) or a TEL URI (as defined in RFC
3966) and helps route a SIP request. Example:
|
subsReqType | int | Available subscription status values:
|
serverName | URI | The SIP URL of the application server that is providing the service of interest. |
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. |