Transcription
Front coverIBM z/OS V2R2 CommunicationsServer TCP/IP Implementation:Volume 2 Standard ApplicationsBill WhiteOctavio FerreiraTeresa MissawaTeddy SudewoRedbooks
International Technical Support OrganizationIBM z/OS V2R2 Communications Server TCP/IPImplementation: Volume 2 Standard ApplicationsSeptember 2016SG24-8361-00
Note: Before using this information and the product it supports, read the information in “Notices” onpage ix.First Edition (September 2016)This edition applies to Version 2, Release 2 of z/OS Communications Server. Copyright International Business Machines Corporation 2016. All rights reserved.Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP ScheduleContract with IBM Corp.
ContentsNotices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ixTrademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xIBM Redbooks promotions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiiiAuthors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xivNow you can become a published author, too! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvComments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvStay connected to IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvChapter 1. The syslog daemon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.1 Conceptual overview of syslogd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21.1.1 What is syslogd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21.1.2 How syslogd works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.1.3 How can syslogd be deployed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.2 Log messages to different files and to a single file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.2.1 Description of logging to multiple files and to a single file. . . . . . . . . . . . . . . . . . . . 51.2.2 Configuration of multiple files and a single file . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.2.3 Verification of multiple files and a single file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131.3 Starting two syslogd instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141.3.1 Description of two syslogd instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141.3.2 Configuring two syslogd instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141.3.3 Verification for running two syslogd instances . . . . . . . . . . . . . . . . . . . . . . . . . . . 171.4 The syslogd functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191.4.1 The syslogd operator commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191.4.2 Description of syslogd automatic archival . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191.4.3 The syslogd browser and search facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241.5 Problem determination for syslogd logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331.6 Additional information sources for syslogd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Chapter 2. TN3270E Telnet server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.1 Conceptual overview of the TN3270E server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.1.1 What is the TN3270E server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.1.2 How does the TN3270E server work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.1.3 Possible uses for the TN3270E server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.2 TN3270E server in a single image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.2.1 Description of the exampleTN3270E server scenario. . . . . . . . . . . . . . . . . . . . . .2.2.2 Configuration of the TN3270E server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.2.3 Activation of the TN3270E server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.2.4 Verification of the TN3270E server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.2.5 Administration and management of the TN3270E server . . . . . . . . . . . . . . . . . . .2.3 Multiple TN3270E servers in a multiple image environment . . . . . . . . . . . . . . . . . . . . .2.3.1 Multiple TN3270E servers within the sysplex . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.3.2 Configuration of multiple TN3270E servers within the sysplex . . . . . . . . . . . . . . .2.3.3 Activation and verification of multiple TN3270E servers in the sysplex . . . . . . . . Copyright IBM Corp. 2016. All rights reserved.353636374344444453546677788086iii
2.4 Multiple TN3270E servers using LU name server and LU name requester . . . . . . . . . 952.4.1 Description of TN3270E servers using LU name server and requester . . . . . . . . 952.4.2 Configuration of TN3270E servers within sysplex using LU name server andrequester. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1012.4.3 Activation and verification of LU name server and requester within sysplex . . . 1082.4.4 Scenario: LU name server automated takeover when active name server fails . 1232.5 TN3270E server in a single image using SHAREACB . . . . . . . . . . . . . . . . . . . . . . . . 1272.5.1 Overview of SHAREACB utilization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1272.5.2 Configuration of the TN3270E server with SHAREACB option. . . . . . . . . . . . . . 1282.5.3 Activation of the TN3270E server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1292.5.4 Verification of the TN3270E server with SHAREACB defined . . . . . . . . . . . . . . 1302.6 TN3270 support of TSO logon reconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1302.7 Problem determination for the TN3270E servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1312.7.1 Review the definition statements within the profile . . . . . . . . . . . . . . . . . . . . . . . 1312.7.2 Use TCP/IP and Telnet commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1322.7.3 Use the MSG07 statement in the TN3270 profile . . . . . . . . . . . . . . . . . . . . . . . . 1372.7.4 Use SMF records to capture TN3270 connection activity . . . . . . . . . . . . . . . . . . 1372.7.5 Use trace data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1382.7.6 Tips for multiple TN3270E servers in a Parallel Sysplex environment . . . . . . . . 1392.7.7 Tips for LU name server and LU name requester diagnosis. . . . . . . . . . . . . . . . 1392.8 Additional information sources for the TN3270E server . . . . . . . . . . . . . . . . . . . . . . . 140Chapter 3. File Transfer Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.1 Conceptual overview of FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.1.1 What FTP is . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.1.2 How FTP works. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.1.3 How FTP can be used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.2 Basic FTP without security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.2.1 Description of basic FTP without security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.2.2 Planning for the basic FTP environment without security . . . . . . . . . . . . . . . . . .3.2.3 Configuration of basic FTP without security . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.2.4 Activation and verification for basic FTP without security . . . . . . . . . . . . . . . . . .3.3 Multiple FTP servers in a sysplex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.3.1 Description of multiple FTP servers in a sysplex . . . . . . . . . . . . . . . . . . . . . . . .3.3.2 Configuration for multiple FTP servers in the sysplex. . . . . . . . . . . . . . . . . . . . .3.3.3 Activation and verification of FTP servers within sysplex . . . . . . . . . . . . . . . . . .3.4 FTP client using batch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.4.1 Description of FTP client using batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.4.2 Configuration of FTP client using batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.4.3 Activation and verification of FTP client batch job. . . . . . . . . . . . . . . . . . . . . . . .3.5 FTP client application programming interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.5.1 FTP client API for REXX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.5.2 FTP client API for Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.6 FTP access to UNIX named pipes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.6.1 What are UNIX named pipes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.6.2 Description of FTP access to UNIX named pipes . . . . . . . . . . . . . . . . . . . . . . . .3.6.3 FTP configuration options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.6.4 Use the z/OS FTP client to create a named pipe in the z/OS FTP server . . . . .3.6.5 Supported z/OS FTP subcommands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.6.6 Storing into a named pipe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .ivIBM z/OS V2R2 Communications Server TCP/IP Implementation: Volume 2 Standard 4178187187188189190190191192192193194196197197
3.7 FTP large data set access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.7.1 The extended address volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.7.2 FTP support for large format data set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.7.3 Example of EAS-eligible data set allocation for FTP transfer . . . . . . . . . . . . . . .3.8 Miscellaneous configuration settings of FTP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.8.1 A single generic FTP server in a multiple stack z/OS image . . . . . . . . . . . . . . .3.8.2 FTP network management interface with SMF . . . . . . . . . . . . . . . . . . . . . . . . . .3.9 Problem determination for FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.10 Additional information sources for FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .199199200201201201202203203Chapter 4. Simple Network Management Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . .4.1 Conceptual overview of SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.1.1 What SNMP is. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.1.2 How SNMP works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.1.3 How SNMP can be applied . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.2 z/OS SNMP agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.2.1 Description of the z/OS SNMP agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.2.2 Configuration of the z/OS SNMP agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.2.3 Activation and verification of the z/OS SNMP agents . . . . . . . . . . . . . . . . . . . . .4.3 z/OS SNMP subagents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.3.1 Description of SNMP subagents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.3.2 Configuration of SNMP subagents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.3.3 Activation and Verification of SNMP subagents . . . . . . . . . . . . . . . . . . . . . . . . .4.4 z/OS SNMP client command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.4.1 Description of the SNMP client commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.4.2 Configuration tasks for the SNMP client commands. . . . . . . . . . . . . . . . . . . . . .4.4.3 Using the osnmp/snmp z/OS UNIX command . . . . . . . . . . . . . . . . . . . . . . . . . .4.5 Problem determination for the SNMP facilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.6 Additional information sources for SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27235236Chapter 5. IP printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1 Conceptual overview of IP printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.1 What IP printing is . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.2 How IP printing works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.3 How IP printing can be applied . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.2 LPR/LPD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.2.1 Description of LPR/LPD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.2.2 Configuration tasks for LPR/LPD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.2.3 Activation and verification of LPR/LPD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.3 Infoprint Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.3.1 Description of the Infoprint Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.3.2 Configuration of Infoprint Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.4 Problem determination for LPR/LPD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.5 Additional information sources for IP printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237238238239239240241241243245246248255261Chapter 6. INETD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.1 Conceptual overview of INETD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.1.1 What INETD is . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.1.2 How INETD works. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.1.3 How INETD can be applied. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.2 A single INETD setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.2.1 Description of the INETD setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.2.2 Configuration tasks for INETD setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.2.3 Activation and verification of INETD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .263264265265266266267267269Contentsv
6.3 Problem determination for INETD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2736.4 Additional information sources for INETD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273viChapter 7. z/OS mail servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.1 Conceptual overview of z/OS mail applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.1.1 z/OS mail services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.1.2 How z/OS mail services work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.1.3 How z/OS mail services are applied . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.2 z/OS CSSMTP, a mail forwarding SMTP client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.2.1 Advantages of using z/OS CSSMTP client . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.2.2 Configuration tasks for the z/OS CSSMTP client . . . . . . . . . . . . . . . . . . . . . . . .7.2.3 Verification of the z/OS CSSMTP client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.3 z/OS SMTP as a mail server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.3.1 Description of z/OS SMTP server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.3.2 Configuration tasks for the z/OS SMTP server . . . . . . . . . . . . . . . . . . . . . . . . . .7.3.3 Verification of the z/OS SMTP server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.4 Using sendmail and popper as mail servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.4.1 Description of sendmail and popper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.4.2 Configuration tasks for sendmail and popper . . . . . . . . . . . . . . . . . . . . . . . . . . .7.4.3 Verification of sendmail and popper setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.5 Using sendmail as a client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.5.1 Description of the sendmail client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.5.2 Configuration tasks for the sendmail client . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.5.3 Verification of the sendmail client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.6 Migrating to CSSMTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.6.1 CSSMTP compatibility with SMTPD client . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.6.2 Configuration tasks for implementing CSSMTP compatibility test mode . . . . . .7.6.3 Migrating from SMTPD to CSSMTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.7 Problem determination for the mail facilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.7.1 P
iv IBM z/OS V2R2 Communications Server TCP/IP Implementation: Volume 2 Standard Applications 2.4 Multiple TN327
