You are here: SwitchKit® Development Environment - 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.

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

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;

See Transaction Capability Application Part.
International Telecommunications Union (UN)
American National Standards Institute. ANSI administers and coordinates the U.S. voluntary standardization and conformity assessment system for the
telecommunications industry. More details on these standards may be
viewed at www.ansi.org.
A sequence of eight bits.
See Message Transfer Part.
Message Transfer Part level 3 - network level
Destination Point Code