This Web service method will return location information for a user or a service in a packet-switched network. The content of the PSLocationInformation object is defined in SHDataType.xsd. Some or all values within the PSLocationInformation object may be null if the corresponding element data (defined in ShDataType.xsd) was not received from the HSS.
PSLocationInformation myPSLocationInformation = service.getPSLocationInformation( "aaa://host.example.com;protocol=diameter;117302099;1", "sipintel10@city.example.com", "realmA.example.com", "0113 272 2245" );
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. |
msisdn | String | Mobile Subscriber ISDN is the standard international telephone
number used to identify a given subscriber. The MSISDN is the telephone number
of a GSM (Global System for Mobile Communications) cell phone that is stored
in the SIM (Subscriber Identity Module) smart card inside the phone. A public
user identity in IMS is the equivalent of the MSISDN in a GSM network. Example:
|