cc/td/doc/product/software/ios121/121sup/121csum2
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

CLAW and TCP/IP Offload Commands

CLAW and TCP/IP Offload Commands

This chapter explains the function and syntax of the claw and TCP/IP offload commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Bridging and IBM Networking Command Reference, Volume 2, Release 12.1.

claw

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

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

no claw path device-address

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. The value packed 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. The value packed 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)

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

claw device-address ip-address host-name device-name host-app device-app [broadcast]

no claw device-address

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.

offload

To configure an Offload device (read and write subchannel) for communication with a mainframe TCP/IP stack in Offload mode, use the offload interface configuration command. 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

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.

offload alias

To assign a virtual IP address to a real IP address for an offload device on a CMCC adapter, use the offload alias interface configuration command. To remove the alias IP address, use the no form of this command.

offload alias real-ip alias-ip

no offload alias real-ip alias-ip

Syntax Description

real-ip

Real IP address of the offload-supported device.

alias-ip

Virtual IP address for the offload-supported device.

offload (backup)

To configure a backup group of Offload devices, use the offload IP host backup configuration command. Along with the path command, the offload backup 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

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.

path

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

path path . . .

no path path

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.

show extended channel backup

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

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

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 the ip-address argument.

show extended channel packing names

To display CLAW packing names and their connection state, use the show extended channel packing names EXEC command.

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

Syntax Description

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

To display CLAW packing statistics, use the show extended channel packing stats EXEC command.

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

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.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Wed Jul 26 12:16:52 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.