CISCO-ALPS-MIB: View SNMP OID List / Download MIB

The MIB module for Airline Protocol Support. ************************************************************** * Acronym Definitions * * * * ALPS : AirLine Protocol Support * * AX.25 : Airline X.25 * * EMTOX : Exchange of Mixed Traffic over X.25 * * ASCU : Agent Set Control Unit * * * ************************************************************** Overview of ALPS (AirLine Protocol Support) MIB ============================================== MIB description Document to refer: 'Configuring ALPS' section in Cisco IOS Command Reference & Configuration Guide. The ALPS MIB provides configuration and operational information for Cisco's Airline protocol support for IBM-P1024B(ALC) and Unisys-P1024C(UTS) protocols encapsulation over TCP/IP. The following entities are managed: 1. Peers 2. ALPS Circuits 3. ASCUs (Agent Set Control Units) 4. ALC interface 5. ALPS Host link interface to the host HOST(Emtox/Ax.25) <----> Central <---> IP Network <---> Remote <----> ASCU router router The router connected to the Host is called the Central router and the router connected to the ASCU is called the Remote router. We anticipate one Central router connecting to a large number of Remote routers. Each router has a local peer, which connects to its counterpart on the other router (referred to as the remote peer) via a TCP connection. ALPS circuits are set up over this TCP connection either on a permanent or on-demand basis. A logical grouping of ASCUs are connected via a single circuit - this has no connection to the physical interfaces that the ASCUs are connected to. The only restriction is that all the ASCUs should be directly connected to the same router. Multiple ASCUs can connect to a single serial interface and several terminals connect to an ASCU. However, terminals are not visible to the ALPS feature - the router talks only to the ASCUs. An ASCU can be identified by * the interface it is on and its Interface Address (IA) or * the circuit it is on, and its A1 and A2 values, which identify it within the circuit. Thus there are two ways of identifying an ASCU - or Circuit names are globally unique. The connection to the host is via one of two flavors of X.25 - either AX.25 (for PVCs) or EMTOX (for SVCs). Each X.25 VC corresponds to one ALPS circuit. There are several hostlinks between a host and the Central router and load balancing is done across these. EMTOX allows the host to dial out to a terminal. This requires the use of an X.121 to IP address translation table to connect to the appropriate remote peer.

The configured IP address used by the ALPS component in this router.

The port number used locally by the ALPS peer at this router. This is a static value but the port number used can change in later versions. This is not a configured value but is embedded into the source code. This has been provided mainly to aid in debugging so that the operator knows which TCP port to look at. ATP is the ALPS Tunnelling Protocol, a Cisco proprietary way to tunnel ALPS data across a TCP link

The TCP keep alive timeout value for Local ALPS Peer. Keepalives are sent out periodically at this interval to the remote peer.

The number of keepalives sent with acknowledgement before declaring the remote peer dead. 0 implies that keepalives are turned off.

If this is true, calls are accepted from any peer. If this is false, calls are accepted only from those routers which have been explicitly configured using alps remote-peer commands.

A list of Remote peers that the local ALPS peer can communicate with.

Each entry represents an Remote ALPS Peer.

The remote IP address for the TCP Connection.

Type of ALPS circuit established. Dynamic circuits are established only when there is data traffic that needs to be sent across and are closed when the alpsRemPeerIdleTimer expires. Permanent circuits stay up regardless of whether there is traffic across them or not. Enumeration: 'permanent': 1, 'dynamic': 2.

The port number used locally by the tcp connection for the circuit. the initiator of a connection will dynamically assign a port number. the other end of the connection will have a well-known port number applicable to the encapsulation used by the connection - e.g. the value of alpsPeerLocalAtpPort for ATP connections.

The port number used by the remote end of the tcp connection for the circuit. the initiator of a connection will dynamically assign a port number. the other end of the connection will have a well-known port number applicable to the encapsulation used by the connection - e.g. the value of alpsPeerLocalAtpPort for ATP connections. If this connection was initiated by the local router, a port number will be dynamically selected. Otherwise the value of alpsPeerLocalAtpPort will be used (for ATP connections)

TCP Peer State. Initially the connection is in the closed state. For permanent connections, it starts opening the TCP connection immediately, but for dynamic ones, it waits till there is traffic addressed to the remote peer. It then progresses via opening into the opened state. Enumeration: 'opened': 3, 'closed': 1, 'opening': 2.

Time elapsed since TCP connection was established.

Number of active ALPS circuits in this TCP session.

The TCP session with the peer will be closed if there is no activity for alpsInactiveTimer seconds. This is valid only for dynamic circuits

Specifies whether alarms are generated for this remote Peer

Maximum TCP Queue size allowed for this TCP session.

Number of packets transmitted to the remote peer.

Number of octets transmitted to the remote peer.

Number of packets received from the remote peer.

Number of octets received from the remote peer.

Number of Packets dropped because they were larger than the maximum allowed packet size of 3840 bytes.

Number of packets dropped because the TCP queue (of size alpsRemPeerTCPQlen) was full.

Number of packets dropped because remote peer was unreachable.

This object is used to create a new row or modify or delete an existing row in this table.

Table listing of all administered ALPS remote peer configuration entries on this node. Entries in this table can be created via a CLI command or via alpsRemPeerCfgRowStatus.

Each entry represents an ALPS remote peer configuration entry on this node.

The configured IP address of an ALPS remote peer.

The configured ALPS protocol encapsulation. This protocol encapsulation is at the layer above TCP. Enumeration: 'matipTypeA': 2, 'atp': 1.

The configured type of ALPS peer activation. Enumeration: 'permanent': 1, 'dynamic': 2.

The configured maximum TCP Queue size.

The configured idle timer for a dynamic activation peer.

The configured no-circuit timer for a dynamic activation peer.

The configured parameter which specifies whether alarms are generated for remote peer connections to the IP address in alpsRemPeerCfgIpAddr.

The configured status interval timer.

The configured number of status retries.

This object is used to create a new row or modify or delete an existing row in this table.

Table listing of all ALPS remote peer connections on this node.

Each entry represents an ALPS remote peer connection on this node.

The IP address of the ALPS remote peer.

A descriptive ASCII string that is used to distinguish among different peer connections to the same ALPS remote peer IP address.

The local TCP port number used by the underlying TCP connection to an ALPS remote peer.

The foreign (remote) TCP port number used by the underlying TCP connection to an ALPS remote peer.

The state of the connection to an ALPS remote peer. Enumeration: 'busy': 4, 'opened': 3, 'closed': 1, 'opening': 2.

The ALPS protocol encapsulation used on the connection to the ALPS remote peer. This protocol encapsulation is a layer above TCP. Enumeration: 'matipTypeA': 2, 'atp': 1.

The stimulus for creating the peer connection object. The peer connection object may be created solely due to configuration (admin) or due to a combination of configuration and protocol events (learned). Enumeration: 'admin': 1, 'learned': 2.

Basis for activation a peer connection. A permanent activation peer connection will attempt to open immediately and stay open, regardless of the usage of the peer connection. A dynamic activation peer connection only opens when there is data to send and the peer connection will close if there are no data messages sent or received across the peer for the duration of the idle timer. Enumeration: 'permanent': 1, 'dynamic': 2.

Elapsed time since the ALPS peer connection was successfully established.

The number of ALPS virtual circuits using the connection to this ALPS remote peer.

The value of sysUpTime when a peer data message was last transmitted or received across this ALPS remote peer connection. This timestamp is not update if the peer message is a peer status inquiry/response message.

The value of sysUpTime when a peer data or status message is last received across the ALPS remote peer connection.

A dynamic activation ALPS peer connection will be closed if zero peer data messages are sent or received for a length of time greater than or equal to this timer.

A dynamic activation ALPS peer connection will be closed if zero ALPS circuits are active or attempt to activate for a length of time greater than or equal to this timer.

The maximum number of ALPS peer messages that can be queued in a single TCP session.

This parameter specifies whether ALPS alarms are generated for this ALPS remote peer connection.

The time interval (in seconds) between transmission of consecutive ALPS Peer Status messages. These messages are only transmitted if zero messages are received on the peer connection for a length of time greater than or equal to this timer.

The number of consecutive unanswered ALPS Peer Status messages transmitted before closing the conenction to the ALPS remote peer.

Reason that an ALPS Peer connection failed to open sauccessfully. Enumeration: 'noMemory': 7, 'destUnreachable': 4, 'noCircuits': 3, 'unknown': 1, 'foreignReset': 5, 'idle': 2, 'localReset': 6, 'openingTimeout': 8.

Number of packets transmitted on this ALPS remote peer connection.

Number of octets transmitted on this ALPS remote peer connection.

Number of packets received on this ALPS remote peer connection.

Number of octets received on this ALPS remote peer connection.

Number of ALPS peer packets dropped due to exceeding the maximum allowed packet size of 3840 bytes.

Number of ALPS peer packets dropped because the TCP output queue is full.

Number of ALPS peer packets dropped because the ALPS remote peer is unreachable.

Number of ALPS peer packets dropped because of a version mismatch in the ALPS encapsulation.

A list of ALPS circuits. This table contains variables common to central & remote routers.

Details of ALPS Circuits.

Specifies the ALPS Circuit Name. This is unique within the network.

Specifies what type of circuit this is. The X25 circuit is set up with the same name as the P1024 circuit so we need this variable to distinguish between the two, in case local switching is done. Enumeration: 'ax25': 2, 'uts': 4, 'alc': 3, 'emtox': 1.

This is the IP address of the Primary Central peer. It is mandatory to configure a primary peer, but the backup peer is optional.

Specifies whether alarms are generated for this ALPS circuit. Alarms can be syslog messages or SNMP traps - both are controlled using the same flags.

Specifies the ALPS Circuit Connection Type. Enumeration: 'permanent': 1, 'dynamic': 2.

Indicates the state of ALPS Circuit. Enumeration: 'opened': 4, 'cktBusy': 5, 'opening': 3, 'inoperable': 2, 'disabled': 1, 'peerBusy': 6, 'updating': 7.

Reports the number of enabled ASCUs that are attached to this ALPS Circuit. Attachment of an ASCU to an ALPS circuit may occur due to configuration or due to information passed in a protocol message.

Reports the IP address of the peer that this ALPS circuit is currently connected to.

A data message that has been queued within the router for longer than this interval will be dropped.

Specifies host link number (on Central router) for this ALPS Circuit. The host link number is used to provide a degree of transparency to the remote router. A single host link may correspond to multiple physical links between the central router and the host, which can then load-balance VCs across them.

Specifies host link type(on Central router) for this ALPS Circuit. Enumeration: 'ax25': 1, 'emtox': 2.

Specifies the HLD (High-level descriptor) of the AX.25/EMTOX host for this ALPS Circuit. This serves as an identifier for the host

Specifies the local HLD for this ALPS Circuit. HLDs are required at the host for both ends of the connection.

Reports the reason why this ALPS Circuit is down, if it is down. Enumeration: 'x25ClearConfigRejected': 25, 'noReason': 2, 'x25ClearHostSaturated': 22, 'x25ClearHostUnknown': 19, 'cktNameInUse': 8, 'cktDisabled': 4, 'incompatibleA1A2': 15, 'configMismatch': 13, 'presMismatch': 36, 'x25ClearHostDisabled': 21, 'pvcLcnOutOfRange': 9, 'x25ClearConfigFallback': 26, 'pvcLcnInUse': 32, 'presUnknown': 35, 'codingMismatch': 41, 'unknown': 1, 'noAscusConfigured': 18, 'noSvcLcnAvail': 33, 'peerIdle': 34, 'x25ClearConfigIncompat': 27, 'hostLinkDisabled': 5, 'openMsgTooShort': 37, 'ascuInSession': 42, 'mpxHdrMismatch': 39, 'noResourcesAvail': 14, 'cktOpeningTimeout': 11, 'mpxUnknown': 38, 'x25ParamInvalid': 10, 'x25ClearFacilRejected': 30, 'noHldMatched': 7, 'x25ClearCallerUnknown': 23, 'peerDown': 17, 'hostLinkDown': 3, 'noHostLinkMatched': 6, 'x25ClearNetNoReason': 31, 'x25ClearHLDUnknown': 28, 'trafTypeMismatch': 40, 'cktIdle': 16, 'x25ClearHostDown': 20, 'x25ClearCallerUnauth': 24, 'x25ClearDteNoReason': 12, 'x25ClearPIDUnknown': 29.

Number of packets transmitted to remote peer over this circuit.

Number of octets transmitted to remote peer over this circuit.

Number of packets received from remote peer over this circuit.

Number of octets received from remote peer over this circuit.

Number of packets dropped because the circuit was disabled. This would typically be packets that were queueued before the circuit was disabled which are now left in the queue.

Number of packets dropped due to TCP Congestion.

Number of packets which were queued within the router for longer than alpsCktBaseLifeTimeTimer.

This specifies if the circuit has been enabled. After a circuit has been configured, it must be explicitly enabled in order for the circuit to be set up.

This object is used to create a new row or modify or delete an existing row in this table.

A descriptive ASCII string that is used to distinguish among different peer connections to the same ALPS remote peer IP address.

A list of ALPS X.25 circuits. These entries exist only for X.25 circuits. hence this table would probably be empty at the remote router

Details of ALPS Circuits.

Specifies what type of circuit this is. Enumeration: 'ax25': 2, 'emtox': 1.

Reports the interface the circuit is on. This is the interface which is connected to the host

The Logical Channel Number being used on the X.25 VC for this ALPS Circuit.

The X.121 address on the host side which the central router uses to connect to the host

X.121 address of the remote side. Remote here refers to the side that the ASCUS are connected to and is also referred to as the remote router.

Number of packets dropped due to the VC being reset. These are packets that were queued up for transmission on that VC when it was reset

A list of ALC or UTS Alps circuits.

Details of ALPS Circuits.

Specifies what type of circuit this is. Enumeration: 'uts': 4, 'alc': 3.

This is the IP address of the backup remote peer. This is optional and hence may not always exist.

Specifies the interval at which a permanent ALPS circuit will attempt to reestablish the circuit in case it wasn't able to come up.

If there is no traffic on a dynamic ALPS circuit for this interval, it will be cleared.

Specifies the X.121 address of the SVC established with EMTOX host. This field should be set to length zero in the case of PVCs (AX.25 host).

Specifies the Logical Channel Number being used on the PVC established with AX.25 host. This field should be set to zero in the case of SVCs (EMTOX host).

Specifies X.25 transmit Window size on the Logical Channel Number of this ALPS Circuit.

Specifies the X.25 receive Window size on the Logical Channel Number of this ALPS Circuit.

Specifies the X.25 maxiumum output Packet size on the Logical Channel Number of this ALPS Circuit. The default output Packet size for AX.25 is 240 bytes and 128 bytes for EMTOX.

Specifies X.25 maximum input Packet size on the Logical Channel Number of this ALPS Circuit. The default input Packet size for AX.25 is 240 bytes and 128 bytes for EMTOX.

Specifies the Service Message List Number to use on this ALPS Circuit. This allows custom service messages to be sent for ASCUs on a particular circuit. Service messages are sent out by the router to the ASCU when abnormal conditions occur, and are displayed on the terminal. There is a default set of service messages, usually referred to as List 0. However, it is possible to configure custom sets of service messages for display, selectable on a per-circuit basis.

Specifies Service Message Time Interval for the Service messages to be sent this ALPS Circuit. This controls how frequently the messages are repeated when an error condition (e.g. network being down) persists.

Number of packets that were found to be from an Unknown ASCU (i.e. an ASCU that had not been configured) and hence were dropped.

This object is used to create a new row or modify or delete an existing row in this table.

Specifies the minumum delay between transmission of a MATIP Close and the transmission of a MATIP Session Open for this ALPS circuit.

A list of ASCUs for each ALPS Circuit. This may not include all ASCUs which have this circuit configured as alpsAscuCktName because some ASCUs may be rejected by the host while setting up the circuit.

Details of ASCUs on ASCU Circuits.

The name of the ALPS circuit which this ASCU is on. The circuit may be always up (for permanent circuits) or get set up (dynamic circuits) when there is traffic on one of the ASCUs which are set up for that circuit.

Specifies what type of circuit this is. The X.25 circuit is set up with the same name as the ALC circuit so we need this variable to distinguish between the two. Enumeration: 'ax25': 2, 'uts': 4, 'alc': 3, 'emtox': 1.

A1 value. This is used along with the alpsCktAscuA2 value to identify the ASCU within the circuit.

A2 value. This is used along with the alpsCktAscuA1 value to identify the ASCU within the circuit.

Reports the interface the ASCU is on. This field, along with alpsCktAscuId is provided so that it is possible to correlate this information with the configured ASCU information in alpsAscuTable

Reports the ASCU Identifier which uniquely identifies an ASCU on a given interface. This value is the Interface Address (IA) for ALC and the Remote Identifier (RID) for UTS. A value of 0 indicates that the ASCU id is either unavailable or not applicable.

Reports the ASCU status - ASCUs configured on the circuit can be rejected at the host and would then be marked REJECT. Also, ASCUs configured after the circuit has been established are not added dynamically to the circuit but are marked NEW and get added when the circuit gets established the next time. ASCUs waiting for an accept or reject response from the host are marked as PENDING. ASCUs that were accepted by the host are marked OK. Enumeration: 'unknown': 1, 'ok': 2, 'pending': 5, 'new': 4, 'reject': 3.

A list of interfaces running the P1024B or P1024C protocols

Interface Details

Reports the encapsulation type for this Serial Interface. Enumeration: 'uts': 2, 'alc': 1.

Specifies the Poll Response Time out value.

Specifies the time-out delay between receipt of first character of an input sequence solicited by a poll and receipt of GA sequence.

Specifies the minimum delay between two poll cycles. Thus the poll pause interval is counted from the instant when the first ASCU in the poll list is polled. Note that this is the delay between two traversals of the entire poll list rather than the interval between two consecutive polls. The actual delay will probably be more than the value of this variable.

Specifies a maximum error count for this interface. After an ASCU link comes up, if it experiences this number of errors the ASCU link will be shutdown. The default value of 0 results in the ASCU link never being shutdown.

Specifies the maximum number of times an output message will be retransmitted before it is discarded. This is relevant only for P1024C (UTS). For ALC, a value of 0 will be returned. Note that legal values for UTS are 1-10

Reports the number of errors currently existing for this ASCU link. When this equals alpsIfP1024MaxErrCnt then the ASCU link will be shut down, unless alpsIfP1024MaxErrCnt equals 0 in which case the ascu link is never shut down due to error thresholds being exceeded

Specifies the number of good Poll Responses to be received from an ASCU before it can be declared up.

Specifies how many times ASCUs in UP state are polled before an ASCU in DOWN state is polled again.

Reports the number of ASCUs configured on this Serial Port.

Specifies the format of the service message sent to an ASCU on this interface. Enumeration: 'sita': 1, 'apollo': 2.

Specifies whether service messages generated due to an ALPS circuit status change or an ASCU status change, will be forwarded to the ASCU.

Specifies whether the service message will be sent to the same terminal address of the dropped message or the configured value. Enumeration: 'configterm': 2, 'msgterm': 1.

A list of interfaces running AX.25/EMTOX host link protocols. These are on the central router

Details of AX.25/EMTOX host link protocols on an Interface.

Specifies the HLD of the AX.25/EMTOX host connected on this Interface. The HLD(High-level descriptor) serves as an identifier along with the hostlink number and helps correlate the ALPS circuit to a host link. The hex range is 0x1 to 0xFFFF which corresponds to 1 ... 65535 in decimal.

Specifies the configured Host Link Number on this Serial Interface.

Reports the encapsulation type for this Serial Interface - AX.25 or EMTOX. Enumeration: 'ax25': 1, 'emtox': 2.

The purpose of this object is to handle the link-damping for an AX.25 host. If the PVC goes inactive (i.e. link goes down, etc...) for PVCDampValue seconds, then PVC will be destroyed as well as the associated ALPS circuit.

Specfies the X.121 address of this EMTOX host.

Reports the number of ALPS Ckts established with this host.

A list of ALPS ASCUs on an interface. This is defined only at the remote router.

Details of ASCU.

Specifies the ASCU Identifier and uniquely identifies an ASCU on a given interface. This value is the Interface Address (IA) for ALC and the Remote Identifier (RID) for UTS. This uniquely identifies an ASCU on a given interface.

A1 value of the ASCU.

A2 value of the ASCU.

Specifies the ALPS Circuit Name for the circuit that is to be used for this ASCU's data. Note that all ASCUs on a physical interface may not use the same ALPS circuit to connect to the central router

Specifies whether alarms (syslog messages or SNMP traps) will be generated for this ASCU.

Specifies the retry option for this ASCU. This specifies the error message to be sent to the terminal when a message is dropped at the router. The terminal has three choices - either retransmit the last message (if the terminal can buffer it), re-enter the last message sent or do nothing. Based on the terminal's capabilities, one of these three is configured for the ASCU. Note that this option is the same for all terminals connected to an ASCU because the ALPS feature does not handle individual terminals Enumeration: 'none': 3, 'reenter': 2, 'resend': 1.

Specifies Maximum length of Input Message that can be received from this ASCU.

If this flag is set, status messages received from the ASCU are forwarded to the host. Otherwise they are discarded. Note that these are relevant only for P1024C (UTS). For ALC, a value of FALSE will be returned.

Reports the current ASCU Status. ASCUs are initially in disabled state. They are enabled from the parser if the operator wants to. This takes them to an UP state from which they go to a DOWN state if there are too many errors. Enumeration: 'disabled': 1, 'unknown': 2, 'up': 4, 'down': 3.

Reports the Down reason for this ASCU if it is down. Enumeration: 'ascuDisabled': 4, 'unknown': 1, 'notDown': 3, 'errorThresholdExceeded': 5, 'noReason': 2.

Number of packets transmitted to this ASCU.

Number of octets transmitted to this ASCU.

Number of packets received from this ASCU

Number of octets received from this ASCU.

The number of packets dropped due to the inability to properly decode them. Examples of garbled packets include packets with bad CRCs or bad header information

The number of packets dropped because the ASCU had previously been declared DOWN due to error thresholds being exceeded.

The number of packets dropped because the ASCU had previously been declared to be in disabled state.

Specifies whether the ASCU has been enabled or not. After the ASCU has been configured, it must be explicitly enabled to allow it to be polled.

This object is used to create a new row or modify or delete an existing row in this table.

Specifies whether a reset command will be automatically issued to any non-responsive ALC ASCUs.

A list of service messages and its associated number. There is a default list of service messages (list 0) as well as user-configurable service messages. On a per-circuit basis, the service message list to use can be selected. The user-configured service message lists are defined in this table. Note that the default service messages are not part of this table.

Service Messages configured along with its List number and Service Message Number in that list.

Specifies the Service Msg Number of this Service Msg. A maximum of 8 Service Message lists can be configured not including the one for Default/System (when alpsSvcMsgListNum = 0) Service messages.

Specifies the Service Msg Number of this Service Msg. A Maximum of 8 messages can be present.

Specifies the Service Message string .

This object is used to create a new row or modify or delete an existing row in this table.

A Translation table between X.121 address and IP address. This is intended to allow a connection to be established to the appropriate remote router. The X121 address in the call packet is used to look up the IP address of the remote peer

A mapping table between X.121 address and IP address.

Specfies the X.121 address of the VC established with EMTOX host.

This is the IP address of the remote peer which maps onto the X.121 address.

This object is used to create a new row or modify or delete an existing row in this table.

This Notification is generated when there is a change in state for the peer connection, provided alarms are enabled for that peer.

This Notification has to be generated whenever there is a state change for the ALPS circuit, provided alarms are enabled for that circuit

This Notification has to be generated whenever there is a change in ASCU status, provided alarms are enabled for that ASCU

This Notification is generated when there is a change in state for an ALPS peer connection, provided alarms are enabled for that peer connection.

This Notification is generated whenever there is an open failure for the ALPS circuit, provided alarms are enabled for that circuit

This Notification is generated whenever there is an open confirmation that contains a list of rejected ASCUs for the ALPS circuit, provided alarms are enabled for that circuit

The compliance statement for ALPS.

The compliance statement for ALPS.

The compliance statement for ALPS.

A collection of objects providing Peer information

A collection of objects providing Circuit information

A collection of objects providing ALC interface information

A collection of objects providing Hostlink information

A collection of objects providing ASCU information

A collection of objects providing Service Message information

A collection of objects providing Address Translation information.

A collection of notifications.

A collection of objects providing peer information.

A collection of notifications.

A collection of objects providing ALC interface information

A collection of objects providing ASCU information

A collection of notifications.