Guest

Cisco IOS Software Releases 12.0 T

Cisco MultiPath Channel+

Table Of Contents

Cisco Multipath Channel+

Feature Summary

Benefits

List of Terms

Platforms

Related Publications

Supported MIBs and RFCs

Configuration Tasks

Configuration Tasks for the Host

Configure the VTAM Transport Resource List Major Node

Configure the Stacks

Configure the IBM TCP/IP Stack

Configure the HSAS Stack

Configuration Tasks for the Router

Assign IP Address to Network Interface

Configure the CMPC+ Subchannels

Configure the CMPC+ Transmission Groups

Configuration Examples

CMPC+ with TCP/IP Stack Example

Router

TCP/IP Profile

TRL Major Node Example

CMPC+ with HSAS Stack Example

Router

Stack Definition in the OE Parmlib Member for HSAS

HSAS Configuration Example

TRL Major Node Example

CMPC+ with TCP/IP and HSAS Stacks

Router

TRL Major Node for TCP/IP Stack Example

TRL Major Node for HSAS Stack Example

TCP/IP Profile

HSAS Stack Configuration

CMPC+ TG Using Two Interfaces Example

Router

HSAS Configuration Example

TRL Major Node for HSAS Stack Example

Command Reference

cmpc

Syntax Description

Command Mode

Usage Guidelines

Example

Related Commands

show extended channel cmgr

Syntax Description

Command Mode

Usage Guidelines

Sample Display

Related Commands

show extended channel cmpc

Syntax Description

Command Mode

Usage Guidelines

Sample Display

Related Commands

show extended channel statistics

Syntax Description

Command Mode

Usage Guidelines

Sample Displays

Related Commands

show extended channel subchannel

Syntax Description

Command Mode

Usage Guidelines

Sample Display

Related Commands

show extended channel tg

Syntax Description

Command Mode

Usage Guidelines

Sample Displays

Related Commands

tg

Syntax Description

Command Mode

Usage Guidelines

Example

Related Commands

Debug Commands

debug channel events

Command Mode

Usage Guidelines

Sample Display

Related Commands


Cisco Multipath Channel+


Feature Summary

CMPC+ is Cisco's implementation of IBM's MPC+ feature. The Cisco Multipath Channel+ (CMPC+) feature in Cisco IOS Release 12.0(3)T supports the MPC+ features and protocols necessary to support IP. CMPC+ enables High Performance Data Transfer (HPDT). It allows TCP/IP connections to the host through Cisco Mainframe Channel Connection (CMCC) adapters, using either the TCP/IP stack or the High Speed Access Services (HSAS) IP stack.

CMPC+ offers the following support:

Support for TCP/IP and HSAS Transmission Group (TG)

Support for one IP stack per MPC+ group

Support for one read subchannel and one write subchannel per CMPC+ group. The read subchannel and write subchannel in an MPC+ group can be on different physical channels.

Support for up to 64 KB per I/O block.

Runs on the Channel Interface Processor (CIP) and the the Channel Port Adapter (CPA)

Up to 64 MPC+ groups can be configured on a CMCC, depending on memory configuration. CMPC+ can coexist with CMPC, TCP/IP Offload, CLAW, TN3270, and CSNA features.

shows an MVS host with a TCP/IP stack and a Cisco router configured with CMPC+ and IP.

Figure 1 MVS Host with TCP/IP Stack and Cisco Router with CMPC+

shows a scenario where a VTAM host is configured with both HSAS and TCP/IP stacks. Each stack on the host has a TG with a read and write subchannel. The CMCC adapter can be a CIP or CPA. On the outbound flow coming from the host, the Cisco router receives the MPC+ packets from the channel, removes the MPC+ headers, and transfers the packets as IP packets to the IP cloud. The router sends the packets to the appropriate interface, depending on the destination IP address in the packet.

On the inbound flow coming from the IP cloud via LAN or WAN interfaces, the IP packets are switched from the Cisco IOS software to the CMCC adapter and MPC+ headers are added to the packets. The MPC+ block of packets is then sent to the host.

Figure 2 CMPC+ IP Structure

IP communication from one IBM host to another can also be accomplished through the same CMCC adapter. illustrates IP packets going from Host 1 to Host 2 and from Host 2 to Host 1. These packets are routed through the same Route Switch Processor (RSP) in the Cisco router.

Figure 3 IP Communication Between IBM Hosts Through the Same CMCC

illustrates IP packets flowing between host 1 and host 2. IP packets can also be sent from one host to another host using different CMCC adapters.

Figure 4 IP Communication Between IBM Hosts Using Different CMCC Adapters

illustrates IP communication flowing between host 1 and host 2. IP communication can occur between two different hosts connected through two different routers.

Figure 5 IP Communication Between Hosts Through Different Routers

illustrates IP communication between a host and different IP nodes.

Figure 6 IP Communication from a Host to IP Nodes

Benefits

The following benefits are available in CMPC+:

Support for HPDT

IP connections to hosts using MPC+

Coexists with CMPC, CSNA, TN3270, TCP/IP Offload, and CLAW features on a CMCC

ESCON and Parallel Channel support

ESCON Director support

EMIF support

List of Terms

Cisco Mainframe Channel Connection (CMCC)—Adapter cards (CIP or CPA) used in the Cisco 7000, 7200, and 7500 series routers for mainframe channel connections.

Cisco Multipath Channel (CMPC)—Cisco's implementation of IBM's MPC feature.

Cisco Multipath Channel+ (CMPC+)—Cisco's implementation of IBM's MPC+ feature.

High Performance Data Transfer (HPDT)—In VTAM, a family of functions that enhance the efficiency of large message transfers for VTAM application programs.

High Speed Access Services (HSAS)—IBM's high-speed TCP/IP stack that exclusively uses the efficient and strategic MPC point-to-point interface to communicate with both enterprise system connection (ESCON) network devices, and Open Systems Adapter (OSA) features.

Multipath Channel (MPC)—IBM channel protocol that allows a channel connection consisting of multiple read-direction and write-direction subchannels.

Multipath Channel+ (MPC+)—IBM channel protocol that allows channel connection consisting of multiple read-direction and write-direction subchannels that enables HPDT.

Transmission group (TG)—A connection between adjacent nodes.

Platforms

This feature is supported on these following platforms:

Router Platform Requirements

Cisco 7200, Cisco 7000 with RSP, and Cisco 7500 routers. These routers must have Cisco IOS Release 12.0(3)T or later, CMCC (either CIP or CPA) with a minimum of 32 MB DRAM and appropriate CMCC microcode.

Host Platform Requirements

The S/390 mainframe host is supported and the following networking software must be on the host:

OS/390 1.3 or later

ACF/VTAM 4.4 or later

The following IP stacks on the mainframe are supported:

TCP/IP 3.3 or later

HSAS

Related Publications

Mainframe-related publications include the following:

OS/390 TCP/IP OpenEdition Configuration Guide, SC31-8304-00

OS/390 TCP/IP OpenEdition Planning and Release Guide, SC31-8303-00

OS/390 TCP/IP OpenEdition User's Guide, GC31-8305-00

IP Planning and Migration Guide, SC31-8512

IP User's Guide, C31-8514-00

High Speed Access Services User's Guide, GC31-8676

ES/390 Principles of Operation, SA22-7201

VTAM Network Implementation Guide, SC31-8370-00

VTAM Resource Definition Reference, SC31-8377-00

VTAM V4R4 Resource Definition Samples, SC31-8378-00

Supported MIBs and RFCs

The following Management Information Bases (MIBs) are supported for CMPC+:

CISCO-CIPCMPC-MIB

CISCO-CIPTG-MIB

For descriptions of supported MIBs and how to use MIBs, see Cisco's MIB website on CCO at http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml

No RFCs are supported.

Configuration Tasks

This section describes the following configuration tasks for CMPC+:

Configuration Tasks for the Host

Configuration Tasks for the Router

Configuration Tasks for the Host

This section contains the following host configuration tasks:

Configure the VTAM Transport Resource List Major Node

Configure the Stacks

Configure the VTAM Transport Resource List Major Node

The CMPC+ feature supports standard Transport Resource List (TRL) major node configurations, standard TCP Profiles and OE configuration statements. The host configuration must be coordinated with the CMPC+ configuration for IP connectivity to be successful.

Following is a sample TRL configuration:

MPCPRTL  VBUILD TYPE=TRL                                                
MPCPTRLE TRLE  LNCTL=MPC,MAXBFRU=16,                                   X
               READ=(246),                                             X
               WRITE=(247)   
                                           

CMPC+ requires a unique TRLE for each CMPC+ TG.

Configure the Stacks

This section provides samples for the following tasks:

Configure the IBM TCP/IP Stack

Configure the HSAS Stack

Configure the IBM TCP/IP Stack

Following is an excerpt of a sample TCP/IP profile. The most important configuration commands are in bold:

DEVICE mpcptrle MPCPTP
LINK MPCPIP1   MPCPTP mpcptrle
;
telnetparms
  TIMEMARK 600
  PORT 23
  DBCSTRANSFORM
endtelnetparms
;
ASSORTEDPARMS NOFWD ENDASSORTEDPARMS
;
PORT
    20 TCP OMVS      NOAUTOLOG ; FTP Server
    21 TCP OMVS                ; FTP Server
    23 TCP INTCLIEN            ; TELNET Server
    25 TCP SMTP                ; SMTP Server
    53 TCP NAMESRV             ; Domain Name Server
    53 UDP NAMESRV             ; Domain Name Server
   111 TCP OMVS                ; OE Portmap Server
   111 UDP OMVS                ; OE PORtmap Server
   135 UDP NCSLLBD             ; NCS Location Broker
   161 UDP SNMPD               ; SNMP Agent
   162 UDP SNMPQE              ; OE SNMPQE Agent
   515 TCP LPSERVE             ; LPD Server
   520 UDP OROUTED             ; OE RouteD Server
   750 TCP MVSKERB             ; Kerberos
   750 UDP MVSKERB             ; Kerberos
   751 TCP ADM@SRV             ; Kerberos Admin Server
  2049 UDP MVSNFS              ; NFS Server
  3000 TCP CICSTCP             ; CICS Socket
HOME
    172.18.5.3    MPCPIP1
GATEWAY
    172.18.5.1 = MPCPIP1 4468 HOST
    DEFAULTNET  172.18.5.1  MPCPIP1 4468 0
;
; TRANSLATE
BEGINVTAM
 3278-2-E NSX32702 ; 24 line screen
 3279-2-E NSX32702 ; 24 line screen
 3278-3-E NSX32703 ; 32 line screen - default of NSX32702 is 24 lines
 3279-3-E NSX32703 ; 32 line screen - default of NSX32702 is 24 lines
 3278-4-E NSX32704 ; 48 line screen - default of NSX32702 is 24 lines
 3279-4-E NSX32704 ; 48 line screen - default of NSX32702 is 24 lines
 3278-5-E NSX32705 ; 132 column screen - default of NSX32702 is 80
 3279-5-E NSX32705 ; 132 column screen - default of NSX32702 is 80
DEFAULTLUS
      TCP20000..TCP20999  ; allow 1000 LU-LU SESSIONS on this TCPIP
  ENDDEFAULTLUS
ALLOWAPPL * ; Allow access to all applications 
USSTCP USSTCPMF MPCPIP1
ENDVTAM
DATASETPREFIX TCPMVS2.TCPIP1
START MPCPTRLE

For the CMCC adapter, the MTU size on the DEFAULTNET statement must be 4468 or less to ensure that the CMCC adapter does not receive packets larger than the CMCC adapter's MTU.

Configure the HSAS Stack

Following are the sample OE configuration commands for configuring and activating the HSAS stack:

oeifconfig trle host-ip-addr router-ip-addr [mtu size] [netmask netmask]
oeifconfig trle [up|down|detach]
oeroute [flags] [add|delete] [default|dest-ip-addr gateway-ip-addr [metric]]
oenetopts [+-a [config-file-name]]

For HSAS, the MTU size must be set to 4468.

Configuration Tasks for the Router

This section describes the configuration tasks associated with the CMPC+ feature.

Assign IP Address to Network Interface

Configure the CMPC+ Subchannels

Configure the CMPC+ Transmission Groups

Assign IP Address to Network Interface

To assign an IP address to the network interface, use the following command in interface configuration mode:

ip address ip-address mask secondary

Assign IP address to network interface.


Configure the CMPC+ Subchannels

To define a CMPC+ read subchannel and CMPC+ write subchannel, use the following commands in interface configuration mode on a CMCC adapter physical interface:

Step
Command
Purpose

1

cmpc path device tg-name read

Configure the CMPC+ read subchannel.

2

cmpc path device tg-name write

Configure the CMPC+ write subchannel.


These statements define the subchannel addresses that CMPC+ uses to connect to the host and to correspond to the definitions in the TRL major network node on the host.

Use the no cmpc path device command to remove the definition of a subchannel.

Configure the CMPC+ Transmission Groups

To define a CMPC+ TG by name, use the following command in interface configuration mode on a CIP virtual interface or a CPA physical interface:

Command
Purpose

tg tg-name [ip | hsas-ip] host-ip-addr local-ip-addr

Define IP addresses for CMPC+ connection.


The tg command defines the name of the TG. The tg-name must match the name given in the cmpc command issued in the physical interfaces on the same CMCC adapter.

Use the no tg command to delete a CMPC+ TG from the configuration and deactivate the TG.

To change any parameter of the tg statement, the statement must be removed by using the no tg tg-name command and reentered first with new parameters.

Configuration Examples

Following are the CMPC+ configuration examples shown in this section:

CMPC+ with TCP/IP Stack Example

CMPC+ with HSAS Stack Example

CMPC+ with TCP/IP and HSAS Stacks

CMPC+ TG Using Two Interfaces Example

CMPC+ with TCP/IP Stack Example

illustrates TCP/IP link for CMPC+ between a Host and a Cisco router with a CMCC adapter. The configurations for this example follow.

Figure 7 CMPC+ IP with TCP/IP

Router

The following configuration is for the CIP in the Cisco 7500 router:

hostname ipclust1
!
microcode CIP flash slot0:cip27-0
microcode reload
!
interface Channel0/1
 no ip address
 no keepalive
 cmpc 0170 00 TG00 READ
 cmpc 0170 01 TG00 WRITE
!
interface Channel0/2
 ip address 80.12.165.1 255.255.255.0
 no ip redirects
 no ip directed-broadcast
 ip route-cache same-interface
 no ip mroute-cache
 load-interval 30
 no keepalive

 tg TG00     ip 80.12.165.2 80.12.165.1

In this configuration, the CMPC+ configuration is for the TCP/IP stack on the host. The host IP address of 80.12.165.2 in the TG statement corresponds to the IP address for the TCP/IP stack in the TCP/IP profile on the host. The IP address for the CIP is 80.12.165.2.

TCP/IP Profile

The following sample shows the TCP/IP Profile on the Host:

ARPAGE 5
telnetparms timemark 600 port 23 dbcstransform endtelnetparms
ASSORTEDPARMS NOFWD ENDASSORTEDPARMS
;
DEVICE mpc4b00  MPCPTP
LINK MPCPLNK2 MPCPTP mpc4b00
;
AUTOLOG
  OEFTPE3
ENDAUTOLOG
INCLUDE TODD.MPCP.TCPIP.PROFILES(PORTS)
HOME
  80.12.165.2   MPCPLNK2
GATEWAY
; NETWORK    FIRST     DRIVER    PACKET   SUBNet mask    subnet value
;             HOP                 SIZE
 80.12.165.1   =    mpcplnk2     4468     host
DEFAULTNET 80.12.165.1 mpcplnk2  4468     0
BEGINVTAM
    ; Define logon mode tables to be the defaults shipped with the latest
    ; level of VTAM
  3278-3-E NSX32703 ; 32 line screen - default of NSX32702 is 24 line screen
  3279-3-E NSX32703 ; 32 line screen - default of NSX32702 is 24 line screen
  3278-4-E NSX32704 ; 48 line screen - default of NSX32702 is 24 line screen
  3279-4-E NSX32704 ; 48 line screen - default of NSX32702 is 24 line screen
  3278-5-E NSX32705 ; 132 column screen - default of NSX32702 is 80 columns
  3279-5-E NSX32705 ; 132 column screen - default of NSX32702 is 80 columns
    ; Define the LUs to be used for general users
  DEFAULTAPPL ECHOMVSE
; DEFAULTAPPL ECHOMVSE 10.10.1.188
; DEFAULTAPPL NETTMVSE
  DEFAULTLUS
      TCPE0000..TCPE9999
  ENDDEFAULTLUS
  ALLOWAPPL * ; Allow all applications that have not been previously
              ; specified to be accessed
ENDVTAM
DATASETPREFIX TODD.MPCP
start mpc4b00

In this TCP/IP profile, the DEVICE specifies the VTAM TRLE mpc4b00 and LINK specifies the link name (MPCPLNK2) associated with the IP address (80.12.165.2) for that link. The host IP address 80.12.165.2 that is specified for the TG in the router configuration must be identical to the IP address specified for the TG in the router configuration.

TRL Major Node Example

The following sample shows the TRL major node example:

TRL4B00 VBUILD TYPE=TRL
MPC4B00  TRLE  LNCTL=MPC,MAXBFRU=16,                                         X
               READ=(4B00),                                                  X
               WRITE=(4B01)

In this TRL major node example, the parameter MPC4B00 must be identical to the LINK parameter in the TCP/IP profile.

CMPC+ with HSAS Stack Example

illustrates HSAS for CMPC+ between a host and a Cisco router with a CMCC adapter. The configurations for this example follow.

Figure 8 CMPC+ IP with HSAS

Router

The following sample shows the configuration for the CIP in the Cisco 7500 router:

hostname ipclust1
!
microcode CIP flash slot0:cip27-0
microcode reload
!
interface Channel0/1
 no ip address
 no keepalive
 cmpc 0170 00 TG00 READ
 cmpc 0170 01 TG00 WRITE
!
interface Channel0/2
 ip address 80.12.165.1 255.255.255.0
 no ip redirects
 no ip directed-broadcast
 ip route-cache same-interface
 no ip mroute-cache
 load-interval 30
 no keepalive
 tg TG00 hsas-ip 80.12.165.2 80.12.165.1

In this configuration, the CMPC + configuration is for the HSAS stack on the host. The IP address of 80.12.165.2 on the CIP corresponds to the HSAS IP address for the HSAS stack on the host.

Stack Definition in the OE Parmlib Member for HSAS

The following example shows the HSAS communications stack defined through the BPXPRMxy member in SYS1.PARMLIB. The most important configuration statement is shown in bold.

SYS1.PARMLIB(BPXPRMxy)
.
.
FILESYSTYPE    ENTRYPOINT(BPXTCINT)  TYPE(CINET)                
NETWORK DOMAINNAME(AF_INET) DOMAINNUMBER(2) MAXSOCKETS(11000)   
    TYPE(CINET)  INADDRANYPORT(5000)  INADDRANYCOUNT(4000)      
SUBFILESYSTYPE NAME(TCPMVSE1) ENTRYPOINT(EZBPFINI) TYPE(CINET)  
     DEFAULT                                                    
SUBFILESYSTYPE NAME(TCPMVSE2) ENTRYPOINT(EZBPFINI) TYPE(CINET)  
SUBFILESYSTYPE NAME(TCPMVSE3) ENTRYPOINT(EZBPFINI) TYPE(CINET)  
SUBFILESYSTYPE NAME(TCPMVSE4) ENTRYPOINT(EZBPFINI) TYPE(CINET)  
SUBFILESYSTYPE NAME(TCPMVSE5) ENTRYPOINT(EZBPFINI) TYPE(CINET)  
SUBFILESYSTYPE NAME(TCPMVSE6) ENTRYPOINT(EZBPFINI) TYPE(CINET)  
SUBFILESYSTYPE NAME(TCPMVSE7) ENTRYPOINT(EZBPFINI) TYPE(CINET)  
SUBFILESYSTYPE NAME(TCPMVSE8) ENTRYPOINT(EZBPFINI) TYPE(CINET)  
SUBFILESYSTYPE NAME(OESTACK)  ENTRYPOINT(BPXUIINT) TYPE(CINET)  

The OpenEdition Common INET physical file system must be defined to include the HSAS communications stack (OESTACK). Whereas other IP communications stacks require a separate address space, the HSAS communications stack resides within the OpenEdition kernel.

The SUBFILESTYPE NAME(OESTACK) statement defines the HSAS stack. This statement must be coded exactly as shown in the example and only one such statement must be coded.

HSAS Configuration Example

The following sample is the HSAS configuration on the MVS host:

oeifconfig mpc4b02 80.80.165.2 80.12.165.1 mtu 4468
oeroute add default 80.12.165.1

TRL Major Node Example

The following sample is the TRL major node configuration:

TRL4B02 VBUILD TYPE=TRL
MPC4B02 TRLE  LNCTL=MPC,MAXBFRU=16,                                    X
               READ=(4B02),                                            X
               WRITE=(4B03)

In this TRL major node configuration, the parameter MPC4B02 must be identical to the trle parameter in the oeifconfig configuration.

CMPC+ with TCP/IP and HSAS Stacks

illustrates CMPC+ used between a Cisco router with a CMCC adapter and a Host with both TCP/IP and HSAS stacks.

Figure 9 CMPC+ with TCP/IP and HSAS Stacks

Router

The following is the CMPC+ configuration for TCP/IP and HSAS in the CPA:

hostname ipclust2
!
enable secret 5 $1$2Py5$GmguUvRGwLdOj2UCi6cv71
enable password lab
!
microcode ecpa slot0:xcpa216-0.plus110698
microcode reload
ip subnet-zero
ip host bizarre 171.69.160.37
ip domain-name cisco.com
ip name-server 171.69.161.21
!
interface Channel5/0
 ip address 80.80.2.1 255.255.255.0
 no ip directed-broadcast
 ip route-cache same-interface
 no ip mroute-cache
 load-interval 30
 no keepalive
 cmpc 0180 00 TG00 READ
 cmpc 0180 01 TG00 WRITE
 cmpc 0180 02 TG02 READ
 cmpc 0180 03 TG02 WRITE
 tg TG00     ip 80.80.2.2 80.80.2.1
 tg TG02     hsas-ip 80.80.2.3 80.80.2.1

In this configuration, the cmpc configuration is for the TCP/IP and HSAS stacks on the host. The IP address of 80.80.2.2 corresponds to the IP address for the TCP/IP stack in the TCP/IP profile on the host. The IP address of 80.80.2.3 corresponds to the IP address in the HSAS stack on the host.

TRL Major Node for TCP/IP Stack Example

The following sample shows the TRL major node configuration for the TCP/IP stack:

TRL4900 VBUILD TYPE=TRL
MPC4900 TRLE  LNCTL=MPC,MAXBFRU=6,REPLYTO=3,                                  x
               READ=(4900),WRITE=(4901)

In this TRL major node example, the parameter MPC4900 must be identical to the TRLE parameter in the LINK statement in the TCP/IP profile.

TRL Major Node for HSAS Stack Example

The following sample shows the TRL major node configuration for the HSAS stack:

TRL4902  VBUILD TYPE=TRL 
MPC4902  TRLE  LNCTL=MPC,MAXBFRU=9,REPLYTO=3,                                 X
               READ=(4902),                                                   X
               WRITE=(4903)

In this TRL major node example, the parameter MPC4B02 must be identical to the oeifconfig statement in the TCP/IP profile.

TCP/IP Profile

The following example shows the TCP/IP Profile on the Host:

ARPAGE 5
telnetparms timemark 600 port 23 dbcstransform endtelnetparms
ASSORTEDPARMS NOFWD ENDASSORTEDPARMS
;
DEVICE mpc4900  MPCPTP
LINK MPCPLNK2 MPCPTP mpc4900
;
INCLUDE TODD.MPCP.TCPIP.PROFILES(PORTS)
HOME
  80.80.2.2     MPCPLNK2
GATEWAY
; NETWORK    FIRST     DRIVER    PACKET   SUBNet mask    subnet value
;             HOP                 SIZE    
 80.80.2.1     =       mpcplnk2   4468     host
DEFAULTNET 80.80.2.1   mpcplnk2   4468      0
BEGINVTAM
    ; Define logon mode tables to be the defaults shipped with the latest
    ; level of VTAM
 3278-3-E NSX32703 ; 32 line screen - default of NSX32702 is 24 line screen
 3279-3-E NSX32703 ; 32 line screen - default of NSX32702 is 24 line screen
 3278-4-E NSX32704 ; 48 line screen - default of NSX32702 is 24 line screen
 3279-4-E NSX32704 ; 48 line screen - default of NSX32702 is 24 line screen
 3278-5-E NSX32705 ; 132 column screen - default of NSX32702 is 80 columns
 3279-5-E NSX32705 ; 132 column screen - default of NSX32702 is 80 columns
    ; Define the LUs to be used for general users
 DEFAULTAPPL ECHOMVSF
; DEFAULTAPPL NETTMVSE
 DEFAULTLUS
     TCPF0000..TCPF9999
  ENDDEFAULTLUS
  ALLOWAPPL * ; Allow all applications that have not been previously
              ; specified to be accessed
ENDVTAM
DATASETPREFIX TODD.MPCP

START mpc4900

In this TCP/IP profile, the DEVICE specifies the VTAM TRLE mpc4900 and LINK specifies the link name (MPCPLNK2) associated with the IP address (80.8.2.2) for that link. The IP address 80.80.2.1 must be identical to the IP address specified for the TG in the router configuration.

HSAS Stack Configuration

The following example shows the OE commands for the HSAS stack configuration:

oeifconfig mpc4902 80.80.2.3 80.80.2.1 mtu 4468
oeroute add default 80.80.2.1

In this configuration, mpc4902 must be identical to the TRLE parameter in the oeifconfig configuration.

CMPC+ TG Using Two Interfaces Example

illustrates CMPC+ used between a Cisco router with a CIP and a Host with split TGs.


Note   The split TG configuration is only supported on a CIP with two physical interfaces.


Figure 10 CMPC+ with Split TG

Router

The following example shows the CMPC+ router configuration for a split transmission group:

interface Channel0/0
 no ip address
 no ip directed-broadcast
 no keepalive
 cmpc 0170 00 TG00 READ
!
interface Channel0/1
 no ip address
 no ip directed-broadcast
 no keepalive
 cmpc 0170 00 TG00 WRITE
!
interface Channel0/2
 ip address 80.12.165.1 255.255.255.0
 no ip redirects
 no ip directed-broadcast
 ip route-cache same-interface
 no ip mroute-cache
 load-interval 30
 no keepalive
 tg TG00      hsas-ip 80.12.165.2 80.12.165.1
! 

HSAS Configuration Example

The following example shows the HSAS configuration on the Host:

oeifconfig mpcsplit 80.12.165.2 80.12.165.1 mtu 4468
oeroute add default 80.12.165.1

TRL Major Node for HSAS Stack Example

The following example shows the TRL major node configuration for the HSAS stack:

TRLSPLIT VBUILD TYPE=TRL                                                
MPCSPLIT TRLE  LNCTL=MPC,MAXBFRU=16,REPLYTO=3,                         X
               READ=(5200),                                            X
               WRITE=(4B00)

In this TRL major node example, the parameter mpcsplit must be identical to the TRLE parameter in the LINK statement within the oeifconfig statement.

Command Reference

This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.0 command references.

cmpc

show extended channel cmgr

show extended channel cmgr

show extended channel cmpc

show extended channel statistics

show extended channel subchannel

show extended channel tg

tg

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

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. For the bus and tag, use the value 0x0100.

device

Two-digit hexadecimal value that specifies the device address of the CMPC+ subchannel.

tg-name

Name of the CMPC+ transmission group. The maximum length of the name is eight characters.

read

Read value is identical to the read value specified in the TRL major node. Specifies the subchannel used for reads. This must match the configuration of the device TRL.

write

Write value is identical to the write value specified in the TRL major node. It specifies the subchannel used for writes.


Command Mode

Interface configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 11.3. This command supports CMPC+ in Cisco IOS Release 12.0(3)T.

Each cmpc configuration command in a 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 and 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 can be configured on separate physical interfaces.

The no cmpc command deactivates the CMPC+ subchannel and all sessions using the TG are immediately terminated.

Example

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

cmpc C020 F8 CONFIGE READ
cmpc C020 F9 CONFIGE WRITE

Related Commands

show extended channel cmpc
show extended channel tg
show extended channel subchannel
show extended channel statistics

show extended channel cmgr

Use the show extended channel cmgr privileged EXEC command to display information about the MPC+ TG connection manager.

show extended channel slot/port cmgr [tg-name]

Syntax Description

slot

Slot number.

port

Physical channel interface port number.

cmgr

connection manager.

tg-name

(Optional) Name of the transmission group.


Command Mode

Privileged EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 12.0(3)T.

This command is valid on the CIP's virtual channel interface or the CPA's physical channel interface.

Sample Display

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

Router# show extended channel 3/2 cmgr
CMGR:MPCPTG2  Type=PTP
  Local Group Token:0500128933                    Remote Group Token :0500993355
  Local VC Token   :0500109002                    Local Conn. Token  :0500109003
  Remote VC Token  :0500201002                    Remote Conn. Token :0500201002
  VC Status        :Active                        Connection Status  :Active

CMGR:MPCPTG3   Type=PTP
  Local Group Token:050014573                    Remote Group Token :05008984300
  Local VC Token   :0500109044                   Local Conn. Token  :0500109066
  Remote VC Token  :0500201095                   Remote Conn. Token :0500201088
  VC Status        :Active                       Connection Status  :Active

describes the fields shown in the display.

Table 1 Show Extended Channel CMPC+ Field Descriptions  

Field
Description

Local Group Token

CMCC's MPC+ group token for this TG.

Remote Group Token

Host's MPC+ group token for this TG.

Type

Connection manager type supported is point-to-point (PTP).

Local VC Token

CMCC adapter's token for the connection manager's virtual circuit.

Remote VC Token

host's token for the connection manager's virtual circuit.

VC Status

Valid states for a VC are:

Reset—Awaiting a connection manager virtual circuit activate indication from the host.

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

Local Conn Token

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

Remote Conn Token

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

Connection Status

Valid states for a connection manager's connection are:

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

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


Related Commands

cmpc
show extended channel cmgr

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

Syntax Description

slot

Slot number.

port

Physical channel interface port number.

path

(Optional) Logical channel path.

device

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


Command Mode

Privileged EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 11.3. This command was modified in Cisco IOS Release 12.0(3)T to include CMPC+ support.

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

Sample Display

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

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  

describes the fields shown in the display.

Table 2 Show Extended Channel CMPC+ Field Descriptions  

Field
Description

Path

CMPC+ channel path configured.

Dv

CMPC+ subchannel device configured.

TGName

Transmission group name configured for the CMPC+ subchannel.

Dir

Identifies this CMPC+ subchannel as READ or WRITE.

Bfrs

On the read subchannel, this is the number of 4 KB-size pages that VTAM has allocated for each read. This number matches the MAXBFRU value configured in the VTAM TRL major node. On the write subchannel, this is the maximum number of 4 KB pages VTAM can write to the CMCC adapter for a single channel I/O. The value is always 16 for the write subchannel because the CIP always allows VTAM to write up to 64 KB per channel I/O.

Status

State of the CMPC+ subchannel. Valid values are:

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

Inactive—CMPC+ subchannel is not active.

XID2_Pending—XID2 handshaking is in progress.

Active—XID2 exchange is complete; subchannel is active in non-HPDT mode. This value is invalid for IP.

Active+—XID2 exchange is complete; subchannel is active in HPDT mode.


Related Commands

cmpc
show extended channel cmgr

show extended channel statistics

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

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

Syntax Description

slot

Slot number.

port

Port number.

path

(Optional) Hexadecimal value in the range 0x0000 to 0xFFFF. This specifies the data path and consists of two digits for the physical connection (either on the host or on the ESCON Director switch): one digit for the control unit address, and one digit for the channel logical address.

device-address

(Optional) Hexadecimal value in the range 0x00 to 0xFE. This value is the unit address associated with the control unit number and path as specified in the host IOCP file. For CLAW and offload support, the device address must have an even value.

connected

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


Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 10.2.

Sample Displays

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


tanzania#show extended channel 0/1 statistics
Path:C020  -- ESTABLISHED
                  Command             Selective     System     Device        CU
Dev   Connects    Retries    Cancels      Reset      Reset     Errors       Busy
 30          5          0          0          0          3          0          0
 31          5          0          0          0          3          0          0
 36         27         15          1          0          3          0          0
 37         29          6          1          0          3          0          0
                 Blocks               Bytes              Dropped Blk    Memd
Dev-Lnk      Read      Write      Read     Write       Read      Write  wait Con
 30-00          0          0         0         0          0          0     0   N
 31-00          0          0         0         0          0          0     0   N
 36-00         19          6     54236       789          0          0     0   Y
 37-00          9         17       801     63302          0          0     0   Y
Path C020
Total:        28         23     55037     64091          0          0     0
Path:C190  -- ESTABLISHED
                  Command             Selective     System     Device        CU
Dev   Connects    Retries    Cancels      Reset      Reset     Errors       Busy
 34         12          0          0          0          5          0          0
 35         12          0          0          0          5          0          0
 36        251        226          6          0          5          0          0
 37        258         14          8          0          5          0          0
 3E         12          0          0          0          5          0          0
 3F         12          0          0          0          5          0          0
                 Blocks               Bytes              Dropped Blk    Memd
Dev-Lnk      Read      Write      Read     Write       Read      Write  wait Con
 34-00          0          0         0         0          0          0     0   N
 35-00          0          0         0         0          0          0     0   N
 36-00        236         12   3604441      1578          0          0     0   Y
 37-00         18        236      1602   4217913          0          0     0   Y
 3E-00          0          0         0         0          0          0     0   N
 3F-00          0          0         0         0          0          0     0   N
Path C190
Total:       254        248   3606043   4219491          0          0     0
Adapter Card
Total:       282        271   3661080   4283582          0          0     0
  Last statistics 8 seconds old, next in 2 seconds
tanzania#

Table 3 Show Extended Channel Statistics Field Descriptions 

Field
Description

Path

Path from the CLAW, offload, CMPC+, or CSNA configuration.

Dev

Address for each device. For CLAW and offload, there are two device addresses. In the configuration statement, you specify only the even address. Both CSNA and CMPC+ have one device.

Connects

Number of times the channel started a channel program on the device.

Command Retries

Number of times the CMCC adapter either had no data to send to the channel (for the read subchannel) or the number of times the CMCC adapter had no buffers to hold data from the channel (for the write subchannel). Every command retry that is resumed results in a connect. A command retry can be ended via a cancel.

Cancels

Host requested any outstanding operation to be terminated. It is a measure of the number of times the host program was started.

Selective Reset

Selective reset resets only one device.On VM, selective reset occurs when a device is attached and a CP Initial Program Load (IPL) command is issued.

System Reset

Number of times the system IPL command was issued. A system reset affects all devices on the given channel. The command is always issued when the ECA is initialized, and when the channel is taken off line.

Device Errors

Errors detected by the ESCON or Parallel interface because of problems on the link. This value should always be 0.

CU Busy

Number of times the adapter returned a control unit busy indication to the host. This indication occurs after a cancel or reset if the host requests an operation before the CMCC adapter has finished processing the cancel or reset.

Dev-Lnk

First number is the device address. The second number is the logical link. Link 0 is always used for CLAW control messages. For IP datagram mode, link 1 is for actual datagram traffic.

For offload, link 2 is for API traffic. For CSNA and CMPC+, the Dev-Lnk is not relevant.

Blocks Read/Write

Count of channel blocks that are read and written from the mainframe.

Bytes Read/Bytes Write

Sum of the bytes in the blocks.

Dropped Blk Read/Write

If the route processor sends data to the CMCC adapter faster than it can send it to the channel, then the block is dropped. High values mean the host is not running fast enough. A write drop occurs if the CMCC adapter fails to get a router processor buffer n times for a given block. See the Memd wait counter.

Memd wait

Number of times the CMCC adapter could not obtain a buffer.

Con

For link 0, a connection of Y means the system validation is complete. For all other links, Con means the connection request sequence is completed. For CSNA devices, a value of Y is displayed when the CSNA device status is complete. For all other states, the Con shows a value of N.


describes the fields shown in the display.

The following is sample output using the show extended channel statistics command for the CSNA path:

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