February 2, 1998
This document contains the release notes for the unbundled CIP microcode software. Prior to Cisco Internetwork Operating System (Cisco IOSTM) Release 11.1, CIP microcode was provided as part of the Cisco IOS software "bundle." Beginning with Cisco IOS Release 11.1 and continuing with all subsequent Cisco IOS software releases, the CIP microcode was unbundled from the Cisco IOS software. Therefore, you can obtain the CIP microcode as a separately loadable software module and match a version of the CIP microcode to the Cisco IOS software.
Refer to the "CIP Microcode and CIP Hardware Compatibility" section for a list of CIP microcode releases described by this document..

| Caution If you are upgrading from a previous Cisco IOS release, a special microcode installation procedure is required or your CIP will not operate properly. For details, refer to the section "CIP Microcode Upgrade Overview."
|
This CIP microcode release note describes the CIP microcode modifications and caveats for the latest versions of CIP microcode. It includes all CIP microcode releases described in the section "CIP Microcode and CIP Hardware Compatibility." Also included is an overview of the procedures required to upgrade to the latest versions of CIP microcode depending on the CIP-compatible router platform you have.
This CIP microcode release note discusses the following topics:
- Cisco IOS Software and Cisco 7000 Family Hardware Documentation, page 2
- How Does CIP Microcode Ship?, page 3
- CIP Microcode and CIP Hardware Compatibility, page 4
- CIP Microcode/Cisco IOS Software Compatibility Matrix, page 4
- CIP Microcode Release cip25 Caveats and Modifications, page 5
- CIP Microcode Release cip24 Caveats and Modifications, page 10
- CIP Microcode Release cip22 Caveats and Modifications, page 19
- CIP Microcode Release cip21 Caveats and Modifications, page 44
- CIP-Related Caveats for Cisco IOS Releases, page 45
- CIP and Processor Module ROM Monitor Recommendations, page 45
- CIP and RP/RSP DRAM Requirements, page 47
- CIP Microcode Upgrade Overview, page 47
- Cisco Connection Online, page 48
- Cisco Documentation CD-ROM, page 49
For documentation of CIP features in the Cisco IOS 11.1 Release, refer to Table 1.
Table 1: Cisco IOS 11.1 Release Publications
| Cisco IOS 11.1 Release Publication
| Customer Order Number
|
|---|
| Configuration Fundamentals Configuration Guide
| DOC-CFCG11.1=
|
| Configuration Fundamentals Command Reference
| DOC-CFCR11.1=
|
| Bridging and IBM Networking Configuration Guide
| DOC-IBMNCG11.1=
|
| Bridging and IBM Networking Command Reference
| DOC-IBMNCR11.1=
|
| Cisco IOS Software Command Summary
| DOC-CIOSCS11.1=
|
| System Error Messages
| DOC-SYSEM11.1=
|
| Release Notes for Cisco IOS Release 11.1
| Document Number 78-2886-xx
|
For documentation of CIP features in the Cisco IOS 11.2 Release, refer to Table 2.
Table 2: Cisco IOS 11.2 Release Publications
| Cisco IOS 11.2 Release Publication
| Customer Order Number
|
|---|
| Configuration Fundamentals Configuration Guide
| DOC-CFCG11.2=
|
| Configuration Fundamentals Command Reference
| DOC-CFCR11.2=
|
| Bridging and IBM Networking Configuration Guide
| DOC-IBMNCG11.2=
|
| Bridging and IBM Networking Command Reference
| DOC-IBMNCR11.2=
|
| Cisco IOS Software Command Summary
| DOC-CIOSCS11.2=
|
| System Error Messages
| DOC-SYSEM11.2=
|
| Release Notes for Cisco IOS Release 11.2
| Document Number 78-3648-01-xx
|
For documentation of CIP features in the Cisco IOS Release 11.2 BC, refer to Table 3.
Table 3: Cisco IOS Release 11.2 BC Publications
| Cisco IOS Release 11.2 BC Publication
| Customer Order Number
|
|---|
| Release Notes for Cisco IOS Release 11.2
| 78-3648-xx
|
| Release Notes for Cisco IOS Release 11.2 BC
| 78-4694-xx
|
| Feature Guide for Cisco IOS Release 11.2 BC
| 78-4693-xx
|
For documentation of CIP features in the Cisco IOS Release 11.3, refer to Table 4.
Table 4: Cisco IOS Release 11.3 Publications
| Cisco IOS 11.3 Release Publication
| Customer Order Number
|
|---|
| Configuration Fundamentals Configuration Guide
| DOC-CFCG11.3=
|
| Configuration Fundamentals Command Reference
| DOC-CFCR11.3=
|
| Bridging and IBM Networking Configuration Guide
| DOC-IBMNCG11.3=
|
| Bridging and IBM Networking Command Reference
| DOC-IBMNCR11.3=
|
| Cisco IOS Software Command Summary
| DOC-CIOSCS11.3=
|
| System Error Messages
| DOC-SYSEM11.3=
|
| Release Notes for Cisco IOS Release 11.3
| Document Number 78-4998-xx
|
For chassis-specific hardware configuration or troubleshooting information, refer to the following publications:
- Cisco 7000 Hardware Installation and Maintenance (DOC-7000IM3)
- Cisco 7010 Hardware Installation and Maintenance (DOC-7010IM2)
- Cisco 7505 Hardware Installation and Maintenance (DOC-7505HIM1)
- Cisco 7507 Hardware Installation and Maintenance (DOC-7507HIM1)
- Cisco 7513 Hardware Installation and Maintenance (DOC-7513HIM1)
These hardware publications are available on Cisco Connection Online in the Core/High-End Routers database.
For the Cisco 7000 family routers (Cisco 7000 series routers and Cisco 7500 series), CIP microcode is available on floppy disks, Flash memory cards (which also include the Cisco IOS release compatible with the microcode version), and via Cisco Connection Online (CCO).
Starting with Cisco IOS Release 11.1, CIP microcode images are shipped separately from the Cisco IOS software. For new Cisco 7000 family routers shipped with Cisco IOS Release 11.1 and later, the CIP microcode is shipped pre-installed on the Flash memory card. For Cisco IOS Release 11.1, 11.2, and 11.2 BC software upgrades, the CIP microcode is shipped or available on the following media:
- Via electronic download from Cisco Connection Online using File Transfer Protocol (FTP) for all Cisco 7000 family routers
- On a separate set of floppy disks shipped with Cisco IOS Release software disks for all Cisco 7000 family routers
- On floppy disks shipped with Cisco IOS Release software ROMs (RP-based Cisco 7000 series routers only)
- Pre-installed on a Flash memory card with Cisco IOS Release software (available as an upgrade for RP-based Cisco 7000 series routers only)
Beginning with Cisco IOS Release 11.1(5), shipping in August 1996, two versions of the CIP card are supported. Production of the initial CIP card has been discontinued and it can no longer be ordered. The CIP2 card replaces the CIP.
There are no microcode issues associated with this change. The Route Switch Processor (RSP) card in the Cisco 7000 family router automatically determines which version of the microcode is appropriate for the installed CIP or CIP2.
Cisco IOS Release 11.1(5) and CIP microcode Version 22.6 as well as Cisco IOS Release 11.2(2) and CIP microcode Version 22.7 support both a CIP and a CIP2 card in the same router. Prior to this release, different versions of a CIP card in the same router are not supported.
Table 5 lists CIP microcode version and Cisco IOS software compatibility for the Cisco 7000 family. The CIP microcode image is shipped in a bundle separate from the Cisco IOS software images.
Note Starting with Cisco IOS Releases 10.3(9) and 11.0(5), the Cisco 7000 series routers and the Cisco 7500 series routers use the same CIP microcode image. The first version of common CIP microcode in Cisco IOS Release 10.3 is cip20-5, in Cisco IOS Release 11.0 it is cip21-3. Cisco IOS Release 11.1 and later all use the common CIP microcode rather than a separate microcode version for each chassis and processor type.
Table 5: Unbundled CIP Microcode Releases and Corresponding Cisco IOS Releases for the Cisco 7000 Family
| Default CIP
Microcode
Version
| Cisco IOS Release 11.1
| Cisco IOS Release 11.2
| Cisco IOS Release 11.2 BC
| Cisco IOS Release 11.3
|
|---|
| 21-3
| 11.1(1)
|
|
|
|
| 22-0
| 11.1(1)
|
|
|
|
| 22-3
| 11.1(3)
|
|
|
|
| 22-6
| 11.1(5)
|
|
|
|
| 22-7
| 11.1(6)
|
|
|
|
| 22-10
| 11.1(7)
| 11.2(1), 11.2(2)
|
|
|
| 22-12
| 11.1(8)
| 11.2(3), 11.2(4)
|
|
|
| 22-14
| 11.1(9)
|
|
|
|
| 22-15
| 11.1(10)
|
|
|
|
| 22-17
|
| 11.2(5)
|
|
|
| 22-18
| 11.1(11)
|
|
|
|
| 22.19
|
| 11.2(6)
|
|
|
| 22-20
| 11.1 (12
| 11.2(7)
|
|
|
| 22.21
| 11.1 (13)
| 11.2(8)
|
|
|
| 22-22
| 11.1(14)
| 11.2(9)
|
|
|
| 22-23
| 11.1(15)
|
|
|
|
| 22-25
| 11.1(16)
| 11.2(10)
|
|
|
| 22-26
| 11.1(17)
| 11.2(11)
|
|
|
| 24-0
|
|
| 11.2(8)BC
|
|
| 24-1
|
|
| 11.2(9)BC
|
|
| 24-2
|
|
| 11.2(10)BC
|
|
| 24-3
|
|
| 11.2(11)BC
|
|
| 25-3
|
|
|
| 11.3(1)
|
Note For Cisco IOS Release 11.2 BC, the CIP card is supported only on the Cisco 7000 with RSP7000 and the Cisco 7500 series routers.
CIP Microcode Version 25.3 is the initial release for support under Cisco IOS Release 11.3(1). Because CIP Microcode Version 25.3 was based on Version 25.2, modifications made in Version 25.2 are listed below.
This section describes possibly unexpected behavior by Version 25.2. All the caveats listed in this section are resolved in Version 25.3. See Table 5 for the Cisco IOS software release that corresponds to the 25.3 microcode version.
- If a CIP TN3270 PU is configured to connect from the host to the CIP via NCP, the link may fail.
- The workaround is to configure the CIP TN3270 PUs connecting at the host. [CSCdj07152]
- The output of the show extended channel slot port tn3270-server dlur command has been modified to show more information. The following additional information is displayed:
- Current network node server
- Status of the CP-CP session
- The following is an example of the output:
lorikeet#sh ext ch 2/2 tn dlur
dlur MPX.LORICP
preferred dlus MPX.NGMVMPC dlur-dlus status ACTIVE
current server MPX.NGMVMPC cp-cp status ACTIVE
backup dlus
preferred server
lsap token-adap 0 C0 vrn status ACTIVE
link TRP390 remote 4000.7470.00e7 08 status ACTIVE
- [CSCdj19544]
- The CIP TN3270 server should stop listening on the relevant IP port if it cannot accept any more TN3270 or TN3270E connections. This action ensures that the device driver makes correct decisions. [CSCdj24385]
- Following a channel error or host initial program load (IPL), the VTAM is unable to activate the XCA major node. The router log shows the following message at each attempted activation of the XCA major node:
Jul 4 00:10:28: %CIP25-6-MSG: %MSG802-6-LLC_DUP_SAP: LLC Duplicat SAP on interface 546 : SAP=4.
- Issuing the llc show all command on the CIP indicates that CSNA has failed to clear up one remaining session.
CIP-Slot5#llc show all
--- AdapNo 02, LanType Token , SAP 04 ---
pcep=0860 rmac=4000.0000.7190 lmac=C000.0115.6500 rsap=04 lsap=04 this=8120EDA8
pcep=0860 state=ADM rbusy=no lbusy=no flow=on pflag=1 dflag=0 v_r=0 v_s=0 last_nr=0 flag=60264282
- The workaround is to issue a microcode reload command to clear the hanging session. [CSCdj26081]
- A TN3270 Server, when operating with RFC1646-compliant printers, may send the wrong sense-code to the host when presented with a printer 'InterventionRequired' condition. The sensecode actually provided to VTAM is 0x1003000; correct operation might result in a sensecode of 0x08020000 or similar. [CSCdj36856]
- The TN3270 server may drop an unbind image from a job entry subsystem to a TN3270E client. The client (for example, a PC3270) may send a disconnect after receiving a bind image without receiving an unbind image. [CSCdj36868]
- The Offload write task does not terminate after deconfiguring the offload if the host has sent frames on the write subchannel IP link. The only known side effect is that this task will take up an entry in the task table and some memory. [CSCdj37835]
- If the VTAM is shut down while traffic is flowing, an external communication adapter (XCA) node may not start when the VTAM is restarted.
- The workaround is to issue the no csna command on the nonfunctioning subchannel, the no shutdown command on the physical interface, or the micro reload command. [CSCdj38712]
- When using a CIP TN3270 Server with the SNA session switch feature (DLUR), PUs that have a fully qualified name length of 17 characters cannot be activated. Activation fails with the SNA sensecode 0x10060000.
- The workaround is to use PU names that are less than eight characters. [CSCdj39358]
- When hosts send a null response unit with begin chain (BC), the server will not send a TN3270E header to the printer client. The client then sends a disconnect to terminate the session. A typical host application is a job entry subsystem. [CSCdj39359]
- The following changes have been made to address some TEST command issues:
- Answer TEST CMD other than DSAP of 0x0 if it is activated.
- The TEST CMD is dropped if the adapter has not activated the SAP or if the maximum number of connections has been reached.
- The TEST CMD is dropped while the SAP is in the deactivation processing mode.
- [CSCdj41342]
- The shutdown process never completes, and a microcode reload is required when a shutdown command is issued on the virtual interface. This condition occurs when a connection is configured between a CIP MultiPath Channel (CMPC ) Transmission group and an APPN node and the TRL and SNA local nodes are activated.
- The workaround is to inactivate the SNA local node before shutting down the virtual interface. [CSCdj43833]
- The SNA Local node must be recycled after cycling the virtual interface. This condition occurs when a pair of CMPC subchannels, a transmission group (TG), and an APPN node are configured on the router and a session is brought up by activating the host TRL and SNA local nodes. When a no shutdown command is issued, the SNA local node does not recover.
- The workaround is to either inactivate the local node first, or inactivate and then reactivate node when the problem occurs. [CSCdj46294]
- The actual amount of supported max-llc2-sessions is one less than what is configured. The workaround is to ensure adequate margin in the max-llc2-sessions specification. [CSCdj51067]
This section describes possibly unexpected behavior by Version 25.1. All the caveats listed in this section are resolved in Version 25.2.
- When usinging DDDLU (LUGROUP) in conjunction with DLUR (for example, a CIP TN3270 as SNA Session Switch), the hostas session awareness does not recover after a DLUS outage. This error occurs because DLUR provides the session awareness on the required space character for the ACTLU, but for DDDLU LUs there will be no ACTLU. This is an architectural error. [CSCdj15193]
- When the CIP TN3270 servers only active DLUR links are configured from the host end and not from the CIP end, no attempt is made to find a network node server. [CSCdj18737]
- CIP1 with 8 MB DRAM cannot be configured for 10 LLC sessions when using CSNA and cip22-19 microcode. The CIP will run if the max-llc2-sessions configured is 1. The CIP reloads continuously if the max-llc2-sessions is 10. [CSCdj19012]
- When the CIP TN3270 Server disconnects a TN3270 client session, it sends out telnet commands and an ascii message describing it's reason for the disconnect. The TCP session closes shortly after the message. Some clients will freeze or send an application error after this sequence of events.
- This malfunction could be caused by the following:
- TN3270 clients not following the RFC allow network virtual terminal (NVT) messages to be sent at disconnection time to inform the client of reason for disconnection.
- Client TCPIP stack reorders the data and FIN (finish) packets causing an error on the client.
- The workaround is to upgrade to a client TCPIP stack and application that conform to RFCs.
- This error disables the capabilities of the Telnet option, which stops TN3270 mode (IAC DONT BINARY IAC WONT BINARY) and the NVT messages at disconnect time in CIPTN3270 server. [CSCdj19545]
- If clients disconnect from a CIP TN3270 server in a short period of time, the server loses buffers and the PUs stay in the ACT/BUSY state. [CSCdj20423]
- The commands that begin with show extended channel slot port can fail to display all expected data because of a bug in the inter-process communications function used by Cisco IOS software to communicate with the CIP. [CSCdj21544]
- LU-LU sessions are not preserved and the links are disconnected when an SSCP takeover or giveback occurs. [CSCdj22128]
- A client can hang when a TN3270E client sends data before it sends a response. This error causes the data to be sent to the host before the response and causes the bracket state to be incorrect. This problem occurs using Personal COMMunication (PCOMM) 4.1 when the PA1 key on the TN3270 terminal is pressed while data is sent to the client. [CSCdj22926]
- A CIP TN3270 server PU stays in ACTIVE state after removing the internal adapter from the router configuration that the PU was using to connect to the host over the physical channel on the CIP. [CSCdj23224]
- When the CIP is not channel attached, the CIP crashes with the following SSI_ASSERT message:
%CIP0-3-MSG: %SSI802-3-FATAL_ERROR: SSI_ASSERT failure in ../ssi/ssi_buff.c @ 158 - (msg) && ((( msg)->m_flags & ( M_PK
%CIP0-3-MSG: THDR | M_EXT)) == ( M_PKTHDR | M_EXT))
- [CSCdj23424]
- In a CIP TN3270 server using TN3270E client, multiple chain messages do not use TN3270E responses when the first in chain has the Exception-response (EXR) flag set. The Definite-response (DR) actually comes on last in the chain, but by that time it is too late.
- The workaround is to handle multiple chain messages as if they are definite responses from the host while generating TN3270E header. This workaround will ensure that the definite-response from the host can be used to guarantee an end-to-end response. [CSCdj24073]
- The CIP TN3270 server should stop listening on the relevant IP port if it cannot accept any more TN3270 or TN3270E connections. This action ensures that the device driver makes correct decisions. [CSCdj24385]
- If a PU is remaining in the BUSY state, a new session may connect to the PU despite the availability of other PUs. The original connection will fail and there will be no warning message to indicate the connection failed.
- For the TN3270E client, there is no warning message if the host does not send a start data traffic (SDT) message. If a Telnet instead of a TN3270 client connects in the connection will fail, but an LU may be permanently assigned and not be reused again. If the host sends a DACTPU message, the statistics of the LU connections and disconnections may be wrong.
- Some hosts may send system services control points (SSCP) LU data before they send notify-response data. Also, a "no bind" warning message may be sent. [CSCdj24694]
- The SNA session switch (DLUR) support in the CIP TN3270 Server is limited to 16384 concurrent sessions per CIP. Attempts to activate more LUs are rejected with sense code 0812 0007. [CSCdj24704]
- The CIP crashes with a fatal error code 35 because the global queue of 4 KB buffers contains 0x00000100 instead of a valid address. The fatal error output contains the following line:
%DEBUGGER-0-STACK_DATA8: 0000 FFFFFFFF BE810000 00000000 00000100 ...
- If the second double word on this line contains 00000000 00000100 it is likely that the crash was caused by this bug. [CSCdj25062]
- During link inactivation, a message from downstream through a CIP TN3270 server could cause the CIP to reload spontaneously. [CSCdj25255]
- If the host sends SSCP LU data before a notify response and the client sends data before a notify response, the client is disconnected. This bug should happen only on a busy host with an application software sending data as soon as it receives data. [CSCdj27305]
- If the host sends consecutive exceptional response frames, the TN3270 server will send these frames before any responses come back from the RFC 1646 printer client. Some clients (for example, Attachmate Extra 4.3) may drop the data. [CSCdj28167]
- The LUs are allocated from a PU so that no more LUs leave from the PU. If the PU become inoperative (INOP), then typically 255 sessions are lost. However, if the LUs are PUs evenly allocated, then fewer users are affected upon PU INOP. [CSCdj28852]
- A CIP configured with CSNA and TN3270 server may crash with the following message:
SSI_ASSERT failure in ../cta802/ccb802.c @ 3044 - LOOPBACK_FLOW_RECEIVED
Fatal error (code=09)
- [CSCdj29175]
- When a DLUR link becomes inactive, the TN3270 server reports the link outage with the wrong transmission group number. If the transmission group number is zero, then there is no problem. If the transmission group number is not zero, then DLUS may attempt to route dependent LU sessions over the link and the session setup will fail. [CSCdj29401]
- When a DACTPU Giveback is sent to a TN3270 Server DLUR PU, no response is sent to the VTAM. After V INACT,ID=pu,TYPE=G, the PU is left in the state physical device address control point. [CSCdj29413]
- The CIP crashes with a fatal error code 35 because the global queue of 4 KB buffers contains 0x00010001 instead of a valid address. The fatal error output contains the following line:
%DEBUGGER-0-STACK_DATA8: 0000 FFFFFFFF 803F0010 00000000 00010001 ...
-
- If the second double word on this line contains 00000000 00010001 it is likely that the crash was caused by this bug. [CSCdj30387]
- Each time a client connects and selects a static LU, the client is delayed for 3 seconds before the host connection is made. [CSCdj30652]
- An extra end of job message (EOJ) may be sent to the printer after the last message, but before the client response. This may cause the printer drop the last messages.
- This bug is a regression caused by CSCdj28167. It occurs if the last message the host sends does not have end bracket (EB) bit on it. [CSCdj30937]
- A CIP may crash with the following message after many errors are received over an ESCON Channel Adapter (ECA):
Jul 30 00:53:29: %CIP3-3-MSG: %SSI802-3-FATAL_ERROR: SSI_ASSERT failure in ../cta/cta.c @ 345 - FALSE
Jul 30 00:53:29: %CIP3-0-MSG: %DEBUGGER-0-FATAL_ERROR: Fatal error (code=09)
- [CSCdj30949]
- Under rare circumstances (for example, during power outages or when a TN3270 client disconnects suddenly in middle of normal traffic) the CIP microcode may reload spontaneously with error 35.
- There is no guaranteed workaround other than to avoid random disconnection from the client in the middle of transactions. [CSCdj31131]
- When the offload code on the CIP gets a duplicate send request because of the IBM bug known as APAR PQ02051, it responds with an EINVAL error code to the second request. The mainframe reacts to this error by dropping the session.
- The workaround is to drop the duplicate request. [CSCdj31238]
- This fix corrects the CSNA problem of handling invalid channel blocks from host. [CSCdj31253]
- Performing a no shutdown command on a CIP virtual interface where the llc2-max-connections command is greater than 5000, can result in excessive memory consumption. This problem exists in versions up to cip22-21.
- For example, the interface works well if it is brought up with 6000 sessions. However, when the interface is issued a shutdown and no shutdown command, an additional 64K 160-byte buffers is added to one of the CTA buffer pools, consuming about 10 MB of memory. This excessive memory consumption causes various problems depending on the size of the CIP memory. The size of the buffer pool can be corrected by issuing a micro reload command. [CSCdj31884]
- The show controller cbus command could indicate that the channel utilization is 100 percent busy, despite no device-level traffic. This situation most likely occurs with a Parallel Channel Adapter (PCA), and less likely with an ECA. Without this fix, any start subchannel connected to one of the devices should cause the utilization to start reporting correctly. [CSCdj32046]
- This bug fixes and deprecates an unimplemented trap (cipCardLinkFailure) and implements a new trap (cipCardDtrBrdLinkFailure). Also, a new snmp-server enable traps channel-failures command was added to the parser. This command enables and disables the new trap (cipCardDtrBrdLinkFailure). [CSCdj32297]
CIP Microcode Version 24.0 is the initial release for support under Cisco IOS Release 11.2(8)BC. Because CIP Microcode Version 24.0 was based on Version 23.2, modifications made in Version 23.2 are listed below.
This section describes possibly unexpected behavior by Version 24.2. All the caveats listed in this section are resolved in Version 24.3. See Table 5 for the Cisco IOS software release that corresponds to the 24.3 microcode version.
- Despite "unbind-action keep" being configured, the TN3270-server disconnects a TN3270/E client if Sysreq is followed by any key. This disconnection is not a problem if sysreq is not used to close an LU-LU session.
- The workaround is to either not use sysreq or to reconnect the client if a SSCP-LU session is required. [CSCdj21850]
- Sending a ping greater than 4096 bytes in length to a CIP TN3270-server IP address will cause the CIP to hang and consume all available CIP memory. [CSCdj39225]
- Although an NMVT PSID was sent to VTAM during the connection state, a PSID was not sent to VTAM during disconnection. Sending both PSIDs allows network management to know the connection time of the clients. [CSCdj39365]
- The following changes have been made to address some TEST command issues:
- Answer TEST CMD other than DSAP of 0x0 if it is activated.
- The TEST CMD is dropped if the adapter has not activated the SAP or if the maximum number of connections has been reached.
- The TEST CMD is dropped while the SAP is in the deactivation processing mode.
- [CSCdj41342]
- When a TN3270E connects, a new LU is selected. This selection causes the LU to cycle once and likely cause a connection failure. [CSCdj43047]
- When using the offload feature, if an HSCH (Halt Subchannel) is issued from the mainframe when the offload read subchannel is busy with more-to-come chains, the CIP could fail in many ways. The problem could result in a fatal-error as a result of freeing and invalid addresses (for example, 0 or a non-four-byte aligned address) to the global page queue. The problem could also result in a fatal-error as a result of the EP (ESCON Processor) locking. It is unlikely that this problem will occur because the mainframe rarely performs an HSCH on busy connections. [CSCdj43959]
- When recycling a LOGAPPL application that is connected to a CIP TN3270 Server, one or more PUs can remain in flow-control state. This scenario can cause the PU to go into ACT/BUSY state and terminate all LU traffic going to users.
- The workaround is to recycle the PU. [CSCdj46065]
- With a TN3270 Server, if a CIP application shuts down its own TCP connection, it sends out a FIN (finish) segment. If it never receives a FIN from the peer, the local side of the connection will stay in FIN_WAIT_2 state forever, even after the application closes the socket completely. [CSCdj48609]
- A TN3270 client, which is mapped to a specific LU, fails upon reconnection. Although the first connection is successful, when the client disconnects and then tries to reconnect, the connection attempt will fail. [CSCdj48876]
- DLUR PUs can stick in PAPU2 state. Recycling (by issuing a shut command and then a no shut command ) the DLUR does not help. This condition arises if all of the DLUR PUs are made inactive at the Host, but the DLUR EN PU is active. The repeated attempts of DLUR to activate the PUs result in buffer loss in the CIP. Eventually a pool of buffers becomes empty and no ACTPU's are processed.
- The workaround is to recycle the TN3270. [CSCdj50517]
- The actual amount of supported max-llc2-sessions is one less than what is configured. The workaround is to ensure adequate margin in the max-llc2-sessions specification. [CSCdj51067]
- For CSNA devices, multiple LOGDATA records can occur as a result of the corruption of the count in the data request frame. Usually when multiple LOGDATA records occur, it is for some other reason (for example, a bad fiber connection). The way to verify that it is this caveat, is to put an ESCON analyzer on the ESCON connection and trigger the beginning of connection recovery (UD sequence).
- There is no workaround. [CSCdj51076]
- The host XCA node goes down or an attached PU or LU goes into the INOP state after installing a CIP image.
- The workaround is to revert to a previous CIP microcode version or install the next release, which does not contain this problem. [CSCdj51725]
- The SNA sense code 2003 is sent to the host causing the client to be disconnected. If the host has the direction and the client sends data, the data will be queued. Later the host sends data with EBI bit on, the client data will be sent. However, subsequent data from the host will get a negative response.
- The workaround is to reconnect the client. [CSCdj58664]
- The offload code can hit a fatal error after an OFFL-3-ILLEN or OFFL-3-ILLALH error message. There is no workaround for this problem, however, the error conditions leading to those error messages are rare.
- Another problem that was fixed was an OFFL-6-WRCHAIN error message when running TPF Offload. [CSCdj59133]
- There exists a small timing window that may cause the LLC2 connections to hang when the connection enters the ERROR state. This ddts will prevent the user from being able to change to XCA mode. [CSCdj59231]
- During high traffic and usage of varying frame sizes, the following error message may occur:
SSI_ASSERT crash in ssi_msg_offset function.
- The workaround is to reduce the PIU size. [CSCdj61634]
- While parsing messages, the offload code does minimal sanity checking on blocks with Offload Messages received from the mainframe. Therefore, corrupted blocks appear to contain a large number (up to 128 per 4 KB CLAW frame) of Offload Messages. Because there are not enough control blocks to handle this many messages, the CIP hits a fatal error. This caveat should not occur if Offload Messages are properly formatted.
- There is no workaround. [CSCdj64309]
This section describes possibly unexpected behavior by Version 24.1. All the caveats listed in this section are resolved in Version 24.2. See Table 5 for the Cisco IOS software release that corresponds to the 24.2 microcode version.
- The Offload write task does not terminate after deconfiguring the offload if the host has sent frames on the write subchannel IP link. The only known side effect is that this task will take up an entry in the task table and some memory. [CSCdj37835]
- The shutdown process never completes, and a microcode reload is required when a shutdown command is issued on the virtual interface. This condition occurs when a connection is configured between a CIP MultiPath Channel (CMPC ) Transmission group and an APPN node and the TRL and SNA local nodes are activated.
- The workaround is to inactivate the SNA local node before shutting down the virtual interface. [CSCdj43833]
- A TN3270 client, which is mapped to a specific LU, fails upon reconnection. Although the first connection is successful, when the client disconnects and then tries to reconnect, the connection attempt will fail. [CSCdj48876]
- The host XCA node goes down or an attached PU or LU goes into the INOP state after installing a CIP image.
- The workaround is to revert to a previous CIP microcode version or install the next release, which does not contain this problem. [CSCdj51725]
This section describes possibly unexpected behavior by Version 24.0. All the caveats listed in this section are resolved in Version 24.1. See Table 5 for the Cisco IOS software release that corresponds to the 24.1 microcode version.
- If a CIP TN3270 PU is configured to connect from the host to the CIP via NCP, the link may fail.
- The workaround is to configure the CIP TN3270 PUs as connecting at the host. [CSCdj07152]
- When the CIP TN3270 servers only active DLUR links are configured from the host end and not from the CIP end, no attempt is made to find a network node server. [CSCdj18737]
- CIP1 with 8 MB DRAM cannot be configured for 10 LLC sessions when using CSNA and cip22-19 microcode. The CIP will run if the max-llc2-sessions configured is 1. The CIP reloads continuously if the max-llc2-sessions is 10. [CSCdj19012]
- When the CIP TN3270 Server disconnects a TN3270 client session, it sends out telnet commands and an ascii message describing it's reason for the disconnect. The TCP session closes shortly after the message. Some clients will freeze or send an application error after this sequence of events.
- This malfunction could be caused by the following:
- TN3270 clients not following the RFC allow network virtual terminal (NVT) messages to be sent at disconnection time to inform the client of reason for disconnection.
- Client TCPIP stack reorders the data and FIN (finish) packets causing an error on the client.
- The workaround is to upgrade to a client TCPIP stack and application that conform to RFCs.
- This error disables the capabilities of the Telnet option, which stops TN3270 mode (IAC DONT BINARY IAC WONT BINARY) and the NVT messages at disconnect time in CIPTN3270 server. [CSCdj19545]
- If clients disconnect from a CIP TN3270 server in a short period of time, the server loses buffers and the PUs stay in the ACT/BUSY state. [CSCdj20423]
- The commands that begin with show extended channel slot port can fail to display all expected data because of a bug in the inter-process communications function used by Cisco IOS software to communicate with the CIP. [CSCdj21544]
- LU-LU sessions are not preserved and the links are disconnected when an SSCP takeover or giveback occurs. [CSCdj22128]
- A client can hang when a TN3270E client sends data before it sends a response. This error causes the data to be sent to the host before the response and causes the bracket state to be incorrect. This problem occurs using Personal COMMunication (PCOMM) 4.1 when the PA1 key on the TN3270 terminal is pressed while data is sent to the client. [CSCdj22926]
- A CIP TN3270 server PU stays in ACTIVE state after removing the internal adapter from the router configuration that the PU was using to connect to the host over the physical channel on the CIP. [CSCdj23224]
- When the CIP is not channel attached, the CIP crashes with the following SSI_ASSERT message:
%CIP0-3-MSG:%SSI802-3-FATAL_ERROR: SSI_ASSERT failure in../ssi/ssi_buff.c @ 158 - (msg) && ((( msg)->m_flags & ( M_PK
%CIP0-3-MSG: THDR | M_EXT)) == ( M_PKTHDR | M_EXT))
- [CSCdj23424]
- In a CIP TN3270 server using TN3270E client, multiple chain messages do not use TN3270E responses when the first in chain has the Exception-response (EXR) flag set. The Definite-response (DR) actually comes on last in the chain, but by that time it is too late.
- The workaround is to handle multiple chain messages as if they are definite responses from the host while generating TN3270E header. This workaround will ensure that the definite-response from the host can be used to guarantee an end-to-end response. [CSCdj24073]
- The CIP TN3270 server should stop listening on the relevant IP port if it cannot accept any more TN3270 or TN3270E connections. This action ensures that the device driver makes correct decisions. [CSCdj24385]
- If a PU is remaining in the BUSY state, a new session may connect to the PU despite the availability of other PUs. The original connection will fail and there will be no warning message to indicate the connection failed.
- For the TN3270E client, there is no warning message if the host does not send a start data traffic (SDT) message. If a Telnet instead of a TN3270 client connects in the connection will fail, but an LU may be permanently assigned and not be reused again. If the host sends a DACTPU message, the statistics of the LU connections and disconnections may be wrong.
- Some hosts may send system services control points (SSCP) LU data before they send notify-response data. Also, a "no bind" warning message may be sent. [CSCdj24694]
- The SNA session switch (DLUR) support in the CIP TN3270 Server is limited to 16384 concurrent sessions per CIP. Attempts to activate more LUs are rejected with sense code 0812 0007. [CSCdj24704]
- The CIP crashes with a fatal error code 35 because the global queue of 4 KB buffers contains 0x00000100 instead of a valid address. The fatal error output contains the following line:
%DEBUGGER-0-STACK_DATA8: 0000 FFFFFFFF BE810000 00000000 00000100 ...
- If the second double word on this line contains 00000000 00000100 it is likely that the crash was caused by this bug. [CSCdj25062]
- During link inactivation, a message from downstream through a CIP TN3270 server could cause the CIP to reload spontaneously. [CSCdj25255]
- Following a channel error or host initial program load (IPL), the VTAM is unable to activate the XCA major node. The router log shows the following message at each attempted activation of the XCA major node:
Jul 4 00:10:28: %CIP25-6-MSG: %MSG802-6-LLC_DUP_SAP: LLC Duplicat SAP on interface 546 : SAP=4.
- Issuing the llc show all command on the CIP indicates that CSNA has failed to clear up one remaining session.
CIP-Slot5#llc show all
--- AdapNo 02, LanType Token , SAP 04 ---
pcep=0860 rmac=4000.0000.7190 lmac=C000.0115.6500 rsap=04 lsap=04 this=8120EDA8
pcep=0860 state=ADM rbusy=no lbusy=no flow=on pflag=1 dflag=0 v_r=0 v_s=0 last_nr=0 flag=60264282
- The workaround is to issue a microcode reload command to clear the hanging session. [CSCdj26081]
- If the host sends SSCP LU data before a notify response and the client sends data before a notify response, the client is disconnected. This bug should happen only on a busy host with an application software sending data as soon as it receives data. [CSCdj27305]
- If the host sends consecutive exceptional response frames, the TN3270 server will send these frames before any responses come back from the RFC 1646 printer client. Some clients (for example, Attachmate Extra 4.3) may drop the data. [CSCdj28167]
- The LUs are allocated from a PU so that no more LUs leave from the PU. If the PU become inoperative (INOP), then typically 255 sessions are lost. However, if the LUs are PUs evenly allocated, then fewer users are affected upon PU INOP. [CSCdj28852]
- A CIP configured with CSNA and TN3270 server may crash with the following message:
SSI_ASSERT failure in ../cta802/ccb802.c @ 3044 - LOOPBACK_FLOW_RECEIVED
Fatal error (code=09)
- [CSCdj29175]
- When a DLUR link becomes inactive, the TN3270 server reports the link outage with the wrong transmission group number. If the transmission group number is zero, then there is no problem. If the transmission group number is not zero, then DLUS may attempt to route dependent LU sessions over the link and the session setup will fail. [CSCdj29401]
- When a DACTPU Giveback is sent to a TN3270 Server DLUR PU, no response is sent to the VTAM. After V INACT,ID=pu,TYPE=G, the PU is left in the state physical device address control point. [CSCdj29413]
- The CIP crashes with a fatal error code 35 because the global queue of 4 KB buffers contains 0x00010001 instead of a valid address. The fatal error output contains the following line:
%DEBUGGER-0-STACK_DATA8: 0000 FFFFFFFF 803F0010 00000000 00010001 ...
- If the second double word on this line contains 00000000 00010001 it is likely that the crash was caused by this bug. [CSCdj30387]
- Each time a client connects and selects a static LU, the client is delayed for 3 seconds before the host connection is made. [CSCdj30652]
- An extra end of job message (EOJ) may be sent to the printer after the last message, but before the client response. This may cause the printer drop the last messages.
- This bug is a regression caused by CSCdj28167. It occurs if the last message the host sends does not have end bracket (EB) bit on it. [CSCdj30937]
- A CIP may crash with the following message after many errors are received over an ESCON Channel Adapter (ECA):
Jul 30 00:53:29: %CIP3-3-MSG: %SSI802-3-FATAL_ERROR: SSI_ASSERT failure in ../cta/cta.c @ 345 - FALSE
Jul 30 00:53:29: %CIP3-0-MSG: %DEBUGGER-0-FATAL_ERROR: Fatal error (code=09)
- [CSCdj30949]
- Under rare circumstances (for example, during power outages or when a TN3270 client disconnects suddenly in middle of normal traffic) the CIP microcode may reload spontaneously with error 35.
- There is no guaranteed workaround other than to avoid random disconnection from the client in the middle of transactions. [CSCdj31131]
- This fix corrects the CSNA problem of handling invalid channel blocks from host. [CSCdj31253]
- Performing a no shutdown command on a CIP virtual interface where the llc2-max-connections command is greater than 5000, can result in excessive memory consumption. This problem exists in versions up to cip22-21.
- For example, the interface works well if it is brought up with 6000 sessions. However, when the interface is issued a shutdown and no shutdown command, an additional 64K 160-byte buffers is added to one of the CTA buffer pools, consuming about 10 MB of memory. This excessive memory consumption causes various problems depending on the size of the CIP memory. The size of the buffer pool can be corrected by issuing a micro reload command. [CSCdj31884]
- The show controller cbus command could indicate that the channel utilization is 100 percent busy, despite no device-level traffic. This situation most likely occurs with a Parallel Channel Adapter (PCA), and less likely with an ECA. Without this fix, any start subchannel connected to one of the devices should cause the utilization to start reporting correctly. [CSCdj32046]
- This bug fixes and deprecates an unimplemented trap (cipCardLinkFailure) and implements a new trap (cipCardDtrBrdLinkFailure). Also, a new snmp-server enable traps channel-failures command was added to the parser. This command enables and disables the new trap (cipCardDtrBrdLinkFailure). [CSCdj32297]
- A TN3270 Server, when operating with RFC1646-compliant printers, may send the wrong sense-code to the host when presented with a printer 'InterventionRequired' condition. The sensecode actually provided to VTAM is 0x1003000; correct operation might result in a sensecode of 0x08020000 or similar. [CSCdj36856]
- The TN3270 server may drop an unbind image from a job entry subsystem to a TN3270E client. The client (for example, a PC3270) may send a disconnect after receiving a bind image without receiving an unbind image. [CSCdj36868]
- If the VTAM is shut down while traffic is flowing, an external communication adapter (XCA) node may not start when the VTAM is restarted.
- The workaround is to issue the no csna command on the nonfunctioning subchannel, the no shutdown command on the physical interface, or the micro reload command. [CSCdj38712]
- When using a CIP TN3270 Server with the SNA session switch feature (DLUR), PUs that have a fully qualified name length of 17 characters cannot be activated. Activation fails with the SNA sensecode 0x10060000.
- The workaround is to use PU names that are less than eight characters. [CSCdj39358]
- When hosts send a null response unit with begin chain (BC), the server will not send a TN3270E header to the printer client. The client then sends a disconnect to terminate the session. A typical host application is a job entry subsystem. [CSCdj39359]
This section describes possibly unexpected behavior by Version 23.2. All the caveats listed in this section are resolved in Version 24.0. See Table 5 for the Cisco IOS software release that corresponds to the 24.0 microcode version.
- The Product Set ID (PSID) vector that is sent by CIP TN3270 Server in XIDs lacks a vendor ID. [CSCdi49621]
- Reply PSID responses coming from the host do not show in the output of the show extended channel <slot/port> tn3270-server pu foo lu<luLocaddr>history command.
- A workaround is to examine the event log (located above the SNA traces). The event log shows whether the reply PSID response was received from the host. [CSCdi89304]
- The CIP1 in the RSP crashes with an error 35 after loading the router. [CSCdj09542]
- This fix addresses CIP LLC2 timer problem. [CSCdj11140]
- Issuing a shut or no shut command when using the Cisco IOS for S/390 TCP/IP stack and the Parallel Channel Adapter (PCA) can cause incorrect data transfer lengths and data corruption. [CSCdj13880]
- If an inactive CIP TN3270 link is deleted with the no link command and is then added again, the CIP microcode may spontaneously reload. [CSCdj14956]
- If the mainframe issues two close requests for the same socket, the second close request will cause an OFFL-4-BADDESC message to be displayed followed by a printout of the context necessary to troubleshoot the problem. This is a cosmetic bug caused by an unusual timing condition. This bug will not affect normal operations and does not indicate any session failures. [CSCdj15521]
- The CIP may occasionally reload spontaneously with a traceback and the following error message:
%DEBUGGER-0-FATAL_ERROR: Fatal error (code=32)
- This failure has only been observed at sites running the CIP across an SRB network to a host (instead of the normal channel attachment). [CSCdj17365]
- Configuration of CIP-CSNA appears to intermittently cause blocked virtual routes across VTAM-to-VTAM connections. [CSCdj17412]
- If the mainframe offload code sends a socket request with a bad length field, the CIP may print an error message indicating that the length is bad. During the processing of this error message, the code can cause an alignment exception. The result is a fatal error with code 35. [CSCdj17843]
- CIP1 with 8 MB DRAM cannot be configured for 10 LLC sessions when using CSNA and cip22-19 microcode. The CIP will run if the max-llc2-sessions configured is 1. The CIP reloads continuously if the max-llc2-sessions is 10. [CSCdj19012]
- If a CIP TN3270 DLUR link is deleted with the no link command and is then added again, the link sticks in WAIT state. [CSCdj19069]
- When the CIP TN3270 Server disconnects a TN3270 client session, it sends out telnet commands and an ascii message describing it's reason for the disconnect. The TCP session closes shortly after the message. Some clients will freeze or send an application error after these sequence of events.
- This malfunction could be caused by the following:
- TN3270 clients not following the RFC allow network virtual terminal (NVT) messages to be sent at disconnection time to inform the client of reason for disconnection.
- Client TCPIP stack reorders the data and FIN (finish) packets causing an error on the client.
- The workaround is to upgrade to a client TCPIP stack and application that conform to RFCs.
- This error disables the capabilities of the Telnet option, which stops TN3270 mode (IAC DONT BINARY IAC WONT BINARY) and the NVT messages at disconnect time in CIPTN3270 server.
- If a CIP TN3270 DLUR (SNA session switch) link fails or is taken down remotely,DLUR incorrectly reports that the link state is up. This can lead to session start attempts failing with sense 80140003.
- The workaround is to take down the DLUR-DLUS session. [CSCdj19817]
- A TN3270 server on a CIP with a PU goes into ACT/BSY state, which prevents new users from connecting and stops existing users sessions.
- This problem only affects customers using TN3270E.
- The buffers are lost only if BIND is followed immediately by unbind without SDT. This is small window of time, but some host applications might amplify it and should be avoided.
- To keep the PU from locking if the TN3270E and special host application are being used periodically reload the CIP microcode. Although PU re-activation is also a way to recover, it does not guarantee recovery. [CSCdj20210]
- The CIP can spontaneously reload during operation if the host applications attempt to rebind immediately after a client disconnects. This problem did not exist in versions prior to cip22-20.
- A possible workaround is to ensure that the client always goes back to SSCP-LU after being in session, which means not using LOGAPPL or session-queuing. [CSCdj20596]
- The CIP TN3270 Server records the rejection of received binds and the rejection of sent binds as the following message: "Rejecting rcvd Bind". [CSCdj20719]
- The following error messages may appear when issuing the DACTPU command on the host or removing a PU:
May 27 18:26:37: %CIP1-1-MSG: %TN3270S-1-LU_ERROR: lu error lu not in hash
table: :36 pu:80A78998, tnet:0 May 27 18:26:37: %CIP1-1-MSG:
%TN3270S-1-LU_ERROR_INFO: LU info: Event 0 0 0 0 0 0 0 0 0 0 0 0 0 3 6 14 ,
state = A, snaState = 0, flag = May 27 18:26:37: %CIP1-1-MSG: 1
- This error message is caused by fixing CSCdj15559. These error messages should not hurt network operations. [CSCdj21011]
- During the recovery of certain ESCON link errors, the CIP can crash with a FATAL-ERROR after the ESCON adapter reports a device-level error when there is no active device. When this problem occurs, the FATAL-ERROR is preceded by the following error message:
CCA-0-DEV_ERR2: Device error but no active defined device
- The workaround is to determine and resolve the reason for the ESCON link error. [CSCdj21031]
The following sections describe the caveats to current CIP microcode versions and the modifications made in current CIP microcode versions for cip22 microcode. The caveats listed apply to only the most serious problems. See Table 5 for the Cisco IOS software releases supported by cip22 microcode.
This section describes possibly unexpected behavior by Version 22.25. All the caveats listed in this section are resolved in Version 22.26. See Table 5 for the Cisco IOS release software version that corresponds to the 22.26 microcode version.
- Despite "unbind-action keep" being configured, the TN3270-server disconnects a TN3270/E client if sysreq is followed by any key. This disconnection is not a problem if sysreq is not used to close an LU-LU session.
- The workaround is to not use sysreq or to reconnect the client if a SSCP-LU session is required. [CSCdj21850]
- For Offload and CLAW devices, if the write device (odd device number) on the mainframe is misconfigured to talk to the read subchannel (even device number), the CIP could crash with an SCBNRDY error message.
- The workaround is to properly configure the devices on the mainframe. The most likely cause of the problem is under the virtual machine (VM) if the write device is attached to the read subchannel. In this scenario, detach both devices (read and write) and reattach them to the correct subchannel. [CSCdj23802]
- Sending a ping larger than 4096 bytes to a CIP TN3270-server IP address will cause the CIP to hang and consume all available CIP memory. [CSCdj39225]
- Although an NMVT PSID was sent to VTAM during the connection state, a PSID was not sent to VTAM during disconnection. Sending both PSIDs allows network management to know the connection time of the clients. [CSCdj39365]
- The following changes have been made to address some TEST command issues:
- Answer TEST CMD other than DSAP of 0x0 if it is activated.
- TEST CMD is dropped if the adapter has not activated the SAP or if the maximum number of connections has been reached.
- TEST CMD is dropped while the SAP is in the deactivation processing mode.
- [CSCdj41342]
- When a TN3270E connects, a new LU is selected. This selection causes the LU to cycle once and may cause a connection failure. [CSCdj43047]
- When recycling a LOGAPPL application that is connected to a CIP TN3270 Server, one or more PUs can remain in flow-control state. This scenario can cause the PU to go into ACT/BUSY state and terminate all LU traffic going to users.
- The workaround is to recycle the PU. [CSCdj46065]
- With a TN3270 Server, if a CIP application shuts down its own TCP connection, it sends out a FIN (finish) segment. If it never receives a FIN from the peer, the local side of the connection will stay in FIN_WAIT_2 state forever, even after the application closes the socket completely. [CSCdj48609]
- Memory is leaked by the CIP TCP/IP if a direct memory access (DMA) controller write operation detects an error. [CSCdj48929]
- DLUR PUs can stick in the PAPU2 state. Recycling (by issuing a shut command and then a no shut command ) the DLUR does not help. The condition arises if all of the DLUR PUs are made inactive at the host but the DLUR EN PU is active. The repeated attempts of DLUR to activate the PUs results in buffer loss in the CIP. Eventually a pool of buffers becomes empty and no ACTPU's are processed.
- The workaround is to recycle the TN3270. [CSCdj50517]
- The actual number of supported max-llc2-sessions is one less than the number configured. The workaround is to ensure adequate margin in the max-llc2-sessions specification. [CSCdj51067]
- For CSNA device types, mulitple LOGDATA records can occur as a result of the corruption of the count in the data request frame. Usually when multiple LOGDATA records occur, it is for some other reason (for example, a bad fiber connection). The way to verify if the problem is this DDTS, is to put an ESCON analyzer on the ESCON connection and trigger the beginning of connection recovery (UD sequence).
- There is no workaround. [CSCdj51076]
- When a TN3270 client is powered down without terminating the TCP/IP session with the CIP, the TIMING-MARK and TCP retransmissions tear down the connection. If a client is unable to work with TIMING-MARK and uses a previously specified LU name then it will be unable to reconnect. [CSCdj51696]
- If several of the TN3270 Server PUs are configured under DLUR and are INACT or unknown at the Host, then the process of stabilizing the DLUR-DLUS pipe can be prolonged and thereby preventing PUs from activating.
- This situation occurs with certain patterns of "good" and "bad" PUs. For example, out of a total of six PUs, the first five could be INACT at the host and the sixth could be CONCT.
- The workaround is to shut down the PUs on the CIP or make them active at the Host. [CSCdj54138]
- When the customer attempts to IPL an Hatachi mainframe running IBM VSE 1.4.1 with Connectivity Systems TCPIP stack for VSE, the system goes into a loop and the CIP appears to be in an offline state. After several attempts to trace the problem on the CIP, the following trace indicates the CIP failed to respond:
Channel (F7) Cisco/CIP Explanation
ALA ==================> (CH sends Aquire Link Address)
<================= ALA (CU sends Aquire Link Address)
ACK =================> (CH acknowledges request from CU)
End of Communication (CU never acknowledges request from CH)
-
- [CSCdj55448]
- During peak times of logon-rate and network congestion, end users cannot access the CIP TN3270 Server for extended periods of time (5-15 minutes). Existing TN3270 sessions exhibit normal response times during these periods, but new connections are locked out. [CSCdj56273]
- The SNA sense code 2003 is sent to the host that is causing the client to disconnect. If the host has the direction and the client sends data, the data will be queued. Later, when the host sends data with EBI bit on, the client data will be sent. However, subsequent data from the host will get a negative response.
- The workaround is to reconnect the client. [CSCdj58664]
- There exists a small timing window that may cause the LLC2 connections to hang when the connection enters the ERROR state. This ddts will prevent the user from being able to change to XCA mode. [CSCdj59231]
- A TN3270E disconnects after the host sends and unbind message. When the user presses the F3 key to end the LU-LU session, the session is disconnected instead.
- The workaround is to reconnect the client. [CSCdj59985]
This section describes possibly unexpected behavior by Version 22.24. All the caveats listed in this section are resolved in Version 22.25. See Table 5 for the Cisco IOS release software version that corresponds to the 22.25 microcode version.
- The host XCA node goes down or an attached PU or LU goes into the INOP state after installing a CIP image.
- The workaround is to revert to a previous CIP microcode version or install the next release, which does not contain this problem. [CSCdj51725]
This section describes possibly unexpected behavior by Version 22.23. All the caveats listed in this section are resolved in Version 22.24. See Table 5 for the Cisco IOS release software version that corresponds to the 22.24 microcode version.
- The Offload write task does not terminate after deconfiguring the offload if the host has sent frames on the write subchannel IP link. The only known side effect is that this task will take up an entry in the task table and some memory. [CSCdj37835]
- When using the offload feature, if an HSCH (Halt Subchannel) is issued from the mainframe when the offload read subchannel is busy with more-to-come chains, the CIP could fail in many ways. The problem could result in a fatal-error as a result of freeing and invalid addresses (for example, 0 or a non-four-byte aligned address) to the global page queue. The problem could also result in a fatal-error as a result of the EP (ESCON Processor) locking. It is unlikely that this problem will occur because the mainframe rarely performs an HSCH on busy connections. [CSCdj43959]
- A TN3270 client, which is mapped to a specific LU, fails upon reconnection. Although the first connection is successful, when the client disconnects and then tries to reconnect, the connection attempt will fail. [CSCdj48876]
This section describes possibly unexpected behavior by Version 22.22. All the caveats listed in this section are resolved in Version 22.23. See Table 5 for the Cisco IOS release software version that corresponds to the 22.23 microcode version.
- If a CIP TN3270 PU is configured to connect from the host to the CIP via NCP, the link may fail.
- The workaround is to configure the CIP TN3270 PUs as connecting at the host. [CSCdj07152]
- When using DDDLU (LUGROUP) in conjunction with DLUR (for example, a CIP TN3270's SNA Session Switch), the Host's session awareness does not recover after a DLUS outage. This error occurs because DLUR provides the session awareness on the required space character for the ACTLU, but for DDDLU LUs there will be no ACTLU. This error appears to be a shortcoming in the architecture. [CSCdj15193]
- If a PU is remaining in the BUSY state, a new session may connect to the PU despite the availability of other PUs. The original connection will fail and there will be no warning message to indicate the connection failed.
- For the TN3270E client, there is no warning message if the host does not send a start data traffic (SDT) message. If a Telnet instead of a TN3270 client connects in the connection will fail, but an LU may be permanently assigned and not be reused again. If the host sends a DACTPU message, the statistics of the LU connections and disconnections may be wrong.
- Some hosts may send system services control points (SSCP) LU data before they send notify-response data. Also, a "no bind" warning message may be sent. [CSCdj24694]
- Following a channel error or host initial program load (IPL), the VTAM is unable to activate the XCA major node. The router log shows the following message at each attempted activation of the XCA major node:
Jul 4 00:10:28: %CIP25-6-MSG: %MSG802-6-LLC_DUP_SAP: LLC Duplicat SAP on interface 546 : SAP=4.
- Issuing the llc show all command on the CIP indicates that CSNA has failed to clear up one remaining session.
CIP-Slot5#llc show all
--- AdapNo 02, LanType Token , SAP 04 ---
pcep=0860 rmac=4000.0000.7190 lmac=C000.0115.6500 rsap=04 lsap=04 this=8120EDA8
pcep=0860 state=ADM rbusy=no lbusy=no flow=on pflag=1 dflag=0 v_r=0 v_s=0 last_nr=0 flag=60264282
-
- The workaround is to issue a microcode reload command to clear the hanging session. [CSCdj26081]
- The LUs are allocated from a PU so that no more LUs leave from the PU. If the PU become inoperative (INOP), then typically 255 sessions are lost. However, if the LUs are PUs evenly allocated, then fewer users are affected upon PU INOP. [CSCdj28852]
- A CIP configured with CSNA and TN3270 server may crash with the following message:
SSI_ASSERT failure in ../cta802/ccb802.c @ 3044 - LOOPBACK_FLOW_RECEIVED
Fatal error (code=09)
- [CSCdj29175]
- When a DACTPU Giveback is sent to a TN3270 Server DLUR PU, no response is sent to the VTAM. After V INACT,ID=pu,TYPE=G, the PU is left in the state physical device address control point. [CSCdj29413]
- The CIP crashes with a fatal error code 35 because the global queue of 4 KB buffers contains 0x00010001 instead of a valid address. The fatal error output contains the following line:
"%DEBUGGER-0-STACK_DATA8: 0000 FFFFFFFF 803F0010 00000000 00010001 ..."
- If the second double word on this line contains 00000000 00010001 it is likely that the crash was caused by this bug. [CSCdj30387]
- Each time a client connects and selects a static LU, the client is delayed for 3 seconds before the host connection is made. [CSCdj30652]
- An extra end of job message (EOJ) may be sent to the printer after the last message, but before the client response. This may cause the printer drop the last messages.
- This bug is a regression caused by CSCdj28167. It occurs if the last message the host sends does not have end bracket (EB) bit on it. [CSCdj30937]
- A CIP may crash with the following message after many errors are received over an ESCON Channel Adapter (ECA):
Jul 30 00:53:29: %CIP3-3-MSG: %SSI802-3-FATAL_ERROR: SSI_ASSERT failure in ../cta/cta.c @ 345 - FALSE
Jul 30 00:53:29: %CIP3-0-MSG: %DEBUGGER-0-FATAL_ERROR: Fatal error (code=09)
- [CSCdj30949]
- Under rare circumstances (for example, during power outages or when a TN3270 client disconnects suddenly in middle of normal traffic) the CIP microcode may reload spontaneously with error 35.
- There is no guaranteed workaround other than to avoid random disconnection from the client in the middle of transactions. [CSCdj31131]
- Performing a no shutdown command on a CIP virtual interface where the llc2-max-connections command is greater than 5000, can result in excessive memory consumption. This problem exists in versions up to cip22-21.
- For example, the interface works well if it is brought up with 6000 sessions. However, when the interface is issued a shutdown and no shutdown command, an additional 64K 160-byte buffers is added to one of the CTA buffer pools, consuming about 10 MB of memory. This excessive memory consumption causes various problems depending on the size of the CIP memory. The size of the buffer pool can be corrected by issuing a micro reload command. [CSCdj31884]
- The show controller cbus command could indicate that the channel utilization is 100 percent busy, despite no device-level traffic. This situation most likely occurs with a Parallel Channel Adapter (PCA), and less likely with an ECA. Without this fix, any start subchannel connected to one of the devices should cause the utilization to start reporting correctly. [CSCdj32046]
- This bug fixes and deprecates an unimplemented trap (cipCardLinkFailure) and implements a new trap (cipCardDtrBrdLinkFailure). Also, a new snmp-server enable traps channel-failures command was added to the parser. This command enables and disables the new trap (cipCardDtrBrdLinkFailure). [CSCdj32297]
- A TN3270 Server, when operating with RFC1646-compliant printers, may send the wrong sense-code to the host when presented with a printer 'InterventionRequired' condition. The sensecode actually provided to VTAM is 0x1003000; correct operation might result in a sensecode of 0x08020000 or similar. [CSCdj36856]
- The TN3270 server may drop an unbind image from a job entry subsystem to a TN3270E client. The client (for example, a PC3270) may send a disconnect after receiving a bind image without receiving an unbind image. [CSCdj36868]
- If the VTAM is shut down while traffic is flowing, an external communication adapter (XCA) node may not start when the VTAM is restarted.
- The workaround is to issue the no csna command on the nonfunctioning subchannel, the no shutdown command on the physical interface, or the micro reload command. [CSCdj38712]
- When using a CIP TN3270 Server with the SNA session switch feature (DLUR), PUs that have a fully qualified name length of 17 characters cannot be activated. Activation fails with the SNA sensecode 0x10060000.
- The workaround is to use PU names that are less than eight characters. [CSCdj39358]
- When hosts send a null response unit with begin chain (BC), the server will not send a TN3270E header to the printer client. The client then sends a disconnect to terminate the session. A typical host application is a job entry subsystem. [CSCdj39359]
This section describes possibly unexpected behavior by Version 22.21. All the caveats listed in this section are resolved in Version 22.22. See Table 5 for the Cisco IOS release software version that corresponds to the 22.22 microcode version.
- When the CIP TN3270 servers only active DLUR links are configured from the host end and not from the CIP end, no attempt is made to find a network node server. [CSCdj18737]
- The CIP1 with 8 MB DRAM reloads continuously when configured for 10 LLC sessions when using CSNA and cip22-19 microcode. With max-llc2-sessions 1 configured, however, the CIP runs without any problems. [CSCdj19012]
- If clients disconnect from a CIP TN3270 server in a short period of time, the server loses buffers and the PUs stay in the ACT/BUSY state. [CSCdj20423]
- A CIP TN3270 Server logs both the rejection of received binds and the rejection of sent binds as "Rejecting rcvd Bind." [CSCdj20719]
- The commands that begin with show extended channel slot | port can fail to display all expected data because of a bug in the inter-process communications function used by Cisco IOS software to communicate with the CIP. [CSCdj21544]
- LU-LU sessions are not preserved and the links are disconnected when an SSCP takeover or giveback occurs. [CSCdj22128]
- A client can hang when a TN3270E client sends data before it sends a response. This error causes the data to be sent to the host before the response and causes the bracket state to be incorrect. This problem occurs using Personal COMMunication (PCOMM) 4.1 when the PA1 key on the TN3270 terminal is pressed while data is sent to the client. [CSCdj22926]
- A CIP TN3270 server PU stays in ACTIVE state after removing the internal adapter from the router configuration that the PU was using to connect to the host over the physical channel on the CIP. [CSCdj23224]
- When the CIP is not channel attached, the CIP crashes with the following SSI_ASSERT message:
%CIP0-3-MSG: %SSI802-3-FATAL_ERROR: SSI_ASSERT failure in ../ssi/ssi_buff.c @ 158 - (msg) && ((( msg)->m_flags & ( M_PK
%CIP0-3-MSG: THDR | M_EXT)) == ( M_PKTHDR | M_EXT))
- [CSCdj23424]
- In a CIP TN3270 server using TN3270E client, multiple chain messages do not use TN3270E responses when the first in chain has the Exception-response (EXR) flag set. The Definite-response (DR) actually comes on last in the Chain, but by that time it is too late.
- The workaround is to handle multiple chain messages as if they are definite responses from the host while generating TN3270E header. This workaround will ensure that the definite-response from the host can be used to guarantee an end-to-end response. [CSCdj24073]
- The CIP TN3270 server should stop listening on the relevant IP port if it cannot accept any more TN3270 or TN3270E connections. This action ensures that device driver makes correct decisions. [CSCdj24385]
- The SNA session switch (DLUR) support in the CIP TN3270 Server is limited to 16384 concurrent sessions per CIP. Attempts to activate more LUs are rejected with sense code 0812 0007. [CSCdj24704]
- A CIP running TCP/IP offload can (under very rare circumstances) hit a fatal error. The fatal error messages will be preceded by:
- %CIP21-0-MSG: %CCA-0-BSQ_FULL: Buffer status queue is full
- [CSCdj25040]
- The CIP crashes with a fatal error code 35 because the global queue of 4 KB buffers contains 0x00000100 instead of a valid address. The fatal error output contains the following line:
%DEBUGGER-0-STACK_DATA8: 0000 FFFFFFFF BE810000 00000000 00000100 ...
- If the second double word on this line contains 00000000 00000100 it is likely that the crash was caused by this bug. [CSCdj25062]
- During link inactivation, a message from downstream through a CIP TN3270 server could cause the CIP to reload spontaneously. [CSCdj25255]
- If the host sends SSCP-LU data before a notify response and the client sends data before a notify response, the client is disconnected. This bug should happen only on a busy host with an application software sending data as soon as it receives data. [CSCdj27305]
- If the host sends consecutive exceptional response frames, the TN3270 server will send these frames before any responses comes back from the RFC 1646 printer client. Some clients (for example, Attachmate Extra 4.3) may drop the data. [CSCdj28167]
- When a DLUR link goes inactive, the TN3270 server reports the link outage with the wrong transmission group number. If the transmission group number is zero, then there is no problem. If the transmission group number is not zero, then DLUS may attempt to route dependent LU sessions over the link and the session setup will fail. [CSCdj29401]
- When the offload code on the CIP gets a duplicate send request because of the IBM bug known as APAR PQ02051, it responds with an EINVAL error code to the second request. The mainframe reacts to this error by dropping the session.
- The workaround is to drop the duplicate request. [CSCdj31238]
- This fix corrects the CSNA problem of handling invalid channel blocks from host. [CSCdj31253]
This section describes possibly unexpected behavior by Version 22.20. All the caveats listed in this section are resolved in Version 22.21. See Table 5 for the Cisco IOS release software version that corresponds to the 22.21 microcode version.
- If all CIP interfaces are shut down when the CIP is initialized (for example, during a microcode reload or router load) on a Cisco 70xx RP router, the following error message will be displayed:
%CIPn-2-MSG: %IPC-2-NOMEMD: Unable to obtain CBUS IPC transmit buffers(BUS)
- This error message does not cause any problems to the network. [CSCdj00153]
- The CIP1 in the RSP immediately crashes with an error 35 after loading the router. [CSCdj09542]
- This fix addresses the CIP failure which was caused by the CIP LLC2 timer services malfunctioning. [CSCdj11140]
- Issuing a shut or no shut command when using the Cisco IOS/390 TCPIP stack and the Parallel Channel Adapter (PCA) can cause incorrect data transfer lengths and data corruption. [CSCdj13880]
- If an inactive CIP TN3270 link is deleted with the no link command and is then added again, the CIP microcode may spontaneously reload. [CSCdj14956]
- If the mainframe issues two close requests for the same socket, the second close request will cause an OFFL-4-BADDESC message to be displayed followed by a printout of the context necessary to troubleshoot the problem. This is a cosmetic bug caused by an unusual timing condition. This bug will not affect normal operations and does not indicate any session failures. [CSCdj15521]
- The CIP may occasionally reload spontaneously with a traceback and the following error message:
%DEBUGGER-0-FATAL_ERROR: Fatal error (code=32)
- This failure has only been observed at sites running the CIP across an SRB network to a host (instead of the normal channel attachment). [CSCdj17365]
- Configuration of CIP-CSNA appears to intermittently cause blocked virtual routes across VTAM-to-VTAM connections. [CSCdj17412]
- If the mainframe offload code sends a socket request with a bad length field, the CIP may print an error message indicating that the length is bad. During the processing of this error message, the code could cause an alignment exception. The result is a fatal error with code 35. [CSCdj17843]
- If a CIP TN3270 DLUR link is deleted with the no link command and is then added again, the link becomes stuck in WAIT state. [CSCdj19069]
- When the CIP TN3270 Server disconnects a TN3270 client session, it sends out telnet commands and an ascii message describing it's reason for the disconnect. The TCP session closes shortly after the message. Some clients don't like the telnet command/data; others don't like tcp close coming on heels of data. They may show unusual behavior like application error/freeze in that case. These clients do not have the problem with those servers which don't send telnet commands and the ascii message before the TCP closes. This message may cause the TN3270 client to freeze. If the TN3270 client does freeze, reboot the operating system. This situation has not, however, been reported with other TN3270 servers.
- This malfunction could be caused by the following:
- TN3270 clients not following the RFC which allow network virtual terminal (NVT) messages to be sent at disconnection time to inform the client of reason for disconnection.
- the client TCPIP stack reorder the data and FIN (finish) packets causing an error on client
- The workaround is to upgrade to a client TCPIP stack and application that conform to RFCs.
- This error disables the capabilities of the Telnet option, which stops TN3270 mode (IAC DONT BINARY IAC WONT BINARY) and the NVT messages at disconnect time in CIPTN3270 server. [CSCdj19545]
- If a CIP TN3270 DLUR (SNA session switch) link fails or is taken down remotely, then DLUR incorrectly reports that the link state is up. This can lead to session start attempts failing with sense 80140003.
- The workaround is to take down the DLUR-DLUS session. [CSCdj19817]
- In TN3270 server on CIP, the PU sometimes stays in ACT/BSY state. In this state, no new users are allowed to connect and existing user sessions stop.
- This problem only occurs if customers are using TN3270E. Therefore, it does not affect customers who are only using TN3270 clients.
- The buffers are lost only if BIND is followed immediately by UNBIND without start data traffic. This circumstance should be avoided because some host application might amplify it.
- To avoid locking up the PU, periodically reload the microcode on the CIP if a TN3270E and special host application are being used. PU reactivation is also a way to recover although it does not guarantee recovery. [CSCdj20210]
- The CIP can spontaneously reload during operation if the host applications attempt to rebind immediately after a client disconnects. This problem did not exist in versions prior to cip22-20.
- A possible workaround is to ensure that the client always goes back to SSCP-LU after being in session, which means not using LOGAPPL or session-queuing. [CSCdj20596]
- The following error messages may appear when DACTPU or removing a PU:
May 27 18:26:37: %CIP1-1-MSG: %TN3270S-1-LU_ERROR: lu error lu not in hash
table: :36 pu:80A78998, tnet:0 May 27 18:26:37: %CIP1-1-MSG:
%TN3270S-1-LU_ERROR_INFO: LU info: Event 0 0 0 0 0 0 0 0 0 0 0 0 0 3 6 14 ,
state = A, snaState = 0, flag = May 27 18:26:37: %CIP1-1-MSG: 1
- This error message is caused by fixing CSCdj15559. These error messages should not hurt network operations. [CSCdj21011]
- During the recovery of certain ESCON link errors, the CIP could crash with a FATAL-ERROR after the ESCON adapter reports a device-level error when there is no active device. When this problem occurs, the FATAL-ERROR is preceded by the following error message:
CCA-0-DEV_ERR2: Device error but no active defined device
- The workaround is to determine and resolve the reason for the ESCON link error. [CSCdj21031]
This section describes possibly unexpected behavior by Version 22.19. All the caveats listed in this section are resolved in Version 22.20. See Table 5 for the Cisco IOS release software version that corresponds to the 22.20 microcode version.
- The tracerte utility on VM or MVS hosts does not work with the CIP Offload code. [CSCdi52947]
- TCP/IP sometimes sends a purge socket request with a bad socket descriptor. The socket descriptor is a 16-bit value placed in a 32-bit field. A corrupted request has some of the upper 16 bits set. Usually these values correspond to the 32-bit host socket descriptor for that socket.
- With this fix, the CIP now specifically checks for a host descriptor and searches through the control blocks for a match. Because using the host descriptor is considered incorrect behavior, the following error message is displayed:
OFFL-4-WRONGDESC
- [CSCdi64196]
- If the host is not configured for Dynamic Definition of Dependent LUs (DDDLU), the client connection is rejected without warning. [CSCdi73120]
- The following are issues related to the output from a show extended channel slot/port csna [stat] command:
- The byte count sent to the host is not accumulated correctly. A symptom is that the number of blocks exceeds the number of bytes.
- The output direction is host-centric (transmitted means bytes from host) instead of Cisco's convention of router-centric (transmitted means bytes to host). This issue has been corrected.
- The block count sent to the host, which includes all blocks, exceeds the sum of the values for the CSNA device such as Txd by maxpiu, Txd by time-delay and Txd by length-delay Blocks/Bytes counts because the LSA channel protocol includes blocks that contain only control information. [CSCdi77063]
- When the host sends the Offload box a close request followed by a purge request for the same socket, collect the following CIP trace information:
trace len 500
trace all off
trace offl on
trace offl_hdr on
trace socket on
stop offl_lpurge on
- Wait for the next BADPURGE error message and capture the trace table information:
tasks
trace display
stop off
trace default
- Then, send the output and all the console messages to Cisco engineering to resolve the problem. [CSCdi84662]
- The CIP crashes when it tries to process either the 129th CLAW Offload configuration command or the 257th CSNA command.
- The workaround is to not configure more devices or subchannels on a Channel Interface than are designated in the router configuration manual. [CSCdi86777]
- If the LU name in VTAM has a '$' character, the output from show extended channel slot/ 2 tn3270 server pu pu-name will display a "?" character. [CSCdj03576]
- The CIP crashes with Fatal error (code-35) when the host sends a Write request without wcc (illegal data). [CSCdj05890]
- When using the SNA session switch feature of a CIP TN3270 Server, if an upstream link is lost while it has LU-LU sessions, then the LU with the first local form session identifier (lowest LFSID) session will be left in a hung state. [CSCdj06185]
- For a CSNA user, this fix enables the CSNA to better cope with malformed protocol data unit (PDU) or garbage frames from the network. [CSCdj06519]
- If a link from a CIP TN3270 DLUR to VTAM (not the link that carries the DLUR-DLUS pipe) is a shut command then no shut command or deleted and added again, then the link will not be selected for LU-LU sessions. The resource sequence number (RSN) used to report the changed link state is incorrect, so DLUS ignores the information that the link has been restored. This circumstance can be confirmed by issuing the command DISPLAY NET,TOPO,ORIG=x,DEST=y at VTAM, where x is the CP name of the DLUR, and y is the CP name of VTAM on that link. If the problem has occurred then the status will be shown as INOP although the link is really active (and can be confirmed by reversing ORIG and DEST and reissuing the command).
- A workaround is to take down the DLUR-DLUS pipe after restoring the link. This can be done by issuing the VARY NET,INACT,ID=x,F command at VTAM, where x is the CP name of the DLUR, then making it active again. During this recycle, no new LU-LU sessions can be established, but existing sessions will be unaffected. [CSCdj09855]
- An extra 2 bytes of 01 c2 will be sent to the LU type 1 printer after end of job if the client printer sends data or negative response to the server. This may cause the printer to print 2 bytes of garbage data. [CSCdj10135]
- If a CIP TN3270 server PU is configured with the same remote MAC and SAP, then communication with the CIP is lost (output is hung). [CSCdj10605]
- When using Interlinks SNS TCPACCESS or Cisco IOS/390, the claw connection may not become established after a hard shutdown and restart of the host TCP/IP stack. The workaround for this problem would be to shut down the CIP interface and then issue the no shut command. [CSCdj11561]
- If the mainframe offload code sends a socket request with a bad length field, the CIP can crash with an alignment exception. The result is a fatal error with code 35. [CSCdj13586]
- This change provides additional diagnostic information when CIP detects failure condition. To capture this additional diagnostic information, users who have "logging buffered" configured have to configure a log buffer size of at least 36KB. [CSCdj14084]
- If two PUs are trying to talk to each other, a spontaneous microcode reload could happen with fatal error 35 in the Timer area. This fix corrects that potential microcode reload.
- The workaround is to correctly configure the PU. [CSCdj14302]
- If an inactive CIP TN3270 link is deleted with a no link command and then added again, then the link will always be rejected by the CSNA layer with the following message:
%MSG802-6-LLC_DUP_CCB.
- [CSCdj14957]
This section describes possibly unexpected behavior by Version 22.18. All the caveats listed in this section are resolved in Version 22.19. See Table 5 for the Cisco IOS release software version that corresponds to the 22.19 microcode version.
- If a packet without end of record (EOR) is received and followed by another packet with EOR and followed by data, a failure condition can occur for a TN3270 session. When this failure occurs, a random number of bytes will be appended to the first packet. If the second packet only contains EOR, or if multiple packets that end in EOR are received, the problem does not occur. The EOR for a TN3270 server is represented by the message FF EF. This failure could result in one of several atypical system behaviors including:
- Spontaneous reload of CIP.
- Lost sessions that are accessing the host via this channel connection.
- In this case the channel connection that this TN3270 session is using must be restored by deactivating and reactivating at the host.
- [CSCdj08881]
This section describes possibly unexpected behavior by Version 22.17. All the caveats listed in this section are resolved in Version 22.18. See Table 5 for the Cisco IOS release software version that corresponds to the 22.18 microcode version.
- An offload application can deplete all control blocks of a particular type and prevent traffic from going through a port adapter on the CIP. This situation can occur when several thousand established TCP connections close in a short period of time.
- The workaround is to reload the CIP microcode. [CSCdi41087]
- When the TN3270 server is running on the CIP, the CIP may send the following error message:
tnet sequence lost, expected....
- [CSCdi68249]
- When the CIP TN3270 server requests dynamically allocated logical unit (LU) sessions, the system services control points (SSCP) host VTAM produces the following message:
IST1016I
REASON = LU HAS ACTIVE OR PENDING ACTIVE SESSIONS
- The LU has a controlling Primary LU as defined by the LOGAPPL parameter.
- The workaround is to request another session. [CSCdi86173]
- A request/response unit (RU) gets marked Definite Response when DLUS at the host sends an RU to the CIP TN3270 server's DLUR (a session switch feature). The DLUR responds incorrectly, causing DLUS to unbind the session with sense code 400F0000. The PUs under DLUR enter HARD INOP state at VTAM. [CSCdi90099]
- A TN3270 client can send inbound data after the TN3270 server commits to accept outbound data. If the host data ends with a segmented RU, and the server queues the inbound data, then the server takes the inbound data out of the queue without waiting for the final segment. The server then incorrectly tracks the bracket state and rejects the next message from the host with SNA sense 2003.
- The workaround is to ensure that the outbound data is not segmented and by configuring the llc2 N1 4105 command on the virtual adapter of the CIP virtual interface. [CSCdi91434]
- When the CIP TN3270 server runs with a load greater than the CIP CPU can handle, the VTAM consumes more cycles than is desirable.
- The workaround is to reduce the offered load on the affected CIP card by reducing the number of connected sessions. [CSCdi92360]
- When connecting the TN3270 server and defining the PU with an LU-seed name, you must add a fifth character to the LU-seed T1 number. A fifth character is also required on the client- specified device name. Subsequent connections use the expected 4-character names. [CSCdi93113]
- CSNA allows the VTAM XID3 to advertise a larger window size than the CSNA has been configured. With this fix, CSNA will enforce the VTAM XID3 to only advertise a window size that does not exceed the configured receive window. [CSCdj01070]
- When a host sends a NULL RU CD after a write structure field write, the client keyboard is locked. [CSCdj02987]
- The details of the TN3270 connection are not displayed with the following error message:
%TN3270S-1-NegRsp_NO_CORRELATOR: TN3270E Neg Resp no correlator found
- This error message makes it impossible to isolate the cause of the problem. A useful error message includes the remote IP address and LU details. [CSCdj03345]
- Previously, the CIP microcode allocated 64 buffers for each CLAW device. The number of buffers per CLAW increased because of sudden burst of traffic and the large number of routes being passed to host-based TCP/IP stacks.
- Now, for each CLAW statement, the CIP microcode will retain the static 64 buffers that are 4096 in size. However, each 4096 byte buffer can be segmented into either 4 smaller buffers of 1024 bytes each or 8 smaller buffers of 512 bytes each. When buffers are allocated in this fashion, the 4096-byte buffer is reassembled after all of the smaller chunks are freed. [CSCdj03799]
- Stress testing of a TN3270 generates the following message:
TN3270S-1-LU_NO_BUFFER: No buffer for lu: SNA PosRspToHost.
[CSCdj05600]
- A CIP microcode reload may occur under the following circumstances:
- PU is not configured or shutdown
- TN3270 server is shut down
- Channel virtual port is shut down on a TN3270 server
- If a CIP microcode reload does occur, then check to see if the CIP TN3270 server displayed the following message when the PU was configured:
%CIP3: OpenNMLogListenEndPoint failed:bind failed
- If this caveat occurs, then it is likely that the situation described in CSCdj07773 occurred previously and the user should not perform a shutdown.
- The workaround is to reload the CIP microcode manually. [CSCdj07762]
This section describes possibly unexpected behavior by Version 22.15. All the caveats listed in this section are resolved in Version 22.17. See Table 5 for the Cisco IOS release software version that corresponds to the 22.17 microcode version.
- Issuing a shut command on the TN3270 server while there are active links can cause the CIP to reload spontaneously. The CIP reports error 9. [CSCdi81749]
- Issuing a shut command on the CIP virtual interface when tn3270-server command is configured on the interface can lead to the CIP spontaneously reloading. The CIP reports error 35. [CSCdi87976]
- The CIP will crash when either a no tn3270 or no pu command is issued within 10 seconds after a TN3270 E or non-E client disconnects. This defect causes the error message: CIP crash after issue no TN3270 command.
- This is a regression in the code Release 11.0(13.3)BT1(1.4) and 11.2(4.2) and was introduced by CSCdi90765.
- The workaround is to not issue a no TN3270 or the no pu command within 10 seconds of a client disconnecting. [CSCdi93241]
- Some mainframe applications emit SNA ambiguous sequences (for example, CA7). The problem is a result of an SNA sequence sending an End Bracket and a Change Direction on the same RU. The CIP rejects the RU with a sensecode of 0x40090000. The CIP should permit End Bracket and Change Direction RUs.
- To work around this problem, consult the documentation for mainframe applications. Some of the applications have startup modification options that can disable End Bracket and Change Direction PUs. [CSCdj00195]
The Version 22.16 was never released. All of the modifications listed in version 22.16 are included in Version 22.17.
This section describes possibly unexpected behavior by Version 22.14. All the caveats listed in this section are resolved in Version 22.15. See Table 5 for the Cisco IOS release software version that corresponds to the 22.15 microcode version.
- The show extended command may not function properly after inserting an IP card into a Cisco 75xx with CIP installed. The CIP card or router is not affected. [CSCdi58895]
- When a TN3270 server is operating with a configured primary and backup DLUS host, the DLUR-DLUS connection to the backup DLUS is not brought up until an unsuccessful attempt to rediscover the primary DLUS has been made. Depending on the number of timeouts in the APPN network (for example, in FEPs), this connection can take up to 15 minutes. Also, The CIP TN3270 DLUR should bring up a DLUR-DLUS session to the backup DLUS before it is needed. [CSCdi71259]
- When running CSNA on the CIP, the CSNA channel device becomes inactive for over six minutes and causes all SNA connections over the subchannel to be disconnected. [CSCdi74726]
- This problem occurs under the following two possible failure scenarios:
- The PCA-to-CIP communication will sometimes hang if the PCA adapter is configured with a path value that is not 0100 and no shutdown/shutdown interface commands are applied to the PCA interface. However, if a path value of 0100 and any other valid path value are defined on the PCA interface, the PCA-to-CIP communication will not hang.
- If the 0100 PCA logical path is not going to the established state as displayed by the show extended channel slot | port stats command and the CHPID is online, the customer may encounter the PCA-to-CIP communication problem. The workaround is to issue a shut command on the interface, issue a microcode reload command, and then issue a no shut command.
- The PCA-to-CIP communication might hang if a microcode reload is performed while the PCA interface is not shut down. This problem can also occur following a microcode reload command or no shut command if the 0100 PCA logical path is not going to the established state as displayed by the show extended channel slot | port stats command and the CHPID is online. After subsequent attempts to reload the microcode, the following messages indicate there is a PCA-to-CIP communication hang problem:
%CIP0-0-MSG: %ADAPTER-0-DIAGFAIL: Port 0 failed the PCA Diagnostic Mode 1 diagnostic
%CIP0-0-MSG: %ADAPTER-0-DIAGDATA: Module Call: 0 0 Error ID: 0 FFFFFFFF 0 c
- The workaround is to use online insertion and removal to reset the CIP. There should be a 10-second delay between the removal and the insertion of the CIP card. [CSCdi77139]
- The fix for CSCdi56069 introduced a bug in a rarely used code path. If the CIP has run out of message buffers in the past and a command is printing to a message port (typically the console port) and the user disconnects from that port, then the CIP may terminate with a fatal error dump. The fatal error occurs only when a large amount of output is sent to the CIP console (for example, when you issue a memory command at the CIP console). The error also happens when a large number of error messages are sent to the operating system. [CSCdi78520]
- All CSNA SNA sessions are lost when the CIP fatal error dump (code 09) occurs. The problem occurs about once a day on a Cisco 7513 with an RSP2 running Cisco IOS Release 11.1.7 (image rsp-jv-mz.111-7.CA1.bin) and CIP microcode version 22.12. When this error occurs, the following error message is displayed:
CIP5-0-MSG: %DMA-0-BADFIFO: FIFO failure detected during transfer (40 7E90).
- [CSCdi79267]
- In the show controller cbus command output, the CIP utilization data was upgraded to show more details. For each statistic, the value for a 1-minute sample period is shown with 5-minute and 60-minute sliding averages of the same statistic. The sliding averages are inaccurate, however. The 5-minute value can be too low by as much as 4, and the 60-minute value can be too low by as much as 59. [CSCdi79798]
- IP packets sent to an offload device with a destination address that differs from the address of the offload device are forwarded to the host without going through the TCP/IP stack on the CIP. If the packets arrive at the CIP faster than the host can read them, they queue on the CIP until it runs out of resources. No more data can be sent to the host on that interface until the next microcode reload. This problem occurs if a large amount of data is sent and is more likely to happen with UDP than with TCP. [CSCdi80263]
- The CIP may reload spontaneously when engaged in the hierarchical resetting of LUs that are TN3270 server-based. Shutting down a PU, link, or external communication adapter can cause hierarchical resets.
- The workaround to properly shut down a host, ESCON channel, link or PU is to shut down the PUs that will be affected before shutting down the host resource. [CSCdi81150]
- The CIP may fail after extended periods of use when there are not many offload sessions. [CSCdi82181]
- When all the PUs in a TN3270 server using a particular TCPIP IP/port listening pair are inactivated from the host, the statistics for that IP/port pair are reset. The statistics are reset for the show extended command output and the SNMP output in the TN3270 server MIB.
- The workaround is to keep active at least one PU on the IP/port, which prevents the statistics from being reset. [CSCdi82513]
- A TCP session may hang or UDP packets will be lost if the 16-bit sum of the TCP or UDP pseudo header equals 65535 (0xffff). Because the pseudo header is calculated from the source address, destination address, protocol, and protocol packet length once the problem tries to connect, that connection will eventually timeout because all of the packets will be dropped.
- View the output from the show extended channel slot | port tcp-stack and show extended channel slot | port udp-stack commands to view the errors. The variables that will be incremented for TCP and UDP will be TcpInErrors and UdpInErrors, respectively. [CSCdi83308]
- The following error message may be displayed if there are multiple FTP sessions to the MVS host:
*Dec 30 14:54:21: %CIP0-3-MSG: %OFFL-3-ILLEN: Illegal byte count in offload data.
1599427375 specified, 20500 available. xfer_element = 0
*Dec 30 14:54:21: %CIP0-3-MSG: x841BDA68
The FTP sessions, however, are unaffected at the application level.
- [CSCdi83886]
- The TN3270 server will send a value of 0 for end node CPs and DLUR user-defined transmission group characteristics. Instead of 0, the value should be the standard APPN default, which is 128. This applies to both real links and virtual ring nodes.
- Route selection problems can occur in networks with user-defined parameters in the transmission group characteristics. [CSCdi84886]
- The CIP interface is reset when the router displays the following error message:
%CBUS-3-INITERR: Interface 65535, Error (8034), idb 00000000 0 rx_setup - cbus_init()
- [CSCdi85216]
- The CSNA user can configure a maximum of 6000 LLC connections. To enable this feature, the user must use CIP microcode version cip21.14 (cip204.213), cip22.15 (cip206.171), or later. [CSCdi85623]
- The session switch (DLUR) feature in the CIP TN3270 server does not accept ACTLU for LUs with names that are the maximum length (8 bytes NETID plus 8 bytes LU name). The ACTLU is not acknowledged and the VTAM state is Pending Activate LU Response (PACTL).
- The workaround is to use shorter LU and NETID names. [CSCdi90243]
- The fix for CSCdi26192 allowed the RP or RSP to retrieve the following pieces of information without having the CIP interfaces configured: adapter type, adapter hardware version, adapter software version, available and total SRAM, as well as available and total DRAM.
- If the customer has an operating system that includes CSCdi26192, but is using a microcode that does not include the fix for this DDTS, the following error messages will be displayed when issuing the show controller cbus command:
00:09:52: %CBUS-3-CCBCMDFAIL1: Controller 0, cmd (77 0x00000000) failed (0x8008)00:09:52: %CBUS-3-CCBCMDFAIL1: Controller 0, cmd (77 0x00000010) failed (0x8008)00:09:52: %CBUS-3-CCBCMDFAIL1: Controller 0, cmd (78 0x00000001) failed (0x8008)
- [CSCdi90794]
- The number of reported maximum LUs is incorrect when queried by SNMP or when displayed in the show extend channel command in the TN3270 server. This problem occurs when Dynamic Definition of Dependent LU (DDDLU) is disabled on one or more PUs.
- The workaround is to use Dynamic Definition of Dependent LU (DDDLU)-enabled PUs. [CSCdi92154]
This section describes possibly unexpected behavior by Version 22.12. All the caveats listed in this section are resolved in Version 22.14. See Table 5 for the Cisco IOS release software version that corresponds to the 22.14 microcode version.
- In VTAM, the +r unbind dequeues the queued bind, but the Nfy Unav overtakes it and causes the bind to stay queued. This exposes a security hole in the session manager. The problem occurs when the user completes the following steps:
Step 1 Signs on (userid and password) to the session manager.
Step 2 Selects a Customer Information Control System (CICS) application. Clsdst/pass occurs to CICS application. Simlogon happens to session manager.
Step 3 Enters a CICS transaction.
Step 4 Releases the session from a CICS master terminal. The Rumba V4.1 TN3270 client then returns the message "requested LU unavailable."
Step 5 User disconnects from the Rumba client and reconnects, bypassing the entry validation screen. User is sent directly to the application selection menu.
- The existing sequence is:
Host Tn3270 Client
<--------------------------- logoff
unbind ---------->
disc ---------->
<--------- +r unbind
<--------- Nfy Unav
- This problem will be fixed in a future release. [CSCdi58780]
- Historically, both the default and maximum values for the TN3270 server maximum-lus parameter were set at 20000. Because of licensing issues, the default value will be set to 2100; the maximum value will become 32000. License reminders will be displayed when the default is exceeded, and warning messages would be displayed when the configured maximum is approached. [CSCdi62250]
- In the SNA-NAU-MIB, snaLuOperName is not displayed correctly. [CSCdi69052]
- CSNA users occasionally receive a CTA-0-INACTIVE message with an incorrect timeout value. The problem can result in the CSNA subchannel being reset when the subchannel is idle for more than 9 seconds. [CSCdi69282]
- An LU2 bind was accepted for printer client. A LU2 and LU3 bind was accepted for screen client. This behavior was incorrect. A fix was implemented so the bind is now rejected and the client disconnected. [CSCdi70482]
- This bug was introduced by CSCdi38483. IBM's offload implementation issues a never-ending receive on all RAW and datagram sockets. If packets come in to these sockets faster than the host can read them, the sockets start filling memory on the CIP. CSCdi38483 introduced a throttling mechanism for these sockets. However, it did not address the problem of closing a socket that was paused (throttled). The result is a fatal error caused by the offload code trying to resume a paused receive operation on a socket that no longer exists.
- This problem is corrected by making sure the socket control block for a paused socket remains after the socket closes until the resume operation is processed. [CSCdi72208]
- When running the CIP TN3270 server, no PLU sessions can be queued for statically defined until the first downstream TN3270 client connects to that LU. This may interfere with initialization of host-based print software such as RSCS, VPS, and so on. This reason for this is that the SLU is INHIBITED at ACTLU time, and goes to DISABLED or ENABLED state only during or after the first TN3270 client connection to the LU. The TN3270 server should initially place the SLU in DISABLED state (not INHIBITED).
- The workaround is to connect the downstream print clients before directing the host print software to queue sessions to the affected LUs. [CSCdi73134]
- If the Distributed Director feature is used with the TN3270 server, it occasionally locks up the TN3270 server. This results in new TN3270 connections not being accepted and previous connections not proceeding well. The workaround is to reload the CIP microcode. [CSCdi74255]
- When running CSNA on the CIP, the CSNA channel device becomes inactive for over six minutes and causes all SNA connections over the subchannel to be disconnected. [CSCdi74726]
- When a host sends a NULL RU with EB, the client may lock up because the server did not clear the keyboard restore bit. In the WSF, extra keyboard restore frames can be sent to the clients. [CSCdi74900]
- The RFC 1646 printer is not supported. [CSCdi75065]
- When using the TN3270 server DLUR feature and running the dependent LU sessions through an IBM 3746 as an intermediate network node, the IBM 3746 sometimes rejects the bind response from the server. [CSCdi75453]
- Sometimes while running the TN3270 server, the CIP will reload with fatal error 32.
- [CSCdi75996]
- When running TN3270E mode, the response to the host may come in too early (it is not the true response from the client). [CSCdi76545]
- When running an undocumented CIP console command tracing TN3270 server actions, the CIP reloads. This happens only when TN3270 sessions are connecting to the router. The failure is intermittent. [CSCdi76558]
- When running the TN3270 server on the CIP, the CIP leaks DRAM memory. over time. This leaking can cause crashes or hangs because of the lack of memory on the CIP.
- The memory leak is slow over a period of days when processing 4000 TN3270 connections per day. The workaround is to reload the CIP microcode periodically (for example, once a week).
- Inspect the output of show controller cbus daily and look at the amount of DRAM available to the CIP. [CSCdi76764]
- Occasionally, snmp and show command report unusually large response times for host and TCP side in the TN3270 server.
- If TN3270 printer sessions are not being run, this problem will not happen. This problem does not affect operation of TN3270 sessions or the TN3270 server itself. [CSCdi76786]
- This problem occurs under two possible failure scenarios.
- The PCA-to-CIP communication will sometimes hang if the PCA adapter is configured with a PATH value that is not 0100 and no shutdown/shutdown interface commands are applied to the PCA interface. However, if a PATH value of 0100 and any other valid PATH value is defined on the PCA interface, the PCA to CIP communication will not hang.
- If the 0100 PCA logical path is not going to the ESTABLISHED state as displayed by the show extended channel slot/port stat command and the CHPID is online, the customer may have encountered this problem. The workaround is to issue a shut command on the interface, a microcode reload command, then a no shut command.
- Whenever a microcode reload command is performed while the PCA interface is not shutdown, the PCA to CIP communication might hang. Following a microcode reload command or no shut command, if the 0100 PCA logical path is not going to the ESTABLISHED state as displayed by the show extended channel slot/port stat command and the CHPID is online, the customer may experience this problem. If this problem was encountered, the following messages appear on subsequent attempts to reload the microcode:
%CIP0-0-MSG: %ADAPTER-0-DIAGFAIL: Port 0 failed the PCA Diagnostic Mode 1 diagnostic
%CIP0-0-MSG: %ADAPTER-0-DIAGDATA: Module Call: 0 0 Error ID: 0 FFFFFFFF 0 c
- The workaround is to OIR of the CIP with a 10-second delay between the removal and the insertion of the CIP card. [CSCdi77139]
- SNMP queries sent to the CIP or show extended channel commands that use IPC can corrupt data for offload sessions or data for ind$file transfers.
- If SNMP requests and show extended channel commands are not issued, there is no problem. [CSCdi77480]
- This problem only affects the output of in_use global pages while using the mbstat command on the CIP console. It causes no functional problems. [CSCdi77481]
- When clients acting as an IBM 3270 Model 3, 4 or 5 connect to the Information Management System (IMS) through a CIP TN3270 server, the output screens may be corrupted.
- IMS does not perform a read partition query to determine the terminal's screen size characteristics. If IMS receives a LOGMODE message with a primary screen size of 24 x 80 (MOD2) and an alternate screen size of 27x132 (MODS), IMS sets the bind to both primary and alternate screen size of 27x132 (MOD 5). TN3270 server does a +RSP to the bind, but the TN3270 client does not know that the primary screen size has changed. The client expects a primary screen size of MOD2, and the application (IMS) has changed the primary screen size to MOD5.
- When IMS sends an ERASE WRITE message, it expects the screen to be 27 x 132. The client expects the screen to be 24 x 80 and a garbled screen results.
- This problem affects all non-TN3270E clients. Many TN3270E clients are also affected because they ignore the bind data.
- The TN3270 server must detect the discrepancy and translate between ERASE WRITE and ERASE WRITE ALTERNATE messages. [CSCdi77802]
- TN3270 server direct PUs send XID3s with no CP name vector. While this is legal (back-level LEN node behavior), some VTAMs reject it with sense code 089500xx. The PUs remain in the XID state. [CSCdi78349]
- The fix for CSCdi43140 introduced a memory leak in the offload support. Whenever offload quits (shut, no offload, interface reset) it does not free all its memory. The only workaround is to occasionally reload the microcode. [CSCdi78569]
- In the show controller cbus command output, the CIP utilization data was upgraded to show more details. For each statistic, the value for a 1-minute sample period is shown: 5-minute and 60-minute sliding averages of the same statistic are also shown. The sliding averages are inaccurate. The 5-minute value can be too low by as much as 4, and the 60-minute value can be too low by as much as 59. [CSCdi79798]
- If a CIP TN3270 server PU is varied INACT then ACT at the host, the server might try to reconnect the PU before the ACT. When this happens, the host replies with an XID3 carrying subvector 22. Because this generates host console messages, the server does not retry the connection for two minutes.
- The workaround is to recycle the PU using INACT,TYPE=REACT instead of INACT followed by ACT. [CSCdi79815]
- Occasionally when the user hits the PF key, the keyboard hangs. This is a regression error introduced by CSCdi74900. [CSCdi80141]
- IP packets sent to an offload device with a destination address that differs from the address of the offload device are forwarded to the host without going through the TCP/IP stack on the CIP. If the packets arrive at the CIP faster than the host can read them, they queue on the CIP until it runs out of resources. No more data can be sent to the host on that interface until the next microcode reload. This problem occurs if a large amount of data is sent and is more likely to happen with UDP than with TCP. [CSCdi80263]
- Because of incorrect configuration from host, VTAM can send SSCP-LU SNA character string data to a client that requires 3270DS. The TN3270 client will display garbled output or reject the connection.
- Similarly, the user's logon will be sent in 3270DS format, and the host must be configured to expect that. If the USS10 sent was in the wrong format, the logon will not be understood.
- The CIP TN3270 server should detect the problem and do what it can to convert the datastreams. Users often do not realize they must configure the host to match the format. [CSCdi82008]
This section describes possibly unexpected behavior by Version 22.10. All the caveats listed in this section are resolved in Version 22.12. See Table 5 for the Cisco IOS release software version that corresponds to the 22.12 microcode version.
- A TN3270 session that is connected but not immediately bound gets disconnected 2 1/2 minutes later. Additionally, the following message appears on the router console:
%CIP2-1-MSG: %TN3270S-1-NO_BIND_REQ_RCVD: No BIND REQ received on LU...
- The LU affected is not disabled; a VTAM display of the LU shows that it is ENABLED.
- Proper operation would allow the LU (printer or screen) to remain unbound until the inactivity timer triggers or the connection is shut down. In any case, proper operation dictates that a disconnected TN3270 session is reflected with the LU being in a DISABLED or INHIBITED state. [CSCdi70475]
- For users who are running CSNA and Offload concurrently, Offload can consume all the free buffer list (FBL) internal resources that CSNA needs in order to complete the channel WRITE operation. The resource consumption often causes CSNA to detect the subchannel idle condition and display following message:
%CTA-0-INACTIVE: PA0 CTA 0110-06 reset after being inactive for 180 seconds
- [CSCdi71177]
- The CIP card stops operation and reloads when a shut tn3270-server or a no tn3270-server command is issued at the CIP virtual interface. This reload occurs intermittently when Dependent LU Requester (DLUR) links have been defined for the TN3270 Server feature.
- A workaround for this problem is to go to the DLUR configuration mode under the TN3270 Server configuration mode of the virtual interface and issue no lsap commands to deconfigure the adapter attachment points for DLUR before deactivating the TN3270 Server. Be sure to record the current link and lsap command contents, as these values must be reconfigured when the TN3270 Server is brought up again. [CSCdi71216]
- For CSNA, there is a buffer leak problem associated with initiating an outgoing call. The buffer leak may result in locking up the subchannel or displaying the following message:
PA1 CTA c010-d1 reset after being inactive for 180 seconds
- [CSCdi73007]
- CSCdi39888 introduced a serious memory leak in Offload. CIP microcode that contains the fix for CSCdi39888, but not the fix for CSCdi74628, should not be used with Offload.
- Host applications that issues accept requests to the Offload devices can cause memory leaks of roughly 3 KB for every connection accepted. The Telnet Server application in MVS TCP/IP V3.1 is one example of such an application. Because of the memory leak, eventually the Offload application can no longer find enough memory to create new sockets and prints out the following error message:
%OFFL-3-REJSOCK: Not enough memory to handle new socket. sockets open.
- The TCPIP job log on the host will show the following error message:
EZB5141E Unexpected result from offload device ... ...
EZB5153I trgcls hi-order accept...
EZB5162I Data:
EZB5062I 000000:00000001 FFFFFFFF FFFFFFFF 0000000C
- This message indicates that the application on the host will no longer accept any incoming connections on that socket. For the Telnet Server, TCPIP must be recycled to allow clients to connect to the host again. Recycle other applications to correct the problem on the host.
- To correct the problem on the CIP, the Offload device must be unconfigured and reconfigured or the channel interface must be bounced (shut down and then restarted) with a shut command followed by a no shut command.
- The only workaround is to occasionally bounce the Offload devices on the CIP. [CSCdi74628]
- The fix for CSCdi56069 introduced a bug in a rarely used code path. If the CIP runs out of message buffers, it may encounter a bad instruction in this code path and terminate with a fatal error dump. The fatal error occurs only when a large amount of output is sent to the CIP console (for example, when you issue a memory command at the CIP console). The error also happens when many error messages are sent to the router operating system. [CSCdi74911]
- All data from the CIP to the Switch Processor (SP) or RSP is dropped and counted as an "ignore" in the show interface display. The problem potentially affects any feature that the CIP supports for supported releases. A clear indication of this problem is when the value for "rxcurr" is greater than 65000 in the show controller cbus display for the CIP interface. [CSCdi75138]
- The CIP may fail under certain conditions when multiple clients are bound to the same socket, but not fully bound. Running multiple copies of an FTP server is an example of this condition. This condition can also occur while doing multiple concurrent FTP GETS, which typically requires some connections to terminate abnormally so that the FTP sessions are taken down in a different order than they were created. [CSCdi75396]
This section describes possibly unexpected behavior by Version 22.7. All the caveats listed in this section are resolved in Version 22.10. See Table 5 for the Cisco IOS Release Software Version that corresponds to the 22.10 microcode version.
- Historically, both the default and maximum values for the TN3270 server maximum-lus parameter were set at 20000. Because of licensing issues, the default value will be set to 2100; the maximum value will become 32000. License reminders will be displayed when the default is exceeded, and warning messages would be displayed when the configured maximum is approached. [CSCdi62250]
- Under some circumstances, static TN3270 LUs cannot be selected by name by the client. The LU is active at the host and at the CIP, but attempts to select it are refused as though it were unknown.
- The more static LUs in the network, the higher the chance that any given LU is affected. [CSCdi67583]
- For CSNA users running Cisco IOS Releases 11.0(11) and 11.1(6), download one or both of the following microcode images from Cisco Connection Online.
- For Release 11.0(11):
- cip21-10 for CIP 1
- cipp21-10 for CIP 2
- For Release 11.1(6):
- cip22-10 for CIP 1
- cipp22-10 for CIP 2
- There is a potentially catastrophic problem with the CSNA feature in the microcode bundled with Cisco IOS Release11.0(11). The problem can occur with SNA path information units (PIUs) 4025 bytes or larger destined for the channel. [CSCdi69773]
This section describes possibly unexpected behavior by Version 22.6. All the caveats listed in this section are resolved in Version 22.7. See Table 5 for the Cisco IOS Release Software Version that corresponds to the 22.7 microcode version.
- The CSNA fails to detect the host halted via the "ZET NET, CANCEL" command. (Included with the corrections for this problem is an enhancement that speeds up the connection termination process so it will be more responsive to the vary active XCA major node command.) [CSCdi53187]
- The direct memory access (DMA) controller on the CIP which transfers packets between MEMD (on the SP or RSP) and memory on the CIP. The resulting error message looks like one of the two following examples:
DMA-0-BADFIFO: FIFO failure detected during transfer (4x 0100)
DMA-0-BADFIFO: FIFO failure detected during transfer (4x 0001)
- The numbers 0100 or 0001 in the parentheses indicate that the error is from a different type of unexpected behavior. IP datagram connections will drop packets that encounter the DMA transfer problem. Only packets coming from the mainframe are affected. These dropped packets will be retransmitted by higher level protocols (for example, TCP) and the new packets will not run into the same problem due to different IP sequence numbers in the IP header.
- Offload connections will drop outgoing packets (packets from the mainframe) that encounter the DMA transfer problem. Incoming packets will be dropped due to incorrect TCP or UDP checksums. Again, higher-level protocols will retransmit the packet. CSNA will be affected in much the same way as IP datagram. The major difference is that there is nothing equivalent to an IP sequence number in an LLC2 packet, so the retransmitted packets could encounter the DMA transfer problem. If enough unsuccessful retransmissions occur, the LLC2 session will drop. However, it is unlikely that this problem will occur because there are numerous conditions that must be met. [CSCdi54732]
- The CIP halts if the router switches a packet to the CIP for the virtual port adapter (interface channel slot/2) using the wrong virtual circuit number the CIP crashes. Before the fatal error dump you will see the following error message:
%CIP5-3-MSG: %CONFIG-3-WRONGINT: VCN 0(0000) not for port adapter 2
- In addition to preventing the unexpected halt, the fix in version 22.7 also adds code to print out the beginning of the bad packet. This allows to find out why the VCN was wrong. [CSCdi61532]
- On a CIP 2 (hardware revision 5.x) with CSNA and TCP Offload both in use, TCP sessions could randomly drop out with the remote client appearing to have requested disconnect. [CSCdi63044]
- Occasionally, if the CIP receives a packet greater than 4 k from RP/RSP, CIP may stop functioning properly and eventually may crash with fatal errors. The following message is an indication that the problem is encountered:
CLAW-6-TOOBIG: 4352 byte IP datagram exceeds CLAW MTU for device
- The workaround is to reload the router. [CSCdi64874]
- If you are running IP datagram, and a number of Selective Resets are issued to a CLAW connection, that CLAW connection may hang. One sign that this problem is occurring would be if the CLAW connection state is "Y," but every packet from the router to the CIP is dropped as viewed by the Read Block Dropped counter in the output from the show extended channel slot/port stat command. A microcode reload is required to clear the problem. [CSCdi65099]
- When more the one device is configured on a CIP interface, a potential exists for those devices to stop accepting data from the mainframe. For CLAW devices, this only prevents data from being received from the host. For CSNA devices, this would prevent traffic from flowing in or out of the host. A microcode reload is required to recover from the problem. [CSCdi66108]
- CSNA and Offload are not supported features if the CIP hardware revision is lower than Version 4.4. The fix for microcode version 22.7 adds a warning if these features are configured on down-level hardware. [CSCdi66745]
- When using a version of CIP microcode that contains the fix for CSCdi56069 (cip20-9, cipp20-9, cip204-80, cipp204-80, cip206-70) and running in an RASP platform, DBUS-INTERRs could result while entering commands into the CIP console. [CSCdi67549]
This section describes possibly unexpected behavior by Version 22.3. All the caveats listed in this section are resolved in Version 22.5. See Table 5 for the Cisco IOS Release Software Version that corresponds to the 22.6 microcode version.
- While running CSNA and in the process of bringing up a session, or while in data transfer phases, VTAM deactivates all active sessions with following error message:
INOP RECEIVED FOR XXXXXXXX code = 02
- [CSCdi64229]
- The CIP was designed to run two channel adapters with only 2 MB of DRAM when running in IP datagram mode. When running 32 CLAW devices with RIP, packets would be dropped even though additional DRAM was available to buffer packets until the mainframe could receive them. The fix for microcode version 22.6 allows CIPs with more than 2 MB of DRAM to make use of the additional memory when running IP datagram mode. [CSCdi54042]
- This fix addresses unexpected behavior when running CSNA, which could potentially cause session failure, BADFIFO error messages, and other side effects. [CSCdi61131]
- Under certain conditions, the FTP server on VM or MVS stops functioning if the offload device returns an invalid return code to a particular socket request to receive data. This return code also generates a traceback in the TCPIP logs for TCPIP for VM and MVS. The offload device no longer returns this invalid return code. [CSCdi61870]
This section describes possibly unexpected behavior by Version 22.0. All the caveats listed in this section are resolved in Version 22.3. See Table 5 for the Cisco IOS Release Software Version that corresponds to the 22.3 microcode version.
- Hub terminals manufactured by HOB expect a Receive Ready (RR) to be sent after the SABME is sent. This is not required by the 802.2 standard. After the HOB sends a SABME to the CIP LLC stack, the CIP LLC stack should respond with an RR and then assume that the terminal is in normal transfer mode. [CSCdi45083]
- The Offload read and write tasks are created with too little stack space. Under certain conditions, typically when several hundred sessions are established, a stack overflow can occur, which usually leads to a fatal error dump. The error code in this dump can be almost anything, with 32 and 35 being most likely. If you are running Offload with microcode versions cip21-3, cip11-4, cip22-1, or earlier, you should upgrade to at least cip21-4 (Cisco IOS Release 11.0(7) or later) or cip22-3 (Cisco IOS Release 11.1(2.4) or later). [CSCdi48357]
- When running CSNA, during large bursts of LLC, type 1 traffic from VTAM (many sessions configured for callout) an automatic reload of the CIP microcode may occur with the following message displayed: SSI_ASSERT failure in../cta/cta_mbuf.c @ 287 ... [CSCdi48855]
- When running MVS V=R in a VM/XA guest machine with a PCA, the mainframe channel will generate an interface disconnect in the middle of command chaining when it reaches an invalid CCW. If multiple devices are active on the PCA, this may result in an SCB_CHAIN error. The only work around for the SCB_CHAIN error is not to run in this configuration. [CSCdi49057]
- When running CSNA, if XCA major nodes are cycled inactive/active many times without reloading the CIP microcode, a CCA error message TOOMANY may be seen, and channel operation is paused without completing the current channel program. Depending on traffic levels, operation may or may not resume. If not, the CIP microcode must be reloaded. [CSCdi51452]
- Restarting TCPIP on the mainframe while data is moving through an Offload connection can cause the CIP to halt unexpectedly. The result is a fatal error dump. This dump must be sent to development engineering for analysis. The problem can be avoided by shutting down TCPIP, which causes all open sockets/connections to be closed, before restarting it. [CSCdi51859]
- With the CSNA feature, if an XCA major node is inactivated or VTAM is shut down while connections are active and traffic is flowing to VTAM, the CIP may pause indefinitely. If this pause occurs, the CIP microcode must be reloaded. [CSCdi53138]
Because CIP Microcode Version 22.0 was based on Version 21.3, modifications made in Version 21.3 are listed in this section.
CIP Microcode Version 22.0 was the first version specifically built for unbundled microcode support under Cisco IOS Release 11.1. See Table 5 for the Cisco IOS release software version that corresponds to the 22.0 microcode version.
CIP Microcode Version 21.3 fixed the following:
- This fix handles the VTAM flow request and eliminates the following message from being displayed: CSNA code does not recognize 0x0d50, Flow Request from VTAM [CSCdi45035]
- If the host sends a CLAW disconnect message to a link that has already been disconnected and that CLAW connection has a different link that is connected, the CIP will cause the static route for the CLAW connection to be removed. Version 2.1 of Interlink and IBM TCPIP V2 behave in this manner.
- The router will show that the Claw connection, as viewed by show extended channel slot/port statistics is connected, but the static route will be removed. [CSCdi45752]
- When status is pending on initial connection, the pending status is not flushed. This resulted in owed status being suppressed. On CSNA connections this causes data transfer to stop, and VTAM or the Missing Interrupt Handler detects an operation as taking too long. [CSCdi46037]
- This fix only applies to CSNA users who are using host backup configuration. If the user has duplicate VTAMs, for backup purposes, the user can configure two or more logical LAN adaptors (ADAPNO) with same MAC address on different internal LANs. When one of the VTAMs is brought down, similar to varying off the XCA major node, or one of the VTAMs is in trouble, all end-stations that previously connected to the problem VTAM can then reconnect to the backup VTAM.
- The subroutine that handles the reconnect logic requires this fix. [CSCdi47267]
For a complete list of caveats against the Cisco IOS Releasees, use Cisco Connection Documentation or access Cisco Connection Online as described in the section "Cisco Connection Online" later in this document. You can also refer to the following publications which are available on Cisco Connection Documentation:
- Release Notes for Cisco IOS Release 11.1 (Document Number 78-2886-xx)
- Release Notes for Cisco IOS Release 11.2 (Document Number 78-3648-01-xx)
- Release Notes for Cisco IOS Release 11.2 BC (Document Number 78-4694-01-xx)
- Release Notes for Cisco IOS Release 11.3 (Document Number 78-4998-xx)
CIP and processor module (RP, RSP, and RSP7000) ROM monitor (system bootstrap) versions and system software images are typically independent of each other; however, the CIP hardware version does have minimum recommended requirements in terms of Cisco IOS Release and CIP Microcode Version as listed in Table 5. Other microcode versions can be used, but only when specifically instructed to do so by technical support personnel. Table 5 identifies the processor module monitor versions.
Note For Cisco IOS Release 11.2 BC, the CIP card is supported only on the Cisco 7000 with RSP7000 and the Cisco 7500 series routers.
Use the show diag EXEC command to display the CIP hardware version. The original CIP card is identified as version 4.x. The CIP2 card is identified as version 5.x.
Table 6: CIP Hardware, Cisco IOS Release, and CIP Microcode Compatability
| CIP Hardware Version
| Minimum Cisco IOS Release Required
| Minimum CIP Microcode Version Recommended
|
|---|
| CIP 4.1
| 10.2(4.6)
| cip10-4
|
CIP 4.2
| 10.3(5.1)
| cip10-7
|
| 10.3(8.5)
| cip20-5
|
| 10.3(6.2)
| rsp_cip20-2
|
CIP 4.41
| 20.2(10.2) or later
| cip10-4
|
|
| cip20-4
|
| 10.3(7.5)
| cip10-9
|
| 10.3(8.5)
| cip20-5
|
| 10.3(7.5)
| rsp_cip20-3
|
| 11.0(3.5)2
| cip11-4
|
| 11.0(4.5), 11.1(1)
| cip21-3
|
| 11.0(3.5)
| rsp_cip21-2
|
| 11.1 any version
| cip22-x
|
| 11.2 any version
| cip22-x
|
111CIP2 5.x
| 10.2(3), 10.3(13)
| cipp20-8
|
| 11.0(10)
| cipp21-7
|
| 11.1(5)
| cip22-6
|
| 11.1(6)
| cip22-7
|
| 11.1(7), 11.2(1), 11.2(2)
| cip22-10
|
| 11.1(8), 11.2(3), 11.2(4)
| cip22-12
|
| 11.1(9)
| cip22-14
|
| 11.1(10)
| cip22-15
|
| 11.2(5)
| cip22-17
|
| 11.1(11)
| cip22-18
|
| 11.2(6)
| cip22-19
|
| 11.1(12), 11.2(7)
| cip22-20
|
| 11.1(13), 11.2(8)
| cip22-21
|
| 11.1(14), 11.2(9)
| cip22-22
|
| 11.1(15)
| cip22-23
|
| 11.2(10), 11.1(16)
| cip22-25
|
| 11.2(11), 11.1(17)
| cip22-26
|
| 11.2(8)BC
| cip24-0
|
| 11.2(9)BC
| cip24-1
|
| 11.2(10)BC
| cip24-2
|
| 11.2(11)BC
| cip24-3
|
| 11.3(1)
| cip25-3
|
1
The Cisco 7500 series requires CIP hardware revision 4.4 or later.
2
Cisco IOS Release 11.0 and later also requires a CIP hardware revision 4.4 or later.
Table 7: Minimum Recommended CIP Boot ROM Versions
| Platform and Processor
| CIP Boot ROM Version
| Processor ROM Monitor Version
|
|---|
| Cisco 7000 family router1 with a Route Processor (RP), 7000 Series Route Switch Processor (RSP7000), RSP1, and RSP2
| Version 1.6 or later (required)
| System Bootstrap Version 11.0 or later
|
1
The Cisco 7000 family routers include the Cisco 7000, Cisco 7010, Cisco 7505, Cisco 7507, and Cisco 7513.
For the Cisco routers to take advantage of the Cisco IOS Release Software CIP features, you might need to upgrade code, main system, or CIP memory. For specific Cisco IOS-related memory requirements, refer to the Release Notes for Cisco IOS Release 11.x publication, which is available on Cisco Connection Online.
Following is an overview of how to upgrade unbundled CIP microcode (CIP Microcode Version 22.0 and later) for the Cisco 7000 family routers.
Note In the following procedure, a Cisco IOS Release 11.1 (or later) image is booted
before the CIP microcode image is copied to Flash memory.
For CIP microcode images that were shipped on floppy disks or were obtained from CCO, do the following:
Step 1 Upload the CIP microcode image (and the Cisco IOS image if not on ROM) from the floppy disks or from CCO to a TFTP server.
Step 2 From the running configuration, remove any microcode cip configuration commands that specify a CIP microcode image.
Step 3 Save your running configuration to a TFTP server or Flash memory.
Note If you have a Cisco 7000 series router and plan to install new software ROM with Cisco IOS software, skip Steps 4 and 5 and turn off power to your router. Install the new ROMs, then proceed to Step 6.
Step 4 Before you copy tftp you need to rename the microcode you downloaded from CIP22-3.TAR to CIP22-3. If you do not rename the microcode image, the RSP does not find the kernel because it will be named CIP22-3.TAR_kernel... instead of CIP22-3_kernel....
Step 5 Download the Cisco IOS Release software image to Flash memory.
Step 6 Configure the router to boot from the Flash memory where the Cisco IOS Release software image resides.
Step 7 Boot the Cisco IOS Release software image.
Note The router must be running Cisco IOS Release software before copying the CIP image to Flash memory in the following step because the CIP image must be "exploded" from the single image file on the TFTP server to multiple files in Flash memory. This capability is added in Release 11.1.
Step 8 Download the CIP microcode image to the Flash memory card in slot 0.
Step 9 Perform a microcode reload.
Step 10 Restore the running configuration with the configuration you saved to the TFTP server in Step 3.
For CIP microcode that shipped on Flash memory cards, do the following:
Step 1 Insert the Flash memory card into a Flash memory card slot 0.
Step 2 Configure the router to boot from the Flash memory card in slot 0.
Note For the specific procedures associated with the steps in this overview, refer to the companion publication
Upgrading Software and Microcode in Cisco 7000 Family Routers (document number 78-1144-xx), which includes the information and procedures necessary to upgrade your CIP microcode. The
Upgrading Software and Microcode in Cisco 7000 Family Routers publication includes information on upgrading software and microcode images, transferring files to and from Trivial File Transfer Protocol (TFTP) servers, copying files between nonvolatile random-access memory (NVRAM) and Flash memory, and between TFTP servers and Flash memory. The publication also includes basic instructions for booting your system.
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. CCO services include product information, product documentation, software updates, release notes, technical tips, the Bug Navigator, configuration notes, brochures, descriptions of service offerings, and download access to public and authorized files.
CCO serves a wide variety of users through two interfaces that are updated and enhanced simultaneously--a character-based version and a multimedia version that resides on the World Wide Web (WWW). The character-based CCO supports Zmodem, Kermit, Xmodem, FTP, and Internet e-mail, and is excellent for quick access to information over lower bandwidths. The WWW version of CCO provides richly formatted documents with photographs, figures, graphics, and video, as well as hyperlinks to related information.
You can access CCO in the following ways:
- WWW:
http://www.cisco.com
- WWW:
http://www-europe.cisco.com
- WWW:
http://www-china.cisco.com
- Telnet:
cco.cisco.com
- Modem: From North America, 408 526-8070; from Europe, 33 1 64 46 40 82. Use the following terminal settings: VT100 emulation; databits: 8; parity: none; stop bits: 1; and connection rates up to 28.8 kbps.
For a copy of CCO's Frequently Asked Questions (FAQ), contact cco-help@cisco.com. For additional information, contact cco-team@cisco.com.
Note If you are a network administrator and need personal technical assistance with a Cisco product that is under warranty or covered by a maintenance contract, contact Cisco's Technical Assistance Center (TAC) at 800 553-2447, 408 526-7209, or
tac@cisco.com. To obtain general information about Cisco Systems, Cisco products, or upgrades, contact 800 553-6387, 408 526-7208, or
cs-rep@cisco.com.
Cisco Documentation CD-ROM
Cisco documentation and additional literature are available in a CD-ROM package, which ships with your product. The Documentation CD-ROM, a member of the Cisco Connection Family, is updated monthly. Therefore, it might be more up to date than printed documentation. To order additional copies of the Documentation CD-ROM, contact your local sales representative or call customer service. The CD-ROM package is available as a single package or as an annual subscription. You can also access Cisco documentation on the World Wide Web at http://www.cisco.com, http://www-china.cisco.com, or http://www-europe.cisco.com.
If you are reading Cisco product documentation on the World Wide Web, you can submit comments electronically. Click Feedback in the toolbar, select Documentation, and click Enter the feedback form. After you complete the form, click Submit to send it to Cisco. We appreciate your comments.
