- This routine must be called periodically to process incoming messages. This can be done using a polling process or used in conjunction with MTP3SyncObj and operating system specific mechanisms to retrieve a message only when notification has indicated that one is available.
Note: The size of the buffer identified in the pMsgInd field must be large enough to contain a data indication.
- Data Indication
- This structure will be received by an application, via the MTP3RetrieveMessage function, when data matching the application's service information octet is received from a remote signaling point.
typedef struct data_ind_s
U8 code; /* MTP3_DATA_IND (0x1A) */
U16 suId; /* Service User Id from bind request */
U32 opc; /* Originating Point Code */
U32 dpc; /* Destination Point Code */
U8 srvInfo; /* Service information octet */
U8 lnkSel; /* Link selector field */
U8 data[MAXDATA] /* Received data packet */
DATA_IND;
- Status Indication
- This structure will be received by an application, via the MTP3RetrieveMessage function, when an important status change occurs on a circuit matching the application's service information octet. These are generated by the local MTP 3 layer. Refer to Section 2.11, Status Indications, for detailed information about each possible status indication.
typedef struct stat_ind_s {
U8 code; /* MTP3_STAT_IND (0x7A) */
U16 suId; /* Service user Id from bind request */
U32 pc; /* Point Code related to the status ind */
S16 status; /* Status indicator. See defines above */
U8 priority; /* Priority of this status indication */
} STAT_IND;
- Extended Status Indication
- If the application has registered to receive extended status indications, the following structure will be received by an application, via the MTP3RetrieveMessage
function, when an important status change occurs on a link. These indications are generated by the local MTP 3 layer. Refer to Section 2.12, Extended Status Indications, for detailed information concerning each possible extended status indication.
type def struct xstat_ind_s {
U8 code; /* MTP3_XSTAT_IND (0x3A) */
U16 suId; /* Service User identifier */
U16 status; /* Extended Status Type */
U16 link; /* Affected MTP3 link */
U16 spare1; /* Reserved for future use */
U16 spare2; /* Reserved for future use */
} XSTAT_IND;
- Bind Confirm
- A bind confirm is received in response to a previous bind request to MTP 3. The following structure shows the fields in a bind request:
typedef struct bind_cfm_s {
U8 code; /* bind request packet type 0x04 */
S16 suId; /* Service user ID from bind request */
S16 sapId; /* SAP identifier from bind request */
} BIND_CFM
(Page 6 of 9 in this chapter) Version