You are here: SwitchKit TCAP Interface User’s Guide > 6 SKTAL Parameter Classes > Class TCAP_Begin : public TCAP_Dialogue
Class TCAP_Begin : public TCAP_Dialogue
Purpose
The purpose of the TCAP_Begin message class is to define the interface for beginning TCAP transactions. The class implements TCPPT_TC_BEGIN (ITU) and TCPPT_TC_QUERY_W_PERM/TCPPT_TC_QUERY_WO_PERM (ANSI) dialogues. This message begins a communication session for remote operations. In ANSI, a Boolean may be passed to this Class Constructor. If this Boolean is true (default value), TC_QUERY_WITH_PERM is sent out, else TC_QUERY_WO_PERM.
The TCAP_Begin message class includes the following methods:
// Xcvr checks
virtual bool SendCheck() const;
virtual bool ReceiveCheck();
// Point code (orig)
void GetOPC(SKTAL_UINT& pointCode) const;
// Point code (dest)
void SetDPC(const SKTAL_UINT pointCode);
// Full SCCP Address (orig)
void SetOrigAddr(const bool isNational,
const SKTAL_UINT pointCode,
const SKTAL_OCTET ssn);
void SetOrigAddr(const SKTAL_OCTET addrInd,
const SKTAL_UINT pointCode,
const SKTAL_OCTET ssn,
const SKTAL_OCTET* gttInfo,
const SKTAL_USHORT gttLen);
void SetOrigAddr(const SCCP_Address& addr);
void GetOrigAddr(bool& isNational,
SKTAL_UINT& pointCode,
SKTAL_OCTET& ssn) const;
void GetOrigAddr(SKTAL_OCTET& addrInd,
SKTAL_UINT& pointCode,
SKTAL_OCTET& ssn,
SKTAL_OCTET* gttInfo,
SKTAL_USHORT* gttLen) const;
void GetOrigAddr(SCCP_Address& addr) const;
// Full SCCP Address (dest)
void SetDestAddr(const bool isNational,
const SKTAL_UINT pointCode,
const SKTAL_OCTET ssn);
void SetDestAddr(const SKTAL_OCTET addrInd,
const SKTAL_UINT pointCode,
const SKTAL_OCTET ssn,
const SKTAL_OCTET* gttInfo,
const SKTAL_USHORT gttLen);
void SetDestAddr(const SCCP_Address& addr);
void GetDestAddr(bool& isNational,
SKTAL_UINT& pointCode,
SKTAL_OCTET& ssn) const;
void GetDestAddr(SKTAL_OCTET& addrInd,
GetDestAddr(SCCP_Address& addr) const;
Syntax
See class TCAP_Dialogue
virtual bool SendCheck() const;
See class TCAP_Dialogue
Syntax
virtual bool ReceiveCheck();
Description
This method gets the OPC for this dialogue primitive from discrete information. OPC contained in MTP routing label is received from the CSP for TCAP BEGIN/QWP/QWOP messages as a optional parameter. OPC is included by the CSP, only if SCCP CGPA does not contain a point code.
Syntax
void GetOPC(SKTAL_UINT& pointCode) const;
void GetOPC(MTP3_POINT_CODE& pc) const;
void GetOPC(MTP3_PointCode& pc) const;
Input Parameters and Input/Output Parameters
None
Output Parameters
pointCode: the point code of this address
Return Value
None
Description
Sets the DPC for this dialogue primitive. This method sets the DPC in the routing label of outgoing TCAP BEGIN/QWP/QWOP messages. A DPC set using the SetDPC method will come into effect only if SCCP CDPA does not contain a point code.
Syntax
void SetDPC( const SKTAL_UINT pointCode);
Input Parameters
pointCode - the point code of this address
Input/Output Parameters and Output Parameters
None
See class TCAP_Unidirectional
Syntax
void SetOrigAddr(const bool isNational,
const SKTAL_UINT pointCode,
const SKTAL_OCTET ssn);
void SetOrigAddr(const SKTAL_OCTET addrInd,
const SKTAL_UINT pointCode,
const SKTAL_OCTET ssn,
const SKTAL_OCTET* gttInfo,
const SKTAL_USHORT gttLen);
void SetOrigAddr(const SCCP_Address& addr);
Syntax
See class TCAP_Unidirectional
void GetOrigAddr(bool& isNational,
SKTAL_UINT& pointCode,
SKTAL_OCTET& ssn) const;
void GetOrigAddr(SKTAL_OCTET& addrInd,
SKTAL_UINT& pointCode,
SKTAL_OCTET& ssn,
SKTAL_OCTET* gttInfo,
SKTAL_USHORT* gttLen) const;
void GetOrigAddr(SCCP_Address& addr) const;
See class TCAP_Unidirectional
Syntax
void SetDestAddr(const bool isNational,
const SKTAL_UINT pointCode,
const SKTAL_OCTET ssn);
void SetDestAddr(const SKTAL_OCTET addrInd,
const SKTAL_UINT pointCode,
const SKTAL_OCTET ssn,
const SKTAL_OCTET* gttInfo,
const SKTAL_USHORT gttLen);
void SetDestAddr(const SCCP_Address& addr);
Syntax
See class TCAP_Unidirectional
void GetDestAddr(bool& isNational,
SKTAL_UINT& pointCode,
SKTAL_OCTET& ssn) const;
void GetDestAddr(SKTAL_OCTET& addrInd,
SKTAL_UINT& pointCode,
SKTAL_OCTET& ssn,
SKTAL_OCTET* gttInfo,
SKTAL_USHORT* gttLen) const;
void GetDestAddr(SCCP_Address& addr) const;