ISDN GTD for Setup Message - cisco.com GTD for Setup Message...

26
ISDN GTD for Setup Message This chapter describes how to implement the ISDN Generic Transparency Descriptor (GTD) for Setup Message feature. The feature provides support for mapping ISDN information elements (IEs) to corresponding GTD parameters. The following IEs and parameters are supported: Originating line information (OLI) Bearer capability (USI and TMR) called-party number (CPN) Calling-party number (CGN) Redirecting number (RGN, OCN and RNI) This feature allows VoIP service providers to develop custom call treatments and enhanced service offerings based on call origination and to correctly identify the source of a call, bill appropriately, and settle accurately with other network providers. Feature History for ISDN GTD for Setup Message Modification Release This feature was introduced. 12.2(15)T Finding Feature Information, page 2 Prerequisites for Configuring ISDN GTD for Setup Message, page 2 Restrictions for Configuring ISDN GTD for Setup Message, page 2 Information About ISDN GTD for Setup Message, page 2 How to Configure ISDN GTD for Setup Message, page 17 Configuration Examples for ISDN Generic Transparency Descriptor (GTD) for Setup Message, page 22 Additional References, page 25 ISDN Voice Configuration Guide, Cisco IOS Release 15M&T 1

Transcript of ISDN GTD for Setup Message - cisco.com GTD for Setup Message...

Page 1: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

ISDN GTD for Setup Message

This chapter describes how to implement the ISDN Generic Transparency Descriptor (GTD) for SetupMessage feature. The feature provides support for mapping ISDN information elements (IEs) to correspondingGTD parameters. The following IEs and parameters are supported:

• Originating line information (OLI)

• Bearer capability (USI and TMR) called-party number (CPN)

• Calling-party number (CGN)

• Redirecting number (RGN, OCN and RNI)

This feature allows VoIP service providers to develop custom call treatments and enhanced service offeringsbased on call origination and to correctly identify the source of a call, bill appropriately, and settle accuratelywith other network providers.

Feature History for ISDN GTD for Setup Message

ModificationRelease

This feature was introduced.12.2(15)T

• Finding Feature Information, page 2

• Prerequisites for Configuring ISDN GTD for Setup Message, page 2

• Restrictions for Configuring ISDN GTD for Setup Message, page 2

• Information About ISDN GTD for Setup Message, page 2

• How to Configure ISDN GTD for Setup Message, page 17

• Configuration Examples for ISDN Generic Transparency Descriptor (GTD) for Setup Message, page22

• Additional References, page 25

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T 1

Page 2: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

Finding Feature InformationYour software release may not support all the features documented in this module. For the latest caveats andfeature information, see Bug Search Tool and the release notes for your platform and software release. Tofind information about the features documented in this module, and to see a list of the releases in which eachfeature is supported, see the feature information table at the end of this module.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support.To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

Prerequisites for Configuring ISDN GTD for Setup Message• Perform the prerequisites that are listed in the "Prerequisites for Configuring an ISDN Voice Interface"section.

• Configure your VoIP network and Cisco IOS gateways to allow sending and processing of ISDN Q.931setup messages.

Restrictions for Configuring ISDN GTD for Setup MessageRestrictions are described in the Restrictions for Configuring ISDN Voice Interfaces section. In addition, thefollowing applies:

• This feature does not support ISDN BRI calls.

Information About ISDN GTD for Setup Message

General information about ISDN voice interfaces is presented in the "Information About ISDN VoiceInterfaces" section.

Note

Feature Design of ISDN GTD for Setup MessagesThe ISDN GTD for Setup Messages feature allows the delivery of information elements present in ISDNsetup messages to Tool Command Language (Tcl) scripts, RADIUS accounting servers, and routing serversin VoIP networks. This allows Tcl scripts and routing servers to access ISDN signaling information to provideenhanced features and routing services. In particular, the OLI IE present in AT&T (TR-41459 ISDN PRI UNISpecification) and MCI setup messages can be passed to the originating-line-info VSA in RADIUSstart-accounting messages to identify the originating caller.

FCC regulations mandate that pay-telephone operators be compensated by network operators for 1-800 callsmade from their pay telephones. Before implementation of this feature, network operators had no way toidentify calls made from their pay telephones. As a result, network operators had to compensate pay-telephoneoperators directly from their own revenues. In addition, network operators had no billing records to validate

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T2

ISDN GTD for Setup MessageFinding Feature Information

Page 3: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

pay-telephone operators’ settlement requests to prevent fraud. This feature provides Cisco network operatorswith the ability to correctly identify the source of a call. It allows networks to do the following:

• Extract originating-line information (OLI) to identify pay telephone calls and pass on applicable charges

• Generate billing records that can be used to validate pay telephone operator settlement requests.

For information on accounting records and RADIUS billing, see the RADIUSVSAVoice ImplementationGuide.

Note

This feature provides the flexibility to identify other types of originated calls (from prisons, hotels, and soforth) and allows you to use the Tcl interface to define custom services for these types of calls.

For more information on Tcl application programming, see the Tcl IVR API Version 2.0 Programmer'sGuide.

Note

In addition to passing OLI, this feature supports GTD mapping for Bearer Capability, Called Party Number,Calling Party Number, and Redirecting Number IEs.

Cisco implements this feature on Cisco IOS gateways by providing amechanism to allow creating and passingthe Q931 setup message and its parameters in a GTD format. The setup message, received by the gateway toinitiate call establishment, is mapped to the GTD initial address message (IAM). Generic transparencydescriptors represent parameters within signaling messages and enable transport of signaling data in a standardformat across network components and applications. The GTD mechanism allows them to share signalingdata and achieve interworking between different signaling types. This feature supports only ISDN PRI andnon-facility associated signaling (NFAS) calls.

Mapping of ISDN Information Elements to GTD ParametersISDN messages, used to signal call control, are composed of information elements and follow the formatspecified in ITU-T Q.931. This feature supports only the mapping of Q931 setup messages to GTD IAMmessages. This section defines the mapping of ISDN information elements to GTD parameters. Parametersare referred to by both parameter name and three-character GTD code.

The table below defines the mapping of ISDN IEs to GTD parameters. The GTD mechanism also passes thefollowing parameters for which there are no corresponding ISDN IEs:

• Calling-party category (CPC)

• Forward-call indicators (FCI)

• Protocol name (PRN)

Table 1: ISDN IEs Mapped to GTD Parameters

GTD ParameterISDN Information Element

USI (user-service information), TMR(transmission-medium requirements)

Bearer Capability

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T 3

ISDN GTD for Setup MessageMapping of ISDN Information Elements to GTD Parameters

Page 4: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

GTD ParameterISDN Information Element

CPN (called party number)Called Party Number

CGN (calling-party number)Calling Party Number

OLI (originating-line information)Originating Line Info

RGN (redirecting number), OCN (original callednumber), RNI (redirection information)

Redirecting Number

GTD mapping allows up to two redirecting number (original called number) IEs per call as follows:

• If only one IE is present in the incoming setup message, then both RGN and OCN parameters are builtby the ISDN stack and the RGN and OCN parameters contain the same values. Both the redirectionreason (rr) field and original redirection reason (orr) field in the GTD RNI parameter contain theredirection reason indicated in the IE.

• If two IEs are present, then OCN contains information specified in the first IE and RGN containsinformation for the second IE. RNI contains redirection reasons. The GTD orr field indicates theredirection reason of the first IE and the GTD rr field indicates that of the second IE.

Mapping for CPN CGN and RGNThis section defines mapping for fields and values common to the called party number (CPN), calling partynumber (CGN), and redirecting information (RGN) GTD parameters carried in the GTD IAM message.

The table below defines mapping for ISDN type of number fields to GTD nature of address (noa) fields.

Table 2: Type of Number to Nature of Address Mapping

GTD Nature of Address (noa)ISDN Type of Number

00--Unknown (number present)0--Unknown

06--Unique international number1-- International number

04--Unique national (significant) number2--National number

08--Network specific number3--Network specific number

02--Unique subscriber number4--Subscriber number

34--Abbreviated number6--Abbreviated number

The table below defines mapping for ISDN numbering plan identification fields to GTD numbering planindicator (npi) fields.

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T4

ISDN GTD for Setup MessageMapping of ISDN Information Elements to GTD Parameters

Page 5: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

Table 3: Numbering Plan Identification to Numbering Plan Indicator Mapping

GTD Numbering Plan Indicator (npi)ISDN Numbering Plan Identification

u--Unknown0--Unknown

1--ISDN numbering plan1--ISDN telephony numbering plan

1--ISDN numbering plan (best fit)2--Telephony numbering plan

2--Data numbering plan3--Data numbering plan

3--Telex numbering plan4--Telex numbering plan

5--National numbering plan8--National standard numbering plan

4--Private numbering plan9--Private numbering plan

The table below defines mapping for ISDN and GTD presentation indicator (pi) fields.

Table 4: Presentation Indicator Mapping

GTD Presentation Indicator (pi)ISDN Presentation Indicator

u--Unknown--

y--Presentation allowed0-- Presentation allowed

n--Presentation not allowed1--Presentation restricted

0--Address not available2--Number not available due to interworking

Mapping for Calling Party Number (CGN)The table below defines mapping for ISDN and GTD screening indicator (si) fields.

Table 5: Screening Indicator Mapping

GTD Screening Indicator (si)ISDN Screening Indicator

u--Unknown--

1--User-provided, not screened0-- User-provided, not screened

2--User-provided screening passed1--User-provided, verified and passed

3--User-provided screening failed2--User-provided, verified and failed

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T 5

ISDN GTD for Setup MessageMapping of ISDN Information Elements to GTD Parameters

Page 6: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

Mapping for Redirection Information (RNI)The table below defines mapping for the ISDN reason for redirection fields to GTD original redirection reason(orr) and redirection reason (rr) fields in the GTD RNI parameter.

Table 6: Reason for Redirection to Original Redirection Reason and Redirection Reason Mapping

GTD Original Redirection Reason (orr) andRedirection Reason (rr)

ISDN Reason for Redirection

u--Unknown0--Unknown

1--User busy1--Call forwarding busy or called DTE busy

2--No reply2--Call forwarding no reply

4--Deflection during alerting4--Call deflection

5--Call deflection immediate response5--Call deflection immediate response

2--No reply (best fit)9--Called DTE out of order

5--Call deflection immediate response (best fit)10--Call forwarding by the called DTE

5--Call deflection immediate response (best fit)13--Call transfer

5--Call deflection immediate response (best fit)14--Call pickup

3--Unconditional15--Call forwarding unconditional

Mapping for Originating Line Information (OLI)The table below defines mapping for OLI fields.

Table 7: Originating Line Information Mapping

GTD Originating-Line Information (oli)ISDN Originating-Line Information

0--POTS0-- POTS

1--Multiparty line1--Multiparty line

2--ANI failure2--ANI failure

6--Station-level rating6--Station-level rating

7--Special operator handling required7--Special operator handling required

8-- Inter-LATA restricted8--Inter-LATA restricted

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T6

ISDN GTD for Setup MessageMapping of ISDN Information Elements to GTD Parameters

Page 7: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

GTD Originating-Line Information (oli)ISDN Originating-Line Information

10--Test call10--Test call

20--AIOD-listed DN sent20--AIOD-listed DN sent

23--Coin or noncoin on calls using database access23--Coin or noncoin on calls using database access

24--800 service call24--800 service call

25--800 service call from a pay station25-- 800 service call from a pay station

27--Payphone using coin control signaling27--Payphone using coin control signaling

29--Prison or inmate service29-- Prison or inmate service

30--Intercept (blank)30-- Intercept (blank)

31--Intercept (trouble)31--Intercept (trouble)

32--Intercept (regular)32--Intercept (regular)

34--Telco operator-handled call34--Telco operator-handled call

36--CPE36--CPE

52--OUTWATS52--OUTWATS

60--TRS call from unrestricted line60--TRS call from unrestricted line

61--Wireless or cellular PCS (type 1)61--Wireless or cellular PCS (type 1)

62--Wireless or cellular PCS (type 2)62--Wireless or cellular PCS (type 2)

63--Wireless or cellular PCS (roaming)63-- Wireless or cellular PCS (roaming)

66--TRS call from hotel66--TRS call from hotel

67--TRS call from restricted line67--TRS call from restricted line

68--Inter-LATA restricted hotel68-- Inter-LATA restricted hotel

78--Inter-LATA restricted coinless78--Inter-LATA restricted coinless

70--Private paystations70--Private paystations

93--Private virtual network93--Private virtual network

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T 7

ISDN GTD for Setup MessageMapping of ISDN Information Elements to GTD Parameters

Page 8: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

Mapping for Bearer Capability (USI and TMR) ParametersThe ISDN Bearer Capability IE is mapped to the GTD User Service Information (USI) and TransmissionMedium Requirements (TMR) parameters. The table below defines mapping for coding standard fields andvalues.

Table 8: ISDN to GTD Coding Standard Mapping

GTD Coding Standard (cs)ISDN Coding Standard

c--CCITT/ITU standardized coding0--CCITT standardized coding

i--ISO/IEC standard1--Reserved for other international standard

n--National standard2--National standard

p--Standard defined for the network3--Standard defined for the network

The table below defines ISDN to GTD mapping for information transfer capability fields and values.

Table 9: Information Transfer Capability Mapping

GTD Information Transfer Capability (cap)ISDN Information Transfer Capability

s--Speech0--Speech

d--Unrestricted digital information8--Unrestricted digital information

r--Restricted digital information9--Restricted digital information

3--3.1-kbps audio16--3.1-kHz audio

7--7-kbps audio17--7-kHz audio

v-- Video24--Video

The table below defines mapping for transfer mode fields and values.

Table 10: Transfer Mode Mapping

GTD Transfer Mode (mode)ISDN Transfer Mode

c--Circuit mode0--Circuit mode

p--Packet mode2--Packet mode

The table below defines mapping for information transfer rate fields and values.

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T8

ISDN GTD for Setup MessageMapping of ISDN Information Elements to GTD Parameters

Page 9: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

Table 11: Information Transfer Rate Mapping

GTD Information Transfer Rate (rate)ISDN Information Transfer Rate

0--Not applicable (used for packet call)0--Packet mode

1--64 kbps16--64 kbps

7--2x64 kbps17--2x64 kbps

2--384 kbps19--384 kbps

4--1536 kbps21--1536 kbps

5--1920 kbps23--1920 kbps

The table below defines mapping for transmission medium requirements.

Table 12: Transmission Medium Requirements Mapping

GTD Transmission MediumRequirements

ISDN Information Transfer RateISDN Information TransferCapability

00--0--Speech

0116--64 kbps8--Unrestricted digital information

0417--2x64 kbps8--Unrestricted digital information

0519--384 kbps8--Unrestricted digital information

0621--1536 kbps8--Unrestricted digital information

0723--1920 kbps8--Unrestricted digital information

02--16--3.1-kHz audio

08--17--7-kHz audio

08--24--Video

The table below defines mapping for structure fields and values.

Table 13: Structure Mappings

Structure (str)Structure

0--Default or unknown0--Default

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T 9

ISDN GTD for Setup MessageMapping of ISDN Information Elements to GTD Parameters

Page 10: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

Structure (str)Structure

1--8-kHz integrity1--8-kHz integrity

2--Service data unit integrity4--Service data unit integrity

3--Unstructured7--Unstructured

The table below defines mapping for configuration fields and values.

Table 14: Configuration Field Mapping

GTD Configuration (conf)ISDN Configuration

0--Point to point0--Point to point

The table below defines mapping for establishment fields and values.

Table 15: Establishment Field Mapping

GTD Establishment (estab)ISDN Establishment

d--Demand0--Demand

The table below defines mapping for symmetry fields and values.

Table 16: Symmetry Field Mapping

GTD Symmetry (sym)ISDN Symmetry

sb--Symmetric bidirectional0--Bidirectional symmetric

The table below defines mapping for Layer 1 protocol fields and values.

Table 17: Layer 1 Protocol Mapping

GTD Layer 1 Protocol (lay1)ISDN Information Layer 1 Protocol

v110--CCITT standardized V.110/X.301--CCITT standardized V110

ulaw--G711 mu-law2--G.711mu-law

alaw--G711 A-law3--G.711A-law

g721--G721 32 kbps4--G.721 32 kbps

g722--G.722 and G.725/G.724 7-kHz audio5--G.722 and G.725

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T10

ISDN GTD for Setup MessageMapping of ISDN Information Elements to GTD Parameters

Page 11: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

GTD Layer 1 Protocol (lay1)ISDN Information Layer 1 Protocol

g735--G.735 for 384 kbps video6--G.7xx 384 video

nonc--Non-CCITT rate adaptation7--Non-CCITT standardized

v120--CCITT standardized V.1208--CCITT standardized V.120

hdlc--CCITT standardized X.319--CCITT standardized X.31

The table below defines mapping for synchronization fields and values.

Table 18: Synchronization Mapping

GTD Synchronization (sync)ISDN Synchronous/Asynchronous

y--Synchronous0--Synchronous

n--Asynchronous1--Asynchronous

The table below defines mapping for negotiation fields and values.

Table 19: Negotiation Mapping

GTD Negotiation (neg)ISDN Negotiation

0--In-band negotiation not possible0--In-band negotiation not possible

1--In-band negotiation possible1--In-band negotiation possible

The table below defines mapping for user rate fields and values.

Table 20: User-Rate Mapping

ISDN User Rate (subrate)ISDN User Rate

0--rate is indicated by E-bits0--rate is indicated by E-bits

1--0.6 kbps1--0.6 kbps

2--1.2 kbps2--1.2 kbps

3--2.4 kbps3--2.4 kbps

4--3.6 kbps4--3.6 kbps

5--4.8 kbps5--4.8 kbps

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T 11

ISDN GTD for Setup MessageMapping of ISDN Information Elements to GTD Parameters

Page 12: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

ISDN User Rate (subrate)ISDN User Rate

6--7.2 kbps6--7.2 kbps

7--8.0 kbps7--8.0 kbps

8--9.6 kbps8--9.6 kbps

9--14.4 kbps9--14.4 kbps

10--16.0 kbps10--16.0 kbps

11--19.2 kbps11--19.2 kbps

12--32.0 kbps12--32.0 kbps

13--48.0 kbps14--48.0 kbps

14--56.0 kbps15--56.0 kbps

14--56.0 kbps (best fit)16--64.0 kbps

15--0.1345 kbps21--0.1345 kbps

16--0.1000 kbps22--0.100 kbps

17--0.075/1.2 kbps23--0.075/1.2 kbps

18--1.2/0.075 kbps24--1.2/0.075 kbps

19--0.050 kbps25--0.050 kbps

20--0.075 kbps26--0.075 kbps

21--0.110 kbps27--0.110 kbps

22--0.150 kbps28--0.150 kbps

23--0.200 kbps29--0.200 kbps

24--0.300 kbps30-- 0.300 kbps

25--12 kbps31--12 kbps

The table below defines mapping for intermediate rate fields and values.

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T12

ISDN GTD for Setup MessageMapping of ISDN Information Elements to GTD Parameters

Page 13: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

Table 21: Intermediate Rate Mapping

GTD Intermediate Rate (int)ISDN Intermediate Rate

08--8 kbps1--8 kbps

16--16 kbps2--16 kbps

32--32 kbps3--32 kbps

The table below defines mapping for network independent clock on transmission fields and values.

Table 22: Mapping for Network Independent Clock on Transmission

ISDN Network Independent Clock on TX (txnic)ISDN Network Independent Clock on TX

n--Not required to send data0--Not required to send data

y--Required to send data1--Required to send data

The table below defines mapping for network independent clock on reception fields and values.

Table 23: Mapping for Network Independent Clock on Reception

GTD Network Independent Clock on RX (rxnic)ISDN Network Independent Clock on RX

n--Cannot accept data0--Cannot accept data

y--Can accept data1--Can accept data

The table below defines mapping for flow control on transmission fields and values.

Table 24: Mapping for Flow Control on Transmission

GTD Flow Control on TX (txfl)ISDN Flow Control on TX

n--Not required to send data0--Not required to send data

y--Required to send data1--Required to send data

The table below defines mapping for flow control on reception fields and values.

Table 25: Mapping for Flow Control on Reception

GTD Flow Control on RX (rxfl)ISDN Flow Control on RX

n--Cannot accept data0--Cannot accept data

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T 13

ISDN GTD for Setup MessageMapping of ISDN Information Elements to GTD Parameters

Page 14: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

GTD Flow Control on RX (rxfl)ISDN Flow Control on RX

y--Can accept data1--Can accept data

The table below defines mapping for rate adaptation header fields and values.

Table 26: Mapping for Rate Adaptation Header

GTD Rate Adaptation Header (hdr)ISDN Rate Adaptation Header/No Header

n--Rate adaptation header not included0--Rate adaptation header not included

y--Rate adaptation header included1--Rate adaptation header included

The table below defines mapping for multiframe establishment support for data link fields and values.

Table 27: Mapping for Multiframe Establishment (MFE) Support

GTD MFE Support in Data Link (mf)ISDN MFE Support in Data Link

n--MFE not supported0--MFE not supported

y--MFE supported1--MFE supported

The table below defines mapping for mode of operation fields and values.

Table 28: Mode of Operation Mapping

GTD Mode of Operation (mode)ISDN Mode of Operation

0--Bit-transparent mode of operation0--Bit-transparent mode of operation

1--Protocol-sensitive mode of operation1--Protocol-sensitive mode of operation

The table below defines mapping for logical link identifier negotiation fields and values.

Table 29: Logical Link Identifier (LLI) Mapping

GTD LLI Negotiation (lli)ISDN LLI Negotiation

0--Default0--Default

1--Full-protocol negotiation1--Full protocol negotiation

The table below defines mapping for assignor and assignee fields and values.

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T14

ISDN GTD for Setup MessageMapping of ISDN Information Elements to GTD Parameters

Page 15: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

Table 30: Mapping for Assignor and Assignee

GTD Assignor and Assignee (asgn)ISDN Assignor and Assignee

0--Message originator is default assignee0--Message originator is default assignee

1--Message originator is assignor only1--Message originator is assignor only

The table below defines mapping for in-band and out-of-band negotiation fields and values.

Table 31: Mapping for Inband and Out-of-Band Negotiation

GTD In-band and Out-of-Band Negotiation (inbnd)ISDN In-band and Out-of-Band Negotiation

0-- Not applicable to this protocol0--Negotiation done with USER INFO

1-- Negotiation done in-band1--Negotiation done in-band

The table below defines mapping for fields and values for number of stop bits.

Table 32: Mapping for Number of Stop Bits

GTD Number of Stop Bits (stp)ISDN Number of Stop Bits

1--1 bit1--1 bit

3--1.5 bit2--1.5 bit

2--2 bits3--2 bits

The table below defines mapping for fields and values for number of data bits.

Table 33: Mapping for Number of Data Bits

GTD Number of Data Bits (dat)ISDN Number of Data Bits

5--5 bits1--5 bits

7--7 bits2--7 bits

8--8 bits3--8 bits

The table below defines mapping for parity information fields and values.

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T 15

ISDN GTD for Setup MessageMapping of ISDN Information Elements to GTD Parameters

Page 16: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

Table 34: Parity Mapping

GTD Parity (par)ISDN Parity Information

o--Odd0--Odd

e--Even2--Even

n--None3--None

0--Forced to 04--Forced to 0

1-- Forced to 15--Forced to 1

The table below defines mapping for duplex mode fields and values.

Table 35: Duplex Mode Mapping

GTD Duplex (dup1)ISDN Duplex Mode

h--Half duplex0--Half duplex

f--Full duplex1--Full duplex

The table below defines mapping for modem type fields and values.

Table 36: Modem Type Mapping

Modem Type (modm)Modem Type

11--V.211--V.21

00--V.222--V.22

01--V.22 bis3--V.22 bis

02--V.234--V.23

03--V.265--V.26

04--V.26 bis6--V.26 bis

05--V.26 ter7--V.26 ter

06--V.278 --V.27

07--V.27 bis9--V.27 bis

08--V.27 ter10--V.27 ter

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T16

ISDN GTD for Setup MessageMapping of ISDN Information Elements to GTD Parameters

Page 17: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

Modem Type (modm)Modem Type

09--V.2911--V.29

10--V.3212--V.32

12--V.34 (best fit)13--V.35

The table below defines mapping for Layer 2 protocol fields and values.

Table 37: Layer 2 Protocol Mapping

GTD Layer 2 Protocol (lay2)ISDN User Information Layer 2 Protocol

2--Q.9212--Q.921

1--X.256--X.25

The table below defines mapping for Layer 3 protocol fields and values.

Table 38: Layer 3 Protocol Mapping

GTD Layer 3 Protocol (lay3)ISDN User Information Layer 3 Protocol

2--Q.9312--Q.931

1--X.256--X.25

How to Configure ISDN GTD for Setup Message

Configuring ISDN GTD for Setup MessagesThis feature is enabled by default; no configuration tasks are required to enable this feature. To reenable thefeature if it was disabled by use of the no isdn gtd command, perform the following steps.

SUMMARY STEPS

1. enable2. configure terminal3. interface4. isdn gtd5. exit

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T 17

ISDN GTD for Setup MessageHow to Configure ISDN GTD for Setup Message

Page 18: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

DETAILED STEPS

PurposeCommand or Action

Enables privileged EXEC mode. Enter your passwordif prompted.

enable

Example:

Router> enable

Step 1

Enters global configuration mode.configure terminal

Example:

Router# configure terminal

Step 2

Enters interface configuration mode.interface

Example:

Router(config)# interface

Step 3

Enables GTD parameter mapping for ISDN IEs.isdn gtd

Example:

Router(config-if)# isdn gtd

Step 4

Exits the current mode.exit

Example:

Router(config-if)# exit

Step 5

Configuring the OLI IE to Interface with MCI SwitchesTo configure OLI IE to interface with MCI switches, perform the following steps.

You must configure the Cisco IOS gateway to support the switch variant from which the gateway receivesISDN signaling. For a gateway that interfaces to an MCI switch or PBX, the OLI IE identifier for the MCIISDNvariant, as defined in CPERequirements forMCI ISDNPrimary Rate Interface, (014-0018-04.3D-ER,revision 4.3D), is configurable. Select the IE value that indicates OLI information to configure gatewaysupport for the MCI ISDN variant.

Note

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T18

ISDN GTD for Setup MessageConfiguring the OLI IE to Interface with MCI Switches

Page 19: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

SUMMARY STEPS

1. enable2. configure terminal3. interface4. isdn ie oli value5. exit

DETAILED STEPS

PurposeCommand or Action

Enables privileged EXEC mode. Enter your password ifprompted.

enable

Example:

Router> enable

Step 1

Enters global configuration mode.configure terminal

Example:

Router# configure terminal

Step 2

Enters interface configuration mode.interface

Example:

Router(config)# interface

Step 3

Configures the OLI IE identifier to allow the gateway tointerface with an MCI switch.

isdn ie oli value

Example:

Router(config-if)# isdn ie oli 7F

Step 4

OLI IE identifier values are in hexadecimal format. Valuesrange from 00 to 7F.

Exits the current mode.exit

Example:

Router(config-if)# exit

Step 5

Verifying ISDN GTDTo verify the interface, perform the following steps (listed alphabetically).

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T 19

ISDN GTD for Setup MessageVerifying ISDN GTD

Page 20: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

SUMMARY STEPS

1. show isdn status2. show running-config

DETAILED STEPS

Step 1 show isdn statusUse this command to display the status of all ISDN interfaces, including active layers, timer information, and switch-typesettings.

Step 2 show running-configUse this command to display the configuration for the ISDNGTD for SetupMessages feature. If GTDmapping is enabled(default), command output does not display the isdn gtd command.

Troubleshooting Tips• Use the debug gtd detailscommand to display GTD details.

• Use the debug gtd error command to display GTD errors.

• Use the debug gtd eventscommand to display GTD events.

ExamplesThis section provides the following output example:

Sample Output for the debug gtd events Command

Router# debug gtd events00:05:19:%SYS-5-CONFIG_I:Configured from console by console*Aug 8 06:32:20.915:ISDN Se3:23 Q931:RX <- SETUP pd = 8 callref = 0x0002

Bearer Capability i = 0x8890Standard = CCITTTranser Capability = Unrestricted DigitalTransfer Mode = CircuitTransfer Rate = 64 kbit/s

Channel ID i = 0xA98397Exclusive, Channel 23

Called Party Number i = 0x81, '9999'Plan:ISDN, Type:Unknown

*Aug 8 06:32:20.919:ISDN Se3:23:Built a GTD of size 86 octets for ISDN message type 0x5*Aug 8 06:32:20.919:tsp_ccrawmsg_encap:calling cdapi_find_tsm*Aug 8 06:32:20.919:cdapi_find_tsm:Found Tunnelled Signaling Msg with GTD:PROT_PTYPE_GTD*Aug 8 06:32:20.919:cdapi_find_tsm:Found a gtd msg of length 86:*Aug 8 06:32:20.919:gtd msg = "IAM,PRN,isdn*,,,USI,rate,c,d,c,1TMR,01CPN,00,,1,9999CPC,09FCI,,,,,,,y,"

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T20

ISDN GTD for Setup MessageTroubleshooting Tips

Page 21: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

*Aug 8 06:32:20.923:ccGTDExtractParm:Starting*Aug 8 06:32:20.923: tunnelledPtype = 2*Aug 8 06:32:20.923: gtdInstance = 0*Aug 8 06:32:20.923: gtdBitMap = 0xFFFFFFFF*Aug 8 06:32:20.923:ccGTDExtractParm:TunnelledContent has GTD message*Aug 8 06:32:20.923:gtd msg = "IAM,PRN,isdn*,,,USI,rate,c,d,c,1TMR,01CPN,00,,1,9999CPC,09FCI,,,,,,,y,"*Aug 8 06:32:20.927:ccGTDExtractParm:GTD Parm CPC obtained*Aug 8 06:32:20.927:ccGTDExtractParm:GTD Parm TMR obtained*Aug 8 06:32:20.927:ccGTDExtractParm:GTD Parm PRN obtained*Aug 8 06:32:21.547:ccMapGCItoGUID:GTD Parm GCI not present*Aug 8 06:32:21.547:ccMapGUIDtoGCI:Modified GTD string to include GCI*Aug 8 06:32:21.547:ccMapGUIDtoGCI:Calling update_gtd_in_raw_msg_buffer*Aug 8 06:32:21.547:update_gtd_in_raw_msg_buffer:Inserting 124 byte GTD string into rawmsgbuffer.The new gtd string is:*Aug 8 06:32:21.547:gtd msg = "IAM,PRN,isdn*,,,USI,rate,c,d,c,1TMR,01CPN,00,,1,9999CPC,09FCI,,,,,,,y,GCI,7ba32c886c2c11d48005b0f6ff40a2c1"*Aug 8 06:32:21.547:update_gtd_in_raw_msg_buffer:Original rawmsg buf length is 115the original gtd length was 86the new gtd length is = 124*Aug 8 06:32:21.547:update_gtd_in_raw_msg_buffer:New data and IE inserted in rawmsg buff,rawmsg buf length is now 153*Aug 8 06:32:21.551:Have gtd msg, length=124:*Aug 8 06:32:21.551:gtd msg = "IAM,PRN,isdn*,,,USI,rate,c,d,c,1TMR,01CPN,00,,1,9999CPC,09FCI,,,,,,,y,GCI,7ba32c886c2c11d48005b0f6ff40a2c1"*Aug 8 06:32:21.555:Have gtd msg, length=124:*Aug 8 06:32:21.555:gtd msg = "IAM,PRN,isdn*,,,USI,rate,c,d,c,1TMR,01CPN,00,,1,9999CPC,09FCI,,,,,,,y,GCI,7ba32c886c2c11d48005b0f6ff40a2c1"*Aug 8 06:32:21.559:ccMapGUIDtoGCI:GTD Parm GCI is present:7ba32c886c2c11d48005b0f6ff40a2c1,just returning*Aug 8 06:32:21.559:ccGTDExtractParm:Starting*Aug 8 06:32:21.559: tunnelledPtype = 2*Aug 8 06:32:21.559: gtdInstance = 0*Aug 8 06:32:21.559: gtdBitMap = 0xFFFBFFFF*Aug 8 06:32:21.559:ccGTDExtractParm:TunnelledContent has GTD message*Aug 8 06:32:21.559:gtd msg = "IAM,PRN,isdn*,,,USI,rate,c,d,c,1TMR,01CPN,00,,1,9999CPC,09FCI,,,,,,,y,GCI,7ba32c886c2c11d48005b0f6ff40a2c1"*Aug 8 06:32:21.559:ccGTDExtractParm:GTD Parm CPC obtained*Aug 8 06:32:21.559:ccGTDExtractParm:GTD Parm TMR obtained*Aug 8 06:32:21.563:ccGTDExtractParm:GTD Parm PRN obtained*Aug 8 06:32:21.563:ISDN Se3:23 Q931:TX -> CALL_PROC pd = 8 callref = 0x8002

Channel ID i = 0xA98397Exclusive, Channel 23

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T 21

ISDN GTD for Setup MessageTroubleshooting Tips

Page 22: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

Configuration Examples for ISDN Generic TransparencyDescriptor (GTD) for Setup Message

GTD Mapping ExampleThe following example shows that GTD mapping is enabled:

enableconfigure terminalinterfaceisdn gtd

The GTD feature is different from the isdn mapcommand.Note

OLI IE ExampleThe following example shows that the OLI IE identifier for interfacing to an MCI switch is set to 7F:

enableconfigure terminalinterfaceisdn ie oli 7F

OLI IE and GTD ExampleThe following example shows that the isdn gtd command is disabled and that the OLI IE identifier is set to1F in the D channel of the T1 line in slot 3 (serial3:23):

Router# show running-configBuilding configuration...Current configuration :4112 bytes!version 12.2no parser cacheservice timestamps debug datetime msecservice timestamps log uptimeno service password-encryption!hostname Router!boot system flash:c5300-i-mz.122-4.2no logging bufferedenable secretenable password!username guam passwordusername user1 passwordusername user2 passwordspe 2/0 2/7firmware location system:/ucode/mica_port_firmware!resource-pool disable

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T22

ISDN GTD for Setup MessageConfiguration Examples for ISDN Generic Transparency Descriptor (GTD) for Setup Message

Page 23: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

!ip subnet-zerono ip domain lookupip domain name cisco.comip host nlab-boot 172.21.200.2ip host dirt 172.69.1.129ip host dsbu-web.cisco.com 172.19.192.254 172.71.162.82ip host lab 172.19.192.254!isdn switch-type primary-niisdn gateway-max-interworking!trunk group 1carrier-id cd1max-retry 2hunt-scheme random!trunk group 2max-retry 2hunt-scheme random!voice service voip!no voice hpi capture bufferno voice hpi capture destination!fax interface-type modemmta receive maximum-recipients 0!controller T1 0framing esfclock source line primarylinecode b8zspri-group timeslots 1-24 nfas_d primary nfas_int 0 nfas_group 0no yellow generationno yellow detection!controller T1 1framing esfclock source line secondary 1linecode b8zspri-group timeslots 1-24 nfas_d backup nfas_int 1 nfas_group 0no yellow generationno yellow detection!controller T1 2framing esflinecode b8zspri-group timeslots 1-24 nfas_d none nfas_int 2 nfas_group 0no yellow generationno yellow detection!controller T1 3framing esflinecode b8zspri-group timeslots 1-24no yellow generationno yellow detection!interface Ethernet0ip address 10.0.44.29 255.255.255.0no ip route-cacheno ip mroute-cacheno cdp enable!interface Serial0:23ip address 10.1.1.2 255.255.255.0dialer map ip 10.1.1.1 name host 1111dialer-group 1isdn switch-type primary-niisdn protocol-emulate networkisdn T310 30000isdn negotiate-bchan

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T 23

ISDN GTD for Setup MessageOLI IE and GTD Example

Page 24: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

isdn bchan-number-order descendingno cdp enable!interface Serial3:23ip address 10.9.9.9 255.255.255.0dialer map ip 10.8.8.8 name host 8888dialer map ip 10.8.8.8 255.255.255.0dialer-group 1isdn switch-type primary-net5isdn protocol-emulate networkisdn incoming-voice modemisdn disconnect-cause 126no isdn outgoing display-ieisdn ie oli 1Fno isdn gtdno cdp enable!interface FastEthernet0no ip addressno ip route-cacheno ip mroute-cacheshutdownduplex autospeed autono cdp enable!interface Group-Async1no ip addressencapsulation pppdialer in-banddialer-group 1no keepalivegroup-range 1 96!interface Dialer1ip address 10.2.2.2 255.255.255.0encapsulation pppno ip route-cacheno ip mroute-cachedialer remote-name hostdialer-group 1no fair-queue!interface Dialer2no ip addressno cdp enable!interface Dialer5ip address 10.1.1.1 255.0.0.0encapsulation pppno ip route-cacheno ip mroute-cachedialer in-banddialer map ip 10.1.1.2 name host 1234567dialer-group 1ppp authentication chap!ip default-gateway 10.0.44.1ip classlessip route 0.0.0.0 0.0.0.0 10.0.44.1ip route 0.0.0.0 0.0.0.0 Ethernet0no ip http server!access-list 101 permit ip any anydialer-list 1 protocol ip permitno cdp run!snmp-server enable traps ttysnmp-server enable traps isdn layer2snmp-server host 10.1.1.1 public!call rsvp-sync!

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T24

ISDN GTD for Setup MessageOLI IE and GTD Example

Page 25: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

voice-port 0:D!voice-port 3:D!mgcp profile default!dial-peer cor custom!dial-peer voice 2 voipdestination-pattern 111session target ipv4:10.0.45.87!dial-peer voice 10 potsdestination-pattern 9999direct-inward-dialport 3:Dprefix 9999!dial-peer voice 20 voipdestination-pattern 000000002.session target ipv4:10.0.44.28!dial-peer voice 50 potsdestination-pattern 2222direct-inward-dialport 0:Dprefix 2222!alias exec c conf t!line con 0exec-timeout 0 0logging synchronousline 1 96no flush-at-activationmodem InOuttransport input alltransport output lat pad telnet rlogin udptn v120 lapb-taline aux 0line vty 0 4passwordlogin!end

Additional ReferencesGeneral ISDN References

• "Overview of ISDNVoice Interfaces" --Describes relevant underlying technology; lists related documents,standards, MIBs, and RFCs; and describes how to obtain technical assistance

• "Additional References" section --Lists additional ISDN references

References Mentioned in This Chapter

• RADIUS VSA Voice Implementation Guide at http://www.cisco.com/univercd/cc/td/doc/product/access/acs_serv/vapp_dev/vsaig3.htm

• Tcl IVR API Version 2.0 Programmer's Guide at http://www.cisco.com/univercd/cc/td/doc/product/access/acs_serv/vapp_dev/tclivrv2/index.htm

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T 25

ISDN GTD for Setup MessageAdditional References

Page 26: ISDN GTD for Setup Message - cisco.com GTD for Setup Message ThischapterdescribeshowtoimplementtheISDNGenericTransparencyDescriptor(GTD)forSetup Messagefeature.ThefeatureprovidessupportformappingISDNinformationelements(IEs)tocorresponding

ISDN Voice Configuration Guide, Cisco IOS Release 15M&T26

ISDN GTD for Setup MessageAdditional References