|
|
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.
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]
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.
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]
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.
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]
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.
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
Syntax Description
real-ip Real IP address of the offload-supported device. alias-ip Virtual IP address for the offload-supported device.
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]
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.
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 . . .
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.
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.
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.
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.
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Wed Jul 26 12:16:52 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.