|
|
The Airline Product Set (ALPS) feature is a tunneling mechanism that transports airline protocol data across a Cisco router-based TCP/IP network to an X.25-attached mainframe. This feature provides connectivity between agent set control units (ASCUs) and a mainframe host that runs the airline reservation system database.
Figure 1 shows the basic ALPS topology and the protocols implemented in the feature. Three major components provide the end-to-end transportation of airline protocol traffic across the network: the P1024B Airline Control (ALC) or P1024C (UTS) protocol, the TCP-based transport protocol, and the AX.25/EMTOX access to the mainframe.
Cisco's ALPS feature provides an end-to-end solution for airlines or central reservation systems.
The ALPS feature is integrated in the Cisco IOS software and allows airlines to replace their existing hardware and software with Cisco routers. For customers who already use Cisco routers, this feature allows them to consolidate networking overhead and functionality.
The ALPS feature is supported on the following platforms:
Airline protocol---A generic term that refers to the airline reservation system data and the protocols such as P1024B (ALC), P1024C (UTS), AX.25 and EMTOX that are used to transport the data between the mainframe and the ASCUs.
ALC---Airline Control protocol. P1024B, a data-link layer polled protocol that runs in full-duplex mode over synchronous serial (V.24) lines and uses the binary-coded decimal (BCD) character set.
ALPS---Acronym for Cisco's Airline Product Set feature.
ASCU---Agent set control unit. An airline reservations system terminal controller.
AX.25---Airline X.25. An X.25 implementation based on CCITT 1984 recommendation using permanent virtual circuits (PVCs) only.
Central CPE---Routers with the ALPS feature that are connected to the host via AX.25 or EMTOX.
CPE---Customer premises equipment (in this context, a Cisco router).
EMTOX---Exchange of mixed traffic over X.25. Specification for transmitting airline protocol data over standard X.25 switched virtual circuits (SVCs).
HLD---High-Level Designator.
IA---ASCU Interchange Address. Specifies a physical ASCU identity.
IATA---International Airline Transport Association.
Local switching---Ability of a CPE to forward traffic between an ASCU and an AX.25/EMTOX host that are both attached to the same CPE.
Remote CPE---Routers with the ALPS feature that are physically connected to the ASCUs.
UTS---P1024C, a data-link layer protocol that runs in full-duplex mode over synchronous serial (V.24) lines and uses the ASCII character set.
Perform the tasks in the following sections to configure and maintain the ALPS feature.
Perform the tasks in the following sections to configure the ALPS feature on the remote CPE routers:
You must identify an IP address as an ALPS local peer on the remote CPE. Only one ALPS local peer is permitted on a router.
To specify the ALPS local peer IP address, use the following commands in global configuration mode:
| Step | Command | Purpose | ||
|---|---|---|---|---|
| alps local-peer ipaddress | Specify an IP address to use as the ALPS local peer on the remote CPE. | ||
| alps keepalive [interval time] [retry count] | Enable TCP keepalives for ALPS TCP peer connections. |
You must also specify in the remote CPE configuration the IP addresses of ALPS peers that exist on the central CPE router. The peer connection may be either permanent or dynamic (established on demand).
To specify the IP addresses that exist on the central CPE, use the following commands in global configuration mode:
| Command | Purpose |
|---|---|
alps remote-peer ip-addr [dynamic [inact-timer]] [tcp-qlen [num] | Specify the IP addresses of ALPS peers that exist on partner CPE routers. |
You can customize the contents of the service message list. To specify the service message number and the content of the message, use the following command in global configuration mode:
| Command | Purpose |
|---|---|
alps service-msg-list list number number msg | Specify service message numbers and content. |
An ALPS circuit is a communication path across a TCP connection for one or more ASCUs. The ALPS circuit must have a configured association with an ALPS remote peer to establish a connection to the host. Additionally, an ALPS circuit configuration may specify a different remote peer as a backup peer to the host. Configuration for an ALPS circuit also includes X.25 connection information to be passed to the central CPE router when the circuit is established. ALPS circuits may be multiplexed across a single TCP connection.
To specify an ALPS circuit, use the following commands, beginning in global configuration mode:
| Step | Command | Purpose | ||
|---|---|---|---|---|
| alps circuit name | Specify an ALPS circuit at the remote CPE and enter ALPS circuit submode. | ||
| alps primary-peer ip-addr [backup-peer ip-addr] | Specify the primary TCP peer and an optional backup peer for this ALPS circuit. | ||
| alps local-hld loc-hld remote-hld rem-hld | Specify the local and remote HLDs for this ALPS circuit. | ||
| alps connection-type permanent retry-timer | Specify that this circuit should be established when the circuit is enabled. | ||
| alps lifetime-timer timer | Specify how long messages can be queued in the ALPS circuit queue. | ||
| alps hostlink number {ax25 lcn | emtox x121-addr} [winout val1] [winin val2] [ops val3] [ips val4] | Specify the information required to establish an X.25 virtual circuit at the central CPE. | ||
| alps service-msg-interval seconds | Specify the interval between the transmission of a service message to an ASCU and the transmission of a "PLEASE RETRY' message. The "PLEASE RETRY" message is transmitted only to ASCUs that use circuits with a dynamic connection type. | ||
| Define the service message list to be used for this circuit. | |||
| Enable the circuit to be activated. |
Each ASCU must be configured within the context of the serial interface configuration. ASCU addressing information and association with an ASCU circuit must be configured. Timers, maximum frame sizes, and retry values are optional configuration parameters for each ASCU. Appropriate default parameters are used for unspecified parameters.
To specify an ASCU, use the following commands, beginning in global configuration mode:
| Step | Command | Purpose | ||
|---|---|---|---|---|
| interface type number | Configure an interface and enter interface configuration mode. | ||
| encapsulation [alc | uts] | Specify the protocol to be used on the serial interface. | ||
| alps t1 delay | Specify the timeout delay between the transmission of an ALC poll message and the receipt of the first character of the poll message response. | ||
| alps t2 delay | Specify the timeout delay between receipt of the first character of the response to a poll message and the receipt of a Go Ahead message. | ||
| alps n1 errors | Specify the threshold of consecutive errors logged before an ASCU is declared to be down. | ||
| alps n2 polls | Specify the number of polls that must be correctly replied to before an ASCU is declared to be up. | ||
| alps servlim polls | Specify the number of polls of the ASCU UP list allowed between two successive polls of the ASCU DOWN list. | ||
| alps ascu id | Specify a physical ASCU identity (the ASCU interchange address value for ALC) and enter ALPS ASCU submode. | ||
| alps default-ckt name | Specify the ALPS circuit that this ASCU uses. | ||
| alps a1-map a1-value a2-map a2-value | Specify the A1 and A2 logical ASCU identification information. | ||
| alps retry-option [resend | reenter] | Specify the retry option when an ALC message with a bad cyclic check character (CCC) is received. | ||
| alps max-msg-length value | Specify maximum input message length. | ||
| alps error-display number1 number2 | Specify where error messages are displayed. | ||
| Begin polling the ASCU. |
Perform the tasks in the following sections to configure the ALPS feature on the central CPE router:
You must identify an IP address to use as the ALPS local peer IP address. Only one ALPS host local peer is permitted on a router. The promiscuous option, which allows any remote CPE to connect, is recommended at the remote CPE.
To specify the ALPS host local peer address, use the following command in global configuration mode:
| Command | Purpose |
|---|---|
alps local-peer ip-address [promiscuous] | Specify the IP address of the local peer. |
For AX.25 to be enabled on an X.25 interface, the ALPS host high-level designator (HLD) and hostlink number must be configured and AX.25 must be specified on an X.25 serial interface. At circuit-establishment time, the remote CPE router forwards the host HLD, the logical channel number (LCN), and the hostlink number for the permanent virtual circuit (PVC), to be used for the ASCU group.
To configure AX.25 on an X.25 interface, use the following commands, beginning in global configuration mode:
| Step | Command | Purpose | ||
|---|---|---|---|---|
| interface type number | Configure an interface and enter interface configuration mode. | ||
| encapsulation x25 ax25 | Specify a serial interface as an X.25 device. | ||
| alps host-hld num host-link num ax25 [damp-tmr value] [life-tmr value] | Enable ALPS on the X.25 interface. |
For EMTOX to be enabled on an X.25 interface, the host HLD and the hostlink number must be configured and EMTOX must be specified on an X.25 serial interface. At circuit-establishment time, the remote CPE router forwards the X.121 address to be used as the calling address in the X.25 call and the host HLD and the hostlink number. If the host performs a call out, a correlation between the X.121 called address and a remote CPE peer IP address must be configured.
To configure EMTOX on an X.25 interface, use the following commands, beginning in global configuration mode:
| Step | Command | Purpose | ||
|---|---|---|---|---|
| interface type number | Configure an interface and enter interface configuration mode. | ||
| encapsulation x25 | Specify a serial interface as an X.25 device. | ||
| alps host-hld num host-link num emtox [life-tmr value] | Enable ALPS on the X.25 interface. | ||
| alps translate x.121-addr ip-addr | Map an X.121 address to an IP address on a remote peer. |
To monitor the status of the ALPS feature, use the following commands in EXEC mode:
| Command | Purpose |
|---|---|
show alps ascu [interface id] [detail] | Display the status of the ALPS ASCU. |
show alps circuits [name name] [detail] | Display the status of the ALPS circuits. |
show alps peers [ipaddress addr] [detail] | Display the status of the ALPS remote peers. |
show interface type number | Display ALC or UTS information. |
This section includes two example configurations:
Figure 2 shows a simple router topology for the ALPS feature. The configuration for this topology follows.
alps local-peer 172.22.0.90 alps keepalive interval 60 alps remote-peer 172.22.0.91 alps remote-peer 172.22.0.92 dynamic 60 alps service-msg-list 1 number 2 "Turn off the terminal NOW" ! alps circuit CKT1 alps primary-peer 172.22.0.91 backup-peer 172.22.0.92 alps local-hld 4B10 remote-hld 5C00 alps connection-type permanent 30 alps lifetime-timer 3 alps hostlink 3 ax25 120 winout 3 winin 3 alps service-msg-interval 3 alps service-msg-list 1 alps enable-circuit ! alps circuit CKT2 alps primary-peer 172.22.0.91 backup-peer 172.22.0.92 alps local-hld 4B10 remote-hld 5C00 alps hostlink 3 ax25 1500 winout 4 winin 5 alps enable-circuit ! alps circuit CKT3 alps primary-peer 172.22.0.91 alps local-hld 4B10 remote-hld 5C00 alps connection-type permanent 30 alps lifetime-timer 6 alps hostlink 3 ax25 905 alps enable-circuit ! interface serial 1 ip address 172.22.0.90 255.255.255.0 ! interface serial 2 encapsulation alc alps t1 3 alps t2 6 alps n1 3 alps n2 2 alps servlim 20 ! alps ascu 51 alps default-ckt CKT1 alps a1-map 40 a2-map 2D alps retry-option resend alps max-msg-length 1950 alps error-display 6d 78 alps enable-ascu ! alps ascu 44 alps default-ckt CKT1 alps a1-map 40 a2-map 2E alps max-msg-length 590 alps error-display 6d 78 alps enable-ascu ! alps ascu 7E alps default-ckt CKT2 alps a1-map 40 a2-map 2F alps retry-option re-send alps max-msg-length 2000 alps error-display 6d 78 alps enable-ascu interface serial 3 encapsulation alc alps t1 5 alps t2 6 alps n1 1 alps n2 2 alps servlim 20 ! alps ascu 4B alps default-ckt CKT3 alps a1-map 63 a2-map 41 alps retry-option re-send alps max-msg-length 1960 alps error-display 6d 78 alps enable-ascu alps ascu 66 alps default-ckt CKT2 alps a1-map 71 a2-map 21 alps max-msg-length 3800 alps error-display 6d 78 alps enable-ascu
alps local-peer 172.22.0.91 promiscuous interface serial 0 encapsulation x25 ax25 alps host-hld 4B10 host-link 3 ax25
alps local-peer 172.22.0.91 promiscuous interface serial 0 encapsulation x25 alps host-hld 4B20 host-link 3 emtox 1114235 alps translate 88845* 172.22.0.90
alps local-peer 172.22.0.92 promiscuous interface serial 0 encapsulation x25 ax25 alps host-hld 4B10 host-link 3 ax25 nonstd-ps 240
alps local-peer 172.22.0.92 promiscuous interface serial 0 encapsulation x25 alps host-hld 4B10 host-link 3 emtox 1114235
The following configuration is an example of routing and transmitting ALC (P1024B) and UTS (P1024C) data frames across the network between central and remote equitment.
hostname alps-rcpe alps local-peer 200.100.25.2 alps keepalive interval 45 retry 5 alps remote-peer 200.100.40.2 alps remote-peer 200.100.70.2 alps enable-alarms peer 200.100.40.2 alps enable-alarms ascu ! alps circuit ALC_AX25 alps primary-peer 200.100.40.2 backup-peer 200.100.70.2 alps connection-type permanent alps local-hld 2525 remote-hld 4040 alps hostlink 2 ax25 50 winout 2 winin 7 alps enable-circuit ! alps circuit UTS_EMTOX alps primary-peer 200.100.40.2 alps idle-timer 90 alps local-hld 2525 remote-hld 5050 alps mpx single alps hostlink 6 emtox 1100 ops 512 ips 512 alps enable-circuit alps service-msg-interval 2 ! interface Loopback0 ip address 200.100.25.2 255.255.255.0 interface Serial0 ip address 210.100.50.2 255.255.255.0 encapsulation frame-relay IETF frame-relay map ip 210.100.50.3 40 ! interface Serial1 ip address 200.100.50.2 255.255.255.0 encapsulation frame-relay IETF frame-relay map ip 200.100.50.3 20 interface Serial6 encapsulation alc alps t1 6 alps t2 8 alps poll-pause 100 clockrate 9600 ! alps ascu 42 alps default-circuit ALC_AX25 alps a1-map 60 a2-map 70 alps enable-ascu ! alps ascu 45 alps default-circuit ALC_AX25 alps a1-map 60 a2-map 72 alps enable-ascu ! interface Serial7 encapsulation uts alps n1 5 alps n3 4 alps poll-pause 75 clockrate 4800 ! alps ascu 21 alps default-circuit UTS_EMTOX alps a1-map 22 a2-map 13 alps enable-ascu !
hostname alps-ccpe alps local-peer 200.100.40.2 promiscuous alps enable-alarms circuit ! interface Loopback0 ip address 200.100.40.2 255.255.255.0 ! interface Serial0 ip address 200.100.50.3 255.255.255.0 encapsulation frame-relay IETF clockrate 56000 frame-relay map ip 200.100.50.2 20 ! interface Serial2 encapsulation x25 dce ax25 x25 ltc 500 alps host-hld 4040 host-link 2 ax25 clockrate 64000 ! interface Serial3 encapsulation x25 dce alps host-hld 5050 host-link 6 emtox 2222 alps translate 110* 200.100.25.2 clockrate 64000!
hostname alps-back-ccpe alps local-peer 200.100.70.2 promiscuous ! interface Loopback0 ip address 200.100.70.2 255.255.255.0 ! interface Serial0 ip address 210.100.50.3 255.255.255.0 encapsulation frame-relay IETF clockrate 56000 frame-relay map ip 210.100.50.2 40 ! interface Serial1 encapsulation x25 dce ax25 x25 ltc 500 alps host-hld 4040 host-link 2 ax25 clockrate 64000
This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 11.3 command references.
Use the alps a1-map a2-map ALPS ASCU submode command to specify the A1 and A2 logical ASCU identification information.
alps a1-map a1-value a2-map a2-value
a1-value | A1 logical ASCU identification. |
a2-value | A2 logical ASCU identification. |
ALPS ASCU submode
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies the A1 identification as 40 and the A2 identification as 20:
alps a1-map 40 a2-map 20
show alps ascu
Use the alps ascu interface configuration command to specify a physical ASCU identity. Use the no form of this command to remove the ASCU from the interface and delete any messages queued for transmission to the ASCU or the network.
alps ascu ia
ia | ASCU interchange address. |
Interface configuration
This command first appeared in Cisco IOS Release 11.3T.
If an ASCU already exists on the interface, the alps ascu command initiates the ALPS ASCU submode for that ASCU. If the ASCU does not exist, an ASCU is created and the ALPS ASCU submode is initiated.
The following example specifies the IA as 4B:
alps ascu 4B
show alps ascu
Use the alps circuit global configuration command to specify an ALPS circuit at the remote CPE across a TCP/IP connection. Use the no form of this command to remove the circuit definition from the configuration, send a close message on the ALPS circuit, and delete any queued messages for the circuit.
alps circuit name
name | Name given to identify an ALPS circuit on the remote CPE. |
Global configuration
This command first appeared in Cisco IOS Release 11.3T.
Entering this command causes a circuit control block to be created. the command also initiates the ALPS circuit submode. If the circuit already exists, the only action is the initiation of the ALPS circuit submode.
Note that this command is used to statically create an ALPS circuit at the remote CPE (P1024B/C attached router). ALPS X.25 circuits (at the central CPE) are always dynamically created and are never created using this command.
The following example specifies the name of the ALPS circuit at the remote CPE as CKT1:
alps circuit CKT1
show alps circuits
Use the alps connection-type permanent ALPS circuit submode command to specify that this circuit should be established when the circuit is enabled.
alps connection-type permanent retry-timer
retry-timer | Determines how frequently the remote CPE tries to establish the connection in the event of a failure. The default for retry-timer is 30 seconds and the range is 1 to 180 seconds. |
The default is 30 seconds.
ALPS circuit submode
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies that the circuit is established when enabled and that the CPE will retry the connection every 30 seconds in the event of a failure:
alps connection-type permanent 30
show alps circuits
Use the alps default-ckt ALPS ASCU submode command to specify the ALPS circuit that this ASCU uses.
alps default-ckt name
name | Name given to identify an ALPS circuit on the remote CPE. |
ALPS ASCU submode
This command first appeared in Cisco IOS Release 11.3T.
The following example specified that ALPS circuit to be used is CKT1:
alps default-ckt CKT1
show alps circuits
Use the alps enable-alarms ascu global configuration command at the remote CPE to enable alarms for the ALPS ASCUs. Use the no form of this command to disable alarms for the ALPS ASCUs.
alps enable-alarms ascu [interface ia]
interface ia | (Optional)Interface and interchange address. Enable alarms for the specified ASCU. |
If no interface/interchange address combination is specified, then alarms (SYSLOG messages and SNMP traps) are enabled for all ALPS ASCUs.
Global configuration
This command first appeared in Cisco IOS Release 11.3T.
If an interface/interchange address combination is specified, then the alarms are enabled only for the ASCU matching that combination. Up to eight alps enable-alarms ascu commands can be entered to allow a set of ALPS ASCUs to be monitored. ALPS ASCU alarms are only generated at the remote CPE.
The following example enables alarms for ALPS ASCU 42 on interface Serial1:
alps enable-alarms ascu Serial1 42
show alps ascu
Use the alps enable-alarms circuit global configuration command to enable alarms for the ALPS circuits. Use the no form of this command to remove the circuit definition from the configuration.
alps enable-alarms circuit name
name | Name given to identify an ALPS circuit on the remote CPE. |
Global configuration
This command first appeared in Cisco IOS Release 11.3T.
If a valid circuit name is specified, then the alarms are enabled only for the circuit matching the name. Up to eight alps enable-alarms circuit commands can be entered to allow a subset of ALPS circuits to be monitored. ALPS circuit alarms are generated at both the remote (P1024B) CPE and the central (X.25) CPE.
The following example enables alarms for the ALPS circuit named CKT1:
alps enable alarms circuit CKT1
show alps circuits
Use the alps enable-alarms peer global configuration command to enable alarms for the ALPS peers. Use the no form of this command to remove the circuit definition from the configuration, send a close message on the ALPS circuit, and delete any queued messages for the circuit.
alps enable-alarms peer ip-address
ip-address | IP address of the remote peer for which alarms are enabled. |
Global configuration
This command first appeared in Cisco IOS Release 11.3T.
If an IP address is specified, then the alarms are enabled only for the remote peer matching the IP address. Up to eight alps enable-alarms peer commands can be entered to allow a set of ALPS peers to be monitored. ALPS peer alarms are generated at both the remote and the central CPE.
The following example enables alarms for the ALPS peer at IP address 172.22.0.91:
alps enable alarms peer 172.22.0.91
show alps peers
Use the alps enable-ascu ALPS ASCU submode command to move the previously defined ASCU from the inactive poll list to the active poll list. This move results in the protocol handler polling the ASCU and rendering it ready for handling terminal traffic. Use the no form of this command to remove the ASCU from the active poll list to the inactive poll list. This action prevents the ASCU from being polled, rendering it not ready for handling terminal traffic.
alps enable-ascuThis command has no arguments or keywords.
ALPS ASCU submode
This command first appeared in Cisco IOS Release 11.3T.
The following example moves the ASCU to the active poll list:
alps enable-ascu
show alps ascu
Use the alps enable-circuit ALPS circuit submode command to enable the circuit to be activated when data is received from an ASCU. Use the no form of this command to disable the circuit.
alps enable-circuitThis command has no arguments or keywords.
The circuit is disabled by default.
ALPS circuit submode
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies the circuit to be activated when data is received from an ASCU:
alps enable-circuit
show alps circuits
Use the alps error-display ALPS ASCU submode command to specify where error messages about service availability or network problems are displayed. Use the no form of this command to return to the default values.
alps error-display number1 number2
number1 | For P1024B, specifies the terminal address where these service messages are sent. Valid numbers are hexadecimal numbers in the range 0x40 to 0x7F. The default address is 0x72. For P1024C, specifies the screen line number where service messages are displayed. Valid numbers are hexadecimal numbers in the range 0x00 to 0x7F. The default line number is 0x37 |
number2 | For P1024B, specifies the screen line number where service messages are displayed. Valid numbers are hexadecimal numbers in the range 0x40 to 0x7F. The default screen line number is 0x66. For P1024C, specifies the column number where service messages are displayed. Valid numbers are hexadecimal numbers in the range 0x00 to 0x7F. The default column number is 0x20. |
The default terminal address forP1024B is 0x72.
The default screen line for P1024B is 0x20.
ALPS ASCU submode
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies that error messages are displayed at terminal address 6d, on screen line number 78:
alps error-display 6d 78
show alps ascu
Use the alps host-hld host-link interface configuration command to enable ALPS on the X.25 interface. Use the no form of this command to disable ALPS on the X.25 interface.
alps host-hld hld host-link num {{ax25 [damp-tmr value]} | {emtox x.121}}
hld | Host high -level designator. A hexadecimal number in the range |
num | Host-link identifier. A number in the range 1 to 255. |
ax25 | Specifies airline X.25 implementation of X.25. |
damp-tmr | Specifies the AX.25 PVC damping timer. The default is 10 seconds. |
value | Length of time that a PVC can be inactive before it is destroyed and the corresponding ALPS circuits are closed. |
emtox | Specifies EMTOX implementation of X.25. |
x.121 | X.121 address of the EMTOX host (called address on calls to the EMTOX host). |
Interface configuration
This command first appeared in Cisco IOS Release 11.3T.
The following example enables ALPS on an X.25 interface, using the airline X.25 implementation:
alps host-hld 4B10 host-link 3 ax25
Use the alps hostlink ALPS circuit submode command to specify information required to establish an X.25 virtual circuit at the central CPE. Use the no form of this command to remove the circuit definition from the configuration, send a close message on the ALPS circuit, and delete any queued messages for the circuit.
alps hostlink number {ax25 lcn | emtox x121-addr} [winout val1] [winin val2] [ops val3]
number | Interface at the host CPE. Decimal number in the range 1 to 255. |
ax25 | Specifies airline X.25 implementation of X.25. |
lcn | Local channel number for AX.25 connections. |
emtox | Specifies EMTOX implementation of X.25. |
x121-addr | Address for EMTOX connections. |
winout | (Optional) Specifies the X.25 transmit window. |
val1 | Decimal number in the range 1 to 7. |
winin | (Optional) Specifies the X.25 receive window. |
val2 | Decimal number in the range 1 to 7. |
ops | (Optional) Specifies the maximum output packet size. |
val3 | One of the following numbers: 128, 240, 256, 512, 1024, 2048, or 4096. |
ips | (Optional) Specifies the maximum input packet size. |
val4 | One of the following numbers: 128, 240, 256, 512, 1024, 2048, or 4096. |
If these values are not specified, the default values at the X.25-attached central CPE are used.
ALPS circuit submode
This command first appeared in Cisco IOS Release 11.3T.
The following example establishes an X.25 virtual circuit at the central CPE. The configuration specifies airline X.25 implementation. The host CPE interface is 3, the local channel number for airline X.25 connections is 120, and the X.25 transmit window is 3.
alps hostlink 3 ax25 120 winout 3 winin 3
alps circuit
show alps circuit
Use the alps idle-timer ALPS circuit submode command to specify (for on-demand circuits) the length of time that can elapse before an idle circuit is disabled. Use the no form of this command to remove the definition from the configuration.
alps idle-timer timer
timer | Length of time that can elapse before an idle circuit is brought down. The range is 10 to 600 seconds. The default is 60 seconds. |
The default length of time that can elapse before an idle circuit is brought down is 60 seconds.
ALPS circuit submode
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies that an idle circuit is maintained for 90 seconds before it is disabled:
alps idle-timer 90
alps circuit
show alps circuit
Use the alps keepalive global configuration command to enable TCP keepalives for ALPS TCP peer connections. A TCP keepalive request will be sent to the remote peer if the TCP connection to the remote peer is silent for a time period larger than the interval specified. The TCP connection to the ALPS host will be closed when a count equal to the retry count specified is missed consecutively. Use the no form of this command to disable keepalives for ALPS.
alps keepalive [interval time] [retry count]
interval | (Optional) Interval for keepalive requests. |
time | Keepalive interval, in the range 10 to 300 seconds. The default is 30 seconds. |
retry | (Optional) Indicates how many times keepalive requests will be sent before the connection is closed. |
count | Retry count, in the range 1 to 10. The default is 3 retries. |
The default keepalive interval is 30 seconds.
The default retry count is 3.
Global configuration
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies that a TCP keepalive request will be sent to the remote peer if the TCP peer connection is idle for 60 seconds. The connection will be closed after 3 consecutive keepalive requests are sent.
alps keepalive interval 60 retry 8
alps local-peer
Use the alps lifetime-timer ALPS circuit submode command to specify how long messages can be queued in the ALPS circuit queue. Use the no form of this command to remove the definition from the configuration.
alps lifetime-timer timer
timer | Length of time, in seconds, that a message can be queued. The range is 1 to 20 seconds. The default is 4 seconds. |
The default length of time that a message can be queued in the ALPS circuit queue is 4 seconds.
ALPS circuit submode
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies that a message remains in the ALPS circuit queue for no longer than 3 seconds:
alps lifetime-timer 3
alps circuit
show alps circuits
Use the alps local-hld remote-hld ALPS circuit submode command to specify the local and remote HLDs (in hexadecimal) to use for this ALPS circuit. Use the no form of this command to remove the definition from the configuration.
alps local-hld loc-hld remote-hld rem-hld
loc-hld | Local HLD to use for ALPS circuit. Hexadecimal number in the range 0x0101 to 0x7F7F. |
rem-hld | Remote HLD to use for ALPS circuit. Hexadecimal number in the range 0x0101 to 0x7F7F. |
There is no default value for this command.
ALPS circuit submode
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies the local HLD as 4b10 and the remote HLD as 5c00:
alps local-hld 4B10 remote-hld 5c00
alps circuit
show alps circuits
Use the alps local-peer global configuration command to specify the IP address of the local peer. Use the no form of this command to remove all subsequent ALPS configuration commands from the router.
alps local-peer ip-address [promiscuous]
ip-address | IP address of the local peer. |
promiscuous | (Optional) Keyword specified at the central CPE to accept incoming TCP connections from any remote CPE. |
Global configuration
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies the local peer IP address as 172.22.0.91 and specifies that the CPE accepts incoming TCP connections from any CPE:
alps local-peer 172.22.0.91 promiscuous
show alps peers
Use the alps max-msg-length ALPS ASCU submode command to specify maximum input message length. Use the no form of this command to return to the default maximum input message length.
alps max-msg-length value
value | Maximum input message length. The range is 1 to 3840. The default is 962 characters. |
The default maximum input message length is 962 characters.
ALPS ASCU submode
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies that the maximum length of a message is 1000 characters:
alps max-msg-length 1000
Use the alps mpx ALPS circuit submode command to specify the multiplexing and the ASCU identification header for this circuit. Use the no form of this command to remove the definition from the configuration.
alps mpx {group | single} {hdr a1a2}
group | Specifies that multiple ASCUs will be multiplexed on the ALPS circuit. |
single | Specifies that only one ASCU will use this circuit. |
hdr | Specifies the ASCU identification header for the circuit. |
a1a2 | ASCU identification via A1, A2. |
The default for multiplexing is group.
The default header is a1a2.
ALPS circuit submode
This command first appeared in Cisco IOS Release 11.3T.
If alps mpx group is specified, multiple ASCUs will be multiplexed on this ALPS circuit. If alps mpx single is specified, then only one ASCU uses this ALPS circuit. If alps mpx single hdr none is specified, the A1 and A2 ASCU identification information is not added to the front of data frames sent across this circuit, and it is assumed that it does not exist in frames received on this circuit. The exclusion of ASCU identification should only be specified when the EMTOX protocol is used.
Use the alps n1 interface configuration command to specify the threshold of consecutive errors logged before an ASCU is declared down. Use the no form of this command to reassert the default number of consecutive errors before declaring an ASCU down.
alps n1 errors
errors | Error count limit. The valid range is 1 to 30 errors. |
The default error count is 30 errors.
Interface configuration
This command first appeared in Cisco IOS Release 11.3T.
The error count limit is a threshold value. When the threshold is exceeded an SNMP notification is sent to the network management console as a result of the ASCU going down, and the ASCU is moved to the slow poll list.
The following example specifies that an ASCU is declared down when the error count exceeds 1:
alps n1 1
alps ascu
show alps ascu
Use the alps n2 interface configuration command to specify the number of polls that must be correctly replied to before an ASCU is declared up. Use the no form of this command to reassert the default number of polls that must be correctly replied before an ASCU is declared up.
alps n2 polls
polls | Number of polls that must be correctly replied to. The valid range is 1 to 30 polls. The default is 30 polls. |
The default number of polls that must be correctly replied to is 30.
Interface configuration
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies that 30 polls must be correctly replied to before the ASCU is declared up:
alps n2 2
alps ascu
show alps ascu
Use the alps n3 interface configuration command to specify the maximum number of retransmissions of an unacknowledged output data message to an ASCU. Use the no form of this command to reassert the default.
alps n3 value
value | Maximum number of retransmissions of an unacknowledged output data message. When the number is exceeded the output data message is dropped. The valid range is 1 to 10 retransmissions. The default is 3 retransmissions. |
The default number of retransmissions is 3.
Interface configuration
This command first appeared in Cisco IOS Release 12.0(2)T.
This command is valid on 1026C interfaces only.
The following example specifies that 6 is the maximum number of retransmissions of an unacknowledged output data message to an ASCU.:
alps n3 6
alps ascu
show alps ascu
Use the alps poll-pause interface configuration command to set the minimum interval, in microseconds, between 2 polls to the same ASCU. Use the no form of this command to revert to the default interval.
alps poll-pause msec
msec | Minimum interval between polls, in microseconds.The valid range is 10 to 1000 microseconds. The default interval is 50 microseconds. |
The default minimum interval is 50 microseconds.
Interface configuration
This command first appeared in Cisco IOS Release 11.3T.
The following example sets a 200 microsecond minimum interval between polls.
alps poll-pause 200
alps ascu
Use the alps primary-peer ALPS circuit submode command to specify the primary TCP peer and, optionally, a backup TCP peer for this ALPS circuit. Use the no form of this command to remove the definition from the configuration.
alps poll-pause ip-addr]
ip-addr | IP addresses specified in the alps remote-peer commands. |
backup-peer | (Optional) Backup TCP peer for the ALPS circuit. |
ip-addr | IP addresses specified in the alps remote-peer commands. |
ALPS circuit submode
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies a primary peer at IP address 172.22.0.91 and a backup peer at IP address 172.22.0.92:
alps primary-peer 172.22.0.91 backup-peer 172.22.0.92
alps circuit
show alps peers
Use the alps remote-peer global configuration command to specify the IP address of a peer connection to the partner CPE. Use the no form of this command to remove the definition from the configuration.
alps remote-peer ip-addr [dynamic [inact-timer]] [tcp-qlen [num]]
ip-addr | IP address of the peer. |
dynamic | (Optional) Allows the TCP connection to the host peer to be opened only when there is data to be transferred to the host reservation system. |
inact-timer | Length of inactivity, in seconds, after which the connection is closed. The range is 10 to 300 seconds. The default is 60 seconds. |
tcp-qlen | (Optional) Specifies a default number of packets in the queue. |
num | Number of packets allowed in the queue. The range is 26 to 200 packets. The default is 200 packets. |
The default is length of inactivity is 60 seconds.
The default number of packets is 200.
Global configuration
This command first appeared in Cisco IOS Release 11.3T.
Issuing the alps remote-peer command causes the following to occur:
The following example specifies a peer connection at IP address 172.22.0.92 and allows the TCP connection to be opened only when there is data to be transferred:
alps remote-peer 172.22.0.92 dynamic 60
show alps peers
Use the alps retry-option ALPS ASCU submode command to configure the CPE to signal the ASCU whenever an error is detected. Use the no form of this command to reassert the default action of no retry.
alps retry-option {resend | reenter}
resend | Specify the retry option as resend. This option causes an indicator LED to signal the operator at the ASCU to resend data. |
reenter | Specify the retry option as reenter. This option causes a service message to signal the operator at the ASCU to reenter data. |
The default retry option is no retry.
ALPS ASCU submode
This command first appeared in Cisco IOS Release 11.3T.
This command is applicable only for P1024B (ALC) interfaces; it is invalid on P1024C (UTS) interfaces.
The following example specifies that an indicator LED signals the ASCU to resend data:
alps retry-option resend
alps ascu
show alps ascu
Use the alps service-msg-interval ALPS circuit submode command to specify the interval between consecutive transmissions of service messages from the remote CPE to the ASCU. Use the no form of this command to remove the definition from the configuration.
alps service-msg-interval seconds
seconds | Interval, in seconds, between consecutive transmissions of service messages from the remote CPE to the ASCU. The range is 1 to 20 seconds. The default interval is 4 seconds. |
The default interval between consecutive transmissions of service messages from the remote CPE to the ASCU is 4 seconds.
ALPS circuit submode
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies an interval of 3 seconds between transmission of service messages from the CPE to the ASCU:
alps service-msg-interval 3
alps circuit
alps service-msg-list
Use the alps service-msg-list ALPS circuit submode command to define the service message list to be used for this circuit. Use the no form of this command to remove the list from the circuit configuration, thus issuing no service messages until another list is configured.
alps service-msg-list list
list | The service message list to be used for this circuit. The valid numbers are 1 to 8. |
ALPS circuit submode
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies that message list 1 is used for this circuit:
alps service-msg-list 1
alps circuit
alps service-msg-interval
Use the alps service-msg-list number global configuration command to define the service message identity and its contents for a service message list. Use the no form of this command to remove a service-msg number from the service message list configuration.
alps service-msg-list list number number msg
list | The service message list to be used for this circuit. The valid numbers are 1 to 8 |
number | Specify a list number. |
number | List number. Valid numbers are 1 to 8. |
msg | Contents of a service message. |
The default service message will be used for this service message list.
Global configuration
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies the text of message list 1, message number 2:
alps service-msg-list 1 number 2 "Turn off the terminal NOW."
Use the alps servlim interface configuration command to specify the number of polls of the ASCU UP list allowed between two successive polls of the ASCU DOWN list. Use the no form of this command to reassert the default number of cycles through the normal (active) poll list allowed before the slow poll list is processed.
alps servlim polls
polls | Number of polls of the ASCU UP list. The valid range is 1 to 30 polls. The default is 30 polls. |
The default number of polls of the ASCU UP list allowed between two successive polls of the ASCU DOWN list is 30 polls.
Interface configuration
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies
alps servlim 5
Use the alps t1 interface configuration command to specify the time-out delay between polling and response. Use the no form of this command to reassert the default poll timeout value of 0.5 seconds.
alps t1 delay
delay | Timeout delay, in seconds, between polling and response. The valid range is 1 to 10 tenths of a second (.1 to 1 second). The default is 5 tenths of a second (.5 second). |
The default time-out delay between polling and response is 5 tenths of a second (.5 second).
Interface configuration
This command first appeared in Cisco IOS Release 11.3T.
The following example specifies a .5-second time-out delay between polling and response:
alps t1 5
Use the alps t2 interface configuration command to specify the time-out delay between receipt of the first character of an I/P sequence solicited by a poll and receipt of a Go Ahead (GA) sequence. Use the no form of this command to reassert the default timeout value of 6 seconds.
alps t2 delay
delay | Timeout delay, in seconds, between receipt of first character of an I/P sequence solicited by a poll and receipt of Go Ahead (GA) sequence. The valid range is 1 to 10 seconds. The default is 6 seconds. |
The default timeout delay between receipt of first character of an I/P sequence solicited by a poll and receipt of Go Ahead (GA) sequence is 6 seconds.
Interface configuration
This command first appeared in Cisco IOS Release 11.3T.
This command is applicable only for P1024B (ALC) interfaces; it is invalid on P1024C (UTS) interfaces.
The following example specifies a time-out delay of 6 seconds between receipt of the first character of an I/P sequence solicited by a poll and receipt of a Go Ahead sequence:
alps t2 6
Use the alps translate interface configuration command to map an X.121 address to an IP address of a remote peer. Use the no form of this command to remove mapping from the configuration.
alps translate x.121-addr ip-addr
x.121-addr | X.121 address to be mapped to an IP address of a remote peer. |
ip-addr | IP address of the remote peer. |
Interface configuration
This command first appeared in Cisco IOS Release 11.3T.
The X.121 address is compared to the Called Address on inbound X.25 call packets to determine if the call should be accepted. The X.121 address may have an asterisk (*) at the end to indicate "all X.121 addresses prefixed with the address before the *".
The following example maps all X.121 addresses prefixed with the address 88845 to the remote peer IP address 172.22.0.90:
alps translate 88845* 172.22.0.90
encapsulation x25
Use the clear alps circuits EXEC command to remove configured ALPS circuits.
clear alps circuits [ipaddr | name]
ipaddr | Clear ALPS circuits for peer with specified IP address. |
name | Clear ALPS circuits for peer with specified name. |
If no IP address or name is specified, the command clears all ALPS circuits.
EXEC
This command first appeared in Cisco IOS Release 11.3T.
The following example clears the ALPS circuit named CKT1:
clear alps circuits name CKT1
alps circuit
show alps circuit
Use the clear alps counters EXEC command to clear all counters relevant to the ALPS feature.
clear alps countersThis command has no arguments or keywords.
EXEC
This command first appeared in Cisco IOS Release 11.3T.
The following command clear all counters for the ALPS feature:
clear alps counters
show alps ascu
show alps circuits
show alps peers
Use the encapsulation alc interface configuration command to specify that the P1024B protocol will be used on the serial interface. Use the no form of this command to remove P1024B protocol handling from the serial interface, and return the default encapsulation (HDLC) to the interface.
encapsulation alcThis command has no arguments or keywords.
Interface configuration
This command first appeared in Cisco IOS Release 11.3T.
The encapsulation alc command causes any ASCU configuration to be removed from the interface. As each ASCU defined on the interface is removed it is also unlinked from the ASCU circuit it belongs to. All data frames queued for transmission to the ASCU are destroyed.
This encapsulation command must be entered prior to any ASCU configuration. Note that all timer and counter values are applicable to all ASCUs on the interface.
The following example specifies that the P1024B protocol is used:
encapsulation alc
show interface
Use the encapsulation uts interface configuration command to specify that the P1024C protocol will be used on the serial interface. Use the no form of this command to remove P1024C protocol handling from the serial interface, and return the default encapsulation (HDLC) to the interface.
encapsulation utsThis command has no arguments or keywords.
Interface configuration
This command first appeared in Cisco IOS Release 11.3T.
The encapsulation uts command causes any ASCU configuration to be removed from the interface. As each ASCU defined on the interface is removed it is also unlinked from the ASCU circuit it belongs to. All data frames queued for transmission to the ASCU are destroyed.
This encapsulation command must be entered prior to any ASCU configuration. Note that all timer and counter values are applicable to all ASCUs on the interface.
The following example specifies that the P1024C protocol is used:
encapsulation uts
show interface
Use the show alps ascu EXEC command to display the status of the ALPS ASCU.
show alps ascu [interface ia] [detail]
interface ia | (Optional) Combined interface and IA. If specified, only the status of that ASCU is displayed. |
detail | (Optional) Long display of output. |
EXEC
This command first appeared in Cisco IOS Release 11.3T.
Brief sample display of remote CPE
router# show alps ascu interfacedlciaa1a2circuitpkt_txpkt_rxstate -------------------------------------------------------------------------------------- Serial6ALC422449AX_CKT105105UP Serial6ALC464652EM_CKT00UP
Detailed sample display of remote CPE
router # show alps ascu detail ascu 42 on i/f Serial6, dlc = ALC, state = UP default-circuit = AX_CKT, a1 = 24, a2 = 49 retry_option = resend, max_msg_len = 962 err_disp_terminal = 0, err_disp_line = 0 pkt_tx = 105, byte_tx = 1050, pkt_rx = 105, byte_rx = 1050 drops = 0, erroneous_msgs = 0, bad_ccc = 0 ascu 46 on i/f Serial6, dlc = ALC, state = UP default-circuit = EM_CKT, a1 = 46, a2 = 52 retry_option = reenter, max_msg_len = 962 err_disp_terminal = 0, err_disp_line = 0 pkt_tx = 0, byte_tx = 0, pkt_rx = 0, byte_rx = 0 drops = 0, erroneous_msgs = 0, bad_ccc = 0
alps ascu
Use the show alps circuits EXEC command to display the status of the ALPS circuits. If a circuit name is specified, than only the status of that circuit will be displayed; otherwise, the status of all circuits will be displayed.
show alps circuits [name name] [detail]
name | If specified, only the status of that ASCU is displayed. |
name | If specified, only the status of that ASCU is displayed. |
detail | (Optional) Long display of output. |
EXEC
This command first appeared in Cisco IOS Release 11.3T.
Brief sample display of central CPE
router# show alps circuits namepri_peercurr_peer dlcstatepkt_txpkt_rx --------------------------------------------------------------------------------- AX_CKT172.18.3.141172.18.3.141AX25OPEN5757 EM_CKT172.18.3.141172.18.3.141EMTOXOPEN00
Detailed sample display on central CPE
router# show alps circuits detail AX_CKT: dlc = AX25, peer = 172.18.3.141, state = OPEN, uptime = 00:00:00 i/f = Serial2, host_link = 1, host_hld = 700, remote_hld = 145 lcn = 33, nonstd_240 = TRUE damping_tmr = 10, lifetime_tmr = 4 pkt_tx = 57, byte_tx = 1311, pkt_rx = 57, byte_rx = 1311 src_corr = 5063224, dst_corr = 88D990 drops_q_overflow = 0, drops_lifetime_exceeded = 0, drops_vc_reset = 0 ascus: (24,49), EM_CKT: dlc = EMTOX, peer = 172.18.3.141, state = OPEN, uptime = 00:00:00 i/f = Serial3, host_link = 3, host_hld = 1200, remote_hld = 145 lcn = 1, host_x121 = 22233, remote_x121 = 44005 damping_tmr = 0, lifetime_tmr = 4 pkt_tx = 0, byte_tx = 0, pkt_rx = 0, byte_rx = 0 src_corr = 502F220, dst_corr = 88DBF8 drops_q_overflow = 0, drops_lifetime_exceeded = 0, drops_vc_reset = 0 ascus: (46,52),
Brief sample display on remote CPE
router# show alps circuits namepri_peercurr_peer dlcstatepkt_txpkt_rx --------------------------------------------------------------------------------- AX_CKT172.18.3.27172.18.3.27ALCOPEN105105 EM_CKT172.18.3.27172.18.3.27ALCOPEN00
Detailed sample display on remote CPE
router# show alps circuits detail AX_CKT: dlc = ALC, conn_type = DYN, state = OPEN, uptime = 00:00:00 pri_peer = 172.18.3.27, sec_peer = 0.0.0.0, curr_peer = 172.18.3.27 local_hld = 145, remote_hld = 700 ax25: hostlink = 1, lcn = 33 lifetime_tmr = 4, idle_tmr = 60, retry_tmr = 0 pkt_tx = 105, byte_tx = 2415, pkt_rx = 105, byte_rx = 2415 src_corr = 9A1760, dst_corr = 50333C8 drops_q_overflow = 0, drops_ckt_disabled = 0 drops_lifetime_tmr = 0, drops_invalid_ascu = 0 ascus: (24,49), EM_CKT: dlc = ALC, conn_type = PERM, state = OPEN, uptime = 00:00:00 pri_peer = 172.18.3.27, sec_peer = 0.0.0.0, curr_peer = 172.18.3.27 ocal_hld = 145, remote_hld = 1200 emtox: hostlink = 3, x121 = 44005 lifetime_tmr = 4, idle_tmr = 60, retry_tmr = 10 pkt_tx = 0, byte_tx = 0, pkt_rx = 0, byte_rx = 0 src_corr = 9A18D4, dst_corr = 8FB520 drops_q_overflow = 0, drops_ckt_disabled = 0 drops_lifetime_tmr = 0, drops_invalid_ascu = 0 ascus: (46,52),
alps circuit
Use the show alps peers EXEC command to display the status of the ALPS remote peers. If an IP address is specified, than only the status of that peer will be displayed; otherwise, the status of all peers will be displayed.
show alps peers [ipaddress addr] [detail]
ipaddress | If specified, only the status of that ASCU is displayed. |
addr | If specified, only the status of that ASCU is displayed. |
detail | (Optional) Long display of output. |
EXEC
This command first appeared in Cisco IOS Release 11.3T.
Brief sample display of remote CPE
router# show alps peers local_peer : ip_address = 172.18.3.141 ip_addressrolestatetypepkt_txpkt_rx -------------------------------------------------------------------------------------- 172.18.3.27PRIOPENEDPERM00
Detailed sample display of remote CPE
router # show alps peers detail local_peer : ip_address = 172.18.3.141 TCP: 172.18.3.27, type = PERM, create = ADMIN, state = OPENED, uptime = 00:08:21 pkt_tx = 0, byte_tx = 0, pkt_rx = 0, byte_rx = 0 drops_giants = 0, drops_q_overflow = 0, drops_peer_down = 0, drops_ver_mismatch = 0 active_ckts: CKT1, CKT2
alps primary-peer
alps remote-peer
Use the show interface EXEC command to display P1024B/C information.
show interfaceThis command has no arguments or keywords.
EXEC
This command first appeared in Cisco IOS Release 10.0.
The following output shows P1024B information for the serial 2 interface.
router# show interface s2 Serial2 is up, line protocol is up Hardware is CD2430 MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255 Encapsulation ALC role: Primary ascus in UP state: 42, 46 ascus in DOWN state: ascus DISABLED: Last input never, output never, output hang never Last clearing of "show interface" counters never Queueing strategy: fifo Output queue 0/40, 0 drops; input queue 0/75, 0 drops 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes, 0 no buffer Received 0 broadcasts, 0 runts, 0 giants 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort 0 packets output, 0 bytes, 0 underruns 0 output errors, 0 collisions, 3 interface resets 0 output buffer failures, 0 output buffers swapped out DCD=down DSR=down DTR=down RTS=down CTS=down
This section documents the ALPS debug commands. The ALPS debug commands are available for the privileged user to monitor ALPS traffic. A range of command modifiers is available to limit the output to the specific area of interest.
Use the debug alps ascu EXEC command to enable debugging for ALPS ASCUs. Use the no form of this command to disable debugging.
debug alps ascu {event | packet | detail | all} [interface ia]
event | Display ALC abnormal events or protocol errors. |
packet | Display transmitted or received packets. |
detail | Display all ALC protocol events. |
all | Enable event, packet, and detail debugging. |
interface ia | (Optional) Enable debugging for a specified ASCU. |
If no ASCU is specified, debugging is enabled for all ASCUs.
EXEC
This command first appeared in Cisco IOS Release 11.3T.
To enable debugging for a group of ASCUs enter a separate command for each ASCU interface and IA combination.
The following is output from the debug alps ascu command, showing abnormal events or protocol errors for ASCU 42 on interface Serial7:
alps-rcpe#debug alps ascu event Serial7 42 ALPS ASCU: T1 expired for ascu 42 on i/f Serial7 ALPS ASCU: DOWN event while UP for ascu 42 on i/f Serial7 : C1 count = 1
The following is output from the debug alps ascu command, showing all protocol events for ASCU 42 on interface Serial6:
alps-rcpe#debug alps ascu detail Serial6 42 ALPS ASCU: Tx ALC POLL MSG (3 bytes + CCC) to ascu 42 on i/f Serial6 ALPS ASCU: ALC GO AHD MSG rcvd from ascu 42 on i/f Serial6 ALPS ASCU: Tx ALC POLL MSG (3 bytes + CCC) to ascu 42 on i/f Serial6 ALPS ASCU: ALC GO AHD MSG rcvd from ascu 42 on i/f Serial6 ALPS ASCU: Tx ALC POLL MSG (3 bytes + CCC) to ascu 42 on i/f Serial6 ALPS ASCU: Rx ALC DATA MSG (14 bytes + CCC) from ascu 42 on i/f Serial6, fwd ckt RTP_AX25 ALPS ASCU: ALC GO AHD MSG rcvd from ascu 42 on i/f Serial6 ALPS ASCU: Tx ALC DATA MSG (14 bytes + CCC) to ascu 42 on i/f Serial6 ALPS ASCU: Tx ALC POLL MSG (3 bytes + CCC) to ascu 42 on i/f Serial6
The following is output from the debug alps ascu command, showing all packets transmitted or received for ASCU 42 on interface Serial6:
alps-rcpe#debug alps ascu packet Serial6 42 ALPS ASCU: Tx ALC SERVICE MSG (18 bytes + CCC) to ascu 42 on i/f Serial6 0405B530: 02321D26 0C261616 0405B540: 140C0D18 26163135 0611C6 ALPS ASCU: Rx ALC DATA MSG (14 bytes + CCC) from ascu 42 on i/f Serial6, fwd ckt RTP_AX25 040730B0: 42607866 65717866 040730C0: 65717966 755124 ALPS ASCU: Tx ALC DATA MSG (14 bytes + CCC) to ascu 42 on i/f Serial6 0405B540: 022038 26253138 0405B550: 26253139 263511E4
Use the debug alps circuit event EXEC command to enable event debugging for ALPS circuits. Use the no form of this command to disable debugging.
debug alps circuit event [name]
name | Name given to identify an ALPS circuit on the remote CPE. |
If no circuit name is specified, then debugging is enabled for every ALPS circuit.
EXEC
This command first appeared in Cisco IOS Release 11.3T.
To enable debugging for a single ALPS circuit, specify the name of the circuit.
To enable debugging for a group of circuits, enter a separate command for each circuit name.
The following is sample output from the debug alps circuit event command for circuit RTP_AX25:
alps-rcpe#debug alps circuit event RTP_AX25 ALPS P1024 CKT: FSM - Ckt= RTP_AX25, State= OPEN, Event= DISABLE: (CloseAndDisable)->DISC ALPS P1024 CKT: FSM - Ckt= RTP_AX25, State= DISC, Event= ENABLE: (TmrStartNullRetry)->INOP ALPS P1024 CKT: Ckt= RTP_AX25, Open - peer set to 200.100.40.2 ALPS P1024 CKT: Ckt= RTP_AX25, Open - peer open. ALPS P1024 CKT: FSM - Ckt= RTP_AX25, State= INOP, Event= RETRY_TIMEOUT: (Open)->OPNG ALPS P1024 CKT: FSM - Ckt= RTP_AX25, State= OPNG, Event= CKT_OPEN_CFM: (CacheAndFwdAscuData)->OPEN alps-ccpe#debug alps circuit event RTP_AX25 ALPS AX.25 FSM: Ckt= RTP_AX25, State= OPEN, Event= CktClose, Rsn= 12: (PvcKill,CktRemove,TmrStartClose)->INOP ALPS AX.25 FSM: Ckt= RTP_AX25, State= INOP, Event= X25PvcInact, Rsn= 0: (-,-,-)->INOP ALPS AX.25 FSM: Ckt= RTP_AX25, State= INOP, Event= X25VcDeleted, Rsn= 0: (-,CktDestroy,TmrStop)->INOP ALPS AX.25 FSM: Ckt= RTP_AX25, State= INOP, Event= CktOpReq, Rsn= 4: (PvcMake,CktAdd,TmrStartOpen)->OPNG ALPS AX.25 FSM: Ckt= RTP_AX25, State= OPNG, Event= X25ResetTx, Rsn= 0: (-,-,-)->OPNG ALPS AX.25 FSM: Ckt= RTP_AX25, State= OPNG, Event= X25VcUp, Rsn= 0: (-,OpnCfm,TmrStop)->OPEN
Use the debug alps peer event EXEC command to enable event debugging for ALPS peers. Use the no form of this command to disable debugging.
debug alps peer event ipaddr
ipaddr | (Optional) Peer IP address. |
If no IP address is specified, then debugging is enabled for every peer connection.
EXEC
This command first appeared in Cisco IOS Release 11.3T.
To enable debugging for a single remote ALPS peer, specify the peer IP address.
To enable debugging for a set of remote peers, enter the command for each peer IP address.
The following is sample output from the debug alps peer event command:
alps-ccpe#debug alps peer event ALPS PEER: FSM - Peer 200.100.25.2, Event ALPS_CLOSED_IND, State OPENED ALPS PEER: peer 200.100.25.2 closed - closing peer circuits. ALPS PEER: Promiscuous peer created for 200.100.25.2 ALPS PEER: TCP Listen - passive open 200.100.25.2(11003) -> 10000 ALPS PEER: FSM - Peer 200.100.25.2, Event ALPS_OPEN_IND, State DISCONN ALPS PEER: peer 200.100.25.2 opened OK.
This feature supports the following MIBs:
For descriptions of supported MIBs and how to use MIBs, see Cisco's MIB website on CCO at http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.
This feature supports the following RFCs:
Posted: Wed May 12 14:44:24 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.