TCAP transaction information structure

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.