Table Of Contents

Remote CAPI Commands

CAPI Features

CAPI and RVS-COM

Supported B Channel Protocols

Supported D-Channel Protocols

Supported Applications

Remote CAPI Router Commands

diag rcapi

reset rcapi number

set rcapi

set rcapi number

set rcapi server port

show rcapi status

Remote CAPI Commands

---

This chapter describes the commands needed for configuration tasks such as enabling Remote CAPI (RCAPI), configuring the TCP port on which the RCAPI server listens for client requests, and configuring the Cisco 700 series router to distinguish between incoming RCAPI calls and incoming calls of other types.

The Common Application Programing Interface (CAPI) is an application programming interface standard used to access ISDN equipment connected to Basic Rate Interfaces (BRIs) and Primary Rate Interfaces (PRIs). It provides a standardized interface that allows application programs to use ISDN drivers and controllers. One application can use one or more controllers. Several applications can share one or more controllers.

CAPI provides a selection mechanism that supports applications that use different protocols at different protocol levels and standardized network access by performing an abstraction from different protocol variables. All connection-related data, such as connection state, display messages, and so on, is available to the applications at any time.

The framing protocols supported by CAPI include High-Level Data Link Control (HDLC), HDLC inverted, bit transparent (speech), and V.110 synchronous/asynchronous.

CAPI integrates the following data link and network layer protocols:

•Link Access Procedure on the D channel (LAPD) in accordance with Q.921 for X.25 D-channel implementation.

•Point-to-Point Protocol (PPP).

•ISO 8208 (X.25 DTE-DTE).

•X.25 DCE, T.90NL, and T.30 (fax group 3).

CAPI Features

CAPI has the following features:

•Basic call features, such as call set up and clear-down.

•Multiple B channels for data and voice connections.

•Several logical data link connections within a physical connection.

•Ability to select different services and protocols during connection setup and on answering incoming calls.

•Transparent interface for protocols above Layer 3.

•One or more BRIs as well as PRI on one or more ISDN adapters.

•Multiple applications.

•Operating systems-independent messages.

•Operating system-dependent exchange mechanism for optimum operating system integration.

•Asynchronous event-driven mechanism, resulting in high throughput.

•Well-defined mechanism for manufacturer-specific extensions.

•Multiple supplementary services.

CAPI and RVS-COM

The Cisco 700 series router supports the ISDN Device Control Protocol (ISDN-DCP) from RVS-COM. ISDN-DCP allows a workstation on the LAN or router to use legacy dial computer telephony integration (CTI) applications. These applications include fax transmitting and receiving and placing and receiving phone calls.

Using ISDN-DCP, the router acts as a DCP server. By default, the router listens for DCP messages on TCP port number 2578 (the Internet-assigned number for RVS-COM DCP) on its LAN port.

When the router receives a DCP message from a DCP client (connected to the LAN port of the router), the router processes the message and acts on it. The actions include sending confirmations to the DCP clients and sending ISDN packets through the BRI port of the router.

When the router receives packets on its BRI port destined for one of the DCP clients, the router formats the packet as a DCP message and sends it to the corresponding client. The router supports all the DCP messages specified in the ISDN-DCP specification.

Supported B Channel Protocols

The Cisco 700 series router provides two 64-kbps B channels to CAPI clients. Each B channel can be configured separately to work in either HDLC mode or bit transparent mode. For CAPI support, the higher layer protocols (B2 through B7) are transparent to the applications using these B channels.

The ISDN Core Engine of RVS-COM supports the following B channel protocols:

•CAPI layer B1

•64 kbps with HDLC framing

•64-kbps bit-transparent operation with byte framing from the network

•T.30 modem for fax group 3

•Modem with full negotiation

•CAPI layer B2

•X.75 SLP (ISO 7776) with V.42bis compression option (negotiated)

•V.120 with V.42bis compression option (negotiated)

•Transparent

•T.30 modem for fax group 3

•Modem with full negotiation

•CAPI layer B3

•Transparent

•T.90NL with compatibility to T.70NL according to T.90 Appendix II

•ISO 8208 (X.25 DTE-DTE) modulo 8 and windows size 2, no multiple logical connections

•T.30 for fax group 3

•Modem with full negotiation

•T.30 for fax group 3 (SFF file format [default], sending and receiving up to 14400 bit/s with ECM option, modulations V.17, V.21, V.27ter, V.29)

•Analog modem (sending and receiving up to 14400 bit/s with V.42 error correction and V.42bis compression option, modulations V.21, V.22, V.22bis, V.23, V.32, V.32bis)

Supported D-Channel Protocols

•CAPI support is available only for the ISDN switch type Net3.

Supported Applications

ISDN-DCP supports CAPI and non-CAPI applications. Applications are supported that use one or two B channels for data transfer, different HDLC-based protocols, Euro File transfer, or fax G4; also supported are applications that send bit-transparent data, such as A/Mu lay audio, fax G3, analog modem, or analog telephones.

Remote CAPI Router Commands

The commands described in this chapter have been added to the user interface of the router to support CAPI. Note that CAPI runs on a remote network device other than the router; the Cisco 700 series router enables remote CAPI applications.

diag rcapi

To display diagnostic information about the Device Control Protocol (DCP) and about DCP-to-host communication, use the diag rcapi command.

DIag RCapi ON | OFf

Syntax Description

ON	Turn on the diagnostic display.
OFf	Turn off the diagnostic display.

Default

Off

Command Mode

System or profile mode

Usage Guidelines

The diag rcapi command displays all of the DCP messages that are transmitted between the Cisco 700 series router and the DCP client, as shown in this example:

DCP: fmt1:fmt2:Message

If displayed, fmt1 indicates the session identifier and fmt2 indicates the controller or connection identifier.

Example

The following example shows output from the diag rcapi on command:

Host:2503> diag rcapi on 
DCP:Received DCP_CAPABILITIES_REQ

DCP:    DCPVersion = 256

DCP:    MaxSessionCount = 100

DCP:    ManufactureId = 268435457

DCP:    DeviceId = 1

DCP:    DeviceVersion = 256

DCP:Sending DCP_CAPABILITIES_CONF

DCP:Received DCPSC_START_REQ

DCP:    SessionMode = 0

DCP:    SessionTimeout = 5

DCP:    SessionIndex = 6

DCP:New Session Accepted with ID: 16777224

DCP:16777224:Sending DCPSC_START_CONF

DCP:16777224:interval = 250000

DCP:16777224:33554433:Received DCPCC_LISTEN_REQ

DCP:Sending DCPCC_LISTEN_CONF

DCP:16777224:ListenMode = OFF

DCP:16777224:Received DCPCC_CALL_REQ

DCP:16777224:DeviceMode

DCP:    Framing HDLC

DCP:    CalledPartyNumber 4805010

DCP:16777224:ConnectionId allocated is 50332929

DCP:16777224:50332929:Sending DCPCC_CALL_CONF

Related Commands

set rcapi
set rcapi number
set rcapi server port

reset rcapi number

To reset the RCAPI directory number, use the reset rcapi number command.

REset RCapi NUmber number.subaddress | ALl

Syntax Description

number	Clears a specific directory number assigned to RCAPI calls.
subaddress	Clears a specific subaddress of a device on a multipoint ISDN line.
ALl	Clears all RCAPI numbers.

Default

None

Command Mode

System mode

Usage Guidelines

If you reset all of the directory numbers, the RCAPI number is automatically reset.

Example

The following example clears all previously set RCAPI directory numbers:

Host> reset rcapi all

Related Command

set rcapi number

set rcapi

To enable or disable RCAPI , use the set rcapi command.

SEt RCapi ON | OFf

Syntax Description

ON	Enables RCAPI.
OFf	Disables RCPI.

Default

Off

Command Mode

System mode

Usage Guidelines

The router must be rebooted in order for this command to take effect.

Example

The following example enables RCAPI:

Host> set rcapi on

Related Commands

set directorynumber
set rcapi number
set rcapi server port

set rcapi number

To reserve a directory number for use by RCAPI, use the set rcapi number command.

SEt RCapi NUmber number.subaddress

Syntax Description

number	The directory number assigned to RCAPI calls. Can have 2 to 20 digits.
subaddress	Subaddress of a device on a multipoint ISDN line. Can have 1 to 10 digits.

Default

No directory number is configured.

Command Mode

System mode

Usage Guidelines

The set rcapi number command enables the Cisco 700 series router to distinguish between incoming RCAPI calls and incoming calls of other types (for example, POTS, PPP, and X.25) by reserving some directory numbers exclusively for incoming RCAPI calls.

The RCAPI number must already be set as a directory number, and you cannot set it to any other interface type (such as POTS, or DOV). You can set a maximum of six RCAPI directory numbers.

Example

The following example sets the RCAPI number to 5553000.5553100:

Host> set rcapi number 5553000.5553100

Related Commands

reset rcapi number
set rcapi

set rcapi server port

To set the TCP port number on which the RCAPI server listens for client requests, use the set rcapi server port command.

SEt RCapi SErver POrt number

Syntax Description

number

The TCP port number on which the RCAPI server listens for client requests.

Default

The default port number is 2578.

Command Mode

System mode

Usage Guidelines

You must reboot the router for this command to take effect.

Example

The following example configures the TCP port number to 2550:

Host> set rcapi server port 2550

Related Command

set rcapi

show rcapi status

To display the RCAPI configuration, use the show rcapi status command.

SHow RCapi Status

Command Mode

System mode

Example

The following example shows the output of the show rcapi status command:

Host> show rcapi status 

Rcapi Server ON

Rcapi Server Port 2578

Rcapi Number(s) 5310

CLIENT        SESSION-ID LISTEN CONNECTION-ID TYPE           CALL-STATUS

------------------------------------------------------------------------

192.168.100.3 16777218   ON

192.168.100.5 16777227   OFF    50333953      HDLC            CONNECTED 
192.168.100.6 16777228   OFF    50334209      BIT-TRANSPARENT CONNECTED

Related Commands

set rcapi
set rcapi number
set rcapi server port