net.rim.device.api.io
Interface DatagramStatusListener


public interface DatagramStatusListener

Describes functionality that a datagram status listener must implement.

If you plan on using datagram status listeners then you should invoke DatagramConnectionBase.allocateDatagramId(javax.microedition.io.Datagram) and use this value when invoking DatagramBase.setDatagramId(int). This value will then be the datagram ID returned in the callback. Use it to determine what datagram the event is for.

Since:
BlackBerry API 4.0.0

Field Summary
static int ACKNOWLEDGED
          Datagram's receipt has been acknowleged.
static int CANCELLED
          Generic cancellation error.
static int COMP_ENCRYPT
          Datagram is currently being compressed/encrypted.
static int CPPDEV_BEGIN
          Lowest possible value for transmission errors specific to C++ devices.
static int CPPDEV_END
          Highest possible value for transmission errors specific to C++ devices.
static int CPPDEV_VALID_MASK
          Valid event mask.
static int DELIVERED
          Datagram has been delivered.
static int ERROR
          Generic error.
static int ERROR_APN
          Access point name error.
static int ERROR_CALL_BARRED
          SMS sending error: Call barred.
static int ERROR_CONGESTION
          SMS sending error: Congestion.
static int ERROR_DEST_OUT_OF_ORDER
          SMS sending error: Destination out of order.
static int ERROR_FACILITY_REJECTED
          SMS sending error: Facility not supported.
static int ERROR_FDN_FAILURE
          SMS sending error: FDN vailure.
static int ERROR_FLAG
          Some kind of error has occured.
static int ERROR_GENERAL
          SMS delivery error: general.
static int ERROR_IE_NONEXISTENT
          SMS sending error: Information element non-existant or not implemented.
static int ERROR_INTERWORKING_UNSPECIFIED
          SMS sending error: Unspecified interworking protocol type.
static int ERROR_INVALID_MANDATORY_INFO
          SMS sending error: Invalid mandatory information.
static int ERROR_INVALID_SC_ADDR
          SMS sending error: datagram has invalid SC address.
static int ERROR_INVALID_SM_TRANSFER_VALUE
          SMS sending error: Invalid short message transfer value.
static int ERROR_MAX_ATTEMPTS
          MDP error: maximum number of attempts reached.
static int ERROR_MES_FAILED
          SMS sending error: Mobile Equipment Status failed
static int ERROR_MES_NOT_COMPATABLE_WITH_PROT_STAT
          SMS sending error: ME incompatible with protocol state.
static int ERROR_MSG_TYPE_NOT_IMPLEMENTED
          SMS sending error: Message type non-existant or not implemented.
static int ERROR_NETWORK
          SMS delivery error: network failure.
static int ERROR_NETWORK_FAILURE
          SMS sending error: Network failure.
static int ERROR_NETWORK_OUT_OF_ORDER
          SMS sending error: Network out of order.
static int ERROR_OPER_DETERM_BARRING
          SMS sending error: Operator determined barring.
static int ERROR_ORIG_DENIED
          SMS delivery error: originator denied.
static int ERROR_PACKET_ADDRESS
          Packet addressing error.
static int ERROR_PACKET_CONGESTED
          Congested packet error.
static int ERROR_PACKET_EXPIRED
          Expired packet error.
static int ERROR_PACKET_FAILURE
          Failed packet error.
static int ERROR_PACKET_FATAL
          Fatal packet error.
static int ERROR_PACKET_FORMAT
          Packet formatting error.
static int ERROR_PACKET_RESEND_LATER
          Resend packet later error.
static int ERROR_PACKET_RETURNED
          Packet returned error.
static int ERROR_PERMANENT_FAILURE
          SMS sending error: Mobile Class 3 - Permanent Failure
static int ERROR_PORT_REG
          Port registration error.
static int ERROR_PROTOCOL_ERROR
          SMS sending error: Protocol error.
static int ERROR_PS_ERROR
          SMS sending error: Protocol Stack Error
static int ERROR_RADIO_SEND
          Radio sending error.
static int ERROR_REFUSED
          MDP error: datagram refused.
static int ERROR_REQUESTED_FACILITY_NOT_IMPLEMENTED
          SMS sending error: Requested facility not implemented.
static int ERROR_REQUESTED_FACILITY_NOT_SUBSCRIBED
          SMS sending error: Requested facility not subscribed to.
static int ERROR_RESOURCE_UNAVAILABLE
          SMS sending error: Resource unavailable.
static int ERROR_SEMANTICALLY_INCORRECT_MES
          SMS sending error: Semantically incorrect message.
static int ERROR_SERVICE_NOT_AVAILABLE
          SMS delivery error: Service not available.
static int ERROR_SERVICE_NOT_SUBSCRIBED
          SMS sending error: Service not subscribed.
static int ERROR_SERV_OPT_NOT_SUPPORTED
          SMS sending error: Service option not supported.
static int ERROR_SERV_OPT_TEMP_OUT_OF_ORDER
          SMS sending error: Service option temporarily out of order.
static int ERROR_SHORT_MES_TRANSFER_REJECTED
          SMS sending error: Short message transfer from ME rejected.
static int ERROR_STK_SMS_CONTROL_NOT_ALLOWED
          SMS sending error: SIM Toolkit control failure.
static int ERROR_TEMP_FAILURE
          SMS sending error: Temporary failure.
static int ERROR_TERM_DENIED
          SMS delivery error: terminator denied.
static int ERROR_TOO_LONG
          SMS delivery error: datagram too long.
static int ERROR_TRANSMITTER
          Transmitter error.
static int ERROR_UNASSIGNED_NUMBER
          SMS sending error: Unassigned (unallocated) number.
static int ERROR_UNIDENTIFIED_SUBSCRIBER
          SMS sending error: Unidentified subscriber.
static int ERROR_UNKNOWN_DEST
          SMS delivery error: datagram has unkown destination.
static int ERROR_UNKNOWN_SUBSCRIBER
          SMS sending error: Unknown subscriber.
static int ERROR_UNSUPPORTED
          SMS delivery error: service not supported.
static int ERROR_VERSION
          MDP error: bad version.
static int FETCHING_KEY
          Compressor/encryptor is currently fetching key.
static int GME_COMP_ALG_UNDECIDED
          GME error: compression algorithm undecided.
static int GME_ENCRYPT_ALG_UNDECIDED
          GME error: encryption algorithm undecided.
static int GME_ENCRYPT_COMP_FAILURE
          GME error: encryption/compression failure.
static int GME_MALFORMED_ADDRESS
          GME error: malformed address.
static int GME_MISMATCHED_DACS
          GME error: mismatched DACs.
static int GME_NO_COMP_MODE_AVAILABLE
          GME error: no compression mode available.
static int GME_NO_CRYPTO_MODE_AVAILABLE
          GME error: no cryptography mode available.
static int GME_NO_DAC_FOUND
          GME error: no DAC found.
static int GME_NO_ROUTING_INFORMATION
          GME error: no routing information.
static int GME_NO_SERVICE_DEFINED
          GME error: no service defined.
static int GME_ROUTE_FAILURE
          GME error: failure to be sent due to connection loss.
static int GME_SERVICE_DISABLED
          GME error: service disabled.
static int GME_TERROR_BAD_GME_FORMAT
          GME transaction error: bad GME format.
static int GME_TERROR_DECRYPTION_ERROR
          GME transaction error: decryption error.
static int GME_TERROR_FAILURE_AT_SERVICE
          GME transaction error: failure at service.
static int GME_TERROR_GENERAL_FAILURE
          GME transaction error: general failure.
static int GME_TERROR_INVALID_SERVICE_IDENTIFIER
          GME transaction error: invalid service identifier.
static int GME_TERROR_RESERVED
          GME transaction error: reserved.
static int GME_TERROR_TIMEOUT
          GME transaction error: timeout.
static int GME_TERROR_UNHANDLED_GME_CMD
          GME transaction error: unhandled GME command.
static int GME_UNKNOWN_DESTINATION
          GME error: unknown desintation.
static long GUID_GME_CRYPTO_FAILURE
          The GUID for the global event when GME is unable to decrypt a packet (for whatever reason).
static int IPPP_RECEIVED_CLOSED
          IPPP event: received and closed.
static int IPPP_RECEIVED_CLOSING
          IPPP event: received and closing.
static int IPPP_RECEIVED_DATA
          IPPP event: received data.
static int IPPP_RECEIVED_ERROR
          IPPP event: reception error.
static int MAILBOXED
          Datagram has been mailboxed.
static int NO_ERROR
          No error.
static int PENDING
          Datagram is pending transmission.
static int SENDING
          Datagram is currently transmitting.
static int SENT
          Datagram sent.
static int SENTINEL
          Sentinel value (should never actually be passed as an event).
 
Method Summary
 void updateDatagramStatus(int dgId, int code, Object context)
          Invoked when a datagram's status changes.
 



Field Detail

GUID_GME_CRYPTO_FAILURE

static final long GUID_GME_CRYPTO_FAILURE
The GUID for the global event when GME is unable to decrypt a packet (for whatever reason).

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

SENTINEL

static final int SENTINEL
Sentinel value (should never actually be passed as an event).

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

SENT

static final int SENT
Datagram sent.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

PENDING

static final int PENDING
Datagram is pending transmission.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

SENDING

static final int SENDING
Datagram is currently transmitting.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

COMP_ENCRYPT

static final int COMP_ENCRYPT
Datagram is currently being compressed/encrypted.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

FETCHING_KEY

static final int FETCHING_KEY
Compressor/encryptor is currently fetching key.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

DELIVERED

static final int DELIVERED
Datagram has been delivered.

Note: The DELIVERED event code has a context object. The context object is an array of Strings. Each String will be a destination address that has confirmed delivery of the datagram. If an address is not listed, that address has not confirmed delivery.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ACKNOWLEDGED

static final int ACKNOWLEDGED
Datagram's receipt has been acknowleged.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

MAILBOXED

static final int MAILBOXED
Datagram has been mailboxed.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

NO_ERROR

static final int NO_ERROR
No error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_FLAG

static final int ERROR_FLAG
Some kind of error has occured.

This flag is ORed with another value indicating the precise error that occured.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR

static final int ERROR
Generic error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

CANCELLED

static final int CANCELLED
Generic cancellation error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_PACKET_FATAL

static final int ERROR_PACKET_FATAL
Fatal packet error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_PACKET_FORMAT

static final int ERROR_PACKET_FORMAT
Packet formatting error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_RADIO_SEND

static final int ERROR_RADIO_SEND
Radio sending error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_APN

static final int ERROR_APN
Access point name error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_TRANSMITTER

static final int ERROR_TRANSMITTER
Transmitter error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_PORT_REG

static final int ERROR_PORT_REG
Port registration error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_PACKET_ADDRESS

static final int ERROR_PACKET_ADDRESS
Packet addressing error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_PACKET_CONGESTED

static final int ERROR_PACKET_CONGESTED
Congested packet error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_PACKET_EXPIRED

static final int ERROR_PACKET_EXPIRED
Expired packet error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_PACKET_FAILURE

static final int ERROR_PACKET_FAILURE
Failed packet error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_PACKET_RESEND_LATER

static final int ERROR_PACKET_RESEND_LATER
Resend packet later error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_PACKET_RETURNED

static final int ERROR_PACKET_RETURNED
Packet returned error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_NETWORK

static final int ERROR_NETWORK
SMS delivery error: network failure.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_GENERAL

static final int ERROR_GENERAL
SMS delivery error: general.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_ORIG_DENIED

static final int ERROR_ORIG_DENIED
SMS delivery error: originator denied.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_TERM_DENIED

static final int ERROR_TERM_DENIED
SMS delivery error: terminator denied.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_UNSUPPORTED

static final int ERROR_UNSUPPORTED
SMS delivery error: service not supported.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_TOO_LONG

static final int ERROR_TOO_LONG
SMS delivery error: datagram too long.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_UNKNOWN_DEST

static final int ERROR_UNKNOWN_DEST
SMS delivery error: datagram has unkown destination.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_SERVICE_NOT_AVAILABLE

static final int ERROR_SERVICE_NOT_AVAILABLE
SMS delivery error: Service not available.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_INVALID_SC_ADDR

static final int ERROR_INVALID_SC_ADDR
SMS sending error: datagram has invalid SC address.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_FDN_FAILURE

static final int ERROR_FDN_FAILURE
SMS sending error: FDN vailure.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_SERVICE_NOT_SUBSCRIBED

static final int ERROR_SERVICE_NOT_SUBSCRIBED
SMS sending error: Service not subscribed.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_SHORT_MES_TRANSFER_REJECTED

static final int ERROR_SHORT_MES_TRANSFER_REJECTED
SMS sending error: Short message transfer from ME rejected.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_UNIDENTIFIED_SUBSCRIBER

static final int ERROR_UNIDENTIFIED_SUBSCRIBER
SMS sending error: Unidentified subscriber.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_FACILITY_REJECTED

static final int ERROR_FACILITY_REJECTED
SMS sending error: Facility not supported.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_UNKNOWN_SUBSCRIBER

static final int ERROR_UNKNOWN_SUBSCRIBER
SMS sending error: Unknown subscriber.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_REQUESTED_FACILITY_NOT_SUBSCRIBED

static final int ERROR_REQUESTED_FACILITY_NOT_SUBSCRIBED
SMS sending error: Requested facility not subscribed to.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_REQUESTED_FACILITY_NOT_IMPLEMENTED

static final int ERROR_REQUESTED_FACILITY_NOT_IMPLEMENTED
SMS sending error: Requested facility not implemented.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_MES_NOT_COMPATABLE_WITH_PROT_STAT

static final int ERROR_MES_NOT_COMPATABLE_WITH_PROT_STAT
SMS sending error: ME incompatible with protocol state.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_INVALID_SM_TRANSFER_VALUE

static final int ERROR_INVALID_SM_TRANSFER_VALUE
SMS sending error: Invalid short message transfer value.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_NETWORK_OUT_OF_ORDER

static final int ERROR_NETWORK_OUT_OF_ORDER
SMS sending error: Network out of order.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_TEMP_FAILURE

static final int ERROR_TEMP_FAILURE
SMS sending error: Temporary failure.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_CONGESTION

static final int ERROR_CONGESTION
SMS sending error: Congestion.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_RESOURCE_UNAVAILABLE

static final int ERROR_RESOURCE_UNAVAILABLE
SMS sending error: Resource unavailable.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_SEMANTICALLY_INCORRECT_MES

static final int ERROR_SEMANTICALLY_INCORRECT_MES
SMS sending error: Semantically incorrect message.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_INTERWORKING_UNSPECIFIED

static final int ERROR_INTERWORKING_UNSPECIFIED
SMS sending error: Unspecified interworking protocol type.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_PROTOCOL_ERROR

static final int ERROR_PROTOCOL_ERROR
SMS sending error: Protocol error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_UNASSIGNED_NUMBER

static final int ERROR_UNASSIGNED_NUMBER
SMS sending error: Unassigned (unallocated) number.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_OPER_DETERM_BARRING

static final int ERROR_OPER_DETERM_BARRING
SMS sending error: Operator determined barring.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_CALL_BARRED

static final int ERROR_CALL_BARRED
SMS sending error: Call barred.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_DEST_OUT_OF_ORDER

static final int ERROR_DEST_OUT_OF_ORDER
SMS sending error: Destination out of order.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_INVALID_MANDATORY_INFO

static final int ERROR_INVALID_MANDATORY_INFO
SMS sending error: Invalid mandatory information.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_MSG_TYPE_NOT_IMPLEMENTED

static final int ERROR_MSG_TYPE_NOT_IMPLEMENTED
SMS sending error: Message type non-existant or not implemented.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_IE_NONEXISTENT

static final int ERROR_IE_NONEXISTENT
SMS sending error: Information element non-existant or not implemented.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_SERV_OPT_NOT_SUPPORTED

static final int ERROR_SERV_OPT_NOT_SUPPORTED
SMS sending error: Service option not supported.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_SERV_OPT_TEMP_OUT_OF_ORDER

static final int ERROR_SERV_OPT_TEMP_OUT_OF_ORDER
SMS sending error: Service option temporarily out of order.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_NETWORK_FAILURE

static final int ERROR_NETWORK_FAILURE
SMS sending error: Network failure.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.2

ERROR_STK_SMS_CONTROL_NOT_ALLOWED

static final int ERROR_STK_SMS_CONTROL_NOT_ALLOWED
SMS sending error: SIM Toolkit control failure.

See Also:
Constant Field Values
Since:
BlackBerry API 4.2.1

ERROR_PS_ERROR

static final int ERROR_PS_ERROR
SMS sending error: Protocol Stack Error

See Also:
Constant Field Values
Since:
BlackBerry API 4.5.0

ERROR_MES_FAILED

static final int ERROR_MES_FAILED
SMS sending error: Mobile Equipment Status failed

See Also:
Constant Field Values
Since:
BlackBerry API 4.5.0

ERROR_PERMANENT_FAILURE

static final int ERROR_PERMANENT_FAILURE
SMS sending error: Mobile Class 3 - Permanent Failure

See Also:
Constant Field Values
Since:
BlackBerry API 5.0.0

ERROR_MAX_ATTEMPTS

static final int ERROR_MAX_ATTEMPTS
MDP error: maximum number of attempts reached.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_REFUSED

static final int ERROR_REFUSED
MDP error: datagram refused.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

ERROR_VERSION

static final int ERROR_VERSION
MDP error: bad version.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_MALFORMED_ADDRESS

static final int GME_MALFORMED_ADDRESS
GME error: malformed address.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_NO_ROUTING_INFORMATION

static final int GME_NO_ROUTING_INFORMATION
GME error: no routing information.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_SERVICE_DISABLED

static final int GME_SERVICE_DISABLED
GME error: service disabled.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_MISMATCHED_DACS

static final int GME_MISMATCHED_DACS
GME error: mismatched DACs.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_NO_SERVICE_DEFINED

static final int GME_NO_SERVICE_DEFINED
GME error: no service defined.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_UNKNOWN_DESTINATION

static final int GME_UNKNOWN_DESTINATION
GME error: unknown desintation.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_NO_COMP_MODE_AVAILABLE

static final int GME_NO_COMP_MODE_AVAILABLE
GME error: no compression mode available.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_NO_CRYPTO_MODE_AVAILABLE

static final int GME_NO_CRYPTO_MODE_AVAILABLE
GME error: no cryptography mode available.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_NO_DAC_FOUND

static final int GME_NO_DAC_FOUND
GME error: no DAC found.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_ENCRYPT_ALG_UNDECIDED

static final int GME_ENCRYPT_ALG_UNDECIDED
GME error: encryption algorithm undecided.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_COMP_ALG_UNDECIDED

static final int GME_COMP_ALG_UNDECIDED
GME error: compression algorithm undecided.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_ENCRYPT_COMP_FAILURE

static final int GME_ENCRYPT_COMP_FAILURE
GME error: encryption/compression failure.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_ROUTE_FAILURE

static final int GME_ROUTE_FAILURE
GME error: failure to be sent due to connection loss.

See Also:
Constant Field Values
Since:
BlackBerry API 4.3.0

GME_TERROR_RESERVED

static final int GME_TERROR_RESERVED
GME transaction error: reserved. This error may pass up a String object for context containing a human readable description of the failure.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_TERROR_FAILURE_AT_SERVICE

static final int GME_TERROR_FAILURE_AT_SERVICE
GME transaction error: failure at service. This error may pass up a String object for context containing a human readable description of the failure.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_TERROR_UNHANDLED_GME_CMD

static final int GME_TERROR_UNHANDLED_GME_CMD
GME transaction error: unhandled GME command. This error may pass up a String object for context containing a human readable description of the failure.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_TERROR_BAD_GME_FORMAT

static final int GME_TERROR_BAD_GME_FORMAT
GME transaction error: bad GME format. This error may pass up a String object for context containing a human readable description of the failure.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_TERROR_TIMEOUT

static final int GME_TERROR_TIMEOUT
GME transaction error: timeout. This error may pass up a String object for context containing a human readable description of the failure.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_TERROR_INVALID_SERVICE_IDENTIFIER

static final int GME_TERROR_INVALID_SERVICE_IDENTIFIER
GME transaction error: invalid service identifier. This error may pass up a String object for context containing a human readable description of the failure.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_TERROR_DECRYPTION_ERROR

static final int GME_TERROR_DECRYPTION_ERROR
GME transaction error: decryption error. This error may pass up a String object for context containing a human readable description of the failure.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

GME_TERROR_GENERAL_FAILURE

static final int GME_TERROR_GENERAL_FAILURE
GME transaction error: general failure. This error may pass up a String object for context containing a human readable description of the failure.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

IPPP_RECEIVED_DATA

static final int IPPP_RECEIVED_DATA
IPPP event: received data.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

IPPP_RECEIVED_CLOSING

static final int IPPP_RECEIVED_CLOSING
IPPP event: received and closing.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

IPPP_RECEIVED_CLOSED

static final int IPPP_RECEIVED_CLOSED
IPPP event: received and closed.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

IPPP_RECEIVED_ERROR

static final int IPPP_RECEIVED_ERROR
IPPP event: reception error.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

CPPDEV_BEGIN

static final int CPPDEV_BEGIN
Lowest possible value for transmission errors specific to C++ devices.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

CPPDEV_END

static final int CPPDEV_END
Highest possible value for transmission errors specific to C++ devices.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0

CPPDEV_VALID_MASK

static final int CPPDEV_VALID_MASK
Valid event mask.

Mask for removing garbage data in top byte after ERROR_FLAG is found not to be one.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0


Method Detail

updateDatagramStatus

void updateDatagramStatus(int dgId,
                          int code,
                          Object context)
Invoked when a datagram's status changes.

Parameters:
dgId - The ID of the datagram.
code - an integer that represents the new status value
context - Some kind of context object (may be null). Depends on the event code received
Since:
BlackBerry API 4.0.0





Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.