VSI OpenVMS VSI TCP/IP Services for OpenVMS User's Guide Document Number: DO-TCPUSR-01A Publication Date: September 2020 Revision Update Information: This is a new manual. Operating System and Version: VSI OpenVMS Integrity Version 8.4-2 VSI OpenVMS Alpha Version 8.4-2L1 Software Version: VSI TCP/IP Services Version 5.7 VMS Software, Inc. (VSI) Burlington, Massachusetts, USA VSI TCP/IP Services for OpenVMS User's Guide Copyright © 2020 VMS Software, Inc. (VSI), Burlington, Massachusetts, USA Legal Notice Confidential computer software. Valid license from VSI 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 VSI 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. VSI shall not be liable for technical or editorial errors or omissions contained herein. HPE, HPE Integrity, HPE Alpha, and HPE Proliant are trademarks or registered trademarks of Hewlett Packard Enterprise. Intel, Itanium and IA-64 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. The VSI OpenVMS documentation set is available on DVD. ii VSI TCP/IP Services for OpenVMS User's Guide Preface ................................................................................................................................... vii 1. About VSI .................................................................................................................... vii 2. Intended Audience ........................................................................................................ vii 3. Document Structure ...................................................................................................... vii 4. Related Documents ...................................................................................................... viii 5. VSI Encourages Your Comments .................................................................................... ix 6. Conventions ................................................................................................................... ix Chapter 1. Getting Started ................................................................................................... 1 1.1. Which Service Should You Use? .................................................................................. 3 1.1.1. Services for Working with Files ......................................................................... 5 1.1.2. Services for Remote Logins ............................................................................... 5 1.1.3. Services for Issuing Commands at a Remote Host ............................................... 6 1.2. Client/Server Software .................................................................................................. 6 1.3. User Commands ........................................................................................................... 7 1.4. Command Syntax ......................................................................................................... 8 1.5. Online Help ............................................................................................................... 10 Chapter 2. Working with Files Using the File Transfer Protocol (FTP) ........................ 13 2.1. Using FTP Commands ............................................................................................... 16 2.1.1. DCL and UNIX Command Syntax ................................................................... 16 2.1.2. Quotation Marks .............................................................................................. 17 2.1.3. Wildcards ........................................................................................................ 17 2.1.4. Qualifiers ........................................................................................................ 18 2.2. Obtaining Online Help ............................................................................................... 18 2.3. Starting FTP Sessions ................................................................................................. 19 2.3.1. Making a Remote Connection .......................................................................... 19 2.3.2. Anonymous User Access (Anonymous FTP) ..................................................... 20 2.4. Exiting FTP ............................................................................................................... 21 2.5. Viewing Directories on the Remote Host ..................................................................... 22 2.6. Displaying and Changing the Default Directory ........................................................... 22 2.7. Creating and Deleting Directories ............................................................................... 23 2.8. Copying Files ............................................................................................................. 23 2.8.1. Using the GET Command to Copy Remote Files to the Local Host ..................... 23 2.8.2. Using the PUT Command to Copy Local Files to the Remote Host ..................... 24 2.8.3. How FTP Copies Files ..................................................................................... 25 2.8.4. Using the Store Unique Feature ........................................................................ 26 2.8.5. Transferring Files Between OpenVMS Hosts: VMS Plus Mode .......................... 26 2.8.6. Preserving OpenVMS File Attributes ................................................................ 26 2.8.7. Transfer Mode ................................................................................................. 28 2.8.8. File Structure ................................................................................................... 28 2.9. Renaming and Deleting Files ...................................................................................... 28 2.10. Viewing the Contents of a File .................................................................................. 28 2.11. Appending Files ....................................................................................................... 29 2.12. Suspending FTP to Return to the Local DCL Prompt ................................................. 29 2.13. Customizing FTP Command Processing .................................................................... 30 2.14. Command Procedures ............................................................................................... 31 2.14.1. Task Command Files ..................................................................................... 31 2.14.2. Initialization Command File ........................................................................... 32 2.14.3. Setting Error Level ........................................................................................ 33 2.15. Using FTP with DECnet ........................................................................................... 34 2.16. Command Descriptions ............................................................................................. 34 Chapter 3. Using Remote (R) Commands ........................................................................ 63 iii VSI TCP/IP Services for OpenVMS User's Guide 3.1. Providing Account and Password Information .............................................................. 63 3.1.1. Quotation Marks .............................................................................................. 65 3.1.2. Examples ........................................................................................................ 65 3.2. Specifying Qualifiers .................................................................................................. 65 3.3. Obtaining Online Help ............................................................................................... 66 3.4. Copying Files with RCP ............................................................................................. 66 3.4.1. Notes About File Formats ................................................................................ 67 3.4.2. Notes About File Size ...................................................................................... 67 3.4.3. Example RCP Commands ................................................................................ 67 3.5. Starting a Remote Login Session with RLOGIN .......................................................... 68 3.5.1. Logging Out .................................................................................................... 68 3.5.2. Example RLOGIN Sessions ............................................................................. 68 3.6. Issuing a Remote Command with RSH ....................................................................... 69 3.6.1. Quotation Marks in Commands ........................................................................ 69 3.6.2. Interrupting a Command's Execution ................................................................ 70 3.6.3. Example RSH Commands ...............................................................................