com.ibm.soa.parlayx21.sms
Interface ReceiveSms

All Superinterfaces:
java.rmi.Remote
All Known Subinterfaces:
ReceiveSms_RI
All Known Implementing Classes:
ReceiveSmsBindingStub, ReceiveSmsProxy

public interface ReceiveSms
extends java.rmi.Remote


Method Summary
 SmsMessage[] getReceivedSms(java.lang.String registrationIdentifier)
          The invocation of getReceivedSms retrieves all the SMS messages received that fulfil the criteria identified by registrationIdentifier.
 

Method Detail

getReceivedSms

SmsMessage[] getReceivedSms(java.lang.String registrationIdentifier)
                            throws java.rmi.RemoteException,
                                   PolicyException,
                                   ServiceException

The invocation of getReceivedSms retrieves all the SMS messages received that fulfil the criteria identified by registrationIdentifier. The method returns only the list of SMS messages received since the previous invocation of the same method, for example, each time the method is executed the messages returned are removed from the server. Moreover, each SMS message will be automatically removed from the server after a maximum time interval specified in an off-line configuration step.

The received SMS messages are returned in receivedSms. An SMS message is identified by a structure indicating the sender of the SMS message and the content.

Referenced faults

ServiceException from ES 202 391-1 [2]:
  * SVC0001 - Service error.
  * SVC0002 - Invalid input value.

PolicyException from ES 202 391-1 [2]:
  * POL0001 - Policy error.

Parameters:
registrationIdentifier - xsd:string Identifies the off-line provisioning step that enables the application to receive notification of SMS reception according to specified criteria
Returns:
result SmsMessage [0..unbounded] It lists the received SMS since last invocation
Throws:
java.rmi.RemoteException
PolicyException
ServiceException


Copyright © 2003 IBM Corp. All Rights Reserved.