Table of Contents
Airline Product Set Commands
This chapter explains the function and syntax of the airline product set commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Bridging and IBM Networking Command Reference, Volume 1, Release 12.1.
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
a1-value
| A1 logical ASCU identification:
- ALC range---Hexadecimal number in the range 0 to 0xFF.
- UTS range---Hexadecimal number in the range 0 to 0xFF.
|
a2-value
| A2 logical ASCU identification:
- ALC range---Hexadecimal number in the range 0 to 0xFF.
- UTS range---Hexadecimal number in the range 0 to 0xFF.
|
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, 47, 50 to 57, 60, 64, and 7B. The UTS valid range is between 21 and 4F.
|
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
name
| Name given to identify an ALPS circuit.
|
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
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.
|
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
name
| Name given to identify an ALPS circuit on the remote CPE.
|
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
interface id
| (Optional) ASCU identifier. Enable alarms for the specified ASCU.
|
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
name
| (Optional) Name given to identify an ALPS circuit on the remote CPE.
|
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
ip-address
| (Optional) IP address of the remote peer for which alarms are enabled.
|
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.
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.
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
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.
|
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 num {{ax25 [damp-tmr value]} | {emtox x.121 [pseudo-conv]}} [life-tmr value]
no alps host-hld hld host-link num {{ax25 [damp-tmr value]} | {emtox x.121 [pseudo-conv]}} [life-tmr value]
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).
|
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
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.
|
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.
|
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
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.
|
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.
|
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.
|
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.
|
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.
|
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
value
| Maximum input message length. The range is 1 to 3840. The default is 962 characters.
|
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
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.
|
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.
- UTS default is 10 error.
|
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.
|
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
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.
|
To specify the minimum interval, in milliseconds, between initiations of the polling cycle, use the alps poll-pause interface configuration command. To revert to the default interval, use the no form of this command.
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.
|
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.
|
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
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:
- ALPS Tunneling Protocol encapsulation. This encapsulation is the default.
- MATIP Type A (conversational) encapsulation.
|
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.
|
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
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.
|
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.
|
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
list
| The service message list to be used for this circuit. The valid numbers are 1 to 8.
|
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.
|
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 30 polls. The default is 30 polls.
|
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).
|
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
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.
|
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.
|
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.
|
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.
|
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.
To specify that the 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.
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 uts
no encapsulation uts
Syntax Description
This command has no arguments or keywords.
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.
|
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
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.
|
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 addr] [detail]
Syntax Description
ipaddress addr
| (Optional) Displays only the status of that ASCU.
|
detail
| (Optional) Displays detailed output.
|
Posted: Wed Jul 26 11:06:08 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.
