(Page 8 of 14 in this chapter)
TCAPInitTrans
Description
- Initializes a new transaction message prior to adding components to the transaction message (with TCAPAddComp) and/or sending the transaction request (with TCAPTransRqst).
Prototype
- S16 TCAPInitTrans (U8 *pMessage,
- TcapTransInfo *pTinfo,
- TcapDlgSect *pDlgPart,
- U16 userInfoLen,
- U8 *pUserInfo )
- pMessage The address of the caller's message buffer, where the TCAP message will be constructed. This buffer must be at least TCAP_MSG_SIZE bytes long (currently 668).
- pTInfo The address of the caller's TcapTransInfo buffer specifying the general characteristics of the transaction message (message type, dialog ID(s), originating address, destination address). The structure of the transaction information block is defined in Section 3.2.6.
- pDlgPart (Optional) The address of the caller's TcapDlgSect area where the ITU-92 dialog portion is defined. The dialog portion is used only for the ITU-92 protocol variant. If no dialog portion is in the outgoing message desired (such as when using the ANSI protocol variant), then a NULL pointer should be passed here. The structure of the TcapDlgSect block is defined in Section 3.2.7.
- pUserInfoLen (Optional) The byte length of user data to be included in the message. The user data field is allowed only for the ITU-92 protocol variant. For other protocol variants, or if no user data is to be included, this parameter should be set to zero.
- pUserInfo The address of the caller's user data to be included in the message. The user data field is allowed only for the ITU-92 protocol variant. For other protocol variants, or if no user data is to be included, a NULL pointer should be passed for this parameter.
Return Values
Details
- After successful completion of this routine, the caller may then call the TCAPAddComp primitive one or more times to add components to the transaction message, if desired. The application must then call the TCAPTransRqst primitive to send the constructed message to the TCAP layer.
(Page 8 of 14 in this chapter)
tech_support@nmss.com
Copyright © 1999, Natural MicroSystems, Inc. All rights
reserved.