com.ibm.soa.parlayx21.terminal_status
Interface TerminalStatusNotification

All Superinterfaces:
java.rmi.Remote
All Known Subinterfaces:
TerminalStatusNotification_RI
All Known Implementing Classes:
TerminalStatusNotificationBindingStub, TerminalStatusNotificationProxy

public interface TerminalStatusNotification
extends java.rmi.Remote

Notification interface to which notifications are delivered.


Method Summary
 void statusEnd(java.lang.String correlator)
          The notifications have completed for this correlator.
 void statusError(java.lang.String correlator, java.net.URI address, ServiceError reason)
          This operation is invoked on the application to indicate that the notification is being cancelled by the Web Service.
 void statusNotification(java.lang.String correlator, StatusInformation[] terminalStatus)
          When the status of a monitored device changes, a notification is delivered to the application with the new status information for each of the devices.
 

Method Detail

statusNotification

void statusNotification(java.lang.String correlator,
                        StatusInformation[] terminalStatus)
                        throws java.rmi.RemoteException

When the status of a monitored device changes, a notification is delivered to the application with the new status information for each of the devices. If a group identifier was used, the terminal device URI is provided, not the group URI.

Referenced faults

None.

Parameters:
correlator - xsd:string Correlator provided in request to set up this notification
terminalStatus - StatusInformation [1..unbounded]

Set of elements, each containing a terminal address and its new status.

Throws:
java.rmi.RemoteException

statusError

void statusError(java.lang.String correlator,
                 java.net.URI address,
                 ServiceError reason)
                 throws java.rmi.RemoteException

This operation is invoked on the application to indicate that the notification is being cancelled by the Web Service.

Referenced faults

None.

Parameters:
correlator - xsd:string

Correlator provided in request to set up this notification.

address - xsd:anyURI

Address of terminal if the error applies to an individual terminal, or not specified if it applies to the whole notification.

reason - common:ServiceError

Reason notification is being discontinued.

Throws:
java.rmi.RemoteException

statusEnd

void statusEnd(java.lang.String correlator)
               throws java.rmi.RemoteException

The notifications have completed for this correlator. This operation will be invoked on the application when the duration or count for notifications have been completed. This operation will not be invoked in the case of an error ending the notifications or deliberate ending of the notifications (using the endNotification operation).

Parameters:
correlator - xsd:string

Correlator provided in request to set up this notification.

Throws:
java.rmi.RemoteException


Copyright © 2003 IBM Corp. All Rights Reserved.