|
|
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:
CAPI has the following features:
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.
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:
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.
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.
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
ON | Turn on the diagnostic display. |
OFf | Turn off the diagnostic display. |
Off
System or profile mode
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.
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
set rcapi
set rcapi number
set rcapi server port
To reset the RCAPI directory number, use the reset rcapi number command.
REset RCapi NUmber number.subaddress | ALl
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. |
None
System mode
If you reset all of the directory numbers, the RCAPI number is automatically reset.
The following example clears all previously set RCAPI directory numbers:
Host> reset rcapi all
set rcapi number
To enable or disable RCAPI , use the set rcapi command.
SEt RCapi ON | OFf
ON | Enables RCAPI. |
OFf | Disables RCPI. |
Off
System mode
The router must be rebooted in order for this command to take effect.
The following example enables RCAPI:
Host> set rcapi on
set directorynumber
set rcapi number
set rcapi server port
To reserve a directory number for use by RCAPI, use the set rcapi number command.
SEt RCapi NUmber number.subaddress
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. |
No directory number is configured.
System mode
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.
The following example sets the RCAPI number to 5553000.5553100:
Host> set rcapi number 5553000.5553100
reset rcapi number
set rcapi
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
number | The TCP port number on which the RCAPI server listens for client requests. |
The default port number is 2578.
System mode
You must reboot the router for this command to take effect.
The following example configures the TCP port number to 2550:
Host> set rcapi server port 2550
set rcapi
To display the RCAPI configuration, use the show rcapi status command.
SHow RCapi StatusSystem mode
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 CLIENTSESSION-IDLISTENCONNECTION-IDTYPECALL-STATUS ------------------------------------------------------------------------ 192.168.100.316777218ON 192.168.100.516777227OFF50333953HDLCCONNECTED
192.168.100.616777228OFF50334209BIT-TRANSPARENTCONNECTED
set rcapi
set rcapi number
set rcapi server port
Posted: Thu Jul 8 12:46:53 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.