Doc. No. 78-3610-09 Cisco IOS Release 11.0 BT Release Note and Update to Configuration Guides and Command References January 15, 1999 This document supplements the Cisco IOS Release 11.0 documentation set with new and changed commands that support Cisco IOS Release 11.0(10)BT and later. Note that Cisco IOS Release 11.0(10)BT is the initial release of Cisco IOS Release 11.0 BT. No prior versions of Cisco IOS Release 11.0 BT exist.
Introduction • • • • • • • • Cisco IOS 11.0(15)BT Cisco IOS 11.0(16)BT Cisco IOS 11.0(17)BT Cisco IOS 11.0(18)BT Cisco IOS 11.0(19)BT Cisco IOS 11.0(20)BT Cisco IOS 11.0(21)BT Cisco IOS 11.0(22)BT Cisco IOS Release 11.0 BT is based on Cisco IOS Release 11.0.
Release Note Platform Support Cisco IOS Release 11.0 BT supports the following router platforms: • • Cisco 7500 series Cisco 7000 series and Cisco 7000 series with RSP7000 Cisco IOS Packaging The following feature sets are available in Release 11.0 BT. Refer to the Router Products Release Notes for Cisco IOS Release 11.0 for a list of the features provided in the Cisco 7000 and Cisco 7500 series feature sets.
Update to Configuration Guide Cisco 7500 Series and Cisco 7000 with RSP7000 Minimum Required Code Memory Cisco 7000 Series Required Main Memory Required CIP Memory Release 11.0 Runs From Required Code Memory Required CIP Memory Release 11.0 Runs From Enterprise Set (gs7-k-mz) 8 MB Flash memory card 16 Mb 32 Mb RAM Enterprise/CIP2 Set (gs7-k2-mz) 8 MB Flash memory card 16 Mb 32 Mb RAM Microcode Software Note that microcode software images are bundled with the system software image.
Cisco’s Implementation of TN3270 on a Channel Interface Processor Configuring TN3270 Server on the Channel Interface Processor This chapter describes TN3270 server support provided by the Channel Interface Processor (CIP) card for Systems Network Architecture (SNA) devices. For a complete description of the commands mentioned in this chapter, refer to the “TN3270 Server Commands” update chapter.
Configuring TN3270 on a Channel Interface Processor Note To enable the TN3270 server feature, you must have a CIP installed in a Cisco 7000 family router. The TN3270 server is different from the TN3270 terminal emulation access feature described in the “Configuring TN3270” chapter of the Access Services Configuration Guide. Configuring TN3270 on a Channel Interface Processor The following sections describe additional features of TN3270 server support on the CIP.
Configuring TN3270 on a Channel Interface Processor • IBM-DYNAMIC: This will result in “DYNAMIC” being put in the model type and number field. The VTAM configuration will need to have “DYNAMIC” defined as a template in the LU group. In fact “IBM-ZZ..Z,” where “ZZ..Z” does not match the preceding syntax, will be forwarded as “ZZ..Z.” Note The “E” in the model string refers to 3270 extended datastream. It has no connection with the “E” in “TN3270E”. • • Any other string is forwarded as is.
VTAM Host Configuration Considerations for Dynamic LU Allocation SNA Session Switch—End Node DLUR An end node DLUR function is implemented as part of the TN3270 server. The purpose of the DLUR is to allow the routing of TN3270 LUs to multiple VTAM hosts to be performed in the CIP card rather than on the VTAM hosts. The need for this feature will increase with the introduction of the new multi-CPU CMOS mainframe which comprises up to 16 CPUs that appear as separate VTAMs.
VTAM Host Configuration Considerations for Dynamic LU Allocation Figure 2 VTAM Host Values Defining LUSEED and LUGROUP Example VTAM host values defining LUSEED and LUGROUP name parameters: TN3270PU PU . IDBLK=05D, IDNUM=30001, * define other PU parameters LUSEED=TN3X1###, * define the seed component of the LU names created by DDDLU (e.g.
TN3270 Configuration Modes After the VTAM activation, the server can support session requests from clients using dynamic or specific LU allocation. TN3270 Configuration Modes The TN3270 configuration modes and router command prompts are described in the following sections and displayed in Figure 3. The TN3270 server can be configured only on Port 2, the internal LAN port, of a CIP card. Some configuration commands create entities on the CIP.
TN3270 Configuration Modes Figure 3 TN3270 Configuration Modes TN3270 configuration mode Prompt: tn3270-server> Prompt: TN3270 DLUR configuration mode tn3270-dlur> TN3270 DLUR SAP configuration mode TN3270/PU TN3270 DLUR PU configuration mode Prompt: tn3270-dlur-lsap> Prompts: tn3270-pu> tn3270-dlur> Use TN3270 DLUR PU configuration mode when the TN3270 server is attached to an APPN host. S4736 Use TN3270 PU configuration mode when the TN3270 server is attached to a non-APPN host.
TN3270 Configuration Modes DLUR SAP Configuration Mode From DLUR server configuration mode, lsap command puts you in DLUR SAP configuration mode. Prompt: tn3270-dlur-lsap> PU Configuration Mode There are two paths to PU configuration mode: from the TN3270 server configuration mode, or from the DLUR configuration mode. In either mode, the pu command puts you in PU configuration mode.
TN3270 Configuration Task List TN3270 Configuration Task List The following sections describe how to configure TN3270 server support on the CIP. Not all tasks are required. Refer to “TN3270 Configuration Example” for configuration examples. Note The TN3270 server is configured on an internal LAN interface in the CIP, which is port 2 of a CIP. Port 0 and port 1 represent physical interface ports; port 2 is a “virtual” port and is always reserved for the internal LAN interface.
TN3270 Configuration Task List Configure TN3270 Server This task is required. To establish a TN3270 server on the internal LAN interface on the CIP, perform the following tasks beginning in global configuration mode: Task Command Select the channel attach internal LAN interface and enter interface configuration mode. interface channel slot/2 Specify a TN3270 server on the internal LAN interface and enter TN3270 configuration mode. tn3270-server (Optional) Configure maximum number of LUs allowed.
TN3270 Configuration Task List Task Command (Optional) Specify the idle time for server disconnect. This command is also available in TN3270 configuration mode. idle-time num-of-seconds (Optional) Specify the maximum time allowed between keepalive marks before the server disconnects. This command is also available in TN3270 configuration mode. keepalive num-of-seconds (Optional) Specify whether the TN3270 session will disconnect when an UNBIND command is received.
TN3270 Configuration Task List Task Command (Optional) Create named links to hosts. A link should be configured to each potential NN server. (The alternative is to configure the NN servers to connect to DLUR.) If VRN is used it is not necessary to configure links to other hosts. Do not configure multiple links to the same host. link name [rmac rmac] [rsap rsap] Configure PUs under DLUR This task is required when configuring DLUR connected hosts.
TN3270 Configuration Task List TN3270 Configuration Example The following configuration has three PUs using DLUR and two more with direct connections. The initial CIP configuration is as follows: interface Channel2/2 ip address 10.10.20.126 255.255.255.
TN3270 Configuration Task List ! create direct pus for the non-APPN Host ! note that they must use different lsaps because they go to the same Host router(cfg-tn3270)#pu pu3 05d00001 10.10.20.5 tok 1 24 rmac 4100.cafe.0001 lu-seed pu3### router(tn3270-pu)#pu pu4 05d00002 10.10.20.5 tok 1 28 rmac 4100.cafe.0001 lu-seed pu4### router(tn3270-pu)#end The resulting configuration from the initial configuration and the configuration dialog follows: interface Channel2/2 ip address 10.10.20.126 255.255.255.
Update to Command Reference Update to Command Reference The information that follows is an update to the Router Products Command Reference, Chapters 23 to 33. Add the TN3270 information as a standalone chapter following page 33-30. TN3270 Server Commands This update describes the commands to configure TN3270 support on the Channel Interface Processor (CIP).
dlur dlur Use the dlur TN3270 configuration command to enable the Systems Network Architecture (SNA) session switch function on the CIP, 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.
dlus-backup 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 Syntax Description dlusname2 Fully qualified name of the backup DLUS for the DLUR. Default No backup DLUS is specified. Command Mode DLUR configuration Usage Guidelines Only one backup DLUS can be specified per CIP.
generic-pool 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 Syntax Description permit Left over LUs should be made available to TN3270 users wanting generic sessions. This value is the default.
generic-pool Similarly, if generic-pool permit is specified, any inactive LUs are immediately available for dynamic connections. Moreover, any active LUs that were dynamic previously (before generic-pool deny was issued) return to being dynamic.
idle-time 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 Syntax Description seconds Number of seconds, from 0 to 65535. A value of 0 means the session is never disconnected.
keepalive 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 Syntax Description seconds Number of seconds, from 0 to 65535. A value of 0 means no keepalive signals are sent. The default is 1800 seconds (30 minutes).
link 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 Syntax Description name Link name, from one to eight alphanumeric characters. The first character must be alphabetic. The name must be unique within the DLUR function. rmac (Optional) Remote MAC address of the form xxxx.xxxx.xxxx in hexadecimal.
link The following example shows different adapter numbers configured on the same internal LAN to avoid SAP contention. The host uses SAP 4 on token ring adapter 0: lan tokenring 0 adapter 0 4000.0000.0001 adapter 1 4000.0000.0002 tn3270-server dlur ... lsap token-adapter 1 link HOST rmac 4000.0000.
lsap 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] Syntax Description type Internal adapter type on the CIP card, which corresponds to the value specified in the lan internal LAN configuration command.
lsap Example The following command defines an adapter type, an adapter number, and a local SAP: lsap token 0 B0 Related Commands adapter lan TN3270 Server Commands 29
maximum-lus 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 Syntax Description number Maximum number of LU control blocks allowed. The allowed range is 0 to 32000. However, the practical upper limit for concurrently operating TN3270 sessions depends on the hardware and usage characteristics. The default is 2100.
preferred-nnserver 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 Syntax Description name A fully qualified name of a NN. Default This command has no defaults. Command Mode DLUR configuration Usage Guidelines Fully qualified names consist of two case-insensitive alphanumeric strings, separated by a period.
pu (direct) 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 pu pu-name idblk-idnum ip-address type adapter-number lsap [rmac rmac] [rsap rsap] [lu-seed lu-name-stem] no pu pu-name Syntax Description 32 pu-name Name that uniquely identifies this PU. idblk-idnum This value must match the IDBLK-IDNUM value defined at the host.
pu (direct) 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.
pu (direct) Related Commands adapter lan 34 TN3270 Server Commands
pu (DLUR) 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 Syntax Description pu-name Name that uniquely identifies this PU. idblk-idnum This value must match the idblk-idnum value defined at the host.
show extended channel tn3270-server show extended channel tn3270-server Use the show extended channel tn3270-server privileged EXEC command to display current server configuration parameters and the status of the PUs defined in each TN3270 server. show extended channel slot/2 tn3270-server Syntax Description slot/2 Specifies a particular CIP in the router where slot is the slot number. The port value for a TN3270 server is always 2.
show extended channel tn3270-server Table 5 Show tn3270-server Field Descriptions (Continued) Field Description DISCONN number Total number of disconnects since the TN3270 feature was started. FAIL number Total number of failed connects since the TN3270 feature was started. RESPONSE TIME, HOST number The average response time from the host across all sessions through this server IP address. This is measured from sending CD to the host to receiving the reply.
show extended channel tn3270-server Table 5 38 Show tn3270-server Field Descriptions (Continued) Field Description LINK type LINK type is either internal adapter type and internal adapter number or dlur if it is a SNA Session Switch PU. DESTINATION mac-address or PU-name If a direct PU, then it is the destination MAC address, otherwise, it is the name of the partner PU. R-LSAP number number Remote and local SAP values.
show extended channel tn3270-server client-ip-address show extended channel tn3270-server client-ip-address Use the show extended channel tn3270-server client-ip-address privileged EXEC command to display information about all clients at a specific IP address. show extended channel slot/2 tn3270-server client-ip-address ip-address Syntax Description slot/2 (Optional) Specifies a particular CIP in the router where slot is the slot number. The port value for a TN3270 server will always be 2.
show extended channel tn3270-server client-ip-address OUT IN OUT IN OUT IN IN OUT sdt req unbind req Client disconnect req notify resp warm actpu req len=28 2Cxxxxxxxx16038100F14011C3F0 len=9 2C0001040016838100 len=35 2Dxxxxxxxx3D6B80003201000000 len=10 2D000104043DEB800032 len=132 2Cxxxxxxxx0303800005C21D607C len=9 2C0000040003838000 len=20 xxxxxxxxxx110B80008106200C0600 len=12 2Cxxxxxxxx118B8000810620 Table 6 describes significant fields in the display.
show extended channel tn3270-server client-ip-address Table 6 Show tn3270-server client-ip-address Field Descriptions (Continued) Field Description BYTES IN/OUT number/number Total number of bytes sent to/received from the host. RUSIZE IN/OUT number/number RU size as configured in the bind. NEGRSP IN/OUT number/number Number of SNA negative responses sent to/received from the host. PACING WINDOW IN/OUT number/number SNA pacing window as configured in the bind.
show extended channel tn3270-server dlur show extended channel tn3270-server dlur Use the show extended channel tn3270-server dlur privileged EXEC command to display information about the SNA session switch. show extended channel slot/2 tn3270-server dlur Syntax Description slot/2 Specifies a particular CIP in the router where slot is the slot number. The port value for a TN3270 server will always be 2.
show extended channel tn3270-server dlur Table 7 Show tn3270-server dlur Field Descriptions (Continued) Field Description VRN fq-name Name of the connection network as configured by the virtual routing node (VRN) statement for this LSAP and internal adapter pair. LSAP...STATUS status Possible sap-status values and their meanings are: • inactive—Not connected to adapter. • pnd-actv—SAP activation in progress. • active—SAP open. • pnd-inac—SAP deactivation in progress.
show extended channel tn3270-server dlurlink show extended channel tn3270-server dlurlink Use the show extended channel tn3270-server dlurlink privileged EXEC command to display information about the DLUR components. show extended channel slot/2 tn3270-server dlurlink name Syntax Description slot/2 Specifies a particular CIP in the router where slot is the slot number. The port value for a TN3270 server will always be 2. name Name of the SNA session switch link to be displayed.
show extended channel tn3270-server pu show extended channel tn3270-server pu Use the show extended channel tn3270-server pu privileged EXEC command to display the PU configuration parameters, statistics and all the LUs currently attached to the PU. show extended channel slot/2 tn3270-server pu pu-name Syntax Description extended channel slot/2 (Optional) Specifies a particular CIP in the router where slot is the slot number. The port value for a TN3270 server will always be 2.
show extended channel tn3270-server pu Table 9 describes significant fields in the display. Table 9 Show tn3270-server pu Field Descriptions Field Description NAME pu-name Name of the PU as configured. IP:TCP ip-addr:tcpport IP address and TCP port number configured for the PU. XID number Configured XID - idblk and idnum. STATE pu-state Possible state values and their meanings are: • shut—The PU is configured, but is in a shut state. • reset—The link station of this PU is not active.
show extended channel tn3270-server pu Table 9 Show tn3270-server pu Field Descriptions (Continued) Field Description CLIENT-IP:TCP ip-addr:tcpport Client’s IP address and TCP port number. STATE lu-state The LU states and their meanings are: • unknown—LU is in an undefined state. • inactive—LU did not receive ACTLU. • active—LU received ACTLU and acknowledged positively. • p-sdt—LU is bound, but there is no SDT yet. • act/sess—LU is bound and in session.
show extended channel tn3270-server pu lu show extended channel tn3270-server pu lu Use the show extended channel tn3270-server pu lu privileged EXEC command to display information about the TN3270 server LUs running on CIP interface in a Cisco 7000 series. show extended channel slot/2 tn3270-server pu pu-name lu locaddr [history] Syntax Description slot/2 Specifies a particular CIP in the router where slot is the slot number. The port value for a TN3270 server will always be 2.
show extended channel tn3270-server pu lu OUT IN OUT IN OUT IN OUT IN Client connect req Reply PSID pos rsp actlu req bind req sdt req len=12 2Dxxxxxxxx456B80000D0201 len=25 xxxxxxxxxx45EB80000D0201000000 len=53 2Dxxxxxxxx466B800031010303B1 len=10 2D0001010646EB800031 len=10 2D00010106476B8000A0 len=10 2D0001010647EB8000A0 len=1677 2Cxxxxxxxx010381C07EC7114040 len=9 2C0001010001838100 Table 10 describes significant fields in the display.
show extended channel tn3270-server pu lu Table 10 50 Show tn3270-server pu lu Field Descriptions (Continued) Field Description RUSIZE IN/OUT number/number RU size as configured in the bind. NEGRSP IN/OUT number/number Number of SNA negative responses sent to/received from the host. PACING WINDOW IN/OUT number/number SNA pacing window as configured in the bind. CREDITS IN number Number of frames that can be sent inbound without requiring an isolated pacing response.
shutdown shutdown Use the shutdown interface configuration command to shutdown a physical interface or the internal LAN interface on the CIP 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.
tcp-port 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 Syntax Description 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. Defaults In TN3270 configuration mode, the default is 23.
timing-mark timing-mark Use the timing-mark TN3270 configuration mode command to select whether a DO TIMING-MARK is transmitted when the host application needs an SNA response (definite or pacing response). Use the no form of the command to turn off DO TIMING-MARK transmission except as used by the keepalive function. timing-mark no timing-mark Syntax Description This command has no arguments or key words. Default No DO TIMING-MARKS are transmitted except by keepalive.
tn3270-server tn3270-server Use the tn3270-server interface configuration command to start the TN3270 server on a CIP or to enter TN3270 configuration mode. Use the no form of this command to disable all TN3270 server activity on a CIP. tn3270-server no tn3270-server Syntax Description This command has no arguments or keywords. Default No TN3270 server function is enabled. Command Mode Interface configuration Usage Guidelines Only one TN3270 server can run on a CIP.
unbind-action 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 Syntax Description keep No automatic disconnect will be made by the server upon receipt of an UNBIND. disconnect LUT2 session clients will be disconnected upon receipt of an UNBIND. LUT1 and LUT3 session clients are not automatically disconnected.
vrn vrn Use the vrn DLUR SAP configuration command to tell the SNA session switch which connection network the internal adapter interface on the CIP card belongs to. Use the no form of this command to remove a network name. vrn vrn-name no vrn Syntax Description vrn-name Fully qualified virtual routing node (VRN) name. Default The adapter is not considered to be part of a connection network.
Cisco Connection Online Cisco Connection Online Cisco Connection Online (CCO) is Cisco Systems’ primary, real-time support channel. Maintenance customers and partners can self-register on CCO to obtain additional information and services. Available 24 hours a day, 7 days a week, CCO provides a wealth of standard and value-added services to Cisco’s customers and business partners.
Cisco Connection Documentation The CD is updated and shipped monthly so it might be more current than printed documentation. To order the CD, contact your local sales representative or call Customer Service. The CD is available both as a single CD and as an annual subscription. You can also access Cisco technical documentation on the World Wide Web URL http://www.cisco.com This document is to be used in conjunction with the Router Products Release Notes for Cisco IOS Release 11.0 publication.