Maximum input message length. Protocol level count that includes all protocol overhead plus data. The valid range is from 1 to 3840 bytes. The default is 962 bytes. Anything over the maximum is discarded and the interface giant counter is incremented. This does not apply to the GarbledMsg for the ASCU.

retry_option

Retry option. When a message with a bad cycle check character (CCC) is received from an ASCU, a retry option can be configured using the alpsretry-option command. The retry option configures the customer premises equipment (CPE) to send a message to the ASCU. The following retry options are available:

•resend—Indicator LED signals the operator at the ASCU to resend data.

•reenter—Service messages signal the operator at the ASCU to reenter data.

The default retry option is no retry.

alias

Parent ASCU interchange address to which this nonpolling automatic level control (ALC) ASCU is aliased.

err_disp_terminal

Terminal address to which error service messages are sent.

err_disp_line

Screen line number where error service messages are sent.

pkt_tx

Packets sent.

byte_tx

Bytes sent.

pkt_rx

Packets received.

byte_rx

Bytes received.

bad_CCC

Number of bad CCCs. Bad CCCs occurs due to the following reasons:

•The proper control characters were received.

•The characters did not exceed the maximum length.

•The CCC calculation fails.

garbledMsgs

Number of garbled messages. Garbled messages are a result of a range of different errors, including the following:

•An unexpected character is received.

•The maximum interface buffer size is exceeded.

•The maximum message length is exceeded.

T1Timeouts

Number of response timeouts.

Related Commands

Command

Description

alps ascu

Specifies a physical ASCU identity.

show alps circuits

To display the status of the Airline Product Set (ALPS) circuits, use the show alps circuits command in user EXEC or privileged EXEC mode.

show alps circuits [peerip-address][namename] [detailed]

Syntax Description

peerip-address

(Optional) Displays the status of the circuits connected to the specified peer.

namename

(Optional) Displays the status of the specified circuit.

detailed

(Optional) Displays the detailed output.

Command Default

If a circuit name is specified, then the status of that circuit will be displayed; otherwise, the status of all circuits will be displayed.

Command Modes

User EXEC (>)Privileged EXEC (#)

Command History

Release

Modification

11.3T

This command was introduced.

12.0(5)T

The output was modified.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2 SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Command Modes

Command History

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

This command first appeared in Cisco IOS Release 10.0. The verbose keyword first appeared in Cisco IOS Release 11.0.

The following are possible variations of the show bridge command:

show bridge ethernet 0

show bridge 0000.0c00.0000 0000.00FF.FFFF

show bridge 0000.0c00.0e1a

show bridge

show bridge verbose

In the sample output, the first command would display all entries for hosts reachable via Ethernet interface 0, the second command would display all entries with the vendor code of 0000.0c00.0000, and the third command would display the entry for address 0000.0c00.0e1a. In the fourth command, all entries in the forwarding database would be displayed. The fifth command provides additional detail. In all five lines, the bridge group number has been omitted.

Examples

The following is sample output from the show bridge command. The second display is output from the show bridge command with the verbose argument.

Total number of forwarding database elements in the system. The memory to hold bridge entries is allocated in blocks of memory sufficient to hold 300 individual entries. When the number of free entries falls below 25, another block of memory sufficient to hold another 300 entries is allocated. Therefore, the size of the bridge forwarding database is limited to the amount of free memory in the router.

295 free

Number in the free list of forwarding database elements in the system. The total number of forwarding elements is expanded dynamically, as needed.

BG

Bridging group to which the address belongs.

Hash

Hash key/relative position in the keyed list.

Address

Canonical (Ethernet ordered) MAC address.

Action

Action to be taken when that address is looked up; choices are to discard or forward the datagram.

Interface

Interface, if any, on which that address was seen.

Age

Number of minutes since a frame was received from or sent to that address. The letter "P" indicates a permanent entry. The letter "S" indicates the system as recorded by the router. On the modular systems, this is typically the broadcast address and the router's own hardware address; on the IGS, this field will also include certain multicast addresses.

RX count

Number of frames received from that address.

TX count

Number of frames forwarded to that address.

show bridge circuit-group

To display the interfaces configured in each circuit group and show whether they are currently participating in load distribution, use the show bridge circuit-group command in user EXEC or privileged EXEC mode.

Indicates whether this interface is included or not included in circuit-group operation. If the interface is administratively down, or if line protocol is not up, the interface is not included in the circuit-group operation.

learning

Indicates whether this interface is in Spanning Tree Protocol (IEEE or Digital) learning or not learning state.

forwarding

Indicates whether this port is in Spanning Tree Protocol (IEEE or Digital) forwarding or not forwarding state.

show bridge group

To display the status of each bridge group, use the show bridge group command in privileged EXEC mode.

show bridge group[verbose]

Syntax Description

verbose

(Optional) Displays detailed information.

Command Modes

Privileged EXEC

Command History

Release

Modification

10.3

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Examples

The following is sample output from the show bridge group command:

Router# show bridge group

Bridge Group 1 is running the DEC compatible Spanning Tree Protocol

Port 7 (ATM0.1 LANE Ethernet) of bridge group 1 is down

Port 4 (TokenRing0) of bridge group 1 is forwarding

"Forwarding" and "down" indicate the port state as determined by the spanning-tree algorithm or via configuration.

The following examples are for bridge group 30 and bridge group 40 of a PA-12E/2FE port adapter in slot 3:

Router# show bridge group

Bridge Group 30 is running the IEEE compatible Spanning Tree Protocol

Port 19 (Fast Ethernet3/0) of bridge group 30 is forwarding

Port 20 (Fast Ethernet3/1) of bridge group 30 is forwarding

Port 21 (Ethernet3/2) of bridge group 30 is forwarding

Port 22 (Ethernet3/3) of bridge group 30 is forwarding

Port 23 (Ethernet3/4) of bridge group 30 is forwarding

Port 24 (Ethernet3/5) of bridge group 30 is forwarding

Port 25 (Ethernet3/6) of bridge group 30 is forwarding

Bridge Group 40 is running the IEEE compatible Spanning Tree Protocol

Port 26 (Ethernet3/7) of bridge group 40 is down

Port 27 (Ethernet3/8) of bridge group 40 is down

Port 28 (Ethernet3/9) of bridge group 40 is down

Port 29 (Ethernet3/10) of bridge group 40 is down

Port 30 (Ethernet3/11) of bridge group 40 is down

Port 31 (Ethernet3/12) of bridge group 40 is down

Port 32 (Ethernet3/13) of bridge group 40 is down

show bridge multicast

To display transparent bridging multicast state information, use the show bridge multicast command in user EXEC or privileged EXEC mode.

List of the multicast router ports by bridge group. Within the bridge group cluster, the display lists the number of multicast router ports and then lists the ports by interface.

Multicast groups for...

List of the multicast groups by bridge group.

Within each multicast group, identified by a unique address, the display lists each port by interface name and indicates whether that port is a group member ("G"), a multicast router port ("R"), or both.

The receive (RX) and transmit (TX) counts show the number of multicast packets that have been constrained to the multicast group by the bridge.

show bridge vlan

To display virtual LAN subinterfaces, use the show bridge vlan command in privileged EXEC mode.

show bridge vlan

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release

Modification

10.3

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Indicates whether the router is configured for pass-through or local acknowledgment on the indicated interface.

Output queue depth

Packets queued on this interface. This field is displayed only when the value is not zero.

Frame builder state

Current frame building state. This field is displayed only when the state is not IDLE.

HDX enforcement state

Current half-duplex send enforcement state. The values are:

•IDLE—Waiting for communication activity.

•PND_COMP—Waiting for router to send.

•PND_RCV—Waiting for attached device to respond to data sent.

Frame sequencing state

Frame sequencing state to protect against network latencies.

When the router is configured as the primary end of the link, the values are:

•IDLE—Waiting for a poll.

•SEC—In a session with a device.

When the router is configured as the secondary end of the link, the values are:

•IDLE—Waiting for a poll.

•PRI—In a session with a device.

When the router is configured for point-to-point contention, the values are:

•IDLE—Waiting for a poll.

•PEND—Waiting for the first data frame.

•PRI—Connected device is acting as a primary device.

•SEC—Connected device is acting as a secondary device.

Total Tx Counts

Total transmit frame count for the indicated interface.

Total Rx Count

Total receive frame count for the indicated interface.

Primary state is ...

The current state when the router is configured as the primary end of the link. The possible values are:

•TCU_Down—Waiting for the line to become active.

•TCU_EOFile—A valid block ending in ETX has been received.

•TCU_Idle—Waiting for work or notification of completion of the sending of end of transmission (EOT).

•TCU_InFile—A valid block ending in ETB has been received.

•TCU_Polled—A general poll has been issued.

•TCU_Selected—A select has been issued.

•TCU_SpecPolled—A specific poll has been sent.

•TCU_TtdDelay—An ETB block was acknowledged, but the next block to be sent has not yet been received.

•TCU_TtdSent—A TTD has been sent because no data was received by the time the timeout for sending Ttd expired.

•TCU_TxEOFile—A block of data ending in ETX has been sent.

•TCU_TxInFile—A block of data ending in ETB has been sent.

•TCU_TxRetry—Trying to send a frame again.

Secondary state is ...

The current state when the router is configured as the secondary end of the link. The possible values are:

•CU_DevBusy—A select has been refused with WACK or RVI.

•CU_Down—Waiting for the line to become active.

•CU_EOFile—A valid block ending in ETX has been received.

•CU_Idle—Waiting for a poll or select action.

•CU_InFile—A valid block ending in ETB has been received.

•CU_Selected—A select has been acknowledged.

•CU_TtdDelay—An ETB block was acknowledged, but the next block to be sent has not yet been received.

•CU_TtdSent—A TTD has been sent because no data was received by the time the timeout for sending Ttd expired.

•CU_TxEOFile—A block of data ending in ETX has been sent.

•CU_TxInFile—A block of data ending in ETB has been sent.

•CU_TxRetry—Trying to send a frame again.

•CU_TxSpecPollData—A data frame (typically S/S) has been used to answer a specific poll.

•CU_TxStatus—Host has polled for device-specific status.

Poll address

Address used when the host wants to get device information.

Select address

Address used when the host wants to send data to the device.

State is ...

Current initialization state of this control unit. The values are:

•Active—The remote device is active.

•Inactive—The remote device is dead.

•Initializing—No response from remote device yet.

Tx Counts

Transmit frame count for this control unit.

Rx Counts

Receive frame count for this control unit.

Total Tx Counts

Total transmit frame count for the indicated interface.

Total Rx Counts

Total receive frame count for the indicated interface.

show bstun

To display the current status of serial tunnel (STUN) connections, use the show bstun command in privileged EXEC mode.

show bstun[groupbstun-group-number] [addressaddress-list]

Syntax Description

group bstun-group-number

(Optional) Block Serial Tunneling (BSTUN) group number. Valid numbers are decimal integers in the range from 1 to 255.

address address-list

(Optional) List of poll addresses.

Command Modes

Privileged EXEC

Command History

Release

Modification

11.0

This command was introduced.

12.2(4)T

This command was modified for the Bisync-to-IP Conversion for Automated Teller Machines feature. The display was modified to include Bisync-to-IP (BIP) as a transport protocol, and to show both the foreign and local port numbers.

12.3(2)T

This command was modified for the Asynchronous Point of Sale-to-IP Conversion (APIP) feature to include APIP as a transport protocol.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Examples

The following is sample output from the show bstun command with no options:

Lists the peer name or address. The interface name (as defined by the description command), its block serial tunnel (BSTUN) group number, and the protocol associated with the group are shown on the next header line.

route

Bisync control unit address or all.

transport

Description of link, either a serial interface using serial transport (indicated by IF followed by interface name), a TCP connection to a remote router (TCP followed by IP address), a BIP connection to a host, or APIP connection to a host (APIP followed by an IP address).

address

The IP address or serial interface that packets are being forwarded to.

fport

The foreign port number.

lport

The local port number.

state

State of the link. The following are possible values for the state of the link:

•open: A connection is active.

•open pending: Indicates the router will be attempting to connect to the remote device.

•open wait: An active open message has been sent to the remote device, and the router is waiting for a response.

•direct: A direct link to another line is active.

•dead: The connection has been aborted.

•closed: A normal close operation has disconnected the connection.

open

A connection is active.

open pending

Indicates the router will be attempting to connect to the remote device.

open wait

An active open message has been sent to the remote device, and the router is waiting for a response.

direct

A direct link to another line is active.

dead

The connection has been aborted.

closed

A normal close operation has disconnected the connection.

rx_pkts

Number of received packets.

tx_pkts

Number of sent packets.

drops

Number of packets that had to be dropped for whatever reason.

show controllers channel

To display Channel Port Adapter (CPA)-specific information, including the loaded microcode, use the show controllers channel command in user EXEC or privileged EXEC mode.

show controllers channel [slot/port]

Syntax Description

slot

(Optional) Slot number.

port

(Optional) Interface number.

Command Modes

User EXECPrvileged EXEC

Command History

Release

Modification

11.3 T

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

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

Load metrics:

Memory sram 2964552/4096K, dram 11552952/16M

CPU 1m 0%, 5m 0%, 60m 0%

DMA 1m 0%, 5m 0%, 60m 0%

ECA0 1m 0%, 5m 0%, 60m 0%

Interface Channel5/0

Hardware is Escon Channel

HW Registers control status=0x0001EC07 LED control=0x00045DD5

HW Poll Register 4B05D4E0:[00000001]

Free buffer queues

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

Tx Queues

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

Rx Queues

max_entries=221 poll_index=3 head=57 ring=4B096800

max packets per interrupt count = 0

show controllers token (IBM)

To display information about memory management, error counters, and the board itself, use the show controllers token command in privileged EXEC mode.

show controllers token

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release

Modification

10.0

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

Depending on the board being used, the output from the show controllers token commandcan vary. The show controllers token command also displays proprietary information. Thus, the information that the show controllers token command displays is of primary use to Cisco Systems technical personnel. Information that is useful to users can be obtained with the show interfaces tokenring command, described later.

Examples

The following is sample output from the show controllers token command of a CSC-IR or CSC-2R card:

Unit number assigned to the Token Ring interface associated with this output.

is board 0

Board number assigned to the Token Ring controller board associated with this interface.

ring 0

Number of the Token Ring associated with this board.

In the following line, state 3 indicates the state of the board. The rest of this output line displays memory mapping that is of primary use to Cisco engineers.

state 3, dev blk: 0x1D2EBC, mailbox: 0x2100010, sca: 0x2010000

The following line also appears in show interface token output as the address and burned-in address (bia), respectively:

current address: 0000.3080.6f40, burned in address: 0000.3080.6f40

The following line displays buffer management pointers that change by board:

current TX ptr: 0xBA8, current RX ptr: 0x800

The following line indicates the ring status from the controller chipset. This information is used by LAN Network Manager:

Last Ring Status: none

The following line displays Token Ring statistics. See the Token Ring specification for more information:

Stats: soft:0/0, hard:0/0, sig loss:0/0

tx beacon: 0/0, wire fault 0/0, recovery: 0/0

only station: 0/0, remote removal: 0/0

The following line indicates that Token Ring communication has been enabled on the interface. If this line of output appears, the message "Source Route Bridge capable" should appear in the show interfaces tokenring display.

Bridge: local 3330, bnum 1, target 3583

Table 24, Part 2 describes the fields shown in the following line of sample output:

max_hops 7, target idb: 0x0, not local

Table 24, Part 2 show controllers token Field Descriptions

Field

Description

max_hops 7

Maximum number of bridges.

target idb: 0x0

Destination interface definition.

not local

Interface has been defined as a remote bridge.

The following line is specific to the hardware:

Interface failures: 0 -- Bkgnd Ints: 0

In the following line, transmit (TX) shorts are the number of packets the interface sends that are discarded because they are smaller than the medium's minimum packet size. TX giants are the number of packets the interface sends that are discarded because they exceed the medium's maximum packet size.

TX shorts 0, TX giants 0

The following line indicates the state of the controller. Possible values are active, failure, inactive, and reset.

Monitor state: (active)

The following line displays detailed information relating to the monitor state shown in the previous line of output. This information relates to the firmware on the controller. This information is relevant to Cisco engineers only if the monitor state is something other than active.

Interface has not been configured for bridging, but it has that capability.

The following line displays the version numbers for the kernel and the accelerator microcode of the Madge firmware on the board; this firmware is the Logical Link Control (LLC) interface to the chipset:

SMT form of this command s: 1.01 kernel, 4.02 fastmac

The following line displays LAN Network Manager information that relates to ring status:

ring mode: F00, internal enables: SRB REM RPS CRS/NetMgr

The following line corresponds to the functional address and the group address shown in show interfaces tokenring output:

internal functional: 0000011A (0000011A), group: 00000000 (00000000)

The following line displays interface board state information that is proprietary:

if_state: 1, ints: 0/0, ghosts: 0/0, bad_states: 0/0

The following lines display information that is proprietary. Our engineers use this information for debugging purposes:

t2m fifo purges: 0/0

t2m fifo current: 0, t2m fifo max: 0/0, proto_errs: 0/0

Each of the fields in the following line maps to a field in the show source bridge display, as follows: ring maps to srn; bridge num maps to bn; target maps to trn; and max hops maps to max:

ring: 3330, bridge num: 1, target: 3583, max hops: 7

In the following lines of output, the number preceding the slash (/) indicates the count since the value was last displayed; the number following the slash (/) indicates the count since the system was last booted:

Packet counts:

receive total: 298/6197, small: 298/6197, large 0/0

In the following line, the number preceding the slash (/) indicates the count since the value was last displayed; the number following the slash (/) indicates the count since the system was last booted. The runts and giants values that appear here correspond to the runts and giants values that appear in show interfaces tokenring output:

runts: 0/0, giants: 0/0

The following lines are receiver-specific information that Cisco engineers can use for debugging purposes:

local: 298/6197, bridged: 0/0, promis: 0/0

bad rif: 0/0, multiframe: 0/0

ring num mismatch 0/0, spanning violations 0

transmit total: 1/25, small: 1/25, large 0/0

runts: 0/0, giants: 0/0, errors 0/0

The following lines include very specific statistics that are not relevant in most cases, but exist for historical purposes. In particular, the internal errors, burst errors, ari/fci, abort errors, copy errors, frequency errors, dma bus errors, and dma parity errors fields are not relevant.

Internal controller counts:

line errors: 0/0, internal errors: 0/0

burst errors: 0/0, ari/fci errors: 0/0

abort errors: 0/0, lost frame: 0/0

copy errors: 0/0, rcvr congestion: 0/0

token errors: 0/0, frequency errors: 0/0

dma bus errors: -/-, dma parity errors: -/-

The following lines are low-level Token Ring interface statistics relating to the state and status of the Token Ring with respect to all other Token Rings on the line:

Internal controller smt state:

Adapter MAC: 0000.3080.6f40, Physical drop: 00000000

NAUN Address: 0000.a6e0.11a6, NAUN drop: 00000000

Last source: 0000.a6e0.11a6, Last poll: 0000.3080.6f40

Last MVID: 0006, Last attn code: 0006

Txmit priority: 0006, Auth Class: 7FFF

Monitor Error: 0000, Interface Errors: FFFF

Correlator: 0000, Soft Error Timer: 00C8

Local Ring: 0000, Ring Status: 0000

Beacon rcv type: 0000, Beacon txmit type: 0000

show dlsw capabilities

To display the configuration of a specific peer or all peers, use the show dlsw capabilities command in privileged EXEC mode.

MAC address and SAP value used by end station closest to this data-link switching plus (DLSw+) peer.

remote addr(dsap)

MAC address and SAP value used by end station that is across the peer connection (remote).

state

Indicates whether circuit has completed establishment.

uptime

Length of time a circuit has been connected.

Total number of circuits connected

Number of total connected circuits. If a circuit has not completed connection, it will not show a value.

PCEP, UCEP

Internal correlators used as labels for communication internal to the router between DLSw+ and Logical Link Control, type 2 (LLC2), Synchronous Data Link Control (SDLC), or Qualified Logical Link Control (QLLC).

Port

Local port over which this circuit has been established or DLSw interface to the bridge group.

Flow Control (Tx and Rx)

Reports DSLw+ flow control windows as described in Section 8 of RFC 1795.

SQ

Two flags indicating congestion toward the remote peer. These flags are displayed only when the circuit is congested.

S

Data flow from the local station has been stopped. This results in LLC2 or SDLC sending Receiver Not Ready (RNR) frames.

Q

Data frames are being queued for transport to the remote peer.

CW

Current pacing window. See RFC 1795.

Permitted

Packet counter for tx. See RFC 1795.

Granted

Packet counter for rx. See RFC 1795.

Op

Next flow indicator (FCI) that will be sent to the remote peer. See RFC 1795.

Congestion

Data flow indicator from router to station is congested. Values are Low, Medium, High, and Max.

Flow Op

Amount of Reset Window Operator and Half Window Operator being sent or received. See RFC 1795.

RIF

Routing Information Field used over the local port for data traversing this circuit (if appropriate).

show dlsw circuits history

To display the details of the last status of all DLSW circuits either currently active or not active, use the show dlsw circuitshistory command in privileged EXEC mode.

MAC address of station being sought (destination MAC address of canureach_ex packet).

NetBIOS Name

NetBIOS name of station being sought (destination MAC address of NQ_ex packet).

status

Result of station search. The status can be one of the following:

•FOUND—Station has recently sent a broadcast or responded to a broadcast.

•SEARCHING—Router has sent a broadcast to this station and is waiting for a response.

•NOT_FOUND—Negative caching is on, and the station has not responded to queries.

•UNCONFIRMED—Station is configured, but DLSw has not verified it.

•VERIFY—Cache information is being verified because cache is going stale, or the user configuration is being verified.

Loc.

Location of station. LOCAL indicates that the station is on the local network. REMOTE indicates that the station is on the remote network.

peer/port

Peer/port number. If the Loc. field lists a REMOTE station, the peer/port field indicates the peer through which the remote station is reachable. If the Loc. field lists a LOCAL station, the peer/port field indicates the port through which the local station is reachable. For ports, the port number and slot number are given. Pxxx-Syyy denotes port xxx slot yyy. If the station is reachable through a bridge group, that is shown by TBridge-xxx.

rif

Displays the Routing Information Field (RIF) in the cache. This column applies only to LOCAL stations. If the station was reached through a medium that does not support RIFs (such as Synchronous Data Link Control [SDLC] or Ethernet) then "--no rif--" is shown.

show dlsw statistics

Todisplay the number of frames that have been processed in the local, remote, and group cache, use the show dlsw statistics command in privileged EXEC mode.

show dlsw statistics [border-peers]

Syntax Description

border-peers

(Optional) Displays the number of frames processed in the local, remote, and group caches.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release

Modification

11.2 F

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Examples

The following is sample output from the show dlsw statistics command. The output displays the number of frames processed in the local, remote, and group cache.

Router# show dlsw statistics border-peers

100 Border Peer Frames processed

10 Border frames found Local

20 Border frames found Remote

17 Border frames found Group Cache

show dlsw transparent cache

To display the master circuit cache for each transparent bridged domain, use the show dlsw transparent cache command in privileged EXEC mode.

show dlsw transparent cache

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release

Modification

12.0(5)T

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

Issue the show dlsw transparent cache command on the master router of the transparent bridged domain.

Examples

The following is sample output from the show dlsw transparent cache command:

Router# show dlsw transparent cache

Interface Ethernet0/1

Circuit Cache

local addr(lsap) remote addr(dsap) state Owner

0000.3028.92b6(08) 0007.0db1.238c(08) POSITIVE SELF

0000.3028.92b6(08) 0008.dec3.609e(12) NEGATIVE 0009.fa50.0b1c

Total number of circuits in the Cache:2

show dlsw transparent map

To display MAC address mappings on the local router and any mappings for which the local router is acting as backup for a neighbor peer, use the show dlsw transparent map command in privileged EXEC mode.

show dlsw transparent map

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release

Modification

12.0(5)T

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

Issue the show dlsw transparent map command to ensure that the local MAC address is the address created in the dlsw transparent map command. The command should be issued on all the routers configured for the Ethernet Redundancy feature to ensure the local MAC addresses match.

Examples

The following is sample output from the show dlsw transparent map command on two routers configured for the Ethernet Redundancy feature:

Router6# show dlsw transparent map

Interface Ethernet6/2

LOCAL Mac REMOTE MAC BACKUP

--------- ---------- ------

0008.dec3.0080 0008.dec3.609e 0007.7fb0.1080 STATIC

0008.dec3.0040 0008.dec3.609e 0007.7fb0.1080 DYNAMIC(Passive)

Router7# show dlsw transparent map

Interface Ethernet0/1

LOCAL Mac REMOTE MAC BACKUP

--------- ---------- ------

0008.dec3.0080 0008.dec3.609e 0006.3a0a.1a55 DYNAMIC(Passive)

0008.dec3.0040 0008.dec3.609e 0006.3a0a.1a55 STATIC

The output from Router 6 and Router 7 shows the created MAC addresses are 0008.dec3.0080 and 0008.dec3.0040.

show dlsw transparent neighbor

To display data-link switching plus (DLSw) neighbors in a transparent bridged domain, use the show dlsw transparent neighbor command in privileged EXEC mode.

show dlsw transparent neighbor

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release

Modification

12.0(5)T

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Examples

The following is sample output from the show dlsw transparent neighbor command:

Router# show dlsw transparent neighbor

Interface ATM0.1

0006.e278.6c0e SELF Master

0009.fa50.0b1c Rcvd Master-Accepted VALID

The output shows that Router 7 is the master router whose MAC address is 0006.e278.6c0e. The other router, with a MAC address of 0009.fa50.0b1c, is a slave router on the common domain. The master router received a packet from the slave and notes the router is VALID.

show drip

To display the status of the duplicate ring protocol (DRiP) database for a router or an Route Switch Module (RSM), use the show drip command in privileged EXEC mode.

show drip

Syntax Descriptions

This command has no arguments or keywords.

Defaults

No default behavior or values.

Command Modes

Privileged EXEC

Command History

Release

Modification

11.3(4)T

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Examples

The following is sample output from the show drip command:

Router# show drip

DRIP Database for Mgmt Domain Fast Ethernet4/0

--------------------------------------------------

Mac Address 0010-A6AE-B440

Vlan 100 Status 30 : l-active, l-config,

Mac Address 0010-2F72-C800

Vlan 20 Status 0C : r-active, r-config,

Vlan 1003 Status 0C : r-active, r-config,

Statistics:

Advertisements received 126

Advertisements processed 1

Advertisements transmitted 131

Last revision transmitted 0x84

Last changed revision transmitted 0x2

Related Commands

Command

Description

clear drip counters

Clears DRiP counters.

interface vlan

Configures a Token Ring or Ethernet interface on the RSM.

show vlans

Displays virtual LAN subinterfaces.

show dspu

To display the status of the downstream physical unit (DSPU) feature, use the show dspu command in privileged EXEC mode.

show dspu [poolpool-name |pu{host-name | pu-name}] [all]

Syntax Description

pool pool-name

(Optional) Name of a pool of logical unit (LU)s (as defined by the dspu pool command).

pu

(Optional) Name of defined physical unit (PU) (as defined by either the dspu pu or the dspu host command).

host-name

Name of a host defined in a dspu host command.

pu-name

Name of a PU defined in a dspu pu command.

all

(Optional) Displays a detailed status.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release

Modification

10.3

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Examples

The following is sample output from the show dspu command. It shows a summary of the DSPU status.

Router# show dspu

dspu host HOST_NAMEA interface PU STATUS ssssssss

FRAMES RECEIVED nnnnnn FRAMES SENT nnnnnn

LUs USED BY DSPU nnn LUs ACTIVE nnn

LUs USED BY API nnn LUs ACTIVE nnn

LUs ACTIVATED BY HOST BUT NOT USED nnn

dspu host HOST_NAMEB interface PU STATUS ssssssss

FRAMES RECEIVED nnnnnn FRAMES SENT nnnnnn

LUs USED BY DSPU nnn LUs ACTIVE nnn

LUs USED BY API nnn LUs ACTIVE nnn

LUs ACTIVATED BY HOST BUT NOT USED nnn

dspu pu PU_NAMEE interface PU STATUS ssssssss

FRAMES RECEIVED nnnnnn FRAMES SENT nnnnnn

LUs USED BY DSPU nnn LUs ACTIVE nnn

LUs USED BY API nnn LUs ACTIVE nnn

LUs ACTIVATED BY HOST BUT NOT USED nnn

dspu pu PU_NAMEF interface PU STATUS ssssssss

FRAMES RECEIVED nnnnnn FRAMES SENT nnnnnn

LUs USED BY DSPU nnn LUs ACTIVE nnn

LUs USED BY API nnn LUs ACTIVE nnn

LUs ACTIVATED BY HOST BUT NOT USED nnn

The following is sample output from the show dspu command with the pu keyword:

Router# show dspu pu putest

dspu pu PUTEST interface PU STATUS ssssssss

RMAC remote_mac RSAP remote_sap LSAP local_sap

XID xid RETRIES retry_count RETRY_TIMEOUT retry_timeout

WINDOW window_size MAXIFRAME max_iframe

FRAMES RECEIVED nnnnnn FRAMES SENT nnnnnn

LUs USED BY DSPU nnn LUs ACTIVE nnn

LUs USED BY API nnn LUs ACTIVE nnn

LUs ACTIVATED BY HOST BUT NOT USED nnn

The following is sample output from the show dspu command with the all keyword:

Router# show dspu pu putest all

dspu pu PUTEST interface PU STATUS ssssssss

RMAC remote_mac RSAP remote_sap LSAP local_sap

XID xid RETRIES retry_count RETRY_TIMEOUT retry_timeout

WINDOW window_size MAXIFRAME max_iframe

FRAMES RECEIVED nnnnnn FRAMES SENT nnnnnn

LU nnn PEER PU HOST_NAMEA PEER LU nnn STATUS tttttttt

FRAMES RECEIVED nnnnnn FRAMES SENT nnnnnn

LU nnn PEER PU HOST_NAMEA PEER LU nnn STATUS tttttttt

FRAMES RECEIVED nnnnnn, FRAMES SENT nnnnnn

LU nnn PEER PU HOST_NAMEB PEER LU nnn STATUS tttttttt

FRAMES RECEIVED nnnnnn, FRAMES SENT nnnnnn

The following example shows a summary of the LUs in a pool:

Router#show dspu pool poolname

dspu pool poolname host HOST_NAMEA lu start-lu end-lu

The following example shows the details of all the LUs in a pool:

Router#show dspu pool poolname all

dspu pool poolname host HOST_NAMEA lu start-lu end-lu

DSPU POOL poolname INACTIVITY_TIMEOUT timeout-value

lu nnn host HOST_NAMEA peer lu nnn pu PU_NAMEF status tttttttt

lu nnn host HOST_NAMEA peer lu nnn pu PU_NAMEF status tttttttt

lu nnn host HOST_NAMEA peer lu nnn pu PU_NAMEF status tttttttt

show extended channel backup

To display information about the Common Link Access for Workstations (CLAW) and offload commands for each backup group configured on Cisco Mainframe Channel Connection (CMCC) channel interfaces, use the show extended channel backup command in privileged EXEC mode.

show extended channelslot/port backup [ip-address]

Syntax Description

slot

Slot number.

port

Port number.

backup

Displays all claw or offload commands associated with the backup group.

ip-address

(Optional) Displays information about all devices in the backup group defined by the ip-address argument.

Command Modes

Privileged EXEC

Command History

Release

Modification

12.0

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Examples

The following is sample output from the show extended channel backup command:

Router# show extended channel 0/1 backup

Mode Path Device IP Address: 10.11.198.2

OFFLOAD E200 50 CISCOVM RISPIX TCPIP TCPIP TCPIP API

OFFLOAD E300 50 CISCOVM RISPIX TCPIP TCPIP TCPIP API

Last statistics 4 seconds old, next in 6 seconds

Related Commands

Command

Description

claw (backup)

Configures a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in offload mode and also configures individual members of a CLAW backup group for the IP Host Backup feature.

offload (backup)

Configures a backup group of Offload devices.

show extended channel cmgr

To display information about the Cisco Multipath Channel (CMPC+) transmission group (TG) connection manager, use the show extended channel cmgr command in privileged EXEC mode.

show extended channelslot/portcmgr [tg-name]

Syntax Description

slot

Slot number.

port

Physical channel interface port number.

tg-name

(Optional) Name of the TG.

Command Modes

Privileged EXEC

Command History

Release

Modification

12.0(3)T

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

•Active—Connection manager virtual circuit active indication was received from the host and CMCC adapter has sent a virtual circuit active indication to the host. The virtual circuit is now ready to send receive connection requests.

Local Conn.Token

CMCC's token for the connection manager's connection.

Remote Conn.Token

Host's token for the connection manager's connection.

Connection Status

Valid states for a connection manager's connection are:

•Reset—Awaiting a connection manager connection request from the host.

•Active—Connection is active. The host has sent a connection request and the CMCC adapter has responded with a confirmation of the connection.

Related Commands

show extended channel cmpc

To display information about each Cisco Multipath Channel (CMPC) or CMPC+ subchannel configured on the specified channel interface, use the show extended channel cmpc command in privileged EXEC mode.

show extended channel slot/portcmpc [path [device]]

Syntax Description

slot

Slot number.

port

Physical channel interface port number.

path

(Optional) Logical channel path.

device

(Optional) Two-digit hexadecimal value that specifies a device address of the CPMC or CMPC+ subchannel. If specified, only status for that CMPC or CMPC+ device is displayed. If not specified, status for all CMPC or CMPC+ devices for the specified path is displayed.

Command Modes

Privileged EXEC

Command History

Release

Modification

11.3

This command was introduced.

12.0(3)T

Support was added for the CMPC+ feature.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

This command is valid only on the Cisco Mainframe Channel Connection (CMCC) adapter physical interfaces.

Examples

The following is sample output on a Cisco 7500 router from the show extended channel cmpc command:

On the read subchannel, this is the number of 4 KB-size pages that virtual telecommunications access method (VTAM) has allocated for each Read. This will match the MAXBFRU value configured in the VTAM Transport Resource List (TRL) major node. On the write subchannel, this is the maximum number of 4-KB pages VTAM can write to the CMCC adapter for a single channel I/O. The value will always be 16 for the write subchannel because the Channel Interface Processor (CIP)always allows VTAM to write up to 64 KB per channel I/O.

Status

State of the CMPC or CMPC+ subchannel. Valid values are:

•Shutdown—CMCC adapter interface for this CMPC or CMPC+ subchannel is shut down. In this state, the Bfrs value is not available and will be displayed as zeros.

Displays information about the MPC+ transmission group connection manager.

show extended channel connection-map llc2

To display the number of active Logical Link Control, type 2 (LLC2) connections for each service access point (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 command in privileged EXEC mode.

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.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

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:

Syntax Description

slot

Slot number.

port

Port number.

path

(Optional) A hexadecimal value in the range from 0000 to FFFF. This 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. If not specified, information is displayed for all CSNA subchannels configured on the selected interface.

device

(Optional) A hexadecimal value in the range from 00 to FE. This is the unit address associated with the control unit number and path as specified in the host input/output configuration program (IOCP) file. If not specified, information is displayed for all CSNA subchannels configured with the specified path on the selected interface.

Command Modes

Command History

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

The information that is displayed by this command is generally useful for diagnostic tasks performed by technical support personnel only.

Examples

The following is sample output from the show extended channel csna command. Three examples are provided, one for each type of output as specified by the admin, oper, and statskeywords.

The following example displays the configured values for all CSNA devices on interface channel 1/0:

Router# show extended channel 1/0 csna admin

Path Dv maxpiu time-delay length-delay

CSNA C200 60 64000 100 64000

CSNA C200 61 64000 100 64000

CSNA C200 62 64000 100 64000

The following example displays operational data for all CSNA devices configured on interface channel 1/0. The channel interface must be up (no shut) for this information to be displayed.

Router# show extended channel 1/0 csna oper

Path Dv Status SlowDown maxpiu time-delay length-delay

CSNA C200 60 setupComplet off 64000 100 64000

CSNA C200 61 setupComplet off 64000 100 64000

CSNA C200 62 setupComplet off 64000 100 64000

The following example displays CSNA statistics for subchannel path c200, device 60. The channel interface must be up (no shut) for this information to be displayed. If the maxpiu value is reconfigured while the CSNA subchannel is active (setupComplete) then the maxpiu value displayed by the oper keyword is the old, operational value.

•setupComplete—All internal MAC adapter information has been collected from the CIP. The CSNA subchannel is operational.

•pendingClose—A Close Subchannel command has been received from VTAM.

•unknown—Current state of the CSNA subchannel cannot be determined.

SlowDown

Status of flow control for the CSNA device.

•off—Subchannel is normal (both CSNA and VTAM are able to send data.

•sent— CSNA has put VTAM into a slow down state for this CSNA subchannel.

•received—VTAM has put the CSNA subchannel into a slow down state.

•both—Both VTAM and the CSNA subchannel are in a slow down state.

•unknown—Current state of flow control on this CSNA subchannel cannot be determined.

maxpiu

Maximum size of a channel I/O block that the CSNA subchannel can send to the host. This value may differ from the configured maxpiu value if the value is reconfigured while the CSNA subchannel is active (setupComplete).

CSNA blocks Systems Network Architecture (SNA) frames into channel I/O blocks which must not exceed the maxpiu value. A length-delay value less than the maxpiu value can cause the channel I/O blocks to be limited to the lower value.

The maxpiu value may be reconfigured while the subchannel is operational but the new maxpiu value does not take effect until the subchannel is reinitialized (in other words, until the XCA major node is recycled). In this case, the maxpiu value displayed with the admin keyword will be the new, configured value while the maxpiu displayed by the oper keyword will be the old, operational value.

time-delay

CSNA blocks SNA frames destined for VTAM for time-delay milliseconds from the time the first SNA frame within a channel I/O block is blocked from sending. This can increase the overall throughput of CSNA by minimizing the number of channel I/O operations. However, blocking can induce response time latency of a transaction by up to the time-delay value. If time-delay=0, CSNA ignores length-delay and puts each frame into the channel I/O block for sending to the host. Even with a time-delay=0, CSNA may still block frames while waiting for a previous channel I/O to complete.

length-delay

CSNA blocks SNA frames destined for VTAM when the current block reaches the length-delay value in size (bytes). This will increase the chance of using larger block sizes for CSNA channel I/O. SNA frames are blocked up to either time-delay milliseconds or until the block reaches the length-delay size, at which time CSNA starts the channel I/O.

The length-delay is ignored if larger than the maxpiu value. It can be used to force CSNA blocking to generate smaller I/O blocks than specified by maxpiu. In general, however, larger blocks result in better channel throughput and efficiency. A value of zero causes the length-delay value to be ignored; blocking is then controlled by the maxpiu and time-delay parameters.

Blocks Transmitted

Number of channel I/O blocks sent to VTAM from this CSNA subchannel. The Blocks Transmitted value may be higher than the total blocks for the Txd by maxpiu, Txd by time-delay, and Txd by length-delay counters. This is due to NULL blocks (8 bytes each with no data) that CSNA sends. The channel program used for link-state advertisement (LSA) traffic consists of a write/read CCW chain. When VTAM has data for CSNA it sends it with the write CCW. When the chained read CCW is executed CSNA will respond with any pending inbound data. If CSNA has no pending inbound data the read CCW is satisfied with an 8-byte header indicating no data.

Blocks Received

Number of channel I/O blocks received from VTAM by this CSNA subchannel.

Slow downs Sent

Number of times CSNA put VTAM into a slowdown (flow control) for this subchannel device.

Slow downs Received

Number of times VTAM put CSNA into a slowdown (flow control) for this subchannel.

Txd by maxpiu

Blocks/Bytes

Number of channel I/O blocks and bytes sent to VTAM by this CSNA subchannel because the size of the channel I/O block reached the maxpiu value configured for this subchannel.

Txd by time-delay

Blocks/Bytes

Number of channel I/O blocks and bytes sent to VTAM by this CSNA subchannel because the blocking time delay configured for this subchannel expired.

Txd by length-delay

Blocks/Bytes

Number of channel I/O blocks and bytes sent to VTAM by this CSNA subchannel because the blocking length delay configured for this subchannel was reached.

Related Commands

Command

Description

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.

show extended channel icmp-stack

To display information about the Internet Control Message Protocol (ICMP) stack running on the Cisco Mainframe Channel Connection (CMCC) channel interfaces, use the show extended channel icmp-stack command in user EXEC or privileged EXEC mode.

Virtual IP addresses assigned to the real IP address of an offload device.

InMsgs

Total number of Internet Control Message Protocol (ICMP) messages that the entity received. Note that this counter includes all those counted by icmpInErrors.

InErrors

Number of ICMP messages that 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 physical unit (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 Dependent Logical Unit Requestor (DLUR) PU configuration mode.

show extended channel ip-stack

To display information about the IP stack running on Cisco Mainframe Channel Connection (CMCC) channel interfaces, use the show extended channel ip-stack command in user EXEC or privileged EXEC mode.

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, and so on.

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 that 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 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 that were discarded (for example, for lack of buffer space). Note that this counter does not include any datagrams discarded while awaiting reassembly.

InDelivers

Total number of input datagrams delivered to IP user protocols (including Internet Control Message Protocol (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 that 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 that 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 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 because 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 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 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 physical unit (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 Dependent Logical Unit Requestor (DLUR) PU configuration mode.

show extended channel lan

To display the internal LANs and adapters configured on a Cisco Mainframe Channel Connection (CMCC) adapter, use the show extended channel lan command in user EXEC or privileged EXEC mode.

show extended channel slot/portlan[tokenring [lan-id [adapno]]]

Syntax Description

slot

Slot number.

port

Port number.

tokenring

(Optional) Specify the 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

User EXECPrivileged EXEC

Command History

Release

Modification

11.0

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

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:

show extended channelslot/portllc2[admin|oper|stats][lmac[lsap[rmac[rsap]]]]

Syntax Description

slot

Slot number.

port

Port number.

admin

(Optional) Displys Shows configured values. This is the default.

oper

(Optional) Displays operational values for:

•Internal adapters

•Service access point (SAP)s 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 SAP address, in the range from 0 to 256.

rmac

(Optional) Remote MAC address.

rsap

(Optional) Remote SAP address, in the range from 0 to 256.

Command Modes

User EXECPrivileged EXEC

Command History

Release

Modification

11.0(3)

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

The show extended channel llc2 command is valid on virtual channel interfaces.

To specify LLC information for internal adapters, perform the following asks:

•Specify a value for the lmac argumentto 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, perform the following tasks:

•Specify values for the lmac and lsap arguments to display information for a particular SAP.

•Specify a value for the lmac argumentand "*' to display information for all SAPs opened on the specified channel adapter.

To display information for LLC2 connections on a channel interface, perform the following tasks:

•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 argumentto 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:

Length of time in milliseconds the CMCC LLC2 link station waits for an acknowledgment to a sent I-frame before polling the remote LLC2 station.

tpf-time

Length of time in milliseconds the CMCC LLC2 link station waits for a final response to a poll before resending the original poll frame.

trej-time

Length of time in milliseconds the CMCC LLC2 link station waits for a correct frame after sending a reject command to a remote LLC2 station.

tbusy-time

Length of time in milliseconds 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 virtual telecommunications access method (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 Channel Interface Processor (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=1

Max SAPs Opened=1

Open SAPS is the number of SAPs 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 stats

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 38 describes the specified 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.

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 exchange identification (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.

UIFramesIn

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 or 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, an 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 an 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, an SNMP trap, and a router console message.

DMsInABM

Number of times the CMCC LLC2 link station went into disconnect mode after receiving a disconnect mode (DM). The CMCC LLC2 stack generates an event each time it detects this condition. The event can be configured to generate a NetView alert, an SNMP trap, and a router console message.

SABMEDsInABM

Number of times the CMCC LLC2 link station went into disconnect mode after receiving a Set Asynchronous Balanced Mode Extended (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, an SNMP trap, and a router console message.

The following sample displays operation information for the specified CMCC link station:

Table 41 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.

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 in milliseconds the CMCC LLC2 link station waits for an acknowledgment to a sent I-frame before polling the remote LLC2 station.

tpf-time

Length of time in milliseconds the CMCC LLC2 link station waits for a final response to a poll before resending the original poll frame.

trej-time

Length of time in milliseconds the CMCC LLC2 link station waits for a correct frame after sending a reject command to a remote LLC2 station.

tbusy-tim

Length of time in milliseconds 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 length of time in milliseconds the CMCC LLC2 link station allows received I-frames to remain unacknowledged. The Channel Interface Processor (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 Receiver Not Ready (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:

Number of times the CMCC LLC2 link station entered the busy state. This state occurs for a CMCC LLC2 link station when there are x I-frames received from the remote LLC2 station on the CMCC queued to be sent over the channel to VTAM; Where x is two times the recv-wind value. 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 the Nw field description in Table 40 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 Logical Link Control, type 2 (LLC2) sessions supported on the Cisco Mainframe Channel Connection (CMCC) adapter, use the show extended channel max-llc2-sessionscommand in privileged EXEC mode.

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.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

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:

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 and no shut command, 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 failures

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 service access point (SAP) and the mapping of the internal MAC adapter and the SAP to the resource that activated the SAP.

show extended channel packing names

To display Common Link Access for Workstations (CLAW) packing names and their connection state, use the show extended channel packing names command in user EXEC or privileged EXEC mode.

show extended channelslot/portpacking names[path [device-address]]

Syntax Description

slot

Slot number.

port

Port number.

path

(Optional) Hexadecimal value in the range from 0000 to FFFF. This value specifies the logical channel path and consists of two digits for the physical connection (either on the host or on the ESCON director), one digit for the channel logical address, and one digit for the control unit logical address. If the path is not specified in the input/output configuration program (IOCP), the default value for channel logical address and control unit logical address is 0.

device-address

(Optional) Hexadecimal value in the range from 00 to FE. This is the unit address associated with the control unit number and path as specified in the host IOCP file. The device address must have an even numbered value.

Command Modes

User EXECPrivileged EXEC

Command History

Release

Modification

12.0

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Examples

The following is sample output from the show extended channel packing names command:

Path from the CLAW configuration. It indicates which port on the switch is used by the channel side of the configuration.

Devices

Device address for each device. One CLAW connection requires two devices. You need only specify the even numbered address.

CLAW Link

Established CLAW link number used for all CLAW packing messages. A number value indicates that a CONTROL sublink is connected. "N" indicates that a control sublink is disconnected.

Sublink

DISCONNECTED indicates that a sublink connection for a particular link name is not established.

0 indicates that the CONTROL sublink is established.

1 to 15 indicates the negotiated sublink number for each application pair.

Link Names

Name used to represent the type of traffic that flows over a particular sublink:

•CONTROL indicates the sublink used to transport CLAW packing control messages.

•IP indicates the sublink used to send IP datagrams whose TCP checksum is handled by the host.

CKSUM indicates the sublink used to send IP datagrams that use the CMCC checksum assist feature.

Related Commands

Command

Description

claw (primary) (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.

offload (primary) (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 packing stats

To display Common Link Access for Workstations (CLAW) packing statistics, use the show extended channel packing stats command in user EXEC or privileged EXEC mode.

show extended channel slot/portpacking stats[path [device-address]]

Syntax Description

slot

Slot number.

port

Port number.

path

(Optional) Hexadecimal value in the range from 0000 to FFFF. This 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. If not specified, the control unit address and channel logical address default to 0.

device-address

(Optional) Hexadecimal value in the range from 00 to FE. This value is the unit address associated with the control unit number and path as specified in the host input/output configuration program (IOCP) file. For CLAW and offload support, the device address must have an even numbered value.

Command Modes

User EXECPrivileged EXEC

Command History

Release

Modification

12.0

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Examples

The following is sample output from the show extended channel packing stats command:

Device address for each device. One CLAW connection requires two devices. You need only specify the even numbered address.

CLAW Link

Established CLAW link number used for all CLAW packing messages. A number value indicates that a CONTROL sublink is connected. "N" indicates that a control sublink is disconnected.

Read Blks

Number of CLAW channel blocks read.

Write Blks

Number of CLAW channel blocks written.

Linkname

Name used to represent the type of traffic that flows over a particular sublink.

•CONTROL indicates the sublink used to transport CLAW packing control messages.

•IP indicates the sublink used to send IP datagrams whose TCP checksum is handled by the host.

CKSUM indicates the sublink used to send IP datagrams that use the CMCC checksum assist feature.

Packets

Read Write

Total number of packets read and written for each sublink.

Bytes

Read Write

Total number of bytes read and written for each sublink.

Drops

Read Write

Total number of dropped read and write packets for each sublink.

Err

Number of errors. Each error produces an error message at the router console.

C

Connection state of a sublink. "Y" indicates connected. "N" indicates not connected.

Total

Total for each of the recorded statistics.

Related Commands

Command

Description

claw (primary) (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.

offload (primary) (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 statistics

To display statistical information about subchannels on the physical interface of a Cisco Mainframe Channel Connection (CMCC) adapter, use the show extended channel statistics command in user EXEC or privileged EXEC mode. 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.

Syntax Description

slot

Slot number.

port

Port number.

path

(Optional) Hexadecimal value in the range from 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 from 0x00 to 0xFE. This value is the unit address associated with the control unit number and path as specified in the host input/output configuration program (IOCP) file. For Common Link Access for Workstations (CLAW) and offload support, the device address must have an even numbered value.

connected

(Optional) For each backup group, displays information only about the active subchannel or the first subchannel defined in the group if none are active.

Command Modes

User EXECPrivileged EXEC

Command History

Release

Modification

10.2

This command was introduced.

12.0(3)T

Support was added for the CMPC+ feature.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Examples

The following is sample output from the show extended channel statistics command from a CMCC adapter configured with Common Link Access for Workstations (CLAW), offload, cisco systems network architecture (CSNA), and Cisco Multipath Channel (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

D0 4459 4459 0 0 0 0 0

D1 4950 0 0 0 0 0 0

D2 2529 2526 0 0 0 0 0

D3 2600 0 0 0 0 0 0

D9 2211 0 0 0 0 0 0

DA 4048 2024 0 0 0 0 0

Blocks Bytes Dropped Blk Memd

Dev-Lnk Read Write Read Write Read Write wait Con

D0-00 0 0 0 0 0 0 0 Y

D0-01 5017 0 1215457 0 0 0 0 Y

Total: 5017 0 1215457 0 0 0 0

D1-00 0 0 0 0 0 0 0 Y

D1-01 0 5039 0 1247307 0 0 0 Y

Total: 0 5039 0 1247307 0 0 0

D2-00 0 0 0 0 0 0 0 Y

D2-01 0 0 0 0 0 0 0 Y

D2-02 2671 0 661621 0 0 0 0 Y

Total: 2671 0 661621 0 0 0 0

D3-00 0 0 0 0 0 0 0 Y

D3-01 0 0 0 0 0 0 0 Y

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

Path E010

Total: 9712 9933 2001665 2124010 0 0 0

Last statistics 5 seconds old, next in 5 seconds

The following is sample output from the show extended channel statistics command from a CMCC adapter configured with CLAW, offload, cisco systems network architecture (CSNA), and CMPC+:

Address for each device. For CLAW and offload, there are two device addresses. In the configuration statement, you specify only the even numbered 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 the virtual machine (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 ESCON Channel Adapter (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 application program interface (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/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 x 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 virtual telecommunications access method (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 from 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

D1 59530 19800 1 0 0 0 0

D2 1065 252 2 0 0 0 0

D3 1329 16 2 0 0 0 0

D4 1066 251 2 0 0 0 0

D5 887 29 2 0 0 0 0

DA 1073 17 2 0 0 0 373

DB 410 174 2 0 0 0 0

DC 1154 14 2 0 0 0 459

DD 254 17 2 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

Path E200

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.

Configures Systems Network Architecture (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 Cisco Mainframe Channel Connection (CMCC) adapter physical interfaces, use the show extended channel subchannel command in user EXEC or privileged EXEC mode. 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

User EXECPrivileged EXEC

Command History

Release

Modification

10.2

This command was introduced.

12.0(3)T

Support was added for the CMPC+ feature.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Examples

The following is sample output from the show extended channel subchannel connected command used on a CMCC adapter configured for Common Link Access for Workstations (CLAW), offload, and cisco systems network architecture (CSNA):

•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.

Flags (continued)

•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 be set only if the LOADED flag is also set. 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 cyclic redundancy check (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.

•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 +/- 0.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 offline sequence (OLS) state.

•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.

Configures Systems Network Architecture (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 TCP sockets on a channel interface, use the show extended channel tcp-connections command in user EXEC or privileged EXEC mode.

show extended channelslot/porttcp-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.

(Optional) This is the default. Prints a summary of all matching connections.

Command Modes

User EXECPrivileged EXEC

Command History

Release

Modification

11.0

This command was introduced.

12.0(7)T

The stack address field was added to the output.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

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 from 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

10.11.198.2 21 0.0.0.0 0 listen 0 0

10.11.198.2 21 172.18.48.194 38668 establish 62 298

10.11.198.2 23 0.0.0.0 0 listen 0 0

10.11.198.2 23 172.18.48.194 38666 establish 124 11966

10.11.198.2 1025 0.0.0.0 0 listen 0 0

10.11.198.2 1025 172.18.48.194 38705 closeWait 24 1

10.11.198.3 7 0.0.0.0 0 listen 0 0

10.11.198.3 9 0.0.0.0 0 listen 0 0

10.11.198.3 19 0.0.0.0 0 listen 0 0

10.11.198.3 21 0.0.0.0 0 listen 0 0

10.11.198.3 23 0.0.0.0 0 listen 0 0

10.11.198.3 23 172.18.48.194 38667 establish 85 446

The following is 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:

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 Transmission Control Block (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, a reset (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 Simple Network Management Protocol (SNMP) Version 1 Managers, this variable is supplied as a 32-bit value that can wrap 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 that can wrap frequently.

The following is sample output from 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 physical unit (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 Dependent Logical Unit Requestor (DLUR) PU configuration mode.

Command History

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

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 10.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

InErrs : 0 OutRsts : 0

TCP Statistics for IP Address 10.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

InErrs : 0 OutRsts : 0

The following is 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

InErrs : 0 OutRsts : 0

The following is 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:

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 established connections.

OutSegs

Total number of segments sent, including those on current connections but excluding those containing only re-sent octets.

RetransSegs

Total number of segments re-sent—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 reset (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 physical unit (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 Dependent Logical Unit Requestor (DLUR) PU configuration mode.

Syntax Description

(Optional) Operational parameters for the CMPC or CMPC+ Transmission Group (TG) values.

stats

(Optional) Statistical values for the CMPC or CMPC+ TG.

detailed

(Optional) Additional information about the CMPC or CMPC+ TG.

tg-name

(Optional) Name of the TG.

Command Modes

User EXECPrivileged EXEC

Command History

Release

Modification

11.3

This command was introduced.

12.0(3)T

Support was added for the CMPC+ feature.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

The show extended channel tg command is valid only on the virtual channel interface. If the tg-name argument is not specified, information about all TGs configured on the specified interface is displayed.

If neither the oper or stats keyword is specified, operational values are displayed.

Examples

The following is sample output from the show extended channel tg oper command for a CMPC TG:

•Shutdown—CMCC virtual interface is shut down. In this state, all nonconfigurable values will not be displayed and the Logical Link Control (LLC) connection operational values displayed when the detailed keyword is specified also are not displayed.

Identifies the CMCC adapter's internal MAC adapter configured for this CMPC TG. The MAC address configured for this adapter is the local MAC address for the CMPC or CMPC+ TG LLC connection.

RMAC

Remote MAC address configured for the CMPC TG LLC connection.

LSAP

Local service access point (SAP) configured for the CMPC TG LLC connection.

RSAP

Remote SAP configured for the CMPC TG LLC connection.

TGN

TG number for this CMPC TG LLC connection. This value is extracted from the XID3 negotiation exchange.

Local CP

Control point name for virtual telecommunications access method (VTAM). The name is extracted from XID3s received from virtual telecommunications access method (VTAM).

Remote CP

Control point name for the remote node connected by this CMPC TG. The name is extracted from XID3 received from the remote node.

MaxIn

Maximum path information unit (PIU) the remote node is allowed to send to VTAM. The value is the max PIU field in the XID3s received from VTAM.

MaxOut

Maximum PIU VTAM is allowed to send to the remote node. The value is the lowest of the max PIU field in the XID3 received from the remote node, the LF (length field) size in the RIF, and the CMCC virtual interface MTU size.

HPR

Valid values are YES and NO. If HPR is active on this CMPC TG, then the value will display YES.

HPR LSAP

Local SAP value used for HPR traffic. This value will be the same as the configured local service access point (SAP) value.

HPR RSAP

Remote SAP value used for HPR traffic. This value is extracted from the XID3s during the connection negotiation between VTAM and the remote node.

RIF

Routing information field. If the CMPC TG LLC connection is established using source-route bridging, then the RIF used for the connection is displayed here.

The following is sample output on a Cisco 7500 router from the show extended channel tg stats command for a CMPC TG:

•Shutdown—CMCC virtual interface is shut down. In this state, all nonconfigurable values will not be displayed and the connection operational values displayed when the detailed keyword is specified also are not displayed.

•Ready—CMCC virtual interface is operational.

•Unknown—Unknown status.

•Inactive—CMPC+ TG is reset ready to activate.

•Active—CMPC+ TG connection active.

Local IP Address

IP address of the CMCC interface for this TG. This address matches the router's IP address configured on the corresponding TG statement.

Remote IP Address

IP address of the host for this TG. This address matches the host IP address configured on the corresponding TG statement.

Type

Valid IP connection types are:

•TCP/IP—Indicates that the connection is via the TCP/IP stack.

•HSAS IP—Indicates that the connection is via the High Speed Access Services (HSAS) stack.

Local VC Token

CMCC adapter's token for the virtual circuit.

Remote VC Token

Host's token for the virtual circuit.

VC Status

Valid states for the virtual circuit are:

•Reset—Awaiting a connection request from the host or CMCC adapter.

•Active—Virtual circuit active indication was received from the host and the CMCC adapter sent a virtual circuit active indication to the host. The virtual circuit is now ready to send and receive connection requests.

•ConnectionRequestSent—CMCC adapter sent a Connection Request to the host and is waiting a Connection Confirm from the host.

•PendingActive—CMCC adapter is waiting for the host to enable traffic flow on the connection.

•Active—Connection is active and both the CMCC adapter and the host have enabled traffic flow on the connection. At this point, the CMCC adapter has added a static route on the router for the host's IP address. Verify with the show ip route static command.

The following sample shows output on a CMCC adapter from the show extended channel tg stats command for a CMPC+ TG:

Displays information about the MPC+ transmission group connection manager.

show extended channel tn3270-server

To display current server configuration parameters and the status of the physical unit (PU)s defined for the TN3270 server, use the show extended channel tn3270-servercommand in user EXEC or privileged EXEC mode.

show extended channel slot/porttn3270-server

Syntax Description

slot

Specifies a particular Cisco Mainframe Channel Connection (CMCC) adapter in the router where the slot argument is the slot number.

port

Port value for a TN3270 server will always be 2.

Defaults

No default behavior or values

Command Modes

User EXECPrivileged EXEC

Command History

Release

Modification

11.2

This command was introduced.

12.0(5)T

The following fields were added to the output display:

•lu-termination

•lu-deletion

12.2

The Named value was added for the lu-deletion field in the output display.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Examples

The following is sample output from the show extended channel tn3270-server command:

Router# show extended channel 3/2 tn3270-server

<current stats> < connection stats > <response time(ms)>

server-ip:tcp lu in-use connect disconn fail host tcp

172.28.1.106:23 510 1 12 11 0 54 40

172.28.1.107:23 511 0 0 0 0 0 0

172.28.1.108:23 255 0 0 0 0 0 0

total 1276 1

configured max_lu 20000 unbind-action disconnect

idle-time 0 keepalive 1800 (send nop)

tcp-port 23 generic-pool permit no timing-mark

lu-termination unbind lu-deletion never

dlur MPX.GOANCP status SHUT

dlus MPX.NGMVMPC

name(index) ip:tcp xid state link destination r-lsap

EXT2(1) 172.28.1.106:23 05D18092 ACTIVE tok 0 4000.7470.00e7 08 04

PUS10(2) 172.28.1.107:23 05D19010 ACTIVE tok 0 4000.7470.00e7 08 2C

PUS11(3) 172.28.1.107:23 05D19011 ACTIVE tok 0 4000.7470.00e7 08 28

PUS12(4) 172.28.1.108:23 05D19012 ACTIVE tok 0 4000.7470.00e7 08 24

PUS9(5) 172.28.1.109:23 05D18509 SHUT tok 0 4001.3745.1088 04 40

SDTF(7) 172.28.1.107:23 12345678 ACTIVE tok 0 0800.5a4b.1cbc 04 08

TEST(8) 172.28.1.106:23 05D18091 ACTIVE tok 0 4000.7470.00e7 08 30

INT1(6) 172.28.1.106:23 05D18091 SHUT dlur

Table 54 describes the significant fields in the display. Those fields not described correspond to configured values.

Table 54 show extended channel tn3270-server Field Descriptions

Field

Description

server

IP address and TCP port number, listen point, configured on one or more PUs.

lu

Total number of logical unit (LU)s available for this listen point.

in-use

Number of LUs in use.

connect

Total number of connections since the TN3270 feature was started.

disconn

Total number of disconnects since the TN3270 feature was started.

fail

Total number of failed connections since the TN3270 feature was started.

response time, host

The average response time from the host across all sessions through this server IP address. This is measured from sending Carrier Detect (CD) to the host to receiving the reply.

response time, tcp

Average response time from the clients on this server IP address. This is measured only when TIMING MARKs are sent. If no timing-mark is configured, they are sent only on special occasions, such as Bind.

idle-time number

Configured idle-time for this physical unit (PU).

keepalive

Configured keepalive time for this PU. action is one of the following:

•send nop—The Telnet command for no operation is sent to the TN3270 client to verify the physical connection.

•send timing marknumber—Number of seconds within which the TN3270 server expects a response to the DO TIMING-MARK from the TN3270 client.

unbind-action

Configured unbind action for LUs on this PU.

tcp-port

Configured TCP port number.

generic-pool

Configured generic pool for LUs on this PU.

lu-termination

Displays the value configured for the lu termination siftdown command for the PUs supported by the TN3270 server. The lu termination command specifies whether a TERMSELF or UNBIND request/response unit (RU) is sent by the TN3270 server when a client turns off the device or disconnects. The values are:

•termself—Termination of all sessions and session requests associated with an LU is ordered upon disconnect.

•unbind—Termination of the session by the application is requested upon LU disconnect.

lu-deletion

Displays the value configured for the lu deletion siftdown command for the PUs supported by the TN3270 server. The lu deletion command specifies whether the TN3270 server sends a REPLY-PSID poweroff request to virtual telecommunications access method (VTAM) to delete the corresponding LU when a client disconnects. The values are:

•always—Dynamic LUs for this PU are always deleted upon disconnect.

•named—Only named LUs for this PU are deleted upon disconnect.

•normal—Only screen LUs for this PU are deleted upon disconnect.

•non-generic—Only specified LUs for this PU are deleted upon disconnect.

Syntax Description

slot

Slot number.

port

Port number.

ip-address

IP address of the client.

disconnected

(Optional) Displays all clients with the ip-address argument in disconnected state. Disconnected state refers to an logical unit (LU) session state of ACTIVE or INACTIVE. In this case, the ip-address argumentrefers to the client that last used the LU.

in-session

(Optional) Displays all clients with the ip-address argument in active session state. Active session state refers to an LU session state of ACT/SESS.

pending

(Optional) Displays all clients with the ip-address argument in pending state. Pending session state refers to an LU session state of P-SDT, P-ACTLU, P-NTF/AV, P-NTF/UA, P-RESET, P-PSID, P-BIND, P-UNBIND, WT-UNBND, WT-SDT, or UNKNOWN.

Command Modes

User EXECPrivileged EXEC

Command History

Release

Modification

11.2

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

The show extended channel tn3270-server client-ip-address command is valid only on the virtual channel interface. Note that this command does not display information about LUs that have never been connected.

Examples

The following is sample output from the show extended channel tn3270-server client-ip-address command. The example shows only active sessions because no other session types exist at this client IP address.

If the physical unit (PU) is directly connected, then the name shown is the one generated by the seed. If LU, then only the unqualified portion is shown. The network entity title (NET) ID portion will be the same as the current Dependent Logical Unit Server (DLUS)

client-ip:tcp

Client's IP address and TCP port number.

nail

Status of LU nailing, either Y or N.

state

LU state values and their meanings are:

•UNKNOWN—LU in an undefined state.

•INACTIVE—LU did not receive activate logical unit (ACTLU).

•ACT/NA—LU received ACTLU and acknowledged positively.

•P-SDT—LU is bound but there is no Structured Data Transfer (SDT) yet.

state (continued)

•ACT/SESS—LU is bound and in session.

•P-ACTLU—Telnet connects in and is waiting for ACTLU.

•P-NTF/AV—Awaiting host notify-available response.

•P-NTF/UA—Awaiting host notify-unavailable response.

•P-RESET—Awaiting a buffer to send Deactivate LU (DACTLU) response.

•P-PSID—Awaiting NMVT Reply PSID response.

•P-BIND—Waiting for host to send bind.

•P-UNBIND—Awaiting host unbind response.

•WT-UNBND—Waiting for client to acknowledge disconnection.

•WT-SDT—Waiting for client to acknowledge SDT.

model

IBM 3278 model type of client; blank if Static LU.

frames in

Number of frames sent inbound to the host.

frames out

Number of frames sent outbound from the host.

idle for

Time the client has been idle. The time is in HH:MM:SS.

pu is

Name of the PU.

lu is

Whether LU is DYNAMIC or STATIC.

negotiated

Whether client is TN3270 or TN3270E.

bytes in/out

Total number of bytes sent to and received from the host.

RuSize in/out

Request/response unit (RU) size as configured in the bind.

NegRsp in/out

Number of Systems Network Architecture (SNA) negative responses sent to and received from the host.

pacing window in/out

SNA pacing window as configured in the bind.

credits in

Number of frames that can be sent inbound without requiring an isolated pacing response.

queue size in

Indicates the number of SNA frames waiting to be sent to the host that are blocked and are waiting for a pacing response.

queue-size out

SNA frames not yet acknowledged by an isolated pacing response by the TN3270 server.

Related Commands

Command

Description

client ip lu

Defines a specific LU or range of LUs to a client at the IP address or subnet.

show extended channel tn3270-server client-name

To display information about all connected clients with a specific machine name, use the show extended channeltn3270-server client-name command in user EXEC or privileged EXEC mode.

show extended channelslot/virtual-channeltn3270-server client-name name

Syntax Description

slot

Specifies a particular Cisco Mainframe Channel Connection (CMCC) adapter in the router where the slot argument is the slot number.

virtual-channel

Virtual channel number.

name

Specifies the client machine name. This name is specified originally in the client pool command.

Defaults

No default behavior or values

Command Modes

User EXECPrivileged EXEC

Command History

Release

Modification

12.1(5)T

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

There is not a no form for this command.

Examples

The following is sample output from the show extended channeltn3270-server client-name command:

If the physical unit (PU) is directly connected, then the name shown is the one generated by the seed. If LU, then only the unqualified portion is shown. The network entity title (NET) ID portion will be the same as the current Dependent Logical Unit Server (DLUS)

client-name

Client's machine name.

nail

Status of LU nailing, either Y or N.

state

LU state values and their meanings are:

•UNKNOWN—LU in an undefined state.

•INACTIVE—LU did not receive activate logical unit (ACTLU).

•ACT/NA—LU received ACTLU and acknowledged positively.

•P-SDT—LU is bound but there is no Structured Data Transfer (SDT) yet.

•ACT/SESS—LU is bound and in session.

•P-ACTLU—Telnet connects in and is waiting for ACTLU.

•P-NTF/AV—Awaiting host notify-available response.

•P-NTF/UA—Awaiting host notify-unavailable response.

•P-RESET—Awaiting a buffer to send Deactivate LU (DACTLU) response.

•P-PSID—Awaiting NMVT Reply PSID response.

•P-BIND—Waiting for host to send bind.

•P-UNBIND—Awaiting host unbind response.

•WT-UNBND—Waiting for client to acknowledge disconnection.

•WT-SDT—Waiting for client to acknowledge SDT.

model

IBM 3278 model type of client; blank if Static LU.

frames in

Number of frames sent inbound to the host.

frames out

Number of frames sent outbound from the host.

idle for

Time the client has been idle. The time is in HH:MM:SS.

pu is

Name of the PU.

lu is

Whether LU is DYNAMIC or STATIC.

negotiated

Whether client is TN3270 or TN3270E.

bytes in/out

Total number of bytes sent to and received from the host.

RuSize in/out

Request/response unit (RU) size as configured in the bind.

NegRsp in/out

Number of Systems Network Architecture (SNA) negative responses sent to and received from the host.

pacing window in/out

SNA pacing window as configured in the bind.

credits in

Number of frames that can be sent inbound without requiring an isolated pacing response.

queue size in

Indicates the number of SNA frames waiting to be sent to the host that are blocked and are waiting for a pacing response.

response time buckets

Number of transactions in each response-time "bucket" for the specified LU. The bucket boundaries are defined using the response-time group command.

average total response time

Average response time (in tenths of seconds) for the total number of response-time transactions.

average IP response time

Average IP transit response time (in tenths of seconds) for the total number of response-time transactions.

number of transactions

Total number of response-time transactions across all response-time buckets.

show extended channel tn3270-server dlur

To display information about the Systems Network Architecture (SNA) session switch, use the show extended channel tn3270-server dlurcommand in user EXEC or privileged EXEC mode.

show extended channel slot/porttn3270-server dlur

Syntax Description

slot

Slot number.

port

Port number.

Command Modes

User EXECPrivileged EXEC

Command History

Release

Modification

11.2

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Fully qualified control point (CP) name used by the SNA session switch and the logical unit (LU) name for the Dependent Logical Unit Requestor (DLUR) function configured as the fully qualified CP named on the dlur statement.

current dlus

Name of the active Dependent Logical Unit Server (DLUS), either the primary DLUS or the backup DLUS.

Transmission group (TG) number for this link. Because the SNA session switch supports only one TG per pair of CP names, it is typically 0 or 1.

maxdata

Maximum frame size allowed on this link.

Related Commands

Command

Description

client pool

Nails clients to pools.

show extended channel tn3270-server nailed-domain

To list all nailing statements with a specific nailed-domain name, use the show extended channeltn3270-servernailed-domain command in user EXEC or privileged EXEC mode.

show extended channelslot/virtual-channeltn3270-servernailed-domain name

Syntax Description

slot

Specifies a particular Cisco Mainframe Channel Connection (CMCC) adapter in the router where the slot argument is the slot number.

virtual-channel

Virtual channel number.

name

Specifies the exact nailed-domain name, as specified originally in the client pool command. Output is displayed for the nailed-domain name exactly as specified. That is, specifying "cisco.com" is different from specifying ".cisco.com."

Defaults

No default behavior or values

Command Modes

User EXECPrivileged EXEC

Command History

Release

Modification

12.1(5)T

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

There is not a no form for this command.

Examples

The following is sample output from the show extended channeltn3270-server nailed-domain command:

LU local address range showing the first local address and last local address. There need not be a last local address if only a single local address rather than a range is configured.

printer

Type of device being nailed to the local addresses. If printer is specified, only clients that are printers are nailed to the local addresss. If screen is specified, only clients that are screens are nailed to the local addresss. If neither is specified, both screens and printers can use the local addresss. A printer client is any client with a device type of "328*". A screen client is a client with any other device type.

show extended channel tn3270-server nailed-name

To list all nailing statements with a specific nailed machine name, use the show extended channeltn3270-servernailed-name command in user EXEC or privileged EXEC mode.

show extended channelslot/virtual-channeltn3270-server nailed-name name

Syntax Description

slot

Specifies a particular Cisco Mainframe Channel Connection (CMCC) adapter in the router where the slot argument is the slot number.

virtual-channel

Virtual channel number.

name

Specifies the nailed machine name. This name is specified originally in the client pool command.

Defaults

No default behavior or values

Command Modes

User EXECPrivileged EXEC

Command History

Release

Modification

12.1(5)T

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Examples

The following is sample output from the show extended channeltn3270-server nailed-name command:

Listen point IP address under which the clientpool command was configured.

pool

Pool name to which the client is nailed.

show extended channel tn3270-server pu

To display configuration parameters for a physical unit (PU) and all the logical unit (LU)s attached to the PU, including the logical unit (LU) cluster layout and pool name, use the show extended channel tn3270-server pu command in user EXEC or privileged EXEC mode.

Syntax Description

Specifies a particular Cisco Mainframe Channel Connection (CMCC) adapter in the router where the slot argument is the slot number.

virtual-channel

Virtual channel number.

pu-name

Name that uniquely identifies this PU.

cluster

(Optional) Displays cluster information for the LUs within the pool.

client-name

(Optional) Displays client name information for the LUs within the pool.

Defaults

No default behavior or values

Command Modes

User EXECPrivileged EXEC

Command History

Release

Modification

11.2

This command was introduced.

11.2(2.1)

ACT/NA replaced ACTIVE status for logical unit (LU) states. A note was added to the output to describe its meaning.

11.2(18)BC

The cluster keyword was added.

12.0(5)T

The following fields were added to the output display:

•lu-termination

•lu-deletion

12.1(5)T

The client-name keyword was added.

12.2

The named value was added for the lu-deletion field in the output display.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

The show extended channel tn3270-server pu command is valid only on the virtual channel interface. The display shown depends on whether the PU is a direct PU or a Systems Network Architecture (SNA) session switch PU.

The output from the show extended channel tn3270-server pu command varies based on use of the optional cluster keyword. Without the cluster keyword, the output column headings for the LU information appear as "model," "frames in out," and "idle for."

When you use the cluster keyword, the output column headings for the LU information appear as "cluster," "pool," and "count." The cluster heading lists the specific cluster within the pool to which the LU belongs, along with the specific cluster layout after the slash.

The pool heading identifies the corresponding pool name, and the count heading identifies the cluster number out of the total number of clusters in the pool.

There is not a no form for this command.

Examples

The following example shows a sample router configuration and the corresponding output using the show extended channel tn3270-server pu command:

interface Channel6/1

no ip address

no keepalive

csna E160 40

!

interface Channel6/2

ip address 172.18.4.17 255.255.255.248

no keepalive

lan TokenRing 15

source-bridge 15 1 500

adapter 15 4000.b0ca.0015

lan TokenRing 16

source-bridge 16 1 500

adapter 16 4000.b0ca.0016

tn3270-server

pool PCPOOL cluster layout 4s1p

pool SIMPLE cluster layout 1a

pool UNIXPOOL cluster layout 49s1p

dlur NETA.SHEK NETA.MVSD

lsap token-adapter 15 04

link SHE1 rmac 4000.b0ca.0016

listen-point 172.18.4.18 tcp-port 23

pu PU1 91903315 dlur

allocate lu 1 pool PCPOOL clusters 10

allocate lu 51 pool UNIXPOOL clusters 2

allocate lu 200 pool SIMPLE clusters 50

listen-point 172.18.4.19 tcp-port 2023

pu PU2 91913315 token-adapter 16 08

allocate lu 1 pool UNIXPOOL clusters 2

allocate lu 101 pool SIMPLE clusters 100

allocate lu 201 pool PCPOOL clusters 10

The following sample output from the show extended channel tn3270-server pu command without the cluster keyword for a PU named PU1:

The following is sample output from the show extended channel tn3270-server pu command with the cluster keyword for a PU named PU1. In the example, 1/1a identifies cluster 1 with a layout of 1a, which contains one LU of any type.

Note If the cluster layout is very long, only the first eight bytes are displayed under the cluster column. The pool called: GENERIC is shown for all LUs that are not allocated to any specific pool name.

The following is sample output from the show extended channel tn3270-server pu command with the client-name keyword for a PU named JADOEPU:

LINK type is either internal adapter type and internal adapter number, or dlur if it is an SNA Session Switch PU.

destination

If a direct PU, then it is the destination MAC address; otherwise, it is the name of the partner PU.

r-lsap

Remote and local service access point (SAP) values.

idle-time

Configured idle time for this PU.

keepalive

Configured keepalive time for this PU. The action is one of the following:

•send nop—The Telnet command for no operation is sent to the TN3270 client to verify the physical connection.

•send timing marknumber—Number of seconds within which the TN3270 server expects a response to the DO TIMING-MARK from the TN3270 client.

unbind-act

Configured unbind action for LUs on this PU.

generic-pool

Configured generic pool for LUs on this PU.

ip-preced-screen

IP precedence value for screen LUs on this PU.

ip-preced-printer

IP precedence value for printer LUs on this PU.

ip-tos-screen number

IP type of service (ToS) value for screen LUs on this PU.

ip-tos-printer number

IP ToS value for printer LUs on this PU.

lu-termination

Value configured in the PU for the lu termination siftdown command. The lu termination command specifies whether a TERMSELF or UNBIND request/response unit (RU) is sent by the TN3270 server when a client turns off the device or disconnects. The values are:

•termself—Termination of all sessions and session requests associated with an LU is ordered upon disconnect.

•unbind—Termination of the session by the application is requested upon LU disconnect.

lu-deletion

Value configured in the PU for the lu deletion siftdown command. The lu deletion command specifies whether the TN3270 server sends a REPLY-PSID poweroff request to virtual telecommunications access method (VTAM) to delete the corresponding LU when a client disconnects. The values are:

•always—Dynamic LUs for this PU are always deleted upon disconnect.

•named—Only named LUs for this PU are deleted upon disconnect.

•normal—Only screen LUs for this PU are deleted upon disconnect.

•non-generic—Only specified LUs for this PU are deleted upon disconnect.

•never—None of the LUs for this PU are ever deleted upon disconnect.

bytes in/out

Total number of bytes sent to or received from the host for this PU.

frames in/out

Total number of frames sent to or received from the host for this PU.

NegRsp in/out

Total number of SNA negative responses sent to or received from the host.

actlus

Total number of ACTLUs received from the host.

dactlus

Total number of DACTLUs received from the host.

binds

Total number of BINDs received from the host.

lu

Local address of the LU.

name

Name of the TN3270 LU.

client-name

Client's IP address and TCP port number.

nail

Status of LU nailing, either Y or N

state

LU state values and their meanings:

•UNKNOWN—LU in an undefined state.

•INACTIVE—LU did not receive activate logical unit (ACTLU).

•ACT/NA—LU received ACTLU and acknowledged positively. If a client IP address is shown, then the client is disconnected.

•P-SDT—LU is bound but there is no Structured Data Transfer (SDT) yet.

•ACT/SESS—LU is bound and in session.

•P-ACTLU—Telnet has connected and is awaiting ACTLU.

•P-NTF/av—Awaiting host notify-available response.

•P-NTF/UA—Awaiting host notify-unavailable response.

•P-RESET—Waiting for a buffer to send Deactivate LU (DACTLU) response.

•P-PSID—Waiting for NMVT Reply psid response.

•P-BIND—Waiting for host to send bind.

•P-UNBIND—Awaiting host unbind response.

•WT-UNBND—Waiting for client to acknowledge disconnection.

•WT-SDT—Waiting for client to acknowledge SDT.

model

IBM 3278 model type of client.

frames in

Number of frames sent inbound to the host.

frames out

Number of frames sent outbound from the host.

idle for

Time the client has been idle. The time is in HH:MM:SS.

client-ip

Remote client IP address.

mask

Current network mask.

nail-type

LU nailing type, screen or printer.

lu-first

First LU address in the range.

lu-last

Last LU address in the range, if one is specified in the client configuration command.

client-name

Client machine name or domain name.

nail-type

LU nailing type, screen or printer.

lu-first

First LU address in the range.

lu-last

Last LU address in the range, if one is specified in the client configuration command.

Related Commands

Command

Description

allocate lu

Assigns LUs to a pool.

pu dlur (listen-point)

Creates a PU entity that has no direct link to a host and enters listen-point PU configuration mode.

pu (listen-point)

Creates a PU entity that has a direct link to a host and enters listen-point PU configuration mode.

Syntax Description

(Optional) Display only the client group corresponding to the virtual telecommunications access method (VTAM) application name.

detail

(Optional) List client members and their response-time statistics following the client group entry.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release

Modification

11.2(18)BC

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

If optional keywords are not used for the show extended channel tn3270-server response-time application command, a complete list of existing per-application client groups is displayed along with their collection control parameters. If you specify the appl-name argument, only the client group corresponding to that application is displayed. If you specify the detail keyword, the client group entry is followed by a list of its client members and their response-time statistics.

Examples

The following is sample output from the show extended channel tn3270-server response-time application command:

Note The aggregate, excludeip, and dynamic definite response field values are MIB parameters that are configured automatically by the TN3270 server according to the type of response-time group. These values are not configurable in the TN3270 server.

Displays whether the response time statistics for the clients in this response-time group are reported collectively for the group (YES) or individually by client (NO). This value is automatically set to NO by the TN3270 server for application client response-time groups.

excludeip

Displays whether the IP component (the client/server path) is included in the response time for any transaction (NO) or if only the Systems Network Architecture (SNA) component (the server/host path) is included in the response time for any transaction (YES). This value is automatically set to NO by the TN3270 server for application client response-time groups.

dynamic definite response

Displays whether the server adds a Definite Response request to the first-in-chain (FIC) reply in each transaction, to get a response from the client so that the IP component can be included in the response time. The value is automatically set to NO by the TN3270 server for all types of response-time groups.

sample period multiplier

Displays the number that is multiplied by an interval of 20 seconds to determine the collection interval for the response-time group. The multiplier value is defined using the response-time group command. For example, a sample period multiplier of 30 results in a collection interval of 600 seconds (30 x 20 seconds), or 10 minutes, for this client group.

response time buckets

Displays the number of transactions in each response-time "bucket" for the specified application group. The bucket boundaries are defined using the response-time group command.

average total response time

Displays the average response time (in tenths of seconds) for the total number of response-time transactions.

average IP response time

Displays the average response time in tenths of seconds (including IP transit time) for the total number of response-time transactions.

number of transactions

Displays the total number of response-time transactions across all response-time buckets.

Related Commands

Command

Description

response-time group

Configures a client subnet group for response-time measurements.

show extended channel tn3270-server response-time global

Displays information about the global response-time client group.

show extended channel tn3270-server response-time link

Displays information about host link response-time client groups.

show extended channel tn3270-server response-time listen-point

Displays information about listen point response-time client groups.

show extended channel tn3270-server response-time subnet

Displays information about Subnet response-time client groups.

show extended channel tn3270-server response-time global

To display collection control parameters for the global client group, use the show extended channel tn3270-server response-time global command in privileged EXEC mode.

Note The aggregate, excludeip, and dynamic definite response field values are MIB parameters that are configured automatically by the TN3270 server according to the type of response-time group. These values are not configurable in the TN3270 server.

Displays whether the response time statistics for the clients in this response-time group are reported collectively for the group (YES) or individually by client (NO). This value is automatically set to YES by the TN3270 server for global client response-time groups.

excludeip

Displays whether the IP component (the client/server path) is included in the response time for any transaction (NO) or if only the Systems Network Architecture (SNA) component (the server/host path) is included in the response time for any transaction (YES). This value is automatically set to NO by the TN3270 server for global client response-time groups.

dynamic definite response

Displays whether the server adds a Definite Response request to the first-in-chain (FIC) reply in each transaction, to get a response from the client so that the IP component can be included in the response time. The value is automatically set to NO by the TN3270 server for all types of response-time groups.

sample period multiplier

Displays the number that is multiplied by an interval of 20 seconds to determine the collection interval for the response-time group. The multiplier value is defined using the response-time group command. For example, a sample period multiplier of 30 results in a collection interval of 600 seconds (30 x 20 seconds), or 10 minutes, for this client group.

bucket boundaries

Displays the value of the response-time bucket boundaries in tenths of seconds. The bucket boundaries are defined using the response-time group command.

buckets

Displays the number of transactions in each response-time bucket for the specified application group.

average total response time

Displays the average response time (in tenths of seconds) for the total number of response-time transactions.

average IP response time

Displays the average response time in tenths of seconds (including IP transit time) for the total number of response-time transactions.

number of transactions

Displays the total number of response-time transactions across all response-time buckets.

Syntax Description

(Optional) physical unit (PU) name for a direct PU or link name for a Dependent Logical Unit Requestor (DLUR) PU.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release

Modification

11.2(18)BC

This command was first introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

This command displays information clients groups by host link. If no optional arguments are specified, a complete list of existing client groups by host link is displayed along with their collection control parameters and aggregate response-time statistics. If a value for the link-name argument is specified, only the client group corresponding to that link is displayed.

Examples

The following is sample output from the show extended channel tn3270-server response-time link command without optional arguments. It shows all client groups by host link:

Router# show extended channel 3/2 tn3270-server response-time link

group DIRECT LINK MYLINK

aggregate YES excludeip YES dynamic definite response NO

sample period multiplier 30

bucket boundaries 10 20 50 100

buckets 10 18 21 10 10

average total response time 37 average IP response time 23

number of transactions 69

group DLUR LINK HISLINK

aggregate YES excludeip YES dynamic definite response NO

sample period multiplier 30

bucket boundaries 10 20 50 100

buckets 14 31 15 3 1

average total response time 19 average IP response time 8

number of transactions 64

The following is sample output from the show extended channel tn3270-server response-time link command for the link named Direct link mylink:

Note The aggregate, excludeip, and dynamic definite response field values are MIB parameters that are configured automatically by the TN3270 server according to the type of response-time group. These values are not configurable in the TN3270 server.

Displays whether the response time statistics for the clients in this response-time group are reported collectively for the group (YES) or individually by client (NO). This value is automatically set to YES by the TN3270 server for link client response-time groups.

excludeip

Displays whether the IP component (the client/server path) is included in the response time for any transaction (NO) or if only the Systems Network Architecture (SNA) component (the server/host path) is included in the response time for any transaction (YES). This value is automatically set to YES by the TN3270 server for link client response-time groups.

dynamic definite response

Displays whether the server adds a Definite Response request to the first-in-chain (FIC) reply in each transaction, to get a response from the client so that the IP component can be included in the response time. The value is automatically set to NO by the TN3270 server for all types of response-time groups.

sample period multiplier

Displays the number that is multiplied by an interval of 20 seconds to determine the collection interval for the response-time group. The multiplier value is defined using the response-time group command. For example, a sample period multiplier of 30 results in a collection interval of 600 seconds (30 x 20 seconds), or 10 minutes, for this client group.

bucket boundaries

Displays the value of the response-time bucket boundaries in tenths of seconds. The bucket boundaries are defined using the response-time group command.

buckets

Displays the number of transactions in each response-time bucket for the specified application group.

average total response time

Displays the average response time (in tenths of seconds) for the total number of response-time transactions.

average IP response time

Displays the average response time in tenths of seconds (including IP transit time) for the total number of response-time transactions.

number of transactions

Displays the total number of response-time transactions across all response-time buckets.

Related Commands

Command

Description

response-time group

Configures a client subnet group for response-time measurements.

show extended channel tn3270-server response-time application

Displays information about application response-time client groups.

show extended channel tn3270-server response-time global

Displays information about the global response-time client group.

show extended channel tn3270-server response-time listen-point

Displays information about listen point response-time client groups.

show extended channel tn3270-server response-time subnet

Displays information about Subnet response-time client groups.

show extended channel tn3270-server response-time listen-point

To display information about listen-point client groups, use the show extended channel tn3270-server response-time listen-point command in privileged EXEC mode.

Command Modes

Command History

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

The show extended channel tn3270-server response-time listen-point command displays information about groups of clients summarized by listen point. A complete list of currently existing listen-point client groups is displayed along with their collection control parameters and aggregate response-time statistics.

Examples

The following is sample output from the show extended channel tn3270-server response-time listen-point command:

Note The aggregate, excludeip, and dynamic definite response field values are MIB parameters that are configured automatically by the TN3270 server according to the type of response-time group. These values are not configurable in the TN3270 server.

Displays whether the response time statistics for the clients in this response-time group are reported collectively for the group (YES) or individually by client (NO). This value is automatically set to YES by the TN3270 server for link client response-time groups.

excludeip

Displays whether the IP component (the client/server path) is included in the response time for any transaction (NO) or if only the Systems Network Architecture (SNA) component (the server/host path) is included in the response time for any transaction (YES). This value is automatically set to NO by the TN3270 server for link client response-time groups.

dynamic definite response

Displays whether the server adds a Definite Response request to the first-in-chain (FIC) reply in each transaction, to get a response from the client so that the IP component can be included in the response time. The value is automatically set to NO by the TN3270 server for all types of response-time groups.

sample period multiplier

Displays the number that is multiplied by an interval of 20 seconds to determine the collection interval for the response-time group. The multiplier value is defined using the response-time group command. For example, a sample period multiplier of 30 results in a collection interval of 600 seconds (30 x 20 seconds), or 10 minutes, for this client group.

bucket boundaries

Displays the value of the response-time bucket boundaries in tenths of seconds. The bucket boundaries are defined using the response-time group command.

buckets

Displays the number of transactions in each response-time bucket for the specified application group.

average total response time

Displays the average response time (in tenths of seconds) for the total number of response-time transactions.

average IP response time

Displays the average response time in tenths of seconds (including IP transit time) for the total number of response-time transactions.

number of transactions

Displays the total number of response-time transactions across all response-time buckets.

Related Commands

Command

Description

response-time group

Configures a client subnet group for response-time measurements.

show extended channel tn3270-server response-time application

Displays information about application response-time client groups.

show extended channel tn3270-server response-time global

Displays information about the global response-time client group.

show extended channel tn3270-server response-time link

Displays information about host link response-time client groups.

show extended channel tn3270-server response-time subnet

Displays information about Subnet response-time client groups.

show extended channel tn3270-server response-time subnet

To display information about subnet client groups, use the show extended channel tn3270-server response-time subnet command in privileged EXEC mode.

Syntax Description

(Optional) Each client group entry is followed by a list of its client members and their respective response-time statistics.

Defaults

No default behavior or values

Command Modes

Privileged EXEC

Command History

Release

Modification

11.2(18)BC

This command was first introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

This command displays information about client subnet client groups. This includes all configured groups and the CLIENT SUBNET OTHER group. If no optional parameters are specified, a complete list of client subnet client groups is displayed along with their collection control parameters. If you specify values for the ip-address keyword and ip-mask argument, only client groups containing that subnet are displayed. If you specify the detail keyword, each client group entry is followed by a list of its client members and their response-time statistics.

Examples

The following is sample output from all configured client groups using the show extended channel tn3270-server response-time subnet command:

Router# show extended channel 3/2 tn3270-server response-time subnet

group SUBNETGROUP1

subnet 10.10.10.0 255.255.255.192

aggregate NO excludeip NO dynamic definite response NO

sample period multiplier 30

bucket boundaries 10 20 50 100

group SUBNETGROUP2

subnet 10.10.10.128 255.255.255.192

subnet 10.10.10.192 255.255.255.192

aggregate NO exclude ip NO dynamic definite response NO

sample period multiplier 40

bucket boundaries 20 30 60 120

group CLIENT SUBNET OTHER

aggregate NO exclude ip NO dynamic definite response NO

sample period multiplier 30

bucket boundaries 10 20 50 100

The following is sample output from subnet 10.10.10.0 with IP mask 255.255.255.192, which shows a list of the client members and their response-time statistics:

Note The aggregate, excludeip, and dynamic definite response field values are MIB parameters that are configured automatically by the TN3270 server according to the type of response-time group. These values are not configurable in the TN3270 server.

Displays the IP address and IP mask of the client subnet group for which response-time statistics are being shown.

aggregate

Displays whether the response time statistics for the clients in this response-time group are reported collectively for the group (YES) or individually by client (NO). This value is automatically set to NO by the TN3270 server for subnet client response-time groups.

excludeip

Displays whether the IP component (the client/server path) is included in the response time for any transaction (NO) or if only the Systems Network Architecture (SNA) component (the server/host path) is included in the response time for any transaction (YES). This value is automatically set to NO by the TN3270 server for subnet client response-time groups.

dynamic definite response

Displays whether the server adds a Definite Response request to the first-in-chain (FIC) reply in each transaction, to get a response from the client so that the IP component can be included in the response time. The value is automatically set to NO by the TN3270 server for all types of response-time groups.

sample period multiplier

Displays the number that is multiplied by an interval of 20 seconds to determine the collection interval for the response-time group. The multiplier value is defined using the response-time group command. For example, a sample period multiplier of 30 results in a collection interval of 600 seconds (30 x 20 seconds), or 10 minutes, for this client group.

bucket boundaries

Displays the value of the response-time bucket boundaries in tenths of seconds. The bucket boundaries are defined using the response-time group command.

buckets

Displays the number of transactions in each response-time bucket for the specified application group.

average total response time

Displays the average response time (in tenths of seconds) for the total number of response-time transactions.

average IP response time

Displays the average response time in tenths of seconds (including IP transit time) for the total number of response-time transactions.

number of transactions

Displays the total number of response-time transactions across all response-time buckets.

Related Commands

Command

Description

response-time group

Configures a client subnet group for response-time measurements.

show extended channel tn3270-server response-time application

Displays information about application response-time client groups.

show extended channel tn3270-server response-time global

Displays information about the global response-time client group.

show extended channel tn3270-server response-time link

Displays information about host link response-time client groups.

show extended channel tn3270-server response-time listen-point

Displays information about listen point response-time client groups.

show extended channel tn3270-server security

To display information about the TN3270 security enhancement, use the show extended channel tn3270-server security command in user EXEC or privileged EXEC mode.

Syntax Description

slot

Specifies a particular Cisco Mainframe Channel Connection (CMCC) adapter in the router where the slot argument is the slot number.

virtual-channel

Virtual channel number.

sec-profile profilename

(Optional) Alphanumeric name that specifies the security profile name to be associated with a listen point. The character range is from 1 to 24. This name is specified originally in the profile command.

listen-pointip-address

(Optional) IP address that the clients should use as the host IP address to map to logical unit (LU) sessions under this physical unit (PU) and listen point.

tcp-port number

(Optional) Port number used for the listen operation. The default value is 23.

Defaults

The default tcp-port value is 23.

Command Modes

User EXECPrivileged EXEC

Command History

Release

Modification

12.1(5)T

This command was introduced.

12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(33)SRA.

12.2SX

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

There is not a no form for this command.

Examples

The following is sample output from the show extended channel tn3270-server security command with the optional sec-profile keyword configured:

Command Modes

Command History

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

Usage Guidelines

The show extended channel udp-listenerscommand is valid on both physical and virtual channel interfaces.

Examples

The following is sample output from the show extended channel udp-listenerscommand:

Router# show extended channel 0/1 udp-listeners

UDP Listener: IP Address 10.11.198.3 LocalPort 7

UDP Listener: IP Address 10.11.198.3 LocalPort 9

UDP Listener: IP Address 10.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 Dependent Logical Unit Requestor (DLUR) PU configuration mode.

Command History

This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.

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 o1 udp-stack

UDP Statistics for IP Address 10.11.198.2

InDatagrams : 6 NoPorts : 6

InErrors : 0 OutDatagrams: 0

UDP Statistics for IP Address 10.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:

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 physical unit (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 Dependent Logical Unit Requestor (DLUR) PU configuration mode.