-
Bridging and IBM Networking Command Reference
-
About The Cisco IOS Software Documentation
- Part 1: Bridging
-
Part 2: IBM Networking
-
Remote Source-Route Bridging Commands
-
DLSw+ Commands
-
STUN and BSTUN Commands
-
LLC2 and SDLC Commands
-
IBM Network Media Translation Commands
-
DSPU and SNA Service Point Support Commands
-
SNA Frame Relay Access Support Commands
-
APPN Configuration Commands
-
NCIA Server Configuration Commands
-
IBM Channel Attach Commands
-
Appendix - Ethernet Type Codes
-
-
Table Of Contents
show extended channel connection-map llc2
show extended channel icmp-stack
show extended channel ip-stack
show extended channel max-llc2-sessions
show extended channel statistics
show extended channel subchannel
show extended channel tcp-connections
show extended channel tcp-stack
show extended channel tn3270-server
show extended channel tn3270-server client-ip-address
show extended channel tn3270-server dlur
show extended channel tn3270-server dlurlink
show extended channel tn3270-server nailed-ip
show extended channel tn3270-server pu
show extended channel tn3270-server pu lu
show extended channel udp-listeners
show extended channel udp-stack
IBM Channel Attach Commands
Use the commands in this chapter to configure IBM channel attach interface features. For hardware technical descriptions and for information about installing the router interfaces, refer to the hardware installation and maintenance publication for your particular product.
For interface configuration information and examples, refer to the "Configuring IBM Channel Attach" chapter of the Bridging and IBM Networking Configuration Guide.
For a conversion table of the modular products and Cisco 7000 family processors, refer to the "Platform Support" appendix of the Configuration Fundamentals Command Reference.
adapter
Use the adapter internal LAN configuration command to configure an internal adapter interface on an internal LAN. Use the no form of this command to remove an internal adapter configuration.
adapter adapter-number mac-address
no adapter adapter-number mac-addressSyntax Description
Default
This command has no defaults.
Command Mode
Internal LAN configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Before you can configure an internal adapter interface, you must use the bridge-group internal LAN configuration command or the source-bridge internal LAN configuration command to configure the bridging type. The only way to get packets to the Channel Interface Processor (CIP) Systems Network Architecture (SNA) feature is through bridging. These two commands are identical to their interface configuration forms.
For transparent bridging, the bridge-group statements identify the interfaces in the same bridge group. Frames are sent only to the interface in the same bridge group.
For source-route bridging, the source-bridge statements identify the interfaces in the same ring group. Frames are sent only to interfaces in the same ring group.
An Ethernet internal LAN can have a bridge-group command.
A Token Ring or FDDI internal LAN can have either a bridge-group or a source-bridge command, but not both.
Note
If the source-bridge command is changed while adapters have active sessions, those sessions will be terminated.
Example
The following example configures an Ethernet internal LAN adapter on relative adapter 12 and MAC address 87AD.0462.3FDE:
interface channel 1/2lan ethernet 20bridge-group 1adapter 12 87AD.0462.3FDERelated Commands
You can use the master indexes or search online to find documentation of related commands.
bridge-group
llc2
name
source-bridge
lanchannel-protocol
Use the channel-protocol interface configuration command to define a data rate of either 3 megabytes per second or 4.5 megabytes per second for the Parallel Channel Adapter (PCA) card.
channel-protocol [s | s4]
Syntax Description
s
(Optional) Specifies a data rate of 3 megabytes per second.
s4
(Optional) Specifies a data rate of 4.5 megabytes per second.
Default
If no value is specified, the default data rate for the PCA is 3 megabytes per second.
Command Mode
Interface configuration
Usage Guideline
This command first appeared in Cisco IOS Release 10.3.
This command is valid for a PCA adapter card configured on a CIP on the Cisco 7000 with RSP7000 and Cisco 7500 series.
Example
The following command specifies a data rate of 4.5 megabytes per second for the interface:
channel-protocol s4claw
Use the claw interface configuration command to establish the IBM channel attach configuration for an ESCON Channel Adapter (ECA) interface or bus-and-tag Parallel Channel Adapter (PCA) interface on the Cisco 7000 with RSP7000 and Cisco 7500 series.
claw path device-address ip-address host-name device-name host-app device-app [broadcast]
Syntax Description
Default
This command has no defaults.
Command Mode
Interface configuration
Usage Guideline
This command first appeared in Cisco IOS Release 10.3.
This command defines information that is specific to the interface hardware and the IBM channels supported on the interface.
Example
The following example shows how to enable IBM channel attach routing on the CIP port 0, which is supporting a directly connected ESCON channel:
interface channel 3/0ip address 198.92.0.1 255.255.255.0claw 0100 00 198.92.0.21 CISCOVM EVAL TCPIP TCPIPclient (lu limit)
Use the client TN3270 configuration command to limit the number of LU sessions that can be established from a client IP address. Use the no form of this command to remove a single LU limit associated with a particular IP address.
client [ip [ip-mask]] lu maximum number
no client [ip [ip-mask]] [lu maximum number]Syntax Description
Default
The default is that there is no limit on the number of concurrent sessions to one client IP address.
In the no form of this command, the default number is 65535.
Command Mode
TN3270 configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 BC.
An instance of the client (lu limit) command on a given tn3270-server is uniquely identified by the ip-mask and the logical AND of the ip address with that mask. For example, if the command is entered as the following:
client 10.1.1.62 255.255.255.192 lu maximum 2then it will be stored (and subsequently displayed by write term) as:
client 10.1.1.0 255.255.255.192 lu maximum 2The maximum specified on the command can be changed simply by reissuing the command with the new value. It is not necessary to remove the command first.
When you use the no client command, only the corresponding client lu maximum statement is removed, as identified by the IP address and IP address mask combination. You cannot use no client to specify an unlimited number of LU sessions.
For example, if a service bureau has 8000 clients and each client IP address is limited to four LU sessions, you will never need more than 32000 concurrent LU definitions even when the service is running at 100 percent capacity.
Examples
The following example limits all clients to a maximum of two LU sessions:
client lu maximum 2The following example limits a client at IP address 10.1.1.28 to a maximum of three LU sessions:
client 10.1.1.28 lu maximum 3The LU limit can be applied to different subnets as shown in the following example. The most exact match to the client IP address is chosen. Clients with IP addresses that reside in the subnet 10.1.1.64 (those with IP addresses in the range of 10.1.1.64 through 10.1.1.127) are limited to a maximum of 5 LU sessions while other clients with IP addresses in the subnet 10.1.1.0 are limited to a maximum of 4 LU sessions.
client 10.1.1.0 255.255.255.0 lu maximum 4client 10.1.1.64 255.255.255.192 lu maximum 5The following example prevents an LU session for the client at IP address 10.1.1.28:
client 10.1.1.28 lu maximum 0Related Commands
You can use the master indexes or search online to find documentation of related commands.
client (lu nailing)
Use the client TN3270 PU configuration mode command to define a range of locaddrs to be reserved for remote devices. Use the no form of this command to cancel this definition.
client [printer] ip ip-address [mask] lu first-locaddr [last-locaddr]
no client [printer] ip ip-address [mask] lu first-locaddr [last-locaddr]Syntax Description
Default
The default is that no LUs are nailed. They are all available to any client.
Command Mode
TN3270 PU configuration mode
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 BC.
Multiple statements can be configured for one IP address or nail type either on one PU or multiple PUs. But each LU can only appear in one client statement.
A client with a nailed IP address can request one of the nailed LUs via the TN3270 device name. If the requested LU is not available then the connection is rejected.
A client with a nailed IP address cannot request an LU outside the range of nailed LUs for its type (screen or printer).
A client with a non-nailed IP address cannot request an LU that is configured as nailed.
The command will be rejected if some of the locaddrs are already nailed. If the locaddrs are currently in use by other remote clients, the nailing statement will take effect only when the locaddr is made available.
To cancel the definition, the no client form of the command must be entered exactly as the client command was originally configured. If a range of locaddrs was specified, to cancel this definition the whole range of locaddrs must be specified. There is no way to cancel only one locaddr if a whole range of locaddrs was configured.
Examples
In the following example, locaddrs 1 to 50 are reserved for remote devices in the 171.69.176.0 subnet:
interface channel 2/2tn3270-serverpu BAGE4client ip 171.69.176.28 255.255.255.0 lu 1 50In the following example, locaddrs 1 to 40 are reserved for screen devices in the 171.69.176.0 subnet, while 41 to 50 are reserved for printers in that subnet:
interface channel 2/2tn3270-serverpu BAGE4client ip 171.69.176.28 255.255.255.0 lu 1 40client printer ip 171.69.176.28 255.255.255.0 lu 41 50In the following example, there is an attempt to cancel a definition but this is rejected because it does not specify the full range of locaddrs and the second attempt fails to specify the correct nail type:
interface channel 2/2tn3270-serverpu BAGE4client printer ip 171.69.176.50 255.255.255.0 lu 1 100no client printer ip 171.69.176.50 255.255.255.0 lu 1%Invalid LU range specifiedno client ip 171.69.176.50 255.255.255.0 lu 1 100%client ip 171.69.176.50 nail type not matched with configured nail type printercmpc
Use the cmpc interface configuration command to configure a CMPC read subchannel and a CMPC write subchannel. Use the no form of this command to remove a subchannel definition and to deactivate the transmission group.
cmpc path device tg-name {read | write}
no cmpc path deviceSyntax Description
Default
No default is specified.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 F.
The hexadecimal path value specifies the data path and consists of two digits for the physical connection (either on the mainframe or on the ESCON Director Switch), one digit for the channel logical address, and one digit for the control unit address.
Each cmpc configuration command in a given CMPC transmission group specifies the same transmission group name. The corresponding tg command specifies the same transmission group name. Together, the cmpc and tg commands make up the transmission group specification.
The cmpc command defines the read/write subchannel addresses that CMPC uses to connect to the host. The command corresponds to the definitions in theTRL major node on the host. Configure the CMPC command on the CIP physical interfaces, slot/0 or slot/1, and not on the CIP internal LAN interface, slot/2. Because CMPC uses read and write subchannel pairs, you can configure the CMPC subchannels on different CIP physical interfaces as long as they are on the same CIP.
The no cmpc command deactivates the CMPC transmission group. If the transmission group is used for a non-HPR connection, all sessions using the TG will be terminated immediately. If the transmission group is an HPR connection, all sessions using the transmission group will be terminated if no other HPR connection is available to the host.
Example
The following example configures a read and a write subchannel on path C020 for the CMPC transmission group named CONFIGE:
cmpc C020 F8 CONFIGE READcmpc C020 F9 CONFIGE WRITERelated Commands
You can use the master indexes or search online to find documentation of related commands.
csna
Use the csna interface configuration command to specify the path and device/subchannel on a physical channel of the Cisco 7000 with RSP7000 and Cisco 7500 series router to communicate with an attached mainframe. Use the no form of this command to delete the CIP SNA (CSNA) path.
csna path device [maxpiu value] [time-delay value] [length-delay value]
no csna path deviceSyntax Description
Defaults
maxpiu value: 20470 (0x4ff6) bytes
time-delay value: 10 ms
length-delay value: 20470 (0x4ff6) bytesCommand Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
This command is valid for an ESCON or PCA card configured on a CIP on the Cisco 7000 with RSP7000 and Cisco 7500 series. This command is required for CSNA support over a physical channel.
Use the maxpiu, time-delay, and length-delay keywords to adjust the CIP interface transmission characteristics. You can set the maximum size of packet that the interface will transmit to match the packet size accepted by the host system. You can adjust the delay between the time a packet is received on one of the CIP internal interfaces and transmitted to the host. You can also adjust the transmit-to-host delay by changing the amount of data the CIP accumulates before transmitting to the host.
Changes to the delay values take effect immediately. Any change to the maximum packet size will take effect after the channel is reinitialized. A length-delay value of 0 sends the packet as soon as possible.
Using the no csna command terminates all subchannels (path and devices) configured on the channel and all Logical Link Control, type 2 (LLC2) sessions established over the subchannels.
Example
The following example shows CSNA, offload, and CLAW configured on the CIP in slot 1, port 0. CSNA can be configured by itself, without dependency on offload or CLAW:
interface channel 1/0no ip addressno keepaliveoffload c700 c0 172.18.1.217 TCPIP OS2TCP TCPIP TCPIP TCPIP APIclaw C700 A0 192.18.1.219 EVAL CISCOVM AAA BBBcsna 0100 10csna 0100 11csna 0100 12dlur
Use the dlur TN3270 configuration command to enable the Systems Network Architecture (SNA) session switch function on the CIP, or to enter dependent logical unit requester (DLUR) configuration mode. Use the no form of this command to disable the SNA session switch function and discard all parameter values associated with the SNA session switch.
dlur
dlur fq-cpname fq-dlusname
no dlurSyntax Description
Default
No DLUR function is enabled.
Command Mode
TN3270 configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
If the SNA session switch function is already enabled, the dlur command with no arguments puts you in DLUR configuration mode.
Several parameters in the DLUR configuration mode consist of fully qualified names, as defined by the APPN architecture. Fully qualified names consist of two case-insensitive alphanumeric strings, separated by a period. However, for compatibility with existing APPN products, including VTAM, the characters "#" (pound), "@" (at), and "$" (dollar) are allowed in the fully qualified name strings. Each string is from one to eight characters long; for example, RA12.NODM1PP. The portion of the name before the period is the NETID and is shared between entities in the same logical network.
The no dlur command hierarchically deletes all resources defined beneath it.
Example
The following command performs two functions: It enters DLUR configuration mode; and it enables the DLUR function and defines the LU name for the DLUR as SYD.TN3020 and the primary choice for DLUS as SYD.VMG. Note that the NETID portion of both names is the same:
dlur SYD.TN3020 SYD.VMGdlus-backup
Use the dlus-backup DLUR configuration command to specify a backup DLUS for the DLUR function. Use the no form of this command to remove a backup DLUS name.
dlus-backup dlusname2
no dlus-backupSyntax Description
Default
No backup DLUS is specified.
Command Mode
DLUR configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
Only one backup DLUS can be specified per CIP. If the backup DLUS specified in the dlus-backup command is in use when a no dlus-backup is issued, the connection is not torn down.
Several parameters in the DLUR configuration mode consist of fully qualified names, as defined by the APPN architecture. Fully qualified names consist of two case-insensitive alphanumeric strings, separated by a period. However, for compatibility with existing APPN products, including VTAM, the characters "#" (pound), "@" (at), and "$" (dollar) are allowed in the fully qualified name strings. Each string is from one to eight characters long; for example, RA12.NODM1PP. The portion of the name before the period is the NETID and is shared between entities in the same logical network.
Example
The following command specifies SYD.VMX as the backup DLUS:
dlus-backup SYD.VMXgeneric-pool
Use the generic-pool TN3270 configuration command to specify whether or not left-over LUs will be made available to TN3270 sessions that do not request a specific LU or LU pool through TN3270E. Use the no form of this command to selectively remove the permit or deny condition of generic pool use.
generic-pool {permit | deny}
no generic-poolSyntax Description
Defaults
In TN3270 configuration mode, generic pool use is permitted.
In PU configuration mode, the default is the value currently configured in TN3270 configuration mode.
Command Modes
TN3270 configuration
PU configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
A left-over LU is defined as one for which all of the following conditions are true:
•
•
All LUs in the generic pool are, by definition, DDDLU capable.
Values entered for generic-pool in TN3270 configuration mode apply to all PUs for that TN3270 server but can be changed in PU configuration mode.
In PU configuration mode, a no generic-pool command will restore the generic-pool value entered in TN3270 command mode.
In TN3270 configuration mode, the no generic-pool command reverts to the default, which permits generic pool use.
The command takes effect immediately. If generic-pool deny is specified on a PU, no further dynamic connections to it will be allowed. Existing sessions are unaffected, but as they terminate the LUs will not become available for dynamic connections.
Similarly, if generic-pool permit is specified, any inactive LUs are immediately available for dynamic connections. Moreover, any active LUs that were dynamic previously (before generic-pool deny was issued) return to being dynamic.
Example
The following command permits generic LU pool use:
generic-pool permitidle-time
Use the idle-time TN3270 configuration command to specify how many seconds of LU inactivity, from both host and client, before the TN3270 session is disconnected. Use the no form of this command to cancel the idle time period and return to the default.
idle-time seconds
no idle-timeSyntax Description
Defaults
The default in TN3270 configuration mode is that the session is never disconnected (0).
The default in PU configuration mode is the value currently configured in TN3270 configuration mode.
Command Modes
TN3270 configuration
PU configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
The idle-time command can be entered in either TN3270 configuration mode or PU configuration mode. A value entered in TN3270 mode applies to all PUs for that TN3270 server, except as overridden by values entered in PU configuration mode.
A no idle-time command entered in PU configuration mode will restore the idle-time value entered in TN3270 command mode.
The idle-time command affects currently active and future TN3270 sessions. For example, if the idle-time value is reduced from 900 seconds to 600 seconds, sessions that have been idle for between 600 and 900 seconds are immediately disconnected.
Note
Examples
The following command sets an idle-time disconnect value of 10 minutes:
idle-time 600The following command entered in TN3270 configuration mode sets the default idle-time disconnect value to 0, or never disconnect:
no idle-timeinterface channel
Use the interface channel global configuration command to specify a channel attach interface and enter interface configuration mode.
interface channel slot/port
Syntax Description
Default
This command has no defaults.
Command Mode
Global configuration
Usage Guideline
This command first appeared in Cisco IOS Release 11.0. It is used only on the Cisco 7000 with RSP7000 and Cisco 7500 series.
Example
The following example shows how to enter interface configuration mode for a CIP in slot 2 and begin configuring port 0:
interface channel 2/0Related Commands
You can use the master indexes or search online to find documentation of related commands.
claw
cmpc
csna
lan
max-llc2-sessions
offload
tn3270-serverip precedence
Use the ip precedence command to specify the precedence level for IP traffic in the TN3270 server. The no form of this command removes the precedence value.
ip precedence {screen | printer} value
no ip precedence {screen | printer}Syntax Description
Default
The default is a precedence value of 0 for both screens and printers.
Command Mode
TN3270 server configuration mode
TN3270 PU configuration mode
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 BC.
Precedence values applied in TN3270 PU configuration mode override values applied in TN3270 server configuration mode.
You can enter new or different values for IP precedence without first using the no form of this command.
During initial Telnet negotiations to establish, or bind, the session an IP precedence value of 0 and IP TOS value of 0 is used. These values are used until the bind takes place. When the session is a type 2 bind, the TN3270 client is assumed to be a screen; otherwise the client is assumed to be a printer.
Example
The following example assigns a precedence value of 3 to printers:
ip precedence printer 3Related Commands
You can use the master indexes or search online to find documentation of related commands.
ip tos
Use the ip tos command to specify the TOS level for IP traffic in the TN3270 server. The no form of this command removes the TOS value.
ip tos {screen | printer} value
no ip tos {screen | printer}Syntax Description
screen
Specifies the TOS is for screen devices.
printer
Specifies the TOS is for printer devices.
value
Sets the TOS priority. A value between 0 and 15. The default is 0.
Default
The default is a TOS value of 0 for both screens and printers.
Command Mode
TN3270 server configuration mode
TN3270 PU configuration mode
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 BC.
TOS values applied in TN3270 PU configuration mode override values applied in TN3270 server configuration mode.
The default TOS values for screen and printer are 0. However, RFC 1349 recommends different default values. Specifically, the RFC recommends a default minimize screen delay value of 8 and a default maximize printer throughput value of 4. You must configure these values using the ip tos command if you want to comply to the defaults as stated in the RFC. shows the values described in RFC 1349.
During initial Telnet negotiations to establish, or bind, the session, an IP precedence value of 0 and IP TOS value of 0 is used. These values are used until the bind takes place. When the session is a type 2 bind, the TN3270 client is assumed to be a screen; otherwise the client is assumed to be a printer.
When you use the no form of the command, the TOS value is either set to 0 for that configuration mode or the value set at a previous (higher) configuration mode is used. For example, if you are at the TN3270 PU configuration mode and issue a no ip tos screen command, any value you configured previously at the TN3270 server configuration mode will take effect.
You can enter new or different values for TOS without first using the no form of this command.
Example
In the following example, the TN3270 server TOS screen value is set to 10 and a specific PU TOS screen value is set to 0:
interface channel 3/2 tn3270-server ip tos screen 8 ip tos printer 4 pu PUS2 ip tos screen 0Related Commands
You can use the master indexes or search online to find documentation of related commands.
keepalive
Use the keepalive TN3270 configuration command to specify how many seconds of inactivity elapse before transmission of a DO TIMING-MARK to the TN3270 client. Use the no form of this command to cancel the keepalive period and return to the default.
keepalive seconds
no keepaliveSyntax Description
seconds
Number of seconds, from 0 to 65535. A value of 0 means no keepalive signals are sent. The default is 1800 seconds (30 minutes).
Defaults
The default in TN3270 configuration mode is 1800 seconds (30 minutes).
The default in PU configuration mode is the value currently configured in TN3270 configuration mode.
Command Modes
TN3270 configuration
PU configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
The keepalive command can be entered in either TN3270 configuration mode or PU configuration mode. A value entered in TN3270 mode applies to all PUs for that TN3270 server, except as overridden by values entered in PU configuration mode. A no keepalive command entered in PU configuration mode will restore the keepalive value entered in TN3270 command mode.
If the client does not reply within 30 minutes of the transmission of the DO TIMING-MARK, the TN3270 server disconnects the TN3270 session. The DO TIMING-MARK is a Telnet protocol operation that does not affect the client operation.
If the IP path to the client is broken, the TCP layer will detect the failure to acknowledge the DO TIMING-MARK and initiate disconnection. This action will usually take much less than 30 minutes.
The keepalive command affects currently active and future TN3270 sessions. For example, reducing the value to a smaller nonzero value will cause an immediate burst of DO TIMING-MARKs on those sessions that have been inactive for a period of time greater than the new, smaller value.
The keepalive command can be used to determine whether power-off Reply product set ID (PSID) network management vector transport (NMVT) is sent to the host. With the default value, the power-off Reply PSID NMVT is not sent. Increasing the value to 50000 or above will enable the sending of power-off Reply PSID NMVT. If the configured value is greater than 50000, the keepalive function uses a value equal to 50000 less than the configured value.
Examples
The following command sets an keepalive disconnect value of 15 minutes (900 seconds):
keepalive 900The following example entered in TN3270 configuration mode sets the keepalive disconnect value to 51800 seconds, a value greater than 50000, and enables the sending of power-off Reply product set ID (PSID) network management vector transport (NMVT) to the host.
keepalive 51800The following command entered in TN3270 configuration mode sets the keepalive disconnect value to 1800 seconds, the default:
no keepalivelan
Use the lan interface configuration command to configure an internal LAN on a CIP interface. Use the no form of the command to remove an internal LAN interface.
lan type lan-id
no lan type lan-idSyntax Description
Default
This command has no defaults.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
An internal LAN can be configured only on CIP interface port 2. Interface port 2 represents an internal port on the CIP. You receive an error message if you attempt to configure an internal LAN on any CIP port other than port 2.
Example
The following example shows how to configure an internal LAN Ethernet with a LAN ID of 20 on the CIP in slot 1, port 2:
interface channel 1/2lan ethernet 20link
Use the link DLUR SAP configuration command to define and activate a link to a host. Use the no form of this command to delete the link definition.
link name [rmac rmac] [rsap rsap]
no link nameSyntax Description
Defaults
No DLUR link is defined.
The default remote SAP address is 04 (hexadecimal).
Command Mode
DLUR SAP configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
The combination of rmac and rsap must be unique within the DLUR SAP function. These values can only be changed by deleting the link definition, using the no link command, and recreating the link definition.
For a link via a channel on this CIP, the TN3270 server and the hosts should open different adapters in the same internal LAN. Using different adapters avoids any contention for SAP numbers, and is also necessary if you configure duplicate MAC addresses for fallback CSNA access to the host. By configuring the adapters in the same internal LAN, you achieve the same performance—bypassing the DLC stacks—as looping back on a single adapter.
Examples
The following command defines a link name and a remote SAP address:
link LINK5 rsap 08The following example shows different adapter numbers configured on the same internal LAN to avoid SAP contention. The host uses SAP 4 on token ring adapter 0.
lan tokenring 0adapter 0 4000.0000.0001adapter 1 4000.0000.0002tn3270-serverdlur ...lsap token-adapter 1link HOST rmac 4000.0000.0001 rsap 4lsap
Use the lsap DLUR configuration command to create a SAP in the SNA session switch, or to enter DLUR SAP configuration mode. Use the no form of this command to delete a SAP and all SNA session switch links using the internal LAN interface.
lsap
lsap type adapter-number [lsap]
no lsap type adapter-number [lsap]Syntax Description
Default
The default value for lsap is hexadecimal C0.
Command Mode
DLUR configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
If the SAP in the SNA session switch function is already created, the lsap command with no arguments puts you in DLUR SAP configuration mode.
The lsap command can be entered only in DLUR configuration mode.
The lsap command uses values that are defined in two other commands: the lan internal LAN configuration command and the adapter internal LAN configuration command. The lan type and adapter adapter-number values configured on the CIP internal LAN interface are used in the lsap command.
However, the lan type keyword is a little different. Where the type on the lan command is tokenring, the corresponding type on lsap is token-adapter. This emphasizes that the number that follows is an adapter number, not a lan number.
The no lsap command hierarchically deletes any links using it. Any sessions using those links are lost.
Example
The following command defines an adapter type, an adapter number, and a local SAP:
lsap token 0 B0Related Commands
You can use the master indexes or search online to find documentation of related commands.
max-llc2-sessions
Use the max-llc2-sessions internal adapter configuration command to specify the number of concurrent LLC2 sessions that will be supported on the CIP interface. Use the no form of this command to remove a value.
max-llc2-sessions number
no max-llc2-sessions numberSyntax Description
Default
The default number of sessions is 256.
Command Mode
Internal adapter configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
The maximum number of LLC2 sessions can be configured only on CIP interface port 2. To specify an unlimited number of LLC2 sessions, either omit this command from the adapter configuration on CIP interface port 2, or use a value of 0.
When configured for an unlimited number of LLC2 sessions, the actual number of sessions is determined by the available memory on the CIP.
Example
The following example limits the maximum number of LLC2 sessions to 212:
max-llc2-sessions 212maximum-lus
Use the maximum-lus TN3270 configuration command to limit the number of LU control blocks that will be allocated for TN3270 server use. Use the no form of this command to restore the default value.
maximum-lus number
no maximum-lusSyntax Description
Default
Because of the license structure, the default is 2100, which represents the limit of the lower-priced license (2000) plus a five percent buffer. If you configure a value greater than the default, a license reminder is displayed.
Command Mode
TN3270 configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
Although the value may be varied at any time, reducing it below the current number of LU control blocks will not release those blocks until a PU is inactivated by DACTPU or by using the no pu command.
If the number of LUs in use reaches 94% of the current setting of maximum-lus, a warning message is displayed on the console. To prevent annoyance, the threshold for generating such messages is raised for a period.
The TN3270 server attempts to allocate one LU control block for each LU activated by the hosts. In the case of dynamic definition of dependent LU (DDDLU) the control block is allocated when the client requests the LU, in anticipation of an ACTLU from the SSCP host.
By limiting the number of LU control blocks allocated, you can make sure enough memory is available to support other CIP functions. The control blocks themselves take about 1K bytes per LU. During session activity, a further 2K per LU may be needed for data. On a CIP, 32 MB of memory will support 4000 LUs. To support more than 4000 LUs, we recommend 64 MB of memory.
Example
The following command allows 5000 LU control blocks to be allocated:
maximum-lus 5000Related Commands
You can use the master indexes or search online to find documentation of related commands.
client (lu limit)
pu (DLUR)
pu (direct)name
Use the name internal adapter configuration command to give a name to the internal adapter. Use the no form of the command to remove the name assigned to an internal adapter.
name name
no name nameSyntax Description
name
Name that identifies this internal adapter. Consists of up to 8 characters that does not include blanks.
Default
This command has no defaults.
Command Mode
Internal adapter configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following example assigns a name to an internal adapter interface:
name VTAM_B14offload
Use the offload interface configuration command to configure an offload task on the CIP. Use the no form of this command to cancel the offload task on the CIP.
offload path device-address ip-address host-name device-name host-app device-app host-link
device-link [broadcast]
no offload path device-addressSyntax Description
Default
This command has no defaults.
Command Mode
Interface configuration
Usage Guideline
This command first appeared in Cisco IOS Release 11.0.
The offload command uses the same underlying configuration parameters as does the claw command.
Example
The following example shows how to enable IBM channel attach offload routing on the CIP port 0, which is supporting a directly connected ESCON channel:
interface channel 3/0ip address 198.92.0.1 255.255.255.0offload 0100 00 198.92.0.21 CISCOVM EVAL TCPIP TCPIP TCPIP APIpreferred-nnserver
Use the preferred-nnserver DLUR configuration command to specify a preferred network node (NN) as server. Use the no form of this command to remove the preference.
preferred-nnserver name
no preferred-nnserverSyntax Description
Default
This command has no defaults.
Command Mode
DLUR configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
Fully qualified names consist of two case-insensitive alphanumeric strings, separated by a period. However, for compatibility with existing APPN products, including VTAM, the characters "#" (pound), "@" (at), and "$" (dollar) are allowed in the fully qualified name strings. Each string is from one to eight characters long; for example, RA12.NODM1PP. The portion of the name before the period is the NETID and is shared between entities in the same logical network.
When no preferred server is specified, the DLUR will request NN server support from the first suitable node with which it makes contact. If refused, it will try the next one, and so on.
If a preferred server is specified, then DLUR will wait a short time to allow a link to the preferred server to materialize. If the preferred server is not found in that time, any suitable node can be used, as above.
DLUR will not relinquish the current NN server merely because the preferred server becomes available.
Example
The following command selects SYD.VMX as the preferred NN server:
preferred-nnserver SYD.VMXpu (DLUR)
Use the pu DLUR configuration command to create a PU entity that has no direct link to a host or to enter PU configuration mode. Use the no form of this command to remove the PU entity.
pu pu-name
pu pu-name idblk-idnum ip-address
no pu pu-nameSyntax Description
Default
No PU is defined.
Command Mode
DLUR configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
If the PU is already created, the pu pu-name command with no arguments puts you in PU configuration mode. In this mode you can modify an existing PU DLUR entity.
A typical usage for the IP address is to reserve an IP address per host application. For example, clients wanting to connect to TSO specify an IP address that will be defined with PUs that have LOGAPPL=TSO.
Example
The following sequence of commands define three PUs. Two of the PUs share the same IP address and the third PU has a separate IP address:
pu p0 05D99001 192.195.80.40pu p1 05D99002 192.195.80.40pu p2 05D99003 192.195.80.41pu (direct)
Use the pu TN3270 configuration command to create a PU entity that has its own direct link to a host, or to enter PU configuration mode. Use the no form of this command to remove the PU entity.
pu pu-name idblk-idnum ip-address type adapter-number lsap [rmac rmac] [rsap rsap]
[lu-seed lu-name-stem]
no pu pu-nameSyntax Description
Defaults
No PU is defined.
The default remote SAP address is 04 (hexadecimal).
Command Mode
TN3270 configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
If the PU is already created, the pu pu-name command with no arguments puts you in PU configuration mode, where you can modify an existing PU entity.
The pu (direct) command uses values that are defined in two other commands: the lan internal LAN configuration command and the adapter internal LAN configuration command. The lan type and adapter adapter-number values configured on the CIP internal LAN interface are used in the pu command.
For a link via a channel on this CIP, the TN3270 server and the hosts should open different adapters in the same internal LAN. Using different adapters avoids any contention for SAP numbers, and is also necessary if you configure duplicate MAC addresses for fallback CSNA access to the host. By configuring the adapters in the same internal LAN, you achieve the same performance—bypassing the DLC stacks—as looping back on a single adapter.
Examples
The following commands configure the TN3270 server to be active, and has one PU, CAPPU1, trying to connect in. An LU seed using hexadecimal digits is defined.
tn3270-serverpu CAPPU1 05D18101 10.14.20.34 token-adapter 3 rmac 4000.0501.0001 lu-seed CAP01L##The following example shows different adapter numbers configured on the same internal LAN to avoid SAP contention. The host uses SAP 4 on token ring adapter 0.
lan tokenring 0adapter 0 4000.0000.0001adapter 1 4000.0000.0002tn3270-serverpu PU1 05d00001 10.0.0.1 token-adapter 1 8 rmac 4000.0000.0001 rsap 4Related Commands
You can use the master indexes or search online to find documentation of related commands.
show extended channel cmpc
Use the show extended channel cmpc privileged EXEC command to display information about each CMPC subchannel configured on the specified CIP interface.
show extended channel slot/port cmpc [path [device]]
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 BC.
This command is valid only on the CIP physical interfaces, slot/0 or slot/1.
Sample Display
The following is sample output on a Cisco 7500 router from the show extended channel cmpc command:
router# show extended channel 3/0 cmpc c020Path Dv TGName Dir Bfrs StatusCMPC C020 46 MVS2ISRA READ 10 ActiveCMPC C020 47 MVS2ISRA WRITE 16 ActiveCMPC C020 4A MVS2ISR1 READ 7 ActiveCMPC C020 4B MVS2ISR1 WRITE 16 ActiveCMPC C020 4C MVS2ISR2 READ 7 ActiveCMPC C020 4D MVS2ISR2 WRITE 16 ActiveCMPC C020 4E MVS2TN READ 0 InactiveCMPC C020 4F MVS2TN WRITE 0 Inactivedescribes the fields shown in the display.
show extended channel connection-map llc2
Use the show extended channel connection-map llc2 privileged EXEC command to display the number of active LLC2 connections for each SAP and the mapping of the internal MAC adapter and the SAP to the resource that activated the SAP.
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 Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0(3).
Sample Display
The following is sample output on the Cisco 7000 from the show extended channel connection-map llc2 command.
router# show extended channel 1/2 connection-map llc2LAN Token 0 Adapter 0 4000.7000.0747Local SAP=08 LLC2 Connections=4 CSNA Port=1 Path=C200 Device=60Local SAP=0C LLC2 Connections=4 CSNA Port=1 Path=C200 Device=60Local SAP=10 LLC2 Connections=2 CSNA Port=1 Path=C200 Device=60Local SAP=14 LLC2 Connections=0 CSNA Port=1 Path=C200 Device=60LAN Token 1 Adapter 1 4000.7000.0767Local SAP=08 LLC2 Connections=3 CSNA Port=1 Path=C200 Device=61Local SAP=0C LLC2 Connections=3 CSNA Port=1 Path=C200 Device=61Local SAP=10 LLC2 Connections=2 CSNA Port=1 Path=C200 Device=61Local SAP=14 LLC2 Connections=2 CSNA Port=1 Path=C200 Device=61LAN Token 2 Adapter 2 4000.7000.0737No SAPs open on this interfaceTotal : SAPs opened = 8 Connections active = 20show extended channel csna
Use the show extended channel csna privileged EXEC command to display information about the CSNA subchannels on the Cisco 7000 series.
show extended channel slot/port csna [path [device-address ]] [admin | oper | stats]
Syntax Description
Default
The default is to show the administrative (configured) values as specified by the optional admin keyword.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0(3).
This command displays information that is specific to the interface hardware. The information is generally useful for diagnostic tasks performed by technical support personnel only.
Sample Displays
The following is sample output on the Cisco 7000 from the show extended channel csna command. Three examples are provided, one for each type of output as specified by the admin, oper, and stats keywords.
The following example displays the configured values for all CSNA devices on interface channel 1/0.
router# show extended channel 1/0 csna adminPath Dv maxpiu time-delay length-delayCSNA C200 60 64000 100 64000CSNA C200 61 64000 100 64000CSNA C200 62 64000 100 64000describes the fields shown in the display.
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 operPath Dv Status SlowDown maxpiu time-delay length-delayCSNA C200 60 setupComplet off 64000 100 64000CSNA C200 61 setupComplet off 64000 100 64000CSNA C200 62 setupComplet off 64000 100 64000describes the fields shown in the display.
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.
router# show extended channel 1/0 csna c200 60 statsCSNA C200 60Blocks Transmitted = 38979079 Received = 38979075Bytes Transmitted = 79251477K Received = 13554Slow downs Sent = 0 Received = 0Txd by maxpiu : Blocks = 0 Bytes = 0Txd by time-delay : Blocks = 222 Bytes = 12522Txd by length-delay: Blocks = 0 Bytes = 0describes the fields shown in the display.
show extended channel icmp-stack
Use the show extended channel icmp-stack privileged EXEC command to display information about the Internet Control Message Protocol (ICMP) stack running on the CIP interfaces in a Cisco 7000 with RSP7000 and Cisco 7500 series.
show extended channel slot/port icmp-stack [ip-address]
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Sample Display
The following is sample output from the show extended channel icmp-stack command:
router# show extended channel 4/0 icmp-stackICMP Statistics for IP Address 198.92.1.120InMsgs : 200 InErrors : 201 InDestUnreachs: 202InTimeExcds : 203 InParmProbs : 204 InSrcQuenchs : 205InRedirects : 206 InEchos : 207 OutEchoReps : 213OutTimestamps : 214 OutTimestampReps: 215 OutAddrMasks : 216OutAddrMaskReps: 217ICMP Statistics for IP Address 198.92.1.121InMsgs : 201 InErrors : 202 InDestUnreachs: 203InTimeExcds : 204 InParmProbs : 205 InSrcQuenchs : 206InRedirects : 207 InEchos : 208 OutEchoReps : 214OutTimestamps : 215 OutTimestampReps: 216 OutAddrMasks : 217OutAddrMaskReps: 218describes the fields shown in the display.
Related Commands
You can use the master indexes or search online to find documentation of related commands.
pu (direct)
pu (DLUR)
offloadshow extended channel ip-stack
Use the show extended channel ip-stack privileged EXEC command to display information about the IP stack running on the CIP interfaces in a Cisco 7000 with RSP7000 and Cisco 7500 series.
show extended channel slot/port ip-stack [ip-address]
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Sample Display
The following is sample output on the Cisco 7000 with RSP7000 from the show extended channel ip-stack command:
router# show extended channel ip-stackIP Statistics for IP Address 198.92.1.120Forwarding : fowarding DefaultTTL : 2 InReceives : 3InHdrErrors : 4 InAddrErrors : 5 ForwDatagrams: 6InUnknownProtos: 7 InDiscards : 8 InDelivers : 1313371OutRequests : 10 OutDiscards : 11 OutNoRoutes : 12ReasmTimeout : 13 ReasmReqds : 14 ReasmOKs : 15ReasmFails : 16 FragOKs : 17 FragFails : 18FragCreates : 19 RoutingDiscards: 20IP Statistics for IP Address 198.92.1.121Forwarding : nofoward DefaultTTL : 3 InReceives : 4InHdrErrors : 5 InAddrErrors : 6 ForwDatagrams: 7InUnknownProtos: 8 InDiscards : 9 InDelivers : 1313371OutRequests : 11 OutDiscards : 12 OutNoRoutes : 13ReasmTimeout : 14 ReasmReqds : 15 ReasmOKs : 16ReasmFails : 17 FragOKs : 18 FragFails : 19FragCreates : 20 RoutingDiscards: 21describes the fields shown in the display.
Related Commands
You can use the master indexes or search online to find documentation of related commands.
pu (direct)
pu (DLUR)
offloadshow extended channel llc2
Use the show extended channel llc2 privileged EXEC command to display information about the LLC2 sessions running on the CIP interfaces in a Cisco 7000 series.
show extended channel slot/port llc2 [admin | oper | stats] [lmac [lsap [rmac [rsap]]]]
Syntax Description
Default
The default is to show the administrative (configured) values as specified by the optional admin keyword.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0(3).
To specify LLC information for internal adapters:
•
•
To display LLC information for SAPs opened on an internal adapter:
•
•
To display information for LLC2 connections on a channel interface:
•
•
•
•
•
Sample Displays
The following is sample output on the Cisco 7000 from the show extended channel llc2 command. Three examples are provided, one for each type of output as specified by the admin, oper, and stats keywords.
The following sample displays the configured values for all LLC2 connections on channel 2/2.
router# show extended channel 2/2 llc2 adminLan Token adapter 0 0004.0004.0004t1-time = 1000 tpf-time = 1000 trej-time = 3200 tbusy-tim = 9600idle-time =60000 local-win = 7 recv-wind = 7 N2 = 8N1 = 1033 ack-delay = 100 ack-max = 3 nw = 0
describes the fields shown in the display.
The following sample displays the operational values for all LLC2 connections on channel 2/2.
router#show extended channel 5/2 llc operLAN Token 0 Adapter 0 4000.1010.2020Open SAPs=1Max SAPs Opened=1describes the fields shown in the display.
The following sample displays statistics for all LLC2 connections on channel 2/2.
router#show extended channel 5/2 llc statLAN Token 0 Adapter 0 4000.1010.2020PDUsIn = 223339 PDUsOut = 9564OctetsIn = 6949875 OctetsOut = 307448TESTCmdsIn = 213293 TESTRspsOut = 2LocalBusies= 0 UnknownSAPs = 0describes the fields shown in the display. These statistics are available on the adapter because when LLC2 connections are deactivated, users can no longer retreive the information per LLC2 connection.
The following sample displays statistics for all LLC2 connections on channel 2/2.
router#sho ext ch 5/2 llc2 oper 4000.1010.2020 04LAN Token 0 Adapter 0 4000.1010.2020Local SAP=04Open Connections=2Max Connections Opened=2
The following table describes the fields shown in the display.
The following sample displays statistics for all LLC2 connections on channel 2/2.
router#sho ext ch 5/2 llc2 stats 4000.1010.2020 04LAN Token 0 Adapter 0 4000.1010.2020Local SAP=04TESTRspsIn = 0 TESTCmdsOut = 0XIDCmdsIn = 14 XIDCmdsOut = 16XIDRspsIn = 4 XIDRspsOut = 0UIFramesIn = 0 UIFramesOut = 0UIOctetsIn = 0 UIOctetsOut = 0ConnectOk = 2 ConnectFail = 0DiscNorm = 0 DiscByTmr = 0DiscByFRMRSent = 0 DiscByFRMRRcvd = 0DMsInABM = 0 SABMEsInABM = 0describes the fields shown in the display. All statistics for SAPs are based on the time the SAP was last opened.
The following sample displays statistics for all LLC2 connections on
router#sho ext ch 5/2 llc2 oper 4000.1010.2020 04 4000.1234.1030 18LAN Token 0 Adapter 0 4000.1010.2020Local SAP=04 Remote MAC=4000.1234.1030 Remote SAP=18 State=normalt1-time = 1000 tpf-time = 1000 trej-time = 3200 tbusy-tim = 9600idle-time =60000 local-win = 7 recv-wind = 7 N2 = 8N1-Send = 4105 N1-Rcv = 4105 ack-delay = 100 ack-max = 3Nw = 0 Ww = 7Last Ww Cause = neverInvokedConnection Time: 17:50:11Last modified: neverdescribes the fields shown in the display. The output reflects the LLC2 parameters in use by the LLC2 connection. These parameters are the ones configured on the internal adpater 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 following sample displays statistics for all LLC2 connections between LMAC 4000.1010.2020 LSAP 04 and RMAC 4000.1234.1030 RSAP 18.
router#sho ext ch 5/2 llc2 stats 4000.1010.2020 04 4000.1234.1030 18LAN Token 0 Adapter 0 4000.1010.2020Local SAP=04 Remote MAC=4000.1234.1030 Remote SAP=18LocalBusies = 0 RemoteBusies = 0IFramesIn = 1 IFramesOut = 1IOctetsIn = 19 IOctetsOut = 21SFramesIn = 0 SFramesOut = 0REJsIn = 0 REJsOut = 0RetransmitsOut = 0 WwCountChanges = 0The following table describes the fields shown in the display.
show extended channel max-llc2-sessions
Use the show extended channel max privileged EXEC command to display information about the number of LLC2 sessions supported on the CIP.
show extended channel slot/port max-llc2-sessions
Syntax Description
slot
Slot number.
port
Port number.
max-llc2-sessions
Display the maximum number of LLC2 sessions supported on the CIP.
Default
Are there any defaults we should mention?
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0(3).
Sample Display
The following is sample output on the Cisco 7000 from the show extended channel max-llc2-sessions command:
router# show extended channel 1/2 max-llc2-sessionsAdministrative max-llc2-sessions = 1000Operational max-llc2_sessions = 1000Highest concurrent LLC2 sessions = 30LLC2 session allocation failures = 0describes the fields shown in the display.
show extended channel statistics
Use the show extended channel statistics privileged EXEC command to display information about the CIP interfaces on the Cisco 7000 with RSP7000 and Cisco 7500 series. This command displays information that is specific to the interface hardware. The information is generally useful only for diagnostic tasks performed by technical support personnel.
show extended channel slot/port statistics [path [device-address]]
Syntax Description
Default
The data path default for the control unit address and the channel logical address is 0.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
Sample Display
The following is sample output on the Cisco 7000 with RSP7000 from the show extended channel statistics command:
router# show extended channel 3/0 statisticsPath: C300 - ESTABLISHEDCommand Selective System Device CUDev Connects Retries Cancels Reset Reset Errors Busy60 92 85 5 4 1 0 061 94 0 4 3 1 0 0Blocks Bytes Dropped Blk MemdDev-Lnk Read Write Read Write Read Write wait Con60-00 6 0 192 0 8 0 0 Y60-01 82 0 7373 0 0 0 0 YTotal: 88 0 7565 0 8 0 061-00 0 4 0 128 0 0 0 Y61-01 0 85 0 9081 0 0 0 YTotal: 0 89 0 9209 0 0 0Path C300Total: 88 89 7565 9209 8 0 0Last stats 8 seconds old, next in 2 secondsdescribes the fields shown in the display.
show extended channel subchannel
Use the show extended channel subchannel privileged EXEC command to display information about the CIP interfaces on the Cisco 7000 with RSP7000 and Cisco 7500 series. This command displays information that is specific to the interface hardware. The information displayed is generally useful only for diagnostic tasks performed by technical support personnel.
show extended channel slot/port subchannel
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
Sample Display
The following is sample output on the Cisco 7000 with RSP7000 from the show extended channel subchannel command:
router# show extended channel 3/0 subchannelChannel3/0: state upFlags: VALID ESCON LOADED RQC_PEND MEMD_ENABLEDLink: C4, Buffers 0, CRC errrors 0, Load count 1Link Incident Reportsimplicit 0, bit-error 0, link failed 0,NOS 0, sequence timeout 0, invalid sequence 0Neighbor Node - VALIDClass: Switch Type Number : 009033 Tag: C4Model: 001 Manufacturer: IBMPlant: 51 Sequence : 000000010067Local Node - VALIDClass: CTCA-standalone Type Number : C7000 Tag: 30Model: 0 Manufacturer: CSCPlant: 17 Sequence : 00000C04953FLastMode Path Device SenseCLAW C300 60 198.92.1.58 CISCOVM AUBURN TCPIP TCPIP 0000CLAW C300 61 198.92.1.58 CISCOVM AUBURN TCPIP TCPIP 0080Last stats 1 seconds old, next in 9 secondsThe first line describes the status of the specified CIP and port. The status can be up, down, or administratively down:
Channel3/0: state upThe next line describes the flags on the CIP:
Flags: VALID ESCON LOADED RQC_PEND MEMD_ENABLED•
•
•
•
•
•
The next line describes Link information on the CIP:
Link: C4, Buffers 0, CRC errrors 0, Load count 1•
•
•
•
The next line displays Link Incident Reports:
Link Incident Reportsimplicit 0, bit-error 0, link failed 0,NOS 0, sequence timeout 0, invalid sequence 0Link Incidents are errors on an ESCON channel. These errors are reported to the host operating system and are recorded here for additional information.
Implicit incidents indicate a recoverable error occurred in the ECA.
Bit errors indicate the bit error rate threshold was reached. The bit error rate threshold is 15 error bursts within 5 minutes. An error burst is defined as a time period of 1.5+/-.5 seconds during which one or more code violations occurred. A code violation error is caused by an incorrect sequence of 10 bit characters.
Link failed means a loss of synchronization or light has occurred.
NOS means the channel or switch transmitted the Not Operational Sequence.
Sequence timeout occurs when a connection recovery timeout occurs or when waiting for the appropriate response while in the transmit off-line sequence (OLS) state.
Invalid Sequence occurs when a UD or UDR is recognized in the wait for offline sequence state. UD is an unconditional disconnect and UDR is an unconditional disconnect response.
The neighbor node describes the channel or switch. The local node describes the router. The VALID flag shows information has been exchanged between the router and channel or switch.
The information displayed under Neighbor Node is as follows:
Neighbor Node - VALIDClass: Switch Type Number : 009033 Tag: C4Model: 001 Manufacturer: IBMPlant: 51 Sequence : 000000010067Class will be switch or channel depending on whether the connection is a switched point-to-point connection or a point-to-point connection. The type number describes the model of switch or processor. The TAG describes the physical location of the connector. Model is a further classification of type. Manufacturer describes who made switch or processor. Plant and sequence are manufacturer specific information to uniquely define this one device.
The information displayed under Local Node is as follows:
Local Node - VALIDClass: CTCA-standalone Type Number : C7000 Tag: 30Model: 0 Manufacturer: CSCPlant: 17 Sequence : 00000C04953FThe class will be CTCA. The type number and model define the router. The tag is the slot and port where the channel interface processor resides. Manufacturer will always be CSC (for Cisco Systems). Plant is the location where the CIP was manufactured. Sequence is the base Ethernet address assigned to the route processor (RP).
The last three lines show currently configured information for the inbound and outbound channel connections:
LastMode Path Device SenseCLAW C300 60 198.92.1.58 CISCOVM AUBURN TCPIP TCPIP 0000CLAW C300 61 198.92.1.58 CISCOVM AUBURN TCPIP TCPIP 0080Mode can be CLAW, offload, or CSNA. Path, device, IP address, and names are from the CLAW command. Because CLAW and offload commands define two devices, both devices are shown. Last sense is the two bytes of sense data transmitted to the host at the time of the last unit exception. Normally the value will be 0000 if no unit exception has occurred, or 0080 to indicate that a resetting event has occurred. Resetting events occur whenever an ESCON device starts unless the first command is a 0x02 read command. The CLAW read subchannel always starts with a 0x02 read command so a resetting event will not occur.
show extended channel tcp-connections
Use the show extended channel tcp-connections EXEC command to display information about the Transmission Control Protocol (TCP) sockets on a channel interface.
show extended channel slot/port tcp-connections [[loc-ip-addr [loc-port [rem-ip-addr [rem-port]] [detail | summary]
Syntax Description
Command Mode
EXEC for summary and Privileged EXEC for detail.
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.
Sample Display
The following is sample output for the show extended channel tcp-connections detail command:
Router#show extended channel 0/1 tcp-connections detailLocal IP Addr Port Remote IP Addr Port State In Bytes Out Bytes80.11.198.2 21 0.0.0.0 0 listen 0 080.11.198.2 21 172.18.48.194 38668 establish 62 29880.11.198.2 23 0.0.0.0 0 listen 0 080.11.198.2 23 172.18.48.194 38666 establish 124 1196680.11.198.2 1025 0.0.0.0 0 listen 0 080.11.198.2 1025 172.18.48.194 38705 closeWait 24 180.11.198.3 7 0.0.0.0 0 listen 0 080.11.198.3 9 0.0.0.0 0 listen 0 080.11.198.3 19 0.0.0.0 0 listen 0 080.11.198.3 21 0.0.0.0 0 listen 0 080.11.198.3 23 0.0.0.0 0 listen 0 080.11.198.3 23 172.18.48.194 38667 establish 85 446describes the fields shown in the display.
The following is sample output for the show extended channel tcp-connections summary command:
Router# show extended channel 0/1 tcp-connections summaryTCP Connections=12 Input Bytes= 294 Output Bytes= 13049Related Commands
You can use the master indexes or search online to find documentation of related commands.
pu (DLUR)
pu (DLUR)
offload
show extended channel tcp-stackshow extended channel tcp-stack
Use the show extended channel tcp-stack privileged EXEC command to display information about the TCP stack running on the CIP interfaces in a Cisco 7000 with RSP7000 and Cisco 7500 series.
show extended channel slot/port tcp-stack [ip-address]
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Sample Display
The following is sample output from the show channel tcp-stack command:
router# show extended channel tcp-stackTCP Statistics for IP Address 198.92.1.120RtoAlgorithm: other RtoMin : 101 RtoMax : 102MaxConn : 103 ActiveOpens : 104 PassiveOpens: 105AttemptFails: 106 EstabResets : 107 CurrEstab : 108InSegs : 109 OutSegs : 110 RetransSegs : 111InErrs : 112 OutRsts : 113TCP Statistics for IP Address 198.92.1.121RtoAlgorithm: constant RtoMin : 102 RtoMax : 103MaxConn : 104 ActiveOpens : 105 PassiveOpens: 106AttemptFails: 107 EstabResets : 108 CurrEstab : 109InSegs : 110 OutSegs : 111 RetransSegs : 112InErrs : 113 OutRsts : 114describes the fields shown in the display.
show extended channel tg
Use the show extended channel tg privileged EXEC command to display configuration, operational information, and statistics information for CMPC transmission groups configured on the specified CIP internal LAN interface.
show extended channel slot/2 tg [oper | stats] [detailed] [tg-name]
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 BC.
If neither the oper or stats arguments are specified, operational values will be displayed.
Sample Displays
The following is sample output on a Cisco 7500 router from the show extended channel tg oper command:
router# show extended channel 3/2 tg oper detailed MVS2-TG1CMPC-TG: MVS2-TG1 Status: ACTIVEAdapter:token 1 RMAC:4000.4040.1996 LSAP:04 RSAP:04TGN :21 Local CP: NETA.MVS2 Remote CP: NETA.CALEBMaxIn :4105 MaxOut :4105HPR :NO HPR LSAP:04 HPR RSAP :00RIF :0830.1FF1.0041.00A0Connection LLC2 Information:t1-time = 1000 tpf-time = 1000 trej-time = 3200 tbusy-tim = 9600idle-time =60000 local-win = 7 recv-wind = 7 N2 = 8N1-Send = 1033 N1-Rcv = 1033 ack-delay = 100 ack-max = 3Nw = 0 Ww = 7Last Ww Cause = otherConnection Time: 00:00:00 UTC Jan 1 1970Last modified: 00:00:00 UTC Jan 1 1970describes the fields shown in the display.
The following is sample output on a Cisco 7500 router from the show extended channel tg stats command:
router# show extended channel 3/2 tg stats detail MVS2-TG1CMPC-TG:MVS2ISR1IFramesIn :51 IFramesOut :41IBytesIn :4378 IBytesOut :51803UIFramesIn :0 UIFramesOut :0UIBytesIn :0 UIBytesOut :0TESTRspsIn :1 TESTCmdsOut :1XIDCmdsIn :3 XIDCmdsOut :3XIDRspsIn :0 XIDRspsOut :0ConnectReqs :2 ConnectInds :0ConnectRsps :2 ConnectCnfms:0DISCReqs :1 DISCInds :0SweepReqsIn :0 SweepReqsOut:0SweepRspsIn :0 SweepRspsOut:0Wraps :0LastSeqNoIn :9 LastSeqNoOut:7LastSeqNoFailureCause : NoneTimeSinceLastSeqNoFailure : neverLLC2 Connection Statistics:LAN Token 0 Adapter 1 4000.cdcd.cdcdLocal SAP=04 Remote MAC=4000.4040.1996 Remote SAP=04LocalBusies = 0 RemoteBusies = 0IFramesIn = 51 IFramesOut = 41IOctetsIn = 4378 IOctetsOut = 51803SFramesIn = 0 SFramesOut = 0REJsIn = 0 REJsOut = 0RetransmitsOut = 0 WwCountChanges = 0The following is sample output on a Cisco 7500 router from the show extended channel tg stats command when the interface is shut down:
router# show extended channel 3/2 tg stats detail MVS2-TG1CIP LLC-TG:MVS2ISR1 -Statistics Not Availabledescribes the fields shown in the display.
show extended channel tn3270-server
Use the show extended channel tn3270-server privileged EXEC command to display current server configuration parameters and the status of the PUs defined in each TN3270 server.
show extended channel slot/2 tn3270-server
Syntax Description
slot/2
Specifies a particular CIP in the router where slot is the slot number. The port value for a TN3270 server is always 2.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
Sample Display
The following is sample output on the Cisco 7000 with RSP7000 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 tcp172.28.1.106:23 510 1 12 11 0 54 40172.28.1.107:23 511 0 0 0 0 0 0172.28.1.108:23 255 0 0 0 0 0 0total 1276 1configured max_lu 20000idle-time 0 keepalive 1800 unbind-action disconnecttcp-port 23 generic-pool permit no timing-markdlur MPX.GOANCP status NOTQRYD SHUTdlus MPX.NGMVMPCname(index) ip:tcp xid state link destination r-lsapEXT2(1) 172.28.1.106:23 05D18092 ACTIVE tok 0 4000.7470.00e7 08 04PUS10(2) 172.28.1.107:23 05D19010 ACTIVE tok 0 4000.7470.00e7 08 2CPUS11(3) 172.28.1.107:23 05D19011 ACTIVE tok 0 4000.7470.00e7 08 28PUS12(4) 172.28.1.108:23 05D19012 ACTIVE tok 0 4000.7470.00e7 08 24PUS9(5) 172.28.1.109:23 05D18509 SHUT tok 0 4001.3745.1088 04 40SDTF(7) 172.28.1.107:23 12345678 ACTIVE tok 0 0800.5a4b.1cbc 04 08TEST(8) 172.28.1.106:23 05D18091 ACTIVE tok 0 4000.7470.00e7 08 30INT1(6) 172.28.1.106:23 05D18091 SHUT dlurdescribes significant fields in the display. Those fields not described correspond to configured values.
show extended channel tn3270-server client-ip-address
Use the show extended channel tn3270-server client-ip-address privileged EXEC command to display information about all clients at a specific IP address.
show extended channel slot/2 tn3270-server client-ip-address ip-address [disconnected |
in-session | pending]Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
Note that this command does not show information about LUs that have never been connected.
Sample Displays
The following is sample output on the Cisco 7000 with RSP7000 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.
router# show extended channel 3/2 tn3270-server client-ip 192.195.80.40lu name client-ip:tcp nail state model frames in out idle for1 PUS11001 192.195.80.40:3169 Y ACT/SESS 327804 5 5 0:5:47pu is PUS11, lu is DYNAMIC type 2, negotiated TN3270bytes 155 in, 1758 out; RuSize 1024 in, 3840 out; NegRsp 0 in, 0 outpacing window 0 in, 1 out; credits 0 in, queue-size 0 in, 0 outThe following is sample output using the disconnected argument:
Router# show extended channel 2/2 tn3270 client-ip 10.14.1.21 disconnectedTotal 2 clients found using 10.14.1.21The following is sample output using the in-session argument:
Router# show extended channel 2/2 tn3270 client-ip 10.14.1.21 in-sessionNote: if state is ACT/NA then the client is disconnectedlu name client-ip:tcp nail state model frames in out idle for3 PU1L03 10.14.1.21:35215 N ACT/SESS 327804 317 316 0:0:1pu is PU1, lu is DYNAMIC type 2, negotiated TN3270bytes 12167 in, 225476 out; RuSize 2048 in, 1536 out; NegRsp 0 in, 0 outpacing window 0 in, 1 out; credits 0 in, queue-size 0 in, 0 outNote: if state is ACT/NA then the client is disconnectedlu name client-ip:tcp nail state model frames in out idle for4 PU1L04 10.14.1.21:35216 N ACT/SESS 327804 317 316 0:0:1pu is PU1, lu is DYNAMIC type 2, negotiated TN3270bytes 12167 in, 225476 out; RuSize 2048 in, 1536 out; NegRsp 0 in, 0 outpacing window 0 in, 1 out; credits 0 in, queue-size 0 in, 0 outNote: if state is ACT/NA then the client is disconnectedTotal 2 clients found using 10.14.1.21The following is sample output using the pending argument:
Router# show extended channel 2/2 tn3270 client-ip 10.14.1.21 pendingTotal 2 clients found using 10.14.1.21describes significant fields in the display.
show extended channel tn3270-server dlur
Use the show extended channel tn3270-server dlur privileged EXEC command to display information about the SNA session switch.
show extended channel slot/2 tn3270-server dlur
Syntax Description
slot/2
Specifies a particular CIP in the router where slot is the slot number. The port value for a TN3270 server will always be 2.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
Sample Display
The following is sample output on the Cisco 7000 with RSP7000 from the show extended channel tn3270-server dlur command:
router# show extended channel 3/2 tn3270-server dlurdlur MPX.GOANCPcurrent dlus MPX.NGMVMPC dlur-dlus status ACTIVEpreferred dlus MPX.NGMVMPC backup dlus MPX.NGMVMPBpreferred server MPX.NGMVMPAlsap token-adapter 0 5C vrn MPX.LAN4 status ACTIVElink P390 remote 4000.7470.00e7 08 status ACTIVE
describes significant fields in the display.
show extended channel tn3270-server dlurlink
Use the show extended channel tn3270-server dlurlink privileged EXEC command to display information about the DLUR components.
show extended channel slot/2 tn3270-server dlurlink name
Syntax Description
slot/2
Specifies a particular CIP in the router where slot is the slot number. The port value for a TN3270 server will always be 2.
name
Name of the SNA session switch link to be displayed.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
Sample Display
The following is sample output on the Cisco 7000 with RSP7000 from the show extended channel tn3270-server dlurlink command:
router# show extended channel 3/2 tn3270-server dlurlink P390lsap token-adapter 0 5C vrn MPX.LAN4 status ACTIVElink P390 remote 4000.7470.00e7 08 status ACTIVEpartner MPX.NGMVMPC tgn 1 maxdata 1033describes significant fields in the display.
show extended channel tn3270-server nailed-ip
Use the show extended channel tn3270-server nailed-ip privileged EXEC command to display mappings between a nailed client IP address and nailed LUs.
show extended channel slot/2 tn3270-server nailed-ip ip-address
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 BC.
Sample Displays
The following is sample output on the Cisco 7000 with RSP7000 from the show extended channel tn3270-server nailed-ip command:
router# show extended channel 3/2 tn3270-server nailed-ip 172.28.0.0172.28.1.0 255.255.255.192 pu BAGE1 lu 1 50172.28.1.80 255.255.255.248 pu BAGE2 lu 100 200 printer172.28.1.83 pu BAGE3 lu 1 60 printer172.28.1.82 pu BAGE1 lu 100 200
show extended channel tn3270-server pu
Use the show extended channel tn3270-server pu privileged EXEC command to display the PU configuration parameters, statistics and all the LUs currently attached to the PU.
show extended channel slot/2 tn3270-server pu pu-name
Syntax Description
Command Mode
Privileged EXEC
Usage Guideline
This command first appeared in Cisco IOS Release 11.2.
The display shown depends on whether the PU is a direct PU or a SNA session switch PU.
Sample Displays
The following is sample output on the Cisco 7000 with RSP7000 from the show extended channel tn3270-server pu command for a direct PU:
router# show extended channel 3/2 tn3270-server pu BAGE1name(index) ip:tcp xid state link destination r-lsapBAGE1(1) 172.28.1.82:23 05D18081 ACTIVE tok 0 4000.7470.00e7 08 10idle-time 0 keepalive 1800 unbind-act discon generic-pool permbytes 560 in, 3765 out; frames 20 in, 27 out; NegRsp 0 in, 0 outactlus 12, dactlus 0, binds 2lu name client-ip:tcp nail state model frames in out idle for1 BAGE1001 never connected Y ACTIVE 1 1 4:50:442 BAGE1002 never connected Y ACTIVE 1 1 4:50:443 BAGE1003 192.195.80.40:2077 N ACT/SESS 327804 5 5 5:4:364 BAGE1004 192.195.80.40:2644 Y ACTIVE 327804 5 5 0:36:7client ip mask nail-type lu first lu last192.195.80.40 255.255.255.0 screen 1 2192.195.80.40 255.255.255.0 printer 4The following is sample output on the Cisco 7000 with RSP7000 from the show extended channel tn3270-server pu command for a SNA session switch PU:
router# show extended channel 3/2 tn3270-server pu INT1name(index) ip:tcp xid state link destination r-lsapINT1(5) 172.28.1.106:23 05D18091 ACTIVE dlur MPX.GOAN1idle-time 0 keepalive 0 unbind-act discon generic-pool permbytes 50 in, out; frames 87 in, 2 out; NegRsp 3 in, 0 outactlus 2, dactlus 0, binds 0lu name client-ip:tcp state model frames in out idle for1 GOAN1X01 never connected ACTIVE 1 1 0:32:142 GOAN1X02 never connected ACTIVE 1 1 0:32:14describes significant fields in the display.
show extended channel tn3270-server pu lu
Use the show extended channel tn3270-server pu lu privileged EXEC command to display information about the TN3270 server LUs running on CIP interface in a Cisco 7000 with RSP7000 and Cisco 7500 series.
show extended channel slot/2 tn3270-server pu pu-name lu locaddr [history]
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
Sample Displays
The following is sample output on the Cisco 7000 with RSP7000 from the show extended channel tn3270-server pu lu command for a direct PU:
router# show extended channel 3/2 tn3270 pu ext2 lu 3lu name client-ip:tcp state model frames in out idle for3 EXT2003 171.69.176.77:3829 ACTIVE 327902E 8 9 0:4:43pu is EXT2, lu is DYNAMIC type 0, negotiated TN3270bytes 203 in, 2954 out; RuSize 0 in, 0 out; NegRsp 1 in, 0 outpacing window 0 in, 1 out; credits 0 in, queue-size 0 in, 0 outThe following is sample output on the Cisco 7000 with RSP7000 from the show extended channel tn3270-server pu lu command for a SNA session switch PU:
router# show extended channel 3/2 tn3270 pu int1 lu 1lu name client-ip:tcp state model frames in out idle for1 GOAN1X01 171.69.176.77:3828 ACTIVE 4 4 0:4:51pu is INT1, lu is STATIC type 0, negotiated TN3270Ebytes 74 in, 1219 out; RuSize 0 in, 0 out; NegRsp 0 in, 0 outpacing window 0 in, 0 out; credits 0 in, queue-size 0 in, 0 outThe following is sample output on the Cisco 7000 with RSP7000 from the show extended channel tn3270-server pu lu history command:
router# show extended channel 3/2 tn3270 pu pus20 lu 1 historylu name client-ip:tcp state model frames in out idle for1 PUS20001 192.195.80.40:2480 ACT/SESS 327804 5 4 0:0:8pu is PUS20, lu is DYNAMIC type 2, negotiated TN3270bytes 155 in, 1752 out; RuSize 1024 in, 3840 out; NegRsp 0 in, 0 out>pacing window 0 in, 1 out; credits 0 in, queue-size 0 in, 0 outtraces:Client connect reqReply PSID pos rspactlu reqbind reqsdt reqOUT len=12 2Dxxxxxxxx456B80000D0201IN len=25 xxxxxxxxxx45EB80000D0201000000OUT len=53 2Dxxxxxxxx466B800031010303B1IN len=10 2D0001010646EB800031OUT len=10 2D00010106476B8000A0IN len=10 2D0001010647EB8000A0OUT len=1677 2Cxxxxxxxx010381C07EC7114040IN len=9 2C0001010001838100describes significant fields in the display.
show extended channel udp-listeners
Use the show extended channel udp-listeners privileged EXEC command to display information about the User Datagram Protocol (UDP) listener sockets running on the CIP interfaces in a Cisco 7000 with RSP7000 and Cisco 7500 series.
show extended channel slot/port udp-listeners [ip-address]
Syntax Description
slot
Slot number.
port
Port number.
udp-listeners
Specifies UDP listener port display.
ip-address
(Optional) Offload or TN3270-server IP address.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Sample Display
The following is sample output from the show channel udp-listeners command:
router# show extended channel 4/0 udp-listeners 198.92.1.120UDP Listener: IP Address 198.92.1.120 LocalPort 0UDP Listener: IP Address 198.92.1.120 LocalPort 1UDP Listener: IP Address 198.92.1.120 LocalPort 2UDP Listener: IP Address 198.92.1.120 LocalPort 3UDP Listener: IP Address 198.92.1.120 LocalPort 4router# show extended channel 4/0 udp-listeners 198.92.1.121UDP Listener: IP Address 198.92.1.121 LocalPort 0UDP Listener: IP Address 198.92.1.121 LocalPort 1UDP Listener: IP Address 198.92.1.121 LocalPort 2UDP Listener: IP Address 198.92.1.121 LocalPort 3UDP Listener: IP Address 198.92.1.121 LocalPort 4show extended channel udp-stack
Use the show extended channel udp-stack privileged EXEC command to display information about the UDP stack running on the CIP interfaces in a Cisco 7000 with RSP7000 and Cisco 7500 series.
show extended channel slot/port udp-stack [ip-address]
Syntax Description
slot
Slot number.
port
Port number.
udp-stack
Selects UDP stack display.
ip-address
(Optional) Offload or TN3270-server IP address.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Sample Display
The following is sample output from the show extended channel udp-stack command:
router# show extended channel udp-stackUDP Statistics for IP Address 198.92.1.120InDatagrams : 300 NoPorts : 301InErrors : 302 OutDatagrams: 303UDP Statistics for IP Address 198.92.1.121InDatagrams : 301 NoPorts : 302InErrors : 303 OutDatagrams: 304describes the fields shown in the display.
Related Commands
You can use the master indexes or search online to find documentation of related commands.
pu (direct)
pu (DLUR)
offloadshow interfaces channel
Use the show interfaces channel privileged EXEC command to display information about the CIP interfaces on the Cisco 7000 with RSP7000 and Cisco 7500 series. This command displays information that is specific to the interface hardware. The information displayed is generally useful for diagnostic tasks performed by technical support personnel only.
show interfaces channel slot/port [accounting]
Syntax Description
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 10.3.
Sample Display
The following is sample output on the Cisco 7000 with RSP7000 from the show interfaces channel command:
Router# show interfaces channel 3/0Channel3/0 is up, line protocol is upHardware is cxBus IBM ChannelInternet address is 198.92.1.145, subnet mask is 255.255.255.248MTU 4096 bytes, BW 0 Kbit, DLY 0 usec, rely 255/255, load 1/255Encapsulation CHANNEL, loopback not set, keepalive not setECA type daughter cardData transfer rate 12 Mbytes Number of subchannels 1Last input never, output never, output hang neverLast clearing of "show interface" counters 0:00:04Output queue 0/0, 0 drops; input queue 0/75, 0 dropsFive minute input rate 0 bits/sec, 0 packets/secFive minute output rate 0 bits/sec, 0 packets/sec0 packets input, 0 bytes, 0 no bufferReceived 0 broadcasts, 0 runts, 0 giants0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort0 packets output, 0 bytes, 0 underruns0 output errors, 0 collisions, 0 interface resets, 0 restartsdescribes the fields shown in the display.
shutdown
Use the shutdown interface configuration command to shutdown a physical interface or the internal LAN interface on the CIP when you are in interface configuration mode. The shutdown command also shuts down TN3270 entities, such as PU, DLUR, and DLUR SAP, depending on which configuration mode you are in when the command is issued. Use the no form of this command to restart the interface or entity. The entity affected depends on the mode in which the command is issued.
shutdown
no shutdownSyntax Description
This command has no arguments or keywords.
Default
The interface or entity is enabled.
Command Modes
CIP interface configuration
TN3270 configuration
PU configuration
DLUR configuration
DLUR SAP configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
In CIP interface configuration mode, the command applies to the entire CIP.
In TN3270 configuration mode, the command applies to the whole TN3270 Server.
In PU configuration mode, the command applies to the DLUR or direct PU.
In DLUR configuration mode, the command applies to the whole DLUR subsystem.
In DLUR SAP configuration, mode the command applies to the local SAP.
Example
The following command issued in TN3270 configuration mode shuts down the entire TN3270 server:
shutdowntcp-port
Use the tcp-port TN3270 configuration command to override the default TCP port setting of 23. Use the no form of this command to restore the default.
tcp-port port-number
no tcp-portSyntax Description
port-number
A valid TCP port number in the range of 0 to 65534. The default is 23, which is the IETF standard. The value 65535 is reserved by the TN3270 server.
Defaults
In TN3270 configuration mode, the default is 23.
In PU configuration mode the default is the value currently configured in TN3270 configuration mode.
Command Modes
TN3270 configuration
PU configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
The tcp-port command can be entered in either TN3270 configuration mode or PU configuration mode. A value entered in TN3270 mode applies to all PUs for that TN3270 server, except as overridden by values entered in PU configuration mode. The tcp-port command affects only future TN3270 sessions.
The no tcp-port command entered in PU configuration mode removes the override.
Example
The following command entered in TN3270 configuration mode returns the TCP port value to 23:
no tcp-porttg
Use the tg interface configuration command to define LLC connection parameters for the CMPC transmission group. Use the no form of this command to remove the specified transmission group from the configuration, which also deactivates the transmission group.
tg name llc type adapter-number lsap [rmac rmac] [rsap rsap]
no tg nameSyntax Description
Default
The lsap and rsap values default to 04.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2 BC.
The tg command defines an LLC connection with a complete addressing 4-tuple. The lsap, rmac, and rsap are specified explicitly by parameters. The lmac is the local MAC address of the adapter referred to by the type and adapter-number parameters.
To change any parameter of the tg command, the TG must be removed by using no tg name.
The no tg command removes the CMPC transmission group from the configuration. If the transmission group is used for a non-HPR connection, all sessions using the TG will be terminated immediately. If the transmission group is an HPR connection, all sessions using the transmission group will be terminated if no other HPR connection is available to the host.
This command is valid only on the CIP internal interface, slot/2.
Example
The following example configures a transmission group name and includes the rmac and rsap parameters:
tg LAGUNAA llc token-adapter 1 18 rmac 4000.0000.beef rsap 14Related Commands
You can use the master indexes or search online to find documentation of related commands.
tn3270-server
Use the tn3270-server interface configuration command to start the TN3270 server on a CIP or to enter TN3270 configuration mode. Use the no form of this command to disable all TN3270 server activity on a CIP.
tn3270-server
no tn3270-serverSyntax Description
This command has no arguments or keywords.
Default
No TN3270 server function is enabled.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
Only one TN3270 server can run on a CIP. It will always be configured on port 2, which is the internal LAN interface port.
The no tn3270-server command shuts down TN3270 server immediately. All active sessions will be disconnected and all DLUR and PU definitions deleted from the router configuration. To restart a TN3270 server, you must reconfigure all parameters.
Example
The following command starts the TN3270 server and enters TN3270 configuration mode:
tn3270-servertiming-mark
Use the timing-mark TN3270 configuration mode command to select whether a WILL TIMING-MARK is transmitted when the host application needs an SNA response (definite or pacing response). Use the no form of the command to turn off WILL TIMING-MARK transmission except as used by the keepalive function.
timing-mark
no timing-markSyntax Description
This command has no arguments or key words.
Default
No WILL TIMING-MARKS are transmitted except by keepalive.
Command Mode
TN3270 configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
If timing-mark is configured the TN3270 server will send WILL TIMING-MARK as necessary to achieve an end-to-end response protocol. Specifically, TIMING-MARK will be sent if any of the following are true:
•
•
The use of the timing-mark command can degrade performance. Some clients do not support timing-mark used in this way. Therefore, timing-mark should only be configured where both of the following are true:
•
•
Example
The following command enables TIMING-MARK transmission:
timing-markRelated Commands
unbind-action
Use the unbind-action TN3270 configuration command to select what action to take when the TN3270 server receives an UNBIND. Use the no form of this command to restore the default.
unbind-action {keep | disconnect}
no unbind-actionSyntax Description
keep
No automatic disconnect will be made by the server upon receipt of an UNBIND.
disconnect
Session will be disconnected upon receipt of an UNBIND.
Defaults
In TN3270 configuration mode, the default is disconnect.
In PU configuration mode the default is the value currently configured in TN3270 configuration mode.
Command Modes
TN3270 configuration
PU configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
The unbind-action command can be entered in either TN3270 configuration mode or PU configuration mode. A value entered in TN3270 mode applies to all PUs for that TN3270 server, except as overridden by values entered in PU configuration mode. The unbind-action command affects currently active and future TN3270 sessions.
The no unbind-action command entered in PU configuration mode removes the override.
The unbind-action command affects currently active and future TN3270 sessions.
Example
The following command prevents automatic disconnect:
unbind-action keepvrn
Use the vrn DLUR SAP configuration command to tell the SNA session switch which connection network the internal adapter interface on the CIP card belongs to. Use the no form of this command to remove a network name.
vrn vrn-name
no vrnSyntax Description
Default
The adapter is not considered to be part of a connection network.
Command Mode
DLUR SAP configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
The vrn command is used to discover routes without having to configure all possible links.
A connection network is also known as a shared-access transport facility (SATF). This means, at the MAC level, that all nodes in the network can reach each other using the same addressing scheme and without requiring the services of SNA session routing. A bridged LAN (whether source-route or transparent) is an example. Such a network is represented in the APPN topology as a kind of node, termed a virtual routing node (VRN).
To make use of this function, all APPN nodes must use the same VRN name for the SATF.
Refer to the VTAM operating system documentation for your host system for additional information regarding the VTAM VNGROUP and VNNAME parameters on the PORT statement of an XCA major node.
Several parameters in the DLUR configuration mode consist of fully qualified names, as defined by the APPN architecture. Fully qualified names consist of two case-insensitive alphanumeric strings, separated by a period. However, for compatibility with existing APPN products, including VTAM, the characters "#" (pound), "@" (at), and "$" (dollar) are allowed in the fully qualified name strings. Each string is from one to eight characters long; for example, RA12.NODM1PP. The portion of the name before the period is the NETID and is shared between entities in the same logical network.
Example
The following command sets a VRN name for the TN3270 internal adapter on the CIP:
vrn SYD.BLAN25Related Commands
adapter
lan
