cc/td/doc/product/software/ios120/12supdoc/12cmdsum
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Cisco Mainframe Channel Connection Commands

Cisco Mainframe Channel Connection Commands

This chapter describes the function and displays the syntax for Cisco Mainframe Channel Connection (CMCC) commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Bridging and IBM Networking Command Reference.

adapter

Use the adapter internal LAN configuration command to configure internal adapters. Use the no form of this command to remove an internal adapter.

adapter adapter-number [mac-address]
no adapter adapter-number [mac-address]

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.


channel-protocol

Use the channel-protocol interface configuration command to define a data rate of either 3  megabytes per second or 4.5 megabytes per second for Parallel Channel Interfaces.

channel-protocol [s | s4]

s

(Optional) Specifies a data rate of 3 megabytes per second.

s4

(Optional) Specifies a data rate of 4.5 megabytes per second.


claw

Use the claw interface configuration command to configure a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in IP Datagram mode. This command can also be used to configure individual members of a CLAW backup group for the IP Host Backup feature.

claw path device-address ip-address host-name device-name host-app device-app [broadcast] [backup]
no claw
path device-address

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.


claw (backup)

Use the claw(backup) configuration command to configure a CLAW device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. This command can also be used to configure individual members of a CLAW backup group for the IP Host Backup feature.

claw path device-address ip-address host-name device-name host-app device-app [broadcast]
[backup]
no claw device-address

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

backup

(Optional) Enables this CLAW connection to be used as part of a backup group of CLAW connections for the specified IP address.


clear extended counters

Use the clear extended counters EXEC command to clear the extended interface counters associated with CMCC features.

clear extended counters [channel slot/port [csna | icmp-stack | ip-stack | llc2 | statistics | tcp-connections | tcp-stack | tg | tn3270-server | udp-stack]]

channel

(Optional) Specify a channel interface.

slot

(Optional) Slot number.

port

(Optional) Port number.

csna

(Optional) Clear CSNA feature counters.

icmp-stack

(Optional) Clear ICMP stack counters.

ip-stack

(Optional) Clear IP stack counters.

llc2

(Optional) Clear LLC2 counters.

statistics

(Optional) Clear subchannel statistic counters.

tcp-connections

(Optional) Clear TCP connection counters.

tcp-stack

(Optional) Clear TCP stack counters.

tg

(Optional) Clear TG counters.

tn3270-server

(Optional) Clear TN3270 Server counters.

udp-stack

(Optional) Clear UDP stack counters.


client (lu limit)

Use the client TN3270 configuration command to limit the number of LU sessions that can be established from a client IP address. Use the no form of this command to remove a single LU limit associated with a particular IP address.

client [ip [ip-mask]] lu maximum number
no client [ip [ip-mask]] [lu maximum number]

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

lu maximum number

Maximum number of LU sessions. The allowed value is from 0 to 65535. (Optional and ignored in no form of the command).


client (lu nailing)

Use the client TN3270 PU configuration mode command to define a range of locaddrs to be reserved for remote devices. Use the no form of this command to cancel this definition.

client [printer] ip ip-address [ip-mask] lu first-locaddr [last-locaddr]
no client [printer] ip ip-address [ip-mask] lu first-locaddr [last-locaddr]

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

lu first-locaddr

Defines a single locaddr to nail.

lu last-locaddr

(Optional) Defines the end range of inclusive locaddrs to be nailed from first-locaddr to last-locaddr.


cmpc

Use the cmpc interface configuration command to configure a CMPC read subchannel and a CMPC write subchannel. Use the no form of this command to remove a subchannel definition and to deactivate the transmission group.

cmpc path device tg-name {read | write}
no cmpc path device

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.


csna

Use the csna interface configuration command to configure SNA support on a CMCC physical channel interface. This command is used to specify the path and device/subchannel on a physical channel of the router to communicate with an attached mainframe. Use the no form of this command to delete the CSNA device path.

csna path device [maxpiu value] [time-delay value] [length-delay value]
no csna path device

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.


dlur

Use the dlur TN3270 configuration command to enable the Systems Network Architecture (SNA) session switch function on the CMCC adapter, or to enter dependent logical unit requester (DLUR) configuration mode. Use the no form of this command to disable the SNA session switch function and discard all parameter values associated with the SNA session switch.

dlur [fq-cpname fq-dlusname]
no dlur

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.


dlus-backup

Use the dlus-backup DLUR configuration command to specify a backup DLUS for the DLUR function. Use the no form of this command to remove a backup DLUS name.

dlus-backup dlusname2
no dlus-backup

dlusname2

Fully qualified name of the backup DLUS for the DLUR.


exception slot

Use the exception slot global configuration command to provide a core dump of a CMCC adapter. This command is only supported on the Cisco 7000 with RSP7000 and Cisco 7500 series. Use the no form of the command to disable the core dump.

exception slot [slot] protocol://host/filename
no exception slot [slot] protocol://host/filename

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. Enter the colon and the forward slashes.

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.


generic-pool

Use the generic-pool TN3270 configuration command to specify whether or not left-over LUs will be made available to TN3270 sessions that do not request a specific LU or LU pool through TN3270E. Use the no form of this command to selectively remove the permit or deny condition of generic pool use.

generic-pool {permit | deny}
no generic-pool

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 configuration mode.


idle-time

Use the idle-time TN3270 configuration command to specify how many seconds of LU inactivity, from both host and client, before the TN3270 session is disconnected. Use the no form of this command to cancel the idle time period and return to the default.

idle-time seconds
no idle-time

seconds

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


interface channel

Use the interface channel global configuration command to specify a channel attach interface and enter interface configuration mode.

interface channel slot/port

slot

Slot number where the CMCC adapter is located.

port

Inteface where the CMCC adapter is located.


ip precedence

Use the ip precedence command to specify the precedence level for IP traffic in the TN3270 server. Use the no form of this command to remove the precedence value.

ip precedence {screen | printer} value
no ip precedence {screen | printer}

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.


ip tos

Use the ip tos command to specify the TOS level for IP traffic in the TN3270 server. Use the no form of this command to remove the TOS value.

ip tos {screen | printer} value
no ip tos {screen | printer}

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.


keepalive

Use the keepalive TN3270 configuration command to specify how many seconds of inactivity elapse before transmission of a DO TIMING-MARK to the TN3270 client. Use the no form of this command to cancel the keepalive period and return to the default.

keepalive seconds
no keepalive

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


lan

Use the lan interface configuration command to configure an internal LAN on a CMCC adapter interface and enter the internal LAN configuration mode. Use the no form of the command to remove an internal LAN interface.

lan type lan-id
no lan type lan-id

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.


link

Use the link DLUR SAP configuration command to define and activate a link to a host. Use the no form of this command to delete the link definition.

link name [rmac rmac] [rsap rsap]
no link name

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


lsap

Use the lsap DLUR configuration command to create a SAP in the SNA session switch, or to enter DLUR SAP configuration mode. Use the no form of this command to delete a SAP and all SNA session switch links using the internal LAN interface.

lsap
lsap
type adapter-number [lsap]
no lsap type adapter-number [lsap]

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.


max-llc2-sessions

Use the max-llc2-sessions interface configuration command to specify the maximum number of LLC2 sessions supported on the CMCC adapter. Use the no form of this command to remove the current value and change back to the default value.

max-llc2-sessions number
no max-llc2-sessions number

number

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


maximum-lus

Use the maximum-lus TN3270 configuration command to limit the number of LU control blocks that will be allocated for TN3270 server use. Use the no form of this command to restore the default value.

maximum-lus number
no maximum-lus

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.


name

Use the name internal adapter configuration command to give a name to the internal adapter. Use the no form of the command to remove the name assigned to an internal adapter.

name name
no name name

name

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


offload

Use the offload interface configuration command to configure an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode. This command can also be used to configure individual members of an Offload backup group for the IP Host Backup feature. Use the no form of this command to cancel the offload task on the CMCC adapter.

offload path device-address ip-address host-name device-name host-ip-link device-ip-link host-api-link device-api-link [broadcast] [backup]
no offload path device-address

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.


offload (backup)

Use the offload IP Host Backup configuration mode to configure a backup group of Offload devices. Along with the path command, the offload command provides a quick way to configure an Offload backup group. Use the no form of this command to cancel the offload task on the CMCC adapter.

offload device-address ip-address host-name device-name host-ip-link device-ip-link host-api-link device-api-link [broadcast]
no offload path device-address

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.


path

Use the path interface configuration command to specify one or more data paths for the IP host backup. Use the no form of this command to delete a single path.

path path [[path]...]
no path path

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.


preferred-nnserver

Use the preferred-nnserver DLUR configuration command to specify a preferred network node (NN) as server. Use the no form of this command to remove the preference.

preferred-nnserver name
no preferred-nnserver

name

A fully qualified name of an NN.


pu (direct)

Use the pu TN3270 configuration command to create a PU entity that has its own direct link to a host, or to enter PU configuration mode. Use the no form of this command to remove the PU entity.

pu pu-name idblk-idnum ip-address type adapter-number lsap [rmac rmac] [rsap rsap]
[lu-seed lu-name-stem]
no pu pu-name

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.


pu (DLUR)

Use the pu DLUR configuration command to create a PU entity that has no direct link to a host or to enter PU configuration mode. Use the no form of this command to remove the PU entity.

pu pu-name
pu pu-name idblk-idnum ip-address
no pu pu-name

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 generally cannot tell which remote hosts are in which subareas, so the server only enforces uniqueness within the set of DLUR PUs.

ip-address

IP address that the clients should use as host IP address to map to LU sessions under this PU.


show controllers channel

Use the show controllers channel EXEC command to display CPA-specific information, including the currently loaded microcode.

show controllers channel [slot/port]

slot

(Optional) The slot number.

port

(Optional) The interface number.


show extended channel backup

Use the show extended channel backup privileged EXEC command to display information about the CLAW and offload commands for each backup group configured on CMCC channel interfaces.

show extended channel slot/port backup [ip-address]

slot

Slot number.

port

Port number.

ip-address

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


show extended channel cmpc

Use the show extended channel cmpc privileged EXEC command to display information about each CMPC subchannel configured on the specified channel interface.

show extended channel slot/port cmpc [path [device]]

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.


show extended channel connection-map llc2

Use the show extended channel connection-map llc2 privileged EXEC command to display the number of active LLC2 connections for each SAP and the mapping of the internal MAC adapter and the SAP to the resource that activated the SAP.

show extended channel slot/port connection-map llc2

slot

Slot number.

port

Port number.


show extended channel csna

Use the show extended channel csna privileged EXEC command to display information about the CSNA subchannels configured on the specified CMCC interface.

show extended channel slot/port [path] [device] [admin] [oper] [stats]

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.

show extended channel icmp-stack

Use the show extended channel icmp-stack EXEC command to display information about the Internet Control Message Protocol (ICMP) stack running on the CMCC channel interfaces.

show extended channel slot/port icmp-stack [ip-address]

slot

Slot number.

port

Port number.

ip-address

(Optional) IP address specified by the offload interface configuration command or the tn3270-server pu command.


show extended channel ip-stack

Use the show extended channel ip-stack EXEC command to display information about the IP stack running on CMCC channel interfaces.

show extended channel slot/port ip-stack [ip-address]

slot

Slot number.

port

Port number.

ip-address

(Optional) IP address specified by the offload interface configuration command or the tn327-server pu command.


show extended channel lan

Use the show extended channel lan EXEC command to display the internal LANs and adapters configured on a CMCC adapter.

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

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.


show extended channel llc2

Use the show extended channel llc2 EXEC command to display information about the LLC2 sessions running on the CMCC adapter interfaces.

show extended channel slot/port llc2 [admin | oper | stats] [lmac [lsap [rmac [rsap]]]]

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.


show extended channel max-llc2-sessions

Use the show extended channel max-llc2-sessions privileged EXEC command to display information about the number of LLC2 sessions supported on the CMCC adapter.

show extended channel slot/port max-llc2-sessions

slot

Slot number.

port

Port number.


show extended channel packing names

Use the show extended channel packing names EXEC command to display CLAW packing names and their connection state.

show extended channel slot/port packing names [path [device-address]]

slot

Slot number.

port

Port number.

path

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

(Optional) 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.


show extended channel packing stats

Use the show extended channel packing stats EXEC command to display CLAW packing statistics.

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

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.


show extended channel statistics

Use the show extended channel statistics EXEC command to display statistical information about subchannels on the physical interface of a CMCC adapter. This command displays information that is specific to the interface channel devices. The information is generally useful only for diagnostic tasks performed by technical support personnel.

show extended channel slot/port statistics [path [device-address]] [connected]

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.


show extended channel subchannel

Use the show extended channel subchannel EXEC command to display information about the CMCC adapter physical interfaces. This command displays information that is specific to the interface channel connection. The information displayed is generally useful only for diagnostic tasks performed by technical support personnel.

show extended channel slot/port subchannel [connected]

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.


show extended channel tcp-connections

Use the show extended channel tcp-connections EXEC command to display information about the Transmission Control Protocol (TCP) sockets on a channel interface.

show extended channel slot/port tcp-connections [[loc-ip-addr [loc-port [rem-ip-addr [rem-port]] [detail | summary]

slot

Slot number.

port

Port number.

loc-ip-addr

(Optional) Local IP address. IP address of the local connection endpoint. Restricts the output to those connections with a matching local IP address.

loc-port

(Optional) Local TCP port. This is the TCP port of the local connection endpoint. Restricts the output to those connections with a matching local TCP port. An asterisk (*) is a wildcard that matches every port.

rem-ip-addr

(Optional) Remote IP address. IP address of the remote connection endpoint. Restricts the output to those connections with a matching remote IP address.

rem-port

(Optional) Remote TCP port. TCP port of the remote connection endpoint. Restricts the output to those connections with a matching remote TCP port.

detail

(Optional) Prints detailed information about every matching connection.

summary

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


show extended channel tcp-stack

Use the show extended channel tcp-stack EXEC command to display information about the TCP stack running on CMCC adapter interfaces.

show extended channel slot/port tcp-stack [ip-address]

slot

Slot number.

port

Port number.

ip-address

(Optional) IP address specified by the offload interface configuration command or the tn327-server pu command.


show extended channel tg

Use the show extended channel tg EXEC command to display configuration, operational information, and statistics information for CMPC transmission groups configured on the specified CMCC adapter's virtual interface.

show extended channel slot/port tg [oper | stats] [detailed] [tg-name]

slot

Slot number.

port

Port number.

oper

(Optional) Operational parameters for the CMPC transmission group values.

stats

(Optional) Statistical values for the CMPC transmission group.

detailed

(Optional) Additional LLC information about the CMPC transmission group.

tg-name

(Optional) Information for the specified tg-name.


show extended channel tn3270-server

Use the show extended channel tn3270-server EXEC command to display current server configuration parameters and the status of the PUs defined for the TN3270 server.

show extended channel slot/port tn3270-server

slot

Slot number.

port

Port number.


show extended channel tn3270-server client-ip-address

Use the show extended channel tn3270-server client-ip-address EXEC command to display information about all clients at a specific IP address.

show extended channel slot/port tn3270-server client-ip-address ip-address [disconnected |
in-session | pending]

slot

The slot number.

port

The port number.

ip-address

IP address of the client.

disconnected

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

in-session

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

pending

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


show extended channel tn3270-server dlur

Use the show extended channel tn3270-server dlur EXEC command to display information about the SNA session switch.

show extended channel slot/port tn3270-server dlur

slot

The slot number.

port

The port number.


show extended channel tn3270-server dlurlink

Use the show extended channel tn3270-server dlurlink EXEC command to display information about the DLUR components.

show extended channel slot/port tn3270-server dlurlink name

slot

Specifies a particular CMCC adapter in the router where slot is the slot number.

port

The port number.

name

Name of the SNA session switch link to be displayed.


show extended channel tn3270-server nailed-ip

Use the show extended channel tn3270-server nailed-ip EXEC command to display mappings between a nailed client IP address and nailed LUs.

show extended channel slot/port tn3270-server nailed-ip ip-address

slot

The slot number.

port

The port number.

ip-address

Remote client IP address.


show extended channel tn3270-server pu

Use the show extended channel tn3270-server pu EXEC command to display the PU configuration parameters, statistics and all the LUs currently attached to the PU.

show extended channel slot/port tn3270-server pu pu-name

slot

Specifies a particular CMCC adapter in the router where slot is the slot number.

port

The port value for a TN3270 server will always be 2.

pu-name

PU name that uniquely identifies this PU.


show extended channel tn3270-server pu lu

Use the show extended channel tn3270-server pu lu EXEC command to display information about the TN3270 server LUs running on CMCC adapter interface.

show extended channel slot/port tn3270-server pu pu-name lu locaddr [history]

slot

Specifies a particular CMCC adapter in the router where slot is the slot number. The port value for a TN3270 server will always be 2.

port

The port value for a TN3270 server will always be 2.

pu-name

PU name that uniquely identifies this PU.

locaddr

LU LOCADDR that uniquely identifies the LU.

history

(Optional) Displays the LU trace history.


show extended channel udp-listeners

Use the show extended channel udp-listeners EXEC command to display information about the User Datagram Protocol (UDP) listener sockets running on the CMCC adapter interfaces.

show extended channel slot/port udp-listeners [ip-address]

slot

Slot number.

port

Port number.

ip-address

(Optional) IP address specified by the offload interface configuration command or the tn3270-server pu command.


show extended channel udp-stack

Use the show extended channel udp-stack EXEC command to display information about the UDP stack running on the CMCC adapter interfaces.

show extended channel slot/port udp-stack [ip-address]

slot

Slot number.

port

Port number.

ip-address

(Optional) IP address specified by the offload interface configuration command or the tn3270-server pu command.


show interfaces channel

Use the show interfaces channel privileged EXEC command to display information about the CMCC adapter interfaces. This command displays information that is specific to the interface hardware. The information displayed is generally useful for diagnostic tasks performed by technical support personnel only.

show interfaces channel slot/port [accounting]

slot

Slot number.

port

Port number.

accounting

(Optional) Shows interface accounting information.


shutdown

Use the shutdown interface configuration command to shut down an interface or the virtual interface on the CMCC adapter when you are in interface configuration mode. The shutdown command also shuts down TN3270 entities, such as PU, DLUR, and DLUR SAP, depending on which configuration mode you are in when the command is issued. Use the no form of this command to restart the interface or entity. The entity affected depends on the mode in which the command is issued.

shutdown
no shutdown

tcp-port

Use the tcp-port TN3270 configuration command to override the default TCP port setting of 23. Use the no form of this command to restore the default.

tcp-port port-number
no tcp-port

port-number

A valid TCP port number in the range of 0 to 65534. The default is 23, which is the IETF standard. The value 65535 is reserved by the TN3270 server.


tg

Use the tg interface configuration command to define LLC connection parameters for the CMPC transmission group. Use the no form of this command to remove the specified transmission group from the configuration, which also deactivates the transmission group.

tg name llc token-adapter adapter-number lsap [rmac rmac] [rsap rsap]
no tg name

name

The name of the CMPC transmission group. The maximum length of the name is eight characters. This must match the name specified on the cmpc statements.

llc

Specifies that this TG is connected to the LLC stack on the CMCC adapter card.

token-adapter

Internal adapter type on the CMCC adapter card. The currently supported type is token-adapter.

adapter-number

Internal adapter number on the CMCC adapter card, which is the same value specified in the adapter internal LAN configuration command.

lsap

Local SAP number, 04 to FC, in hexadecimal. 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 IEEE 802.2 clients of that adapter, in the router or in a host, can use the same SAP.

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


timing-mark

Use the timing-mark TN3270 configuration mode command to select whether a WILL TIMING-MARK is transmitted when the host application needs an SNA response (definite or pacing response). Use the no form of this command to turn off WILL TIMING-MARK transmission except as used by the keepalive function.

timing-mark
no timing-mark

tn3270-server

Use the tn3270-server interface configuration command to start the TN3270 server on a CMCC adapter or to enter TN3270 configuration mode. Use the no form of this command to remove the existing TN3270 configuration.

tn3270-server
no tn3270-server

unbind-action

Use the unbind-action TN3270 configuration command to select what action to take when the TN3270 server receives an UNBIND. Use the no form of this command to restore the default.

unbind-action {keep | disconnect}
no unbind-action

keep

No automatic disconnect will be made by the server upon receipt of an UNBIND.

disconnect

Session will be disconnected upon receipt of an UNBIND.


vrn

Use the vrn DLUR SAP configuration command to tell the SNA session switch the connection network to which the internal adapter interface on the CMCC adapter belongs. Use the no form of this command to remove a network name.

vrn vrn-name
no vrn

vrn-name

Fully qualified name of the connection network.



hometocprevnextglossaryfeedbacksearchhelp
Posted: Mon Feb 8 13:42:47 PST 1999
Copyright 1989-1999©Cisco Systems Inc.