Table of Contents Index NMS Glossary Previous Page Next Page (Page 7 of 11 in this chapter) Version

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

DWORD TCAPInitTrans ( U8 *pMessage,
TcapTransInfo *pTinfo,
TcapDlgSect *pDlgPart,
U16 userInfoLen,
U8 *pUserInfo )

pMessage 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 Address of the caller's TcapTransInfo buffer specifying the general characteristics of the transaction message.

pDlgPart Address of the caller's TcapDlgSect area where the ITU-92 dialog portion is defined (Optional).

pUserInfoLen Byte length of user data to be included in the message (Optional).

pUserInfo Address of the caller's user data to be included in the message.

Return Values

Details

After successful completion of this routine, the caller may then call TCAPAddComp one or more times to add components to the transaction message, if desired. The application must then call TCAPTransRqst to send the constructed message to the TCAP layer.

The structure of the transaction information block (pointed to in pTinfo) is defined in Appendix A.

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 Appendix A.

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.


Table of Contents Index NMS Glossary Previous Page Next Page (Page 7 of 11 in this chapter) Version

Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2002, NMS Communications Corporation. All rights reserved.