Copyright © 1996–2013 by CSI International All Rights Reserved RESTRICTED RIGHTS LEGEND Use, duplication, or disclosure by the Government is subject to the restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. This material contains confidential and proprietary material of Connectivity Systems, Inc. (hereafter referred to as CSI International and CSI) and may not be used in any way without written authorization from CSI International. This material may not be reproduced, in whole or in part, in any way, without prior written permission from CSI International. Permission is hereby granted to copy and distribute this document as follows: • Each copy must be a complete and accurate copy. • All copyright notices must be retained. • No modifications may be made. • Use of each copy is restricted to the evaluation and/or promotion of CSI International’s TCP/IP FOR VSE product or in accordance with a license agreement. TCP/IP FOR VSE User Guide Version 1 Release 5F March 2013 Published by CSI International 8120 State Route 138 Williamsport OH 43164 Phone: 800-795-4914 Fax: 740-986-6022 Internet: http://www.csi-international.com E-mail: [email protected] Technical Support: [email protected] Documentation comments: [email protected] CSI International Technical Support and Technical Support Escalation CSI Product Technical Support During Business Hours Monday through Friday, 9:00 A.M. through 5:00 P.M. EST/EDT • Telephone Toll Free in the USA: 800-795-4914 Worldwide: 740-420-5400 •E-mail Questions: [email protected] • Web http://csi-international.com/problemreport_vse.htm Emergency Service After business hours, and 24 hours on Saturday and Sunday (24/7) • Telephone1 Toll Free in the USA: 800-795-4914 Worldwide: 740-420-5400 Escalating Technical Issues Business Hours Monday through Friday, 9:00 A.M. through 5:00 P.M. EST/EDT Request support escalation by the telephone numbers or e-mail address listed below. 1. Calls are automatically transferred to a 24/7 answering service that forwards all calls based on severity. Copyright © 2013 by CSI International i CSI International Technical Support • Telephone Toll Free in the USA: 800-795-4914 Worldwide: 740-420-5400 •E-mail Escalation: [email protected] After Hours (SEV1) 1. Call one of the following telephone numbers. Toll Free in the USA: 800-795-4914 Worldwide: 740-420-5400 2. Tell the operator that you have a “SEV1” issue. The answering service will follow the following chain: a. Technical Support Rep(s) b. Product Developer (if necessary) c. Technical Support Manager (if necessary) d. Development Manager (if necessary) e. Chief Operating Officer (if necessary) f. Chief Executive Officer (if necessary) 3. Calls continue until the best person to resolve your issue is contacted. Copyright © 2013 by CSI International ii Updates The following tables identify updates to the TCP/IP for VSE User Guide. These updates are associated with incidents in the CSI support database. Recent changes on each page are indicated by a change bar in the margin. Published March 2013 Change ID Topic Description Page(s) F007163 FTP Updated the MAXACTIVE 2.24 parameter description to include the default value (16) F007178 FTP Updated the SETVAR command 2.34, 2.99 description to explain how VSE SETPARM variables must be assigned with SETVAR before they can be used in FTPBATCH commands F007172 FTP Updated the SETVAR command 2.99 description to specify a variable’s maximum length (49 characters) F007168 EMAIL Updated the ATTACH and 6.20, 6.26 SEND command descriptions to add autonomous-file support Copyright © 2013 by CSI International iii TCP-IP FOR VSE 1.5F User Guide Updates Published 7/8/2011 Change ID Topic Description Page(s) F007100 FTP Added note explaining the 2.22 correct use of the continuation character (-) in batch files F007090 FTP Clarified the SET IGNORERR 2.30 command description for FTPBATCH F007105 FTP, Updated the variables table for 2.39, 4.7, 6.8 LPR, auto event processing in FTP and EMAIL added similar tables for LPR and EMAIL F007092 FTP Added table to indicate 2.48 applicable record formats for each autonomous file type F007096 FTP Added note on the 2.48 LOCAL_DLBL command F007093 LPR Added SET command 4.17−4.70 descriptions related to formatting control F007076 LPR Updated PRINT command: 4.28 multiple reports F007104 PING Added note explaining how to 5.4 select a stack ID when running ping, traceroute, or DISCOVER as a CICS transaction F007101 EMAIL Corrected the SET 6.29 ATTACHFAIL description F007106 EMAIL Corrected the SET DISP 6.35 description Published 10/27/2010 Change ID Topic Description Page(s) F007081 FTP Added note: use SET commands 2.27 before LOPEN F007087 FTP Added new section on 2.47−2.52 autonomous file syntax F007082 FTP Added note on 2.48 BIM-EPIC-controlled autonomous files: the recfm, lrecl, and blksize values must be omitted from the syntax Copyright © 2013 by CSI International iv TCP-IP FOR VSE 1.5F User Guide Updates Published 7/13/2010 Change ID Topic Description Page(s) F007078 FTP Updated the FTPBATCH 2.23−2.33 parameter and SET command descriptions F007066 FTP Clarified the SET EXTRADAT 2.29 description and the related message ID F007070 FTP Added a description of SET 2.33 TELNTRAN, which sets the control-connection translate table in FTPBATCH jobs F007067 LPR Added descriptions of SET 4.47, 4.49, INFOPRINT, SET FORMDEF, 4.54, 4.68 and SET PAGEDEF commands F007068 EMAIL Clarified the valid values for 6.13, 6.13 QUIET=YES and other EXEC EMAIL parameters F007073 EMAIL Added a note listing disallowed 6.28 EOD characters in the TEXT command when calling the EMAIL client from within a REXX program F007074 REXEC Added a description of the SET 7.7, 7.9 TIMEOUT command, which may be used to increase the connection timeout period Copyright © 2013 by CSI International v TCP-IP FOR VSE 1.5F User Guide Updates Copyright © 2013 by CSI International vi Contents CSI International Technical Support and Technical Support Escalation .................. i Updates.......................................................................................................................... iii Chapter 1: Getting Started ........................................................................................ 1.1 Introduction..............................................................................................................................1.1 Chapter 2: FTP ........................................................................................................... 2.1 Protocol Background................................................................................................................2.1 File Transfer Concepts .............................................................................................................2.3 Ports ...................................................................................................................................2.4 UNIX Emulation Mode .....................................................................................................2.5 Entering UNIX Mode ...................................................................................................2.6 Data Translation .................................................................................................................2.7 Translation Constraints .................................................................................................2.7 VSE Directory Output .......................................................................................................2.8 Root Directory ..............................................................................................................2.9 Library Files ...............................................................................................................2.11 VSE Sublibraries ........................................................................................................2.12 POWER Files .............................................................................................................2.13 VSAM Catalogs ..........................................................................................................2.14 HFS Files ....................................................................................................................2.15 Mechanics of Transferring a File .....................................................................................2.15 Diagnosing FTP Hangs ....................................................................................................2.16 FTP as a Client on VSE .........................................................................................................2.17 Internal FTP Client.................................................................................................................2.18 Starting the Client ............................................................................................................2.18 Parameters ........................................................................................................................2.19 UPSI Switches .................................................................................................................2.20 Copyright © 2013 by CSI International vii TCP-IP FOR VSE 1.5F User Guide Contents Command Variables ........................................................................................................2.20