Table Of Contents
alps connection-type permanent
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 agent-set control unit (ASCU) identification information, use the alps a1-map a2-map command in ALPS ASCU configuration mode. 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 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 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 0x4C a2-map 0x20Related Commands
alps ascu
To specify a physical agent-set control unit 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 from 41 to 7E, except 43, 44, 47, 50 to 57, 60, 64, and 7B. The universal transmit support (UTS) valid range is from 21 to 4F.
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.
12.0(2)T
This command was modified for UTS support.
Usage Guidelines
If an ASCU already exists on the interface, the alps ascu command initiates the ALPS ASCU configuration submode for that ASCU. If the ASCU does not exist, an ASCU is created and the ALPS ASCU configuration submode is initiated.
Examples
The following example specifies the interchange address as 4B:
alps ascu 4BRelated Commands
Specifies that the P1024C protocol will be used on the serial interface of the router.
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 ALC P1024B is 0x72.
The default screen line for ALC P1024B is 0x20.
The default line number for UTS P1024C is 0x37.
The default column number for UTS P1024C 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-addr} [winout val1] [winin val2] [ops val3] [ips val4]
no alps hostlink number {ax25 lcn | emtox x121-addr} [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 transmit window is 3.
alps hostlink 3 ax25 120 winout 3 winin 3Related Commands
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
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 the maximum amount of time 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
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
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 re-opening 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 re-opening 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.
•
ALC default is 30 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 protocol will be used on that 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 protocol will be used on that 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 retransmissions 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 retransmissions 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 specify the minimum interval, in milliseconds, between initiations of the polling cycle, 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 this 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-addr [backup-peer ip-addr]
no alps primary-peer ip-addr [backup-peer ip-addr]
Syntax Description
ip-addr
IP address specified in the alps remote-peer command.
backup-peer
(Optional) Backup TCP peer for the ALPS circuit.
ip-addr
(Optional) IP address specified in the alps remote-peer command.
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
alps remote-peer
To specify the partner IP address, 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-addr [protocol {atp | matip-a}] [status-interval interval] [status-retry retries] [dynamic [inact-timer] [no-circuit no-circ-timer]] [tcp-qlen [num]]
no alps remote-peer ip-addr [protocol {atp | matip-a}] [status-interval interval] [status-retry retries] [dynamic [inact-timer] [no-circuit no-circ-timer]] [tcp-qlen [num]]
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:
•
•
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
alps retry-option
To configure the CPE to transmit a message to the ASCU when a message with a bad cycle check character (CCC) is received from an ASCU, 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 protocol will be used on that interface.
alps service-msg-interval
To specify the interval between transmission of a service message to an ASCU and transmission of a "PLEASE RETRY" message, 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 transmissions 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 transmissions 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 transmitted only to ASCUs that use circuits with a dynamic connection type.
Examples
The following example specifies an interval of 3 seconds between transmission of service messages from the CPE to the ASCU:
alps service-msg-interval 3Related Commands
Specifies an ALPS circuit at the remote CPE across a TCP/IP connection.
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
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 msg
no alps service-msg-list list number number msg
Syntax Description
list
The service message list to be used for this circuit. The valid numbers are 1 to 8
number
List number. Valid numbers are 1 to 8.
msg
Contents of a service message.
Defaults
The default service message is used if no service message list number is specified.
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 text of message list 1, message number 2:
alps service-msg-list 1 number 2 "Turn off the terminal NOW."alps servlim
To specify the number of cycles of the active poll list to execute before polling the next ASCU on the inactive poll 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 10 tenths of a second (.1 to 1 second). The default is 5 tenths of a second (.5 second).
Defaults
The default timeout delay between polling and response is 5 tenths of a second (.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.
Examples
The following example specifies a .5-second time-out 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 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-addr ip-addr
no alps translate x.121-addr ip-addr
Syntax Description
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.
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
encapsulation x25
Specifies that the P1024C protocol will be used on that interface.
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
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
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
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 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.
Examples
The following example specifies that the ALC protocol is used:
encapsulation alcRelated Commands
show interfaces
Displays statistics for all interfaces configured on the 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 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 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.
Examples
The following example specifies that the P1024C protocol is used:
encapsulation utsRelated Commands
show interfaces
Displays statistics for all interfaces configured on the 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
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 ascu command:
router# show alps ascuinterface dlc id a1 a2 circuit pkt_tx pkt_rx state---------------------------------------------------------------------Serial3 ALC 41 41 41 CKT-1 0 0 UPSerial3 ALC 42 41 42 CKT-1 0 0 UPSerial3 ALC 45 41 45 CKT-1 29 1484 UPRelated 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 circuits name ckt-1 detailCKT-1:dlc = ALC, conn_type = DYN, state = OPEN, uptime = 00:00:06down reason = noReasonpri_peer = 10.227.50.106, sec_peer = 0.0.0.0curr_peer = 10.227.50.106, MATIP_A_CKT-1local_hld = 7F7F, remote_hld = 7F7Femtox:hostlink = 255, x121 = 1133470125lifetime_tmr = 4, idle_tmr = 60, retry_tmr = 0pkt_tx = 2239, byte_tx = 94244, pkt_rx = 2238, byte_rx = 94208src_corr = 0, dst_corr = 0drops_q_overflow = 388, drops_ckt_disabled = 30drops_lifetime_tmr = 24, drops_invalid_ascu = 0ascus:(45,41)Related Commands
show alps peers
To display the status of the ALPS partner peers, use the show alps peers EXEC command.
show alps peers [ipaddress addr] [detail]
Syntax Description
ipaddress addr
(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.
Usage Guidelines
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.
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 = 0Table 46 describes the significant fields shown in the display.
Related Commands
Specifies the primary TCP peer and, optionally, a backup TCP peer for this ALPS circuit.
Specifies the partner IP address.