Predefined message properties

Some message properties have been predefined for your convenience. Predefined properties can be read but should not be set. The predefined message properties are:

  • ias_Adapters   For network status notification messages, a list of network adapters that can be used to connect to the MobiLink server. The list is a string and is delimited by a vertical bar.

  • ias_DeliveryCount   Int. The number of attempts that have been made so far to deliver the message.

  • ias_MessageType   Int. Indicates the type of the message. The message types can be:

    Value Message type Description

    0

    REGULAR

    If a message does not have the ias_MessageType property set, it is a regular message.

    13

    PUSH_NOTIFICATION

    When a push notification is received from the server, a message of type PUSH_NOTIFICATION is sent to the system queue. See Notifications of push notification.

    14

    NETWORK_STATUS_NOTIFICATION

    When there is a change in network status, a message of this type is sent to the system queue. See Network status notifications.

  • ias_RASNames   String. For network status notification messages, a list of RAS entry names that can be used to connect to the MobiLink server. The list is delimited by a vertical bar.

  • ias_NetworkStatus   Int. For network status notification messages, the state of the network connection. The value is 1 if connected, 0 otherwise.

  • ias_Originator   String. The message store ID of the originator of the message.

  • ias_Status   Int. The current status of the message. This property is not supported in the SQL API. The values can be:

    Status Code Description
    1 Pending - The message has been sent but not received.
    10 Receiving - The message is in the process of being received, or it was received but not acknowledged.
    20 Final - The message has achieved a final state.
    30 Expired - The message was not received before its expiration time has passed.
    40 Cancelled - The message has been canceled.
    50 Unreceivable - The message is either malformed, or there were too many failed attempts to deliver it.
    60 Received - The message has been received and acknowledged.

    There are constants for the status values. See:

  • ias_StatusTime   The time at which the message became its current status. It is in units that are natural for the platform. It is a local time. In the C++ API, for Windows and PocketPC platforms, the timestamp is the SYSTEMTIME, converted to a FILETIME, which is copied to a qa_long value. This property is not supported in the SQL API.

    API This property returns...
    .NET DateTime
    C++ string
    Java java.util.Date object

 Message property constants