|
|
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.
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
Syntax Description
a1-value A1 logical ASCU identification: a2-value A2 logical ASCU identification:
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.
Release
Modification
Examples
The following example specifies the A1 identification as 0x4C and the A2 identification as 0x20:
alps a1-map 4C a2-map 20
Related Commands
Specifies that the P1024C protocol will be used on that interface.
Command
Description
Syntax Description
id ASCU identification. Valid range is between 41 and 7E, except 43, 44, 47, 50 to 57, 60, 64, and 7B. The UTS valid range is between 21 and 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.
Release
Modification
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 4B
Related Commands
Specifies that the P1024C protocol will be used on that interface.
Command
Description
Syntax Description
name Name given to identify an ALPS circuit.
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.
Release
Modification
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 CKT1
Related Commands
Displays 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.
Command
Description
Syntax Description
retry-timer (Optional) Specifies the maximum interval between consecutive attempts to establish a circuit in the event of a failure. The default for retry-timer is 30 seconds and the range is 1 to 180 seconds.
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.
Release
Modification
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 30
Related Commands
Displays 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.
Command
Description
Syntax Description
name Name given to identify an ALPS circuit on the remote CPE.
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.
Release
Modification
Examples
The following example specifies that ALPS circuit to be used is CKT1:
alps default-circuit CKT1
Related Commands
Displays 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.
Command
Description
Syntax Description
interface id (Optional) ASCU identifier. Enable alarms for the specified ASCU.
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.
Release
Modification
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 42
Related Commands
Specifies that the P1024C protocol will be used on that interface.
Command
Description
Syntax Description
name (Optional) Name given to identify an ALPS circuit on the 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.
Release
Modification
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 CKT1
Related Commands
Displays 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.
Command
Description
Syntax Description
ip-address (Optional) IP address of the remote peer for which alarms are enabled.
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.
Release
Modification
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.91
Related Commands
Displays the status of the ALPS partner 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.
Command
Description
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.
Release
Modification
Examples
The following example moves the ASCU to the active poll list:
alps enable-ascu
Related Commands
Specifies that the P1024C protocol will be used on that interface.
Command
Description
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.
Release
Modification
Examples
The following example specifies the circuit to be activated when data is received from an ASCU:
alps enable-circuit
Related Commands
Displays 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.
Command
Description
Syntax Description
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.
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.
Release
Modification
Examples
The following example specifies that error messages are displayed at terminal address 6d, on screen line number 78:
alps error-display 6d 78
Related Commands
Specifies that the P1024C protocol will be used on that interface.
Command
Description
Syntax Description
hld Host high-level designator. A hexadecimal number in the range 1 to 7f7f. num Host-link identifier. A number in the range 1 to 255. ax25 Specifies airline X.25 implementation of X.25. damp-tmr value (Optional) Specifies the AX.25 PVC damping timer. The value argument is the length of time that a PVC can be inactive before it is destroyed and the corresponding ALPS circuits are closed. The default is 10 seconds. emtox Specifies EMTOX implementation of X.25. x.121 X.121 address of the EMTOX host (called address on calls to the EMTOX host). pseudo-conv (Optional) Specifies the pseudo-conversational format of EMTOX packets. life-tmr value (Optional) Specifies the maximum amount of time (in seconds) that a message may be queued for transmission to the host X.25 system before it is discarded. The value argument is time (in seconds).
Defaults
The default damping timer value is 10 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.
Release
Modification
Examples
The following example enables ALPS on an X.25 interface, using the airline X.25 implementation:
alps host-hld 4B10 host-link 3 ax25
Related Commands
encapsulation x25 Specifies operation of a serial interface as an X.25 device.
Command
Description
Syntax Description
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 X.121 address for EMTOX connections.This is the X.121 calling address for X.25 call packets sent from the central CPE to the EMTOX host. winout val1 (Optional) Specifies the X.25 transmit window The val1 argument is a decimal number in the range 1 to 7. winin val2 (Optional) Specifies the X.25 receive window. The val2 argument is a decimal number in the range 1 to 7. ops val3 (Optional) Specifies the maximum output packet size. The val3 argument is one of the following numbers: 128, 240, 256, 512, 1024, 2048, or 4096. ips val4 (Optional) Specifies the maximum input packet size. The val4 argument is one of the following numbers: 128, 240, 256, 512, 1024, 2048, or 4096.
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.
Release
Modification
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 3
Related Commands
Specifies an ALPS circuit at the remote CPE across a TCP/IP connection. Displays 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.
Command
Description
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.
Release
Modification
Examples
The following example specifies that an idle circuit is maintained for 90 seconds before it is disabled:
alps idle-timer 90
Related Commands
Specifies an ALPS circuit at the remote CPE across a TCP/IP connection. Displays 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.
Command
Description
Syntax Description
interval time (Optional) Interval for keepalive requests. The time argument is the keepalive interval, in the range of 10 to 300 seconds. The default is 30 seconds. retry count (Optional) Indicates how many times keepalive requests will be sent before the connection is closed. The count argument is the retry count, in the range 1 to 10. The default is 3 retries.
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.
Release
Modification
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 8
Related Commands
Specifies the IP address of the local peer.
Command
Description
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.
Release
Modification
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 3
Related Commands
Specifies an ALPS circuit at the remote CPE across a TCP/IP connection. Displays 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.
Command
Description
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
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
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 and the remote-hld keyword is not applicable for MATIP.
Release
Modification
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 4B10
Related Commands
Specifies an ALPS circuit at the remote CPE across a TCP/IP connection. Displays 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.
Command
Description
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.
Release
Modification
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 promiscuous
Related Commands
Displays the status of the ALPS partner 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.
Command
Description
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
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
12.0(5)T This command was introduced.
Release
Modification
Examples
The following example specifies a close delay time of 20 seconds
alps matip-close-delay 20
Related Commands
Displays the status of the ALPS circuits.
Command
Description
Syntax Description
value Maximum input message length. The range is 1 to 3840. The default is 962 characters.
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.
Release
Modification
Examples
The following example specifies that the maximum length of a message is 1000 characters:
alps max-msg-length 1000
Syntax Description
group Specifies that multiple ASCUs will be multiplexed on the ALPS circuit. This setting is the default. single Specifies that only one ASCU will use this circuit. hdr Specifies the ASCU identification header for the circuit. The default is a1a2. a1a2 ASCU identification via A1, A2. none No ASCU identification.
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.
Release
Modification
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.
Syntax Description
errors Error count limit. The valid range is 1 to 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.
Release
Modification
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 1
Related Commands
Specifies a physical ASCU identity. Specifies that the P1024C protocol will be used on that interface.
Command
Description
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.
Release
Modification
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 2
Related Commands
Specifies a physical ASCU identity. Specifies that the P1024C protocol will be used on that interface.
Command
Description
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
Syntax Description
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.
Defaults
The default number of retransmissions is 3.
Command Modes
Interface configuration
Command History
12.0(2)T This command was introduced.
Release
Modification
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 6
Related Commands
alps ascu Specifies a physical ASCU identity. show alps ascu Displays the status of the ALPS ASCU.
Command
Description
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.
Release
Modification
Examples
The following example sets a 200-ms minimum interval between polls.
alps poll-pause 200
Related Commands
Specifies a physical ASCU identity.
Command
Description
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.
Release
Modification
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.92
Related Commands
Specifies an ALPS circuit at the remote CPE across a TCP/IP connection. Displays the status of the ALPS partner 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.
Command
Description
Syntax Description
ip-addr IP address of the peer. protocol {atp | matip-a} (Optional) Specifies the type of encapsulation for the connection. The following options are available: status-interval interval (Optional) Specifies amount of time, in seconds, between sending of MATIP status messages. The messages verify the integrity of the TCP connection. Number of seconds between status messages. The range is 0 to 300 seconds. The default value is 0 (off). status-retry retries (Optional) Specifies number of times to retry sending a MATIP status message before the peer connection is closed. Number of retries. The range is 0 to 100 retries. The default value is 2. dynamic inact-timer (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. Length of inactivity, in seconds, after which the connection is closed. The range is 0 to 300 seconds. The default is 30 seconds. A value of zero indicates that the timer is disabled. no-circuit no-circ-timer (Optional) Specifies amount of time, in seconds, that a peer will stay connected while no circuits are using the peer connection. This parameter is valid only if the dynamic parameter is first configured. Number of seconds before which the timer will expire. The range is 0 to 3600 seconds. The default is 90 seconds. tcp-qlen num (Optional) Specifies the maximum length of a TCP queue for peer connections. Number of packets allowed in the TCP queue. The range is 26 to 100 packets. The default is 50 packets.
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
11.3(6)T This command was introduced 12.0(1) This command was available for general release. 12.0(5)T The keyword protocol, status-interval, status-retry and the no-circuit option were added.
Release
Modification
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 30
Related Commands
Specifies the IP address of the local peer. Displays the status of the ALPS partner 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.
Command
Description
Syntax Description
resend Specifies the retry option as resend. This option causes an indicator LED to signal the operator at the ASCU to resend data. reenter Specifies the retry option as reenter. This option causes a service message to signal the operator at the ASCU to reenter data.
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.
Release
Modification
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 resend
Related Commands
Specifies a physical ASCU identity. Specifies that the P1024C protocol will be used on that interface.
Command
Description
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.
Release
Modification
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 3
Related 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.
Command
Description
Syntax Description
list The service message list to be used for this circuit. The valid numbers are 1 to 8.
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.
Release
Modification
Examples
The following example specifies that message list 1 is used for this circuit:
alps service-msg-list 1
Related Commands
Specifies an ALPS circuit at the remote CPE across a TCP/IP connection. Specifies the interval between transmission of a service message to an ASCU and transmission of a PLEASE RETRY message.
Command
Description
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.
Release
Modification
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."
Syntax Description
polls Number of polls of the ASCU UP list. The valid range is 1 to 30 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.
Release
Modification
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 5
Related Commands
Specifies the threshold of consecutive errors logged before an ASCU is declared down. Specifies the number of polls that must be correctly replied to before an ASCU is declared up. Specifies the timeout delay between polling and response. Specifies the timeout delay between receipt of the first character of an IP sequence solicited by a poll and receipt of a Go Ahead (GA) sequence.
Command
Description
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.
Release
Modification
Examples
The following example specifies a .5-second time-out delay between polling and response:
alps t1 5
Related Commands
Specifies the threshold of consecutive errors logged before an ASCU is declared down. Specifies the number of polls that must be correctly replied to before an ASCU is declared up. Specifies the number of cycles of the active poll list to execute before polling the next ASCU on the inactive poll list. Specifies the timeout delay between receipt of the first character of an IP sequence solicited by a poll and receipt of a Go Ahead (GA) sequence.
Command
Description
Syntax Description
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.
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.
Release
Modification
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 8
Related Commands
Specifies the threshold of consecutive errors logged before an ASCU is declared down. Specifies the number of polls that must be correctly replied to before an ASCU is declared up. Specifies the number of cycles of the active poll list to execute before polling the next ASCU on the inactive poll list. Specifies the timeout delay between polling and response.
Command
Description
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.
Release
Modification
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.90
Related Commands
encapsulation x25 Specifies that the P1024C protocol will be used on that interface.
Command
Description
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
name (Optional) Specifies name of circuit to update.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(5)T This command was introduced.
Release
Modification
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-1
Related Commands
Specifies an ALPS circuit at the remote CPE across a TCP/IP connection. Enables the circuit to be activated when data is received from an ASCU. Displays the status of the ALPS circuits.
Command
Description
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.
Release
Modification
Examples
The following example clears the ALPS circuit named CKT1:
clear alps circuits name CKT1
Related Commands
Specifies an ALPS circuit at the remote CPE across a TCP/IP connection. Displays 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.
Command
Description
To clear all counters relevant to the ALPS feature, use the clear alps counters EXEC command.
clear alps countersSyntax 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.
Release
Modification
Examples
The following example clears all counters for the ALPS feature:
clear alps counters
Related Commands
Specifies that the P1024C protocol will be used on that interface. Displays 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. Displays the status of the ALPS partner 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.
Command
Description
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.
Release
Modification
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 alc
Related Commands
show interfaces Displays statistics for all interfaces configured on the router or access server.
Command
Description
To specify that the P1024C protocol will be used on the serial interface, use the encapsulation uts interface configuration command. To remove P1024C protocol handling from the serial interface and return the default encapsulation (HDLC) to the interface, use the no form of this command.
encapsulation utsSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
12.0(2)T This command was introduced.
Release
Modification
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 uts
Related Commands
show interfaces Displays statistics for all interfaces configured on the router or access server.
Command
Description
To display the status of the ALPS ASCU, use the show alps ascu EXEC command.
show alps ascu [interface [id]] [detail]
Syntax Description
interface [id] (Optional) Combined interface and ASCU Interchange Address (IA). If the interface and ASCU are specified, the status for only the ASCU on that interface is displayed. If only the interface is specified, all ASCUs defined on that interface are displayed. If the interface and ASCU are not specified, then all ASCUs defined are displayed. 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.
Release
Modification
Examples
The following example shows output from the show alps ascu command:
router# show alps ascu interface dlc id a1 a2 circuit pkt_tx pkt_rx state --------------------------------------------------------------------- Serial3 ALC 41 41 41 CKT-1 0 0 UP Serial3 ALC 42 41 42 CKT-1 0 0 UP Serial3 ALC 45 41 45 CKT-1 29 1484 UP
Related Commands
Specifies a physical ASCU identity.
Command
Description
show alps circuits [peer ipaddress] [name name] [detail]
Syntax Description
peer ipaddress (Optional) Displays the status of the circuits connected to the specified peer. name name (Optional) Displays only the status of that circuit. detail (Optional) Displays detailed output.
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.
Release
Modification
Examples
The following example shows output from the show alps circuits command:
router# show alps circuits name ckt-1 detail CKT-1:dlc = ALC, conn_type = DYN, state = OPEN, uptime = 00:00:06 down reason = noReason pri_peer = 10.227.50.106, sec_peer = 0.0.0.0 curr_peer = 10.227.50.106, MATIP_A_CKT-1 local_hld = 7F7F, remote_hld = 7F7F emtox:hostlink = 255, x121 = 1133470125 lifetime_tmr = 4, idle_tmr = 60, retry_tmr = 0 pkt_tx = 2239, byte_tx = 94244, pkt_rx = 2238, byte_rx = 94208 src_corr = 0, dst_corr = 0 drops_q_overflow = 388, drops_ckt_disabled = 30 drops_lifetime_tmr = 24, drops_invalid_ascu = 0 ascus:(45,41)
Related Commands
Specifies an ALPS circuit at the remote CPE across a TCP/IP connection.
Command
Description
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.
Release
Modification
Examples
The following example shows output from the show alps peers detail command: router# show alps peers detail TCP:10.227.50.106, conn_id = MATIP_A_CKT-2 protocol = MATIP_A, fport = 350, lport = 11592 type = DYN, create = ADMIN, state = OPENED, uptime = 00:00:53 down reason = unknown pkt_tx = 1071, byte_tx = 37264, pkt_rx = 1066, byte_rx = 36010 Drops: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.
Command
Description
Posted: Wed Aug 23 13:02:13 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.