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.

Summary of Methods

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;

SendCheck()

Syntax

See class TCAP_Dialogue

virtual bool SendCheck() const;

ReceiveCheck()

See class TCAP_Dialogue

Syntax

virtual bool ReceiveCheck();

GetOPC()

Description

This method gets the OPC for this dialogue primitive from discrete information. OPC contained in MTP routing label is received from the Excel platform for TCAP BEGIN/QWP/QWOP messages as a optional parameter. OPC is included by the Excel platform, 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

SetDPC()

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

SetOrigAddr()

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);

GetOrigAddr()

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;

SetDestAddr()

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);

GetDestAddr()

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;