TCP/IP Level 410 Preventive Service Planning
(PSP) Bucket
**> Last update: 06 Mar 2002 **> Synch'd w/RETAIN: 14 Oct 2002 *********************** * SUBSET VM410 * *********************** This SUBSET contains installation information for TCP/IP Level 410 for z/VM Version 4 Release 1.0. ************************************************************************ * C H A N G E S U M M A R Y * ************************************************************************ Date Last Changed Section 1. 2001/08/22 Installation Information 2. 2001/09/08 Documentation Changes 3. 2002/03/06 General Information 4. 2002/01/24 Service Recommendations - See 0101RSU 5. yyyy/mm/dd Cross Product Dependencies Service Recommendation Summary DATE APAR PTF VOLID COMMENTS 1. yyyy/mm/dd xxnnnnn xxnnnnn nnnn N/A ************************************************************************ * SECTION 1. I N S T A L L A T I O N I N F O R M A T I O N * ************************************************************************ This section contains changes relevant to the installation of the product, or to its Program Directory. 6. 2001/08/22 When network devices are configured for the TCP/IP (stack) server virtual machine, ensure that any virtual device addresses specified for a device are available for use. (Such virtual addresses are specified as part of DEVICE statements within the TCP/IP server configuration file -- PROFILE TCPIP, or its equivalent.) For example, for a default installation environment, virtual addresses 401, 402 and 405 cannot be used for network devices unless local adjustments are made. These addresses have been reserved and defined within the z/VM system directory for establishing links to MAINT-owned National Language Support (NLS) HELP minidisks, to allow specific help information to be referenced in the appropriate environments. 5. 2001/08/03 It my be possible to address certain z/VM host connectivity problems by including specific ASSORTEDPARMS operands in the TCP/IP server configuration file (PROFILE TCPIP, or its equivalent). The OVERRIDEPRECEDENCE operand may help alleviate general connectivity problems that arise when clients alter TCP/IP Type-of-Service (TOS) values after a connection has been established. Connections that appear to close unexpectedly are symptomatic of a possible need for using the OVERRIDEPRECEDENCE operand. The NORFC1323 operand may help alleviate TN3270 connectivity problems that arise with Telnet connections that are associated with Windows 95 (Win95) hosts. Win95-initiated Telnet connections that appear to "hang" on a regular basis, and with consistent duration, are symptomatic of a possible need for using the NORFC1323 operand. Note: The use of the NORFC1323 operand may impact TCP connection performance for other TCP clients, as this operand prevents the z/VM TCP/IP server from initiating RFC 1323-related performance features (although client requests to enable these facilities are always accepted). 4. 2001/08/03 For customers who plan to use the Secure Socket Layer (SSL) server support, please note the following: To use the Secure Socket Layer (SSL) server, a suitably configured Linux kernel and file system must be installed on your z/VM system. Detailed information about Linux requirements and preparation for use by the SSL server are available at the TCP/IP for z/VM home page on the World Wide Web. The URL for this home page is: http://www.vm.ibm.com/related/tcpip/ Note: If no specific action is taken to configure the SSL server and an attempt is made to initialize this server, the SSL server will report errors similar to those shown here and will fail to initialize: DTCRUN1011I Server started at nn:nn:nn on dd mmm yyyy (day) DTCRUN1011I Running "VMSSL" DTCSSL2428I Port 9999 is used for SSL administration. HCPVMI232E IPL UNIT ERROR; IRB 00404017 00000010 00200018 00800000 HCPGIR450W CP entered; disabled wait PSW 000E0000 00000232 3. 2001/08/03 Customers who plan to use an External Security Manager (ESM) different from the IBM Resource Access Control Facility (RACF), such as VMSECURE from Sterling Software Inc., should review Informational APAR II11256 for additional information about configuring TCP/IP servers in such an environment. 2. 2001/08/03 Missing interrupt conditions for I/O operations involving devices dedicated to the TCPIP virtual machine should be detected, but *not* dealt with. For z/VM, the default MIH setting of OFF will accomplish this. (This default is in effect when MIH is not specified on the user directory OPTION statement or the SET MIH command is not issued within a virtual machine). However, when MIH OFF is in effect, CP issues HCPMHT2150I messages to the operator, to indicate that an I/O operation was started but the MIH interval expired before the device sent an interrupt. In some instances, these messages may flood the OPERATOR console. Use of the 'OFF' parameter of a related command, CP SET MITIME, can prevent excessive HCPMHT2150I messages related to TCPIP from appearing on the OPERATOR console. This command controls the time interval at which a specified device is checked for missing interrupts. To reduce occurrences of HCPMHT2150I messages, use the following command. Note that only the device(s) dedicated to the TCPIP server should be specified with this command. CP SET MITIME rdev1-rdev2 OFF The CP SET MITIME command should be issued within an "exit" exec, identified by an ":Exit." tag that is defined for the TCPIP server entry in a locally created DTCPARMS file. 1. 2001/08/03 Prior to installing TCP/IP for z/VM, you may find it useful to review the content of the following ITSO Redbooks if you're not familiar with TCP/IP protocols, functions and networking principles: * "TCP/IP Tutorial and Technical Overview", (GG24-3376) * "IP Network Design Guide", (SG24-2580) * "TCP/IP Solutions for VM/ESA", (SG24-5459) * "IBM Communications Server for OS/390 V2R10 TCP/IP Implementation Guide, Volume 1: Configuration and Routing", (SG24-5227) Additional textbook references that may be useful are: * "TCP/IP Illustrated, Volume 1: The Protocols," Richard W. Stevens, Addison-Wesley, Reading, Massachusetts, 1994. ISBN: 0-201-63346-9 (SR28-5586-00) * "Internetworking with TCP/IP Volume I:Principles, Protocols, and Architecture," Douglas E. Comer, Prentice Hall, Englewood Cliffs, New Jersey, 1991. ISBN: 0-13-216987-8 (SC31-6144-00) * "DNS and BIND in a Nutshell," Paul Albitz & Cricket Liu, O'Reilly & Associates, Sebastopol, California, 1992. ISBN: 1-56592-010-4 (SR28-4970-00) ************************************************************************ * SECTION 2. D O C U M E N T A T I O N C H A N G E S * ************************************************************************ 4. 2001/09/08 Please note that level-specific TCP/IP publications have not been produced for TCP/IP Level 410 Therefore, existing TCP/IP Level 3A0 publications must be used and referenced when using TCP/IP Level 410. In the context of using any TCP/IP Level 3A0 publications in conjunction with TCP/IP Level 410, references to "Level 3A0" should be construed as "Level 410." Detailed information about TCP/IP Level 410 functional changes and TCP/IP Level 3A0 publication discrepancies that warrant attention is available at the TCP/IP Feature home page on the World Wide Web. The URL for this home page is: http://www.vm.ibm.com/related/tcpip/ 3. 2001/08/03 The PDF-format file for the "z/VM: TCP/IP Level 3A0 Diagnosis Guide" (fzaa2a00.pdf) that has been included on the VM Collection kit CD-ROM is incorrect. Note that the BookManager version of this file included on this same CD-ROM is correct. If required, a correct version of the fzaa2a00.pdf file can be obtained from the TCP/IP Feature home page on the World Wide Web. The URL for this home page is: http://www.vm.ibm.com/related/tcpip/ This problem is similarly discussed in Informational APAR II12738. 2. 2001/08/03 The following errors exist in "z/VM: TCP/IP Level 3A0 Programmer's Reference" (SC24-5983-00): Chapter 1, "General Programming Information" Page Error / Correction ---- -------------------------------------------------- 2 In the section titled "Compiling and Linking C Applications", the link library ordering for the GLOBAL TXTLIB examples is incorrect. The first example should be as follows: GLOBAL TXTLIB COMMTXT SCEELKED Similarly, the second example should show: GLOBAL TXTLIB COMMTXT SCEELKED RPCLIB 1. 2001/08/03 The following errors exist in "z/VM: TCP/IP Level 3A0 Planning and Customization" (SC24-5981-00): Chapter 23, "Configuring the SSL Server" Page Error / Correction ---- -------------------------------------------------- 525 The fourth paragraph that discusses use of the Linux operating system is incorrect. This paragraph should read as follows: The SSL server runs on the Linux operating system, which runs as a guest in the SSL server virtual machine. Thus, a suitably configured Linux kernel and file system must be installed on your z/VM system. Detailed information about Linux requirements and preparation for use by the SSL server are available at the TCP/IP for z/VM home page on the World Wide Web. The URL for this home page is: http://www.vm.ibm.com/related/tcpip/ ************************************************************************ * SECTION 3. G E N E R A L I N F O R M A T I O N * ************************************************************************ This section contains general information, i.e., hints/tips. 5. 2002/03/06 When TCP/IP server exit samples are customized to meet the needs of your installation, note that commands which make use of TCP/IP services should *not* be used within any of these exits. TCP/IP server exits to which this limitation applies are: TCP/IP Server Supported Exits -------------- ----------------------------- TCP/IP (Stack) SCEXIT PMEXIT DNS VALIDUSR FTP FTPEXIT CHKIPADR NFS VMNFSCMS VMNFSMON VMNFSSMG SMTP SMTPCMDX SMTPFWDX SMTPVERX UFT UFTCMDX UFTNSLKX Examples of programs and functions that should not be utilized are: * PING, NSLOOKUP, REXEC * TCP/IP-oriented CMS PIPE stages and Rexx Sockets APIs * Local or third-party applications that use TCP/IP socket interfaces or other services For the TCP/IP stack server, doing so creates a situation where the stack is required to provide TCP/IP services to itself, at which point internal interrupt handling and blocking issues then arise. For other TCP/IP servers, similar problems can result, not just with VMCF or IUCV communication interrupt handling, but also with TCP/IP connection management. Attempts to make use of a secondary TCP/IP "worker" stack to provide the desired information will also encounter the same problems just described, regardless of the servers involved. Thus, care must be taken to ensure that all commands or programs invoked within a TCP/IP server exit do not adversely affect the operation of that server. This includes not just TCP/IP-oriented commands, but those which can cause CMS storage management changes, extended wait conditions, or that otherwise adversely affect server performance. Without such care, unpredictable results or other operational errors can and may occur. 4. 2001/08/03 Several TCP/IP for VM functions are Pascal-based, and use VMCF communications to communicate with the TCPIP server. Therefore, these functions cannot be reliably used in conjunction with other applications that also use VMCF communications (such as the CMS Utility, WAKEUP); doing so may produce intermittent hangs during processing or other unpredictable results. The TCP/IP Pascal-base functions for which such problems may arise are: FTP HOMETEST LPQ LPR LPRM NETSTAT OBEYFILE PING REXEC TELNET TESTSITE TFTP See CMS Utilities APAR VM58540 for more information about problems when using FTP in conjunction with WAKEUP. 3. 2001/08/03 With RSCS Version 3 Release 1 (V3 R1), enhanced configuration features, such as embedded files, new configuration statements (such as LINKDEFINE), and the ability to use additional comment delimiters ('/*' and '*/') are available for configuring RSCS. For example: IMBED fn ft /* RSCS V3 R1 style comments */ The TCP/IP for VM program, SMTPRSCS, uses the RSCS CONFIG file to build an RSCS host table file (SMTPRSCS HOSTINFO). SMTPRSCS can process RSCS V3 R1 embedded files, its new configuration definitions, and the additional comment delimiters. However, if "generic routing" is used in your environment (as from using a "ROUTE *" statement), you still need to identify -- with respect to SMTPRSCS -- any additional RSCS host names that are relevant to your RSCS network, which are not in the RSCS CONFIG configuration file. To do this, you can create a separate file to be used as input for the SMTPRSCS program. For example, a file named TCP-RSCS CONFIG, that contains: IMBED RSCS CONFIG ROUTE nodeid1 ROUTE nodeid2 : where each ROUTE statement must have two tokens -- "ROUTE" and a nodeid name of an additional RSCS node to be identified for use by the SMTP server. 2. 2001/08/03 APAR VM62879, through its associated PTF, UM97410, is used as the ordering mechanism for the current level of the TCP/IP Function Level 410 RSU. This APAR/PTF will be updated during every RSU cycle to indicate the RSU level that is currently available through ISMD service. The RSU can be ordered upon request by contacting the Level 2 support group, or through the SRD (Service Request & Delivery) function of IBMLink. Please see the text of APAR VM62879 for more information, if necessary. Note: TCP/IP RSU maintenance is provided only as part of the z/VM 4.1.0 "stacked" RSU. 1. 2001/08/03 When appropriate, the support center will open informational APARs covering various aspects of TCP/IP for VM. These APARs will cover installation and maintenance specific information, information on using the product, and other information that will often assist the customer. Customers can search for these APARs by using The product component ID (5735FAL00) and the keyword TCPIPINFO. It's recommended that customers using TCP/IP for VM review these APARs for information specific to their needs. ************************************************************************ * SECTION 4. S E R V I C E R E C O M M E N D A T I O N S * ************************************************************************ 1. 2002/01/24 See Subset 0101RSU for service recommendations. ************************************************************************ * SECTION 5. C R O S S P R O D U C T D E P E N D E N C I E S * ************************************************************************ This section contains information that is dependent upon another product other than this subset ID. It also contains information dealing with migration and product coexistence. This item contains no records. 1. yyyy/mm/dd Interdependent Product: Problem: Users Affected: Recommendation: Install xxxxxxx on Volid xxxx ************************************************************************ * I N F O R M A T I O N A L / D O C U M E N T A T I O N * * APARs Follow (If Any) * ************************************************************************ ------------------------------------------------------------------------ PTF Include List: This item contains no records. ------------------------------------------------------------------------ PTF Exclude List: This item contains no records. ------------------------------------------------------------------------ PE APAR List: This item contains no records. ------------------------------------------------------------------------ Pending PE APAR List: This item contains no records.