HP_DECnet-Plus_for_OpenVMS__________________________ Release Notes March 2010 This manual describes installation notes for this release, new features not discussed in the current documentation, corrections included in this release, documentation errata, and operational notes. Revision/Update Information: This revised manual supersedes HP DECnet- Plus for OpenVMS Integrity servers- Release Notes, V8.3- 1H1. Operating System: OpenVMS Version 8.4 for Integrity servers OpenVMS Alpha Version 8.4 Software Version: HP DECnet-Plus for OpenVMS Version 8.4 Hewlett-Packard Company Palo Alto, California © Copyright 2010 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. UNIX is a registered trademark of The Open Group. _________________________________________________________________ Contents Preface................................................... vii 1 Installation 1.1 Features Not Supported in This Release........ 1-1 1.2 License Requirements.......................... 1-1 1.2.1 License Requirements for OpenVMS Integrity Servers................................... 1-1 1.2.2 License Requirements for OpenVMS Alpha Systems................................... 1-2 1.3 OpenVMS Software Version Requirement.......... 1-2 1.4 Other Software Version Requirements........... 1-3 1.5 Installing the New Release.................... 1-3 1.6 AUTOGEN Errors During Installation (OpenVMS Alpha Only)................................... 1-4 2 New Features and Enhancements 2.1 Network Management............................ 2-1 2.1.1 DECnet/IP Communication Through SSH....... 2-1 2.1.2 DECnet-Plus Support for Mixed Case Password.................................. 2-4 2.1.3 NET$CONFIGURE Improvements................ 2-5 2.1.4 NCL Updates............................... 2-5 2.1.4.1 Added information about Configuring the system to listen to DECnet/IP connections............................. 2-6 iii 2.1.5 NCL HELP Updates.......................... 2-6 2.1.5.1 Added New Material about Backtranslations and Towers............. 2-7 2.1.5.2 Added Information about Support for IP Towers.................................. 2-7 2.1.5.3 Added Help for register and modify decnet_register Commands................ 2-7 2.1.5.4 Added Information about Flushing the CDI Cache................................... 2-7 2.1.5.5 Modified Description of the Session Control Naming Search Path Characteristic.......................... 2-8 2.1.5.6 Directory System Agent (DSA) Entity Help Updated................................. 2-8 2.1.5.7 Added DNS/BIND Namespace Examples for LOOP Help............................... 2-8 2.1.5.8 Updated Help for FDDI Station Link Event Reporting............................... 2-8 2.2 New Devices Supported by MOP.................. 2-9 2.3 DECnet-Plus and DECnet Phase IV support VLAN.......................................... 2-9 2.4 Transport Improvements........................ 2-10 2.5 Host-Based Routing Improvements............... 2-10 2.6 Session Control Improvements.................. 2-11 2.7 Distributed Naming Service (DECdns)........... 2-12 2.7.1 DECdns Now Supports Dynamic Device Recognition............................... 2-12 2.7.2 DECdns Now Supports DECnet over TCP/IP Links..................................... 2-12 2.7.2.1 Protocol Towers......................... 2-13 2.7.3 decnet_register Now Supports IP Towers in the DECdns Namespace...................... 2-13 2.8 Distributed Time Service (DECdts)............. 2-15 2.8.1 DECdts Now Supports Dynamic Device Recognition............................... 2-16 2.8.2 DECdts Now Supports DECnet over TCP/IP Links..................................... 2-16 iv 3 Corrections Included in this Release 3.1 DNS$ADVER.EXE................................. 3-1 3.2 DTSS Changes.................................. 3-1 3.3 Network Management Changes.................... 3-2 3.3.1 End System Routing........................ 3-2 3.3.2 NET$CONFIGURE Command Procedure........... 3-3 3.3.3 NET$STARTUP Command Procedure............. 3-3 3.3.4 NCL$GLOBALSECTION.DAT..................... 3-3 3.4 OSAK Changes.................................. 3-4 3.5 Session Control............................... 3-4 3.6 Transport Layer............................... 3-5 4 Documentation Errata and Addenda 4.1 Current Product Documentation................. 4-1 4.2 Documentation Update for Version 8.2.......... 4-2 4.3 Network Management and NCL.................... 4-7 4.3.1 Devices and OpenVMS Device Names.......... 4-7 4.3.1.1 CSMA-CD Devices......................... 4-7 4.3.1.2 FDDI Devices............................ 4-10 4.3.1.3 Synchronous Devices (OpenVMS VAX and Alpha Only)............................. 4-11 4.3.1.4 Asynchronous Devices (OpenVMS VAX Only)................................... 4-13 4.3.2 DTR/DTS................................... 4-13 4.4 OSAK Programming.............................. 4-14 4.4.1 called_aei Parameter on A-ASSOCIATE and S-CONNECT Indication Events............... 4-14 4.4.2 ROSE Minimum Workspace Increased.......... 4-14 4.4.3 Using OSAK with OSI over TCP/IP........... 4-14 4.4.4 New Status Code for osak_send_more and spi_send_more Routines.................... 4-15 4.4.5 New OSAK API Routine: osak_tc_no_sc() .... 4-15 4.4.6 Handling of Default Transport Templates... 4-16 4.4.7 Omitted Parameter Block Parameters........ 4-17 4.5 File Transfer, Access, and Management (FTAM)........................................ 4-17 4.5.1 Possible Values for OSIF_FAILURE.......... 4-17 v 5 Operational Notes 5.1 Network Management............................ 5-1 5.1.1 CTF Utility Now Requires Process Privileges................................ 5-1 5.1.2 Tuning to Support the Larger CML BYTLM Value..................................... 5-1 5.1.3 COLLECT Command and Addressing in decnet_migrate Commands................... 5-3 5.1.4 Decimal Syntax DSPs Not Supported......... 5-3 5.2 Devices and Data Links........................ 5-3 5.2.1 Receive Buffers Attribute on HDLC LINK Entity Not Implemented (Integrity servers and Alpha only)........................... 5-3 5.2.2 FDDI Large Packet Support................. 5-4 5.3 Transport Layer............................... 5-4 5.3.1 NSP Characteristics for X.25 PVCs......... 5-4 5.3.2 NSP Flow Control Policy and DECnis and x25Gateway Routers........................ 5-4 5.3.3 OSI Transport............................. 5-5 5.4 Session Control............................... 5-5 5.4.1 Transport Precedence in Predominantly Phase IV Networks......................... 5-6 5.4.2 Session Control Back Translation Soft Links..................................... 5-6 5.4.3 Restriction When Using Applications Supported Using Cluster Aliases........... 5-6 5.5 Distributed Naming Service (DECdns)........... 5-7 5.5.1 Creating Clearinghouses When IP Address is Zero Causes DNS Server Hang............... 5-7 5.5.2 Server Startup Delay...................... 5-8 5.5.3 Delay in Node Name-to-Address Translations When DECdns Is Using DECnet over TCP/IP Connections............................... 5-8 5.5.4 Problem Creating Clearinghouse Using DECnet over TCP/IP Connections............ 5-9 5.5.5 DNS$CONFIGURE Option 4 Does Not Display IP Address................................... 5-9 5.5.6 Limitation on Size of Checkpoint File Records................................... 5-9 5.5.7 PAGEDYN Resources: Clerks and Servers..... 5-10 5.5.8 Error Message Generated by DECdns Clerk During Startup............................ 5-11 5.5.9 Miscellaneous DECdns Operational Notes.... 5-11 vi 5.6 Distributed Time Service (DECdts)............. 5-12 5.6.1 Automatic Time Zone Changes on Rebooting Clusters.................................. 5-12 5.7 OSAK Programming.............................. 5-12 5.7.1 User Data Size Restriction for Tracing.... 5-12 5.7.2 OSAK Version 1.1 No Longer Supplied....... 5-12 5.7.3 Migrating Applications from Version 2.0 to Version 3.0 OSAK API Interface............ 5-12 5.7.4 Misleading OSAK Error Message: SPM Congestion at Connect Time................ 5-13 5.8 DECnet Programming............................ 5-14 5.8.1 64-Bit Virtual Address Restrictions....... 5-14 5.8.2 Backtranslation of IP Addresses........... 5-14 5.8.3 Applications Connection Requirement....... 5-14 Tables 4-1 Documentation Update/Release Notes Cross-Reference........................... 4-3 4-2 CSMA-CD Devices........................... 4-7 4-3 FDDI Devices.............................. 4-10 4-4 Synchronous Devices (OpenVMS VAX and Alpha Only)..................................... 4-11 4-5 Asynchronous Devices (OpenVMS VAX Only)... 4-13 vii _________________________________________________________________ Preface Intended Audience This manual is intended for all HP DECnet-Plus for OpenVMS Version 8.4 software users. Read this manual before you install, upgrade, or use DECnet-Plus for OpenVMS. Structure of This Book This manual contains the following chapters: o Chapter 1 contains installation notes for this release. o Chapter 2 describes new features not documented in the DECnet-Plus Version 8.4/8.3-1H1/8.3/8.2-1/8.2/7.1 documentation set. o Chapter 3 lists corrections included in this release. o Chapter 4 contains documentation errata and additions. o Chapter 5 discusses operational notes, restrictions, and known problems with the current release. This manual contains release notes introduced in the current release and notes from previous DECnet-Plus versions that still apply to the new release. For a list of additional documents available that support this version of the DECnet-Plus for OpenVMS software, see the DECnet-Plus for OpenVMS Introduction and User's Guide. vii Reader's Comments HP welcomes your comments on this manual or any of the DECnet-Plus documents. Please send comments to openvmsdoc@hp.com How To Order Additional Documentation For information about how to order additional documentation and for online versions of most DECnet-Plus documentation, visit the following World Wide Web address: http://www.hp.com/go/openvms/doc/ Conventions The following conventions are used in this book. ___________________________________________________________ Convention_______Meaning___________________________________ special type Indicates a literal example of system output or user input. In text, indicates command names, keywords, node names, file names, directories, utilities, and tools. You can abbreviate command keywords to the smallest number of characters that OpenVMS, NCL, DECdns, DECdts and the other utilities accept, usually three characters. UPPERCASE Indicates keywords that you enter. You can type the characters in uppercase or lowercase. You can abbreviate command keywords to the smallest number of characters that OpenVMS, NCL, DECdns, DECdts, or the other utilities accept, usually three characters. Uppercase also indicates the names of files, directories, utilities, tools, commands, parameters, and procedures. italic type Indicates a variable. bold Indicates a new term defined in the text or important information. viii ___________________________________________________________ Convention_______Meaning___________________________________ Indicates that you press the Return key. Indicates that you press the Control key while you press the key noted by c. [YES] Brackets indicate that the enclosed item is a default value in an installation prompt. { } In command format descriptions, indicates you must enter at least one listed element. $________________Represents_the_OpenVMS_DCL_system_prompt._ ix 1 _________________________________________________________________ Installation This chapter discusses installation information not found in the current documentation set. 1.1 Features Not Supported in This Release X.25 synchronous data links are NOT supported by HP DECnet- Plus for OpenVMS Version 8.4 for OpenVMS Integrity server systems. They ARE supported by HP DECnet-Plus for OpenVMS Version 8.3 for OpenVMS Alpha systems. 1.2 License Requirements 1.2.1 License Requirements for OpenVMS Integrity Servers HP DECnet-Plus for OpenVMS Version 8.4 for Integrity server systems requires the Base Operating Environment (BOE) license. This license includes the basic function license (DVNETEND). If you intend to configure your system as a DNS server or use host-based routing, you must obtain a separate DVNETEXT license. _______________________ Warning _______________________ If you install the software without the DVNETEXT license and then attempt to configure your system as a DNS server, the DNS server will fail and the configuration utility (NET$CONFIGURE) will exit. ______________________________________________________ Installation 1-1 Installation 1.2 License Requirements 1.2.2 License Requirements for OpenVMS Alpha Systems HP DECnet-Plus for OpenVMS Version 8.4 for Alpha systems requires one of two licenses: the basic function license (DVNETEND) or the extended function license (DVNETEXT). If you intend to configure your system as a DNS server, you must use the DVNETEXT license. _______________________ Warning _______________________ If you install the software without the DVNETEXT license and then attempt to configure your system as a DNS server, the DNS server will fail and the configuration utility (NET$CONFIGURE) will exit. ______________________________________________________ __ Warning for Installations over DECnet-Plus V7.3-1 __ When DECdns server support for Alpha systems was added to DECnet-Plus in Version 7.3-1, the DECdns software mistakenly verified the VAX extended function license (DVNETRTG) instead of the Alpha extended function license. This error has been corrected. If you have a DECnet-Plus V7.3-1 system currently configured as a DECdns server, do not install this software until you obtain and install the DVNETEXT license. If you fail to install the DVNETEXT license, your DECdns server will not start. ______________________________________________________ 1.3 OpenVMS Software Version Requirement HP DECnet-Plus for OpenVMS Version 8.4 for OpenVMS Integrity servers requires Version 8.4 of the OpenVMS Integrity servers operating system. HP DECnet-Plus for OpenVMS Version 8.4 for OpenVMS Alpha requires Version 8.4 of the OpenVMS Alpha operating system. ________________________ Note ________________________ DECnet Phase IV and DECnet-Plus cannot be installed on the same system. They are mutually exclusive. If 1-2 Installation Installation 1.3 OpenVMS Software Version Requirement either of the DECnet product is present on the system, uninstall the product before installing the other. ______________________________________________________ 1.4 Other Software Version Requirements If your network includes X.25 connectivity, HP DECnet- Plus for OpenVMS Version 8.4 requires Version 2.0 of the X.25 for OpenVMS product. See the HP DECnet-Plus for OpenVMS Installation and Configuration manual for important information about when to install this software during the DECnet-Plus installation and configuration process. ______________________ Important ______________________ Version 2.0 of the X.25 for OpenVMS product does not support synchronous devices on OpenVMS Integrity server systems at this time. Therefore, synchronous X.25 data links are not supported by HP DECnet-Plus for OpenVMS Version 8.4 on OpenVMS Integrity server systems. ______________________________________________________ If your network includes TCP/IP connectivity and you plan to enable OSI over TCP/IP or DECnet over TCP/IP, HP DECnet- Plus for OpenVMS Version 8.4 requires the latest version of the HP TCP/IP Services supported by the Operating System. 1.5 Installing the New Release Install this kit using the POLYCENTER Software Installation utility (PCSI) by logging into the SYSTEM account. The following example is for the OpenVMS Integrity servers platform. Entering the following command at the DCL prompt (for OpenVMS Alpha systems, use DECnet_OSI instead of DECNET_ PLUS): $ PRODUCT INSTALL DECNET_PLUS/SOURCE=file-location Installation 1-3 Installation 1.5 Installing the New Release For the new software to take effect, you must reboot the system. If the system is a member of a VMS cluster, you must reboot the entire cluster. ________________________ Note ________________________ This kit contains a correction to the CDI$SHR executable (see CDI$SHR.EXE in the Corrections section). To ensure that this correction takes effect on a previously configured system, use the following command to clear the CDI cache after you install the kit: $ MCR NCL FLUSH SESSION CONTROL NAMING CACHE ENTRY "*" ______________________________________________________ 1.6 AUTOGEN Errors During Installation (OpenVMS Alpha Only) The PCSI installation process now calls AUTOGEN near the end of the installation (with the parameters GETDATA, SETPARAMS, and CHECK_FEEDBACK). If AUTOGEN returns any error indication, the PCSI installation process displays the following informational text: %PCSI-I-PRCOUTPUT, output from subprocess follows ... %AUTOGEN-W-REPORT, please read AUTOGEN warnings in SYS$SYSTEM:AGEN$PARAMS.REPORT The AUTOGEN report may contain messages similar to the following: ** INFORMATIONAL ** - Removing CLU$PARAMS definition made by unknown product _UNKNOWN_$ADD_GBLPAGES = 55000 !Set by (unknown) This message is related to the fact that previous versions of DECnet-Plus were incorrectly using the NEWPARAMS.DAT/CLU$PARAMS.DAT method to pass system parameter information to AUTOGEN. In previous versions, DECnet-Plus did not label its data in the NEWPARAMS.DAT file. The preceding message indicates that AUTOGEN has found an unlabeled system parameter in the existing CLU$PARAMS.DAT file and is removing it. If the system parameter was set by DECnet-Plus, the newly-created NEWPARAMS.DAT file contains the current system parameter requirements and these will be automatically included in 1-4 Installation Installation 1.6 AUTOGEN Errors During Installation (OpenVMS Alpha Only) CLU$PARAMS.DAT. Therefore, you can safely ignore these messages. Installation 1-5 2 _________________________________________________________________ New Features and Enhancements This chapter describes new functionality or enhancements provided by HP DECnet-Plus for OpenVMS. This section includes new functionality implemented in Versions 8.4, 8.3-1H1, 8.3, 8.2-1, 8.2, 7.3-2, 7.3-1, 7.3, 7.2-1, 7.2, and 7.1 which was not documented in the Version 8.2/Version 7.1 documentation set. 2.1 Network Management This section describes new network management features. 2.1.1 DECnet/IP Communication Through SSH The following improvement has been made to NET$DRIVER.EXE, NET$OSDRIVER.EXE, NET$SESSION_CONTROL.EXE, NET$TRANSPORT_ OSI.EXE, and NET$TPCONS.EXE images: This release of DECnet-Plus uses the port forwarding feature of Secure Shell (SSH). This enables you to transmit DECnet/IP data over a secure channel, thus providing data security. The DECnet transmitter side requires modification to support this feature; however the receiver side does not require any change. This feature can be used Processwide or Systemwide by defining the logical with the /PROCESS or /SYSTEM qualifiers. A new process or systemwide logical, DECNET_IP_PORT_FORWARD is introduced to provide the SSH functionality. The logical value should be unique and the port must be unused. The logical value must be same as that of the local port used to establish the secure channel. After setting the processwide logical in a particular process context, all DECnet/IP connections initiated by this process is secure. If the systemwide logical is defined, all the DECnet/IP connections initiated by this system is secured. New Features and Enhancements 2-1 New Features and Enhancements 2.1 Network Management Prerequisites: SSH client must be running on the local host and SSH server must be running on the remote host. ________________________ Note ________________________ For SSH related queries and support, contact the TCP/IP SSH Engineering team. ______________________________________________________ To enable the port forwarding feature of SSH, perform the following steps: 1. To establish a secure channel between a client and the server, execute the following SSH command Host1$ SSH -"L"port:host:hostport remotehost Where: -L is the local port forwarding. port is the local port on the client (local) system. The port value must be between 1 and 65535. host is the server system. hostport is the server's port. remotehost is the remote system's IP address or name. This command prompts you for the system password of the remotehost (Host2). 2. Enter the system password and an output similar to the following is displayed: system's password: Authentication successful. Welcome to HP OpenVMS Industry Standard 64 Operating System, Version V8.4 3. Define the processwide or systemwide logical, DECNET_IP_ PORT_FORWARD with the logical value. This logical value is same as that of the "Port" specified in Step 1. ________________________ Note ________________________ In a particular process context, if both the processwide and systemwide logicals are defined, the processwide logical gets the preference. ______________________________________________________ 2-2 New Features and Enhancements New Features and Enhancements 2.1 Network Management 4. Execute the DECnet/IP commands such as directory, set host, and copy from the terminal on Host1 on which the logical is defined using the following syntax: SET HOST LOCALHOST The localhost is used instead of the IP address. Using localhost and port, an SSH channel is established between the transmitter and receiver system. 5. Deassign the logical after completing the task by executing the following command: Host1$ DEASSIGN/PROCESS DECNET_IP_PORT_FORWARD OR Host1$ DEASSIGN/SYSTEM DECNET_IP_PORT_FORWARD If the logical is not deassigned, all the connections still uses SSH. Following is an example of how this implementation can be used: In this example, the following names and numbers are used: DECnet name: Host1 IP Number: 18.138.72.14 DECnet name: Host2 IP Number: 18.138.185.56 1. Set up a secure connection between local host (Host1) and remote host Host 2 using the following command: Host1$ssh "-L" 512:localhost:399 18.138.185.56 system's password: Authentication successful. Welcome to OpenVMS (TM) on Host2 Host2$ Where: 18.138.185.56 is the system IP address of the remotehost(Host2) to which you are transmitting data using the local port 512. 2. From a different terminal on the local host with a user login, a process or systemwide logical must be defined to use the DECnet/IP over SSH: Host1$ DEFINE/PROCESS DECNET_IP_PORT_FORWARD 512 OR Host1$ DEFINE/SYSTEM DECNET_IP_PORT_FORWARD 512 New Features and Enhancements 2-3 New Features and Enhancements 2.1 Network Management Where; 512 is the logical value, which is same as that of the "Port" specified in Step 1. 3. Execute a DECnet/IP command, such as SET HOST or COPY or DIRECTORY from the local host to remote host: Host1$ DIRECTORY localhost"system welcome123"::sys$sysdevice:[000000] An output of the DIRECTORY command from the 18.138.185.56 system is displayed. 4. After the communication is completed, you can deassign the logicals as follows, depending on whether a processwide or systemwide logical had been defined: Host1$ DEASSIGN/PROCESS DECNET_IP_PORT_FORWARD OR Host1$ DEASSIGN/SYSTEM DECNET_IP_PORT_FORWARD 2.1.2 DECnet-Plus Support for Mixed Case Password The following improvements have been made to the NET$OSVCM.EXE and NET$SESSION_CONTROL.EXE images: o OpenVMS version 7.3-2 and above allows you to use mixed- case and extended characters in passwords when PWDMIX is specified as login flags. DECnet has two different methods for user authentication. This is controlled by the sysgen parameter, NET_CALLOUT. If this parameter is set to 255, then the verification and proxy lookups are performed in LOGINOUT rather than DECnet. In earlier versions of DECnet, when DECnet performed the user verification there were restrictions on using mixed-case and extended characters in passwords. This version of DECnet supports mixed-case password for task to task communication and remote file access. 2-4 New Features and Enhancements New Features and Enhancements 2.1 Network Management 2.1.3 NET$CONFIGURE Improvements The following changes have been made to NET$CONFIGURE.COM: o This release adds support for listening to selected interfaces for incoming DECnet over IP connections. DECnet-Plus, by default, would listen to inbound DECnet over IP connections on all IP-configured interfaces. With this new feature, you can select the interfaces on which DECnet over IP listens to the incoming connections. For example, if the system has five IP- configured interfaces and you want DECnet over IP to listen on only three interfaces, you can provide the list of IP addresses for those required interfaces. To configure the system to listen to selective IP- configured interfaces using the ADVANCED configuration of DECnet-Plus: o Type "ALL" if all the connections are required or o Type comma separated list of the required IP addresses for the following question: * Interface(s) for DECnet/OSI over TCP/IP ? [ALL] : Also, refer to Section 2.1.3.1 for the new NCL commands. o The NET$CONFIGURE.COM procedure now informs you of the existence of the ISIS$CONFIGURE.COM procedure. You can use this procedure to configure a routing node that uses the link state routing protocol. Previously, there was no support for configuring a routing node using the link state routing protocol. For more information about using the ISIS$CONFIGURE.COM procedure, see the new appendix about configuring link state routing in the HP DECnet-Plus for OpenVMS Installation and Configuration manual. 2.1.4 NCL Updates This section describes new features found in NCL. New Features and Enhancements 2-5 New Features and Enhancements 2.1 Network Management 2.1.4.1 Added information about Configuring the system to listen to DECnet/IP connections The following commands have been added to reflect the new feature described in Section 2.1.2 for V8.3 $MC NCL SET OSI TRANSPORT RFC1006 LISTENER IPADDRESSES {a.b.c.d, w.x.y.z} $MC NCL ADD OSI TRANSPORT RFC1006 LISTENER IPADDRESSES {a.b.c.d, w.x.y.z} $MC NCL REMOVE OSI TRANSPORT RFC1006 LISTENER IPADDRESSES {a.b.c.d, w.x.y.z} $MC NCL SHOW OSI TRANSPORT RFC1006 LISTENER IPADDRESSES These commands will enable or disable DECnet-Plus to listen to inbound DECnet over IP connections on interfaces having local node IP addresses specified. However, these commands do not support DECnet-Plus to listen to remote node IP addresses. This is applicable for both RFC 1006 and RFC 1859. ________________________ Note ________________________ In this release, these commands are used to set/show/add/remove the OSI transport attributes on a local node only, but these commands cannot be used for a remote node. ______________________________________________________ 2.1.5 NCL HELP Updates Since Version 7.1, several changes have been made to NCL HELP. These changes represent new material about new functionality, new material about existing functionality, and corrections to existing material. The sections that follow describe help changes where some of the material discussed in the HELP updates is not present in the current documentation set or in these Release Notes. 2-6 New Features and Enhancements New Features and Enhancements 2.1 Network Management 2.1.5.1 Added New Material about Backtranslations and Towers Added significant explanatory material about managing backtranslation softlink and tower maintenance entities to the help text for the following commands: DELETE SESSION_CONTROL BACKTRANSLATION SOFTLINK SHOW SESSION_CONTROL BACKTRANSLATION SOFTLINK UPDATE SESSION_ CONTROL BACKTRANSLATION SOFTLINK UPDATE SESSION_CONTROL TOWER MAINTENANCE For more information, see the help text (of particular interest is the help text for the two update commands). 2.1.5.2 Added Information about Support for IP Towers Added a description of an IP tower to the NCL_Introduction -> Syntax -> Data_Types -> TowerSet topic. Added IP examples to the help text for commands used to manage session control backtranslation softlink and session control tower maintenance entities (see also Section 2.1.5.1). Added an example of registering an IP tower using the decnet_register node registration tool to the Network_ Management -> Tools -> Decnet_Register topic. 2.1.5.3 Added Help for register and modify decnet_register Commands Added new material about the modify and register commands used to set the session control version. For more information about why these command examples may be useful, see the help text. 2.1.5.4 Added Information about Flushing the CDI Cache Added material to the help text for the Flush_(OpenVMS) topic. This topic discusses flushing an entry from the Session Control Naming Cache (known as the CDI cache). Also added an example of flushing an IP cache entry. New Features and Enhancements 2-7 New Features and Enhancements 2.1 Network Management 2.1.5.5 Modified Description of the Session Control Naming Search Path Characteristic Modified the description of the naming search path characteristic in the help text for the show session control command to reflect relaxed restrictions in both the content of and the order of the naming search path for DECdns servers. For more information about this topic, see Chapter 7 of the HP DECnet-Plus for OpenVMS Installation and Configuration manual (in particular, the section entitled "Using the DECdns Namespace as Secondary on a DECdns Server.") 2.1.5.6 Directory System Agent (DSA) Entity Help Updated Replaced the Directory_Module help topic with new help information for the HP OpenVMS Enterprise Directory product (HP's implementation of the ITU-T X.500 Recommendations for OpenVMS). 2.1.5.7 Added DNS/BIND Namespace Examples for LOOP Help Added DNS/BIND namespace examples to the help for the loop loopback application command. For example, the example section now includes the following DNS/BIND example: loop loopback application name DOMAIN:LAMCHP.SCH.DEC.COM 2.1.5.8 Updated Help for FDDI Station Link Event Reporting Updated the Event_Messages -> FDDI_Station -> Link topic to reflect restrictions in FDDI Station Link event reporting which are imposed by the OpenVMS device drivers. The following events are not logged, but their respective counters are incremented when these events occur: block check error directed beacon received duplicate address test failure duplicate token detected fci strip error frame status error link buffer unavailable pdu length error receive data overrun ring beacon initiated ring purge error trace initiated 2-8 New Features and Enhancements New Features and Enhancements 2.1 Network Management transmit failure transmit underrun The "unrecognized individual pdu destination", "unrecognized multicast pdu destination", and "user buffer unavailable" events can be reported, and their respective counters can increase accordingly. However, DECnet blocks "unrecognized multicast pdu destination" by default. Refer to the SYS$MANAGER:NET$EVENT_LOCAL.TEMPLATE file if you wish to pass this event. The "ring initialization initiated" and "ring initialization received" events are now logged by certain OpenVMS device drivers. If an OpenVMS device driver supports these events, they are not logged on a one-to- one basis with increases in their corresponding counters. Instead, only one error report is issued for any number of these events that occur within a sampling period. This is intended to decrease any possibility of flooding OPCOM. 2.2 New Devices Supported by MOP Modified NET$NISCS_LAA.EXE to recognize new style device names returned by $GETDVI. This permits loads over SCSI PAC devices. Prior to this release, the satellite load failed with the following messages displayed at the satellite: %VMScluster-I-MSCPCONN, Connected to a MSCP server for the system disk, node nnnnnn %VMScluster-E-NOT_SERVED, Configuration change, the system disk is no longer served by node nnnnnn 2.3 DECnet-Plus and DECnet Phase IV support VLAN The following improvements have been made to the NET$CONFIGURE.COM and NET$CONVERT_DATABASE.EXE: o DECnet-Plus and DECnet phase IV can be configured to run over VLAN. New Features and Enhancements 2-9 New Features and Enhancements 2.4 Transport Improvements 2.4 Transport Improvements The following improvements have been made to NET$TPCONS.EXE and NET$TRANSPORT_OSI.EXE: o This release adds support for listening to selected interfaces for incoming DECnet over IP connections. For more information, see Section 2.1.2 for V8.3 and Section 2.1.3.1. o The DECnet-Plus interface has been redesigned to allow independent restarts between the DECnet OSI Transport module and the HP TCP/IP Services for OpenVMS product. Previously, the entire system had to be rebooted if the TCP/IP PATHWORKS Internet Protocol (PWIP) interface was restarted. Now, if the TCP/IP PWIP interface is disabled and then reenabled, DECnet-Plus starts new transport connections. Similarly, if the DECnet OSI Transport module is disabled and then reenabled, the TCP/IP PWIP interface receives new DECnet transport connections through the new TPCONS ports. 2.5 Host-Based Routing Improvements This release supports the configuration of host-based routers that use the link state routing algorithm. The NET$CONFIGURE procedure always creates routers that use the routing vector algorithm. However, a new command procedure (ISIS$CONFIGURE.COM) can be used to modify the router configuration to use the link state routing algorithm. This procedure also allows more control of the routing configuration than is found in NET$CONFIGURE.COM. For more information, see the "Host-Based Routing" section in Chapter 8 of the HP DECnet-Plus for OpenVMS Network Management manual and the new ISIS$CONFIGURE appendix in the HP DECnet-Plus for OpenVMS Installation and Configuration manual. This release of the NET$ROUTING_IS.EXE module contains the following improvements: o Raised the maximum allowed routing circuits from 16 to 32. 2-10 New Features and Enhancements New Features and Enhancements 2.5 Host-Based Routing Improvements o Modified logic used to set maximum circuit segment size for FDDI circuits. Previously, the calculation could sometimes use the Phase IV default of 576. This has been changed to always use the FDDI default of 4352. 2.6 Session Control Improvements This release of the NET$SESSION_CONTROL.EXE module contains the following improvement: o On Integrity servers and Alpha systems, the NET$SESSION_ CONTROL.EXE module now uses the name string from the PSB instead of GETJPI. New Features and Enhancements 2-11 New Features and Enhancements 2.7 Distributed Naming Service (DECdns) 2.7 Distributed Naming Service (DECdns) The following sections describe new features of DECdns. 2.7.1 DECdns Now Supports Dynamic Device Recognition The static device tables formerly used to determine the devices used by DECdns have been removed. Now, DECdns uses the $DEVSCAN and $GETDVI system services to build a list of devices that have the following characteristics: o a device class of DC$SCOM (synchronous communication device) o a device characteristic of DEV$V_NET o a device status of UCB$V_ONLINE and UCB$V_TEMPLATE o a device name in the form _xxy0: You can use the logical name DNS$ETHERNET_DEVICE to provide a list of devices that DECdns should NOT use. All devices must be in the form _xxy0:. The string can contain spaces and other text which is ignored by DTSS. For example, the following command tells DECdns not to use the _EIA0: and _FWA0: devices. $ DEFINE/SYSTEM DNS$ETHERNET_DEVICE "Don't use _EIA0: and _FWA0: " ________________________ Note ________________________ Unterminated network adapters can cause the dynamic device recognition process to hang. Either terminate all network adapters or include any unterminated devices in the DNS$ETHERNET_DEVICE logical definition. ______________________________________________________ 2.7.2 DECdns Now Supports DECnet over TCP/IP Links DECdns has been enhanced to support the DECnet over TCP/IP transport. The sections that follow discuss various topics related to this new feature. For more information, see the HP DECnet-Plus for OpenVMS DECdns Management manual. 2-12 New Features and Enhancements New Features and Enhancements 2.7 Distributed Naming Service (DECdns) 2.7.2.1 Protocol Towers The DNA$Towers attribute of the object entry for a Phase V node can now include a protocol tower with an IP address. The third tower in the following example is an IP protocol tower. DNS>show obj .xpr.wzbang dna$towers SHOW OBJECT WINTER:.xpr.wzbang AT 09-MAR-2004:14:55:02 DNA$Towers (set) = : Tower 1 Floor 1 = 01 13 (null) Tower 1 Floor 2 = 03 00 13 Tower 1 Floor 3 = 04 (null) Tower 1 Floor 4 = 06 49 00 18 aa 00 04 00 2a 60 20 DNA$Towers (set) = : Tower 2 Floor 1 = 01 13 (null) Tower 2 Floor 2 = 03 00 13 Tower 2 Floor 3 = 05 de c0 Tower 2 Floor 4 = 06 49 00 18 aa 00 04 00 2a 60 21 DNA$Towers (set) = : Tower 3 Floor 1 = 01 13 (null) Tower 3 Floor 2 = 02 00 13 Tower 3 Floor 3 = 05 de c0 Tower 3 Floor 4 = 09 a1 72 5e 45 DNS> 2.7.3 decnet_register Now Supports IP Towers in the DECdns Namespace Normally, the IP towers and IP backtranslation softlinks for all nodes are now automatically updated in the DECdns namespace during regular tower and softlink maintenance operations. Occasionally, it may be necessary to perform manual updates or to verify that the current information is correct. For this reason, the decnet_register tool has been enhanced to show and register IP towers and backtranslation softlinks for nodes within the DECdns namespace. The following example illustrates how to use menu Option 1 to display information about the node WINTER:.XPR.CASE: New Features and Enhancements 2-13 New Features and Enhancements 2.7 Distributed Naming Service (DECdns) $ run decnet_register DECNET_REGISTER - Manage node registrations in network directory services Use Return, CTRL/N, and CTRL/P to move between input fields Use "?" to obtain help, CTRL/Z to cancel 1 - Show information about registered node names 2 - Register or modify node names 3 - Update registered node towers using information from the nodes 4 - Rename a registered node name 5 - Repair the synonym and address links for registered node names 6 - Deregister node names 7 - Export node names to a data file 8 - Import node names from a data file 9 - Set preferences and network values 10 - Manage the directory service 11 - Spawn to DCL * Option (use CTRL/Z to exit): 1 Show registered node information Use Return, CTRL/N, and CTRL/P to move between input fields Use "?" to obtain help, CTRL/Z to cancel Specify the directory service as LocalFile, DECdns, or PhaseIV. * Directory service: DECdns Specify the node to show using an explicit or wildcard name, an NSAP, or a Phase IV synonym or address. * Node name or address: WINTER:.XPR.CASE Specify the information to display as either brief, full, or names. Specify the output file name (a blank line indicates the terminal). * Display format: full * Output file: Press Return to show the node values, CTRL/Z to cancel 2-14 New Features and Enhancements New Features and Enhancements 2.7 Distributed Naming Service (DECdns) Directory Service: DECdns Node name: WINTER:.XPR.CASE Phase IV synonym: CASE Address tower protocol and selector values: Session: DNA_SessionControlV3 (SC3) 00 13 Transport: DNA_OSItransportV1 (TP4) DE C0 Routing: DNA_OSInetwork (CLNS) 49::00-18:AA-00-04-00-24-60:21 (24.36) Session: DNA_SessionControlV3 (SC3) 00 13 Transport: DNA_NSP (NSP) (no selector value) Routing: DNA_OSInetwork (CLNS) 49::00-18:AA-00-04-00-24-60:20 (24.36) Session: DNA_SessionControlV2 (SC2) 00 13 Transport: DNA_OSItransportV1 (TP2 or TP0) DE C0 Routing: DNA_IP (IP) 161.114.94.62 Synonym softlink name: WINTER:.DNA_NodeSynonym.CASE Reverse address mapping (backtranslation) softlink names: WINTER:.DNA_BackTranslation.%X49.%X0018.%XAA0004002460 WINTER:.DNA_BackTranslation.%XA1725E3E Number of nodes reported on: 1 2.8 Distributed Time Service (DECdts) The following sections describe new features of DECdts. New Features and Enhancements 2-15 New Features and Enhancements 2.8 Distributed Time Service (DECdts) 2.8.1 DECdts Now Supports Dynamic Device Recognition The static device tables formerly used to determine the devices used by DECdts have been removed. Now, DECdts uses the $DEVSCAN and $GETDVI system services to build a list of devices that have the following characteristics: o a device class of DC$SCOM (synchronous communication device) o a device characteristic of DEV$V_NET o a device status of UCB$V_ONLINE and UCB$V_TEMPLATE o a device name in the form _xxy0: You can use the logical name DTSS$ETHERNET_DEVICE to provide a list of devices that DECdts should NOT use. All devices must be in the form _xxy0:. The string can contain spaces and other text which is ignored by DTSS. For example, the following command tells DECdts not to use the _EIA0: and _FWA0: devices. $ DEFINE/SYSTEM DTSS$ETHERNET_DEVICE "Don't use _EIA0: and _FWA0: " ________________________ Note ________________________ Unterminated network adapters can cause the dynamic device recognition process to hang. Either terminate all network adapters or include any unterminated devices in the DTSS$ETHERNET_DEVICE logical definition. ______________________________________________________ 2.8.2 DECdts Now Supports DECnet over TCP/IP Links DECdts now supports operation in the DECnet over TCP/IP environment without requiring the use of a configuration file. This requires the use of the DECdns version that supports DECnet over TCP/IP. From the management standpoint, global DECdts servers work much the same as they do in the DECnet-only environment. You still use the advertise command to add a global server to the global set. For more information, see the HP DECnet-Plus for OpenVMS DECdts Management manual. 2-16 New Features and Enhancements 3 _________________________________________________________________ Corrections Included in this Release This chapter discusses corrections included in HP DECnet- Plus for OpenVMS Version 8.4. The chapter contains an abbreviated list of the updates included in this release. If a specific update you are looking for is not listed, this does not mean that it is not included in this release. For further information on specific updates, contact your HP support representative. 3.1 DNS$ADVER.EXE The following correction has been made to DNS$ADVER.EXE: o This release fixes the DECnet hang during start-up when the DNS$ADVER process is in the RWAST state. This happens when the PQL_MBYTLM/BUFFER_LIMIT parameter is set to a high value or when the number of network interfaces are more than 10. In addition to the messages that are logged in DNS$ADVER_ERROR.LOG logfile, a message will be logged on the operator console when the DNS$ADVER process is unable to start its protocol on any of the ethernet interfaces. 3.2 DTSS Changes The following correction has been made to the DTSS$SERVICE image: o This fix prevents the access violation error found during DTSS server startup with global server configured. Corrections Included in this Release 3-1 Corrections Included in this Release 3.3 Network Management Changes 3.3 Network Management Changes The following corrections are made to the network layer. o This release fixes the INVEXCEPTION crash in the routing layer caused because of accessing the corrupted end system cache database. When the $ MC NCL DISABLE ROUTING command is executed, apart from disabling the routing entity it clears the base address of the end system cache table while processing the incoming data PDU. o This release fixes the BADQHDR crash while trying to resume the network task, which is the "SUSPENDED QUEUE" task at the session layer. Failure to acquire the secondary interlock on the header of the suspended queue at the session layer causes the system to crash. 3.3.1 End System Routing The following correction has been made to the NET$ROUTING_ ES.EXE image: o This release fixes some of the alignment faults in NET$ROUTING by aligning the unaligned variables found during DTSEND tests. The following correction has been made to NET$ROUTING_ ES.EXE and NET$ALIAS.EXE images: o This fix sets the ES hello packet with a holding time of zero so as to clear the adjacencies immediately when the "SHUT ALIAS port" command is used. The following correction has been made to NET$ROUTING_ VCM.EXE and SYS$NAME_SERVICES.EXE images: o This release fixes the alignment faults observed in SYS$NAME_SERVICES and NET$ROUTING_VCM on Integrity server systems. The following correction has been made to the NET$ROUTING_ IS.EXE image: o This release fixes the system crash while creating a new manual adjacency with the same Adjacency name, LAN address, and ENDnode id on two different CSMA-CD circuits. 3-2 Corrections Included in this Release Corrections Included in this Release 3.3 Network Management Changes 3.3.2 NET$CONFIGURE Command Procedure The following corrections have been made to the NET$CONFIGURE.COM command procedure: o This fix validates the IP address and prompts until a valid IP address is entered for the "Interface(s) for DECnet/OSI over TCP/IP" option while running NET$CONFIGURE in an advanced mode. o This release enables SYS$NODE* logicals to be read from the NET$CONFIG.DAT file with the correct set of privileges on an Integrity server satellite node. The following warning message is no longer displayed while booting the satellite system: %DECnet-W-NOOPEN, could not open SYS$SYSROOT:[SYSEXE]NET$CONFIG.DAT 3.3.3 NET$STARTUP Command Procedure The following correction has been made to the NET$STARTUP.COM command procedure: o The default protection of the OSIT$NAMES logical name table has been modified such that only the privileged user, such as SYSTEM will be able to modify the table. As described in Section 6.4.6.1 of DECnet-Plus for OpenVMS Programming Manual, the SYSNAM privilege to define a logical name in OSIT$NAMES is not applicable. 3.3.4 NCL$GLOBALSECTION.DAT The following change has been made to NCL$GLOBALSECTION.DAT: o In this release, the naming format of "rfc1006 Duplicate Connection" is changed to "RFC1006 Duplicate Connection". The following commands enable OSITP to accept the RFC1006 CLASS-0 duplicate connections without affecting the original connections: $ mc ncl show osi transport RFC1006 Duplicate Connection $ mc ncl set osi transport RFC1006 Duplicate Connection = TRUE or FALSE Corrections Included in this Release 3-3 Corrections Included in this Release 3.4 OSAK Changes 3.4 OSAK Changes The following corrections have been made to the OSAK$OSAKSHR.EXE image: o This release fixes the problem of OSAK ports not being closed properly even when the Directory System Agent (DSA) timer is set to 300. As a result, the DSA-server would hang. o This fix avoids an access violation in OSAK$OSAKSHR.EXE when the OSAK library function, osak_close_port tries to access a memory that is already freed-up. o When the OSI Transport connection is already established, remote NSAP address is not populated if a disruptive event occurs. This problem is fixed. 3.5 Session Control The following corrections have been made to the NET$SESSION_CONTROL.EXE image: o This release suppresses the display of the Failure on the back translate address request message when a node is connected to another node using the SET HOST command. This happens when: - A node with fullnodename, that is, with the first octet (from left side) with greater than 8 alpha numeric characters and without the alias in the TCP/IP local host database. OR - A node is registered in the DECnet local database without a synonym. o This releases fixes the crash in Session layer while processing an Expedited data event, which came from Transport layer for a non-existent Session port. 3-4 Corrections Included in this Release Corrections Included in this Release 3.6 Transport Layer 3.6 Transport Layer The following corrections have been made to the NET$TRANSPORT_OSI.EXE image: o When there is a duplicate CONS connection at the OSI transport, with the same source reference, this release is fixed to reject the new connection without affecting the existing connection. o This release fixes the INVEXCEPTION crash in the OSITP port management routine while trying to access an already deallocated network connection control block (NCCB). o This release fixes the INVEXCEPTION crash in OSITP$CLNS_ CLOSEASSOCIATION because of an invalid VCRP address passed to this routine. The system crash occurs while trying to access this invalid virtual address. o This release fixes the system crash with NAT Consumption fault error in the NET$OSI_TRANSPORT module. This fix is applicable only on Integrity server systems. o This release fixes the leaking BG devices which is caused when an illegal packet is received and when the transport connection between the TPCONS and the OSI layer is not yet opened. The following change has been made to CTF$OSITP_ANALYZE.EXE and NET$TRANSPORT_OSI.EXE: o This release is enhanced to display the Local and Remote Transport Selector (Tsel) information as part of the Remote Transport Disconnect OPCOM Event and Local Transport OPCOM Event on both Integrity servers and Alpha systems. This will help you to debug or trace the faulty applications. The following corrections have been made to the NET$TRANSPORT_NSP.EXE image: o This release enhances the performance between DECnet Alpha Phase IV and DECnet Integrity servers Phase V (DECnet-Plus) system by transmitting less number of data acknowledgements. The transmitter now processes less number of data acknowledgements while transferring data. Corrections Included in this Release 3-5 Corrections Included in this Release 3.6 Transport Layer o This release fixes the crash in NET$TRANSPORT_NSP caused because of the NAT consumption fault. 3-6 Corrections Included in this Release 4 _________________________________________________________________ Documentation Errata and Addenda This chapter contains corrections and additions to the current documentation set for HP DECnet-Plus for OpenVMS. 4.1 Current Product Documentation The current documentation set for DECnet-Plus is shown in the following list: o DECnet-Plus for OpenVMS Introduction and User's Guide Version 7.1 (Order number: AA-Q191F-TE) o DECnet-Plus Planning Guide Version 7.1 (Order number: AA-QBTHE-TE) o HP DECnet-Plus for OpenVMS Installation and Configuration Version 8.3 (Order number: BA406-90007) o HP DECnet-Plus for OpenVMS Network Management Version 8.2 (Order number: BA406-90006) o HP DECnet-Plus for OpenVMS Network Control Language Reference Version 8.2 (Order number: BA406-90004) o DECnet-Plus Problem Solving Version 7.1 (Order number: AA-Q18ZE-TE) o HP DECnet-Plus for OpenVMS DECdns Management Version 8.2/DECdns Version 2.0 (Order number: BA406-90002) Documentation Errata and Addenda 4-1 Documentation Errata and Addenda 4.1 Current Product Documentation o HP DECnet-Plus for OpenVMS DECdts Management Version 8.2/DECdts Version 2.0 (Order number: BA406-90003) o DECnet-Plus FTAM and Virtual Terminal Use and Management Version 7.1/FTAM Version 3.2 (Order number: AA-Q78TD-TE) o DECnet-Plus for OpenVMS Programming Version 7.1 (Order number: AA-Q195E-TE) o DECnet-Plus DECdts Programming Version 7.1/DECdts Version 1.1 (Order number: AA-PHEQC-TE) o DECnet-Plus OSAK Programming Version 7.1/OSAK Version 3.0 (Order number: AA-PJ1CE-TE) o DECnet-Plus OSAK Programming Reference Version 7.1/OSAK Version 3.0 (Order number: AA-PJ1DD-TE) o DECnet-Plus OSAK SPI Programming Reference Version 7.1/OSAK Version 3.0 (Order number: AA-QRAYB-TE) o DECnet-Plus FTAM Programming Version 7.1/FTAM Version 3.2 (Order number: AA-PJ1EF-TE) o DECnet/OSI for VMS CTF Use Version 5.5 (Order number: AA-PHEBB-TE) 4.2 Documentation Update for Version 8.2 Several manuals have been updated for HP DECnet-Plus for OpenVMS Version 8.2. See the list in Section 4.1 for the version numbers associated with each manual in the documentation set. Much of the updated material came from entries in the Release Notes for several previous versions of DECnet-Plus. Table 4-1 provides a cross-reference between former Release Note topics and their locations in the new manuals. The manual references are given in 4-2 Documentation Errata and Addenda Documentation Errata and Addenda 4.2 Documentation Update for Version 8.2 the form manual-chapter or appendix where manual is the following: INS - HP DECnet-Plus for OpenVMS Installation and Configuration MNG - HP DECnet-Plus for OpenVMS Network Management NCL - HP DECnet-Plus for OpenVMS Network Control Language Reference DNS - HP DECnet-Plus for OpenVMS DECdns Management DTS - HP DECnet-Plus for OpenVMS DECdts Management In many cases, the information in the Release Notes was interleaved with existing information. Therefore, references to specific sections in the new manuals is not feasible. Table 4-1 Documentation Update/Release Notes Cross- __________Reference________________________________________ Release_Note_Topic______________________Refer_to_..._______ New Features NET$CONFIGURE New option to configure DNS INS-7 servers DNS server node can have other INS-7 name service as primary Phase IV migration INS-6 improvements New Support for DNS/BIND as INS-6 Primary Name Service NET$STARTUP Procedure NET$STARTUP supports STARTUP_ MNG-8 P2 SYSGEN procedure NET$LOGICALS File New logicals MNG-6 NET$SHUTDOWN (continued on next page) Documentation Errata and Addenda 4-3 Documentation Errata and Addenda 4.2 Documentation Update for Version 8.2 Table 4-1 (Cont.) Documentation Update/Release Notes Cross- __________________Reference________________________________ Release_Note_Topic______________________Refer_to_..._______ New NET$APPLICATION_SHUTDOWN MNG-6, MNG-8 logical NCL Explanation of IP address NCL-1 backtranslations New management topics in NCL NCL-1 Help Improved explanation of access NCL-1 control Improved explanation of NCL-1 wildcard proxies New SHUT ALIAS PORT command NCL-3 Host Based Routing Routing Originating Queue NCL-21 Limit characteristic modified Session Control/CDI Cache CDI cache improvement MNG-5 CDI$SYSTEM_TABLE logical name MNG-5 table Resolution of IP fully- MNG-5 qualified names DECdns Establishing clerk connections INS-7 to WAN TCP/IP Servers New logicals for the DNS$ADVER DNS-12 process Controlling the LAN devices DNS-6 used by DECdts DECdts (continued on next page) 4-4 Documentation Errata and Addenda Documentation Errata and Addenda 4.2 Documentation Update for Version 8.2 Table 4-1 (Cont.) Documentation Update/Release Notes Cross- __________________Reference________________________________ Release_Note_Topic______________________Refer_to_..._______ New procedures for Changing INS-7[1] Time New DECdts NTP provider sample DTS-C program Designating Global Servers DTS-2 Using the BIND Database Option to Disable DECdts at DTS-2 System Boot Controlling the LAN devices DTS-2 used by DECdts OSAK OSAK new features moved to Documentation Errata chapter. Documentation Corrections NCL Syntax corrections NCL-(throughout command descriptions) Alias Port Outgoing Default NCL-3 characteristic added Routing Entity Maximum Buffers NCL-21 characteristic modified Removed restriction on NCL-20 modifying OSI Transport Cons Filters characteristic [1]See_also_the_"Setting_System_Time"_chapter_in_the_HP____ OpenVMS System Manager's Utility Guide, the "Creating Time Zone Conversion Information" in the "Overview" chapter of the Compaq C Run-Time Library Utilities Reference Manual, and the "Date/Time Functions" chapter and tzset function description in the HP C Run-Time Library Reference Manual for OpenVMS Systems manual. (continued on next page) Documentation Errata and Addenda 4-5 Documentation Errata and Addenda 4.2 Documentation Update for Version 8.2 Table 4-1 (Cont.) Documentation Update/Release Notes Cross- __________________Reference________________________________ Release_Note_Topic______________________Refer_to_..._______ Added material about using SET NCL-1 NCL DEFAULT commands Added material about using NCL NCL-1 SNAPSHOT command Network Management New DECNET_VERSION values MNG-3 Added material about using MNG-11, NCL-1 SNAPSHOT command Operational Notes Network Management Startup procedure changed: NCL MNG-6, MNG-8 information minimized decnet_register option 3 - MNG-5, MNG-E updating registered node towers DECdns Modifying a Clerk to use the DNS-6 Cluster Alias Providing adequate resources DNS-12 for DNS clerk Providing adequate resources DNS-12 for DNS server Using the DNS.CONF file DNS-12 Adjusting null_port_timeout in DNS-12 DNS.CONF file Note on using the NEW EPOCH DNS-11 command Default parameters for process DNS-12 limits on DNS servers Removing Obsolete DNS$CACHE DNS-12 ________files______________________________________________ 4-6 Documentation Errata and Addenda Documentation Errata and Addenda 4.3 Network Management and NCL 4.3 Network Management and NCL The following sections describe documentation errata and addenda for the HP DECnet-Plus for OpenVMS Network Management, HP DECnet-Plus for OpenVMS Network Control Language Reference, and DECnet-Plus Problem Solving manuals. 4.3.1 Devices and OpenVMS Device Names The sections that follow list the devices that can be configured using DECnet-Plus software. The last column lists the device name to use for the communication port characteristic when creating entities that reference these devices. ________________________ Note ________________________ DECnet-Plus supports a subset of the communication devices supported by OpenVMS. Some of the devices shown in these tables may be configurable (either by NET$CONFIGURE or directly by NCL) but are no longer supported by DECnet-Plus. See the Software Product Descriptions (SPDs) for HP DECnet-Plus for OpenVMS and HP OpenVMS for a list of devices supported by the current release. ______________________________________________________ 4.3.1.1 CSMA-CD Devices The circuit devices listed in Table 4-2 can be configured using DECnet-Plus software. They provide multi-access connections among many nodes on the same CSMA-CD circuit. Table_4-2_CSMA-CD_Devices__________________________________ DECnet Device OpenVMS Comm Name______Type____________OS______I/O_Bus_____Name_____Port 82559 100BaseTX IntegritPCI(embedded)I EIc (Intel) servers (continued on next page) Documentation Errata and Addenda 4-7 Documentation Errata and Addenda 4.3 Network Management and NCL Table_4-2_(Cont.)_CSMA-CD_Devices__________________________ DECnet Device OpenVMS Comm Name______Type____________OS______I/O_Bus_____Name_____Port A5230A 100BaseTX IntegritPCI EW EWc servers A5506B 100BaseTX IntegritPCI EW EWc (4-port) servers A6825A 1000BaseTX IntegritPCI EW EWc servers A6847A 1000BaseSX IntegritPCI EW EWc servers A7011A 1000BaseSX IntegritPCI-X EI EIc (2-port) servers A7012A 1000BaseTX IntegritPCI-X EI EIc (2-port) servers A9782A 1000BaseSX IntegritPCI-X EW EWc servers A9784A 1000BaseTX IntegritPCI-X EW EWc servers BCM5701 1000BaseTX IntegritPCI(embedded)W EWc servers, Alpha BCM5703 1000BaseTX IntegritPCI(embedded)W EWc servers, Alpha COREIO 10Base5 Alpha TURBOchannelES ESc DEBNA 10Base5 VAX BI-bus ET ETc DEBNI 10Base5 VAX BI-bus ET ETc DEBNK 10Base5 VAX BI-bus ET ETc DEBNT 10Base5 VAX BI-bus ET ETc DEGPA-xx 1000BaseTX,SX Alpha PCI EW EWc DEGXA-xx 1000BaseTX,SX Alpha PCI,PCI-X EW EWc (continued on next page) 4-8 Documentation Errata and Addenda Documentation Errata and Addenda 4.3 Network Management and NCL Table_4-2_(Cont.)_CSMA-CD_Devices__________________________ DECnet Device OpenVMS Comm Name______Type____________OS______I/O_Bus_____Name_____Port DELQA 10Base5 VAX Q-bus XQ XQc DELTA 10Base5 (2- VAX TURBOchannelEC ECc port) DELUA 10Base5 VAX UNIBUS XE XEc DEMNA 10Base5 VAX,AlphXMI EX EXc DEQTA 10Base5 VAX Q-bus XQ XQc DESQA 10Base5 VAX Q-bus ES ESc DESVA 10Base5 VAX embedded ES ESc DEUNA 10Base5 VAX UNIBUS XE XEc DE20c 10Base2,5,T Alpha ISA ER ERc DE422 10Base2/T Alpha EISA ER ERc DE425 10Base2/5/T Alpha EISA ER ERc DE434 10BaseT Alpha PCI EW EWc DE435 10Base2/5/T Alpha PCI EW EWc DE436 10BaseT (4- Alpha PCI EW EWc port) DE450 10Base2/5/T Alpha PCI EW EWc DE500-xx 100BaseTX,FX Alpha PCI EW EWc DE504-BA 100BaseTX Alpha PCI EW EWc (4-port) DE600-xx 100BaseTX,FX Alpha PCI EI EIc DE602-xx 100BaseTX,FX Alpha PCI EI EIc (2-port) KFE52 10Base5 VAX Q-bus EF EFc P2SE 100BaseTX Alpha PCI EW EWc P2SE+ 100BaseTX Alpha PCI EW EWc PMAD 10Base5 VAX,AlphTURBOchannelEC ECc SGEC 10Base2 VAX Local EZ EZc (continued on next page) Documentation Errata and Addenda 4-9 Documentation Errata and Addenda 4.3 Network Management and NCL Table_4-2_(Cont.)_CSMA-CD_Devices__________________________ DECnet Device OpenVMS Comm Name______Type____________OS______I/O_Bus_____Name_____Port TGEC______10Base2_________Alpha___Local_______EZ_______EZc_ ________________________ Note ________________________ ATM devices are supported in emulated LAN (ELAN) mode by the OpenVMS EL device. For information about configuring an ELAN (and creating the EL device), see the "Configuring an Emulated LAN (ELAN)" section in the "Local Area Network (LAN) Device Drivers" chapter in the HP OpenVMS I/O Users Reference Manual. LAN failover sets are supported by the OpenVMS LL device. For a general discussion of LAN failover sets, see Chapter 10 in Volume 2 of the HP OpenVMS System Manager's Manual. For information about managing LAN failover sets, see the description of the LANCP utility's DEFINE DEVICE and SET DEVICE commands in the HP OpenVMS System Management Utilities Reference Manual. ______________________________________________________ 4.3.1.2 FDDI Devices The devices listed in Table 4-3 can be configured using DECnet-Plus software. These devices provide multi-access connections among many nodes on the same FDDI circuit. Table_4-3_FDDI_Devices_____________________________________ DECnet Device OpenVMS Comm Name______Type____________OS______I/O_Bus_____Name_____Port DEFAA 100 mmf Alpha FutureBus+ FA FAc (continued on next page) 4-10 Documentation Errata and Addenda Documentation Errata and Addenda 4.3 Network Management and NCL Table_4-3_(Cont.)_FDDI_Devices_____________________________ DECnet Device OpenVMS Comm Name______Type____________OS______I/O_Bus_____Name_____Port DEFEA-xx 100 mmf, UTP Alpha EISA FR FRc DEFPA-xx 100 mmf, UTP Alpha PCI FW FWc DEFPZ-xx 100 mmf, UTP Alpha PCI FW FWc DEFQA 100 mmf VAX Q-bus FQ FQc DEFTA-xx 100 mmf, UTP VAX,AlphTURBOchannelFC FCc DEFZA 100 mmf VAX,AlphTURBOchannelFC FCc DEMFA_____100_mmf_________VAX,AlphXMI_________FX_______FXc_ 4.3.1.3 Synchronous Devices (OpenVMS VAX and Alpha Only) The synchronous devices listed in Table 4-4 can be configured by DECnet-Plus software. All of the synchronous line devices are either point-to-point or multipoint tributary circuit devices. Table_4-4_Synchronous_Devices_(OpenVMS_VAX_and_Alpha_Only)_ DECnet Device OpenVMS Comm Name______Type____________OS______I/O_Bus_____Name_____Port DIV32 VAX Q-bus SD DIV- c-u DMB32 1-port VAX VAXBI SI DMB- c-u DMF32 1-port VAX UNIBUS XG DMF- c-u DNSES 2-port Alpha EISA ZE ZE- c-u DPV11 1-port VAX Q-bus SE DPV- c-u (continued on next page) Documentation Errata and Addenda 4-11 Documentation Errata and Addenda 4.3 Network Management and NCL Table 4-4 (Cont.) Synchronous Devices (OpenVMS VAX and __________________Alpha_Only)______________________________ DECnet Device OpenVMS Comm Name______Type____________OS______I/O_Bus_____Name_____Port DSB32 2-port VAX VAXBI SL DSB- c-u DSF32 2-port VAX MI-bus SF DSF- c-u DSH32 2-port VAX Busless ZS DSH- c-u DST32 1-port VAX Busless ZS DST- c-u DSV11 2-port VAX Q-bus SJ DSV- c-u DSW21 1-port VAX Busless ZT DSW- c-u DSW41 1-port VAX Busless ZT DSW- c-u DSW42 2-port VAX Busless ZT DSW- c-u DSYT1 2-port Alpha TURBOchannelZY ZY- c-u DUP11 1-port VAX UNIBUS SE DPV- c-u PBXDD-Ax 2-, 4-port Alpha PCI ZZ ZZ- c-u PBXDI-Ax 2-, 4-port Alpha ISA ZS ZS- c-u PBXDP-Ax 2-, 4-, 8-port Alpha PCI ZW ZW- c-u SCC 1-port Alpha None ZR ZR- _______________________________________________________c-u_ 4-12 Documentation Errata and Addenda Documentation Errata and Addenda 4.3 Network Management and NCL 4.3.1.4 Asynchronous Devices (OpenVMS VAX Only) The asynchronous devices listed in Table 4-5 can be configured by DECnet-Plus software on OpenVMS VAX systems. Table_4-5_Asynchronous_Devices_(OpenVMS_VAX_Only)__________ DECnet Device OpenVMS Comm Name________Type+___________I/O_Bus_________Name_____Port__ DHQ11 8-line,MC Q-bus TX TX-c-u DHU11 16-line,MC UNIBUS TX TX-c-u DHV11 8-line,MC Q-bus TX TX-c-u DMB32 8-line,MC VAXBI TX TX-c-u DMF32 8-line,MC UNIBUS TX TX-c-u DMZ32 24-line,MC UNIBUS TX TX-c-u DZ11 8-line,PMC UNIBUS TT TT-c-u DZ32 8-line,PMC UNIBUS TT TT-c-u DZQ11 4-line,PMC Q-bus TT TT-c-u DZV11 4-line,PMC Q-bus TT TT-c-u +MC_=_full_modem_control,_PMC_=_partial_modem_control______ ___________________________________________________________ 4.3.2 DTR/DTS In Section 3.10.2 of the DECnet-Plus Problem Solving manual, the documentation for the /nodename qualifier of the DTS test command contains a statement that seems to indicate that DTS/DTR might support Phase V node names. The statement should read as follows: The node-id can be 0, a Phase IV address or node name, or, on a Tru64 UNIX system, a DECnet-Plus NSAP address or Phase V node name. To specify a Phase V node on OpenVMS systems, you must use a node synonym of 6 characters or less. Documentation Errata and Addenda 4-13 Documentation Errata and Addenda 4.4 OSAK Programming 4.4 OSAK Programming The following sections provide information that updates the current OSI Applications Kernel (OSAK) programming documentation. 4.4.1 called_aei Parameter on A-ASSOCIATE and S-CONNECT Indication Events For A-ASSOCIATE indication events in the OSAK API, and S-CONNECT indication events in the SPI, the nsap field of the called_aei parameter is no longer filled in by OSAK. Previously, the called_aei.paddress.nsap structure contained the values specified in the local_ aei.paddress.nsap parameter on the osak_open_responder or spi_open_responder call. However, these values are not used by osak_open_responder or spi_open_responder and may not contain correct information about the received connection (for example, the transport type). 4.4.2 ROSE Minimum Workspace Increased The minimum required size for the parameter block workspace for ROSE has increased. If your ROSE application is using the old minimum workspace size, you will now get a bad parameter error. It is recommended that your application use the constant ROSE_WS_SIZE defined in osak_api.h to get the correct minimum workspace size. ________________________ Note ________________________ Depending on the size of your application's parameter block workspace, you may have to recompile your ROSE applications. ______________________________________________________ 4.4.3 Using OSAK with OSI over TCP/IP On the initiator side, to make a connection using OSI over TCP/IP, specify as the NSAP the IP address as a 6-byte nibble packed hex value including the port number in the first two bytes. For example, the address of 16.36.12.142 on port 102 would be encoded as follows: 4-14 Documentation Errata and Addenda Documentation Errata and Addenda 4.4 OSAK Programming 102 16.36.112.142 | | | | | 0066 10 24 70 8E In this case, the NSAP would be 00661024708E (hex). Specify the NSAP type as OSAK_C_RFC1006. For the transport template, specify either the pseudo-template "1006" or no template at all. OSAK uses a default template of "1006" if the NSAP type is OSAK_C_RFC1006. On the responder side, to listen for OSI over TCP/IP connections, specify as the transport template the pseudo- template "1006". 4.4.4 New Status Code for osak_send_more and spi_send_more Routines The routines osak_send_more and spi_send_more can now return a status code of OSAK_S_NODATA which indicates that there is no data remaining. In previous versions, the status code OSAK_S_INVFUNC may have been returned when this error occurred. 4.4.5 New OSAK API Routine: osak_tc_no_sc() OSAK now contains a new API routine which allows application programs to query OSAK to determine whether a transport connection has been established on a port, but a session connection has not. Syntax: status = osak_tc_no_sc(port, state) C Binding: osak_tc_no_sc(port, state) osak_port port; int *state; Arguments: port The OSAK port that you wish to query. state Documentation Errata and Addenda 4-15 Documentation Errata and Addenda 4.4 OSAK Programming A pointer to an integer where OSAK should return the state information. If the port is connected at the transport layer, but not at the session layer, OSAK returns a non- zero value (true). If the port is connected at the session layer, OSAK returns a zero value (false). Description: Call this routine to determine whether the port is connected at the transport layer, but not at the session layer. This information can be useful when interoperating with some other OSI implementations that may incorrectly terminate the transport connection, or may establish a transport connection but never complete the session connection. Use of this routine can assist an application in determining if the OSAK port is hung. An equivalent routine also exists for the SPI interface: spi_tc_no_sc(). Return Values: OSAK_S_NORMAL The routine has finished without error. OSAK_S_INVPORT The port identifier is invalid. 4.4.6 Handling of Default Transport Templates The following information clarifies statements made about template defaulting in the DECnet-Plus OSAK Programming Reference and DECnet-Plus OSAK SPI Programming Reference manuals. If no transport template is specified in the osak_ associate_req (API and ROSE) or spi_connect_req (SPI) call, OSAK takes the following actions: o If the NSAP in the osak_nsap data structure is CONS or CLNS, OSAK uses the default transport template. o If the NSAP in the osak_nsap data structure is RFC 1006, OSAK uses the osit$rfc1006 transport template. 4-16 Documentation Errata and Addenda Documentation Errata and Addenda 4.4 OSAK Programming 4.4.7 Omitted Parameter Block Parameters In the DECnet-Plus OSAK SPI Programming Reference manual, the following OSAK parameter block parameters were omitted from the SPI routine descriptions. Although the parameters are listed in Section 1.2 and described in Section 1.4.2, they should also appear in the Parameters Used table as follows: ___________________________________________________________ Parameters Used_________Data_Type____Access___________________________ [user_ Address read only context] port_id______osak_port____write_only_______________________ The preceding parameters should be listed for all SPI routines that have the OSAK parameter block argument, except for the following: o spi_async_close o spi_close_port o spi_collect_pb o spi_expedited_req 4.5 File Transfer, Access, and Management (FTAM) The following section describes the documentation update for DECnet-Plus FTAM Programming Manual. 4.5.1 Possible Values for OSIF_FAILURE The error_code argument for the osif_get_event call provides further information if the status returned from the call is OSIF_FAILURE. All the possible values for OSIF_FAILURE is documented in DECnet-Plus FTAM Programming Manual. The two more possible values for OSIF_FAILURE, which is not documented includes the following values: o 44743722 - corresponds to OSAK_S_INVAEI, invalid application entity invocation. o 44743770 - corresponds to OSAK_S_INVPCTXT, invalid presentation context list. Documentation Errata and Addenda 4-17 5 _________________________________________________________________ Operational Notes This chapter contains operational notes and restrictions for HP DECnet-Plus for OpenVMS. This chapter also includes known problems with the current release. 5.1 Network Management The following sections discuss several operational notes about network management. 5.1.1 CTF Utility Now Requires Process Privileges The CTF utility has always required that the invoking process have certain rights identifiers in order to use the START and STOP commands to control the collection of trace records. These rights identifiers are described in Chapter 3 of the DECnet/OSI for VMS CTF Use manual. Now, in addition to one or more of the required rights identifiers, the invoking process must have the following process privileges before invoking CTF for any purpose: ALTPRI, BYPASS, CMKRNL, NETMBX, PRMGBL, PRMMBX, PSWAPM, SYSGBL, SYSLCK, SYSNAM, TMPMBX, and WORLD If you invoke CTF from a process without the required process privileges, the utility exits with an error message indicating the first of the required privileges not granted. 5.1.2 Tuning to Support the Larger CML BYTLM Value The default BYTLM value for CML has been increased from 10,000 to 64,000. This correction was done to prevent NCL from returning the NCL-E-OVERFLOWBYTLM error message when large amounts of data were needed from CML. If you have ever experienced this problem, or if your MAXBUF Operational Notes 5-1 Operational Notes 5.1 Network Management value is already set to 64000 and you have received NCL- E-NORESOURCEAVAIL error messages, then you should make the changes described in this section. To fully take advantage of the increased BYTLM value, do the following: 1. Increase the value of MAXBUF to 64,000. 2. Raise the BYTLM quota on any account that might issue NCL commands requiring the increased resources to at least 65,000. Be sure to do this to at least the SYSTEM, CML$SERVER, and MIRRO$SERVER accounts. For example, to modify the CML$SERVER account, use the following command: $ run sys$system:authorize UAF> modify cml$server/bytlm=65000 3. Check for the existence of the logicals NET$ACP_ BYTLM, NET$EVD_BYTLIM, and NET$MOP_BYTLIM. If any of these logicals are defined and they are set to a value lower than 65,000, modify their entries in SYS$MANAGER:NET$LOGICALS.COM to raise their value to at least 65,000. 4. Check for the existence of the NET$LESACP_BUFFER_ LIMIT logical. If this logical is defined and it is set to a value lower than 65,000, modify its entry in SYS$STARTUP:NET$LES_STARTUP.COM to raise the value to at least 65,000. 5. Check for the existence of the NET$ADVER_BUFFER_LIMIT logical. If this logical is defined and it is set to a value lower than 300,000, modify its entry in SYS$STARTUP:SYLOGICALS.COM to raise the value to at least 300,000. 6. Reboot the system to make all the preceding changes effective. If, after applying the measures described in the previous list, you now receive NCL-E-NORESOURCEAVAIL errors instead of NCL-E-OVERFLOWBYTLIM errors, this generally indicates that your process BYTLM quota is not set high enough. Set the quota to a value slightly higher than the MAXBUF value. Setting process BYTLM quotas to 65,000 (as specified in the previous list) should be sufficient to avoid this problem. 5-2 Operational Notes Operational Notes 5.1 Network Management 5.1.3 COLLECT Command and Addressing in decnet_migrate Commands Some connection errors might be reported for nodes with DECnet-Plus addresses that are not Phase-IV compatible as well. These errors occur because the network management interface on the OpenVMS operating system does not recognize connections to nodes by the explicit use of a DECnet-Plus address that is not Phase-IV compatible. If a DECnet-Plus node also has a Phase-IV compatible address, information is collected for it using that address. 5.1.4 Decimal Syntax DSPs Not Supported DECnet-Plus supports only those IDPs (initial domain parts) that specify the use of binary syntax DSPs (domain-specific parts). IDPs that specify decimal syntax DSPs are not supported. 5.2 Devices and Data Links The following sections discuss operational notes about device support and data links. 5.2.1 Receive Buffers Attribute on HDLC LINK Entity Not Implemented (Integrity servers and Alpha only) The receive buffers attribute of the hdlc link entity is not implemented in DECnet-Plus. If you attempt to set the attribute according to the following example, NCL displays the subsequent informational messages: NCL>set node 0 hdlc link hdlc-0 receive buffers 8 Node 0 HDLC Link HDLC-0 at 2004-04-28-09:51:10.780-04:00I0.113 Command failed due to: set list error Characteristics no such attribute ID: Receive Buffers = 8 HDLC (High-level Data Link Control) allocates the number of receive buffers that it requires; you cannot specify this setting. Operational Notes 5-3 Operational Notes 5.2 Devices and Data Links 5.2.2 FDDI Large Packet Support Phase IV nodes do not support FDDI large packets. If your node has an FDDI controller that uses large packets, routing selects a smaller segment size for Phase IV adjacencies. To communicate with Phase IV nodes, you must enable Phase IV addressing on the routing circuit. Verify that the enable phaseiv address attribute is set to true on one FDDI circuit in the SYS$MANAGER:NET$ROUTING_STARTUP.NCL file. 5.3 Transport Layer The following sections discuss operational notes for the transports in DECnet-Plus. 5.3.1 NSP Characteristics for X.25 PVCs If a node has routing circuits of type x25 permanent you should set the NSP flow control policy characteristic to no flow control. In addition, if the call packet window size is 8 or less, you should set the NSP maximum window characteristic to 8. This lowers the number of NSP unacknowledged transmits and thus prevents the NSP out-of-order cache from filling. 5.3.2 NSP Flow Control Policy and DECnis and x25Gateway Routers In DECnet-Plus Version 6.3, several corrections were made to NSP flow control algorithms. Previous to these changes, if segment flow control was used flow control credits were sometimes improperly handled and the connections would appear to hang. The NSP software in DECnis routers and the x25Gateway product is based on the pre-DECnet-Plus Version 6.3 software. For this reason, whenever a connection is set up to one of these hardware products the NSP flow control should always be set to no flow control. Note that segment flow control is the default for NSP's flow control policy characteristic. Therefore, you must explicitly select NONE when running NET$CONFIGURE, use NCL to modify the running system, or edit the NCL startup script created by NET$CONFIGURE. 5-4 Operational Notes Operational Notes 5.3 Transport Layer 5.3.3 OSI Transport The following notes apply to OSI transport: o If OSI transport times out during data transfer mode because the remote end is unreachable, the error SS$_CONNECFAIL may also be returned in the IOSB for the $QIO(IO$_READVBLK) or $QIO(IO$_WRITEVBLK) call. User code should handle SS$_TIMEOUT as well as SS$_ CONNECFAIL. o When defining an RFC 1006 address using the OSIT$NAMES logical name table, you must put a quotation mark around the address portion. o The requirement against using 0 (zero) and 1 as valid NSELs (network selectors) has been removed, but the following restrictions apply: - The selector fields for OSI transport must be the same in both transport partners if the packet is traversing a backbone containing Phase IV routers (as opposed to routing vector domains). - Although the cluster alias uses two ranges of network transport selector fields to reduce the risk of a collision, HP recommends that you do not choose values from those ranges, or at least that you do not choose the first few values in each range. o The osi transport entity does not support a value of 0 for the maximum remote NSAPs (network service access points) attribute. o The osi transport template entity does not support a value of any for the network service attribute. If this attribute is set to any, it is treated by OSI transport as clns. 5.4 Session Control The following sections discuss operational notes about Session Control. Operational Notes 5-5 Operational Notes 5.4 Session Control 5.4.1 Transport Precedence in Predominantly Phase IV Networks When using a Phase V node in a predominantly Phase IV network, the default for session control's transport precedence characteristic is {OSI,NSP}. This causes session control to attempt an OSI connection first, followed by an NSP connection. If you have a predominantly Phase IV network, this causes an unnecessary delay when connecting to Phase IV nodes. If the precedence is causing the delay, the delay is not seen when connecting in the reverse. To change the precedence, insert the following line at the end of the NET$SESSION_STARTUP.NCL file: set node 0 session control transport precedence = {NSP,OSI} Remember to reinsert this line if you run NET$CONFIGURE. 5.4.2 Session Control Back Translation Soft Links Although the default for Session Control's maintain backward soft links characteristic is correctly documented as false, on OpenVMS systems the Session Control startup script always sets this characteristic to true. 5.4.3 Restriction When Using Applications Supported Using Cluster Aliases Due to a design restriction, incoming ALIAS connections are forwarded to cluster members somewhat differently depending upon whether the SESSION CONTROL APPLICATION entity's ADDRESS set contains a NUMBER parameter (equivalent to Phase IV's connect by object number) or a TASK parameter (equivalent to Phase IV's connect by object name). For an incoming connect by object number, each ALIAS entity has access to a cluster-wide object number table that specifies which object numbers have been defined for each cluster member and the status of their INCOMING ALIAS characteristic. The result is that the connection forwarding mechanism works as expected, that is, connections are forwarded or not forwarded to cluster members correctly depending upon whether the application exists on the member and depending on the setting of the INCOMING ALIAS parameter. 5-6 Operational Notes Operational Notes 5.4 Session Control However, the mechanism for mapping incoming connections by object name using this cluster-wide object number table does not exist and the result is that connections are forwarded to a given cluster member regardless of whether the application exists on a given member and regardless of the setting of the INCOMING ALIAS parameter on a given member. If you wish to restrict access to a network application supported using a cluster alias (either by not having the application present on a member or by setting the INCOMING ALIAS characteristic to FALSE on a member), you must create the SESSION CONTROL APPLICATION by supplying the NUMBER keyword for the ADDRESS characteristic (that is, supplying the object number), so that connection forwarding works as expected. 5.5 Distributed Naming Service (DECdns) The following sections discuss operational notes for DECdns. 5.5.1 Creating Clearinghouses When IP Address is Zero Causes DNS Server Hang Do not create a clearinghouse when the node's IP address is all zeros. You can determine if the address is zero by using the NCL command SHOW ADDRESS. After each system boot, the local node's IP address is zero until the first incoming or outgoing OSI over TCP/IP or DECnet over TCP/IP connection occurs on the local node. At that time, the PATHWORKS Internet Protocol (PWIP) driver included with HP TCP/IP Services for OpenVMS provides DECnet-Plus with its IP address. Consequently, at least one OSI over TCP/IP or DECnet over TCP/IP connection must occur before attempting to create a clearinghouse. An easy method to ensure that at least one OSI over TCP/IP or DECnet over TCP/IP connection has been made is to use the SET HOST command with the IP address of the local node. (If you don't know the local node's IP address, use the DCL SHOW LOGICAL *HOSTADDR command to display it.) The SET HOST command causes HP TCP/IP Services for OpenVMS to provide the local IP address to DECnet-Plus. Remember to use the NCL SHOW ADDRESS command to verify that the local node's IP address has been defined. Operational Notes 5-7 Operational Notes 5.5 Distributed Naming Service (DECdns) If fail to do this, you may have to delete the clearinghouse and start over after you have obtained a non-zero IP address. If you try to use a clearinghouse with zero IP addresses in the towers it is likely that the DECdns server will hang. 5.5.2 Server Startup Delay There can be a delay in the startup of the DECdns server when the server is using DECnet over TCP/IP connections. This delay is due to the time required for the server to obtain a non-zero IP address from DECnet and the PATHWORKS Internet Protocol (PWIP) software. The IP address is initially zero until it is updated by DECnet and PWIP with the actual IP address for the node. 5.5.3 Delay in Node Name-to-Address Translations When DECdns Is Using DECnet over TCP/IP Connections When DECdns is using DECnet over TCP/IP connections, you may experience delays whenever DECnet has to translate a node name to a node address using the node's IP tower. These delays can occur when you are using NCL, when you invoke a DECnet application, or when you perform any other action that requires translating the node's name to its IP address. The DECdns clerk, like any other DECnet application, uses DECnet to access the DECdns server. Currently, Session Control's transport precedence characteristic does not support a value for the IP tower. Therefore, Session Control always attempts to connect to the DECdns server using the NSP and OSI towers before trying the IP tower. After DECnet notifies DECdns that it cannot make a connection on a OSI or NSP tower, the DECdns clerk tries the IP tower. ________________________ Note ________________________ This problem is especially noticeable in environments where a process spawns multiple subprocesses, each of which performs a network command. This is common in some batch environments. ______________________________________________________ 5-8 Operational Notes Operational Notes 5.5 Distributed Naming Service (DECdns) 5.5.4 Problem Creating Clearinghouse Using DECnet over TCP/IP Connections When creating a new clearinghouse that joins an existing namespace in an environment that uses DECnet over TCP/IP connections, it is possible to have a clearinghouse created without the root directory. This is usually due to an intermittent communications error during clearinghouse creation. This problem occurs infrequently. The current workaround is to force the creation of the root directory by issuing a manual skulk command as shown below: $ mcr dns$control DNS>set dir . to skulk 5.5.5 DNS$CONFIGURE Option 4 Does Not Display IP Address Option 4 of the DECdns configuration program (DNS$CONFIGURE.COM) is used to display a server node's address (as described in Section 10.5 of the HP DECnet- Plus for OpenVMS DECdns Management manual). This option has not been enhanced to display the node's IP address. As a workaround, use the NCL show node [node-id] address command. 5.5.6 Limitation on Size of Checkpoint File Records The checkpoint file has a limitation of 500 blocks maximum on the size of individual records. To detect any records over this limit or approaching this limit, run the SURGEON "-scanrx" option. You will need to take corrective action if you see a line indicating greater than 500 blocks and the number of records is one (RECS: 1) because the server may bugcheck with a 902 error in the DB_COMPRESSION.C module. Records that exceed the 500 block maximum can be caused by an application that is writing records larger than this limit or the garbage collector mechanism (removes deleted records) is not running. To correct the problem, apply one of the following actions: o Use the SURGEON "-exciser" option to remove the offending records Operational Notes 5-9 Operational Notes 5.5 Distributed Naming Service (DECdns) o Use the recreate object command (if the garbage collector is not running). If you have any questions about doing this, consult your HP representative. Avoid the situation with the garbage collector not running by making sure all your directories skulk to a success status and that the DNS$ALLUPTO date is recent. Use the following command in DNS$CONTROL to check the skulk status of all directories in the namespace: SHOW DIR ... DNS$SKULKSTATUS Use the following command in DNS$CONTROL to check the DNS$ALLUPTO date on all directories in the namespace: SHOW DIR ... DNS$ALLUPTO 5.5.7 PAGEDYN Resources: Clerks and Servers DECdns clerk and server systems can require additional paged dynamic memory resources (PAGEDYN). For DECdns clerk systems, consider increasing the PAGEDYN resource on the node if you see either the RESOURCEERROR or NONSRESOURCES error during skulk operations. Before you configure a system as a DECdns server, check that the system has at least 50,000 free bytes of paged dynamic memory. Insufficient paged dynamic memory on servers can cause configuration errors, skulk failures, and in some cases normal clerk operations can fail, returning either the RESOURCEERROR or NONSRESOURCES error. The DNS$SERVER.LOG file can also contain messages regarding failures caused by this resource. Servers holding master replicas of directories that have many read-only replicas can also require additional paged dynamic memory. 5-10 Operational Notes Operational Notes 5.5 Distributed Naming Service (DECdns) 5.5.8 Error Message Generated by DECdns Clerk During Startup The DECdns clerk startup might output the following error message: create node 0 dns clerk known namespace CZ command failed due to: process failure A Known Namespace with this name or NSCTS already exists You can disregard this message. The DECdns clerk configuration procedure puts a create dns clerk known namespace command for the default namespace into the DECdns clerk NCL startup file. The command remains there in case the DECdns cache file has been deleted or corrupted. 5.5.9 Miscellaneous DECdns Operational Notes You might encounter the following DECdns problems: o DNS$CONTROL might return Syntax Error if the clerk is disabled. o You should not use DNS$CONTROL to modify the DNA_ NodeSynonym attribute on DECnet node objects. DNS$CONTROL displays the attribute properly but does not modify it properly. Use the decnet_register node registration tool to modify DECnet data stored in DECdns. o Re-created entries retain the case of the original entry name. o If you have trouble creating a clearinghouse, make sure that both the dns$server account (user authorization file entry) and its default directory exist. Operational Notes 5-11 Operational Notes 5.6 Distributed Time Service (DECdts) 5.6 Distributed Time Service (DECdts) The following sections discuss operational notes for DECdts. 5.6.1 Automatic Time Zone Changes on Rebooting Clusters If all members of a cluster are down when daylight saving time (DST) takes effect and automatic time zone changes are enabled, then members may reboot with the incorrect local time. If you anticipate that the cluster will be down during the change to or from daylight saving time, you should disable automatic time zone changes and make the changes manually. 5.7 OSAK Programming The following sections discuss operational notes for the OSI Applications Kernel (OSAK) interface. 5.7.1 User Data Size Restriction for Tracing OSAK does not support tracing with user data buffers larger than 32,765 bytes. 5.7.2 OSAK Version 1.1 No Longer Supplied HP no longer provides the OSAK Version 1.1 interface. If you use the OSAK Version 1.1 interface, you must migrate to the OSAK Version 3.0 SPI (session programming interface). The OSAK Version 3.0 SPI provides the same capabilities as the OSAK Version 1.1 interface. For detailed information about the OSAK Version 3.0 SPI, see the DECnet-Plus OSAK SPI Programming Reference manual. 5.7.3 Migrating Applications from Version 2.0 to Version 3.0 OSAK API Interface Version 3.0 of OSAK includes a programming interface that is backwards compatible with the Version 2.0 programming interface. As a result of more rigorous conformance testing, some additional problems have been uncovered in the Version 2.0 interface. 5-12 Operational Notes Operational Notes 5.7 OSAK Programming As a result, applications built against OSAK Version 2.0 might encounter problems when using the Version 2.0 backwards-compatible interface in OSAK Version 3.0 if the applications contain previously untrapped application problems. 5.7.4 Misleading OSAK Error Message: SPM Congestion at Connect Time When OSAKserver receives an association request that specifies a nonexistent user identity, it generates the error message "SPM Congestion at Connect Time." If you see this error, check that the user name and password specified in the request are correct. If the user name is correct but the password is incorrect, the OPCOM message %LOGIN-F-INVPWD is logged. If the user name is incorrect, no OPCOM message is logged. Operational Notes 5-13 Operational Notes 5.8 DECnet Programming 5.8 DECnet Programming The following sections discuss programming issues that apply to the DECnet programming interface. 5.8.1 64-Bit Virtual Address Restrictions You can use 64-bit virtual addresses only with $QIO operations on the NET: devices; you cannot use 64-bit virtual addresses with $QIO operations on the OS: devices. For transparent task-to-task communication, the $ASSIGN system service accepts only 32-bit addresses and 32-bit descriptors for the DEVNAM parameter when it describes a network connect block (NCB). You can use non-transparent task-to-task operations when you want 64-bit descriptor addresses and 64-bit descriptors to specify an NCB. 5.8.2 Backtranslation of IP Addresses For IP addresses, session control returns the full name if the synonym is not available regardless of the Session Control Application Node Synonym setting. If neither the full name nor synonym is available, the IP$aa.bb.cc.dd format is returned. If the system is configured to use IP addresses, you should prepare the application to receive a node name or address string longer than six characters in length even if Session Control Application Node Synonym = TRUE is specified for the application. 5.8.3 Applications Connection Requirement With DECnet-Plus, your application must wait for the completion of the $QIO system service call used to accept the connection before attempting to use the connection. 5-14 Operational Notes