Table Of Contents
alps connection-type permanent
alps service-msg status-change
Airline Product Set Commands
Use the commands in this chapter to configure and monitor the Airline Product Set (ALPS). For ALPS configuration information and examples, refer to the "Configuring the Airline Product Set" chapter in the Cisco IOS Bridging and IBM Networking Configuration Guide.
alps a1-map a2-map
To specify the A1 and A2 logical ASCU identification information, use the alps a1-map a2-map ALPS ASCU submode command. To remove the specification of the A1 and A2 logical ASCU identification information, use the no form of this command.
alps a1-map a1-value a2-map a2-value
no alps a1-map a1-value a2-map a2-value
Syntax Description
Defaults
No default behavior or values.
Command Modes
ALPS ASCU submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
12.0(2)T
The range values were modified.
12.0(5)T
The range values were modified.
Examples
The following example specifies the A1 identification as 0x4C and the A2 identification as 0x20:
alps a1-map 4C a2-map 20Related Commands
alps alias
To specify that an ALC ASCU is to operate in nonpolling mode, and to specify the parent ASCU interchange address to which this ASCU is aliased, use the alps alias ALPS ASCU configuration command. To return the ASCU to polled mode, use the no form of this command.
alps alias alias-interchange-address
no alps alias alias-interchange-address
Syntax Description
alias-interchange-address
Specifies the interchange address of the polled (alias) ASCU with which to associate this non-polled ASCU. Valid range is between 41 and 7E, except 43, 44, 50 to 53, and 60.
Defaults
If you do not specify the alps alias command, the ASCU functions in normal polled mode. You must specify the alps alias command to enable non-polled handling.
Command Modes
ALPS ASCU configuration
Command History
Usage Guidelines
This command applies only to ALC ASCUs.
By default, an ALC ASCU cannot send data to a remote router until it is polled by that router. However, you can use this command to configure non-polled ALC ASCUs.
A non-polled ASCU must be associated with another, polled ASCU, known as the alias ASCU. When a remote router polls the alias ASCU, the router accepts data from that ASCU and from all non-polled ASCUs associated with that ASCU. The non-polled ASCUs present the same characteristics to the host as the alias ASCU, so the current ASCU configuration is maintained.
This command does not impact the ALC send path or the circuit management code.
Examples
The following example sets the ALC ASCU with interchange address 4B to operate in nonpolling mode and sets 42 as the alias interchange address:
Router(config-if)# alps ascu 4BRouter(config-alps-ascu)# alps alias 42Related Commands
alps ascu
Specifies a physical ASCU identity.
show alps ascu
Displays the status of the ALPS ASCU.
alps ascu
To specify a physical ASCU identity, use the alps ascu interface configuration command. To remove the ASCU from the interface and delete any messages queued for transmission to the ASCU or the network, use the no form of this command.
alps ascu id
no alps ascu id
Syntax Description
id
ASCU identification. Valid range is between 41 and 7E, except 43, 44, 50 to 53, and 60. The UTS valid range is between 21 and 4F.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Usage Guidelines
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.
Examples
The following example specifies the interchange address as 4B:
alps ascu 4BRelated Commands
encapsulation uts
Specifies that the P1024C UTS protocol is used on the serial interface.
encapsulation alc
Specifies that the P1024B ALC protocol is used on the serial interface.
alps auto-reset
To automatically reset a non-responsive ALC ASCU in the DOWN state, use the alps auto-reset ALPS ASCU submode command. To disable the automatic reset, use the no form of this command.
alps auto-reset
no alps auto-reset
Syntax Description
This command has no arguments or keywords.
Defaults
Automatic ASCU reset is disabled by default.
Command Modes
ALPS ASCU submode
Command History
Usage Guidelines
This command applies only to ALC ASCUs.
Examples
The following example configures automatic reset for all non-responsive ASCUs in the DOWN state:
alps auto-resetRelated Commands
Specifies a physical ASCU identity.
encapsulation alc
Specifies that the P1024B ALC protocol is used on the serial interface.
alps circuit
To specify an ALPS circuit at the remote CPE across a TCP/IP connection, use the alps circuit global configuration 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, use the no form of this command.
alps circuit name
no alps circuit name
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Usage Guidelines
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. ALPS X.25 circuits (at the central CPE) are always dynamically created and are never created using this command.
Examples
The following example specifies the name of the ALPS circuit at the remote CPE as CKT1:
alps circuit CKT1Related Commands
alps connection-type permanent
To specify that this circuit should be established when the circuit is enabled, use the alps connection-type permanent ALPS circuit submode command. To remove the permanent activation behavior and return the behavior to the default dynamic activation, use the no form of this command.
alps connection-type permanent [retry-timer]
no alps connection-type permanent [retry-timer]
Syntax Description
Defaults
The default is 30 seconds.
Command Modes
ALPS circuit submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
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 30Related Commands
alps default-circuit
To specify the ALPS circuit that this ASCU uses, use the alps default-circuit ALPS ASCU submode command. To remove the default circuit specification, use the no form of this command.
alps default-circuit name
no alps default-circuit name
Syntax Description
Defaults
No default behavior or values.
Command Modes
ALPS ASCU submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
The following example specifies that ALPS circuit to be used is CKT1:
alps default-circuit CKT1Related Commands
alps enable-alarms ascu
To enable alarms for the ALPS ASCUs, use the alps enable-alarms ascu global configuration command at the remote CPE. To disable alarms for the ALPS ASCUs, use the no form of this command.
alps enable-alarms ascu [interface id]
no alps enable-alarms ascu
Syntax Description
Defaults
If no interface and interchange address combination is specified, then alarms (SYSLOG messages and SNMP traps) are enabled for all ALPS ASCUs.
Command Modes
Global configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Usage Guidelines
If an interface and 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.
Examples
The following example enables alarms for ALPS ASCU 42 on serial interface 1:
alps enable-alarms ascu Serial1 42Related Commands
alps enable-alarms circuit
To enable alarms for the ALPS circuits, use the alps enable-alarms circuit global configuration command. To remove the circuit definition from the configuration, use the no form of this command.
alps enable-alarms circuit [name]
no alps enable-alarms circuit [name]
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Usage Guidelines
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 ALC CPE and the central (X.25) CPE.
Examples
The following example enables alarms for the ALPS circuit named CKT1:
alps enable alarms circuit CKT1Related Commands
alps enable-alarms peer
To enable alarms for the ALPS peers, use the alps enable-alarms peer global configuration 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, use the no form of this command.
alps enable-alarms peer [ip-address]
no alps enable-alarms peer [ip-address]
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Usage Guidelines
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.
Examples
The following example enables alarms for the ALPS peer at IP address 172.22.0.91:
alps enable alarms peer 172.22.0.91Related Commands
alps enable-ascu
To move the previously defined ASCU from the inactive poll list to the active poll list, use the alps enable-ascu ALPS ASCU submode command. This move results in the protocol handler polling the ASCU and rendering it ready for handling terminal traffic. To remove the ASCU from the active poll list to the inactive poll list, use the no form of this command. This action prevents the ASCU from being polled, rendering it not ready for handling terminal traffic.
alps enable-ascu
no alps enable-ascu
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
ALPS ASCU submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
The following example moves the ASCU to the active poll list:
alps enable-ascuRelated Commands
alps enable-circuit
To enable the circuit to be activated when data is received from an ASCU, use the alps enable-circuit ALPS circuit submode command. To disable the circuit, use the no form of this command.
alps enable-circuit
no alps enable-circuit
Syntax Description
This command has no arguments or keywords.
Defaults
The circuit is disabled by default.
Command Modes
ALPS circuit submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
The following example specifies the circuit to be activated when data is received from an ASCU:
alps enable-circuitRelated Commands
alps error-display
To specify where error messages about service availability or network problems are displayed, use the alps error-display ALPS ASCU submode command. To return to the default values, use the no form of this command.
alps error-display number1 number2
no alps error-display number1 number2
Syntax Description
Defaults
The default terminal address for P1024B ALC is 0x72.
The default screen line for P1024B ALC is 0x20.
The default line number for P1024C UTS is 0x37.
The default column number for P1024C UTS is 0x20.
Command Modes
ALPS ASCU submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
The following example specifies that error messages are displayed at terminal address 6d, on screen line number 78:
alps error-display 6d 78Related Commands
alps host-hld host-link
To enable ALPS on the X.25 interface, use the alps host-hld host-link interface configuration command. To disable ALPS on the X.25 interface, use the no form of this command.
alps host-hld hld host-link number {{ax25 [damp-tmr value]} | {emtox x.121 [pseudo-conv]}} [life-tmr value] [reply-tmr value]
no alps host-hld hld host-link number {{ax25 [damp-tmr value]} | {emtox x.121 [pseudo-conv]}} [life-tmr value] [reply-tmr value]
Syntax Description
Defaults
The default damping timer value is 10 seconds.
The default no-reply timer value is 60 seconds.
Command Modes
Interface configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Related Commands
alps hostlink
To specify information required to establish an X.25 virtual circuit at the central CPE, use the alps hostlink ALPS circuit submode 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, use the no form of this command.
alps hostlink number {ax25 lcn | emtox x121-address} [winout val1] [winin val2] [ops val3] [ips val4]
no alps hostlink number {ax25 lcn | emtox x121-address} [winout val1] [winin val2] [ops val3] [ips val4]
Syntax Description
Defaults
If no values are specified, the default values at the X.25-attached central CPE are used.
Command Modes
ALPS circuit submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
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 send window is 3.
alps hostlink 3 ax25 120 winout 3 winin 3Related Commands
Automatically resets a nonresponsive ALC ASCU in the DOWN state.
Displays the status of the ALPS circuits.
alps idle-timer
To specify (for dynamic circuits) the length of time that can elapse before an idle circuit is disabled, use the alps idle-timer ALPS circuit submode command. To return to the default idle-timer value, use the no form of this command.
alps idle-timer timer
no alps idle-timer timer
Syntax Description
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.
Defaults
The default length of time that can elapse before an idle circuit is brought down is 60 seconds.
Command Modes
ALPS circuit submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
The following example specifies that an idle circuit is maintained for 90 seconds before it is disabled:
alps idle-timer 90Related Commands
Automatically resets a nonresponsive ALC ASCU in the DOWN state.
Displays the status of the ALPS circuits.
alps keepalive
To enable TCP keepalives for ALPS TCP peer connections, use the alps keepalive global configuration command. 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. To disable keepalives for ALPS, use the no form of this command.
alps keepalive [interval time] [retry count]
no alps keepalive [interval time] [retry count]
Syntax Description
Defaults
The default keepalive interval is 30 seconds.
The default retry count is 3.
Command Modes
Global configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
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 8Related Commands
alps lifetime-timer
To specify how long messages can be queued in the ALPS circuit queue awaiting transmission to the central CPE, use the alps lifetime-timer ALPS circuit submode command. To return to the default lifetime-timer value, use the no form of this command.
alps lifetime-timer timer
no alps lifetime-timer timer
Syntax Description
timer
Length of time, in seconds, that a message can be queued. The range is 1 to 20 seconds. The default is 4 seconds.
Defaults
The default length of time that a message can be queued in the ALPS circuit queue is 4 seconds.
Command Modes
ALPS circuit submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Usage Guidelines
Messages that exceed the timer limit are discarded.
Examples
The following example specifies that a message remains in the ALPS circuit queue for no longer than 3 seconds:
alps lifetime-timer 3Related Commands
Automatically resets a nonresponsive ALC ASCU in the DOWN state.
Displays the status of the ALPS circuits.
alps local-hld remote-hld
To specify the local and remote HLDs to use for this ALPS circuit, use the alps local-hld remote-hld ALPS circuit submode command. To remove the definition from the configuration, use the no form of this command.
alps local-hld loc-hld remote-hld rem-hld
no alps local-hld loc-hld remote-hld rem-hld
Syntax Description
loc-hld
Local HLD to use for ALPS circuit. Hexadecimal number in the range 1 to FFFF.
rem-hld
Remote HLD to use for ALPS circuit. Hexadecimal number in the range 1 to FFFF.
Defaults
No default behavior or values.
Command Modes
ALPS circuit submode
Command History
Usage Guidelines
The remote-hld keyword is not applicable for ALPS with MATIP.
Examples
The following example specifies the local HLD as 4B10:
alps local-hld 4B10Related Commands
Automatically resets a nonresponsive ALC ASCU in the DOWN state.
Displays the status of the ALPS circuits.
alps local-peer
To specify the IP address of the local peer, use the alps local-peer global configuration command. To remove all subsequent ALPS configuration commands from the router, use the no form of this command.
alps local-peer ip-address [promiscuous]
no alps local-peer ip-address [promiscuous]
Syntax Description
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.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
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 promiscuousRelated Commands
alps matip-close-delay
To specify the interval between the closing and reopening of MATIP circuit connections, use the alps matip-close-delay ALPS circuit submode command. To restore the definition to the default value, use the no form of this command.
alps matip-close-delay time
no alps matip-close-delay time
Syntax Description
time
Minimum number of seconds between the closing and reopening of an ALPS MATIP circuit. The range is 1 to 90 seconds. The default is 10 seconds.
Defaults
The default value is 10 seconds.
Command Modes
ALPS circuit submode
Command History
Examples
The following example specifies a close delay time of 20 seconds:
alps matip-close-delay 20Related Commands
alps max-msg-length
To specify maximum input message length, use the alps max-msg-length ALPS ASCU submode command. To return to the default maximum input message length, use the no form of this command.
alps max-msg-length value
no alps max-msg-length value
Syntax Description
Defaults
The default maximum input message length is 962 characters.
Command Modes
ALPS ASCU submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
The following example specifies that the maximum length of a message is 1000 characters:
alps max-msg-length 1000alps mpx
To specify the multiplexing and the ASCU identification header for this circuit, use the alps mpx ALPS circuit submode command. To remove the definition from the configuration, use the no form of this command.
alps mpx {group | single} hdr {a1a2 | none}
no alps mpx {group | single} hdr {a1a2 | none}
Syntax Description
Defaults
The default for multiplexing is group.
The default header is a1a2.
Command Modes
ALPS circuit submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Usage Guidelines
If alps mpx group is specified, multiple ASCUs will be multiplexed on this ALPS circuit and the none option is not applicable. 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.
alps n1
To specify the threshold of consecutive errors logged before an ASCU is declared down, use the alps n1 interface configuration command. To reassert the default number of consecutive errors before declaring an ASCU down, use the no form of this command.
alps n1 errors
no alps n1 errors
Syntax Description
errors
Error count limit. The valid range is 1 to 30 errors. The default for ALC is 30 errors. The default for UTS is 10 errors.
Defaults
The default ALC error count is 30 errors.
The default UTS error count is 10 errors.
Command Modes
Interface configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
12.0(2)T
The error ranges were modified.
Usage Guidelines
The error count limit is a threshold value. If the ASCU state is UP and the error count threshold is exceeded, the ASCU state changes to DOWN and it is moved to the inactive poll. If alarms are enabled for the ASCU, a SYSLOG message is displayed and an SNMP notification is sent to the SNMP network management station.
Examples
The following example specifies that an ASCU is declared down when the error count exceeds 1:
alps n1 1Related Commands
Specifies a physical ASCU identity.
Specifies that the P1024C UTS protocol will be used on the serial interface.
alps n2
To specify the number of polls that must be correctly replied to before an ASCU is declared up, use the alps n2 interface configuration command. To reassert the default number of polls that must be correctly replied before an ASCU is declared up, use the no form of this command.
alps n2 polls
no alps n2 polls
Syntax Description
polls
Number of polls that must be correctly replied to. The valid range is 1 to 30 polls. The default is 1 poll.
Defaults
The default number of polls that must be correctly replied to is 1.
Command Modes
Interface configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Usage Guidelines
If the ASCU state is DOWN and the reply threshold is exceeded, the ASCU state changes to UP and the ASCU is moved to the active poll list. If alarms are enabled for the ASCU, a SYSLOG message is displayed and an SNMP notification is sent to the SNMP management station.
Examples
The following example specifies that 2 polls must be correctly replied to before the ASCU is declared up:
alps n2 2Related Commands
Specifies a physical ASCU identity.
Specifies that the P1024C UTS protocol will be used on the serial interface.
alps n3
To specify the maximum number of retransmissions of an unacknowledged output data message to an ASCU, use the alps n3 interface configuration command. To reassert the default, use the no form of this command.
alps n3 value
no alps n3 value
Syntax Description
Defaults
The default number of resends is 3.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is valid on 1026C interfaces only.
Examples
The following example specifies that 6 is the maximum number of resends of an unacknowledged output data message to an ASCU:
alps n3 6Related Commands
alps ascu
Specifies a physical ASCU identity.
show alps ascu
Displays the status of the ALPS ASCU.
alps poll-pause
To set the minimum interval, in milliseconds, between two polls to the same ASCU, use the alps poll-pause interface configuration command. To the default interval, use the no form of this command to revert.
alps poll-pause msec
no alps poll-pause
Syntax Description
msec
Minimum interval between polls, in milliseconds. The valid range is 10 to 1000 ms. The default interval is 50 ms.
Defaults
The default minimum interval is 50 ms.
Command Modes
Interface configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
The following example sets a 200-ms minimum interval between polls:
alps poll-pause 200Related Commands
alps primary-peer
To specify the primary TCP peer and, optionally, a backup TCP peer for an ALPS circuit, use the alps primary-peer ALPS circuit submode command. To remove the definition from the configuration, use the no form of this command.
alps primary-peer ip-address [backup-peer ip-address]
no alps primary-peer ip-address [backup-peer ip-address]
Syntax Description
Defaults
No default behavior or values.
Command Modes
ALPS circuit submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
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.92Related Commands
Automatically resets a nonresponsive ALC ASCU in the DOWN state.
Displays the status of the ALPS partner peers.
alps remote-peer
To specify the partner IP address for an ALPS circuit, use the alps remote-peer global configuration command. To remove the definition from the configuration, use the no form of this command.
alps remote-peer ip-address [protocol {atp | matip-a}] [status-interval interval] [status-retry retries] [dynamic [inact-timer] [no-circuit no-circ-timer]] [tcp-qlen [number]]
no alps remote-peer ip-address [protocol {atp | matip-a}] [status-interval interval] [status-retry retries] [dynamic [inact-timer] [no-circuit no-circ-timer]] [tcp-qlen [number]]
Syntax Description
Defaults
The default for the status-interval argument is 0 (off).
The default for the status-retry argument is 2.
The default for the dynamic argument is 30 seconds.
The default for the no-circuit argument is 90 seconds.
The default for the tcp-qlen argument is 50 packets.
Command Modes
Global configuration
Command History
Usage Guidelines
When the protocol option is configured for MATIP, the peer connection is dynamic.
When the protocol option is configured for ATP, the peer connection is permanent.
The no-circuit option within the dynamic keyword does not apply to permanent (ALC/UTS) connections.
The status-interval and status-retry options apply only to the MATIP protocol.
Issuing the no alps remote-peer command does the following:
•
Closes TCP connection.
•
Notifies the ALPS circuits using this TCP peer that the connection is closed.
Examples
The following example specifies a MATIP peer connection at IP address 172.22.0.92. Status messages will be sent every 20 seconds and will be 2 times before the connection is closed. The maximum TCP length is 30:
alps remote-peer 172.22.0.92 protocol matip-a status-interval 20 status-retry 2 tcp-qlen 30Related Commands
Specifies the IP address of the local peer.
Displays the status of the ALPS partner peers.
alps retry-option
To configure the CPE to signal the ASCU whenever an error is detected, use the alps retry-option ALPS ASCU submode command. To reassert the default action of no retry, use the no form of this command.
alps retry-option {resend | reenter}
no alps retry-option
Syntax Description
Defaults
The default retry option is no retry.
Command Modes
ALPS ASCU submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Usage Guidelines
This command is applicable only for P1024B ALC interfaces; it is invalid on P1024C UTS interfaces.
Examples
The following example specifies that an indicator LED signals the ASCU to resend data:
alps retry-option resendRelated Commands
Specifies a physical ASCU identity.
Specifies that the P1024C UTS protocol will be used on the serial interface.
alps service-msg-interval
To specify the interval between consecutive transmissions of service messages from the remote CPE to the ASCU, use the alps service-msg-interval ALPS circuit submode command. To remove the definition from the configuration, use the no form of this command.
alps service-msg-interval seconds
no alps service-msg-interval seconds
Syntax Description
seconds
Interval, in seconds, between consecutive sendings of service messages from the remote CPE to the ASCU. The range is 1 to 20 seconds. The default interval is 4 seconds.
Defaults
The default interval between consecutive sendings of service messages from the remote CPE to the ASCU is 4 seconds.
Command Modes
ALPS circuit submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Usage Guidelines
The "PLEASE RETRY" message is sent only to ASCUs that use circuits with a dynamic connection type.
Examples
The following example specifies an interval of 3 seconds between sending service messages from the CPE to the ASCU:
alps service-msg-interval 3Related Commands
Automatically resets a nonresponsive ALC ASCU in the DOWN state.
Defines the service message list to be used for this circuit.
alps service-msg-list
To define the service message list to be used for this circuit, use the alps service-msg-list ALPS circuit submode command. To remove the list from the circuit configuration, thus issuing no service messages until another list is configured, use the no form of this command.
alps service-msg-list list
no alps service-msg-list list
Syntax Description
Defaults
No default behavior or values.
Command Modes
ALPS circuit submode
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
The following example specifies that message list 1 is used for this circuit:
alps service-msg-list 1Related Commands
Automatically resets a nonresponsive ALC ASCU in the DOWN state.
Specifies the interval between consecutive transmissions of service messages from the remote CPE to the ASCU.
alps service-msg-list number
To define the service message identity and its contents for a service message list, use the alps service-msg-list number global configuration command. To remove a service message number from the service message list configuration, use the no form of this command.
alps service-msg-list list number number message
no alps service-msg-list list number number message
Syntax Description
Defaults
The default service message is used if no service message list number is specified.
Table 51 shows the default service message text strings.
Command Modes
Global configuration
Command History
Usage Guidelines
To disable a particular service message, configure the message argument with a value of $OFF$.
Examples
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."The following example disables service message 3 from list 1:
alps service-msg-list 1 number 3 $OFF$Related Commands
alps service-msg list
Defines the service message list to be used for this circuit.
alps service-msg data-drop
To specify where to retrieve the terminal address to be used when a service message is sent to an ASCU as the result of a dropped data message, use the alps service-msg data-drop interface configuration command. To remove the terminal address specification, use the no form of this command.
alps service-msg data-drop {msg-term | config-term}
no alps service-msg data-drop {msg-term | config-term}
Syntax Description
Defaults
The config-term option is the default.
If this command is not configured and a data message is dropped from a terminal, the resulting service message is sent to the terminal specified in the alps error-display command.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command applies to serial interfaces configured with ALC encapsulation only.
Examples
The following example specifies that service messages resulting from dropped data messages are sent to the terminal address of the dropped message:
alps service-msg data-drop msg-termRelated Commands
alps service-msg format
To specify the protocol format of service messages sent from the router to an ASCU, use the alps service-msg format interface configuration command. To remove the protocol format specification, use the no form of this command.
alps service-msg format {sita | apollo}
no alps service-msg format {sita | apollo}
Syntax Description
Defaults
The default protocol format is sita.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command applies to serial interfaces configured with ALC encapsulation only.
Examples
The following example specifies the apollo protocol format:
alps service-msg format apolloRelated Commands
encapsulation alc
Specifies that the P1024B ALC protocol is used on the serial interface.
alps service-msg status-change
To specify that service messages for ALPS circuit status changes be sent to ASCUs on the serial interface, use the alps service-msg status-change interface configuration command. To send service messages for ALPS circuit status changes only when ALC data messages are dropped, use the no form of this command.
alps service-msg status-change
no alps service-msg status-change
Syntax Description
This command has no arguments or keywords.
Defaults
The default is on. Unless the no form of this command is configured, unsolicited service messages are sent to all ASCUs multiplexed on the MATIP session when the following ALPS circuit events occur:
•
•
Command Modes
Interface configuration
Command History
Usage Guidelines
This command applies to serial interfaces configured with ALC encapsulation only.
If the no form of this command is configured, service messages for ALPS circuit status changes are sent only when ALC data messages are dropped.
Examples
The following example specifies that unsolicited service messages resulting from ALPS circuit status changes be sent to ASCUs on the serial interface:
alps service-msg status-changeRelated Commands
encapsulation alc
Specifies that the P1024B ALC protocol is used on the serial interface.
alps servlim
To specify the number of polls of the ASCU UP list allowed between two successive polls of the ASCU DOWN list, use the alps servlim interface configuration command. To reassert the default number of cycles through the normal (active) poll list allowed before the slow poll list is processed, use the no form of this command.
alps servlim polls
no alps servlim polls
Syntax Description
polls
Number of polls of the ASCU UP list. The valid range is 1 to 512 polls. The default is 30 polls.
Defaults
The default number of polls of the ASCU UP list allowed between two successive polls of the ASCU DOWN list is 30 polls.
Command Modes
Interface configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
The following example specifies that 5 polls of the ASCU UP list are allowed between 2 successive polls of the ASCU DOWN list.
alps servlim 5Related Commands
alps t1
To specify the timeout delay between polling and response, use the alps t1 interface configuration command. To reassert the default poll timeout value of 0.5 seconds, use the no form of this command.
alps t1 delay
no alps t1 delay
Syntax Description
delay
Timeout delay, in seconds, between polling and response. The valid range is 1 to 20 tenths of a second (0.1 to 2 seconds). The default is 5 tenths of a second (0.5 second).
Defaults
The default timeout delay between polling and response is 5 tenths of a second (0.5 second).
Command Modes
Interface configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
12.1(2)T
The range for the timeout delay was extended.
Examples
The following example specifies a 0.5-second timeout delay between polling and response:
alps t1 5Related Commands
alps t2
To specify the timeout 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 alps t2 interface configuration command. To reassert the default timeout value of 6 seconds, use the no form of this command.
alps t2 delay
no alps t2 delay
Syntax Description
Defaults
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.
Command Modes
Interface configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
The following example specifies a timeout delay of 8 seconds between receipt of the first character of an I/P sequence solicited by a poll and receipt of a Go Ahead (GA) sequence:
alps t2 8Related Commands
alps translate
To map an X.121 address to an IP address of a remote peer, use the alps translate interface configuration command. To remove mapping from the configuration, use the no form of this command.
alps translate x.121-address ip-address
no alps translate x.121-address ip-address
Syntax Description
x.121-address
X.121 address to be mapped to an IP address of a remote peer.
ip-address
IP address of the remote peer.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Usage Guidelines
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 *."
Examples
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.90Related Commands
alps update-circuit
To update one or more ALPS circuits, use the alps update-circuit EXEC command. If a circuit name is specified, then only that circuit will be updated; otherwise, all circuits will be updated.
alps update-circuit [name]
Syntax Description
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
Usage Guidelines
If the alps update-circuit command is issued for a circuit that is using the ATP protocol, the circuit will be closed and reopened.
If the alps update-circuit command is issued for a circuit that is using the MATIP protocol, a configuration update will be sent in the form of a MATIP Session Open command.
The alps update-circuit command is effective only for ALPS circuits that are enabled and active (opening or opened state).
There is not a no form for this command.
Examples
The following example specifies that circuit 1 has been updated:
alps update-circuit CKT-1Related Commands
Automatically resets a nonresponsive ALC ASCU in the DOWN state.
Enables the circuit to be activated when data is received from an ASCU.
Displays the status of the ALPS circuits.
clear alps circuits
To remove configured ALPS circuits, use the clear alps circuits EXEC command.
clear alps circuits [ipaddr address | name string]
Syntax Description
ipaddr address
(Optional) Clear ALPS circuits for peer with specified IP address.
name string
(Optional) Clear ALPS circuits for peer with specified name.
Defaults
If no IP address or name is specified, the command clears all ALPS circuits.
Command Modes
EXEC
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
The following example clears the ALPS circuit named CKT1:
clear alps circuits name CKT1Related Commands
Automatically resets a nonresponsive ALC ASCU in the DOWN state.
Displays the status of the ALPS circuits.
clear alps counters
To clear all counters relevant to the ALPS feature, use the clear alps counters EXEC command.
clear alps counters
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Examples
The following example clears all counters for the ALPS feature:
clear alps countersRelated Commands
Specifies that the P1024C UTS protocol will be used on the serial interface.
Displays the status of the ALPS circuits.
Displays the status of the ALPS partner peers.
encapsulation alc
To specify that the P1024B Airline Control (ALC) protocol will be used on the serial interface, use the encapsulation alc interface configuration command. To remove ALC protocol handling from the serial interface, and return the default encapsulation (HDLC) to the interface, use the no form of this command.
encapsulation alc
no encapsulation alc
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
Usage Guidelines
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 sending 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.
Examples
The following example specifies that the ALC protocol is used:
encapsulation alcRelated Commands
show interfaces
Displays statistics for the interfaces configured on a router or access server.
encapsulation uts
To specify that the P1024C Universal Terminal Support (UTS) protocol will be used on the serial interface, use the encapsulation uts interface configuration command. To remove P1024C UTS protocol handling from the serial interface and return the default encapsulation (HDLC) to the interface, use the no form of this command.
encapsulation uts
no encapsulation uts
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Usage Guidelines
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 sending 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.
Examples
The following example specifies that the P1024C UTS protocol is used:
encapsulation utsRelated Commands
show interfaces
Displays statistics for all interfaces configured on a router or access server.
show alps ascu
To display the status of the ALPS ASCU, use the show alps ascu EXEC command.
show alps ascu [interface [id]] [detail]
Syntax Description
Command Modes
EXEC
Command History
Examples
The following example shows output from the show alps ascu command:
router# show alps ascuinterface dlc id a1 a2 circuit pkt_tx pkt_rx state----------------------------------------------------------------------Serial1/2 ALC 5F 41 42 MATIP-ALC 0 0 DOWNSerial1/3 UTS 21 23 4A MATIP 0 0 DOWNSerial1/6 ALC 5F 41 45 MATIP-ALC 0 0 DOWNSerial1/6 ALC 6F 41 44 MATIP-ALC 0 0 DOWNTotal number of ASCUs: 4Total number of up ASCUs: 0The following example shows output from the show alps ascu detail command for ASCUs 4F and 6F on interface Serial1/6:
Router# show alps ascu detailascu 4F on i/f Serial1/6, dlc = ALC, state = UPdefault-circuit = MATIP-ALC, a1 = 41, a2 = 45max_msg_len = 962, retry_option = none, alias = 6Ferr_disp_terminal = 114, err_disp_line = 102pkt_tx = 0, byte_tx = 0, pkt_rx = 0, byte_rx = 0bad_CCC = 0, garbledMsgs = 0, T1Timeouts = 0ascu 6F on i/f Serial1/6, dlc = ALC, state = DOWNdefault-circuit = MATIP-ALC, a1 = 41, a2 = 44max_msg_len = 962, retry_option = noneerr_disp_terminal = 114, err_disp_line = 102pkt_tx = 0, byte_tx = 0, pkt_rx = 0, byte_rx = 0bad_CCC = 0, garbledMsgs = 0, T1Timeouts = 14Table 52 describes significant fields in the display:
Related Commands
show alps circuits
To display the status of the ALPS circuits, use the show alps circuits EXEC command. If a circuit name is specified, then only the status of that circuit will be displayed; otherwise, the status of all circuits will be displayed.
show alps circuits [peer ipaddress] [name name] [detail]
Syntax Description
Command Modes
EXEC
Command History
11.3T
This command was introduced.
12.0(1)
This command was available for general release.
12.0(5)T
This command was modified.
Examples
The following example shows output from the show alps circuits command:
router# show alps circuitsname pri_peer curr_peer dlc state pkt_tx pkt_rx--------------------------------------------------------------------------------CKT1 172.18.60.201 0.0.0.0 NONE DISC 0 0CKT2 172.18.60.201 0.0.0.0 NONE DISC 0 0MATIP 10.100.1.2 0.0.0.0 UTS DISC 0 0MATIP-ALC 10.100.1.2 0.0.0.0 ALC INOP 0 0Total number of circuits: 4Total number of connected circuits: 0The following example shows output from the show alps circuits command using the detail keyword:
router# show alps circuit name matip-alc detailMATIP-ALC: dlc = ALC, conn_type = PERM, state = INOP, uptime = 00:00:00down reason = noReasonpri_peer = 10.100.1.2, sec_peer = 0.0.0.0curr_peer = 0.0.0.0,local_hld = 4D02, remote_hld = 7F7Femtox: hostlink = 255, x121 = 1234lifetime_tmr = 4, idle_tmr = 60, retry_tmr = 30pkt_tx = 0, byte_tx = 0, pkt_rx = 0, byte_rx = 0src_corr = 0, dst_corr = 0drops_q_overflow = 0, drops_ckt_disabled = 0drops_lifetime_tmr = 0, drops_invalid_ascu = 0ascus: (41,42)U, (41,44)U, (41,45)UTotal number of ASCUs: 3Related Commands
show alps peers
To display the status of the ALPS partner peers, use the show alps peers EXEC command. If an IP address is specified, then only the status of that peer will be displayed; otherwise, the status of all peers will be displayed.
show alps peers [ipaddress address] [detail]
Syntax Description
ipaddress address
(Optional) Displays only the status of that ASCU.
detail
(Optional) Displays detailed output.
Command Modes
EXEC
Command History
11.3(6)T
This command was introduced.
12.0(1)
This command was available for general release.
12.0(5)T
This command was modified.
Examples
The following example shows output from the show alps peers detail command:router# show alps peers detailTCP:10.227.50.106, conn_id = MATIP_A_CKT-2protocol = MATIP_A, fport = 350, lport = 11592type = DYN, create = ADMIN, state = OPENED, uptime = 00:00:53down reason = unknownpkt_tx = 1071, byte_tx = 37264, pkt_rx = 1066, byte_rx = 36010Drops:giants = 0, q_overflow = 0, peer_down = 0, ver_mismatch = 0
Related Commands
Specifies the primary TCP peer and, optionally, a backup TCP peer for this ALPS circuit.
Specifies the partner IP address.