Holds the transaction-level information regarding an outgoing transaction request or an incoming transaction message:
typedef struct Tcap_Trans_Info
{
U8 msgType; /* transaction message/package type */
U8 abortCause; /* cause of an abort by TCAP layer, valid
* only if msgType is TCAP_ANSI_PABORT or
* TCAP_P_ABORT */
U8 preArgEnd; /* pre-arranged end? 0=no, 1=yes */
U8 chkpt; /* Checkpoint behavior */
U16 inactvTimer; /* Inactivity timer */
U16 spare1; /* spare for alignment */
U32 suDlgId; /* service user dialog ID */
U32 spDlgId; /* service provider (TCAP) dialog ID */
TcapSpAddr cdAddr; /* called party address */
TcapSpAddr cgAddr; /* calling party address */
TcapSccpQos qos; /* SCCP quality of service requested */
} TcapTransInfo;
The fields in the TcapTransInfo structure are encoded as follows:
Field |
Value |
msgType |
The message type identifies the TCAP transaction message that is sent or received: 1 = TCAP_BEGIN ITU-T begin message 2 = TCAP_CONTINUE ITU-T continue message 3 = TCAP_END ITU-T end message 4 = TCAP_U_ABORT ITU-T user abort message 5 = TCAP_UNI ITU-T unidirectional 6 = TCAP_QRY_PRM ANSI query with permission message 7 = TCAP_QRY_NO_PRM ANSI query without permission message 8 = TCAP_RESPONSE ANSI response message 9 = TCAP_CNV_PRM ANSI conversation with permission message 10 = TCAP_CNV_NO_PRM ANSI conversation without permission message 11 = TCAP_ANSI_UABORT TCAP ANSI user abort message 12 = TCAP_ANSI_PABORT TCAP ANSI protocol abort message 13 = TCAP_P_ABORT CCITT protocol abort message 14 = TCAP_ANSI_UNI ANSI unidirectional 15 = TCAP_LOC_IND Locally-generated comp. indication 16 = TCAP_XACTION_TIMEOUT Locally generated transaction time-out indication |
abortCause |
Identifies the cause of an abort initiated by the TCAP layer. Its value is valid only on incoming messages when the msgType field is TCAP_ANSI_PABORT or TCAP_P_ABORT. P-Abort ITU-T causes 0x00 = TCAP_ABORT_UNREC_MSG Unrecognized message 0x01 = TCAP_ABORT_UNREC_TRS Unrecognized transaction ID 0x02 = TCAP_ABORT_BAD_FRMT Malformed trans. part 0x03 = TCAP_ABORT_INC_TRANS Incorrect trans. part 0x04 = TCAP_ABORT_RESOURCE Insufficient resources 0x05 = TCAP_ABORT_ABNML_DLG Incorrect dialog portion 0x06 = TCAP_ABORT_NO_CMN_DLG Unsupported protocol version dialog portion P-Abort ANSI causes 0x01 = TCAP_ANSI_ABORT_UP Unrecognized package type 0x02 = TCAP_ANSI_ABORT_IN Incorrect transaction portion 0x03 = TCAP_ANSI_ABORT_BD Badly structured transaction portion 0x04 = TCAP_ANSI_ABORT_UT Unrecognized transaction ID 0x05 = TCAP_ANSI_ABORT_PR Permission to release problem 0x06 = TCAP_ANSI_ABORT_RN Resource not available |
chkpt |
If redundant TCAP is in use, this field determines the checkpoint behavior of a transaction. The default checkpoint behavior is defined in the TCAP configuration file. 0 = TCAP_NO_CHKPT Do not checkpoint this transaction 1 = TCAP_CHKPT Checkpoint this transaction 2 = TCAP_CHKPT_DEFAULT Use the default checkpoint value |
inactv Timer |
Determines the setting (in seconds) for the inactivity timer for the transaction. If set to 0 (zero), the transaction uses the default inactivity timer. |
suDlgId |
Service user dialog ID assigned by the application for this transaction. This value must be unique among all active transactions belonging to this TCAP SAP. |
spDlgId |
Provider dialog ID assigned by the TCAP layer for this transaction. On transactions initiated by the application, this value must be set to zero on any outgoing request sent before the first incoming transaction message is received. The first incoming message for any transaction (initiated by either end) contains the spDlgId assigned by the TCAP layer. The application should save this value to be used with subsequent requests belonging to the same transaction. |
cdAddr |
Destination address of a transaction message. |
cgAddr |
Originating address of a transaction message. |
qos |
Quality of service requested from the SCCP. |
preArgEnd |
Set to 1 if the transaction end is pre-arranged. When a transaction end is pre-arranged, there is no explicit transaction end message exchanged between the two signaling points. The transaction is cleared locally by the TCAP layer and the far signaling point is expected to do the same. If this field is set to 0 (zero), a normal transaction end is performed. |