Advanced Communications Controller Release Notes for the B.03.01 Release Dart 42 5966-7377 HP 9000 Systems E1098 Printed in: U.S.A. © Copyright 1998 © Hewlett-Packard Company. All rights reserved.
Legal Notices The information in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this manual, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be held liable for errors contained herein or direct, indirect, special, incidental or consequential damages in connection with the furnishing, performance, or use of this material. Warranty.
©copyright 1990, 1991, 1992 Cornell University ©copyright 1989-1991 The University of Maryland ©copyright 1988 Carnegie Mellon University Trademark Notices UNIX is a registered trademark of The Open Group. X Window System is a trademark of the Massachusetts Institute of Technology. MS-DOS and Microsoft are U.S. registered trademarks of Microsoft Corporation. OSF/Motif is a trademark of the Open Software Foundation, Inc. in the U.S. and other countries.
Publishing History The manual publishing date and part number indicate its current edition. The publishing date will change when a new edition is published. Minor changes may be made without changing the publishing date. The manual part number will change when extensive changes are made. Manual updates may be issued between editions to correct errors or document product changes. To ensure that you receive the updated or new editions, you should subscribe to the appropriate product support service.
Contents ACC Software Products and Documents . . . . . . . . . . . . . . . . . . . . . . . . . 9 What’s in this Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Benefits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 New Features and Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Fixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Changes for ACC Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 ACC Protocol Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Enhancements in Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Documentation Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Software Availability in Native Languages . . . . . . . . . . . . . . . . . . . . . . .
1 Advanced Communications Controller Release Notes for the B.03.
Advanced Communications Controller Release Notes for the B.03.01 Release The following information is for Release B.03.01 of the Advanced Communications Controller (ACC) products for HP-UX B.11.00. ACC is a wide-area networking product for the HP 9000 systems. It supports high-throughput and high-connectivity networking over a variety of serial data communications protocols. An Application Programmatic Interface (API) is also available to allow low-level access to monitor and control the protocols.
Advanced Communications Controller Release Notes for the B.03.01 Release ACC Software Products and Documents ACC Software Products and Documents ACC Release B.03.01 is delivered via the HP-UX Applications CD-ROM instead of DDS tape as in the previous releases. The software products are also re-structured to simplify the product choices. Four (4) software products are offered in this release: • Z7476AA: ACC and X.25/9000 Software Bundle This combines 3 products: J2793B X.25/9000, Z7478AA and Z7480AA in one.
Advanced Communications Controller Release Notes for the B.03.01 Release ACC Software Products and Documents Table 1-1 Documents for ACC Software Products Z7477AA ACC and X.25/9000 Software Bundle Documentation ACC Installation and Configuration Guide 5966-7370 ACC Utilities Reference Guide 5966-7369 ACC Error Guide 5967-9806 ACC X.25/ISDN Data Analyzer User’s Guide 5966-7396 X.25/ACC Installation and Configuration Guide 5966-7367 X25/ACC Update Guide 5967-9804 X.
Advanced Communications Controller Release Notes for the B.03.01 Release What’s in this Version What’s in this Version Benefits ACC Release B.03.01 is a major release. It is the first release that runs on HP-UX 11.00, supporting both 32/64-bit modes of HP-UX 11.00. This release supports 64-bit and multi-threaded application development. This provides the foundation for improving the capacity and performance of today’s enterprise networking application systems. Together with the ACC X.
Advanced Communications Controller Release Notes for the B.03.01 Release What’s in this Version • All ACC drivers have been modified to be MP Scalable. On multiprocessor hardware, each driver may run in parallel on a separate processor. • Both the ACC kernel and API support true multi-threading using POSIX threads. On multiprocessor hardware, this enables maximum concurrency and true physical parallelism. • Enhancements to X.
Advanced Communications Controller Release Notes for the B.03.01 Release Known Problems and Workarounds for ACC Products Known Problems and Workarounds for ACC Products This section describes known problems and workarounds for version B.03.01 of the ACC software products. • Due to potential installation problems, independent installation of the X.25/9000 (J2793B) and the ACC and X.25/9000 Software Bundle (Z7476AA) products is not currently supported. • When installing the ACC and X.
Advanced Communications Controller Release Notes for the B.03.01 Release Known Problems and Workarounds for ACC Products • The Fast Select facility code is being dropped by the X.25 driver. • X25ping utility does not work. • The x25init -a ipmap command (without the -c option) does not work. • The swremove command may fail. When removing the Z7476AA product from the system, you may get an ERROR condition. Please ignore the error if the /var/adm/sw/swagent.
Advanced Communications Controller Release Notes for the B.03.01 Release Known Problems and Workarounds for ACC Products configuration. When this happens, zmlog prints an error message in the ZCOM error log file and ignores the log buffer. This problem is very difficult to reproduce in the lab, hence the cause is still unknown. It is suspected that the cause is contention in the driver, when multiple pieces of driver codes are trying to log messages and hit some unprotected critical sections.
Advanced Communications Controller Release Notes for the B.03.01 Release Known Problems and Workarounds for ACC Products • x25stat may return invalid statistics data While x25stat (provided by X.25/9000) is used to display the statistics data from the X.25/ACC subsystem, some of the X.25/9000 statistics data is not available in this release of X.25/ACC subsystem. x25stat displays the unavailable statistics data as zeros. A value of zero in the following LAP- B fields mean that statistics are not available.
Advanced Communications Controller Release Notes for the B.03.01 Release Known Problems and Workarounds for X.25/9000 Products Known Problems and Workarounds for X.25/9000 Products This section describes known problems and workarounds for version B.11.00.05 of the J2793B X.25 software for the HP 9000 server systems and workstations.
Advanced Communications Controller Release Notes for the B.03.01 Release Known Problems and Workarounds for X.25/9000 Products This is not an error. It is a message for your information. The installation will succeed. • To configure remote system access, the “Subnetwork Mask” option on SAM’s “Configure Internet Address” window must be set to “Yes” and the “Subnet Mask” field must be completed. • To successfully regenerate the kernel, you must always have a session opened on the LOCAL console.
Advanced Communications Controller Release Notes for the B.03.01 Release Compatibility Information and Installation Requirements Compatibility Information and Installation Requirements Software Requirements • Products Z7476AA ACC and X.25/9000 Software Bundle, Z7478AA ACC Base Software, and Z7486AA ACC Protocols for Appplication Developers only require the basic HP-UX operating system. • Product Z7480AA ACC X.25/9000 Link Software requires both Z7478AA ACC Base Software and J2793B X.
Advanced Communications Controller Release Notes for the B.03.01 Release Compatibility Information and Installation Requirements OS Platform and Version Compatibility • This release only runs on HP-UX 11.00 operating system (both 32/64-bit). If you are currently running HP-UX 9.x or 10.x, you must upgrade to HP-UX 11.00 before installing this release. • Either 32-bit or 64-bit ACC will be installed depending on the mode of the target operating system.
Advanced Communications Controller Release Notes for the B.03.01 Release Compatibility Information and Installation Requirements • Extra disk space will be required while running ACC software, such as runtime log files and configuration files. Hence, it is recommended that you allow at least another 20Mb of free disk space for running the ACC product. Install/Upgrade With System Up or Down It is recommended that the necessary ACC interface cards be installed before installing the software.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Patches and Fixes for this Version All the fixes and patches released for earlier releases B.02.xx are incorporated in this release of ACC software. The following table describes the major fixes. Table 1-3 Defects fixed in this release Symptoms 1. Reference: NONE Some ACC software components are not Year 2000 compliant. 2.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 5. Reference: SR #1653241331 Reference: TPO0h01641 2-channel card only: When an unrecognized unnumbered frame is received at level2, the cause code information in the generated frame reject is incorrect. 6. Reference: SR #1653241356 Reference: TPO0h01640 On 2-port ACC cards, the card can transmit a bad frame at the beginning of link setup.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 8. Reference: SR #1653260117 Reference: SR #4701391920 Reference: TPO0h01285 For HP-UX 10.0 and later, all driver major numbers are dynamically assigned. When the ACC software is installed, its devices are created with the correct major numbers.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 10. Reference: SR #4701391862 Reference: SR #4701391912 Reference: TPO0h02130 No current method to determine hardware revision. 11. Reference: SR #5003380527 When kernel parameters msgssz & msgseg are incorrectly configured, it causes zmasterd to hang during ZCOM subsystem start up. 12.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 15. Reference: SR #5003419424 zterm’s PT ommand is supposed to change the ACC port configuration, but it does not always work when checked with zmntr. 16. Reference: SR #5003437947 For NIO 8-port ACC cards, DMA timeout was occurring during ACC system start up in HP K-class systems (and potentially any T series) with 2 or more ACC cards installed.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 18. Reference: TPO0h01208 Defect / Fix This library is shipped as of this release. The ZCOM shared library libzcom_c.sl is not provided to the customers. It needs to be added to the packaging and the transition links file. 19.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 22. Reference: TPO0h01617 When a restart was required on an active 8-port EISA ACC card, due to firmware failure, the restart sequence was attempted five times unsuccessfully. Defect / Fix The DAM and firmware have been corrected. The driver reports the following errors: Backplane command (DMA) has timed out ! Activate error: MUX timed out 23.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 27. Reference: TPO0h01755 HDLC/LAP-B (ABM) or X.25 protocol sends REJ on receipt of an I-frame with duplicate N(S). This causes reject frames to be transmitted even though no frames were missed. This problem was spotted in dump files. In addition to the incorrect REJ, the retry mechanism for the unsatisfied REJ is incorrect. 28.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 31. Reference: TPO0h01894 Loopback test on Z7330A and Z7300A cards may sometimes fail. 32. Reference: TPO0h01913 During a card restart, the following message is logged for a ZLU: zcom 00207 ZLU 3 Set terminal parameters failed with error: Protocol not loaded. After the card restart processing completes, all ZLUs mentioned by the above message will be unusable (hung).
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 33. Reference: TPO0h01914 A request issued to a ZLU hangs and is never processed. That is, it is queued in the data structures but never sent to the card. Defect / Fix The application is dynamically creating a ZLU on a subchannel or port that has not been defined or configured, but the driver does not check for this condition and rejects the request.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 37. Reference: TPO0h02042 On 4-channel cards, LAPB/LAPD loses timers in the timer download control request. Defect / Fix When timers are downloaded to the LAPB/LAPD protocol in the CW_TIMERS control write request, a system timer entry is wasted. Eventually the ACC card can run out of timers. This firmware is fixed. 38.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 42. Reference: TPO0h02189 zset_rcvr() allows shared receivers to be set without limit. But zget_shrcvr_list() silently imposes a limit of 64 shared receiver (ZcMAX_SHARED_RCVRS) that can be retrieved. So a program can keep setting shared receivers, but cannot see the whole list. In general, 64 shared receivers is a large enough number for most application needs. 43.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 44.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 46. Reference: TPO0h02255 On 4-port cards, the ACC X.25 firmware occasionally fails in creating a large number of X.25 virtual circuits in a short period of time. This problem was discovered in executing a stress test that attempts to establish 1024 VCs. The driver sometimes detected that write completion messages arrived out of sequence. 47.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 49. Reference: TPO0h02280 A subchannel on the Z7330A ACC card may occasionally stop receiving frames. This will lead to different error conditions depending on the protocol being used. With X.25, a message in the ACC log file reported: Link ZLU <#> down: Exceeded N2 retransmit limit. 50.
Advanced Communications Controller Release Notes for the B.03.01 Release Patches and Fixes for this Version Symptoms 51. Reference: TPO0h02331 This defect is to include an error check in the 4-port firmware $PORT command to reject invalid configurations when using dynamic configurations. - Subchannels 0-31 are valid for both E1 and T1. - Timeslot 0 is unusable in both T1 and E1 modes, and an error should be reported if this is assigned to a timeslot. - For E1, timeslots 1-31 are valid.
Advanced Communications Controller Release Notes for the B.03.01 Release Major Enhancements and New Features Major Enhancements and New Features 32/64-bit Support • This release comes with 32-bit and 64-bit versions of ACC software. Depending on the target system OS, the compatible version will be selected automatically during ACC software installation. • The 32-bit ACC software is compatible across PA-RISC 1.1 and 2.0 architecture, and is supported on both 32-bit and 64-bit HP-UX 11.00.
Advanced Communications Controller Release Notes for the B.03.01 Release Major Enhancements and New Features Changes for ACC Development • This release of ACC software supports true multi-threading. All APIs are enhanced to be Thread-Safe using POSIX (1003.1c) kernel threads. The ACC kernel drivers are also optimized for multiprocessor hardware. Hence, maximum concurrency and true physical parallelism can be achieved with multiprocessor hardware.
Advanced Communications Controller Release Notes for the B.03.01 Release Major Enhancements and New Features dynamically configured using zonfig() timeslot zero can only be assigned to subchannel zero, otherwise a status code (PT_BAD_TS) will be returned. • ttgen now reports an error if timeslots 25 to 31 inclusive are assigned to a subchannel when the port is configured in Tmode. ttgen also reports an error if timeslot zero is assigned to a subchannel in any port mode.
Advanced Communications Controller Release Notes for the B.03.01 Release Major Enhancements and New Features messages (for example, expected notification messages) to be selectively excluded from being logged so that the ZCOM log file is not filled up by them. The relevant message files can be modified to give a negative priority to the unwanted messages. Refer to the chapter for zmlog in the ACC Utilities Reference Guide for details.
Advanced Communications Controller Release Notes for the B.03.01 Release Major Enhancements and New Features Documentation Changes • A new document is introduced: ACC Error Guide (5967-8906). It is a reference document for the ZCOM error codes, status codes and log messages used in various ACC software components. It is intended to be a handy reference document for troubleshooting. • A second new document is introduced: X.25/ACC Update Guide (5967-8904). This manual describes how to update your existing X.
Advanced Communications Controller Release Notes for the B.03.01 Release Software Availability in Native Languages Software Availability in Native Languages All the software and documents of the ACC product family are currently delivered in English only. However, all messages that can appear in the ACC log file are defined in text files which can be customized for native language support if necessary.
