z/OS Communications Server IP User’s Guide and Commands Version 1 Release 4 SC31-8780-02 z/OS Communications Server IP User’s Guide and Commands Version 1 Release 4 SC31-8780-02 Note: Before using this information and the product it supports, be sure to read the general information under “Notices” on page 425. Third Edition (September 2002) This edition applies to Version 1 Release 4 of z/OS (5694-A01) and Version 1 Release 4 of z/OS.e (5655-G52) and to all subsequent releases and modifications until otherwise indicated in new editions. Publications are not stocked at the address given below. If you want more IBM® publications, ask your IBM representative or write to the IBM branch office serving your locality. A form for your comments is provided at the back of this document. If the form has been removed, you may address comments to: IBM Corporation Software Reengineering Department G7IA/ Bldg 503 Research Triangle Park, NC 27709-9990 U.S.A. If you prefer to send comments electronically, use one of the following methods: Fax (USA and Canada): 1-800-254-0206 Internet e-mail: [email protected] World Wide Web: http://www.ibm.com/servers/eserver/zseries/zos/webqs.html IBMLink™: CIBMORCF at RALVM17 IBM Mail Exchange: [email protected] When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. © Copyright International Business Machines Corporation 1990, 2002. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures............................xi Tables............................xiii About this document ......................xv Who should use this document ...................xv Where to find more information ...................xv Where to find related information on the Internet ...........xv Accessing z/OS licensed documents on the Internet ..........xvi Using LookAt to look up message explanations............xvii How to contact IBM service ...................xvii z/OS Communications Server information ..............xvii Summary of changes .....................xxv Chapter 1. Getting started.....................1 Understanding TCP/IP ......................1 Physical network........................1 Protocols ..........................2 Network devices ........................2 Addresses ..........................2 How TCP/IP uses networks.....................2 Local and remote nodes .....................2 Client and server .......................2 TCP/IP addresses .......................3 Network names ........................3 Ports and port numbers .....................3 Understanding what you can do ...................4 Logging on to other hosts ....................4 Transferring data sets between hosts ................4 Sending and receiving mail ....................4 Remote command execution ...................5 Printing to or from other hosts ...................5 What you need to get started ....................6 Testing commands with loopback ..................6 Obtaining command help .....................7 Chapter 2. Logging on to a host using TELNET ............9 Using the TSO TELNET command ..................9 TELNET command ......................10 Using the TELNET subcommands ..................13 AO—Terminate output display ..................14 AYT—Query the connection ...................15 BRK—Send a Break or Attention keystroke to a host ..........16 HELP or ?—Display help information ................17 IP—Interrupt the process ....................18 PA1—Send the PA1 keystroke to a host ..............19 QUIT—End the TELNET session .................20 SYNCH—Clear the data path ..................21 ¢ and `—Send ASCII control characters to a host in line mode ......22 Using the TELNET function keys ..................23 Transparent mode function keys .................23 Line mode function keys ....................23 © Copyright IBM Corp. 1990, 2002 iii Suppressing carriage return and line feed ...............23 Using TELNET 3270 DBCS transform mode ..............24 Terminal and conversion type ..................26 Chapter 3. File Transfer Protocol (FTP) ...............29 Using the FTP command .....................29 FTP command—Enter the FTP environment .............30 Logging in to FTP .......................35 Allocating FTP input and output data sets ..............35 UTF-8 enabled control connection .................36 NETRC data set .......................37 Getting help ..........................37 Establishing and exiting a connection ................38 Example of establishing and exiting a connection ...........38 Initial Working Directory Considerations at the z/OS FTP Server......39 Obtaining status and system information ...............40 Working with directories on the remote host ..............41 Examples of the CD subcommand.................41 Examples showing the differences between DIR and LS output for HFS directories .........................42 Examples showing the differences between DIR and LS output with DIRECTORYMode and DATASetmode for MVS ...........43 Working with directories on the local host ...............45 Security considerations ......................46 Using security mechanisms ...................46 Using a SOCKS server .....................47 Chapter 4. Transferring data using the File Transfer Protocol (FTP) ....49 Preparing the environment ....................49 Transferring data ........................50 How to transfer data ......................50 Examples of GET and MGET subcommands .............51 Examples of PUT and MPUT subcommands .............56 DD name support .......................58 Load Module Transfer (LMTR) ..................60 Changing local site defaults using FTP.DATA ..............63 Statistics for PDS members ...................75 Setting user-level options using FTPS.RC ..............75 Configuring the FTP client for SOCKS server.............76 Sample FTP.DATA data set (FTCDATA) ................77 Using different SBCS translation tables for the control and data connections 85 || Using different MBCS translation tables for the data connection .......85 Specifying values for new data sets .................86 Dynamic allocation ......................86 Storage Management Subsystem (SMS) ..............87 Steps for using a DCBDSN model to create a new data set .......87 Generation data group support ...................88 GDG examples ........................89 Submitting FTP requests in batch ..................91 Submitting requests without input and output data sets .........94 Using the EXEC interface .....................94 Issuing FTP subcommands from a file ...............95 Issuing FTP subcommands directly from the EXEC interface .......96 FTP EXIT return codes ......................97 FTP subcommand codes ....................98 FTP reply codes .......................100 iv z/OS V1R4.0 CS: IP User’s Guide and Commands FTP client error codes.....................100 Restarting a failed data transfer ..................101 Interfacing with JES ......................101 Steps for submitting a job ...................102 Displaying the status of a job ..................103 Receiving spool output ....................104 Deleting a job ........................106 Steps for submitting a job and automatically receiving output ......106 Terminating access to JES ...................107 JESINTERFACELEVEL differences ................107 JES security ........................109 JES examples ........................111 Performing DB2 SQL queries with FTP ...............117 SQL data types supported by FTP ................117 Creating the input data set ...................118 Setting the characteristics for the SQL query ............118 Submitting the query .....................121 Examples of SQL query output .................122 FTP with DBCS support .....................123 Selecting a DBCS translation table ................123 Selecting an SBCS translation table................123 DBCS subcommands .....................124 Server commands and client subcommands.............124 Mapping DBCS aliases to CCSIDs ................125 Chapter 5. FTP subcommands ..................127 ! subcommand—Invoke a z/OS UNIX System Services function ......130 ACcount subcommand—Supply account information ..........131 APpend subcommand—Append a local data set ............132 AScii subcommand—Change the data transfer type to ASCII .......134 BIG5 subcommand—Change the data transfer type to BIG5........135 BINary subcommand—Change the data transfer type to Image ......137 BLock subcommand—Set the block data transfer mode .........138 CCc subcommand—Turn off integrity protection ............139 CD subcommand—Change the directory on the remote host .......140 CDUp subcommand—Change to the parent of the working directory.....143 CLEar subcommand—Set the protection level for data transfers to CLEAR 145 CLose subcommand—Disconnect from a remote host ..........146 COMpress subcommand—Set the compressed data transfer mode .....147 CProtect subcommand— Set the protection level on commands ......148 DEBug subcommand—Set general trace options ............149 DELEte subcommand—Delete files .................153 DELImit subcommand—Display the file name delimiter..........154 DIr subcommand—Obtain a list of directory entries ...........155 DUMP subcommand—Set extended trace options ...........159 EBcdic subcommand—Change the data transfer type to EBCDIC ......161 EUckanji subcommand—Change