org.mobicents.csapi.jr.slee.mm.ule
Interface IpUserLocationEmergencyConnection

All Superinterfaces:

IpServiceConnection

public interface IpUserLocationEmergencyConnection
extends IpServiceConnection

The application programmer can use this interface to obtain the location of users who initiate emergency calls. This interface shall be implemented by a Mobility SCF. The emergencyLocationReportReq() method, or the subscribeEmergencyLocationReports() and unSubscribeEmergencyLocationReports() methods shall be implemented as a minimum requirement.

Method Summary

int	emergencyLocationReportReq(TpUserLocationEmergencyRequest request) Request of report on the location for one user that is making an emergency call.
int	subscribeEmergencyLocationReports() Subscribe to network initiated emergency user location reports.
void	unSubscribeEmergencyLocationReports(int assignmentId) This method cancels a subscription to network initiated emergency user location reports.

Methods inherited from interface org.mobicents.csapi.jr.slee.IpServiceConnection

closeConnection

Method Detail

emergencyLocationReportReq

int emergencyLocationReportReq(TpUserLocationEmergencyRequest request)
                               throws TpCommonExceptions,
                                      P_UNKNOWN_SUBSCRIBER,
                                      P_INFORMATION_NOT_AVAILABLE,
                                      P_APPLICATION_NOT_ACTIVATED,
                                      javax.slee.resource.ResourceException

Request of report on the location for one user that is making an emergency call.

Parameters:

request - Specifies among others the identity of the user or terminal, requested location type, accuracy, response time and priority.

Returns:

assignmentId Specifies the assignment ID of the emergency location-report request.

Throws:

TpCommonExceptions

P_UNKNOWN_SUBSCRIBER

P_INFORMATION_NOT_AVAILABLE

P_APPLICATION_NOT_ACTIVATED

javax.slee.resource.ResourceException

subscribeEmergencyLocationReports

int subscribeEmergencyLocationReports()
                                      throws TpCommonExceptions,
                                             javax.slee.resource.ResourceException

Subscribe to network initiated emergency user location reports.

Returns:

assignmentId Specifies the assignment ID of the subscription.

Throws:

TpCommonExceptions

javax.slee.resource.ResourceException

unSubscribeEmergencyLocationReports

void unSubscribeEmergencyLocationReports(int assignmentId)
                                         throws TpCommonExceptions,
                                                P_INVALID_ASSIGNMENT_ID,
                                                javax.slee.resource.ResourceException

This method cancels a subscription to network initiated emergency user location reports. The assignment ID does not correspond to one of a valid assignment.

Parameters:

assignmentId - Specifies the assignment ID of the subscription.

Throws:

TpCommonExceptions

P_INVALID_ASSIGNMENT_ID

javax.slee.resource.ResourceException