Cisco Mainframe Channel Connection Commands

Note   Unless otherwise specified, all commands in this chapter are supported on the Cisco 7000 with RSP7000, Cisco 7500 and the Cisco 7200 series routers.

For interface configuration information and examples, refer to the "Configuring Cisco Mainframe Channel Connection Adapters" chapter of the 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.

Syntax Description

adapter-number	Number in the range 0 to 31 that uniquely identifies the internal adapter (relative adapter number) for all internal LANs of the same type on the CMCC adapter. When configuring CSNA, this value corresponds to the ADAPNO parameter defined in the Virtual Telecommunications Access Method (VTAM) Extended Communications Adapter (XCA) Major Node.
mac-address	(Optional) Media access control (MAC) address for this internal adapter. This is a hexadecimal value in the form xxxx.xxxx.xxxx.

Defaults

This command has no defaults.

Command Modes

Internal LAN interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

This command is valid only on the virtual channel interface. Internal adapters are used to provide LAN gateway MAC addresses for the following CMCC adapter features: CSNA, CMPC, and TN3270-Server.

Up to 18 internal adapters can be configured on a CMCC adapter. Internal adapters are configured on internal LANs. The only limit to the number of internal adapters you can configure on a single internal LAN is the limit of up to 18 total internal adapters per CMCC.

When removing an internal adapter configuration command or modifying an existing internal adapter, the mac-address parameter is not required. When in internal adapter configuration mode, the router prompt appears as follows:

router(cfg-adap-type n-m)#
 

In this syntax, type is the internal LAN type, n is the lan-id, and m is the adapter-number.

Examples

Following is an example:

interface channel 1/2
 lan tokenring 20
  adapter 3 4000.7500.0003
  adapter 4 4000.7500.0004
 lan tokenring 10
  source-bridge 100 1 2000
  adapter 1 4000.7500.1111

Related Commands

Command	Description
lan	Configures an internal LAN on a CMCC adapter interface and enters the internal LAN configuration mode.
name	Assigns a name to the internal adapter.
source-bridge	Configures an interface for SRB.
show extended channel lan	Displays the internal LANs and adapters configured on a CMCC adapter.
show extended channel llc2	Displays information about the LLC2 sessions running on the CMCC adapter interfaces.
show extended channel connection-map llc2	Displays the number of active LLC2 connections for each SAP and the mapping of the internal MAC adapter and the SAP to the resource that activated the SAP.

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.

Defaults

If no value is specified, the default data rate for the PCA is 3 megabytes per second.

Command Modes

Interface configuration

Command History

Release	Modification
10.2	This command was introduced.

Usage Guidelines

This command is valid on Parallel Channel Interfaces.

Examples

The following example specifies a data rate of 4.5 megabytes per second for the interface:

channel-protocol s4

Syntax Description

path	Hexadecimal value in the range 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 IOCP, the default values for channel logical address and control unit logical address is 0.
device-address	Hexadecimal value in the range 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 value.
ip-address	IP address specified in the HOME statement of the host TCP/IP application configuration file.
host-name	Host name specified in the device statement in the host TCP/IP application configuration file.
device-name	CLAW workstation name specified in the device statement in the host TCP/IP application configuration file.
host-app	Host application name as specified in the host application file. If connected to the IBM TCP host offerings, or if the CLAW packing feature is not enabled on the mainframe TCPIP stack, this value will be tcpip, which is the constant specified in the host TCP/IP application file. When attached to other applications, this value must match the value hard coded in the host application. PACKED is another value that can be used for the host-app parameter to enable the CLAW packing feature.
device-app	CLAW workstation application specified in the host TCPIP application. If connected to the IBM TCP host offerings, or if the CLAW packing feature is not enabled on the mainframe TCPIP stack, this value will be tcpip, which is the constant specified in the host TCP/IP application file. When attached to other applications, this value must match the value hard coded in the host application. PACKED is another value that can be used for the device-app parameter to enable the CLAW packing feature.
broadcast	(Optional) Enables broadcast processing for this subchannel.
backup	(Optional) Enables this CLAW connection to be used as part of a backup group of CLAW connections for the specified IP address.

Defaults

This command has no defaults.

Command Modes

Interface configuration

Command History

Release	Modification
10.2	This command was introduced.
12.0	These options were added: packed backup

Usage Guidelines

This command defines information that is specific to the hardware interface and the IBM channels supported on the interface. When used with the path command, the claw command provides a quick way to configure a CLAW backup group.

CLAW devices are used to switch IP packets between a mainframe and a channel-attached router.

At most, 128 statements can be configured per interface because each interface is limited to 256 subchannels. Each CLAW device uses a read channel and a write channel. There is also a restriction of 64 unique paths.

A limit of 32 CLAW device configuration commands is recommended.

Duplicate IP addresses are invalid for nonbackup configurations.

Duplicate IP addresses are permitted if they appear within a backup group of only claw or offload interface configuration commands. All configuration commands in one backup group must specify the backup keyword.

You can use the path interface configuration command to specify a number of paths that belong to a backup group. In that case, a claw IP host backup configuration command is used that needs no path variable or backup keyword.

Examples

The following example shows how to enable IBM channel attach routing on channel interface 3/0, which is supporting an ESCON direct connection to the mainframe:

interface channel 3/0
ip address 172.18.4.49 255.255.255.248
claw c020 F4 172.18.4.52 HOSTB RTRA TCPIP TCPIP
 

The following example shows how to enable CLAW packing:

interface Channel 3/0
ip address 172.18.4.49 255.255.255.248
claw c010 F2 172.18.4.50 HOSTA RTRA PACKED PACKED
 

The following example shows how an IP host backup group is specified using the backup keyword:

interface Channel3/0
 no ip address
 no keepalive
 no shutdown 
 claw 0100 C0 10.30.1.2 CISCOVM EVAL TCPIP TCPIP backup
 claw 0110 C0 10.30.1.2 CISCOVM EVAL TCPIP TCPIP backup
 claw 0120 C0 10.30.1.2 CISCOVM EVAL TCPIP TCPIP backup
 claw 0110 C2 10.30.1.3 CISCOVM EVAL TCPIP TCPIP

Related Commands

Command	Description
claw (IP-host-backup)	Configures a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. Can also be used to configure individual members of a CLAW backup group for the IP Host Backup feature.
offload (interface)	Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. Also can be used to configure individual members of an Offload backup group for the IP Host Backup feature.
offload (IP-host-backup)	Specifies one or more data paths for the IP host backup.
show extended channel packing names	Displays CLAW packing names and their connection state.
show extended channel packing stats	Displays CLAW packing statistics.
show extended channel subchannel	Displays information about the CMCC adapter physical interfaces and displays information that is specific to the interface channel connection.The information displayed generally is useful only for diagnostic tasks performed by technical support personnel.
show extended channel statistics	Displays statistical information about subchannels on the physical interface of a CMCC adapter and displays information that is specific to the interface channel devices.The information generally is useful only for diagnostic tasks performed by technical support personnel.

Syntax Description

path	Hexadecimal value in the range 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 IOCP, the default values for channel logical address and control unit logical address is 0.
device-address	Hexadecimal value in the range 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 value.
host-name	Host name specified in the device statement in the host TCP/IP application configuration file.
device-name	CLAW workstation name specified in the device statement in the host TCP/IP application configuration file.
host-app	Host application name as specified in the host application file. When connected to the IBM TCP host offerings, this value will be tcpip, which is the constant specified in the host TCP/IP application file. When attached to other applications, this value must match the value hard coded in the host application.
device-app	CLAW workstation application specified in the host TCPIP application. When connected to the IBM TCP host offerings, this value will be tcpip, which is the constant specified in the host TCP/IP application file. When attached to other applications, this value must match the value hard coded in the host application.
broadcast	(Optional) Enables broadcast processing for this subchannel.

Defaults

This command has no defaults.

Command Modes

IP host backup configuration

Command History

Release	Modification
12.0	This command was introduced.

Usage Guidelines

This command defines information that is specific to the hardware interface and the IBM channels supported on the interface.

CLAW devices are used to switch IP packets between a mainframe and a channel-attached router.

At most, 128 statements can be configured per interface because each interface is limited to
256 subchannels. Each CLAW device uses a read channel and a write channel. There is also a restriction of 64 unique paths.

A limit of 32 CLAW device configuration commands is recommended.

Duplicate IP addresses are invalid for non-backup configurations.

Duplicate IP addresses are permitted if they appear within a backup group of only claw or offload interface configuration commands. All configuration commands in one backup group must specify the backup keyword.

You can use the path interface configuration command to specify a number of paths that belong to a backup group. In that case, a claw IP host backup configuration command is used that needs no path variable or backup keyword.

Examples

The following examples show two methods for entering the same IP host backup group information. The first group of commands is the long form, using the claw interface configuration command. The second group is the shortcut, using the path interface configuration command and a claw IP host backup configuration command.

Long form:

claw c000 00 198.92.10.5 sysa router1 tcpip tcpip backup
claw c100 00 198.92.10.5 sysa router1 tcpip tcpip backup
claw c200 00 198.92.10.5 sysa router1 tcpip tcpip backup
 

Shortcut form:

path c000 c100 c200
  claw 00 198.92.10.5 sysa router1 tcpip tcpip

Related Commands

Command	Descirption
claw (interface)	Configures a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in IP Datagram mode.Can also be used to configure individual members of a CLAW backup group for the IP Host Backup feature.
offload (interface)	Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. Also can be used to configure individual members of an Offload backup group for the IP Host Backup feature.
offload (IP-host-backup)	Specifies one or more data paths for the IP host backup.
show extended channel packing names	Displays CLAW packing names and their connection state.
show extended channel packing stats	Displays CLAW packing statistics.
show extended channel subchannel	Displays information about the CMCC adapter physical interfaces and displays information that is specific to the interface channel connection.The information displayed generally is useful only for diagnostic tasks performed by technical support personnel.
show extended channel statistics	Displays statistical information about subchannels on the physical interface of a CMCC adapter and displays information that is specific to the interface channel devices.The information generally is useful only for diagnostic tasks performed by technical support personnel.

Syntax Description

ip	(Optional) IP address of the client. The ip value is optional when setting the maximum number of LU sessions. If no IP address is specified then the limit is applied to all clients.
ip-mask	(Optional) IP network mask for the client. The default is 255.255.255.255
number	(Optional and ignored in no form of the command). Maximum number of LU sessions. The allowed value is from 0 to 65535.

Defaults

The default is that there is no limit on the number of concurrent sessions from one client IP address.

In the no form of this command, the default number is 65535.

Command Modes

TN3270 server configuration

Command History

Release	Modification
12.0	This command was introduced.

Usage Guidelines

This command is valid only on the virtual channel interface. 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 2
 

then it will be stored (and subsequently displayed by write term) as:

client 10.1.1.0 255.255.255.192 lu maximum 2
 

The 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 2
 

The 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 3
 

The 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 4
client 10.1.1.64 255.255.255.192 lu maximum 5
 

The following example prevents an LU session for the client at IP address 10.1.1.28:

client 10.1.1.28 lu maximum 0

Related Commands

Command	Description
maximum-lus	Limits the number of LU control blocks that will be allocated for TN3270 server use.

Syntax Description

printer	(Optional) Specifies that a client connection from the nailed IP addresses will be nailed to one of the specified LUs only if the client-session negotiates a model type of 328n, where n is any alphanumeric character. Moreover, it ensures that a printer matching the IP address condition can only use an LU nailed as a printer LU. If the printer keyword is not specified for any client statement that has this IP address set, all model types can use this range of LUs.
ip-address	Specifies remote client IP address.
ip-mask	(Optional) The mask applied to the remote device address. Multiple client IP addresses in the same subnet can be nailed to the same range of locaddrs.
first-locaddr	Defines a single locaddr to nail.
last-locaddr	(Optional) Defines the end range of inclusive locaddrs to be nailed from first-locaddr to last-locaddr.

Defaults

No LUs are nailed. They are all available to any client.

Command Modes

TN3270 PU configuration mode

Command History

Release	Modification
11.3	This command was introduced.

Usage Guidelines

This command is valid only on the virtual channel interface. 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 nonnailed 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/2
 tn3270-server
 pu BAGE4
  client ip 171.69.176.28 255.255.255.0 lu 1 50
 

In 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/2
 tn3270-server
 pu BAGE4
  client ip 171.69.176.28 255.255.255.0 lu 1 40
  client printer ip 171.69.176.28 255.255.255.0 lu 41 50
 

In 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/2
 tn3270-server
  pu BAGE4
  client printer ip 171.69.176.50 255.255.255.0 lu 1 100
  no client printer ip 171.69.176.50 255.255.255.0 lu 1
  %Invalid LU range specified
  no 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 printer 

Related Commands

Command	Description
pu (DLUR)	Creates a PU enity that has no direct link to a host, or enters PU configuartion mode.

Syntax Description

path	Hexadecimal value in the range 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 IOCP, the default values for channel logical address and control unit logical address is 0.
device	Hexadecimal value in the range of 00 to FF. This is the unit address associated with the control unit number and path as specified in the host IOCP file.
tg-name	The name of the CMPC transmission group. The maximum length of the name is 8 characters.
read	The same value read , as specified in the TRL major node.
write	The same value write, as specified in the TRL major node.

Defaults

No default is specified.

Command Modes

Interface configuration.

Command History

Release	Modification
11.3	This command was introduced.

Usage Guidelines

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 the TRL major node on the host. Configure the CMPC command on a CMCC adapter physical interface. Configure one read subchannel and one write subchannel. If CMPC is configured on a CMCC adapter with two physical interfaces, the read and write CMPC subchannels may be configured on separate physical interfaces.

The no cmpc command deactivates the CMPC subchannel. 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.

Examples

The following example configures a read and a write subchannel on path C020 for the CMPC transmission group named CONFIGE:

cmpc C020 F8 CONFIGE READ
cmpc C020 F9 CONFIGE WRITE

Related Commands

Command	Description
tg	Defines LLC connection parameters for the CMPC transmission group.
show extended channel cmpc	Displays information about each CMPC subchannel configured on the specified channel interface.
show extended channel tg	Displays configuration, operational information, and statistics information for CMPC transmission groups configured on the virtual interface of the specified CMCC adapter.
show extended channel subchannel	Displays information about the CMCC adapter physical interfaces and displays information that is specific to the interface channel connection.The information displayed generally is useful only for diagnostic tasks performed by technical support personnel.
show extended channel statistics	Displays statistical information about subchannels on the physical interface of a CMCC adapter and displays information that is specific to the interface channel devices.The information generally is useful only for diagnostic tasks performed by technical support personnel.

Syntax Description

path	Hexadecimal value in the range 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 IOCP, the default values for channel logical address and control unit logical address is 0.
device	Hexadecimal value in the range 00 to FF. This is the unit address associated with the control unit number and path as specified in the host IOCP file.
maxpiu value	(Optional) Maximum channel I/0 block size in bytes that is transmitted across the physical channel from the CMCC adapter to the attached mainframe. The range is 4096 to 65535 bytes. The default is 20470 bytes.
time-delay value	(Optional) Number of milliseconds a host-bound SNA frame may be delayed in order to maximize the channel I/0 block size. The range is 0 to 100 ms. The default is 10 ms.
length-delay value	(Optional) Amount of SNA frame data in bytes the CSNA subchannel accumulates before transmitting the accumulated channel I/0 block to the attached mainframe. The range is 0 to 65535 bytes. The default is 20470 bytes.

Defaults

maxpiu value: 20470 (0x4ff6) bytes

time-delay value: 10 ms

length-delay value: 20470 (0x4ff6) bytes

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

The parameters maxpiu, time-delay and length-delay control the characteristics of host-bound traffic for the CSNA subchannel. The channel protocol used by CSNA allows multiple SNA frames to be blocked into one channel I/0 block, reducing the channel bandwidth utilization and mainframe and CMCC adapter process utilization.

The maxpiu parameter allows you to set the maximum size of a host-bound channel I/0 block.

The time-delay parameter instructs the CSNA subchannel to delay sending the channel I/0 block for the specified time in milliseconds, from the time the first SNA packet is blocked. This can increase the network latency for an SNA packet by up to the specified time delay.

The length-delay parameter instructs the CSNA subchannel to delay sending the channel I/0 block until it contains the number of bytes specified by the length-delay parameter. An accumulated block is sent to the mainframe if one of the following conditions is true:

• the time-delay expires

• the channel I/0 block reaches the length-delay size

• channel I/0 block reaches the maxpiu size.

A time-delay value of 0 instructs the CSNA subchannel to send SNA packets to the mainframe as soon as they are received from the network. A length-delay value of 0 instructs the CSNA subchannel to ignore this parameter.

The no csna command deactivates and removes the CSNA subchannel configuration. It also deactivates all LLC2 sessions established over the subchannel.

Examples

The following example shows CSNA, offload, and CLAW configured on a channel interface. CSNA has no dependencies to CLAW, Offload, or CMPC.

interface channel 1/0
 no ip address
 no keepalive
 offload c700 c0 172.18.1.127 TCPIP OS2TCP TCPIP TCPIP TCPIP API
 claw C700 c2 172.18.1.219 EVAL CISCOVM AAA BBB
 csna c700 c4
 csna c700 c5 maxpiu 65535 time-delay 100 length-delay 65535
 csna c700 c6 maxpiu 65535 time-delay 100

Related Commands

Command	Description
lan	Configures an internal LAN on a CMCC adapter interface and enters the internal LAN configuration mode.
adapter	Configures internal adapters.
show extended channel csna	Displays information about the CSNA subchannels configured on the specified CMCC interface.
show extended channel connection-map llc2	Displays the number of active LLC2 connections for each SAP and the mapping of the internal MAC adapter and the SAP to the resource that activated the SAP.
show extended channel subchannel	Displays information about the CMCC adapter physical interfaces and displays information that is specific to the interface channel connection.The information displayed generally is useful only for diagnostic tasks performed by technical support personnel.
show extended channel statistics	Displays statistical information about subchannels on the physical interface of a CMCC adapter and displays information that is specific to the interface channel devices.The information generally is useful only for diagnostic tasks performed by technical support personnel.

Syntax Description

fq-cpname	(Optional) Fully qualified control point (CP) name used by the SNA session switch and the logical unit (LU) name for the DLUR function. This name must be unique among APPN nodes in the network including other fq-cpname values specified on all other TN3270 servers running under the Cisco IOS software.
fq-dlusname	(Optional) Fully qualified name of the primary choice for the dependent LU server (DLUS). This is the name of an LU, usually a CP, in an APPN host. The fq-dlusname value can be repeated and shared across servers.

Defaults

No DLUR function is enabled.

Command Modes

TN3270 server configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command is valid only on the virtual channel interface. If the SNA session switch function is already enabled, the dlur command with no arguments puts you in DLUR configuration mode. The session switch function implements an End Node DLUR.

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.

Examples

The following example 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.VMG

Related Commands

Command	Description
dlur (TN3270)	Specifies a backup DLUS for the DLUR function.
lsap	Creates a SAP in the SNA session switch, or enters DLUR SAP configuration mode.
preferred-nnserver	Specifies a preferred NN as server.
pu (DLUR)	Creates a PU entity that has no direct link to a host, or enters PU configuation mode.

Syntax Description

dlusname2

Fully qualified name of the backup DLUS for the DLUR.

Defaults

No backup DLUS is specified.

Command Modes

DLUR configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command is valid only on the virtual channel interface. Only one backup DLUS can be specified per CMCC adapter. 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.

Examples

The following example specifies SYD.VMX as the backup DLUS:

dlus-backup SYD.VMX

Related Commands

Command	Description
dlur (TN3270)	Enables the SNA session switch function on the CMCC adapter, or enters DLUR configuration mode.

Syntax Description

slot	(Optional) Slot number of the CMCC adapter. If no slot is specified, all installed CMCC adapters will output a core dump when they halt unexpectedly.
protocol	Protocol for transferring the file. Currently, the only allowed value is FTP.
host	Name or IP address of the host that receives the core dump information.
filename	Filename on the host that receives the core dump information. The maximum name length is 31 characters. When written to the host, slot is automatically appended, where slot is the slot number.

Defaults

This command has no defaults.

Command Modes

Global configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

You must configure FTP services on the router before you can create a CMCC adapter core dump.

Do not exceed your host limits on filename length. An additional two characters are added to the filename, .slot, where slot is the slot number.

Examples

The following example shows how to configure a router to perform a CMCC adapter core dump. Assuming the CIP is installed in slot 3, the filename cipdump.3 will be written to the host.

ip domain-name cisco.com
ip name-server 168.69.161.21
ip ftp username tech1
ip ftp password tech1
exception slot ftp://168.18.2.196/cipdump

Related Commands

Command	Description
ip domain-name	Defines a default domain name to complete unqualified host names (names without a dotted-decimal domain name).
ip name-server	Specifies the address of one or more name servers to use for name and address resolution.
ip ftp username	Configures the username for FTP connections.
ip ftp password	Specifies the password to be used for FTP connections.

Syntax Description

permit	Left-over LUs should be made available to TN3270 users wanting generic sessions. This value is the default.
deny	Left-over LUs should not be given to a generic pool. The physical unit (PU) is not automatically fully populated with 255 LOCADDR definitions. The default is the value configured in TN3270 server configuration mode.

Defaults

In TN3270 server configuration mode, generic pool use is permitted.

In PU configuration mode, the default is the value currently configured in TN3270 server configuration mode.

Command Modes

TN3270 server configuration. PU configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command is valid only on the virtual channel interface.

A left-over LU is defined as one for which all of the following conditions are true:

• The system services control point (SSCP) did not send an ACTLU during PU start-up; and

• The PU controlling the LU is capable of carrying product set ID (PSID) vectors on network management vector transport (NMVT) messages, thus allowing dynamic definition of dependent LU (DDDLU) operation for that LU.

All LUs in the generic pool are, by definition, DDDLU capable.

Values entered for generic-pool in TN3270 server 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 server 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.

Examples

The following example permits generic LU pool use:

generic-pool permit

Related Commands

Command	Description
client (lu nailing)	Defines a range of locaddrs to be reserved for remote devices.

Syntax Description

seconds

Idle time in seconds, from 0 to 65535. A value of 0 means the session is never disconnected.

Defaults

The default in TN3270 server configuration mode is that the session is never disconnected (0).

The default in PU configuration mode is the value currently configured in TN3270 server configuration mode.

Command Modes

TN3270 server configuration. PU configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

The idle-time command is valid only on the virtual channel interface, and can be entered in either TN3270 server 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   For the purposes of idle-time logic, TIMING-MARKs generated by the keepalive logic do not constitute "activity."

Examples

The following command sets an idle-time disconnect value of 10 minutes:

idle-time 600
 

The following command entered in TN3270 server configuration mode sets the default idle-time disconnect value to 0, or never disconnect:

no idle-time

Related Commands

Command	Description
keepalive (TN3270)	Specifies how many seconds of inactivity elapse before transmission of a DO TIMING-MARK to the TN3270 client.
timing-mark	Selects whether a WILL TIMING-MARK is sent when the host application needs an SNA response (definite or pacing response).

Syntax Description

slot	Slot number where the CMCC adapter is located.
port	Inteface where the CMCC adapter is located.

Defaults

This command has no defaults.

Command Modes

Global configuration

Command History

Release	Modification
10.2	This command was introduced.

Examples

The following example shows how to enter interface configuration mode for a CIP in slot 2 and begin configuring port 0:

interface channel 2/0

Related Commands

Command	Description
channel-protocol	Defines a data rate of either 3 MBps or 4.5 MBps for PCIs.
claw (interface)	Configures a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in IP Datagram mode.Can also be used to configure individual members of a CLAW backup group for the IP Host Backup feature.
client (lu limit)	Configures a CMPC read subchannel and a CMPC write subchannel.
csna	Configures SNA support on a CMCC physical channel interface and specifies the path and device/subchannel on a physical channel of the router to communicate with an attached mainframe.
lan	Configures an internal LAN on a CMCC adapter interface and enters the internal LAN configuration mode.
max-llc2-sessions	Specifies the maximum number of LLC2 sessions supported on the CMCC adapter.
offload (interface)	Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. Also can be used to configure individual members of an Offload backup group for the IP Host Backup feature.
offload (IP-host-backup)	Specifies one or more data paths for the IP host backup.
tg	Defines LLC connection parameters for the CMPC transmission group.
tn3270-server	Starts the TN3270 server on a CMCC adapter or enters TN3270 server configuration mode.

Syntax Description

screen	Specifies the precedence is for screen devices.
printer	Specifies the precedence is for printer devices.
value	Sets the precedence priority. A value between 0 and 7, with 7 being the highest priority. The default is 0.

Defaults

The default is a precedence value of 0 for both screens and printers.

Command Modes

TN3270 server configuration mode. TN3270 PU configuration mode

Command History

Release	Modification
11.3	This command was introduced.

Usage Guidelines

This command is valid only on the virtual channel interface. 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.

Examples

The following example assigns a precedence value of 3 to printers:

ip precedence printer 3

Related Commands

Command	Description
ip tos	Specifies the TOS level for IP traffic in the TN3270 server.

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.

Defaults

The default is a TOS value of 0 for both screens and printers.

Command Modes

TN3270 server configuration mode. TN3270 PU configuration mode

Command History

Release	Modification
11.3	This command was introduced.

Usage Guidelines

This command is valid only on the virtual channel interface. TOS values applied in TN3270 PU configuration mode override values applied in TN3270 server configuration mode.

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.

Examples

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 0

Related Commands

Command	Description
ip precedence (TN3270)	Specifies the precedence level for IP traffic in the TN3270 server.

Syntax 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

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

The keepalive (TN3270) command is valid only on the virtual channel interface. This 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.

The default behavior of the TN3270 server is to send timing marks every 30 minutes if there is no other traffic flowing between the TN3270 client and server. The TN3270 server disconnects a session if the client does not respond within 30 seconds. (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.

Using the Idle Time and Keepalive Options

There are two TN3270 server options that can affect when a session is disconnected—idle time and keepalive. These two options operate independently of each other and both can be used to clean up partially disconnected sessions. Whichever option first detects that a session is eligible for disconnect immediately causes the TN3270 server to disconnect that session. If you are specifying both the idle time and keepalive options, then you might consider how the values for these options determine when client sessions are disconnected to achieve the response that you want.

The amount of time that the TN3270 server waits for a keepalive response is the value (in seconds) that is the lesser of the the following values:

• [30 seconds + (keepalive value/4)]

• idle-time value in seconds

Examples

The following example sets keepalive disconnect value of 15 minutes (900 seconds):

keepalive 900
 

The 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 51800
 

The following example entered in TN3270 configuration mode sets the keepalive disconnect value to 1800 seconds, the default:

no keepalive

Related Commands

Command	Description
idle-time	Specifies how many seconds of LU inactivitiy, from both host and client, before the TN3270 session is diconnected.
timing-mark	Selects whether a WILL TIMING-MARK is sent when the host application needs an SNA response (definite or pacing response)>

Syntax Description

type	Interface type for this internal LAN: tokenring.
lan-id	A number 0 to 31 that uniquely identifies this internal LAN on this CMCC adapter. This value must be unique between all internal LANs of the same interface type on a CMCC adapter.

Defaults

This command has no defaults.

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

This command is valid only on the virtual channel interface. All internal adapters configured on the internal LAN must be removed first before the internal LAN can be removed.

A CMCC internal LAN can be configured as a SRB LAN. This allows LLC packets to be bridged between the CMCC adapter and IOS, providing a means to link the internal LAN to IOS SNA features such as SRB, DLSw+, RSRB, SDLLc, QLLC, APPN, and SR/TLB.

An internal LAN can only be configured on a virtual channel interface of a CMCC adapter. You enter the internal LAn configuration mode by issuing the command for an internal LAN that already exists or when you configure an internal LAN for the first time. In the internal LAN configuration mode, the router prompt appears as follows:

router (cfg-lan-type n) #

In this syntax, type is the specified internal LAN type and n is the specified lan-id.

Examples

The following example shows how to configure an internal LAN Token Ring with a LAN ID of 20 on the channel interface 1/2:

interface channel 1/2
 lan tokenring 20

Related Commands

Command	Description
adapter	Configures internal adapters.
show extended channel lan	Displays the internal LANs and adapters configured on a CMCC adapter.
source-bridge	Configures an interface for SRB.

Syntax Description

name	Link name, from one to eight alphanumeric characters. The first character must be alphabetic. The name must be unique within the DLUR function.
rmac	(Optional) Remote MAC address of the form xxxx.xxxx.xxxx in hexadecimal. If not specified, a loopback link to another SAP on the same internal LAN adapter is assumed.
rsap	(Optional) Remote SAP address, 04 to FC in hexadecimal. The rsap value must be even and should be a multiple of 4, but this requirement is not enforced. The rsap value default is 04.

Defaults

No DLUR link is defined.

The default remote SAP address is 04 (hexadecimal).

Command Modes

DLUR SAP configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

This command is valid only on the virtual channel interface. 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 CMCC adapter, the TN3270 server and the hosts should open different adapters. Using different adapters avoids any contention for SAP numbers, and is also necessary if you configure duplicate MAC addresses for fallback CSNA or CMPC access to the host.

Examples

The following example defines a link name and a remote SAP address:

link LINK5 rsap 08
 

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 0
 adapter 0 4000.0000.0001
 adapter 1 4000.0000.0002
tn3270-server
 dlur ...
 lsap token-adapter 1
  link HOST rmac 4000.0000.0001 rsap 4

Related Commands

Command	Description
adapter	Configures internal adapters.
dlur (TN3270)	Enables the SNA session switch function on the CMCC adapter, or enters DLUR configuration mode.
lan	Configures an internal LAN on a CMCC adapter interface and enters the internal LAN configuration mode.
lsap	Creates a SAP in the SNA session switch, or enters DLUR SAP configuration mode.

Syntax Description

type	Internal adapter type on the CIP card, which corresponds to the value specified in the lan internal LAN configuration command. The currently supported type is token-adapter.
adapter-number	Internal adapter interface on the CIP card, which is the same value specified in the adapter internal LAN configuration command.
lsap	(Optional) Local SAP number, 04 to FC, in hex. The value must be even and should normally be a multiple of four. It must be unique within the internal adapter in that no other 802.2 clients of that adapter, in the router or in a host, should be allocated the same SAP. The default value is C0.

Defaults

The default value for lsap is hexadecimal C0.

Command Modes

DLUR configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

The lsap command is valid only on the virtual channel interface. 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 CMCC 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.

Examples

The following example defines an adapter type, an adapter number, and a local SAP:

lsap token 0 B0

Related Commands

Command	Description
adapter	Configures internal adapters.
dlur (TN3270)	Enables the SNA session switch function on the CMCC adapter, or enters DLUR configuration mode.
lan	Configures an internal LAN on a CMCC adapter interface and enters the internal LAN configuration mode.

Syntax Description

number

A value in the range 1 to 6000 LLC sessions. If this command is not configured, the default is 256 sessions.

Defaults

The default number of sessions is 256.

Command Modes

Interface configuration.

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

This command is configured on the virtual interface of a CIP, and the physical interface of a CPA. If you do not configure this parameter on the CMCC adapter, then the limit of LLC2 sessions is 256.

This command will fail if there is not enough memory currently available on the CMCC adapter to support the specified number of LLC2 sessions.

Note   A value of 0 sets the maximum number of LLC2 sessions to the default value of 256. In this case, the value does not appear in your configuration when you use the show run command.

Examples

The following example limits the maximum number of LLC2 sessions to 212:

max-llc2-sessions 212
 

Syntax Description

number

Maximum number of LU control blocks allowed. The allowed range is 0 to 32000. However, the practical upper limit for concurrently operating TN3270 sessions depends on the hardware and usage characteristics. The default is 2100.

Defaults

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 Modes

TN3270 server configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

The maximum-lus command is valid only on the virtual channel interface. 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 redundant messages, 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 CMCC 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. On an XCPA, 8 MB of memory supports 1000 LUs.

Examples

The following example allows 5000 LU control blocks to be allocated:

maximum-lus 5000

Related Commands

Command	Description
client (lu limit)	Limits the number of LU sessions that can be established from a client IP address.
pu (direct)	Creates a PU entity that has its own direct link to a host, or enters PU configuration mode.
pu (DLUR)	Creates a PU entity that has no direct link to a host, or enters PU configuration mode.

Syntax Description

name	Name that identifies this internal adapter. Consists of up to 8 characters that does not include blanks.

Defaults

This command has no defaults.

Command Modes

Internal adapter configuration

Command History

Release	Modification
11.0	This command was introduced.

Examples

The following example assigns a name to an internal adapter interface:

name VTAM_B14

Related Commands

Command	Description
adapter	Configures internal adapters.

Syntax Description

path	Hexadecimal value in the range 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 IOCP, the default values for channel logical address and control unit logical address is 0.
device-address	Hexadecimal value in the range 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 value.
ip-address	IP address specified in the host TCP/IP application configuration file.
host-name	Host name specified in the device statement in the host TCP/IP application configuration file.
device-name	CLAW workstation name specified in the device statement in the host TCP/IP application configuration file.
host-ip-link	CLAW host link name for the IP link as specified by the host application. For IBM VM and VMS TCP/IP stacks, this value is tcpip. When used with other applications, this value must match the value coded in the host application.
device-ip-link	CLAW workstation link name for the IP link as specified by the host application. For IBM VM and MVS TCP/IP stacks, this value is tcpip. When used with other applications, this value must match the value coded in the host application.
host-api-link	CLAW host link name for the API link as specified by the host application. For IBM VM and MVS TCP/IP stacks, this value is tcpip. When used with other applications, this value must match the value coded in the host application.
device-api-link	Offload link name for the API link as specified by the host application. For IBM VM and MVS TCP/IP stacks, this value is api. When used with other applications, this value must match the value coded in the host application.
broadcast	(Optional) Enables broadcast processing for this subchannel.
backup	(Optional) Enables this offload connection to be used as part of a backup group of offload connections for the specified IP address.

Defaults

This command has no defaults.

Command Modes

Interface configuration

Command History

Release	Modification
11.0	This command was introduced.
12.0	The backup option was added.

Usage Guidelines

Offload devices provide IP connectivity to a mainframe while at the same time offloading a large part of the TCP/IP processing to the CMCC adapter. Not every mainframe TCP/IP stack supports offload.

The offload command uses the same underlying configuration parameters as does the claw command.

Examples

The following example shows how to enable IBM channel attach offload processing on a CMCC adapter's physical channel interface which is supporting a directly connected ESCON channel:

interface channel 3/0
ip address 198.92.0.1 255.255.255.0
offload 0100 00 198.92.0.21 CISCOVM EVAL TCPIP TCPIP TCPIP API
 

The following example shows how an IP host backup group is specified using the backup keyword:

interface Channel3/0
 no ip address
 no keepalive
 shutdown
 offload 0100 C0 10.30.1.2 TCPIP OS2TCP TCPIP TCPIP TCPIP API backup
 offload 0110 C0 10.30.1.2 TCPIP OS2TCP TCPIP TCPIP TCPIP API backup
 offload 0120 C0 10.30.1.2 TCPIP OS2TCP TCPIP TCPIP TCPIP API backup
 offload 0110 C2 10.30.1.3 TCPIP OS2TCP TCPIP TCPIP TCPIP API

Related Commands

Command	Description
offload (IP-host-backup)	Specifies one or more data paths for the IP host backup.
show extended channel icmp-stack	Displays information about the ICMP stack running on the CMCC channel interfaces.
show extended channel ip-stack	Displays information about the IP stack running on CMCC channel interfaces.
show extended channel statistics	Displays statistical information about subchannels on the physical interface of a CMCC adapter and displays information that is specific to the interface channel devices.The information generally is useful only for diagnostic tasks performed by technical support personnel.
show extended channel subchannel	Displays information about the CMCC adapter physical interfaces and displays information that is specific to the interface channel connection.The information displayed generally is useful only for diagnostic tasks performed by technical support personnel.
show extended channel tcp-connections	Displays information about the TCP sockets on a channel interface.
show extended channel tcp-stack	Displays information about the TCP stack running on CMCC adapter interfaces.
show extended channel udp-listeners	Displays information about the UDP listener sockets running on the CMCC adapter interfaces.
show extended channel udp-stack	Displays information about the UDP stack running on the CMCC adapter interfaces.

Syntax Description

device-address	Hexadecimal value in the range 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 IOCP, the default values for channel logical address and control unit logical address is 0.
ip-address	Hexadecimal value in the range 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 value.
host-name	Host name specified in the device statement in the host TCP/IP application configuration file.
device-name	CLAW workstation name specified in the device statement in the host TCP/IP application configuration file.
host-ip-link	Host link name for the IP link as specified by the host application. For IBM VM and MVS TCP/IP stacks, this value is tcpip. When used with other applications, this value must match the value coded in the host application.
device-ip-link	Workstation link name for the IP link as specified by the host application. For IBM VM and MVS TCP/IP stacks, this value is tcpip. When used with other applications, this value must match the value coded in the host application.
host-api-link	Host link name for the API link as specified by the host application. For IBM VM and MVS TCP/IP stacks, this value is tcpip. When used with other applications, this value must match the value coded in the host application.
device-api-link	Offload link name for the API link as specified by the host application. For IBM VM and MVS TCP/IP stacks, this value is api. When used with other applications, this value must match the value coded in the host application.
broadcast	(Optional) Enables broadcast processing for this subchannel.

Defaults

This command has no defaults.

Command Modes

IP host backup configuration.

Command History

Release	Modification
12.0	This command was introduced.

Usage Guidelines

Offload devices provide IP connectivity to a mainframe while at the same time offloading a large part of the TCP/IP processing to the CMCC adapter. Not every mainframe TCP/IP stack supports offload.

The offload command uses the same underlying configuration parameters as does the claw command.

Examples

The following examples show two methods for entering the same IP host backup group information. The first group of commands is the long form, using the offload interface configuration command. The second group is the shortcut, using the path interface configuration command and a offload IP host backup configuration command.

Long form:

offload c000 00 198.92.10.5 sysa router1 tcpip tcpip tcpip api backup
offload c100 00 198.92.10.5 sysa router1 tcpip tcpip tcpip api backup
offload c200 00 198.92.10.5 sysa router1 tcpip tcpip tcpip api backup
 

Shortcut form:

path c000 c100 c200
  offload 00 198.92.10.5 sysa router1 tcpip tcpip tcpip api

Related Commands

Command	Description
show extended channel ip-stack	Displays information about the IP stack running on CMCC channel interfaces.
show extended channel statistics	Displays statistical information about subchannels on the physical interface of a CMCC adapter and displays information that is specific to the interface channel devices.The information generally is useful only for diagnostic tasks performed by technical support personnel.
show extended channel subchannel	Displays information about the CMCC adapter physical interfaces and displays information that is specific to the interface channel connection.The information displayed generally is useful only for diagnostic tasks performed by technical support personnel.
show extended channel tcp-connections	Displays information about the TCP sockets on a channel interface.
show extended channel tcp-stack	Displays information about the TCP stack running on CMCC adapter interfaces.
offload (interface)	Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. Also can be used to configure individual members of an Offload backup group for the IP Host Backup feature.
offload (IP-host-backup)	Specifies one or more data paths for the IP host backup.
show extended channel icmp-stack	Displays information about the ICMP stack running on the CMCC channel interfaces.
show extended channel udp-listeners	Displays information about the UDP listener sockets running on the CMCC adapter interfaces.
show extended channel udp-stack	Displays information about the UDP stack running on the CMCC adapter interfaces.

Syntax Description

path

Hexadecimal value in the range 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 IOCP, the default values for channel logical address and control unit logical address is 0.

Defaults

This command has no defaults.

Command Modes

Interface configuration

Command History

Release	Modification
12.0	This command was introduced.

Usage Guidelines

Up to 16 path values can be specified in the path command.

The path command places you in IP host backup configuration mode, where you can enter additional commands to define backup groups for CLAW and offload connections.

Examples

The following examples show two methods for entering the same IP host backup group information. The first group is the long form, using the offload interface configuration command. The second group of commands is the shortcut, using the path interface configuration command and a offload IP host backup configuration command.

Long form:

offload c000 00 198.92.10.5 sysa router1 tcpip tcpip backup
offload c100 00 198.92.10.5 sysa router1 tcpip tcpip backup
offload c200 00 198.92.10.5 sysa router1 tcpip tcpip backup
 

Shortcut form:

path c000 c100 c200
  offload 00 198.92.10.5 sysa router1 tcpip tcpip

Related Commands

Command	Description
claw (IP-host-backup)	Configures a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. Can also be used to configure individual members of a CLAW backup group for the IP Host Backup feature.
offload (IP-host-backup)	Specifies one or more data paths for the IP host backup.

Syntax Description

name	A fully qualified name of an NN.

Defaults

This command has no defaults.

Command Modes

DLUR configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

The preferred-nnserver command is valid only on the virtual channel interface. 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.

Examples

The following example selects SYD.VMX as the preferred NN server:

preferred-nnserver SYD.VMX

Related Commands

Command	Description
dlur (TN3270)	Enables the SNA session switch function on the CMCC adapter, or enters DLUR configuration mode.

Syntax Description

pu-name	Name that uniquely identifies this PU.
idblk-idnum	This value must match the IDBLK-IDNUM value defined at the host. The value must be unique within the subarea; however, the TN3270 Server cannot tell which remote hosts are in which subareas and does not enforce the unique value requirement.
ip-address	IP address that the clients should use as host IP address to map to LU sessions under this PU.
type	Internal adapter type on the CIP card, which corresponds to the value specified in the lan internal LAN configuration command. The currently supported type is token-adapter.
adapter-number	Internal adapter interface on the CIP card, which is the same value specified in the adapter internal LAN configuration command.
lsap	Local SAP number in hexadecimal, ranging from 04 to FC. The value must be even, and must be unique within the internal adapter so that no other 802.2 clients of that adapter, in the router or in a host, should be allocated the same SAP. Other direct links from TN3270 server direct PUs may use the same value on the internal adapter as long as the remote MAC or SAP is different.
rmac rmac	(Optional) Remote MAC address. The remote MAC address of the form xxxx.xxxx.xxxx hexadecimal, specifying the MAC address of the remote host. If not specified, a loopback link to another SAP on the same internal LAN adapter is assumed.
rsap rsap	(Optional) Remote SAP address. The remote SAP address is a one- or two-character hexadecimal string, ranging from 04 to FC, specifying the SAP address of the remote host. The default is 04.
lu-seed lu-name-stem	(Optional) Provides an LU name that the client can use when a specific LU name request is needed. The format can be x...x## or x...x### where x..x is an alphanumeric string. When ## is specified, it is replaced with the LU LOCADDR in hexadecimal digits to form the complete LU name. When ### is specified, decimal digits are used, padded with leading zeroes to make three characters. The first x must be alphabetic and the entire string, including the # symbols, must not exceed 8 characters.

Defaults

No PU is defined.

The default remote SAP address is 04 (hexadecimal).

Command Modes

TN3270 server configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

The pu pu-name command is valid only on the virtual channel interface. 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 CMCC adapter, the TN3270 server and the hosts should open different adapters. Using different adapters avoids any contention for SAP numbers, and is also necessary if you configure duplicate MAC addresses for fallback CSNA or CMPC access to the host.

Examples

The following example configures the TN3270 server to be active, and has one PU, CAPPU1, trying to connect in. An LU seed using hexadecimal digits is defined.

tn3270-server
pu 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 0
 adapter 0 4000.0000.0001
 adapter 1 4000.0000.0002
tn3270-server
 pu PU1 05d00001 10.0.0.1 token-adapter 1 8 rmac 4000.0000.0001 rsap 4

Related Commands

Command	Description
adapter	Configures internal adapters.
lan	Configures an internal LAN on a CMCC adapter interface and enters the internal LAN configuration mode.
tn3270-server	Starts the TN3270 server on a CMCC adapter or enters TN3270 server configuration mode.

Syntax Description

slot	Slot number.
port	Port number.
backup	Display all CLAW or OFFLOAD commands associated with the backup group.
ip-address	(Optional) Display information about all devices in the backup group defined by ip-address.

Command Modes

Privileged EXEC

Command History

Release	Modification
12.0	This command was introduced.

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: 80.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 (IP-host-backup)	Configures a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. Can also be used to configure individual members of a CLAW backup group for the IP Host Backup feature.
offload (IP-host-backup)	Specifies one or more data paths for the IP host backup.

Syntax Description

slot	Slot number.
port	Physical channel interface port number.
path	(Optional) The logical channel path.
device	(Optional) A 2-digit hexadecimal value that specifies a device address of the CPMC subchannel. If specified, only status for that CMPC device will be displayed. If not specified, status for all CMPC devices for the specified path will be displayed.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.3	This command was introduced.

Usage Guidelines

This command is valid only on the CMCC adapter physical interfaces.

Examples

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

Router# show extended channel 3/0 cmpc c020 
 
     Path Dv  TGName    Dir    Bfrs  Status
CMPC C020 46  MVS2ISRA  READ   10    Active
CMPC C020 47  MVS2ISRA  WRITE  16    Active
CMPC C020 4A  MVS2ISR1  READ   7     Active
CMPC C020 4B  MVS2ISR1  WRITE  16    Active
CMPC C020 4C  MVS2ISR2  READ   7     Active
CMPC C020 4D  MVS2ISR2  WRITE  16    Active
CMPC C020 4E  MVS2TN    READ   0     Inactive
CMPC C020 4F  MVS2TN    WRITE  0     Inactive
 

Related Commands

Command	Description
client (lu limit)	Configures a CMPC read subchannel and a CMPC write subchannel.
tg	Defines LLC connection parameters for the CMPC transmission group.

Syntax Description

slot	Slot number.
port	Port number.
connection-map llc2	Displays a connection map of LLC2 connections.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.0(3)	This command was introduced.

Usage Guidelines

The show extended channel connection-map llc2 command is valid only on the virtual channel interfaces.

Examples

The following is sample output from the show extended channel connection-map llc2 command.

Router# show extended channel 1/2 connection-map llc2
 
LAN Token  0 Adapter   0 4000.7000.0747
 Local SAP=08 LLC2 Connections=4   CSNA Port=1 Path=C200 Device=60
 Local SAP=0C LLC2 Connections=4   CSNA Port=1 Path=C200 Device=60
 Local SAP=10 LLC2 Connections=2   CSNA Port=1 Path=C200 Device=60
 Local SAP=14 LLC2 Connections=0   CSNA Port=1 Path=C200 Device=60
 
LAN Token  1 Adapter   1 4000.7000.0767
 Local SAP=08 LLC2 Connections=3   CSNA Port=1 Path=C200 Device=61
 Local SAP=0C LLC2 Connections=3   CSNA Port=1 Path=C200 Device=61
 Local SAP=10 LLC2 Connections=2   CSNA Port=1 Path=C200 Device=61
 Local SAP=14 LLC2 Connections=2   CSNA Port=1 Path=C200 Device=61
 
LAN Token  2 Adapter   2 4000.7000.0737
 No SAPs open on this interface
 
 Total : SAPs opened = 8      Connections active = 20 
 

Syntax Description

slot	Slot number.
port	Port number.
path	(Optional) A hexadecimal value in the range of 0x0000 - 0xFFFF. 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 of 0x00 - 0xFE. This is the unit address associated with the control unit number and path as specified in the host IOCP file. If not specified, information is displayed for all CSNA subchannels configured with the specified path on the selected interface.
admin	(Optional) Displays configured values for CSNA channel devices. If neither admin, oper, or stats is specified, admin is the default.
oper	(Optional) Displays operational values for CSNA channel devices.
stats	(Optional) Displays statistics for CSNA channel devices.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.0(3)	This command was introduced.

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

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.

Syntax Description

slot	Slot number.
port	Port number.
ip-address	(Optional) IP address specified by the offload interface configuration command or the tn3270-server pu command.

Command Modes

EXEC

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

The show extended channel icmp-stack command is valid on both physical and virtual channel interfaces.

Examples

The following is sample output from the show extended channel icmp-stack command:

Router# show extended channel 0/1 icmp-stack
 
ICMP Statistics for IP Address 80.11.198.2
  InMsgs         : 3            InErrors        : 0            InDestUnreachs: 0
  InTimeExcds    : 0            InParmProbs     : 0            InSrcQuenchs  : 0
  InRedirects    : 0            InEchos         : 3            OutEchoReps   : 3
  OutTimestamps  : 0            OutTimestampReps: 0            OutAddrMasks  : 0
  OutAddrMaskReps: 0
ICMP Statistics for IP Address 80.11.198.3
  InMsgs         : 1            InErrors        : 0            InDestUnreachs: 0
  InTimeExcds    : 0            InParmProbs     : 0            InSrcQuenchs  : 0
  InRedirects    : 0            InEchos         : 1            OutEchoReps   : 1
  OutTimestamps  : 0            OutTimestampReps: 0            OutAddrMasks  : 0

OutAddrMaskReps: 0

Related Commands

Command	Description
offload (interface)	Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. Also can be used to configure individual members of an Offload backup group for the IP Host Backup feature.
pu (direct)	Creates a PU entity that has its own direct link to a host, or enters PU configuration mode.
pu (DLUR)	Creates a PU entity that has no direct link to a host, or enters PU configuration mode.

Syntax Description

slot	Slot number.
port	Port number.
ip-address	(Optional) IP address specified by the offload interface configuration command or the tn327-server pu command.

Command Modes

EXEC

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

The show extended channel ip-stack command is valid on both physical and virtual channel interfaces.

Examples

The following is sample output from the show extended channel ip-stack command:

Router# show extended channel 0/1 ip-stack
 
IP Statistics for IP Address 80.11.198.2
  Forwarding     : no           DefaultTTL     : 64           InReceives   : 165
  InHdrErrors    : 0            InAddrErrors   : 0            ForwDatagrams: 0
  InUnknownProtos: 0            InDiscards     : 0            InDelivers   : 165
  OutRequests    : 157          OutDiscards    : 0            OutNoRoutes  : 0
  ReasmTimeout   : 60           ReasmReqds     : 0            ReasmOKs     : 0
  ReasmFails     : 0            FragOKs        : 0            FragFails    : 0
  FragCreates    : 0            RoutingDiscards: 0
IP Statistics for IP Address 80.11.198.3
  Forwarding     : no           DefaultTTL     : 64           InReceives   : 77
  InHdrErrors    : 0            InAddrErrors   : 0            ForwDatagrams: 0
  InUnknownProtos: 0            InDiscards     : 0            InDelivers   : 77
  OutRequests    : 78           OutDiscards    : 0            OutNoRoutes  : 0
  ReasmTimeout   : 60           ReasmReqds     : 0            ReasmOKs     : 0
  ReasmFails     : 0            FragOKs        : 0            FragFails    : 0
  FragCreates    : 0            RoutingDiscards: 0
 

Related Commands

Command	Description
offload (interface)	Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. Also can be used to configure individual members of an Offload backup group for the IP Host Backup feature.
pu (direct)	Creates a PU entity that has its own direct link to a host, or enters PU configuration mode.
pu (DLUR)	Creates a PU entity that has no direct link to a host, or enters PU configuration mode.

Syntax Description

slot	Slot number.
port	Port number.
tokenring	(Optional) Specify CMCC internal LAN type to be displayed.
lan-id	(Optional) Specify the CMCC internal LAN number to be displayed.
adapno	(Optional) Specify the CMCC internal adapter number on the selected internal LAN to be displayed.

Defaults

Display all internal LANs and adapters on the selected channel interface.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.0	This command was introduced.

Usage Guidelines

This command is valid only on the virtual channel interface.

Examples

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

Router# show extended channel 3/2 lan
 
Lan TokenRing 0
        Adapno Mac Address    Name     Vcnum
             0 4000.1111.1112            544
            20 4000.1111.2200            564
            30 4000.3030.0101            574
Lan TokenRing 1
        source-bridge 207 1 2002
        Adapno Mac Address    Name     Vcnum
             1 4000.2222.2222            545
Lan TokenRing 2
        source-bridge 50 1 1500
        Adapno Mac Address    Name     Vcnum
             2 4000.3333.2222            546 
Lan TokenRing 5
        source-bridge 112 1 3000
        Adapno Mac Address    Name     Vcnum
             5 4000.1234.5656            549 
Lan TokenRing 9
        source-bridge 111 1 3000
        Adapno Mac Address    Name     Vcnum
             9 4000.9999.1111            553
Lan TokenRing 10
        source-bridge 110 1 3000
        Adapno Mac Address    Name     Vcnum
            10 4000.aaaa.1111            554
Lan TokenRing 20
        source-bridge 20 1 2002
        Adapno Mac Address    Name     Vcnum
            21 4000.2020.2020            565

Related Commands

Command	Description
adapter	Configures internal adapters.
lan	Configures an internal LAN on a CMCC adapter interface and enters the internal LAN configuration mode.

Syntax Description

slot	Slot number.
port	Port number.
admin	(Optional) Shows configured values. This is the default.
oper	(Optional) Shows operational values for: Internal adapters SAPs opened on the internal adapters LLC2 connections on the internal adapters
stats	(Optional) Shows statistics for: Internal adapters SAPs opened on the internal adapters LLC connections on the internal adapters
lmac	(Optional) Local MAC address.
lsap	(Optional) Local service access point (SAP) address, 0 to 256.
rmac	(Optional) Remote MAC address.
rsap	(Optional) Remote SAP address, 0 to 256.

Command Modes

EXEC

Command History

Release	Modification
11.0(3)	This command was introduced.

Usage Guidelines

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

To specify LLC information for internal adapters:

• Specify the lmac to get information for a specific internal adapter.

• Omit the lmac parameter to display information for all internal adapters on the specified channel interface.

To display LLC information for SAPs opened on an internal adapter:

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

• Specify the lmac parameter and `*' to display information for all SAPs opened on the specified channel adapter.

To display information for LLC2 connections on a channel interface:

• Specify the lmac, lsap, rmac, and rsap parameters to display information for a particular active LLC2 connection.

• Specify the lmac, lsap, and rmac parameters 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 the lmac and lsap parameters, 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 the lmac, `*' for the local SAP, and rmac to display information for all LLC2 connections active between the specified internal adapter and the remote MAC address.

• Specify the lmac, `*' for the local SAP, and `*' for the remote MAC address to display information for all active LLC2 connections on the specified internal adapter.

Examples

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

The following sample displays the configured values for all LLC2 connections on channel 2/2.

Router# show extended channel 2/2 llc2 admin
 
     Lan Token adapter   0 0004.0004.0004
  t1-time   = 1000  tpf-time  = 1000  trej-time = 3200  tbusy-tim = 9600
  idle-time =60000  local-win =    7  recv-wind =    7  N2        =    8
  N1        = 1033  ack-delay =  100  ack-max   =    3  nw        =    0
 

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 currently opened on this internal MAC adapter. Max SAPs Opened is the number of SAPs concurrently opened on this internal MAC adapter since the last reset of the channel adapter of channel interface.

The following sample displays operational information for the specified SAP opened on a CMCC internal adapter:

Router# show extended channel 5/2 llc stat
 
LAN Token  0 Adapter   0 4000.1010.2020
      PDUsIn     =     223339    PDUsOut     =       9564
      OctetsIn   =    6949875    OctetsOut   =     307448
      TESTCmdsIn =     213293    TESTRspsOut =          2
      LocalBusies=          0    UnknownSAPs =          0
 

The following sample displays operational information for the specified SAP opened on the internal adapter, 4000.1010.2020 configured on channel interface 5/2.

Router# show extended channel 5/2 llc2 oper 4000.1010.2020 04
 
  LAN Token  0 Adapter   0 4000.1010.2020
    Local SAP=04
      Open Connections=2

Max Connections Opened=2

The following table describes the fields shown in the display.

Field	Description
Open Connections	Number of LLC2 connections active on the SAP.
Max Connections	Highest number of LLC2 connections concurrently active on that SAP since the SAP has been active.

The following sample displays statistics for the specified SAP on the internal adapter, 4000.1010.2020 configured on channel interface 5/2.

Router# show extended channel 5/2 llc2 stats 4000.1010.2020 04
 
  LAN Token  0 Adapter   0 4000.1010.2020
    Local SAP=04
      TESTRspsIn     =          0  TESTCmdsOut    =          0
      XIDCmdsIn      =         14  XIDCmdsOut     =         16
      XIDRspsIn      =          4  XIDRspsOut     =          0
      UIFramesIn     =          0  UIFramesOut    =          0
      UIOctetsIn     =          0  UIOctetsOut    =          0
      ConnectOk      =          2  ConnectFail    =          0
      DiscNorm       =          0  DiscByTmr      =          0
      DiscByFRMRSent =          0  DiscByFRMRRcvd =          0
      DMsInABM       =          0  SABMEsInABM    =          0
 

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

Router# show extended channel 5/2 llc2 oper 4000.1010.2020 04 4000.1234.1030 18
 
  LAN Token  0 Adapter   0 4000.1010.2020
    Local SAP=04 Remote MAC=4000.1234.1030 Remote SAP=18  State=normal
      t1-time   = 1000  tpf-time  = 1000  trej-time = 3200  tbusy-tim = 9600
      idle-time =60000  local-win =    7  recv-wind =    7  N2        =    8
        N1-Send   = 4105  N1-Rcv    = 4105  ack-delay =  100  ack-max   =    3
Nw        =    0  Ww        =    7
      Last Ww Cause = neverInvoked
      Connection Time: 17:50:11
      Last modified: never
 

The following sample displays statistics for the CMCC LLC2 link station connection between LMAC 4000.1010.2020 LSAP 04 and RMAC 4000.1234.1030 RSAP 18.

Router# show extended channel 5/2 llc2 stats 4000.1010.2020 04 4000.1234.1030 18
 
  LAN Token  0 Adapter   0 4000.1010.2020
    Local SAP=04 Remote MAC=4000.1234.1030 Remote SAP=18
      LocalBusies    =          0  RemoteBusies   =          0
      IFramesIn      =          1  IFramesOut     =          1
      IOctetsIn      =         19  IOctetsOut     =         21
      SFramesIn      =          0  SFramesOut     =          0
      REJsIn         =          0  REJsOut        =          0
      RetransmitsOut =          0  WwCountChanges =          0

Related Commands

Command	Description
adapter	Configures internal adapters.

Syntax Description

slot	Slot number.
port	Port number.
max-llc2-sessions	Display the maximum number of LLC2 sessions supported on the CMCC adapter.

Command Modes

Privileged EXEC

Command History

Release	Modification
11.0(3)	This command was introduced

Usage Guidelines

This command is valid only on the virtual channel interface.

Examples

The following is sample output from the show extended channel max-llc2-sessions command:

Router# show extended channel 1/2 max-llc2-sessions
 
Administrative max-llc2-sessions = 1000
Operational max-llc2_sessions = 1000
Highest concurrent LLC2 sessions = 30
LLC2 session allocation failures = 0
 

Related Commands

Command	Description
adapter	Configures internal adapters.
show extended channel connection-map llc2	Displays the number of active LLC2 connections for each SAP and the mapping of the internal MAC adapter and the SAP to the resource that activated the SAP.

Syntax Description

slot	Slot number.
port	Port number.
path	Hexadecimal value in the range 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 IOCP, the default values for channel logical address and control unit logical address is 0.
device-address	Hexadecimal value in the range 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 value.

Command Modes

EXEC

Command History

Release	Modification
12.0	This command was introduced.

Examples

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

Router# show extended channel 3/0 packing names
Path: C010  Devices: F2,F3 CLAW Link: 1
 
    Sublink            Link Names
       0                 CONTROL
       1              IP        IP
       2              CKSUM     CKSUM
 
Path: C030  Devices: F6,F7 CLAW Link: N
 
    Sublink            Link Names
  DISCONNECTED           CONTROL
  DISCONNECTED        IP        IP
  DISCONNECTED        CKSUM     CKSUM
 

Related Commands

Command	Description
claw (interface)	Configures a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in IP Datagram mode.Can also be used to configure individual members of a CLAW backup group for the IP Host Backup feature.
offload (interface)	Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. Also can be used to configure individual members of an Offload backup group for the IP Host Backup feature.

Syntax Description

slot	Slot number.
port	Port number.
path	(Optional) Hexadecimal value in the range 0x0000 to 0xFFFF. 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 0x00 to 0xFE. This value is the unit address associated with the control unit number and path as specified in the host IOCP file. For CLAW and offload support, the device address must have an even value.

Command Modes

EXEC

Command History

Release	Modification
12.0	This command was introduced.

Examples

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

Router# show extended channel 3/0 packing stats
 
Path: C010 Devs: F2,F3 CLAW Link: 1  Read Blks: 4584       Wrt Blks: 15054
                  Packets               Bytes                Drops
Linkname       Read      Write      Read     Write       Read      Write   Err C
CONTROL           4          2       128        64          0          0     0 Y
IP                5          5       500       500          0          0     0 Y
CKSUM          4694      93584    187854  53889648          0          0     0 Y
  Total:       4703      93591    188482  53890212          0          0     0
 
Path: C030 Devs: F6,F7 CLAW Link: N  Read Blks: UNKNOWN    Wrt Blks: UNKNOWN
                  Packets               Bytes                Drops
Linkname       Read      Write      Read     Write       Read      Write   Err C
CONTROL           0          0         0         0          0          0     0 N
IP                0          0         0         0          0          0     0 N
CKSUM             0          0         0         0          0          0     0 N
  Total:          0          0         0         0          0          0     0
 

Related Commands

Command	Description
claw (interface)	Configures a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in IP Datagram mode.Can also be used to configure individual members of a CLAW backup group for the IP Host Backup feature.
offload (interface)	Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. Also can be used to configure individual members of an Offload backup group for the IP Host Backup feature.

Syntax Description

slot	Slot number.
port	Port number.
path	(Optional) Hexadecimal value in the range 0x0000 to 0xFFFF. 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 0x00 to 0xFE. This value is the unit address associated with the control unit number and path as specified in the host IOCP file. For CLAW and offload support, the device address must have an even value.
connected	(Optional) For each backup group, only display information about the active subchannel or the first subchannel defined in the group if none are active.

Command Modes

EXEC

Command History

Release	Modification
10.2	This command was introduced.

Examples

The following is sample output for the show extended channel statistics command from a CMCC adapter configured with CLAW, Offload, CSNA, and CMPC:

Router# show extended channel 0/1 statistics E010
 
Path: E010  -- ESTABLISHED
                  Command             Selective     System     Device        CU
Dev   Connects    Retries    Cancels      Reset      Reset     Errors       Busy
 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 for the CSNA path, using the show extended channel statistics command:

Router# show extended channel 0/1 statistics E200
 
Path: E200  -- ESTABLISHED
                  Command             Selective     System     Device        CU
Dev   Connects    Retries    Cancels      Reset      Reset     Errors       Busy
 D0     217440     108293          1          0          0          0          0
 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 (interface)	Configures a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in IP Datagram mode.Can also be used to configure individual members of a CLAW backup group for the IP Host Backup feature.
client (lu limit)	Configures a CMPC read subchannel and a CMPC write subchannel.
csna	Configures SNA support on a CMCC physical channel interface and specifies the path and device/subchannel on a physical channel of the router to communicate with an attached mainframe.
offload (interface)	Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. Also can be used to configure individual members of an Offload backup group for the IP Host Backup feature.

Syntax Description

slot	Slot number.
port	Port number.
connected	(Optional) For each backup group, only display information about the active subchannel or the first subchannel defined in the group if none are active.

Command Modes

EXEC

Command History

Release	Modification
10.2	This command was introduced.

Examples

The following is sample output from the show extended channel subchannel connected command used on a CMCC adapter configured for CLAW, Offload, CSNA, and CMPC:

Router# show extended channel 0/1 subchannel
 
Channel0/1: state up
  Flags: VALID ESCON LOADED ENABLED SIGNAL
  Link: DD, Buffers 0, CRC errors 0, Load count 4
  Link Incident Reports
    implicit 0, bit-error 0, link failed 0, 
    NOS 0, sequence timeout 0, invalid sequence 0
  Neighbor Node - VALID
    Class: Switch          Type Number : 009032        Tag: DD
    Model: 002             Manufacturer: 000
    Plant: 02              Sequence    : 000000011123
  Local Node - VALID
    Class: CTCA-standalone Type Number : C7500         Tag: 1
    Model: 2               Manufacturer: CSC
    Plant: A               Sequence    : 76027714
                                                                           Last
  Mode     Path Device                                                    Sense
  CLAW     E010   D0   10.50.1.11      CISCOMVS DUBLIN   TCPIP    TCPIP    0080
  CLAW     E010   D1   10.50.1.11      CISCOMVS DUBLIN   TCPIP    TCPIP    0080
  OFFLOAD  E010   D2   10.50.1.2       CISCOMVS MPC1OF   TCPIP    TCPIP    0080
                                       TCPIP    API
  OFFLOAD  E010   D3   10.50.1.2       CISCOMVS MPC1OF   TCPIP    TCPIP    0080
                                       TCPIP    API
  CMPC     E010   D9   PC1-789 WRITE                                       0080
  CMPC     E010   DA   PC1-789 READ                                        0080
  CSNA     E200   D0   maxpiu 20470 time-delay  10 length-delay 20470      0000
  CSNA     E200   D1   maxpiu 20470 time-delay  10 length-delay 20470      0000
  CMPC     E200   D2   PC1-7F2 WRITE                                       0000
  CMPC     E200   D3   PC1-7F2 READ                                        0000
  CMPC     E200   D4   PC1-7F4 WRITE                                       0000
  CMPC     E200   D5   PC1-7F4 READ                                        0000
  CMPC     E200   DA   PC1-7FA READ                                        0000
  CMPC     E200   DB   PC1-7FA WRITE                                       0000
  CMPC     E200   DC   PC1-7FB READ                                        0000
  CMPC     E200   DD   PC1-7FB WRITE                                       0000
  Last statistics 0 seconds old, next in 10 seconds
 

Related Commands

Command	Description
claw (interface)	Configures a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in IP Datagram mode.Can also be used to configure individual members of a CLAW backup group for the IP Host Backup feature.
client (lu limit)	Configures a CMPC read subchannel and a CMPC write subchannel.
csna	Configures SNA support on a CMCC physical channel interface and specifies the path and device/subchannel on a physical channel of the router to communicate with an attached mainframe.
offload (interface)	Configures an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. Also can be used to configure individual members of an Offload backup group for the IP Host Backup feature.