Table Of Contents
Cisco Mainframe Channel Connection Commands
adapter
channel-protocol
clear extended counters
exception slot
interface channel
lan
max-llc2-sessions
name
show controllers channel
show extended channel connection-map llc2
show extended channel icmp-stack
show extended channel ip-stack
show extended channel lan
show extended channel llc2
show extended channel max-llc2-sessions
show extended channel statistics
show extended channel subchannel
show extended channel tcp-connections
show extended channel tcp-stack
show extended channel udp-listeners
show extended channel udp-stack
show interfaces channel
shutdown (CMCC)
state-tracks-signal
Cisco Mainframe Channel Connection Commands
Use the commands in this chapter to configure and monitor the Cisco Mainframe Channel Connection (CMCC) products which include the Channel Interface Processor (CIP) and the Channel Port Adapter (CPA). For commands to configure specific features on a CMCC adapter, see the corresponding chapters in this publication.
For hardware technical descriptions and for information about installing the router interfaces, refer to the hardware installation and maintenance publication for your particular product.
Note 
Unless otherwise specified, all commands in this chapter are supported on the Cisco 7000 with RSP7000, Cisco 7500 and the Cisco 7200 series routers.
For interface configuration information and examples, refer to the "Configuring Cisco Mainframe Channel Connection Adapters" chapter of the Cisco IOS Bridging and IBM Networking Configuration Guide.
For a conversion table of the modular products and Cisco 7000 family processors, refer to the "Platform Support" appendix of the Cisco IOS Configuration Fundamentals Command Reference.
adapter
To configure internal adapters, use the adapter command in internal LAN interface configuration submode. To remove an internal adapter, use the no form of this command.
adapter adapter-number [mac-address] [hsma-partner hsma-mac-address]
no adapter adapter-number [mac-address]
Syntax Description
adapter-number
|
Number in the range from 0 to 31 that uniquely identifies the internal adapter (relative adapter number) for all internal LANs of the same type on the Cisco Mainframe Channel Connection (CMCC) adapter. In Cisco Systems Network Architecture (CSNA), this value corresponds to the adaptor number (ADAPNO) parameter defined in the Virtual Telecommunications Access Method (VTAM) Extended Communications Adapter (XCA) Major Node.
|
mac-address
|
(Optional) MAC address for this internal adapter. This is a hexadecimal value in the form xxxx.xxxx.xxxx.
|
hsma-partner
|
(Optional) Specifies a hot standby MAC address (HSMA) partner.
|
hsma-mac-address
|
(Optional) MAC address of the HSMA partner control adapter.
|
Defaults
No default behavior or values
Command Modes
Internal LAN interface configuration
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
12.3(3)
|
The hsma-partner keyword and hsma-mac-address argument were added.
|
Usage Guidelines
This command is valid only on the virtual channel interface. Internal adapters are used to provide LAN gateway MAC addresses for the following CMCC adapter features: CSNA, Cisco Multipath Channel (CMPC), and TN3270 Server.
Up to 18 internal adapters can be configured on a CMCC adapter. Internal adapters are configured on internal LANs. The only limit to the number of internal adapters that you can configure on a single internal LAN is the limit of up to 18 total internal adapters per CMCC.
When an internal adapter configuration command is removed or an existing internal adapter is modified, the mac-address parameter is not required. In internal adapter configuration mode, the router prompt appears as follows:
router(cfg-adap-type n-m)#
In this syntax, type is the internal LAN type, n is the LAN ID, and m is the adapter number.
HSMA is designed to allow redundant CMCC internal adapter MAC addresses in an Ethernet environment. Communication between the HSMA control adapters is used to ensure that only one of the adapters is active at a time.
Examples
The following example shows how to configure internal adapters 3 and 4 (with their corresponding MAC addresses) on the internal Token Ring LAN number 20, and internal adapter 1 on the internal Token Ring LAN number 10:
The following example shows how to configure internal adapter 9 to communicate with the HSMA partner at the MAC address 4043.3333.001a:
adapter 9 4043.1313.9009 hsma-partner 4043.3333.001a
adapter 26 4043.1111.001a
Related Commands
Command
|
Description
|
lan
|
Configures an internal LAN on a CMCC adapter interface and enters the internal LAN configuration mode.
|
name
|
Assigns a name to an internal adapter.
|
show extended channel lan
|
Displays the internal LANs and adapters configured on a CMCC adapter.
|
show extended channel llc2
|
Displays information about the LLC2 sessions running on CMCC adapter interfaces.
|
show extended channel connection-map llc2
|
Displays the number of active LLC2 connections for each SAP and the mapping of the internal MAC adapter and the SAP to the resource that activated the SAP.
|
source-bridge
|
Configures an interface for SRB.
|
channel-protocol
To define a data rate of either 3 MBps or 4.5 MBps for Parallel Channel Interfaces, use the channel-protocol interface configuration command. To return to the default rate of 3 MBps, use the no form of this command.
channel-protocol [s | s4]
no channel-protocol
Syntax Description
s
|
(Optional) Specifies a data rate of 3 MBps.
|
s4
|
(Optional) Specifies a data rate of 4.5 MBps.
|
Defaults
If no value is specified, the default data rate for the Parallel Channel Adapter (PCA) and the Parallel Channel Port Adapter (PCPA) is 3 MBps.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
10.2
|
This command was introduced.
|
Usage Guidelines
This command is valid on Parallel Channel Interfaces.
Examples
The following example specifies a data rate of 4.5 MBps for the interface:
clear extended counters
To clear the extended interface counters associated with CMCC features, use the clear extended counters EXEC command.
clear extended counters [channel slot/port [csna | icmp-stack | ip-stack | llc2 | statistics |
tcp-connections | tcp-stack | tg | tn3270-server | udp-stack]]
Syntax Description
channel
|
(Optional) Specifies a channel interface.
|
slot
|
(Optional) Slot number.
|
port
|
(Optional) Port number.
|
csna
|
(Optional) Clears CSNA feature counters.
|
icmp-stack
|
(Optional) Clears ICMP stack counters.
|
ip-stack
|
(Optional) Clears IP stack counters.
|
llc2
|
(Optional) Clears LLC2 counters.
|
statistics
|
(Optional) Clears subchannel statistic counters.
|
tcp-connections
|
(Optional) Clears TCP connection counters.
|
tcp-stack
|
(Optional) Clears TCP stack counters.
|
tg
|
(Optional) Clears TG counters.
|
tn3270-server
|
(Optional) Clears TN3270 Server counters.
|
udp-stack
|
(Optional) Clears UDP stack counters.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.3
|
This command was introduced.
|
Usage Guidelines
This command is valid on both the physical and virtual channel interfaces. To clear counters for a selected CMCC feature, you must specify the channel interface on which the feature is configured or running.
Counters displayed using the show extended channel EXEC command are cleared using this command.
Entering any form of this command will prompt the user for a confirmation before clearing any counters. A "CLEAR-5-EXT_COUNT" message is displayed to indicate successful completion of the command.
These counters will be cleared in the show commands and remain uncleared when obtained through the SNMP interface.
Examples
The following is an example of the command:
Related Commands
exception slot
To provide a core dump of a CMCC adapter, use the exception slot global configuration command. To disable the core dump, use the no form of this command.
exception slot [slot] protocol://host/filename
no exception slot [slot] protocol://host/filename
Syntax Description
slot
|
(Optional) Slot number of the CMCC adapter. If no slot is specified, all installed CMCC adapters will output a core dump when they halt unexpectedly.
|
protocol
|
Protocol for transferring the file. Currently, the only allowed value is FTP.
|
host
|
Name or IP address of the host that receives the core dump information.
|
filename
|
Filename on the host that receives the core dump information. The maximum name length is 31 characters. When written to the host, slot is automatically appended, where slot is the slot number.
|
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Release
|
Modification
|
11.2
|
This command was introduced.
|
Usage Guidelines
This command is only supported on the Cisco 7000 with RSP7000 and Cisco 7500 series routers.
You must configure FTP services on the router before you can create a CMCC adapter core dump.
Do not exceed your host limits on filename length. An additional two characters are added to the filename, slot, where slot is the slot number.
Examples
The following example shows how to configure a router to perform a CMCC adapter core dump. Assuming the CIP is installed in slot 3, the filename cipdump.3 will be written to the host.
ip name-server 168.69.161.21
exception slot ftp://168.18.2.196/cipdump
Related Commands
Command
|
Description
|
ip domain-name
|
Defines a default domain name to complete unqualified host names (names without a dotted-decimal domain name).
|
ip name-server
|
Specifies the address of one or more name servers to use for name and address resolution.
|
ip ftp username
|
Configures the username for FTP connections.
|
ip ftp password
|
Specifies the password to be used for FTP connections.
|
interface channel
To specify a channel-attached interface and enter interface configuration mode, use the interface channel global configuration command.
interface channel slot/port
Syntax Description
slot
|
Slot number where the CMCC adapter is located.
|
port
|
Interface where the CMCC adapter is located.
|
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Release
|
Modification
|
10.2
|
This command was introduced.
|
Examples
The following example shows how to enter interface configuration mode for a CIP in slot 2 and begin configuring port 0:
Related Commands
Command
|
Description
|
channel-protocol
|
Defines a data rate of either 3 MBps or 4.5 MBps for Parallel Channel Interfaces.
|
claw (primary)
|
Configures a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in IP datagram mode and also configures individual members of a CLAW backup group for the IP Host Backup feature.
|
cmpc
|
Configures a CMPC (or CMPC+) read subchannel and a CMPC (or CMPC+) write subchannel.
|
csna
|
Configures SNA support on a CMCC physical channel interface and specifies the path and device/subchannel on a physical channel of the router to communicate with an attached mainframe.
|
lan
|
Configures an internal LAN on a CMCC adapter interface and enters internal LAN configuration mode.
|
max-llc2-sessions
|
Specifies the maximum number of LLC2 sessions supported on the CMCC adapter.
|
offload (primary)
|
Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in offload mode and also configures individual members of an Offload backup group for the IP Host Backup feature.
|
offload (backup)
|
Configures a backup group of Offload devices.
|
tg (CMPC)
|
Defines LLC connection parameters for the CMPC TG.
|
tn3270-server
|
Starts the TN3270 server on a CMCC adapter and enters TN3270 server configuration mode.
|
lan
To configure an internal LAN on a CMCC adapter interface and enter the internal LAN configuration mode, use the lan interface configuration command. To remove an internal LAN interface, use the no form of this command.
lan type lan-id
no lan type lan-id
Syntax Description
type
|
Interface type for this internal LAN: tokenring.
|
lan-id
|
Number 0 to 31 that uniquely identifies the internal LAN on this CMCC adapter. This value must be unique between all internal LANs of the same interface type on a CMCC adapter.
|
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Usage Guidelines
Token Ring is the only type of internal LAN that is supported.
This command is valid only on the virtual channel interface. All internal adapters configured on the internal LAN must be removed first before the internal LAN can be removed.
A CMCC internal LAN can be configured as a SRB LAN. This allows LLC packets to be bridged between the CMCC adapter and IOS, providing a means to link the internal LAN to Cisco IOS SNA features such as SRB, DLSw+, RSRB, SDLLC, QLLC, APPN, and SR/TLB.
An internal LAN can only be configured on a virtual channel interface of a CMCC adapter. You enter the internal LAN configuration mode by issuing the command for an internal LAN that already exists or when you configure an internal LAN for the first time. In the internal LAN configuration mode, the router prompt appears as follows:
router (cfg-lan-type n) #
In this syntax, type is the specified internal LAN type and n is the specified value for the lan-id.
Examples
The following example shows how to configure an internal LAN Token Ring with a LAN ID of 20 on the channel interface 1/2:
Related Commands
Command
|
Description
|
adapter
|
Configures internal adapters.
|
locaddr-priority
|
Assigns an RSRB priority group to an input interface.
|
sap-priority
|
Defines a priority list on an interface.
|
show extended channel lan
|
Displays the internal LANs and adapters configured on a CMCC adapter.
|
source-bridge
|
Configures an interface for SRB.
|
max-llc2-sessions
To specify the maximum number of LLC2 sessions supported on the CMCC adapter, use the max-llc2-sessions interface configuration command. To restore the default value, use the no form of this command.
max-llc2-sessions number
no max-llc2-sessions number
Syntax Description
number
|
A value in the range 1 to 6000 LLC sessions. If this command is not configured, the default is 256 sessions.
|
Defaults
The default number of sessions is 256.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Usage Guidelines
This command is configured on the virtual interface of a CIP, and the physical interface of a CPA. If you do not configure this parameter on the CMCC adapter, then the limit of LLC2 sessions is 256.
This command will fail if there is not enough memory currently available on the CMCC adapter to support the specified number of LLC2 sessions.
Note A value of 0 sets the maximum number of LLC2 sessions to the default value of 256. In this case, the value does not appear in your configuration when you use the show run command.
Examples
The following example limits the maximum number of LLC2 sessions to 212:
name
To assign a name to the internal adapter, use the name internal adapter configuration command. To remove the name assigned to an internal adapter, use the no form of this command.
name name
no name name
Syntax Description
name
|
Name that identifies this internal adapter. The name consists of up to 8 characters (not including blanks).
|
Defaults
No default behavior or values.
Command Modes
Internal adapter configuration
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Examples
The following example assigns a name to an internal adapter interface:
Related Commands
Command
|
Description
|
adapter
|
Configures internal adapters.
|
show controllers channel
To display CPA-specific information, including the currently loaded microcode, use the show controllers channel EXEC command.
show controllers channel [slot/port]
Syntax Description
slot
|
(Optional) Slot number.
|
port
|
(Optional) Interface number.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.3T
|
This command was introduced.
|
Examples
The following is sample output from the show controllers channel command:
Router# show controllers channel 5/0
ECPA 5, hardware version 1.0, microcode version 26.0
Mailbox commands: 0 forevers, 0 max elapsed usecs
Microcode loaded from flash slot0:xcpa26-0_kernel_xcpa
Loaded:seg_eca Rev. 0 Compiled by cip-release on 01-Apr-98
EPROM version 1.0, VPLD version 1.1
ECA0: hw version 255, microcode version C50602D1
Memory sram 2964552/4096K, dram 11552952/16M
ECA0 1m 0%, 5m 0%, 60m 0%
Hardware is Escon Channel
HW Registers control status=0x0001EC07 LED control=0x00045DD5
HW Poll Register 4B05D4E0:[00000001]
queue=0 max_entries=128 size=600 head=39 ring=4B095F00
queue=1 max_entries=32 size=4520 head=31 ring=4B095E40
queue=2 max_entries=64 size=4520 head=63 ring=4B096140
queue=0 head=0 tail=0 tx_cnt=0 tx_pakcnt=0
max_entries=128 type=1 poll_index=0 ring=4B0963C0
fspak buffers swapped out=0
queue=1 head=31 tail=31 tx_cnt=0 tx_pakcnt=0
max_entries=32 type=2 poll_index=1 ring=4B096280
fspak buffers swapped out=0
max_entries=221 poll_index=3 head=57 ring=4B096800
max packets per interrupt count = 0
show extended channel connection-map llc2
To display the number of active LLC2 connections for each SAP and the mapping of the internal MAC adapter and the SAP to the resource that activated the SAP, use the show extended channel connection-map llc2 privileged EXEC command.
show extended channel slot/port connection-map llc2
Syntax Description
slot
|
Slot number.
|
port
|
Port number.
|
connection-map llc2
|
Displays a connection map of LLC2 connections.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.0(3)
|
This command was introduced.
|
Usage Guidelines
The show extended channel connection-map llc2 command is valid only on the virtual channel interfaces.
Examples
The following is sample output from the show extended channel connection-map llc2 command:
Router# show extended channel 1/2 connection-map llc2
LAN Token 0 Adapter 0 4000.7000.0747
Local SAP=08 LLC2 Connections=4 CSNA Port=1 Path=C200 Device=60
Local SAP=0C LLC2 Connections=4 CSNA Port=1 Path=C200 Device=60
Local SAP=10 LLC2 Connections=2 CSNA Port=1 Path=C200 Device=60
Local SAP=14 LLC2 Connections=0 CSNA Port=1 Path=C200 Device=60
LAN Token 1 Adapter 1 4000.7000.0767
Local SAP=08 LLC2 Connections=3 CSNA Port=1 Path=C200 Device=61
Local SAP=0C LLC2 Connections=3 CSNA Port=1 Path=C200 Device=61
Local SAP=10 LLC2 Connections=2 CSNA Port=1 Path=C200 Device=61
Local SAP=14 LLC2 Connections=2 CSNA Port=1 Path=C200 Device=61
LAN Token 2 Adapter 2 4000.7000.0737
No SAPs open on this interface
Total : SAPs opened = 8 Connections active = 20
show extended channel icmp-stack
To display information about the Internet Control Message Protocol (ICMP) stack running on the CMCC channel interfaces, use the show extended channel icmp-stack EXEC command.
show extended channel slot/port icmp-stack [ip-address]
Syntax Description
slot
|
Slot number.
|
port
|
Port number.
|
ip-address
|
(Optional) IP address specified by the offload interface configuration command or the tn3270-server pu command.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
12.0(7)T
|
Alias addresses field added to the output.
|
Usage Guidelines
The show extended channel icmp-stack command is valid on both physical and virtual channel interfaces.
Examples
The following is sample output from the show extended channel icmp-stack command:
Router# show extended channel 0/1 icmp-stack
ICMP Statistics for IP Address 80.11.198.2
InMsgs : 3 InErrors : 0 InDestUnreachs: 0
InTimeExcds : 0 InParmProbs : 0 InSrcQuenchs : 0
InRedirects : 0 InEchos : 3 OutEchoReps : 3
OutTimestamps : 0 OutTimestampReps: 0 OutAddrMasks : 0
ICMP Statistics for IP Address 80.11.198.3
InMsgs : 1 InErrors : 0 InDestUnreachs: 0
InTimeExcds : 0 InParmProbs : 0 InSrcQuenchs : 0
InRedirects : 0 InEchos : 1 OutEchoReps : 1
OutTimestamps : 0 OutTimestampReps: 0 OutAddrMasks : 0
The following example shows sample output from the show extended channel icmp-stack for an offload device at real IP address 10.10.21.3 and alias IP address of 10.2.33.88:
Router# show extended channel 3/1 icmp-stack
ICMP Statistics for IP Address 10.10.21.3
Alias addresses: 10.2.33.88
InMsgs : 0 InErrors : 0 InDestUnreachs: 0
InTimeExcds : 0 InParmProbs : 0 InSrcQuenchs : 0
InRedirects : 0 InEchos : 0 OutEchoReps : 0
OutTimestamps : 0 OutTimestampReps: 0 OutAddrMasks : 0
Table 10 describes the fields shown in the display.
Table 10 show extended channel icmp-stack Field Descriptions
Field
|
Description
|
Alias addresses
|
Virtual IP addresses assigned to the real IP address of an offload device.
|
InMsgs
|
Total number of ICMP messages which the entity received. Note that this counter includes all those counted by icmpInErrors.
|
InErrors
|
Number of ICMP messages which the entity received but determined as having ICMP-specific errors (for example, bad ICMP checksums, bad length).
|
InDestUnreachs
|
Number of ICMP Destination Unreachable messages received.
|
InTimeExcds
|
Number of ICMP Time Exceeded messages received.
|
InParmPrbs
|
Number of ICMP Parameter Problem messages received.
|
InSrcQuenchs
|
Number of ICMP Source Quench messages received.
|
InRedirects
|
Number of ICMP Redirect messages received.
|
InEchos
|
Number of ICMP Echo (request) messages received.
|
OutEchoReps
|
Number of ICMP Echo Reply messages sent.
|
OutTimestamps
|
Number of ICMP Timestamp (request) messages sent.
|
OutTimestampReps
|
Number of ICMP Timestamp Reply messages sent.
|
OutAddrMasks
|
Number of ICMP Address Mask Request messages sent.
|
OutAddrMaskReps
|
Number of ICMP Address Mask Reply messages sent.
|
Related Commands
Command
|
Description
|
offload (primary)
|
Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in offload mode and also configures individual members of an Offload backup group for the IP Host Backup feature.
|
pu (TN3270)
|
Creates a PU entity that has its own direct link to a host and enters PU configuration mode.
|
pu (DLUR)
|
Creates a PU entity that has no direct link to a host and enters DLUR PU configuration mode.
|
show extended channel ip-stack
To display information about the IP stack running on CMCC channel interfaces, use the show extended channel ip-stack EXEC command.
show extended channel slot/port ip-stack [ip-address]
Syntax Description
slot
|
Slot number.
|
port
|
Port number.
|
ip-address
|
(Optional) IP address specified by the offload interface configuration command or the tn327-server pu command.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
12.0(7)T
|
Alias addresses field added to the output.
|
Usage Guidelines
The show extended channel ip-stack command is valid on both physical and virtual channel interfaces.
Examples
The following is sample output from the show extended channel ip-stack command:
Router# show extended channel 0/1 ip-stack
IP Statistics for IP Address 80.11.198.2
Forwarding : no DefaultTTL : 64 InReceives : 165
InHdrErrors : 0 InAddrErrors : 0 ForwDatagrams: 0
InUnknownProtos: 0 InDiscards : 0 InDelivers : 165
OutRequests : 157 OutDiscards : 0 OutNoRoutes : 0
ReasmTimeout : 60 ReasmReqds : 0 ReasmOKs : 0
ReasmFails : 0 FragOKs : 0 FragFails : 0
FragCreates : 0 RoutingDiscards: 0
IP Statistics for IP Address 80.11.198.3
Forwarding : no DefaultTTL : 64 InReceives : 77
InHdrErrors : 0 InAddrErrors : 0 ForwDatagrams: 0
InUnknownProtos: 0 InDiscards : 0 InDelivers : 77
OutRequests : 78 OutDiscards : 0 OutNoRoutes : 0
ReasmTimeout : 60 ReasmReqds : 0 ReasmOKs : 0
ReasmFails : 0 FragOKs : 0 FragFails : 0
FragCreates : 0 RoutingDiscards: 0
The following example shows sample output from the show extended channel ip-stack for an offload device at real IP address 10.10.21.3 and alias IP address of 10.2.33.88:
Router# show extended channel 3/1 ip-stack
IP Statistics for IP Address 10.10.21.3
Alias addresses: 10.2.33.88
Forwarding : no DefaultTTL : 64 InReceives : 16
InHdrErrors : 0 InAddrErrors : 0 ForwDatagrams: 0
InUnknownProtos: 0 InDiscards : 0 InDelivers : 16
OutRequests : 7 OutDiscards : 0 OutNoRoutes : 0
ReasmTimeout : 60 ReasmReqds : 0 ReasmOKs : 0
ReasmFails : 0 FragOKs : 0 FragFails : 0
FragCreates : 0 RoutingDiscards: 0
The following example shows sample output from the show extended channel ip-stack when you specify the alias IP address for an offload device at real IP address 10.10.21.3:
Router# show extended channel 3/1 ip-stack 10.2.33.88
IP Statistics for IP Address 10.10.21.3
Alias addresses: 10.2.33.88
Forwarding : no DefaultTTL : 64 InReceives : 16
InHdrErrors : 0 InAddrErrors : 0 ForwDatagrams: 0
InUnknownProtos: 0 InDiscards : 0 InDelivers : 16
OutRequests : 7 OutDiscards : 0 OutNoRoutes : 0
ReasmTimeout : 60 ReasmReqds : 0 ReasmOKs : 0
ReasmFails : 0 FragOKs : 0 FragFails : 0
FragCreates : 0 RoutingDiscards: 0
Table 11 describes the fields shown in the display.
Table 11 show extended channel ip-stack Field Descriptions
Field
|
Description
|
Alias addresses
|
Virtual IP addresses assigned to the real IP address of an offload device.
|
Forwarding
|
Indication of whether this entity is acting as an IP gateway in respect to the forwarding of datagrams received by, but not addressed to, this entity. IP gateways forward datagrams. IP hosts do not (except those source-routed via the host).
Note that for some managed nodes, this object may take on only a subset of the values possible. Accordingly, it is appropriate for an agent to return a `badValue' response if a management station attempts to change this object to an inappropriate value.
|
DefaultTTL
|
The default value inserted into the Time-To-Live field of the IP header of datagrams originated at this entity, whenever a TTL value is not supplied by the transport layer protocol.
|
InReceives
|
Total number of input datagrams received from interfaces, including those received in error, for this IP Address instance.
|
InHdrErrors
|
Number of input datagrams discarded due to errors in their IP headers, including bad checksums, version number mismatch, other format errors, time-to-live exceeded, errors discovered in processing their IP options, etc.
|
InAddrErrors
|
Number of input datagrams discarded because the IP address in their IP header's destination field was not a valid address to be received at this entity. This count includes invalid addresses (for example, 0.0.0.0) and addresses of unsupported Classes (for example, Class E). For entities which are not IP Gateways and therefore do not forward datagrams, this counter includes datagrams discarded because the destination address was not a local address.
|
ForwDatagrams
|
Number of input datagrams for which this entity was not their final IP destination, as a result of which an attempt was made to find a route to forward them to that final destination. In entities that do not act as IP Gateways, this counter will include only those packets that were Source-Routed through this entity, and the Source-Route option processing was successful.
|
InUnknownProtos
|
Number of locally-addressed datagrams received successfully but discarded because of an unknown or unsupported protocol.
|
InDiscards
|
Number of input IP datagrams for which no problems were encountered to prevent their continued processing, but which were discarded (for example, for lack of buffer space). Note that this counter does not include any datagrams discarded while awaiting re-assembly.
|
InDelivers
|
Total number of input datagrams successfully delivered to IP user-protocols (including ICMP)
|
OutRequests
|
Total number of IP datagrams that local IP user-protocols (including ICMP) supplied to IP in requests for sending. Note that this counter does not include any datagrams counted in ipForwDatagrams.
|
OutDiscards
|
Number of output IP datagrams for which no problem was encountered to prevent sending them to their destination, but which were discarded (for example, for lack of buffer space). Note that this counter would include datagrams counted in ipForwDatagrams if any such packets met this (discretionary) discard criterion.
|
OutNoRoutes
|
Number of IP datagrams discarded because no route could be found to send them to their destination. Note that this counter includes any packets counted in ipForwDatagrams that meet this `no-route' criterion. Note that this includes any datagrams which a host cannot route because all of its default gateways are down.
|
ReasmTimeout
|
Maximum number of seconds that received fragments are held while they are awaiting reassembly at this entity.
|
ReasmReqds
|
Number of IP fragments received that needed to be reassembled at this entity.
|
ReasmOKs
|
Number of IP datagrams successfully reassembled.
|
ReasmFails
|
Number of failures detected by the IP reassembly algorithm (for whatever reason: timed out, errors, and so on). Note that this is not necessarily a count of discarded IP fragments since some algorithms (notably the algorithm in RFC 815) can lose track of the number of fragments by combining them as they are received.
|
FragOKs
|
Number of IP datagrams that have been successfully fragmented at this entity.
|
FragFails
|
Number of IP datagrams that have been discarded because they needed to be fragmented at this entity but could not be, for example, because their Don't Fragment flag was set.
|
FragCreates
|
Number of IP datagram fragments that have been generated as a result of fragmentation at this entity.
|
RoutingDiscards
|
Number of routing entries that were chosen to be discarded even though they are valid. One possible reason for discarding such an entry could be to free-up buffer space for other routing entries.
|
Related Commands
Command
|
Description
|
offload (primary)
|
Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in offload mode and also configures individual members of an Offload backup group for the IP Host Backup feature.
|
pu (TN3270)
|
Creates a PU entity that has its own direct link to a host and enters PU configuration mode.
|
pu (DLUR)
|
Creates a PU entity that has no direct link to a host and enters DLUR PU configuration mode.
|
show extended channel lan
To display the internal LANs and adapters configured on a CMCC adapter, use the show extended channel lan EXEC command.
show extended channel slot/port lan [tokenring [lan-id [adapno]]]
Syntax Description
slot
|
Slot number.
|
port
|
Port number.
|
tokenring
|
(Optional) Specify CMCC internal LAN type to be displayed.
|
lan-id
|
(Optional) Specify the CMCC internal LAN number to be displayed.
|
adapno
|
(Optional) Specify the CMCC internal adapter number on the selected internal LAN to be displayed.
|
Defaults
Display all internal LANs and adapters on the selected channel interface.
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Usage Guidelines
This command is valid only on the virtual channel interface.
Examples
The following is sample output from the show extended channel lan command:
Router# show extended channel 3/2 lan
Adapno Mac Address Name Vcnum
Adapno Mac Address Name Vcnum
Adapno Mac Address Name Vcnum
Adapno Mac Address Name Vcnum
Adapno Mac Address Name Vcnum
Adapno Mac Address Name Vcnum
Adapno Mac Address Name Vcnum
Related Commands
Command
|
Description
|
adapter
|
Configures internal adapters.
|
lan
|
Configures an internal LAN on a CMCC adapter interface and enters internal LAN configuration mode.
|
show extended channel llc2
To display information about the LLC2 sessions running on the CMCC adapter interfaces, use the show extended channel llc2 EXEC command.
show extended channel slot/port llc2 [admin | oper | stats] [lmac [lsap [rmac [rsap]]]]
Syntax Description
slot
|
Slot number.
|
port
|
Port number.
|
admin
|
(Optional) Shows configured values. This is the default.
|
oper
|
(Optional) Shows operational values for:
•Internal adapters
•SAPs opened on the internal adapters
•LLC2 connections on the internal adapters
|
stats
|
(Optional) Displays statistics for:
•Internal adapters
•SAPs opened on the internal adapters
•LLC connections on the internal adapters
|
lmac
|
(Optional) Local MAC address.
|
lsap
|
(Optional) Local service access point (SAP) address, 0 to 256.
|
rmac
|
(Optional) Remote MAC address.
|
rsap
|
(Optional) Remote SAP address, 0 to 256.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0(3)
|
This command was introduced.
|
Usage Guidelines
The show extended channel llc2 command is valid on virtual channel interfaces.
To specify LLC information for internal adapters:
•Specify a value for the lmac argument to get information for a specific internal adapter.
•Omit the lmac argument to display information for all internal adapters on the specified channel interface.
To display LLC information for SAPs opened on an internal adapter:
•Specify values for the lmac and lsap arguments to display information for a particular SAP.
•Specify a value for the lmac argument and `*' to display information for all SAPs opened on the specified channel adapter.
To display information for LLC2 connections on a channel interface:
•Specify values for the lmac, lsap, rmac, and rsap arguments to display information for a particular active LLC2 connection.
•Specify values for the lmac, lsap, and rmac arguments to display information for all LLC2 connections active between the specified remote MAC address and the specified local SAP opened on the specified internal adapter.
•Specify values for the lmac and lsap arguments, and `*' to display information for all LLC2 connections active on the specified local SAP and the specified internal adapter and any remote MAC address the connections are active with.
•Specify a value for the lmac argument, `*' for the local SAP, and a value for the rmac argument to display information for all LLC2 connections active between the specified internal adapter and the remote MAC address.
•Specify a value for the lmac argument, `*' for the local SAP, and `*' for the remote MAC address to display information for all active LLC2 connections on the specified internal adapter.
Examples
The following is sample output from the show extended channel llc2 command. Three examples are provided, one for each type of output as specified by the admin, oper, and stats keywords.
The following sample displays the configured values for all LLC2 connections on channel 2/2:
Router# show extended channel 2/2 llc2 admin
Lan Token adapter 0 0004.0004.0004
t1-time = 1000 tpf-time = 1000 trej-time = 3200 tbusy-tim = 9600
idle-time =60000 local-win = 7 recv-wind = 7 N2 = 8
N1 = 1033 ack-delay = 100 ack-max = 3 nw = 0
Table 12 describes the fields shown in the display.
Table 12 show extended channel llc2 admin Field Descriptions—All LLC2 Connections
Field
|
Description
|
t1-time
|
Length of time the CMCC LLC2 link station waits for an acknowledgment to a sent I-frame before polling the remote LLC2 station.
|
tpf-time
|
Amount of time the CMCC LLC2 link station waits for a final response to a poll before resending the original poll frame.
|
trej-time
|
Amount of time the CMCC LLC2 link station waits for a correct frame after sending a reject command to a remote LLC2 station.
|
tbusy-time
|
Amount of time the CMCC LLC2 link station waits before repolling a busy LLC2 station.
|
idle-time
|
Frequency of polls during periods of idle traffic.
|
local-win
|
Maximum number of I-frames that the CMCC LLC2 link station connection can send to the remote LLC2 station without receiving an acknowledgment.
|
recv-wind
|
Maximum number of I-frames that the CMCC LLC2 link station connection can receive without receiving an acknowledgment.
|
N2
|
Number of times the CMCC LLC2 link station connection will resend an unacknowledged I-frame.
|
N1
|
Maximum size of LLC frames supported by the CMCC LLC2 link station. The maximum size LLC frame supported on the CMCC is controlled by other factors including the largest interface MTU between the CMCC and the remote network device, and configured values at VTAM and at the end station.
|
ack-delay
|
Maximum amount of time the CMCC LLC2 link station allows received I-frames to remain unacknowledged. The CMCC LLC2 connection will acknowledge received I-frames within the ack-delay time.
|
ack-max
|
Maximum number of I-frames the CIP LLC2 link station receives before sending an acknowledgment.
|
Nw
|
Working send window size. When I-frames sent by the CMCC are rejected by the remote LLC2 station, the CMCC LLC2 connection reduces its working send window size to 1. Then, for every subsequent I-frame sent by the CMCC LLC2 connection that is positively acknowledged by the remote LLC2 station, the CMCC LLC2 connection increases its working send window by the Nw value until the working send window reaches the configured local-window value.
|
The following sample displays the operational values for all LLC2 connections on channel 2/2:
Router# show extended channel 5/2 llc oper
LAN Token 0 Adapter 0 4000.1010.2020
Open SAPS is the number of SAPs currently opened on this internal MAC adapter. Max SAPs Opened is the number of SAPs concurrently opened on this internal MAC adapter since the last reset of the channel adapter of channel interface.
The following sample displays operational information for the specified SAP opened on a CMCC internal adapter:
Router# show extended channel 5/2 llc stat
LAN Token 0 Adapter 0 4000.1010.2020
PDUsIn = 223339 PDUsOut = 9564
OctetsIn = 6949875 OctetsOut = 307448
TESTCmdsIn = 213293 TESTRspsOut = 2
LocalBusies= 0 UnknownSAPs = 0
Table 13 describes the fields shown in the display. These statistics are available on the adapter because when LLC2 connections are deactivated, users can no longer retrieve the information per LLC2 connection.
Table 13 show extended channel llc2 stats Field Descriptions—all LLC2 Connections
Field
|
Description
|
PDUsIn
|
Protocol Data Units received by the internal adapter.
|
PDUsOut
|
Protocol Data Units sent by the internal adapter.
|
OctetsIn
|
PDU bytes received by the internal adapter.
|
OctetsOut
|
PDU bytes sent by the internal adapter.
|
TESTCmdsIn
|
Number of TEST commands received destined for this MAC address.
|
TESTRspsOut
|
Number of TEST responses sent by this MAC address responding to TEST commands received.
|
Local Busies
|
Number of times LLC2 connection stations on this adapter entered a busy state, send RNRs to the remote LLC2 station.
|
UnknownSAPs
|
Number of frames received that are destined for a SAP that does not exist on this adapter.
|
The following sample displays operational information for the specified SAP opened on the internal adapter, 4000.1010.2020 configured on channel interface 5/2:
Router# show extended channel 5/2 llc2 oper 4000.1010.2020 04
LAN Token 0 Adapter 0 4000.1010.2020
Table 14 describes the fields shown in the display.
Table 14 show extended channel llc2 oper Field Descriptions for Specified Interface
Field
|
Description
|
Open Connections
|
Number of LLC2 connections active on the SAP.
|
Max Connections
|
Highest number of LLC2 connections concurrently active on that SAP since the SAP has been active.
|
The following sample displays statistics for the specified SAP on the internal adapter, 4000.1010.2020 configured on channel interface 5/2:
Router# show extended channel 5/2 llc2 stats 4000.1010.2020 04
LAN Token 0 Adapter 0 4000.1010.2020
TESTRspsIn = 0 TESTCmdsOut = 0
XIDCmdsIn = 14 XIDCmdsOut = 16
XIDRspsIn = 4 XIDRspsOut = 0
UIFramesIn = 0 UIFramesOut = 0
UIOctetsIn = 0 UIOctetsOut = 0
ConnectOk = 2 ConnectFail = 0
DiscNorm = 0 DiscByTmr = 0
DiscByFRMRSent = 0 DiscByFRMRRcvd = 0
DMsInABM = 0 SABMEsInABM = 0
Table 15 describes the fields shown in the display. All statistics for SAPs are based on the time the SAP was last opened.
Table 15 show extended channel llc2 stats Field Descriptions for Specified Interface
Field
|
Description
|
TESTRspsIn
|
Number of TEST responses received on this SAP for TEST commands sent by VTAM (connect out).
|
TESTCmdsOut
|
Number of TEST commands sent by this SAP to explore for a remote MAC address (VTAM connect out).
|
XIDCmdsIN
|
Number of XID commands received by this SAP from a remote link station.
|
XIDCmdsOut
|
Number of XID commands sent by this SAP to a remote link station.
|
XIDRspsIN
|
Number of XID responses received by this SAP from a remote link station.
|
XIDRspsOut
|
Number of XID responses sent by this SAP to a remote link station.
|
UIFreamesIn
|
Number of Unnumbered I-frames received by this SAP from a remote link station.
|
UIFramesOut
|
Number of Unnumbered I-frames sent by this SAP to a remote link station.
|
UIOctetsIn
|
Number of Unnumbered I-frame bytes received by this SAP from a remote link station.
|
UIOctetsOut
|
Number of Unnumbered I-frame bytes sent by this SAP to a remote link station.
|
ConnectOk
|
Number of successful LLC2 connection attempts on this SAP.
|
ConnectFail
|
Number of LLC2 connections that failed.
|
DiscNorm
|
Number of normal LLC2 connection disconnections.
|
DisByTmr
|
Number of LLC2 connections disconnected due to the CMCC LLC2 link station not getting responses to polls from the remote LLC2 station, typically due to the remote station being powered off or a severe network failure/congestion. The CMCC LLC2 stack generates an event each time it detects this condition. The event can be configured to generate a NetView alert, SNMP trap, and a router console message.
|
DiscByFRMRSent
|
Number of times a CMCC LLC2 connection disconnected after detecting a protocol violation and sending a FRNR to the remote LLC2 station.The CMCC LLC2 link station generates an event each time it detects this condition. The event can be configured to generate a NetView alert, SNMP trap, and a router console message.
|
DiscByFRMRRcvd
|
Number of times the CMCC LLC2 connection disconnected after the remote LLC2 station detected a protocol violation and sent a FRMR to the CMCC LLC2 link station.The CMCC LLC2 stack generates an event each time it detects this condition. The event can be configured to generate a NetView alert, SNMP trap, and a router console message.
|
DMsInABM
|
Number of times the CMCC LLC2 link station went into disconnect mode after receiving a DM. The CMCC LLC2 stack generates an event each time it detects this condition. The event can be configured to generate a NetView alert, SNMP trap, and a router console message.
|
SABMEDsInABM
|
Number of times the CMCC LLC2 link station went into disconnect mode after receiving a SABME from the LLC2 station. The CMCC LLC2 stack generates an event each time it detects this condition. The event can be configured to generate a NetView alert, SNMP trap, and a router console message.
|
The following sample displays operation information for the specified CMCC link station:
Router# show extended channel 5/2 llc2 oper 4000.1010.2020 04 4000.1234.1030 18
LAN Token 0 Adapter 0 4000.1010.2020
Local SAP=04 Remote MAC=4000.1234.1030 Remote SAP=18 State=normal
t1-time = 1000 tpf-time = 1000 trej-time = 3200 tbusy-tim = 9600
idle-time =60000 local-win = 7 recv-wind = 7 N2 = 8
N1-Send = 4105 N1-Rcv = 4105 ack-delay = 100 ack-max = 3
Last Ww Cause = neverInvoked
Connection Time: 17:50:11
Table 16 explains parameters in use by the LLC2 connection. These parameters are the ones configured on the internal adapter 4000.0000.0001 at the time the LLC2 connection was established. If the LLC2 parameters on the internal adapter are changed while this connection is active, the connection will not reflect the changes to the adapter.
Table 16 show extended channel llc2 Field Descriptions for Internal LAN Adapter
Field
|
Description
|
State
|
•ADM (Asynchronous Disconnect Mode)
•setup
•conn
•normal
•busy
•reject
•await
•awaitBusy
•awaitReject
•discConn
•reset
•error
•pendDiscRsp
The descriptions for each state can be found in Section 7.8.3, IOS 8802-2: 1989, ANSI/IEEE Std 802.2 - 1989.
|
t1-time
|
Length of time the CMCC LLC2 link station waits for an acknowledgment to a sent I-frame before polling the remote LLC2 station.
|
tpf-time
|
Amount of time the CMCC LLC2 link station waits for a final response to a poll before resending the original poll frame.
|
trej-time
|
Amount of time the CMCC LLC2 link station waits for a correct frame after sending a reject command to a remote LLC2 station.
|
tbusy-tim
|
Amount of time the CMCC LLC2 link station waits before repolling a busy LLC2 station.
|
idle-time
|
Frequency of polls during periods of idle traffic.
|
local-win
|
Maximum number of I-frames that the CMCC LLC2 link station can send to the remote LLC2 station without receiving an acknowledgment.
|
recv-wind
|
Maximum number of I-frames that a CMCC LLC2 link station can receive without receiving an acknowledgment.
|
N2
|
Number of times a CMCC LLC2 link station will resend an unacknowledged I-frame.
|
N1-Send
|
Largest frame size this CMCC LLC2 link station is allowed to send.
|
N1-Rcv
|
Largest frame size this CMCC LLC2 link station can receive.
|
ack-delay
|
Maximum amount of time the CMCC LLC2 link station allows received I-frames to remain unacknowledged. The CIP LLC2 connection will acknowledge received I-frames within the ack-delay time.
|
ack-max
|
Maximum number of I-frames a CMCC LLC2 link station receives before sending an acknowledgment.
|
Nw
|
Working send window size. When I-frames sent by a CMCC LLC2 link station are rejected by the remote LLC2 station, the CMCC LLC2 link station reduces its working send window size to 1. Then, for every subsequent I-frame sent by the CMCC LLC2 connection that is positively acknowledged by the remote LLC2 station, the CMCC LLC2 link station increases its working send window by the Nw value until the working send window reaches the configured local-window value.
|
Ww
|
Current working window size for this LLC2 link station. This is the current number of unacknowledged I-frames that this LLC2 link station will send.
|
Last Ww Cause
|
Last event that caused the working window to change values. Valid values are:
•neverInvoked - This LLC2 station has not detected a condition to change the working window from the initial value at activation time.
•lostData - The current working window value was changed due to loss of data by the remote LLC2 link station.
•macLayerCongestion - The current working window value was changed due to the remote end station sending this LLC2 link station a RNR frame.
|
Connection Time
|
Length of time this LLC2 connection has been active.
|
Last modified
|
Length of time since one of the LLC2 parameters for this connection was last modified.
|
The following sample displays statistics for the CMCC LLC2 link station connection between LMAC 4000.1010.2020 LSAP 04 and RMAC 4000.1234.1030 RSAP 18:
Router# show extended channel 5/2 llc2 stats 4000.1010.2020 04 4000.1234.1030 18
LAN Token 0 Adapter 0 4000.1010.2020
Local SAP=04 Remote MAC=4000.1234.1030 Remote SAP=18
LocalBusies = 0 RemoteBusies = 0
IFramesIn = 1 IFramesOut = 1
IOctetsIn = 19 IOctetsOut = 21
SFramesIn = 0 SFramesOut = 0
RetransmitsOut = 0 WwCountChanges = 0
Table 17 describes the fields shown in the display.
.
Table 17 show extended channel llc2 stats Field Descriptions
Field
|
Description
|
LocalBusies
|
Number of times the CMCC LLC2 link station entered the busy state. This state occurs for a CMCC LLC2 link station when there are n I-frames received from the remote LLC2 station on the CMCC queued to be sent over the channel to VTAM. Where n is two times the recv-wind. The CMCC LLC2 link station will also enter into busy state whenever it receives a flow control command from VTAM.
|
RemoteBusies
|
Number of times the remote LLC2 link station entered into busy state.
|
IFramesIn
|
Number of LLC2 information frames received by the CMCC LLC2 link station from the remote link station.
|
IFramesOut
|
Number of LLC2 information frames sent by the CMCC link station to the remote link station.
|
IOctetsIn
|
Number of LLC2 information frame bytes received by the CMCC LLC2 link station from the remote link station.
|
IOctetsOut
|
Number of LLC2 information frame bytes sent by the CMCC link station to the remote link station.
|
SFramesIn
|
Number of LLC2 supervisory frames received by the CMCC link station from the remote link station. These include RRs, RNRs and REJs.
|
SFramesOut
|
Number of LLC2 supervisory frames sent by the CMCC link station to the remote link station. These include RRs, RNRs and REJs.
|
REJsIn
|
Number of LLC2 REJ frames received by the CMCC link station from the remote link station. This field indicates the number of times the remote link station detected dropped I-frames sent from the CMCC LLC2 station.
|
REJsOut
|
Number of LLC2 REJ frames sent by the CMCC link station to the remote link station. This indicates the number of times the CMCC link station detected dropped I-frames sent by the remote link station.
|
RetransmitsOut
|
Number of I-frames the CMCC link station was required to resend.
|
WwCountChanges
|
Number of times the CMCC LLC2 link station changed its working send window (local-win). See Nw field description in Table 15 for a description of when the LLC2 link stations working send window is changed.
|
Related Commands
Command
|
Description
|
adapter
|
Configures internal adapters.
|
show extended channel max-llc2-sessions
To display information about the number of LLC2 sessions supported on the CMCC adapter, use the show extended channel max-llc2-sessions privileged EXEC command.
show extended channel slot/port max-llc2-sessions
Syntax Description
slot
|
Slot number.
|
port
|
Port number.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.0(3)
|
This command was introduced
|
Usage Guidelines
This command is valid only on the virtual channel interface.
Examples
The following is sample output from the show extended channel max-llc2-sessions command:
Router# show extended channel 1/2 max-llc2-sessions
Administrative max-llc2-sessions = 1000
Operational max-llc2_sessions = 1000
Highest concurrent LLC2 sessions = 30
LLC2 session allocation failures = 0
Table 18 describes the fields shown in the display.
Table 18 show extended channel max-llc2-sessions Field Descriptions
Field
|
Description
|
Administrative max-llc2-sessions
|
Maximum number of LLC2 sessions configured.
|
Operational max-llc2-sessions
|
Maximum number of LLC2 sessions configured on the CMCC adapter. This value differs from the value for the administrative max-llc2-sessions if the maximum number of LLC2 sessions is decreased by configuring a new value while the CMCC adapter's virtual interface is up. If the CMCC adapter's virtual interface is reset (shut/no shut), both the administrative and operational max-llc2-sessions numbers will match.
|
Highest concurrent llc2 sessions
|
Highest number of LLC2 sessions active concurrently since the CMCC adapter LLC2 was started. When the CMCC adapter llc2 is initiated, the following message displays:
%CIP1-6-MSG: %MSG802-6-LLC_START: Starting LLC-2 with a
session capacity of 1000
|
LLC2 session allocation failure
|
Number of times network devices tried to establish an LLC2 connection with the CMCC adapter and failed because the operational max-llc2-sessions limit was reached when the connection was attempted.
|
Related Commands
Command
|
Description
|
adapter
|
Configures internal adapters.
|
show extended channel connection-map llc2
|
Displays the number of active LLC2 connections for each SAP and the mapping of the internal MAC adapter and the SAP to the resource that activated the SAP.
|
show extended channel statistics
To display statistical information about subchannels on the physical interface of a CMCC adapter, use the show extended channel statistics EXEC command. This command displays information that is specific to the interface channel devices. The information is generally useful only for diagnostic tasks performed by technical support personnel.
show extended channel slot/port statistics [path [device-address]] [connected]
Syntax Description
slot
|
Slot number.
|
port
|
Port number.
|
path
|
(Optional) Hexadecimal value in the range 0x0000 to 0xFFFF. This value specifies the data path and consists of two digits for the physical connection (either on the host or on the ESCON Director switch): one digit for the control unit address, and one digit for the channel logical address.
|
device-address
|
(Optional) Hexadecimal value in the range 0x00 to 0xFE. This value is the unit address associated with the control unit number and path as specified in the host IOCP file. For CLAW and offload support, the device address must have an even value.
|
connected
|
(Optional) For each backup group, only display information about the active subchannel or the first subchannel defined in the group if none are active.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.2
|
This command was introduced.
|
12.0(3)T
|
Support for the CMPC+ feature was added.
|
Examples
The following is sample output for the show extended channel statistics command from a CMCC adapter configured with CLAW, Offload, CSNA, and CMPC:
Router# show extended channel 0/1 statistics E010
Path: E010 -- ESTABLISHED
Command Selective System Device CU
Dev Connects Retries Cancels Reset Reset Errors Busy
Blocks Bytes Dropped Blk Memd
Dev-Lnk Read Write Read Write Read Write wait Con
D0-01 5017 0 1215457 0 0 0 0 Y
Total: 5017 0 1215457 0 0 0 0
D1-01 0 5039 0 1247307 0 0 0 Y
Total: 0 5039 0 1247307 0 0 0
D2-02 2671 0 661621 0 0 0 0 Y
Total: 2671 0 661621 0 0 0 0
D3-02 0 2680 0 653285 0 0 0 Y
Total: 0 2680 0 653285 0 0 0
D9-00 0 2214 0 223418 0 0 0 Y
DA-00 2024 0 124587 0 0 0 0 Y
Total: 9712 9933 2001665 2124010 0 0 0
Last statistics 5 seconds old, next in 5 seconds
The following is sample output for the show extended channel statistics command from a CMCC adapter configured with CLAW, Offload, CSNA, and CMPC+:
tanzania# show extended channel 0/1 statistics
Command Selective System Device CU
Dev Connects Retries Cancels Reset Reset Errors Busy
Blocks Bytes Dropped Blk Memd
Dev-Lnk Read Write Read Write Read Write wait Con
36-00 19 6 54236 789 0 0 0 Y
37-00 9 17 801 63302 0 0 0 Y
Total: 28 23 55037 64091 0 0 0
Command Selective System Device CU
Dev Connects Retries Cancels Reset Reset Errors Busy
Blocks Bytes Dropped Blk Memd
Dev-Lnk Read Write Read Write Read Write wait Con
36-00 236 12 3604441 1578 0 0 0 Y
37-00 18 236 1602 4217913 0 0 0 Y
Total: 254 248 3606043 4219491 0 0 0
Total: 282 271 3661080 4283582 0 0 0
Last statistics 8 seconds old, next in 2 seconds
Table 19 describes the fields shown in the display.
Table 19 show extended channel statistics Field Descriptions
Field
|
Description
|
Path
|
Path from the CLAW, offload, CMPC, CMPC+, or CSNA configuration.
|
Dev
|
Address for each device. For CLAW and offload, there are two device addresses. In the configuration statement, you specify only the even address. Both CSNA, CMPC, and CMPC+ have one device.
|
Connects
|
Number of times the channel started a channel program on the device.
|
Command Retries
|
Number of times the CMCC adapter either had no data to send to the channel (for the read subchannel) or the number of times the CMCC adapter had no buffers to hold data from the channel (for the write subchannel). Every command retry that is resumed results in a connect. A command retry can be ended via a cancel.
|
Cancels
|
Host requested any outstanding operation to be terminated. It is a measure of the number of times the host program was started.
|
Selective Reset
|
Resets only one device. On VM, selective reset occurs when a device is attached and a CP Initial Program Load (IPL) command is issued.
|
System Reset
|
Number of times the system IPL command was issued. A system reset affects all devices on the given channel. The command is always issued when the ECA is initialized, and when the channel is taken off line.
|
Device Errors
|
Errors detected by the ESCON or Parallel interface because of problems on the link. This value should always be 0.
|
CU Busy
|
Number of times the adapter returned a control unit busy indication to the host. This indication occurs after a cancel or reset if the host requests an operation before the CMCC adapter has finished processing the cancel or reset.
|
Dev-Lnk
|
First number is the device address. The second number is the logical link. Link 0 is always used for CLAW control messages. For IP datagram mode, link 1 is for actual datagram traffic.
For offload, link 2 is for API traffic. For CSNA, CMPC, and CMPC+, the Dev-Lnk is not relevant.
|
Blocks Read/Write
|
Count of channel blocks that are read and written from the mainframe.
|
Bytes Read/Bytes Write
|
Sum of the bytes in the blocks.
|
Dropped Blk Read/Write
|
If the route processor sends data to the CMCC adapter faster than it can send it to the channel, then the block is dropped. High values mean the host is not running fast enough. A write drop occurs if the CMCC adapter fails to get a router processor buffer n times for a given block. See the Memd wait counter.
|
Memd wait
|
Number of times the CMCC adapter could not obtain a buffer.
|
Con
|
For link 0, a connection of Y means the system validation is complete. For all other links, Con means the connection request sequence is completed. For CSNA devices, a value of Y is displayed when the CSNA device status is complete. For all other states, the Con shows a value of N.
Note If you halt the host or terminate VTAM using the Z NET, CANCEL command, VTAM does not halt the subchannels, and CON shows a value of Y until the subchannels time out (approximately 180 seconds).
|
The following is sample output for the CSNA path, using the show extended channel statistics command:
Router# show extended channel 0/1 statistics E200
Path: E200 -- ESTABLISHED
Command Selective System Device CU
Dev Connects Retries Cancels Reset Reset Errors Busy
D0 217440 108293 1 0 0 0 0
Blocks Bytes Dropped Blk Memd
Dev-Lnk Read Write Read Write Read Write wait Con
D0-00 109096 109095 237799616 880468 0 0 0 Y
D1-00 19877 19875 160688 237876362 0 0 0 Y
D2-00 9 12842 801 52554701 0 0 0 Y
D3-00 1315 8 30378114 1052 0 0 0 Y
D4-00 9 12842 801 52554701 0 0 0 Y
D5-00 860 8 17003956 1052 0 0 0 Y
DA-00 687 8 14617852 1052 0 0 0 Y
DB-00 9 3578 801 14613989 0 0 0 Y
DC-00 682 8 14513604 1052 0 0 0 Y
DD-00 9 3594 801 14679517 0 0 0 Y
Total: 132553 161858 314477034 373163946 0 0 0
Last statistics 3 seconds old, next in 7 seconds
Related Commands
Command
|
Description
|
claw (primary)
|
Configures a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in IP datagram mode and also configures individual members of a CLAW backup group for the IP Host Backup feature.
|
cmpc
|
Configures a CMPC (or CMPC+) read subchannel and a CMPC (or CMPC+) write subchannel.
|
csna
|
Configures SNA support on a CMCC physical channel interface and specifies the path and device/subchannel on a physical channel of the router to communicate with an attached mainframe.
|
offload (primary)
|
Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in offload mode and also configures individual members of an Offload backup group for the IP Host Backup feature.
|
show extended channel subchannel
To display information about the CMCC adapter physical interfaces, use the show extended channel subchannel EXEC command. This command displays information that is specific to the interface channel connection. The information displayed is generally useful only for diagnostic tasks performed by technical support personnel.
show extended channel slot/port subchannel [connected]
Syntax Description
slot
|
Slot number.
|
port
|
Port number.
|
connected
|
(Optional) For each backup group, displays information about the active subchannel or the first subchannel defined in the group if none are active.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
10.2
|
This command was introduced.
|
12.0(3)T
|
Support for the CMPC+ feature was added.
|
Examples
The following is sample output from the show extended channel subchannel connected command used on a CMCC adapter configured for CLAW, Offload, and CSNA:
Router# show extended channel 1/0 subchannel
Flags:VALID ESCON LOADED ENABLED SIGNAL
Link:E9, Buffers 0, CRC errors 1, Load count 1
implicit 0, bit-error 0, link failed 1,
NOS 0, sequence timeout 0, invalid sequence 0
Class:Switch Type Number :009032 Tag:E9
Model:002 Manufacturer:IBM
Plant:02 Sequence :000000010685
Class:CTCA-standalone Type Number :C7200 Tag:10
Plant:A Sequence :8083599
CLAW E020 90 172.18.55.12 CISCOMVS TRAILMIX TCPIP TCPIP 0000 Flags:RESET_EVENT
CLAW E020 91 172.18.55.12 CISCOMVS TRAILMIX TCPIP TCPIP 0000 Flags:RESET_EVENT
CSNA E020 94 maxpiu 20470 time-delay 10 length-delay 20470 0000 Flags:RESET_EVENT
OFFLOAD E140 90 172.18.55.11 CISCOMVS TRAILMIX TCPIP TCPIP 0080 TCPIP API Flags:CMD_RETRY
OFFLOAD E140 91 172.18.55.11 CISCOMVS TRAILMIX TCPIP TCPIP 0080 TCPIP API Flags:CMD_RETRY
CLAW E150 90 172.18.55.13 CISCOMVS TRAILMIX TCPIP TCPIP 0080 Flags:CMD_RETRY
CLAW E150 91 172.18.55.13 CISCOMVS TRAILMIX TCPIP TCPIP 0080 Flags:CMD_RETRY
CLAW E150 96 172.18.55.22 CISCOMVS TRAILMIX TCPIP TCPIP 0080
CLAW E150 97 172.18.55.22 CISCOMVS TRAILMIX TCPIP TCPIP 0080
CLAW E160 90 172.18.55.14 CISCOMVS TRAILMIX TCPIP TCPIP 0080 Flags:CMD_RETRY
CLAW E160 91 172.18.55.14 CISCOMVS TRAILMIX TCPIP TCPIP 0080 Flags:CMD_RETRY
CLAW E170 90 172.18.55.15 CISCOMVS TRAILMIX TCPIP TCPIP 0080 Flags:CMD_RETRY
CLAW E170 91 172.18.55.15 CISCOMVS TRAILMIX TCPIP TCPIP 0080 Flags:CMD_RETRY
CLAW E180 90 172.18.55.20 VMV2R3 TRAILMIX TCPIP TCPIP 0000 Flags:CMD_RETRY
CLAW E180 91 172.18.55.20 VMV2R3 TRAILMIX TCPIP TCPIP 0000 Flags:CMD_RETRY
CLAW E180 92 172.18.55.21 TSOMAIN TRAILMIX TCPIP TCPIP 0000 Flags:CMD_RETRY
CLAW E180 93 172.18.55.21 TSOMAIN TRAILMIX TCPIP TCPIP 0000 Flags:CMD_RETRY
CLAW E190 90 172.18.55.17 CISCOMVS TRAILMIX TCPIP TCPIP 0000 Flags:RESET_EVENT
CLAW E190 91 172.18.55.17 CISCOMVS TRAILMIX TCPIP TCPIP 0000 Flags:RESET_EVENT
CLAW E1E0 90 172.18.55.18 CISCOMVS TRAILMIX TCPIP TCPIP 0080 Flags:CMD_RETRY
CLAW E1E0 91 172.18.55.18 CISCOMVS TRAILMIX TCPIP TCPIP 0080 Flags:CMD_RETRY
CLAW E1F0 90 172.18.55.19 CISCOMVS TRAILMIX TCPIP TCPIP 0080 Flags:CMD_RETRY
CLAW E1F0 91 172.18.55.19 CISCOMVS TRAILMIX TCPIP TCPIP 0080 Flags:CMD_RETRY
Last statistics 6 seconds old, next in 4 seconds
Table 20 describes the fields shown in the display.
Table 20 show extended channel subchannel Field Descriptions
Field
|
Description
|
Channelx/y: state
|
State can be up, down, or administratively down.
|
Flags
|
•GO-OFF—CMCC adapter is trying to shut down the channel interface. This state should not persist for more than a few seconds. This flag is not applicable to the virtual channel interface.
•INVALID—All displays for virtual channel interfaces should contain this flag. On physical channel interfaces, it indicates a problem with the CMCC adapter microcode.
•LOADED—Channel firmware for the physical channel interface is loaded. The channel firmware is loaded only if the interface configuration contains at least one device configuration statement and is not shut down. This flag matches the state of the "loaded" LED. This flag is not applicable to the virtual channel interface.
•LOVE—Note indicating an interface state change (up-down or down-up) is pending on this interface. This state should not persist for more than a few seconds.
•OFFLINE—For an ESCON channel interface, this flag indicates that no mainframe has established an ESCON logical path corresponding to the paths specified in any device configuration statement (claw, offload, csna, or cmpc). For a Parallel channel interface, this flag indicates that the x'0100' path is not defined in any device configuration statement or SIGNAL is not present.
•ONLINE—For an ESCON Channel interface, this flag indicates that at least one mainframe has established an ESCON logical path corresponding to the paths specified in one of the device configuration statements (CLAW, offload, CSNA, CMPC, or CMPC+). For a Parallel Channel interface, this flag indicates that the x'0100' path is defined in at least one device configuration statement and SIGNAL is present.
•RQC_PEND—CMCC adapter is attempting to send status to the channel on this interface. This state should not persist for more than a few seconds. This flag is not applicable to the virtual channel interface.
•RESET_EVENT—Indicates that a reset event has been received.
•SIGNAL—For an ESCON channel interface, this flag indicates that light is detected. For a Parallel channel interface, this flag indicates that the "operational out" signal is detected. This flag matches the state of the "signal" LED. It will only be set if the LOADED flag is set as well. This flag is not applicable to the virtual channel interface.
•STAT_PEND—CMCC adapter has status to present for this device. The indication is cleared when the mainframe accepts the status.
|
Flags (continued)
|
•SUSPEND—Indicates that the CMCC device task has decided to suspend data transfer for a particular device.
•VALID—A physical interface is installed. All displays for physical channel interfaces should contain this. This flag matches the state of the "present" LED.
|
Link: xx
|
Director Port number to which the physical channel is connected. If the physical channel is directly connected, then this value is host dependent.
|
Buffers
|
Number of times the CMCC adapter has dropped a packet bound for the route processor because no packet switching buffer was available on the route processor.
|
CRC errors
|
Number of CRC errors detected on the channel for ESCON. Number of parity errors detected on the channel for Parallel.
|
Load count
|
For a CMCC physical channel interface, the number of times the channel adapter microcode has been loaded.
|
Link Incident Reports
|
Link incidents are errors on an ESCON channel. These errors are reported to the host operating system and are recorded here for additional information.
•Implicit incidents—Recoverable error occurred in the ECA.
•Bit errors—Bit error rate threshold was reached. The bit error rate threshold is 15 error bursts within 5 minutes. An error burst is defined as a time period of 1.5 +/- .5 seconds during which one or more code violations occurred. A code violation error is caused by an incorrect sequence of 10 bit characters.
•Link failed—Loss of synchronization or light has occurred.
•NOS—Channel or switch sent the Not Operational Sequence.
•Sequence timeout—Connection recovery timeout has occurred or the router is waiting for the appropriate response while in the send off-line sequence (OLS) state.
•Invalid Sequence—Unconditional disconnect (UD) or unconditional disconnect response (UDR) is recognized in the wait for offline sequence state.
|
Neighbor node
|
Describes the channel or switch. Valid values are:
•VALID—Information has been exchanged between the router and channel or switch.
•Class—Switch or channel depending on whether the connection is a switched point-to-point connection or a point-to-point connection.
•Type number—Model of switch or processor.
•TAG—Physical location of the connector.
•Model—A further classification of type.
•Manufacturer—Identifies who made switch or processor.
•Plant and sequence—Manufacturer-specific information to uniquely define this one device.
|
Related Commands
Command
|
Description
|
claw (primary)
|
Configures a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in IP datagram mode and also configures individual members of a CLAW backup group for the IP Host Backup feature.
|
cmpc
|
Configures a CMPC (or CMPC+) read subchannel and a CMPC (or CMPC+) write subchannel.
|
csna
|
Configures SNA support on a CMCC physical channel interface and specifies the path and device/subchannel on a physical channel of the router to communicate with an attached mainframe.
|
offload (primary)
|
Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in offload mode and also configures individual members of an Offload backup group for the IP Host Backup feature.
|
show extended channel tcp-connections
To display information about the Transmission Control Protocol (TCP) sockets on a channel interface, use the show extended channel tcp-connections EXEC command.
show extended channel slot/port tcp-connections [[loc-ip-addr [loc-port [rem-ip-addr
[rem-port]] [detail | summary]
Syntax Description
slot
|
Slot number.
|
port
|
Port number.
|
tcp-connections
|
Specifies TCP connections display.
|
loc-ip-addr
|
(Optional) Local IP address. IP address of the local connection endpoint. Restricts the output to those connections with a matching local IP address.
|
loc-port
|
(Optional) Local TCP port. This is the TCP port of the local connection endpoint. Restricts the output to those connections with a matching local TCP port. An asterisk (*) is a wildcard that matches every port.
|
rem-ip-addr
|
(Optional) Remote IP address. IP address of the remote connection endpoint. Restricts the output to those connections with a matching remote IP address.
|
rem-port
|
(Optional) Remote TCP port. TCP port of the remote connection endpoint. Restricts the output to those connections with a matching remote TCP port.
|
detail
|
(Optional) Prints detailed information about every matching connection.
|
summary
|
(Optional) This is the default. Prints a summary of all matching connections.
|
Command Modes
EXEC for summary and privileged EXEC for detail.
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
12.0(7)T
|
Stack address field added to the output.
|
Usage Guidelines
The show extended channel tcp-connections command is valid on both physical and virtual channel interfaces. If no IP addresses or TCP ports are specified, all TCP connections are displayed in a summary for the specified interface.
The command displays detailed information about a large number of sessions that can take a long time. Consider restricting the output by IP address and TCP port to connections of interest.
Examples
The following is sample output for the show extended channel tcp-connections detail command:
Router# show extended channel 0/1 tcp-connections detail
Local IP Addr Port Remote IP Addr Port State In Bytes Out Bytes
80.11.198.2 21 0.0.0.0 0 listen 0 0
80.11.198.2 21 172.18.48.194 38668 establish 62 298
80.11.198.2 23 0.0.0.0 0 listen 0 0
80.11.198.2 23 172.18.48.194 38666 establish 124 11966
80.11.198.2 1025 0.0.0.0 0 listen 0 0
80.11.198.2 1025 172.18.48.194 38705 closeWait 24 1
80.11.198.3 7 0.0.0.0 0 listen 0 0
80.11.198.3 9 0.0.0.0 0 listen 0 0
80.11.198.3 19 0.0.0.0 0 listen 0 0
80.11.198.3 21 0.0.0.0 0 listen 0 0
80.11.198.3 23 0.0.0.0 0 listen 0 0
80.11.198.3 23 172.18.48.194 38667 establish 85 446
The following example shows sample output from the show extended channel tcp-connections command when you specify the detail keyword for an offload device at real IP address 10.10.21.3 with an alias address of 10.2.33.88:
Router# show extended channel3/1 tcp-connections 10.10.21.3 detail
Stack Address 10.10.21.3:
Local IP Addr Port Remote IP Addr Port State In Bytes Out Bytes Addr
0.0.0.0 23 0.0.0.0 0 listen 0 0
10.2.33.88 23 70.70.5.140 61954 establish 59 105
Table 21 describes the fields shown in the display.
Table 21 show extended channel tcp-connections Field Descriptions
Field
|
Description
|
Stack Address
|
Real IP address of the TCP/IP stack or offload device.
|
Local IP Addr
|
Local IP address on the connection.
|
State
|
The state of this TCP connection.
The only value that may be set by a management station is deleteTCB(12). Accordingly, it is appropriate for an agent to return a `badValue' response if a management station attempts to set this object to any other value.
If a management station sets this object to the value deleteTCB(12), then this has the effect of deleting the TCB (as defined in RFC 793) of the corresponding connection on the managed node, resulting in immediate termination of the connection.
As an implementation-specific option, an RST segment may be sent from the managed node to the other TCP endpoint (note however that RST segments are not sent reliably).
|
In Bytes
|
Number of bytes sent for this TCP connection.
Note To support SNMP Version 1 Managers, this variable is supplied as a 32-bit value which can wrap very frequently.
|
Out Bytes
|
Number of bytes received for this TCP connection.
Note To support SNMP Version 1 Managers, this variable is supplied as a 32-bit value which can wrap very frequently.
|
The following is sample output for the show extended channel tcp-connections summary command:
Router# show extended channel 0/1 tcp-connections summary
TCP Connections=12 Input Bytes= 294 Output Bytes= 13049
Related Commands
Command
|
Description
|
offload (primary)
|
Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in offload mode and also configures individual members of an Offload backup group for the IP Host Backup feature.
|
pu (TN3270)
|
Creates a PU entity that has its own direct link to a host and enters PU configuration mode.
|
pu (DLUR)
|
Creates a PU entity that has no direct link to a host and enters DLUR PU configuration mode.
|
show extended channel tcp-stack
|
Displays information about the TCP stack running on CMCC adapter interfaces.
|
show extended channel tcp-stack
To display information about the TCP stack running on CMCC adapter interfaces, use the show extended channel tcp-stack EXEC command.
show extended channel slot/port tcp-stack [ip-address]
Syntax Description
slot
|
Slot number.
|
port
|
Port number.
|
tcp-stack
|
Specifies tcp stack display.
|
ip-address
|
(Optional) IP address specified by the offload interface configuration command or the tn327-server pu command.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
12.0(7)T
|
Alias addresses field added to the output.
|
Usage Guidelines
The show extended channel tcp-stack command is valid on both physical and virtual channel interfaces. If no ip-address argument is specified, then information is displayed for all IP addresses configured on the specified interface.
Examples
The following is sample output from the show extended channel tcp-stack command:
Router# show extended channel 0/1 tcp-stack
TCP Statistics for IP Address 80.11.198.2
RtoAlgorithm: vanj RtoMin : 1000 RtoMax : 64000
MaxConn : -1 ActiveOpens : 1 PassiveOpens: 17
AttemptFails: 0 EstabResets : 0 CurrEstab : 5
InSegs : 181 OutSegs : 147 RetransSegs : 0
TCP Statistics for IP Address 80.11.198.3
RtoAlgorithm: vanj RtoMin : 1000 RtoMax : 64000
MaxConn : -1 ActiveOpens : 0 PassiveOpens: 1
AttemptFails: 0 EstabResets : 0 CurrEstab : 6
InSegs : 25 OutSegs : 23 RetransSegs : 0
The following example shows sample output from the show extended channel tcp-stack command when you specify the real IP address for an offload device at 10.10.21.3:
Router# show extended channel 3/1 tcp-stack 10.10.21.3
TCP Statistics for IP Address 10.10.21.3
Alias addresses: 10.2.33.88
RtoAlgorithm: vanj RtoMin : 1000 RtoMax : 64000
MaxConn : -1 ActiveOpens : 0 PassiveOpens: 1
AttemptFails: 0 EstabResets : 0 CurrEstab : 2
InSegs : 16 OutSegs : 7 RetransSegs : 0
The following example shows sample output from the show extended channel tcp-stack command when you specify the alias IP address for an offload device at 10.2.33.88:
Router# show extended channel 3/1 tcp-stack 10.2.33.88
TCP Statistics for IP Address 10.10.21.3
Alias addresses: 10.2.33.88
RtoAlgorithm: vanj RtoMin : 1000 RtoMax : 64000
MaxConn : -1 ActiveOpens : 0 PassiveOpens: 1
AttemptFails: 0 EstabResets : 0 CurrEstab : 2
InSegs : 16 OutSegs : 7 RetransSegs : 0
Table 22 describes the fields shown in the display.
Table 22 show extended channel tcp-stack Field Descriptions
Field
|
Description
|
Alias addresses
|
Virtual IP addresses assigned to the real IP address of an offload device.
|
RtoAlgorithm
|
The algorithm used to determine the timeout value used for resending unacknowledged octets.
|
RtoMin
|
The minimum value permitted by a TCP implementation for the retransmission timeout, measured in milliseconds. More refined semantics for objects of this type depend upon the algorithm used to determine the retransmission timeout. In particular, when the timeout algorithm is rsre(3), an object of this type has the semantics of the LBOUND quantity described in RFC 793.
|
RtoMax
|
The maximum value permitted by a TCP implementation for the retransmission timeout, measured in milliseconds. More refined semantics for objects of this type depend upon the algorithm used to determine the retransmission timeout. In particular, when the timeout algorithm is rsre(3), an object of this type has the semantics of the UBOUND quantity described in RFC 793."
|
MaxConn
|
The limit on the total number of TCP connections the entity can support. In entities where the maximum number of connections is dynamic, this object should contain the value -1.
|
ActiveOpens
|
Number of times TCP connections have made a direct transition to the SYN-SENT state from the CLOSED state.
|
PassiveOpens
|
Number of times TCP connections have made a direct transition to the SYN-RCVD state from the LISTEN state.
|
AttemptFails
|
Number of times TCP connections have made a direct transition to the CLOSED state from either the SYN-SENT state or the SYN-RCVD state, plus the number of times TCP connections have made a direct transition to the LISTEN state from the SYN-RCVD state.
|
EstabResets
|
Number of times TCP connections have made a direct transition to the CLOSED state from either the ESTABLISHED state or the CLOSE-WAIT state.
|
CurrEstab
|
Number of TCP connections for which the current state is either ESTABLISHED or CLOSE- WAIT.
|
InSegs
|
Total number of segments received, including those received in error. This count includes segments received on currently established connections.
|
OutSegs
|
Total number of segments sent, including those on current connections but excluding those containing only resent octets.
|
RetransSegs
|
Total number of segments resent—that is, the number of TCP segments sent containing one or more previously sent octets.
|
InErrs
|
Total number of segments received in error (for example, bad TCP checksums).
|
OutRsts
|
Number of TCP segments sent containing the RST flag.
|
Related Commands
Command
|
Description
|
offload (primary)
|
Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in offload mode and also configures individual members of an Offload backup group for the IP Host Backup feature.
|
pu (TN3270)
|
Creates a PU entity that has its own direct link to a host and enters PU configuration mode.
|
pu (DLUR)
|
Creates a PU entity that has no direct link to a host and enters DLUR PU configuration mode.
|
show extended channel tcp-connections
|
Displays information about the TCP sockets on a channel interface.
|
show extended channel udp-listeners
To display information about the User Datagram Protocol (UDP) listener sockets running on the CMCC adapter interfaces, use the show extended channel udp-listeners EXEC command.
show extended channel slot/port udp-listeners [ip-address]
Syntax Description
slot
|
Slot number.
|
port
|
Port number.
|
udp-listeners
|
Specifies UDP listener port display.
|
ip-address
|
(Optional) IP address specified by the offload interface configuration command or the tn3270-server pu command.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
Usage Guidelines
The show extended channel tn3270-server udp-listeners command is valid on both physical and virtual channel interfaces.
Examples
The following is sample output from the show channel udp-listeners command:
Router# show extended channel 0/1 udp-listeners
UDP Listener: IP Address 80.11.198.3 LocalPort 7
UDP Listener: IP Address 80.11.198.3 LocalPort 9
UDP Listener: IP Address 80.11.198.3 LocalPort 19
Related Commands
Command
|
Description
|
offload (primary)
|
Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in offload mode and also configures individual members of an Offload backup group for the IP Host Backup feature.
|
pu (TN3270)
|
Creates a PU entity that has its own direct link to a host and enters PU configuration mode.
|
pu (DLUR)
|
Creates a PU entity that has no direct link to a host and enters DLUR PU configuration mode.
|
show extended channel udp-stack
To display information about the UDP stack running on the CMCC adapter interfaces, use the show extended channel udp-stack EXEC command.
show extended channel slot/port udp-stack [ip-address]
Syntax Description
slot
|
Slot number.
|
port
|
Port number.
|
udp-stack
|
Selects UDP stack display.
|
ip-address
|
(Optional) IP address specified by the offload interface configuration command or the tn3270-server pu command.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
12.0(7)T
|
Alias addresses field added to the output.
|
Usage Guidelines
The show extended channel udp-stack command is valid on both physical and virtual channel interfaces.
Examples
The following is sample output from the show extended channel udp-stack command:
Router# show extended channel udp-stack
rispix#show extended channel 0/1 udp-stack
UDP Statistics for IP Address 80.11.198.2
InDatagrams : 6 NoPorts : 6
InErrors : 0 OutDatagrams: 0
UDP Statistics for IP Address 80.11.198.3
InDatagrams : 6 NoPorts : 6
InErrors : 0 OutDatagrams: 1
The following examples show sample output from the show extended channel udp-stack command when you specify the real IP address or the alias IP address, for an offload device at real IP address 10.10.21.3 and alias IP address of 10.2.33.88:
Router# show extended channel 3/1 udp-stack 10.10.21.3
UDP Statistics for IP Address 10.10.21.3
Alias addresses: 10.2.33.88
InDatagrams : 6 NoPorts : 6
InErrors : 0 OutDatagrams: 1
Router# show extended channel 3/1 udp-stack 10.2.33.88
UDP Statistics for IP Address 10.10.21.3
Alias addresses: 10.2.33.88
InDatagrams : 6 NoPorts : 6
InErrors : 0 OutDatagrams: 1
Table 23 describes the fields shown in the display.
.
Table 23 show extended channel udp-stack Field Descriptions
Field
|
Description
|
Alias addresses
|
Virtual IP addresses assigned to the real IP address of an offload device.
|
InDatagrams
|
Total number of UDP datagrams delivered to UDP users.
|
NoPorts
|
Total number of received UDP datagrams for which there was no application at the destination port.
|
InErrors
|
Number of received UDP datagrams that could not be delivered for reasons other than the lack of an application at the destination port.
|
OutDatagrams
|
Total number of UDP datagrams sent from this entity.
|
Related Commands
Command
|
Description
|
offload (primary)
|
Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in offload mode and also configures individual members of an Offload backup group for the IP Host Backup feature.
|
pu (TN3270)
|
Creates a PU entity that has its own direct link to a host and enters PU configuration mode.
|
pu (DLUR)
|
Creates a PU entity that has no direct link to a host and enters DLUR PU configuration mode.
|
show interfaces channel
To display information about the CMCC adapter interfaces, use the show interfaces channel privileged EXEC command. This command displays information that is specific to the interface hardware. The information displayed is generally useful for diagnostic tasks performed by technical support personnel only.
show interfaces channel slot/port [accounting]
Syntax Description
slot
|
Slot number.
|
port
|
Port number.
|
accounting
|
(Optional) Displays interface accounting information.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
10.2
|
This command was introduced.
|
Examples
The following is sample output from the show interfaces channel command:
Router# show interfaces channel 3/0
Channel3/0 is up, line protocol is up
Hardware is cxBus IBM Channel
Internet address is 198.92.1.145, subnet mask is 255.255.255.248
MTU 4096 bytes, BW 0 Kb, DLY 0 usec, rely 255/255, load 1/255
Encapsulation CHANNEL, loopback not set, keepalive not set
Data transfer rate 12 Mbytes Number of subchannels 1
Last input never, output never, output hang never
Last clearing of "show interface" counters 0:00:04
Output queue 0/0, 0 drops; input queue 0/75, 0 drops
Five minute input rate 0 bits/sec, 0 packets/sec
Five minute output rate 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 no buffer
Received 0 broadcasts, 0 runts, 0 giants
0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
0 packets output, 0 bytes, 0 underruns
0 output errors, 0 collisions, 0 interface resets, 0 restarts
Table 24 describes the fields shown in the display.
Table 24 show interfaces channel Field Descriptions
Field
|
Description
|
Channel... is {up | down | administratively down}
|
Indicates whether the interface hardware is currently active (whether synchronization is achieved on an ESCON channel, or whether operational out is enabled on a parallel channel) and whether it has been taken down by an administrator.
|
line protocol is {up | down | administratively down}
|
Indicates whether the software processes that handle the line protocol think the line is usable (that is, whether keepalives are successful).
|
Hardware is
|
Hardware type.
|
Internet address is
|
IP address and subnet mask.
|
MTU
|
Maximum transmission unit of the interface.
|
BW
|
Bandwidth of the interface in kilobits per second.
|
DLY
|
Delay of the interface in microseconds.
|
rely
|
Reliability of the interface as a fraction of 255 (255/255 is 100% reliability), calculated as an exponential average over 5 minutes.
|
load
|
Load on the interface as a fraction of 255 (255/255 is completely saturated), calculated as an exponential average over 5 minutes. The calculation uses the value from the bandwidth interface configuration command.
|
Encapsulation
|
Encapsulation method assigned to interface.
|
loopback
|
Indicates whether loopbacks are set or not.
|
keepalive
|
Indicates whether keepalives are set or not.
|
daughter card
|
Type of adapter card.
|
Data transfer rate
|
Rate of data transfer.
|
Number of subchannels
|
Number of subchannels.
|
Last input
|
Number of hours, minutes, and seconds since the last packet was successfully received by an interface. Useful for knowing when a dead interface failed. This counter is updated only when packets are process switched, not when packets are fast switched.
|
Last output
|
Number of hours, minutes, and seconds since the last packet was successfully sent by an interface. This counter is updated only when packets are process switched, not when packets are fast switched.
|
output hang
|
Number of hours, minutes, and seconds (or never) since the interface was last reset because of data that took too long to send. When the number of hours in any of the "last" fields exceeds 24 hours, the number of days and hours is printed. If that field overflows, asterisks are printed.
|
Last clearing
|
The time at which the counters that measure cumulative statistics (such as number of bytes sent and received) shown in this report were last reset to zero. Note that variables that might affect routing (for example, load and reliability) are not cleared when the counters are cleared. These asterisks (***) indicate the elapsed time is too large to be displayed. 0:00:00 indicates the counters were cleared more than 231ms (and less than 232ms) ago.
|
Output queue, drops input queue, drops
|
Number of packets in output and input queues. Each number is followed by a slash, the maximum size of the queue, and the number of packets dropped due to a full queue.
|
Five minute input rate, Five minute output rate
|
Average number of bits and packets sent per second in the last 5 minutes.
|
packets input
|
Total number of error-free packets received by the system.
|
bytes input
|
Total number of bytes, including data and MAC encapsulation, in the error free packets received by the system.
|
no buffer
|
Number of received packets discarded because there was no buffer space in the main system. Compare with ignored count. Broadcast storms on Ethernets and bursts of noise on serial lines are often responsible for no input buffer events.
|
broadcasts
|
Total number of broadcast or multicast packets received by the interface.
|
runts
|
Number of packets that are discarded because they are smaller than the medium's minimum packet size.
|
giants
|
Number of packets that are discarded because they exceed the medium's maximum packet size.
|
input errors
|
Total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and abort counts. Other input-related errors can also increment the count, so that this sum may not balance with the other counts.
|
CRC
|
Number of code violation errors seen on the ESCON interface, where a received transmission character is recognized as invalid. On a parallel interface, the number of parity errors seen.
|
frame
|
Number of packets received incorrectly having a CRC error and a noninteger number of octets. This value is always 0.
|
overrun
|
Number of times the serial receiver hardware was unable to hand received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data. This value is always 0.
|
ignored
|
Number of received packets ignored by the interface because the interface hardware ran low on internal buffers. These buffers are different than the system buffers mentioned previously in the buffer description. Broadcast storms and bursts of noise can cause the ignored count to be incremented.
|
abort
|
Illegal sequence of one bits on a serial interface. This usually indicates a clocking problem between the serial interface and the data link equipment. This value is always 0.
|
packets output
|
Total number of messages sent by the system.
|
bytes
|
Total number of bytes, including data and MAC encapsulation, sent by the system.
|
underruns
|
Sum of all errors that prevented the final sending of datagrams out of the interface being examined. Note that this may not balance with the sum of the enumerated output errors, as some datagrams may have more than one error, and others may have errors that do not fall into any of the specifically tabulated categories.
|
output errors
|
Number of output errors.
|
collisions
|
Number of collisions detected. This value is always 0.
|
interface resets
|
Number of times an interface has been completely reset. This can happen if packets queued for sending were not sent within several seconds. On a serial line, this can be caused by a malfunctioning modem that is not supplying the send clock signal, or by a cable problem. If the system notices that the carrier detect line of a serial interface is up, but the line protocol is down, it periodically resets the interface in an effort to restart it. Interface resets can also occur when an interface is looped back or shut down.
On the CMCC adapter, this may occur if the host software is not requesting data.
|
restarts
|
Number of times the controller was restarted because of errors.
|
shutdown (CMCC)
To shut down an interface or the virtual interface on the CMCC adapter when you are in interface configuration mode, use the shutdown CMCC command. The shutdown TN3270 server command also shuts down TN3270 entities, such as PU, DLUR, and DLUR SAP, depending on which configuration mode you are in when the command is issued. To restart the interface or entity, use the no form of this command. The entity affected depends on the mode in which the command is issued.
shutdown
no shutdown
Syntax Description
This command has no arguments or keywords.
Defaults
The interface or entity is enabled.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
10.2
|
This command was introduced.
|
Usage Guidelines
In channel interface configuration mode, the command applies to the entire CMCC adapter.
Examples
The following example issued in interface configuration mode shuts down the entire CMCC adapter:
state-tracks-signal
To allow the channel interface state to track the state of the physical interface signal on a Channel Port Adapter (CPA), use the state-tracks-signal interface configuration command. To disable tracking of the physical interface signal on a Channel Port Adapter interface, use the no form of this command.
state-tracks-signal
no state-tracks-signal
Syntax Description
This command has no arguments or keywords.
Defaults
The physical interface signal is not tracked.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.0(4.1)
|
This command was introduced.
|
Usage Guidelines
The state-tracks-signal command is useful in environments where you are using Hot Standby Router Protocol (HSRP) or SNMP alerts to monitor channel interface status.
The state-tracks-signal command is valid only on channel interfaces which combine the functions of both a physical and virtual interface. The ECPA and PCPA are examples of this type of channel interface. The command is not valid for the CIP, which has a separate channel interface for the virtual channel functions.
When the state-tracks-signal command is used on an interface that is configured for no shutdown, then the state of the channel interface is reported according to the status of the physical channel interface signal. If the physical channel interface signal is not present, then the channel interface status is DOWN/DOWN.
When the channel interface is configured for no state-tracks-signal (the default) and no shutdown, the channel interface status is always reported as UP/UP, even when there is no signal present on the physical connection. This configuration is useful for TN3270 server environments that are operating in a mode without any physical channel interface connections.
Examples
The following example specifies that the channel interface state tracks the physical channel interface signal and reports the channel interface state according to the presence or absence of the physical interface signal when the interface is configured for no shutdown:
Feedback
