FTP

z/OS Communications Server
IP User’s Guide and Commands

Version 1 Release 9
SC31-8780-07
z/OS Communications Server
IP User’s Guide and Commands

Version 1 Release 9
SC31-8780-07
Note:
Before using this information and the product it supports, be sure to read the general information under “Notices” on page
471.
Eighth Edition (September 2007)

This edition applies to Version 1 Release 9 of z/OS (5694-A01) and to all subsequent releases and modifications
until otherwise indicated in new editions.
IBM welcomes your comments. You may send your comments to the following address.
International Business Machines Corporation
Attn: z/OS Communications Server Information Development
Department AKCA, Building 501
P.O. Box 12195, 3039 Cornwallis Road
Research Triangle Park, North Carolina 27709-2195
You can send us comments electronically by using one of the following methods:
Fax (USA and Canada):
1+919-254-1258
Send the fax to “Attn: z/OS Communications Server Information Development”
Internet e-mail:
comsvrcf@us.ibm.com
World Wide Web:
http://www.ibm.com/servers/eserver/zseries/zos/webqs.html
If you would like a reply, be sure to include your name, address, telephone number, or FAX number. Make sure to
include the following in your comment or note:
v Title and order number of this document
v Page number or topic related to your comment
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, 2007. 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 read this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
How to use this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi
Determining whether a publication is current . . . . . . . . . . . . . . . . . . . . . . . xvi
How to contact IBM service . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii
Conventions and terminology used in this document . . . . . . . . . . . . . . . . . . . . . xvii
Clarification of notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii
How to read a syntax diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii
Symbols and punctuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii
Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii
Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Syntax examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Longer than one line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Required operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Optional values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx
Selecting more than one operand . . . . . . . . . . . . . . . . . . . . . . . . . . . xx
Nonalphanumeric characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx
Blank spaces in syntax diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . xx
Default operands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx
Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
Syntax fragments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
Prerequisite and related information . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
Required information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
Related information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
Softcopy information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi
Other documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii
Where to find related information on the Internet . . . . . . . . . . . . . . . . . . . . . xxiii
DNS Web sites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv
Using LookAt to look up message explanations . . . . . . . . . . . . . . . . . . . . . . xxv
Using IBM Health Checker for z/OS . . . . . . . . . . . . . . . . . . . . . . . . . xxv
How to send your comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvi
Summary of changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvii
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
© Copyright IBM Corp. 1990, 2007 iii

Transferring data sets between hosts . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Sending and receiving mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Remote command execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Printing to or from other hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
What you need to get started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Testing commands with loopback . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
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
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 FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
FTP command — Entering the FTP environment . . . . . . . . . . . . . . . . . . . . . . 30
Logging in to FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Interpreting FTP client output . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Allocating FTP input and output data sets . . . . . . . . . . . . . . . . . . . . . . . . 38
UTF-8 enabled control connection . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
NETRC data set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Getting help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Establishing and exiting a connection . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Example of establishing and exiting a connection . . . . . . . . . . . . . . . . . . . . . . 42
Initial working directory considerations at the z/OS FTP server . . . . . . . . . . . . . . . . . 42
Obtaining status and system information . . . . . . . . . . . . . . . . . . . . . . . . . 44
Working with directories on the remote host . . . . . . . . . . . . . . . . . . . . . . . . 44
Examples of the CD subcommand . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Examples showing the differences between DIR and LS output for z/OS UNIX directories . . . . . . . . 45
Examples showing the differences between DIR and LS output with DIRECTORYMode and DATASetmode for
MVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Working with directories on the local host . . . . . . . . . . . . . . . . . . . . . . . . . 49
Security considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Using security mechanisms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Using a SOCKS server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Chapter 4. Transferring data using the File Transfer Protocol (FTP) . . . . . . . . . 53

Preparing the environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Transferring data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
How to transfer data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Examples of GET and MGET subcommands . . . . . . . . . . . . . . . . . . . . . . . 56
Examples of PUT and MPUT subcommands . . . . . . . . . . . . . . . . . . . . . . . 62
ddname support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Load module transfer (LMTR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
iv z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

Changing local site defaults using FTP.DATA . . . . . . . . . . . . . .
. 70 . . . . . . . . .
Setting user-level options using FTPS.RC . . . . . . . . . . . . . .
. 71 . . . . . . . . .
Configuring the FTP client for SOCKS server . . . . . . . . . . . . .
. 72 . . . . . . . . .
Sample FTP.DATA data set (FTCDATA) . . . . . . . . . . . . . . . .
. 72 . . . . . . . . .
FTP data conversion . . . . . . . . . . . . . . . . . . . . . .
. 86 . . . . . . . . .
Support for SBCS languages . . . . . . . . . . . . . . . . . . .
. 86 . . . . . . . . .
FTP with traditional DBCS support . . . . . . . . . . . . . . . .
. 87 . . . . . . . . .
Support for MBCS languages . . . . . . . . . . . . . . . . . .
. 90 . . . . . . . . .
Specifying values for new data sets . . . . . . . . . . . . . . . . .
. 91 . . . . . . . . .
Dynamic allocation . . . . . . . . . . . . . . . . . . . . . .
. 91 . . . . . . . . .
Automatically generated SITE subcommand . . . . . . . . . . . . .
. 92 . . . . . . . . .
Storage Management Subsystem (SMS) . . . . . . . . . . . . . . .
. 92 . . . . . . . . .
Steps for using a DCBDSN model to create a new data set . . . . . . . .
. 93 . . . . . . . . .
Statistics for PDS members . . . . . . . . . . . . . . . . . . . .
. 94 . . . . . . . . .
Generation data group support . . . . . . . . . . . . . . . . . . .
. 94 . . . . . . . . .
GDG examples . . . . . . . . . . . . . . . . . . . . . . .
. 96 . . . . . . . . .
Submitting FTP requests in batch . . . . . . . . . . . . . . . . . .
. 98 . . . . . . . . .
Submitting requests without input and output data sets . . . . . . . . . . . . . . . . . . . 101
| Submitting a batch job with concatenated files . . . . . . . . . . . . . . . . . . . . . . 101
FTP and data set cataloging . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Using the EXEC interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Issuing FTP subcommands from a file . . . . . . . . . . . . . . . . . . . . . . . . . 102
Issuing FTP subcommands directly from the EXEC interface. . . . . . . . . . . . . . . . . . 104
FTP return codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
FTP standard return codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
FTP client error codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
FTP client error codes extended . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
FTP client error logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Restarting a failed data transfer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Interfacing with JES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Steps for submitting a job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Displaying the status of a job . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Receiving spool output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Deleting a job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Steps for submitting a job and automatically receiving output . . . . . . . . . . . . . . . . . 118
Terminating access to JES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
JESINTERFACELEVEL differences . . . . . . . . . . . . . . . . . . . . . . . . . . 120
JES security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
JES examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Performing DB2 SQL queries with FTP . . . . . . . . . . . . . . . . . . . . . . . . . . 129
SQL data types supported by FTP . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Creating the input data set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Setting the characteristics for the SQL query . . . . . . . . . . . . . . . . . . . . . . . 130
Submitting the query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Examples of SQL query output . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Chapter 5. FTP subcommands . . . . . . . . . . . . . . . . . . . . . . . . . 137

! subcommand—Invoke a z/OS UNIX System Services function . . . . . . . . . . . . . . . . . 142
ACCt subcommand—Supply account information . . . . . . . . . . . . . . . . . . . . . . 143
APpend subcommand—Append a local data set. . . . . . . . . . . . . . . . . . . . . . . 144
AScii subcommand—Change the data transfer type to ASCII . . . . . . . . . . . . . . . . . . 146
| AUth subcommand—Request security mechanism . . . . . . . . . . . . . . . . . . . . . . 147
BIG5 subcommand—Change the data transfer type to BIG5 . . . . . . . . . . . . . . . . . . . 148
BINary subcommand—Change the data transfer type to Image . . . . . . . . . . . . . . . . . . 150
BLock subcommand—Set the block data transfer mode . . . . . . . . . . . . . . . . . . . . 151
CCc subcommand—Turn off integrity protection . . . . . . . . . . . . . . . . . . . . . . 152
CD subcommand—Change the directory on the remote host . . . . . . . . . . . . . . . . . . 153
CDUp subcommand—Change to the parent of the working directory . . . . . . . . . . . . . . . 156
CLEar subcommand—Set the protection level for data transfers to CLEAR . . . . . . . . . . . . . . 158
CLose subcommand—Disconnect from a remote host . . . . . . . . . . . . . . . . . . . . . 159
COMpress subcommand—Set the compressed data transfer mode . . . . . . . . . . . . . . . . . 160
Contents v
CProtect subcommand— Set the protection level on commands . . . . . . . . . . . . . . . . . 161
DEBug subcommand—Set general trace options . . . . . . . . . . . . . . . . . . . . . . . 162
DELEte subcommand—Delete files . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
DELImit subcommand—Display the file name delimiter . . . . . . . . . . . . . . . . . . . . 167
DIr subcommand—Obtain a list of directory entries . . . . . . . . . . . . . . . . . . . . . 168
DUMP subcommand—Set extended trace options . . . . . . . . . . . . . . . . . . . . . . 173
EBcdic subcommand—Change the data transfer type to EBCDIC . . . . . . . . . . . . . . . . . 175
EUckanji subcommand—Change the data transfer type to EUCKANJI . . . . . . . . . . . . . . . 176
FEature subcommand—Query FTP server for features it supports . . . . . . . . . . . . . . . . . 178
FIle subcommand—Set the file structure to File . . . . . . . . . . . . . . . . . . . . . . . 179
Get subcommand—Copy files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
GLob subcommand—Toggle expansion of metacharacters . . . . . . . . . . . . . . . . . . . 182
HAngeul subcommand—Change the data transfer type to HANGEUL . . . . . . . . . . . . . . . 184
HElp and ? subcommands—Display help information . . . . . . . . . . . . . . . . . . . . . 186
Ibmkanji subcommand—Change the data transfer type to IBMKANJI . . . . . . . . . . . . . . . 187
JIS78kj subcommand—Change the data transfer type to JIS78KJ . . . . . . . . . . . . . . . . . 188
JIS83kj subcommand—Change the data transfer type to JIS83KJ . . . . . . . . . . . . . . . . . 189
Ksc5601 subcommand—Change the data transfer type to KSC-5601 . . . . . . . . . . . . . . . . 190
LANGuage subcommand—Set the language used for FTP replies from the server . . . . . . . . . . . 192
LCd subcommand—Change the local working directory . . . . . . . . . . . . . . . . . . . . 193
LOCSIte subcommand—Specify site information to the local host . . . . . . . . . . . . . . . . . 195
LOCSTat subcommand—Display local status information . . . . . . . . . . . . . . . . . . . . 218
LMkdir subcommand—Create a directory on the local host . . . . . . . . . . . . . . . . . . . 225
LPwd subcommand—Display the current working-level qualifier . . . . . . . . . . . . . . . . . 228
LS subcommand—Obtain a list of file names . . . . . . . . . . . . . . . . . . . . . . . . 229
MDelete subcommand—Delete multiple files . . . . . . . . . . . . . . . . . . . . . . . . 232
MGet subcommand—Copy multiple files . . . . . . . . . . . . . . . . . . . . . . . . . 235
MKdir subcommand—Create a directory on the remote host . . . . . . . . . . . . . . . . . . 239
MOde subcommand—Set the data transfer mode . . . . . . . . . . . . . . . . . . . . . . 242
MPut subcommand—Copy multiple data sets to the remote host . . . . . . . . . . . . . . . . . 243
NOop subcommand—Test the connection . . . . . . . . . . . . . . . . . . . . . . . . . 246
Open subcommand—Connect to the FTP server . . . . . . . . . . . . . . . . . . . . . . . 247
PAss subcommand—Supply a password . . . . . . . . . . . . . . . . . . . . . . . . . 248
PRIvate subcommand—Set the protection level for data transfers to PRIVATE . . . . . . . . . . . . . 249
PROMpt subcommand—Toggle interactive prompting for M* commands . . . . . . . . . . . . . . 250
PROTect subcommand—Set the protection level for data transfers . . . . . . . . . . . . . . . . . 251
PROXy subcommand—Execute FTP subcommand on secondary control connections . . . . . . . . . . 252
PUt subcommand—Copy data sets to the remote host . . . . . . . . . . . . . . . . . . . . . 255
PWd subcommand—Display the current working directory . . . . . . . . . . . . . . . . . . . 257
QUIt subcommand—Leave the FTP environment . . . . . . . . . . . . . . . . . . . . . . 258
QUOte subcommand—Send an uninterpreted string of data . . . . . . . . . . . . . . . . . . . 259
RECord subcommand—Set the file structure to record . . . . . . . . . . . . . . . . . . . . . 261
REName subcommand—Rename files . . . . . . . . . . . . . . . . . . . . . . . . . . 262
REStart subcommand—Restart a checkpointed data transfer . . . . . . . . . . . . . . . . . . . 263
RMdir subcommand—Remove a directory on the remote host . . . . . . . . . . . . . . . . . . 264
SAfe subcommand—Set the protection level to safe. . . . . . . . . . . . . . . . . . . . . . 265
SChinese subcommand—Change the data transfer type to SCHINESE . . . . . . . . . . . . . . . 266
SENDPort subcommand—Toggle the sending of port information . . . . . . . . . . . . . . . . . 268
SENDSite subcommand—Toggle the sending of site information . . . . . . . . . . . . . . . . . 269
SIte subcommand—Send site-specific information to a host . . . . . . . . . . . . . . . . . . . 270
SJiskanji subcommand—Change the data transfer type to SJISKANJI . . . . . . . . . . . . . . . . 297
SRestart subcommand—Restart a stream data transfer . . . . . . . . . . . . . . . . . . . . . 299
STAtus subcommand—Retrieve status information from a remote host . . . . . . . . . . . . . . . 301
STREam subcommand—Set the stream data transfer mode . . . . . . . . . . . . . . . . . . . 308
STRucture subcommand—Set the file structure . . . . . . . . . . . . . . . . . . . . . . . 309
SUnique subcommand—Changes the storage method . . . . . . . . . . . . . . . . . . . . . 310
SYstem subcommand—Display the operating system name . . . . . . . . . . . . . . . . . . . 311
TChinese subcommand—Change the data transfer type to TCHINESE . . . . . . . . . . . . . . . 312
TSO subcommand—Use TSO commands . . . . . . . . . . . . . . . . . . . . . . . . . 314
TYpe subcommand—Set the data transfer type . . . . . . . . . . . . . . . . . . . . . . . 315
UCs2 subcommand—Change data transfer type to Unicode UCS-2 . . . . . . . . . . . . . . . . 319
vi z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

User subcommand—Identify yourself to a host or change your TSO user ID password . . . . . . . . . . 320
Verbose subcommand—Toggle verbose mode . . . . . . . . . . . . . . . . . . . . . . . 322
Chapter 6. Sending electronic mail using SMTP commands . . . . . . . . . . . . 323

Interfaces to the SMTP address space . . . . . . . . . . . . . . . . . . . . . . . . . . 323
Using the SMTPNOTE command from your terminal . . . . . . . . . . . . . . . . . . . . . 324
SMTPNOTE command—Send electronic mail to one or more recipients on NJE or TCP networks . . . . . 325
Preparing and sending mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
Undelivered notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
SMTP exit for unwanted mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Monitoring the status of SMTP using the TSO SMSG command . . . . . . . . . . . . . . . . . 330
SMSG SMTP command for the general user . . . . . . . . . . . . . . . . . . . . . . . 331
| SMSG SMTP command for the authorized user . . . . . . . . . . . . . . . . . . . . . . 334
Electronic mail gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
SMTP commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
DATA command—Define the following information as data . . . . . . . . . . . . . . . . . . 339
EXPN command—Verify whether a mailbox exists on the local host . . . . . . . . . . . . . . . 341
HELO command—Identify the domain name of the sending host to SMTP . . . . . . . . . . . . . 342
HELP command—Get help with SMTP commands . . . . . . . . . . . . . . . . . . . . . 343
MAIL FROM command—Specify the sender of the mail . . . . . . . . . . . . . . . . . . . 344
NOOP command—Return a 250 OK return code when SMTP is responding . . . . . . . . . . . . 345
QUEU command—Get information about mail queued at SMTP for delivery . . . . . . . . . . . . 346
QUIT command—End an SMTP connection . . . . . . . . . . . . . . . . . . . . . . . 348
RCPT TO command—Specify the recipients of the mail . . . . . . . . . . . . . . . . . . . 349
RSET command—Reset the SMTP connection to the initial state . . . . . . . . . . . . . . . . 350
TICK command—Insert an identifier into the batch SMTP response data set . . . . . . . . . . . . 351
VERB command—Enable or disable verbose mode . . . . . . . . . . . . . . . . . . . . . 352
VRFY command—Verify whether a mailbox exists on the local host . . . . . . . . . . . . . . . 353
SMTP responses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
Batch SMTP examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
Using batch SMTP command in TSO utilities . . . . . . . . . . . . . . . . . . . . . . . . 356
SMTP with DBCS support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
Conversion of DBCS mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
Chapter 7. Sending electronic mail using z/OS UNIX sendmail . . . . . . . . . . . 359

sendmail command—Send file contents . . . . . . . . . . . . . . . . . . . . . . . . . 360
Chapter 8. Using remote printing . . . . . . . . . . . . . . . . . . . . . . . . 363

LPQ command—Request a list of the printer queue on a remote printer . . . . . . . . . . . . . . . 364
LPR command—Print to a remote printer . . . . . . . . . . . . . . . . . . . . . . . . . 366
LPRM command—Remove a job from the printer queue on a remote host . . . . . . . . . . . . . . 379
LPRSET command—Set the default printer and host name . . . . . . . . . . . . . . . . . . . 381
TSO SMSG command—Monitoring the Status of LPD . . . . . . . . . . . . . . . . . . . . . 383
Chapter 9. Using GDDMXD/MVS with the X Window System . . . . . . . . . . . . 385

Overview of GDDMXD/MVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
Keyboard and character set mappings . . . . . . . . . . . . . . . . . . . . . . . . . 385
Executable code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
GDDM application limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
GDDM display limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
Using GDDMXD/MVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
GDDMXD command—Invoke the GDDMXD CLIST . . . . . . . . . . . . . . . . . . . . 388
Identifying the target display . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
GDDMXD usage notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
Resizing the GDDMXD graphics window . . . . . . . . . . . . . . . . . . . . . . . . 390
User-specified options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
ANFontn option—Specify the X Window System font used for characters in the alphanumeric presentation
space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
CMap option—Specify whether the default color map is loaded or bypassed . . . . . . . . . . . . 393
Compr option—Control the technique used to compress bit-mapped data . . . . . . . . . . . . . 394
Contents vii
Enter option—Override the default key mapping for Enter . . . . . . . . . . . . . . . . . . 395
GColornn option—Specify a color name . . . . . . . . . . . . . . . . . . . . . . . . 396
Geometry option—Specify the size and location of the initial GDDMXD graphics presentation space . . . . 397
GMCPnn option—Override GDDM multicolor patterns with workstation color names . . . . . . . . . 398
HostRast option—Perform raster image processing at the System/370 host . . . . . . . . . . . . . 399
NewLine option—Override the default key mapping for NewLine . . . . . . . . . . . . . . . 400
XSync option—Request that the X Window System process one request at a time . . . . . . . . . . 401
ZWL option—Tell GDDMXD/MVS to draw all lines using 0-width lines . . . . . . . . . . . . . 402
Keyboard functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
GDDMXD/MVS keyboard functions . . . . . . . . . . . . . . . . . . . . . . . . . 403
GDDMXD/MVS to X Window System keyboard functions . . . . . . . . . . . . . . . . . . 403
APL2 character set keyboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Setting up hlq.GDXAPLCS.MAP . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Chapter 10. Executing commands on a remote host . . . . . . . . . . . . . . . . 405

REXEC command—Execute a command on the remote host and receive the results on your local host . . . . 406
Using the NETRC data set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
Submitting REXEC and RSH requests in batch . . . . . . . . . . . . . . . . . . . . . . . 409
RSH command—Execute a command on a remote host and receive the results on your local host . . . . . 413
RHOSTS.DATA data set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
Using remote execution clients in a z/OS UNIX environment . . . . . . . . . . . . . . . . . . 415
The z/OS UNIX orexec/rexec command—Execute a command on the remote host . . . . . . . . . . 417
The z/OS UNIX orsh/rsh Command—Execute a Command on the remote host . . . . . . . . . . . 419
Chapter 11. Using the Network Database System . . . . . . . . . . . . . . . . . 421

NDBCLNT command—Issue SQL statements to a DB2 subsystem . . . . . . . . . . . . . . . . . 422
SQL statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
NDB commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
Return codes for NDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
Format of output displayed on the client . . . . . . . . . . . . . . . . . . . . . . . . . 428
Appendix A. Specifying data sets and files. . . . . . . . . . . . . . . . . . . . 429

MVS data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
Sequential data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
Partitioned data sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
Transferring data between partitioned and sequential data sets . . . . . . . . . . . . . . . . . 431
Data transfer methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
Transferring PDS directory information . . . . . . . . . . . . . . . . . . . . . . . . . 432
AIX and UNIX files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
AS/400 operating system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
VM files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
Appendix B. Mapping values for the APL2 character set . . . . . . . . . . . . . . 435
Appendix C. TELNET extensions . . . . . . . . . . . . . . . . . . . . . . . . 441

Character set cross reference table . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
Special key operation for TELNET . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
Operation of PF and PA keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
Sense codes for special key operation . . . . . . . . . . . . . . . . . . . . . . . . . . 446
Appendix D. Related protocol specifications . . . . . . . . . . . . . . . . . . . 449

Internet drafts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
Appendix E. Information APARs and technotes . . . . . . . . . . . . . . . . . . 465

Information APARs for IP documents . . . . . . . . . . . . . . . . . . . . . . . . . . 465
Information APARs for SNA documents . . . . . . . . . . . . . . . . . . . . . . . . . 466
Other information APARs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
Appendix F. Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
viii z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

Using assistive technologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
Keyboard navigation of the user interface . . . . . . . . . . . . . . . . . . . . . . . . . 469
z/OS information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
Bibliography . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
z/OS Communications Server information . . . . . . . . . . . . . . . . . . . . . . . . 481
z/OS Communications Server library . . . . . . . . . . . . . . . . . . . . . . . . . 481
Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
Resource definition, configuration, and tuning . . . . . . . . . . . . . . . . . . . . . . 481
Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
Writing application programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
Diagnosis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
Messages and codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
Communicating Your Comments to IBM . . . . . . . . . . . . . . . . . . . . . 495
Contents ix
x z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands
Figures
1. Sample output of the MORE program—first screen . . . . . . . . . . . . . . . . . . . . 24
2. Sample output of the MORE program—second screen . . . . . . . . . . . . . . . . . . . 24
3. FTP.DATA for FTP client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
4. JCL to run FTP in batch using data sets . . . . . . . . . . . . . . . . . . . . . . . . 100
5. Contents of an INPUT DD data set . . . . . . . . . . . . . . . . . . . . . . . . . 100
6. JCL to run FTP in batch without using data sets . . . . . . . . . . . . . . . . . . . . . 101
7. Job to create a new GDS in batch . . . . . . . . . . . . . . . . . . . . . . . . . . 101
| 8. Submitting an FTP batch job with concatenated input . . . . . . . . . . . . . . . . . . . 101
9. How to issue the FTP subcommands from a data set . . . . . . . . . . . . . . . . . . . 103
10. How to issue the FTP subcommands from a z/OS UNIX file system . . . . . . . . . . . . . . 103
11. How to issue FTP subcommands from an EXEC . . . . . . . . . . . . . . . . . . . . . 104
12. How FTP subcommands can be solicited interactively from an EXEC . . . . . . . . . . . . . . 105
13. SMTP gateway overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
14. Example of preparing and sending mail . . . . . . . . . . . . . . . . . . . . . . . 327
15. TSO RECEIVE command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
16. Example of a nondelivery note . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
17. Example of an unknown recipient note . . . . . . . . . . . . . . . . . . . . . . . . 329
18. SMTP as a mail gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
© Copyright IBM Corp. 1990, 2007 xi

xii z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands
Tables
1. TELNET subcommands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2. ASCII control characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
3. TELNET function keys in line mode . . . . . . . . . . . . . . . . . . . . . . . . . 23
4. Environment variables accessed by FTP . . . . . . . . . . . . . . . . . . . . . . . . 41
5. FTP subcommands for getting help . . . . . . . . . . . . . . . . . . . . . . . . . 41
6. FTP subcommands for establishing and exiting a connection . . . . . . . . . . . . . . . . . 41
7. FTP subcommands for obtaining status and system information . . . . . . . . . . . . . . . . 44
8. FTP subcommands for working with directories on the remote host . . . . . . . . . . . . . . . 44
9. FTP subcommands for working with directories on the local host . . . . . . . . . . . . . . . 49
| 10. Important differences between the draft level and the RFC level . . . . . . . . . . . . . . . . 51
11. FTP subcommands for preparing the environment . . . . . . . . . . . . . . . . . . . . 53
12. FTP subcommands for transferring data . . . . . . . . . . . . . . . . . . . . . . . . 55
13. Recommended methods for data transfer . . . . . . . . . . . . . . . . . . . . . . . 55
14. FTP client search orders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
15. FTP subcommands for DBCS support . . . . . . . . . . . . . . . . . . . . . . . . . 88
16. FTP TYPE subcommand aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
17. Mapping of DBCS keywords to CCSIDs . . . . . . . . . . . . . . . . . . . . . . . . 90
18. FTP subcommand codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
19. Client error codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
20. FTP subcommands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
21. SMTP commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
22. Remote printing commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
23. Supported graphics presentation space sizes . . . . . . . . . . . . . . . . . . . . . . 390
24. GDDMXD/MVS options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
25. GColors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
26. Recommended methods for data transfer . . . . . . . . . . . . . . . . . . . . . . . 432
27. Mapping values for the APL2 character set . . . . . . . . . . . . . . . . . . . . . . 435
28. TCP/IP character set cross reference . . . . . . . . . . . . . . . . . . . . . . . . . 441
29. Special key conversions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
30. Sense codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
| 31. IP information APARs for z/OS Communications Server . . . . . . . . . . . . . . . . . . 465
| 32. SNA information APARs for z/OS Communications Server . . . . . . . . . . . . . . . . . 466
33. Non-document information APARs . . . . . . . . . . . . . . . . . . . . . . . . . 466
© Copyright IBM Corp. 1990, 2007 xiii

xiv z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands
About this document
This document describes how to use the applications available in z/OS®
Communications Server to perform the following functions:
v Log on to a remote host
v Transfer data sets
v Send and receive electronic mail
v Print on remote printers
v Display IBM® GDDM/MVS graphics on X Window System workstations
v Run a command on another host
The information in this document supports both IPv6 and IPv4. Unless explicitly
noted, information describes IPv4 networking protocol. IPv6 support is qualified
within the text.
A companion to this document is the z/OS Communications Server: IP System

Administrator’s Commands, which contains specific system administrator commands
used to monitor the network, manage resources, and maintain performance of
z/OS Communications Server V1R9.
Who should read this document

This document is written for users who want to use the applications that are
available in z/OS Communications Server V1R9.
Before using this document, you should be familiar with the IBM Multiple Virtual
Storage (MVS™) operating system, the IBM Time Sharing Option (TSO), and z/OS
UNIX System Services and the z/OS UNIX shell. In addition, z/OS
Communications Server V1R9 should already be installed and customized for your
network. For information about installing, see the z/OS Program Directory. For
information about customizing, see the z/OS Communications Server: IP Configuration
Reference.
How this document is organized

This document contains the following:
v Chapter 1, “Getting started,” on page 1 contains basic information about TCP/IP
and how to get started using it.
v Chapter 2, “Logging on to a host using TELNET,” on page 9 describes how to
use TELNET.
v Chapter 3, “File Transfer Protocol (FTP),” on page 29 contains basic information
about FTP.
v Chapter 4, “Transferring data using the File Transfer Protocol (FTP),” on page 53
describes how to use the FTP command and its subcommands to sequentially
access multiple hosts without leaving the FTP environment.
v Chapter 5, “FTP subcommands,” on page 137 describes the FTP subcommands.
v Chapter 6, “Sending electronic mail using SMTP commands,” on page 323
describes how to use the SMTPNOTE command, provided with z/OS
Communications Server, to prepare and send electronic mail.
© Copyright IBM Corp. 1990, 2007 xv

v Chapter 7, “Sending electronic mail using z/OS UNIX sendmail,” on page 359
describes how to use z/OS UNIX sendmail, provided with z/OS
Communications Server, to prepare and send electronic mail using the facilities
of the z/OS shell.
v Chapter 8, “Using remote printing,” on page 363 describes the remote printing
commands.
v Chapter 9, “Using GDDMXD/MVS with the X Window System,” on page 385
describes GDDMXD/MVS and the GDDMXD CLIST and how to use
GDDMXD/MVS user-specified options and keyboard functions.
v Chapter 10, “Executing commands on a remote host,” on page 405 describes how
to use the REXEC and RSH clients.
v Chapter 11, “Using the Network Database System,” on page 421 describes the
Network Database System (NDB), that is used to access relational database
systems in a TCP/IP environment.
v Appendix A, “Specifying data sets and files,” on page 429 describes the
file-naming formats for the MVS, AIX®, UNIX®, AS/400®, and VM operating
systems.
v Appendix B, “Mapping values for the APL2 character set,” on page 435 lists the
GDDMXD/MVS default mapping values for the APL2® character set.
v Appendix C, “TELNET extensions,” on page 441 describes the Telnet 3270 DBCS
Transform special operations.
v Appendix D, “Related protocol specifications,” on page 449 lists the related
protocol specifications for TCP/IP.
v "Information APARs and technotes" lists information APARs for IP and SNA
documents.
v "Accessibility" describes accessibility features to help users with physical
disabilities.
v "Notices" contains notices and trademarks used in this document.
v "Bibliography" contains descriptions of the documents in the z/OS
Communications Server library.
How to use this document

To use this document, you should be familiar with z/OS TCP/IP Services and the
TCP/IP suite of protocols.
Determining whether a publication is current

As needed, IBM updates its publications with new and changed information. For a
given publication, updates to the hardcopy and associated BookManager® softcopy
are usually available at the same time. Sometimes, however, the updates to
hardcopy and softcopy are available at different times. The following information
describes how to determine if you are looking at the most current copy of a
publication:
v At the end of a publication’s order number there is a dash followed by two
digits, often referred to as the dash level. A publication with a higher dash level
is more current than one with a lower dash level. For example, in the
publication order number GC28-1747-07, the dash level 07 means that the
publication is more current than previous levels, such as 05 or 04.
v If a hardcopy publication and a softcopy publication have the same dash level, it
is possible that the softcopy publication is more current than the hardcopy
xvi z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

publication. Check the dates shown in the Summary of Changes. The softcopy
publication might have a more recently dated Summary of Changes than the
hardcopy publication.
v To compare softcopy publications, you can check the last two characters of the
publication’s file name (also called the book name). The higher the number, the
more recent the publication. Also, next to the publication titles in the CD-ROM
booklet and the readme files, there is an asterisk (*) that indicates whether a
publication is new or changed.
How to contact IBM service

For immediate assistance, visit this Web site:
http://www.software.ibm.com/network/commserver/support/
Most problems can be resolved at this Web site, where you can submit questions
and problem reports electronically, as well as access a variety of diagnosis
information.
For telephone assistance in problem diagnosis and resolution (in the United States
or Puerto Rico), call the IBM Software Support Center anytime (1-800-IBM-SERV).
You will receive a return call within 8 business hours (Monday – Friday, 8:00 a.m.
– 5:00 p.m., local customer time).
Outside of the United States or Puerto Rico, contact your local IBM representative
or your authorized IBM supplier.
If you would like to provide feedback on this publication, see “Communicating

Your Comments to IBM” on page 495.
Conventions and terminology used in this document

Commands in this book that can be used in both TSO and z/OS UNIX
environments use the following conventions:
v When describing how to use the command in a TSO environment, the command
is presented in uppercase (for example, NETSTAT).
v When describing how to use the command in a z/OS UNIX environment, the
command is presented in bold lowercase (for example, netstat).
v When referring to the command in a general way in text, the command is
presented with an initial capital letter (for example, Netstat).
All of the exit routines described in this document are installation-wide exit routines.
You will see the installation-wide exit routines also called installation-wide exits,
exit routines, and exits throughout this document.
The TPF logon manager, although shipped with VTAM®, is an application

program. Therefore, the logon manager is documented separately from VTAM.
Samples used in this book might not be updated for each release. Evaluate a
sample carefully before applying it to your system.
For definitions of the terms and abbreviations used in this document, you can view
the latest IBM terminology at the IBM Terminology Web site.
About this document xvii

Clarification of notes
Information traditionally qualified as Notes is further qualified as follows:
Note Supplemental detail
Tip Offers shortcuts or alternative ways of performing an action; a hint
Guideline
Customary way to perform a procedure
Rule Something you must do; limitations on your actions
Restriction
Indicates certain conditions are not supported; limitations on a product or
facility
Requirement
Dependencies, prerequisites
Result Indicates the outcome
How to read a syntax diagram

This syntax information applies to all commands and statements that do not have
their own syntax described elsewhere.
The syntax diagram shows you how to specify a command so that the operating
system can correctly interpret what you type. Read the syntax diagram from left to
right and from top to bottom, following the horizontal line (the main path).
Symbols and punctuation

The following symbols are used in syntax diagrams:
Symbol
Description
Marks the beginning of the command syntax.
Indicates that the command syntax is continued.
| Marks the beginning and end of a fragment or part of the command
syntax.
Marks the end of the command syntax.
You must include all punctuation such as colons, semicolons, commas, quotation
marks, and minus signs that are shown in the syntax diagram.
Commands
Commands that can be used in both TSO and z/OS UNIX environments use the
following conventions in syntax diagrams:
v When describing how to use the command in a TSO environment, the command
is presented in uppercase (for example, NETSTAT).
v When describing how to use the command in a z/OS UNIX environment, the
command is presented in bold lowercase (for example, netstat).
xviii z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

Parameters
The following types of parameters are used in syntax diagrams.
Required
Required parameters are displayed on the main path.
Optional
Optional parameters are displayed below the main path.
Default
Default parameters are displayed above the main path.
Parameters are classified as keywords or variables. For the TSO and MVS console
commands, the keywords are not case sensitive. You can code them in uppercase
or lowercase. If the keyword appears in the syntax diagram in both uppercase and
lowercase, the uppercase portion is the abbreviation for the keyword (for example,
OPERand).
For the z/OS UNIX commands, the keywords must be entered in the case
indicated in the syntax diagram.
Variables are italicized, appear in lowercase letters, and represent names or values
you supply. For example, a data set is a variable.
Syntax examples
In the following example, the USER command is a keyword. The required variable
parameter is user_id, and the optional variable parameter is password. Replace the
variable parameters with your own values.
USER user_id
password
Longer than one line

If a diagram is longer than one line, the first line ends with a single arrowhead
and the second line begins with a single arrowhead.
The first line of a syntax diagram that is longer than one line
The continuation of the subcommands, parameters, or both
Required operands
Required operands and values appear on the main path line.
REQUIRED_OPERAND
You must code required operands and values.
About this document xix

Optional values
Optional operands and values appear below the main path line.

OPERAND
You can choose not to code optional operands and values.
Selecting more than one operand

An arrow returning to the left above a group of operands or values means more
than one can be selected, or a single one can be repeated.

,
REPEATABLE_OPERAND_OR_VALUE_1
REPEATABLE_OPERAND_OR_VALUE_2
REPEATABLE_OPER_OR_VALUE_1
REPEATABLE_OPER_OR_VALUE_2
Nonalphanumeric characters
If a diagram shows a character that is not alphanumeric (such as parentheses,
periods, commas, and equal signs), you must code the character as part of the
syntax. In this example, you must code OPERAND=(001,0.001).
OPERAND = ( 001 , 0.001 )
Blank spaces in syntax diagrams

If a diagram shows a blank space, you must code the blank space as part of the
syntax. In this example, you must code OPERAND=(001 FIXED).
OPERAND = ( 001 FIXED )
Default operands
Default operands and values appear above the main path line. TCP/IP uses the
default if you omit the operand entirely.
DEFAULT

OPERAND
xx z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

Variables
A word in all lowercase italics is a variable. Where you see a variable in the syntax,
you must replace it with one of its allowable names or values, as defined in the
text.
variable
Syntax fragments
Some diagrams contain syntax fragments, which serve to break up diagrams that
are too long, too complex, or too repetitious. Syntax fragment names are in mixed
case and are shown in the diagram and in the heading of the fragment. The
fragment is placed below the main diagram.
Syntax fragment
Syntax fragment:
1ST_OPERAND , 2ND_OPERAND , 3RD_OPERAND
Prerequisite and related information

z/OS Communications Server function is described in the z/OS Communications
Server library. Descriptions of those documents are listed in “z/OS
Communications Server information” on page 481, in the back of this document.
Required information
Before using this product, you should be familiar with TCP/IP, VTAM, MVS, and
UNIX System Services.
Related information
This section contains subsections on:
v “Softcopy information”
v “Other documents” on page xxii
v “Redbooks” on page xxiii
v “Where to find related information on the Internet” on page xxiii
v “Using LookAt to look up message explanations” on page xxv
v “Using IBM Health Checker for z/OS” on page xxv
Softcopy information
Softcopy publications are available in the following collections:
About this document xxi

Titles Order Description
Number
z/OS V1R9 Collection SK3T-4269 This is the CD collection shipped with the z/OS product. It includes
the libraries for z/OS V1R9, in both BookManager and PDF
formats.
z/OS Software Products SK3T-4270 This CD includes, in both BookManager and PDF formats, the
Collection libraries of z/OS software products that run on z/OS but are not
elements and features, as well as the Getting Started with Parallel
Sysplex® bookshelf.
z/OS V1R9 and Software SK3T-4271 This collection includes the libraries of z/OS (the element and
Products DVD Collection feature libraries) and the libraries for z/OS software products in
both BookManager and PDF format. This collection combines
SK3T-4269 and SK3T-4270.
z/OS Licensed Product Library SK3T-4307 This CD includes the licensed documents in both BookManager and
PDF format.
| IBM System z Redbooks SK3T-7876 The Redbooks selected for this CD series are taken from the IBM
| Collection Redbooks inventory of over 800 books. All the Redbooks that are of
| interest to the zSeries platform professional are identified by their
| authors and are included in this collection. The zSeries subject areas
| range from e-business application development and enablement to
| hardware, networking, Linux, solutions, security, parallel sysplex,
| and many others.
Other documents
For information about z/OS products, refer to z/OS Information Roadmap
(SA22-7500). The Roadmap describes what level of documents are supplied with
each release of z/OS Communications Server, as well as describing each z/OS
publication.
Relevant RFCs are listed in an appendix of the IP documents. Architectural

specifications for the SNA protocol are listed in an appendix of the SNA
documents.
The following table lists documents that might be helpful to readers.
Title Number
DNS and BIND, Fourth Edition, O’Reilly and Associates, 2001 ISBN 0-596-00158-4
Routing in the Internet , Christian Huitema (Prentice Hall PTR, 1995) ISBN 0-13-132192-7
sendmail, Bryan Costales and Eric Allman, O’Reilly and Associates, 2002 ISBN 1-56592-839-3
SNA Formats GA27-3136
TCP/IP Illustrated, Volume I: The Protocols, W. Richard Stevens, Addison-Wesley ISBN 0-201-63346-9
Publishing, 1994
TCP/IP Illustrated, Volume II: The Implementation, Gary R. Wright and W. Richard ISBN 0-201-63354-X
Stevens, Addison-Wesley Publishing, 1995
TCP/IP Illustrated, Volume III, W. Richard Stevens, Addison-Wesley Publishing, 1995 ISBN 0-201-63495-3
TCP/IP Tutorial and Technical Overview GG24-3376
Understanding LDAP SG24-4986
z/OS Cryptographic Service System Secure Sockets Layer Programming SC24-5901
z/OS Integrated Security Services LDAP Client Programming SC24-5924
xxii z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

Title Number
z/OS Integrated Security Services LDAP Server Administration and Use SC24-5923
z/OS JES2 Initialization and Tuning Guide SA22-7532
z/OS Problem Management G325-2564
z/OS MVS Diagnosis: Reference GA22-7588
z/OS MVS Diagnosis: Tools and Service Aids GA22-7589
z/OS MVS Using the Subsystem Interface SA22-7642
z/OS Program Directory GI10-0670
z/OS UNIX System Services Command Reference SA22-7802
z/OS UNIX System Services Planning GA22-7800
z/OS UNIX System Services Programming: Assembler Callable Services Reference SA22-7803
z/OS UNIX System Services User’s Guide SA22-7801
z/OS XL C/C++ Run-Time Library Reference SA22-7821
System z9 and zSeries OSA-Express Customer’s Guide and Reference SA22-7935
Redbooks
The following Redbooks™ might help you as you implement z/OS
Communications Server.
Title Number
Communications Server for z/OS V1R8 TCP/IP Implementation, Volume 1: Base SG24-7339
Functions, Connectivity, and Routing
Communications Server for z/OS V1R8 TCP/IP Implementation, Volume 2: Standard SG24-7340
Applications
Communications Server for z/OS V1R8 TCP/IP Implementation, Volume 3: High SG24-7341
Availability, Scalability, and Performance
Communications Server for z/OS V1R8 TCP/IP Implementation, Volume 4: Policy-Based SG24-7342
Network Security
IBM Communication Controller Migration Guide SG24-6298
IP Network Design Guide SG24-2580
®
Managing OS/390 TCP/IP with SNMP SG24-5866
Migrating Subarea Networks to an IP Infrastructure Using Enterprise Extender SG24-5957
SecureWay Communications Server for OS/390 V2R8 TCP/IP: Guide to Enhancements SG24–5631
SNA and TCP/IP Integration SG24-5291
TCP/IP in a Sysplex SG24-5235
TCP/IP Tutorial and Technical Overview GG24-3376
Threadsafe Considerations for CICS SG24-6351
Where to find related information on the Internet

z/OS
This site provides information about z/OS Communications Server release
availability, migration information, downloads, and links to information
about z/OS technology
About this document xxiii

http://www.ibm.com/servers/eserver/zseries/zos/
z/OS Internet Library
Use this site to view and download z/OS Communications Server
documentation
http://www.ibm.com/servers/eserver/zseries/zos/bkserv/
IBM Communications Server product
The primary home page for information about z/OS Communications
Server
http://www.software.ibm.com/network/commserver/
IBM Communications Server product support
Use this site to submit and track problems and search the z/OS
Communications Server knowledge base for Technotes, FAQs, white
papers, and other z/OS Communications Server information
http://www.software.ibm.com/network/commserver/support/
IBM Systems Center publications
Use this site to view and order Redbooks, Redpapers, and Technotes
http://www.redbooks.ibm.com/
IBM Systems Center flashes
Search the Technical Sales Library for Techdocs (including Flashes,
presentations, Technotes, FAQs, white papers, Customer Support Plans,
and Skills Transfer information)
http://www.ibm.com/support/techdocs/atsmastr.nsf
RFCs
Search for and view Request for Comments documents in this section of
the Internet Engineering Task Force Web site, with links to the RFC
repository and the IETF Working Groups Web page
http://www.ietf.org/rfc.html
Internet drafts
View Internet-Drafts, which are working documents of the Internet
Engineering Task Force (IETF) and other groups, in this section of the
Internet Engineering Task Force Web site
http://www.ietf.org/ID.html
Information about Web addresses can also be found in information APAR II11334.
Note: Any pointers in this publication to Web sites are provided for convenience
only and do not in any manner serve as an endorsement of these Web sites.
DNS Web sites

For more information about DNS, see the following USENET news groups and
mailing addresses:
USENET news groups
comp.protocols.dns.bind
xxiv z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

BIND mailing lists
http://www.isc.org/ml-archives/
BIND Users
v Subscribe by sending mail to bind-users-request@isc.org.
v Submit questions or answers to this forum by sending mail to
bind-users@isc.org.
BIND 9 Users (This list might not be maintained indefinitely.)
v Subscribe by sending mail to bind9-users-request@isc.org.
v Submit questions or answers to this forum by sending mail to
bind9-users@isc.org.
Using LookAt to look up message explanations

LookAt is an online facility that lets you look up explanations for most of the IBM
messages you encounter, as well as for some system abends and codes. Using
LookAt to find information is faster than a conventional search because in most
cases LookAt goes directly to the message explanation.
You can use LookAt from these locations to find IBM message explanations for
z/OS elements and features, z/VM®, VSE/ESA™, and Clusters for AIX and Linux™:
v The Internet. You can access IBM message explanations directly from the LookAt
Web site at www.ibm.com/servers/eserver/zseries/zos/bkserv/lookat/.
v Your z/OS TSO/E host system. You can install code on your z/OS systems to
access IBM message explanations using LookAt from a TSO/E command line
(for example: TSO/E prompt, ISPF, or z/OS UNIX System Services).
v Your Microsoft® Windows® workstation. You can install LookAt directly from the
z/OS Collection (SK3T-4269) or the z/OS and Software Products DVD Collection
(SK3T-4271) and use it from the resulting Windows graphical user interface
(GUI). The command prompt (also known as the DOS > command line) version
can still be used from the directory in which you install the Windows version of
LookAt.
v Your wireless handheld device. You can use the LookAt Mobile Edition from
www.ibm.com/servers/eserver/zseries/zos/bkserv/lookat/lookatm.html with a
handheld device that has wireless access and an Internet browser (for example:
Internet Explorer for Pocket PCs, Blazer or Eudora for Palm OS, or Opera for
Linux handheld devices).
You can obtain code to install LookAt on your host system or Microsoft Windows
workstation from:
v A CD-ROM in the z/OS Collection (SK3T-4269).
v The z/OS and Software Products DVD Collection (SK3T-4271).
v The LookAt Web site (click Download and then select the platform, release,
collection, and location that suit your needs). More information is available in
the LOOKAT.ME files available during the download process.
Using IBM Health Checker for z/OS

IBM Health Checker for z/OS is a z/OS component that installations can use to
gather information about their system environment and system parameters to help
identify potential configuration problems before they impact availability or cause
outages. Individual products, z/OS components, or ISV software can provide
About this document xxv

checks that take advantage of the IBM Health Checker for z/OS framework. This
book might refer to checks or messages associated with this component.
For additional information about checks and about IBM Health Checker for z/OS,
see IBM Health Checker for z/OS: User’s Guide. Starting with z/OS V1R4, z/OS users
can obtain the IBM Health Checker for z/OS from the z/OS Downloads page at
http://www.ibm.com/servers/eservers/zseries/zos/downloads/.
SDSF also provides functions to simplify the management of checks. See z/OS
SDSF Operation and Customization for additional information.
How to send your comments

Your feedback is important in helping to provide the most accurate and
high-quality information. If you have any comments about this document or any
other z/OS Communications Server documentation:
v Go to the z/OS contact page at:
http://www.ibm.com/servers/eserver/zseries/zos/webqs.html
There you will find the feedback page where you can enter and submit your
comments.
v Send your comments by e-mail to comsvrcf@us.ibm.com. Be sure to include the
name of the document, the part number of the document, the version of z/OS
Communications Server, and, if applicable, the specific location of the text you
are commenting on (for example, a section number, a page number or a table
number).
xxvi z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

Summary of changes
Summary of changes
for SC31-8780-07
z/OS Version 1 Release 9
This document contains information previously presented in SC31-8780-06, which

supports z/OS Version 1 Release 8.
The information in this document includes descriptions of support for both IPv4
and IPv6 networking protocols. Unless explicitly noted, descriptions of IP protocol
support concern IPv4. IPv6 support is qualified within the text.
This document refers to Communications Server data sets by their default SMP/E
distribution library name. Your installation might, however, have different names
for these data sets where allowed by SMP/E, your installation personnel, or
administration staff. For instance, this document refers to samples in SEZAINST
library as simply in SEZAINST. Your installation might choose a data set name of
SYS1.SEZAINST, CS390.SEZAINST or other high-level qualifiers for the data set
name.
New information
v Allow FTP client to select source IP address, see “FTP command — Entering the
FTP environment” on page 30.
v IPv6 scoped address architecture API, see:
– “FTP command — Entering the FTP environment” on page 30
– “NETRC data set” on page 40
– “Open subcommand—Connect to the FTP server” on page 247
– “REXEC command—Execute a command on the remote host and receive the
results on your local host” on page 406
– “Using the NETRC data set” on page 408
– “RSH command—Execute a command on a remote host and receive the
– “RHOSTS.DATA data set” on page 415
– “The z/OS UNIX orexec/rexec command—Execute a command on the remote
host” on page 417
– “The z/OS UNIX orsh/rsh Command—Execute a Command on the remote
host” on page 419
v FTP TLS/SSL RFC compliance, see:
– “Using security mechanisms” on page 50
– “AUth subcommand—Request security mechanism” on page 147
– “LOCSIte subcommand—Specify site information to the local host” on page
195
– “LOCSTat subcommand—Display local status information” on page 218
– “STAtus subcommand—Retrieve status information from a remote host” on
page 301
v FTP enhancements, see:
– “Sample FTP.DATA data set (FTCDATA)” on page 72
© Copyright IBM Corp. 1990, 2007 xxvii

– “Submitting FTP requests in batch” on page 98
– “Submitting a batch job with concatenated files” on page 101
v SMTP enhancements, see “SMSG SMTP command for the general user” on page
331.
Changed information
v FTP unicode support, see:
195
– “SIte subcommand—Send site-specific information to a host” on page 270
– “TYpe subcommand—Set the data transfer type” on page 315
Deleted information
The APPC Application Suite is removed from the z/OS V1R9 Communications
Server product and therefore documentation describing APPC Application Suite
support has been deleted.
This document contains terminology, maintenance, and editorial changes. Technical

changes or additions to the text and illustrations are indicated by a vertical line to
the left of the change.
You might notice changes in the style and structure of some content in this
document—for example, headings that use uppercase for the first letter of initial
words only, and procedures that have a different look and format. The changes are
ongoing improvements to the consistency and retrievability of information in our
documents.
Summary of changes
for SC31-8780-06

SYS1.SEZAINST, CS390.SEZAINST or other high-level qualifiers for the data set
name.
New information
v FTP UTF-8 data transfer and storage, see the following:
195
– “SIte subcommand—Send site-specific information to a host” on page 270
Changed information
xxviii z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

v FTP LOCSTat subcommand enhancement, see “LOCSTat subcommand—Display
local status information” on page 218.
v FTP STAtus subcommand enhancement, see “STAtus subcommand—Retrieve
status information from a remote host” on page 301.

documents.
Summary of changes
for SC31-8780-05

SYS1.SEZAINST, CS390.SEZAINST or other high level qualifiers for the data set
name.
New information
v LISTSUBdir and NOLISTSUBdir parameters added to LOCSIte and SIte
subcommands.
v New examples added to GET, MGET, PUT, MPUT, LS, and MDelete
subcommands.
v MBSENDEOL and SBSENDEOL parameters defined for LOCSIte and SIte
subcommands.
Changed information
v Promotion of the use of IPv6 global unicast addresses - Site-local addresses were
designed to use private address prefixes that could be used within a site without
the need for a global prefix. Until recently, the full negative impacts of site-local
addresses in the Internet were not fully understood. The IETF has deprecated
the special treatment given to the site-local prefix. Because of this, it is preferable
to use global unicast addresses. This means we are replacing addresses and
prefixes that use the site-local prefix (fec0::/10) with ones that use the global
prefix for documentation (2001:0DB8::/32).
Deleted information
v OROUTED references
Summary of changes xxix

documents.
xxx z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

Chapter 1. Getting started
Transmission Control Protocol/Internet Protocol (TCP/IP) is a set of
industry-standard protocols and applications that enable you to share data and
computing resources with other computers, both IBM and non-IBM. By using
TCP/IP commands at your workstation, you can perform tasks and communicate
easily with a variety of other systems and workstations. z/OS Communications
Server enables the user to interactively run TCP/IP applications (TCP/IP
commands) from both the Time Sharing Option (TSO) and the z/OS shell.
The following subjects are covered in this topic:

v “Understanding TCP/IP”
v “How TCP/IP uses networks” on page 2
v “Understanding what you can do” on page 4
v “What you need to get started” on page 6
v “Testing commands with loopback” on page 7
v “Obtaining command help” on page 7
Understanding TCP/IP
TCP/IP is a set of protocols and applications that enable you to perform certain
computer functions in a similar manner independent of the types of computers or
networks being used. When you use TCP/IP, you are using a network of
computers to communicate with other users, share data with each other, and share
the processing resources of the computers connected to the TCP/IP network.
A computer network is a group of computer nodes electronically connected by

some communication medium. Each node has the hardware and the programs
necessary to communicate with other computer nodes across this communication
medium. The node can be a PC, workstation, departmental computer, or large
computer system. The size of the computer is not important. The ability to
communicate with other nodes is important.
Computer networks enable you to share the data and computing resources of
many computers. Applications, such as departmental file servers, rely on
networking as a way to share data and programs.
Many forms of communication media are available today. Each is designed to take
advantage of the environment in which it operates. Communication media consist
of a combination of the physical network used to connect the computer nodes and
the language, or protocol, they use to communicate with each other.
Physical network
A physical network consists of electrical wiring and components, such as modems,
bridges, controllers, access units, telephone lines, fiber optic cables, and coaxial
cables. These are used to connect the computer nodes. The physical network can
connect two nodes in a single room or thousands of nodes communicating across
large geographic areas. The most common networks in use today are Local Area
Networks (LANs) and Wide Area Networks (WANs). LANs cover a limited
distance, generally one or two floors or buildings, while WANs, using
telecommunication facilities, are used for longer distances.
© Copyright IBM Corp. 1990, 2007 1

Protocols
Network protocols are the rules that define how information is delivered between
nodes. They describe the sequence and contents of the data exchanged between
nodes on the network. Network protocols determine how a computer node
functions during communication with another node, how data is encoded to reach
its destination safely, and what path it should follow. Protocols coordinate the flow
of messages and can specify which node a message is destined for in the network.
A variety of protocols are used to take advantage of the characteristics of each of
the physical network types. The most common protocols are Ethernet, 802.3, token
ring, X.25, and System Network Architecture (SNA).
Network devices
See the z/OS Communications Server: IP Configuration Reference for more information
about network devices.
Addresses
A network address is a component of the communication network and is
associated with both hardware and software. The address is the means by which
the sending node selects the receiving node for data transfer. It is also used by the
receiving node to recognize what data is destined for it. An address is a unique
code assigned to every node on a network. But an address is formed differently for
different protocols. The length, position, and method used to specify an address
are unique for each protocol. A communication node using one protocol cannot
recognize the address of another protocol.
How TCP/IP uses networks

TCP/IP consists of a layered structure of protocols ranging from
hardware-dependent programs to high-level applications. Each TCP/IP layer
provides services to the layer above it and uses the services of the layer below it.
The lowest layer, which is next to the physical layer, is not part of TCP/IP. This
layer consists of existing protocols, such as Ethernet and token ring. TCP/IP uses
the services of this layer to transport data across dissimilar networks, much like a
gateway.
Local and remote nodes

A physical network is used by the hosts that reside on that network. Each host is a
node on that network. A node is an addressable location in a communication
network that provides host processing services. The intercommunication of these
nodes gives rise to the concept of local and remote nodes. A local node pertains to
a device, file, or host accessed directly from your system. A remote node pertains
to a device, file, or host accessed by your system through the network.
Client and server

A server is a computer or a program that contains data or provides services to be
used by other computers on the network. Some of the common server types are
file, print, and mail servers. They enable your computer to share the data, devices
and resources of another computer. There are also servers that provide services to
let you execute programs on a computer other than your own. This enables your
computer to share the processing power of another computer. Servers are also
known as daemons. Generally, a server runs continuously and can handle the
requests of multiple clients simultaneously.
2 z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

A client is a computer or a program that requests services or data from a server. A
client could, for example, request that a file located at the server be sent across the
network to the client.
TCP/IP addresses
An address enables data to be routed to the chosen destination. Each destination in
your network, as well as any other TCP/IP network you have access to, can be
uniquely identified by its assigned address (either a 32-bit IPv4 address in dotted
decimal notation, or a 128-bit IPv6 address in colon hexadecimal notation).
v IPv4 TCP/IP address
An IPv4 TCP/IP address is a 32-bit number written in dotted decimal notation.
This scheme is numeric and consists of four groups separated by a period (.).
For example, 9.67.1.100 represents a single host on a single network. 193.5.86.9
represents another host on another network.
v IPv6 TCP/IP address
An IPv6 TCP/IP address is a 128-bit number written in colon hexadecimal
notation. This scheme is hexadecimal and consists of eight 16-bit pieces of the
address. For example, x:x:x:x:x:x:x:x represents a single host on a single network.
Alternate notations described in RFC 2373 are acceptable. For example,
FEDC:BA98:7654:3210:FEDC:BA98:7654:321 or ::1.
To indicate IPv6 prefixing use a slash followed by the number of prefix bits. For
example, use 12AB:0:0:CD30::/60 to indicate the prefix X'12AB00000000CD3'.
Most TCP/IP commands require you to include the address of the remote host
where the server you wish to access resides. Each link (physical or virtual) on a
host has an IP address.
Network names
An alternative to supplying a numeric address is to use the host name, rather than
the address, in TCP/IP commands. (Each host may be assigned at least one name.)
Your local host can resolve the name you supply in a command into the correct
numeric address. The names are translated using either a translation file or an
application known as a name server. Your ability to use network names depends
on how your TCP/IP network has been designed and which features have been
installed.
Ports and port numbers

The use of ports and their identifying numbers are an extension to the addressing
scheme. Once the address is used to deliver data to the desired host on the
network, the port number is used to identify the process for which the data is
used. This enables one host to provide more than one service.
How you define the port number depends on your configuration. Some
applications make use of standard, or well-known, port numbers. Two applications
at the same address cannot use the same port number. If you are configuring your
system with multiple instances of TCP/IP on the same system, however, they will
have different addresses and therefore the same port number can be used for the
same function on each stack.
TCP/IP assumes the well-known port number unless you explicitly specify
otherwise when entering a TCP/IP command. A port number is entered as a
Chapter 1. Getting started 3

decimal number on TCP/IP commands. For those cases when you are requesting
the services of a user-developed server, you need to know the port number of that
server.
Understanding what you can do

You can perform many functions from either TCP/IP environment: TSO or z/OS
UNIX System Services (z/OS UNIX). See "How to read a syntax diagram" for
additional information about command syntax.
z/OS Communications Server commands provide a set of basic functions that

include:
v Logging on to other hosts
v Transferring data sets and files between hosts
v Sending and receiving mail
v Using other hosts
v Printing to or from other hosts
Logging on to other hosts

The Telnet protocol provides a standardized interface that enables terminal devices
and terminal-oriented processes on hosts that support TCP/IP to communicate
with each other. The TSO TELNET command runs the MVS Telnet client that
enables you to log on to a remote host from TSO as though you are directly
attached to that host. This client supports the Telnet 3270 protocol. The MVS Telnet
client does not run in the z/OS UNIX environment.
Connecting to the z/OS UNIX Telnet server from any client results in a session
with the z/OS shell as if the user had entered UNIX System Services from TSO in
line mode or character mode. Once the z/OS UNIX Telnet session has been
established, you can enter any UNIX System Services command that can be issued
from within the z/OS shell.
See Chapter 2, “Logging on to a host using TELNET,” on page 9 for more

information about TELNET.
Transferring data sets between hosts

When data is created or stored at one host but is processed by another host, some
method for transferring the data between hosts is necessary. TCP/IP implements
File Transfer Protocol (FTP), a protocol for transferring files between any two hosts.
The FTP command invokes the z/OS FTP client. From the FTP client, you can copy
data sets and files between your local host and any host that implements an FTP
server.
The FTP command provides subcommands that enable you to change the local and
remote directories, set the transmission character code, list remote files, delete
remote files, and send and receive files between hosts. You can use z/OS FTP
client to perform Structured Query Language (SQL) queries and to submit jobs to
JES for batch processing, as well as file transfer. FTP includes optional security
features such as Kerberos and TLS authentication, and server user ID and
password verification.
See Chapter 3, “File Transfer Protocol (FTP),” on page 29, for a complete list of FTP
functions.

Sending and receiving mail
The Simple Mail Transfer Protocol (SMTP) is a TCP/IP application that is used to
transport electronic mail. Electronic mail enables you to send notes, messages,
letters, or correspondence to others on the network. It is similar to sending a letter
through the post office. You compose the message just as you would an ordinary
letter, address the letter to one or more people and possibly carbon copy others.
You enclose copies of the letter in envelopes, address them to the recipients, and
give them to the delivery system. You expect the mail to be delivered to the correct
address available for pickup when the recipient is ready. And you want any
undeliverable mail returned to you. You can even keep a log of the mail you send
and receive. The following commands are available to let you send and receive
mail:
Command Description
SMTPNOTE Composes and sends mail from you to users on local or remote hosts.
The TSO SMTPNOTE command helps you address the mail, set up a
copy list, and enter the text of the message. The date, time, and your
address are included automatically.
z/OS UNIX Composes and sends mail from you to users on local or remote hosts.
sendmail The z/OS UNIX sendmail command helps you address the mail, set up
a copy list, and enter the text of the message. The date, time, and your
address are included automatically.
RECEIVE Retrieves data that has been sent to you through the Job Entry
Subsystem (JES). You use the RECEIVE command for your TCP/IP mail
just as you do for other mail, messages, and data sets that are sent to
you.
See Chapter 6, “Sending electronic mail using SMTP commands,” on page 323 for
more information about the SMTP mail facility.
See Chapter 7, “Sending electronic mail using z/OS UNIX sendmail,” on page 359
for more information about the z/OS UNIX mail facility.
Remote command execution

Just as there are occasions when you want to transfer data to a host where it can
be processed, there are also occasions when you want to process the data where it
exists and send the processing results to another host. The data sets or files could
be too large to transfer efficiently or all the data might be kept at one host for
security reasons. The computing power necessary to perform some tasks could be
more than your host is capable of or the only licensed copy of a required program
might reside at some other host. TCP/IP provides a command that enables you to
use the processing resources of other hosts. The TSO commands REXEC and RSH
and the z/OS UNIX shell command orexec run client programs that enable you to
send any command that is valid in the remote host shell environment and receive
the results at the local host. The remote host must be running a rexec server, an rsh
server, or both. A user ID and password provide security checking at the remote
host. The command sent to the remote host must not require user interaction to
complete. See z/OS Communications Server: IP System Administrator’s Commands for
more information about these commands.
Printing to or from other hosts

You can print reports, documents, listings, and so on completely independent of
where the job or process that created them was executed by routing the data sets
to a remote host for printing. Four TSO commands are provided for remote
printing. These TSO commands do not run in the z/OS shell environment and do

not support printing of z/OS UNIX files.
Command Description
LPQ Enables you to query a printer queue on a remote printer. You can query
a printer queue for a specific job, a specific user ID, or all the jobs in a
remote printer queue.
LPR Prints a data set on a remote printer. A variety of options enables you to
specify how and where the data set is printed.
LPRM Removes a job from a printer queue.
LPRSET Specifies remote printer and remote host names when they are not
specifically included in the Line Print commands.
What you need to get started

TCP/IP is a part of your z/OS system. To use it you need a TSO user ID and
password. If you are already a TSO user, you can begin using TCP/IP.
In order to use z/OS Communications Server for V1R9 applications, you must be
authorized to use z/OS UNIX System Services. For information about z/OS UNIX,
see the z/OS UNIX System Services User’s Guide.
Ensure that you have the following before proceeding:

User IDs and passwords
You should have a user ID and password for each host you intend to use
that requires user authorization and authentication. This includes most
hosts you use. Some hosts on a TCP/IP network use a user ID of
anonymous and a password of guest to permit all interested parties access
to data sets contained at that host, but that is the exception and not the
rule.
Host names
TCP/IP commands require that you know the name or IP address of the
remote host you want to use.
Authorizations for data and programs
Your ability to access data sets and programs on remote hosts depends on
the data security system used by that host. You might require authorization
by the Resource Access Control Facility (RACF) or other security programs
before you can gain access to data sets, commands, or other resources on
remote hosts.
Electronic mail addresses
To send mail electronically, you need the e-mail address of the users you
wish to send mail to and they need to know your electronic mail address
to send you mail.
Printer names
You need the printer name and name of the remote host to which it is
attached to print using TCP/IP.

Testing commands with loopback
In order to test your local machine, an address is reserved that always refers to
your local host rather than any other hosts on a network. For IPv4, this class A
network address is 127.0.0.1. For IPv6, the reserved loopback address is ::1. You
can also specify loopback as the host name. Not all commands and clients shipped
with z/OS Communications Server V1R9 support IPv6 addresses or hostnames
that resolve to IPv6 addresses.
You can use the loopback address with any TCP/IP command that accepts IP
addresses. When you issue a command with the loopback address, the command is
sent out from your local host’s client and continues until it reaches the IP layer on
your local host. The command is then sent on to your local host’s server.
Note: Any command or data that you send using the loopback address never
actually goes out on any network.
You can also use a nonloopback local IP address for testing. It can be any local IP
address assigned to a device, even though the device may not be active, but cannot
be a multicast or broadcast address. The nonloopback address provides a faster
response but may not reach the IP layer on your host.
The loopback address is commonly used as the first step in diagnosing network
problems. The information you receive indicates the state of your system and
checks to ensure that the client and server code for the function you are testing is
operating properly. You should see the same response as for a normal, successful
command. If the client or server code is not operating properly, the same message
that would be returned for an unsuccessful command is returned.
Obtaining command help

Commands typically support HELP or -? options that allow users to obtain online
help. Additionally, end user commands supported in the z/OS UNIX System
Services shell environment support man pages (manual pages). For example,
typing man ftp displays the manual pages for the ftp command.

Chapter 2. Logging on to a host using TELNET
The TELNET protocol provides a standardized interface that enables terminal
devices and terminal-oriented processes on hosts that support TCP/IP to
communicate with each other.

v “Using the TSO TELNET command”
v “Using the TELNET subcommands” on page 13
v “Using the TELNET function keys” on page 23
v “Suppressing carriage return and line feed” on page 23
v “Using TELNET 3270 DBCS transform mode” on page 24
Using the TSO TELNET command

When you use the TSO TELNET command you are running a Telnet client to
connect to a remote host running a Telnet server. The data displayed on your
terminal is managed by the Telnet client which communicates using TCP/IP with
the Telnet server at the remote host. As a result, the operation of your terminal
may differ from what you are used to seeing when you are directly logged on to
TSO or to another MVS application. For example, the remote host may be running
UNIX, VM or any other operating system that provides a Telnet server. You need
to use the terminal operation procedures of the remote host operating system while
you have a TELNET session with that remote host.
TELNET management of your terminal for the remote host can also cause
operational differences. For example, the function keys described in “Using the
TELNET function keys” on page 23 can result in different actions.
When all of the display data does not fit on your screen, Linemode displays the
HOLDING message in the lower right corner of your screen. If this message
appears, press the CLEAR key to see the rest of the data.
If your TELNET session ends for any reason, the following message is displayed:
Session ended. <ENTER> to return to TSO.
If you invoke the services of the MVS Telnet 3270 server from a Telnet client that is
not Telnet 3270 capable, you cannot use applications in full-screen mode. Once in
line-mode, all nested Telnet sessions continue to be line mode. If you use TELNET
in line-mode to access an MVS or VM TELNET server, all subsequent nested
TELNET requests are automatically connected in line-mode as a start-stop TTY
terminal, and transparent (full-screen) operations are not possible.
When you return to TSO, a message explaining why the TELNET session ended is
displayed. The following is an example of what is displayed when you return to
TSO:
TELNET terminated -- Foreign host is no longer responding
Note: The z/OS TELNET client does not support the Secure Sockets Layer (SSL)
protocol.

TELNET command
Purpose
The TELNET command enables you to log on to a foreign host that supports
TCP/IP.
Notes:
1. For information on how to read syntax diagrams, see "How to read a syntax
diagram".
2. The TSO TELNET command uses the Pascal socket API, so VMCF must be
started for the command to be successful. If VMCF is not started, an
ABEND0D6 can occur.
Format
TELNET
23
foreign_host port_number
Help

(
Linemode DEBUG TRANslate data_set_name
Parameters
foreign_host
Specifies the name or IP address of the local or remote host. If you do not
specify the name or IP address of the host, you are prompted for the
foreign_host. This must be an IPv4 address or a host name that resolves to an
IPv4 address.
port_number
Specifies the port number to which you want to connect on the host. The
default is well-known port 23.
Help
Provides a description of the TELNET command, its subcommands, and how it
operates.
Linemode
Uses the line mode and prevents operation in the transparent mode.
In line mode, the foreign host output is displayed on your screen one line at a
time, without full-screen capabilities.
Note: You cannot use the TELNET command to log on to an MVS host from
an existing MVS line mode TELNET session. In this situation, the error
message TELNET requires a 327x-Type terminal is displayed.
In transparent mode, the foreign host full-screen capabilities are functional on

your local terminal.
Transparent mode is the default.

DEBUG
Causes TELNET client-trace data, including the data transferred to and

received from the TELNET server, to be written to a data set defined by the
DEBUGFIL DD statement in the user TSO LOGON procedure, or as specified
by issuing the TSO ALLOC command.
The following is an example of the DEBUGFIL DD statement:
//DEBUGFIL DD DSN=USER28.TELNET.TRACE,DISP=OLD
The following is an example of the TSO ALLOC command:

ALLOC DDNAME(DEBUGFIL) DSNAME(USER28.TELNET.TRACE) OLD
TRANslate data_set_name
Specifies the name of a nonstandard translation table. If you specify this
parameter, TELNET uses the translation table in the
user_id.data_set_name.TCPXLBIN data set, rather than the standard translation
tables user_id.TELNET.TCPXLBIN or hlq.TELNET.TCPXLBIN.
If user_id.data_set_name.TCPXLBIN does not exist, TELNET uses
hlq.data_set_name.TCPXLBIN.
If user_id.data_set_name.TCPXLBIN and hlq.data_set_name.TCPXLBIN do not
exist, or if they were incorrectly created, TELNET ends with an error message.
A nonstandard translation table is used in line mode only.
Examples
v To log on to a host with an IP address of 1.1.2.3, enter:
TELNET 1.1.2.3
The following is displayed:

System:
READY
User: TELNET 1.1.2.3
System:
MVS TCP/IP TELNET CS V1R2
Connecting to 1.1.2.3, port TELNET (23)
***
Using Transparent Mode...
Notes on using TELNET when in Transparent Mode:

- To enter TELNET Command, Hit PA1
***
v If your user ID is RON and the translation table RON.EXAMPLE.TCPXLBIN is required

rather than the standard one, you should enter:
TELNET 1.1.2.3 (TRANslate EXAMPLE
– If the remote host is neither MVS nor VM, and you specify a nonstandard
translation table, a linemode connection is automatically used.
– If the remote host is an MVS or VM host and you specify a nonstandard
translation table without the linemode parameter, the nonstandard translation
table is ignored.
– If the host is an MVS or VM host and both the linemode parameter and a
nonstandard translation table are specified, the nonstandard translation table
is used.
Usage
v The minimum abbreviation for each parameter is shown in uppercase letters.
v TELNET normally operates in transparent mode. In 3270 transparent mode, all
full-screen capabilities of the remote host are functional at your local display
station, but the PA1 key is the only special-function key whose intended
Chapter 2. Logging on to a host using TELNET 11

function is passed to the application by Telnet. In line mode, the remote host
output is displayed on your screen one line at a time, without full-screen
capabilities.
v The TELNET command supports IBM 3270-type display stations. Examples of
supported display stations are:
– IBM 3178 Display Station
– IBM 3275 Display Station Model 2
– IBM 3276 Control Unit Display Station Models 2, 3, and 4
– IBM 3277 Display Station Model 2
– IBM 3278 Display Station Models 2, 3, 4, and 5
– IBM 3279 Color Display Station Models 2 and 3

Using the TELNET subcommands
You must be in the TELNET environment to use the TELNET subcommands.
To invoke a TELNET subcommand while you are logged on to the foreign host,
press the PA1 key (transparent mode) or the designated PF key (line mode). After
you press the PA1 or PF key, you are prompted to enter a TELNET subcommand.
You can enter TELNET subcommands in uppercase or lowercase characters. Table 1
lists the TELNET subcommands.
Table 1. TELNET subcommands
Subcommand Description See
AO Stops the display of “AO—Terminate output display” on page
information 14
AYt Queries the existence of the “AYT—Query the connection” on page 15
connection
Brk Sends a Break or Attn “BRK—Send a Break or Attention
keystroke keystroke to a host” on page 16
Help or ? Displays help information “HELP or ?—Display help information”
on page 17
Ip Interrupts the current process “IP—Interrupt the process” on page 18
Pa1 Sends a PA1 keystroke in “PA1—Send the PA1 keystroke to a host”
transparent mode on page 19
Quit Disconnects from the foreign “QUIT—End the TELNET session” on
host page 20
Synch Clears the data path “SYNCH—Clear the data path” on page
21
Note: The minimum abbreviation for each subcommand is shown in uppercase

letters.

AO—Terminate output display
Purpose
Use the AO (Abort Output) subcommand to stop the display of output.
Format
AO
Parameters
There are no parameters for this subcommand.
Usage
The AO subcommand is used to clear any output that has already been produced,
but has not been displayed on your terminal.

AYT—Query the connection
Purpose
Use the AYT (Are You There) subcommand to query the existence of the
connection.
Format
AYt
Parameters
Usage
v You can use the AYT subcommand to check for the existence of a TELNET
connection. For example, if you feel that a command is taking longer than it
should to complete, issue the AYT subcommand to test whether the connection
is still active.
v If the connection exists and you are operating in transparent mode, the terminal
makes a sound. If you are operating in line mode, you receive a message from
the TELNET server.

BRK—Send a Break or Attention keystroke to a host
Purpose
Use the BRK subcommand to send a Break or Attn (Attention) keystroke to the
remote session.
Format
Brk
Parameters
Usage
You can use the BRK subcommand to end a command without terminating the
TELNET session.

HELP or ?—Display help information
Purpose
Use the HELP (or ?) subcommand to access the help facility.
Format
Help
?
Parameters
Usage
v After your TELNET connection is established, your display station screen is
controlled by the foreign host, so the help you see is different for line mode and
transparent mode. The help available in transparent mode is abbreviated because
TELNET does not have control of the screen.
v When you invoke the HELP or ? subcommand in line mode, TELNET displays
the help information one line after another, as in the following example:
Once connected, follow the log in and usage
procedures of the remote host.
To invoke one of several TELNET commands, hit a
PF key (PF4-12, PF16-24), and then enter any of
the following commands:
Help or ? -- Receive (this) assistance
AYT -- Are You There?
AO -- Abort Output
BRK -- Break
IP -- Interrupt Process
SYNCH -- Clear data path, except for TELNET commands
Quit -- Quit the TELNET session
The following PF settings are in force:

PF1 or 13 -- Retrieve previous input line
PF2 or 14 -- Scroll halfway up
PF3 or 15 -- Turn off display of user-line; designed
to be used before entering password
For control characters, enter ¢c or `c where c is:
"0": 00, "a" - "z" or "A" - "Z": 0x01-0x1A
"2" - "6": 0x1B-0x1F
"{": 0x5B, "}": 0x5D, "#": 0x7F
v When you invoke the HELP or ? subcommand in transparent mode, TELNET

overwrites one line of the current screen with the help information, as in the
following example:
Valid TELNET cmds: AO,AYT,BRK,IP,PA1,QUIT,SYNCH.

IP—Interrupt the process
Purpose
Use the IP subcommand to interrupt the current process running on the remote
host.
Format
Ip
Parameters
Usage
You can use the IP subcommand if you want to stop a process that is in a loop, or
when you want to stop a process that you inadvertently started.

PA1—Send the PA1 keystroke to a host
Purpose
Use the PA1 subcommand to send a PA1 keystroke to the remote session in
transparent mode.
Format
Pa1
Parameters
Usage
v The PA1 subcommand operates only in transparent mode. This subcommand
replaces the PA1 attention key on the remote host.
v When there are nested TELNET sessions, use the PA1 key to enter a TELNET
subcommand in the first open TELNET session. To enter a TELNET
subcommand in the second open TELNET session, send a PA1 subcommand
from the first session.
v You would normally interrupt a PING command by pressing PA1. However, in
a transparent mode TELNET session, this key is used to invoke a TELNET
subcommand. You would issue a PA1 subcommand to interrupt the PING
command instead.

QUIT—End the TELNET session
Purpose
Use the QUIT subcommand to end the TELNET session.
Format
Quit
Parameters
Usage
v You should use the QUIT subcommand carefully because it can create an MVS
error condition. If you do not reconnect within a timeout period, your TELNET
session is canceled.
v If you are logged on to an application on a remote host, and that application is
defined as disconnectable to VTAM and TCP/IP, you can use the QUIT
subcommand to disconnect from the remote host without logging off the
application.
v When you want to end a logon session with the host, use the logoff procedure
of the host.
For more information about defining applications to VTAM and TCP/IP, see the
z/OS Communications Server: IP Configuration Reference.

SYNCH—Clear the data path
Purpose
Use the SYNCH subcommand to clear the data path.
Format
Synch
Parameters
Usage
The SYNCH subcommand clears the data path to the host, except for any TELNET
subcommands in the data path. This subcommand enables you to ensure that
commands issued when the TELNET server is inactive are not executed when the
TELNET server becomes active.

¢ and `—Send ASCII control characters to a host in line mode
Purpose
Use the ¢ character and the grave accent ( `) in line mode to indicate a control
character.
Format
¢ control_character
`
Parameters
control_character
Indicates the ASCII control character that you want to send to the host. The
purpose of each control character is specific to the remote host.
Examples
To send Ctrl-p, use either: ¢p or `p.
Usage
v If you want to use ¢ or ` without indicating a control character, you must enter
these characters twice.
v The ASCII control characters are shown in Table 2.
Table 2. ASCII control characters
Character input ASCII output
À – `Z 01 – 1A (Ctrl-a – Ctrl-z)
`{ 5B (left square bracket - [)
`} 5D (right square bracket - ])
`2 – `6 1B – 1F
`# 7F (DEL)

Using the TELNET function keys
This section describes the functions that are assigned to PF keys when you invoke
TELNET in transparent mode and line mode.
Transparent mode function keys

In transparent mode, the only function key available is the PA1 attention key. It is
used to invoke a TELNET subcommand. If there is more than one nested TELNET
session, the PA1 key is used to invoke a TELNET subcommand for the first
TELNET session.
See “PA1—Send the PA1 keystroke to a host” on page 19 for information about
how to send the PA1 keystroke to the foreign host session.
Line mode function keys

Table 3 describes the function keys that are available in line mode.
Table 3. TELNET function keys in line mode
Function key Description
PF4–PF12, Enables you to invoke a TELNET subcommand. After pressing one
PF16–PF24 of these function keys, enter a subcommand or enter Help to get a
list of valid subcommands.
PF1, PF13 Retrieves the previous input line, except when the line was entered
in hidden mode for security reasons.
PF2, PF14 Scrolls halfway up the screen.
PF3, PF15 Turns off input line display so data is not echoed to the screen. For
example, use either of these keys before entering your password to
keep it from being displayed.
Suppressing carriage return and line feed

It is useful if the command environment of the foreign host responds when you
enter a single character, without the need for a carriage return and line feed after
that character. This function is also useful when your cursor is at the end of the
input field, but you want to continue the line without introducing a carriage
return.
Figure 1 on page 24 and Figure 2 on page 24 show the output of a BSD UNIX
program called MORE. This program displays one line or one page at a time. A
carriage return character (CR) causes it to display one line, while a blank character
causes it to display one page. If you are executing this program from an MVS host,
use the grave accent (`) character to suppress the CR that is normally sent when
you press Enter.

% more hosts.localNET : 4.0.0.0 : SATNET :
NET : 6.0.0.0 : YPG-NET :
NET : 7.0.0.0 : EDN-TEMP :
NET : 8.0.0.0 : BBNCCNET :
NET : 9.0.0.0 : IBM :
NET : 10.0.0.0 : ARPANET :
NET : 12.0.0.0 : ATT :
NET : 13.0.0.0 : XEROX-NET :
NET : 14.0.0.0 : PDN :
NET : 15.0.0.0 : HP-INTERNET :
NET : 18.0.0.0 : MIT-TEMP :
NET : 21.0.0.0 : DDN-RVN :
NET : 23.0.0.0 : DDN-TC-NET :
NET : 24.0.0.0 : MINET :
NET : 25.0.0.0 : RSRE-EXP :
NET : 26.0.0.0 : MILNET :
NET : 27.0.0.0 : NOSC-LCCN-TEMP :
NET : 28.0.0.0 : WIDEBAND :
NET : 29.0.0.0 : MILX25-TEMP :
NET : 30.0.0.0 : ARPAX25-TEMP :
NET : 31.0.0.0 : UCDLA-NET :
NET : 35.0.0.0 : MERIT :
--More--(0%) [HIT <ENTER> HERE. ONE LINE IS DISPLAYED]
NET : 36.0.0.0 : SU-NET-TEMP :
--More--(0%)
Figure 1. Sample output of the MORE program—first screen
NET : 39.0.0.0 : SRINET-TEMP :

--More--(0%) [HIT <BLANK>, <ACCENT GRAVE>, <ENTER>]
NET : 39.0.0.0 : SRINET-TEMP :
NET : 41.0.0.0 : BBN-TEST-A :
NET : 42.0.0.0 : CAN-INET :
NET : 44.0.0.0 : AMPRNET :
NET : 46.0.0.0 : BBNET :
NET : 128.1.0.0 : BBN-TEST-B :
NET : 128.2.0.0 : CMU-NET :
NET : 128.3.0.0 : LBL-IP-NET1 :
NET : 128.4.0.0 : DCNET :
NET : 128.5.0.0 : FORDNET :
NET : 128.6.0.0 : RUTGERS :
NET : 128.7.0.0 : KRAUTNET :
NET : 128.8.0.0 : UMDNET :
NET : 128.9.0.0 : ISI-NET :
NET : 128.10.0.0 : PURDUE-CS-EN :
NET : 128.11.0.0 : BBN-CRONUS :
NET : 128.12.0.0 : SU-NET :
NET : 128.13.0.0 : MATNET :
NET : 128.14.0.0 : BBN-SAT-TEST :
NET : 128.15.0.0 : S1NET :
NET : 128.16.0.0 : UCLNET :
NET : 128.17.0.0 : MATNET-ALT :
--More--(1%)
Figure 2. Sample output of the MORE program—second screen
Using TELNET 3270 DBCS transform mode

When 3270 DBCS transform mode is configured for the MVS TELNET server, all
new line-mode sessions to the server are introduced with a panel where you can
select transform mode or line mode.
TELNET 3270 DBCS transform mode is used to provide 3270 DBCS emulation,
while the 3270 processing is done only at the host end of the connection. This
enables full-screen access from non-3270 terminals.

TELNET 3270 DBCS transform mode supports terminals of the VT100/VT220
family of terminals, including VT100 and VT282.
To log on to the server using 3270 DBCS transform mode, specify the LINEMODE
option on the TELNET client command line. The following banner is displayed if
transform mode is available:
IBM TCP/IP TELNET SERVER DBCS SERVICE START AT HH.MM.SS ON MM/DD/YY

KEY-IN YOUR TERMINAL TYPE & CONVERSION TYPE:

Terminal and conversion type
Format
When the DBCS banner appears, enter the required terminal and conversion type.

VT282 SJISKANJI
VT100 /
TTY JIS78KJ
JIS83KJ
BIG5
EUCKANJI
DECKANJI
HANGEUL
KSC5601
SCHINESE
TCHINESE
Parameters
VT100
VT100 terminal type, full-screen mode—no DBCS support
VT282
VT282 terminal type, full-screen mode—with DBCS support
TTY
Line mode—no DBCS support. This option bypasses operation in transform
mode.
SJISKANJI
Shift JIS Kanji DBCS conversion
JIS78KJ
JIS Kanji 1978 DBCS conversion
JIS83KJ
JIS Kanji 1983 DBCS conversion
BIG5
Big-5 DBCS conversion
EUCKANJI
Extended UNIX code Kanji DBCS conversion
DECKANJI
DEC Kanji DBCS conversion
HANGEUL
Hangeul DBCS conversion
KSC5601
Korean Standard code KSC-5601 DBCS conversion
SCHINESE
Simplified Chinese DBCS conversion
TCHINESE
Traditional Chinese (5550) DBCS conversion

Usage
v Do not enter any spaces between the terminal type and the slash character (/),
or between the slash character (/) and the conversion type. For example, to
specify a VT282 terminal with Shift JIS Kanji DBCS conversion, enter the
following:
VT282/SJISKANJI
v If the conversion type is not specified, it defaults to the CODEKIND specified in
the TNCBCSTM configuration data set. If neither terminal type nor conversion
type is specified, the terminal type defaults to VT282 and the conversion type to
the CODEKIND specified in the TNDBCSTM configuration data set.
v TELNET 3270 with DBCS transform mode supports a screen size of 24 by 80.
Unpredictable results may occur when using a larger screen size.
v The maximum number of concurrent TELNET 3270 DBCS Transform connections
is 250.
Context
For more information about using translation tables, see the z/OS Communications
Server: IP Configuration Reference.
For information about character sets, see “Character set cross reference table” on
page 441.
For information about the TELNET extensions for terminals other than the 3270
family, see Appendix C, “TELNET extensions,” on page 441.

Chapter 3. File Transfer Protocol (FTP)
The FTP command runs the FTP client program that enables you to transfer data
sets and files between your local host and another host running an FTP server.
Using the FTP command and its subcommands, you can sequentially access
multiple hosts without leaving the FTP client.
This topic describes:

v “Using FTP”
v “Getting help” on page 41
v “Establishing and exiting a connection” on page 41
v “Obtaining status and system information” on page 44
v “Working with directories on the remote host” on page 44
v “Working with directories on the local host” on page 49
v “Security considerations” on page 50
Using FTP
Before transferring files between your local host and a remote host, or using any
other FTP functions, you must enter the FTP environment. Enter the FTP
environment by doing one of the following:
v Code PGM=FTP in a batch job and pass parameters using the PARM keyword.
See “Submitting FTP requests in batch” on page 98 for more information.
v Enter the FTP command from TSO.
v Enter the FTP command from the z/OS UNIX shell.
v Pass the FTP command parameters to the FTP Client API. See FTP Client API
information in the z/OS Communications Server: IP Programmer’s Guide and
Reference for complete details on the FTP Client API.

FTP command — Entering the FTP environment
Purpose
Use the FTP command to enter the FTP environment. When using the FTP Client
API, omit the FTP keyword.
Guidelines:
1. The FTP client expects to be invoked with POSIX(ON). If you invoke the FTP
client with POSIX(OFF) you might experience unpredictable results because
many of the status and result functions that are meant to inform the user of
any errors during the transfer are dependent on POSIX(ON).
2. In a z/OS UNIX environment, using the FTP command in the format shown in
this example results in an error:
ftp 1.1.2.3 (trace
Instead, use the standard UNIX flag (for example, -d) or precede the left
parenthesis with an escape character, such as the backslash (\):
ftp 1.1.2.3 \(trace
Format
|
ftp
-a NEVER 21
GSSAPI foreign_host
TLS port_number
-d
-e
-f ftpdata_filename
-g
-i
-n
-p tcpip
-r NEVER
GSSAPI
TLS
-s srcip
-t data_set_name
-v
-w nn
-x

(
Exit TRACe TImeout nn TCP tcpip
Exit = nn

Parameters
-a
NEVER
FTP does not attempt authentication upon initial connection.

GSSAPI
FTP attempts auto-authentication upon initial connection. FTP attempts to
authenticate to the FTP server by sending the AUTH command specifying
GSSAPI as the authentication type. Once the authentication type is
accepted, the authentication protocol proceeds by issuing ADAT
commands.
TLS
TLS as the authentication type.
| Result: If you specify the TLS parameter, FTP attempts to authenticate for
| the control connection regardless of how you have configured FTP.DATA.
| FTP does not protect the data connection unless you have configured
| FTP.DATA to protect the data connection.
-d Starts the generation of tracing output. Equivalent to TRACE.
-e Terminates FTP for certain FTP errors with a nonzero MVS return code.
Equivalent to EXIT.
-f ftpdata_filename
Specifies the client file. You can specify a z/OS UNIX file, an MVS data set, or
a ddname.
| Result: If you specify the -f parameter and the file or data set cannot be used,
| the client will exit.
Tip: The following are some examples of using the -f parameter to specify the
client’s FTP.DATA:
v When the FTP client is invoked from the z/OS UNIX shell:
– To specify a z/OS UNIX file enter:
ftp -f /etc/ftpascii myftphost
– To specify an MVS data set enter:
ftp -f ″//’USER12.FTP.DATA’″ myftphost
v When the FTP client is called from TSO:
– To specify a z/OS UNIX file enter:
ftp -f ″/etc/ftpascii″ 127.0.0.1
– To specify an MVS data set enter:
ftp -f ″//’USER1.MYFTP.DATA’″ 127.0.0.1
– To specify an MVS PDS member enter:
ftp -f ″//’SYS1.TCPPARMS(FTPCDATA)’″ 127.0.0.1
– To specify an MVS data set by its ddname enter:
alloc fi(myftp) da(’USER1.MYFTP.DATA’) SHR ftp -f ″//dd:myftp″
127.0.0.1
Rule: When using the -f parameter from the TSO client, enclose the ftpdata
parameter in quotes. For example:
ftp -f ″/u/user1/my.ftp.data″ myHost
ftp -f ″//dd:ftpdd″ myHost
ftp -f ″//’SYS1.TCPPARMS(MYFTPDAT)’″
Chapter 3. File Transfer Protocol (FTP) 31

-g Turns off metacharacter expansion (globbing). Equivalent to the GLOB
subcommand.
-i Turns off interactive prompting for MDELETE, MGET, and MPUT
subcommands. Equivalent to the PROMPT subcommand.
-n Inhibits automatic login, preventing the FTP client from prompting the user for
a user ID and password. If you specify the -n parameter and you have defined
a NETRC data set, the data set is not used to log in to this session.
-p tcpip
Indicates the name of the TCP on the local host to which the FTP client should
connect. This parameter is ignored if your system is not configured for
multiple instances of TCP/IP. This is equivalent to TCP tcpip.
-t data_set_name
Specifies the name of a nonstandard translation table. Equivalent to
TRANSLATE data_set_name.
-r The option -r is the same as -a except that the AUTH command must be
accepted by the server. If it is not, then the client ends the session.
| Result: If you specify the -r parameter, FTP attempts to authenticate for the
| control connection regardless of how you have configured FTP.DATA. FTP
| does not protect the data connection unless you have configured FTP.DATA to
| protect the data connection.
NEVER
FTP does not attempt to authenticate upon initial connection. This option
overrides a value in the FTP.DATA file that would cause authentication.
GSSAPI
GSSAPI as the authentication type. Once the authentication type is
accepted, the authentication protocol proceeds by issuing ADAT
commands. If the authentication type is not accepted, the client terminates
the connection.
TLS
TLS as the authentication type.
| -s srcip
| Indicates the source IP address that the FTP client uses for connections. You
| must specify this as an IP address rather than a host name. The address must
| be a unicast address. INADDR_ANY, the IPv6 unspecified address
| (in6addr_any), IPv4-mapped IPv6 addresses, and multicast addresses are not
| supported. If the IP address specified is not a valid home address on the
| TCP/IP stack, the FTP client cannot connect to the FTP server.
| Restriction: Scope information cannot be specified for the source IP address.
-v Enables verbose mode. This parameter gives you extra information (such as
message IDs) when running in z/OS UNIX.
Guideline: When running the FTP client from TSO, use the TSO profile
options MSGID and NOMSGID to affix or discard message IDs.
-w nn
Specifies the number of seconds to be used for the TIMEOUT parameters.
Equivalent to TIMEOUT nn.

-x Client attempts to negotiate encryption (data and command protection level of
private) immediately after a successful authentication negotiation.
foreign_host
Specifies the name of the host to which you are connecting. Specify the host by
its host name or its IP address. The host can be a remote host or your local
| host. When you use IPv6 link-local addresses, you can provide scope
| information along with the host name or IP address, as described in support
| for scope information in the z/OS Communications Server: IPv6 Network and
| Application Design Guide.
You are prompted for a host name if you do not specify a foreign_host value
with the FTP command. If you specify a foreign_host value incorrectly or if the
host is not accessible, you enter the FTP environment without connecting to a
host. You should then use either the OPEN subcommand to attempt another
connection with a host or the QUIT subcommand (or Ctrl-C, in z/OS UNIX) to
exit the FTP environment.
port_number
Specifies the port number of the FTP server on the remote host. The default is
well-known port 21. The maximum port number that can be specified is 65
534. This parameter should not be used unless you are sure there is a server
listening on a port other than the well-known port 21 at the destination.
Exit
Terminates FTP, for certain FTP errors, with a nonzero MVS return code. See
“FTP return codes” on page 105 for a description of the return code options
available for the client.
Exit=nn
Terminates FTP with a nonzero return code of your choice when an FTP error
occurs. Valid values are in the range 0–4095.
TRACe
Starts the generation of tracing output. TRACe is used in debugging.
TImeout nn
Specifies the number of seconds (nn) to be used for the following TImeout
parameters:
v MYOPENTIME
v DCONNTIME
v CCONNTIME
v INACTTIME
v DATACTTIME
The name of each timer corresponds to an FTP.DATA statement available to set
that timer. See the FTP.DATA data set statements information in the z/OS
Communications Server: IP Configuration Reference for a description of each of
these timers and its default value.
If you specify a value outside the range 15 – 86 400, the Timeout parameters
are not changed.
Result: If the value is not a number, all Timeout values are set to 0.
TCP tcpip
Indicates the name of the TCP on the local host to which the FTP client should
connect. This parameter is ignored if your system is not configured for
multiple instances of TCP/IP.

Note: You must specify this value as a parameter, not as a value in the
FTP.DATA data set. You can choose to specify this value with the
TCPIPJOBNAME statement in the resolver configuration file.
Specifies the data set name of a nonstandard translation table. If you specify
this parameter, FTP uses the translation table in the
user_id.data_set_name.TCPXLBIN data set, rather than the standard translation
table provided with TCP/IP (hlq.STANDARD.TCPXLBIN). The
hlq.STANDARD.TCPXLBIN data set is never used if you specify the
TRANSLATE parameter.
If user_id.data_set_name.TCPXLBIN does not exist, FTP uses
hlq.data_set_name.TCPXLBIN. If neither data set exists, or if they were
incorrectly created, FTP ends with an error message.
Since the TRANslate parameter also dictates the search order for DBCS
translation tables, you might wish to use a customized DBCS translation table
but not require a modified SBCS translation table. If this is the case, copy
hlq.STANDARD.TCPXLBIN into the nonstandard TCPXLBIN translation table
data set to ensure that FTP will start.
Notes:
1. Use the CTRLConn and SBDataconn statements in your local FTP.DATA
data set to specify different SBCS tables for the control and data
connections, or use the LOCSITE SBDataconn subcommand to change the
SBCS translation for the data connection. For information on specifying
these statements, see “Support for SBCS languages” on page 86.
2. If you require the use of a customized DBCS translation table, but cannot
or do not wish to use the TRANSlate parameter, you can name the data set
such that it is found in the client search order (for example,
userid.FTP.TCPdbBIN). See the z/OS Communications Server: IP Configuration
Reference for information about the DBCS translation table search order. FTP
does not terminate because it fails to find a nonstandard DBCS translation
table data set.
Usage
v When starting FTP in a TSO environment that includes support for the REXX™
programming language, you receive the following message:
CSV003I Requested module IRXSTK not found
This is a normal informational message when starting FTP in a TSO

environment.
| v If you enter the FTP flags (-a, -d, -e, -f, -g, -i, -n, -p, -r, -s -t, -v, -w, and -x) from
z/OS UNIX the flags must be entered in lowercase. These options can be
entered in lowercase or uppercase from TSO.
v GSSAPI authentication is supported only for IPv4 connections. The client fails
the negotiation when the connection is IPv6.
v NOOPTMSS is no longer supported and is ignored.
v When FTP is started from the FTP Client API, some of the start parameters are
ignored. See the FTP client behavior when started by the FTP Client API section
in the z/OS Communications Server: IP Programmer’s Guide and Reference for more
information.

Context
v See “Open subcommand—Connect to the FTP server” on page 247 and “QUIt
subcommand—Leave the FTP environment” on page 258 for more information
about the OPEN and QUIT subcommands.
v See “FTP return codes” on page 105 for a description of return code handling in
the FTP client.
v See “Changing local site defaults using FTP.DATA” on page 70 for information
about the FTP.DATA data set.
v See the z/OS Communications Server: IP Configuration Reference for information
about the TCPIP.DATA data set or loading and customizing DBCS translation
tables.

Logging in to FTP
If you correctly specify a foreign host with the FTP command, you are prompted to
identify yourself. The following is a sample of the information that is displayed
after you successfully invoke the FTP command with foreign_host correctly
specified.
IBM FTP CS V1R5
FTP: using TCPCS
Connecting to: 9.67.113.37 port: 21.
220-FTPD1 IBM FTP CS V1R4 at vic135, 19:11:09 on 2003-01-15.
220 Connection will close if idle for more than 5 minutes.
NAME (9.67.113.37:USER10):
>>> USER USER10
331 Send password please.
PASSWORD:
>>> PASS
230 USER10 is logged on. Working directory is "/tmp".
Command
After successfully identifying yourself, you are prompted for a password if the
foreign host requires a password. If you enter the password correctly, you are
connected to the foreign host.
Notes:
1. You can use the data set NETRC to automatically log in to a remote host. For
information about using NETRC, see “NETRC data set” on page 40.
2. If you have enabled UTF-8 encoding of the control connection, the login
sequence is different. See “UTF-8 enabled control connection” on page 39 for
more information.
3. During the FTP login process, if you receive a series of 230-type replies there
might be errors in the server configuration files. These replies contain CD and
SITE command errors that might appear. These errors describe the failures of
CD and SITE commands listed in a user-level configuration file on the server.
Contact the system programmer for assistance.
See FTPD reply codesz/OS Communications Server: IP and SNA Codes for
additional information about 230-type replies.
4. When the FTP Client API is invoked by an application program, ddnames
associated with the application are not available to the spawned FTP client
process and the handling of prompts from the client differs. See the FTP client
behavior when started by the FTP Client API section in the z/OS
Communications Server: IP Programmer’s Guide and Reference for more
information.
For the procedure to enter the FTP environment using the FTP command, see
“Establishing and exiting a connection” on page 41 for more information.
Interpreting FTP client output

The z/OS FTP client output can be categorized as follows:
v Client messages
v Server replies
v Echo input
v Client trace
The following is an example of FTP client output:

1# ftp -v vic135
2EZY2640I Using ’USER1.FTP.DATA’ for local site configuration parameters.
3EZYFT46E Error in ’USER1.FTP.DATA’ file: line 580 near column 11.
4EZYFT25I Using //’TPOUSER.STANDARD.TCPXLBIN’ for FTP translation tables for
the control connection.
5EZYFT75I Using internal translate tables for the data connection.
6EZA1450I IBM FTP CS V1R7
7EZA1466I FTP: using TCPCS
8EZYFT18I Using catalog ’/usr/lib/nls/msg/C/ftpdmsg.cat’ for FTP messages.
9EZA1554I Connecting to: vic135.tcp.raleigh.ibm.com 9.42.103.37 port: 21.
10220-FTPD1 IBM FTP CS V1R7 at VIC135.tcp.raleigh.ibm.com, 21:21:49 on 2004-11-08.
11220 Connection will not timeout.
12EZA1459I NAME (vic135:USER1):
13EZA1701I >>> USER USER1
15EZA1789I PASSWORD:
16230 USER1 is logged on. Working directory is "USER1.".
17EZA1460I Command:
18debug all
19PC0346 parseCmd: subcommand: debug
20PC0371 parseCmd: parameter 1: all
21EZA2923I Active client traces - FLO CMD PAR INT ACC UTL SEC FSC(1) SOC(1) SQL
22SC3392 resetLastReply: entered
23PC0657 parseCmd: using primary session.
24CU0307 getCommand: entered
25EZA1460I Command:
26debug time
27PC0346 parseCmd: subcommand: debug
28PC0693 fndCmd: entered with debug
29PC0775 fndCmd: command found is debug
30PC0371 parseCmd: parameter 1: time
31PC0404 parseCmd: fndCmd returned the cmdrecord for debug
32PC0536 parseCmd: using primary session
33CL0205 debug: entered
34GU2981 setDebug: entered
35EZA2923I Active client traces - FLO CMD PAR INT ACC UTL SEC FSC(1) SOC(1) SQL
3616:54:46 SC3392 resetLastReply: entered
3716:54:46 PC0657 parseCmd: using primary session.
3816:54:46 CU0307 getCommand: entered
39EZA1460I Command:
Following are descriptions of the numbered items in the example.

1 This is the command that starts the FTP client. The -v option directs FTP to
precede each client message with its unique 7-character identifier.
For more information about FTP start options, see “FTP command —
Entering the FTP environment” on page 30.
2 to 9
These are FTP client messages, whose identifiers are always 8 characters
long. The message identifier appears only when you start FTP with the -v
option. After you have started FTP, you can use the client subcommand,
verbose, to toggle display of client message identifiers on and off.
The first three characters are always one of the following strings:
v EZA
v EZY
v EZZ
The final character can be E, I, or W.See z/OS Communications Server: IP
Messages Volume 1 (EZA), z/OS Communications Server: IP Messages Volume 3
(EZY), and z/OS Communications Server: IP Messages Volume 4 (EZZ,
SNM)for more information about FTP client messages.

10, 11
These are replies from the FTP server. FTP server replies are always
prefixed with a 3-digit numeric reply code, in the range 100–555. For the
meaning of the reply code, see RFC 959. If the server is a z/OS FTP server,
you will also find the FTP server reply code and reply text documented in
z/OS Communications Server: IP and SNA Codes.
12, 13, 15, 17, 21, 25, 39
These are FTP client messages, as indicated by the 3-letter prefix.
14, 16
These are FTP server replies, as indicated by the 3-digit prefix.
18 This is the echo of input entered in response to the FTP client command
prompt at line 17. The debug subcommand turns on the FTP client trace.
19, 20, 22 to 24
This is FTP client trace output. FTP client trace output lines are always
composed of a 2-letter prefix with a 4-digit numeral. The FTP client trace is
for the use of the IBM Service Center.
26 This is the echo of input entered in response to the FTP client command
prompt at line 25. The time option of the debug subcommand causes the
FTP client trace to be time-stamped
27 to 34
This is client trace generated by the client processing the debug
subcommand. This trace is not time-stamped because the client has not yet
recognized that it is processing the TIME option.
35 This is a client message issued in response to the debug subcommand.
36 to 38
This is client trace output. At this point, the client has recognized the TIME
option entered at line 26 and client trace is now time-stamped.
Allocating FTP input and output data sets

When you invoke the FTP command from TSO, a check is made to see whether a
data set is allocated to INPUT. If a data set is allocated, subcommands are read
from that data set rather than from your terminal. Similarly, a check is also made
to see whether a data set is allocated to OUTPUT. If so, all FTP prompts and
replies are written to that data set rather than to your terminal.
The record length and block size of the output data set can be any size. If the
logical record length of the output data set is less than 100 bytes, some messages
could be truncated or wrapped around to the next line.
If you create INPUT and OUTPUT data sets, use the following guidelines:
v Specify the INPUT data set:
– Record format=FB.
– Logical record length=2080.
The logical record length of the input data set can be any value in the range
80–2080.
– Block size is a multiple of logical record length.
v Specify the OUTPUT data set:
– Record format=FB.
– Logical record length=160.

– Block size is a multiple of 160.
Restriction: When the FTP Client API is invoked by an application program,
INPUT and OUTPUT ddnames are not available to the spawned FTP client
process. See the z/OS Communications Server: IP Programmer’s Guide and
Reference for a description of the FTP Client API.
UTF-8 enabled control connection

You can specify EXTENSIONS UTF8 in the client’s FTP.DATA data set to enable
the FTP client to use and accept UTF-8 encoding of the control connection. See the
z/OS Communications Server: IP Configuration Reference for information about the
EXTENSIONS statement. If you code EXTENSIONS UTF8 in the client’s FTP.DATA
data set, the login sequence is different. Following is an example of logging in to a
UTF-8 enabled FTP server when the client has enabled UTF-8 encoding of the
control connection.
IBM FTP CS V1R5
FTP: using TCPCS
>>> FEAT
211- Extensions supported
UTF8
LANG en*
211 End
>>> LANG en
200 - Language is en-US (United States English)
NAME (9.67.113.37:USER10):
>>> USER USER10

PASSWORD:
>>> PASS
Command:
The difference is that the client issues the FEAT command during login to
negotiate use of UTF-8 on the control connection, as specified in RFC 2640 (see
Appendix D, “Related protocol specifications,” on page 449). In this example, the
FEAT reply indicates the server supports RFC 2640 (UTF8 and LANG keywords),
so the client issues LANG to commence UTF-8 encoding of the control connection.
Here is an example of a UTF-8 enabled client logging in to a server which does not
support UTF-8 encoding:
IBM FTP CS V1R5
FTP: using TCPCS
>>> FEAT
211- Extensions supported
SIZE
MDTM
REST STREAM
211 End
NAME (9.67.113.37:USER10):
>>> USER USER10

PASSWORD:

>>> PASS
Command:
The client issued the FEAT command during login because EXTENSIONS UTF8 is
coded in FTP.DATA. Since the server FEAT reply did not indicate the server
supports RFC 2640, no LANG command was issued by the client. The client will
not send UTF-8 encoded data to this server.
NETRC data set

The user_id.NETRC data set (/$HOME/.netrc, in z/OS UNIX) provides you with
an alternative to specifying your user_id and password values as FTP parameters
when you want to FTP to a remote host. The following example shows you how to
specify the user_id.NETRC data set:
machine mvs1.tcp.raleigh.ibm.com login user28 password user28
machine 9.67.112.25 login user28
MACHINE FEDC:BA98:7654:3210:FEDC:BA98:7654:3210 LOGIN user28
The keywords machine, login, and password must be lowercase and the variables
user_ID and password might be case sensitive, depending on the remote host. (For
example, when using UNIX or AIX hosts, the user_ID and password values are case
| sensitive.) The hostname variable that is specified after the machine keyword can
| include scope information, as described in the support for scope information in the
| z/OS Communications Server: IPv6 Network and Application Design Guide.
| Guideline: If you include scope on the FTP command (for example,

| hostname%scope), there should be an entry defined in the user_id.NETRC data set
| that includes scope as part of the hostname value following the machine keyword.
| Defining this entry ensures that the correct user_id and password values are
| selected.
To invoke the user_id.NETRC data set and automatically log on to the remote host
named MVS1, enter the FTP command as shown in the following example:
User: ftp mvs1
System:
IBM FTP CS V1R5
FTP: using TCPCS
220-FTPD1 IBM FTP CS V1R2 at MVSVIC04, 12:00:51 on 2003-01-12.
>>>USER user28
>>>PASS ********
230 USER28 is logged on. Working directory is "/u/user28".
Command:
In order to bypass definitions in a user_id.NETRC data set for an FTP session,

specify the -n parameter. For information about using the user_id.NETRC data set
in a batch file, see “Submitting FTP requests in batch” on page 98.
Environment variables
The following are environment variables that are referenced by FTP:

Table 4. Environment variables accessed by FTP
Environment variable Command-type Description
application
1 HOME FTP CLIENT Initialized by the system at login to a value equal to
the path name of the user’s home directory.
2 LANG FTP CLIENT Determines the locale category for native language,
local customs, and coded character set in the
absence of the LC_ALL and other LC_* environment
variables (including LC_COLLATE, LC_CTYPE,
LC_MESSAGES, LC_MONETARY, LC_NUMERIC,
AND LC_TIME).
3 NLSPATH FTP CLIENT Contains a sequence of templates used by the
catopen() function when it attempts to locate
message catalogs. Each template consists of an
optional prefix, one or more conversion
specifications, a file name, and an optional suffix.
4 SHELL FTP CLIENT Sets the default shell used by make, vi, and other
tools.
Getting help
The FTP Help subcommands are listed in Table 5.
Table 5. FTP subcommands for getting help
? Provides an introduction to “HElp and ? subcommands—Display help
using FTP. information” on page 186
HElp Displays help information for “HElp and ? subcommands—Display help
FTP. information” on page 186
man UNIX Shell command “Obtaining command help” on page 7
provides help information
about the z/OS UNIX FTP
client.
Establishing and exiting a connection

You normally establish a connection to a foreign host when you invoke the FTP
command with a foreign_host specified. If you are not successful in specifying a
foreign host, or if you need to connect to a different foreign host, use the
subcommands listed in Table 6.
Table 6. FTP subcommands for establishing and exiting a connection
ACCt Sends “ACCt subcommand—Supply account information”
host-dependent on page 143
account information.
CLose Disconnects from the “CLose subcommand—Disconnect from a remote
foreign host. host” on page 159
Open Opens a connection “Open subcommand—Connect to the FTP server” on
to a foreign host. page 247
PAss Supplies a password “PAss subcommand—Supply a password” on page
to the foreign host. 248

Table 6. FTP subcommands for establishing and exiting a connection (continued)
QUIt Leaves the FTP “QUIt subcommand—Leave the FTP environment”
command on page 258
environment.
User Identifies you to a “User subcommand—Identify yourself to a host or
foreign host. change your TSO user ID password” on page 320
Example of establishing and exiting a connection

This example shows how a single FTP session can be used to connect to the
following multiple foreign hosts:
1. MVS Host: 2001:0DB8:c2d4::9:67:115:12 port 21
2. VM Host: 192.9.2.4
ftp 2001:0DB8:c2d4::9:67:115:12
IBM FTP CS V1R5
FTP: using TCPCS
Connecting to: 2001:0DB8:c2d4::9:67:115:12 port: 21.
220-FTPD1 IBM FTP CS V1R4 at MVSVIC96, 12:38:19 on 2003-01-27.
NAME (2001:0DB8:c2d4::9:67:115:12:USER1):
user2 ******
>>> USER user2
>>> PASS
230 USER2 is logged on. Working directory is "/".
Command:
User: close
System:
>>>QUIT
221 Quit command received. Goodbye.
Command:
User: open 192.9.2.4
_
System:

220-FTPSERVE IBM VM Level 320 at VM.IBM.COM, 14:03:49 EST MONDAY 2003-01-11
NAME (<host>:tsouserid):
User: vmuser
System:
>>USER vmuser
331 Sent password please.
Password:
>>>PASS ********
230 VMUSER logged in; working directory = VMUSER 191
Command:
User: account
System:
Usage: ACCT account-information
Command:
User: acct vmuser
System:
>>>ACCT ********
230 You now have write permission to VMUSER 191
Command:
User: close
System:
>>>QUIT
Command:
Initial working directory considerations at the z/OS FTP server

When you first log in to a z/OS FTP server, the initial or default working directory
at the server is determined by the following:
v The value specified on the STARTDIRECTORY statement in the FTP.DATA file of
the server
v The user ID you used when you connected to the server

v The prefix defined in the profile for the user ID
Note: To use FTP, your user ID must have an OMVS segment defined (or
defaulted).
If STARTDIRECTORY HFS is defined at the server, the initial working directory is

the home directory for the user ID. An example of an initial working directory for
USER1 is the following:
/u/user1
If STARTDIRECTORY MVS is defined at the server and no prefix is defined for the
user ID, the initial working directory is the user ID followed by a period. An
example of an initial working directory for USER1 is the following:
USER1.
If your TSO user ID is defined through Resource Access Control Facility (RACF®)
and a PREFIX is defined for the user ID, the PREFIX value is used as the initial
working directory.
The PREFIX of a TSO user ID can be set or changed by using the TSO PROFILE
command as follows:
1. Log in to TSO on the MVS system of the FTP server.
2. Set your new prefix using the TSO PROFILE command:
TSO PROFILE Prefix(prefix)
where prefix is any TSO prefix that you choose.
Notes:
a. You must enter both the opening and closing parentheses.
b. At this point, the TSO prefix is defined for your current TSO session but is
not known to RACF or the FTP server until you log off and log on.
3. Log off to save the new default working directory name.
The TSO prefix should now be your default working directory whenever you log
on to an FTP session on that FTP server. To verify that you set up the default
working directory correctly, perform the following steps:
1. Establish an FTP session to the FTP server.
2. Issue a PWD command. This should show the TSO prefix as your new default
working directory. For information on using the PWD command, see “PWd
subcommand—Display the current working directory” on page 257.
Notes:
1. To use the TSO PREFIX as your default working directory, you must have
installed RACF Version 1.9 and you must define your TSO user IDs through
RACF.
2. When you log in to an FTP server from a z/OS UNIX shell, the default local
working directory is the directory from which the FTP client was started.

Obtaining status and system information
To retrieve and display status information about the local host and remote host,
use the subcommands listed in Table 7.
Table 7. FTP subcommands for obtaining status and system information
! Passes a z/OS UNIX System “! subcommand—Invoke a z/OS UNIX
Services command to the local System Services function” on page 142
z/OS shell. This command
must be issued while using
FTP in the z/OS shell.
DEBug Sets general trace options. “DEBug subcommand—Set general trace
options” on page 162
DUMP Sets extended trace options. “DUMP subcommand—Set extended trace
options” on page 173
FEature Asks server which features or “FEature subcommand—Query FTP server
extensions it supports. for features it supports” on page 178
LOCSTat Displays FTP status “LOCSTat subcommand—Display local
information for the local host. status information” on page 218
NOop Checks whether the foreign “NOop subcommand—Test the
host is still responding. connection” on page 246
STAtus Displays status information for “STAtus subcommand—Retrieve status
the foreign host. information from a remote host” on page
301
SYstem Displays the name of the “SYstem subcommand—Display the
foreign host’s operating operating system name” on page 311
system.
TSO Passes a TSO command to the “TSO subcommand—Use TSO commands”
local host TSO environment. on page 314
Working with directories on the remote host

To obtain directory information on the remote host, use the subcommands listed in
Table 8.
Table 8. FTP subcommands for working with directories on the remote host
CD Changes the working “CD subcommand—Change the directory on
directory. the remote host” on page 153
CDUp Changes to the parent of “CDUp subcommand—Change to the parent
the current working of the working directory” on page 156
directory.
CWd Changes the working “CD subcommand—Change the directory on
directory (synonymous the remote host” on page 153
with CD).
DIr Lists the directory entries “DIr subcommand—Obtain a list of directory
for files on the foreign entries” on page 168
host.
LS Lists the names of files on “LS subcommand—Obtain a list of file
the foreign host. names” on page 229

Table 8. FTP subcommands for working with directories on the remote host (continued)
MKdir Creates a directory on the “MKdir subcommand—Create a directory on
foreign host. the remote host” on page 239
PWd Displays the name of the “PWd subcommand—Display the current
active working directory working directory” on page 257
on the foreign host.
RMdir Removes a directory on “RMdir subcommand—Remove a directory
the foreign host. on the remote host” on page 264
Examples of the CD subcommand

This example shows how to change and choose remote working directories and
how the z/OS FTP server enables you to switch between the MVS and z/OS UNIX
file system environments. For more information on how to change the directory
levels, see the information on the CD, CDUP, and LCD subcommands.
User: ftp 9.67.113.24 621
System:
IBM FTP CS V1R5
FTP: using TCPCS
Connecting to 9.67.113.24, port 621
220-FTPD1 IBM FTP CS V1R2 at MVS164, 20:12:38 on 2003-01-02.
USER(identify yourself to the host):
User: user121
System:
>>>USER user121
Password:
>>>PASS ********
Command:
User: cd tcpip
System:
>>>CWD tcpip
250 HFS directory /u/user121/tcpip is the current working directory
Command:
User: cd ..
System:
>>>CWD ..
250 HFS directory /u/user121 is the current working directory
Command:
User: cd ’user121’
System:
250 "’user121’" is working directory name prefix.
Command:
Examples showing the differences between DIR and LS output

for z/OS UNIX directories
The examples in this section use the following Internet addresses:
MVSXA2: 9.67.113.25
MVSXA3: 9.67.113.24
The current host is MVSXA2 (9.67.113.25). An FTP command is issued from
9.67.113.25 to 9.67.113.24.

User: ftp 9.67.113.24
System:
IBM FTP CS V1R5
FTP: using TCPCS
User: user121
System:
>>>USER user121
Password:
>>>PASS ********
Command:
User: dir
System:
>>>PORT 9,67,112,25,4,25
200 Port request OK.
>>>LIST
125 List started OK.
total 2736
drwxr-xr-x 2 USER121 SYS1 0 Nov 20 18:15 IBM
-rwxr-xr-t 2 USER121 SYS1 389120 Feb 5 16:03 ftpdka
-rwxr-xr-t 2 USER121 SYS1 962560 Feb 5 16:04 ftpsrvka
-rw-r----- 1 USER121 SYS1 11648 Jan 20 14:30 g.s
drwxr-x--- 3 USER121 SYS1 0 Oct 21 17:50 msg
-rw-r----- 1 USER121 SYS1 1458 Jan 10 19:25 s.k
drwxr-x--- 2 USER121 SYS1 0 Feb 6 15:59 tcpip
drwxr-x--- 2 USER121 SYS1 0 Feb 6 17:29 test
250 List completed successfully.
Command:
User: ls
System:
>>>PORT 9,67,112,25,4,26
>>>NLST
IBM
ftpdka
ftpsrvka
g.s
msg
s.k
tcpip
test
Command:
DIR provides detailed information about the data sets under the remote working
directory, while LS shows the data set names only.
Examples showing the differences between DIR and LS output

with DIRECTORYMode and DATASetmode for MVS
This section gives examples of issuing a DIR and LS command in both
DIRECTORYMode and DATASetmode.

User: ftp 1.1.2.3
System:
IBM FTP CS V1R5
FTP: using TCPCS
User: mvsuser
System:
>>>USER mvsuser
Password:
>>>PASS ********
230 MVSUSER is logged on. Working directory is "/u/mvsuser"
Command:
User: cd ’tcpv3’
System:
>>>CWD ’tcpv3’
257 "’TCPV3.’" is working directory name prefix.
Command:
User: site directorymode
System:
>>>SITE directorymode
200 Site command was accepted
Command:
User: dir
System:
>>>PORT 1,1,2,2,4,39
>>>LIST 125 List started OK.
Volume Unit
Referred Ext Used Recfm Lrecl BlkSz Dsorg Dsname
Pseudo Directory ETC
Pseudo Directory FTP
Pseudo Directory HOSTS
Pseudo Directory NSMAIN
Pseudo Directory PROFILE
Pseudo Directory STANDARD
Pseudo Directory TCPIP
Pseudo Directory TCPIPL62
Pseudo Directory TELNET
Command:

User: site datasetmode
System:
>>>SITE datasetmode
Command:
User: dir
System:
>>>PORT 1,1,2,2,4,40
>>>LIST
Volume Unit Date Ext Used Recfm Lrecl BlkSz Dsorg Dsname
APCSPL 3380D 07/16/97 1 1 FB 80 8800 PS ETC.RPC
APCSPL 3380D 08/03/97 1 1 FB 80 3200 PS ETC.SERVICES
APCSPL 3380D 08/03/97 1 1 FB 80 3120 PS FTP.DATA
APCSPL 3380D 08/02/97 1 1 F 158 158 PS HOSTS.ADDRINFO
APCSPL 3380D 08/03/97 1 1 FB 80 3120 PS HOSTS.LOCAL
APCSPL 3380D 07/30/97 1 1 F 56 56 PS HOSTS.SITEINFO
APCSPL 3380D 07/15/97 1 1 FB 80 8800 PS NSMAIN.CACHE
APCSPL 3380D 07/28/97 1 1 FB 80 8800 PS NSMAIN.DATA
APCSPL 3380D 08/03/97 1 2 FB 80 3200 PS PROFILE.TCPIP
APCSPL 3380D 07/26/97 1 2 FB 80 3200 PS PROFILE.TCPIP.XA2
APCSPL 3380D 08/03/97 1 1 VB 5124 6160 PS STANDARD.TCPKJBIN
APCSPL 3380D 08/03/97 1 15 F 256 256 PS STANDARD.TCPXLBIN
APCSPL 3380D 08/03/97 1 1 FB 80 3120 PS TCPIP.DATA
APCSPL 3380D 06/29/97 1 2 FB 80 3200 PS TCPIPL62.CONFIG
APCSPL 3380D 07/29/97 1 15 F 256 256 PS TELNET.TCPXLBIN
Command:
User: site directorymode

System:
>>>SITE directorymode
Command:
User: ls
System:
>>>PORT 1,1,2,2,4,41
>>>NLST
ETC
FTP
HOSTS
NSMAIN
PROFILE
STANDARD
TCPIP
TCPIPL62
TELNET
Command:

User: site datasetmode
System:
>>>SITE datasetmode
Command:
User: ls
System:
>>>PORT 1,1,2,2,4,42
>>>NLST
ETC.RPC
ETC.SERVICES
FTP.DATA
HOSTS.ADDRINFO
HOSTS.LOCAL
HOSTS.SITEINFO
NSMAIN.CACHE
NSMAIN.DATA
PROFILE.TCPIP
PROFILE.TCPIP.XA2
STANDARD.TCPKJBIN
STANDARD.TCPXLBIN
TCPIP.DATA
TCPIPL62.CONFIG
TELNET.TCPXLBIN
Command:
Working with directories on the local host

To work with directories on the local host, use the subcommands listed in Table 9.
Table 9. FTP subcommands for working with directories on the local host
LCd Changes the current “LCd subcommand—Change the local
directory on the local host. working directory” on page 193
LMkdir Creates a directory on the “LMkdir subcommand—Create a directory on
local host. the local host” on page 225
LPwd Displays the name of the “LPwd subcommand—Display the current
active working directory on working-level qualifier” on page 228
the local host.
Your default working directory on the local host is set according to the
environment in which the FTP client is invoked: $HOME in z/OS UNIX, your
MVS user ID in TSO.
The following examples show how to choose local working directories.

User: ftp 1.1.2.3
System:
IBM FTP CS V1R5
FTP: using TCPCS
User: mvsuser
System:
>>>USER mvsuser
Password:
>>>PASS ********
230 MVSUSER is logged on. Working directory is "/u/mvsuser".
Command:
User: lpwd
System:
Local directory is MVSUSER.
Command:
User: lcd tcpip
System:
Local directory name set to MVSUSER.TCPIP.
Command:
User: lpwd
System:
Local directory is MVSUSER.TCPIP.
Command:
User: lcd ’ftp.test’
System:
Local directory name set to FTP.TEST.
Command:
User: lpwd
System:
Local directory is FTP.TEST.
Command:
User: lcd ..
System:
Local directory name set to FTP.
Command:
User: lpwd
System:
Local directory is FTP.
Command:
Security considerations
The following describes security issues to consider when using FTP.
Using security mechanisms

File data transferred between an FTP client and server can be secured with respect
to encryption, authentication, and data integrity.
Authentication established using a security mechanism can also be used to make

the authorization decision. The FTP security interaction begins with a client telling
the server what security mechanism it wants to use with the AUTH command. The
server either accepts this mechanism, rejects this mechanism, or, in the case of a

server which does not implement the security extensions, rejects the command
completely. The server’s reply indicates if the client must respond with additional
data for the security mechanism to interpret.
Once a security association is established, authentication (which is part of this

association) can be used in addition to the standard user ID/password exchange
for authorizing a user to connect to the server. A user ID specified by the USER
command is always required to specify the identity to be used on the server.
Transport Layer Security (TLS) is an upwardly-compatible successor to Secure

Sockets Layer (SSL). SSL is a protocol that performs secure and encrypted TCP
transmission. The FTP client supports either SSL or TLS protected sessions,
including client authentication. Note that the negotiation of SSL versus TLS is
performed by the sockets-layer TLS code and is transparent to FTP.
Many TLS/SSL applications work by having a client connect to one TCP port for
unprotected sessions and a separate TCP port for protected ones. FTP supports this
mode for compatibility with the original SSL design. However, FTP also provides a
more general solution for FTP security, where the client connects to the FTP server
on the regular, non-encrypted port and negotiates authentication and encryption
options.
| FTP assumes that the port configured by the TLSPORT statement (default
| TLSPORT is 990) is a protected port. An AUTH command is not needed and the
client completes the exchange of additional data with the server immediately after
a successful connection.
| FTP support for SSL/TLS protected sessions is based on the Internet Draft, On
| Securing FTP with TLS. As of October, 2005, On Securing FTP with TLS has been
| published as RFC 4217. The RFC level is different from the Internet draft. You can
| set the TLSRFCLEVEL configuration option to choose which level of On Securing
| FTP with TLS you want FTP to support.
| To use the new RFC 4217 function, the client and server must have the same
| TLSRFCLEVEL value. Otherwise, the client and server do not need to be
| configured with the same TLSRFCLEVEL values.
| Table 10 identifies important differences between the draft level and the RFC level
| of the TLSRFCLEVEL value.
| Table 10. Important differences between the draft level and the RFC level
| Draft level RFC level
| The server does not support the CCC and The server supports the CCC and AUTH
| AUTH commands when the connection is commands on TLS-secured connections that
| secured with TLS. are not implicitly secured by connecting to
| the port that is configured with the
| TLSPORT statement.
| The client does not allow CCc or CProtect The client allows the CCc and CProtect clear
| clear subcommands during a session that is subcommands during a TLS-secured session
| secured with TLS. that is not implicitly secured by connecting
| to the port that is configured with the
| TLSPORT statement.

| Table 10. Important differences between the draft level and the RFC level (continued)
| Draft level RFC level
| The client does not allow an AUTH The client allows the AUTH command
| command to flow during a session that is during a TLS-secured session that is not
| secured with TLS. implicitly secured by connecting to the port
| that is configured with the TLSPORT
| statement.
|
| The server does not allow the PROT or PBSZ commands to run on a control
| connection that has been cleared with the CCC command. After a successful CCc
| subcommand, the client does not allow clear, protect clear, private, and protect
| private subcommands for the remainder of the session.
There are optional FTP commands and statements for negotiating session security.
The following is a list of the configuration parameters that determine whether the
client uses a security mechanism to protect the session:
v See “FTP command — Entering the FTP environment” on page 30 for a
description of the start parameters.
Start parameters
-a TLS
-a GSSAPI
-r TLS
-r GSSAPI
v See “Changing local site defaults using FTP.DATA” on page 70 and the z/OS
Communications Server: IP Configuration Reference for a description of the
FTP.DATA statements.
FTP.DATA statements
SECURE_MECHANISM
SECURE_FTP
SECURE_CTRLCONN
SECURE_DATACONN
| SECUREIMPLICITZOS
CIPHERSUITE
KEYRING
| TLSPORT
| TLSRFCLEVEL
TLSTIMEOUT
SECURE_PBSZ
Using a SOCKS server

You can configure the FTP client to access FTP servers through a SOCKS server.
When entering FTP through a SOCKS server, the FTP client establishes a
connection with the SOCKS server and then the SOCKS server establishes a
connection to the FTP server. All data and commands for the FTP session are
relayed through the SOCKS server. A SOCKS server can be configured to log all
FTP connections and permit or deny access to certain FTP servers. See
“Configuring the FTP client for SOCKS server” on page 72 for more information.

Chapter 4. Transferring data using the File Transfer Protocol
(FTP)
The FTP command enables you to transfer data sets between your local host and
any host that supports TCP/IP and FTP. Using the FTP command and its
subcommands, you can sequentially access multiple hosts without leaving the FTP
environment.
This topic describes information about:

v “Preparing the environment”
v “Transferring data” on page 55
v “Changing local site defaults using FTP.DATA” on page 70
v “Sample FTP.DATA data set (FTCDATA)” on page 72
v “Support for SBCS languages” on page 86
v “Support for MBCS languages” on page 90
v “Specifying values for new data sets” on page 91
v “Generation data group support” on page 94
v “Submitting FTP requests in batch” on page 98
v “Using the EXEC interface” on page 102
v “FTP return codes” on page 105
v “Restarting a failed data transfer” on page 112
v “Interfacing with JES” on page 113
v “Performing DB2 SQL queries with FTP” on page 129
v “FTP with traditional DBCS support” on page 87
Preparing the environment

You can use the subcommands that are listed in Table 11 to prepare the
environment before working with data.
Table 11. FTP subcommands for preparing the environment
AScii Sets the transfer type to “AScii subcommand—Change the data transfer
ASCII. type to ASCII” on page 146
BINary Sets the transfer type to “BINary subcommand—Change the data
IMAGE. transfer type to Image” on page 150
BLock Sets the data transfer “BLock subcommand—Set the block data
mode to block mode. transfer mode” on page 151
COMpress Sets the data transfer “COMpress subcommand—Set the compressed
mode to compressed data transfer mode” on page 160
mode.
EBcdic Sets the transfer type to “EBcdic subcommand—Change the data
EBCDIC. transfer type to EBCDIC” on page 175
FIle Sets the file structure to “FIle subcommand—Set the file structure to
File. File” on page 179

Table 11. FTP subcommands for preparing the environment (continued)
GLob Toggles globbing (the “GLob subcommand—Toggle expansion of
expansion of metacharacters” on page 182
metacharacters in file
names) for the
MDELETE, MGET, and
MPUT subcommands.
LOCSIte Specifies information “LOCSIte subcommand—Specify site
that is used by the local information to the local host” on page 195
host to provide service
specific to that host
system.
LANGuage Sets language for server “LANGuage subcommand—Set the language
replies. used for FTP replies from the server” on page
192
MOde Specifies the mode or “MOde subcommand—Set the data transfer
data format of the mode” on page 242
transfer.
PROMpt Toggles interactive “PROMpt subcommand—Toggle interactive
prompting for prompting for M* commands” on page 250
MDELETE, MGET, and
MPUT commands.
QUOte Sends an uninterpreted “QUOte subcommand—Send an uninterpreted
string of data. string of data” on page 259
RECord Sets the file structure to “RECord subcommand—Set the file structure
record. to record” on page 261
SENDPort Enables or disables “SENDPort subcommand—Toggle the sending
automatic transmission of port information” on page 268
of the FTP server PORT
command.
SENDSite Enables or disables “SENDSite subcommand—Toggle the sending
automatic transmission of site information” on page 269
of the SITE
subcommand.
SIte Sends information to the “SIte subcommand—Send site-specific
foreign host using information to a host” on page 270
site-specific commands.
STREam Sets the data transfer “STREam subcommand—Set the stream data
mode to stream mode. transfer mode” on page 308
STRucture Sets the file transfer “STRucture subcommand—Set the file
structure. structure” on page 309
SUnique Changes the storage “SUnique subcommand—Changes the storage
methods. method” on page 310
TYpe Specifies the transfer “TYpe subcommand—Set the data transfer
type. type” on page 315

Transferring data
You can use the subcommands listed in Table 12 to work with and transfer data.
Table 12. FTP subcommands for transferring data
APpend Appends a data set on “APpend subcommand—Append a local data
your local host to a file on set” on page 144
the foreign host.
DELEte Deletes a single file on the “DELEte subcommand—Delete files” on page
foreign host. 166
DELImit Displays the delimiter “DELImit subcommand—Display the file name
character between the delimiter” on page 167
file_name and file_type.
Get Copies a file from the “Get subcommand—Copy files” on page 180
foreign host to your local
host.
MDelete Deletes multiple files on “MDelete subcommand—Delete multiple files”
the foreign host. on page 232
MGet Copies multiple files from “MGet subcommand—Copy multiple files” on
the foreign host to your page 235
local host.
MPut Copies multiple files on “MPut subcommand—Copy multiple data sets
your local host to the to the remote host” on page 243
foreign host.
PUt Copies a file on your local “PUt subcommand—Copy data sets to the
host to the foreign host. remote host” on page 255
REName Renames a file on the “REName subcommand—Rename files” on
foreign host. page 262
REStart Restarts a checkpointed “REStart subcommand—Restart a checkpointed
data transfer. data transfer” on page 263
SRestart Restarts a stream mode “SRestart subcommand—Restart a stream data
data transfer. transfer” on page 299
How to transfer data

FTP supports only the data transfer of a data set or file structured as a continuous
sequence of data bytes. This ensures that the correct record format is preserved
across MVS hosts. Information could be lost or altered during transmission if you
use an incorrect transfer.
Table 13 shows how to set the transmission attributes for different host systems.
For example, VM or MVS host systems use EBCDIC for internal character
representation. A text file of ASCII data type contains displayable characters; a
carriage return (X'0D') and line feed (X'0A') are used to delimit a line. A text file of
EBCDIC data type contains displayable characters; the new-line character (X'15') is
used to delimit a line. A binary file contains a contiguous stream of bits with no
line delimiters.
Table 13. Recommended methods for data transfer
Transfer between host types Data transfer type Data transfer mode
EBCDIC and EBCDIC — DBCS text data IBMKANJI (EBCDIC) Stream
Chapter 4. Transferring data using the File Transfer Protocol (FTP) 55

Table 13. Recommended methods for data transfer (continued)
Transfer between host types Data transfer type Data transfer mode
EBCDIC and EBCDIC — text data EBCDIC Stream
EBCDIC and EBCDIC — DBCS binary IBMKANJI (EBCDIC) Block
data
EBCDIC and EBCDIC — binary data EBCDIC Block
EBCDIC and ASCII — DBCS text data SJISKANJI, EUCKANJI, Stream
JIS78KJ, JIS83KJ,
HANGEUL, KSC5601,
TCHINESE, BIG5,
SCHINESE (ASCII)
ASCII and EBCDIC — MBCS data ASCII Stream
ASCII and EBCDIC — text data ASCII Stream
ASCII and EBCDIC — DBCS binary data Image (binary) Stream
ASCII and EBCDIC — binary data Image (binary) Stream
ASCII-to-EBCDIC-to-ASCII — all data Image (binary) Stream
Note: The EBCDIC host is used for
storage only. Data remains encoded in
ASCII; therefore, the data cannot be used
on the EBCDIC host.
For more information about the DBCS data type keywords and examples, see “FTP
with traditional DBCS support” on page 87.
For information about setting data transfer type, see “TYpe subcommand—Set the
data transfer type” on page 315. For information about setting data transfer mode,
see “MOde subcommand—Set the data transfer mode” on page 242.
Examples of GET and MGET subcommands

Results:
1. If the LISTSUBdir option is not specified on the SITE subcommand and the
LISTSUBDIR statement is not specified in the server FTP.DATA file, the default
is as if the LISTSUBdir option was specified on the SITE subcommand.
2. If the z/OS FTP server has the NOLISTSUBDIR option on the SITE
subcommand or LISTSUBDIR FALSE in the server FTP.DATA file, then an mget
* command gets only the files in the current directory.
Restrictions:
1. The LISTSUBDIR statement applies to z/OS UNIX file operations only. MVS
data set operations are not affected.
2. The SITE LISTSUBDIR command is supported by z/OS FTP in V1R7 and later
releases. The FTP client must be communicating with a z/OS V1R7 or later FTP
server or an unrecognized parameter response results.
Example 1: GET and MGET enable you to obtain files from a remote host and send
them to the local host. In this example, FTP subcommands are issued from
MVSXA2 to MVSVIC03. See Table 12 on page 55 for other subcommands useful for
working with and transferring data.
The following members exist in the data set USER121.FTP.EXAMPLE on

MVSVIC03:

FILE1
FILE2
FILE3
FILE4
FILE5
The following is displayed when entering the FTP environment:

User: ftp 9.67.113.24 621
System:
IBM FTP CS V1R5
FTP: using TCPCS
User: user121
System:
>>>USER user121
Password:
>>>PASS ********
Command:
User: get ’user121.ftp.example(file1)’ ’user121.ftp.example(file1)’

System:
’USER121.FTP.EXAMPLE(FILE1)’ IS AN non-EXISTENT PARTITIONED DATASET.
USE LMKDIR TO CREATE IT. LOCAL FILE NOT FOUND
COMMAND:
User: lmkdir ’user121.ftp.example’
System:
USER121.FTP.EXAMPLE CREATED.
COMMAND:
System:
>>>PORT 9,67,112,25,4,9
>>>RETR ’USER121.ftp.example(file1)’
125 Sending data set USER121.FTP.EXAMPLE(FILE1) FIXrecfm 128
250 Transfer completed successfully.
3464 bytes transferred in 0.754 seconds. Transfer rate 4.59 Kbytes/sec.
Command:
System:
>>>PORT 9,67,112,25,4,34
>>>RETR ’USER121.ftp.example(file2)’
125 Sending data set USER121.FTP.EXAMPLE(FILE2) FIXrecfm 128
Command:

System:
Data set ’USER121.FTP.EXAMPLE(FILE2)’ was not replaced.
Local file already exists
To replace it, use command with the (REPLACE option
Command:
User: get ’user121.ftp.example(file2)’ ’user121.ftp.example(file2)’ (replace
System:
>>>PORT 9,67,112,25,4,35
>>>RETR ’user121.ftp.example(file2)’
125 Sending data set USER121.FTP.EXAMPLE(FILE2)
Command:
User: lpwd
System:
Local directory is USER121
COMMAND:
User: mget ’user121.ftp.example(file3)’ ’user121.ftp.example(file4)’
System:
>>>PORT 9,67,112,25,4,10
>>>NLST ’user121.ftp.example(file3)’
>>>PORT 9,67,112,25,4,11
>>>NLST ’user121.ftp.example(file4)’
>>>PORT 9,67,112,25,4,12
>>>RETR ’USER121.FTP.EXAMPLE(FILE3)’
>>>PORT 9,67,112,25,4,13
>>>RETR ’USER121.FTP.EXAMPLE(FILE4)’
Command:

User: lpwd
System:
Local directory is USER121.
Command:
User: cd ’user121.ftp.example’
System:
>>>CWD ’user121.ftp.example’
250 "USER121.FTP.EXAMPLE" partitioned data set is working directory.
Command:
User: pwd
System:
>>>PWD
257 "USER121.FTP.EXAMPLE" partitioned data set is working directory.
Command:
User: mget file3 file4
System:
>>>PORT 9,67,112,25,4,20
>>>NLST file3
>>>PORT 9,67,112,25,4,21
>>>NLST file4
>>>PORT 9,67,112,25,4,22
>>>RETR FILE3
>>>PORT 9,67,112,25,4,23
>>>RETR FILE4
Command:
User: quit
System:
>>>QUIT
READY
User: ftp 9.67.113.24 621

System:
IBM FTP CS V1R5 2003 314 01:11 UTC
220-FTPD1 IBM FTP CS/390 V2R10 AT MVS164, 20:12:38 ON 2003-01-02.
User: user121
System:
>>>USER user121
Password:
>>>PASS ********
Command:

User: get ’/u/user121/ftp.example/file1’ ’user121.ftp.example(file1)’
System:
>>>PORT 9,67,112,25,4,24
>>>RETR ’/u/user121/ftp.example/file1’
125 Sending data set /u/user121/ftp.example/file1
Command:
User: lcd ’user121.ftp.example’
System: Local directory name set to partitioned data set USER121.FTP.EXAMPLE.
Command:
User: lpwd
System: Local directory is partitioned data set USER121.FTP.EXAMPLE.
Command:
User: cd ’/u/user121/ftp.example’
System: >>>CWD ’/u/user121.ftp.example’
250 HFS directory /u/user121/ftp.example is the current working
directory
Command:
User: pwd
System: >>>PWD
257 "/u/user121.ftp.example" is the HFS working directory.
Command:
User: get file1
System: >>>PORT 9,67,112,25,4,26
>>>RETR file1
3464 bytes transferred in 1.059 seconds. Transfer rate 3.27 kbytes/sec.
Command:
User: mget ’/u/user121/ftp.example/file4’ ’/u/user121/ftp.example/file5’

System:
>>>PORT 9,67,112,25,4,33
>>>NLST ’/u/user121/ftp.example/file4’
125 List started OK
>>>PORT 9,67,112,25,4,34
>>>NLST ’/u/user121/ftp.example/file5’
125 List started OK
>>>PORT 9,67,112,25,4,35
>>>RETR /u/user121/ftp.example/file4
7367 bytes transferred in 1.324 seconds. Transfer rate 5.56
kbytes/sec.
>>>RETR /u/user121/ftp.example/file5
3464 bytes transferred in 0.951 seconds. Transfer rate 3.64
kbytes/sec.
Command:
The data set USER121.FTP.EXAMPLE on MVSXA2 now contains the following

members:
FILE1
FILE2
FILE3
FILE4

FILE5
Restrictions:
1. You do not have a choice of names for the local file as a result of the MGET
subcommand.
2. The MGET subcommand is not applicable for generation data groups (GDGs).
Example 2: MGET with SITE LISTSUBDIR
Following is an example of mget * with SITE LISTSUBDIR. This setting affects

processing of the NLST command. The z/OS FTP client sends an NLST command
to the server as part of mget * subcommand processing. LISTSUBDIR specifies that
both the current and next subdirectory should be retrieved from the server as a
result of processing a mget * subcommand. In this example, the current directory
has a file x and a subdirectory y and subdirectory y has a file x.
site listsubdir
>>> SITE listsubdir
200 SITE command was accepted
mget * (rep
>>> PORT 127,0,0,1,4,13
>>> NLST *
125 List started OK
>>> PORT 127,0,0,1,4,14
>>> RETR x
125 Sending data set /tmp/mgetmput/x
>>> PORT 127,0,0,1,4,14
>>> RETR y/x
125 Sending data set /tmp/mgetmput/y/x
Command:
Example 3: MGET with SITE NOLISTSUBDIR
Following is an example of mget * with SITE NOLISTSUBDIR. This setting affects

to the server as part of mget * subcommand processing. NOLISTSUBDIR specifies
that only the current directory should be retrieved from the server as a result of
processing a mget * subcommand. In this example, the current directory has a file
x and a subdirectory y and subdirectory y has a file x.
site nolistsubdir
>>> SITE nolistsubdir
mget * (rep
>>> PORT 127,0,0,1,4,13
>>> NLST *
125 List started OK
>>> PORT 127,0,0,1,4,14
>>> RETR x
125 Sending data set /tmp/mgetmput/x
Command:

Examples of PUT and MPUT subcommands
Results:
1. If the LISTSUBdir option is not specified on the LOCSITE subcommand and the
LISTSUBDIR statement is not specified in the client FTP.DATA file, the default
is as if the LISTSUBdir option was specified on the LOCSITE subcommand.
2. If the z/OS FTP client has the NOLISTSUBDIR option on the LOCSITE
subcommand or LISTSUBDIR FALSE in the client FTP.DATA file, an mput *
stores only the files that are in the current directory.
Restriction: The LISTSUBDIR statement applies to z/OS UNIX file operations only;
MVS data set operations are not affected.
Example 1: PUT and MPUT subcommands enable you to send files from a local
host to a remote host. In this example, FTP subcommands are issued from
MVSXA2 to MVSVIC03. The data set USER121.FTP.EXAMPLE on MVSXA2
contains the following members:
APPEND01
XA2FILE1
XA2FILE2
XA2FILE3
The data set USER121.FTP.EXAMPLE on MVSVIC03 contains the following

members:
XA3FILE1
XA3FILE2
XA3FILE3
The following is displayed when entering the FTP environment:

User: ftp 1.1.2.3
System: IBM FTP CS V1R5
FTP: using TCPCS
User: user121
System: >>>USER user121
Password:
>>>PASS ********
230 user121 is logged on. Working directory is "/u/user121"
Command:

User: put ’user121.ftp.example(xa2file1)’ ’user121.ftp.example(f1from2)’
System: >>>SITE FIXrecfm 128 Lrecl=128 Recfm=FB BlockSize=6144
>>>PORT 1,1,2,2,4,48
>>>STOR ’user121.ftp.example(f1from2)’
125 Storing data set USER121.FTP.EXAMPLE(F1FROM2)
390 bytes transferred in 1.117 seconds.
Transfer rate 0.35 Kbytes/sec.
Command:
>>>PORT 1,1,2,2,4,49
>>>STOR ’user121.ftp.example(f1from2)’
125 Storing data set USER121.FTP.EXAMPLE(F1FROM2)
Command:
User: sunique
System: Store unique is ON
Command:
>>>PORT 1,1,2,2,4,50
>>>STOU ’user121.ftp.example(f1from2)’
125 Storing data set USER121.FTP.EXAMPLE(F1FROM21) ( unique name )
Command:
User: sunique
System: Store unique is OFF
Command:
User: cd ’user121.ftp.example.’
System: >>>CWD ’user121.ftp.example.’
257 "’USER121.FTP.EXAMPLE.’" is working directory name prefix.
Command:
User: lpwd
System: Local directory is USER121.
Command:
User: lcd ’user121.ftp.example’
System: Local directory name set to PDS USER121.FTP.EXAMPLE.
Command:
User: lpwd
System: Local directory is partitioned data set USER121.FTP.EXAMPLE.
Command:

User: mput xa2file2 xa2file3
>>>PORT 1,1,2,2,4,51
>>>STOR XA2FILE2
125 Storing data set USER121.FTP.EXAMPLE.XA2FILE2
>>>SITE FIXrecfm 128 Lrecl=128 Recfm=FB BlockSize=6144
>>>PORT 1,1,2,2,4,52
>>>STOR XA2FILE3
125 Storing data set USER121.FTP.EXAMPLE.XA2FILE3
Command:
User: quit
System: >>>QUIT
READY
The data set USER121.FTP.EXAMPLE on MVSVIC03 now contains the following

members:
F1FROM2
F1FROM21
XA3FILE1
XA3FILE2
XA3FILE3
MVSVIC03 now also has the following data sets:
USER121.FTP.EXAMPLE.XA2FILE2
USER121.FTP.EXAMPLE.XA2FILE3
Restriction: The MPUT command is not applicable for generation data groups
(GDGs).
Example 2: MPUT with LOCSITE LISTSUBDIR
Following is an example of mput * with the LOCSITE LISTSUBDIR option. The

LISTSUBDIR option specifies that not only the current subdirectory, but also the
next subdirectory should be searched for files to be sent from the client to the
server. In this example, the current directory has a file x and a subdirectory y and
subdirectory y has a file x.

locsite listsubdir
prompt
Interactive mode is off
Command:
mput *
>>> PORT 127,0,0,1,4,11
>>> STOR x
125 Storing data set /u/user1/x
>>> PORT 127,0,0,1,4,12
>>> STOR x
Command:
Example 3: MPUT with LOCSITE NOLISTSUBDIR
Following is an example of mput * with the LOCSITE NOLISTSUBDIR option. The

NOLISTSUBDIR option specifies that only the current directory should be searched
for files to be sent from the client to the server. In this example, the current
directory has a file x and a subdirectory y and subdirectory y has a file x.
locsite NOlistsubdir
prompt
Command:
mput *
>>> PORT 127,0,0,1,4,11
>>> STOR x
Command:
ddname support
This section describes how the FTP client transfers a data set or file allocated in the
JCL for a batch job or by an interactive user prior to the transfer. The FTP client
refers to the data set with the ddname used on the allocation.
The FTP Client API does not support ddname transfers. The ddnames associated
with a batch job that invokes an application program using the FTP Client API are
not available to the spawned FTP client process.
The //DD: token prefixed before a 1–8 character local file name on a client file
access command indicates that the token which follows is actually a ddname,
rather than a local file name. This ddname must be allocated by the user (for
example, in the JCL that started the FTP client). The server file name must be
explicitly specified when a ddname is being used to access a local file for a put
command.
Sometimes the client requires DCB information before it opens a data set. Among
the situations where this is true are:
v Reading and writing spanned records (RECFM=VS or VBS)
v Reading and writing records that contain ASA control characters

v Reading and writing variable-length records while preserving the RDW
v Reading and writing fixed-length records while preserving trailing blanks
When a data set is allocated using a ddname and the DCB information is needed
before open, the FTP client must be able to find the DCB information on the DD
statement that was used to allocate the data set.
DCB attributes for a ddname allocation are acquired using the attributes or data set
name specified in the DD statement DCB parameter. See the z/OS MVS JCL
Reference for restrictions on using backward references in the DCB parameter.
If the DD statement refers to a cataloged DASD data set, any DCB attributes that
are not specified are retrieved from the DSCB. DCB attributes on the DD statement
that override those found in the DSCB, except that LRECL=0 and BLKSIZE=0 do
not override a different value in the DSCB.
If the DD statement refers to a tape data set that is to be opened for input (PUT
//DD:), the record format that is specified on the DD statement is used instead of
the READTAPEFormat setting. If no record format (RECFM) is specified on the DD
statement, the READTAPEFormat setting (if any) is used.
Once the data set is opened by FTP, its attributes are set using the data returned in
the DCB by open.
Following is a sample job that shows usage of the //DD: token. In the sample job
there are two data sets that use the local file specification with the //DD: token.
One is a data set that is created as a new GDG data set in STEP01 (see the
OUTSET DD statement). Note that STEP02 (the FTP step) uses a backward
reference with the DD02 DD statement to locate the data set. Since the referenced
DD statement contains explicit DCB attributes, FTP can access the attributes prior
to opening the data set. The second data set is an old data set that existed before
the job was executed.
//USER33J JOB MSGLEVEL=1,MSGCLASS=H,USER=USER33,PASSWORD=**pw**

//STEP01 EXEC PGM=IEBDG
//SYSPRINT DD SYSOUT=A
1 //OUTSET DD DSNAME=USER33.MYGDG(+1),DISP=(NEW,CATLG,CATLG),
// VOLUME=SER=CPDLB1,SPACE=(TRK,(5,5)),UNIT=SYSDA,
// DCB=(RECFM=FB,LRECL=80,BLKSIZE=800)
//SYSIN DD *
< create statements >
//STEP02 EXEC PGM=FTP,REGION=2048K,PARM=’(TCP TCPCS TRACE’
//STEPLIB DD DSN=USER33.LINKLIB,DISP=SHR
//SYSPRINT DD SYSOUT=*
2 //DD01 DD DSNAME=USER33.TEST.S.A,DISP=OLD
3 //DD02 DD DSNAME=*.STEP01.OUTSET,DISP=SHR
//OUTPUT DD SYSOUT=*
//INPUT DD *
9.67.113.57 6321
USER33 **pw**
4 put //DD:DD02 data
5 get data //DD:DD01
quit
/*
Following are short descriptions of the numbered items in the example.

1 DD statement that allocates a new generation of a GDG data set

2 DD statement for an existing data set
3 Backward reference for the new data set in STEP01
4 Put subcommand using the //DD: token for the new data set created in
STEP01
5 Get subcommand using the //DD: token for the existing data set
The FTP output for the above job is the following. Note that only a few selected
FTP trace statements are shown.
EZA1736I FTP (TCP TCPCS
EZA1450I IBM FTP CS V1R5 2003 090 19:22 UTC
EZA1466I FTP: using TCPCS
EZA1456I Connect to ?
EZA1736I 9.67.113.57 6321
EZA1554I Connecting to: 9.67.113.57 port: 6321.
220-FTPDJG1 IBM FTP CS V1R2 at MVS164, 14:58:36 on 2003-01-01.
EZA1459I NAME (9.67.113.57:USER33):
EZA1701I >>> USER USER33
EZA1701I >>> PASS
EZA1460I Command:
1 EZA1736I put //DD:DD02 data
2 MF0680 seq_open_file: DDname DD02 has filename USER33.MYGDG.G0087V00
EZA1701I >>> PORT 9,67,113,57,6,158
EZA1701I >>> STOR data
125 Storing data set /u/user33/data
EZA1617I 820 bytes transferred in 0.020 seconds. Transfer rate 41.00 Kbytes/sec.
EZA1460I Command:
3 EZA1736I get data //DD:DD01
4 MF0680 seq_open_file: DDname DD01 has filename USER33.TEST.S.A
EZA1701I >>> PORT 9,67,113,57,6,159
EZA1701I >>> RETR data
125 Sending data set /u/user33/data
EZA1617I 820 bytes transferred in 0.030 seconds. Transfer rate 27.33 Kbytes/sec.
EZA1460I Command:
EZA1736I quit
EZA1701I >>> QUIT
1 Put subcommand using //DD: token for the local file
2 Trace statement showing that the local data set name is the new GDG data
set that was created in STEP01
3 Get subcommand using //DD: token for the local file
4 Trace statement showing that the local data set name is the existing data
set.
Load module transfer (LMTR)

As long as your FTP client and FTP server are both at the z/OS Communications
Server V2R10 or later, you can use FTP to transfer MVS load modules between
load libraries on different hosts or the same host. MVS load modules transferred,
using z/OS Communications Server V2R10 or later support, are executable on the
target system. A load module can be specified by its real name or by one of its
alias names, and in either case, all aliases are transferred with each load module.

Load module transfer is also supported for proxy transfer, in which case all three
hosts (client, primary server, and secondary server) must be z/OS Communications
Server V2R10 or later.
Load module transfer processing (at z/OS V1R2 Communications Server or later)
makes use of the IEBCOPY system utility, which must be available on both the
origin and destination hosts.
The following FTP file transfer commands will properly transfer MVS load
modules:
v get
v mget
v put
v mput
Because of the special requirements of MVS load modules, there are some
additional restrictions:
v The current working directory on both the client and the server must be the
source or destination load library. A load library is a PDS or PDSE with
RECFM=U.
v Only member names can be specified. No fully qualified names can be specified.
v File rename is not supported on load module transfer.
v Load modules can be transferred only between the same types of libraries. For
example, PDS to PDSE transfer is not allowed.
v If load modules are being sent to or from the z/OS FTP client, the client must be
started from one of the following environments:
– TSO terminal session
– TSO REXX
– TSO batch
– TSO background
– Unix System services terminal session
v A load module loading from a temporary data set will always be a REPLACE
operation, overwriting existing members. LMTR is not performed in STOU mode
(the user has toggled SUNIQUE on).
v There is no prompting on mput and mget subcommands. All files that match the
mask provided are transferred.
In most cases where load module processing cannot be performed, including
failure to abide by the restrictions given above, FTP completes the file transfer
using normal processing. Any load modules transferred with normal processing
will not be executable on the target system.
For the examples shown below, the following assumptions are made:
v The contents of load library USER.LINKLIB are:
Name Prompt Alias-of Size TTR AC AM RM
EZACDOPN 0000D268 00160F 01 31 ANY
EZAFTPLC 000E3758 00001B 01 31 ANY
FTP EZAFTPLC 000E3758 00001B 01 31 ANY
OPING EZACDOPN 0000D268 00160F 01 31 ANY
v USER1.TESTLIB is a PDS with RECFM=U.

The following example is a sample session involving a load module transfer with
debug/trace on. (For clarity, user input is shown offset to the left and notes are
contained within // characters.)
NAME (9.67.43.61:USER1):
user1
>>> USER user1
PASSWORD:
>>> PASS
Command:
cd ’user.linklib’
>>> CWD ’user.linklib’
250-The working directory may be a load library
250-The working directory "USER.LINKLIB" is a partitioned data set //1//
Command:
lcd ’user1.testlib’
Local directory might be a load library //1//
Local directory name set to partitioned data set USER1.TESTLIB
Command:
get oping
>>> XLMT PDS 0 oping //2//
250 PDS 53864 - send next command for load module transfer //2//
>>> PORT 9,67,43,65,4,41
>>> RETR oping
125-Transferring load module //2//
125 DCB 32760 32760 //2//
IEBCOPY MESSAGES AND CONTROL STATEMENTS //3// PAGE 1
IEBCOPY FMID HDZ11D0 SERVICE LEVEL UW90570 DATED 19990520 DFSMS

1.5.0 MVS SP6.0.8 HBB6608 CPU 9672
USER1 OS390R5 OS390R5 16:20:59 TUE 16 NOV 1999 PARM=’’
STANDARD DD NAMES- SYSIN SYSPRINT SYSUT1 SYSUT2 SYSUT3
SYSUT4
OVERRIDING DD NAMES- SYS00158 SYS00159 SYS00157 SYS00156 SYSUT3
SYSUT4
VL GETMAIN REQUESTED 280K TO 1M BYTES. OBTAINED 1M.
COPY OUTDD=SYS00156,INDD=((SYS00157,R))
ORIGINAL PDS (BEFORE UNLOAD) WAS RECFM=U BLKSIZE=32760 LRECL=0
KEYLEN=0 OPTCD=X’20’ UCBTYPE=X’3010200F’ INDC=X’00’
ALLOCATED 2 CONTIGUOUS BUFFERS EACH 111K BYTES. WORK AREA HAS 757K
BYTES AVAILABLE.
COPYING FROM PDSU INDD=SYS00157 VOL=

DSN=SYS99320.T162100.RA000.USER1.TEMPXLMT.H01
TO PDS OUTDD=SYS00156 VOL=CPDLB1 DSN=USER1.TESTLIB
CONTROL TABLE IS 20 BYTES LONG. WORK AREA HAS 757K BYTES AVAILABLE.
ALLOCATED SECOND BUFFER OF 745K BYTES. FIRST BUFFER IS NOW 221K
BYTES. WORK AREA HAS 11974 BYTES AVAILABLE.
FOLLOWING MEMBER(S) LOADED FROM INPUT DATA SET REFERENCED BY SYS00157
EZACDPIN HAS BEEN SUCCESSFULLY LOADED //4//
OPING HAS BEEN SUCCESSFULLY LOADED //4//
2 OF 2 MEMBERS LOADED FROM INPUT DATA SET REFERENCED BY SYS00157
THERE ARE 135 UNUSED TRACKS IN OUTPUT DATA SET REFERENCED BY SYS00156
THERE ARE 23 UNUSED DIRECTORY BLOCKS IN OUTPUT DIRECTORY
RELEASED 1016K ADDITIONAL BYTES.
END OF JOB - 0 WAS HIGHEST SEVERITY CODE
Command:

In this next example, the user attempts to transfer a load module and rename the
load module. As this is not supported, load module processing will exit and
normal processing will take over. The transferred load module will not be
executable on the target system.
cd ’user.linklib’
>>> CWD ’user.linklib’
250-The working directory may be a load library
250-The working directory "USER.LINKLIB" is a partitioned data set
Command:
lcd ’user1.testlib’
Local directory might be a load library
Local directory name set to partitioned data set USER1.TESTLIB
Command:
get oping ping
Load module transfer does not support load module rename //5//
>>> PORT 9,67,43,66,4,41
>>> RETR oping
125 Sending data set USER.LINKLIB(OPING)
Command:
Notes:
1. When a cd or lcd subcommand is performed, the user will be notified if the
new current directory is eligible for load module transfer processing. If this
message or reply is not seen when changing to a directory, load module
transfer will not be attempted.
2. There are additional flows between the client and server for load module
transfer.
3. The IEBCOPY system utility is invoked by FTP as part of load module transfer
processing. Note that this output is seen only when running with debug or
trace on. Otherwise the IEBCOPY output is placed in the syslog.
4. The actual load module and all of its aliases are transferred, even though (in
this case only) the alias was specified by the user.
5. When load module transfer processing cannot be performed, the user is warned
and the transfer might be completed using normal processing. The data set
USER.TESTLIB(PING) is not executable on the client system.
Changing local site defaults using FTP.DATA

The default values for the local site parameters are hardcoded in the FTP client
module. You can change these default values by creating an FTP.DATA
configuration data set.
Note: Unless otherwise indicated, FTP.DATA data set refers to both the
/etc/ftp.data z/OS UNIX file and the MVS data set FTP.DATA.
| The FTP.DATA configuration data set is optional. If you specify the -f parameter on
| the FTP invocation, that parameter is used; otherwise, the FTP client uses one of
| the search orders shown in Table 14 on page 71 to obtain the local site parameter
| values.

Table 14. FTP client search orders
TSO shell z/OS UNIX shell
1. SYSFTPD DD statement 1. $HOME/ftp.data

2. tso_prefix.FTP.DATA 2. userid.FTP.DATA
3. userid.FTP.DATA 3. /etc/ftp.data
4. /etc/ftp.data 4. SYS1.TCPPARMS(FTPDATA) data set
5. SYS1.TCPPARMS(FTPDATA) data set 5. tcpip_hlq.FTP.DATA file
6. tcpip_hlq.FTP.DATA file
See the z/OS Communications Server: IP Programmer’s Guide and Reference for a
description of the FTP.DATA search order used when FTP is started from the FTP
Client API.
The z/OS Communications Server: IP Configuration Reference describes the statements

you can code in the FTP.DATA data set. It is not necessary to include all statements
in the FTP.DATA data set; only those statements whose default values are to be
changed must be included. The hard-coded default is used for any statement that
is not included in the FTP.DATA data set.
You can find a sample FTP.DATA file in the SEZAINST (FTCDATA) data set.
You can change several of the FTP local site parameters during the FTP session by
using the LOCSITE subcommand. See “LOCSIte subcommand—Specify site
information to the local host” on page 195 for more information about using the
LOCSITE subcommand to change the local site parameters.
Setting user-level options using FTPS.RC

The default values for the site parameters are coded in the server FTP.DATA file.
As a client user, you can change the site parameters by creating an FTPS.RC
configuration data set. This file can have CD and SITE subcommands.
The FTPS.RC configuration data set is optional. The FTP server uses the following
search order to find the data set:
1. tso_prefix.FTPS.RC
2. userid.FTPS.RC
3. $HOME/ftps.rc
The following are the syntax rules for the FTPS.RC file:
v Only SITE and CWD commands are allowed for this file. (CD is also accepted
and is treated as CWD.)
v Each command must be contained in a single line.
v The SITE command can have multiple parameters.
v Comments are allowed, but the entire line will be commented out. In other
words, comments cannot exist on the same line as the actual command line.
v Each comment must begin with a semicolon.
v Comments can be entered between two or more command lines.
Note: Test your configuration file to ensure that it is processed correctly by

naming the file (following the preceding naming convention) and putting
the file into the correct directory. A 230-type reply of Processing FTPS.RC

configuration file.. is displayed during your login process. The 230-type
reply indicates any errors encountered or whether the file was successfully
opened and processed. Contact the system programmer if you cannot fix
any errors reported or if the file cannot be opened or created. See z/OS
Communications Server: IP and SNA Codes for additional information about
230-type replies.
The following are examples of an FTPS.RC file with no errors and with errors.
v No errors (correctly coded).
; This is a sample configuration file for FTPS.RC
; You may enter comments by starting a line with semicolon (;). The
; entire line will be ignored.
; The server FTP.DATA file must have the statement DEBUGONSITE TRUE
; for the SITE DEBUG= subcommand to be accepted by the server.
SITE debug=all
; You may also insert comments between command lines.
; You may code either ’CD’ or ’CWD’.
CWD /user2
CD tmp
v Errors within the file.
; This is a sample configuration file for FTPS.RC
; You may enter comments by starting a line with semicolon (;). The
; entire line will be ignored.
; The line below has an error: errormount is an unrecognized parameter.
SITE errormount
; PUT subcommand is not accepted in this file.
PUT ’user2.tmp.banner’ ’user3.tmp.banner’
Configuring the FTP client for SOCKS server

The FTP client uses a SOCKS configuration data set or file to determine whether to
access a given FTP server directly or through a SOCKS server. The name of the
data set or file is specified by coding the SOCKSCONFIGFILE statement in the
client FTP.DATA file.
The FTP client references the SOCKSCONFIGFILE only when the FTP server is
known to it by an IPv4 IP address or by a DNS name that resolves to an IPv4 IP
address. The FTP client always connects directly to FTP servers known to it by
IPv6 addresses or by DNS names that resolve to IPv6 addresses.
See the z/OS Communications Server: IP Configuration Reference for details regarding
the contents of the SOCKS configuration file.
Sample FTP.DATA data set (FTCDATA)

The following is a sample of the contents of the FTP.DATA data set in the
FTCDATA member of the SEZAINST data set.

;***********************************************************************
; *
; Name of File: SEZAINST(FTCDATA) *
; *
; Descriptive Name: FTP.DATA (for FTP Client) *
; *
; SMP/E Distribution Name: EZAFTPAC *
; *
; Copyright: Licensed Materials - Property of IBM *
; *
; "Restricted Materials of IBM" *
; *
; 5694-A01 *
; *
; (C) Copyright IBM Corp. 1977, 2007 *
; *
; US Government Users Restricted Rights - *
; Use, duplication or disclosure restricted by *
; GSA ADP Schedule Contract with IBM Corp. *
; *
| ; Status: CSV1R9 *
; *
; *
; This FTP.DATA file is used to specify default file and disk *
; parameters used by the FTP client. *
; *
; Note: For an example of an FTP.DATA file for the FTP server, *
; see the FTPSDATA example. *
; *
; Syntax Rules for the FTP.DATA Configuration File: *
; *
; (a) All characters to the right of and including a ; will be *
; treated as a comment. *
; *
; (b) Blanks and <end-of-line> are used to delimit tokens. *
; *
; (c) The format for each statement is: *
; *
; parameter value *
; *
; *
; The FTP.DATA options are grouped into the following groups in *
; this sample FTP client FTP.DATA configuration data set: *
; *
; 1. Basic configuration options *
; 2. HFS file options *
; 3. Default attributes for MVS data set creation *
; 4. MVS data set transfer options *
; 5. Code page conversion options *
Figure 3. FTP.DATA for FTP client (Part 1 of 14)

; 6. DB2 (SQL) interface options *
; 7. Security options *
; 8. Timers *
; 9. Return codes *
; 10. Checkpoint / Restart options *
; 11. Socks server access *
; 12. Debug (trace) options *
; 13. Additional advanced options *
; *
; For options that have a pre-selected set of values, a (D) indicates*
; the default value for the option. *
; *
; Options that can be changed via LOCSITE subcommands are identified *
; with an (S). *
; *
;***********************************************************************
; ---------------------------------------------------------------------
;
; 1. Basic FTP client configuration options
;
; ---------------------------------------------------------------------
;SUPPRESSIGNOREWARNINGS FALSE ; Suppress message EZYFT47I
; while processing remaining
; statements in this FTP.DATA
; TRUE - Yes
; FALSE (D) - No. EZYFT47I is
; issued to warn of ignored
; statements
FILETYPE SEQ ; (S) Client mode of operation
; SEQ = transfer data sets or
; files (D)
; SQL = submit queries to DB2
| ;SEQNUMSUPPORT FALSE ; Support sequence numbers when input
| ; read from //INPUT DD file
| ; FALSE = (D) Do not support
| ; sequence numbers.
| ; EZYFS33I issued if
| ; sequence numbers detected
| ; TRUE = Support sequence numbers
; ---------------------------------------------------------------------
;
; 2. HFS file options
;
; ---------------------------------------------------------------------
UMASK 027 ; (S) Octal UMASK to restrict setting
; of permission bits when creating
; new HFS files
; Default value is 027.
LISTSUBDIR TRUE ; Should wildcard searches span
; subdirectories?
; TRUE (D) - Yes
; FALSE - No
; ---------------------------------------------------------------------

;
; 3. Default MVS data set creation attributes
;
; ---------------------------------------------------------------------
BLKSIZE 6233 ; (S) New data set allocation block size
; Default is 6233
; Valid range is 0 to 32760
;DATACLASS SMSDATA ; (S) SMS data class name
; There is no default
;MGMTCLASS SMSMGNT ; (S) SMS mgmtclass name
;STORCLASS SMSSTOR ; (S) SMS storclass name
;DCBDSN MODEL.DCB ; (S) New data set allocation
; model DCB name - must be a
; fully qualified data set name
DIRECTORY 27 ; (S) Number of directory blocks in
; new PDS/PDSE data sets.
; Range is from 1 to 16777215.
LRECL 256 ; (S) New data set allocation LRECL.
; Valid range 0 through 32760.
PDSTYPE ; (S) no value - allocate MVS
; directories according to the
; system default (PDS or PDSE)
; PDS - allocate MVS
; directories as a PDS
; PDSE - allocate MVS directories
; as a PDSE
PRIMARY 1 ; (S) New data set allocation
; primary space units according
; to the value of SPACETYPE.
RECFM VB ; (S) New data set allocation
; record format.
; Default value is VB.
; Value may be specified as certain
; combinations of:
; A - ASA print control
; B - Blocked
; F - Fixed length records
; M - Machine print control
; S - Spanned (V) or Standard (F)
; U - Undefined record length
; V - Variable length records
RETPD ; (S) New data set retention
; period in days.
; Blank = no retention period (D)
; 0 = expire today
; NB: Note the difference between
; a blank value and a value

; of zero.
SECONDARY 1 ; (S) New data set allocation
; secondary space units according
; to the value of SPACETYPE.
SPACETYPE TRACK ; (S) New data set allocation
; space type.
; TRACK (D)
; BLOCK
; CYLINDER
UCOUNT ; (S) Sets the unit count for an
; allocation.
; If this option is not specified
; or is specified with a value of
; blank, the unit count attribute
; is not used on an allocation (D)
; Valid range is 1 through 59 or
; the character P for parallel
; mount requests
;UNITNAME SYSDA ; (S) New data set allocation unit
; name.
; There is no default.
VCOUNT 59 ; (S) Volume count for an
; allocation.
; Valid range is 1 through 255.
;VOLUME WRKLB1,WRKLB2 ; (S) Volume serial number(s) to
; use for allocating a data set.
; Specify either a single VOLSER
; or a list of VOLSERs
; separated with commas
; ---------------------------------------------------------------------
;
; 4. MVS data set transfer options
;
; ---------------------------------------------------------------------
ASATRANS FALSE ; (S) Conversion of ASA print
; control characters
; TRUE = Use C conversion
; FALSE = Do not convert (D)
AUTOMOUNT TRUE ; (S) Automatic mount of unmounted
; DASD volumes
; TRUE = Mount volumes (D)
; FALSE = Do not mount volumes
AUTORECALL TRUE ; (S) Automatic recall of
; migrated data sets
; TRUE = Recall them (D)
; FALSE = Do not recall them
AUTOTAPEMOUNT FALSE ; Automatic mount of unmounted
; tape volumes
; TRUE = Mount volumes
; FALSE = Do not mount volumes (D)
BUFNO 5 ; (S) Specify number of access
; method buffers

; Valid range is from 1 through
; 35 - default value is 5
CONDDISP CATLG ; (S) Disposition of a new data set
; when transfer ends prematurely
; CATLG = Keep and catalog (D)
; DELETE = Delete data set
; Note this option applies to HFS
; files also
DIRECTORYMODE FALSE ; (S) Specifies how to view the MVS
; data set structure:
; FALSE = (D) All qualifiers below
; LCWD are treated as
; entries in the directory
; TRUE = Qualifiers immediately
; below the LCWD are
; treated as entries in the
; directory
ISPFSTATS FALSE ; (S) TRUE = create/update PDS
; statistics
; FALSE = (D) does not create /
; update PDS statistics
MIGRATEVOL MIGRAT ; (S) Migration volume VOLSER to
; identify migrated data sets
; under control of non-HSM
; storage management products.
; Default value is MIGRAT.
QUOTESOVERRIDE TRUE ; (S) How to treat quotes at the
; beginning or surrounding file
; names.
; TRUE = Override current working
; directory (D)
; FALSE = Treat quotes as part of
; file name
RDW FALSE ; (S) Specify whether Record
; Descriptor Words (RDWs) are
; discarded or retained.
; TRUE = Retain RDWs and transfer
; as part of data
; FALSE = Discard RDWs when
; transferring data (D)
TRAILINGBLANKS FALSE ; (S) How to handle trailing blanks
; in fixed format data sets during
; text transfers.
; TRUE = Retain trailing blanks
; (include in transfer)
; FALSE = Strip off trailing
; blanks (D)
TRUNCATE FALSE ; (S) Used in conjuction with
; WRAPRECORD to specify what to do
; if no new-line is encountered
; before reaching the MVS data set
; record length limit as defined
; by LRECL when transferring data
; to MVS. This parameter only has
; meaning if WRAPRECORD is false.

; TRUE (D) = allow truncation and
; continue with the file transfer
; FALSE = fail the file
; transfer instead of truncating
WRAPRECORD FALSE ; (S) Specify what to do if no new-line
; is encountered before reaching
; the MVS data set record length
; limit as defined by LRECL when
; transferring data to MVS.
; TRUE = Wrap data to new record
; FALSE = Truncate data (D)
WRTAPEFASTIO FALSE ; (S) How should the server write
; ASCII stream mode to tapes?
; TRUE = Use BSAM I/O routines
; FALSE (D) = Use LE Run Time
; library fwrite
; ---------------------------------------------------------------------
;
; 5. Text code page conversion options
;
; ---------------------------------------------------------------------
;CCTRANS dsn_qual ; Control connection translate
; table data set qualifier.
; Used to search for
; a) userid.dsn_qual.TCPXLBIN
; b) hlq.dsn_qual.TCPXLBIN
; If CTRLCONN is specified, that
; value overrides CCTRANS.
;CTRLCONN 7BIT ; (S) ASCII code page for
; control connection.
; 7BIT is the default if CTRLCONN
; is not specified AND no TCPXLBIN
; translation table data set found.
; Can be specified as any iconv
; supported ASCII code page, such
; as IBM-850
;DBSUB FALSE ; (S) Specifies whether untranslatable
; data bytes should be replaced
; with substitution character in
; iconv() during data transfer.
; TRUE = Replace each
; untranslatable byte
; FALSE = Terminate transfer (D)
; when untranslatable bytes are
; detected
;ENCODING SBCS ; (S) Specifies whether multi-byte or
; single-byte data conversion is
; to be performed on ASCII data
; transfers.
; MBCS = Use multi-byte
; SBCS = Use single-byte (D)
;
;EXTENSIONS UTF8 ; Enable RFC 2640 support.
; Default is disabled.
; Control connection starts as

; 7bit ASCII and switches to UTF-8
; encoding when LANG command
; processed successfully. CCTRANS
; and CTRLCONN are ignored.
;MBDATACONN (IBM-1388,IBM-5488) ; (S) Specifies the conversion table
; names for the data connection
; when ENCODING has a value of
; MBCS. The names are the file
; system code page name and the
; network transfer code page name.
;MBSENDEOL CRLF ; (S) When translating multi-byte data
; to ASCII :
; CRLF = (D) Append a carriage
; return (x’0D’) and line
; feed (x’0A’) to each line
; of text. This is the
; default and the standard
; line terminator defined by
; RFC 959. The z/OS server
; and client can receive
; ASCII data only in this
; format.
; CR = Append a carriage return
; (x’0D’) only to each line
; of text.
; LF = Append a line feed (x’0A’)
; only to each line of text.
; NONE = Do not append a line
; terminator to any line of
; text.
;MBREQUIRELASTEOL TRUE ; (S) Specifies whether the last
; record of an incoming multibyte
; transfer is required to have
; an EOL sequence.
; TRUE A missing EOL on the last
; record received is treated as an
; error (D)
; FALSE A missing EOL on the last
; record received is ignored
;SBDATACONN (IBM-1047,IBM-850) ; (S) file system/network transfer
; code pages for data connection.
; Either a fully-qualified MVS
; data set name or HFS file name
; built with the CONVXLAT utility -
; HLQ.MY.TRANS.DATASET
; /u/user1/my.trans.file
; Or a file system code page name
; followed by a network transfer
; code page name according to
; iconv supported code pages -
; for example
; (IBM-1047,IBM-850)
; If SBDATACONN is not present,
; std. search order for a default
; translation table data set will

; be used.
;SBSENDEOL CRLF ; (S) When translating single-byte
; data to ASCII :
; CRLF = (D) Append a carriage
; return (x’0D’) and line
; feed (x’0A’) to each line
; of text. This is the
; default and the standard
; line terminator defined by
; RFC 959. The z/OS server
; and client can receive
; ASCII data only in this
; format.
; CR = Append a carriage return
; (x’0D’) only to each line
; of text.
; LF = Append a line feed (x’0A’)
; only to each line of text.
; NONE = Do not append a line
; terminator to any line of
; text.
;SBSUB FALSE ; (S) Specifies whether untranslatable
; data bytes should be replaced
; with SBSUBCHAR when detected
; during SBCS data transfer.
; TRUE = Replace each
; untranslatable byte with
; SBSUBCHAR.
; when untranslatable bytes are
; detected
;SBSUBCHAR SPACE ; (S) Specifies the substitution char
; for SBCS data transfer when
; SBSUB is TRUE.
; nn = hexadecimal value from
; 0x’00’ to 0x’FF’.
; SPACE = x’40’ when target code
; set is EBCDIC, and
; x’20’ when target code
; set is ASCII. (D)
;SBTRANS dsn_qual ; Data connection translate
; table data set qualifier.
; Used to search for
; a) userid.dsn_qual.TCPXLBIN
; b) hlq.dsn_qual.TCPXLBIN
; If SBDATACONN is specified, that
; value overrides SBTRANS
;UCSHOSTCS code_set ; (S) Specify the EBCDIC code set
; to be used for data conversion
| ; to or from UCS-2.
; If UCSHOSTCS is not specified,
; the current EBCDIC code page
; for the data connection is used.

| UCSSUB FALSE ; (S) Specify whether UCS-2 to EBCDIC
; conversion should use the EBCDIC
; substitution character or
; cause the data transfer to be
| ; terminated if a UCS-2 character
| ; cannot be converted to a
| ; character in the target EBCDIC
| ; code set
; TRUE = Use substitution char
UCSTRUNC FALSE ; (S) Specify whether the transfer
| ; of UCS-2 data should be
; aborted if truncation
; occurs at the MVS host
; TRUE = Truncation allowed
;UNICODEFILESYSTEMBOM ASIS ; (S) When storing UNICODE files,
; specifies whether to store a
; Byte Order Mark (BOM) as the
; first character of the file.
; ASIS = (D) Store a BOM if one
; was transmitted with the file
; as the first character.
; ALWAYS = Always store a BOM as
; the first character of the file
; NEVER = Never store a BOM as
; the first character of the file
; regardless of whether a BOM was
; was sent. Although a BOM can
; appear anywhere within the
; file, only a BOM sent as the
; first file character is
; affected by this setting.
; ---------------------------------------------------------------------
;
; 6. DB2 (SQL) interface options
;
; ---------------------------------------------------------------------
DB2 DB2 ; (S) DB2 subsystem name
; The default name is DB2
DB2PLAN EZAFTPMQ ; DB2 plan name for FTP client
; The default name is EZAFTPMQ
SPREAD FALSE ; (S) SQL spreadsheet output format
; TRUE = Spreadsheet format
; FALSE = Not spreadsheet
; format (D)
SQLCOL NAMES ; (S) SQL output headings
; NAMES = Use column names (D)
; LABELS = Use column labels

; ANY = Use label if defined,
; else use name
; ---------------------------------------------------------------------
;
; 7. Security options
;
; ---------------------------------------------------------------------
;SECURE_MECHANISM GSSAPI ; Name of the security mechanism
; that the client uses when it
; sends an AUTH command to the
; server.
; GSSAPI = Kerberos support
; TLS = TLS
;SECURE_FTP ALLOWED ; Authentication indicator
; ALLOWED (D)
; REQUIRED
;SECURE_CTRLCONN CLEAR ; Minimum level of security for
; the control connection
; CLEAR (D)
; SAFE
; PRIVATE
;SECURE_DATACONN CLEAR ; Minimum level of security for
; the data connection
; NEVER
; CLEAR (D)
; SAFE
; PRIVATE
;SECURE_HOSTNAME OPTIONAL ; Authentication of hostname in
; the server certificate
; OPTIONAL (D)
; REQUIRED
;SECURE_PBSZ 16384 ; Kerberos maximum size of the
; encoded data blocks
; Default value is 16384
; Valid range is 512 through 32768
; Name of a ciphersuite that can be passed to the partner during
; the TLS handshake. None, some, or all of the following may be
; specified. The number to the far right is the cipherspec id
; that corresponds to the ciphersuite’s name.
;CIPHERSUITE SSL_NULL_MD5 ; 01
;CIPHERSUITE SSL_NULL_SHA ; 02
;CIPHERSUITE SSL_RC4_MD5_EX ; 03
;CIPHERSUITE SSL_RC4_MD5 ; 04
;CIPHERSUITE SSL_RC4_SHA ; 05
;CIPHERSUITE SSL_RC2_MD5_EX ; 06
;CIPHERSUITE SSL_DES_SHA ; 09
;CIPHERSUITE SSL_3DES_SHA ; 0A
;CIPHERSUITE SSL_AES_128_SHA ; 2F
;CIPHERSUITE SSL_AES_256_SHA ; 35
;KEYRING name ; Name of the keyring for TLS
; It can be the name of an HFS
; file (name starts with /) or
; a resource name in the security
; product (e.g., RACF)
;TLSTIMEOUT 100 ; Maximum time limit between full

; TLS handshakes to protect data
; connections
; Default value is 100 seconds.
; Valid range is 0 through 86400
;SECUREIMPLICITZOS TRUE ; Specify whether client will
; connect to a z/OS FTP server
| ; when using the TLS port.
; TRUE (D)
; FALSE Use FALSE if server is
; not z/OS or the port is not the
; TLS port (990).
| ;TLSRFCLEVEL DRAFT ; (S) Specify what level of RFC 4217,
| ; On Securing ; FTP with TLS, is
| ; supported
| ; DRAFT (D) Internet Draft level
| ; RFC4217 RFC level
; ---------------------------------------------------------------------
;
; 8. Timers
;
; ---------------------------------------------------------------------
CCONNTIME 30 ; Timeout value for successful
; close of control connection.
; 0 = do not timeout
DATACTTIME 120 ; Timeout for send/receive data
; operations.
DCONNTIME 120 ; Timeout value for successful
; close of data connection.
FTPKEEPALIVE 0 ; Keepalive packets are sent after
; the connection is idle for the
; specified number of seconds
; Default is 0 seconds
; 0 = do not send keepalive packets
; Valid range is 60 - 86400
INACTTIME 120 ; The time in seconds to wait for
; an expected response from the
; server.
MYOPENTIME 60 ; Connection timeout value in
; seconds.

PROGRESS 10 ; Time interval in seconds between
; progress updates for file
; transfers. Default is 10 seconds
; Valid range is 10 through 86400,
; or 0 to request no updates.
; ---------------------------------------------------------------------
;
; 9. Return codes
;
; ---------------------------------------------------------------------
;CLIENTERRCODES FALSE ; Return code format
; TRUE - 2 digit error return code
; FALSE (D) - 5 digit XXYYY format
; XX - FTP subcommand
; YYY - server reply code
; EXTENDED - 4 digit XXYY format
; XX - 2 digit error return code
; YY - FTP subcommand
;LOGCLIENTERR FALSE ; Report errors with EZZ9830I msg?
; TRUE - Yes
; FALSE (D) - No
; ---------------------------------------------------------------------
;
; 10. Checkpoint / Restart options
;
; ---------------------------------------------------------------------
CHKPTINT 0 ; (S) Specify the checkpoint interval
; in number of records.
; NB: checkpointing only works
; with datatype EBCDIC and block
; or compressed transfer mode.
; 0 = no checkpoints (D)
RESTGET TRUE ; (S) Should checkpointing occur during
; a GET operation?
; TRUE (D) - Yes
; FALSE - No
CHKPTPREFIX HOME ; (S) Low level qualifier of checkpoint
; data set: FTP.CHECKPOINT
; HOME (D) - either TSO prefix or
; UNIX local directory path
; USERID - login user ID
; LOCAL - current local directory
; ---------------------------------------------------------------------
;
; 11. SOCKS server options
;
; ---------------------------------------------------------------------
;SOCKSCONFIGFILE /etc/socks.conf ; file path for SOCKS configuration
; file. The SOCKS configuration
; file specifies which FTP servers
; should be accessed via SOCKS.
; ---------------------------------------------------------------------
;

; 12. Debug (trace) options
;
; ---------------------------------------------------------------------
;DEBUG TIME ; time stamp client trace entries
;DEBUG ALL ; activate all traces
;DEBUG BAS ; active basic traces
; (marked with an *)
;DEBUG FLO ; function flow
;DEBUG CMD ; * command trace
;DEBUG PAR ; parser details
;DEBUG INT ; * program initialization and
; termination
;DEBUG ACC ; access control (logging in)
;DEBUG SEC ; security processing
;DEBUG UTL ; utility functions
;DEBUG FSC(1) ; * file services
;DEBUG SOC(1) ; * socket services
;DEBUG SQL ; special SQL processing
; ---------------------------------------------------------------------
;
; 13. Additional advanced options
;
; ---------------------------------------------------------------------
CHKCONFIDENCE FALSE ; (S) FALSE = (D) Do not perform
; confidence checks of
; data transfers.
; TRUE = Check and report on
; the confidence in the
; successful completion of
; a data transfer. The FTP
; client reports the level
; of confidence after each
; file transfer with the
; message EZA2108I.
;FWFRIENDLY FALSE ; (S) Use firewall friendly protocol
; for starting data connections?
; TRUE - Yes
; FALSE (D) - NO
;EPSV4 FALSE ; (S) Use NAT firewall friendly protoco
; for starting data connections?
; TRUE - Yes
; FALSE (D) - NO
;NETRCLEVEL 1 ; When logging in, should the FTP
; server’s IP addr be converted to
; a host name to use NETRC login
; file?
; 1 (D) - IP addr is not converted
; 2 - IP addr is converted
; 2 - IP addr is converted
;TRACECAPI CONDITIONAL ; When the FTP client is invoked
; from the FTP Callable API, write
; records to the API trace spool
; data set based on this setting
; CONDITIONAL (D)
; Trace requests for which the

; application has set the
; FCAI_TraceIt field to
; FCAI_TraceIt_Yes (1)
; ALL
; Trace all requests, regardless
; of the value in FCAI_TraceIt
; NONE
; Trace no requests, regardless
; of the value in FCAI_TraceIt
FTP data conversion

By default, the z/OS FTP client transmits all data on the control connection and on
the data connection as single byte ASCII, the same ASCII code page being used to
encode both connections. z/OS FTP provides the ability to specify different code
pages for the control and data connections. The code page you specify can be
single byte (SBCS), double byte (DBCS), or multibyte (MBCS).
Support for SBCS languages

SBCS (single byte character set) encoding is the default encoding for both control
and data connections, and is the encoding specified in FTP RFCs such as RFC 959.
You can specify SBCS encoding on either the control or data connection.
Some methods of specifying alternate translation tables for the FTP client apply to
both the control and data connection. If the translation table you need for data
transfer does not support the standard encodings for the portable character set,
you should establish different translation tables for the control and data
connections to ensure that FTP commands and replies are translated correctly.
Specify SBCS encoding for the data connection with one of the following methods:
v Code statements in FTP.DATA: SBDATACONN and SBTRANS.
v Use LOCSITE SBDataconn or LOCSITE XLATE subcommands to set the code
page.
v Place an MVS data set containing a binary translate table in the FTP client’s
search order for TCPXLBIN data sets. Use the CONVXLAT utility to generate an
MVS data set containing the binary translation table you require. See SBCS
translation table hierarchy in the z/OS Communications Server: IP Configuration
Reference for the search order used by the FTP client.
v Specify the TRANSLATE parameter as an FTP client start option. The translate
parameter applies to both the control and data connections.
If you need to establish different translate tables for the control and data
connection, use one of the other methods to establish the translate table, or else
change either translate table after starting the client.
If the table you specified with the TRANSLATE parameter does not support the
POSIX portable character set, start the client without specifying a host name so
the client does not attempt to send commands on the control connection before
the correct translation table is established. Then change the client’s translation
table after starting FTP.
You can specify different conversions for the control connection by using any of
the following methods:
v Code CTRLConn statements in the FTP.DATA file.

v Place an MVS data set containing a binary translate table in the FTP client’s
search order for TCPXLBIN data sets. Use the CONVXLAT utility to generate an
MVS data set that contains the binary translation table you require. See SBCS
translation table hierarchy in the z/OS Communications Server: IP Configuration
Reference for the search order used by the FTP client.
v Use the LOCSITE CTRLCONN subcommand.
v Specify the TRANSLATE parameter as an FTP client start option. If you use this
method, the table applies to both control and data connections.
If you code EXTENSIONS UTF8 in the client FTP.DATA file, the control connection
uses 7-bit ASCII for commands and, when negotiated with the server, UTF-8
encoding of path names. The client can override the EXTENSIONS UTF8 statement
by using the FTP TRANSLATE start parameter or by issuing SITE and LOCSITE
subcommands. However, the client cannot resume UTF-8 encoding on the control
connection until you restart the client.
Extended trace point ID 81 is available for tracing the translate tables. When set to
ON, 256 bytes of each translate table can be traced as follows:
v When the FTP STAT command is sent to the server, the translate tables being
used by the server for the control and data connection are traced. When the FTP
LOCSTAT subcommand is entered, the translate tables being used by the client
are traced.
v When the LOCSITE subcommand is entered to change the client translate table,
the client traces the new table. When the server receives a SITE command to
change the translate table, the server traces the new table.
See the “SITE subcommand - DUMP parameter” on page 281 for instructions for
activating extended trace point 81 for the server. See the “DUMP
subcommand—Set extended trace options” on page 173 for instructions for
activating extended trace point 81 for the client.
FTP with traditional DBCS support

This section describes how to use FTP to exchange DBCS data sets between hosts
supporting DBCS file transfer.
The z/OS FTP server and client programs access data sets containing data that is
usually in EBCDIC format. To transfer these data sets to or from an ASCII-based
host requires translation tables. The transfer of DBCS data uses two tables—one for
DBCS characters and one for SBCS characters.
Selecting a DBCS translation table

The LOADDBCSTABLES statement in TCPIP.DATA is used by both the FTP server
and client to determine which DBCS translation table data sets can be loaded. See
Using translation tables in the z/OS Communications Server: IP Configuration
Reference for more information about the loading and customizing of DBCS
translation tables for FTP.
The FTP server and client can be configured to load a number of DBCS translation
tables. These are used during data set transfers to convert MVS host DBCS
characters and non-MVS DBCS characters. The FTP command TYPE B n or the
corresponding client subcommand is used to enter DBCS transfer mode and select
a DBCS table.

Selecting an SBCS translation table
The SBCS table used to transfer DBCS data is the SBCS table that is established for
the data connection.
SBCS tables are used by the control connection to transfer commands; they are also
used by the data connection. Often the same SBCS table is used, but you might
want to select a different table to be used for data transfers. How you specify the
SBCS table for the data connection depends on whether the translation is to be
done by the FTP server or the FTP client.
When the EBCDIC-to-ASCII translation is done by the FTP server, you can issue a
SITE SBDataconn command to select the SBCS table to be used by the server for
data transfers.
When the EBCDIC-to-ASCII translation is done by the FTP client, you can use the
following parameters in your local FTP.DATA file to establish the SBCS tables:
CTRLConn Establishes the SBCS tables the client uses for control connections.
SBDataconn Establishes the SBCS tables the client uses for data connections.
Alternatively, you can use the TRANSLATE option of the FTP command to change
the SBCS and DBCS translation table hierarchy for both the control and data
connection. The TRANSLATE option results in the same SBCS table for both the
control and the data connection.
Note: The TRANSLATE option can be used as long as the table maintains the
integrity of the portable character set.
Another alternative when the FTP client is to perform the translation is to use the
LOCSITE SBDataconn subcommand to change the SBCS table used by the client
for the data connection.
DBCS subcommands
DBCS data sets are transferred using the standard FTP subcommands PUT and
GET. However, before the transfer commences, the current transfer type for the
session must be set to the required DBCS type. To set the transfer type to DBCS for
an FTP session, you must issue the appropriate FTP subcommand to the client or
the server, depending on where the DBCS conversion is to be done. The FTP
subcommands for DBCS support are listed in Table 15.
Table 15. FTP subcommands for DBCS support
BIG5 Sets the transfer type “BIG5 subcommand—Change the data transfer
to BIG-5 type to BIG5” on page 148
EUckanji Sets the transfer type “EUckanji subcommand—Change the data
to EUCKANJI transfer type to EUCKANJI” on page 176
HAngeul Sets the transfer type “HAngeul subcommand—Change the data
to HANGEUL transfer type to HANGEUL” on page 184
Ibmkanji Sets the transfer type “Ibmkanji subcommand—Change the data transfer
to IBMKANJI type to IBMKANJI” on page 187
JIS78kj Sets the transfer type “JIS78kj subcommand—Change the data transfer
to JIS78KJ type to JIS78KJ” on page 188
JIS83kj Sets the transfer type “JIS83kj subcommand—Change the data transfer
to JIS83KJ type to JIS83KJ” on page 189

Table 15. FTP subcommands for DBCS support (continued)
Ksc5601 Sets the transfer type “Ksc5601 subcommand—Change the data transfer
to KSC5601 type to KSC-5601” on page 190
QUOte Sends an “QUOte subcommand—Send an uninterpreted
uninterpreted string string of data” on page 259
of data
SChinese Sets the transfer type “SChinese subcommand—Change the data
to SCHINESE transfer type to SCHINESE” on page 266
SJiskanji Sets the transfer type “SJiskanji subcommand—Change the data transfer
to SJISKANJI type to SJISKANJI” on page 297
TChinese Sets the transfer type “TChinese subcommand—Change the data
to TCHINESE transfer type to TCHINESE” on page 312
TYpe Specifies the transfer “TYpe subcommand—Set the data transfer type”
type on page 315
Server commands and client subcommands

Table 16 shows examples of the server command that would be generated for each
client subcommand:
Table 16. FTP TYPE subcommand aliases
Client subcommand Server command Description
BIG5 TYPE B 8 Big-5 transfer type
EUCKANJI TYPE B 2 Extended UNIX Code kanji transfer
type
HANGEUL TYPE B 5 Hangeul transfer type
IBMKANJI TYPE F 1 IBM (EBCDIC) kanji transfer type
JIS78KJ TYPE B 4 A JIS 1978 kanji using ASCII shift-in
transfer type
JIS78KJ (ASCII TYPE B 4 A ASCII shift-in escape sequence
JIS78KJ (JISROMAN TYPE B 4 R JISROMAN shift-in escape
sequence
JIS78KJ (JISROMAN NOSO TYPE B 4 R N Pure DBCS data transfer
JIS83KJ TYPE B 3 A JIS 1983 kanji using ASCII shift-in
transfer type
JIS83KJ (ASCII TYPE B 3 A ASCII shift-in escape sequence
JIS83KJ (JISROMAN TYPE B 3 R JISROMAN shift-in escape
sequence
JIS83KJ (JISROMAN NOSO TYPE B 3 R N Pure DBCS data transfer
KSC5601 TYPE B 6 Korean Standard Code KSC-5601
transfer type
SCHINESE TYPE B 9 Simplified Chinese transfer type
SJISKANJI TYPE B 1 Shift JIS kanji transfer type
SJISKANJI (Sosi TYPE B 1 S A Shift-out/shift-in characters
X'1E'/X'1F'
SJISKANJI (Sosi ASCII TYPE B 1 S A Shift-out/shift-in characters
X'1E'/X'1F'

Table 16. FTP TYPE subcommand aliases (continued)
Client subcommand Server command Description
SJISKANJI (Sosi EBCDIC TYPE B 1 S E Shift-out/shift-in characters
X’0E’/X’0F’
SJISKANJI (Sosi SPACE TYPE B 1 S S Shift-out/shift-in characters
X’20’/X’20’
SJISKANJI (NOSO TYPE B 1 N Pure DBCS data transfer
TCHINESE TYPE B 7 Traditional Chinese (5550) transfer
type
Mapping DBCS aliases to CCSIDs

The code sets supported by the DBCS for FTP options conform to standard coded
character set identifiers (CCSIDs). Table 17 shows how CCSIDs map to DBCS
keywords.
For more information about CCSIDs, see Character Data Representation Architecture
Reference and Registry, GC09-2207.
Table 17. Mapping of DBCS keywords to CCSIDs
DBCS keyword CCSID Description
BIG5 00947 IBM Big-5 DBCS
EUCKANJI 00954 Japanese EUC (G0, G1 and G2 only)
HANGEUL 00926 Korean DBCS-PC
JIS78KJ 00955 JIS X0208–1978
JIS83KJ 05048 JIS X0208–1990
KSC5601 00951 IBM Korean Standard code
SCHINESE 01380 Simplified Chinese DBCS-PC
SJISKANJI 00301 Japanese DBCS-PC
TCHINESE 00927 Traditional Chinese DBCS-PC
Support for MBCS languages

MBCS translation can be performed on the data connection.
The FTP client and server provide double-byte language support using a set of
subcommands at the client and corresponding TYPE B commands at the server.
This support is described in “FTP with traditional DBCS support” on page 87. An
alternative to using the subcommands and TYPE B commands is to use the
multibyte support in FTP that is activated by the ENCODING keyword in the
FTP.DATA file, LOCSITE subcommand, or SITE command. Use the ENCODING
and MBDATACONN keywords to enable translation using system supplied
codepages. This method supports most of the double-byte languages currently
handled by the traditional DBCS (TYPE B) support.
For example, you can specify that you want to use the Chinese standard GB18030
provided by the codepage IBM-5488 for data conversion on your data connections.
To use the codepage IBM-5488, you must specify that multibyte encoding is to be
used. You can do this in one of the following ways:
v Code the following statement in the FTP.DATA file:
ENCODING MBCS

v Issue a subcommand:
LOCSITE ENCODING=MBCS
You can then specify which codepage the IBM-5488 encoded data is to be
converted to or from in the file system by doing one of the following:
v Code one of the following statements in the FTP.DATA file:
MBDATACONN (IBM-1388,IBM-5488)
or
MBDATACONN (UTF-8,IBM-5488)
v Issue one of the following subcommands:
LOCSITE MBDATACONN=(IBM-1388,IBM-5488
or
LOCSITE MBDATACONN=(UTF-8,IBM-5488)
Guideline: These steps control the client end of the data connection. To request the
same conversions at the server end of the data connection, the same statements
must be added to the server FTP.DATA file or use the SITE subcommand.
Specifying values for new data sets

When allocating new data sets, there are several methods you can use to specify
the data set attributes. You can individually use the storage attribute parameters
with the SITE and LOCSITE commands or the hlq.FTP.DATA data set. Or, if your
system administrator has used the Storage Management Subsystem to group
together default attributes into named classes, you can specify those class names
on the DATAClass, STORclass, and MGmtclass parameters.
Dynamic allocation
FTP enables you to dynamically allocate a new physical-sequential data set,
partitioned data set (PDS), or partitioned data set extended (PDSE) for the purpose
of transferring data to be written to that data set. The following optional allocation
variables can be used by the client to override and turn off the hard-coded defaults
that affect the allocation of the data set.
Variable FTP.DATA parameter

allocation units SPACETYPE
blocksize BLKSIZE
data class DATACLASS
directory blocks DIRECTORY
logical record length LRECL
management class MGMTCLASS
model DCB values DCBDSN
PDS type PDSTYPE
primary space PRIMARY
record format RECFM
retention period RETPD
secondary space SECONDARY
storage class STORCLASS

unit UNITNAME
volume count VCOUNT
unit count UCOUNT
volume serial number VOLUME
Some of these allocation variables might provide duplicate information. For

example, the model DCB might have a record format (RECfm) that differs from the
record format specified by a data class and from the one explicitly specified by the
client. FTP passes all variables that are specified to dynamic allocation and lets it
determine which of the specifications takes precedence. The following list describes
the exceptions to that policy:
v If neither the primary nor secondary space quantity is specified, the allocation
units value is not sent.
v If the data set organization is physical-sequential, directory blocks specification
is not sent.
v Otherwise, all variables are sent to dynamic allocation where the order of
precedence is:
1. Any FTP.DATA, SITE, or LOCSITE parameters explicitly specified or
defaulted
2. Any attributes picked up from the model DCB and not otherwise explicitly
specified
3. Any attributes picked up from the data class and not previously derived
from 1 or 2
4. Any allocation defaults
Automatically generated SITE subcommand

The FTP client automatically generates a SITE subcommand when sending an MVS
data set with the PUt or MPut subcommand. The SITE subcommand includes
information on the record format, logical record length, and block size of the data
set. An example of a generated SITE command is:
SITE FIXrecfm 80 LRECL=80 RECFM=FB BLKSIZE=320
Where: FIXrecfm 80 is intended for use by VM servers and LRECL=80 RECFM=FB

BLKSIZE=320 is intended for use by MVS servers. ASCII servers ignore this SITE
information. The SENDSite command can be used to toggle the automatic sending
of the SITE subcommand. See “SENDSite subcommand—Toggle the sending of site
information” on page 269 for more information.
Storage Management Subsystem (SMS)

An FTP client can specify one or more of the following Storage Management
Subsystem (SMS) classes to manage characteristics that are associated with or
assigned to data sets.
v Data class is an SMS construct that determines data set allocation attributes used
by SMS for creation of data sets. The fields listed are available attributes that
serve as a template for allocation. Each is optional and is overridden by any
explicit specification of FTP allocation variables or by a model DCB (DCBDSN).

directory blocks DIRECTORY

logical record length LRECL
primary space PRIMARY
record format RECFM
retention period RETPD
secondary space SECondary
Note: If either primary or secondary space is explicitly specified, the primary

and secondary values from data class are not used.
v Management class is an SMS construct that determines Data Facility Hierarchical
Storage Manager (DFHSM) action for data set retention, migration, backup, and
release of allocated but unused space. Management class replaces and expands
attributes that otherwise would be specified. That is, management class might
override any other specification of retention period.
v Storage class is a list of storage performance and availability services requests
for an SMS-managed data set that SMS attempts to honor when selecting a
volume or volumes for the data set. It might conflict with an explicit
specification of volume and unit. If storage class is used, volume and unit
parameters should be unspecified.
Steps for using a DCBDSN model to create a new data set

Perform the following steps to use a DCBDSN model to create a data set.
1. Issue the following command:
SITE DCBDSN=data_set_name
where data_set_name is the name of the data set to be used as a model to set the
values of the logical record length (LRecl), the block size (BLKsize), the
retention period (RETpd), and the record format (RECfm) of a new data set.
_________________________________________________________________
2. Issue the following command to enable the LRecl, BLKSIze, and RECfm of the
model to be used:
SITE LRECL BLKSIZE RETPD RECFM
_________________________________________________________________
3. Issue the following command to create the new data set with the values
specified by the DCBDSN model:
PUT data_set_name
where data_set_name is the name of the new data set.
Note: If you are using a non-MVS client that does not support the SITE
command, you might be able to send the SITE command to the MVS
server by using the QUOTE command. For example:
QUOTE SITE DCBDSN=data_set_name
| Restriction: If more than one concurrent FTP user attempts to update a partitioned
| data set (PDS) using the FTP REName, DELEte, or PUt subcommands, the PDS
| directory might be accessed by more than one user simultaneously. This situation
| can cause problems with the PDS directory. To avoid this situation, when
| concurrent users will be using FTP REName, DELEte, or PUt subcommands to
| update a PDS, use a partitioned data set extended (PDSE).

Statistics for PDS members
ISPFStats can be set to either TRUE or FALSE in a client FTP.DATA file or can be
set using the LOCSITE subcommand. If ISPFStats is set to TRUE, FTP creates and
maintains statistics for partitioned data set members. The following explains the
effect ISPFStats has on PDS member statistics when you are issuing GET and
MGET subcommands.
Note: ISPFStats is ignored for sequential data sets. Also, the record format must be
either variable or fixed, and the record length must be less than 256.
Transferring PDS member to PDS member in block mode or in compress
mode differs in behavior from transferring in stream mode. If the user wants
to preserve the statistics of a PDS member that already has the statistics and
have the same statistics copied over to the target PDS member, transferring
in block mode or in compress mode is required.
v Effect of ISPFStats setting when issuing GET or MGET when the file does not
already exist
Whenever a PDS member is being transferred, FTP checks the setting of
ISPFStats. If the member does not already exist, FTP follows what the ISPFStats
is set to. For example:
– If ISPFStats is TRUE, FTP creates statistics for PDS members.
– If ISPFStats is FALSE, FTP does not create statistics.
v Effect of ISPFStats setting when issuing GET or MGET when the target PDS
member already exists
Whenever a member is being transferred, FTP checks the setting of ISPFStats. If
the targeted PDS member already exists, FTP considers whether the target
member has statistics and the setting of ISPFStats. For example:
– If ISPFStats is TRUE and the existing member has statistics, FTP updates the
statistics.
– If ISPFStats is TRUE and the existing member does not have statistics, FTP
creates the statistics.
– If ISPFStats is FALSE and the existing member has statistics, FTP updates the
statistics and sends a message indicating the behavior.
– If ISPFStats is FALSE and the existing member does not have statistics, FTP
does not create statistics.
Generation data group support

Generation data groups (GDGs) enable you to store multiple data sets, called
generation data sets (GDSs), as versions of the GDG. You cannot use FTP to create
a new GDG, but you can use it to create a new version (that is, a new GDS) or to
transfer an existing version of an existing GDG.
The relationship between DCBDSN and GDGs is governed by MVS allocation rules
rather than FTP usage rules. Therefore, when creating a new GDG [put
‘sys1.proclib(jes2)’ user77.mygdg(+1)], at least one of the following must be true:
v A valid MODEL or PATTERN DSCB (for FTP, DCBDSN) specification must be
coded in the FTP.DATA file when the z/OS FTP server is started.
v A valid SITE DCbdsn=dataset_name must be issued before a PUT command is
issued.
v A data set having the same name as the GDG base must reside on the volume as
the user catalog that contains the GDG definition. In this case, neither a SITE
DCbdsn or a DCBDSN argument in the FTP.DATA data file is required.
Allocation detects that a GDG is being created and looks in the VTOC of the
volume containing the USERCATALOG for a data set (uncataloged) that has the
same name as the GDG BASE (see the sample GDG JCL that follows).
Notes:
1. A model or pattern DSCB that is the same name as the GDG BASE cannot
exist on an SMS managed volume. This is an SMS restriction and is
documented in the DFP manuals pertaining to using data sets (generation
data sets or generation data groups).
2. Allocation does not generally have any requirements about the characteristics
of a MODEL DSCB (cannot be VSAM, must be on DASD). Most facilities
create one model DSCB for the entire system and everyone uses that model.
The system-wide model usually has no logical record length (LRecl), block
size (BLKsize), record format (RECfm), data set organization (DSORG) or
retention period (RETpd) associated with it.
3. The z/OS FTP server requires the MODEL DSCB to have a valid DSORG of
physical sequential organization (PS). Otherwise the SITE command for the
DCBDSN is ignored, and a message is issued indicating the DCBDSN was
ignored.
4. GDGs are MVS-specific structures. Other operating systems might not
support this structure. Using FTP to send GDG members to other operating
systems is not guaranteed to yield the same results as an MVS-to-MVS
transfer.
| 5. The REName subcommand does not guarantee serialization of the GDG data
| set. Use the PUt subcommand instead. See Informational APAR II08285 for
| more information.
The following restrictions apply:

v DCBDSN=USER.MYGDG(0)/ USER.MYGDG(-n), not supported
v DCBDSN=SYS1.PROCLIB(JES2), specifying a member of a PDS is not valid
v DCBDSN=SYS1.PROCLIB, valid
v The data set referenced on the DCBDSN, a DSORG of PS needed (FTP
requirement)
Note: If there are explicit values associated with LRecl, BLKsize, RECfm, or the
SMS management equivalent parameters, these explicit parameters override
the values associated with the model DSCB specified on the DCBDSN.
The following is a sample Job Control Language (JCL) to create a model and the
GDG BASE:
USER77.MYGDG -MODEL/PATTERN
VOL=SER=CPDLB1 -Volume having USERCATALOG, where USER77 is defined
(NAME(USER77.MYGDG) -GDG BASE definition
//USER77X JOB MSGLEVEL=(1,1),MSGCLASS=D,NOTIFY=USER77

//GDGA EXEC PGM=IDCAMS
//*
//GDGMOD DD DSN=USER77.MYGDG,
// VOL=SER=CPDLB1,
// UNIT=SYSALLDA,
// SPACE=(TRK,(0)),
// DCB=(LRECL=80,RECFM=FB,BLKSIZE=6800,DSORG=PS),
// DISP=(,KEEP)
//SYSIN DD *
DEFINE GENERATIONDATAGROUP -

(NAME(USER77.MYGDG) -
EMPTY -
NOSCRATCH -
LIMIT(255) )
GDG examples
Before you specify a (+nnn) value to create a new GDS, issue the following
command:
SITE DCBDSN=model
This subcommand specifies an MVS data set to be used as a model. The model
must have a DSORG of PS. The other DCB characteristics of the data set are not
checked.
Notes:
1. Failure to have a valid DCBDSN before trying to create a new GDS might
cause FTP or ALLOCATION to fail or to return unpredictable results.
2. If you issue a SITE DCbdsn LRecl BLKsize command before the creation of a
new data set, the LRecl and BLKsize parameters on the SITE command
override the LRecl and BLKsize parameters on the DCbdsn command.
For more information about GDGs, see MVS/DFP Version 3 Release 3, Using Data
Sets.
The following are sample FTP commands that access a GDG called JIMKEO.GDG.
Notes:
1. In the following examples, gdg (0), gdg (-1), and gdg (+1) specify which copy
of the GDG you are using. 0 indicates the latest version, -1 indicates the
previous version, and +1 indicates that a new version is created.
2. GDGALL is not supported by the z/OS FTP server. GDGALL processing occurs
when the base name for the GDG is specified without a relative index value.
3. The MPUT and MGET subcommands are not applicable for GDGs.
The following example illustrates a PUT to the latest existing GDS. The working
directory at the server is JIMKEO:
Command:
put my.gdg gdg(0)
>>>SITE FIXrecfm 150
200-Blocksize must be a multiple of lrecl for FB data sets. Blocksize set to
6150.
>>>PORT 129,34,128,245,126,229
>>>STOR gdg(0)
125 Storing data set JIMKEO.GDG.G0055V00
612 bytes transferred. Transfer rate 3.24 Kbytes/sec.
The following example illustrates a GET of the latest GDG:

Command:
get gdg(0) my.gdg2
>>>PORT 129,34,128,245,126,233
>>>RETR gdg(0)
125 Sending data set JIMKEO.GDG.G0055V00 FIXrecfm 150
The following example illustrates a PUT to a new GDS [After the STOR is
complete, this new version is referenced by (0)].
Command:
put my.gdg gdg(+1)
>>>SITE FIXrecfm 150
>>>PORT 129,34,128,245,126,234
>>>STOR gdg(+1)
125 Storing data set JIMKEO.GDG.G0056V00
The following example illustrates a GET of the previous GDS into the local file
called my.gdg3:
Command:
get gdg(-1) my.gdg3
>>>PORT 129,34,128,245,126,239
>>>RETR gdg(-1)
The following example illustrates a GET that replaces the contents of my.gdg3 with
the most recent GDS:
Command:
get gdg(0) my.gdg3 (replace
>>>PORT 129,34,128,245,126,243
>>>RETR gdg(0)
The following example illustrates changing the working directory:

Command:
cd gdg
>>>CWD gdg
257 "’JIMKEO.GDG.’" is working directory name prefix.
The following example shows the files created:

Command:
dir
>>>MODE s
200 Data transfer mode is Stream.
>>>PORT 129,34,128,245,127,12
>>>LIST
Volume Unit Referred Ext Used Recfm Lrecl BlkSz Dsorg Dsname
STRG73 3380K 04/30/92 1 5 FB 150 32700 PS G0003V00
STRG65 3380K 04/30/92 1 5 FB 150 32700 PS G0006V00
STRG61 3380K 04/30/92 1 5 FB 150 32700 PS G0010V00
STRG47 3380K 04/30/92 1 5 FB 150 32700 PS G0015V00
STRG47 3380K 04/30/92 1 5 FB 150 32700 PS G0021V00
STRG66 3380K 04/30/92 1 5 FB 150 32700 PS G0028V00
STRG47 3380K 04/30/92 1 5 FB 150 32700 PS G0036V00
STRG01 3380K 04/30/92 1 5 FB 150 32700 PS G0045V00
STRG53 3380K 04/30/92 1 5 FB 150 32700 PS G0055V00
STRG59 3380K 04/30/92 1 5 FB 150 32700 PS G0056V00
>>>MODE b
200 Data transfer mode is Block.
Command:
Submitting FTP requests in batch

FTP is usually run interactively by starting and entering commands from your
terminal. You can also run FTP as a batch job, but you must supply the JCL file.
You can use batch when you know what functions you want to perform, when you
want a hardcopy of the results, or when you want to perform an FTP function
many times.
| Rules: When coding the data set, file, or input stream for the ddname INPUT
| statement as described in Figure 4 on page 100, the following rules apply:
| v When you specify a data set for input as shown in Figure 4 on page 100, the
| SEQNUMSUPPORT statement coded in the client’s FTP.DATA file determines
| the disposition of sequence numbers that are in the data set:
| – If the FTP.DATA file has SEQNUMSUPPORT FALSE coded (this is the
| default), the file, data set, or input stream designated by the DDNAME
| INPUT statement that contains the FTP commands cannot have sequence line
| numbers in it. You must save the FTP command file as an unnumbered file.
| – If the FTP.DATA file has SEQNUMSUPPORT TRUE coded, the file, data set,
| or input stream that is designated by the DDNAME INPUT statement
| containing the FTP commands can have sequence numbers in it. These
| sequence numbers are removed.
| v You can add comments to the command input file using the REXX program that
| stacks the commands. The support includes standalone comment records and
| comments that are appended to the end of the line.
| To add standalone comments, use a semicolon (;) as the first non-space character
| on a line. For example:
| ; This is a stand-alone comment record
| You can add a command-line comment by appending a space and a semicolon

| to the end of the command line, followed by the comment. For example:
| USER userx ; This is an appended comment
| When a user ID or password is expected (including passwords required for read
| or write access to files or disks), the entire line has to be blank. The following
| example shows a blank password between the user ID and a comment line.

| USER userx
|
| ; The line above is a blank password
| The following example shows a blank user ID between a comment line and
| password.
| ; This below is a blank userid
|
| mypasswd
| v If a command is too long to insert on a line, type a plus sign (+) in place of the
| next command option and then enter the remaining options on the next line. For
| example:
| put local_file +
| remote_file
| v Use a blank followed by a plus sign (+) at the end of an FTP subcommand line
| as a continuation indicator for all FTP subcommands except for the QUOTE
| subcommand. When the continuation indicator is encountered at the end of an
| FTP subcommand line, the next line is appended to the subcommand. For
| example, the following command is interpreted as PUT SOURCE.DS.NAME
| DEST.DS.NAME:
| PUT SOURCE.DS.NAME +
| DEST.DS.NAME
Tips:
v FTP can be run in batch either by specifying data sets for input and output as in
Figure 4 on page 100, or without referring to data sets for input and output as in
Figure 6 on page 101. See “Allocating FTP input and output data sets” on page
38 for the attributes that are allowed on the INPUT and OUTPUT DD
statements.
v Use the (EXIT parameter if you want FTP to display an error return code and
then exit when certain errors are detected. See “FTP return codes” on page 105
for more information.
Requirements:
v To have the FTP client perform DB/2 queries in a batch job, the DSNLOAD
library must be in the link list or appear on a STEPLIB DD statement for the job.
v When connecting to a server such as a UNIX server where user IDs, passwords,
directory names, and file names are case-sensitive, the data in the FTP batch job
must be in the correct case.
Restriction: When the FTP Client API is utilized by an application program

invoked from a batch job, the ddnames in the batch job are not available to the
spawned FTP client process.
Figure 4 on page 100 shows an example of the JCL required to submit a batch job
by referring to data sets for input and output.

//USER28F JOB ,CARTER,MSGLEVEL=(1,1)
//FTPSTP1 EXEC PGM=FTP,REGION=2048K,
// PARM=’9.67.112.25 (EXIT TIMEOUT 20’
//NETRC DD DSN=ANYHLQ.NETRC,DISP=SHR
//OUTPUT DD SYSOUT=H
//INPUT DD *
type e
mode b
put idss.parts
/*
Figure 4. JCL to run FTP in batch using data sets
Notes:
1. REGION=2048K is a minimum requirement. The requirement could increase
depending on the block size of the data set being transmitted.
2. The first JCL statement is a standard job statement. The next JCL statement is
an EXEC statement. It has PGM=FTP (a region parameter) because FTP might use
more storage than your default region size, and a PARM field.
3. For PARM=, you can specify any parameter that is valid when invoking FTP from
your terminal. See “Using FTP” on page 29 for more information. These
parameters are supported only on the PARM= field of the EXEC card.
As shown in Figure 4, to run FTP in batch mode, you must include the following
three DD statements:
SYSPRINT DD
Alternative name for the OUTPUT DD statement. You can use
SYSPRINT DD in place of the OUTPUT DD statement.
OUTPUT DD Specifies the data set where FTP is to place the client messages and
server replies generated during the FTP session.
INPUT DD Specifies the data set where the FTP subcommands to be
performed are located.
You can use the user_id.NETRC data set, as defined by the NETRC DD statement
in Figure 4, to identify the user ID and password for a batch-processed remote
login. You can also specify the user ID and password in the INPUT DD data set.
Figure 5 shows the records in an INPUT DD data set that contains the FTP
commands to be executed.
HOSTNAME
USERID PASSWD
DIR
PUT MYFILE.LISTING
QUIT
Figure 5. Contents of an INPUT DD data set
The first line of Figure 5 contains the name of the host that you want FTP to use.
The second line contains the user ID followed by its password. The next three lines
contain the FTP commands that you want FTP to perform. In this example, FTP is
doing a directory listing of the server to which you are connecting. The example
then instructs FTP to send a file to the server. The last line ends the connection.
Any client messages and server replies to the commands you execute appear in the
OUTPUT DD data set. The SYSPRINT can contain some additional messages that
relate to the execution of your FTP session.

Note: If you do not want your password to be copied to the output file, specify
your user ID and password on separate input lines. See Figure 6 for an
example.
Submitting requests without input and output data sets

Figure 6 shows an easier way to submit a batch job, because you can avoid
referring to data sets for input and output.
//USERIDX JOB USERID,MSGLEVEL=(1,1),NOTIFY=USERID,MSGCLASS=H,TIME=9

//FTP EXEC PGM=FTP,REGION=4096K
//INPUT DD *
nodeid
userid
password
CD
DIR
GET hostfile.name locfile.name
QUIT
Figure 6. JCL to run FTP in batch without using data sets
Figure 7 shows step 1 creating a new GDS in batch and FTP getting the data set.
//USERIDX JOB USERID,MSGLEVEL=(1,1),NOTIFY=USERID,MSGCLASS=H,TIME=9

//STEP1 EXEC PGM=IEBGENER
//SYSIN DD DUMMY
//SYSUT1 DD DSN=USER31.SOURCE.DATA,DISP=SHR (MYGDG.G0008V00)
//SYSUT2 DD DSN=MYGDG(+1),DISP=(,CATLG),
UNIT=SYSDA, SPACE=(TRK,(1,1)),DCB=(MODEL)
//FTP EXEC PGM=FTP,REGION=4096K
//INPUT DD *
nodeid
userid
password
CD /u/joe
DIR
GET MYGDG(0) A.DATA.SET
QUIT
Figure 7. Job to create a new GDS in batch
Note: All the GDG allocation in batch must be complete before the start of FTP.
| Submitting a batch job with concatenated files

|
| //USERIDX JOB USERID,MSGLEVEL=(1,1),NOTIFY=USERID,MSGCLASS=H,TIME=9
| //FTP EXEC PGM=FTP,REGION=4096K
| //SYSFTPD DD DSN=SYS1.TCPPARMS(FTPCDATA),DISP=SHR
| // DD * see NOTE 1
| SEQNUMSUPPORT TRUE
| DEBUG BAS
| //INPUT DD DSN=FTP.SUBCMDS(LOGIN),DISP=SHR
| // DD DSN=FTP.SUBCMDS(FTPINFO),DISP=SHR
| // DD DSN=FTP.SUBCMDS(FTPCMDS1),DISP=SHR
| // DD DSN=FTP.SUBCMDS(FTPCMDS2),DISP=SHR
|
| Figure 8. Submitting an FTP batch job with concatenated input
|
| Tips:
| v Additional FTP parameters can be concatenated to the FTP.DATA file. This
| technique is useful when you need additional debugging information and you
| do not want to change the source FTP data file or FTP command input.
| v Multiple data sets can be concatenated as input as long as you follow MVS JCL
| concatenation guidelines. See the z/OS MVS JCL Reference for additional
| information. If concatenated files contain both sequenced and unsequenced input
| command files, each file must have a semicolon (;) in the first data column. See
| FTP.DATA statement SEQNUMSUPPORT information in the z/OS
| Communications Server: IP Configuration Reference for additional information.
FTP and data set cataloging

When FTP creates a new data set, it issues a dynamic allocation request to allocate
space for the data set and catalogs the data set.
If the data transfer fails when CONDDISP=DELETE, the data set is deleted and
uncataloged.
If you are running a job scheduling program that detects files as they are
catalogued and then schedules a subsequent job for processing, the job scheduler
must take into account that setting CONDDISP=DELETE causes FTP to delete and
uncatalog the data set when the file transfer fails. For generation data groups, the
following might occur:
v FTP intends to create a new GDG(+1) and generates GDG.G00023V00.
v FTP of this data set fails and the GDG.G00023V00 data set is deleted and
uncataloged.
v A follow-on reference for the current GDG, for example, GDG(0), would cause
the data set GDG.G00022V00 to be accessed and old data to be processed.
Using the EXEC interface

The FTP EXEC interface enables you to execute FTP commands from an EXEC
rather than interactively from a terminal. The FTP subcommands to be performed
can be in a file (MVS data set or z/OS UNIX file), or you can code them directly in
the EXEC.
By default, the FTP session dialog is printed on the terminal. If you want the
dialog sent to a data set rather than the terminal do one of the following:
TSO Specify an OUTPUT data set as part of the ALLOC
statement.
z/OS UNIX System Services Redirect the output to a z/OS UNIX file when
invoking the FTP command.
The following examples are written in REXX. See the z/OS TSO/E REXX Reference
and z/OS Using REXX and z/OS UNIX System Services for more information about
the REXX language.
Issuing FTP subcommands from a file

Figure 9 on page 103 is an example of an EXEC that issues FTP subcommands
from a data set. In this example, the FTPIN1 data set is used for the FTP
subcommands, and FTPOUT1 is used to store the FTP session dialog. This example
must be invoked from TSO.

/*REXX*/
"ALLOC DA(FTPIN1) DD(INPUT) SHR REU" /* Input will be from FTPIN1 */
if rc ¬= 0 then do
say ’Error in ALLOC INPUT, rc = ’ rc
exit
end
"ALLOC DA(FTPOUT1) DD(OUTPUT) SHR REU" /* Output goes to FTPOUT1 */
if rc ¬= 0 then do
say ’Error in ALLOC OUTPUT, rc = ’ rc
exit
end
"FTP YKTVSH" /* FTP to the YKTVSH host */
"FREE DD(INPUT)"
"FREE DD(OUTPUT)"
EXIT
Figure 9. How to issue the FTP subcommands from a data set
Figure 10 is an example of an EXEC that issues FTP subcommands from a z/OS

UNIX file. In this example, the name of the input file and output file are passed as
arguments on the EXEC. For example,
EXAMPLE1 /u/user117/ftpin1 /u/user117/ftpout1
where EXAMPLE1 is the name of the EXEC. This example must be invoked from the
z/OS UNIX shell.
/* rexx */
/* */
/* Input: infile - z/OS UNIX file containing FTP commands */
/* outfile - z/OS UNIX file to contain FTP output. If not specified */
/* output goes to terminal. */
parse arg infile outfile . /* get command line input */
if infile = ’’ then /* input file not specified */

do
say ’Input file name is required.’
exit 12 /* return to UNIX System Services */
end
else
input_file = ’<’ infile /* redirect input from file */
if outfile <> ’’ then

output_file = ’>’ outfile /* redirect output to file */
else
output_file = ’’
address syscall "stat (infile) fstat." /* test if input file exist */

if fstat.0 = 0 then /* input file not found */
do
say ’Input file:’ infile ’not found.’
end
"ftp -v -p TCPIP" input_file output_file /* invoke FTP client with

input and output redirection */
say "FTP client return code is:" rc /* print client return code */
Figure 10. How to issue the FTP subcommands from a z/OS UNIX file system
The following is an example of the input file (either the input data set FTPIN1 or
the z/OS UNIX file /u/user117/ftpin1).
krasik mvsftp
cd examples
put t.info t1.info
get t1.info t2.info (r
quit
Where:
krasik Is the user ID
mvsftp Is the password
t.info Is the file to be transferred
Issuing FTP subcommands directly from the EXEC interface

Figure 11 is an example of how to issue FTP subcommands directly from a REXX
EXEC. The REXX stack is used to hold the FTP subcommands. This example runs
in both the TSO and z/OS UNIX environments.
Note: To use FTP in a z/OS UNIX environment, TSO users must be authorized
users or have a default z/OS UNIX user ID.
/* rexx */
/* push commands on stack */
QUEUE "YKTVSH" /* server address */
QUEUE "krasik mvsftp" /* userid/password */
QUEUE "cd /tmp/examples/"
QUEUE "put t.info t1.info"
QUEUE "cd .."
QUEUE "cd dummy"
QUEUE "quit"
cmdargs = "-v -p TCPIP" /* set ftp client arguments */
parse source . . . . . . . . env . /* check if running under */

/* UNIX System Services */
/* env=’OpenMVS’ if invoked from */
/* UNIX System Services, */
/* otherwise env=’’ */
if env = "OpenMVS" then /* running under */

/* UNIX System Services */
/* invoke ftp client */
call bpxwunix ’ftp -v -p tcpip’,stack
else /* running under TSO */
"FTP" cmdargs /* invoke ftp client */
say "FTP client return code is:" rc /* print client return code */
exit 0 /* return */
Figure 11. How to issue FTP subcommands from an EXEC
Note: If data set DUMMY does not exist, FTP exits with a return code.
Figure 12 on page 105 is an example of how to call FTP from a TSO/E REXX EXEC
and enable it to solicit its FTP subcommands interactively from the user’s TSO
terminal. This requires that TSO/E has prompting enabled.

/* rexx */
newstack; /* set up a null stack for FTP*/
/* so as to not disturb any */
/* commands currently stacked*/
save_rexx_prompt_state = prompt(); /* save REXX prompt state */
temp = prompt(’ON’); /* set prompting on to enable */
/* interactive retrieval of */
/* ftp commands running */
/* under TSO */
"FTP ( exit" /* invoke ftp client */
save_rc = rc; /* save FTP return code */
temp= prompt(save_rexx_prompt_state);/* restore prompt setting */
delstack; /* delete null stack for FTP */
return save_rc; /* return */
Figure 12. How FTP subcommands can be solicited interactively from an EXEC
Tips:
v You can call this EXEC from another TSO/E REXX EXEC by invoking this EXEC
as a function call. For example, if this EXEC is named rexxftp, invoke it with the
following call: return_code = rexxftp()
v If commands are stacked for processing and the newstack and delstack
statements are removed from the sample, FTP subcommands are retrieved and
processed from the stack. If no QUIT command is processed, FTP obtains
commands interactively until a QUIT command is received.
v See the FTP Client API REXX function information in the z/OS Communications
Server: IP Programmer’s Guide and Reference for an alternate method of using
REXX to invoke the FTP client.
FTP return codes

By default, the FTP client ignores any errors that occur during a session and exits
with a return code of zero. You can direct FTP to exit on error with a nonzero
return code by specifying the EXIT or EXIT=nn parameter on the FTP command.
There are several methods you can use to direct the FTP client to compute return
codes.
When FTP is started from the FTP Callable Application Programming Interface, all
elements that compose the values described below are returned to the application.
These include the client error code, the server reply code, and the FTP
subcommand code. The CLIENTERRCODES setting in the FTP.DATA file has no
effect on the FTP Callable API. See the z/OS Communications Server: IP Programmer’s
Guide and Reference for detailed information about using the FTP Callable API.
The FTP client issues message EZA1735I to display the standard return code and
the client error code when the (EXIT parameter is specified on the FTP command
an an error occurs. The standard return code is described in “FTP standard return
codes” on page 106; the client error code is described in “FTP client error codes”
on page 110. All possible computed return codes (excluding EXIT=nn) can be
derived from the information found in the message. EZA1735I is issued regardless
of the type of return code or whether client error logging is in use. See “FTP client
error logging” on page 111 for more information about logging client errors.
When a critical error occurs before the client can establish its environment, FTP
client initialization can exit with a return code set to client error code regardless of
the type of return code requested or the EXIT=nn value.
Each subcommand has an EXIT_IF_ERROR flag that determines whether the FTP
client exits when an error occurs if you specify EXIT or EXIT=nn on the FTP
command. See “FTP subcommand codes” on page 107 for a list of the FTP
subcommand codes and their EXIT_IF_ERROR settings.
The following are the methods for computing the return code:
EXIT=nn
This method instructs the client to exit with a specified fixed return code for
any eligible error. The EXIT parameter is specified with an equal sign (=)
followed by a number in the range of 0–4095.
EXIT with CLIENTERRCODES FALSE (or unspecified) in FTP.DATA
This is the standard return code processing for FTP with EXIT specified. This
type of return code is described in “FTP standard return codes.” Some
limitations of this method are:
v The size of the return code might exceed the capacity (65536) of the SMF
record type 30 subtype 4.
v The return code issued as a batch job step completion code generally does
not match the original return code.
v The batch job step completion codes are difficult to interpret.
Because of these limitations, using one of the other return code options that are
available is recommended.
This method can be used in conjunction with client error logging even if no
EXIT parameter is in use. See “FTP client error logging” on page 111 for more
information about logging client errors.
EXIT with CLIENTERRCODES TRUE in FTP.DATA
This method uses a list of error codes, defined in “FTP client error codes” on
page 110, to describe different types of errors that occur within the FTP client.
For example, errors returned by the server are reported in the client as
FTP_SERVER_ERROR. The client error codes are the same in all environments
and are easier to interpret than standard return codes, but client error codes
contain less information about the cause of the error.
EXIT with CLIENTERRCODES EXTENDED in FTP.DATA
The EXTENDED client error code is composed of an FTP client error code and
an FTP subcommand code, as described in “FTP client error codes extended”
on page 111. These return codes match in all environments, are easily
interpreted, and provide more information regarding the cause of the error
than the client error codes alone.
FTP standard return codes

Standard FTP return codes are computed when EXIT is specified with no
parameter and CLIENTERRCODES FALSE is specified or defaulted to in the
FTP.DATA file. They might also be displayed in the text of message EZZ9830I if
LOGCLIENTERR TRUE and CLIENTERRCODES FALSE are specified in the
FTP.DATA file, whether or not EXIT was specified on the FTP command. A
standard FTP return code appears in the following format:

yyxxx
Where:
yy Is the subcommand code, a number in the range 1-99 representing the
subcommand that the FTP client was executing when it detected the error.
Each subcommand has an EXIT_IF_ERROR flag that determines whether FTP
is exited when an error occurs if you specified EXIT on the FTP command.
Table 18 describes the possible FTP subcommand codes.
xxx
Is the reply code from the most recent reply sent by the FTP server. All FTP
server replies begin with a 3-digit number. All reply codes used by the z/OS
FTP server are listed the z/OS Communications Server: IP and SNA Codes. See
RFC 959 and RFC 1123 for a generic description of FTP reply codes.
Information about accessing RFCs can be found in Appendix D, “Related
protocol specifications,” on page 449.
For example, the FTP standard return code 16550 indicates the following:
16 The GET command failed.
550 The reply code from the FTP server. The latest reply from the server began
with the number 550.
The FTP standard return code 04532 indicates the following:

04 The APPEND command failed.
532 The reply code from the FTP server.
00 and 000 are valid values for yy and xxx. This means that the error occurred at a
time when no FTP subcommand was being processed (yy=00) or at a time when no
reply had been received from the server for the current process. Message EZA1735I
(issued when EXIT was specified at client start) contains the standard return code
and the client error code.
FTP subcommand codes

Table 18 lists the valid FTP subcommand codes. The EXIT_IF_ERROR column
specifies whether an error causes FTP to end if you specified the EXIT parameter
on the FTP command.
Note: LOCSITE will EXIT_IF_ERROR only when there are no parameters on the
command.
Table 18. FTP subcommand codes
Code number Subcommand EXIT_IF_ERROR
00 No subcommand Determined by internal FTP CLIENT
selected ERROR CODE
1 AMBIGUOUS false
2 ? false
3 ACCT true
4 APPEND true
5 ASCII true
6 BINARY true
7 CD true
Table 18. FTP subcommand codes (continued)
8 CLOSE true
9 TSO false
10 OPEN true
11 DEBUG false
12 DELIMIT false
13 DELETE true
14 DIR true
15 EBCDIC true
16 GET true
17 HELP false
18 LOCSTAT true
19 USER true
20 LS true
21 MDELETE true
22 MGET true
23 MODE true
24 MPUT true
25 NOOP true
26 PASS true
27 PUT true
28 PWD true
29 QUIT true
30 QUOTE true
31 RENAME true
32 SENDPORT true
33 SENDSITE false
34 SITE false
35 STATUS true
36 STRUCTURE true
37 SUNIQUE true
38 SYSTEM true
40 TYPE true
41 LCD true
42 LOCSITE true (see previous note in “FTP
subcommand codes” on page 107)
43 LPWD false
44 MKDIR true
45 LMKDIR true
46 EUCKANJI true
47 IBMKANJI true

Table 18. FTP subcommand codes (continued)
48 JIS78KJ true
49 JIS83KJ true
50 SJISKANJI true
51 CDUP true
52 RMDIR true
53 HANGEUL true
54 KSC5601 true
55 TCHINESE true
56 RESTART false
57 BIG5 true
58 BLOCK true
59 COMPRESS true
60 FILE true
61 PROXY true
62 RECORD true
63 SCHINESE true
64 STREAM true
65 GLOB false
66 PROMPT false
67 UCS2 true
68 ! true
70 DUMP false
71 VERBOSE false
72 CLEAR true
73 CPROTECT true
74 PRIVATE true
75 PROTECT true
76 SAFE false
77 CCC true
78 LANGUAGE true
79 FEATURE true
80 SRESTART true
| 81 AUTH true
99 UNKNOWN true
FTP reply codes

The z/OS FTP client displays each command it sends to the FTP server, and the
FTP server reply to that command. As mandated in RFC 959, an FTP server must
reply to every command an FTP client sends to it. The replies are architected to
begin with a three digit reply code, followed by human readable text. The reply
code indicates the status of the command; the text provides additional information.
FTP clients generally interpret only the reply code and ignore the text. The reply
code indicates to the client whether the server is still processing the command, or
whether the server finished processing the command successfully, or whether the
server stopped processing the command because of errors. For a generic
description of FTP server reply codes, see RFC 959 and RFC 1123. Information
about accessing RFCs can be found in Appendix D, “Related protocol
specifications,” on page 449. For a complete list of the replies used by the z/OS
FTP server, see z/OS Communications Server: IP and SNA Codes.
FTP client error codes

Table 19 lists error codes that are used as condition codes for batch jobs if (EXIT is
specified, or as return codes from REXX execs, whenever the FTP client detects one
of the described errors and the FTPDATA statement CLIENTERRCODES is TRUE.
These codes are also used to build the return code when CLIENTERRCODES is
EXTENDED. Message EZA1735I (issued when EXIT was specified at client start)
contains the standard return code and the client error code.
| Result: The return code 24 might supersede condition codes that were used in
| earlier releases.
Table 19. Client error codes
Code Error Examples of cause
01 FTP_INTERNAL_ERROR Failure to acquire storage, unexpected
error in REXX stack.
02 FTP_SERVER_ERROR Error reply returned by the server.
03 unused N/A
04 FTP_INVALID_PARAM Parameter specified on FTP command
is not valid.
05 FTP_OPEN_IOSTREAM_FAILED Failed to open the INPUT stream.
06 FTP_ALREADY_CONNECTED Attempt to OPEN when already
connected.
07 FTP_USAGE Syntax error in a subcommand,
combination of settings is not valid.
08 FTP_CONNECT_FAILED Attempt to reach unknown host, lost
connection, data connect failed.
09 FTP_TIMEOUT Timeout waiting for response on the
control or data connection.
10 FTP_SESSION_ERROR Socket error, other send/receive
errors.
11 FTP_LOGIN_FAILED User ID, password, or account info is
not valid.
12 FTP_INPUT_ERR Error reading INPUT or STDIN.
13 FTP_INPUT_EOF Internal use only.
14 FTP_NOTFOUND TCP/IP stack not found, resolver not
found, translation table not found or
could not be loaded.
15 FTP_INVALID_ENVIRONMENT Missing INPUT DD.
16 FTP_NOT_ENABLED Improper installation of TCP/IP.
17 FTP_AUTHENTICATION Security authentication or negotiation
failure, incorrect specification of
security keywords.

Table 19. Client error codes (continued)
Code Error Examples of cause
18 FTP_FILE_ACCESS Data set allocation failure, recall
failure, open failure.
19 FTP_FILE_READ File corrupted.
20 FTP_FILE_WRITE Out of space condition, close failure.
21 FTP_CONVERSION Error during data translation or setup
not otherwise specified.
22 FTP_PROXY_ERR Error during proxy processing not
otherwise specified.
23 FTP_SQL_ERR Error returned by the SQL process,
including connect failure.
24 FTP_CLIENT_ERR Other errors in the client, some
unrecoverable interface errors.
| 25 FTP_EOD_BEFORE_EOF In a block mode transfer, the last
| record did not include the EOF
| marker. In a stream mode transfer, the
| last record received before the
| connection was closed did not end
| with a
| <CRLF> (carriage return followed by
| line feed) sequence.
FTP client error codes extended

The EXTENDED client error codes feature is enabled by specifying
CLIENTERRCODES EXTENDED in the FTP.DATA data set used by the client.
EXTENDED implies TRUE, meaning that client error codes are be used for return
code generation, and it supplements the information returned. The following is the
format of the return code:
ecyy
Where:
ec The client error code set by the FTP client. See “FTP client error codes” on
page 110 for more information.
yy The subcommand code, which is a number in the range of 0–99. See “FTP
subcommand codes” on page 107 for a list of the subcommand codes.
The return code returned to the user or batch job is the 4-digit ecyy value. This
value can also be derived from the contents of message EZA1735I, which displays
the standard return code and client error code.
FTP client error logging

If you activate FTP client error logging, message EZZ9830I provides the
subcommand code, last reply code, and computed return code of any error that
causes FTP to exit. If you have not specified the EXIT or EXIT=nn parameter on
the FTP command, client error logging will drive message EZZ9830I on the first
error that would have caused FTP to exit if EXIT or EXIT=nn had been specified.
The client error logging feature is enabled by specifying LOGCLIENTERR TRUE in

the FTP.DATA data set used by the client.
Each subcommand has an EXIT_IF_ERROR flag that determines whether the FTP
client exits when an error occurs if you specified EXIT or EXIT=nn on the FTP
command. See “FTP subcommand codes” on page 107 for a list of FTP
subcommand codes and their EXIT_IF_ERROR settings.
If the client session is interactive, the message is displayed on the user terminal. If
the client session is not running in an interactive environment, the message
appears in the system log and in the batch job log. The information contained in
EZZ9830I includes:
v The address space name.
v The FTP subcommand code.
v The last reply code from the server (or 000 if none).
v Whether EXIT was specified at client start.
v The type of computed return code.
v The computed return code value based on the start parameters and
configuration settings. It might not match the actual return code observed from
the client.
Because EZZ9830I is written to the system log when the FTP client is running as a
batch job, the message can be used to drive automation. The computed return code
displayed in the message might be the EXIT=nn value, a standard return code, a
client error code, or a client error code extended.
The standard return code can be derived from the FTP subcommand code and last
reply from the server displayed in the message text. See z/OS Communications
Server: IP Messages Volume 4 (EZZ, SNM) for the complete message format of
EZZ9830I and an explanation of the computed return code value and the other
fields in the message.
Restarting a failed data transfer

FTP supports two subcommands for restarting data transfers that fail. Select the
appropriate subcommand based on the data transfer mode at the time the data
transfer failed.
v If stream mode data transfer was used, use the srestart subcommand to restart
the data transfer. See “SRestart subcommand—Restart a stream data transfer” on
page 299 for a description of stream mode restart.
v If block or compressed mode was used, use the restart subcommand to restart
the data transfer. See “REStart subcommand—Restart a checkpointed data
transfer” on page 263 for a description of block or compressed mode restart.
To restart a block or compressed mode data transfer, checkpointing must have been
initiated prior to the start of the transfer. You can use either the LOCSITE or SITE
subcommands to initiate checkpointing.
v The LOCSITE subcommand parameter CHKPTINT controls the checkpoint
interval at the client, and the parameters CHKPTPREFIX and RESTGET control
the naming of the client checkpoint data set.
v The SITE subcommand parameter CHKPTINT controls the checkpoint interval at
the server.
Each of the LOCSITE/SITE parameters is also supported in the FTP.DATA file.

Interfacing with JES
The MVS Job Entry System (JES) enables you to perform the following functions:
v Submit jobs (consisting of JCL and data) to the job scheduler for execution
v Spool JCL messages and SYSOUT during execution
v Print the output
v View the output
v Delete job output
FTP server provides the following functions in its JES interface:

v Submitting a job
v Displaying the status of all the user’s jobs
v Receiving the spool output of the job (JCL messages and SYSOUT)
v Deleting a job
v Submitting a job and automatically receiving output
v Terminating access to JES
Steps for submitting a job

A job consists of job control language (JCL) and data.
Perform the following steps to submit a job using FTP.

1. Create the JCL and data that you want to submit, using the editor on your
client.
v If the FTP server is set up for JESINTERFACELEVEL 1, to be able to display
the status, receive spool output for, and delete a job, the job name in the JCL
must be the USERIDx, where x is a 1-character letter or number and USERID
must be the user ID you use to log into the FTP server to submit the job.
Otherwise if the job name in the JCL is not USERIDx, the job can be
submitted but the DIR subcommand will not display the job, and the GET
and DELETE subcommands will not be supported for the job.
v If the FTP server is set up for JESINTERFACELEVEL 2, the job name can be
any name you are authorized to view using the Security Authorization
Facility (SAF), such as RACF. See “JESINTERFACELEVEL differences” on
page 120 for more information on security and JESINTERFACELEVEL 2.
You can determine how the FTP server is set up and whether you have
authority to view jobs by entering the STAT client command and the SITE
command. For JESINTERFACLEVEL 2, the STAT command returns:
211-JESINTERFACELEVEL is 2
211-JESOWNER is USER1
211-JESJOBNAME is USER1*
If the SITE JESOWNER= completes successfully, then the user has SAF
authority to other users’ jobs. If the SITE JESJOBNAME= completes
successfully, then the user has SAF authority to other jobs.
Note: The maximum LRecl for the submitted job is 254 characters. JES scans
only the first 72 characters of JCL.
_________________________________________________________________
2. Start a session with the FTP server on the MVS system to which you want to
submit the job.
_________________________________________________________________
3. After you have entered your user ID and password, specify that you want to
interface to JES with a site parameter by entering the following:
SITE FILEtype=JES
_________________________________________________________________
4. To submit the JCL file you have created, enter the following:
PUT filename.filetype
_________________________________________________________________
When you are done, the JCL is then submitted to the JES internal reader and waits
for an initiator to start the job. The job is submitted under the user ID that you
used when you logged on to the system unless a different user ID is specified on
the JOB card.
The default for filetype is SEQ, and when you want to go back to normal FTP file
transfer mode, enter the following:
SITE FILEtype=SEQ
See the z/OS MVS JCL Reference for more information about using JCL.
Displaying the status of a job

This section describes client operation when the MVS server has been placed in
FILEtype=JES mode with the SITE command. After you have submitted your job,
you can determine whether it is waiting for execution, running, or finished. The
status of all the jobs that are on the JES spool for your user ID can be displayed.
The format of the display depends on the value of JESINTERFACELEVEL.
DIR output with JESINTERFACELEVEL=1

The following is a sample of the DIR output with JESINTERFACELEVEL=1:
MYUSRIDA JOB05444 OUTPUT 3 spool Files
MYUSRIDB JOB05766 OUTPUT 6 spool Files
MYUSRIDC JOB05832 OUTPUT 6 spool Files
MYUSRIDD JOB05946 ACTIVE
MYUSRIDE JOB06021 INPUT
1 2 3 4
1. The first column displays the job name.

2. The second column displays the job ID, assigned by JES. This 8-character job
ID, consisting of the word JOB followed by a 5-digit number or the letter J
followed by a 7-digit number, is assigned by JES to identify your job.
3. The third column displays the status of the job.
The status is one of the following:
INPUT
The job was received, but not run yet. If the JCL specified that the job
be put on hold, it appears with this status.
ACTIVE
The job is running.
OUTPUT
The job has finished and has output to be printed or retrieved. For each
OUTPUT job, there are spool files that consist of JCL messages, JES

messages, initiator and terminator messages, and SYSOUT. For jobs
with a status of OUTPUT, the number of spool files for each job is
specified in the DIR display output.
4. The fourth part of the display lists the number of retrievable spool files for the
job.
Note: The LS subcommand lists the job ID without the job status or number of
spool files. Providing this spool information consumes a lot of computer
resources. Use the LS subcommand rather than the DIR subcommand
when the job status and number of spool files are not required.
DIR command with JESINTERFACELEVEL=2

The following is a sample of the DIR command with JESINTERFACELEVEL=2:
dir
EZA1701I >>> PORT 127,0,0,1,4,5
EZA1701I >>> LIST
125 List started OK for JESJOBNAME=USER1*, JESSTATUS=ALL and JESOWNER=USER
EZA2284I JOBNAME JOBID OWNER STATUS CLASS
EZA2284I USER1A JOB00083 USER1 OUTPUT A ABEND=806 3 spool files
EZA2284I USER1 JOB00070 USER1 OUTPUT A RC=000 5 spool files
EZA2284I USER1J JOB00082 USER1 OUTPUT A (JCL error) 3 spool files
EZA2284I USER1 JOB00054 USER1 OUTPUT A RC=0000 5 spool files
EZA2284I USER1D JOB00029 USER1 OUTPUT A RC=0000 5 spool files
EZA2284I USER1C JOB00028 USER1 OUTPUT A RC=0000 5 spool files
EZA2284I USER1B JOB00027 USER1 OUTPUT A RC=0000 5 spool files
EZA2284I USER1 TSU00024 USER1 ACTIVE TSU
EZA2284I USER1W JOB00081 USER1 INPUT A -DUP-
EZA2284I USER1p JOB00093 USER1 INPUT A -HELD-
250-JESENTRYLIMIT of 10 reached. Additional entries not displayed
EZA1460I Command:
dir tsu00024
EZA1701I >>> PORT 127,0,0,1,4,6
EZA1701I >>> LIST tsu00024
EZA2284I USER1 TSU00024 USER1 ACTIVE TSU
--------
EZA2284I STEPNAME ++++++++ PROCNAME OS390R5
EZA2284I CPUTIME 0.503 ELAPSED TIME 3853.718
EZA1460I Command:
dir job54
EZA1701I >>> PORT 127,0,0,1,4,7
EZA1701I >>> LIST job54
EZA2284I USER1 JOB00054 USER1 OUTPUT A RC=000
EZA2284I --------
EZA2284I ID STEPNAME PROCSTEP C DDNAME BYTE-COUNT
EZA2284I 001 JESE H JESMSGLG 1200
EZA2284I 002 JESE H JESJCL 526
EZA2284I 003 JESE H JESYSMSG 1255
EZA2284I 004 STEP57 H SYSUT2 741
EZA2284I 005 STEP57 A SYSPRINT 209
EZA2284I 5 spool files
EZA1460I Command:
v For a list of jobs these fields are displayed:

JOBNAME
The job name.
JOBID
The job ID, assigned by JES. This 8-character job ID, consisting of the word
JOB followed by a 5-digit number or the letter J followed by a 7-digit
number, is assigned by JES to identify your job.
OWNER
The user ID that owns the job.
STATUS
The current job status. The status is one of the following:
INPUT
The job was received, but not run yet.
HELD The JCL specified that the job is to be put on hold.
ACTIVE
The job is running.
OUTPUT
The job has finished and has output to be printed or retrieved. For
each OUTPUT job, there are spool files that consist of JCL messages,
JES messages, initiator and terminator messages, and SYSOUT. For
jobs with a status of OUTPUT, the number of spool files for each job
is specified in the DIR display output.
CLASS
The job class.
These fields are followed by information about the job termination (if it has been
reached) or clarification of the status field. This information might include an
ABEND code, an indication of a JCL error, an indication that the job is held as a
DUP, or the maximum return code for the job in a 4-digit decimal field.
v For a TSO user the following additional fields are displayed:
STEPNAME
The procstepname for the logon procedure.
PROCNAME
The logon procedure.
CPUTIME
The total CPU seconds used.
ELAPSED TIME
The total elapsed time in seconds.
v For an individual job, these additional fields are displayed for each spool file:
ID The ID for the spool file being listed.
STEPNAME
The job step that generated the spool file.
PROCSTEP
The procedure stepname (if any) that generated the spool file.
C The SYSOUT class of the spool file.
DDNAME
The DDNAME associated with this spool file.
BYTE-COUNT
The total number of bytes in the spool file.

Receiving spool output
You can retrieve JCL messages, JES messages, initiator and terminator messages,
and SYSOUT data sets either individually or as a group.
Receiving individual spool files

Retrieving the spool files one at a time enables you to see whether a job ran
correctly before you retrieve the rest of the output, giving you greater control over
retrieving job information. If your FTP server is configured with
JESINTERFACELEVEL=2, then a DIR command displays the output job completion
code and the number and size of the job files. If JESINTERFACELEVEL=1, a DIR
command displays the number of the output job files.
To retrieve the spool output, use the FTP GET subcommand while in the
FILEtype=JES mode, specifying the job ID and the number of the spool file you
want.
You can specify a short form of the job ID by entering the letter J followed by a
4-digit or 5-digit job number. For example:
GET JOB05444.1 JOB05444.FILE1 (REPLACE
GET JOB05766.6 ASSEMBLY.FILE6
GET JOB06235.2 (REPLACE
GET JOB00275.4
GET J7438.3
In these examples, foreign_file is specified first, followed by local_file (on your client
machine) with the appropriate options, such as REPLACE. The first example
requests that the first spool file for JOB05444 be transmitted and replace the file on
your client named JOB05444.FILE1. The second command requests that the sixth
spool file for JOB05766 be transmitted to your client with the name
ASSEMBLY.FILE6.
If you have specified FILEtype=JES, you can use the MGET subcommand to
receive output from multiple jobs without specifying them one at a time. For
example, you can enter:
MGET parameter
The FTP client requires an MGET subcommand parameter. The parameter is

passed to the FTP server but is not used. The server returns all of the SYSOUT files
for all the jobs in the HELD queue for your user ID for FTP servers configured for
JESINTERFACELEVEL=1. For JESINTERFACELEVEL=2, all jobs that match the
filters JESJOBNAME, JESOWNER and JESSTATUS are retrieved whether they are
in the HELD queue or not. Note that the JESJOBNAME and JESOWNER SITE
parameters allow wildcards (*,?). When using the MGET subcommand the
JESOWNER value should be OUTPUT.
Notes:
1. On an MVS FTP server, local_file must be specified.
2. Truncation can cause a loss of data.
3. A GET command performed on an empty data set erases the contents of the
existing local data set.
4. Receiving the output of a job does not remove the job output from the queue.
To remove the job output from the queue, you must issue a DELETE command.
Receiving a group of spool files
To retrieve all the spool files associated with the same job simultaneously into the
same destination file, specify:
GET jobid.x
where x can be uppercase or lowercase. All the spool files are transferred together
and put into file jobid.x. The following line appears between each retrieved JES
spool file:
!! END OF JES SPOOL FILE !!
This enables you to easily find the end of each spool file.
You can also specify a data set name to send the files to, such as:
GET jobid.x data_set_name
All the spool files are put into the file named file.name. This eliminates the need
to retrieve each spool file separately. For example,GET J3456.X retrieves all the
spool files for JOB03456 and puts them in a file named J3456.X.
The command MGET with any parameter produces the same results as issuing
GET jobid.x commands for each job that is associated with your user ID.
Notes:
1. In JES2 (if JESINTERFACELEVEL=1), the spool files retrieved by GET and
tallied by DIR must be in a hold queue (commonly class=H).
2. In JES3 (if JESINTERFACELEVEL=1), the spool files must be in a hold queue
reserved for external writers. Ask your system programmer for the class that
says (HOLD=EXTWTR) in the JES3 installation stream.
3. The maximum record length that can be received at the server is 254 characters
before the record is truncated.
4. Receiving the output of a job does not remove the job output from the queue.
To remove the job output from the queue, you must issue a DELETE command.
Deleting a job
You can delete a job before or during execution, or you can delete the output of a
job before you have retrieved it. You do this by using the DELETE subcommand
while in the FILEtype=JES mode and the job ID. You can specify either the
8-character job ID or a short form of the job ID by entering the letter J followed by
a 1 to 7-digit job number. For example,
DELETE JOB05444
DELETE J3672
When you issue the DELETE command, all spool output related to a job is deleted.
The host returns the message CANCEL SUCCESSFUL after it deletes the job.
Steps for submitting a job and automatically receiving output

You can submit a job using FTP and automatically receive your output. Rather
than using the JCL you built on the FTP client, this function uses the JCL you have
built on the FTP server. Automatic retrieval of jobs works only if the file contains a
single job. It does not work for files that include more than one job (multiple JOB
cards.

Perform the following steps to submit a job using FTP.
1. Create the JCL and data that you want to submit and save it on the MVS host
where the FTP server resides.
The JCL can reside in a sequential data set, or partitioned data set, or z/OS
UNIX file. If JESINTERFACELEVEL=1, then the job name in the JCL must be
USERIDx, where x is a 1-character letter or number. Additionally, the output
class for any data sets you wish to retrieve (MSGCLASS or SYSOUT files)
contained in your JCL must specify a JES HOLD output class. If
JESINTERFACELEVEL=2, then the JESJOBNAME and JESJOBOWNER must
match the jobname and jobowner. Additionally, JESSTATUS must be set to ALL
or OUTPUT and the logged in FTP user ID must have access to
nodeid.userid.jobname.jobid.
_________________________________________________________________
2. Start a session with the FTP server on the MVS system to which you want to
submit the job.
_________________________________________________________________
3. After you have entered your user ID and password, specify that you want to
interface to JES with a site parameter by entering the following:
SITE FILEtype=JES
_________________________________________________________________
4. Submit the JCL file you have created by entering the following command:
GET jclfilename.jclfiletype outputfilename.outputfiletype
The outputfilename.outputfiletype defines the data set at the FTP client site that is
to contain the HELD job output when the job completes.
_________________________________________________________________
The MVS FTP server reads the data set jclfilename.jclfiletype and submits it to the
JES internal reader.
You know you are done when you see the following replies. The next two replies
indicate that the job has been submitted and the MVS FTP server is waiting for it
to complete. The third reply indicates that the job has finished and the files have
been copied to your output data set:
125 Submitting job outputfilename.outputfiletype FIXrecfm 80
125 When JOB05125 is done, will retrieve its output250 Transfer completed successfully.
Note: When submitting a job and automatically receiving the output, remember
that your session is suspended. You should use care, based on the
anticipated run time of your job, when using this function. If your session
times out, you must restart FTP and manually retrieve your output. Session
timeouts are caused by the following:
v The FTP Server does not wait long enough for the job that is executing to
end. Increase the JESPUTGETTO interval in the FTP.DATA data statement
on the server. This defaults to 10 minutes and defines the amount of time
FTP waits for the submitted job to complete before timing out.
v The FTP client does not wait long enough for the job to complete and the
server to retrieve the output. Increase the DATACTTIME timer value in
the client. This defaults to two minutes and defines the amount of time
the client waits for a response from the server.
v FTP client and FTP Server receive resets. This is usually caused by a
firewall that timed out the session because of a lack of activity. Add an
FTPKEEPALIVE statement or decrease the time interval on the current
FTPKEEPALIVE statement in the FTP.DATA data file. The keepalive value
on FTPKEEPALIVE must be less than the expected value of the server.
Terminating access to JES

The FTP default for FILEtype is SEQ. When you want to end access to JES and
return to FTP in its normal file transfer mode, specify the following:
SITE FILEtype=SEQ
JESINTERFACELEVEL differences
The FTP JESINTERFACELevel 2 allows increased functionality for users over that
available with JESINTERFACELevel 1. Jobs allowable by the system (JESSPOOL
RACF class) whether they are in held or nonheld output class can be viewed.
Information about jobs such as held/dup for jobs on the internal reader, CPU time
of running jobs, and number of sysout data sets for completed jobs can be
displayed.
If the user does a DIR subcommand without any operands, the display shows
matches of the search criteria — one line per task. If the user does a DIR
subcommand for a specific JOBID, the status of the job is listed and, if the status is
OUTPUT, it lists information about all the sysout data sets created by this job (and
available in the JES spool data set at the time of access). If a JOBID is supplied and
the job is active, it lists information about the job step name, cpu busy, and elapsed
time.
Whenever a DIR subcommand is executed (with or without arguments), the

JESJOBNAME, JESENTRYLIMIT, JESOWNER and JESSTATUS filter keywords can
be used to limit the number of entries that are returned to the user. A DIR
subcommand with all JES keywords set to their default and JESOWNER set to
USER1 returns information about all batch jobs that have USER1 registered as
OWNER. If the value of JESOWNER is set to empty (space), it defaults to the
logged-in user ID.
v To list jobs for all users, a value of JESOWNER=* must be specified. If the value
of JESJOBNAME is set to empty (space), it defaults to the logged-in user ID
suffixed with an asterisk (if user is USER1, then JESJOBNAME defaults to
USER1*).
v To list all job names, a value of JESJOBNAME=* must be specified. If the value
of JESSTATUS is set to empty, it defaults to all types of output.
v To list only the completed jobs, specify a value of JESSTATUS=OUTPUT.
The subcommands DIR, LS, MDELETE, and MGET allow wildcard (*) filtering on
a specific jobid only if JESINTERFACELevel 2 is active. A DIR subcommand results
in the use of the LIST FTP command. An LS, MDELETE, or MGET subcommand
results in the use of the NLST FTP command.
The following table summarizes the behavior of the different levels of

JESINTERFACELevel. The term matching filters means all jobs that match
parameters of JESJOBNAME, JESOWNER, JESSTATUS, and up to the
JESENTRYLIMIT entries.
Subcommand JESINTERFACELevel 1 JESINTERFACELevel 2

DIR [*] All jobs All Jobs matching filters
DIR Jxx All jobs (Jxx ignored) Details for Jxx (*)
LS All jobids All jobids matching filters

Subcommand JESINTERFACELevel 1 JESINTERFACELevel 2
LS Jxx with wildcards All jobids All Jobs matching filters (*)
LS Jxx no wildcards All jobids (Jxx ignored) All Jxx.nnn sysout ds names
matching filters (*)
GET Jxx.1 [local-file] Return single sysout file Return single sysout file
GET Jxx.x [local-file] All Jxx sysout files in one file All Jxx sysout files in one file
with separators with separators
MGET * One file per job - each file One file per job matching
with separators - local file filters - each file with
names default to jobids separators - local files names
default to jobids
MGET jxx As MGET * (Jxx ignored) One file per job matching
filters - each file with
separators - local file names
default to Jxx.nnn (*)
DELETE Jxx Jxx deleted Jxx Deleted
DELETE Jxx.1 Not supported Not supported
MDELETE * All jobs deleted All jobs matching filters
deleted
GET jclds outfile Server jclds submitted, all Server jclds submitted, all
output returned in outfile output returned in outfile
with separators with separators
JESINTERFACELevel 2 returns different entries from JESINTERFACELevel 1 with

wildcard (*) filtering, assuming the default values are used for the JESOWNER,
JESJOBNAME, and JESENTRYLimit plus JESSTATUS=OUTPUT. The format of the
returned data might also be different.
FILETYPE=JES parameters on DIR, LS and MGET subcommands allow an asterisk

(*) for all job IDs, or a specific job ID. If a job ID is specified, but no such job ID
exists, an error reply is returned to the client.
The NLST command is used under the covers for MGET and MDELETE to obtain
lists of the resource names to issue individual GET or DELETE subcommands
against. For job IDs, the list is simply a list of JES job IDs. For sysout data set IDs,
the list is a list of JES job IDs suffixed with sysout data set numbers — in the same
syntax that is supported by the GET and DELETE subcommands.
LIST, NLST, MDELETE, and MGET all show different behaviors for
JESINTERFACELevel 2 over JESINTERFACELevel 1. This is because LIST and
NLST use the filters for JESINTERFACELevel 2, and the commands DIR, LS,
MDELETE, and MGET use LIST and NLST.
v For job IDs, an NLST command returns:
JOB00013
JOB00034
STC00067
v For sysout data set IDs, an NLST command returns:
JOB00013.1
JOB00013.2
JOB00013.3
JOB00013.4
JES security
If FTP.DATA does not set the JESINTERFACELevel to 2, the FTP server behaves as
in releases prior to z/OS Communications Server level V2R10. FTP clients are
allowed to submit jobs to JES, retrieve held output that matches their logged in
user ID plus one character, and delete held jobs that match their logged in user ID
plus one character.
If JESINTERFACELevel is set to 2, then FTP clients have the ability to retrieve and
delete any job in the system permitted by the Security Access Facility (SAF)
resource class JESSPOOL. For that reason, JESINTERFACELevel=2 should be
specified only if the proper JES and SDSF security measures are in place to protect
access to JES output. The SAF controls used for JESINTERFACELevel=2 are
essentially a subset of those used by SDSF. Therefore, if an installation has
customized SAF facilities for SDSF, then they are configured for FTP JES level 2.
Before customizing the FTP-to-JES interface, you must complete JES customization.
For example, JESJOBS is an SAF class that controls which users can submit jobs to
JES. JESSPOOL is the SAF class that controls which users can access output jobs.
Customize these SAF classes before beginning customization of the FTP-to-JES
interface.
JESSPOOL defines resource names as <nodeid>, <userid>, <jobname>, <Dsid>,

<dsname>. An FTP client can delete an output job if it has ALTER access to the
resource that matches its nodeid, userid, and job name. If the FTP client has READ
access to the resource, it can list, retrieve, or GET the job output.
(JESINTERFACELevel 2 uses the SAPI interface to JES, so READ authority is
required to list job status or retrieve job output.) See the z/OS JES2 Initialization and
Tuning Guide for more information on JES security. See z/OS MVS Using the
Subsystem Interface for more information on the SAPI interface.
Changing JESSTATUS, JESOWNER, and JESJOBNAME

There are three filters used by the FTP server to control the display of jobs:
v JESSTATUS
v JESOWNER
v JESJOBNAME
JESSTATUS can be changed by an FTP client using the SITE command to filter jobs
in INPUT, ACTIVE, or OUTPUT state. The SDSF resources checked for these states
are ISFCMD.DSP.INPUT.jesx, ISFCMD.DSP.ACTIVE.jesx, and
ISFCMD.DSP.OUTPUT.jesx, respectively. At login time (USER command), the
default value is set to ALL if READ access is allowed to all three classes. Otherwise
it attempts to set it to OUTPUT, ACTIVE, and then INPUT if the appropriate
READ access is allowed. If no READ access is allowed to any of the classes,
JESSTATUS is set to OUTPUT but JESOWNER and JESJOBNAME cannot be
changed from the default. In this way, SAF controls can be put in place to limit
FTP clients to whatever status of jobs an installation requires.
At login time, JESOWNER has the value of the logged in user ID. Authority to
change JESOWNER is obtained by READ access to RACF profiles
ISFCMD.FILTER.OWNER. An FTP client with READ access to
ISFCMD.FILTER.OWNER is allowed to change the JESOWNER parameter using the
SITE command.
At login time, JESJOBNAME has the value of the logged in user ID plus an
asterisk (*). Authority to change JESJOBNAME is obtained by READ access to

RACF profile ISFCMD.FILTER.PREFIX. An FTP client with READ access to
ISFCMD.FILTER.PREFIX is allowed to change the JESJOBNAME parameter using
the SITE command.
If a user is not authorized to the appropriate ISFCMD.DSP.<status>.jesx, any SITE

JESSTATUS command is rejected with a reply:
200 User xxxxxxx is not authorized to filter on JESSTATUS, JESSTATUS remains
xxxxxxx
If a user is not authorized to filter on JESOWNER, any SITE JESOWNER command

is rejected with a reply:
200 User xxxxxxx is not authorized to filter on JESOWNER, JESOWNER remains
xxxxxxx
If a user is not authorized to filter on JESJOBNAME, any SITE JESJOBNAME

command is rejected with a reply:
200 User xxxxxxx is not authorized to filter on JESJOBNAME, JESJOBNAME remains
xxxxxxx*
Displaying the status of jobs (LIST and NLST)

No security checks are made when returning information to the user on an NLST
or LIST (DIR, MGET, or MDELETE) command that has a wild card character of *
or ? for a jobid. The filter variables were reset when the user connection was made.
Any attempts to change them caused the appropriate security check to be made.
When a user issues a DIR command for a specific jobid, a check for READ access
to JESSPOOL resource nodeid.userid.jobname.jobid is made. This check is
performed to prevent a different user (one who happens to know a jobid of
another user’s job) from obtaining status information, even though the user was
not allowed to filter on OWNER. If a user is not allowed READ access, the
following reply is sent:
550 RETR fails: nodeid.ownerid.jobname.jobid. User not authorized.
Browsing of SYSOUT data sets

When a SYSOUT data set is requested for transfer to the FTP client, the server
checks JESSPOOL resource nodeid.userid.jobname.jobid.Dsid.dsname for READ
access. If a user is not allowed READ access to the resource, the following reply is
sent:
550 RETR fails: nodeid.ownerid.jobname.jobid. User not authorized.
Deleting/purging of SYSOUT data sets

When an FTP client requests to delete a SYSOUT data set, the server checks
JESSPOOL resource nodeid.userid.jobname.jobid.Dsid.dsname for ALTER access.
If a user is not allowed ALTER access to the resource, the following reply is sent:
550 DELE fails: nodeid.ownerid.jobname.jobid. User not authorized.
JES examples
The following example shows the JCL file USER121.JCL.CNTL(SMFALL) being
submitted to the JES. Before FTP commands are issued, only the data set
USER121.FTP.EXAMPLE exists on MVSXA2.
User: ftp 9.67.113.24 621
System:
IBM FTP CS V1R5
FTP: using TCPCS
FTP.DATA FILE NOT FOUND. USING HARDCODED DEFAULT VALUES.
220-FTPSERVE IBM FTP CS V1R2 at MVSVIC03.TCP.RALEIGH.IBM.COM,
19:03:
on 2003-01-17
User: user121
System:
>>>USER user121
Password:
>>>PASS ********
230 user121 is logged on. Working directory is "/u/user121".
Command:
User: site file=jes

System:
>>>SITE file=jes
Command:
User: put ’user121.jcl.cntl(mvsjob)’
System:
>>>SITE FIXrecfm 80 LRECL=80 RECFM=FB BLKSIZE=27920
>>>PORT 9,67,112,25,4,37
>>>STOR ’user121.jcl.cntl(mvsjob)’
125 Sending Job to JES Internal Reader FIXrecfm 80
250-It is known to JES as JOB02189.
Command:
User: dir
System:
>>>PORT 9,67,112,25,4,38
>>>LIST
USER121A JOB00067 INPUT
Command:
User: dir
System:
>>>PORT 9,67,112,25,4,39
>>>LIST
USER121A JOB00067 ACTIVE
Command:
User: dir
System:
>>>PORT 9,67,112,25,4,40
>>>LIST
USER121A JOB00067 OUTPUT 4 Spool Files
Command:

User: lcd ’user121.ftp.example.’
System:
Local directory name set to USER121.FTP.EXAMPLE.
Command:
User: lpwd
System:
Local directory is USER121.FTP.EXAMPLE.
Command:
User: dir
System:
>>>PORT 9,67,112,25,4,41
>>>LIST
USER121A JOB00067 OUTPUT 4 Spool Files
Command:
User: get job00067.x spoolall
System:
>>>PORT 9,67,112,25,4,42
>>>RETR job00067.x
125 Sending all SPOOL files for requested JOBID.
Command:
User: get job00067.1 spool1

System:
>>>PORT 9,67,112,25,4,43
>>>RETR job00067.1
125 Sending data set USER121.USER121A.JOB00067.D000002.JESMSGLG
Command:
System:
>>>PORT 9,67,112,25,4,44
>>>RETR job00067.3
125 Sending data set USER121.USER121A.JOB00067.D000003.JESYSMSG
Command:
System:
>>>PORT 9,67,112,25,45
>>>RETR job00067.3
125 Sending data set USER121.USER121A.JOB00067.D000004.JESYSMSG
Command:
System:
>>>PORT 9,67,112,25,46
>>>RETR job00067.4
125 Sending data set USER121.USER121A.JOB00067.D000103.?
Command:
System:
>>>PORT 9,67,112,25,47
>>>RETR job00067.5
550 Index 5 is greater than number of spool files for JOB00067
Command:
User: dir
System:
>>>PORT 9,67,112,25,4,50
>>>LIST
user121A JOB00067 OUTPUT 4 Spool Files
Command:
User: delete job00067
System:
>>>DELE job00067
250 Cancel Successful
Command:
User: dir
System:
>>>PORT 9,67,112,25,4,51
>>>LIST
No jobs found on Held queue
Command:
User: site filetype=seq
System:
>>>SITE filetype=seq
Command:
User: quit
System:
>>>QUIT
READY
After executing the FTP commands, the following data sets now exist on MVSXA2:
USER121.FTP.EXAMPLE.SPOOLALL
USER121.FTP.EXAMPLE.SPOOL1
Note: In most situations, the INPUT status is too fast to be captured by issuing
DIR. However, if the ACTIVE or OUTPUT status of the job is captured, the
INPUT status has been passed successfully.
The following are examples displayed by the shown DIR command.
DIR with JESJOBName=* JESOwner=* JESSTATUS=ALL JESENTRYLimit=200 shows all

jobs in the system.

DIR
JOBNAME JOBID OWNER STATUS CLASS
USER1 TSU00017 USER1 INPUT A
USER1A JOB00001 USER1 INPUT A -HELD-
USER1A JOB00002 USER1 INPUT A -DUP-
USER2B JOB00022 USER2 ACTIVE D STEP=STEPNAME PROC=PROCSTEP CPUT= 7.27 ELAPT= 7.27
*MASTER* STC00002 +MASTER+ ACTIVE STEP= PROC= CPUT= 7.48 ELAPT= 7.48
USER3A JOB00061 USER3 OUTPUT D 3 spool files RC=0000
USER4A JOB00070 USER4 OUTPUT D 17 spool files ABEND=0806
DIR with JESJOBName=* JESOwner=USER1 JESSTATUS=ALL JESENTRYLimit=200 shows

all jobs owned by USER1
DIR
DIR with JESJOBName=* JESOwner=USER14 JESSTATUS=ALL JESENTRYLimit=200

shows all jobs owned by USER14
DIR
250 No tasks found for JESJOBName=*, JESSTATUS=ALL and JESOwner=USER14
DIR T* with JESJOBName=* JESOwner=USER1 JESSTATUS=ALL JESENTRYLimit=200

shows all TSO jobs.
DIR T*
DIR with JESJOBName=* JESOwner=* JESSTATUS=ALL JESENTRYLimit=5 shows the

first 5 jobs in the system
DIR
USER2B JOB00022 USER2 ACTIVE D STEP=STEPNAME PROC=PROCSTEP CPUT= 7.27 ELAPT= 7.27
*MASTER* STC00002 +MASTER+ ACTIVE STEP= PROC= CPUT= 7.48 ELAPT= 7.48
JESENTRYLIMIT of 5 reached. Additional entries not displayed
If JESINTERFACELevel is set to 2, the DIR or LIST command for a specific jobid

allows you to display specific SYSOUT data sets.
DIR JOB00061 with JESJOBName=* JESOwner=* JESSTATUS=ALL JESENTRYLimit=5

displays SYSOUT data sets from JOB00061.
DIR JOB00061
ID STEPNAME PROCSTEP C DDNAME REC-COUNT COMMENT
001 JESE H JESMSGLG 18
002 JESE H JESJCL 11
003 A JESYSMSG 22
If JESINTERFACELevel is set to 2, then the GET command should produce results
similar to those below (JESJOBName=* JESOwner=* JESSTATUS=ALL
JESENTRYLimit=200 displays SYSOUT data sets from JOB00061).
DIR JOB00061
003 A JESYSMSG 22
DIR ’JOB00061.1’
GET JOB00061.1
1012 bytes transferred in 0. 40 seconds. Transfer rate 25.30 Kbytes/sec.
GET ’JOB00022.1’ (REP
If JESINTERFACELevel is set to 2 then the MGET subcommand should produce

results similar to those below, which are identical to the GET of just the JOB00061.
At the end of each SYSOUT data set of a MGET, the following line is stored:
!! END OF JES SPOOL FILE !!
JESJOBName=* JESOwner=* JESSTATUS=ALL JESENTRYLimit=200 displays SYSOUT

data sets from JOB00061.
DIR JOB00061
003 A JESYSMSG 22
MGET JOB00061.*
125 Sending all spool files for Jobid JOB00061
If MGET is specified with an asterisk, it works the same as in JESINTERFACELevel

1. MGET gets all jobs that match the JES filters. Also, in the example below, there
are two input jobs for user1, no active jobs, and three output jobs. Care should be
taken with the JES filters because an MGET from the client actually appears to the
server as an NLST followed by several GETs. For example, if JESSTATUS is set to
ALL and there are many jobs returned in the NLST that are in ACTIVE or INPUT
status, then the MGET will not retrieve the number of output files expected and
there will be no message that "250 No tasks found for JESJOBName...".
(JESJOBName=* JESOwner=USER1 JESSTATUS=ALL JESENTRYLimit=1024.)

DIR
USER1 JOB00022 USER1 ACTIVE D STEP=STEPNAME PROC=PROCSTEP CPUT= 7.27 ELAPT= 7.27
USER1B JOB00070 USER1 OUTPUT D 5 spool files RC=0000
USER1C JOB00070 USER1 OUTPUT D 17 spool files ABEND=0806
MGET JOB00061.*
125 Sending all spool files for Jobid JOB00061
SITE JESENTRYLIMIT=2
DIR
USER1 JOB00022 USER1 ACTIVE D STEP=STEPNAME PROC=PROCSTEP CPUT= 7.27 ELAPT= 7.27
JESENTRYLIMIT of 2 reached. Additional entries not displayed.
Note that the DIR showed jobs TSU00017 and JOB00022, but the MGET is not able
to retrieve them.
MGET
550 No spool files available for TSU00017
550 No spool files available for JOB00022
SITE JESSTATUS=OUTPUT
DIR
USER1B JOB00070 USER1 OUTPUT D 5 spool files RC=0000
MGET
125 Nlst started OK
250-JESENTRYLIMIT of 2 reached. Additional entries not received
250 Nlst completed successfully
125 Sending all spool files for requested Jobid JOB00061

125 Sending all spool files for requested Jobid JOB00070

Performing DB2 SQL queries with FTP

FTP enables you to submit a Structured Query Language (SQL) SELECT query to
the DB2® subsystem and receive the results of the SQL query. FTP can perform this
function as either the server or the client.
For information about installing the SQL query function for the FTP client or
server, see the z/OS Communications Server: IP Configuration Reference.
SQL data types supported by FTP

FTP access to SQL supports the following data types:
v DATE
v TIME
v TIMESTAMP
v VARCHAR (variable length, up to 254 characters)
v CHAR (fixed length, up to 254 characters)
v DECIMAL
v INTEGER (full word)
v SMALLINT (half word)
v FLOAT (single or double precision)
v LONG VARCHAR (VARCHAR(n), where n is greater than 254)
v GRAPHIC
v VARGRAPHIC
v LONG VARGRAPHIC
Mixed data (double-byte character set and single-byte character set) is supported in
CHAR, VARCHAR, and LONG VARCHAR data types, but column alignment in
the output file might not be maintained.
Creating the input data set

Before performing a DB2 SQL query using FTP, you must create an MVS data set
that contains the SQL query you want to perform.
You can create queries on the client and use the FTP PUT command to send the
queries to the MVS system to be processed. Or, you can prepare a group of SQL
queries on the MVS system and perform them regularly.
Note: FTP can process only one SQL query per file.
For example, a data set on an MVS system named userid.SQL.IN contains the
following SQL query:
SELECT LASTNAME, EMPID, YEARS_EMPLOYED FROM EMPLOYEE_TABLE
WHERE YEARS_EMPLOYED > 25
You either created that data set on the MVS system with TSO, or you used the FTP
PUT command to put the data set on the MVS system.
Setting the characteristics for the SQL query

After creating a data set to use for your query, you must log on to FTP and set the
file type for the query:
SITE/LOCSITE FILEtype=SQL
There are several commands that are relevant to the client and server in SQL
mode. The server commands use SITE, and the client commands use LOCSITE.
The following list describes the commands:
SITE/LOCSITE DB2=
Specifies the name of the DB2 subsystem that you want to perform your
queries. See “Specifying the DB2 subsystem to perform the query” on page 131
for more information about DB2 subsystems.
SITE/LOCSITE SPRead or NOSPRead
Specifies whether you want the output to be in spreadsheet or report format.
See “Specifying the output format” on page 132 for more information about
output format.
SITE/LOCSITE SQLCol=

Specifies whether you want the column headings to use the DB2 column names
or labels. Valid values include Names, Labels, or Any. See “Assigning column
headings for the SQL query result table” for more information about column
headings.
To return to normal FTP processing after performing queries, or other processes,

specify:
SITE/LOCSITE FILEtype=SEQ
On MVS systems, RECfm=VB is a recommended format that enables you to view

the results of the SQL query. Issue the following command to specify that new data
sets should be created with the RECfm=VB attribute:
SITE/LOCSITE RECFM=VB
To prevent the automatic sending of a SITE command that might override your
SITE setting, toggle SENDSITE to OFF. For more information about the SENDSITE
command, see “SENDSite subcommand—Toggle the sending of site information”
on page 269.
Specifying the DB2 subsystem to perform the query

An MVS system can run several DB2 systems simultaneously, each known by a
subsystem name of up to four characters. For example, you can have a DB2 test
system called DB2T and a DB2 production system called DB2P.
FTP connects to a DB2 system to have it execute a DB2 query. You can specify
what DB2 system FTP should connect to with the following SITE or LOCSITE
parameter:
SITE/LOCSITE DB2=
For example, if you want the FTP server to have the DB2T system perform your
queries, specify:
SITE DB2=DB2T
If you want the FTP client to have the DB2P system perform your queries, specify:
LOCSITE DB2=DB2P
The default DB2 system name is DB2. You can change the default with the DB2
parameter in the FTP.DATA data set. See “Changing local site defaults using
FTP.DATA” on page 70 for more information about the FTP.DATA data set.
Assigning column headings for the SQL query result table

When you create a DB2 table, you can assign descriptive labels to the table
columns. For example, a column name could be XCM554, but the label could be
WEEKLY PAY. For information about assigning names and labels, see the DB2
DESCRIBE statement in the DB2 SQL Reference.
The SQLCol parameter of the SITE command enables you to specify whether you
want names or labels to appear at the top of the columns in your output file. The
default value is Names. Issue the following command if you want a database
column name to appear at the top of each column in your output file:
SITE/LOCSITE SQLCol=Names
Issue the following command if you want a label to appear at the top of each
column:
SITE/LOCSITE SQLCol=Labels
If you specify the Labels parameter, and a column in your query does not have a
label defined in the database, the FTP server supplies a column heading. For more
information about column headings, see “FTP-supplied column headings.”
Issue the following command if you want either a label or a name to appear at the
top of each column:
SITE/LOCSITE SQLCol=Any
If you specify the Any parameter, the label appears as the column heading.
However, if the column does not have a label, the name appears at the top of the
column.
FTP-supplied column headings

The FTP client and server provide column headings in the result table when DB2
does not. This occurs when a result table contains expression columns or when
labels are requested and a database column that appears in the result table does
not have a label defined.
FTP builds a column heading for expression columns. For example,

Select employee, salary/52 from ABC.Staff
results in two columns. The first column gets its name from DB2, while the second
column is built by the server. The server uses the heading COL002 for the second
column because it supports the SQL limit of 750 columns.
Specifying the output format

You have two choices for the format of your output data set: spreadsheet format
and report format. The default is NOSPRead (report format), but you can change
the default for your FTP server by changing the FTP.DATA data set. See “Changing
local site defaults using FTP.DATA” on page 70 for more information.
Spreadsheet Format: You can have the output of the SQL query formatted to load
directly into a spreadsheet program running on a PC or a workstation. To get the
spreadsheet format, issue the following command:
SITE SPRead or LOCSITE SPRead
The SPRead format option puts a TAB character before the first character of each
column entry, except the first column. See your spreadsheet program
documentation for instructions about how to import the output of the SQL query.
Report Format: The NOSPRead format option puts one or more blank spaces
between the columns, and it lists the SQL query, the column headings, and the
resulting columns. Each section is separated with horizontal dashed lines. An
output data set in NOSPRead, or report, format is easier to view and print.
To get the report format, issue the following command:

SITE NOSPRead or LOCSITE NOSPRead

The following is an example of the results contained in the NOSPRead format of
the SQL.OUTPUT data set.
s---------+---------+---------+---------+---------+--------+---------+
SELECT * FROM DB2USER.PHONES
WHERE FIRSTNAME LIKE ’BILL%’
OR FIRSTNAME LIKE ’WILL%’
h---------+---------+---------+---------+---------+---------+---------+
LASTNAME FIRSTNAME TIE EXT ALT DEPT ROOM NODE
d---------+---------+---------+---------+---------+---------+---------+
ACKERMAN BILL 893 6266 7813 431 J2-A22 IBMABC
ADAMS WILLIAM J. 892 2202 1716 681 33-943 IBMABC
ASTERMAN WILLIAM C. 893 7244 7813 222 J4-A44 IBMVM2
BENDER WILLIAM R. 892 4217 4766 490 45-556 IBMVM2
A lowercase letter in the first position of each dashed line specifies what part of
the output follows, enabling a program to read and interpret the contents. For
example, s indicates that the SQL query follows, h indicates a header, d indicates
that the rest of the data set is the actual data, and e indicates that an error message
follows.
The width of the output data set depends on the width of the results from the DB2
query.
Submitting the query

After you have created a data set that contains an SQL query, logged on to FTP,
and set the appropriate SITE or LOCSITE parameters, you are ready to execute the
contents of the data set. You can do this from either an FTP client or an FTP server.
Performing an SQL query from an FTP client

To have the FTP client perform SQL queries and have the results sent to an FTP
server, specify:
LOCSITE FILEtype=SQL
Next, perform a PUT command specifying the name of the file on the client that
contains the SQL query.
For example, if the client has a file named userid.SQL.IN that contains an SQL
query, you can specify:
PUT SQL.IN SQL.OUT
The FTP client then submits the query found in SQL.IN to the DB2 subsystem on
the client and sends the resulting rows of output to the server to be put into
SQL.OUT on the server.
To return to normal FTP processing, specify:

LOCSITE FILEtype=SEQ
Performing an SQL query from an FTP server

To have the FTP server perform the query and have the results sent to the client,
specify:
SITE FILEtype=SQL
Then perform a GET command specifying the name of the file on the server that
contains the SQL query.
For example, if the server has a file named userid.SQL.IN that contains an SQL
query, you can specify:
GET SQL.IN SQL.OUT
The FTP server then submits the query found in SQL.IN to the DB2 subsystem on
the server and sends the resulting rows of output to the client to be put into
SQL.OUT on the client.
Examples of SQL query output

This section shows examples of SQL query output using different options.
With NOSPRead and SQLCol=Names

The following output is from a query using NOSPRead and SQLCol=Names.
s--------+---------+---------+---------+---------+---------+---------+---------+
SELECT EMPLOYEE,AGE
FROM ABC.STAFF
WHERE AGE < 60
h--------+---------+---------+---------+---------+---------+---------+---------+
EMPLOYEE AGE
d--------+---------+---------+---------+---------+---------+---------+---------+
Steve Jasinski 23
Alison Cook 22
With SPRead and SQLCol=Names

The following output is from a query with SPRead and SQLCol=Names.
Note: The period symbol (.) represents a TAB character.

EMPLOYEE .AGE
Steve Jasinski . 23
Alison Cook . 22
The following output examples are for the query:

SELECT DISTINCT ABC.STAFF.TLA, ABC.STAFF.SALARY
FROM ABC.STAFF, ABC.HOURS
WHERE (ABC.STAFF.TLA = ABC.HOURS.TLA) AND
(ABC.HOURS.TOTAL > 40)
With NOSPRead and SQLCol=Names

The following are output from queries using NOSPRead and SQLCol=Names.
s--------+---------+---------+---------+---------+---------+---------+---------+
h--------+---------+---------+---------+---------+---------+---------+---------+
TLA SALARY
d--------+---------+---------+---------+---------+---------+---------+---------+
ACO 20050.00
SJJ 19040.00
and
s--------+---------+---------+---------+---------+---------+---------+---------+
SELECT * FROM ABC.STAFF
h--------+---------+---------+---------+---------+---------+---------+---------+
EMPLOYEE TLA AGE SALARY
d--------+---------+---------+---------+---------+---------+---------+---------+
Steve Jasinski SJJ 23 28040.00
Alison Cook ACO 22 28040.00
Mark Ballam MFB 63 87420.55

With NOSPRead and SQLCol=Labels
The following output is from a query using NOSPRead and SQLCol=Labels.
s--------+---------+---------+---------+---------+---------+---------+---------+
h--------+---------+---------+---------+---------+---------+---------+---------+
EMPLOYEE’S INITIALS SALARY
d--------+---------+---------+---------+---------+---------+---------+---------+
ACO 20050.00
SJJ 19040.00
With NOSPRead and SQLCol=Any

The following output is from a query using NOSPRead and SQLCol=Any.
s--------+---------+---------+---------+---------+---------+---------+---------+
SELECT * FROM ABC.STAFF
h--------+---------+---------+---------+---------+---------+---------+---------+
EMPLOYEE EMPLOYEE’S INITIALS AGE SALARY
d--------+---------+---------+---------+---------+---------+---------+---------+
Steve Jasinski SJJ 23 28040.00
Alison Cook ACO 22 28040.00
Mark Ballam MFB 63 87420.55
Chapter 5. FTP subcommands
The FTP subcommands are listed in Table 20. The minimum abbreviation, a
description, and the link to each subcommand are also included. You must be in
the FTP environment to use the FTP subcommands. See “Using FTP” on page 29
for more information.
Table 20. FTP subcommands
? Provides information to use FTP. “HElp and ? subcommands—Display
help information” on page 186
! Passes a z/OS UNIX System “! subcommand—Invoke a z/OS
Services command to the local UNIX System Services function” on
z/OS shell. This command must be page 142
issued while using FTP in the z/OS
shell.
ACCount Sends host-dependent account “ACCt subcommand—Supply
information. account information” on page 143
APpend Appends a data set on your local “APpend subcommand—Append a
host to a file on the foreign host. local data set” on page 144
| AUth Requests a security mechanism for “AUth subcommand—Request
| the session. security mechanism” on page 147
AScii Sets the transfer type to ASCII. “AScii subcommand—Change the
data transfer type to ASCII” on page
146
BIG5 Sets the transfer type to BIG5. BIG “BIG5 subcommand—Change the
is the minimum abbreviation for data transfer type to BIG5” on page
BIG5. 148
BINary Sets the transfer type to IMAGE. “BINary subcommand—Change the
data transfer type to Image” on page
150
BLock Sets the data transfer mode to block “BLock subcommand—Set the block
mode. This is equivalent to data transfer mode” on page 151
specifying the MOde B
subcommand.
CCc Turns off integrity protection on the “CCc subcommand—Turn off
command channel. integrity protection” on page 152
CD Changes the working directory. “CD subcommand—Change the
directory on the remote host” on
page 153
CDUp Changes to the parent of the current “CDUp subcommand—Change to
working directory. the parent of the working directory”
on page 156
CLEar Sets the protection level for data “CLEar subcommand—Set the
transfers to CLEAR. protection level for data transfers to
CLEAR” on page 158
CLose Disconnects from the foreign host. “CLose subcommand—Disconnect
from a remote host” on page 159

Table 20. FTP subcommands (continued)
COMpress Sets the data transfer mode to “COMpress subcommand—Set the
compressed mode. This is compressed data transfer mode” on
equivalent to specifying the MOde page 160
C subcommand.
CProtect Sets the protection level on “CProtect subcommand— Set the
commands. CProtect CLEar is protection level on commands” on
equivalent to the CCc command. page 161
CWd Changes the working directory “CD subcommand—Change the
(Synonymous with CD). directory on the remote host” on
page 153
DEBug Enables or disables general internal “DEBug subcommand—Set general
tracing. trace options” on page 162
DELEte Deletes a single file on the foreign “DELEte subcommand—Delete files”
host. on page 166
DELImit Displays the delimiter character “DELImit subcommand—Display the
between the file_name and file_type. file name delimiter” on page 167
DIr Lists the directory entries for files “DIr subcommand—Obtain a list of
on the foreign host. directory entries” on page 168
DUMP Enables or disables extended “DUMP subcommand—Set extended
internal tracing. trace options” on page 173
EBcdic Sets the transfer type to EBCDIC. “EBcdic subcommand—Change the
data transfer type to EBCDIC” on
page 175
EUckanji Sets the transfer type to EUCKANJI. “EUckanji subcommand—Change the
data transfer type to EUCKANJI” on
page 176
FEature Queries FTP Server for features it “FEature subcommand—Query FTP
supports. server for features it supports” on
page 178
FIle Sets the file structure to file. This is “FIle subcommand—Set the file
equivalent to specifying the structure to File” on page 179
STRucture F subcommand.
Get Copies a file from the foreign host “Get subcommand—Copy files” on
to your local host. page 180
GLob Toggles globbing (the expansion of “GLob subcommand—Toggle
metacharacters in file names) for expansion of metacharacters” on
the MDelete, MGet, and MPut page 182
subcommands.
HAngeul Sets the transfer type to “HAngeul subcommand—Change
HANGEUL. the data transfer type to HANGEUL”
on page 184
HElp Displays help information for FTP. “HElp and ? subcommands—Display
help information” on page 186
Ibmkanji Sets the transfer type to IBMKANJI. “Ibmkanji subcommand—Change the
data transfer type to IBMKANJI” on
page 187
JIS78kj Sets the transfer type to JIS78KJ. “JIS78kj subcommand—Change the
data transfer type to JIS78KJ” on
page 188

JIS83kj Sets the transfer type to JIS83KJ. “JIS83kj subcommand—Change the
data transfer type to JIS83KJ” on
page 189
Ksc5601 Sets the transfer type to KSC5601. “Ksc5601 subcommand—Change the
data transfer type to KSC-5601” on
page 190
LANGuage Sets the language used for FTP “LANGuage subcommand—Set the
replies from the server. language used for FTP replies from
the server” on page 192
LCd Changes the current directory on “LCd subcommand—Change the
the local host. local working directory” on page 193
LOCSIte Specifies information that is used “LOCSIte subcommand—Specify site
by the local host to provide service information to the local host” on
specific to that host system. page 195
LOCSTat Displays FTP status information for “LOCSTat subcommand—Display
the local host. local status information” on page 218
LMkdir Creates a directory on the local “LMkdir subcommand—Create a
host. directory on the local host” on page
225
LPwd Displays the name of the active “LPwd subcommand—Display the
working directory on the local host. current working-level qualifier” on
page 228
LS Lists the names of files on the “LS subcommand—Obtain a list of
foreign host. file names” on page 229
MDelete Deletes multiple files on the foreign “MDelete subcommand—Delete
host. multiple files” on page 232
MGet Copies multiple files from the “MGet subcommand—Copy multiple
foreign host to your local host. files” on page 235
MKdir Creates a directory on the foreign “MKdir subcommand—Create a
host. directory on the remote host” on
page 239
MOde Specifies the mode or data format “MOde subcommand—Set the data
of the transfer. transfer mode” on page 242
MPut Copies multiple files on your local “MPut subcommand—Copy multiple
host to the foreign host. data sets to the remote host” on page
243
NOop Checks whether the foreign host is “NOop subcommand—Test the
still responding. connection” on page 246
Open Opens a connection to a foreign “Open subcommand—Connect to the
host. FTP server” on page 247
PAss Supplies a password to the foreign “PAss subcommand—Supply a
host. password” on page 248
PRIvate Sets the protection level for data “PRIvate subcommand—Set the
transfers to PRIVATE. protection level for data transfers to
PRIVATE” on page 249
Chapter 5. FTP subcommands 139

PROMpt Toggles interactive prompting for “PROMpt subcommand—Toggle
MDelete, MGet, and MPut interactive prompting for M*
commands. This function is similar commands” on page 250
to specifying the FTP command
with the -i option, which turns off
interactive prompting.
PROTect Sets the protection level for data “PROTect subcommand—Set the
transfers on the data connections. protection level for data transfers” on
page 251
PROXy Executes an FTP subcommand on a “PROXy subcommand—Execute FTP
secondary control connection. subcommand on secondary control
connections” on page 252
PUt Copies a file on your local host to “PUt subcommand—Copy data sets
the foreign host. to the remote host” on page 255
PWd Displays the name of the active “PWd subcommand—Display the
working directory on the foreign current working directory” on page
host. 257
QUIt Leaves the FTP command “QUIt subcommand—Leave the FTP
environment. environment” on page 258
QUOte Sends an uninterpreted string of “QUOte subcommand—Send an
data. uninterpreted string of data” on page
259
RECord Sets the file structure to record. This “RECord subcommand—Set the file
is equivalent to specifying the structure to record” on page 261
STRucture R subcommand.
REName Renames a file on the foreign host. “REName subcommand—Rename
files” on page 262
REStart Restarts a checkpointed data “REStart subcommand—Restart a
transfer. checkpointed data transfer” on page
263
RMdir Removes a directory. “RMdir subcommand—Remove a
directory on the remote host” on
page 264
SAfe Sets the protection level on data “SAfe subcommand—Set the
transfers to safe. protection level to safe” on page 265
SChinese Sets the transfer type to SCHINESE. “SChinese subcommand—Change
the data transfer type to SCHINESE”
on page 266
SENDPort Enables or disables automatic “SENDPort subcommand—Toggle
transmission of the FTP server the sending of port information” on
PORT command. page 268
SENDSite Enables or disables automatic “SENDSite subcommand—Toggle the
transmission of the SIte sending of site information” on page
subcommand. 269
SIte Sends information to the foreign “SIte subcommand—Send
host using site-specific commands. site-specific information to a host” on
page 270
SJiskanji Sets the transfer type to SJISKANJI. “SJiskanji subcommand—Change the
data transfer type to SJISKANJI” on
page 297

SRestart Restarts an interrupted stream “SRestart subcommand—Restart a
mode data transfer. stream data transfer” on page 299
STAtus Displays status information for the “STAtus subcommand—Retrieve
foreign host. status information from a remote
host” on page 301
STREam Sets the data transfer mode to “STREam subcommand—Set the
stream mode. This is equivalent to stream data transfer mode” on page
specifying the MOde S 308
subcommand.
STRucture Sets the file transfer structure. “STRucture subcommand—Set the
file structure” on page 309
SUnique Toggles the storage methods. “SUnique subcommand—Changes
the storage method” on page 310
SYstem Displays the name of the foreign “SYstem subcommand—Display the
host operating system. operating system name” on page 311
TChinese Sets the transfer type to TCHINESE. “TChinese subcommand—Change
the data transfer type to TCHINESE”
on page 312
TSO Passes a TSO command to the local “TSO subcommand—Use TSO
host TSO environment. commands” on page 314
TYpe Specifies the transfer type. “TYpe subcommand—Set the data
transfer type” on page 315
UCs2 Changes the data transfer type to “UCs2 subcommand—Change data
Unicode UCS-2. UC is the transfer type to Unicode UCS-2” on
minimum abbreviation for UCs2. page 319
User Identifies you to a foreign host or “User subcommand—Identify
changes your TSO user ID yourself to a host or change your
password. TSO user ID password” on page 320
Verbose Enables or disables verbose mode. “Verbose subcommand—Toggle
verbose mode” on page 322

! subcommand
! subcommand—Invoke a z/OS UNIX System Services function
Purpose
In a z/OS UNIX environment, use the ! subcommand to invoke z/OS UNIX
functions.
Format
!
shell_command
Parameters
shell_command
Specifying the ! subcommand with a shell command enables you to invoke
z/OS UNIX, perform the subcommand, and return to the FTP environment.
If no shell command is specified, the ! subcommand invokes z/OS UNIX.
There you can specify any number of shell commands before typing exit to
return to the FTP environment.

ACCt subcommand
ACCt subcommand—Supply account information
Purpose
Use the ACCt subcommand to supply account information to a host.
Format
ACCt account_information
Parameters
account_information
Specifies the account information required by the host. See your foreign-host
FTP server documentation for the information required by that host.
Usage
v The z/OS FTP server does not require any account information.
v You might have to use the ACCt subcommand when the foreign host requires
passwords for read and write access to its files or data sets. If you are not
prompted by the foreign host for the passwords, use the ACCt subcommand to
send these passwords to the foreign host.

APpend subcommand
APpend subcommand—Append a local data set
Purpose
Use the APpend subcommand to append a local data set to a remote host.
Format
APpend local_data_set destination_file
Parameters
local_data_set
The name of the data set on your local host to be appended.
destination_file
The name of the file on the remote host to which your data set is appended. If
the destination file does not already exist at the remote host, a new file is
created. If the server is a z/OS UNIX server, the local file can be appended to a
z/OS UNIX file or an MVS data set.
Examples
In the following example, an FTP command is issued from MVSXA2 to MVSXA3.
MVSXA2 has a data set MVSUSER.FTP.EXAMPLE with one member. The member,
APPEND01, contains:
;
; THIS FILE ORIGINALLY RESIDED IN MVSXA2, AND
; WILL BE APPENDED TO A FOREIGN FILE IN MVSXA3.
;
MVSXA3 has a data set, MVSUSER.FTP.EXAMPLE, with one member, APPEND02.

The member contains:
;
; THIS FILE ORIGINALLY RESIDED IN MVSXA3, AND
; WILL BE USED TO RECEIVE ANOTHER FILE FROM MVSXA2.
;
User: append
System: Usage: APPEND localfile foreignfile
Command:
User: lpwd
System: Local directory is MVSUSER.
Command:
User: append ’mvsuser.ftp.example(append01)’ ’mvsuser.ftp.example(append02)’

>>>PORT 1,1,2,2,4,16
>>>APPE ’mvsuser.ftp.example(append02)’
125 Appending to data set MVSUSER.FTP.EXAMPLE(APPEND02)
Command:

APpend subcommand
Usage
v FTP maintains the attributes of a data set that is transmitted between a client
and a server. However, when you use the APpend subcommand, FTP can
truncate data records and you might lose data. If the data set name already
exists at the receiving site and the logical record length (LRecl) of the data set at
the receiving site is less than the LRecl of the transmitted data set, FTP truncates
the transmitted data set.
v If the remote host is an MVS or VM host, and if the data set on the remote host
has a fixed-record format, the format and record length of the data set on the
remote host are always preserved.
v Records from the data set on your local host are truncated or padded with blank
spaces when necessary.
v To append to a file on a remote host, you must define a working directory on
that host, and you must have write privileges to the files in that directory.
v The z/OS FTP Server does not request that unused space be released from a
data set created during APPEND processing. If you are using the z/OS FTP
Server and wish for the Server to request that unused space be released on a
newly-created data set, use the PUT subcommand instead of APPEND.
Context
v See “CD subcommand—Change the directory on the remote host” on page 153
for more information about working with current directories.
v See Appendix A, “Specifying data sets and files,” on page 429 for more
information about naming conventions.
v APpend can be used with the PROXy subcommand to transfer files from a host
on a secondary connection to a host on a primary connection. See “PROXy
subcommand—Execute FTP subcommand on secondary control connections” on

AScii subcommand
AScii subcommand—Change the data transfer type to ASCII
Purpose
Use the AScii subcommand to change the data transfer type to ASCII.
Format
AScii
Parameters
Usage
Use the ASCII subcommand to direct FTP to translate outgoing files into ASCII
before sending them to the other host, and to convert incoming files from ASCII to
the file system code page before storing them.
Context
For more information about transfer methods, see Table 13 on page 55.

AUth subcommand
|
| AUth subcommand—Request security mechanism
| Purpose
| Use the AUth subcommand to request a security mechanism for the session.
| Format
| AUth security_mechanism
|
| Parameters
| security_mechanism
| The possible value is:
| TLS
| Request or reset TLS security for the session.
| Result: The server might not support the security mechanism that you specify,
| or it might not accept the security mechanism that you specify.
| Restrictions:
| v This subcommand is not valid with a TLSPORT implicit connection.
| v This subcommand is not valid during a TLS-secured session when
| TLSRFCLEVEL parameter is set to DRAFT. See “Using security mechanisms”
| on page 50 for more information.
| v This subcommand is not valid during a Kerberos-secured session.

BIG5 subcommand
BIG5 subcommand—Change the data transfer type to BIG5
Purpose
Use the BIG5 subcommand to change the data transfer type to BIG5.
MVS FTP uses the same SBCS translate table for single-byte or double-byte data
transfers. If you require an alternate SBCS table for a double-byte transfer, use the
SIte/LOCSIte SBDataconn or SIte XLate subcommand to have the server (or client)
change the SBCS translation for the data connection.
Format
BIG5
(
Ascii NOSo NOType
Sosi
Ebcdic
Space
Parameters
Sosi
Transferred data contains the shift-out and shift-in characters specified by one
of the following parameters – Ascii, Ebcdic, or Space. If no parameter is
specified, ASCII is used as the default.
If Sosi is not specified at all, shift-out or shift-in characters are not used in the
transferred data.
Ascii
When combined with the Sosi parameter, causes shift-out and shift-in
characters X'1E' and X'1F' to be used to delimit DBCS strings in ASCII
data.
Ebcdic
data.
Space
characters X'20' andX'20' (ASCII spaces) to be used to delimit DBCS strings
in ASCII data.
NOSo
Specifies that the data transferred is pure DBCS (data with no SBCS characters)
and is to be transferred to and from EBCDIC DBCS data that contains no
shift-out or shift-in delimiters.
NOType
Suppresses the sending of the corresponding TYpe command to the server. Use
this parameter when translation is to be performed by the FTP client only.

BIG5 subcommand
Usage
v The BIG5 client subcommand is equivalent to the TYPE B 8 command.
v The minimum abbreviation for BIG5 is BIG.
Context
See “FTP with traditional DBCS support” on page 87 and “Support for MBCS
languages” on page 90 for more information.

BINary subcommand
BINary subcommand—Change the data transfer type to Image
Purpose
Use the BINary subcommand to change the data transfer type to image (binary).
Format
BINary
Parameters
Usage
Use the image transfer type to transfer files between client and server without any
translation of the file data. When using the image transfer type, data is sent as
contiguous bits packed into 8-bit bytes. Use the image transfer type for efficient
storage and retrieval of data sets or files, and for the transfer of binary data.
Context
For more information about data transfer methods, see Table 13 on page 55.

BLock subcommand
BLock subcommand—Set the block data transfer mode
Purpose
Use the BLock subcommand to set the data transfer mode to block mode. This is
equivalent to specifying the MOde B subcommand. See “MOde subcommand—Set
the data transfer mode” on page 242 for more information.
Format
BLock
Parameters

CCc subcommand
CCc subcommand—Turn off integrity protection
Purpose
Use the CCc subcommand to turn off integrity protection on the control
connection. This command must be integrity-protected, and must be preceded by a
successful security mechanism negotiation.
Format
CCc
Parameters
| Rule: Because turning off integrity protection potentially enables an attacker to

| insert commands onto the control connection, some FTP servers might refuse to
| honor this command.
| Restrictions: When the security mechanism is TLS, the following restrictions apply:
| v The CCc subcommand is not supported when the connection is implicitly
| secured with a connection to the port that is configured with the TLSPORT
| statement.
| v The CCc subcommand is supported only when the TLSRFCLEVEL is RFC4217.

CD subcommand
CD subcommand—Change the directory on the remote host
Purpose
Use the CD subcommand to change the working directory or file group on the
remote host.
Format
CD directory
Parameters
directory
Specifies the name of a file directory, a fully qualified data set, or a prefix on
the remote host.
Examples
Changing the directory of a z/OS FTP server
If the remote server is z/OS FTP, the directory value can specify either a z/OS
UNIX file system name, a common prefix for a group of MVS data sets, or the
qualifiers of a partitioned data set (PDS).
When the CD subcommand is issued, the directory specified is appended to the

current working directory. For example, if the current working directory is
TCPUSR14.TEST, and you issue the CD subcommand:
CD FILES
the new working directory becomes TCPUSR14.TEST.FILES.
To override the existing directory rather than append to the directory, issue the
directory parameter within single quotation marks. For example, if the current
working directory is TCPUSR14.TEST, and you issued the CD subcommand:
CD ’FTP.FILES’
the new working directory would be FTP.FILES. If the subdirectory name contains
white space, such as NEW SUBDIRECTORY, then the syntax for the CD command
would be as follows:
CD ’NEW SUBDIRECTORY’
The command syntax must specify the full subdirectory name (including the blank)
delimited within single quotation marks.
If a PDS exists with the exact name of the current working directory, FTP considers
the working directory to be that PDS. Otherwise, FTP considers the working
directory to be a common prefix qualifier for sequential data sets.
If a PDS exists with the same name as the current working directory, but you want
the current working directory to be treated as a common prefix for sequential data
sets, specify the working directory with a period (.) at the end. For example, if a
PDS named TCPUSR14.TEST exists, the subcommand:
CD ’TCPUSR14.TEST’

CD subcommand
makes the PDS TCPUSR14.TEST the current working directory. A subsequent PUt of
file name1 adds a member name1 to the TCPUSR14.TEST PDS. In contrast, the
subcommand
CD ’TCPUSR14.TEST.’
makes the current working directory, TCPUSR14.TEST., a prefix for sequential data
sets. A subsequent PUt command used to copy data set name1 would create the
sequential data set TCPUSR14.TEST.name1.
To back up one level of the current working directory, issue the CD subcommand
with two periods (..) at the end. For example, if the working directory is
jones.source, the subcommand
CD ..
makes jones. the working directory. You can also use the CDUp command to back
up one level of the current working directory. See “CDUp subcommand—Change
to the parent of the working directory” on page 156 for more details.
The following sample commands and responses are displayed as a result of the CD
subcommand.
For an MVS data set:

cd hsmtest
>>>CWD hsmtest
250 "’USER17.HSMTEST.’" is working directory name prefix.
Command:
For a z/OS UNIX file:

cd ’/u/user121/A/B/C’
>>>CWD ’/u/user121/A/B/C’
250 HFS directory /u/user121/A/B/C is the current working directory
Command:
Changing the directory of a VM FTP server

If the remote host is using TCP/IP for VM, the directory can be specified in either
of the following ways:
v user_id minidisk_address
v user_id.minidisk_address
For example, to access the 191 minidisk of user ID jones, enter one of the
following:
v jones 191
v jones.191
Testing throughput with *DEV.NULL

If you have a z/OS FTP server, you can use the PUt command to copy a large
number of files (or one large file) without having the files actually stored on a
z/OS FTP server file system. This is useful for testing purposes because you do not
have to worry about allocating the disk space on the server system.
To use this function, first change the working directory to *DEV.NULL by using
one of the following commands:
v CD *DEV.NULL

CD subcommand
v CWD *DEV.NULL
This affects the working directory only for PUt commands. You then use the PUt
command to copy the file to the server system. The input data set must be valid,
and the output file can either be new or already exist. In either case, the file is not
actually stored.
The following response shows information such as the number of bytes transferred
and the rate of transfer.
To end the use of the *dev.null directory for PUt commands, issue another
CHANGE Directory command.
Command:
cd *dev.null
>>>CWD *dev.null
250-Working directory for PUT is NULL Device;
250 for GET is HFS directory /u/user31
Command:
put a.b a.bbbbb
>>>SITE VARrecfm Lrecl=128 Recfm=VB BlockSize=6144
>>>PORT 14,0,0,0,4,14
>>>STOR a.bbbbb
125 Storing data set in the Null directory (*dev.null).
Command:
quit
>>>QUIT
Usage
You can also use the CWD and CW subcommands to change the current working
directory. These subcommands are synonyms of the CD subcommand.

CDUp subcommand
CDUp subcommand—Change to the parent of the working directory
Purpose
Use the CDUp subcommand as a special case of the CD subcommand to change
the working directory to the next higher directory level. You can use it to simplify
the implementation of programs for transferring directory trees between operating
systems that have different syntaxes for naming the parent directory.
Format
CDUp
Parameters
Examples
Change the working directory to the next higher directory level:
cd ’a.b.c.d’
>>>CWD ’a.b.c.d’
257 "’A.B.C.D.’" is working directory name prefix.
Command: pwd
>>>PWD
257 "’A.B.C.D.’" is working directory
Command: cdup
>>>CDUP
257 "’A.B.C.’" is working directory name prefix.
Command: pwd
>>>PWD
257 "’A.B.C.’" is working directory
Command: cdup
>>>CDUP
257 "’A.B.’" is working directory name prefix.
Command: pwd
>>>PWD
257 "’A.B.’" is working directory
Change the working directory to the next higher directory level for a z/OS UNIX
file:

CDUp subcommand
cd ’/u/user121/A/B/C’
>>>CWD ’/u/user121/A/B/C’
250 HFS directory /u/user121/A/B/C is the current working directory
Command: pwd
>>>PWD
257 "/u/user121/A/B/C" is the HFS working directory
Command: cdup
>>>CDUP
250 HFS directory /u/user121/A/B is the current working directory
Command: pwd
>>>PWD
257 "/u/user121/A/B" is the HFS working directory
Command: cdup
>>>CDUP
250 HFS directory /u/user121/A is the current working directory
Command: pwd
>>>PWD
257 "/u/user121/A" is the HFS working directory.
Command:

CLEar subcommand
CLEar subcommand—Set the protection level for data transfers to

CLEAR
Purpose
Use the CLEar subcommand to set the protection level for data transfers on the
data connections to clear. This subcommand is equivalent to specifying the
PROTect CLEar subcommand.
Format
CLEar
Parameters
Examples
To set the protection level to clear, enter:
clear
Usage
See the “PROTect subcommand—Set the protection level for data transfers” on
page 251 for additional protection level information.
The CLEar subcommand is not valid when there is no active security mechanism.

CLose subcommand
CLose subcommand—Disconnect from a remote host
Purpose
Use the CLose subcommand to disconnect from the remote host and remain in
FTP.
Format
CLose
Parameters
Usage
The FTP session remains active on your local host, but the session to the remote
host is terminated. You can use the Open subcommand to establish a new session
with either the same or a different remote host. If you establish a new session with
the same remote host, values set by the SIte subcommand during the previous
session are cleared. The remote host default values for the parameters of the SIte
subcommand are used for the new session.
Context
v See “Open subcommand—Connect to the FTP server” on page 247 for
information about the Open subcommand.
v CLose can be used with the PROXy subcommand to close a secondary control
connection. See “PROXy subcommand—Execute FTP subcommand on secondary
control connections” on page 252 for more information.

COMpress subcommand
COMpress subcommand—Set the compressed data transfer mode
Purpose
Use the COMpress subcommand to set the data transfer mode to compressed
mode. This is equivalent to specifying the MOde C subcommand. See “MOde
subcommand—Set the data transfer mode” on page 242 for more information.
Format
COMpress
Parameters

CProtect subcommand
CProtect subcommand— Set the protection level on commands
Purpose
Set the protection level on commands to protection-level.
Format
CProtect [protection-level]
Parameters
The valid protection levels are:
protection-level
Can have the following values:
clear
Unprotected commands
safe
Commands integrity-protected by cryptographic checksum
private
Commands confidentiality and integrity-protected by encryption
Result: If an ADAT command succeeds, the default command protection level is

safe; otherwise, the only possible level is clear. If no level is specified, the current
level is used.
Tip: CProtect CLEar is equivalent to the CCc subcommand.

DEBug subcommand
DEBug subcommand—Set general trace options
Purpose
Use the DEBug subcommand to enable or disable general internal tracing.
Format
DEBug
?
ACC
ALL
BAS
CMD
FLO
FSC(n)
INT
NONE
PAR
SEC
SOC(n)
SQL
TIMestamps
UTL
Xyyy
Parameters
One or more of the following options can be specified:
? Displays the status of the traces.
ACC
The ACC trace shows the details of the login process.
ALL
This parameter is used to set all of the trace points.
Note: Both the FSC and the SOC traces will be set to level 1 when the ALL
parameter is processed.
BAS
This parameter is used to set a select group of traces that offer the best overall
debug data without the detailed information of some of the traces. Specifying
this parameter is the same as DEBUG CMD INT FSC SOC.
CMD
The CMD trace shows each command and the parsing of the parameters for
the command.
FLO
The FLO trace shows the flow of control within FTP. It is useful to show which
services of FTP are used for an FTP request.
FSC(n)
The FSC trace shows details of the processing of the file services subcommands

DEBug subcommand
APpend, PUt, Get, MGet, and MPut. This trace can generate very detailed
information and therefore allows you to specify levels of detail for the trace
points.
The level 1 tracing that is specified by entering FSC or FSC(1) is the level
normally used unless more data is requested by TCP/IP service group. The
level (n) can be a number from 1 to 8.
INT
The INT trace shows the details of the initialization and termination of the FTP
session with the server.
NONE
This parameter is used to turn off all of the traces.
PAR
The PAR trace shows details of the FTP command parser. It is useful for
debugging problems in the handling of the command parameters.
SEC
The SEC trace shows the processing of security functions such as TLS and
GSSAPI negotiations.
SOC(n)
The SOC trace shows details of the processing during the setup of the interface
between the FTP application and the network as well as details of the actual
amounts of data that is processed.
This trace can generate very detailed information and therefore allows you to
specify levels of detail for the trace points. The level (n) can be a number from
1 to 8.
SQL
The SQL trace shows details of the processing for SQL requests, such as
requests when LOCSIte FILETYPE=SQL is in effect.
TIMestamps
This is a special parameter used to request that each trace entry have a
timestamp showing the time the entry was made. This is useful during long
running file transfers to track the duration of the transfer and also to match
client trace to the server trace, which also has a timestamp.
UTL
The UTL trace shows the processing of utility functions such as LCd and
LOCSIte.
Xyyy
This syntax is used to turn off (reset) a trace that is named by yyy. For
example, DEBUG XPAR XACC will turn off the PAR and the ACC traces.
Examples
The following example shows sample client traces with DEBug.
debug none fsc soc time
Active client traces - FSC(1) SOC(1)
get a ’user33.abc111’ (replace
11:21:33 CG0204 get: F=1 p=FSA ARTW=0000
11:21:33 CG3356 rcvFile: entered
11:21:33 MR1200 set_filename: entered with pathname ’user33.abc111’
11:21:33 CG2078 mvs_rcvFile: entered
11:21:33 CG1944 newGDGname: entered
11:21:33 MV0874 seq_create_file: entered with dsn=USER33.ABC111
11:21:34 MV1545 seq_create_file: ddname=SYS00009

DEBug subcommand
12345678901234567890123456789012345678901234567890123456789012345678901234567890
11:21:34 MV1605 seq create file: data set has recfm=50, lrecl=256, blksize=6233
11:21:34 CG2470 mvs_rcvFile: FASTIO pending for store_type = N
11:21:34 CG2473 mvs_rcvFile: ... recfm=VB, lrecl=256, blksize=6233
11:21:34 CG2560 mvs_rcvFile: request FASTIO with recfmU override for record form
at VB
11:21:34 MF2540 seq_open_file: recfm is VB
11:21:34 MF2598 seq_open_file: BSAM O SYS00009 ()
11:21:34 MF2600 seq_open_file: ncp=29 DA=0 K0=0 DF=0
11:21:34 MF2658 seq_open_file: stream 46EE8 has maxreclen 256
11:21:34 SC0531 initDsConnection: entered
>>> PORT 9,67,113,57,4,32
>>> RETR a
125 Sending data set /u/user33/a
11:21:34 SC0783 accDsConnection: entered
11:21:34 TI3053 WrtStreamFastIO: O=2 HGPES=00001 BCTE=1000 RLB=50/256/6233
11:21:34 MF2441 seq_close_file: file closed
11:21:34 GV0150 releaseFile: release ddname - SYS00009
11:21:34 GV0171 releaseFile: dynfree() results- rc=0, errcode=0, infocode=0
11:21:34 SC1128 dataClose: entered
11:21:34 CU1821 write_smf_record: entered with type 16.
11:21:34 CU1275 write_smf_record_119: entered with type 16.
11:21:34 CU2084 write_smf_record: length of smfrecord: 224
Usage
By default, DEBug is off. When the FTP environment is entered, you can activate
DEBug by any of the following methods:
v Use the TRACE or -d parameter on the FTP command.
v Code one or more DEBUG statements in the client’s FTP.DATA.
v Code the TRACE statement in the client’s FTP.DATA.
Once FTP is started, you can change the DEBug settings with the DEBug
subcommand.
v The trace supports the DEBug parameters 1 and 2 that are used with previous
product releases. Specifying DEBug BAS provides the same tracing as parameter
1 formerly provided. The DUMP subcommand now provides the extended
tracing that parameter 2 formerly provided.
v The state of the traces points is displayed as a response to the DEBug
subcommand. To see the states without making a change, enter DEBUG ?.
v The setting of the traces is additive as shown by the following:
DEBUG NONE CMD
EZA2851I Active traces: CMD
DEBUG PAR
EZA2851I Active traces: CMD PAR
v Entering DEBug with no parameters will toggle the trace on and off. The state of
the traces when the trace is toggled off is remembered so that toggling it on
restores the previous trace settings. If no traces were active previously, then
toggling activates the BAS trace points
DEBUG NONE CMD
DEB
EZA2851I Active traces: NONE
DEB
DEB FSC
EZA2851I Active traces: CMD FSC(1)
DEB

DEBug subcommand

DEB
EZA2851I Active traces: CMD FSC(1)
DEB NONE
DEB
EZA2851I Active traces: CMD INT FSC(1) SOC(1)
v The timestamp option is demonstrated with the following example:
deb fsc(1)
PC0304 parseCmd: subcommand: deb
PC0307 parseCmd: parameter 1: fsc(1)
Active traces: CMD FSC(1)
Command:
deb time
PC0304 parseCmd: subcommand: deb
PC0307 parseCmd: parameter 1: time
Active traces: CMD FSC(1)
Command:
deb soc(1)
11:39:37 PC0304 parseCmd: subcommand: deb
11:39:37 PC0307 parseCmd: parameter 1: soc(1)
Active traces: CMD FSC(1) SOC(1)
Command:
v For the FSC and SOC trace options only one level of tracing can be defined at
any time. However, when level 2 is defined, levels 1 and 2 are active. When
level 3 is defined, levels 1, 2, and 3 are active. This progression also applies to
levels 4 and 5.
deb fsc(2) soc(1)
Active traces: FSC(2) SOC(1)
Command:
deb fsc(1) soc(2)
Active traces: FSC(1) SOC(2)
Command:
Tip: The DEBug FSC command accepts level values 6–8, but provides only level 5
trace data. Likewise, DEBug SOC accepts level values 4–8, but provides only level
3 trace data.
See Diagnosing FTP client problems with tracing in z/OS Communications Server: IP
Diagnosis Guide for more information about FTP client tracing.

DELEte subcommand
DELEte subcommand—Delete files
Purpose
Use the DELEte subcommand to delete a file on the remote host.
Format
DELEte foreign_file
Parameters
foreign_file
Specifies the name of the file to be deleted on the remote host.
Context
See Appendix A, “Specifying data sets and files,” on page 429 for information
about file naming conventions.

DELImit subcommand
DELImit subcommand—Display the file name delimiter
Purpose
Use the DELImit subcommand to display the character that is used as the delimiter
between the file name and the file type.
Format
DELImit
Parameters
Usage
v The DELImit subcommand should be used for information purposes only.
v You cannot change which character is used as the delimiter.

DIr subcommand
DIr subcommand—Obtain a list of directory entries
Purpose
Use the DIr subcommand to obtain a list of directory entries or a list of files in a
file group on the remote host, or a list of the members of the partitioned data set,
as well as auxiliary information about the files.
Format
DIr
name ( DISK
Parameters
name
Specifies the name of the directory or file group. The default is the current
directory or file group.
(DISK
Stores the results of the DIr subcommand as data set FTP.DIROUTP in the local
current working directory.
v If the local current working directory is an MVS PDS, the member DIROUTP
is stored.
v If the local current working directory is a z/OS UNIX directory, the results
are stored in a file named diroutp.
Examples
v List the data sets with a common high-level qualifier as the current working
directory:
>>>PORT 9,67,58,227,4,62
>>>LIST
Volume Unit Referred Ext UsedRecfm Lrecl BlkSz Dsorg Dsname
WRKLB2 3380 1997/07/02 1 1 F 80 80 PS TEST.A
WRKLB2 3380 1997/07/09 4 7 F 80 80 PO TEST.PDS
WRKLB2 3380 1997/07/09 2 3 VB 60 256 PO TEST.PDSV
WRKLB2 3380 1997/07/01 16 17 VB 200 32000 PS TEST.XYZ1
Command:
Note: The DIr output for a RECFM=U data set for the FTP display always
shows the same value for lrecl as it shows for blksize.
v List the files for a z/OS UNIX file system directory:

DIr subcommand
cd ’/u/user121/ftp.example’
>>>CWD ’/u/user121/ftp.example’
250 HFS directory /u/user121/ftp.example is the current working directory
Command:
dir
>>>PORT 9,67,112,25,4,61
>>>NLST
125 List started OK
total 64
-rw-r----- 1 USER121 SYS1 6720 Feb 7 18:48 append02
-rw-r----- 1 USER121 SYS1 3360 Feb 6 18:51 file1
Command:
v List the members of a partitioned data set containing load modules:

cd ’sys1.linklib’
>>> CWD ’sys1.linklib’
250-Local directory might be a load library
250 "SYS1.LINKLIB" partitioned data set is working directory
Command:
dir d*
>>> PASV
227 Entering Passive Mode (127,0,0,1,4,112)
>>> LIST d*
125 List started OK
Name Size TTR Alias-of AC --------- Attributes --------- Amode Rmode
DD 03DBD8 031506 IRRENV00 01 FO RN RU 31 24
DELDSD 03DBD8 031506 IRRENV00 01 FO RN RU 31 24
DELGROUP 03DBD8 031506 IRRENV00 01 FO RN RU 31 24
DELUSER 03DBD8 031506 IRRENV00 01 FO RN RU 31 24
DG 03DBD8 031506 IRRENV00 01 FO RN RU 31 24
DMOCI001 000710 03370C 00 FO 31 ANY
DMOCTCTL 000178 033715 01 FO RN RU 31 ANY
DMOCTFIL 000028 03371D 01 FO RN RU 31 ANY
DMOCTFMT 00ABC8 033725 01 FO RN RU 31 ANY
DMOCTLOC 0006E8 03380C 01 FO RN RU 31 ANY
DMOCTRCE 0008F8 033814 01 FO RN RU 31 ANY
DMOCTSTR 000588 03381D 01 FO RN RU 31 ANY
DMODA002 001318 033826 01 FO RN RU 31 ANY
DMODA003 004618 033909 01 FO RN RU 31 ANY
DMODA004 000658 033916 01 FO RN RU 31 ANY
DMODIAG 001E58 03391F 00 FO 31 24
DMOVS001 002110 033A04 01 FO RN RU 31 ANY
DMOVS002 0003D8 033A0F 01 FO RN RU 31 ANY
DU 03DBD8 031506 IRRENV00 01 FO RN RU 31 24
Command:
v List the members of a partitioned data set from a text library:

DIr subcommand
cd ’tcpv3.tcpip.profiles’
>>>CWD ’tcpv3.tcpip.profiles’
257 "’TCPV3.TCPIP.PROFILES’" partitioned data set is working directory.
Command: dir
>>>PORT 9,67,112,25,4,32
>>>LIST
Name VV.MM Created Changed Size Init Mod Id
TST6MV1 01.05 1997/06/26 1996/07/10 06:38 16 16 0 USER34
TST6MV2 01.08 1997/05/23 1996/07/03 12:49 16 17 0 USER34
TST6MV3 01.19 1997/05/23 1996/07/10 06:34 16 17 0 USER34
TST6021 01.04 1997/03/04 1996/07/08 09:17 15 15 0 USER34
TST6121 01.10 1997/05/23 1996/07/10 06:26 16 17 0 USER34
***
Usage
v To make a file group the current working directory, use the CD command. The
method you use to specify a directory or file group is host-dependent.
v The DIr subcommand provides a complete list of directory entries and gives
additional information about the files.
When using this subcommand to list MVS data sets that have a common
high-level qualifier as the current working directory on a remote host, the
volume names are displayed. However, when displaying a multivolume data set
used in a SMS environment, only the first volume name is displayed. To list all
volume names for a multivolume data set, issue the following TSO command on
the remote host:
LISTC ENT(’dataset_name’) ALL
v You can use special characters for pattern matching when specifying the name.
These characters depend on the host FTP server.
v Special characters you can use for the z/OS FTP server:
* A single asterisk by itself indicates that either a qualifier or one or more
characters within a qualifier can occupy that position. An asterisk can
precede or follow a set of characters. An asterisk as the last qualifier will
indicate that 0 or more qualifiers can occupy that position.
** A double asterisk indicates that 0 or more qualifiers can occupy that
position. A double asterisk cannot precede or follow any characters. It
must be preceded and followed by either a period or a blank.
% A single percent sign by itself indicates that exactly one alphanumeric or
national character can occupy that position.
%...% One to eight percent signs (%) can be specified in each qualifier.
In DIRECTORYMode, ** is not allowed and % and * can be specified in the last

qualifier only.
The following shows examples of how the z/OS FTP server special characters
can be used.
Entry Returns
VSAM.DATA.SET VSAM.DATA.SET only

DIr subcommand
Entry Returns
VSAM.DATA.SET% VSAM.DATA.SET1
VSAM.DATA.SET2
- but not VSAM.DATA.SET30

VSAM.DATA.SET%% VSAM.DATA.SET30
VSAM.DATA.SET31
- but not VSAM.DATA.SET1

or VSAM.DATA.SET2
VSAM.*.SET VSAM.DATA1.SET
VSAM.DATA2.SET
- but not VSAM.DATA.SET.KSDS

VSAM.*A VSAM.A
VSAM.BA
VSAM.BBA
- but not VSAM.B

or VSAM.AB
VSAM.DATA.* VSAM.DATA.SET1
VSAM.DATA.SET2
VSAM.DATA.SET.KSDS
- but not VSAM.DATA1.SET

VSAM.DATA* VSAM.DATA1
VSAM.DATA23
- but not VSAM.DATA.SET.KSDS

VSAM.DATA*.* VSAM.DATA1
VSAM.DATA23
VSAM.DATA.SET1
VSAM.DATA1.SET
VSAM.DATA.SET.KSDS
VSAM.** VSAM
VSAM.DATA.SET1
VSAM.DATA.SET2
VSAM.DATA.SET.KSDS
- but not VSAM1.DATA.SET

**.DATA VSAM.DATA
NONVSAM.WORK.DATA
DATA
- but not VSAM.DATA.SET
** Will return all data sets within
the current working directory.
If the current working directory

is null, this command has the
potential to read all available
catalogs to which the user has
access. This can take a
considerable length of time.
Context
information about pattern matching and about specifying data sets and files.

DIr subcommand
v To get a list containing only the file names in a directory, use the LS
subcommand (see “LS subcommand—Obtain a list of file names” on page 229).
v To make a file group the current working directory, see “CD
subcommand—Change the directory on the remote host” on page 153.
v To change the local directory, see “LCd subcommand—Change the local working
directory” on page 193.

DUMP subcommand
DUMP subcommand—Set extended trace options
Purpose
Use the DUMP subcommand to enable or disable extended internal tracing.
Note: Extended tracing has the potential to generate a large amount of trace data
and should not be set unless requested to debug a specific problem in the
code.
Format
DUMP
?
n
ALL
FSC
NONE
SOC
SQL
Xyyy
Parameters
One or more of the following options can be specified:
n Specifies the ID number of a specific extended trace point that is to be
activated in the FTP code. The number has a range of 1–99.
ALL
FSC
Activates all of the extended trace points in the file services code. The ID
numbers for FSC are 20 to 49.
NONE
SOC
Activates all of the extended trace points in the network services code. The ID
numbers for SOC are 50 to 59.
SQL
Activates all of the extended trace points in the SQL services code. The ID
numbers for SQL are 70 to 79.
Xyyy
example, DUMP X21 X22 XSQL will reset the extended trace points 21 and 22 and
all of the SQL trace points.
Examples
The following is an example of a dump trace.

DUMP subcommand
dump 21 22
Active client dumpIDs - 21 22
get a ’user33.abc111’ (replace
12:38:31 MV0456 (21) TU_DSN ...:
0A31D1E4 00020001 000DE4E2 C5D9F3F3 4BC1C2C3 *......USER33.ABC*
0A31D1F4 F1F1F100 00000000 00000000 00000000 *111.............*
0A31D204 - 0A31D223 All zeros (0x20 bytes)12:38:31 MV0512 (21) TU_STATS ...:
0A31D150 00040001 00010100 *........ *
12:38:31 MV0521 (21) TU_DISP ...:
0A31D158 00050001 00010800 *........ *
12:38:31 MV2113 (22) RN PA=
0A3296C0 14070000 00000000 0A3296D8 00000000 *..........oQ....*
0A3296D0 00000000 *.... *
12:38:31 MV2115 (22) RN DD=
0A3296B0 00010001 0008E2E8 E2F0F0F0 F0F94B4B *......SYS00009..*
0A3296C0 14070000 0000 *...... *
12:38:31 MV2117 (22) RN DSN=
0A3296EC 00050001 000DE4E2 C5D9F3F3 4BC1C2C3 *......USER33.ABC*
0A3296FC F1F1F14B 60614B4B 4B4B4B4B 4B4B4F6B *111.-/.........,*
0A32970C 6C6D6E6F 4B4B4B4B 4B4B4B4B 4B4B7A7B *%_>?..........:#*
0A32971C 7C7D7E4B *@’=. *
>>> PORT 9,67,113,57,4,59
>>> RETR a
125 Sending data set /u/user33/a
820 bytes transferred in 0.005 seconds. Transfer rate 164.00 Kbytes/sec
Usage
The setting of the traces is additive. This is demonstrated by the following
example:
dump none 21
EZA2850I Active dumpIDs: 21
dump 22
EZA2850I Active dumpIDs: 21 22
Entering dump with no parameters is the same as entering dump with the ?
parameter.
The range of 99 extended trace points is defined to allow easy extension of the
trace points by the TCP/IP service team. Additional trace points can be added to
the code without any changes to the external mechanism to control the traces.
See Diagnosing FTP client problems with tracing in z/OS Communications Server: IP
Diagnosis Guide for more information about FTP client tracing.

EBcdic subcommand
EBcdic subcommand—Change the data transfer type to EBCDIC
Purpose
The EBcdic subcommand enables you to change the data transfer type to EBCDIC.
Format
EBcdic
Parameters
Usage
Use the EBcdic subcommand to direct FTP to transfer data with no translation.
Context

EUckanji subcommand
EUckanji subcommand—Change the data transfer type to EUCKANJI
Purpose
Use the EUckanji subcommand to change the data transfer type to Extended UNIX
Code (EUC) kanji.
Format
EUckanji
(
Ascii NOSo NOType
Sosi
Ebcdic
Space
Parameters
Sosi
of the following parameters – Ascii, Ebcdic or Space. If no parameter is
transferred data.
Ascii
data.
Ebcdic
data.
Space
characters X'20' and X'20' (ASCII spaces) to be used to delimit DBCS
strings in ASCII data.
NOSo
and is to be transferred to and from EBCDIC DBCS data that contains no
NOType
this parameter when translation is to be done by the FTP client only.

EUckanji subcommand
Usage
The EUckanji client subcommand is equivalent to the TYPE B 2 server command.
Context

FEature subcommand
FEature subcommand—Query FTP server for features it supports
Purpose
Ask the FTP server which features it supports. FTP clients use this command to
determine which languages the server supports, and which features the server
supports.
Format
FEature
Parameters
Usage
The minimum abbreviation for the feature subcommand is fe.

FIle subcommand
FIle subcommand—Set the file structure to File
Purpose
Use the FIle subcommand to set the file structure to File. This is equivalent to
specifying the STRucture F subcommand. See “STRucture subcommand—Set the
file structure” on page 309 for more information.
Format
FIle
Parameters

Get subcommand
Get subcommand—Copy files
Purpose
Use the Get subcommand to copy a file from the remote host to your local host.
Format
Get foreign_file
local_file ( REPLACE
Parameters
foreign_file
Specifies the name of the file to be retrieved from the remote host.
local_file
Specifies the name of the local file created as a result of the Get subcommand.
If the current local working directory is a PDS, local_file is the name of the
member in the PDS. If the current local working directory is a data set prefix,
the local file is a sequential data set with the local_file name appended to the
current local working directory. If the current local working directory is a z/OS
UNIX file system directory, the local file is a z/OS UNIX file in that directory.
You can override the usage of the current local working directory in the local
file name by specifying local_file as a complete data set name enclosed in single
quotation marks (’). If local_file is not specified, the local_file name is the same
as the foreign_file name.
(REPLACE
Causes a data set on your local host to be overwritten, if it already exists. If the
data set already exists, and you do not use the replace parameter, the existing
data set is not overwritten. A message informing you of this is displayed.
If the data set already exists and you specify REPLACE, the data in the file is
overwritten, but not reallocated. This means the local data set retains its
existing characteristics.
Usage
v FTP uses either the characteristics of the local file, if it exists, or uses the values
specified with the LOCSIte subcommand. Characteristics of the transmitted
(foreign file) data set are unknown.
When you use the Get subcommand, FTP might truncate data records and you
might lose data, if one of the following occurs:
– If you are creating a new data set at the client and the value of LRecl, as
shown by the LOCSTat command, is a value less than the LRecl of a received
data set, then FTP truncates the received data set.
– If the data set name already exists at the receiving site and the logical record
length (LRecl) of the data set at the receiving site is less than the LRecl of the
transmitted data set, then FTP truncates the transmitted data set.
You could also encounter truncated data records or lost data when you use
the Get subcommand with the REPLACE option.
Attention: A Get subcommand issued for an empty or nonexisting foreign file
erases the contents of the existing local data set.

Get subcommand
– If FTP does not support directory content transfers in partitioned data sets, it
is not possible to FTP load modules.
– If the data set is migrated, it is replaced regardless of the replace option.
v If the name specified for local_file is not acceptable to your local host, the file is
not transferred.
v To get a file from the remote host, you must have a defined working directory
on that host and you must have read privileges to the files in this working
directory.
v If the data set has been preallocated, you must specify DSORG=PS on the DCB
statement in the JCL.
v When a PDS or PDSE member is transmitted, the user data associated with the
PDS member is also transferred to the directory on the target host if the
following conditions are true;
– Data is in block or compressed data transfer mode
– Data has a representation type of EBCDIC
– Transfer is from one MVS directory to another
No PDS directory information is transferred if the member is null (empty).
Context
and “ACCt subcommand—Supply account information” on page 143 for more
information about working directories.
v Get can be used with the PROXy subcommand to transfer files from a host on a
primary connection to a host on a secondary connection. See “PROXy

GLob subcommand
GLob subcommand—Toggle expansion of metacharacters
Purpose
Use the GLob subcommand to toggle globbing (the expansion of metacharacters in
file names) for the MDelete, MGet, and MPut subcommands.
Format
GLob
Parameters
Examples
Assume that the files m1 and m1* exist in the directory /u/user33/mpp1.
Command:
pwd
>>> PWD
257 "/u/user33/mpp1" is the HFS working directory
Command:
lpwd
Local directory name set to hierarchical file /u/user33
Command:
prompt
Command:
mget m1*
>>> PORT 9,67,113,57,4,43
>>> NLST m1*
125 List started OK
>>> PORT 9,67,113,57,4,44
>>> RETR m1
125 Sending data set /u/user33/mpp1/m1
200 bytes transferred in 0.050 seconds. Transfer rate 4.00 ...
Kbytes/sec.
>>> PORT 9,67,113,57,4,45
>>> RETR m1*
125 Sending data set /u/user33/mpp1/m1*
Kbytes/sec.

GLob subcommand
Command:
delete /u/user33/m1
>>> DELE /u/user33/m1
250 /u/user33/m1 deleted.
Command:
delete /u/user33/m1*
>>> DELE /u/user33/m1*
250 /u/user33/m1* deleted.
Command:
glob
Globbing off
Command:
mget m1*
>>> PORT 9,67,113,57,4,46
>>> RETR m1*
125 Sending data set /u/user33/mpp1/m1*
Kbytes/sec.
With globbing off, at most one file will match the pattern. Also, the NLST
command is not sent to look for pattern matches.
Usage
GLob acts as a toggle that turns metacharacter expansion on or off. By default,
GLob is on.
Context
For more information about globbing, see the z/OS UNIX System Services User’s
Guide.

HAngeul subcommand
HAngeul subcommand—Change the data transfer type to HANGEUL
Purpose
Use the HAngeul subcommand to change the data transfer type to Hangeul.
Format
HAngeul
(
Ascii NOSo NOType
Sosi
Ebcdic
Space
Parameters
Sosi
of the following parameters – Ascii, Ebcdic or Space. If no parameter is
transferred data.
Ascii
data.
Ebcdic
data.
Space
NOSo
and is to be transferred to or from EBCDIC DBCS data that contains no
NOType
Usage
The HAngeul client subcommand is equivalent to the TYPE B 5 server command.

HAngeul subcommand
Context
See “FTP with traditional DBCS support” on page 87 for more information.

HElp and ? subcommands
HElp and ? subcommands—Display help information
Purpose
Use the HElp command to get assistance with the FTP subcommands.
Format
HElp
All
PROXY
subcommand
Server
subcommand
Parameters
All
The client displays a description of all the subcommands it implements.
PROXY
When used, displays a description of all subcommands available on the proxy
subcommand.
subcommand
Displays a description of the specified subcommand. The subcommand name
can be abbreviated to its minimum abbreviation.
Server
Displays the help that the foreign host offers for the specified subcommand.
If you do not specify a subcommand, FTP displays a list of the commands that
the foreign host recognizes.
Usage
v If you enter the HElp subcommand without a parameter, you see the HElp FTP
MENU, which lists the subcommands recognized by the FTP client and a
description of the help information available.
v If you enter the ? subcommand by itself, you see introductory information about
FTP.
Note: To receive help from a server on a secondary control connection, enter

PROXy HElp SERVER. See “PROXy subcommand—Execute FTP
subcommand on secondary control connections” on page 252 for more
information.

Ibmkanji subcommand
Ibmkanji subcommand—Change the data transfer type to IBMKANJI
Purpose
Use the Ibmkanji subcommand to change the data transfer type to IBM kanji.
Format
Ibmkanji
( NOType
Parameters
(NOType
Suppresses sending of the TYpe command for host servers that do not support
this data transfer type.
Usage
This subcommand causes no conversion to be performed on the transferred file. It
has exactly the same effect as the EBcdic TYpe command alias.
Context

JIS78kj subcommand
JIS78kj subcommand—Change the data transfer type to JIS78KJ
Purpose
Use the JIS78kj subcommand to change the data transfer type to JIS78KJ (1978
edition).
Format
JIS78kj
Ascii
(
Jisroman NOSo NOType
Parameters
Ascii
Use ASCII shift-in escape sequence ESC ( B in the transferred data.
If neither Ascii nor Jisroman is specified, the ASCII shift-in sequence is used.
Jisroman
Use Jisroman shift-in escape sequence ESC ( J in the transferred data.
NOSo
NOType
Usage
v The JIS78kj or JIS78kj (ASCII client subcommands are equivalent to the TYPE B 4
A server command.
v The JIS78kj (JISROMAN client subcommand is equivalent to the TYPE B 4 R
server command.
v The JIS78kj (JISROMAN NOSO client subcommand is equivalent to the TYPE B
4 R N server command.
Context

JIS83kj subcommand
JIS83kj subcommand—Change the data transfer type to JIS83KJ
Purpose
Use the JIS83kj subcommand to change the data transfer type to JIS83KJ (1983
edition).
Format
JIS83kj
Ascii
(
Jisroman Noso NOType
Parameters
Ascii
Use ASCII shift-in escape sequence ESC ( B in the transferred data.
If neither Ascii nor Jisroman is specified, the ASCII shift-in sequence is used.
Jisroman
Use Jisroman shift-in escape sequence ESC ( J in the transferred data.
NOSo
NOType
Usage
v The JIS83kj or JIS83kj (ASCII client subcommands are equivalent to the TYPE B 3
A server command.
v The JIS78kj (JISROMAN client subcommand is equivalent to the TYPE B 3 R
server command.
Context

Ksc5601 subcommand
Ksc5601 subcommand—Change the data transfer type to KSC-5601
Purpose
Use the Ksc5601 subcommand to change the data transfer type to KSC-5601.
Format
Ksc5601
(
Ascii NOSo NOType
Sosi
Ebcdic
Space
Parameters
Sosi
of the following parameters — Ascii, Ebcdic or Space. If no parameter is
transferred data.
Ascii
data.
Ebcdic
data.
Space
NOSo
NOType

Ksc5601 subcommand
Usage
The Ksc5601 client subcommand is equivalent to the TYPE B 6 server command.
Context
See “Support for MBCS languages” on page 90 for more information.

LANGuage subcommand
LANGuage subcommand—Set the language used for FTP replies from

the server
Purpose
Request the language to be used for FTP server replies, or reset the language in
use to the server’s default language.
Format
LANGuage
language
-subtag
Parameters
language
A 2-character code as specified by RFC 1766 identifying the language to be
used for FTP replies. RFC 1766 defines these codes as those listed in ISO 639.
See Appendix D, “Related protocol specifications,” on page 449 for information
about accessing RFCs.
-subtag
A 2-character code as specified by RFC 1766 identifying a variation of
language. RFC 1766 defines these codes as ISO 3166 alpha-2 country codes. See
Appendix D, “Related protocol specifications,” on page 449 for information
about accessing RFCs.
Usage
v The language subcommand is equivalent to the LANG language -subtag
command.
v LANGuage with no parameters sets the language for FTP replies to the server’s
default language. For most FTP servers, the default is US English encoded in
7-bit ASCII.
v LANGuage with a parameter requests the server to use language for FTP replies.
As specified in RFC 2640, it also directs the server and client to use UTF-8
encoding of path names on the control connection.
v This subcommand is not available unless EXTENSIONS UTF8 is encoded in
FTP.DATA.
v The subcommand is not available if you have disabled UTF-8 encoding with a
LOCSIte command or FTP start option.
Context
The client should use the FEature subcommand to determine which languages the
server offers prior to using the LANGuage subcommand to request a language for
FTP replies. See “FEature subcommand—Query FTP server for features it
supports” on page 178 for information about using the FEature subcommand.

LCd subcommand
LCd subcommand—Change the local working directory
Purpose
Use the LCd subcommand to change the current working directory on the local
host.
Format
v In a TSO Environment:
LCd qualifier
v In a z/OS UNIX System Services Environment:
LCd
qualifier
Parameters
qualifier
Specifies either a common prefix for a group of sequential data sets or the
qualifiers of a PDS.
Note: In a z/OS UNIX environment, you can omit the qualifier on the LCd
subcommand. Doing so changes the current working directory to your
home directory. If you do not have a home directory, the working
directory is not changed, and no message is issued.
Examples
v Change the local current working directory:
lcd ftp.test1
Local directory name set to partitioned data set USER14.FTP.TEST1.

Command:
v When the LCd subcommand is issued, qualifier is appended to the current local
working directory. For example, if the current local working directory is
TCPUSR14.TEST and you issue the LCd subcommand LCD FILES, the new working
directory becomes TCPUSR14.TEST.FILES.
v To override the existing directory rather than append to the directory, issue the
qualifier in single quotation marks (’). For example, if the current local working
directory is TCPUSR14.TEST and you issued the LCd subcommand LCD
’FTP.FILES’, the new working directory is FTP.FILES.
v If a PDS exists with the exact name of the current local working directory, FTP
considers the working directory to be that PDS. Otherwise, FTP considers the
working directory to be a common prefix qualifier for sequential data sets.
If a PDS exists with the same name as the current local working directory, but
you want the current local working directory to be treated as a common prefix
for sequential data sets, specify the working directory with a period (.) at the
end. For example, if a PDS named TCPUSR14.TEST exists, the subcommand LCD
’TCPUSR14.TEST’ makes the PDS TCPUSR14.TEST the current local working
directory. A subsequent Get command used to copy data set name1 would add
the member name1 to the TCPUSR14.TEST PDS. In contrast, the statement LCD

LCd subcommand
’TCPUSR14.TEST.’ would make the current local working directory

TCPUSR14.TEST., a prefix for sequential data sets. A subsequent Get command
used to copy data set name1 would create the sequential data set
TCPUSR14.TEST.name1.
v To back up one level of the current local working directory, issue the LCd
subcommand with two periods (..) at the end. For example, if the working
directory is jones.source, the subcommand LCD .. makes jones. the working
directory.
Testing throughput with *DEV.NULL

You can use the Get subcommand to copy a large number of files (or one large file)
without having the files actually stored in the client’s file system. This is useful for
testing purposes because you do not have to worry about allocating the disk space
on the client system.
To use this function, first change the working directory to *DEV.NULL by entering
the following subcommand:
LCD *DEV.NULL
This affects the working directory only for Get commands. You then use the Get
command to copy the file to the client system. The input data set must be valid,
and the output file can either be new or can already exist. In either case, the file is
not actually stored.
The following response shows information such as the number of bytes transferred
and the rate of transfer.
Command:
lcd *dev.null
Working Directory for GET is NULL Device
for PUT is HFS directory /tmp
Command:
get ’user2.junk(junk)’ example
>>> EPSV
229 Entering Extended Passive Mode (|||1034|)
>>> RETR ’user2.junk(junk)’
125 Sending data set USER2.JUNK(JUNK)
Command:
To end the use of the *dev.null directory for Get commands, issue another change
local working directory subcommand.
Usage
When you enter an FTP session, the working directory on the local host is set
according to the environment in which the FTP client is invoked: $HOME in z/OS
UNIX, your MVS user ID in TSO.

LOCSIte subcommand
LOCSIte subcommand—Specify site information to the local host
Purpose
Use the LOCSIte subcommand to specify information that is used by the local host
to provide services specific to that host system.
Format
LOCSIte option
options:
ASAtrans
AUTOMount
AUTORecall
BLKsize
= size
BLocks
BLOCKSIze
= size
5
BUfno =
number
0
CHKptint =
number
home
CHKPTrefix userid
local
CHMod ooo filename
symbolic filename
CONDdisp = Catlg
Delete
CTRLConn 7BIT
iconv_ascii
FTP_STANDARD_TABLE
*
CYlinders
DATAClass
= data_class
DATASetmode
DB2 = db2_name
DBSUB
DCbdsn
= data_set_name
Directory
= size
DIRECTORYMode
ENCODING = SBCS
MBCS
EPSV4

LOCSIte subcommand
FILEtype = type
FWFriendly
ISPFSTATS
LISTSUBdir
LRecl
= length
MBDATACONN = (file_system_codepage,network_transfer_codepage)
MBREQUIRELASTEOL
MBSENDEOL = CRLF
CR
LF
NONE
MGmtclass
= mgmtclass
MIGratevol
= volume_ID
NOASAtrans
NOAUTOMount
NOAUTORecall
NODBSUB
NOEPSV4
NOFWFriendly
NOISPFSTATS
NOLISTSUBdir
NOMBREQUIRELASTEOL
NOQUOtesoverride
NORDW
NORESTGet
NOSBSUB
NOSECUREIMPlicitzos
NOSPRead
NOTRAILingblanks
NOTRUNcate
NOUCSSUB
NOUCSTRUNC
NOWRAPrecord
NOWRTAPEFastio
PDSTYPE =
PDS
PDSE
PRImary
= amount
10
PROGRESS =
number
Qdisk
= volume_serial
QUOtesoverride
RDW
READTAPEFormat
= tape_format
RECfm
= format
RESTGet
RETpd
= days

LOCSIte subcommand
|
SBDataconn dsname
(file_system_cp,network_transfer_cp)
FTP_STANDARD_TABLE
*
SBSENDEOL = CRLF
CR
LF
NONE
SBSUB
SBSUBCHAR = nn
Space
SECondary
= amount
SECUREIMPlicitzos
SPRead
SQLCol = any
labels
names
STOrclass
= storage_class
TLSRFCLEVEL = DRAFT
RFC4217
TRacks
TRAILingblanks
TRUNcate
UCOUNT
= unit_count | P
UCSHOSTCS
= code_set
UCSSUB
UCSTRUNC
UMask ooo
UNICODEFILESYSTEMBOM = ASIS
ALWAYS
NEVER
Unit
= unit_type
VCOUNT
= volume_count
VOLume =
volume_serial
(volume_serial_list)
WRAPrecord
WRTAPEFastio
Parameters
ASAtrans
Permits the FTP client to interpret characters in the first column of ASA files
being transferred as print control characters.
AUTOMount
Permits automatic mounting of volumes for data sets on volumes that are not
mounted. If AUTOMount is specified and an unmounted volume is needed, a
message is automatically issued to the MVS operator console requesting that
the volume be mounted. The MVS operator must then mount the volume and
reply to the message before FTP can proceed.

LOCSIte subcommand
AUTORecall
Permits automatic recall of migrated data sets.
BLKsize
Specifies the block size of a newly allocated data set. BLKsize is functionally
equivalent to BLOCKSIze. The BLOCKSIze parameter is obsolete, but it is
accepted to provide compatibility with previous releases of z/OS TCP/IP.
When specified without a size, no block size is used when allocating the new
data set. When specified without a size, the equal sign (=) is optional.
Specify BLKsize with no value if you are also specifying DATAClass=data_class
and you want the SMS data class to provide the BLKsize value, or if you are
specifying DCbdsn=data_set_name and you want to use the block size from the
DCBDSN data set. If BLKsize=size is specified with either the DATAClass or
DCbdsn parameter, the value specified by the LOCSite BLKsize parameter
overrides the DATAClass or DCbdsn block size.
Notes:
1. If you specify BLKsize without a size, FTP does not specify the block size
when allocating new data sets.
2. Be especially careful specifying both BLKsize= and Blocks. While there are
conditions where this is tolerated, if a valid BLKsize cannot be determined,
the data set will not be created when the allocation is attempted.
size
Specifies the block size of a newly allocated data set. The valid range is
0–32 760.
BLKsize=0 is a special case. When BLKsize=0 is specified, the operating
system attempts to determine a block size for the new data set. FTP does
not create the new data set unless the system is able to establish a nonzero
block size.
BLocks
Specifies that primary and secondary space allocations are in blocks.
If both PRImary and SECondary are specified as 0, and an SMS data class has
been specified, the space allocation is determined by the SMS data class and
the BLocks parameter is ignored.
BLOCKSIze
Specifies the block size of a newly allocated data set. BLOCKSIze is
functionally equivalent to BLKsize. BLOCKSIze is obsolete but it is accepted to
provide compatibility with previous releases of z/OS TCP/IP. See the BLKsize
parameter for more information.
BUfno
Specifies the number of access method buffers that is used when data is read
from or written to a data set. The valid range is 1–35. The default value is 5.
CHKptint
Specifies the checkpoint interval for the sending site in a file transfer request. If
the checkpoint interval is 0, no checkpointing occurs and no marker blocks are
transmitted. The default value is 0.
CHKptint must be set by LOCSIte when the client site is the sending site for
the file transfer (PUt command). Do not increase the checkpoint interval above
0 for a PUt unless the receiving site supports the REStart command and is able
to process checkpoint markers in the file transfer data stream.
CHKptint is valid only for block and compressed modes of data transfer.

LOCSIte subcommand
number
Specifies the checkpoint interval for the sending site in a file transfer
request. This value is used to determine when checkpoint marker blocks
are to be transmitted so that transmission can be restarted based on the
information in the last marker.
A large checkpoint interval means that a large amount of data is sent
between markers and therefore few markers are sent. A smaller checkpoint
interval means that less data is sent in between markers and therefore
more markers are sent.
The costs involved with using a nonzero checkpoint interval are:
v The markers themselves are transmitted, which means more bytes are
being sent across the network (approximately 44 bytes per marker).
v For each marker that is sent by the client, a reply must be sent by the
server on the control connection. The reply acknowledges the marker
and provides the server’s corresponding marker.
To estimate the appropriate checkpoint interval, use the following formula.

You need to know the record length of the file you are transferring and
how much data you think can be transmitted reliably.
amount of data in interval
CHKPTINT = --------------------------
record length of the file
Do not execute a CHKptint more often than once every 200KB. For
example, if the file you are transferring has 80-byte records:
CHKPTINT = 200KB / 80 bytes
= 200 * 1024 bytes / 80 bytes
= 2560
CHKPTPrefix
Specifies a key which is used to determine the hlq of the checkpoint data set.
The name will be hlq.FTP.CHKPOINT or hlq.pds_name(CHKPOINT).
home
The default.
userid
Creates the data set ’userid.FTP.CHKPOINT’.
local
Creates a file named current_path.FTP.CHKPOINT or, if the path happens to
be a PDS, then the file name is current_path.pds_name(CHKPOINT).
Note the exceptions for z/OS UNIX and BATCH jobs in the following chart
using ’path’ for current path and ’FN’ for FTP.CHKPOINT:
Parameter z/OS UNIX Batch TSO

Home path.FN userid.FN tso_prefix.FN
Userid userid.FN userid.FN userid.FN
Local path.FN path.FN path.FN
Local with path=pdse N/A path.pds_na path.pds_na
(CHKPOINT) (CHKPOINT)
CHMod
Changes the permission bits for a file.

LOCSIte subcommand
ooo filename
ooo is an octal mask representing the permissions you want to assign to
filename. Form the octal mask by OR’ing the constants corresponding to
the permission bits you want set:
400
User read
200
User write
100
User execute (or list directory)
040
Group read
020
Group write
010
Group execute
004
Other read
002
Other write
001
Other execute
You cannot use the LOCSITE subcommand CHMod parameter to set the
following permission bits:
v Set-user-ID bit
v Set-group-ID bit
v Sticky bit
See the z/OS UNIX System Services User’s Guide and the z/OS UNIX System
Services Command Reference for more information about file permissions.
symbolic filename
symbolic represents the permissions you want to apply to filename.
Note: symbolic is specified as follows:

{u|g|o|a}{=|+|-}{r|w|x|rw|rx|wx|rwx}
where u, g, o, a, =, +, -, r, w, and x are as defined for the z/OS

UNIX chmod command.
If filename does not begin with a slash character (/), it is appended to the
current working directory. If filename does begin with a slash character (/), it is
interpreted as a complete directory name.
The file name specified must be a z/OS UNIX file name for a single file and
cannot contain a wildcard (*) for multiple files. The setting of QUOtesoverride
is ignored and all quotation marks are treated as part of the file name.
The CHMOD keyword must be the only or last keyword on a LOCSIte

subcommand.

LOCSIte subcommand
CONDdisp
Specifies the disposition of the data set if a retrieve operation for a new data
set ends before all of the data is written.
Catlg
Specifies that a data set is kept and cataloged when an FTP file transfer
ends prematurely.
Delete
Specifies that a data set is deleted when an FTP file transfer ends
prematurely.
Delete is ignored if the file transfer failed as a result of the FTP client being
terminated or if the client has received checkpoint information during data
transfer.
CTRLConn
Specifies the ASCII code page to be used for control connections. The valid
subcommands are:
LOCSITE CTRLConn=7BIT
LOCSITE CTRLConn=iconv_ascii
LOCSITE CTRLConn=FTP_STANDARD_TABLE
LOCSITE CTRLConn=*
See “Support for SBCS languages” on page 86 for more information.

7BIT
Indicates 7-bit ASCII is to be used.
iconv_ascii
Is a name recognized by iconv to indicate an ASCII code page. For a list of
code pages supported by iconv, see code set converters information in the
z/OS XL C/C++ Programming Guide.
FTP_STANDARD_TABLE
Indicates that the FTP internal tables, which are the same as the tables that
are shipped in TCPXLBIN(STANDARD), are to be used on the control
connection.
* Indicates that the ASCII used at initialization is to be used.
Note: Setting the control connection code page using LOCSIte CTRLCONN
disables UTF-8 encoding of the control connection. You must start the
client again to restore UTF-8 encoding.
CYlinders
Specifies that primary and secondary space allocations are in cylinders.
If both PRImary and SECondary are specified as 0, and an SMS data class has
the CYlinders parameter is ignored.
DATAClass
Specifies the SMS data class, as defined by your organization, for the target
host. Specifying DATAClass with no parameter value cancels the dataclass
specification. The equal sign (=) is optional in this case.
See “Specifying values for new data sets” on page 91 for more information
about specifying attributes when allocating new data sets.
data_class

LOCSIte subcommand
host. If values are specified for any of the following LOCSIte parameters,
the values specified by the LOCSIte parameter override the value specified
in the SMS dataclass:
v BLKsize
v Directory
v LRecl
v PRImary
v RECfm
v RETpd
v SECondary
If the DCbdsn parameter is specified on the LOCSIte subcommand, the
LRecl, RECfm, BLOCKSIze, and RETpd (if specified) of the DCBDSN data
set overrides the values specified in the data class.
If the MGmtclass parameter is specified on the LOCSIte subcommand, and
the requested management class specifies a retention period, the retention
period value of the management class can override the retention period
value of the dataclass.
DATASetmode
Specifies that all the data set qualifiers located below the current directory are
treated as entries in the directory (disables DIRECTORYMode).
DB2
Specifies the name of the DB2 subsystem.
db2_name
The name of the DB2 subsystem.
DBSUB
Specifies that substitution is allowed for data bytes that cannot be translated in
a double-byte character translation. The substitution character is selected by
the C/C++ iconv() function; see the z/OS XL C/C++ Programming Guide
information about Internationalization: Locales and Character Sets for more
information.
DCbdsn
Specifies the name of the MVS data set that is to be used as a model for
allocation of new data sets. Specifying DCbdsn with no parameter value
cancels the DCbdsn specification.
data_set_name
Specifies the name of the data set. The file name must be an MVS data set
name. z/OS UNIX file names are not allowed on the DCbdsn parameter.
The setting of QUOtesoverride is ignored. If the file name is enclosed in
single quotation marks, it overrides the current working directory;
otherwise it is appended to the current working directory.
Notes:
1. Specify the LOCSIte parameters RECfm, LRecl, and BLKsize with no
values to allow characteristics from the model DCB to be used.
2. To override the model characteristics of RECfm, LRecL, BLKsize, or
RETpd, specify a value on the LOCSIte command.
3. If MGmtclass is specified, the RETpd value of the MGmtclass can
override the RETpd value.

LOCSIte subcommand
Specifying a GDG data set with a relative index produces an error

message. The following examples are unsupported specifications:
LOCSITE DCBDSN=MYGDG(0)
LOCSITE DCBDSN=MYGDG(–nnn)or
LOCSITE DCBDSN=MYGDG(+nnn)
See “Steps for using a DCBDSN model to create a new data set” on page
93 for more information about DCbdsn.
Directory
Specifies the number of directory blocks to be allocated for the directory of a
PDS.
Specify Directory=0 to allocate without specifying the number of directory
blocks. Specify Directory=0 when you are also specifying DATAClass=dataclass
and you want the SMS dataclass to provide the Directory size.
The size you specify with the Directory parameter overrides the DATAClass
directory specification.
size
Specifies the number of directory blocks to be allocated for the directory of
a PDS. The valid range is 1–16 777 215. A size of 0 indicates that the
directory blocks should be taken from the SMS data class.
DIRECTORYMode
Specifies that only the data set qualifier immediately below the current
directory is treated as an entry in the directory. In directory mode, this data set
qualifier is the only one used by the MPut subcommand.
DIRECTORYMode has no effect on files residing in a z/OS UNIX file system.
ENCODING
Indicates the kind of encoding that is used for conversions between codepages
for data transfers. See “Support for SBCS languages” on page 86and “Support
for MBCS languages” on page 90 for more information.
SBCS
Single Byte encoding. Code pages are specified using the SBDATACONN
statement. This is the default value.
MBCS
Multibyte encoding. Code pages are specified using the MBDATACONN
statement.
EPSV4
Specifies the client is to attempt to use the EPSV command to establish a data
connection on an IPv4 session instead of referring to the FWFRIENDLY setting.
See RFC 2428 for information about the EPSV command. If the server rejects
the EPSV command, the client refers to the FWFRIENDLY setting to determine
how to establish the data connection. When the client is setting up proxy
transfer data connections, it will try the EPSV and EPRT commands on IPv4
sessions; if a server rejects the EPSV or EPRT command, the client will try the
PASV or PORT command instead.
If the server rejects either the EPSV or the EPRT command during the session,
the client won’t send EPSV to the server again, even when EPSV4 is specified.
FILEtype
Specifies the file type of the data set.

LOCSIte subcommand
type
The file type of the data set can be:
Type Description
SEQ Sequential or partitioned data sets
SQL SQL query function
FWFriendly
Specifies that the FTP client is firewall-friendly. This means that data
connections will be set up from the FTP client to the FTP server.
Note: When the FTP server has an IPv6 address, data connections are always
set up from the FTP client to the FTP server without reference to the
FWFriendly setting.
ISPFSTATS
Allows FTP to create or update ISPF Member statistics when Get or MGet
subcommands are issued.
LISTSUBdir
Use the LISTSUBdir option to indicate that wildcard searches should apply to
the current working directory and should also span one level of its
subdirectories. For the FTP client, this setting applies when issuing an MPut *
subcommand.
Restriction: The LISTSUBdir option applies to z/OS UNIX file operations only;
Result: If the LISTSUBdir option is not specified on the LOCSITE subcommand
and the LISTSUBDIR statement is not specified in the client FTP.DATA file, the
default is as if the LISTSUBdir option was specified on the LOCSITE
subcommand.
LRecl
Used to specify the logical record length (LRecl) of a newly allocated data set.
Specify LRecl with no value when you are also specifying
DATAClass=data_class and you want the SMS dataclass to provide the LRecl
value, or when you are specifying DCbdsn=data_set_name and you want to use
the LRecl from the DCBDSN data set. If LRecl=length is specified with either
DATAClass or DCbdsn, the length specified by the LOCSIte LRecl parameter
overrides the DATAClass or DCbdsn LRecl.
length
Specifies the logical record length of a newly allocated data set. The valid
range is 0–32 760. A special value of x (LRecl=x) is also supported to
indicate that a logical record length can exceed 32 760 for variable-length
spanned records.
Specifying LRecl=0 has the same effect as specifying LRecl with no
parameters.
MBDATACONN=(file_system_codepage,network_transfer_codepage)
Specifies the codepages for the file system and for the network transfer used
when the client does data conversion during a data transfer. This parameter
affects the conversion of multibyte character set (MBCS) data (including
support for DBCS code pages) and is used when the ENCODING=MBCS is
also specified.

LOCSIte subcommand
file_system_codepage
Specifies the name of the file system codepage.
network_transfer_codepage
Specifies the name of the network transfer codepage.
MBREQUIRELASTEOL
Specifies that the FTP client will report an error when a multibyte file or data
set is received from the server with no EOL sequence in the last record
received. FTP will abort the file transfer.
MBSENDEOL
Specifies which end-of-line sequence to use when ENCODING is MBCS, the data
transfer type is ASCII, MODE is Stream, and data is being sent to the server.
The following are possible values:
CRLF
Append both carriage return (X'0D') and line feed (X'0A') end-of-line
sequences to each line of translated text. This is the default and the
standard sequence defined by RFC 959. The z/OS server can receive ASCII
data in this format only.
CR
Append only a carriage return (X'0D') end-of-line sequence to each line of
translated text.
LF Append only a line feed (X'0A') end-of-line sequence to each line of
translated text.
NONE
Do not append an end-of-line sequence to the line of translated text.
Rules:
v Most servers support only the CRLF value for incoming ASCII data. Do not
specify another value for MBSENDEOL unless you have verified that the
server is expecting the end-of-line sequence that you specify.
v Do not use an end-of-line sequence other than CRLF if the server is a z/OS
FTP server. The z/OS FTP server supports only the CRLF value for
incoming ASCII data.
v If you send a file to a server when MBSENDEOL has a value other than
CRLF, a subsequent SIZE command to that server targeting the file you sent
could yield unpredictable results. Any size indicated in the server reply for
such a file might not be reliable.
MGmtclass
Used to specify the SMS management class as defined by your organization for
the target host. Specifying MGmtclass with no mgmtclass cancels the mgmtclass
specification. The equal sign (=) is optional in this case.
mgmtclass
Specifies the SMS management class as defined by your organization for
the target host. If the mgmtclass specified has a setting for RETpd, the
value specified by the mgmtclass can override the setting of the LOCSIte
RETpd parameter, the RETpd value of a model data set if the DCbdsn
parameter is specified, and the RETpd value defined in an SMS data class
if DATAClass is specified. See “Specifying values for new data sets” on
page 91 for more information about specifying attributes when allocating
new data sets.

LOCSIte subcommand
MIGratevol
Specifies the volume ID for migrated data sets if they do not use IBM storage
management systems. If you do not specify MIGratevol, the default
volume_serial is MIGRAT.
volume_ID
The volume ID for migrated data.
NOASAtrans
Treats ASA file transfers as regular file transfers; that is, the ASA characters are
treated as part of the data and are not converted to print control characters.
NOAUTOMount
Prevents automatic mounting of volumes for data sets on volumes that are not
mounted.
NOAUTORecall
Prevents automatic recall of migrated data sets.
Note: A migrated data set can be deleted even though NOAUTORecall is

specified, because migrated data sets are not recalled for deletion.
NODBSUB
Specifies that substitution is not allowed for data bytes that cannot be
translated in a double-byte character translation. This causes a data transfer
failure if a character cannot be translated during the transfer. This is the
default.
NOEPSV4
Prevents the client from using the EPSV command to establish a data
connection on an IPv4 session. See RPC 2428 for information about the EPSV
command. When NOEPSV4 is set, the client refers to the FWFRIENDLY setting
to determine how to establish the data connection. When the client is setting
up proxy transfer data connections, the client will use only PASV and PORT
commands with IPv4 servers.
NOFWFriendly
Specifies that the FTP client is not firewall friendly. This means that data
connections will be set up from the FTP server to the FTP client. This is the
default behavior for FTP data connections.
Note: When the FTP server has an IPv6 address, data connections are always
set up from the FTP client to the FTP server without reference to the
FWFriendly setting.
NOISPFSTATS
Does not allow FTP to create or update ISPF Member statistics when Get or
MGet subcommands are issued.
NOLISTSUBdir
Use the NOLISTSUBdir option to indicate that wildcard searches should apply
only to the current working directory and should not span its subdirectories.
For the FTP client, this setting applies when issuing an MPut * subcommand.
Restriction: The NOLISTSUBdir option applies to z/OS UNIX file operations
only; MVS data set operations are not affected.
Result: If the NOLISTSUBdir option is not specified on the LOCSITE
subcommand and the LISTSUBDIR statement is not specified in the client
FTP.DATA file, the default is as if the LISTSUBdir option was specified on the
LOCSITE subcommand.

LOCSIte subcommand
NOMBREQUIRELASTEOL
Specifies that the FTP client will not report an error when a multibyte file or
data set is received from the network with no EOL sequence in the last record
received. FTP will report the file transfer as completed.
NOQUOtesoverride
A single quote at the beginning of the file name, as well as all other single
quotation marks contained in the file name, is treated as part of the actual file
name. The entire file name, including the leading single quotation mark, is
appended to the current working directory.
NORDW
Specifies that variable record descriptor words (RDWs) are discarded during
FTP transmission of variable format data sets. This applies to transfers in
stream mode only.
NORESTGet
Prevents opening the checkpoint data set for a Get request. Thus, checkpoint
will not be active or recognized. Using this parameter when opening the
checkpoint data set might cause a problem.
NOSBSUB
translated in a single-byte character translation. This causes a data transfer
failure if a character cannot be translated during the transfer.
NOSECUREIMPlicitzos
When the client connects to the server’s TLSPORT, the security handshake and
negotiation are done immediately after the connect and before the 220 reply is
received.
NOSPRead
Specifies that the output is in report format rather than spreadsheet format
when the file type is SQL.
NOTRAILingblanks
Specifies that the FTP client does not preserve the trailing blanks that are in a
fixed format data set when the data is sent to a foreign host.
NOTRUNcate
Specifies that truncation is not permitted. The FTP client will set an error and
fail file transfer if a record that is longer than LRECL of the new file is
detected.
Note: If WRAPRECORD is set then the data is wrapped, not truncated, no

error will be set, and the file transfer will continue.
NOUCSSUB
| In UCS-2-to-EBCDIC conversion, the data transfer is terminated if any UCS-2
character cannot be converted into the EBCDIC code set.
NOUCSTRUNC
| In UCS-2-to-EBCDIC conversion, truncation of EBCDIC data is not allowed.
The data transfer is aborted if the logical record length of the receiving data set
is too small to contain the data after conversion to EBCDIC.
Note: The setting of the CONDdisp parameter determines what happens to

the target data set if the transfer is aborted.

LOCSIte subcommand
NOWRAPrecord
Indicates that data is truncated if no new line character is encountered before
the logical record length of the receiving file is reached.
Note: If NOTRUNcate is also set, an error will be set and the file transfer will
fail.
NOWRTAPEFastio
Indicates that ASCII stream data that is being written to tape must be written
using the Language Environment® run time library.
PDSTYPE
Specifies whether the FTP client creates local MVS directories as partitioned
data sets or as partitioned data sets extended.
When specified without a value, FTP will not specify to z/OS whether to
allocate a new MVS directory as a PDS or a PDSE. When specified without a
value, the equal sign (=) is optional.
PDS
Allocate directories as partitioned data sets.
PDSE
Allocate directories as partitioned data sets extended.
PROGRESS
Specifies the interval between progress report messages generated by the FTP
client during a file transfer (inbound or outbound).
number
Specifies the interval (in seconds) between progress report messages that
are generated in the FTP client during an inbound or outbound file
| transfer. Valid values are in the range 10-86400, or 0. The value 0 turns off
progress reporting in the FTP client. The default value is 10 seconds.
The messages that are generated as part of progress reporting are
EZA2509I and EZA1485I. These messages are generated automatically at
10-second intervals by the FTP client in releases prior to version V1R6.
Beginning in version V1R6, the default behavior is the same as in prior
releases, but the length of the interval and whether to generate the
messages can be configured by using the PROGRESS parameter setting on
the LOCSITE subcommand or by specifying the PROGRESS statement in
the FTP.DATA file.
PRImary
Used to specify the number of tracks, blocks, or cylinders for primary
allocation. When specified with a value of 0, no primary value is used when
allocating the data set.
Specify a PRImary allocation of 0 when you are also specifying
DATAClass=data_class and when you want the SMS dataclass to provide the
PRImary amount.
To enable the SMS data class to determine the space allocation, both PRImary
and SECondary allocations must be specified as 0. The tracks, blocks, cylinders
setting is ignored in this case. If PRImary with amount not equal to 0 is
specified with DATAClass, the value specified by the LOCSIte PRImary
parameter overrides the DATAClass space allocation.

LOCSIte subcommand
amount
Specifies the number of tracks, blocks, or cylinders for primary allocation.
For allocating partitioned data sets, this is the amount of space that is
allocated for the primary extent.
For allocating sequential data sets this is the maximum amount of space
that is allocated for the primary extent. If a lesser amount of space is
needed to hold the data being transferred, only the amount of space
actually needed to hold the data is allocated. The valid range is 1–16 777
215.
Qdisk
Used to display statistics about the amount of space available on a volume. If
Qdisk is entered without a specific volume_serial, statistics about available space
are displayed for each volume that is defined with “Use Attribute=storage”.
volume_serial
Displays statistics about available space on a specific volume.
QUOtesoverride
Specifies that a single quotation mark at the beginning and end of a file name
should override the current working directory instead of being appended to
the current working directory. This is the way single quotation marks are used
in all previous MVS FTP servers, and this is the default. Any single quotation
mark inside the beginning and ending quotation marks are treated as part of
the file name.
QUOtesoverride indicates the usage of single quotation marks appearing at the
beginning of, or surrounding, a file name. The setting of this keyword affects
all FTP subcommands that have a path name as a parameter except keywords
on the LOCSIte subcommand.
RDW
Specifies that variable record descriptor words (RDWs) are treated as if they
were part of the record and are not discarded during FTP transmission of
variable format data sets. This applies to transfers in stream mode only.
Note: RDW information is stored in binary format. Transfer files in binary

mode to avoid the translation problems that can occur if you transfer
this binary field in EBCDIC or ASCII mode.
READTAPEFormat
Used to provide information about an input data set on tape. If specified
without the tape_format (which is the default), processing of input tapes does
not take advantage of the record format information prior to open. The equal
sign (=) is optional in this case.
The READTAPEFormat parameter has no effect on, and is not affected by
DATAClass, DCbdsn, LRecl, RECfm, or any other parameters associated with
creating a data set.
tape_format
Specifies the format of the records on the input tape data set. Valid formats
are:
F Fixed record length
V Variable record length
S Spanned records
X Logical record length is undefined (Lrecl X)

LOCSIte subcommand
blank Unspecified (displayed as U in messages and reply)

These formats are mutually exclusive. Spanned implies variable, and Lrecl
X implies spanned. If specified, the tape_format value must be the most
inclusive identifier in the list that matches the tape. If it is not the most
inclusive identifier, an error message is issued. For example, if the
tape_format value is S (spanned) and the tape contains records with
undefined length (Lrecl X), the request will fail. An unspecified format
avoids this type of error. However, the following should be considered:
v Specify a value for the READTAPEFormat parameter in all the following
cases. Failure to specify a format will likely cause errors in processing
the tape.
– The record length is undefined (Lrecl X).
– The records are spanned (Recfm is VBS, VS).
– The records are variable (Recfm is V, VB, VBA) and RDW is specified.
v Specify a value for the READTAPEFormat parameter for all input tapes
that have one of the listed formats to ensure best results.
RECfm
Used to specify the record format of a data set. When specified without the
format, no record format is used when allocating the data set. The equal sign
(=) is optional in this case.
Specify the RECfm parameter with no value when you are also specifying
DATAClass=data_class and you want the SMS dataclass to provide the RECfm
format, or when you are specifying DCbdsn=data_set_name and you want to use
the record format from the DCBDSN data set.
If RECfm=format is specified with either DATAClass or DCbdsn, the value
specified by the LOCSIte RECfm parameter overrides the DATAClass or
DCbdsn record format.
format
Specifies the record format of a data set. Valid record formats are: F, FA,
FB, FBA, FBM, FBS, FBSA, FBSM, FM, FS, FSA, FSM, U, UA, UM, V, VA,
VB, VBA, VBM, VBS, VBSA, VBSM, VM, VS, VSA, and VSM. The
characters used to specify these record formats have the following
meanings:
Code Description
U Undefined record length
B Blocked records
S Spanned records (if variable) / standard records (if fixed)
A Records contain ISO/ANSI control characters
M Records contain machine code control characters
RESTGet
Allows opening the checkpoint data set for the Get request. This is the default
when the RESTGet statement has not been added to the FTP.DATA file.
RETpd
Used to specify the number of days that a newly allocated data set should be
retained.
Specify RETpd with no value when you are also specifying
DATAClass=data_class or MGmtclass=mgmtclass and you want SMS to provide

LOCSIte subcommand
the RETpd value, or when you are specifying DCbdsn=data_set_name and you
want to use the RETpd from the DCBDSN data set. If more than one of the
LOCSIte parameters (RETpd, MGmtclass, DATAClass, or DCbdsn) are
specified, the order of precedence (highest to lowest) is:
1. MGmtclass
2. RETpd
3. DCbdsn
4. DATAClass
If a retention period is associated with an SMS management or data class, or
with a model DCBDSN data set, the value of the retention period can be
overridden to another nonzero value, but it cannot be overridden to have no
retention period specified for the newly created data sets.
days
Specifies the number of days that a newly allocated data set should be
retained. The valid range is 0–9999. A value of 0 indicates a retention
period of 0 days so that the data set expires the same day as it was
created.
SBDataconn
Specifies the conversions between file system and network code pages to be
used for data transfers.
LOCSITE SBDataconn=dsname
LOCSITE SBDataconn=(file_system_cp,network_transfer_cp)
LOCSITE SBDataconn=FTP_STANDARD_TABLE
LOCSITE SBDataconn=*

dsname
Specifies the fully qualified name of an MVS data set or z/OS UNIX file
that contains the EBCDIC-to-ASCII and ASCII-to-EBCDIC translate tables
generated by the CONVXLAT utility.
Notes:
1. The name must not be enclosed in quotation marks. If quotation marks
appear, they are treated as part of the name. (QUOtesoverride is
ignored.)
2. The z/OS UNIX file system name is case sensitive. The MVS name is
not.
3. The name cannot begin with a left parenthesis [(].
4. The SBDataconn keyword must be the only keyword or the last
keyword on a LOCSIte subcommand.
file_system_cp
Specifies the name of the file system code page recognized by iconv. For a
list of code pages supported by iconv, see code set converters information
in the z/OS XL C/C++ Programming Guide.
network_transfer_cp
Specifies the network transfer code page recognized by iconv. For a list of

LOCSIte subcommand
FTP_STANDARD_TABLE
are shipped in TCPXLBIN(STANDARD), are to be used on the data
connection.
* Indicates the translate tables set up at initialization for the data connection
must be used.
SBSENDEOL
Specifies which end-of-line sequence to use when ENCODING is SBCS, the data
transfer type is ASCII, and data is being sent to the server. The following are
possible values:
CRLF
CR
translated text.
translated text.
NONE
Tip: The srestart subcommand is disabled if you configure a SBSENDEOL

value other than CRLF.
Rules:
v Most servers support only the CRLF value for incoming ASCII data. Do not
specify another value for SBSENDEOL unless you have verified that the
server is expecting the end-of-line sequence that you specify.
v Do not use an end-of-line sequence other than CRLF if the server is a z/OS
FTP server. The z/OS FTP server supports only the CRLF value for
incoming data.
v If you send a file to a server while SBSENDEOL has a value other than
CRLF, a subsequent SIZE command to that server targeting the file you sent
could yield unpredictable results. Any size indicated in the server reply for
such a file might not be reliable.
SBSUB
a single byte character translation. The substitution character is specified by the
SBSUBCHAR parameter.
SBSUBCHAR nn
Specifies the value that is used for substitution when SBSUB is also specified.
The value is one of the following:
SPACE
When the target code set is ASCII, replace untranslatable characters
with X'20' during SBCS data transfers. When the target code set is
EBCDIC, replace untranslatable characters with X'40' during SBCS data
transfers.

LOCSIte subcommand
nn Replace untranslatable characters with nn during SBCS data transfers,

where nn is a hexadecimal value in the range 00 – FF.
SECondary
Specifies the amount of tracks, blocks, or cylinders for secondary allocation.
Specify SECondary=0 when you are also specifying DATAClass=dataclass and
you want the SMS dataclass to provide the SECondary value. To enable the
SMS data class to determine the space allocation, both PRImary and
SECondary must be specified as 0. The tracks, blocks, cylinders setting is
ignored in this case. If SECondary is specified as other than 0 with DATAClass,
the value specified by the SIte SECondary parameter overrides the DATAClass
space allocation.
amount
Specifies the amount of tracks, blocks, or cylinders for secondary
allocation. The valid range is 0–16 777 215. If you specify an amount of 0,
FTP allocates without specifying secondary space.
SECUREIMPlicitzos
When the client connects using the TLSPORT implicit connection, the client
will wait for the 220 good morning reply before initiating the security
handshake and negotiation. This is the default.
SPRead
Specifies that the output is in spreadsheet format when the file type is SQL.
SQLCol
Specifies the column headings of the SQL output file.
any
The label of the DB2 SQL table column heading is the first choice for
column heading, but if there is no label, the name becomes the column
heading.
labels
Labels are the DB2 SQL table column headings. If any of the columns do
not have labels, FTP supplies a column heading in the form of COLnnn.
names
Uses the names of the DB2 SQL table column headings. The labels are
ignored.
STOrclass
Specifies the SMS storage class as defined by your organization for the target
host. Cancels the storage class specification when specified without a
storage_class parameter value. The equal sign (=) is optional in this case.
storage_class
Specifies the SMS storage class as defined by your organization for the
target host.
When an SMS storage class is in use, any of the attributes specified there
can be overridden by a different specification by the user. To avoid
overriding the setting in the SMS storage class, specify BLKSize, LRecl,
PDSTYPE, PRImary, RECfm, SECondary, UCOUNT, Unit, VCOUNT, or
VOLume with no associated value. This removes any value specified on a
prior LOCSITE command or in FTP.DATA, and the affected attributes are

LOCSIte subcommand
not included on the allocation. To override a setting in the SMS storage

class, specify the desired value with the appropriate keyword.
| TLSRFCLEVEL
| Specifies the level of RFC 4217 that the client supports for TLS-protected
| sessions. See “Using security mechanisms” on page 50 for more information.
| DRAFT
| The Internet draft revision level of RFC 4217 is supported. This is the level
| of RFC 4217 support the z/OS FTP client has offered since CSV1R2. This is
| the default value.
| Guideline: Specify this setting to use pre-V1R9 support for FTP
| TLS-protected sessions.
| RFC4217
| The FTP client will comply with RFC 4217.
| Result: The SECUREIMPLICITZOS configuration option is not affected by this

| setting.
| Note: FTP supports the TLSPORT statement regardless of the TLSRFCLEVEL

| setting. FTP connections to the TLSPORT port are implicitly secured
| with TLS as described in the Internet draft.
| Restriction: You cannot set the TLSRFCLEVEL setting to DRAFT during a
| TLS-secured session when the control connection is not secured.
TRacks
Specifies that primary and secondary space allocations are in tracks.
If both PRImary and SECondary are specified as 0 and an SMS data class has
the TRacks parameter is ignored.
TRAILingblanks
Specifies that the FTP client preserves the trailing blanks in a fixed format data
set when the data is sent to a foreign host.
TRUNcate
Specifies that truncation is permitted. The FTP client does not set an error
when a truncated record is detected and the file transfer continues.
UCOUNT
Specifies how many devices to allocate concurrently to support the allocation
request.
unit_count
Specifies number of devices to allocate. Valid value is 1–59. When specified
without a value, the FTP server does not specify a unit count when
allocating data sets.
P Parallel mount request.
Guideline: The UCOUNT statement is not meant to be used with an SMS

storage class. Any UCOUNT value you specify overrides whatever is specified
for the SMS managed dataclass being used.
UCSHOSTCS
| Specifies the EBCDIC code set to be used when converting to and from UCS-2.
If you do not specify a code_set value, the current code set is used.

LOCSIte subcommand
code_set
Name of the EBCDIC code set to be used when converting to and from
| UCS-2.
UCSSUB
| In UCS-2-to-EBCDIC conversion, the EBCDIC substitution character is used to
| replace any UCS-2 character that cannot successfully be converted. Data
transfer continues.
UCSTRUNC
| In UCS-2-to-EBCDIC conversion, truncation of EBCDIC data is allowed. The
data transfer continues even if EBCDIC data is truncated.
UMask
Defines the file mode creation mask. The file mode creation mask defines
which permission bits are not to be set on when a file is created. When a file is
created, the permission bits requested by the file creation are compared to the
file mode creation mask, and any bits requested by the file creation which are
not allowed by the file mode creation mask are turned off.
The format of the UMask keyword is UMask ooo.
When a file is created, the specified permission bits for the file are 666
(-rw-rw-rw-). If the file mode creation mask is 027, the requested permissions
and the file mode creation mask are compared:
110110110 - 666
000010111 - 027
---------
11010000 - 640
The actual permission bits set for the file when it is created is 640 (-rw-r-----).
Notes:
1. The default value for UMask is 027.
2. You cannot use FTP to create z/OS UNIX files with execute permissions. If
you require execute permissions, use the LOCSIte CHMod command to
change permissions after the file has been created.
UNICODEFILESYSTEMBOM
Specifies whether the FTP client will store incoming Unicode files with a byte
order mark (BOM).
| Restriction: The only Unicode encoding formats supported for file storage by
| z/OS FTP are UTF-8 and UTF-16. Files are always stored in big endian format.
| Result: The byte order mark (BOM) stored with the file is determined by the
| encoding used to store the file rather than by the format of the BOM sent with
| the file.
ASIS
Store incoming Unicode files with a byte order mark only if the file was
sent with a byte order mark
ALWAYS
Store incoming Unicode files with a byte order mark regardless of whether
the file was sent with a byte order mark.
NEVER
Store incoming Unicode files without a byte order mark regardless of
whether the file was sent with a byte order mark.

LOCSIte subcommand
Result: The Unicode byte order mark, U+FEFF, can also be interpreted as zero
width nonbreaking space. z/OS FTP considers only the first character of the
file as a possible byte order mark. No other instance of the BOM sequence in
the file is affected by this setting.
Unit
Specifies the unit type for allocation of new data sets.
unit_type
The unit type (for example, 3380) for the allocation of new data sets on
direct access devices. If unit_type is not specified, the unit type used for
allocation is set back to the system default.
VCOUNT
| Specifies the number of tape data set volumes that an allocated data set can
span. When this parameter is specified without a volume_count value, the FTP
| server uses the volume count 50 when it allocates tape data sets.
volume_count
Valid values are in the range 1–255.
VOLume
Specifies the volume serial number for allocation of new data sets.
volume_serial
The serial number of the volume to use for allocation.
volume_serial_list
A list of one or more volume serial numbers for allocation. Delimit each
volume serial number from the previous one with a comma.
If VOLume is specified without a volume_serial_list or volume_serial parameter,

no volumes are specified by the FTP client during the allocation of a new data
set, and the installation default is used.
WRAPrecord
Indicates that data is wrapped to the next record if no new line character is
encountered before the logical record length of the receiving file is reached.
WRTAPEFastio
Indicates that ASCII Stream data that is being written to tape is allowed to be
written using BSAM I/O.
Usage
v Because more than one parameter can be specified with the LOCSIte
subcommand, parameter can be repeated many times, with each parameter
separated by a blank space.
v Issue the HElp LOCSIte subcommand to display a list of services available on
the local host.
v The site-dependent information set with the LOCSIte subcommand remains
active until you issue a new LOCSIte subcommand. The new LOCSIte
subcommand adds to or changes the parameters established by previous
LOCSIte subcommands.
v If you specify one or more incorrect parameters with the LOCSIte subcommand,
an error message specifying the incorrect parameter is displayed. All correct
parameters are set, regardless of any incorrect parameters, and do not need to be
reissued.

LOCSIte subcommand
Context
v See “HElp and ? subcommands—Display help information” on page 186 for
more information about the HElp subcommand.
v To check the effect of the LOCSIte command on the attributes at the local host,
see “LOCSTat subcommand—Display local status information” on page 218.

LOCSTat subcommand
LOCSTat subcommand—Display local status information
Purpose
Use the LOCSTat subcommand to display local status information.
Tip: Issuing the LOCSTat subcommand with no parameters causes all local status
to be displayed. To display local status for a single configuration option, issue the
LOCSTat subcommand with at least one parameter.
Format
LOCSTat
option
options:

LOCSTat subcommand
| ASAtrans
AUTOMount
AUTORecall
BLocks
BLOCKSIze
BUfno
CConntime
CHKptint
CHKPTrefix
CONDdisp
CYlinders
DATAClass
DATACTtime
DATASetmode
DB2
DBSUB
DCbdsn
DCOnntime
Directory
DIRECTORYMode
ENcoding
EPSV4
FILEtype
FTpkeepalive
FWFriendly
INacttime
ISPFStats
LISTSUBdir
LRecl
MBdataconn
MBREQUIRELASTEOL
MBSENDEOL
MGmtclass
MIGratevol
MYopentime
PDSTYPE
PRImary
QUOtesoverride
RDw
READTAPEFormat
RECfm
RESTGet
RETpd
SBDataconn
SBSENDEOL
SBSUB
SBSUBChar
SECondary
SECUREIMPlicitzos
SPRead
SQLCol
STOrclass
TLSRFCLEVEL
TRacks
TRAILingblanks
TRUNcate
UCOUNT
UCSHostcs
UCSSub
UCSTrunc

LOCSTat subcommand
UMask
Unit
VCOUNT
VOLume
WRAPrecord
WRTAPEFastio
Parameters
ASAtrans
Indicates that the FTP client interprets characters in the first column of ASA
files that are being transferred as print control characters.
AUTOMount
Indicates automatic mounting of volumes for data sets that are on unmounted
volumes.
AUTORecall
Indicates automatic recall of migrated data sets.
BLocks
Indicates that primary and secondary space allocations are in blocks.
BLOCKSIze
Indicates the block size of a newly allocated data set.
BUfno
Indicates the number of access method buffers that is used when data is read
from or written to a data set.
CConntime
Indicates the length of time that the FTP client waits after attempting to close a
control connection before terminating it and reporting an error.
CHKptint
Specifies the checkpoint interval for the sending site in a file transfer request.
CHKPTPrefix
Specifies a key that is used to determine the high-level qualifier of the
checkpoint data set.
CONDdisp
CYlinders
Indicates that primary and secondary space allocations are in cylinders.
DATAClass
Specifies the SMS data class.
DATACTtime
Specifies the length of time that the FTP client waits after attempting to send
or receive data before terminating the connection and reporting an error to the
user.
DATASetmode
Indicates whether DATASetmode or DIRECTORYMode is in effect.
DB2

LOCSTat subcommand
DBSUB
Indicates that substitution is allowed for data bytes that cannot be translated in
a double-byte character translation.
DCbdsn
Specifies the name of the MVS data set to be used as a model for allocating
new data sets.
DCOnntime
Specifies the amount of time that FTP waits attempting to close a data transfer
before terminating the connection and reporting an error.
Directory
partitioned data set (PDS).
DIRECTORYMode
ENCODING
Specifies the kind of encoding that is used for conversions between code pages
for data transfers.
EPSV4
Indicates that the client will attempt to use the EPSV command to establish a
data connection on an IPv4 session instead of referring to the FWFRIENDLY
setting.
FILEtype
FTpkeepalive
Specifies the control connection keepalive timer value in seconds.
FWFriendly
Indicates that the FTP client is firewall-friendly.
INacttime
Specifies the length of time that the FTP client waits for an expected response
from the server, on either the control or the data connection, before closing the
session.
ISPFSTATS
Indicates whether FTP will create or update ISPF Member statistics when Get
or MGet subcommands are issued.
LISTSUBdir
Indicates that wildcard searches should apply to the current working directory
and should also span its subdirectories.
LRecl
Specifies the logical record length (LRecl) of a newly allocated data set.
MBDATACONN
Specifies the code pages for the file system and for the network transfer that
are used when the client does data conversion during a data transfer.
MBREQUIRELASTEOL
Indicates whether the last record of an incoming multibyte transfer is required
to have an EOL sequence.
TRUE
A missing EOL on the last record received is treated as an error.

LOCSTat subcommand
FALSE
A missing EOL on the last record received is ignored.
MBSENDEOL
Specifies which end-of-line sequence to use when the ENCODING value is
SBCS, the data is ASCII, and data is being sent to the server.
MGmtclass
Specifies the SMS management class.
MIGratevol
management systems.
MYopentime
Specifies the length of time that the FTP client waits for a session to open
before terminating the attempt and reporting an error.
PDSTYPE
Indicates whether the FTP client creates local MVS directories as partitioned
PRImary
Specifies the number of tracks, blocks, or cylinders for the primary allocation.
QUOtesoverride
Indicates that a single quotation mark at the beginning and end of a file name
RDW
Indicates that variable record descriptor words (RDWs) are treated as if they
are part of the record and are not discarded during FTP transmission of
variable format data sets.
READTAPEFormat
Specifies information about an input data set on tape.
RECfm
Specifies the data set record format.
RESTGet
Indicates that opening the checkpoint data set for the Get request is allowed.
RETpd
retained.
SBDataconn
SBSENDEOL
Specifies which end-of-line sequence to use when ENCODING is SBCS, the
data is ASCII, and data is being sent to the client.
SBSUB
a single byte character translation.
SBSUBCHAR

LOCSTat subcommand
SECondary
Specifies the number of tracks, blocks, or cylinders for a secondary allocation.
SECUREIMPlicitzos
Specifies that when the client connects using the TLSPORT implicit connection,
the client will wait for the 220 good morning reply before initiating the security
handshake and negotiation.
SPRead
Indicates that the output is in spreadsheet format when the file type is SQL.
SQLCol
Indicates the SQL output file column headings.
STOrclass
Indicates the SMS storage class.
| TLSRFCLEVEL
| Indicates the level of RFC 4217, On Securing FTP with TLS, that is supported by
| the client.
TRacks
Indicates that primary and secondary space allocations are in tracks.
TRAILingblanks
Indicates that the FTP client preserves the trailing blanks in a fixed-format data
TRUNcate
Indicates that truncation is permitted.
UCOUNT
request.
UCSHOSTCS
Specifies the EBCDIC code set to be used when converting to and from
Unicode.
UCSSUB
Indicates that in Unicode-to-EBCDIC conversion, the EBCDIC substitution
character is used to replace any Unicode character that cannot be successfully
converted.
UCSTRUNC
Indicates that in Unicode-to-EBCDIC conversion, EBCDIC data truncation is
allowed.
UMask
Specifies the file mode creation mask.
Indicates whether the FTP client will store incoming Unicode files that have a
byte order mark.
Unit
VCOUNT
span.
VOLume

LOCSTat subcommand
WRAPrecord
Indicates that data is wrapped to the next record if no new-line character is
WRTAPEFastio
Indicates that ASCII stream data that is being written to tape can be written
using BSAM I/O.
Examples
The following is an example of the output from the LOCSTat subcommand, issued
with a single parameter:
Command: locstat dconntime
DCONNTIME is 120
Command:
The following example shows part of the output from a LOCSTat subcommand.
Command: locstat
Trace: FALSE, Send Port: TRUE
Send Site with Put command: TRUE
Connected to:9.67.113.57, Port: 6321, logged in
Local Port: 1045
Proxy connection to:9.67.112.25, Port: 6121, logged in
Proxy Local Port: 1046
Data type:a, Transfer mode:s, Structure:f
Automatic recall of migrated data sets.
Automatic mount of direct access volumes.
Data set mode. (Do not treat each qualifier as a directory.)
Primary allocation 2 cylinders, Secondary allocation 3 cylinders
Partitioned data sets will be created with 23 blocks
FileType is SEQ (Sequential - the default).
Number of access method buffers is 1.
Mgmtclass for the new data sets is MGMT1
Storclass for the new data sets is STOR1
Dataclass for the new data sets is DATA1
RDW’s from VB/VBS files are retained as part of data.
Retention period is 2
DB2 subsystem name is DB2
Volid of Migrated Data Sets is MIGRAT
Data sets will be allocated like data set ’USER33.TEST.S.A’
Trailing blanks in records read from RECFM F data sets are discarded.
Record format: FB, Lrecl: 80, Blocksize: 8000.
Data sets will be allocated on CPDLB0
Data sets will be allocated using unit SYSDA
Wrapping data into next record.
Checkpoint interval is 10000
Prompting: ON, Globbing: ON
ASA control characters transferred as C control character sequences
New data sets deleted if a store operation terminates abnormally
Single quotes will override the current working directory
UMASK value is 027
Using ’USER33.FTP.DATA’ for local site configuration parameteres
Command:

LMkdir subcommand
LMkdir subcommand—Create a directory on the local host
Purpose
Use the LMkdir subcommand to create a PDS, PDSE, or z/OS UNIX file system
directory on the local host. This subcommand provides you with an easy way to
create a directory in the local host for data transfer.
Format
LMkdir directory
( like remote_directory
Parameters
directory
Specifies the name of the PDS, PDSE, or z/OS UNIX file system directory to be
created.
remote_directory
Specifies the name of a remote MVS PDS or PDSE that is to be a model for the
directory to be created. This parameter is valid only when directory is a PDS or
PDSE name. If you specify this parameter, the local site variables will change,
and FTP will open and read the remote data set.
Examples
In this example, before LMkdir is issued, the local host had the following data sets:
v MVSUSER.ISPF.ISPPROF
v MVSUSER.JCL.CNTL
v MVSUSER.SMFTEST
v MVSUSER.TCPIP.DATA
User: ftp 1.1.2.3
System: IBM FTP CS/390 V2R10 1997 314 01:11 UTC
220-EZAFTSRV IBM CS/390 V2R10 at EMU.ABC.OZ, 17:04:12 on 08/03/97
User: mvsuser
System: >>>USER mvsuser
Password:
>>>PASS ********
230 MVSUSER is logged on.
Command:
User: lpwd
System: Local directory is MVSUSER.
Command:
User: lcd ftp
System: Local directory name set to MVSUSER.FTP.
Command:
User: lmkdir example
System: MVSUSER.FTP.EXAMPLE created.
Command:

LMkdir subcommand
MVSUSER.FTP.EXAMPLE has now been created. You can the same result directly with
the LMKDIR ’MVSUSER.FTP.EXAMPLE’ command.
This example illustrates the use of the (like parameter:

Command:
lmkdir ’mvsuser.example.linklib’ (like ’sys1.linklib’
>>> XDSI ’sys1.linklib’
200 SITE PDSTYPE=PDS RECFM=U BLKSIZE=32760 DIRECTORY=800 LRECL=0 PRIMARY=482 SECONDARY=30 CYLINDERS
local site variables have changed
MVSUSER.EXAMPLE.LINKLIB created.
Command:
After the LMkdir subcommands were issued, the local host had the following data
sets under MVSUSER:
v MVSUSER.FTP.EXAMPLE
v MVSUSER.ISPF.ISPPROF
v MVSUSER.JCL.CNTL
v MVSUSER.SMFTEST
v MVSUSER.TCPIP.DATA
v MVSUSER.EXAMPLE.LINKLIB
Usage
v FTP provides no subcommand to display a list of local directory entries. You
should use TSO ISPF facility to check whether the directory is created by the
LMkdir subcommand.
v If you are running FTP in a z/OS UNIX environment, you can use the !
subcommand to check the status of z/OS UNIX file system directories.
v The directory value is appended to the local current working directory to form
the name of the created PDS, PDSE, or z/OS UNIX file system directory. To
override the local current working directory, specify an absolute z/OS UNIX file
system path name:
/directory
or a fully qualifed name in quotes:

’directory’
When directory is a PDS or a PDSE name, the data set characteristics of the
newly allocated PDS or PDSE are determined by the settings of the local site
variables.
v You can use the (like parameter of the lmkdir subcommand to specify a PDS or
PDSE on the server host that has characteristics you want the local directory to
have.
– The (like option is valid only when both client and server are z/OS V1R5 or
later, and the working directory for both the client and server is an MVS high
level qualifier (HLQ).
– If you use the (like parameter, the local site variables will change.
– The FTP client will set the local site variables for you so the new PDS or
PDSE is created with characteristics similar to the remote directory. The client,
however, can approximate only certain characteristics of the data set such as
space type, primary, and secondary. For complete control over these
characteristics, do not use the (like parameter.
– FTP must open and read the remote directory to determine its characteristics.
If this is not acceptable, do not use the (like parameter.

LMkdir subcommand
– Only the 3390 device architecture is supported. If the (like parameter is used
for directories residing on other types of devices, unpredictable results will
occur. Use of the (like parameter when the source or target directories do not
reside on a 3390 architecture device is not recommended.
– If the remote data set is migrated, the server will inspect the AUTORECALL
setting to determine whether to recall the data set or fail the request. If
AUTORECALL is true, FTP will attempt to recall the data set; otherwise it
will fail the request. Similarly, if the remote data set is not mounted, the
server will inspect the AUTOMOUNT setting to determine whether to mount
the data set or fail the request. If AUTOMOUNT is true, the server will
attempt to mount the data set; otherwise, it will fail the request. You can
change the server’s AUTOMOUNT and AUTORECALL settings with the SITE
subcommand. Choosing AUTOMOUNT or AUTORECALL could result in a
long delay as the server waits for the data set to become available.
Context
v See “LOCSIte subcommand—Specify site information to the local host” on page
195 and “LOCSTat subcommand—Display local status information” on page 218
for information about setting and displaying the data set characteristics.
v See “SIte subcommand—Send site-specific information to a host” on page 270
for information about setting the AUTOMOUNT and AUTORECALL values.

LPwd subcommand
LPwd subcommand—Display the current working-level qualifier
Purpose
Use the LPwd subcommand to display the name of the current working directory
on the local host.
Format
LPwd
Parameters
Examples
Display the name of the current working directory:
lpwd
Local directory is partitioned data set USER14.FTP.TEST1.
Command:

LS subcommand
LS subcommand—Obtain a list of file names
Purpose
Use the LS subcommand to list only the names of a set of remote files, file group,
or directory.
Format
LS
name ( Disk
Parameters
name
Specifies the set of remote files whose names are to be listed. The default is the
entire current directory or file group.
Disk
Stores the results of the LS subcommand in the user_id.FTP.LSOUTPUT data
set. The results are not displayed on the screen.
Note: If the local current working directory is a z/OS UNIX file system
directory, the results are stored in a file named LSOUTPUT.
Results:
is as if the LISTSUBdir option was specified on the SITE subcommand.
2. If the z/OS FTP server has the NOLISTSUBdir option specified on the SITE
subcommand or has LISTSUBDIR FALSE specified in the server FTP.DATA file,
an ls * command will list only the files in the current directory.
Examples
Example 1: The following is a sample response that is displayed as a result of the
LS subcommand.
>>>PORT 9,67,58,227,4,63
>>>NLST
A.X
CHR.TXT
OBEY.TCPIP
PROFILE.EXEC
SPF.ISPPROF
USERTRAN.TCPXLBIN
Command:
The following is a sample entry and the response that is displayed as a result of
the LS subcommand listing z/OS UNIX files.

LS subcommand
Command:
ls
>>>PORT 9,67,112,25,4,62
>>>NLST
125 List started OK
append02
file1
file2
file3
file4
file5
Command:
Example 2: ls * with SITE LISTSUBdir
Following is an example of ls * with SITE LISTSUBdir. This setting affects

to the server as part of ls * subcommand processing. The LISTSUBdir option
specifies that not only the current subdirectory, but also the next subdirectory
should be listed as a result of processing an ls * subcommand. In this example, the
current directory has a file x and a subdirectory y and subdirectory y has a file x.
site listsubdir
>>> SITE listsubdir
ls *
>>> PORT 127,0,0,1,4,17
>>> NLST *
125 List started OK
x
y/x
Command:
Example 3: ls * with SITE NOLISTSUBdir
Following is an example of ls * with SITE NOLISTSUBdir. This setting affects

to the server as part of ls * subcommand processing. The NOLISTSUBdir option
specifies that only the current directory should be listed as a result of processing
an ls * subcommand. In this example, the current directory has a file x and a
subdirectory y and subdirectory y has a file x.
site Nolistsubdir
>>> SITE Nolistsubdir
ls *
>>> PORT 127,0,0,1,4,18
>>> NLST
125 List started OK
x
y
Command:

LS subcommand
Usage
v To make a file group the current working directory, use the CD subcommand.
The method you use to specify a directory or file group is host-dependent.
v You can use special characters for pattern matching when specifying the name.
These characters depend on the host FTP server. See “DIr subcommand—Obtain
a list of directory entries” on page 168 for information about using special
characters with the z/OS FTP server.
v If the current local directory is a PDS, only a member named LSOUTPUT is
created. If the current local directory is not a PDS, the local directory, not the
user ID, is used as the high-level qualifier for the data set name.
v If the local current working directory is a z/OS UNIX file system directory, the
results are stored in a file named LSOUTPUT.
v LS lists entries only for data sets and file types that FTP can process (see
Appendix A, “Specifying data sets and files,” on page 429 for a list). GDG base,
VSAM, and ATL library entries are among the types not included in the LS
output. See “DIr subcommand—Obtain a list of directory entries” on page 168 to
list entries for all types of data sets or files.
Context
information about pattern matching and about specifying data sets and files.
v To make a file group the current working directory, see “CD
subcommand—Change the directory on the remote host” on page 153.
v To a list of complete directory entries with auxiliary information about the files,
see “DIr subcommand—Obtain a list of directory entries” on page 168.
v To change the local directory, see “LCd subcommand—Change the local working
directory” on page 193.

MDelete subcommand
MDelete subcommand—Delete multiple files
Purpose
Use the MDelete subcommand to delete multiple files.
Format
MDelete foreign_file
Parameters
foreign_file
Specifies the name of the file to be deleted on the remote host.
Because more than one file can be deleted with the MDelete subcommand, the
foreign_file parameter of the MDelete subcommand can be repeated many
times, with each foreign_file separated by a blank space.
Results:
1. At the end of the report, Netstat displays the host name that the resolver used
for the resolution and the list of IP addresses returned from the resolver that it
used as filters.
is as if LISTSUBdir option was specified on the SITE subcommand.
3. If the z/OS FTP server has the NOLISTSUBdir option on the SITE
subcommand or LISTSUBDIR FALSE in the server FTP.DATA file, an MDelete *
deletes only the files in the current directory.
Examples
Example 1: Following is a sample entry and the response that is displayed as a
result of the MDelete subcommand for multiple z/OS UNIX files.

MDelete subcommand
Command:
mdelete file1 file2 file3
>>>PORT 9,67,112,25,4,75
>>>NLST file1
125 List started OK
>>>PORT 9,67,112,25,4,77
>>>NLST file2
125 List started OK
>>>PORT 9,67,112,25,4,76
>>>NLST file3
125 List started OK
>>>DELE file1
250 /u/user121/ftp.example/file1 deleted.
>>>DELE file2
>>>DELE file3
Command:
Example 2: MDelete * with SITE LISTSUBdir
Following is an example of MDelete * with the SITE LISTSUBdir option. This

setting affects processing of the NLST command. The z/OS FTP client sends an
NLST command to the server as part of MDelete * subcommand processing. The
LISTSUBdir option specifies that both the current and the next subdirectory should
be deleted as a result of processing an MDelete * subcommand. In this example,
the current directory has a file x and a subdirectory y and subdirectory y has a file
x.
site listsubdir
>>> SITE listsubdir
prompt
Command:
mdelete *
>>> PORT 127,0,0,1,4,15
>>> NLST *
125 List started OK
>>> DELE x
250 /tmp/mgetmput/x deleted.
>>> DELE y/x
250 /tmp/mgetmput/y/x deleted.
Command:
Example 3: MDelete * with SITE NOLISTSUBdir
Following is an example of MDelete * with the SITE NOLISTSUBdir option. This

setting affects processing of the NLST command. The z/OS FTP client sends an
NLST command to the server as part of MDelete * subcommand processing. The
NOLISTSUBdir option specifies that only the current directory should be deleted

MDelete subcommand
as a result of processing an MDelete * subcommand. In this example, the current

directory has a file x and a subdirectory y and subdirectory y has a file x.
site Nolistsubdir
>>> SITE Nolistsubdir
prompt
Command:
mdelete *
>>> PORT 127,0,0,1,4,15
>>> NLST *
125 List started OK
>>> DELE x
250 /tmp/mgetmput/x deleted.
Command:
Usage
v If you specify one or more incorrect foreign files with the MDelete subcommand,
an error message specifying the incorrect foreign file is displayed. All correct
foreign files are deleted, regardless of any incorrect foreign files, and the
MDelete subcommand does not need to be reissued for these files.
v z/OS UNIX file names require special handling for certain special characters. All
special characters that the operating system requires to be preceded by an escape
character in commands issued to the shell must be preceded by the backslash (\)
escape character, except for the single quote (’), double quote (”), or blank ( ).
Context
See Appendix A, “Specifying data sets and files,” on page 429 for more information
about naming conventions.

MGet subcommand
MGet subcommand—Copy multiple files
Purpose
Use the MGet subcommand to copy multiple files from a remote host to your local
host and create a corresponding number of local files.
Format
MGet foreign_file
( REPLACE
Parameters
foreign_file
Because more than one file can be copied with the MGet subcommand, the
foreign_file parameter of the MGet subcommand can be repeated many times,
with each foreign_file separated by a blank space. You can use special characters
for pattern matching when specifying the foreign_file with the MGet
subcommand. These characters are dependent on the foreign host FTP server.
REPLACE
Causes a data set on your local host to be overwritten if it already exists. If the
data set already exists, and you do not use the replace parameter, the existing
data set is not overwritten. A message informing you of this is displayed.
If the data set already exists and you specify REPLACE, the data in the file is
overwritten, but not reallocated. This means the local data set retains its
existing characteristics.
Examples
The following is a sample entry and response that is displayed as a result of the
MGet subcommand for multiple z/OS UNIX files.

MGet subcommand
Command:
mget file1 file2 file3
>>>PORT 9,67,112,25,4,90
>>>NLST file1
125 List started OK
>>>PORT 9,67,112,25,4,91
>>>NLST file2
125 List started OK
>>>PORT 9,67,112,25,4,92
>>>NLST file3
125 List started OK
>>>PORT 9,67,112,25,4,93
>>>RETR file1
3464 Bytes transferred in 1.031 seconds. Transfer rate 3.36 kbytes/sec.
>>>PORT 9,67,112,25,4,94
>>>RETR file2
>>>PORT 9,67,112,25,4,95
>>>RETR file3
Command:
MGet subcommand using a wildcard character in the file name.

MGet subcommand
Command:
mget file*
>>>PORT 9,67,113,57,5,123
>>>NLST file*
125 List started OK
Mget file1 (Yes|No|Quit|Stop prompting)? s
>>>PORT 9,67,113,57,5,124
>>>RETR file1
125 Sending data set /u/user31/file1
>>>PORT 9,67,113,57,5,125
>>>RETR file2
>>>PORT 9,67,113,57,5,126
>>>RETR file3
Command:
Usage
v When you use the MGet subcommand, FTP might truncate data records and you
might lose data if:
– You are creating a new data set at the client and the value of LRecl, as shown
by the LOCSTat command, is a value less than the LRecl of a received data
set, FTP truncates the received data set.
– The data set name already exists at the client and the logical record length
(LRecl) of the data set at the client is less than the LRecl of the transmitted
data set, FTP truncates the transmitted data set.
You can encounter this situation when you use MGet with the REPLACE
option.
v If the name specified for foreign_file is not acceptable to your local host, the file is
not transferred. To a file from the remote host, you must have a defined working
directory on that host, and you must have read privileges to the files in this
working directory.
v If you specify one or more incorrect foreign files with the MGet subcommand,
an error message specifying the incorrect foreign file is displayed. All correct
foreign files are retrieved, regardless of any incorrect foreign files, and do not
need to be reissued.
v z/OS UNIX file names require special handling for certain special characters.
Except for single quote (’), double quote (”), or blank ( ), all special characters
that the operating system requires to be preceded by an escape character in
commands issued to the shell must be preceded by the backslash (\) escape
character.
v The MGet subcommand is not applicable to generation data groups (GDGs).
v The MGet subcommand can be used with the PROXy subcommand to transfer
files from a host on a primary connection to a host on a secondary connection.
See “PROXy subcommand—Execute FTP subcommand on secondary control
connections” on page 252 for more information.
v If the data set is migrated, it will be replaced regardless of the replace option.

MGet subcommand
v The MGet subcommand removes all directory information from remote file
names. This causes all the files to be saved in the same z/OS UNIX file system
directory when transferring into a z/OS UNIX file system. The directory
structure of the remote host will not be preserved.
v If the LISTSUBdir option is not specified on the SITE subcommand and the
is as if LISTSUBdir option was specified on the SITE subcommand.
v If the z/OS FTP server has the NOLISTSUBdir option specified on the SITE
subcommand or has LISTSUBDIR FALSE specified in the server FTP.DATA file,
an mget * command will get only the files in the current directory.
v The LISTSUBdir option applies to z/OS UNIX file operations only; MVS data set
operations are not affected.
Context
for more information about working directories.

MKdir subcommand
MKdir subcommand—Create a directory on the remote host
Purpose
Use the MKdir subcommand to create a directory on the remote host.
Format
MKdir directory
( like local_directory
Parameters
directory
Specifies the name of the directory to be created.
local_directory
Specifies the name of a local directory that is to be a model for the remote
directory. local_directory must be an MVS directory. If you specify this
parameter, the remote site variables will change, and local_directory will be
read.
Examples
In this example, a directory is created on the remote host (1.1.2.3 in this example).
Both EXAMPLE and FTP.EXAMPLE are created in the remote host, showing the
difference between specifying and omitting quotation marks in the directory name.
User: ftp 9.67.113.24.621
System: IBM FTP CS V1R5
FTP: using TCPCS
FTP.DATA FILE NOT FOUND. USING HARDCODED DEFAULT VALUES.
220-EZAFTSRV IBM FTP CS V1R2 at EMU.ABC.OZ, 15:34:32 on 2000-08-03.
User: user121
System: >>>USER user121
Password:
User:
>>>PASS ********
230 USER121 is logged on. Working directory is ’/u/user121".
Command:

MKdir subcommand
User: dir
System: >>>PORT 9,67,112,25,4,96
>>>LIST
total 2768
Command:
User: mkdir example

System: >>>MKD example
257 "/u/user121/example" created.
Command:
User: dir
System: >>>PORT 9,67,112,25,4,97
>>>LIST
total 2768
drwxr-xr-- 2 USER121 SYS1 0 Feb 7 19:57 example
Command:
User: mkdir ’/u/user121/ftp.example’

System: >>>MKD ’/u/user121/ftp.example’
257 "/u/user121/ftp.example" created.
Command:
User: dir
System: >>>PORT 9,67,112,25,4,98
>>>LIST
total 2800
drwxr-x--- 2 USER121 SYS1 0 Feb 7 19:57 example
drwxr-x--- 2 USER121 SYS1 0 Feb 7 19:57 ftp.example
Command:
Usage
v The MKdir subcommand sends a request to the remote host FTP server to create
a directory with name directory in the current working directory. When the
request is sent to an MVS server, a PDS or PDSE is created if either a fully
qualified MVS data set name is entered (for example, ’USER33.TEST.PDS’), or if

MKdir subcommand
the current working directory is an MVS data set name. For example, if the
current working directory is USER33.TEST, a command MKdir PDS creates a
PDS or PDSE named USER33.TEST.PDS.
v For an MVS server, the data set characteristics used to allocate the new PDS or
PDSE are determined by the settings of the SIte parameters of the server.
v You can use the (like parameter on the MKdir subcommand to specify a local
MVS directory that has characteristics you want the remote directory to have.
– The (like option is valid only if both client and server are z/OS, and the
current working directory for both client and server is an MVS high level
qualifier (HLQ).
– The client will send a SITE command to the server for you so that the new
directory is similar to the local directory. The client, however, can
approximate only certain characteristics of the directory such as space type,
primary, and secondary. For complete control over these characteristics, do
not use the (like parameter. The SITE command will change the remote site
variables to match the characteristics of the existing directory. For complete
control over the remote site variables, do not use the (like parameter.
– Only the 3390 device architecture is supported. Unpredictable results will
occur if the source or target directory reside on devices that use a different
architecture.
– FTP must read the local directory to determine its characteristics. Do not use
the (like parameter if this is not acceptable.
– The sendsite setting is ignored when the (like parameter is specified. The
client will send a SITE command to the server to change the remote site
variables.
– The (like option is recommended for interactive use only.
– If the local data set is migrated, FTP will check the local AUTORECALL
setting to determine whether to recall the data set or fail the request. If
AUTORECALL is true, FTP will try to recall the migrated data set. If
AUTORECALL is false, FTP will fail the mkdir request. You can change the
current AUTORECALL setting with the locsite subcommand. Choosing
AUTORECALL might result in a long delay as the server waits for the data
set to become available.
– If the local data set is not mounted, FTP checks the local AUTOMOUNT
setting to determine whether to mount the data set or fail the request. If
AUTOMOUNT is true, FTP tries to mount the data set. If AUTOMOUNT is
false, FTP fails the mkdir request. You can change the current AUTOMOUNT
setting with the locsite subcommand. Choosing AUTOMOUNT might result
in a long delay as the server waits for the data set to become available.
Context
v See “SIte subcommand—Send site-specific information to a host” on page 270
for information about setting the SIte parameters.
v See “STAtus subcommand—Retrieve status information from a remote host” on
page 301 for information about displaying the SIte parameters.
v See “SENDSite subcommand—Toggle the sending of site information” on page
269 for information about SENDSite subcommand.
195 for information about changing the AUTORECALL and AUTOMOUNT
settings.

MOde subcommand
MOde subcommand—Set the data transfer mode
Purpose
Use the MOde subcommand to define how bits of data are to be transmitted.
Format
MOde B
C
S
Parameters
B Sets the block mode. In block mode, data is transmitted as a series of data
blocks, preceded by one or more header bytes. Block mode preserves the
logical record boundaries of the data set or file. When MOde is set to B, the
data transfer type must be EBCDIC.
Specifying MOde B is equivalent to specifying the BLock subcommand.
C Sets the compressed mode. In compressed mode, data is transmitted as a series
of data blocks, preceded by one or more header bytes. Compressed mode
preserves the logical record boundaries of the data set or file. In compressed
mode, data is transmitted without repetitive characters and blanks. When
MOde is set to C, the data transfer type must be EBCDIC.
Note: Because additional processing time is required for both the sender and
receiver to compress or decompress the data, evaluate the time factor
before you compress a file.
Specifying MOde C is equivalent to specifying the COMpress subcommand.
S Sets the stream mode. In stream mode, data is transmitted as a stream of bytes.
Any data transfer type can be used with stream mode. Stream mode is efficient
because data block information is not transferred.
Specifying MOde S is equivalent to specifying the STREam subcommand.
Usage
v To use MOde C, the receiving host must support the compressed data mode.
v Data compression increases CPU processing costs even if the amount of data
transferred is not large.
Context
v For the syntax of the BLock, COMpress, and STREam subcommands, see “BLock
subcommand—Set the block data transfer mode” on page 151, “COMpress
subcommand—Set the compressed data transfer mode” on page 160, or
“STREam subcommand—Set the stream data transfer mode” on page 308.
v For more information about transfer methods, see Table 13 on page 55.
Tip: Use MODE B or MODE C in conjunction with a CHKConfidence value of

TRUE in FTP.DATA to improve detection of incomplete file transfers.

MPut subcommand
MPut subcommand—Copy multiple data sets to the remote host
Purpose
Use the MPut subcommand to copy multiple data sets from your local host to the
remote host.
Format
MPut local_data_set
Parameters
local_data_set
Specifies the name of the file on your local host being sent to the remote host.
Because more than one data set can be copied with the MPut subcommand,
the local_data_set parameter of this subcommand can be repeated many times,
with each local_data_set separated by a blank space. You can use the asterisk (*)
character for pattern matching when specifying the local_data_set with the
MPut subcommand.
When the wildcard symbol (*) is used in the filename parameter, and the
GLOB subcommand is set to expand metacharacters in file names, the
LISTSUBdir option affects the result of MPut. For more information about the
LISTSUBdir option, see “LOCSIte subcommand—Specify site information to
the local host” on page 195, or the LISTSUBDIR statement (FTP client and
server) in z/OS Communications Server: IP Configuration Reference.
Examples
MPut subcommand to send selected files.

MPut subcommand
Command:
mput file*
Mput FILE1 (Yes|No|Quit|Stop prompting)? yes
>>>PORT 9,67,113,57,5,128
>>>STOR FILE1
125 Storing data set /u/user31/temp/FILE1
Mput FILE2 (Yes|No|Quit|Stop prompting)? no
>>>PORT 9,67,113,57,5,129
>>>STOR FILE3
Command:
dir
>>>PORT 9,67,113,57,5,130
>>>LIST
125 List started OK
total 16
-rw-r----- 1 USER31 SYS1 162 Aug 14 13:20 FILE1
-rw-r----- 1 USER31 SYS1 162 Aug 14 13:21 FILE3
Command:
Usage
and a server. However, when you use the MPut subcommand, FTP might
truncate data records and you might lose data, if:
– You are creating a new file at the server and the value of LRecl, as shown by
the STAtus subcommand, is a value less than the LRecl of the transmitted
data set and SENDSite has been set to OFF, FTP truncates the transmitted
data set.
– The data set name already exists at the receiving site and the logical record
transmitted data set, FTP truncates the transmitted data set.
v By default, if you use the MPut subcommand, the remote host creates files with
the same names as those specified in local_data_set and overwrites any existing
files with those names.
To put files on the remote host with unique file names, you must have set
unique storage on before issuing the MPut command. Use the SUnique
subcommand to change the storage method.
v To send a data set to the remote host, you must have a defined working
directory on the remote host and write privileges to the files in this working
directory.
v If you specify one or more incorrect parameters with the MPut subcommand, an
error message specifying the incorrect parameter is displayed. All correct files
are transferred, regardless of any incorrect parameters, and do not need to be
reissued.
v The MPut command is not applicable to GDGs.
Context
v See “SUnique subcommand—Changes the storage method” on page 310 for
information about changing the storage method on the remote host.

MPut subcommand
v MPut can be used with the PROXy subcommand to transfer files from a host on
a secondary connection to a host on a primary connection. See “PROXy

NOop subcommand
NOop subcommand—Test the connection
Purpose
Use the NOop subcommand to determine whether the foreign host is still
responding.
Format
NOop
Parameters
Examples
v If the foreign host is responding, you receive one of the following responses:
200 OK or 200 NOOP command successful.

v If the foreign host does not respond or is not connected, you receive appropriate
error messages, such as:
EZA1534I Control connection with ipaddr dies.

EZA1457I You must first issue the ’OPEN’ command.
Usage
You can use the NOop command to keep a connection alive that would otherwise
be disconnected if it were idle for longer than the system timeout period.

Open subcommand
Open subcommand—Connect to the FTP server
Purpose
Use the Open subcommand to open a connection to the remote host FTP server in
the following situations:
v If, after closing a connection, you want to open another connection without
leaving the FTP environment.
v If you were unable to open a connection when you specified a foreign_host value
with the FTP command.
Format
21
Open host_name
port_number
Parameters
host_name
| Specifies the host name or IP address of the foreign host. When using IPv6
| link-local addresses, you can provide scope information along with the host
| name or IP address, as described in the support for scope information in the
| z/OS Communications Server: IPv6 Network and Application Design Guide.
port_number
Identifies a port on the foreign host. The default is well-known port 21.
Usage
If you are already connected to a host, you must disconnect from the host before
you can connect to a different host with the Open subcommand. The only
exception to this is if you are using the PROXy Open command. See “PROXy
Context
See “CLose subcommand—Disconnect from a remote host” on page 159 for more
information about closing a connection.

PAss subcommand
PAss subcommand—Supply a password
Purpose
Use the PAss subcommand to supply a password to a host.
Format
PAss password
/newpass/newpass :userdata

account_information
Parameters
password
Specifies your password on the remote host.
/newpass/newpass
Resets a password.
:userdata
The optional user data must be separated from the password information by a
colon (:) and can be any combination of up to 200 nonblank characters and
numbers except the colon. Care should be taken when using the backslash
character (\) in combination with other characters which might be interpreted
as an escape sequence by the C compiler.
account_information
An optional parameter that will be supplied to the remote FTP server if the
server requests account information after receiving the password.
Usage
v The PAss subcommand must be preceded by the User subcommand. For some
sites, the password completes your identification for access control on the
remote host.
v On z/OS hosts, a PAss command is automatically generated by the user
command. If you do not enter the password as part of the user command, you
| are prompted for the password if the host requires it.
v The optional user data is used by the z/OS FTP server as a character string that
is passed to the server’s FTCHKPWD user exit routine.
Context
See “User subcommand—Identify yourself to a host or change your TSO user ID
password” on page 320 for more information.

PRIvate subcommand
PRIvate subcommand—Set the protection level for data transfers to

PRIVATE
Purpose
Use the PRIvate subcommand to set the protection level for data transfers on the
data connections to private. This subcommand is equivalent to specifying the
PROTect PRIvate subcommand.
Format
PRIvate
Parameters
Examples
To set the protection level to private, enter:
private
Usage
v This subcommand is not valid when there is no active security mechanism.
v Data transmissions are confidentiality and integrity protected by encryption.

PROMpt subcommand
PROMpt subcommand—Toggle interactive prompting for M*

commands
Purpose
Use the PROMpt subcommand to toggle interactive prompting for MDelete, MGet,
and MPut commands. Prompting is the default action unless the FTP session was
started with the -i option, which turns off interactive prompting.
Format
PROMpt
Parameters
Examples
The following example shows using the MPut command with interactive
prompting on.
Command:
mput file*
>>>PORT 9,67,113,57,5,128
>>>STOR FILE1
Mput FILE2 (Yes|No|Quit|Stop prompting)? no
>>>PORT 9,67,113,57,5,129
>>>STOR FILE3
Command:
Context
See “Using FTP” on page 29 for more information about the -i option.

PROTect subcommand
PROTect subcommand—Set the protection level for data transfers
Purpose
Use the PROTect subcommand to set the protection level for data transfers on the
data connections.
Format
PROTect CLEAR
PRIVATE
SAFE
Parameters
CLEAR
Data transmissions are not protected. Specifying PROTect CLEAR is equivalent
to specifying the CLEar subcommand.
PRIVATE
Data transmissions are confidentially and integrity protected. Specifying
PROTect PRIVATE is equivalent to specifying the PRIvate subcommand.
SAFE
Data transmissions integrity are protected by cryptographic checksum.
Examples
To set the protection level to private, enter:
prot private
Usage
This subcommand is not valid when there is no active security mechanism.

PROXy subcommand
PROXy subcommand—Execute FTP subcommand on secondary

control connections
Purpose
Use the PROXy subcommand to execute an FTP subcommand on secondary
control connections. PROXy enables the FTP client to connect simultaneously to
two remote FTP servers and then to establish a data connection between the two
servers for the purpose of transferring files between those servers.
Format
PROXy subcommand
Parameters
subcommand
The name of any FTP subcommand except those listed in the first note in
“Usage” on page 253. The first PROXy subcommand should be Open, which
establishes the secondary server connection.
The following subcommands behave differently when prefaced by the PROXy
subcommand:
v Open establishes the secondary server connection.
v CLose closes the secondary server connection.
v Get and MGet transfer files from the host on the primary connection to the
host on the secondary connection.
v PUt, MPut, and APpend transfer files from the host on the secondary
connection to the host on the primary connection.
Examples
The following example shows a proxy open to establish connection to a secondary
server.
Command:
proxy open 9.67.113.57 6321
220-FTPDJG1 IBM FTP CS V1R4 at MVS164, 13:06:23 on 2003-01-14.
NAME (9.67.113.57:USER33): user34
>>>USER user34
PASSWORD:
>>>PASS
The following example shows the commands for a proxy between IPv4 nodes:
v PASV to the secondary server
v PORT to the primary server
v RETR to the primary server
v STOR to the secondary server
Two 250 replies are received by the client, one from each server.

PROXy subcommand
Command:
proxy m1 mx
>>>PASV
227 Entering Passive Mode (9,67,113,57,5,121)
>>>PORT 9,67,113,57,5,121
>>>RETR m1
125 Sending data set /u/user33/mpp1/m1
>>>STOR mx
125 Storing data set USER34.MX
Command:
The following shows a proxy open to establish connection to a secondary server

with an IPv6 address:
Command:
proxy open local167v6
Connecting to: Local167v6 2001:0DB8:c2d4::9:67:115:12 port: 21.
220-Welcome to my test system.
220-You are logged on from 2001:0DB8:c2d4::9:67:115:13
Command:
user user2
>>> USER user2
PASSWORD:
>>> PASS
230 USER2 is logged on. Working directory is "/".
This example shows the commands for a proxy PUt between IPv6 nodes:
v EPSV to the secondary server
v EPRT to the primary server
v STOR to the primary server
v RETR to the secondary server
As in the first example, two 250 replies are received by the client.
Command:
proxy put bob testfile
Load module transfer does not support load module rename
>>> EPSV
229 Entering Extended Passive Mode (|||1027|)
>>> EPRT |2|2001:0DB8:c2d4::9:67:115:12|1027|
200 EPRT request OK
>>> STOR testfile
125 Storing data set /tmp/myTest/testfile
>>> RETR bob
125 Sending data set /tmp/myTest/bob
Command:
Usage
v The following subcommands are not valid proxy subcommands:
– DEBug
– DUMP
– DELImit
– GLob

PROXy subcommand
– LANGuage
– LCd
– LMkdir
– LOCSIte
– LOCSTat
– LPwd
– PROMpt
– QUIt
– REStart
– SENDPort
– SENDSite
– SRestart
– SUnique
– TSO
– Verbose
v To receive help from a server on a secondary control connection, enter PROXy
HElp SERVER.
v Data transfer in PROXy mode can be restricted if the server is set up to reject
PORT and EPRT commands with certain parameters. See the z/OS
Communications Server: IP Configuration Guide for more details.
v If an open subcommand is entered as a proxy subcommand by the client and
the session is currently protected by a security mechanism (for example, TLS),
then the subcommand is rejected with the following message:
Proxy open is not supported with security mechanisms
v If the connection to one server is IPv4 and the connection to the other is IPv6,
proxy transfers might not be possible. The two servers must have the ability to
connect to each other as well as to the client. A z/OS FTP server cannot be the
primary server in a proxy transfer unless the connection from the client to each
of the servers is of the same protocol.
v Data transfer in PROXy mode can be restricted if the server is set up to reject
the redirection of the passive (PASV) data connection using
PASSIVEDATACONN NOREDIRECT. See the z/OS Communications Server: IP
Configuration Reference for more details.

PUt subcommand
PUt subcommand—Copy data sets to the remote host
Purpose
Use the PUt subcommand to copy data sets from your local host to the remote
host.
Format
PUt local_file
foreign_file
Parameters
local_file
Specifies the name of the file on your local host being sent to the remote host.
foreign_file
Specifies the name that the delivered data set is given on the remote host. If
the foreign_file name is not specified, the foreign_file name is the same as the
local_file name.
Usage
and a server. However, when you use the PUt subcommand, FTP might truncate
data records and you might lose data, if one of the following occurs:
– If you are creating a new file at the server and the value of LRecl, as shown
by the STAtus subcommand, is a value less than the LRecl of the transmitted
data set and SENDSite subcommand has been set to OFF, then FTP truncates
the transmitted data set.
– If the data set name already exists at the receiving site and the logical record
transmitted data set, then FTP truncates the transmitted data set.
v If FTP does not support directory content transfers in partitioned data sets, it is
not possible to FTP load modules.
v When a PUt is issued, FTP automatically sends a SIte subcommand containing
record format information for the file or data set. To toggle this off, you must
first issue a SENDSite subcommand. See “SENDSite subcommand—Toggle the
sending of site information” on page 269 for more detailed information.
v If the remote host already has a file with the name specified by foreign_file, the
remote host overwrites the existing file. If the remote host does not have a file
with the same name specified by foreign_file, the remote host creates a new file.
v To put files on the remote host with unique file names, you must have set
unique storage on before issuing the PUt command. Use the SUnique
subcommand to change the storage method.
v To send a data set to the remote host, you must have a defined working
directory on the remote host and write privileges to the files in this working
directory.
UPDATE authority is the minimum required for write access. To ensure that the
newly created data set can be written to before the data set has been allocated
and opened, FTP validates that the user ID has at least UPDATE authority. If

PUt subcommand
this fails, then FTP will be able to issue a reply to the client which is indicative
of the failure. If open is allowed to continue and it fails due to lack of authority,
then the reply will not be as definitive.
v When a PDS or PDSE member is transmitted, the user data associated with the
PDS member is also transferred to the directory on the target host if the
following are true:
– Data is in block or compressed data transfer mode
– Data has a representation type of EBCDIC
– Transfer is from one MVS directory to another
No PDS directory information is transferred if the member is null (empty).
Context
v PUt can be used with the PROXy subcommand to transfer files from a host on a
secondary connection to a host on a primary connection. See “PROXy

PWd subcommand
PWd subcommand—Display the current working directory
Purpose
Use the PWd subcommand to display the name of the current working directory
on the remote host.
Format
PWd
Parameters
Examples
Display the name of the current working directory:
pwd
>>>PWD
257 "’USER17.HSMTEST.’" is working directory
Command:
Display the name of the current z/OS UNIX file system working directory:
pwd
>>>PWD
257 "/u/user121/example" is the HFS working directory.
Command:

QUIt subcommand
QUIt subcommand—Leave the FTP environment
Purpose
Use the QUIt subcommand to disconnect from the foreign host and end the FTP
session.
Format
QUIt
Parameters
Usage
v The QUIt subcommand ends the FTP session with the remote host and exits FTP
on the local host. To establish a new session, use the FTP command.
v In a z/OS UNIX environment, you can also press Ctrl-C to end an FTP session.
v When running with both a primary and a secondary server (by using the
PROXy subcommand), the QUIt subcommand disconnects both sessions.
Context
See “Using FTP” on page 29 for information about the FTP command.

QUOte subcommand
QUOte subcommand—Send an uninterpreted string of data
Purpose
Use the QUOte subcommand to send an uninterpreted string of data to the server
port on the foreign host.
The QUOte subcommand bypasses the FTP interface of your local host. You can
use the QUOte subcommand to send commands that the remote server
understands, but that the local host does not understand.
Format
QUOte string
Parameters
string
Specifies the data to be sent verbatim to the remote host FTP server.
Examples
v For example, QUOTE TYPE B 1 causes the FTP server to change its transfer type to
Shift JIS kanji, without changing the transfer type in the FTP client. The client in
this example should be set to the ASCII transfer type before the QUOte
subcommand is issued.
v The following example shows the screen display when setting the DBCS transfer
type to JIS78KJ, shift-in JISROMAN, and then setting it to HANGEUL using
EBCDIC SO/SI characters. The example shows an MVS TCP/IP FTP client
connected to an MVS TCP/IP FTP server. All three methods of setting the DBCS
transfer type are shown.

QUOte subcommand
User: jis78kj (jisroman

System: >>>TYPE b 4 r
200-Representation type is kanji JIS 1978 shift-in JISROMAN
200 Standard DBCS control used
Command:
User: type b 4 r
System: >>>TYPE b 4 r
Command:
User: jis78kj (jisroman notype
System: Command:
User: quote type b 4 r
System: >>>type b 4 r
Command:
User: hangeul (sosi ebcdic
System: >>>TYPE b 5 s e
200-Representation type is Hangeul
200-SO/SI characters X’0E’/X’0F’ used
200 Data transfer is mixed SBCS/DBCS
Command:
User: type b 5 s e
System: >>>TYPE b 5 s e
Command:
User: hangeul (sosi ebcdic notype
System: Command:
User: quote type b 5 s e
System: >>>type b 5 s e
Command:
Usage
v No parsing or validity checking is performed on the character string you enter
by FTP on your local host. If the character string you send to the FTP server is
part of a required sequence of commands, you are required to provide this
sequence correctly, or the results are unpredictable.
v The QUOte subcommand can be used to generate any of the DBCS TYpe
commands supported by the server. This subcommand is used when the FTP
server supports the DBCS TYpe command, but the FTP client does not.

RECord subcommand
RECord subcommand—Set the file structure to record
Purpose
Use the RECord subcommand to set the file structure to record. This is equivalent
to specifying the STRucture R subcommand. See “STRucture subcommand—Set the
file structure” on page 309 for more information.
Format
RECord
Parameters

REName subcommand
REName subcommand—Rename files
Purpose
Use the REName subcommand to rename a file on the remote host.
Format
REName original_name new_name
Parameters
original_name
Specifies the current name of the file.
new_name
Specifies the new name of the file.
Usage
v For MVS data sets, if the file specified by the new_name value already exists, the
existing file is not replaced by the new file.
v For z/OS UNIX files, if the file specified by the new_name value already exists,
the existing file is replaced.
| Restriction: When you use the FTP RENAME subcommand with a generation data
| group (GDG), for example, RENAME SOURCE.FILE MY.GDG(+1), serialization of the
| GDG data set is not assured. To avoid this, instead use the FTP PUT subcommand.
| For more information about GDG processing, see Information APAR II08285.

REStart subcommand
REStart subcommand—Restart a checkpointed data transfer
Purpose
Use the REStart subcommand to restart a checkpointed data transfer.
Format
REStart
Parameters
Usage
v The REStart subcommand restarts the last checkpoint file transfer request at the
point of the last valid checkpoint stored in the checkpoint data set. See
FTP.DATA CHKPTPREFIX statement to determine the check point data set name.
The file transfer environment (such as file transfer mode, type, and the hlq of the
checkpoint data set name) which was in effect at the time of the last checkpoint
file transfer request must be reestablished before issuing the REStart
subcommand.
v The LOCSIte NORESTGet subcommand and parameter prevent opening the
checkpoint data set for a Get request.
v The REStart subcommand can be used when a checkpointed file transfer request
fails because of some temporary condition such as the loss of the connection
between the client and the server.
v The checkpoint file name is formed using the CHKPTPrefix value and the
current working directory. See the description of CHKPTPrefix under the
“LOCSIte subcommand—Specify site information to the local host” on page 195
or “Changing local site defaults using FTP.DATA” on page 70.
Context
For more information about checkpointing a file transfer request, see “CHKptint”
on page 275 (SIte subcommand) or “CHKptint” on page 198 (LOCSIte
subcommand).

RMdir subcommand
RMdir subcommand—Remove a directory on the remote host
Purpose
Use the RMdir subcommand to remove a directory on the remote host.
Format
RMdir directory
Parameters
directory
Specifies the name of the directory to be removed.
Usage
v The RMdir subcommand sends a request to the remote host FTP server to
remove a directory with name directory from the current remote directory.
v The RMdir subcommand can be used to delete a PDS.

SAfe subcommand
SAfe subcommand—Set the protection level to safe
Purpose
Set the protection level on data transfers to ″safe″. Data transmissions are
integrity-protected by cryptographic checksum.
Format
SAfe
Parameters

SChinese subcommand
SChinese subcommand—Change the data transfer type to SCHINESE
Purpose
Use the SChinese subcommand to change the data transfer type to Simplified
Chinese.
Format
SChinese
(
Ascii NOSo NOType
Sosi
Ebcdic
Space
Parameters
Sosi
Transferred data contains the shift-out and shift-in characters specified by the
one of the following parameters — Ascii, Ebcdic, or Space. If no parameter is
transferred data.
Ascii
data.
Ebcdic
data.
Space
NOSo
NOType

SChinese subcommand
Usage
The SChinese client subcommand is equivalent to the TYPE B 9 server command.
Context

SENDPort subcommand
SENDPort subcommand—Toggle the sending of port information
Purpose
Use the SENDPort subcommand to toggle the automatic sending of the PORT
command.
Format
SENDPort
Parameters
Usage
v By default, the SENDPort subcommand is turned on when you start an FTP
session. Each time you use the SENDPort subcommand, it is turned alternately
on and off.
v FTP does not send PORT commands for data transfer when you disable PORT
commands by toggling the function off.
v SENDPort is useful for communication with those FTP implementations that
ignore PORT commands, but show (incorrectly) that the PORT command has
been accepted.
v To determine if the sending of port information is enabled or disabled on your
local host, use the LOCSTat subcommand.
v The sendport setting is ignored during proxy transfer.
Context
See “LOCSTat subcommand—Display local status information” on page 218 for
more information about LOCSTat subcommand.

SENDSite subcommand
SENDSite subcommand—Toggle the sending of site information
Purpose
Use the SENDSite subcommand to toggle the automatic sending of the SIte
subcommands when sending a data set to a foreign host.
Format
SENDSite
Parameters
Usage
v By default, the SENDSite subcommand is turned on when you start an FTP
session. Each time you use the SENDSite subcommand, it is turned alternately
on and off.
When turned on, FTP sends a SIte subcommand containing record format
information for the file or data set when you issue the PUt or MPut
subcommand.
v SENDSite is useful when you want to PUt a file to the remote host and have the
file created with the same characteristics as defined at the local host.
v If you are using either an SMS data class or a model DCB at your MVS server to
provide the logical record length or record format, you must toggle the
SENDSite setting off at the client. Otherwise, the SIte information that is sent
automatically by the client overrides the values provided by the SMS dataclass
or model DCB.
v To determine if the sending of site information is enabled or disabled on your
local host, use the LOCSTat subcommand.
v The sendsite setting is always ignored if you issue a mkdir subcommand with
the (like parameter. The client must send a SITE command to the server to set
the server’s site variables before allocating the directory.
Context
v See “LOCSTat subcommand—Display local status information” on page 218 for
information about the LOCSTat subcommand.
v See “MKdir subcommand—Create a directory on the remote host” on page 239
for information about the MKdir subcommand.

SIte subcommand
SIte subcommand—Send site-specific information to a host
Purpose
Use the SIte subcommand to send information that is used by the remote host to
provide services specific to that host system.
Format
SIte options
options:
ASAtrans
AUTOMount
AUTORecall
BLKsize
= size
BLocks
BLOCKSIze
= size
5
BUfno =
number
0
CHKptint =
number
CHMod ooo filename
symbolic filename
CONDdisp = Catlg
Delete
CTRLConn 7BIT
iconv_ascii
FTP_STANDARD_TABLE
*
CYlinders
DATAClass
= data_class
DATASetmode

SIte subcommand
DB2 = db2_name
DBSUB
DCbdsn
= data_set_name
DEBug =
?
ACC
ALL
BAS
CMD
FLO
FSC(n)
INT
JES
NONE
PAR
SEC
SOC(n)
SQL
UTL
Xyyy
DESt
= destination
Directory
= size
DIRECTORYMode
DUmp =
?
n
ALL
FSC
JES
NONE
SOC
SQL
Xyyy
ENCODING = SBCS
MBCS

SIte subcommand
FILEtype = type
ISPFSTATS
200
JESENTRYLimit =
number
loginuserid*
JESJOBName =
jobname
JESLrecl = length
*
loginuserid
JESOwner =
userid
JESRecfm = F
V
*
ALL
JESSTatus =
INPUT
ACTIVE
OUTPUT
LISTSUBdir
LRecl
= length
MBDATACONN = (file_system_codepage,network_transfer_codepage)
MBREQUIRELASTEOL
MBSENDEOL = CRLF
CR
LF
NONE
MGmtclass
= mgmtclass
MIGratevol
= volume_ID
NOASAtrans
NOAUTOMount
NOAUTORecall
NODBSUB
NOISPFSTATS
NOLISTSUBdir
NOMBREQUIRELASTEOL
NOQUOtesoverride
NORDW
NOSBSUB
NOSPRead
NOTRAILingblanks
NOTRUNcate
NOUCSSUB
NOUCSTRUNC
NOWRAPrecord
NOWRTAPEFastio
PDSTYPE =
PDS
PDSE

SIte subcommand
PRImary
= amount
Qdisk
= volume_serial
QUOtesoverride
RDW
READTAPEFormat
= tape_format
RECfm
= format
RETpd
= days
SBDataconn dsname
(file_system_cp,network_transfer_cp)
FTP_STANDARD_TABLE
*
SBSENDEOL = CRLF
CR
LF
NONE
SBSUB
SBSUBCHAR = nn
Space
SECondary
= amount
SPRead
SQLCol = any
labels
names
STOrclass
= storage_class
TRacks
TRAILingblanks
TRUNcate
UCOUNT
= unit_count | P
UCSHOSTCS
= code_set
UCSSUB
UCSTRUNC
UMask ooo
UNICODEFILESYSTEMBOM = ASIS
ALWAYS
NEVER
Unit
= unit_type
VCOUNT
= volume_count
VOLume =
volume_serial
(volume_serial_list)
WRAPrecord
WRTAPEFastio
XLate = name

SIte subcommand
Parameters
ASAtrans
Permits the FTP server to interpret the characters in the first column of ASA
files being transferred as print control characters.
AUTOMount
Permits automatic mounting of volumes for data sets on volumes that are not
mounted. If AUTOMount is specified and an unmounted volume is needed, a
message is automatically issued to the MVS operator console requesting that
the volume be mounted. The MVS operator must then mount the volume and
reply to the message before FTP can proceed.
AUTORecall
Permits automatic recall of migrated data sets.
BLKsize
Specifies the block size of a newly allocated data set. BLKsize is functionally
equivalent to BLOCKSIze. The BLOCKSIze parameter is obsolete, but it is
accepted to provide compatibility with previous releases of z/OS TCP/IP.
When specified without a size, no block size is used when allocating the new
data set. When specified without a size, the equal sign (=) is optional.
Specify BLKsize with no value if you are also specifying DATAClass=data_class
and you want the SMS data class to provide the BLKsize value, or if you are
specifying DCbdsn=data_set_name and you want to use the block size from the
DCBDSN data set. If BLKsize=size is specified with either the DATAClass or
DCbdsn parameters, the value specified by the SIte BLKsize parameter
overrides the DATAClass or DCbdsn block size.
Notes:
1. If you specify BLKsize without a size or with a size of 0, FTP does not
specify the block size when allocating new data sets.
2. Be especially careful specifying both BLKsize= and BLocks. While there are
conditions where this is tolerated, if a valid BLKsize cannot be determined,
the data set will not be created when the allocation is attempted.
size
Specifies the block size of a newly allocated data set. The valid range is
0–32 760.
BLKsize=0 is a special case. When BLKsize=0 is specified, the operating
system attempts to determine a block size for the new data set. FTP does
not create the new data set unless the system is able to establish a nonzero
block size.
BLocks
Specifies that primary and secondary space allocations are in blocks.
If both PRImary and SECondary are unspecified, and an SMS data class has
the BLocks parameter is ignored.
BLOCKSIze
Specifies the block size of a newly allocated data set. BLOCKSIze is
functionally equivalent to BLKsize. BLOCKSIze is obsolete but it is accepted to
provide compatibility with previous releases of z/OS TCP/IP. See the BLKsize
parameter for more information.

SIte subcommand
BUfno
Specifies the number of access method buffers that is used when data is read
from or written to a data set. The default value is 5.
number
The number of buffers used. The valid range is 1–35.
CHKptint
Specifies the checkpoint interval for the sending site in a file transfer request. If
the checkpoint interval is 0, no checkpointing occurs and no marker blocks are
transmitted. The default value is 0.
Use SIte to set CHKptint when the FTP server is the sending site (Get
command). It will not be useful to change the checkpoint interval to more than
0 in a Get unless the receiving site is able to process checkpoint markers in the
file transfer data stream.
CHKptint is valid only for block and compressed modes of data transfer.
number
The checkpoint interval for the sending site in a file transfer request. This
value is used to determine when checkpoint marker blocks are to be
transmitted so that transmission can be restarted based on the information
in the last marker.
A large checkpoint interval means that a large amount of data is sent in
between markers and therefore few markers are sent. A smaller checkpoint
interval means that less data is sent between markers and therefore more
markers are sent.
The cost involved with using a nonzero checkpoint interval is the markers
themselves are transmitted, which means more bytes are being sent across
the network (approximately 44 bytes per marker).
To estimate the appropriate checkpoint interval, use the following formula.
You need to know the record length of the file you are transferring and
how much data you think can be transmitted reliably.
amount of data in interval
CHKPTINT = --------------------------
record length of the file
Do not execute a CHKptint more often than once every 200KB. The
following are examples of a file you are transferring with 80-byte records.
CHKPTINT = 200KB / 80 bytes
= 200 * 1024 bytes / 80 bytes
= 2560
CHMod
Changes the permission bits for a file.
ooo filename
ooo is an octal mask representing the permissions you want to assign to
filename. Form the octal mask by OR’ing the constants corresponding to
the permission bits you want set:
400
User read
200
User write
100
User execute (or list directory)

SIte subcommand
040
Group read
020
Group write
010
Group execute
004
Other read
002
Other write
001
Other execute
You cannot use the SITE subcommand CHMod parameter to set the
following permission bits:
v Set-user-ID bit
v Set-group-ID bit
v Sticky bit
See the z/OS UNIX System Services User’s Guide and the z/OS UNIX System
Services Command Reference for more information about file permissions.
symbolic filename
symbolic represents the permissions you want to apply to filename.
Note: symbolic is specified as follows:

{u|g|o|a}{=|+|-}{r|w|x|rw|rx|wx|rwx}
where u, g, o, a, =, +, -, r, w, and x are as defined for the z/OS

UNIX chmod command.
If filename does not begin with a slash character (/), it is appended to the
current working directory. If filename does begin with a slash character (/), it is
interpreted as a complete directory name.
The file name specified must be a z/OS UNIX file name for a single file and
cannot contain a wildcard (*) for multiple files. The setting of QUOtesoverride
is ignored and all quotation marks are treated as part of the file name.
The CHMOD keyword must be the only keyword or last keyword on a SITE
subcommand.
CONDdisp
Specifies the disposition of the data set if a store operation for a new data set
ends before all of the data is written.
Catlg
Specifies that a data set is kept and cataloged when an FTP file transfer
ends prematurely.
Delete
Specifies that a data set is deleted when an FTP file transfer ends
prematurely.

SIte subcommand
Delete is ignored if the file transfer failed as a result of the FTP server
being terminated or if the server has received checkpoint information
during data transfer.
CTRLConn
Specifies the ASCII code page to be used for control connections. The valid
subcommands are:
SITE CTRLConn=7BIT
SITE CTRLConn=iconv_ascii
SITE CTRLConn=FTP_STANDARD_TABLE
SITE CTRLConn=*

7BIT
Indicates 7-bit ASCII is to be used.
iconv_ascii
A name recognized by iconv to indicate an ASCII code page. For a list of
FTP_STANDARD_TABLE
are shipped in TCPXLBIN(STANDARD), are to be used on the control
connection.
* Indicates that the ASCII used at initialization is to be used.
Note: Setting the control connection code page with SIte CTRLCONN disables
UTF-8 encoding. You must start a new session to restore UTF-8
encoding.
CYlinders
Specifies that primary and secondary space allocations are in cylinders.
If both PRImary and SECondary are unspecified, and an SMS data class has
the CYlinders parameter is ignored.
DATAClass
Used to specify the SMS data class, as defined by your organization, for the
target host. Specifying DATAClass with no parameter value cancels the data
class specification. The equal sign (=) is optional in this case.
data_class
host. If values are specified for any of the following SIte parameters, the
values specified by the SIte parameter overrides the value specified in the
SMS data class:
v BLKsize
v Directory
v LRecl
v PRImary
v RECfm
v RETpd
v SECondary
SIte subcommand
If the DCbdsn SIte parameter is specified, the LRecl, RECfm, BLOCKSIze,

and RETpd (if specified) of the DCBDSN data set overrides the values
specified in the data class.
If the MGmtclass site parameter is specified, and the requested
management class specifies a retention period, the retention period value
of the management class can override the retention period value of the
data class.
A SIte DATACLASS command pointing to an SMS data class must be used
to create a PDSE. A load module loading from a temporary data set will
always be a REPLACE operation, in that existing members will be
overwritten in case of name conflicts. LMTR will not be performed in
STOU mode (when SUnique is turned on).
DATASetmode
Specifies that all the data set qualifiers below the current directory are treated
as entries in the directory (disables DIRECTORYMode).
DB2
db2_name
The name of the DB2 subsystem.
DBSUB
a double-byte character translation. The substitution character is selected by
the C/C++ iconv() function; see the z/OS XL C/C++ Programming Guide
information about Internationalization: Locales and Character Sets for more
information.
DCbdsn
Specifies the name of the MVS data set to be used as a model for allocation of
new data sets. Specifying DCbdsn with no parameter value cancels the
DCbdsn specification.
data_set_name
Specifies the name of the data set. The file name must be an MVS data set
name. z/OS UNIX file names are not allowed on the DCbdsn parameter.
The setting of QUOtesoverride is ignored. If the file name is enclosed in
single quotation marks, it overrides the current working directory;
otherwise it is appended to the current working directory.
Notes:
1. Specify SIte RECfm, LRecl, and BLKsize parameters with no values to
allow characteristics from the model DCB to be used.
2. To override the model characteristics of RECfm, LRecL, BLKsize, or
RETpd, specify a value on the SIte command.
3. Ensure that SENDSite subcommand is toggled off. Otherwise, the SIte
information that is sent automatically by the client overrides the values
provided by the model DCB.
4. If MGmtclass is specified, the RETpd value of the MGmtclass can
override the RETpd value.
Specifying a GDG data set with a relative index produces an error

message. The following examples are unsupported specifications:
SITE DCBDSN=MYGDG(0)
SITE DCBDSN=MYGDG(–nnn)or
SITE DCBDSN=MYGDG(+nnn)

SIte subcommand
See “Steps for using a DCBDSN model to create a new data set” on page
93 for more information about DCbdsn.
DEBug
Activates or disables general tracing at the FTP server. One or more traces can
be activated with a single debug parameter with the following options:
ACC
The ACC trace shows the details of the login process.
ALL
Note: Both the FSC and the SOC traces will be set to level 1 when the ALL
parameter is processed.
BAS
This parameter is used to set a select group of traces that offer the best
overall details without the intense tracing of some of the traces. Specifying
this parameter is the same as SITE DEBUG=(CMD,INT,FSC, SOC).
CMD
The CMD trace shows each command and the parsing of the parameters
for the command.
FLO
The FLO trace shows the flow of control within FTP. It is useful to show
which services of FTP are used for an FTP request.
FSC(n)
The FSC trace shows details of the processing of the file services
subcommands APPE, STOR, STOU, RETR, DELE, RNFR, and RNTO.
This trace can generate very detailed information and therefore allows you
to specify levels of detail for the trace points. The level (n) can be a
number from 1 to 5.
INT
The INT trace shows the details of the initialization and termination of the
FTP session with the server.
JES
The JES trace shows details of the processing for JES requests (that is,
requests when SIte FILETYPE=JES is in effect).
NONE
PAR
The PAR trace shows details of the FTP command parser. It is useful in
debugging problems in the handling of the command parameters.
SEC
The SEC trace shows the processing of security functions such as TLS and
GSSAPI negotiations.
SOC(n)
The SOC trace shows details of the processing during the setup of the
interface between the FTP application and the network as well as details of

SIte subcommand
the actual amounts of data that is processed. This trace can generate very
detailed information and therefore allows you to specify levels of detail for
the trace points.
The level 1 tracing that is specified by entering SOC or SOC(1) is the level
normally used unless more data is requested by the TCP/IP service group.
The level (n) can be a number from 1 to 8.
SQL
The SQL trace shows details of the processing for SQL requests, such as
requests when SITE FILETYPE=SQL is in effect.
UTL
The UTL trace shows the processing of utility functions such as CD and
SIte.
Xyyy
example, SITE DEBUG=(XPAR, XACC) will turn off the PAR and the ACC
traces.
Usage notes for the DEBug parameter:

v The client is allowed to change general tracing at the server if the FTP.DATA
file for the server specified DEBUGONSITE TRUE.
v The state of the debug traces points is displayed as a response to the SIte
subcommand. To see the state without making a change, enter SITE
DEBUG=(?).
v The setting of the traces is additive. This is demonstrated by the following
example:
SITE DEBUG=(BAS)
200-Active traces: CMD INT FSC(1) SOC(1)
SITE DEBUG=(ACC)
200-Active traces: CMD INT ACC FSC(1) SOC(1)
v To ensure that only the needed traces are active, use the NONE value to
clear all traces before setting the requested ones.
SITE DEBUG=(?)
EZA1701I >>> SITE DEBUG=(?)
200-Active traces: CMD INT FSC(1) SOC(1)
SITE DEBUG=(NONE,FSC(2))
EZA1701I >>> SITE DEBUG=(NONE,FSC(2))
200-Active traces: FSC(2)
v For the FSC and SOC trace options, only one level of tracing can be defined
at any time. However, when level 2 is defined, levels 1 and 2 are active.
When level 3 is defined, levels 1, 2, and 3 are active. This progression also
applies to levels 4 and 5.
site debug=(fsc(2),soc(1))
>>> SITE debug=(fsc(2),soc(1))
200-Active traces: FSC(2) SOC(1)
site debug=(fsc(1),soc(2))
>>> SITE debug=(fsc(1),soc(2))
200-Active traces: FSC(1) SOC(2)

SIte subcommand
Note: The FSC command accepts level values 6–8, but provides only level 5
trace data. Likewise, the SOC trace option accepts level values 4–8,
but provides only level 3 trace data.
v See the Diagnosing FTP server problems with traces section in z/OS
Communications Server: IP Diagnosis Guide for more information about FTP
server tracing.
DESt
Indicates the Network Job Entry (NJE) destination to which the files are routed
when you enter a PUt command. If specified without a destination parameter,
the destination resets and files are stored at the host system rather than sent to
a remote network.
The SIte DESt subcommand enables you to send data sets (rather than storing
them at the server) to other users on machines that are connected on an NJE
network.
destination
Indicates the NJE destination to which the files are routed when you enter
a PUt command. The value specified for destination can be:
v userID@nodeID
v nodeID.userID
v nodeID
v DestID
The file is sent over the NJE network to the specified destination.
This parameter is ignored if FILEtype=JES is set.
Directory
PDS. When specified without the size, no directory value is used when
allocating the data set. The equal sign (=) is optional in this case.
Specify Directory without a size when you are also specifying
DATAClass=dataclass and you want the SMS data class to provide the
Directory size. If Directory=size is specified with DATAClass, the value
specified by the SIte Directory parameter overrides the DATAClass directory
specification.
size
Specifies the number of directory blocks to be allocated for the directory of
a PDS. The valid range is 1—16 777 215.
DIRECTORYMode
Specifies that only the data set qualifier immediately below the current
directory is treated as an entry in the directory. In directory mode, this data set
qualifier is the only one used by the MGet, LS, and DIr subcommands.
DIRECTORYMode has no effect on files residing in a z/OS UNIX file system.
DUMP
Activates or disables extended tracing at the FTP server.
Note: Extended tracing has the potential to generate a large amount of trace
data and should not be set unless requested to debug a specific problem
in the code.
One or more traces can be activated with a single dump parameter with the
following options:

SIte subcommand
n Specifies the ID number of a specific extended trace point that is to be

activated in the FTP code. The number has a range of 1–99.
ALL
FSC
Activates all of the extended trace points in the file services code. The ID
numbers for FSC are 20 to 49.
JES
Activates all of the extended trace points in the JES services code. The ID
numbers for JES are 60 to 69.
NONE
SOC
Activates all of the extended trace points in the network services code. The
ID numbers for SOC are 50 to 59.
SQL
Activates all of the extended trace points in the SQL services code. The ID
numbers for SQL are 70 to 79.
Xyyy
example, SITE DUMP=(X21,X22,XSQL) will reset the extended trace points 21
and 22 and all of the SQL trace points.
Usage notes for the DUMP parameter:

v The client is allowed to change extended tracing at the server if the
FTP.DATA file for the server specified DUMPONSITE TRUE.
v The setting of the traces is additive. This is demonstrated by the following
example:
SITE DUMP=(NONE,21)
EZA1701I >>> SITE DUMP=(NONE,21)
200-Active dumpIDs: 21
SITE DUMP=(22)
EZA1701I >>> SITE DUMP=(22)
200-Active dumpIDs: 21 22
v The range of 99 extended trace points is defined to allow easy extension of
the trace points by the TCP/IP service team. Additional trace points can be
added to the code without any changes to the external mechanism to control
the traces.
v See Diagnosing FTP server problems with traces in z/OS Communications
Server: IP Diagnosis Guide for more information about FTP server tracing.
ENCODING
Indicates the kind of encoding that is used for conversions between codepages
for data transfers.
See “Support for SBCS languages” on page 86 and “Support for MBCS
SBCS
Single Byte encoding. Code pages are specified using the SBDATACONN
statement. This is the default value.

SIte subcommand
MBCS
Multibyte encoding. Code pages are specified using the MBDATACONN
statement.
FILEtype
type
The file type of the data set can be:
Type Description
SEQ Sequential or partitioned data sets
SQL SQL query function
JES Remote job submission
ISPFSTATS
Allows FTP to create or update ISPF Member statistics when PUt, MPut or
APpend subcommands are issued.
JESENTRYLimit
JESENTRYLimit specifies how many entries can be displayed at once using a
LIST or NLSTcommand. JESENTRYLIMIT is only valid if
JESINTERFACELVEL=2.
number
Fixed number of entries to display. The default for JESENTRYLimit is 200,
if not specified in the server FTP.DATA file.
JESJOBName
Specifies that any command (Get, LIST, DIr or MGet) should be limited to
those jobs, started tasks, APPC/MVS, or TSO output that match the specified
value. JESJOBName is only accepted if JESINTERFACELevel is set to 2.
jobname
Specified job name. Can be or can contain a wildcard (* or ?).
loginuserid*
The logged in user ID appended with an asterisk (*). Default value.
Note: JESJOBName matches the first job name that a job is assigned. Jobs that
change job names during execution time are matched only by their
initial job name.
JESLrecl
Specifies the logical record length (LRecl) for the Job Entry System (JES)
internal reader at the foreign host.
length
The logical record length for the JES internal reader at the foreign host. The
valid range is 1–254.
* Indicates that the logical record length should be taken from the site LRecl
parameter setting.
JESOwner
Specifies that any command (Get, LIST, DIr or MGet) should be limited to
those jobs, started tasks, APPC/MVS, or TSO output which are owned by the
user ID specified. JESOWNER cannot be modified unless
JESINTERFACELEVEL is set to 2.

SIte subcommand
userid
Specified user ID. The userid can be or contain a wild card (* or ?).
loginuserid
The logged in user ID. Default value.
JESRecfm
Specifies the record format for the JES internal reader at the foreign host.
F Fixed record format
V Variable record format
* Indicates that the record format should be taken from the SIte RECfm
parameter setting.
JESSTatus
Specifies what type of information should be returned on LIST and NLST
commands. Acceptable values are INPUT, ACTIVE, OUTPUT or ALL. The
default value for JESSTATUS is ALL. JESSTATUS can be modified only if
JESINTERFACELEVEL=2.
LISTSUBdir
Use the LISTSUBdir option to indicate that wildcard searches should apply to
the current working directory and should also span one level of its
subdirectories. This setting affects processing of the NLST command. The z/OS
FTP client sends an NLST command to the server as part of LS*, MDelete *,
and MGet * subcommand processing.
Restrictions:
1. The LISTSUBdir option applies to z/OS UNIX file operations only; MVS
2. The FTP client must be communicating with a z/OS V1R7 or later FTP
server or an unrecognized parameter response will be received.
Result: If the LISTSUBdir option is not specified on the SITE subcommand and
the LISTSUBDIR statement is not specified in the client FTP.DATA file, the
default is as if the LISTSUBdir option was specified on the SITE subcommand.
LRecl
Specifies the logical record length (LRecl) of a newly allocated data set. When
specified without a length, no LRecl is used when allocating the data set. The
equal sign (=) is optional in this case.
Specify LRecl with no value when you are also specifying DATAC&=data_class
and you want the SMS data class to provide the LRecl value, or when you are
specifying DCbdsn=data_set_name and you want to use the LRecl from the
DCBDSN data set. If LRecl=length is specified with either DATAClass or
DCbdsn, the length specified by the SIte LRecl parameter overrides the
DATAClass or DCbdsn LRecl.
length
Specifies the logical record length of a newly allocated data set. The valid
range is 0—32760. A special value of x (LRecl=x) is also supported to
indicate that a logical record length can exceed 32760 for variable-length
spanned records.
Specifying LRecl=0 has the same effect as specifying LRecl with no
parameters.
MBDATACONN=(file_system_codepage,network_transfer_codepage)
Specifies the codepages for the file system and for the network transfer used

SIte subcommand
when the server does data conversion during a data transfer. This parameter
affects the conversion of multibyte character set (MBCS) data (including
support for DBCS code pages) and is used when the ENCODING=MBCS is
also specified.
file_system_codepage
Specifies the name of the file system codepage.
network_transfer_codepage
Specifies the name of the network transfer codepage.
MBREQUIRELASTEOL
Specifies that the FTP server will report an error when a multibyte file or data
set is received from the network with no EOL sequence in the last record
received. FTP will abort the file transfer.
MBSENDEOL
Specifies which end-of-line sequence to use when ENCODING is MBCS and
data is being sent to the client and translated to ASCII.
CRLF
standard sequence defined by RFC 959.
CR
translated text.
translated text.
NONE
Requirements:
v Most FTP clients support only the CRLF value for incoming ASCII data. Do
not specify another value for MBSENDEOL unless you have verified that the
client is expecting the end-of-line sequence that you specify.
v Do not use an end-of-line sequence other than CRLF if the client is a z/OS
FTP client. The z/OS FTP client supports only the CRLF value for incoming
type ASCII data.
v Do not attempt to stream mode restart a multibyte file retrieve that
originated while the FTP server MBSENDEOL value was not CRLF.
MGmtclass
Specifies the SMS management class as defined by your organization for the
target host. Specifying MGmtclass with no mgmtclass cancels the management
class specification. The equal sign (=) is optional in this case.
mgmtclass
Specifies the SMS management class as defined by your organization for
the target host. If the mgmtclass specified has a setting for RETpd, the
value specified by the mgmtclass can override the setting of the RETpd site
parameter, the RETpd value of a model data set if the DCbdsn parameter
is specified, and the RETpd value defined in an SMS data class if
DATAClass is specified. See “Specifying values for new data sets” on page
91 for more information about specifying attributes when allocating new
data sets.

SIte subcommand
MIGratevol
Specifies the volume ID for migrated data sets if they do not use IBM Storage
Management Subsystems. If you do not specify MIGratevol, the default
volume_serial is MIGRAT.
volume_ID
The volume ID for migrated data.
NOASAtrans
Treats ASA file transfers as regular file transfers; that is, the ASA characters are
treated as part of the data and are not converted to print control characters.
NOAUTOMount
Prevents automatic mounting of volumes for data sets on volumes that are not
mounted.
NOAUTORecall
Prevents automatic recall of migrated data sets.
Note: A migrated data set can be deleted even though NOAUTORecall is

specified, because migrated data sets are not recalled for deletion.
NODBSUB
translated in a double-byte character translation. This causes a data transfer
failure if a character cannot be translated during the transfer. This is the
default.
NOISPFSTATS
Does not allow FTP to create or update ISPF member statistics when PUt,
MPut, or APpend subcommands are issued.
NOLISTSUBdir
Use the NOLISTSUBdir option to indicate that wildcard searches should apply
only to the current working directory. This setting affects processing of the
NLST command. The z/OS FTP client sends an NLST command to the server
as part of LS*, MDelete *, and MGet * subcommand processing.
Restrictions:
1. The NOLISTSUBdir option applies to z/OS UNIX file operations only; MVS
2. The FTP client must be communicating with a z/OS V1R7 or later FTP
server or an unrecognized parameter response will be received.
Result: If the NOLISTSUBdir option is not specified on the SITE subcommand

and the LISTSUBDIR statement is not specified in the client FTP.DATA file, the
default is as if the LISTSUBdir option was specified on the SITE subcommand.
NOMBREQUIRELASTEOL
Specifies that the FTP server will not report an error when a multibyte file or
data set is received from the network with no EOL sequence in the last record
received. FTP will report the file transfer as completed.
NOQUOtesoverride
Treats a single quotation mark appearing at the beginning of the file name, as
well as all other single quotation marks contained in the file name, as part of
the actual file name. The entire file name, including the leading single
quotation mark, is appended to the current working directory.

SIte subcommand
NORDW
Specifies that Record Descriptor Words (RDWs) are not treated as if they were
part of the record and are discarded during FTP transmission of variable
format data sets.
NOSBSUB
translated in a single-byte character translation. This causes a data transfer
failure if a character cannot be translated during the transfer.
NOSPRead
Specifies that the output is in report format rather than spreadsheet format
when the file type is SQL.
NOTRAILingblanks
Specifies that the FTP server does not preserve the trailing blanks that are in a
fixed format data set when the data is sent to the foreign host.
NOTRUNcate
Specifies that truncation is not permitted. The FTP server will set an error and
fail file transfer if a record that is longer than the LRECL of the new file is
detected.
Note: If WRAPRECORD is set then the data is wrapped, not truncated, no

error will be set and the file transfer will continue.
NOUCSSUB
| In UCS-2-to-EBCDIC conversion, the data transfer is terminated if any UCS-2
character cannot be converted into the EBCDIC code set.
NOUCSTRUNC
| In UCS-2-to-EBCDIC conversion, truncation of EBCDIC data is not allowed.
The data transfer is aborted if the logical record length of the receiving data set
is too small to contain the data after conversion to EBCDIC.
Note: The setting of the CONDdisp parameter determines what happens to

the target data set if the transfer is aborted.
NOWRAPrecord
Indicates that data is truncated if no new line character is encountered before
the logical record length of the receiving file is reached.
Note: If NOWRAPrecord and NOTRUNcate are set, then an error will be set
and the file transfer will fail.
NOWRTAPEFastio
Indicates that ASCII Stream data that is being written to tape must be written
using the Language Environment runtime library.
PDSTYPE
Specifies whether the FTP server creates MVS directories as partitioned data
sets or as partitioned data sets extended.
When specified without a value, FTP will not specify to z/OS whether to
allocate a new MVS directory as a PDS or a PDSE. When specified without a
value, the equal sign (=) is optional.
PDS
Allocate directories as partitioned data sets.
PDSE
Allocate directories as partitioned data sets extended.

SIte subcommand
PRImary
When specified without an amount, no primary value is used when allocating
the data set. The equal sign (=) is optional in this case.
Specify PRImary with no value when you are also specifying
DATAClass=data_class and you want the SMS data class to provide the
PRImary amount.
To allow the SMS data class to determine the space allocation, both PRImary
and SECondary must be specified with no value. The tracks, blocks, and
cylinders setting is ignored in this case. If PRImary=amount is specified with
DATAClass, the value specified by the SIte PRImary parameter overrides the
DATAClass space allocation.
amount
For allocating partitioned data sets, this is the amount of space that is
allocated for the primary extent.
For allocating sequential data sets this is the maximum amount of space
that is allocated for the primary extent. If a smaller amount of space is
needed to hold the data being transferred, only the amount actually
needed to hold the data is allocated. The valid range is 1 - 16 777 215.
Qdisk
Used to display statistics about available space on a volume. If the Qdisk
parameter is entered without a specific volume_serial, statistics about available
space are displayed for each volume that is defined with “Use
Attribute=storage.”
volume_serial
Displays statistics about available space on a specific volume.
QUOtesoverride
Specifies that single quotation marks at the beginning and end of a file name
the current working directory. This is the way single quotation marks are used
in all previous MVS FTP servers and is the default. Any single quotation mark
inside the beginning and ending quotation marks is treated as part of the file
name.
QUOtesoverride indicates the usage of single quotation mark appearing at the
beginning of, or surrounding, a file name. The setting of this keyword affects
all FTP subcommands that have a path name as a parameter except keywords
on the SIte subcommand.
RDW
Specifies that Record Descriptor Words (RDWs) are treated as if they were part
of the record and are not discarded during FTP transmission of variable format
data sets in stream mode.
Note: RDW information is stored in binary format. Transfer files in binary

mode to avoid translation problems that can occur if you transfer this
binary field in EBCDIC or ASCII mode.
READTAPEFormat
Used to provide information about an input data set on tape. If specified
without the tape_format (which is the default), processing of input tapes does
not take advantage of the record format information prior to open. The equal
sign (=) is optional in this case.

SIte subcommand
READTAPEFormat has no effect on, and is not affected by DATAClass,

DCbdsn, JESLrecl, JESRecfm, LRecl, RECfm, or any other parameters associated
with creating a data set.
tape_format
Specifies the format of the records on the input tape data set. Valid formats
are:
S Spanned records
X Logical record length is undefined (Lrecl X)
blank Unspecified (displayed as U in messages and reply)
The formats are mutually exclusive. Spanned implies variable and Lrecl X
implies spanned. If specified, the tape_format value must be the most
inclusive identifier in the list that matches the tape. If it is not the most
inclusive identifier, an error message is issued. For example, if the
tape_format value is S (spanned) and the tape contains records with
undefined length (Lrecl X), the request fails. An unspecified format avoids
this type of error. However, the following should be considered:
v Specify a value for READTAPEFormat in all the following cases. Failure
to specify a format will likely cause errors in processing the tape.
– The record length is undefined (Lrecl X).
– The records are spanned (Recfm is VBS, VS).
– The records are variable (Recfm is V, VB, VBA) and RDW is specified.
v Specify a value for READTAPEFormat for all input tapes with one of the
listed formats to ensure best results.
RECfm
Specifies the record format of a data set. When specified without the format, no
record format is used when allocating the data set. The equal sign (=) is
optional in this case.
Specify RECfm with no value when you are also specifying
DATAClass=data_class and you want the SMS data class to provide the RECfm
format, or when you are specifying DCbdsn=data_set_name and you want to use
the record format from the DCBDSN data set.
If RECfm=format is specified with either DATAClass or DCbdsn, the value
specified by the SIte RECfm parameter overrides the DATAClass or DCbdsn
record format.
format
Specifies the record format of a data set. Valid record formats are: F, FA,
FB, FBA, FBM, FBS, FBSA, FBSM, FM, FS, FSA, FSM, U, UA, UM, V, VA,
VB, VBA, VBM, VBSA, VBSM, VBS, VM, VS, VSA, and VSM. The
characters used to specify these record formats have the following
meanings:
Code Description
U Undefined record length
B Blocked records
S Spanned records (if variable) / standard records (if fixed)

SIte subcommand
Code Description
A Records contain ISO/ANSI control characters
M Records contain machine code control characters
RETpd
retained. When specified without the number of days, a retention period will
not be specified when allocating new data sets. The equal sign (=) is optional
in this case.
Specify RETpd with no value when you are also specifying
DATAClass=data_class or MGmtclass=mgmtclass and you want SMS to provide
the RETpd value, or when you are specifying DCbdsn=data_set_name and you
want to use the RETpd from the DCBDSN data set. If more than one of the
SIte parameters (RETpd, MGmtclass, DATAClass, or DCbdsn) are specified, the
order of precedence (highest to lowest) is:
1. MGmtclass
2. RETpd
3. DCbdsn
4. DATAClass
If a retention period is associated with an SMS management or data class, or
with a model DCBDSN data set, the value of the retention period can be
overridden to another retention period, but it cannot be overridden to have no
retention period specified for the newly created data sets.
days
retained. The valid range is 0—9999. A value of 0 indicates a retention
period of 0 days so that the data set expires the same day it was created.
Note: An attempt to either append or replace an existing data set with a

retention period requires operator interaction to take place for
permission to alter the data set. This is normal MVS behavior.
SBDataconn
used for data transfers. Valid subcommands are:
SITE SBDataconn=dsname
SITE SBDataconn=(file_system_cp,network_transfer_cp)
SITE SBDataconn=FTP_STANDARD_TABLE
SITE SBDataconn=*

dsname
Specifies the fully qualified name of an MVS data set or z/OS UNIX file
that contains the EBCDIC-to-ASCII and ASCII-to-EBCDIC translate tables
generated by the CONVXLAT utility.
Notes:
1. The name must not be enclosed in quotation marks. If quotation marks
appear, they are treated as part of the name. (QUOtesoverride is
ignored.)
2. The z/OS UNIX file system name is case sensitive. The MVS name is
not case sensitive.
3. The name cannot begin with a left parenthesis [(].

SIte subcommand
4. The SBDataconn keyword must be the only keyword or the last

keyword on a SIte subcommand.
5. The translate tables being used for the data connection can also be
changed by a SIte XLate subcommand.
6. SIte XLate and SIte SBDataconn are mutually exclusive.
file_system_cp
Specifies the name of a code page recognized by iconv. For a list of code
pages supported by iconv, see code set converters information in the z/OS
XL C/C++ Programming Guide.
network_transfer_cp
Specifies the name of a code page recognized by iconv. For a list of code
pages supported by iconv, see code set converters information in the z/OS
XL C/C++ Programming Guide.
FTP_STANDARD_TABLE
are shipped in TCPXLBIN(STANDARD), are to be used on the data
connection.
* Indicates the translate tables set up at initialization for the data connection
must be used.
SBSENDEOL
Specifies which end-of-line sequence to use when ENCODING is SBCS, the data
type is ASCII, and data is being sent to the client.
CRLF
CR
translated text.
translated text.
NONE
Tips:
1. The SIZE command is disabled if you configure a SBSENDEOL value other
than CRLF.
2. The REST command in Mode Stream is disabled if you configure a
SBSENDEOL value other than CRLF. A mode block REST command is not
affected by the SBSENDEOL setting.
3. SIZE and REST commands are sent by clients as part of a stream mode
restart of an interrupted file transfer. Because these commands are disabled
by changing the SBSENDEOL value from the RFC 959 standard, stream
mode restarts are effectively disabled. Block mode restart is not affected by
the SBSENDEOL setting.
Rules:

SIte subcommand
1. Most clients support only the CRLF value for incoming type ASCII data.
Do not specify another value for SBSENDEOL unless you have verified that
the client is expecting the EOL sequence that you specify.
2. Do not use an EOL sequence value other than CRLF if the client is a z/OS
FTP client. The z/OS FTP client supports only the CRLF value for incoming
ASCII data.
SBSUB
a single byte character translation. The substitution character is specified by the
SBSUBCHAR parameter.
SBSUBCHAR nn
The value is one of the following:
SPACE
When the target code set is ASCII, replace untranslatable characters
with X'20' during SBCS data transfers. When the target code set is
EBCDIC, replace untranslatable characters with X'40' during SBCS data
transfers.
nn Replace untranslatable characters with nn during SBCS data transfers
where nn is a hexadecimal value from 00 to FF.
SECondary
Specifies the number of tracks, blocks, or cylinders for secondary allocation.
When specified without the amount for the C server, no secondary value is
used when allocating the data set. The equal sign (=) is optional in this case.
Specify SECondary with no value when you are also specifying
DATAClass=dataclass and you want the SMS data class to provide the
SECondary value. To allow the SMS data class to determine the space
allocation, both PRImary and SECondary must be specified with no value. The
tracks, blocks, or cylinders setting is ignored in this case. If SECondary=amount
is specified with DATAClass, the value specified by the SIte SECondary
parameter overrides the DATAClass space allocation.
amount
Specifies the amount of tracks, blocks, or cylinders for secondary
allocation. The valid range is 0—16 777 215.
SPRead
Specifies that the output is in spreadsheet format when the file type is SQL.
SQLCol
Specifies the column headings of the SQL output file.
any
The label of the DB2 SQL table column heading is the first choice for
column heading, but if there is no label, the name becomes the column
heading.
labels
Labels are the DB2 SQL table column headings. If any of the columns do
not have labels, FTP supplies a column heading in the form of COLnnn.
names
Uses the names of the DB2 SQL table column headings. The labels are
ignored.

SIte subcommand
STOrclass
Specifies the SMS storage class for the target host, as defined by your
organization. Cancels the storage class specification when specified without a
storage_class parameter value. The equal sign (=) is optional in this case.
storage_class
Specifies the SMS storage class as defined by your organization for the
target host.
When an SMS storage class is in use, any of the attributes specified there
can be overridden bye the user by a different specification. To avoid
overriding the setting in the SMS storage class, specify BLKSize, LRecl,
PDSTYPE, PRImary, RECfm, SECondary, UCOUNT, Unit, VCOUNT, or
VOLume with no associated value. This removes any value specified on a
prior SITE command or in FTP.DATA, and the affected attributes are not
included on the allocation. To override a setting in the SMS storage class,
specify the desired value with the appropriate keyword.
TRacks
Specifies that primary and secondary space allocations are in tracks. If both
PRImary and SECondary values are unspecified, and an SMS data class value
has been specified, the space allocation is determined by the SMS data class
value and the TRacks parameter value is ignored.
TRAILingblanks
Specifies that the FTP server preserves the trailing blanks that are in a fixed
format data set when the data is retrieved from a foreign host.
TRUNcate
Specifies that truncation is permitted. The FTP server does not set an error
when a truncated record is detected and file transfer continues.
UCOUNT
request.
unit_count
Specifies number of devices to allocate. Valid values are in the range 1–59.
When specified without a value, the FTP server does not specify a unit
count when allocating data sets.
P Parallel mount request.
Guideline: The UCOUNT statement is not meant to be used with an SMS

storage class. Any UCOUNT value you specify overrides whatever is specified
for the SMS managed dataclass that being used.
UCSHOSTCS
| Specifies the EBCDIC code set to be used when converting to and from UCS-2.
If you do not specify a code_set value, the current code set is used.
code_set
Name of the EBCDIC code set to be used when converting to and from
| UCS-2.
UCSSUB
| In UCS-2-to-EBCDIC conversion, the EBCDIC substitution character is used to
| replace any UCS-2 character that cannot successfully be converted. Data
transfer continues.

SIte subcommand
UCSTRUNC
| In UCS-2-to-EBCDIC conversion, truncation of EBCDIC data is allowed. The
data transfer continues even if EBCDIC data is truncated.
Note: If the EBCDIC data contains any double-byte data, truncation might not
honor character boundaries and EBCDIC records might not end in
Shift-in state.
UMask
Defines the file mode creation mask. The file mode creation mask defines
which permission bits are not to be set on when a file is created. When a file is
created, the permission bits requested by the file creation are compared to the
file mode creation mask, and any bits requested by the file creation which are
disallowed by the file mode creation mask are turned off.
The format of the UMask keyword is UMASK ooo.
When a file is created, the specified permission bits for the file are 666
(-rw-rw-rw-). If the file mode creation mask is 027, the requested permissions
and the file mode creation mask are compared:
110110110 - 666
000010111 - 027
---------
11010000 - 640
The actual permission bits set for the file when it is created is 640 (-rw-r-----).
Notes:
1. The default value for UMask is 027.
2. You cannot use FTP to create z/OS UNIX files with execute permissions. If
you require execute permissions, use the SITE CHMod command to change
permissions after the file has been created.
Specifies whether the FTP server will store incoming Unicode files with a byte
order mark (BOM).
| Restriction: The only Unicode encoding formats supported for file storage by
| z/OS FTP are UTF-8 and UTF-16. Files are always stored in big endian format.
| Result: The byte order mark (BOM) stored with the file is determined by the
| encoding used to store the file rather than by the format of the BOM sent with
| the file.
ASIS
Store incoming Unicode files with a byte order mark only if the file was
sent with a byte order mark.
ALWAYS
Store incoming Unicode files with a byte order mark regardless of whether
the file was sent with a byte order mark.
NEVER
Store incoming Unicode files without a byte order mark regardless of
whether the file was sent with a byte order mark.
Results:
v The Unicode byte order mark, U+FEFF, can also be interpreted as
zero-width nonbreaking space. z/OS FTP considers only the first character
of the file as a possible byte order mark (BOM). No other instance of the
BOM sequence in the file is affected by this setting.

SIte subcommand
v When appending to a nonexistant file, the FTP server respects the

UNICODEFILESYTEMBOM setting. However, when appending to an
existing file, the FTP server always strips a leading byte order mark from the
incoming file. This prevents a superfluous BOM from being inserted in the
server file.
Unit
unit_type
The unit type (for example, 3380) for the allocation of new data sets on
direct access devices. If a unit_type value is not specified, the unit type
used for allocation is restored to the system default.
VCOUNT
span. When this parameter is specified without a volume_count value, the FTP
| server uses the volume count 50 when it allocates tape data sets.
volume_count
Valid values are in the range 1–255.
VOLume
volume_serial
The serial number of the volume to use for allocation.
volume_serial_list
A list of one or more volume serial numbers for allocation. Delimit each
volume_serial from the prior one with a comma.
If a VOLume value is specified without a volume_serial_list or volume_serial

parameter, no volumes are specified by the FTP server during the allocation of
a new data set, and the installation default is used.
The MVS FTP server identifies multiple commands issued with a single-site
command by the white space. For example (note the white space in the two
commands): site vol=fffff is a single-site command; however, site vol =
fffff is treated by the server as three different commands.
WRAPrecord
Indicates that data is wrapped to the next record if no new line character is
WRTAPEFastio
Indicates that ASCII Stream data that is being written to tape is allowed to be
written using BSAM I/O.
XLate
Indicates the desired translate table to be used for the data connection. Valid
subcommands are:
SITE XLate=name
SITE XLate=*
name
Specifies the name that corresponds to the desired translate table data set.
The corresponding data set name is hlq.name.TCPXLBIN unless
environment variable _FTPXLATE_name = dsn was defined for the FTP
server to override the data set name. In that case, dsn is the data set used.

SIte subcommand
* Indicates that the translate tables set up at initialization for the data
connection are to be used.
Notes:
1. The translate tables being used for the data connection can also be changed
by an SBDataconn subcommand.
2. SIte XLate and SIte SBDataconn are mutually exclusive.
Usage
v Because more than one parameter can be specified with the SIte subcommand,
parameter can be repeated many times, with each parameter separated by a blank
space.
v If the remote host is using TCP/IP, use the SIte subcommand to set data set
routing and send data set allocation attributes to the host. The site-dependent
information sent with the SIte subcommand remains active until you issue a
new SIte subcommand. The new SIte subcommand adds to or changes the
attributes established by previous SIte subcommands.
v If you specify one or more incorrect parameters with the SIte subcommand, an
error message specifying the incorrect parameter is displayed. All correct
parameters are set, regardless of any incorrect parameters, and do not need to be
reissued.
v If the data sets are sent from an MVS host, use the SENDSite subcommand to
automatically invoke the SIte subcommand.
If the local host does not support the SIte subcommand, site information can be
sent to the MVS FTP server from the client using the QUOte subcommand.
v Use the HElp SERVER SIte command to information about the SIte parameters
supported by a server.
Context
v To check the effect of the SIte subcommand on the attributes at the foreign host,
see “STAtus subcommand—Retrieve status information from a remote host” on
page 301.
v See “SENDSite subcommand—Toggle the sending of site information” on page
269 for more information about the SENDSite subcommand.
v See “QUOte subcommand—Send an uninterpreted string of data” on page 259
for more information about the QUOte subcommand.
v See the z/OS MVS JCL Reference for more information about some of the SIte and
LOCSIte parameters.

SJiskanji subcommand
SJiskanji subcommand—Change the data transfer type to SJISKANJI
Purpose
Use the SJiskanji subcommand to change the data transfer type to SJISKANJI.
Format
SJiskanji
(
Ascii NOSo NOType
Sosi
Ebcdic
Space
Parameters
Sosi
of the following parameters — Ascii, Ebcdic or Space. If no parameter is
transferred data.
Ascii
data.
Ebcdic
data.
Space
NOSo
NOType

SJiskanji subcommand
Examples
To cause the FTP client to change its transfer type to Shift JIS kanji, without
sending a TYpe command to the FTP server, use:
SJISKANJI (NOTYPE
The server in this example should be set to the ASCII transfer type before the
(NOTYPE subcommand is issued.
Usage
v The SJiskanji client subcommand is equivalent to the TYPE B 1 server command.
v The SJiskanji (Sosi or SJiskanji (Sosi ASCII client subcommands are equivalent to
the TYPE B 1 S A server command.
v The SJiskanji (Sosi EBcdic client subcommand is equivalent to the TYPE B 1 S E
server command.
v The SJiskanji (Sosi SPACE client subcommand is equivalent to the TYPE B 1 S S
server command.
v The SJiskanji (NOSO client subcommand is equivalent to the TYPE B 1 N server
command.
Context

SRestart subcommand
SRestart subcommand—Restart a stream data transfer
Purpose
Use the SRestart subcommand to restart an interrupted stream mode data transfer.
Format
SRestart
Get foreign_file
local_file
PUt local_file
foreign_file
Parameters
Get
Resume a subcommand.
foreign_file
local_file
Specifies the name of the local file created as a result of the Get
subcommand.
Enter the same names for foreign_file and local_file as you used in the
interrupted subcommand.
You can override the usage of the current local working directory in the
local file name by specifying local_file as a complete data set name enclosed
in single quotation marks (’). If local_file is not specified, the local_file name
is the same as the foreign_file name.
PUt
Resume a put subcommand.
local_file
Specifies the name of the file on your local host being sent to the remote
host.
foreign_file
Specifies the name that the delivered file is given on the remote host. If the
foreign_file name is not specified, the foreign_file name is the same as the
local_file name.
Enter the same names for foreign_file and local_file as you used in the
interrupted put subcommand.
You can override the usage of the current local working directory in the
local file name by specifying local_file as a complete data set name enclosed
in single quotation marks (’). If local_file is not specified, the local_file name
is the same as the foreign_file name.
Usage
v Do not use SRestart to resume an interrupted file transfer unless you can
recreate the start options, FTP.DATA statements, SIte, and LOCSIte options in
effect at the time of the failed file transfer. Unpredictable results can occur if the

SRestart subcommand
file transfer environment cannot be recreated. If you cannot recreate the file
transfer environment, issue Get or PUt to transfer the file again.
v Not all file transfers can be resumed in STREam mode. Observe these
restrictions during the original file transfer as well as the SRestart transfer.
– Mode must be STREam.
– Filetype must be SEQ.
– Structure must be FILE.
– SUnique option must be disabled.
– Data type must be ASCII, EBCDIC, or Image.
– SITE and LOCSITE ENcoding must be SBCS (SRestart does not support DBCS
or MBCS ENcoding).
– The session cannot be protected with an active security mechanism (such as
TLS or Kerberos).
– For SRestart PUt, LOCSITE SBSENDEOL=CRLF must be set. If the original
transfer used a setting other than CRLF, the transfer cannot be restarted.
Using a setting other than CRLF will cause the SRestart to fail. Setting
SBSENDEOL to CRLF when the original transfer used a different setting will
corrupt the remote file.
– For SRestart Get, SITE SBSENDEOL=CRLF must be set. If the original transfer
used a setting other than CRLF, the transfer cannot be restarted. Using a
setting other than CRLF will cause the SRestart to fail. Setting SBSENDEOL to
CRLF when the original transfer used a different setting will corrupt the local
file.
– The local file must reside in the z/OS UNIX file system.
| – For SRestart PUt, a server that is z/OS Communications Server V1R2 or later
| will reject the restart if the foreign_file value is not a z/OS UNIX file system
| file.
v For SRestart PUt, if the server cannot calculate an appropriate point to restart
the file transfer, SRestart will fail.
v For SRestart Get, if the client cannot calculate an appropriate point to restart the
file transfer, SRestart will fail.
v If SRestart fails, use Get or PUt and start the file transfer again.
Context
v See “STRucture subcommand—Set the file structure” on page 309 for more
information.
195 for a description of the SBSENDEOL and ENcoding parameters.

STAtus subcommand
STAtus subcommand—Retrieve status information from a remote host
Purpose
Use the STAtus subcommand to retrieve current configuration information from
the FTP server. This information includes the current settings of the configuration
variables, which can be initialized in the FTP.DATA data set or changed using
various FTP subcommands. For information about the parameters of the FTP.DATA
data set, see the z/OS Communications Server: IP Configuration Reference.
Format
STAtus
name (option
options:

STAtus subcommand
| ASAtrans
AUTOMount
AUTORecall
BLKsize
BLocks
BLOCKSIze
BUfno
CHKptint
CONDdisp
CYlinders
DATAClass
DATASetmode
DB2
DBSUB
DCbdsn
DESt
Directory
DIRECTORYMode
ENcoding
FILEtype
FTpkeepalive
INactivetime
ISPFStats
JESENTRYLimit
JESJOBName
JESLrecl
JESOwner
JESRecfm
JESSTatus
LISTSUBdir
LRecl
MBDATACONN
MBREQUIRELASTEOL
MBSENDEOL
MGmtclass
MIGratevol
PDSTYPE
PRImary
QUOtesoverride
RDw
READTAPEFormat
RECfm
RETpd
SBDataconn
SBSENDEOL
SBSUB
SBSUBChar
SECondary
SPRead
SQLCol
STOrclass
TLSRFCLEVEL
TRacks
TRAILingblanks
TRUNcate
UCOUNT
UCSHostcs
UCSSub
UCSTrunc
UMask

STAtus subcommand
Unit
VCOUNT
VOLume
WRAPrecord
WRTAPEFastio
XLate
Parameters
ASAtrans
Indicates that the FTP client interprets characters in the first column of ASA
files being transferred as print control characters.
AUTOMount
Indicates automatic mounting of volumes for data sets that are on unmounted
volumes.
AUTORecall
Indicates automatic recall of migrated data sets.
BLocks
Indicates that primary and secondary space allocations are in blocks.
BLOCKSIze
Specifies the block size of a newly allocated data set.
BUfno
Indicates the number of access method buffers that are to be used when data is
read from or written to a data set.
CHKptint
Specifies the checkpoint interval for the sending site in a file transfer request.
CONDdisp
CYlinders
Indicates that primary and secondary space allocations are in cylinders.
DATAClass
Specifies the SMS data class.
DATASetmode
DB2
Specifies the DB2 subsystem name.
DBSUB
Indicates whether substitution is allowed for data bytes that cannot be
translated in a double-byte character translation.
DCbdsn
Specifies the name of the MVS data set to be used as a model for allocating
new data sets.
DESt
Specifies the Network Job Entry (NJE) destination to which the files are routed
when you enter a PUt command.

STAtus subcommand
Directory
PDS.
DIRECTORYMode
ENCODING
Specifies the encoding type that is used for conversions between code pages
for data transfers.
FILEtype
Indicates the data set file type.
FTpkeepalive
Specifies the control connection keepalive timer value in seconds.
INactivetime
Specifies the inactivity timer to a specified number of seconds.
ISPFSTATS
Indicates that FTP will create or update ISPF Member statistics when PUt,
MPut, or APpend subcommands are issued.
JESENTRYLimit
Indicates the number of entries that can be displayed concurrently using a
LIST or NLST command.
JESJOBName
Indicates that any command (Get, LIST, DIr, or MGet) should be limited to
those jobs, started tasks, APPC/MVS, or TSO output that match the specified
value.
JESLrecl
Specifies the logical record length (LRecl) for the Job Entry System (JES)
internal reader at the foreign host.
JESOwner
Indicates that any command (Get, LIST, DIr, or MGet) should be limited to
those jobs, started tasks, APPC/MVS, or TSO output which are owned by the
user ID specified.
JESRecfm
Specifies the record format for the JES internal reader at the foreign host.
JESSTatus
Specifies what type of information should be returned on LIST and NLST
commands.
LISTSUBdir
Indicates that wildcard searches should apply to the current working directory
and should also span its subdirectories.
LRecl
Specifies the logical record length (LRecl) of a newly allocated data set.
MBDATACONN
Specifies the code pages for the file system and for the network transfer that
are used when the client does data conversion during a data transfer.
MBREQUIRELASTEOL
Indicates whether the FTP client reports an error when a multibyte file or data
set is received from the server with no EOL sequence in the last record
received.

STAtus subcommand
MBSENDEOL
Indicates which end-of-line sequence to use when the ENCODING value is
SBCS, the data is ASCII, and data is being sent to the server.
MGmtclass
Specifies the SMS management class as defined for the target host by your
organization.
MIGratevol
management systems.
PDSTYPE
Indicates whether the FTP client creates local MVS directories as partitioned
PRImary
Specifies the number of tracks, blocks, or cylinders for the primary allocation.
QUOtesoverride
Indicates that a single quotation mark at the beginning and end of a file name
RDW
Indicates that variable record descriptor words (RDWs) are treated as if they
are part of the record and are not discarded during FTP transmission of
variable format data sets in stream mode.
READTAPEFormat
Displays information about an input data set on tape.
RECfm
Displays the data set record format.
RETpd
retained.
SBDataconn
SBSENDEOL
Specifies which end-of-line sequence to use when ENCODING is SBCS, the
data is ASCII, and data is being sent to the client.
SBSUB
a single-byte-character translation.
SBSUBCHAR
SECondary
Specifies the number of tracks, blocks, or cylinders for the secondary
allocation.
SPRead
Indicates that the output is in spreadsheet format when the file type is SQL.
SQLCol
Specifies the SQL output file column headings.

STAtus subcommand
STOrclass
Specifies the SMS storage class as defined by your organization for the target
host.
| TLSRFCLEVEL
| Specifies the level of RFC 4217, On Securing FTP with TLS, that is supported by
| the server.
TRacks
Indicates that primary and secondary space allocations are in tracks.
TRAILingblanks
Indicates that the FTP client preserves the trailing blanks in a fixed-format data
TRUNcate
Indicates that truncation is permitted.
UCOUNT
Indicates the number of devices to allocate concurrently to support the
allocation request.
UCSHOSTCS
Indicates the EBCDIC code set to be used when converting to and from
Unicode.
UCSSUB
Indicates that in Unicode-to-EBCDIC conversion, the EBCDIC substitution
character is used to replace any Unicode character that cannot be successfully
converted.
UCSTRUNC
Indicates that in Unicode-to-EBCDIC conversion, EBCDIC data truncation is
allowed.
UMask
Specifies the file mode creation mask.
Indicates whether the FTP client will store incoming Unicode files that have a
byte order mark.
Unit
VCOUNT
span.
VOLume
WRAPrecord
Indicates that data is wrapped to the next record if no new-line character is
WRTAPEFastio
Indicates that ASCII stream data that is being written to tape can be written
using BSAM I/O.
XLate
Specifies the translate table to be used for the data connection.

STAtus subcommand
Examples
The following is an example of the STAtus subcommand using a single parameter:
status (asatrans
>>> XSTA (asatrans
211-ASA control characters in ASA files opened for text processing
211-will be transferred as ASA control characters.
211 *** end of status ***
The following is an example of retrieving the status information from an FTP

server:
status
>>>STAT
211-Server FTP talking to host 9.117.222.59, port 23467
211-User: USER33 Working directory: /u/user33
211-The control connection has transferred 395 bytes
211-There is no current data connection.
211-The next data connection will be actively opened
211-to host 9.117.222.59, port 23467,
211-using Mode Stream, Structure File, type EBCDIC, byte-size 8
211-Automatic recall of migrated data sets.
211-Automatic mount of direct access volumes.
211-Auto tape mount is allowed.
211-Inactivity timer is disabled
211-VCOUNT is 59
211-ASA control characters in ASA files opened for text processing
211-will be transferred as ASA control characters.
211-Trailing blanks are removed from a fixed format
211-data set when it is retrieved.
211-Data set mode. (Do not treat each qualifier as a directory.)
211-ISPFSTATS is set to FALSE
211-Primary allocation 2 tracks. Secondary allocation 1 track.
211-Partitioned data sets will be created with 27 directory blocks.
211-FileType SEQ (Sequential - default).
211-Number of access method buffers is 5
211-RDWs from variable format data sets are discarded.
211-Records on input tape are unspecified format
211-SITE DB2 subsystem name is D7A
211-Data not wrapped into next record.
211-Tape write is not allowed to use BSAM I/O
211-Truncated records will not be treated as an error
211-JESLRECL is 80
211-JESRECFM is Fixed
211-JESINTERFACELEVEL is 1
211-ENcoding is set to SBCS
211-DBSUB is set to TRUE
211-SBSUB is set to FALSE
211-SBSUBCHAR is set to SPACE
211-SMS is active.
211-New data sets will be catalogued if a store operation ends abnormally
211-Single quotes will override the current working directory.
211-UMASK value is 027
211-Process id is 50331660
211-Checkpoint interval is 0
211-Authentication type: None
211-Record format FB, Lrecl: 80, Blocksize: 3120
211 *** end of status *** Command:
Usage
The retrieved status information can be a directory, a file, or general status
information, such as a summary of activity. If name is omitted, general status
information is retrieved.
For further information about setting values for server initialization in the
FTP.DATA data set, see the z/OS Communications Server: IP Configuration Reference.

STREam subcommand
STREam subcommand—Set the stream data transfer mode
Purpose
Use the STREam subcommand to set the data transfer mode to stream mode. This
is equivalent to specifying the MOde S subcommand. See “MOde
subcommand—Set the data transfer mode” on page 242 for more information.
Format
STREam
Parameters

STRucture subcommand
STRucture subcommand—Set the file structure
Purpose
Use the STRucture subcommand to set the file structure.
Format
STRucture File
Record
Parameters
File
Sets the file structure to File. When the STRucture value is File, the file is sent
as a continuous sequence of data bytes.
Record
Sets the file structure to Record. When the STRucture value is Record, the file
is sent as a series of records.
Tip: Use STRucture RECORD in conjunction with a CHKConfidence value of

TRUE in FTP.DATA to improve detection of incomplete file transfers.

SUnique subcommand
SUnique subcommand—Changes the storage method
Purpose
The SUnique subcommand changes the method of storing files on the foreign host.
Format
SUnique
On Off NAME NONAME
Parameters
On
Turns on store unique.
Off
Turns off store unique.
NAME
When specified with ON or OFF, instructs the client to include a name when
sending a store-unique command to the server.
NONAME
When specified with ON or OFF, instructs the client to omit a name when
sending the store-unique command to the server.
Usage
v By default, the SUnique setting is OFF NAME and FTP uses a store command
(STOR) with the PUt and MPut subcommands. If the foreign host already has a
data set or file with the name specified by the foreign_file value, the foreign host
overwrites the existing data set or file.
v If SUnique is set to ON, FTP uses a store-unique command (STOU) with the PUt
and MPut subcommands and prevents you from overwriting or erasing the
existing data set or file on the foreign host. If the default setting of NAME is in
effect, a name string is sent to the server with the store-unique command. The
created foreign data set or file is stored with a unique name. FTP sends the
unique name of the created foreign data set or file to the local host, where the
data set or file name is displayed on your terminal.
v SUnique with no parameters toggles the ON/OFF setting. If ON or OFF is
specified, SUnique is set to that value, regardless of its current setting. The
NAME/NONAME setting can be changed as SUnique is turned ON or OFF. It is
in effect when SUnique is ON and does not change for the session until another
NAME or NONAME setting is specified.

SYstem subcommand
SYstem subcommand—Display the operating system name
Purpose
Use the SYstem subcommand to display the name of the remote host operating
system. The remote host must have also implemented the SYST subcommand.
Format
SYstem
Parameters
Usage
Use this subcommand to determine the operating system at the server. The reply
from the server has as its first word one of the system names from the Protocol
Numbers and Assignment Services list for Operating System Names. The names
are maintained by the Internet Assigned Numbers Authority (http://
www.iana.org). For the z/OS server, the reply is determined by the current
working directory at the server.
v If the current working directory is a z/OS UNIX file system directory, the reply
is:
215 UNIX is the operating system of this server. FTP Server is running on z/OS.
v Otherwise, the reply is:
215 MVS is the operating system of this server. FTP Server is running on z/OS.

TChinese subcommand
TChinese subcommand—Change the data transfer type to TCHINESE
Purpose
Use the TChinese subcommand to change the data transfer type to Traditional
Chinese (5550).
Format
TChinese
(
Ascii NOSo NOType
Sosi
Ebcdic
Space
Parameters
Sosi
of the following parameters — Ascii, Ebcdic, or Space. If no parameter is
If the S parameter is not specified, shift-out or shift-in characters are not used
in the transferred data.
Ascii
data.
Ebcdic
data.
Space
NOSo
NOType
Usage
The TChinese client subcommand is equivalent to the TYPE B 7 server command.

TChinese subcommand
Context

TSO subcommand
TSO subcommand—Use TSO commands
Purpose
Use the TSO subcommand to pass a Time Sharing Option (TSO) command to a
local host TSO environment.
Format
TSO command_line
Parameters
command_line
Specifies a TSO command. Do not use synonyms.
Usage
The TSO subcommand is not available from batch.

TYpe subcommand
TYpe subcommand—Set the data transfer type
Purpose
Use the TYpe subcommand to set the data transfer type for the client and server
simultaneously with one command. FTP supports the ASCII, EBCDIC, image
| (binary), UCS-2, and two DBCS data transfer types.
Format
A
TYpe B
1
2
5 A N
6 S
7 E
8 S
9
A
3
4 R N
E
F
1
I
B
U 2
L
Parameters
A Sets the transfer type as ASCII. Specifying the ASCII transfer type has the same
effect as using the AScii subcommand. When the data transfer type is ASCII,
FTP translates outgoing files to ASCII before sending them, and translates
incoming files from ASCII to the file system code page before storing them.
ASCII is the default transfer type.
B Sets the transfer type as DBCS. Specifying the B transfer type with the
appropriate options has the same effect as using the BIG5, EUckanji, HAngeul,
JIS78kj, JIS83kj, Ksc5601, SJiskanji, SChinese, or TChinese subcommands. If B is
specified alone, the second type parameter defaults to 1 and current transfer
type is changed to Shift JIS kanji.
When you transfer double-byte data, the currently active SBCS translation table
is used for SBCS characters in the data set. If necessary, use the SIte/LOCSIte
SBDataconn or SIte XLate FTP subcommand to select an alternate SBCS
translation table that is appropriate for your data before transferring your
double-byte data.
B1
Changes current transfer type to Shift JIS kanji.
B2
Changes current transfer type to Extended UNIX Code kanji.
B3
Changes current transfer type to JIS 1983 kanji.

TYpe subcommand
B4
Changes current transfer type to JIS 1978 kanji.
B5
Changes current transfer type to Hangeul.
B6
Changes current transfer type to Korean Standard Code KSC-5601, 1989
version.
B7
Changes current transfer type to Traditional Chinese (5550).
B8
Changes current transfer type to Big-5.
B9
Changes current transfer type to Simplified Chinese.
S Transferred data contains shift-out and shift-in delimeters.
If S is specified alone, the second parameter defaults to A. Shift-out and
shift-in characters X'1E' and X'1F' are used.
The S parameter can be used to control the use of shift-out (SO) and shift-in
(SI) characters during DBCS data transfer for Big5, SChinese, Shift-JIS kanji,
EUC kanji, Hangeul, KSC-5601, and TChinese.
transferred data.
SA
Use shift-out and shift-in characters X'1E' and X'1F' to delimit DBCS strings
SE
Use shift-out and shift-in characters X'0E'and X'0F' to delimit DBCS strings
SS
Use ASCII spaces (X'20') as shift-out and shift-in characters to delimit
DBCS strings in the transferred data.
A Use ASCII shift-in escape sequence ESC ( B. This is the default. (Used for
DBCS data types JIS 1983 kanji and JIS 1978 kanji only.)
R Use JISROMAN shift-in escape sequence ESC ( J. (Used for DBCS data types
JIS 1983 kanji and JIS 1978 kanji only.)
N Indicates that the transfer is to be pure DBCS data (data with no SBCS
characters) and that the data is to be transferred to or from EBCDIC DBCS
data that contains no shift-out or shift-in delimiters.
When data is transferred from the EBCDIC host, the entire data set is assumed
to be EBCDIC DBCS with no SO/SI characters in the data. The data is then
converted to the required ASCII type and if any SO/SI option has been
specified for the transferred data then the corresponding SO/SI characters are
used to delimit the ASCII DBCS strings.
When transferring data to the EBCDIC host, no SO/SI characters are inserted,
and if any SO/SI option is specified for the transferred data, the corresponding
SO/SI characters are removed from the ASCII data and not replaced at the
host. The length of data might change during transfer to and from the EBCDIC
host when pure DBCS is specified with any SO/SI option. When pure DBCS is

TYpe subcommand
specified by itself, the length of data does not change. If N is not specified, the
shift-out or/shift-in characters X'0E' and X'0F' are used at the host.
E Sets the transfer type as EBCDIC. Specifying the EBCDIC transfer type has the
same effect as using the EBcdic subcommand. The EBCDIC transfer type is
intended for efficient transfer between hosts that use EBCDIC for their internal
character representation.
F Sets the transfer type as EBCDIC IBM kanji. Specifying the IBM kanji transfer
type has the same effect as using the Ibmkanji subcommand.
F1
Change current transfer type to IBM (EBCDIC) kanji.
I Sets the transfer type as image (binary). Specifying the image transfer type has
the same effect as using the BINary subcommand. With the image transfer
type, data is sent as contiguous bits, packed into 8-bit bytes. The image
transfer type is used for the efficient storage and retrieval of data sets or files,
and for the transfer of binary data.
U2
Sets the transfer type to Unicode UCS-2. TYpe U 2 has optional parameters:
B Specifies big-endian byte order for Unicode encoding. This is the
default.
L Specifies little-endian byte order for Unicode encoding.
Examples
v Transfer text data to another host:
User: ascii
System: >>>TYPE A
200 Representation type is ASCII.
Command:
v Transfer binary data to another host:

User: type i
System: >>>TYPE I
200 Representation type is IMAGE.
Command:
v Transfer text data from an EBCDIC host to an EBCDIC host:

User: type e
System: >>>TYPE E
200 Representation type is Ebcdic NonPrint
Command:
v Transfer binary data from an EBCDIC host to an EBCDIC host:

User: type i
System: >>>TYPE I
200 Representation type is Image.
Command:
v Set the transfer type to JIS 1983 kanji using the JISROMAN shift-in escape
sequence ESC ( J:
TYPE B 3 R
v Set the transfer type to Shift-JIS kanji using the EBCDIC SO/SI characters
X'0E'/X'0F' in the transferred date:

TYpe subcommand
TYPE B 1 S E
Usage
v If no Sosi option is specified by the TYpe command for BIG5, SChinese,
EUckanji, HAngeul, Ksc5601, SJiskanji, or TChinese, standard DBCS control is
used for the data transfer. This means that no SO/SI characters are placed in the
ASCII data when transferring from the (EBCDIC) host to ASCII and the value of
each ASCII character is used to determine if it is a single-byte character or part
of a double-byte character when transferring to the host. For JIS 1983 kanji and
JIS 1978 kanji, three-character escape sequences are always used to delimit DBCS
strings in mixed SBCS/DBCS ASCII data. These escape sequences cannot be
altered by using the S, S A, S E, or S S parameters.
v If no Sosi option is specified, the length of data might change as it is transferred
to or from the EBCDIC host since EBCDIC DBCS types on the host contain
SO/SI characters in mixed SBCS/DBCS data to determine which characters are
part of a DBCS string. Any of the above SO/SI options (S, S A, S E or S S) can
be used for mixed SBCS/DBCS data so that the length of data does not change
when transferred to or from the EBCDIC host. Use of three-character escape
sequences for JIS 1983 kanji and JIS 1978 kanji means that the length of data for
these types always change when transferring mixed SBCS/DBCS data to or from
the EBCDIC host.
v Use ASCII spaces as SO/SI characters in the transferred data only for transfer
from the EBCDIC host. Data can be transferred to the host when using this
option but care must be taken as each ASCII space is interpreted as a shift-out or
shift-in character and is replaced with the corresponding SO/SI character on the
host.
Context

UCs2 subcommand
UCs2 subcommand—Change data transfer type to Unicode UCS-2
Purpose
Use the UCs2 subcommand to change the data transfer type to Unicode UCS-2.
Format
UCs2
Big
(
Little NOType
Parameters
Big
Specifies big-endian byte order for the Unicode encoding. This is the default.
Little
Specifies little-endian byte order for the Unicode encoding.
NOType
this parameter when you want translation to be done by the FTP client only.
Usage
The UCs2 client subcommand is equivalent to the TYpe U 2 subcommand.

User subcommand
User subcommand—Identify yourself to a host or change your TSO

user ID password
Purpose
Use the User subcommand to identify yourself to the host after opening a
connection or, if the foreign host is a z/OS FTP server, you can change your TSO
user ID password.
Format
User user_id
Password
Password:
password
/ new_password / new_password : userdata

account_information
Parameters
user_id
Specifies your logon name on the host.
password
Specifies your current password on the host. If you do not supply a password
when invoking the User subcommand, you are prompted to enter a password
if the host requires a logon password.
new_password / new_password
Specifies your new password on the host. You must enter the password twice.
:userdata
The optional user data must be separated from the password information by a
colon (:) and can be any combination of up to 200 nonblank characters and
numbers—except the colon. Care should be taken when using the backslash
character (\) in combination with other characters, which might be interpreted
as an escape sequence by the C compiler.
account_information
An optional parameter that will be supplied to the remote FTP server if the
server requests account information after receiving the password.
Usage
v Not all FTP servers support the userdata parameter. The z/OS FTP server
interprets userdata as a character string and passes it to the server FTCHKPWD
user exit routine.
v If you enter your password incorrectly, you are not prompted to enter the
password again. You must reissue the User subcommand to enter the correct
password.
v If you do not specify password/new_password/new_password on the User
subcommand, you can specify it when you are prompted for the password after

User subcommand
entering the User subcommand. You can specify the User subcommand to
change your TSO user_id password at any time during the FTP session.
v To avoid having your password print when issuing your user ID and password
as part of a CLIST or batch job, enter your user ID and password on separate
lines.
v Do not place any spaces between the passwords and the slashes (/), and the
user data.
v You can use the NETRC data set to automatically log on to a remote host.
v You can pass multiple strings as one parameter by enclosing them in single
quotation marks. For example, if USER MYNAME1 MYNAME2 were passed,
MYNAME1 would be parsed and sent to the server as the user ID, and
MYNAME2 would be parsed as the password and sent when prompted by the
server. However, sending the command USER ’MYNAME1 MYNAME2’ would cause
MYNAME1 MYNAME2 to be sent as the user ID. Typically, this is used when
using FTP through a proxy that requires two user IDs (one for the firewall and
one for the remote system). It is also used with servers that allow blank
characters to be imbedded within a user ID.
This same technique also works with the password. If the following statement is
issued: USER ’MYNAME1 MYNAME2’ ’PASSWD1 PASSWD2’, FTP replies to the USERID
prompt with ’MYNAME1 MYNAME2’ and to the PASSWORD prompt with ’PASSWD1
PASSWD2’.
Context
For information about using NETRC, see “NETRC data set” on page 40.

Verbose subcommand
Verbose subcommand—Toggle verbose mode
Purpose
Use the Verbose subcommand to toggle verbose mode. When in verbose mode the
client displays message IDs. This subcommand is effective only when the client is
running in a z/OS UNIX environment.
Format
Verbose
Parameters
Examples
verbose
Message IDs are not displayed when running in z/OS UNIX
Command:
lpw
Local directory name set to hierarchical file /u/user33
Command:
verbose
EZA2859I Message IDs are displayed when running in OS/390 UNIX
EZA1460I Command:
lpw
EZA2578I Local directory name set to hierarchical file /u/user33
EZA1460I Command:
Usage
Verbose is normally toggled off when the client starts. If you want it toggled on
when the client starts, use the -v parameter on the FTP command. If the FTP client
is running in a TSO environment, the display of message IDs is controlled by the
profile options MSGID and NOMSGID.

Chapter 6. Sending electronic mail using SMTP commands
This topic describes how to use the SMTPNOTE command, provided with z/OS
Communications Server, to prepare and send electronic mail. Recipients of the mail
can be users on your local host, users on network job entry (NJE), or users on TCP
hosts. The SMTPNOTE command uses the Simple Mail Transfer Protocol (SMTP)
to send the mail.
This topic describes information about:

v “Interfaces to the SMTP address space”
v “Using the SMTPNOTE command from your terminal” on page 324
v “Monitoring the status of SMTP using the TSO SMSG command” on page 330
v “SMTP commands” on page 337
v “SMTP responses” on page 354
v “Using batch SMTP command in TSO utilities” on page 356
v “SMTP with DBCS support” on page 357
Interfaces to the SMTP address space

Interfaces to the SMTP address space are:
v SMTP mail can be sent and received interactively over a TCP/IP network. Mail
from TCP/IP network sites destined for local MVS users (or users on a NJE
network attached to the local MVS system) arrives over this interface. All
commands and data received and transmitted through this interface use ASCII
characters.
v Interface from the Job Entry Subsystem (JES) spool, including any connected NJE
nodes. SMTP commands can be written into a SYSOUT data set, with an
external writer name of the SMTP address space. SMTP processes each of the
commands in the data set in sequence, exactly as if it had been transmitted over
a TCP/IP connection. This is how mail is sent from local MVS users to recipients
on the TCP network. Batch SMTP data sets must contain commands and data in
EBCDIC characters.
For a description of batch SMTP in TSO utilities, see “Using batch SMTP
command in TSO utilities” on page 356. For examples of batch SMTP, see “Batch
SMTP examples” on page 355.
Notes:
1. This interface can be used to send mail only. Using the VERB command with
this interface causes spool problems. For a description of the VERB
command, see “VERB command—Enable or disable verbose mode” on page
352.
2. With this interface, you might not be able to use certain SMTP options that
require the NETDATA format. For details, see the z/OS Communications
IBM z/OS Communications Server TCP/IP provides an SMTP gateway function,
which can be used to transfer electronic mail between an NJE network and a
TCP/IP network, as shown in Figure 13 on page 324.

MVS with SMTP NJE Gateway IP Host
SMTP Mail
application
TCP/IP For example:
SMTP TCP/IP LaMail in
Gateway network TCP/IP for
OS/2
XMIT
TSO
JESx or
RECEIVE Batch
NJE
Network
NJE:Node XMIT/RECEIVE NJE:Node user:

MVS: JESx MVS: TSO or Batch
VM: RSCS VM: CMS
SENDFILE/RECEIVE
MVS or VM (or other NJE node implementations)
Figure 13. SMTP gateway overview
Using the SMTPNOTE command from your terminal

The SMTPNOTE command enables you to prepare the mail using the facilities of
the Time Sharing Option (TSO) EDIT command, or to send mail prepared with a
system editor of your choice.

SMTPNOTE command—Send electronic mail to one or more
recipients on NJE or TCP networks
Purpose
Use the SMTPNOTE command to send electronic mail to one or more recipients on
NJE or TCP networks.
Format
SMTPNOTE
To ( recipient ) Cc ( recipient )
NOCc

Subject ( subject ) Dataset ( data_set_name )
Batch
Reuse
Note: The minimum abbreviation for each parameter is shown in uppercase

letters.
Parameters
To (recipient)
Specifies a single recipient for the mail. If you do not specify the To parameter,
you are prompted to enter a list of recipients. Enter the name of each recipient
on a separate line and end the list with a blank line. You must specify at least
one mail recipient.
Cc (recipient)
Specifies a single copy recipient for the mail. If you do not specify the Cc
parameter and you do not specify the NOCc or Batch parameters, you are
prompted to enter a list of copy recipients.
If there are no recipients, press Enter. Otherwise, enter the name of each
recipient on a separate line and end the list with a blank line.
NOCc
Specifies that no prompting for Cc takes place.
recipient
Specifies the path address of the mail recipient. The format of recipient is
equivalent to the path syntax, as described in RFC 821, without the (<) and (>)
delimiters. See Appendix D, “Related protocol specifications,” on page 449 for
information about obtaining RFCs. This recipient parameter has one of the
following formats:
user_id@host_name
User on a host in your domain, possibly on your local node.
user_id@host_name .domain
User on a host in a specified domain.
user_id%nje_host_name@ gateway_name.domain
User on an NJE or RSCS node connected to a TCP network at
gateway_name. See “Electronic mail gateway” on page 336 for more
information.
Chapter 6. Sending electronic mail using SMTP commands 325

@host1,@host2,...,@hostn :user_id @host_name
User on a host that is not known by the local Domain Name server, but
that can be reached by following the path from host1 to hostn.
Subject (subject)
Specifies the subject of the note. If you do not specify the Subject parameter,
you are prompted for the subject.
If there is no subject for the note, press Enter. If Subject is specified as a
keyword, you cannot have embedded blanks. Otherwise, the subject can be any
arbitrary string of characters, but is limited to a total length of 233 characters.
Batch
Specifies that no prompting take place. You must also specify the To and
Dataset parameters.
Dataset (data_set_name)
Indicates that the text of the mail is contained in a sequential data set. The data
set can have any record format, be blocked or unblocked, and have records of
up to 243 characters in length. The data_set_name is the name of the sequential
data set containing the text of the note. It must be a valid data set name, and is
fully qualified if it is contained within single quotation marks (').
Reuse
Causes SMTP to reuse the contents of a note that was previously canceled. If a
note was not canceled, the Reuse parameter is ignored.
Usage
v When the To(), Cc(), Subject(), or Dataset() parameters are specified more than
once, the last value specified is the one used by SMTPNOTE. No error messages
are generated for duplicate parameters on the command line.
v SMTPNOTE no longer requires quotation marks around blanks, single quotation
marks, semicolons, or commas, or triple quotation marks around data set names.
v You cannot use data sets with the extended attribute (PDSE and PSE) with
SMTPNOTE. SMTPNOTE uses TSO TRANSMIT, which does not support PDSE
and PSE data sets.

Preparing and sending mail
After you enter the SMTPNOTE command, you are prompted for the mail
recipients (To:), the copy recipients (Cc:), and the subject of the note (Subject:), if
they were not specified with the SMTPNOTE command. If you enter a list of
recipients, enter the name of each recipient on a separate line and indicate the end
of the list by entering a blank line.
After you answer the prompts, SMTPNOTE invokes the TSO EDIT command to
enable you to prepare your note. Typically, the editor starts in INPUT mode. Enter
the text of your note line by line. When your note is complete, enter a null line
(that is, do not type anything when prompted), and press Enter. The editor
switches to EDIT mode.
In EDIT mode, you can use all the functions of the editor. You can also return to
INPUT mode, send the note, or cancel the note. For a complete description of the
EDIT command, see the z/OS TSO/E Command Reference.
If you invoke the SMTPNOTE command with the REUSE or DATASET parameter,
you are immediately placed in EDIT mode. The contents of the previously canceled
note, or the data set that you specify, are already part of the note. You can add to
or change the data that is already present.
To send the note, enter END SAVE in EDIT mode, and then enter SEND. To cancel
the note, enter END SAVE or END NOSAVE in EDIT mode, and then enter
CANCEL. If you cancel a note, you can recover what you entered by invoking the
SMTPNOTE command with the REUSE parameter. The recipients and subject of
the note are not saved, and must be reentered.
Figure 14 is an example of preparing and sending mail.
READY
smtpnote
TO:
irvine@mvs2.accounting
bekker@mvs2.accounting
mcgregr@mvs1.accounting
CC:
SUBJECT:
Travel Expenses
ENTER "END SAVE" TO SAVE THE NOTE.

FOR A COMPLETE LIST OF EDIT SUBCOMMANDS ENTER "HELP".
INPUT
Could we please postpone the expense review because I
will be out of town the week of the 19th.
How about the 23rd? Thank you, John.
EDIT
end save
ENTER "SEND" TO SEND THE NOTE.
ENTER "CANCEL" TO TERMINATE WITHOUT SENDING THE NOTE.
send
READY
Figure 14. Example of preparing and sending mail

Receiving mail
Use the TSO RECEIVE command to receive SMTP mail, as you would other mail
and messages. Figure 15 shows an example of using the RECEIVE command.
System: READY
User: receive
System: Dataset ** MESSAGE ** from SMTP on MVSXA2
Received: from MVSXA2 by TREEFROG.ABC.OZ (IBM MVS SMTP V3R2)
with BSMTP id 3088
;
***
Wed, 28 Jul 93 16:41:31 EST

Date: 28 Jul 93 16:37:56 LCL
From: MMC@TREEFROG.ABC.OZ
To: mvsuser%mvsxa3@TREEFROG.ABC.OZ
Cc: mmc%mvsxa3@TREEFROG.ABC.OZ
Subject: TSO RECEIVE Example
This is an example of the TSO RECEIVE command.
******************************************************************
INMR000I No more files remain for the receive command to process.
Figure 15. TSO RECEIVE command
If there is no message to be received, the following message is displayed:

INMR003I You have no messages or data sets to receive.
***
For more information, see the z/OS TSO/E User’s Guide, z/OS TSO/E Command
Reference, or z/OS TSO/E Customization.
Undelivered notes
When SMTP cannot deliver a piece of mail, a nondelivery note explaining the
reason for nondelivery is sent to the sender. Nondelivery can occur for several
reasons, such as the destination host is unreachable, or the recipient does not have
a user ID on the destination host. If a note cannot be delivered, the body of the
original piece of mail is returned as part of the nondelivery notification. For an
example of a nondelivery note, see Figure 16 on page 329. The nondelivery note is
shown in bold.

Date: Mon, 9 Mar 92 08:23:54 EST
From: SMTP@MVS1.ACME.COM
To: DANIEL@MVS1
Subject: Undeliverable Mail
MVS1.ACME.COM unable to deliver following mail to recipient(s):
<MATT@SMTP-GATEWAY.IBM.COM>
MVS1.ACME.COM unable to connect for 3 days to host:
SMTP-GATEWAY.IBM.COM
** Text of Mail follows **
From: <DANIEL@MVS1.ACME.COM>
To: <MATT@SMTP-GATEWAY.IBM.COM>
Subject: ACME iron birdseed
Matt,
The shipment of ACME iron birdseed was shipped last Thursday. Please
advise me if you have not received it, and I’ll try to track it down.
Also, your ACME giant rock catapult is on back order; another customer
bought the last one yesterday.
Daniel
Figure 16. Example of a nondelivery note
If a recipient is unknown at the destination host, the destination host does not
accept the mail for delivery, and a nondelivery note is forwarded to the sender. For
an example of an unknown recipient note, see Figure 17. The unknown recipient
note is shown in bold.

From: SMTP@MVS1.ACME.COM
To: DANIEL@MVS1
Subject: Undeliverable Mail
MVS1.ACME.COM unable to deliver following mail to recipient(s):
<GEORGE@SMTP-GATEWAY.IBM.COM>
MVS1.ACME.COM received negative reply from host:
SMTP-GATEWAY.IBM.COM
** Text of Mail follows **
From: <DANIEL@MVS1.ACME.COM>
To: <GEORGE@SMTP-GATEWAY.IBM.COM>
Subject: Your retirement
George,
I recently learned that you will soon be retiring. I just wanted to

wish you best of luck and thanks for all the great work you’ve done.
You were a great asset to your company, and I’m sure they will miss you.
Daniel
Figure 17. Example of an unknown recipient note
SMTP exit for unwanted mail

You can use an SMTP exit to inspect and filter unwanted mail (spam) sent through
SMTPPROC.
The SMTP component contains the SMTPPROC application which is the mail to
mail interface used on the Internet. This component is responsible for routing mail
between the sender and receiver. A user exit can be used to reject mail (spam)
based on criteria determined by the user. This exit examines the data sent by the
remote SMTP client application and determines what action to take based on the
contents of that mail item or mail command.

This exit can be replaced dynamically without stopping the SMTPPROC program.
The procedure for doing this follows:
1. Issue a ″SMSG smtpprocname STOPEXIT″ TSO command. The TSO userid must be
in the authorized list for SMTPPROC to issue this command. This will cause
SMTP to issue the termination call to the exit and then set a flag so that the exit
will not be called anymore. Processing of mail will continue as if there is no
exit.
2. Remove the old exit using the SETPROG EXIT operator command or by
updating SYS1.PARMLIB(PROGxx) and issuing the refresh console command.
An example of updating SYS1.PARMLIB follows:
a. In SYS1.PARMLIB(PROGxx) have this line:
EXIT DELETE EXITNAME(EZBTCPIPSMTPEXIT) MODNAME(OLDEXIT) FORCE(YES)
b. At the MVS console issue SET PROG=xx.
3. Add the new exit using the SETPROG EXIT operator command or by updating
SYS1.PARMLIB(PROGxx). An example of updating SYS1.PARMLIB follows:
a. In SYS1.PARMLIB(PROGxx) have this line:
EXIT ADD EXITNAME(EZBTCPIPSMTPEXIT) MODNAME(NEWEXIT)
b. At the MVS console issue SET PROG=xx.
4. Issue a ″SMSG smtpprocname STARTEXIT″ TSO command. This will cause SMTP
to issue the initialization call to the exit. A flag is then set so the exit will be
called from then on for new mail connections. Processing of new mail will
continue with the exit being called. The first smtp command to be seen by a
reinstated exit will be HELO. The exit will not be called in the middle of a
currently processing exchange.
Monitoring the status of SMTP using the TSO SMSG command

The TSO SMSG command provides an interactive interface to the SMTP server to
do the following::
v Query the operating statistics of the SMTP server
v Query the SMTP mail delivery queues
v Perform privileged system administration tasks, such as shutting down the
SMTP server and enabling or disabling various tracing and debugging options
Responses to commands are sent back to the originator of the command using
MSG commands (or MSGNOH commands if SMTP is running with privilege class
B).
SMSG SMTP is not supported in batch. It uses VMCF and the PASCAL interface to
queue up information and will not print the information to a DD card.

SMSG SMTP command for the general user
Purpose
| As a general user or an authorized user, use the SMSG SMTP command to monitor
the status of SMTP.
Format
| SMSG SMTP HElp
NUMQueue
QUeues
STats

letters.
Parameters
HElp
Provides a list of valid SMTP SMSG commands.
| NUMQueue
| Provides the number of mail messages currently queued in SMTP.
QUeues
| Provides a list of mail queued on the various SMTP mail processing queues.
STats
Provides operating statistics about the SMTP server since the SMTP server was
started.
Examples
| System: READY
| User: smsg smtp numqueue
| System: Msg from SMTP: * Current Number of Mail Messages Queued is 50
|
The following example shows the output from the SMTP QUEUES command.
R Retry
A Active
Q Pending - waiting for TCP/IP connection
v xxx.xxx.xxx.xxx is the IP address
v 1 is the number of pieces of mail
v HostName.DomainName is the symbolic name
Msg from SMTP: * ----- Mail Queues -----
Msg from SMTP: * Spool Queue: 0
Msg from SMTP: * R: xxx.xxx.xxx.xxx : 1 HostName.DomainName
Msg from SMTP: * Undeliverable Queue: 0
Msg from SMTP: * --- Resolver Queues ---
Msg from SMTP: * Process Queue: 0
Msg from SMTP: * Send Queue: 0
Msg from SMTP: * Wait Queue: 0
Msg from SMTP: * Retry Queue: 0
Msg from SMTP: * Completed Queue: 0
Msg from SMTP: * Error Queue: 0

The following example shows the output from the SMTP STATS command.
System: READY
User: smsg smtp stats
System: +Msg from SMTP: * Last Up Time: Wed, 28 Jul 93 16:33:32 EST
+Msg from SMTP: * Statistics : 07/28
+Msg from SMTP: * From TCP : 0
+Msg from SMTP: * From Spool : 0
+Msg from SMTP: * BSMTP Logs : 0
+Msg from SMTP: * Error Mail : 0
+Msg from SMTP: * To Local : 0
+Msg from SMTP: * To NJE : 0
+Msg from SMTP: * To TCP : 0
+Msg from SMTP: * Passive Opns: 0
| +Msg from SMTP: * Active Opens: 0
| +Msg from SMTP: * ----------------------------------------------
| +Msg from SMTP: * Highest num queued: 500
| +Msg from SMTP: * High reached at: Wed, 28 Jul 93 20:00:00 EST
READY
| Field descriptions:
The statistics about SMTP include:

| v The date that SMTP was last started.
| v Statistics about mail handled by SMTP over the past four days, including:
| From TCP
| The number of pieces of mail that arrived over TCP connections
| From Spool
| The number of pieces of mail that arrived from spool (local or NJE
| senders)
| BSMTP Logs
| The number of pieces of mail generated in response to requests to
| VERBose batch SMTP connections
| Error Mail
| The number of pieces of mail generated to return error mail to the
| sender
| To Local
| The number of pieces of mail delivered to local recipients
| To RSCS
| The number of pieces of mail delivered to recipients on the RSCS
| network
| To TCP
| The number of pieces of mail delivered to recipients on the TCP/IP
| network
| Passive Opns
| The number of TCP connections through which mail was received
| Active Opens
| The number of TCP connections through which mail was delivered
| Highest num queued
| The highest number of messages queued up in SMTP and the time and
| date when this occurred

| High reached at
| The time and date when the highest number of messages queued in
| SMTP occurred

| SMSG SMTP command for the authorized user
Purpose
| As an authorized user, use the privileged SMSG SMTP command to monitor the
| status of SMTP.
Format
SMSG SMTP DEbug
EXpire IP_address
NODebug
NOTrace
SHutdown
STOPEXIT
STARTEXIT
TRace

letters.
Parameters
| DEbug
| Enables connection debugging and tracing information to the SMTP DEBUG
| data set. Specifying this parameter is the same as adding the DEBUG statement
| to the SMTP configuration data set (SMTPCONF).
EXpire IP_address
Causes the domain name resolution for mail queued for delivery to this IP
address to expire. SMTP will again try to resolve the IP addresses for this mail
if it is still within the retry time window.
NODebug
Disables connection debugging and tracing.
NOTrace
Disables resolver tracing.
SHutdown
Causes the SMTP server to shut down.
STARTEXIT
Causes SMTP to enable a user exit program by issuing the initialization call to
the user exit program if one exists. For more information regarding user exit
programs, see the z/OS Communications Server: IP Configuration Guide.
STOPEXIT
Causes SMTP to disable a currently running user exit program by issuing the
termination call to the user exit program if one exists. For more information
regarding user exit programs, see the z/OS Communications Server: IP
Configuration Guide.
TRace
Enables resolver tracing. The output of the resolver trace is sent to the SMTP
console. This is the same as adding TRACE RESOLVER to the TCPIP.DATA
data set.

Examples
Note: If the screen remains inactive even after you issue the SMSG SMTP
command, press Enter a few times until any one of the following messages
is displayed.
v In this example, MVSUSER starts the debugging and tracing:
System: READY
User: smsg smtp debug

System: +Msg from SMTP: * Session Debugging Enabled
v Stop debugging and tracing:

System: READY
User: smsg smtp nodebug

System: +Msg from SMTP: * Session Debugging Disabled
READY
v Begin resolver tracing:

System: READY
| User: smsg smtp trace

System: +Msg from SMTP: * Resolver Tracing Enabled
READY
v Stop resolver tracing:

System: READY
User: smsg smtp notrace

System: Msg from SMTP: * Resolver Tracing Disabled
READY
v Shut down the SMTP server:

System: READY
User: smsg smtp shutdown

System: +Msg from SMTP: * ok, About to End SMTP
READY
v Cause all mail queued for name resolution to expire:

System: READY
User: smsg smtp3 expire 9.67.112.25

System: +Msg from SMTP3: * No Mail Found for IP address: 9.67.112.25
READY
Usage
| SMSG commands from authorized users are accepted only from users that are
specified in the SMSGAUTHLIST statement.
Context
| See the z/OS Communications Server: IP Configuration Reference for information about
| the SMTP configuration data set (SMTPCONF) and for a description of how to
| assign authorized users with the SMSGAUTHLIST configuration statement.

Electronic mail gateway
A system administrator can configure the SMTP server to run as a mail gateway
between TCP network users and users located on an NJE or Remote Spooling
Communications Subsystem (RSCS) network that is attached to the local host.
Figure 18 is an example of a mail gateway.
In Figure 18, the following abbreviations are used:
A The local MVS host running both the TCP/IP program and NJE.
B and C Hosts attached to host A through an NJE network.
D and E Hosts attached to host A through a TCP network.
NJE
B D
A TCP/IP Network
C E
NJE
Figure 18. SMTP as a mail gateway
Users on hosts A, B, and C can send mail to users on TCP hosts D and E using the
SMTPNOTE command. This method is described in “Using the SMTPNOTE
command from your terminal” on page 324.
Users on TCP hosts D and E can send mail to the users on host A using addresses
in the following format:
user_id@A.domain
Where:
user_id Is the user ID of the TSO user on host A.

A.domain Is the TCP host name of host A.
The users on TCP hosts D and E can send mail to users on NJE hosts B and C
using addresses in the following format:
user_id%NJEHost@A.domain
Where:
user_id Is the user ID of the user on the host.

NJEHost Is the name of the NJE host (B or C).
A.domain Is the TCP host name of host A.
Path address
Path addresses are rewritten according to the following rules:
v If the local part of a mailbox name includes a percent sign (%) and the domain
of the mailbox is the host system, SMTP rewrites the address, treating the
portion of the local part to the right of the percent sign (%) as the real
destination host. For example, the path address:
John%yourhost@ourhost.our.edu

is rewritten by SMTP running at ourhost.our.edu as:
John@yourhost
v Path addresses with source routes are accepted and rewritten to remove the
domain name of the host system. For example, the path address:
@ourhost.our.edu,@next.host.edu
:John@yourhost

@next.host.edu:John@yourhost
SMTP also optimizes a path address. For example,

@some.host.edu,@ourhost.our.edu,

SMTP commands
This topic describes the SMTP commands as listed in Table 21.
Table 21. SMTP commands
DATA Define the following “DATA command—Define the
information as data. following information as data” on
page 339
EXPN Verify if a mailbox exists on “EXPN command—Verify whether
the local host. a mailbox exists on the local host”
on page 341
HELO Identify the domain name “HELO command—Identify the
of the sending host to domain name of the sending host to
SMTP. SMTP” on page 342
HELP Get help with SMTP “HELP command—Get help with
commands. SMTP commands” on page 343
MAIL FROM Specify the sender of the “MAIL FROM command—Specify
mail. the sender of the mail” on page 344
NOOP Return a 250 OK return “NOOP command—Return a 250
code when SMTP is OK return code when SMTP is
responding. responding” on page 345
QUEU Get information about mail “QUEU command—Get information
queued at SMTP for about mail queued at SMTP for
delivery. delivery” on page 346
QUIT End an SMTP connection. “QUIT command—End an SMTP
connection” on page 348
RCPT TO Specify the recipients of the “RCPT TO command—Specify the
mail. recipients of the mail” on page 349
RSET Reset the SMTP connection “RSET command—Reset the SMTP
to the initial state. connection to the initial state” on
page 350
TICK Insert an identifier into the “TICK command—Insert an
batch SMTP response data identifier into the batch SMTP
set. response data set” on page 351

Table 21. SMTP commands (continued)
VERB Enable or disable verbose “VERB command—Enable or
mode. disable verbose mode” on page 352
Note: VERB ON can cause
spool problems for SMTP if
the REPLY TO: user is not a
valid NJE node.user.
VRFY Verify if a mailbox exists on “VRFY command—Verify whether a
the local host. mailbox exists on the local host” on
page 353
Note: If the DISALLOWCMD statement was used, the server will not support the
EXPN, HELP, QUEU,VERB and VRFY commands.
Data sets containing SMTP commands can be written to the JES spool as SYSOUT
data sets. These SYSOUT data sets contain either punch or NETDATA records.
Data sets originate from users on the same system as the SMTP address space or
from users on any system connected to the host system through an NJE network.

DATA command—Define the following information as data
Purpose
Use the DATA command to define the following information as the data text of the
mail body.
Format
DATA
Parameters
There are no parameters for this command.
Examples
After entering the DATA command, you receive the following message (response
code 354) when you can transmit the body of your mail:
354 Enter mail body. End new line with just a ’.’
You end transmitting the body of your mail by entering a single ASCII period (.)
on a line by itself.
The following message indicates success:

250 Mail Delivered
Usage
v Use the DATA command after a HELO command, a MAIL FROM command,
and at least one RCPT TO command have been accepted.
v When receiving mail over a TCP connection, the ASCII period should be
followed by the ASCII <carriage return> <line feed> character sequence. If any
record in the body of the mail begins with a period, the sending SMTP program
must convert the period into a pair of periods (..). When the receiving SMTP
encounters a record that begins with two periods in the body of the mail, it
discards the leading period. This convention permits the body of mail to contain
records that would otherwise be interpreted as signaling the end of the body of
mail. These rules must be followed over both TCP and batch SMTP connections.
The SMTPNOTE command performs this period doubling on all mail spooled to
SMTP. If the body of the mail in a batch SMTP command is not explicitly ended
by a record with a single period, SMTP adds one.
After a period has been received, the SMTP connection is reset to the initial state
(the state before any sender or recipients have been specified). Additional MAIL
FROM, RCPT TO, DATA, and other commands can now be sent.
If no more mail is to be delivered, end the connection with the QUIT command.
If a QUIT command is not found at the end of a batch SMTP command data set,
it is implied.
v If SMTP runs out of local mail storage space, it sends a reply with a 451 code. If
the length of the body of the mail exceeds MAXMAILBYTES (defined in SMTP
configuration data sets to be 512KB), SMTP sends a reply with a 552 code. For
more information about MAXMAILBYTES, see the z/OS Communications Server:
IP Configuration Reference.
v When mail arrives over a batch SMTP connection from a Remote Spooling
Communications Subsystem (RSCS) network host, and 822 header rewriting is
enabled (with the REWRITE822HEADER configuration option), then header

fields are modified to ensure that all addresses are fully qualified domain names.
See the z/OS Communications Server: IP Configuration Reference for more
information about header rewriting.
v When mail arrives over the JES spool interface using SMTP batch or TSO
transmit command, an NL (newline) or < character occurring in column 80 of
the data is interpreted as a continuation character by the SMTP transport layer.
The last byte of data should not be a continuation character. If the last byte is a
continuation character, then the last record will not be processed correctly and
you will be missing data. Check your note file, correct the data and resend the
mail.

EXPN command—Verify whether a mailbox exists on the local
host
Purpose
Use the EXPN command to verify whether a given mailbox exists on the local host.
Format
EXPN mailbox
Parameters
mailbox
Specifies a user-defined identifier for a mailbox. This name can specify a single
mailbox or a mailing list.
Examples
Verify whether mike is a mailbox on host abc.com:
SMTP client: EXPN mike
SMTP server: 250 mike@abc.com
Verify whether users-hackers is a mailing list on host abc.com:

SMTP client: EXPN users-hackers
SMTP server: 250-carol@abc.com
250-greg@abc.com
250-marsha@abc.com
250 peter@abc.com
The hyphen (-) as the fourth character of a response indicates that the response is
continued on the next line.
Usage
v The EXPN command operates exactly the same as the VRFY command.
v The EXPN command can verify the existence of one or more mailboxes on the
system. The mailboxes are defined by configuration statements in the
SMTP.SMTP.CONFIG data set.
v The MVS SMTP server verifies only TSO user IDs if RACF is installed on the
local system. TSO user IDs that are verified as valid are accepted with a reply
code of 250. If RACF is not installed, any character string up to eight characters
is accepted with a reply code of 250.

HELO command—Identify the domain name of the sending
host to SMTP
Purpose
Use the HELO command to identify the domain name of the sending host to
SMTP before a MAIL FROM command.
Format
HELO domain_name
Parameters
domain_name
Specifies the domain name of the sending host.
Usage
v The HELO command is sent once before a MAIL FROM command.
v If domain_name is not known, you can send messages, but the message never
heard of you is returned. This message indicates that the HELO command is
accepted, but that the host name could not be resolved either through the name
server or through the host tables.
v HELO commands received over a TCP connection that has a domain_name IP
address that does not match the IP address of the ForeignSocket field of the
connection information record are accepted. However, the reply text indicates
the mismatch. HELO commands received over a batch SMTP connection with a
domain_name that does not match the host name of the origination point of the
spool data set are accepted, but the reply text indicates the mismatch.

HELP command—Get help with SMTP commands
Purpose
The HELP command returns a multiline reply with some general information
about the SMTP commands.
Format
HELP
command_name
Parameters
command_name
Indicates any of the SMTP commands.

MAIL FROM command—Specify the sender of the mail
Purpose
Use the MAIL FROM command to specify the sender of the mail.
Format
MAIL FROM : < sender_path_address >
Parameters
sender_path_address
Specifies the full path address of the sender of the mail.
Note: The angle brackets (< >) surrounding the sender_path_address in the syntax
diagram are required.
Usage
v The MAIL FROM command is used once after a HELO command.
v If the host system has never heard of the sender host, a positive reply is sent,
but a message is logged in the SMTP console.

NOOP command—Return a 250 OK return code when SMTP is
responding
Purpose
Use the NOOP command to return a 250 OK return code when SMTP is
responding.
Format
NOOP
Parameters

QUEU command—Get information about mail queued at SMTP
for delivery
Purpose
Use the QUEU command to get information about mail queued at SMTP for
delivery.
Format
QUEU
DATE
Parameters
DATE
Causes information about the age of the mail to be returned. The default is to
not return age information.
Usage
QUEU returns a multiline reply with information about mail queued at SMTP for
delivery. The following information is returned about mail:
Spool Queue Contains mail that is destined for recipients on the local MVS
system, or for recipients on an NJE system attached to the local
MVS system. This queue is generally empty, because SMTP can
deliver this mail quickly by spooling it to the local recipient or to
the NJE address space for delivery to an NJE network recipient.
Active Indicates that if SMTP is currently transmitting to a TCP network
destination, all the mail queued for that destination is shown to be
active.
Queued All mail that arrives over a batch SMTP connection, and mail from
TCP connections that is to be forwarded to another TCP network
destination through source routing, is placed on the queued list. As
soon as SMTP receives resources from the TCPIP address space,
mail that is queued is promoted to active.
Retry Queue Mail is placed here after SMTP tries to transmit mail to each of the
TCP network hosts, but was unable to either open a connection or
complete delivery over the connection. After the number of
minutes specified by RETRYINT, mail is promoted from the retry
queue to the QUEUED state. For more information about the
RETRYINT variable, see the z/OS Communications Server: IP
Configuration Reference.
Undeliverable Queue
Mail is placed here if SMTP cannot deliver mail to a local MVS
recipient, or to a recipient on the NJE network attached to the local
MVS system, because spool space on the local MVS system is full.
After spool space has been increased and SMTP has been restarted,
delivery is attempted again.
Resolution Queues
SMTP uses the following queues for processing queries to the
name server. If the SMTP server is configured to use the site tables
rather than the name server, these queues are not used.

If the queue is empty, the word Empty appears to the right of the
queue. If the queue contains queries, the queries appear on
separate lines below the queue. However, due to the speed of the
SMTP server, the output might show that the queue is active
without containing any entries. In this case, the word Empty does
not appear.
Resolver Process Queue
Is generally empty; it contains queries waiting to be sent to
the SMTP resolver. After the query has been processed, it is
put in the resolver send queue.
Resolver Send Queue
Contains queries waiting to be processed by the SMTP
resolver. SMTP staggers the number of queries sent by the
resolver to prevent the overloading of the network and the
name server.
Resolver Wait Queue
Contains queries for which the SMTP resolver is waiting
for responses. Queries remain in this queue for the period
of time it takes to receive a reply from the name server. If a
reply is not received, the queries are removed from this
queue after the resolver timeout has occurred, and are
placed in the resolver retry queue. If the query is
successful, the query is placed in the resolver completed
queue.
Note: The SMTP resolver timeout is specified by the

RESOLVERTIMEOUT statement in the TCPIP.DATA
data set.
Resolver Retry Queue
Contains queries that have previously failed, either because
the name server did not reply, or the name server returned
a temporary error that forced the SMTP resolver to retry
the query. A temporary error occurs if, for example, the
name server truncates a packet, or if the name server
detects a processing error.
The RESOLVERRETRYINT statement specifies the number
of minutes SMTP waits before retrying the query. The
RETRYAGE statement specifies the number of days SMTP
should continue to resolve the query before returning the
mail to the sender.
Resolver Completed Queue
Contains queries that have been resolved and are waiting
to be recorded into the mail. After the Internet addresses
are recorded, SMTP attempts to deliver the mail.
Resolver Error Pending Queue
Contains queries that the name server has returned
without answers. The corresponding mail message is
returned to the sender with an unknown recipient error.

QUIT command—End an SMTP connection
Purpose
Use the QUIT command to end an SMTP connection.
Format
QUIT
Parameters

RCPT TO command—Specify the recipients of the mail
Purpose
Use the RCPT TO command to specify mail recipients.
Format
RCPT TO : < recipient_path_address >
Parameters
recipient_path_address
Specifies the full path address of the mail recipient.
Note: The angle brackets (< >) surrounding recipient_path_address in the syntax
diagram are required.
Usage
v There is a limit on the number of RCPT TO commands that can be processed
successfully on a single note. If you have more than 2000 RCPT commands you
will receive a failure reply code
552 Too many recipients
. In this situation an abend B37 still might occur if no more space is available on
the volume or if the volume table of contents (VTOC) is full.
v You can use the RCPT TO command only after a MAIL FROM command has
been issued.
v If the host system has never heard of the recipient host, the RCPT TO command
receives a negative reply.
v If a name server is used for domain name resolution, MX records are used to
resolve the recipient IP address before trying A records.
Context
For more information about MX and A records, see the z/OS Communications Server:
IP Configuration Guide.

RSET command—Reset the SMTP connection to the initial
state
Purpose
Use the RSET command to reset the SMTP connection to the initial state in which
the sender and recipient buffers are erased and the connection is ready to begin a
new mail transaction.
Format
RSET
Parameters

TICK command—Insert an identifier into the batch SMTP
response data set
Purpose
Use the TICK command, in combination with the VERB ON command, to insert an
identifier into the batch SMTP response data set. This command is useful with mail
systems that keep track of batch SMTP response data sets.
Format
TICK identifier
Parameters
identifier
Specifies a string used to identify the origin of batch SMTP responses.
Usage
The TICK command has no effect when it is issued over a TCP connection to
SMTP.

VERB command—Enable or disable verbose mode
Purpose
Use the VERB command to enable or disable verbose mode.
Format
OFF
VERB
ON
Parameters
ON
Enables verbose mode. When enabled, the batch SMTP commands and
associated replies are recorded in the batch SMTP response data set. Also, the
batch SMTP response data set is sent back to the origination point of the batch
SMTP command data set.
To avoid receiving spool errors, ensure that the origination point is a valid JES
user and node on the SMTP sending system. The origination point information
is taken from the TSO transmit (XMIT) command headers.
OFF
Disables verbose mode. When disabled, only the replies (not the commands)
are recorded in the batch SMTP response data set. This is the default.
Usage
The VERB command has no effect when issued over a TCP connection to SMTP.

VRFY command—Verify whether a mailbox exists on the local
host
Purpose
Use the VRFY command to verify whether a given mailbox exists on the local host.
Format
VRFY mailbox
Parameters
mailbox
Specifies a user-defined identifier for a mailbox. This name can specify a single
mailbox or a mailing list.
Examples
Verify whether mike is a mailbox on host abc.com:
SMTP client: VRFY mike
SMTP server: 250 mike@abc.com
Verify whether users-hackers is a mailing list on host abc.com:

SMTP client: VRFY users-hackers
SMTP server: 250-carol@abc.com
250-greg@abc.com
250-marsha@abc.com
250 peter@abc.com
The hyphen (-) as the fourth character of a response indicates that the response is
continued on the next line.
Usage
v The VRFY command operates exactly the same as the EXPN command.
v The VRFY command can verify the existence of one or more mailboxes on the
system. The mailboxes are defined by configuration statements in the
SMTP.SMTP.CONFIG data set.
v The MVS SMTP server verifies only TSO user IDs if RACF is installed on the
local system. TSO user IDs that are verified as valid are accepted with a reply
code of 250. If RACF is not installed, any character string up to eight characters
is accepted with a reply code of 250.

SMTP responses
SMTP commands arrive over a TCP connection (to your terminal) or over a batch
SMTP connection. With either connection, a response to each command is
generated. All responses are prefixed with a 3-digit number. You can determine the
response by inspecting the first digit of the response code:
First digit Description

2 Indicates a positive response. Command accepted.
3 Indicates a positive response. Send the data associated with the
command.
4 Indicates a temporary negative response. Try again later.
5 Indicates a permanent negative response. The command has been
rejected.
If SMTP commands arrive over a TCP connection, all responses (positive or

negative) are returned over that TCP connection. If SMTP commands arrive over a
batch SMTP connection, all responses are written to the batch SMTP response data
set.
If verbose mode is enabled for a batch SMTP connection, SMTP returns the batch
SMTP response data set to the origination point of the spool data set. The
origination point is determined from the NETDATA header if the data set arrives
in NETDATA format, or the MAIL FROM command if the data set arrives in
punch format. If the batch SMTP connection is not in verbose mode, the batch
SMTP response data set is not returned to the point of origin, and is discarded.
If an error occurs during the processing of commands over a batch SMTP

connection, such as reception of a negative response (with a first digit of 4 or 5), an
error report is mailed back to the sender. The sender is determined from the last
MAIL FROM command received that was valid. If the sender cannot be
determined from a MAIL FROM command, the sender is assumed to be the
origination point of the batch SMTP command data set. The error report mailed to
the sender includes the batch SMTP response data set and the text of the
undeliverable mail.
| All SMTP commands and data that arrive over TCP or batch SMTP connections are
| subject to the restrictions imposed by constants that are defined in the SMTPGLOB
| object. A reference copy of this object is included in the SEZACMAC library; the
| object lists constant value declarations that are used by SMTP.
The default values of some of these constants are:

v Command lines must not exceed the MaxCommandLine value (512 characters).
v Data lines longer than the MaxDataLine value (1024 characters) are wrapped.
Note: If an incoming note has data lines between 251 and 1024 characters long,
these notes are not processed by the TSO RECEIVE command like
conventional notes. The recipient user is prompted to enter a new data set
name for the RECEIVE command to temporarily store the note text. When
the prompt has been responded to, the text is presented to the user along
with any other notes that are to be processed.
v Path addresses must not exceed the MaxPathLength value (256 characters).
v Domain names must not exceed the MaxDomainName value (256 characters).

v User names, the local part of a mailbox specification, must not exceed the
MaxUserName value (256 characters).
The limit on the number of RCPT commands in a single SMTP job is 2000. If you
have more than 2000 RCPT commands, the excessive RCPT commands receive a
failure reply code 552 Too many recipients. Abend B37 can still occur for either of
the following reasons:
v No more space is available on volume.
v The volume table of contents (VTOC) is full.
Batch SMTP examples

The following sections contain examples that demonstrate batch SMTP capabilities.
Sending mail to a TCP network recipient

The following is an example of sending mail from an NJE network host to two
TCP network recipients. The NJE network is BITNET, and the NJE host is named
YOURMVS. This batch SMTP data set is spooled to SMTP at OURMVS, which is
running with the run-time arguments GATEWAY and NJEDOMAIN BITNET.
OURMVS is a BITNET host and is also connected through a TCP network to the
hosts rsch.our.edu and ai.our.edu.
HELO YOURMVS
MAIL FROM:<CAROL@YOURMVS>
RCPT TO:<msgs@rsch.our.edu>
RCPT TO:<alice@ai.our.edu>
DATA
Date: Thur, 26 Mar 92 21:48:57 EST
From: Carol <CAROL@YOURMVS>
To: <msgs@rsch.your.edu>
Cc: <alice@ai.your.edu>
Subject: update
Mike: Cindy stubbed her toe. Bobby went to

baseball camp. Marsha made the cheerleading team.
Jan got glasses. Peter has an identity crisis.
Greg made dates with 3 girls and couldn’t
remember their names.
.
QUIT
Note: The date header must contain the time and the correct time zone. If the time
zone is not present, then the time the e-mail is received on the remote side
defaults to a time zone of GMT. See RFC 822 for the required syntax of this
information.
SMTP rewrites the From: line to reflect that the mail has been transferred from an
NJE network (in this case, BITNET) to a TCP network. The TCP network recipients
receive:
From: carol <CAROL%YOURMVS.
BITNET@ourhost.our.edu>
Querying the SMTP delivery queues

The SMTP delivery queues can be queried by sending a data set with the SMTP
commands VERB ON and QUEU to the SMTP address space. A batch SMTP
response data set is returned with the result of the VERB ON command.

Using batch SMTP command in TSO utilities
The batch SMTP commands are also used with the TSO transmit (XMIT) command
and the IEBGENER utility in TSO/ISPF.
Note: JES spool files created by TSO transmit will retain trailing blanks. JES spool
files created by IEGNEGER and other utilities will have the trailing blanks
truncated.
Use the TSO transmit (XMIT) command to spool a batch SMTP command
sequential data set to SMTP. After you create the batch SMTP command sequential
data set, use the following command to spool the data set to SMTP:
XMIT jesnode-name.smtp DA(batsmtp.text)
Where:
jesnode
The JES nodename or hostname.
smtp Is the SMTP address space name. This is the default.
batsmtp.text
Is the batch SMTP commands data set.
Note: If sending a member of a partitioned data set (PDS) using the TSO transmit
command, the member must be converted to a SEQuential file. Use the SEQ
option on the TSO transmit (XMIT) command to accomplish this as shown
in the following example.
XMIT jesnod-name.smtp DA(pds(member)) SEQ
Where pds is the name of the partitioned data set and member is the name of
the member to be sent to SMTP.
To code the batch SMTP commands as inline input for SYSUT1 and SYSUT2, create
the following JCL using the IEBGENER utility on the TSO/ISPF application.
Note: The date header must contain the time and the correct time zone. If the time
zone is not present, then the time the e-mail is received on the remote side
defaults to a time zone of GMT. See RFC 822 for the required syntax of this
information.
//BATSMTP JOB (userid,nn),MSGCLASS=B,PRTY=12,MSGLEVEL=(2,1)
//IEBGENER EXEC PGM=IEBGENER
//SYSIN DD DUMMY
//SYSUT1 DD *
HELO YOURMVS
MAIL FROM:<CAROL@YOURMVS>
RCPT TO:<msgs@rsch.our.edu>
RCPT TO:<alice@ai.our.edu>
DATA
Date: Thur, 26 Mar 92 21:48:57 EST
From: Carol <CAROL@YOURMVS>
To: <msgs@rsch.your.edu>
Cc: <alice@ai.your.edu> Subject: update
Mike: Cindy stubbed her toe. Bobby went to

baseball camp. Marsha made the cheerleading team.
Jan got glasses. Peter has an identity crisis.
Greg made dates with 3 girls and couldn’t
remember their names.
.

QUIT
/*
//SYSUT2 DD SYSOUT=(B,smtp)
//* | v
//* v SMTP address space name for external writer
//* SYSOUT class
//SYSOUT DD SYSOUT=A
//SYSPRINT DD SYSOUT=A
//
The blocksize limit for files placed on the JES spool is 32760. If necessary, code the
DCB attributes on the SYSUT2 DD statement. Do not place spanning record files
on the JES spool for SMTP to pick up, because SMTP does not support these files.
The following shows how to code the DCB attributes:
//SYSUT2 DD SYSOUT=(B,SMTP),DCB=(LRECL=133,BLKSIZE=27930),FREE=CLOSE
SMTP with DBCS support

Mail in EBCDIC DBCS Big-5, Kanji, Hangeul, Simplified Chinese, or Traditional
Chinese can be sent to a remote host using SMTPNOTE, if the SMTP server is
configured with the corresponding DBCS support. See the z/OS Communications
Server: IP Configuration Reference for more information about configuring DBCS
support for the SMTP server.
Conversion of DBCS mail

The transmission of DBCS mail by SMTP actually uses two different translation
tables, one SBCS and one DBCS. SBCS characters in the mail headers and in the
mail body are converted using hlq.STANDARD.TCPKJBIN, TCPHGBIN,
TCPSCBIN, or TCPCHBIN.
Both SBCS and DBCS translation tables are required for the transmission of DBCS
mail, as the mail can contain mixed-mode strings. A mixed-mode string contains
both SBCS and DBCS data, delimited by shift-out and shift-in characters.
DBCS conversion is performed only on outgoing and incoming mail to and from
other hosts. Mail spooled to SMTP by SMTPNOTE for the local host is delivered
directly, without any DBCS code conversion.

Chapter 7. Sending electronic mail using z/OS UNIX sendmail
This topic briefly describes how to use z/OS UNIX sendmail, provided with z/OS
Communications Server, to prepare and send electronic mail using the facilities of
the z/OS shell.
For a comprehensive discussion of sendmail, see the industry-accepted document

sendmail by O’Reilly & Associates, Inc.
You can also find more information about sendmail on Web site
http://www.sendmail.org.For the features added after version 8.8.7, see SENDMAIL
INSTALLATION AND OPERATION GUIDE, that can be found on Web site
http://www.sendmail.org/~ca/email/doc8.12/op.html.

sendmail command—Send file contents
Purpose
Use the sendmail command to send the contents of a file.
Format
sendmail
user_name command_line_switch
Parameters
user_name
The user_name of the person you want to receive the mail.
command_line_switch
See the z/OS Communications Server: IP System Administrator’s Commands for
information about sendmail command line arguments or switches.
Examples
To test run sendmail by hand, complete the following steps:
1. Create a file named sendstuff with the following contents:
This is a one line message.
2. Mail this file to yourself with the following command line, where you is your
login name:
sendmail you <sendstuff
When you run sendmail, any command-line arguments that do not begin with a
hyphen (-) are considered to be the names of the people to whom you are sending
the mail message.
Note: The full path name might differ on your system. If so, simply specify the
full sendmail path name as it is configured on your system.
The <sendstuff sequence causes the contents of the file that you have created
(sendstuff) to be redirected into the sendmail program. The sendmail program treats
everything it reads from its standard input (up to the end of the file) as the mail
message to transmit.
Results
There are several ways to view the message that you just sent, depending on how
your system is configured. You can type MAIL to view your mail, or use the mh
package and type INC to receive and SHOW to view your mail. After viewing
your mail, save the mail message to a file. The file will look something like this:

From you@Here.US.EDU Wed Dec 26 18:45:36 2001
Return-Path: <you>
Received: (from you@localhost)
by Here.US.EDU (8.12.1/8.12.1) id fBQAjaoi001037
for you; Wed, 26 Dec 2001 18:45:36 -0700
Date: Wed, 26 Dec 2001 18:45:36 -0700
From: you <you>
Message-Id: <200112261045.fBQAjaoi001037@Here.US.EDU>
Status: RO
This is a one line message.
This file begins with nine lines of text that were not in your original message.
Those lines were added by sendmail and your local delivery program and are
called the header.
The last line of the file is the original line from your sendstuff file. It is separated
from the header by one blank line. The body of a mail message comes after the
header and consists of everything that follows the first blank line.
Ordinarily, when you send mail with your MAILUSERAGENT (MUA), the MUA
adds a header and feeds both the header and the body to sendmail. This time,
however, you ran sendmail directly and supplied only a body; the header was
added by sendmail.
Chapter 7. Sending electronic mail using z/OS UNIX sendmail 361

Chapter 8. Using remote printing
z/OS Communications Server provides client and server support for remote
printing. The remote printing application enables you to spool data sets remotely
to a Line Printer Daemon (LPD). The Line Printer Requester (LPR) sends the
spooled data set to a specified print server host and to a specified printer.
This topic describes the remote printing commands listed in Table 22.
Note: Although this information describes the commands and parameters that are
valid for the MVS LPR client, you might not get the same results from
non-MVS servers, because those servers might not support the same
commands and parameters.
Table 22. Remote printing commands
Command Description See
LPQ Request a list of the printer “LPQ command—Request a list of the printer
queue on a remote printer. queue on a remote printer” on page 364
LPR Print to a remote printer. “LPR command—Print to a remote printer”
on page 366
LPRM Remove a job from the “LPRM command—Remove a job from the
printer queue on a remote printer queue on a remote host” on page 379
host.
LPRSET Set the default printer and “LPRSET command—Set the default printer
host name. and host name” on page 381

LPQ command—Request a list of the printer queue on a remote printer
Purpose
Use the LPQ command to request a list of the printer queue on a remote printer
from the LPD server controlling that printer.
Notes:
1. Do not use the forward slash character (/) in any parameter value for this
command.
2. The TSO LPQ command uses the Pascal socket API, so VMCF must be started
for the command to be successful. If VMCF is not started, an ABEND0D6 can
occur.
Format
LPQ
job_id ( Opt Parms 1: Opt Parms 2:
Opt Parms 1:
ALL Printer name Host host

AT host
Opt Parms 2:
TRace TYpe Version
Parameters
job_id
Specifies either a user ID (this cannot start with a digit), or a job number in the
remote printer queue. If you do not specify job_id with the LPQ command, all
the jobs in the remote printer queue are listed.
Note: job_id is case-sensitive on some systems.

ALL
Prints a long report, which shows the source host and other print job
information.
Printer name
Specifies the name of the printer for which you want the printer queue listed.
The printer name cannot contain an @ symbol.
Host host
Specifies the name or IPv4 IP address of the printer host. The name must
resolve to an IPv4 address. AT is a synonym for this option.
AT host
Specifies the name or IPv4 IP address of the printer host. The name must
resolve to an IPv4 address. Host is a synonym for this parameter.

TRace
Turns on the trace details for interaction with the remote printer. TRace always
overrides TYpe because TYpe is a subset of TRace. Use this option whenever
you need to document a problem.
TYpe
Displays the progress of the command.
Version
Displays the version of the program.
Examples
v Query the printer lp0 on the system os2sys1 and print a short listing of the jobs
that are queued for the lp0 printer:
LPQ (PRINTER lp0 HOST os2sys1
v If the LPRSET command was previously issued (LPRSET lp0@os2sys1), using the
following LPQ command has the same effect as issuing the command in the
previous example.
LPQ
v Get a long listing of the jobs queued, including the name of the host that created
the jobs:
LPQ (PRINTER lp0 HOST os2sys1 ALL
v List the jobs for a user named smith:
LPQ smith (PRINTER lp0 HOST os2sys1
v Get information only about job 123:
LPQ 123 (PRINTER lp0 HOST os2sys1
Usage
v If the printer or host name are not specified in the LPQ command, the last
LASTING.GLOBALV variables for PRINTER and PRTHOST in the
user_id.LASTING.GLOBALV data set are used as the defaults. You can specify
these variables with the LPRSET command. You can use these variables to set up
a default printer and host to be used if you do not specify a printer or host.
v User names in a query are case-sensitive. For example, smith and SMITH are not
the same names. Also for example, on UNIX systems, lp0 and LP0 can refer to
different printers.
v Some systems do not answer with the job information when you use a job
number for a job that was not produced by the querying system.
v You would not normally use the LPQ command to query an MVS system,
because the LPD queue on MVS processes so quickly.
Chapter 8. Using remote printing 365

LPR command—Print to a remote printer
Purpose
Use the LPR command to print to a remote printer.
Notes:
command.
2. The TSO LPR command uses the Pascal socket API, so VMCF must be started
for the command to be successful. If VMCF is not started, an ABEND0D6 can
occur.
Format
LPR data_set_name
( Optional parameters
Optional parameters:

AT host
BIG5
NOBInary
BINary
BUrst
NOBUrst
CC
NOCc
CFfirst
CLass class
1
COpies copies
EOFlf
NOEOFlf
Euckanji
Filter filter
HAngeul
HEader
NOHeader
IBmkanji
Indent number
JIS78kj
ASCII
JISROMAN
JIS83kj
ASCII
JISROMAN
JNum number
Job jobname
Ksc5601
LAndscape
LANDNOcz
LATEconn
LNcz
55
LInecount count
NOLincount
Mail
NAme name
POstscript
NOPostscript
Printer name
More optional parameters:

Host host
SChinese
SJiskanji
SLowshutdown
SOsi
SOsi ASCII
SOsi EBCDIC
SOsi NONE
SOsi SPACE
TChinese
TIMEout
Title title
TOpmargin number
NOTOpmargin
TRACe
TRANslatetable name
TYpe USCFxlate
User name
Version
Width width
Xlatetable name
-o option
filter:
f
l
p
r
jobname:
DEST
FOR
FORM
IDENTIFIER
LINECOUNT
OTHERS
PASS
PRIORITY
Parameters
data_set_name
Specifies the name of the data set to be printed. This cannot be the name of a
z/OS UNIX file.
AT host
Specifies the name or IPv4 IP address of the printer host machine. If host is a
name, it must resolve to an IPv4 address. Host is a synonym for this option.
BIG5
Converts data from Traditional Chinese host DBCS to Big-5 DBCS when
transferring data to a remote system. LPR loads the BIG5 DBCS translation
table from TCPCHBIN binary table data set.

NOBInary
Causes LPR to convert the data from EBCDIC to ASCII when it is sent to the
remote system. This is the default.
BINary
Causes LPR to send the data without translation and without any indication of
record boundaries. Use this option if the data set is already in ASCII.
Note: The MVS LPD server always converts data sets in ASCII to EBCDIC,
and there is no option to disable this conversion.
BUrst
Causes a burst (banner) page to be printed on the remote printer. This is the
default.
NOBUrst
Prevents a burst (banner) page from being printed on the remote printer.
CC
Causes the remote system to interpret the first character of each line as carriage
control.
Records containing control characters that are not valid are deleted. If all
records in the file are deleted, LPR processes the empty file.
CC is the default if the record format is FA, FBA, FBM, FM, VA, VBA, VBM, or
VM. The characters used to specify these record formats have the following
meanings:

B Blocked records
A Records containing ISO/ANSI control characters
M Records containing machine code control characters
NOCc
Prevents the remote system from interpreting the first character of each line as
an ASA carriage control.
CFfirst
Specifies that LPR will send the ControlFile describing the data before it sends
the DataFile that contains the data. This option enables some LPD servers to
print larger jobs since the data can be printed as it is received.
Specify this option when small jobs print, but large jobs do not.
Note: Even when this option is specified, the print job might still be too
complex to print.
CLass class
Specifies the class name to the remote system. The class name is printed on the
banner pages. The default is the sending host name.
To override the SYSOUT CLASS of a job, the CLASS value must be only a
single alphanumeric character . For example, CLASS c.
COpies copies
Specifies the number of copies to be printed. The default is one copy.
EOFlf
Causes an ASCII line feed after the last line of data of a file formatted by ANSI
carriage control. Since ANSI carriage control positions the paper before the line

is printed, you cannot specify how the paper should be positioned after the
last line prints. The normal network standard is to terminate every file with a
line feed. Some LPDs do not print the last line if the line feed is not added. For
example, in ANSI carriage control, a ’F1’X means eject to a new page before
printing the lines. ANSI or ASA CC is used in files with RECFM=FBA.
EOFlf is the default for ANSI CC files. Specify NOEOFlf if your paper is
positioned incorrectly and an extra line is printed because LPR adds a line
feed.
This parameter does not impact files that are not ANSI CC. For example,
BINary, POstscript, LAndscape and Machine CC files are not affected by EOFlf.
NOEOFlf
Inhibits adding the ASCII line feed after the last line of a file that is formatted
by ANSI carriage control. Since ANSI carriage control positions the paper
before the line is printed, how the paper should be positioned after the last
line cannot be specified by the carriage control characters. The normal network
standard is to terminate every file with a line feed. Specifying this parameter
causes the last byte of data to be the last byte sent; a line feed is not added.
For example, an ANSI carriage control ’F1’X means eject to a new page before
printing the line. ANSI or ASA CC is used, for example, in files with
RECFM=FBA.
Specify NOEOFlf if your paper is positioned wrong because an extra line is
being printed at the end of the file. Some applications specify the positioning
and do not have the extra line feed sent by LPR.
For example, BINary, POstscript, and Machine CC files are not affected by this
parameter. This option does not apply when you specify LAndscape.
Euckanji
Causes the data to be converted from EBCDIC DBCS to Extended UNIX Code
kanji ASCII DBCS when it is sent to the remote system. LPR loads the
EUCKANJI DBCS translation table from the TCPKJBIN binary translate table
data set.
Filter filter
Specifies the type of processing to be done on the data by the remote system.
The filter is written as a single letter. Both uppercase and lowercase letters are
accepted, but uppercase letters are converted to lowercase.
Note: The filter values must also be defined in the SERVICE statement of the
configuration data set for the MVS LPD server. See the z/OS
Communications Server: IP Configuration Reference for more information on
the LPD server configuration data set.
In addition to the following list of filter codes, there are filters supported by
other servers described in RFC 1179. [For a list of Requests for Comments
(RFCs), see Appendix D, “Related protocol specifications,” on page 449.]
Filter code Description

f Print as a sequence of lines
l Print, passing through all control characters
p Print with pagination

r Print, interpreting the first column as FORTRAN carriage control
characters. The supported IBM FORTRAN carriage control
characters are 1, 0, +, and −.
When using the MVS LPD server to print files with filter code r, the
PAGESIZE parameter on the SERVICE statement for the printer you
are printing to also affects pagination.
See “Usage” on page 377 for further information.
HAngeul
Causes the data to be converted from EBCDIC DBCS to Hangeul ASCII DBCS
when it is sent to the remote system. LPR loads the HANGEUL DBCS
translation table from the TCPHGBIN binary translate table data set.
HEader
Causes a page header to be inserted by the client at the top of every printed
page if the NOCc and NOBInary options are in effect. To cause the server to
insert page headers, use p as the value of filter and specify the NOHeader
option.
NOHeader
Prevents the client from inserting page headers.
IBmkanji
Causes the data to be sent without translation as IBM (EBCDIC) kanji. This
parameter performs the same function as the BINary parameter.
Indent number
Specifies the number of columns the remote system indents the output when f
or p is specified as the value of filter.
JIS78kj ASCII
Causes the data to be converted from EBCDIC DBCS to JIS 1978 kanji ASCII
DBCS, using the ASCII shift-in escape sequence ESC ( B, when it is sent to the
remote system. LPR loads the JIS78KJ DBCS translation table from the
TCPKJBIN binary translate table data set.
JIS78kj JISROMAN
DBCS, using the JISROMAN shift-in escape sequence ESC ( J, when it is sent
to the remote system. LPR loads the JIS78KJ DBCS translation table from the
JIS83kj ASCII
DBCS, using the ASCII shift-in escape sequence ESC ( B, when it is sent to the
remote system. LPR loads the JIS83KJ DBCS translation table from the
JIS83kj JISROMAN
DBCS, using the JISROMAN shift-in escape sequence ESC ( J, when it is sent
to the remote system. LPR loads the JIS83KJ DBCS translation table from the
JNum number
Specifies a specific job number for the print request, where number is a unique,
3-digit number in the range 000–999. This job number is used by LPR to name
the temporary data and control files, such as:

dFA123hostname cFA123hostname
The JNum parameter is not valid from NPF; do not specify JNum in the NPF
OPTIONS file.
If JNum is not specified for LPR, the three-digit number is randomly generated
by LPR.
Job jobname
Specifies the job name to the remote system. The default name is the full data
set name. The job name is printed on the banner pages.
The following parameters are available with the Job parameter and are entered
as PARAMETER=value. When you use these parameters, you must separate them
from Job or jobname by a blank and from other options by a comma and no
blank. For example,
Job PASS=password,FOR=userid
DEST Sets the destination node. The default is the node on which the
LPR client is running.
FOR Specifies a user ID other than the sending user ID for which
the output is to be spooled. The default is the sender’s ID.
FORM Identifies the form on which the data is printed. This is the
equivalent of the form-name subparameter in the MVS
SYSOUT parameter on the DD card. Therefore, the form name
specified can be 1 through 4 alphanumeric or national ($, #, @)
characters.
IDENTIFIER Sets the destination ID. The default is SYSTEM.
LINECOUNT Specifies a numeric field indicating the number of lines on a
page. This option overrides the PAGESIZE parameter of LPD.
OTHERS Causes all subsequent options to be ignored. This option is
ignored by the MVS LPD server.
PASS Specifies the password. The default is no password, which
causes the job to fail if the RACF option is specified for the
service.
PRIORITY Specifies the transmission priority. The default is 50.
Ksc5601
Causes the data to be converted from EBCDIC DBCS to Korean Standard Code
KSC-5601 ASCII DBCS when it is sent to the remote system. LPR loads the
KSC5601 DBCS translation table from the TCPHGBIN binary translate table
data set.
LAndscape
Converts a non-PostScript data set to a PostScript® data set for printing with
print lines parallel to the long edge of the paper. If the remote printer can
process PostScript output, the data set is printed in landscape format (rotated
90 degrees). Some nonprinting EBCDIC characters below X'3F' are changed to
blanks.
Note: An ASCII cntl-Z X'1A' is sent after the data. If this dos-EOF character
causes problems, use the LANDNOcz option instead.
LANDNOcz/LNcz
Converts a non-PostScript data set to a PostScript data set for printing with

print lines parallel to the long edge of the paper. If the remote printer can
process PostScript output, the data set is printed in landscape format (rotated
90 degrees). Some nonprinting EBCDIC characters below X'3F' are changed to
blanks.
Note: Normally, you should use the LAndscape option, unless the dos-EOF
character (X'1A') sent after the file causes problems. LN and LNcz are
abbreviations for LANDNOcz.
LATEconn
Causes LPR to process the input data file before making any TCPIP connection
with the printer. When this option is not specified, the TCPIP connection is
made before the data file processing begins. This option can be specified when
the initial processing of very large files causes the connection with a printer to
be dropped because of a timeout.
LInecount count
Determines the number of lines to be printed before a new heading is printed.
This option is meaningful only for a data set that does not have the CC option
specified either explicitly or by default.
The valid range for LInecount is 0 to the Pascal integer MAX number 2 147 483
647. The default value is 55. To suppress printing a header before each new
page, specify LInecount 0. Specifying LInecount 0 has the same effect as
specifying the NOLinecount option.
NOLinecount
Prevents a header being printed before each new page. Specifying
NOLinecount has the same effect as specifying LInecount 0.
Mail
Causes mail to be sent to the user when the printing operation ends (for those
servers that support this).
NAme name
Specifies the job information to be provided by the remote system in response
to a query. Only the name or files portion of the query is displayed. This option
is not honored by all remote printing servers.
POstscript
Inserts the header required by some systems to recognize a PostScript data set.
NOPostscript
Prevents a PostScript data set from being recognized as a PostScript data set.
Printer name
Specifies the name of the printer on which you want the data set printed. The
printer name is case sensitive.
Host host
Specifies the name or IPv4 IP address of the printer host machine. If host is a
name, it must resolve to an IPv4 address. AT is a synonym for this option.
SChinese
Converts data from Simplified Chinese host DBCS to Simplified Chinese PC
DBCS when transferring data to a remote system. LPR loads the SCHINESE
DBCS translation table from TCPSCBIN binary table data set.
SJiskanji
Causes the data to be converted from EBCDIC DBCS to Shift JIS kanji ASCII
DBCS when it is sent to the remote system. LPR loads the SJISKANJI DBCS
translation table from the TCPKJBIN binary translate table data set.

SLowshutdown
Causes slower TCP/IP connection termination after the job is sent to the
printer. This option is rarely needed. This option is provided for print servers
which discard the print job just successfully received when LPR uses the fast
shutdown. Before using this option, check the print server for errors (such as
spool file full) that might be causing the job to be discarded instead of printed.
SOsi
Determines how any EBCDIC DBCS shift-out (’0E’X) and shift-in (’0F’X)
characters in the input file are handled. The ASCII, EBCDIC, or SPACE
parameters specifies what is used as shift characters in the ASCII output from
LPR. If SOsi is specified without a following parameter, ASCII is used as the
default.
If you do not specify SOsi, shift-out/shift-in characters are not used in the
ASCII data stream. Therefore, the EBCDIC DBCS shift characters are just
removed during the translation to ASCII. This is the same as specifying SOsi
NONE.
SOsi has no effect on DBCS translations JIS78KJ, JIS83KJ, and IBMKANJI. It is
used with other DBCS translation such as BIG5, EUCKANJI, HANGEUL,
KSC5601, SCHINESE, SJISKANJI, and TCHINESE.
SOsi ASCII
Specifies that DBCS data strings in the ASCII output are delimited by special
shift-out/shift-in characters. As the data is translated from EBCDIC to ASCII,
input EBCDIC shift-out (’0E’X) becomes (’1E’X), and ’0F’X becomes ’1F’X.
SOsi EBCDIC
Specifies that DBCS data strings in the ASCII output are delimited by EBCDIC
input EBCDIC shift-out (’0E’X) remains EBCDIC shift-out (’0E’X), and ’0F’X
remains ’0F’X.
SOsi NONE
Specifies that DBCS data strings in the ASCII output are not delimited by any
any EBCDIC DBCS shift characters are removed.
SOsi SPACE
Specifies that DBCS data strings in the ASCII output are delimited by ASCII
space (’20’X) characters. As the data is translated from EBCDIC to ASCII, input
EBCDIC shift-out (’0E’X) becomes ASCII space (’20’X) and EBCDIC shift-in
(’0F’X) also becomes ’20’X.
TChinese
Causes the data to be converted from EBCDIC DBCS to Traditional Chinese
(5550) ASCII DBCS when it is sent to the remote system. LPR loads the
TCHINESE DBCS translation table from the TCPCHBIN binary translate table
data set.
TIMEout
Specifies that LPR wait 5 minutes for an ACK or NACK from the LPD printer.
If ACK or NACK does not arrive, LPR terminates the connection with Error
Number=73. Since LPR waits for ACK in several places, this error can occur in
different LPR messages, such as EZB1048E.
For some printers, the ACK is not returned until the job has printed. For these
printers, specifying the TIMEout option can cause long jobs to stop printing.

When the TIMEout option is not specified, LPR waits as long as the TCP/IP
connection exists. For some printers, this could tie up the PORT (and any NPF
thread using LPR on that PORT) until an operator intervenes to fix the printer.
For NPF users, TIMEout should be added as an LPR option for these printers.
See the z/OS Communications Server: IP Network Print Facility for information
about configuring LPR options in NPF.
Title title
Specifies the title assigned to a data set printed with the FILTER p option.
TOpmargin number
Specifies the number of lines designated for the top margin.
NOTOpmargin
Indicates that blank lines are not inserted at the top of each page.
TRACe
overrides TYpe because TYpe is a subset of TRace.
TRANslatetable name
Specifies the SBCS translate table to be used by the client. The name parameter
is preceded by either the userid or the hlq and followed by TCPXLBIN to form
the data set name of the translate table (userid.name.TCPXLBIN or
hlq.name.TCPXLBIN). If both data sets exist, a search order hierarchy determines
which one is to be used.
information about search order hierarchy, loading, and customizing SBCS
translation tables. XLatetable is a synonym for this option.
TYpe
Displays the progress of the command as the data set is being processed.
USCFxlate
Specifies that a single byte translation table such as JPNKANA be used for the
print data. The control file generated by LPR and sent to LPD contains upper-
and lowercase alphanumeric characters. Specify this option if any of them are
being translated incorrectly, causing the LPD to reject the print jobs.
User name
Specifies a name that overrides the user identification of the program that is
requesting the print job, prints on the banner page, and becomes the user
identification of the mail option. The name field cannot be longer than eight
characters. If you do not enter the user name parameter, it defaults to the
system user identification or to the job name.
Version
Width width
Specifies the line width of a data set printed with the FILTER options f, l, p, or
r.
Xlatetable name
Specifies the SBCS translate table to be used by the client. The name parameter
is preceded by either the userid or the hlq and followed by TCPXLBIN to form
the data set name of the translate table (userid.name.TCPXLBIN or
hlq.name.TCPXLBIN). If both data sets exist, a search order hierarchy determines
which one is to be used.

information about search order hierarchy, loading, and customizing of SBCS
translation tables. TRANslatetable is a synonym for this option.
-o option
Specifies an option that the control file in PSF for AIX (PSF/6000) or InfoPrint
uses to format the print job. Any -o option honored by PSF/6000 can be passed
to the control file using this parameter of the LPR command. This parameter
must be issued without a blank between the -o and the option.
Below are some sample options. None of these options are standard LDP
options. They are not honored by most LPD print servers.
-ochars=GT15 Sets the value of the CHARS parameter to GT15.
-obin=2 Sets the input bin to 2 (use alternate input bin).
-opagedef=P13700
Sets the value of PAGEDEF parameter to P13700.
-oformdef=F1SEPA
Sets the value of the FORMDEF parameter to F1SEPA.
-ocopies=002 Sets the JCL COPIES count to 2. This parameter is not honored
by most LPD servers. Other LPD servers ignore all control file
information and print one copy. For these printers, issue the
LPR command multiple times to get multiple copies.
IBM Print Services for AIX (S544-3878-03) contains detailed descriptions of the
-o options for PSF/6000.
Examples
v Print the data set TEST.LISTING on a printer named lp0 on the system mvs1:
LPR TEST.LISTING (PRINTER lp0 HOST mvs1
v If TEST.LISTING has a record format that contains carriage control such as VBA,
the first character of each line is interpreted as carriage control. To prevent the
first character of each line from being interpreted as carriage control, use the
following command:
LPR TEST.LISTING (PRINTER lp0 HOST mvs1 NOCC
v If this LPRSET command was issued:
LPRSET lp0@mvs1
the following LPR command would also print the data set on printer LP0 on the
host MVS1 and prevent the first character of each line from being interpreted as
carriage control:
LPR TEST.LISTING (NOCC
v Print the data set TEST.LISTING in landscape mode:
LPR TEST.LISTING (LANDSCAPE
The following example shows the PostScript attributes used in the LAndscape
option:
614 25 translate 90 rotate .88 .76 scale
/n 1 def
/fs 10 def
/ls 11.2 def
/ld ls 2 mul def
/lt ls 3 mul def
/t 740 fs sub def
/y t def /ff t def /os 20 def

/s 512 string def
/Courier-Bold findfont
fs scalefont setfont
/p {n {copypage} repeat erasepage} def
/i (%stdin) (r) file def
/{/c i read not {p stop} if def
c 26 eq {p stop} if
/x 20 def
/y c 43 eq {y /x os def}
{c 32 eq {y ls sub}
{c 48 eq {y ld sub}
{c 45 eq {y lt sub}
{c 49 eq {ff} {y} ifelse}
ifelse} ifelse} ifelse} ifelse def
/ff 0 def
y 65 le {p /y t def} if x y moveto
/os i s readline not {p stop} if dup show
length 0 eq {20} {20.72} ifelse def } loop
To understand these attributes you might need to reference a PostScript manual.
v If a data set TEST has a low-level qualifier of LISTPS (PostScript), use the
following command to send TEST to a PostScript-capable printer without
specifying the PostScript option:
LPR TEST.LISTPS (PRINTER lp0 HOST mvs1
v Print a FORTRAN source program with 57 lines on each page:
LPR TEST.FORTRAN (LINECOUNT 57
Usage
v When sending a print job to a printer that has RACF in its definition in the
LPD.CONFIG data set, you must specify the password. If it is for a different
user ID, you must specify that password and user ID as follows:
Job PASS=password,FOR=userid
v If the printer or host name are not specified in the LPR command, the last
user_id.LASTING.GLOBALV data set are used as the defaults. You can specify
these variables with the LPRSET command.
v LPR normally issues messages only if there is an error. If you want to track the
progress of the command, use the TYpe or TRACe parameter.
v You can use the LPR command to send PostScript data sets to a printer that can
print documents in that language. LPR checks that no incompatible options were
given, if it is a PostScript data set. You can override this check, if you want to
print a PostScript program with the NOPostscript option. UNIX systems
examine the first few characters of a data set (looking for %!) to determine if a
data set is a PostScript data set. If you have PostScript data sets that do not
contain the characters %!, use the POstscript parameter to add them.
v Carriage control is interpreted line by line. A data set can mix ASA and machine
carriage control. Interpretation is done by converting the controls to the
appropriate ASCII sequences, before the data set is sent to the remote system.
Lines that have incorrect carriage control are not printed.
v When a data set is printed without carriage control, LPR adds a heading line
that shows the name of the data set, the title of the system on which the LPR
command is running, and a page number. You can specify the number of lines to
be printed (excluding the 3 heading lines) with the LInecount parameter.
v When you specify a filter code, LPR ignores CC, HEader, NOCc, NOHeader, and
TOpmargin. When a filter code of f, l, p, or r is specified, LPR stops paginating
the data set it is printing. Instead, it sends the data in the data set as plain lines.
The following list provides a description of these filter codes:
f Print as a sequence of lines.
l Print, passing through all control characters.
p Print with pagination.
r Print, interpreting the first column as FORTRAN carriage control
characters. The supported IBM FORTRAN carriage control
characters are 1, 0, +, and −.
When using the MVS LPD server to print files with filter code r, the PAGESIZE
parameter on the SERVICE statement for that printer is ignored in the LPD
CONFIG file. The PAGESIZE parameter defaults to 60 if it is not specified. To
prevent unwanted page ejects, change the value specified on the PAGESIZE
parameter to a number greater than the actual number of lines on the pages
being printed. For example, you can specify 100 000 for the PAGESIZE
parameter.
When you specify a filter code of c, d, g, n, t, or v, LPR transmits the data as a
byte stream (as though you specified the BINary option).

LPRM command—Remove a job from the printer queue on a remote
host
Purpose
Use the LPRM command to remove a job from the printer queue on a remote host.
Notes:
command.
2. The TSO LPRM command uses the Pascal socket API, so VMCF must be
ABEND0D6 can occur.
Format
LPRM
job_id Opt Parms 1: Opt Parms 2:
Opt Parms 1:
(
Printer name Host host
AT host
Opt Parms 2:
TRace TYpe Version
Parameters
job_id
Specifies either a user ID (this must not start with a digit), or a job number in
the remote printer queue. If you do not specify job_id with the LPRM
command, your currently active job is removed.
Printer name
Specifies the name of the printer associated with the job.
Host host
Specifies the name or IPv4 IP address of the printer host. If host is a name, it
must resolve to an IPv4 address. AT is accepted as a synonym for HOST.
AT host
Specifies the name or IPv4 IP address of the printer host. If host is a name, it
must resolve to an IPv4 address. Host is a synonym for this option.
TRace
overrides TYpe because TYpe is a subset of TRace.
TYpe

Version
Examples
v Cancel job number 123 on the printer lp0 on the local system os2sys1:
LPRM 123 (PRINTER lp0 HOST os2sys1
LPRM 123 (PRINTER lp0 AT os2sys1
If the job is in the queue, it is removed. If the job is currently active, it is

stopped.
v If the LPRSET command was previously issued (LPRSET lp0@os2sys1), using the
following LPRM command has the same effect as issuing the command in the
previous example:
LPRM 123
v Cancel the currently active job:
LPRM (PRINTER lp0 HOST os2sys1
Usage
v If the printer and host name are not specified in the LPRM command, the last
user_id.LASTING.GLOBALV data set are used as the defaults. You can set these
variables with the LPRSET command. You can use these variables to set up a
default printer, which is used if you do not specify a printer.
v Removing the currently active job can depend on the number of jobs currently
printing. If you have two jobs printing, and you use the LPRM command
without the job_id parameter, the first job might finish, but you could
inadvertently remove the second job instead.

LPRSET command—Set the default printer and host name
Purpose
Use the LPRSET command to set the default printer and host name. The printer
and host name can also be included in the line printer commands (LPR, LPQ, and
LPRM).
Notes:
command.
2. The TSO LPRSET command uses the Pascal socket API, so VMCF must be
ABEND0D6 can occur.
Format
LPRSET printer@host
Optional Parameters:
Optional Parameters:
(
Query TRace Version
TYpe
Parameters
printer@host
Specifies the name of the printer and host to be used. If host is a name, it must
resolve to an IPv4 address.
Query
Displays the current settings for the default printer and host.
TRace
Turns on the trace details for the recording of the printer and remote host
name. TRace always overrides TYpe because TYpe is a subset of TRace.
TYpe
Version
Examples
v Set the default printer and host as the printer lp0 on the local system mvs1:
LPRSET lp0@mvs1
v Display the current version of LPRSET:
LPRSET (VERSION
v Display the current settings:
LPRSET (QUERY

Usage
v When you use LPRSET to set the printer and host, a data set by the name
userid.LASTING.GLOBALV (where userid is the TSO user ID) is created or
updated. If this data set does not exist, you must be able to create this data set.
userid.LASTING.GLOBALV is the name required by LPRSET.
v Printer names can be case sensitive. The printer name must be spelled the way
the host uses it. For example, on UNIX systems, lp0 and LP0 can refer to
different printers.
Also be aware that ISPF panels default to uppercase unless otherwise specified.
v When you query the current settings on the same command that you set the
default printer and host, the query of the current settings is done before the
specified default printer and host are set. For example, if the printer was set to
PRINT1@RALVM13, and you perform the query, LPRSET PRINT2@RALVM13(Q, the
message returned says, PRINTER is PRINT1@RALVM13. However, it also changes
the default printer to PRINT2. So if you query again, it would respond, PRINTER
is PRINT2@RALVM13.
If you want to set the default printer and host and see that the defaults were set
in the same LPRSET command, use the TYPE parameter. For example, if you
want to set the default printer and host to PRINT2 on RALVM13 and then see
the results afterward, you would enter the following command.
LPRSET PRINT2@RALVM13 (TYPE

TSO SMSG command—Monitoring the Status of LPD
Purpose
The TSO SMSG command provides an interactive interface to the LPD server to:
v Turn on and off diagnostics tracing
v Query the work queue currently being used by LPD server
These commands are privileged so the commands are accepted only from users
specified in the OBEY statement in the LPD server configuration data set. For more
information regarding this statement, see the z/OS Communications Server: IP
Configuration Reference. Responses to the SMSG commands are sent to the
SYSPRINT file that is associated with the LPD started procedure job.
Format
SMSG LPD TRACE ON
OFF
PRINT WORK
Parameters
TRACE ON
Enables tracing in the LPD server.
TRACE OFF
Disables tracing in the LPD server.
PRINT WORK
Prints the jobs in the work queue for LPD.
Examples
The following example shows the output from the SMSG LPD PRINT WORK
command which is sent to the SYSPRINT file.
Note: Response to the SMSG LPD does not go to the screen for the user. The user
must look in the SYSPRINT file associated with LPD job to see the response.
16:59:29 EZB0786I Command received "PRINT WORK".
16:59:29 EZB0731I Work Queue start
16:59:29 EZB0732I <job number> <job state>
16:59:29 EZB0733I Work Queue end

Chapter 9. Using GDDMXD/MVS with the X Window System
This topic describes GDDMXD/MVS and the GDDMXD CLIST. This information
also describes how to use GDDMXD/MVS user-specified options and keyboard
functions. Problem determination information associated with GDDMXD/MVS is
also described in z/OS Communications Server: IP Diagnosis Guide.
Note: The feature HIP612X is required for GDDMXD.

v “Overview of GDDMXD/MVS”
v “Using GDDMXD/MVS” on page 387
v “User-specified options” on page 390
v “Keyboard functions” on page 403
Overview of GDDMXD/MVS
GDDMXD/MVS is an interface that allows graphics from the IBM Graphical Data
Display Manager/MVS to be displayed on workstations that support the
X Window System. When GDDMXD/MVS is installed and activated, the data
stream created by the GDDM® application is translated to the X Window System
protocol and transmitted by TCP/IP to the X Window System server for the
display. If GDDMXD/MVS is installed and not activated, or has been made
inactive, the GDDM application transmits data to its supported display device as if
GDDMXD/MVS were not present.
Keyboard and character set mappings

The following member names contain the described character sets:
Member name Description

GDXALTCS A member of SEZAINST that contains a second character set (the
3270 alternate character sets).
GDXAPLCS A member in the SEZAINST data set that contains sample keyboard
mapping for APL2.
KEYCODE A member of SEZALOAD that displays key codes. You can edit this
data set to change keyboard mappings.
Executable code
The following member names contain the described executable code or sample:
Member name Description

GDXLIOX0 A member of SEZALOAD that contains executable code
XDEFAULT A member of SEZAINST that contains the sample XDEFAULT
member for GDDMXD/MVS
GDDM application limitations

When GDDMXD/MVS is inactive, there are no GDDM application restrictions. The
following types of functions are not supported by GDDMXD/MVS:
v Multiple instances of the GDDM application

v Opening multiple display devices at one time
v Operator windows
GDDM display limitations

GDDMXD/MVS appears as an IBM 3179G device model to the GDDM application.
When the HostRast option is active, the device model is an IBM 3279. The IBM
3179 Model G Color Graphics Display Station is used regardless of the display
device nickname presented by the application.
The following are characteristics of the GDDMXD/MVS IBM 3179G display

station:
Alphanumeric Cursor
When the graphics cursor is not enabled, the alphanumeric cursor can be
repositioned by pointing the X Window System pointer device cursor for
the GDDMXD window at the desired character location and pressing the
pointing device button.
Attached Graphics Cursor
When the graphics cursor is attached, the X Window System pointer
device cursor for the GDDMXD window changes to a crosshair pattern
and moves as the pointer device is moved.
Blinking Character Attribute
Ignores the blinking character attribute.
Character Display
Characters with an EBCDIC value of less than hex 40 are displayed as
blanks.
Color Mixing
GDDMXD/MVS supports only the overpaint foreground color mix mode.
The initial color of the image area is black, and mixing with the actual
background colors is not performed.
An exception is made for data passed by an image data order. In this
exception, a combined foreground color mix mode is supported, if the
series of begin image orders have exactly the same parameter values.
When the HostRast option is active, color mixing is performed by GDDM,
and the preceding exception does not apply.
Default Vector Symbol Set
The Default Vector Symbol Set is not supported.
Detached Graphics Cursor
When the graphics cursor is detached by the data stream or is not
attached, the X Window System pointer device cursor for the GDDMXD
window changes to an open arrow when the keyboard is unlocked, or
changes to an X shape when the keyboard is locked.
Detectable Fields
Ignores the detectable fields.
Pixel Spacing
When the HostRast option is not active, the vertical and horizontal pixel
spacing of the actual display device that is obtained from the X Window
System is supplied to the GDDM application. When the HostRast option is
active, the pixel spacing of an IBM 3279 Color Display Station is supplied
to the GDDM application.

Visual Appearance
For all programmed symbol and image data that is received from the
GDDM application, each GDDM pixel is mapped to one X Window System
display pixel, which causes a different appearance from the same data
stream displayed on an IBM 3179G Color Graphics Display Station. This
map process can also cause display differences in the placement of
alphanumeric field data over the graphics display and in the appearance of
the filled areas of the graphic display. When the HostRast option is active,
aspect ratio distortion of the displayed graphics appears, unless the aspect
ratio of the X Window System display is the same as the IBM 3279.
Using GDDMXD/MVS
Before GDDM data can be sent to an X Window System display, activate
GDDMXD/MVS by invoking the GDDMXD CLIST. Make sure that you have
already copied the GDDMXD CLIST to your system CLIST data set. If you have
not, see the z/OS Communications Server: IP Configuration Reference for instructions.
Note: If you do not want to run GDDM applications through the X Window
System, do not enable GDDMXD/MVS.
To invoke the GDDMXD CLIST, use the GDDMXD command in the format
described in “GDDMXD command—Invoke the GDDMXD CLIST” on page 388.
Chapter 9. Using GDDMXD/MVS with the X Window System 387

GDDMXD command—Invoke the GDDMXD CLIST
Purpose
Use the GDDMXD command to invoke the GDDMXD CLIST.
Format
GDDMXD ON
OFF
Parameters
ON
Enables GDDMXD/MVS. GDDM output is sent to the X Window System
display. The system responds with GDDMXD/MVS active.
OFF
Disables GDDMXD/MVS. The system erases the data set that was created
when GDDMXD/MVS was activated and responds with GDDMXD/MVS inactive.

Identifying the target display
Purpose
A TSO global variable is used by the X Window System to identify the IP address
of the target display based on the contents of the data set
user_id.XWINDOWS.DISPLAY.
Format
internet_address :target_server
.target_screen
Parameters
internet_address
Specifies the IPv4 IP address of the host machine on which the X Window
System server is running.
:target_server
Specifies the number of the display server on the host machine.
.target_screen
Specifies the screen to be used on the target_server.
Examples
Examples of the contents of the user_id.XWINDOWS.DISPLAY data set.
v charm.cambridg.ibm.com:0.0
v 129.42.3.109:0.0

GDDMXD usage notes
v When you use the TSO Session Manager with GDDMXD, enter a null line in the
host session window after the GDDMXD graphics window disappears. This
updates and activates the host session window.
v When you run PL/I GDDM applications, do not let the ISASIZE run-time option
default to 0. This causes excessive allocation of storage below the 16 megabyte
line, and causes a variety of storage allocation abends. Enter a run-time option
for ISASIZE, such as ISASIZE(20K), to prevent storage allocation abends.
v Although GDDMXD provides its own device information to the GDDM
application, normal GDDM device initialization occurs. A full-screen 3270 TSO
session from a real or emulated 3270 terminal with 80 columns and 32 rows is
required to invoke the GDDM application.
Resizing the GDDMXD graphics window

GDDMXD supports four graphics presentation space sizes. The size of the graphics
presentation space used by GDDMXD is determined by the window width
specified by the Geometry option in the user_id.X.DEFAULTS data set (see
“User-specified options” on page 390 for more information). The size is also
determined dynamically when you resize the GDDMXD graphics window. The
relationship between the size of the graphics presentation space and the window
width is shown in Table 23.
Table 23. Supported graphics presentation space sizes
Window width (pixels) GDDMXD graphics presentation space (pixels)
< 650 480 horizontal by 352 vertical
>=650 to < 850 720 horizontal by 512 vertical
>= 850 to <= 1024 960 horizontal by 682 vertical
> 1024 1200 horizontal by 864 vertical
For graphics presentation space sizes other than the default size (720 pixels by 512
pixels), bit-mapped data, such as symbol sets and images, is expanded or
compressed to meet the scaling requirements of the specified graphics presentation
space.
You can expand bit-mapped data by duplicating rows and columns of the data.
The resulting view can differ slightly from the default-size view. You can compress
single-plane bit-mapped data by combining rows and columns of the data with a
logical OR function. Because this might not yield acceptable results when a black
on white image is viewed, the Compr option is provided to specify that a logical
AND function be used to compress the data. See “Compr option—Control the
technique used to compress bit-mapped data” on page 394 for more information
about using this option. You can compress multiplane bit-mapped data by
eliminating certain rows and columns. Data compression produces a view that is
different from the default-size view.
User-specified options
The user-specified options for GDDMXD/MVS are entries in a data set called
user_id.X.DEFAULTS. The user_id.X.DEFAULTS data set is searched during
initialization of GDDMXD/MVS.

Note: The values in the user_id.X.DEFAULTS data set are case sensitive and must
be entered as shown.
The options listed in Table 24 are supported by GDDMXD/MVS.

Table 24. GDDMXD/MVS options
Option Description See
ANFontn Specifies the X Window System “ANFontn option—Specify the X Window
font used for characters in the System font used for characters in the
alphanumeric presentation alphanumeric presentation space” on page
space. 392
CMap Specifies whether the default “CMap option—Specify whether the
color map is loaded or default color map is loaded or bypassed”
bypassed. on page 393
Compr Controls the technique used to “Compr option—Control the technique
compress bit-mapped data used to compress bit-mapped data” on
when a graphics window size page 394
of 480 by 352 pixels is
specified.
Enter Overrides the default key “Enter option—Override the default key
mapping for Enter. mapping for Enter” on page 395
GColornn Specifies a color name. “GColornn option—Specify a color name”
on page 396
Geometry Specifies the size and location “Geometry option—Specify the size and
of the initial GDDMXD location of the initial GDDMXD graphics
graphics presentation space. presentation space” on page 397
GMCPnn Overrides GDDM multicolor “GMCPnn option—Override GDDM
patterns with workstation color multicolor patterns with workstation color
names. names” on page 398
HOSTRAST Performs raster image “HostRast option—Perform raster image
processing at the host. processing at the System/370 host” on
page 399
NewLine Overrides the default key “NewLine option—Override the default
mapping for NewLine. key mapping for NewLine” on page 400
XSync Requests that the X Window “XSync option—Request that the X
System process one request at Window System process one request at a
a time. time” on page 401
ZWL Tells GDDMXD/MVS to draw “ZWL option—Tell GDDMXD/MVS to
all lines using 0-width lines. draw all lines using 0-width lines” on
page 402

ANFontn option—Specify the X Window System font used for
characters in the alphanumeric presentation space
Purpose
Use the ANFontn option to specify the X Window System font that GDDMXD
should use to display characters in the alphanumeric presentation space of the
GDDMXD window.
Format
gddmx*ANFontn: fontname
Parameters
n Specifies presentation space size.
fontname
Specifies the name of the X Window System font.
Examples
The following are examples of ANFontn options.
gddmx*ANFont1: Rom8
gddmx*ANFont3: Rom14
Usage
Graphics mode 1 and 2 characters in the graphics presentation space are not
affected by this option. The value of n is in the range 1–4 and defines the X
Window System font for each of the four sizes of presentation space supported by
GDDMXD. You can specify the ANFontn option for any, all, or none of the four
values for n. The X Window System fonts specified should be fixed-space fonts
that have characters that fit into the character box size required by each of the four
presentation space sizes.
n Presentation space Character box Example font

1 480 x 352 6 x 11 Rom8
2 720 x 512 9 x 16 Rom11
3 960 x 682 12 x 21 Rom14
4 1200 x 864 15 x 27 Rom17
If you select a font that has characters that are larger than the character box size,
the characters might overlap when displayed.

CMap option—Specify whether the default color map is loaded
or bypassed
Purpose
Use the CMap option to specify whether the default color map is loaded or
bypassed.
Format
Y
gddmx*CMap:
N
Parameters
Y Directs GDDMXD/MVS to load the default color map. This is the default.
N Directs GDDMXD/MVS to bypass loading the default color map.
Usage
During initialization, GDDMXD/MVS issues the X Window System call,
XInstallColormap, to load the default color map. If the CMap option is specified as
N, the XInstallColormap call is not made. This option is for X Window System
servers that load their own color map and do not want the clients to load any
other color map.

Compr option—Control the technique used to compress
bit-mapped data
Purpose
Use the Compr option to control the technique used to compress bit-mapped data
when a graphics window size of 480 by 352 pixels is specified.
Format
O
gddmx*Compr:
A
Parameters
O or o
Specifies that a logical OR function must be used when compressing
bit-mapped data. This is the default.
A or a
Specifies that a logical AND function must be used when compressing
bit-mapped data.

Enter option—Override the default key mapping for Enter
Purpose
The Enter option can be specified in the user_id.X.DEFAULTS data set to identify
which X Window System Keysym is to be mapped to the Enter function. This
option overrides the default mapping of the Keysym XK_Execute to the Enter
function.
Format
gddmx*Enter: keysym_name
Parameters
keysym_name
Specifies the X Window System Keysym representing the physical key. For
standard Keysyms, the XK_ prefix is not included in specifying the option.
Examples
In the following example of the Enter option, the X Window System Keysym,
XK_Return, is mapped to the Enter function.
gddmx*Enter: Return

GColornn option—Specify a color name
Purpose
GDDMXD/MVS provides a default mapping of GDDM colors to X Window
System colors. Use the GColornn option to override a default color name or to
specify a color if a default color name is not available by your X Window System
server.
Format
gddmx*GColornn: c
Parameters
nn:
Specifies the GDDM color entry that is mapped.
c Specifies the X Window System color that is used as the GDDM color.
Usage
Table 25 lists the GDDM colors that GDDMXD/MVS maps to the X Window
System.
Table 25. GColors
GColornn GDDM color X Window System color
GColor1 Blue Blue
GColor2 Red Red
GColor3 Magenta Magenta
GColor4 Green Green
GColor5 Turquoise Turquoise
GColor6 Yellow Yellow
GColor7 White White
GColor8 Black Black
GColor9 Dark Blue Dark Slate Blue
GColor10 Orange Orange
GColor11 Purple Plum
GColor12 Dark Green Dark Green
GColor13 Dark Turquoise Dark Turquoise
GColor14 Mustard Wheat
GColor15 Gray Gray
GColor16 Brown Brown
Examples
The following is an example of using a GColornn option to override a default
color:
gddmx*GColor3: Pink
In this example, specifying the GColor3 entry in the user_id.X.DEFAULTS data set
maps the GDDM color, magenta, to the X Window System new color of pink.

Geometry option—Specify the size and location of the initial
GDDMXD graphics presentation space
Purpose
Use the Geometry option to specify the size and location of the initial GDDMXD
graphics presentation space.
Format
gddmx*Geometry: width x height + x_offset + y_offset
Parameters
width
Specifies the initial width of the GDDMXD graphics window. The width
determines the initial size of the graphics presentation space.
height
Specifies the initial height of the GDDMXD graphics window.
x_offset
Specifies the location of the upper left corner of the window where x_offset is
the horizontal offset from the upper left corner of the display.
y_offset
Specifies the location of the upper left corner of the window where y_offset is
the vertical offset from the upper left corner of the display.
Examples
The following is an example of a Geometry option:
gddmx*Geometry: 750x600+20+20

GMCPnn option—Override GDDM multicolor patterns with
workstation color names
Purpose
Use the GMCPnn option to override GDDM multicolor patterns with workstation
color names.
Format
gddmx*GMCPnn: c
Parameters
nn:
Specifies the GDDM multicolor pattern.
c Specifies the color that is used with the defined GDDM multicolor pattern.
Examples
The following is an example of a GMCPnn option:
gddmx*GMCP126: MediumBlue
In this example, the color medium blue is used when multicolor pattern 126 is
specified by the GDDM application.

HostRast option—Perform raster image processing at the
System/370 host
Purpose
Use the HostRast option to perform raster image processing at the System/370™
host.
Use the HostRast option when:

v Multiplane character symbol sets are required by the application.
v GDDM color mixing is important to the application.
The default device model for GDDMXD/MVS is an IBM 3179G with a mouse and
the raster image processing is performed at the workstation.
Format
N
gddmx*HOSTRAST:
Y
X
Parameters
N Directs GDDMXD/MVS to use the IBM 3179G as a device model. This is the
default.
Y Directs GDDMXD/MVS to use the IBM 3279 as a device model.
X Directs GDDMXD/MVS to use the IBM 3279 as a device model and expand
the pixel mapping to reduce aspect ratio distortion.
Usage
v The APL2 character set is not supported when the HostRast option is active.
v When the HostRast option is specified as Y, the GDDM application performs the
raster image processing and transmits the picture as a series of characters whose
pixel definitions have been transmitted to Programmed Symbol Sets. The picture
is mapped exactly as an IBM 3279.
v If the ratio of horizontal to vertical pixel spacing is not the same as that of an
IBM 3279, the aspect ratio can be distorted.

NewLine option—Override the default key mapping for
NewLine
Purpose
The NewLine option can be specified in the user_id.X.DEFAULTS data set to
identify which X Window System Keysym is to be mapped to the NewLine
function. This option overrides the default mapping of the Keysym XK_Return to
the NewLine function.
Format
gddmx*NewLine: keysym_name
Parameters
keysym_name
Specifies the X Window System Keysym representing the physical key. For
standard Keysyms, the XK_ prefix is not included in specifying the option.
Examples
In the following example of the NewLine option, the X Window System Keysym,
KP_Enter, is mapped to the NewLine function:
gddmx*NewLine: KP_Enter

XSync option—Request that the X Window System process
one request at a time
Purpose
The X Window System operates asynchronously. By the time an error has been
detected, more requests could have been issued by the application.
Use the XSync option to request that the X Window System process one request at
a time.
Format
N
gddmx*XSync:
Y
Parameters
N Allows the X Window System to operate asynchronously. This is the default.
Y Directs GDDMXD/MVS to cause the X Window System to operate
synchronously.
Usage
Be aware that system performance goes down when you use XSync=Y.

ZWL option—Tell GDDMXD/MVS to draw all lines using
0-width lines
Purpose
The X Window System supports a range of line widths. Because some X Window
System servers draw wide lines at a slow rate, you can use the Zero Width Lines
(ZWL) to tell GDDMXD/MVS to draw all lines using 0-width lines. The
X Window System server uses the fastest process to draw the lines. The resulting
line might not be exactly the same as if it had been drawn as a wide line.
Format
N
gddmx*ZWL:
Y
Parameters
N Directs GDDMXD/MVS not to use 0-width lines for all drawing. This is the
default.
Y Directs GDDMXD/MVS to use 0-width lines for all drawing.

Keyboard functions
The following sections detail different keyboard functions supported by
GDDMXD/MVS.
GDDMXD/MVS keyboard functions

When you enter input to the GDDM application by GDDMXD/MVS, use the
following 3270 keyboard functions.
v All alphanumeric keys
v F1 – F24
If F13–F24 are not available, use Shift + F1 to Shift + F12
v Tab or Shift + Tab
v Directional arrows
v End key to erase to the end of the field
v Insert key and Delete key
v PA1, PA2, and PA3
v Enter key
v Newline key
Note: The Backspace key is treated as a cursor left key.
If you cannot locate these keys on your workstation, see your workstation X
Window System documentation to determine the mapping of X Window System
key symbol definitions to the physical keys.
GDDMXD/MVS to X Window System keyboard functions

The following are the GDDMXD/MVS keyboard functions that translate to
X Window System key symbol definitions. Key functions not listed are not
supported.
GDDMXD/MVS keyboard function X Window System key symbol

APL2 character set toggle XK_Backspace with state Mod1Mask
Clear XK_Pause
Delete XK_Delete
Down XK_Down
End XK_End
Enter XK_Execute
Insert XK_Insert
F1 – F12 XK_F1 – XK_F12
Left XK_Left
Newline XK_Return
PA1 XK_Prior
PA2 XK_Next
PA3 XK_Home
Right XK_Right
Tab XK_Tab
Up XK_Up

APL2 character set keyboard
The APL2 character set is activated by simultaneously pressing the X Window
System XK_Backspace key (usually the Backspace key) and the State Mod1Mask
key (usually the Alt key). For example, if you use the IBM 101 Enhanced
Keyboard, the APL2 character set is toggled on and off by pressing and holding
the Alt key, and then pressing the Backspace key.
When the APL2 character set is active, the characters APL are displayed in the title
bar of the GDDMXD/MVS window.
In the X Window System, a key code is assigned to each key on the keyboard.
GDDMXD/MVS uses key codes in combination with modifier keys. For example,
the Shift and Alt keys determine the data that should be passed back from
GDDMXD/MVS to the X Window System application to identify the user’s
keystroke data.
GDDMXD looks for the data set SEZAINST(GDXALTCS) when it is initialized.

Before using GDDMXD, copy the installed TCP/IP copy of
SEZAINST(GDXALTCS) to user_id.GDXALTCS.PSS, or allocate the common
installed copy of GDXALTCS.PSS to ddname GDXDACSP.
A default map for the APL2 character set is provided in GDDMXD/MVS, which
corresponds to the IBM 101 Key Enhanced Keyboard. You can override this default
map by creating a data set called GDXAPLCS.MAP to define the map for your
workstation. When GDDMXD/MVS is initialized, the system searches for a data
set called GDXAPLCS.MAP. If the GDXAPLCS.MAP data set exists, the data in the
GDXAPLCS.MAP data set replaces the default mapping for all keys.
Setting up hlq.GDXAPLCS.MAP
The following steps describe how to set up the GDXAPLCS.MAP data set.
1. Invoke the program KEYCODE from the TCP/IP load module library in
SEZALOAD to determine the key codes for the keyboard keys.
When KEYCODE is executed from your workstation session to the host system,
the key code is displayed for each key pressed at the workstation. Therefore,
you can establish the association between a key and the character you want to
generate.
See Appendix B, “Mapping values for the APL2 character set,” on page 435 for
more information about the mapping values that are defined in the
GDXAPLCS.MAP data set.
2. Copy the hlq.GDXAPLCS.SAMPMAP installed with TCP/IP to
hlq.GDXAPLCS.MAP.
3. Edit GDXAPLCS.MAP to establish the association between the key codes in the
program KEYCODE and the character set and code values in Appendix B,
“Mapping values for the APL2 character set,” on page 435.
4. GDDMXD looks for the data set user_id.GDXDAPLCS.MAP when it is
initialized. If you want to use a different data set name, allocate the data set to
ddname GDXDACSM.

Chapter 10. Executing commands on a remote host
The Remote Execution Protocol (REXEC) and the Remote Shell Protocol (RSH) are
remote execution clients that enable you to execute a command on a remote host
and receive the results on the local host. You can execute either REXEC or RSH
from the TSO command line, the z/OS UNIX command line, or as a batch
program. When executed as a batch program, the results are stored in a data set
for later use.
To use REXEC, you must have a REXEC daemon running on the remote host. The
REXEC client passes the user name, password, and command to the REXEC
daemon. The daemon provides automatic logon and user authentication,
depending on the parameters that you set.
To use RSH, you must have a RSH daemon running on the remote host. The RSH
client passes the local user name, remote user name, and command to the RSH
daemon. The remote user name can be in the form user/password when the RSH
daemon is on an MVS host. The daemon provides automatic logon and user
authentication, depending on the parameters that you set.
This information describes how to use the REXEC and RSH clients.

v “REXEC command—Execute a command on the remote host and receive the
v “Using the NETRC data set” on page 408
v “Submitting REXEC and RSH requests in batch” on page 409
v “Using remote execution clients in a z/OS UNIX environment” on page 415
v “The z/OS UNIX orexec/rexec command—Execute a command on the remote
host” on page 417

REXEC command—Execute a command on the remote host and
receive the results on your local host
Purpose
Use the REXEC command to execute a command on the remote host and receive
the results on the local host.
Format
| REXEC
-? -b tab -d -n -l user_id
-s 512
foreign_host command
-p password -s port -t dataset_name
| Restriction: The REXEC parameters -b, -d, -l, -n, -p, -s, and -t are case sensitive
and must be entered in lowercase letters. The user_id and password parameters
might be case sensitive, depending on the operating system of the remote host.
Parameters
-? Displays the help message.
| -b tab
| Specifies the Tab setting. Valid values are in the range 1 - 12 and the default
| value is 1.
-d Activates debug tracing.
-n Prevents automatic logon, if the same foreign host name is defined in the
NETRC data set.
-l user_id
Specifies the user ID on the foreign host.
-p password
Specifies the password for the user ID on the foreign host.
-s port
Specifies the TCP port number of the REXEC server on the foreign host. The
default, 512, is the port number defined in /etc/services.
-t tran_table
Specifies the data set name of a translation table to be used. The search order
when the -t parameter is specified:
userid.tran_table.TCPXLBIN
hlq.tran_table.TCPXLBIN
If this data set is not found, REXEC terminates with message EZA4805I.
Note: If the -t parameter is not specified on the invocation of the REXEC

command, a hardcoded default table is used that is identical to the
STANDARD member in the SEZATCPX data set.
foreign_host
Specifies the name or IP address of the foreign host to which you are sending

the REXEC command. Specify the foreign host by its host name or IP address.
| When you are using IPv6 link-local addresses, you can provide scope
| information along with the host name or IP address, as described in the
| support for scope information in the z/OS Communications Server: IPv6 Network
| and Application Design Guide.
command
Specifies the command to be executed on the remote host.
Examples
Use the REXEC command without using NETRC.DATA:
READY rexec -l user28 -p user28 -s 512 mvs1 lista
MVS TCP/IP REXEC CS V1R2

SYS1.HELP
GIM.SGIMCLS0
DSN230.DSNCLIST
USER.CLIST
BUILD.CLIST
SYS1.HRFCLST
USER28.RSHD5.JOB00160.D0000103.?
Usage
v If you omit the user_id, the password, or both when entering the REXEC
command, the system prompts you to supply the parameters, if the foreign host
is not specified with a user ID password in the NETRC data set.
v When you issue a command that is to be executed on the remote host, do not
place the command in quotation marks. Doing so can result in unexpected
results.
Note: There is no such restriction when using the z/OS UNIX orexec command.
v The condition code 12 is set when an REXEC batch request encounters one of
the following error conditions:
– The client cannot connect to TCP/IP.
– The host name cannot be resolved.
– The translation table cannot be loaded.
v When REXEC issues a command to a remote system and retrieves the output for
presentation to the user, it expects a line of output to be no more than 32767
bytes. A warning message is issued when the size of the output line approaches
this threshold. This condition has no effect on the job running on the remote
host.
| v The Tab setting is used exclusively by the client and is not forwarded to the
| server. The tab setting value determines the alignment of the output. If a Tab
| character is included in the output data stream, blank characters are included in
| the output up to the next Tab setting. The processing is the same whether the
| output is displayed or written to a data set.
Chapter 10. Executing commands on a remote host 407

Using the NETRC data set
The NETRC data set provides you with an alternative to specifying the user_id
and password values as REXEC parameters. REXEC uses the following search
order to find the NETRC data set to use:
1. NETRC DD statement
2. userid.NETRC.DATA
3. tso_prefix.NETRC
4. userid.NETRC
For information about using the NETRC data set in a batch file, see “Submitting
REXEC and RSH requests in batch” on page 409.
If the password is specified on the -p parameter on the REXEC command, no

NETRC data sets are used. The keywords machine, login, and password must be
specified in lowercase. The user ID and password might be case sensitive and if
supplied in the incorrect case, failures might occur when connecting to a REXEC
server. Contact the administrator of the server’s system if you are uncertain which
case should be used.
| The hostname value that is specified after the machine keyword can include scope
| information, as described in the support for scope information in the z/OS
| Communications Server: IPv6 Network and Application Design Guide.
| Guideline: If either hostname%scope or IPv6_address%scope is specified as the

| foreign_host command parameter, there must be an entry in the NETRC data set
| that contains a string identical to the value that follows the machine keyword so
| that the correct user ID and password values are selected.
The following is the format of the NETRC data set:

machine hostname login user_id password password
Note: You can omit your password in the NETRC data set. If you do, the REXEC
command prompts you for your current password.
The following is an example of a NETRC data set:

machine mvs1 login user28 password abcdef
The following is a sample of the response that is displayed as a result of using the
REXEC command and the NETRC data set.
READY rexec mvs1 lista
MVS TCP/IP REXEC CS V1R2
SYS1.HELP
GIM.SGIMCLS0
DSN230.DSNCLIST
USER.CLIST
BUILD.CLIST
SYS1.HRFCLST
USER28.RSHD5.JOB00161.D0000103.?

Submitting REXEC and RSH requests in batch
You usually run REXEC and RSH interactively by entering the command and then
receiving the results at your terminal. However, you can also run REXEC and RSH
as a batch job. To accomplish this, you must supply the necessary job control
language (JCL) and submit it to the job entry subsystem (JES) using the TSO
SUBMIT command.
The command format when submitted as a batch job is the same as the command
format described in “REXEC command—Execute a command on the remote host
and receive the results on your local host” on page 406. You enter the command as
a parameter on the EXEC statement. The results of the command executed on the
remote host are stored on the local host according to how you define the
SYSPRINT DD statement. The data set characteristics should be consistent with the
output from the command you are executing at the remote host.
When you invoke the REXEC command, a check is made to see if a data set is
allocated to INPUT. If a data set is allocated, any input is read from that data set
rather than from your terminal. Similarly, a check is made to see if data set is
allocated to OUTPUT. If so, all REXEC output is written to that data set rather
than to your terminal.
The REXECD or RSH server does not support output being returned to output DD
statements other than SYSTSPRT, SYSPRINT or OUTPUT. Sometimes it is necessary
to direct the output from a REXEC or RSH batch request to an OUTPUT DD and
to include a SYSPRINT DD with SYSOUT=* specified. This is particularly true if
the REXEC or RSH command to be executed contains a slash(/).
There might be times when REXEC and RSH are being executed and the user does
not want the output to be directed to the SYSPRINT DD file. If a //OUTPUT DD
card is coded, output will be directed to it. This DD statement must be directed to
a SYSOUT or a validly defined data set. If multiple REXEC or RSH commands are
being executed in one step, then it is recommended that DISP=MOD be coded on
the //OUTPUT DD card. This will allow each command execution to be appended
to the previous output. If the //OUTPUT DD card specifies a nullfile (ie.
DSN=NULLFILE or DD DUMMY), then the //OUTPUT DD statement will not be
used. Regardless of which ddname you use for the REXEC or RSH output, a new
data set must have the DCB=(...) parameter specified on the DD card. Any data set
you use must have a logical record length (LRECL) greater than 0. If the LRECL is
equal to 0 then the data set is not used.
When using the REXECD server, the procedure specified in the TSOPROC
argument of the startup procedure must have the //SYSTSPRT DD statement
appearing before any other output DD specifications in the procedure. For
example, if the batch procedure specified was TSOPROC=TESTJOB, the following
example would be the correct specification for the batch procedure for REXECD:
//TESTJOB EXEC PGM=IKJEFT01,REGION=4M,DYNAM=30,REGION=4M
//STEPLIB DD DSN=A.LOADLIB,DISP=SHR
//SYSTSPRT DD SYSOUT=*
Adding a PARM argument to the EXEC JCL DD statement for commands to be

submitted to batch might cause unpredictable output, characters to be lost, or
output to be presented out of order.

If DDs are dynamically allocated, the order of output returned might be
unpredictable. For example, the following TSO/E CLIST were invoked as the
remote execution command, using the procedure TESTJOB:
PROC 0
TIME
ALLOC FI(OUT) SYSOUT(*)
OPENFILE OUT OUTPUT
SET &OUT = &STR(THIS; IS THE FIRST LINE)
PUTFILE OUT
SET &OUT = &STR(THIS; IS THE SECOND LINE)
PUTFILE OUT
TIME
SET &OUT = &STR(THIS; IS THE LAST LINE)
PUTFILE OUT
CLOSFILE OUT
FREE FI(OUT)
EXIT
In this case, the output might be returned as:

THIS IS THE FIRST LINE
THIS IS THE SECOND LINE
THIS IS THE LAST LINE
output from time
output from time
In the following example, the TESTJOB procedure was modified to add the OUT
DD statement:
//TESTJOB EXEC PGM=IKJEFT01,REGION=4M,DYNAM=30,REGION=4M
//STEPLIB DD DSN=A.LOADLIB,DISP=SHR
//SYSTSPRT DD SYSOUT=*
//OUT DD SYSOUT=*
The CLIST was also modified, as in the following example (notice that the ALLOC
FI(OUT) and the FREE FI(OUT) have been removed):
PROC 0
TIME
OPENFILE OUT OUTPUT
SET &OUT = &STR(THIS; IS THE FIRST LINE)
PUTFILE OUT
SET &OUT = &STR(THIS; IS THE SECOND LINE)
PUTFILE OUT
TIME
SET &OUT = &STR(THIS; IS THE LAST LINE)
PUTFILE OUT
CLOSFILE OUT
EXIT
The output appears as in the following example:

output from time
output from time
THIS IS THE FIRST LINE
THIS IS THE SECOND LINE
THIS IS THE LAST LINE
Be aware that output being returned to the client from DDs other than SYSTSPRT
or SYSPRINT might have characters truncated. This behavior has been observed
only in the first line of new output files other than SYSTSPRT or SYSPRINT. If you
use DDs other than SYSTSPRT or SYSPRINT, you might want to ensure that the
first line of the output file contains a blank line, so that no data is lost.

Notes:
1. You can also use the NETRC data set name described in “Using the NETRC
data set” on page 408 to specify the user ID and password. You can override
the NETRC data set search order by specifying a NETRC DD statement in the
batch job. The NETRC DD statement identifies the NETRC data set to be used.
You must provide all REXEC command information by using the NETRC data
set and the PARM keyword on the EXEC statement.
2. Submitting a long running command can cause the REXEC program to end
abnormally with a 522 system abend code. This can be avoided by specifying
TIME=1440 on the EXEC statement of the JCL you submit. Job step timing is
suppressed, including the collection of SMF job time accounting information.
3. If the command to be executed on the remote host contains a slash (/), you
must use a preceding slash (/) in the input stream of the NETRC data set or
the PARM.
Following is an example of invoking the RSH program in batch and executing
the command:
LS ./bin/temp/*
//RSHBATCH EXEC PGM=RSH,
// PARM=’/-l userid hostname ls ./bin/temp/*’
4. A condition code of 12 will be set when an REXEC batch request encounters
one of the following error conditions:
v The client cannot connect to TCP/IP.
v The host name cannot be resolved.
v The translation table cannot be loaded.
5. A condition code of 12 will be set when an RSH batch request encounters an
error condition in which the client cannot connect to TCP/IP or when the host
name cannot be resolved.
The following example shows REXEC JCL Spooling Output to JES:

//REXEC JOB USERID,MSGLEVEL=(1,1),NOTIFY=USERID
//STP1 EXEC PGM=REXEC,REGION=512K,
// PARM=’-l userid -p password foreign_host command’
Note: The data set containing the JCL cannot have sequence numbers.
The following example shows the use of the userid.NETRC.DATA containing the
user ID and password. The output is sent to a permanent data set for later use.
// PARM=’foreign_host command’
//SYSPRINT DD DSN=USERID.REXEC.SYSPRINT,DISP=(NEW,CATLG),
// UNIT=3380,VOL=SER=MYVOL
Note: When running REXEC in batch, the user ID assigned to the job is used as
the user_id in the NETRC data set.
The following example shows the use of the NETRC DD statement in batch. The
NETRC DD statement can be used in batch to override the default
userid.NETRC.DATA or userid.NETRC files.

// PARM=’foreign_host command’
//NETRC DD DSN=TST.REXEC.NETRC,DISP=SHR
Note: The user ID and password are retrieved from TST.REXEC.NETRC instead of
userid.NETRC.DATA or userid.NETRC.

RSH command—Execute a command on a remote host and
receive the results on your local host
Purpose
The Remote Shell Protocol (RSH) is a remote execution client similar to REXEC
that enables you to execute a command on a remote host and receive the results on
your local host.
You can use the RSH command from TSO or as a batch job.
Format
| -s 514
RSH
-? -b tab -d -l user/password -s port
Notes:
1. The parameters for the RSH command could be case sensitive, depending on
the remote host you are targeting.
| 2. The RSH command uses the MESSAGECASE setting in the TCPIP.DATA file to
| determine whether messages are issued in uppercase or mixed case characters.
Parameters
-? Lists the valid parameters for the RSH command.
| -b tab
| Specifies the Tab setting. Valid values are in the range 1 - 12. The default value
| is 1.
-d Turns on debug tracing.
-l user/password
Specifies the remote user ID and password.
You must enter the slash (/) between the user ID and password if the target
system is MVS. The character you must use can vary, depending on the target
host. For VM hosts, you should use an @ character.
-s port
Specifies the server port. The default is 514.
foreign_host
| Specifies the name or IP address of the remote host on which you are issuing
| the command. When you are using IPv6 link-local addresses, you can provide
| scope information along with the name or IP address, as described in the
| support for scope information in the z/OS Communications Server: IPv6 Network
| and Application Design Guide.
command
Specifies the command to be executed on the remote host.

Examples
v Execute a command on a remote host and receive the results on your local host:
READY
rsh -l user28/user28 mvs1 lista
SYS1.HELP
BUILD.HELP
GIM.SGIMCLS0
ISR.V3R5M0.ISRCLIB
DSN230.DSNCLIST
DSN230.NEW.DSNCLIST
DSN230.DSNAMACS
USER.CLIST
BUILD.CLIST
SYS1.HRFCLST
ISP.V3R5M0.ISPEXEC
READY
v Use JCL to submit the RSH command as a batch job:

//USER28 JOB ,CARTER,MSGLEVEL=(1,1),NOTIFY=USER28
//RSH31 EXEC PGM=RSH,
// REGION=800K,
// PARM=’/-d -l user28/user28 mvs1 lista’
//SYSTCPD DD DSN=USER28.TCPIP.DATA,DISP=SHR
//SYSIN DD DUMMY
Usage
v You must enter the required parameters on the command line. The RSH
command does not prompt you for missing parameters, or enable you to use the
NETRC.DATA set.
v A condition code 12 is set when an RSH batch request encounters an error
condition in which the client cannot connect to TCP/IP or when the host name
cannot be resolved.
v When RSH issues a command to a remote system and retrieves the output for
presentation to the user, it expects a line of output to be no more than 32767
bytes. A warning message is issued when the size of the output line approaches
this threshold. This condition has no effect on the job running on the remote
host.
| v The tab setting is used exclusively by the client and is not forwarded to the
| server. The tab setting value determines the alignment of the output. If a tab
| character is included in the output data stream, blank characters are included in
| the output up to the next tab setting. The processing is the same whether the
| output is displayed or written to a data set.

RHOSTS.DATA data set
The user_id.RHOSTS.DATA data set provides you with an alternative to specifying
RSH parameters user_id and password when you invoke the RSH command.
The user_id.RHOSTS.DATA data set contains one or more entries. Each entry
consists of two parts, a fully qualified name of a local host and a local userid
associated with that local host. The local userid is case sensitive.
The user ID specified in user_id.RHOSTS.DATA can be either the user ID you

would otherwise specify as an RSH parameter or your logon ID on your local host.
If your user ID is the same at both the local and remote hosts, use this common ID
to create RHOSTS.DATA. In this case, you do not need to include the
user_id/password parameter on the RSH command, as shown in the following
example:
rsh mvsone lista
If your user ID at the remote host is different from your user ID at the local host,
use the user ID of the remote host to create RHOSTS.DATA. In this case, you can
invoke the RSH command without the password, as follows:
rsh -l user28 mvsone lista
If you do not create the RHOSTS.DATA data set on the remote host, you must
specify both the user ID and the password with the RSH command, as shown in
the following example:
rsh -l user28/abcdef mvsone lista
The host names in the following examples are the official, fully qualified names of
local hosts from which you want to run RSH. The user IDs are the logon IDs for
those local hosts. Nicknames are not allowed.
local.host.name user_id
mvsthree.raleigh.ibm.com user30
mvsthree.raleigh.ibm.com user31
mvstfour.raleigh.ibm.com user30
| Tip: The RSH server code obtains the remote host name by resolving the remote IP
| address into a host name. If the remote host connects using a link-local address,
| then the remote host name that is generated by the resolver can have the format
| hostname%scope. Adding scope information to the appropriate RHOSTS.DATA
| remote host definitions results in a more efficient search for a matching remote
| host name. See the support for scope information in the z/OS Communications
| Server: IPv6 Network and Application Design Guide for details about including scope
| information on configured host names.
Using remote execution clients in a z/OS UNIX environment

z/OS UNIX Remote Execution Protocol (z/OS UNIX REXEC) is a remote execution
client that you can use to execute a command on a remote host and receive the
results on the local host. z/OS UNIX RSH is also available as a remote execution
client.
You must have the z/OS UNIX REXEC daemon (orexecd) running on the remote
host to use z/OS UNIX REXEC to run z/OS UNIX commands. The z/OS UNIX
REXEC client passes the user name, password, and command to the z/OS UNIX

REXEC daemon. The daemon provides automatic logon and user authentication,
You do not have to have the z/OS UNIX REXEC deamon (orexecd) running on the
remote host if you are not running z/OS UNIX commands. The z/OS UNIX
REXEC client can use any REXEC daemon (not just z/OS UNIX).
You must have the z/OS UNIX RSH daemon (orshd) running on the remote host
to use z/OS UNIX RSH to run z/OS UNIX commands. The z/OS UNIX RSH
client passes the user name, password, and command to the z/OS UNIX RSH
daemon. The daemon provides automatic logon and user authentication,
You do not have to have the z/OS UNIX RSH deamon (orshd) running on the
remote host if you are not running z/OS UNIX commands. The z/OS UNIX RSH
client can use any RSH daemon (not just z/OS UNIX).

The z/OS UNIX orexec/rexec command—Execute a command
on the remote host
Purpose
Use the z/OS UNIX orexec/rexec command to execute a command on the remote
host and receive the results on the local host.
Notes:
1. The rexec command is a synonym for the orexec command in the z/OS UNIX
shell. The rexec command syntax is the same as that for the orexec command.
2. If the -s parameter is not used to specify the port, the port to be used by the
client must be defined in the /etc/services file as an exec entry defined to TCP.
For information on /etc/services, Protocol Number and Port Assignments, see the
Format
-s port
orexec
-? -d -l user_id -p password -s port
-C -V
Note: Enter the orexec parameters -d, -l, -p, and -s in lowercase letters because
they are case sensitive. The user_id and password parameters can be case
sensitive, depending on the operating system of the remote host.
Parameters
-l user_id
Specifies the user ID on the foreign host.
| -p password
| Specifies the password for the user ID on the foreign host.
-s port
Specifies the TCP port number of the rexec server on the foreign host. The
default is the port number defined in /etc/services.
| -C Forces messages to be displayed in uppercase characters.
| -V Displays the z/OS Communications Server version and release.
foreign_host
the orexec command. Specify the foreign host by its host name or IP address.
| When using IPv6 link-local addresses, scope information can be provided
| along with the name or IP address, as described in the s upport for scope
| information in the z/OS Communications Server: IPv6 Network and Application
| Design Guide.
command
Specifies the command that is sent to the foreign host. The command is
composed of one or more words. Coding is assigned after checking the

prefixed parameters (-l, -p, -s) and assigning the remaining string as the
command. The command you specify must not require a response from you to
complete. The orexec command cannot interact with you after you enter data
in the command format.
Examples
Use the orexec command to execute a command on a remote host:
orexec -l user28 -s 512 mvs1 lista
SYS1.HELP
GIM.SGIMCLS0
DSN230.DSNCLIST
USER.CLIST
BUILD.CLIST
SYS1.HRFCLST
USER28.ORSHD5.JOB00160.D0000103.?
.

The z/OS UNIX orsh/rsh Command—Execute a Command on
the remote host
Purpose
Use the z/OS UNIX orsh/rsh command to execute a command on the remote host
and receive the results on the local host.
Notes:
1. The rsh command is a synonym for the orsh command in the z/OS UNIX
shell. The rsh command syntax is the same as the orsh command syntax.
2. If the -s parameter is not used to specify the port, the port to be used by the
client must be defined in the /etc/services file as a shell entry defined to TCP. For
information about /etc/services, Protocol Number, and Port Assignments, see the
Format
-s port
orsh
-? -d -l user_id/password -s port
Note: Enter the orsh parameters -d, -l, and -s in lowercase letters because they are
case sensitive. The user_id/password parameter can be case sensitive,
depending on the operating system of the remote host.
Parameters
-l user_id/password
Specifies the user ID and password. You must enter the slash (/) between the
user ID and password if the target system is MVS. The character you must use
can vary, depending on the target host. For VM hosts, you should use an @
character.
-s port
Specifies the TCP port number of the rsh server on the foreign host. The
default is the port number defined in /etc/services.
foreign_host
the orsh command. Specify the foreign host by its host name or IP address.
| When using IPv6 link-local addresses, scope information can be provided
| along with the name or IP address, as described in the support for scope
| information in the z/OS Communications Server: IPv6 Network and Application
| Design Guide.
command
Specifies the command that is sent to the foreign host. The command is
composed of one or more words. Coding is assigned after checking the
prefixed parameters (-l or -s) and assigning the remaining string as the

command. The command you specify must not require a response from you to
complete. The orsh commnd cannot interact with you after you enter data in
the command format.
Examples
Use the orsh command to execute a command on a remote host:
orsh -l user28/password -s 512 mvs1 lista
SYS1.HELP
GIM.SGIMCLS0
DSN230.DSNCLIST
USER.CLIST
BUILD.CLIST
SYS1.HRFCLST
USER28.ORSHD5.JOB00160.D0000103.?
.
Usage
Enter the required parameters on the command line. The orsh command does not
prompt you for missing parameters.

Chapter 11. Using the Network Database System
This topic describes the Network Database System (NDB), that is used to access
relational database systems in a TCP/IP environment.
The Network Database System enables:

v Workstation or mainframe users to issue Structured Query Language (SQL)
statements interactively
v Database sharing between computers with different system architectures and
operating systems
The NDB client command enables you to issue SQL statements that you can enter
directly from the client machine to query or access data from a DB2 subsystem.
You can use the NDBCLNT command from the following environments:
v DOS
v MVS
v AIX on RS/6000®
v UNIX on Sun Microsystems
v VM

v “NDBCLNT command—Issue SQL statements to a DB2 subsystem” on page 422
v “SQL statements” on page 425
v “NDB commands” on page 425
v “Return codes for NDB” on page 425
v “Format of output displayed on the client” on page 428

NDBCLNT command—Issue SQL statements to a DB2 subsystem
Purpose
Use the NDBCLNT command to issue SQL statements to a DB2 subsystem.
Note: The SQL statement that you want to enter is not part of the NDBCLNT
command. You enter your SQL statement after the NDBC prompt message is
displayed.
Format
NDBCLNT
-h host_name -u userid -p password

-d DB2_subsystem -o output_file -s -l -c
-o output_file
Parameters
-h host_name
Specifies the host on which the DB2 subsystem resides. host_name must be
IPv4. You are prompted for a name if you do not enter one.
Note: For the NDBCLNT command, substituting the IP address for host_name
is accepted only if doing so is supported by the remote procedure call
(RPC) implementation of the TCP/IP product running on the client
machine.
-u userid
Specifies the host user ID to be used to access the DB2 system. You are
prompted for an ID if you do not enter one.
-p password
Specifies the password for the TSO userid. You are prompted for a password if
you do not enter one.
Note: If you enter your password from the command line as part of the
NDBCLNT invocation, the password is displayed. If you do not enter
your password as part of the invocation, you are prompted for the
password and the password is not echoed to the screen.
-d DB2_subsystem
Specifies the name of the DB2 subsystem to be accessed for this NDB session.
You are prompted for a DB2 subsystem name if you do not enter one.
-o output_file
Specifies the file that stores the SQL statement result. Ensure that you use the
correct naming convention for the system being used. This option is required if
you specify the -s option.
-s Prevents output from being displayed on the terminal. If you do not specify
the -o option, it is assumed, and you are prompted for the name of the output
file.

-l Write listing of NDB session to output file, if one is specified. This includes the
SQL statement and the outcome of that SQL statement. If no output file is
specified, this option is ignored.
-c Specifies that the output from an SQL statement should be sent as one
continuous stream. The default is to have only one buffer of data at a time
displayed (enter the word continue to get the next buffer of data).
Examples
ndbclnt -h mvs1 -d db2a -u user1 -p user1
Port server has allocated NDB Prog: 536870945.

NDBC: create table empinfo (empno int,name char(15),salary dec(8,2),hiredate date)
SQL statement completed successfully
NDBC: insert into empinfo values (10001, ’Andersen’, 23456.78,’01/02/1983’)

1 rows were affected by this SQL statement
NDBC: insert into empinfo values (10204,’Jones’,25890.21,’02/01/1983’)

NDBC: insert into empinfo values (10997,’Smith’,27654.32,CURRENT DATE)

NDBC: commit
NDBC: select * from empinfo

10001 Andersen 23456.78 1983-01-02
10204 Jones 25890.21 1983-02-01
10997 Smith 27654.32 1994-07-25
NDBC: update empinfo set salary = salary * 1.50


10001 Andersen 35185.17 1983-01-02
10204 Jones 38835.31 1983-02-01
10997 Smith 41481.48 1994-07-25
NDBC: rollback

10001 Andersen 23456.78 1983-01-02
10204 Jones 25890.21 1983-02-01
10997 Smith 27654.32 1994-07-25
NDBC: drop table empinfo

NDBC: end
Usage
v If you specify more than once any of the NDB invocation options that require a
parameter (for example, -h, -u, -p, -d, -o), the last occurrence is the one used by
the NDB client code.
v The NDBCLNT command format and parameter descriptions are displayed
when you specify any of the following:
– No parameters
– No valid parameters
v After entering the NDBCLNT command, you are prompted by the NDBC: prompt
for either an SQL statement or an NDB command.
Chapter 11. Using the Network Database System 423

v The reply buffer used by the NDB clients and servers is 8192 bytes. The size of
the reply buffer can be reset by changing the value of the definition
NDB_REPLY_LENGTH at the beginning of the NDBCLT.C program of the sample
client code, and then recompiling the NDB client.

SQL statements
NDB accepts SQL statements up to 2048 characters long. NDB supports all SQL
statements that DB2 allows to be interactively or dynamically prepared along with
the SELECT statement.
If you are using NDBCLNT with an operating system that supports redirected
input from a file, you must ensure that the last statement in the file is the NDB
command END. See the user’s guide or online help facility for your workstation
operating system for more information about using redirected input.
NDB commands
The NDB commands are as follows:
Command Description
continue Requests additional buffers of data when the SQL query returns more than
one buffer of data.
end Ends the NDB client session. END causes an implicit SQL commit work to
take place. All changes made since the last commit or rollback (or since the
beginning of the session if no commits or rollbacks were issued) become
permanent.
eexit Emergency use only. Certain errors can cause the NDB client to be unable
to continue processing NDB commands or SQL statements, including the
NDB END command. These error conditions result in the same or other
error conditions continually being reported by the NDB client. If this
happens, issue the NDB emergency exit command (EEXIT) to immediately
exit. Note that using (EEXIT) does not allow the DB2 thread to terminate.
This will cause the database resources ( for example, locks and buffers) to
continue to be held. The NDB server and the port that the NDB client is
currently using will also continue to be held until the address space
containing this NDB server has been cancelled and restarted.
Return codes for NDB

The valid NDB return codes and messages are:
Code Message
1 Problem with RPC.
Look at the error messages displayed before this one. See the Remote
Procedure Call (RPC) messages and codes information for the client
platform from which you are running the NDB client.
-20000 RPC error. Unable to call the server.
The NDB sample client code detected that the NDB client was unable to
successfully send the SQL statement or NDB command to the NDB server
and to receive a response.
NDB uses RPC to handle requests between NDB clients and servers. Look
at the error messages and RPC information that was displayed before this
error. See the RPC messages and codes information for the client platform
from which you are running the NDB client.

Code Message
-20100 Invalid NDBC control block. Reason: <string>
The NDB server detected that the NDBC control block, used for
communication between an NDB client and its assigned NDB Server,
contained an incorrect value.
Listed below are the possible reasons why the error occurred:
v NDB version numbers do not match.
The version number in the client code must match the version number in
the server code. The NDB sample client code sets a field in the control
block NDBC called ndbver to indicate the current version of the NDB
client. The NDB server also contains a version number in its code.
For TCP/IP for MVS 3.1, the version value is 2. For all previous releases
of TCP/IP for MVS, the version value is 1. Since the version value for
NDB changes when the NDBC control block is changed, one level
(version, release, and modification) of NDB for TCP/IP for MVS might
not be compatible with another.
v NDB release numbers do not match.
The release number in the client code must match the release number in
the server code. The NDB sample client code sets a field in the control
block NDBC called ndbrel to indicate the current release of the NDB
client. The NDB server also contains a release number in its code.
For TCP/IP for MVS 3.1 and all previous releases, the release value is 1.
Since the version value for NDB changes when the NDBC control block
is changed, one level (version, release and modification) of NDB for
TCP/IP for MVS might remain compatible with another, but there are
differences in the control block field values that affect NDB server
processing.
v Eyecatcher is not for NDBC control block.
The NDB sample client code sets a field in the control block NDBC called
ndbcb to indicate the eyecatcher of the main control block being used by
the NDB client. The NDB server looks for this eyecatcher before
processing information contained in the control block.
For TCP/IP for MVS 3.1 and all previous releases, the control block
eyecatcher is NDBC.
v NDB Server name is unrecognized.
The NDB sample client code sets a field in the control block NDBC called
ndbsname to indicate the NDB server name by which the NDB client code
knows the NDB server. The NDB server did not find a recognized name
in the ndbsname field of the NDBC control block. For TCP/IP for MVS 3.1
and all previous releases, the NDB server name is netdbsrv.
Fix the NDBC control block field that is causing the error and rebuild the
NDB client.
-20101 You (or PUBLIC) do not have authority to run DB2 plan EZAND320.
For NDB to access data stored in DB2, the DBUITIL2 application program
that acts as interface code was stored in DB2. DBUTIL2 is in the form of a
DB2 plan name EZAND320. To use NDB (which uses the EZAND320), you
must be granted execute authority for EZAND320 by your database
administrator. This authority can be granted to your specific user ID or to
everyone by granting it to PUBLIC.

Code Message
-20102 DB2 Subsystem is unavailable. DB2 is not active at OPEN DB.
The NDB server detected that the DB2 subsystem specified at NDB server
startup was not running at the time the NDB server tried to establish a
connection with DB2. Contact your system programmer.
-20103 Error occurred while using DB2 CAF.
An error occurred when the NDB server used the DB2 Call Attachment
Facility (CAF) to establish a connection with DB2. Contact your system
programmer.
-20104 Error occurred while trying to allocate storage.
An error occurred when the NDB server allocated storage for a data
structure used by DB2 or for an internal buffer. Contact your system
programmer.
-20105 Single row of query data is larger than reply buffer.
The length of one row of data to be returned from the current query was
greater than the length of the NDB reply buffer (size of which is specified
in the NDBC field NDBRPDLN). You can take either of the following
actions:
v Retrieve fewer columns per query either by issuing multiple queries or
by making the query more restrictive in the number of columns
requested.
v Increase the size of the NDB reply buffer by changing the define
compiler directive for NDB_REPLY_LENGTH in the program NDBCLT.C
and rebuilding the NDB client.
-20108 Host userid or password not valid.
The NDB server has detected that the host user ID or host password did
not pass the security check on the host system. Enter a valid user ID and
password combination.
-20999 Should never occur error has occurred.
During the execution of NDB server code, a programming error occurred.

Contact your system programmer.
+xxx Positive return codes, other than +25, are informational and warning codes
from DB2.
-xxx Negative return codes between -001 and -999 or that are less than or equal
to -30000 are from DB2.
See z/OS Communications Server: IP and SNA Codes for more information about
TCP/IP return codes. See DB2 Messages and Codes for more information about DB2
return codes.

Format of output displayed on the client
The output from an SQL query (SELECT) is presented in row and column format.
The NDB Server distinguishes between a null value that is retrieved from a table
in DB2 and a null value that is the result of an arithmetic error in the SQL SELECT
statement (for example, division by 0). A null data value is represented by dashes
(------), while a null value due to an arithmetic error is represented by slashes
(//////).
For more information on null values, see the DB2 Application Programming and SQL
Guide.
NDB supports the following SQL data types:
Data type Description

DECIMAL All formats supported by DB2
FLOAT Single and double precision
INTEGER Long, or fullword, integer
SMALLINT Short, or halfword, integer
CHAR Fixed length, up to 254 characters
VARCHAR Variable length, up to 254 characters
VARCHAR Long variable length, over 254 characters
DATE All formats supported by DB2
TIME All formats supported by DB2
TIMESTAMP All formats supported by DB2
For unsupported SQL data types, values are replaced with asterisks (******) unless
the value is null. If the value is null, it is represented as previously described. See
the DB2 SQL Reference for information about SQL data types.

Appendix A. Specifying data sets and files
This topic describes the file-naming formats for the following operating systems:
v “MVS data sets”
v “AIX and UNIX files” on page 433
v “AS/400 operating system” on page 433
v “VM files” on page 434
Examples of each format are provided to show how the files appear to a TCP/IP
user who is logged on to the different operating systems.
MVS data sets

FTP subcommands can require a data set or file name. The format used to name a
data set depends on the host system. Some systems limit the length of a data set
name, and some systems are case sensitive.
For information about the //DD file name syntax for FTP, see “ddname support”
on page 65.
Data set names in MVS consist of one or more names, called qualifiers, each from
one to eight characters long, that are delimited from one another by periods.
The leftmost qualifier in the data set name is the high-level qualifier. The rightmost
qualifier in the data set name is the low-level qualifier. Partitioned data sets can be
further qualified with a member name in the rightmost position. Qualifiers lying
between them are called intermediate-level qualifiers.
For example, in the data set name dog.bulldog.winston, dog is the high-level
qualifier, bulldog is the intermediate-level qualifier, and winston is the low-level
qualifier.
Specify TSO sequential data sets in the following format:
llev_qual
hlev_qual. llev_qual.
Specify TSO partitioned data sets in the following format:
membername
(membername)
hlev_qual. llev_qual.
hlev_qual
Specifies the high-level qualifier of the data set. The default is the current
working directory. If you specify this parameter, the complete data set name
must be enclosed within single quotation marks (’).

llev_qual
Specifies the low-level qualifier of the data set. You must specify this qualifier
for sequential data sets.
membername
Specifies the member name of a partitioned data set (PDS). You must include
parentheses around membername only when you also specify llev_qual or
hlev_qual.
Sequential data sets

A sequential data set is a single file that can be allocated with any record length
specified. The naming requirements for a sequential data set on an MVS host are
minimal, and most of the requirements apply to any data set name under MVS.
The naming requirements for a sequential data set are:

v No part of the name can start with a numeric.
v No part of the name can be more than 8 characters in length.
v Each part of the name is separated by a period.
v A sequential data set name can have a minimum of 2 and a maximum of 44
characters.
v If single quotation marks (’) are not used when specifying the data set name, the
MVS system appends the current working directory as the first part of the name.
The following examples show the naming conventions for sequential data sets on
an MVS host.
To access the sequential data set KC00852.SEQ.NAMES, the user, with the current
working directory KC00852, enters one of the following:
v ’KC00852.SEQ.NAMES’
v SEQ.NAMES
Either of these formats is acceptable for accessing a sequential data set.
Partitioned data sets

A partitioned data set (PDS) is a group of files contained in a library. The
individual files that make up a PDS are called members. You can access an entire
PDS or any individual member of a PDS.
The naming requirements for a partitioned data set are:

v No part of the name can start with a numeric.
v No part of the name can be more than eight characters in length.
v Each part of the name is separated by a period.
v If single quotation marks are not used when specifying the PDS name, the MVS
system appends the current working directory as the first part of the name.
The difference between a sequential and partitioned data set specification is that
the partitioned data set user accesses the directory of members in the PDS, and the
sequential data set user accesses an individual file.
The following examples show the naming conventions for partitioned data sets on
an MVS host.

To access the partitioned data set KC00852.PDS.NAMES, the user, with the current
working directory ‘KC00852’, enters one of the following:
v ’KC00852.PDS.NAMES’
v PDS.NAMES
Either of these formats is acceptable to access a partitioned data set.
Note: You can use the special character asterisk (*) as a global name character
(wildcard) for pattern matching when you specify a data set name, with the
following restrictions:
v The asterisk must be the last character, or the only character specified for
a level of qualifier.
v When the data set name is enclosed in quotation marks, you cannot use
the asterisk as a wildcard in the high-level qualifier of the data set name.
Data set names not enclosed in quotation marks will use the setting of the
current directory as the high-level qualifier.
v You can use the asterisk more than once in the complete data set name,
but the asterisk must be the last character for each level of data set name
qualifier.
v If you specify a member name, you cannot use an asterisk anywhere in
the data set name.
v If you use an asterisk as all or part of the member name, you cannot use
an asterisk anywhere else in the data set name.
To access an individual member of a PDS, the member name is entered in

parentheses.
To access the member PROPER in the PDS KC00852.PDS.NAMES, the user, with the
current working directory KC00852, enters one of the following:
v ’KC00852.PDS.NAMES(PROPER)’
v PDS.NAMES(PROPER)
Either of these formats is acceptable to access an individual member of a

partitioned data set.
Transferring data between partitioned and sequential data sets

When transferring data between partitioned and sequential data sets, ensure that
the local_file and foreign_file parameters of the FTP subcommands are compatible
with the type of data set you are transferring to or from. For example, if your local
working directory is a partitioned data set and you want to GET the sequential file
TEST.FILE1, you cannot issue the subcommand GET TEST.FILE1 to retrieve the
file, because this subcommand by default tries to use the local PDS member name
TEST.FILE1, which is not a valid member name.
To keep the local and remote file names compatible with the type of data set used,
do one of the following:
v Specify both the local and remote file names
For example:
GET TEST.FILE TESTFL1
PUT TESTPDS(FILE1) FILE1
v Change the directory to the lowest level qualifier.
For example, to transfer between the PDS ‘USER14.TESTPDS(NAME1)’ and the
sequential data set ‘USER17.SEQ.NAME1’, do the follwoing:
Appendix A. Specifying data sets and files 431

1. Change the local directory (LCD) to ‘USER14.TESTPDS’
2. Change the directory (CD) to ‘USER17.SEQ’
3. Enter one of the following:
– GET NAME1 to get ‘USER17.SEQ.NAME1’ as ‘USER14.TESTPDS(NAME1)’
– PUT NAME1 to put ‘USER14.TESTPDS(NAME1)’ as ‘USER17.SEQ.NAME1’
Data transfer methods

You must use the appropriate transmission attributes to preserve the content and
structure of the data when you transfer data sets or files between two hosts. Use
the FTP MODE subcommand to specify how the bits of data are to be transmitted,
and the FTP TYPE subcommand to define the way that data is represented during
the data transfer.
See “MOde subcommand—Set the data transfer mode” on page 242 for
information about the MODE subcommand, and “TYpe subcommand—Set the data
transfer type” on page 315 for information about the TYPE subcommand.
TCP/IP supports only the data transfer of a data set or file structured as a
continuous sequence of data bytes. This ensures that the correct record format is
preserved across MVS hosts.
Table 26 shows how to set the transmission attributes for different host systems.
IBM mainframe operating systems (VM or MVS) are identified as EBCDIC transfer
types. Systems with ASCII storage are identified as ASCII transfer types. A text file
of an ASCII transfer type contains standard, displayable characters; a carriage
return (ASCII X'0D' and EBCDIC X'15'); and line feed characters (ASCII X'0A' and
EBCDIC X'25'). A text file of an EBCDIC transfer type contains standard,
displayable characters only. A binary file can contain any characters.
Table 26. Recommended methods for data transfer
Transfer between host types Transfer type Mode
EBCDIC to EBCDIC—text data EBCDIC Stream
EBCDIC to EBCDIC—binary data EBCDIC Block
EBCDIC to ASCII—text data ASCII Stream
ASCII to EBCDIC—text data ASCII Stream
ASCII to EBCDIC—binary data Image (binary) Stream
ASCII to EBCDIC to ASCII—all data Image (binary) Stream
Note: The EBCDIC host is used for storage only. Data is not used on the EBCDIC
host.
Transferring PDS directory information

When a PDS member is transmitted in block or compressed data transfer mode
with a representation type of EBCDIC, the user data associated with the PDS
member is also transferred to the directory on the target host. This transfer occurs
only when using an MVS client. No PDS directory information is transferred if the
member is null (empty).

AIX and UNIX files
For the Advanced Interactive Executive (AIX) and UNIX operating systems, data is
stored in files. Related files are stored in a directory. z/OS Communications Server
files are UNIX files.
Specify AIX and UNIX files in the following format:
/directory/filename
directory
Specifies a directory name. Directories contain the names of files, other
directories, or both.
filename
Specifies a file name. It can be up to 14 characters long.
The complete name of an AIX and UNIX file contains the directory name and the
file name. The following is an example:
/mailfiles/cooks
Where:
mailfiles
The directory name
cooks The file name
In the AIX and UNIX operating systems, you specify the first slash (/) only when
you begin at the root directory. If you are specifying a file in the current directory,
enter only the file name. For example, if you are in the current directory mailfiles
and you want to access the cooks file, specify:
cooks
The directory name and file name can each be up to 14 characters in length. The
AIX and UNIX operating systems distinguishes between uppercase and lowercase
letters in file names.
| Tips:
| v A directory name and file name should not include characters that have a
| special meaning to the shell, such as backslash (\), ampersand (&), and period
| (.).
| v If a z/OS UNIX file name contains any single quotation marks (’), enclose the
| name in double quotation marks (″).
| v If a z/OS UNIX file name contains any double quotation marks (″), enclose the
| name in single quotation marks (’).
AS/400 operating system

For the AS/400 operating system, data is stored in files.
Specify AS/400 files in the following format:
library/file.member
Appendix A. Specifying data sets and files 433

library
A library name. Libraries contain the names of programs, files, and commands.
file.member
The file name.
In the AS/400 operating system, files can have one or more members. Each file can
consist of data records, source programs, or database definitions.
The FTP subcommand PUT is used to copy a local file member into a file at the
remote host. The following is an example:
PUT PDS.DATA(MBR1) LIB1/FILEA.MBR1
In this example, the PUT subcommand copies member MBR1 from the partitioned
data set PDS.DATA on the local host to member MBR1 of file FILEA in the library
LIB1 on the remote host. If the member already exists at the remote host, it is
overwritten.
VM files
Data is stored in files on VM hosts. Specify VM files in the following format:
filename.filetype
filename
Specifies the file name.
filetype
Specifies the file type.
Note: The file mode is not accepted by foreign VM hosts; it is taken to be the file
mode associated with the current working directory. The file mode is not
used in TCP/IP commands.
For example, if you want to specify a file named accounts with a file type cprog,
enter the following:
accounts.cprog
Where filename is accounts and filetype is cprog.
All VM file specifications are treated as if they are entered in uppercase. The file
name and the file type consist of 1 to 8 alphanumeric characters. Other valid
characters are $, #, @ (at character), + (plus), - (hyphen), and _ (underscore).
You can use the special character * (asterisk) for pattern matching.

Appendix B. Mapping values for the APL2 character set
This topic lists the GDDMXD/MVS default mapping values for the APL2 character
set. However, If the hlq.GDXAPLCS.MAP data set exists, the default mapping
values are overridden.
Each entry in the hlq.GDXAPLCS.MAP data set (alternative character set) contains
the mapping for a particular physical key that corresponds to three characters. The
characters correspond to the physical key by:
v Pressing the key alone
v Pressing the key and the Shift key simultaneously
v Pressing the key and the Alt key simultaneously
The hlq.GDXAPLCS.MAP data set entries must contain the following seven
single-byte hexadecimal values entered as EBCDIC characters:
v Value 1 is the hexadecimal keycode for the physical key.
v Values 2, 4, and 6 identify whether the character is in the primary or alternative
character set for the emulated 3179G. If the character is in the primary set, the
value is 0; if the character is in the alternative set, the value is 8.
v Values 3, 5, and 7 specify the EBCDIC code of the character in the character set.
The combination of values 2 and 3 define the bytes that describe the character
when the key corresponding to the keycode is pressed alone.
when the key corresponding to the keycode and the Shift key are pressed
simultaneously.
when the key corresponding to the keycode and the Alt key are pressed
simultaneously.
Table 27 lists the mapping values for the APL2 character set.
Table 27. Mapping values for the APL2 character set
Character name Character set EBCDIC Default keycode
value value
Quad Jot 8 73 9 + Shift
Quad Slope 8 CE 9 + Alt
1 0 F1 A
Diaeresis 8 72 A + Shift
Down Tack Up Tack 8 DA A + Alt
2 0 F2 B
Overbar 8 A0 B + Shift
Del Tilde 8 FB B + Alt
3 0 F3 C
< 0 4C C + Shift
Del Stile 8 DC C + Alt

Table 27. Mapping values for the APL2 character set (continued)
value value
4 0 F4 D
Not Greater 8 8C D + Shift
Delta Stile 8 DD D + Alt
5 0 F5 E
= 0 7E E + Shift
Circle Stile 8 CD E + Alt
6 0 F6 F
Not Less 8 AE F + Shift
Circle Slope 8 CF F + Alt
7 0 F7 10
> 0 6E 10 + Shift
Circle Bar 8 ED 10 + Alt
8 0 F8 11
Not Equal 8 BE 11 + Shift
Circle Star 8 FD 11 + Alt
9 0 F9 12
Down Caret 8 78 12 + Shift
Down Caret Tilde 8 CB 12 + Alt
0 0 F0 13
Up Caret 8 71 13 + Shift
Up Caret Tilde 8 CA 13 + Alt
+ 0 4E 14
- 0 60 14 + Shift
! 8 DB 14 + Alt
Times 8 B6 15
Divide 8 B8 15 + Shift
Quad Divide 8 EE 15 + Alt
Q 0 D8 19
? 0 6F 19 + Shift
Q Underbar 8 58 19 + Alt
W 0 E6 1A
Omega 8 B4 1A + Shift
W Underbar 8 66 1A + Alt
E 0 C5 1B
Epsilon 8 B1 1B + Shift
E Underbar 8 45 1B + Alt
R 0 D9 1C
Rho 8 B3 1C + Shift
R Underbar 8 59 1C + Alt

value value
T 0 E3 1D
Tilde 8 80 1D + Shift
T Underbar 8 63 1D + Alt
Y 0 E8 1E
Up Arrow 8 8A 1E + Shift
Y Underbar 8 68 1E + Alt
U 0 E4 1F
Down Arrow 8 8B 1F + Shift
U Underbar 8 64 1F + Alt
I 0 C9 20
Iota 8 B2 20 + Shift
I Underbar 8 49 20 + Alt
O 0 D6 21
Circle 8 9D 21 + Shift
O Underbar 8 56 21 + Alt
P 0 D7 22
Star 0 5C 22 + Shift
P Underbar 8 57 22 + Alt
Left Arrow 8 9F 23
Right Arrow 8 8F 23 + Shift
Quad Quote 8 DE 23 + Alt
Left Brk Right Brk 8 CC 24
Iota Underbar 8 74 24 + Shift
Delta Underbar 8 FC 24 + Alt
Equal Underbar 8 E1 25
Epsilon Underbar 8 E1 25 + Shift
Diaeresis Dot 8 75 25 + Alt
A 0 C1 27
Alpha 8 B0 27 + Shift
A Underbar 8 41 27 + Alt
S 0 E2 28
Up Stile 8 8D 28 + Shift
S Underbar 8 62 28 + Alt
D 0 C4 29
Down Stile 8 8E 29 + Shift
D Underbar 8 44 29 + Alt
F 0 C6 2A
Underbar 0 6D 2A + Shift
F Underbar 8 46 2A + Alt
Appendix B. Mapping values for the APL2 character set 437

value value
G 0 C7 2B
Del 8 BA 2B + Shift
G Underbar 8 47 2B + Alt
H 0 C8 2C
Delta 8 BB 2C + Shift
H Underbar 8 48 2C + Alt
J 0 D1 2D
Jot 8 AF 2D + Shift
J Underbar 8 51 2D + Alt
K 0 D2 2E
Quote 0 7D 2E + Shift
K Underbar 8 52 2E + Alt
L 0 D3 2F
Quad 8 90 2F + Shift
L Underbar 8 53 2F + Alt
Left Bracket 8 AD 30
( 0 4D 30 + Shift
Down Tack Jot 8 FE 30 + Alt
Right Bracket 8 BD 31
) 0 5D 31 + Shift
Up Tack Jot 8 EF 31 + Alt
Z 0 E9 36
Left Shoe 8 9B 36 + Shift
Z Underbar 8 69 36 + Alt
X 0 E7 37
Right Shoe 8 9A 37 + Shift
X Underbar 8 67 37 + Alt
C 0 C3 38
Up Shoe 8 AA 38 + Shift
C Underbar 8 43 38 + Alt
V 0 E5 39
Down Shoe 8 AB 39 + Shift
V Underbar 8 65 39 + Alt
B 0 C2 3A
Down Tack 8 AC 3A + Shift
B Underbar 8 42 3A + Alt
N 0 D5 3B
Up Tack 8 BC 3B + Shift
N Underbar 8 55 3B + Alt

value value
M 0 D4 3C
Stile 0 4F 3C + Shift
M Underbar 8 54 3C + Alt
, 0 6B 3D
; 0 5E 3D + Shift
Up Shoe Jot 8 DF 3D + Alt
period 0 4B 3E
: 0 7A 3E + Shift
Slope Bar 8 EB 3E + Alt
/ 0 61 3F
\ 0 E0 3F + Shift
Slash Bar 8 EA 3F + Alt
Space 0 40 45
Appendix B. Mapping values for the APL2 character set 439

Appendix C. TELNET extensions
This topic describes the Telnet 3270 DBCS Transform special operations. The
following sections are included:
v “Character set cross reference table”
v “Special key operation for TELNET” on page 443
v “Operation of PF and PA keys” on page 445
v “Sense codes for special key operation” on page 446
Character set cross reference table

Table 28 describes the language, codefiles, and character sets for the Telnet 3270
DBCS Transform extended language support.
Table 28. TCP/IP character set cross reference
Character
Keyword Codefiles Description set Description CCSID¹ CPGID²
KANJI
JIS78KJ J8EETA JIS 8 Bit English SBCS ASCII JIS X0201 8 Bit none none
J8EATE
EBCDIC English SBCS none none
J8KETA JIS 8 Bit Katakana SBCS ASCII JIS X0201 8 Bit none none
J8KATE
EBCDIC Katakana SBCS none none
JIS78ETA JIS 1978 Kanji DBCS ASCII JIS X0208 1978 00955 00955
JIS78ATE
EBCDIC Japanese Host DBCS 00300 00300
JIS83KJ J8EETA JIS 8 Bit English SBCSI ASCIII JIS X0201 8 Bit none none
J8EATE
EBCDIC English SBCS none none
J8KETA JIS 8 Bit Katakana SBCS ASCII JIS X0201 8 Bit none none
J8KATE
EBCDIC Katakana none none
SBCS
JIS83ETA JIS 1983 Kanji DBCS ASCII JIS X0208 1990 00952 00952
JIS83ATE
SJISKANJI A8EETA 8 Bit English SBCS ASCII ISO/ANSI Multilingual 00819 00819
A8EATE ASCII
EBCDIC Japanese Latin Host 01027 01027
SBCS
A8KETA 8 Bit Katakana SBCS ASCII ISO/ANSI Multilingual 00819 00819
A8KATE
EBCDIC Japanese Katakana 00290 00290
Host SBCS
SJISETA SJIS 1978 Kanji DBCS ASCII SJIS 0941 0300 0300
SJISATE from EZAKJLAT
EBCDIC 0941 0941
SJISETA SJIS 1995 Kanji DBCS ASCII SJIS 0941 0300 0300
SJISATE from EZAKJ941
EBCDIC 0941 0941
DECKANJI SJDCEETA DEC English SBCS ASCII none none
SJDCEATE
EBCDIC none none

Table 28. TCP/IP character set cross reference (continued)
Character
Keyword Codefiles Description set Description CCSID¹ CPGID²
SJDCKETA DEC Katakana SBCS ASCII none none
SJDCKATE
EBCDIC none none
JDECETA DEC Kanji DBCS ASCII none none
JDECATE
EBCDIC Japanese Host DBCS none none
EUCKANJI SJECEETA 8 Bit English SBCS ASCII JIS X0201 8 Bit none none
SJECEATE
EBCDIC Japanese Latin Host 01027 01027
SBCS
SJECKETA 8 Bit Katakana SBCS ASCII JIS X0201 8 Bit none none
SJECKATE
EBCDIC Japanese Katakana 00290 00290
Host SBCS
JEUCETA Japanese Extended ASCII JIS X0208 1990 00952 00952
JEUCATE Unix DBCS
HANGEUL
KSC5601 SKSHETA Korean Standard Code ASCII KSC 5601 SBCS 01088 01088
SKSHATE KSC 5601 SBCS
EBCDIC Korean Host SBCS 00833 00833
KSHETA Korean Standard Code ASCII KSC 5601 DBCS 00951 00951
KSHATE KSC 5601 DBCS
EBCDIC Korean Host DBCS 00834 00834
HANGEUL SHANETA Hangeul SBCS ASCII Korean PC SBCS 00891 00891
SHANATE
EBCDIC Korean Host SBCS 00833 00833
HANETA Hangeul DBCS ASCII Korean PC DBCS 00926 00926
HANATE
EBCDIC Korean Host DBCS 00834 00834
TCHINESE
TCHINESE STCHETA Traditional Chinese ASCII T-Chinese PC SBCS 00904 00904
STCHATE SBCS
EBCDIC CECP Host SBCS 00037 00037
TCHETA Traditional Chinese ASCII I T-Chinese PC DBCS 00927 00927
TCHATE DBCS
EBCDIC T-Chinese Host DBCS 00835 00835
BIG5 SBG5ETA Big-5 Chinese SBCS I ASCII I Big-5 Chinese PC SBCS 01114 01114
SBG5ATE
EBCDIC CECP Host SBCS 00037 00037
BG5ETA Big-5 Chinese DBCS ASCII Big-5 PC DBCS 00947 00947
BG5ATE
EBCDIC T-Chinese Host DBCS 00835 00835
SCHINESE
SCHINESE SSCHETA Simplified Chinese ASCII S-Chinese PC SBCS 01115 01115
SSCHATE SBCS
EBCDIC S-Chinese Host SBCS 00836 00836
SCHETA Simplified Chinese ASCII S-Chinese PC DBCS 01380 01380
SCHATE DBCS
EBCDIC S-Chinese Host DBCS 00837 00837
¹Coded Character Set ID
²Code Page Group ID

Special key operation for TELNET
Table 29 contains information about the operation of special keys for the TELNET
function when you are using a terminal that is not part of the 3270 family.
Use these key combinations if you are using TELNET and your terminal does not
have the key that you want to use. For example, if you want to clear your screen
and your terminal does not have an ERASE INPUT key, press CTRL+Y to get the
same result.
To use the TELNET extensions, TCP/IP must be configured using the

DBCSTRANSFORM option. For more information, see the z/OS Communications
Table 29. Special key conversions
Function name Input keys Function description
Duplicate Ctrl+D Press CTRL and D together. This
combination enters the Duplicate control
code in the screen buffer and a TAB is
performed on the screen.
Field Mark Ctrl+K Press CTRL and K together. This
combination enters the Field Mark
control code in the screen buffer and
displays it as a blank on the screen.
Redisplay Ctrl+V Press CTRL and V together. This
combination redisplays the contents of
the screen buffer on your screen.
Erase Input Ctrl+Y Press CTRL and Y together. This
combination erases all characters in the
unprotected fields on the screen and
replaces them with blanks. The cursor is
placed at the first unprotected character
position on the screen.
Erase EOF Ctrl+X Press CTRL and X together. This
combination erases all characters in an
unprotected field from the cursor
position to the end of the field and
replaces them with blanks. If the cursor
is on a protected field, the screen is
inhibited and no characters are erased.
Delete One Character Del The DEL deletes the character at the
cursor position, if the field is
unprotected. The cursor does not move.
All characters in the unprotected field to
the right of the cursor are shifted one
position to the left and blank characters
are added at the end of the field.
Alphanumeric or Ctrl+B Press CTRL and B together. This
Alphanumeric-Kana combination is a toggle switch that
redisplays the screen by switching
between Alphanumeric and
Alphanumeric-Kana mode.
Appendix C. TELNET extensions 443

Table 29. Special key conversions (continued)
Field Forward Tab Ctrl+F Press CTRL and F together. This
combination moves the cursor to the
first character position in the next
unprotected field. If the screen is
unformatted or there are no unprotected
fields on the screen, the cursor is placed
in the first position on the screen.
Field Backward Tab Ctrl+A F, or Ctrl+A Press CTRL and A together then press F,
Ctrl+F or Press CTRL and A together then press
CTRL and F together. This combination
moves the cursor to the first character
position in the previous unprotected
field. If the screen is unformatted or
there are no unprotected fields on the
screen, the cursor is placed in the first
Home CSI P, or ESC [ P Press CSI then press P, or Press ESC
then press [ then press P. This
combination moves the cursor to the
first character position in the first
unprotected field on the screen. If the
screen is unformatted or there are no
unprotected fields on the screen, the
cursor is placed in the first character
Move Cursor Up CSI A, or ESC [ A Press CSI then press A, or press ESC
then press [ then press A. This
combination moves the cursor up one
line in the same column. If the cursor is
on the first line on the screen, it moves
to the last line on the screen.
Move Cursor Down CSI B, or ESC [ B Press CSI then press B, or press ESC
then press [ then press B. This
combination moves the cursor down one
line in the same column. If the cursor is
on the last line on the screen, it moves
to the first line on the screen.
Move Cursor Right CSI C, or ESC [ C Press CSI then press C, or press ESC
then press [ then press C. This
combination moves the cursor one
character to the right. If the cursor is in
the last column in a line, it moves to the
first position in the next line on the
screen. If the cursor is in the last
position on the screen, it moves to the
first position on the screen.
Move Cursor Left CSI D, or ESC [ D Press CSI then press D, or press ESC
then press [ then press D. This
combination moves the cursor one
character to the left. If the cursor is in
the first column in a line, it moves to
the last position in the previous line on
the screen. If the cursor is in the first
position on the screen, it moves to the
last position on the screen.

Table 29. Special key conversions (continued)
Backspace One Ctrl+H Press CTRL and H together. This
Character combination deletes one character before
the cursor position in an unprotected
field. The cursor moves one position to
the left and all characters in the field
shift one position to the left. If the
cursor is on a protected field the screen
is inhibited.
Reset Ctrl+R Press CTRL and R together. This
combination releases the screen inhibit
condition. When the screen is inhibited,
only the RESET and MASTER RESET
key combinations remain active.
Master Reset Ctrl+A M, or Ctrl+A Press CTRL and A together then press
Ctrl+M M, or Press CTRL and A together then
press CTRL and M together. This
combination produces the same results
that you get if you key in REDISPLAY
followed by RESET.
Clear Ctrl+L Press CTRL and L together. This
combination fills the screen with blanks
and places the cursor at the first
character position on the screen.
MASTER RESET key combinations
remain active.
Enter Ctrl+M Press CTRL and M together. This
combination sends the data on the
screen to the host system.
CSI stands for Control Sequence Indicator.
Operation of PF and PA keys

This section describes the PF and PA keys for TELNET operations when you are
using a terminal that is not part of the 3270 family.
When you press a key combination, a code that represents the 3270 equivalent
symbol is sent to the application with which you have established TELNET
communication. The application that you are using controls how these codes are
used.
PF Key Input Keys
PF1 Press ESC then press 1

PF11 Press ESC then press the period key (.)
PF12 Press ESC then press =
PF13 Press ESC ESC then press 1
PF23 Press ESC ESC then press .
PF24 Press ESC ESC then press =
PA Key Input Keys
PA1 Press Ctrl+P then press 1
Sense codes for special key operation

Table 30 describes the sense codes that are returned with the error messages for
special key operations when you are using TELNET.
For information about error messages, see z/OS Communications Server: IP Messages
Volume 1 (EZA).
Table 30. Sense codes
Sense code Problem description
8001 The command data length is less than 0 bytes.
8002 There is not enough data in an ERASE/WRITE or an ERASE/WRITE
ALTERNATE command.
8003 There is not enough data in A WRITE command.
8004 There is not enough data in A WRITE STRUCTURED FIELD command.
21001 WCC is not a character. The error occurred in a WRITE command.
21002 There is not enough data in a START FIELD subcommand. The error
occurred in a WRITE command.
21003 There is not enough data in a START FIELD EXTENDED subcommand. The
error occurred in a WRITE command.
21004 There is not enough data in a MODIFY FIELD subcommand. The error
occurred in a WRITE command.

Table 30. Sense codes (continued)
21005 There is not enough data in a SET BUFFER ADDRESS subcommand. The
21006 There is not enough data in a REPEAT TO ADDRESS subcommand. The
21007 There is not enough data in an ERASE UNPROTECTED TO ADDRESS
subcommand. The error occurred in a WRITE command.
22001 The specified attribute is not a character. The error occurred in a START
FIELD subcommand.
22002 A current buffer addressing error occurred. The error occurred in a START
FIELD subcommand.
23001 An addressing error for the current buffer occurred. The error occurred in a
START FIELD EXTENDED subcommand.
23002 The specified attribute is not a character. The error occurred in a START
FIELD EXTENDED subcommand.
23003 The specified attribute is not an acceptable attribute type. The error
occurred in a START FIELD EXTENDED subcommand.
24001 A current buffer addressing error occurred. The error occurred in a
MODIFY FIELD subcommand.
24002 The specified attribute is not a character. The error occurred in a MODIFY
FIELD subcommand.
24003 The specified attribute is not an acceptable attribute type. The error
occurred in a MODIFY FIELD subcommand.
25001 The specified address is incorrect. The error occurred in a SET BUFFER
ADDRESS subcommand.
26001 A current buffer addressing error occurred. The error occurred in a
PROGRAM TAB subcommand.
28001 A current buffer addressing error occurred. The error occurred in a REPEAT
TO ADDRESS subcommand.
28002 The specified address is incorrect. The error occurred in a REPEAT TO
ADDRESS subcommand.
29001 A current buffer addressing error occurred. The error occurred in an ERASE
UNPROTECTED TO ADDRESS subcommand.
29002 The specified address is incorrect. The error occurred in an ERASE
UNPROTECTED TO ADDRESS subcommand.
30001 A current buffer addressing error occurred. The error occurred in the Write
Data Process.
36001 Another structured field appeared after the READ PARTITION field. The
error occurred in a WRITE STRUCTURED FIELD command.
36002 The length is too long or too short in the READ PARTITION field. The
error occurred in a WRITE STRUCTURED FIELD command.
36003 A reserved character is incorrect in the READ PARTITION field. The error
occurred in a WRITE STRUCTURED FIELD command.
36004 The type is incorrect in the READ PARTITION field. The error occurred in
a WRITE STRUCTURED FIELD command.
38001 The length is too long or too short in the ERASE/RESET field. The error

Table 30. Sense codes (continued)
38002 The Partition ID is incorrect in the ERASE/RESET field. The error occurred
in a WRITE STRUCTURED FIELD command.
39001 The length is too long or too short in the SET REPLY mode. The error
39002 The Partition ID is incorrect in the SET REPLY mode. The error occurred in
39003 The Reply Mode is incorrect in the SET REPLY mode. The error occurred in
40001 The 3270 outbound data stream contains a command that is not in this list.
v WRITE
v ERASE/WRITE
v ERASE/WRITE ALTERNATE
v ERASE ALL UNPROTECTED
The error occurred in a WRITE STRUCTURED FIELD command.
50001 SO/SI is on longer a pair. SET REPLY mode. The error occurred in the
GRFTOMAP Process.

Appendix D. Related protocol specifications
This appendix lists the related protocol specifications (RFCs) for TCP/IP. The
Internet Protocol suite is still evolving through requests for comments (RFC). New
protocols are being designed and implemented by researchers and are brought to
the attention of the Internet community in the form of RFCs. Some of these
protocols are so useful that they become recommended protocols. That is, all future
implementations for TCP/IP are recommended to implement these particular
functions or protocols. These become the de facto standards, on which the TCP/IP
protocol suite is built.
You can request RFCs through electronic mail, from the automated Network
Information Center (NIC) mail server, by sending a message to
service@nic.ddn.mil with a subject line of RFC nnnn for text versions or a subject
line of RFC nnnn.PS for PostScript versions. To request a copy of the RFC index,
send a message with a subject line of RFC INDEX.
For more information, contact nic@nic.ddn.mil or at:
Government Systems, Inc.

Attn: Network Information Center
14200 Park Meadow Drive
Suite 200
Chantilly, VA 22021
Hard copies of all RFCs are available from the NIC, either individually or by
subscription. Online copies are available at the following Web address:
http://www.rfc-editor.org/rfc.html.
See “Internet drafts” on page 464 for draft RFCs implemented in this and previous
Communications Server releases.
Many features of TCP/IP Services are based on the following RFCs:

RFC Title and Author
RFC 652 Telnet output carriage-return disposition option D. Crocker
RFC 653 Telnet output horizontal tabstops option D. Crocker
RFC 654 Telnet output horizontal tab disposition option D. Crocker
RFC 655 Telnet output formfeed disposition option D. Crocker
RFC 657 Telnet output vertical tab disposition option D. Crocker
RFC 658 Telnet output linefeed disposition D. Crocker
RFC 698 Telnet extended ASCII option T. Mock
RFC 726 Remote Controlled Transmission and Echoing Telnet option J. Postel, D.
Crocker
RFC 727 Telnet logout option M.R. Crispin
RFC 732 Telnet Data Entry Terminal option J.D. Day
RFC 733 Standard for the format of ARPA network text messages D. Crocker, J.
Vittal, K.T. Pogran, D.A. Henderson

RFC 734 SUPDUP Protocol M.R. Crispin
RFC 735 Revised Telnet byte macro option D. Crocker, R.H. Gumpertz
RFC 736 Telnet SUPDUP option M.R. Crispin
RFC 749 Telnet SUPDUP—Output option B. Greenberg
RFC 765 File Transfer Protocol specification J. Postel
RFC 768 User Datagram Protocol J. Postel
RFC 779 Telnet send-location option E. Killian
RFC 783 TFTP Protocol (revision 2) K.R. Sollins
RFC 791 Internet Protocol J. Postel
RFC 792 Internet Control Message Protocol J. Postel
RFC 793 Transmission Control Protocol J. Postel
RFC 820 Assigned numbers J. Postel
RFC 821 Simple Mail Transfer Protocol J. Postel
RFC 822 Standard for the format of ARPA Internet text messages D. Crocker
RFC 823 DARPA Internet gateway R. Hinden, A. Sheltzer
RFC 826 Ethernet Address Resolution Protocol: Or converting network protocol
addresses to 48.bit Ethernet address for transmission on Ethernet
hardware D. Plummer
RFC 854 Telnet Protocol Specification J. Postel, J. Reynolds
RFC 855 Telnet Option Specification J. Postel, J. Reynolds
RFC 856 Telnet Binary Transmission J. Postel, J. Reynolds
RFC 857 Telnet Echo Option J. Postel, J. Reynolds
RFC 858 Telnet Suppress Go Ahead Option J. Postel, J. Reynolds
RFC 859 Telnet Status Option J. Postel, J. Reynolds
RFC 860 Telnet Timing Mark Option J. Postel, J. Reynolds
RFC 861 Telnet Extended Options: List Option J. Postel, J. Reynolds
RFC 862 Echo Protocol J. Postel
RFC 863 Discard Protocol J. Postel
RFC 864 Character Generator Protocol J. Postel
RFC 865 Quote of the Day Protocol J. Postel
RFC 868 Time Protocol J. Postel, K. Harrenstien
RFC 877 Standard for the transmission of IP datagrams over public data networks
J.T. Korb
RFC 883 Domain names: Implementation specification P.V. Mockapetris
RFC 884 Telnet terminal type option M. Solomon, E. Wimmers
RFC 885 Telnet end of record option J. Postel
RFC 894 Standard for the transmission of IP datagrams over Ethernet networks C.
Hornig
RFC 896 Congestion control in IP/TCP internetworks J. Nagle

RFC 903 Reverse Address Resolution Protocol R. Finlayson, T. Mann, J. Mogul,
M. Theimer
RFC 904 Exterior Gateway Protocol formal specification D. Mills
RFC 919 Broadcasting Internet Datagrams J. Mogul
RFC 922 Broadcasting Internet datagrams in the presence of subnets J. Mogul
RFC 927 TACACS user identification Telnet option B.A. Anderson
RFC 933 Output marking Telnet option S. Silverman
RFC 946 Telnet terminal location number option R. Nedved
RFC 950 Internet Standard Subnetting Procedure J. Mogul, J. Postel
RFC 951 Bootstrap Protocol W.J. Croft, J. Gilmore
RFC 952 DoD Internet host table specification K. Harrenstien, M. Stahl, E.
Feinler
RFC 959 File Transfer Protocol J. Postel, J.K. Reynolds
RFC 961 Official ARPA-Internet protocols J.K. Reynolds, J. Postel
RFC 974 Mail routing and the domain system C. Partridge
RFC 1001 Protocol standard for a NetBIOS service on a TCP/UDP transport:
Concepts and methods NetBios Working Group in the Defense
Advanced Research Projects Agency, Internet Activities Board,
End-to-End Services Task Force
RFC 1002 Protocol Standard for a NetBIOS service on a TCP/UDP transport:
Detailed specifications NetBios Working Group in the Defense
Advanced Research Projects Agency, Internet Activities Board,
End-to-End Services Task Force
RFC 1006 ISO transport services on top of the TCP: Version 3 M.T. Rose, D.E.
Cass
RFC 1009 Requirements for Internet gateways R. Braden, J. Postel
RFC 1011 Official Internet protocols J. Reynolds, J. Postel
RFC 1013 X Window System Protocol, version 11: Alpha update April 1987 R.
Scheifler
RFC 1014 XDR: External Data Representation standard Sun Microsystems
RFC 1027 Using ARP to implement transparent subnet gateways S. Carl-Mitchell,
J. Quarterman
RFC 1032 Domain administrators guide M. Stahl
RFC 1033 Domain administrators operations guide M. Lottor
RFC 1034 Domain names—concepts and facilities P.V. Mockapetris
RFC 1035 Domain names—implementation and specification P.V. Mockapetris
RFC 1038 Draft revised IP security option M. St. Johns
RFC 1041 Telnet 3270 regime option Y. Rekhter
RFC 1042 Standard for the transmission of IP datagrams over IEEE 802 networks J.
Postel, J. Reynolds
RFC 1043 Telnet Data Entry Terminal option: DODIIS implementation A. Yasuda,
T. Thompson
Appendix D. Related protocol specifications 451

RFC 1044 Internet Protocol on Network System’s HYPERchannel: Protocol
specification K. Hardwick, J. Lekashman
RFC 1053 Telnet X.3 PAD option S. Levy, T. Jacobson
RFC 1055 Nonstandard for transmission of IP datagrams over serial lines: SLIP J.
Romkey
RFC 1057 RPC: Remote Procedure Call Protocol Specification: Version 2 Sun
Microsystems
RFC 1058 Routing Information Protocol C. Hedrick
RFC 1060 Assigned numbers J. Reynolds, J. Postel
RFC 1067 Simple Network Management Protocol J.D. Case, M. Fedor, M.L.
Schoffstall, J. Davin
RFC 1071 Computing the Internet checksum R.T. Braden, D.A. Borman, C.
Partridge
RFC 1072 TCP extensions for long-delay paths V. Jacobson, R.T. Braden
RFC 1073 Telnet window size option D. Waitzman
RFC 1079 Telnet terminal speed option C. Hedrick
RFC 1085 ISO presentation services on top of TCP/IP based internets M.T. Rose
RFC 1091 Telnet terminal-type option J. VanBokkelen
RFC 1094 NFS: Network File System Protocol specification Sun Microsystems
RFC 1096 Telnet X display location option G. Marcy
RFC 1101 DNS encoding of network names and other types P. Mockapetris
RFC 1112 Host extensions for IP multicasting S.E. Deering
RFC 1113 Privacy enhancement for Internet electronic mail: Part I — message
encipherment and authentication procedures J. Linn
RFC 1118 Hitchhikers Guide to the Internet E. Krol
RFC 1122 Requirements for Internet Hosts—Communication Layers R. Braden,
Ed.
RFC 1123 Requirements for Internet Hosts—Application and Support R. Braden,
Ed.
RFC 1146 TCP alternate checksum options J. Zweig, C. Partridge
RFC 1155 Structure and identification of management information for TCP/IP-based
internets M. Rose, K. McCloghrie
RFC 1156 Management Information Base for network management of TCP/IP-based
internets K. McCloghrie, M. Rose
RFC 1157 Simple Network Management Protocol (SNMP) J. Case, M. Fedor, M.
Schoffstall, J. Davin
RFC 1158 Management Information Base for network management of TCP/IP-based
internets: MIB-II M. Rose
RFC 1166 Internet numbers S. Kirkpatrick, M.K. Stahl, M. Recker
RFC 1179 Line printer daemon protocol L. McLaughlin
RFC 1180 TCP/IP tutorial T. Socolofsky, C. Kale

RFC 1183 New DNS RR Definitions C.F. Everhart, L.A. Mamakos, R. Ullmann,
P.V. Mockapetris
RFC 1184 Telnet Linemode Option D. Borman
RFC 1186 MD4 Message Digest Algorithm R.L. Rivest
RFC 1187 Bulk Table Retrieval with the SNMP M. Rose, K. McCloghrie, J. Davin
RFC 1188 Proposed Standard for the Transmission of IP Datagrams over FDDI
Networks D. Katz
RFC 1190 Experimental Internet Stream Protocol: Version 2 (ST-II) C. Topolcic
RFC 1191 Path MTU discovery J. Mogul, S. Deering
RFC 1198 FYI on the X window system R. Scheifler
RFC 1207 FYI on Questions and Answers: Answers to commonly asked
“experienced Internet user” questions G. Malkin, A. Marine, J.
Reynolds
RFC 1208 Glossary of networking terms O. Jacobsen, D. Lynch
RFC 1213 Management Information Base for Network Management of
TCP/IP-based internets: MIB-II K. McCloghrie, M.T. Rose
RFC 1215 Convention for defining traps for use with the SNMP M. Rose
RFC 1227 SNMP MUX protocol and MIB M.T. Rose
RFC 1228 SNMP-DPI: Simple Network Management Protocol Distributed Program
Interface G. Carpenter, B. Wijnen
RFC 1229 Extensions to the generic-interface MIB K. McCloghrie
RFC 1230 IEEE 802.4 Token Bus MIB K. McCloghrie, R. Fox
RFC 1231 IEEE 802.5 Token Ring MIB K. McCloghrie, R. Fox, E. Decker
RFC 1236 IP to X.121 address mapping for DDN L. Morales, P. Hasse
RFC 1256 ICMP Router Discovery Messages S. Deering, Ed.
RFC 1267 Border Gateway Protocol 3 (BGP-3) K. Lougheed, Y. Rekhter
RFC 1268 Application of the Border Gateway Protocol in the Internet Y. Rekhter, P.
Gross
RFC 1269 Definitions of Managed Objects for the Border Gateway Protocol: Version
3 S. Willis, J. Burruss
RFC 1270 SNMP Communications Services F. Kastenholz, ed.
RFC 1285 FDDI Management Information Base J. Case
RFC 1315 Management Information Base for Frame Relay DTEs C. Brown, F.
Baker, C. Carvalho
RFC 1321 The MD5 Message-Digest Algorithm R. Rivest
RFC 1323 TCP Extensions for High Performance V. Jacobson, R. Braden, D.
Borman
RFC 1325 FYI on Questions and Answers: Answers to Commonly Asked ″New
Internet User″ Questions G. Malkin, A. Marine
RFC 1327 Mapping between X.400 (1988)/ISO 10021 and RFC 822 S.
Hardcastle-Kille

RFC 1340 Assigned Numbers J. Reynolds, J. Postel
RFC 1344 Implications of MIME for Internet Mail Gateways N. Bornstein
RFC 1349 Type of Service in the Internet Protocol Suite P. Almquist
RFC 1350 The TFTP Protocol (Revision 2) K.R. Sollins
RFC 1351 SNMP Administrative Model J. Davin, J. Galvin, K. McCloghrie
RFC 1352 SNMP Security Protocols J. Galvin, K. McCloghrie, J. Davin
RFC 1353 Definitions of Managed Objects for Administration of SNMP Parties K.
McCloghrie, J. Davin, J. Galvin
RFC 1354 IP Forwarding Table MIB F. Baker
RFC 1356 Multiprotocol Interconnect on X.25 and ISDN in the Packet Mode A.
Malis, D. Robinson, R. Ullmann
RFC 1358 Charter of the Internet Architecture Board (IAB) L. Chapin
RFC 1363 A Proposed Flow Specification C. Partridge
RFC 1368 Definition of Managed Objects for IEEE 802.3 Repeater Devices D.
McMaster, K. McCloghrie
RFC 1372 Telnet Remote Flow Control Option C. L. Hedrick, D. Borman
RFC 1374 IP and ARP on HIPPI J. Renwick, A. Nicholson
RFC 1381 SNMP MIB Extension for X.25 LAPB D. Throop, F. Baker
RFC 1382 SNMP MIB Extension for the X.25 Packet Layer D. Throop
RFC 1387 RIP Version 2 Protocol Analysis G. Malkin
RFC 1388 RIP Version 2 Carrying Additional Information G. Malkin
RFC 1389 RIP Version 2 MIB Extensions G. Malkin, F. Baker
RFC 1390 Transmission of IP and ARP over FDDI Networks D. Katz
RFC 1393 Traceroute Using an IP Option G. Malkin
RFC 1398 Definitions of Managed Objects for the Ethernet-Like Interface Types F.
Kastenholz
RFC 1408 Telnet Environment Option D. Borman, Ed.
RFC 1413 Identification Protocol M. St. Johns
RFC 1416 Telnet Authentication Option D. Borman, ed.
RFC 1420 SNMP over IPX S. Bostock
RFC 1428 Transition of Internet Mail from Just-Send-8 to 8bit-SMTP/MIME G.
Vaudreuil
RFC 1442 Structure of Management Information for version 2 of the Simple
Network Management Protocol (SNMPv2) J. Case, K. McCloghrie, M.
Rose, S. Waldbusser
RFC 1443 Textual Conventions for version 2 of the Simple Network Management
Protocol (SNMPv2) J. Case, K. McCloghrie, M. Rose, S. Waldbusser
RFC 1445 Administrative Model for version 2 of the Simple Network Management
Protocol (SNMPv2) J. Galvin, K. McCloghrie
RFC 1447 Party MIB for version 2 of the Simple Network Management Protocol
(SNMPv2) K. McCloghrie, J. Galvin

RFC 1448 Protocol Operations for version 2 of the Simple Network Management
RFC 1464 Using the Domain Name System to Store Arbitrary String Attributes R.
Rosenbaum
RFC 1469 IP Multicast over Token-Ring Local Area Networks T. Pusateri
RFC 1483 Multiprotocol Encapsulation over ATM Adaptation Layer 5 Juha
Heinanen
RFC 1497 BOOTP Vendor Information Extensions J. Reynolds
RFC 1514 Host Resources MIB P. Grillo, S. Waldbusser
RFC 1516 Definitions of Managed Objects for IEEE 802.3 Repeater Devices D.
McMaster, K. McCloghrie
RFC 1521 MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms
for Specifying and Describing the Format of Internet Message Bodies N.
Borenstein, N. Freed
RFC 1533 DHCP Options and BOOTP Vendor Extensions S. Alexander, R.
Droms
RFC 1534 Interoperation Between DHCP and BOOTP R. Droms
RFC 1535 A Security Problem and Proposed Correction With Widely Deployed
DNS Software E. Gavron
RFC 1536 Common DNS Implementation Errors and Suggested Fixes A. Kumar, J.
Postel, C. Neuman, P. Danzig, S. Miller
RFC 1537 Common DNS Data File Configuration Errors P. Beertema
RFC 1540 Internet Official Protocol Standards J. Postel
RFC 1541 Dynamic Host Configuration Protocol R. Droms
RFC 1542 Clarifications and Extensions for the Bootstrap Protocol W. Wimer
RFC 1571 Telnet Environment Option Interoperability Issues D. Borman
RFC 1572 Telnet Environment Option S. Alexander
RFC 1573 Evolution of the Interfaces Group of MIB-II K. McCloghrie, F.
Kastenholz
RFC 1577 Classical IP and ARP over ATM M. Laubach
RFC 1583 OSPF Version 2 J. Moy
RFC 1591 Domain Name System Structure and Delegation J. Postel
RFC 1592 Simple Network Management Protocol Distributed Protocol Interface
Version 2.0 B. Wijnen, G. Carpenter, K. Curran, A. Sehgal, G. Waters
RFC 1594 FYI on Questions and Answers— Answers to Commonly Asked ″New
Internet User″ Questions A. Marine, J. Reynolds, G. Malkin
RFC 1644 T/TCP — TCP Extensions for Transactions Functional Specification R.
Braden
RFC 1646 TN3270 Extensions for LUname and Printer Selection C. Graves, T.
Butts, M. Angel
RFC 1647 TN3270 Enhancements B. Kelly

RFC 1652 SMTP Service Extension for 8bit-MIMEtransport J. Klensin, N. Freed,
M. Rose, E. Stefferud, D. Crocker
RFC 1664 Using the Internet DNS to Distribute RFC1327 Mail Address Mapping
Tables C. Allochio, A. Bonito, B. Cole, S. Giordano, R. Hagens
RFC 1693 An Extension to TCP: Partial Order Service T. Connolly, P. Amer, P.
Conrad
RFC 1695 Definitions of Managed Objects for ATM Management Version 8.0 using
SMIv2 M. Ahmed, K. Tesink
RFC 1701 Generic Routing Encapsulation (GRE) S. Hanks, T. Li, D. Farinacci, P.
Traina
RFC 1702 Generic Routing Encapsulation over IPv4 networks S. Hanks, T. Li, D.
Farinacci, P. Traina
RFC 1706 DNS NSAP Resource Records B. Manning, R. Colella
RFC 1712 DNS Encoding of Geographical Location C. Farrell, M. Schulze, S.
Pleitner D. Baldoni
RFC 1713 Tools for DNS debugging A. Romao
RFC 1723 RIP Version 2—Carrying Additional Information G. Malkin
RFC 1752 The Recommendation for the IP Next Generation Protocol S. Bradner, A.
Mankin
RFC 1766 Tags for the Identification of Languages H. Alvestrand
RFC 1771 A Border Gateway Protocol 4 (BGP-4) Y. Rekhter, T. Li
RFC 1794 DNS Support for Load Balancing T. Brisco
RFC 1819 Internet Stream Protocol Version 2 (ST2) Protocol Specification—Version
ST2+ L. Delgrossi, L. Berger Eds.
RFC 1826 IP Authentication Header R. Atkinson
RFC 1828 IP Authentication using Keyed MD5 P. Metzger, W. Simpson
RFC 1829 The ESP DES-CBC Transform P. Karn, P. Metzger, W. Simpson
RFC 1830 SMTP Service Extensions for Transmission of Large and Binary MIME
Messages G. Vaudreuil
RFC 1831 RPC: Remote Procedure Call Protocol Specification Version 2 R.
Srinivasan
RFC 1832 XDR: External Data Representation Standard R. Srinivasan
RFC 1833 Binding Protocols for ONC RPC Version 2 R. Srinivasan
RFC 1850 OSPF Version 2 Management Information Base F. Baker, R. Coltun
RFC 1854 SMTP Service Extension for Command Pipelining N. Freed
RFC 1869 SMTP Service Extensions J. Klensin, N. Freed, M. Rose, E. Stefferud,
D. Crocker
RFC 1870 SMTP Service Extension for Message Size Declaration J. Klensin, N.
Freed, K. Moore
RFC 1876 A Means for Expressing Location Information in the Domain Name
System C. Davis, P. Vixie, T. Goodwin, I. Dickinson
RFC 1883 Internet Protocol, Version 6 (IPv6) Specification S. Deering, R. Hinden

RFC 1884 IP Version 6 Addressing Architecture R. Hinden, S. Deering, Eds.
RFC 1886 DNS Extensions to support IP version 6 S. Thomson, C. Huitema
RFC 1888 OSI NSAPs and IPv6 J. Bound, B. Carpenter, D. Harrington, J.
Houldsworth, A. Lloyd
RFC 1891 SMTP Service Extension for Delivery Status Notifications K. Moore
RFC 1892 The Multipart/Report Content Type for the Reporting of Mail System
Administrative Messages G. Vaudreuil
RFC 1894 An Extensible Message Format for Delivery Status NotificationsK.
Moore, G. Vaudreuil
RFC 1901 Introduction to Community-based SNMPv2 J. Case, K. McCloghrie, M.
Rose, S. Waldbusser
RFC 1902 Structure of Management Information for Version 2 of the Simple
Network Management Protocol (SNMPv2) J. Case, K. McCloghrie, M.
Rose, S. Waldbusser
RFC 1903 Textual Conventions for Version 2 of the Simple Network Management
RFC 1904 Conformance Statements for Version 2 of the Simple Network
Management Protocol (SNMPv2) J. Case, K. McCloghrie, M. Rose, S.
Waldbusser
RFC 1905 Protocol Operations for Version 2 of the Simple Network Management
RFC 1906 Transport Mappings for Version 2 of the Simple Network Management
RFC 1907 Management Information Base for Version 2 of the Simple Network
Management Protocol (SNMPv2) J. Case, K. McCloghrie, M. Rose, S.
Waldbusser
RFC 1908 Coexistence between Version 1 and Version 2 of the Internet-standard
Network Management Framework J. Case, K. McCloghrie, M. Rose, S.
Waldbusser
RFC 1912 Common DNS Operational and Configuration Errors D. Barr
RFC 1918 Address Allocation for Private Internets Y. Rekhter, B. Moskowitz, D.
Karrenberg, G.J. de Groot, E. Lear
RFC 1928 SOCKS Protocol Version 5 M. Leech, M. Ganis, Y. Lee, R. Kuris, D.
Koblas, L. Jones
RFC 1930 Guidelines for creation, selection, and registration of an Autonomous
System (AS) J. Hawkinson, T. Bates
RFC 1939 Post Office Protocol-Version 3 J. Myers, M. Rose
RFC 1981 Path MTU Discovery for IP version 6 J. McCann, S. Deering, J. Mogul
RFC 1982 Serial Number Arithmetic R. Elz, R. Bush
RFC 1985 SMTP Service Extension for Remote Message Queue Starting J. De
Winter
RFC 1995 Incremental Zone Transfer in DNS M. Ohta
RFC 1996 A Mechanism for Prompt Notification of Zone Changes (DNS NOTIFY)
P. Vixie

RFC 2010 Operational Criteria for Root Name Servers B. Manning, P. Vixie
RFC 2011 SNMPv2 Management Information Base for the Internet Protocol using
SMIv2 K. McCloghrie, Ed.
RFC 2012 SNMPv2 Management Information Base for the Transmission Control
Protocol using SMIv2 K. McCloghrie, Ed.
RFC 2013 SNMPv2 Management Information Base for the User Datagram Protocol
using SMIv2 K. McCloghrie, Ed.
RFC 2018 TCP Selective Acknowledgement Options M. Mathis, J. Mahdavi, S.
Floyd, A. Romanow
RFC 2026 The Internet Standards Process — Revision 3 S. Bradner
RFC 2030 Simple Network Time Protocol (SNTP) Version 4 for IPv4, IPv6 and OSI
D. Mills
RFC 2033 Local Mail Transfer Protocol J. Myers
RFC 2034 SMTP Service Extension for Returning Enhanced Error CodesN. Freed
RFC 2040 The RC5, RC5–CBC, RC-5–CBC-Pad, and RC5–CTS AlgorithmsR.
Baldwin, R. Rivest
RFC 2045 Multipurpose Internet Mail Extensions (MIME) Part One: Format of
Internet Message Bodies N. Freed, N. Borenstein
RFC 2052 A DNS RR for specifying the location of services (DNS SRV) A.
Gulbrandsen, P. Vixie
RFC 2065 Domain Name System Security Extensions D. Eastlake 3rd, C.
Kaufman
RFC 2066 TELNET CHARSET Option R. Gellens
RFC 2080 RIPng for IPv6 G. Malkin, R. Minnear
RFC 2096 IP Forwarding Table MIB F. Baker
RFC 2104 HMAC: Keyed-Hashing for Message Authentication H. Krawczyk, M.
Bellare, R. Canetti
RFC 2119 Keywords for use in RFCs to Indicate Requirement Levels S. Bradner
RFC 2132 DHCP Options and BOOTP Vendor Extensions S. Alexander, R.
Droms
RFC 2133 Basic Socket Interface Extensions for IPv6 R. Gilligan, S. Thomson, J.
Bound, W. Stevens
RFC 2136 Dynamic Updates in the Domain Name System (DNS UPDATE) P.
Vixie, Ed., S. Thomson, Y. Rekhter, J. Bound
RFC 2137 Secure Domain Name System Dynamic Update D. Eastlake 3rd
RFC 2163 Using the Internet DNS to Distribute MIXER Conformant Global
Address Mapping (MCGAM) C. Allocchio
RFC 2168 Resolution of Uniform Resource Identifiers using the Domain Name
System R. Daniel, M. Mealling
RFC 2181 Clarifications to the DNS Specification R. Elz, R. Bush

RFC 2205 Resource ReSerVation Protocol (RSVP)—Version 1 Functional
Specification R. Braden, Ed., L. Zhang, S. Berson, S. Herzog, S.
Jamin
RFC 2210 The Use of RSVP with IETF Integrated Services J. Wroclawski
RFC 2211 Specification of the Controlled-Load Network Element Service J.
Wroclawski
RFC 2212 Specification of Guaranteed Quality of Service S. Shenker, C. Partridge,
R. Guerin
RFC 2215 General Characterization Parameters for Integrated Service Network
Elements S. Shenker, J. Wroclawski
RFC 2217 Telnet Com Port Control Option G. Clarke
RFC 2219 Use of DNS Aliases for Network Services M. Hamilton, R. Wright
RFC 2228 FTP Security Extensions M. Horowitz, S. Lunt
RFC 2230 Key Exchange Delegation Record for the DNS R. Atkinson
RFC 2233 The Interfaces Group MIB using SMIv2 K. McCloghrie, F. Kastenholz
RFC 2240 A Legal Basis for Domain Name Allocation O. Vaughn
RFC 2246 The TLS Protocol Version 1.0 T. Dierks, C. Allen
RFC 2251 Lightweight Directory Access Protocol (v3) M. Wahl, T. Howes, S. Kille
RFC 2253 Lightweight Directory Access Protocol (v3): UTF-8 String Representation
of Distinguished Names M. Wahl, S. Kille, T. Howes
RFC 2254 The String Representation of LDAP Search Filters T. Howes
RFC 2261 An Architecture for Describing SNMP Management Frameworks D.
Harrington, R. Presuhn, B. Wijnen
RFC 2262 Message Processing and Dispatching for the Simple Network
Management Protocol (SNMP) J. Case, D. Harrington, R. Presuhn, B.
Wijnen
RFC 2271 An Architecture for Describing SNMP Management Frameworks D.
Harrington, R. Presuhn, B. Wijnen
RFC 2273 SNMPv3 Applications D. Levi, P. Meyer, B. Stewartz
RFC 2274 User-based Security Model (USM) for version 3 of the Simple Network
Management Protocol (SNMPv3) U. Blumenthal, B. Wijnen
RFC 2275 View-based Access Control Model (VACM) for the Simple Network
Management Protocol (SNMP) B. Wijnen, R. Presuhn, K. McCloghrie
RFC 2279 UTF-8, a transformation format of ISO 10646 F. Yergeau
RFC 2292 Advanced Sockets API for IPv6 W. Stevens, M. Thomas
RFC 2308 Negative Caching of DNS Queries (DNS NCACHE) M. Andrews
RFC 2317 Classless IN-ADDR.ARPA delegation H. Eidnes, G. de Groot, P. Vixie
RFC 2320 Definitions of Managed Objects for Classical IP and ARP Over ATM
Using SMIv2 (IPOA-MIB) M. Greene, J. Luciani, K. White, T. Kuo
RFC 2345 Domain Names and Company Name Retrieval J. Klensin, T. Wolf, G.
Oglesby

RFC 2352 A Convention for Using Legal Names as Domain Names O. Vaughn
RFC 2355 TN3270 Enhancements B. Kelly
RFC 2358 Definitions of Managed Objects for the Ethernet-like Interface Types J.
Flick, J. Johnson
RFC 2373 IP Version 6 Addressing Architecture R. Hinden, S. Deering
RFC 2374 An IPv6 Aggregatable Global Unicast Address Format R. Hinden, M.
O’Dell, S. Deering
RFC 2375 IPv6 Multicast Address Assignments R. Hinden, S. Deering
RFC 2385 Protection of BGP Sessions via the TCP MD5 Signature OptionA.
Hefferman
RFC 2389 Feature negotiation mechanism for the File Transfer Protocol P.
Hethmon, R. Elz
RFC 2401 Security Architecture for Internet Protocol S. Kent, R. Atkinson
RFC 2402 IP Authentication Header S. Kent, R. Atkinson
RFC 2403 The Use of HMAC-MD5–96 within ESP and AH C. Madson, R. Glenn
RFC 2404 The Use of HMAC-SHA–1–96 within ESP and AH C. Madson, R.
Glenn
RFC 2405 The ESP DES-CBC Cipher Algorithm With Explicit IV C. Madson, N.
Doraswamy
RFC 2406 IP Encapsulating Security Payload (ESP) S. Kent, R. Atkinson
RFC 2407 The Internet IP Security Domain of Interpretation for ISAKMPD. Piper
RFC 2408 Internet Security Association and Key Management Protocol (ISAKMP)
D. Maughan, M. Schertler, M. Schneider, J. Turner
RFC 2409 The Internet Key Exchange (IKE) D. Harkins, D. Carrel
RFC 2410 The NULL Encryption Algorithm and Its Use With IPsec R. Glenn, S.
Kent,
RFC 2428 FTP Extensions for IPv6 and NATs M. Allman, S. Ostermann, C.
Metz
RFC 2445 Internet Calendaring and Scheduling Core Object Specification
(iCalendar) F. Dawson, D. Stenerson
RFC 2459 Internet X.509 Public Key Infrastructure Certificate and CRL Profile R.
Housley, W. Ford, W. Polk, D. Solo
RFC 2460 Internet Protocol, Version 6 (IPv6) Specification S. Deering, R. Hinden
RFC 2461 Neighbor Discovery for IP Version 6 (IPv6) T. Narten, E. Nordmark,
W. Simpson
RFC 2462 IPv6 Stateless Address Autoconfiguration S. Thomson, T. Narten
RFC 2463 Internet Control Message Protocol (ICMPv6) for the Internet Protocol
Version 6 (IPv6) Specification A. Conta, S. Deering
RFC 2464 Transmission of IPv6 Packets over Ethernet Networks M. Crawford
RFC 2466 Management Information Base for IP Version 6: ICMPv6 Group D.
Haskin, S. Onishi
RFC 2476 Message Submission R. Gellens, J. Klensin

RFC 2487 SMTP Service Extension for Secure SMTP over TLS P. Hoffman
RFC 2505 Anti-Spam Recommendations for SMTP MTAs G. Lindberg
RFC 2523 Photuris: Extended Schemes and Attributes P. Karn, W. Simpson
RFC 2535 Domain Name System Security Extensions D. Eastlake 3rd
RFC 2538 Storing Certificates in the Domain Name System (DNS) D. Eastlake
3rd, O. Gudmundsson
RFC 2539 Storage of Diffie-Hellman Keys in the Domain Name System (DNS) D.
Eastlake 3rd
RFC 2540 Detached Domain Name System (DNS) Information D. Eastlake 3rd
RFC 2554 SMTP Service Extension for Authentication J. Myers
RFC 2570 Introduction to Version 3 of the Internet-standard Network Management
Framework J. Case, R. Mundy, D. Partain, B. Stewart
RFC 2571 An Architecture for Describing SNMP Management Frameworks B.
Wijnen, D. Harrington, R. Presuhn
Wijnen
RFC 2573 SNMP Applications D. Levi, P. Meyer, B. Stewart
RFC 2576 Co-Existence between Version 1, Version 2, and Version 3 of the
Internet-standard Network Management Framework R. Frye, D. Levi, S.
Routhier, B. Wijnen
RFC 2578 Structure of Management Information Version 2 (SMIv2) K.
McCloghrie, D. Perkins, J. Schoenwaelder
RFC 2579 Textual Conventions for SMIv2 K. McCloghrie, D. Perkins, J.
Schoenwaelder
RFC 2580 Conformance Statements for SMIv2 K. McCloghrie, D. Perkins, J.
Schoenwaelder
RFC 2581 TCP Congestion Control M. Allman, V. Paxson, W. Stevens
RFC 2583 Guidelines for Next Hop Client (NHC) Developers R. Carlson, L.
Winkler
RFC 2591 Definitions of Managed Objects for Scheduling Management Operations
D. Levi, J. Schoenwaelder
RFC 2625 IP and ARP over Fibre Channel M. Rajagopal, R. Bhagwat, W.
Rickard
RFC 2635 Don’t SPEW A Set of Guidelines for Mass Unsolicited Mailings and
Postings (spam*) S. Hambridge, A. Lunde
RFC 2637 Point-to-Point Tunneling Protocol K. Hamzeh, G. Pall, W. Verthein, J.
Taarud, W. Little, G. Zorn
RFC 2640 Internationalization of the File Transfer Protocol B. Curtin

RFC 2665 Definitions of Managed Objects for the Ethernet-like Interface Types J.
Flick, J. Johnson
RFC 2671 Extension Mechanisms for DNS (EDNS0) P. Vixie
RFC 2672 Non-Terminal DNS Name Redirection M. Crawford
RFC 2675 IPv6 Jumbograms D. Borman, S. Deering, R. Hinden
RFC 2710 Multicast Listener Discovery (MLD) for IPv6 S. Deering, W. Fenner, B.
Haberman
RFC 2711 IPv6 Router Alert Option C. Partridge, A. Jackson
RFC 2740 OSPF for IPv6 R. Coltun, D. Ferguson, J. Moy
RFC 2753 A Framework for Policy-based Admission Control R. Yavatkar, D.
Pendarakis, R. Guerin
RFC 2782 A DNS RR for specifying the location of services (DNS SRV) A.
Gubrandsen, P. Vixix, L. Esibov
RFC 2821 Simple Mail Transfer Protocol J. Klensin, Ed.
RFC 2822 Internet Message Format P. Resnick, Ed.
RFC 2840 TELNET KERMIT OPTION J. Altman, F. da Cruz
RFC 2845 Secret Key Transaction Authentication for DNS (TSIG) P. Vixie, O.
Gudmundsson, D. Eastlake 3rd, B. Wellington
RFC 2851 Textual Conventions for Internet Network Addresses M. Daniele, B.
Haberman, S. Routhier, J. Schoenwaelder
RFC 2852 Deliver By SMTP Service Extension D. Newman
RFC 2874 DNS Extensions to Support IPv6 Address Aggregation and Renumbering
M. Crawford, C. Huitema
RFC 2915 The Naming Authority Pointer (NAPTR) DNS Resource Record M.
Mealling, R. Daniel
RFC 2920 SMTP Service Extension for Command Pipelining N. Freed
RFC 2930 Secret Key Establishment for DNS (TKEY RR) D. Eastlake, 3rd
RFC 2941 Telnet Authentication Option T. Ts’o, ed., J. Altman
RFC 2942 Telnet Authentication: Kerberos Version 5 T. Ts’o
RFC 2946 Telnet Data Encryption Option T. Ts’o
RFC 2952 Telnet Encryption: DES 64 bit Cipher Feedback T. Ts’o
RFC 2953 Telnet Encryption: DES 64 bit Output Feedback T. Ts’o
RFC 2992 Analysis of an Equal-Cost Multi-Path Algorithm C. Hopps
RFC 3019 IP Version 6 Management Information Base for The Multicast Listener
Discovery Protocol B. Haberman, R. Worzella
RFC 3060 Policy Core Information Model—Version 1 Specification B. Moore, E.
Ellesson, J. Strassner, A. Westerinen
RFC 3152 Delegation of IP6.ARPA R. Bush
RFC 3164 The BSD Syslog Protocol C. Lonvick
RFC 3291 Textual Conventions for Internet Network Addresses M. Daniele, B.
Haberman, S. Routhier, J. Schoenwaelder

RFC 3363 Representing Internet Protocol version 6 (IPv6) Addresses in the Domain
Name System R. Bush, A. Durand, B. Fink, O. Gudmundsson, T.
Hain
| RFC 3376 Internet Group Management Protocol, Version 3 B. Cain, S. Deering, I.
| Kouvelas, B. Fenner, A. Thyagarajan
RFC 3390 Increasing TCP’s Initial Window M. Allman, S. Floyd, C. Partridge
RFC 3410 Introduction and Applicability Statements for Internet-Standard
Management Framework J. Case, R. Mundy, D. Partain, B. Stewart
RFC 3411 An Architecture for Describing Simple Network Management Protocol
(SNMP) Management Frameworks D. Harrington, R. Presuhn, B.
Wijnen
Wijnen
RFC 3413 Simple Network Management Protocol (SNMP) Applications D. Levi, P.
Meyer, B. Stewart
RFC 3419 Textual Conventions for Transport Addresses M. Daniele, J.
Schoenwaelder
RFC 3484 Default Address Selection for Internet Protocol version 6 (IPv6) R.
Draves
RFC 3493 Basic Socket Interface Extensions for IPv6 R. Gilligan, S. Thomson, J.
Bound, J. McCann, W. Stevens
RFC 3513 Internet Protocol Version 6 (IPv6) Addressing Architecture R. Hinden,
S. Deering
RFC 3526 More Modular Exponential (MODP) Diffie-Hellman groups for Internet
Key Exchange (IKE) T. Kivinen, M. Kojo
RFC 3542 Advanced Sockets Application Programming Interface (API) for IPv6 W.
Richard Stevens, M. Thomas, E. Nordmark, T. Jinmei
| RFC 3569 An Overview of Source-Specific Multicast (SSM) S. Bhattacharyya, Ed.
RFC 3584 Coexistence between Version 1, Version 2, and Version 3 of the
Internet-standard Network Management Framework R. Frye, D. Levi, S.
Routhier, B. Wijnen
RFC 3602 The AES-CBC Cipher Algorithm and Its Use with IPsec S. Frankel, R.
Glenn, S. Kelly
RFC 3629 UTF-8, a transformation format of ISO 10646 R. Kermode, C. Vicisano
RFC 3658 Delegation Signer (DS) Resource Record (RR) O. Gudmundsson
| RFC 3678 Socket Interface Extensions for Multicast Source Filters D. Thaler, B.
| Fenner, B. Quinn
RFC 3715 IPsec-Network Address Translation (NAT) Compatibility Requirements B.
Aboba, W. Dixon

| RFC 3810 Multicast Listener Discovery Version 2 (MLDv2) for IPv6 R. Vida, Ed.,
| L. Costa, Ed.
RFC 3947 Negotiation of NAT-Traversal in the IKE T. Kivinen, B. Swander, A.
Huttunen, V. Volpe
RFC 3948 UDP Encapsulation of IPsec ESP Packets A. Huttunen, B. Swander, V.
Volpe, L. DiBurro, M. Stenberg
| RFC 4007 IPv6 Scoped Address Architecture S. Deering, B. Haberman, T. Jinmei,
| E. Nordmark, B. Zill
| RFC 4217 Securing FTP with TLS P. Ford-Hutchinson
Internet drafts
Internet drafts are working documents of the Internet Engineering Task Force
(IETF), its areas, and its working groups. Other groups may also distribute
working documents as Internet drafts. You can see Internet drafts at
http://www.ietf.org/ID.html.
Several areas of IPv6 implementation include elements of the following Internet

drafts and are subject to change during the RFC review process.
Draft Title and Author
draft-bivens-sasp-02
Server/Application State Protocol v1 A. Bivens
draft-ietf-ipngwg-icmp-v3-07
Internet Control Message Protocol (ICMPv6) for the Internet Protocol Version 6
(IPv6) Specification A. Conta, S. Deering
draft-ietf-ipsec-esp-v3-10
IP Encapsulating Security Payload (ESP) S. Kent
draft-ietf-ipsec-rfc2402bis-11
IP Authentication Header S. Kent
draft-ietf-ipsec-rfc2401bis-06
Security Architecture for the Internet Protocol S. Kent, K. Seo
draft-ietf-ospf-ospfv3-auth-07
Authentication/Confidentiality for OSPFv3 M. Gupta, N. Melam

Appendix E. Information APARs and technotes
This appendix lists information APARs for IP and SNA documents.
Note:
1. Information APARs contain updates to previous editions of the
documents listed in Table 31 and Table 32 on page 466. Documents
updated for V1R9 are complete except for the updates contained in the
information APARs that might be issued after V1R9 documents went to
press.
2. Information APARs are predefined for z/OS V1R9 Communications
Server and might not contain updates.
3. Information APARs for z/OS documents are in the document called z/OS
and z/OS.e DOC APAR and PTF ++HOLD Documentation, which can be
found at http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/
BOOKS/ZIDOCMST/CCONTENTS.
Information APARs for IP documents

Table 31 lists information APARs for V1R6 IP documents. For releases V1R7 and
later, updates are available as technotes, which can be found at
http://www.ibm.com/support/docview.wss?uid=swg21178966.
| Table 31. IP information APARs for z/OS Communications Server
| Title Information APAR for V1R6
| New Function Summary (both IP and SNA) II13824
| Quick Reference (both IP and SNA) II13831
| IP and SNA Codes II13842
| IP Sockets API Guide II13844
| IP Configuration Guide II13826
| IP Configuration Reference II13827
| IP Diagnosis II13836
| IP Messages Volume 1 II13838
| IPv6 Network and Application Design Guide II13825
| IP Programmer’s Guide and Reference II13843
| IP User’s Guide and Commands II13832
| IP System Admininstrator’s Commands II13833
|

Information APARs for SNA documents
Table 32 lists information APARs for V1R6 SNA documents. For releases V1R7 and
later, updates are available as technotes, which can be found at
http://www.ibm.com/support/docview.wss?uid=swg21178966.
| Table 32. SNA information APARs for z/OS Communications Server
| Title Information APAR for V1R6
| New Function Summary (both IP and SNA) II13824
| Quick Reference (both IP and SNA) II13831
| IP and SNA Codes II13842
| SNA Customization II13857
| SNA Diagnosis, Vol. 1: Techniques and Procedures II13852
| SNA Diagnosis, Vol. 2: FFST Dumps and the VIT II13853
| SNA Messages II13854
| SNA Network Implementation Guide II13849
| SNA Operation II13851
| SNA Programming II13858
| SNA Resource Definition Reference II13850
| SNA Data Areas Volume 1 II13855
| SNA Data Areas Volume 2 II13856
|
Other information APARs

Table 33 lists information APARs not related to documents.
Table 33. Non-document information APARs
Content Number
Index to APARs that list recommended VTAM maintenance II11220
Index to APARs that list trace and dump requests for VTAM problems II13202
Index of Communication Server IP information APARs II12028
Collecting TCPIP CTRACEs II12014
CSM for VTAM II13442
CSM for TCP/IP II13951
| DLUR/DLUS II12986, II13456, and II13783
| Documentation required for FTP server problems II12925
Documentation required for OSA/2, OSA Express and OSA QDIO II13016
DNS — common problems and solutions II13453
Enterprise Extender II12223
| FTP client and FTP server TLS support II13516
FTP problems II12079
FTPing doc to z/OS Ssupport II12030
Generic resources II10986
HPR II10953

Table 33. Non-document information APARs (continued)
Content Number
iQDIO II13142
LPR problems II12022
MNPS II10370
MPC and CTC II01501
NCPROUTE problems II12025
OMPROUTE II12026
PASCAL API II11814
Performance
II11710
II11711
II11712
Resolver
II13398
II13399
II13452
Socket API
II11996
II12020
SMTP problems II12023
SNMP
II13477
II13478
SYSLOGD howto II12021
TCPIP connection states II12449
| TN3270E Telnet server
| II11574
| II13135
| TN3270E Telnet server SSL common problems II13369
Appendix E. Information APARs and technotes 467

Appendix F. Accessibility
Accessibility features help a user who has a physical disability, such as restricted
mobility or limited vision, to use software products successfully. The major
accessibility features in z/OS enable users to:
v Use assistive technologies such as screen readers and screen magnifier software
v Operate specific or equivalent features using only the keyboard
v Customize display attributes such as color, contrast, and font size
Using assistive technologies

Assistive technology products, such as screen readers, function with the user
interfaces found in z/OS. Consult the assistive technology documentation for
specific information when using such products to access z/OS interfaces.
Keyboard navigation of the user interface

Users can access z/OS user interfaces using TSO/E or ISPF. Refer to z/OS TSO/E
Primer, z/OS TSO/E User’s Guide, and z/OS ISPF User’s Guide Vol I for information
about accessing TSO/E and ISPF interfaces. These guides describe how to use
TSO/E and ISPF, including the use of keyboard shortcuts or function keys (PF
keys). Each guide includes the default settings for the PF keys and explains how to
modify their functions.
z/OS information
z/OS information is accessible using screen readers with the BookServer/Library
Server versions of z/OS books in the Internet library at:
www.ibm.com/servers/eserver/zseries/zos/bkserv/

Notices
IBM may not offer all of the products, services, or features discussed in this
document. Consult your local IBM representative for information on the products
and services currently available in your area. Any reference to an IBM product,
program, or service is not intended to state or imply that only that IBM product,
program, or service may be used. Any functionally equivalent product, program,
or service that does not infringe any IBM intellectual property right may be used
instead. However, it is the user’s responsibility to evaluate and verify the operation
of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing

IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation

Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION ″AS IS″ WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this statement may not apply
to you.
This information could include technical inaccuracies or typographical errors.

Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this IBM
product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:
Site Counsel
IBM Corporation
P.O. Box 12195
3039 Cornwallis Road
U.S.A
Such information may be available, subject to appropriate terms and conditions,

including in some cases, payment of a fee.
The licensed program described in this information and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement, or any equivalent agreement
between us.
Any performance data contained herein was determined in a controlled

environment. Therefore, the results obtained in other operating environments may
vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be the same on
generally available systems. Furthermore, some measurement may have been
estimated through extrapolation. Actual results may vary. Users of this document
should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of

those products, their published announcements or other publicly available sources.
IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.
All statements regarding IBM’s future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.
All IBM prices shown are IBM’s suggested retail prices, are current and are subject
to change without notice. Dealer prices may vary.
This information is for planning purposes only. The information herein is subject to
change before the products described become available.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which

illustrates programming techniques on various operating platforms. You may copy,
modify, and distribute these sample programs in any form without payment to
IBM, for the purposes of developing, using, marketing or distributing application

programs conforming to the application programming interface for the operating
platform for which the sample programs are written. These examples have not
been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or
imply reliability, serviceability, or function of these programs. You may copy,
modify, and distribute these sample programs in any form without payment to
IBM for the purposes of developing, using, marketing, or distributing application
programs conforming to IBM’s application programming interfaces.
Each copy or any portion of these sample programs or any derivative work must
include a copyright notice as follows:
© (your company name) (year). Portions of this code are derived from IBM Corp.
Sample Programs. © Copyright IBM Corp. _enter the year or years_. All rights
reserved.
IBM is required to include the following statements in order to distribute portions

of this document and the software described herein to which contributions have
been made by The University of California. Portions herein © Copyright 1979,
1980, 1983, 1986, Regents of the University of California. Reproduced by
permission. Portions herein were developed at the Electrical Engineering and
Computer Sciences Department at the Berkeley campus of the University of
California under the auspices of the Regents of the University of California.
Portions of this publication relating to RPC are Copyright © Sun Microsystems,

Inc., 1988, 1989.
Some portions of this publication relating to X Window System** are Copyright ©

1987, 1988 by Digital Equipment Corporation, Maynard, Massachusetts, and the
Massachusetts Institute Of Technology, Cambridge, Massachusetts. All Rights
Reserved.
Some portions of this publication relating to X Window System are Copyright ©

1986, 1987, 1988 by Hewlett-Packard Corporation.
Permission to use, copy, modify, and distribute the M.I.T., Digital Equipment
Corporation, and Hewlett-Packard Corporation portions of this software and its
documentation for any purpose without fee is hereby granted, provided that the
above copyright notice appears in all copies and that both that copyright notice
and this permission notice appear in supporting documentation, and that the
names of M.I.T., Digital, and Hewlett-Packard not be used in advertising or
publicity pertaining to distribution of the software without specific, written prior
permission. M.I.T., Digital, and Hewlett-Packard make no representation about the
suitability of this software for any purpose. It is provided ″as is″ without express
or implied warranty.
Copyright © 1983, 1995-1997 Eric P. Allman
Copyright © 1988, 1993 The Regents of the University of California. All rights
reserved.
Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list
of conditions and the following disclaimer.
Notices 473
2. Redistributions in binary form must reproduce the above copyright notice, this
list of conditions and the following disclaimer in the documentation and/or
other materials provided with the distribution.
3. All advertising materials mentioning features or use of this software must
display the following acknowledgement:
This product includes software developed by the University of
California, Berkeley and its contributors.
4. Neither the name of the University nor the names of its contributors may be
used to endorse or promote products derived from this software without
specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS `ÀS

IS’’ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
This software program contains code, and/or derivatives or modifications of code

originating from the software program ″Popper.″ Popper is Copyright ©1989-1991
The Regents of the University of California, All Rights Reserved. Popper was
created by Austin Shelton, Information Systems and Technology, University of
California, Berkeley.
Permission from the Regents of the University of California to use, copy, modify,
and distribute the ″Popper″ software contained herein for any purpose, without
fee, and without a written agreement is hereby granted, provided that the above
copyright notice and this paragraph and the following two paragraphs appear in
all copies. HOWEVER, ADDITIONAL PERMISSIONS MAY BE NECESSARY
FROM OTHER PERSONS OR ENTITIES, TO USE DERIVATIVES OR
MODIFICATIONS OF POPPER.
IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY

PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL
DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THE
POPPER SOFTWARE, OR ITS DERIVATIVES OR MODIFICATIONS, AND ITS
DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY

WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE POPPER SOFTWARE PROVIDED HEREUNDER IS ON AN ″AS
IS″ BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS
TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR
MODIFICATIONS.
Copyright © 1983 The Regents of the University of California. All rights reserved.

Redistribution and use in source and binary forms are permitted provided that the
above copyright notice and this paragraph are duplicated in all such forms and
that any documentation, advertising materials, and other materials related to such
distribution and use acknowledge that the software was developed by the
University of California, Berkeley. The name of the University may not be used to
endorse or promote products derived from this software without specific prior
written permission. THIS SOFTWARE IS PROVIDED `ÀS IS’’ AND WITHOUT
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT
LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE.
Copyright © 1991, 1993 The Regents of the University of California. All rights
reserved.
1. Redistributions of source code must retain the above copyright notice, this list
of conditions and the following disclaimer.
display the following acknowledgement:
This product includes software developed by the University of
California, Berkeley and its contributors.
4. Neither the name of the University nor the names of its contributors may be
used to endorse or promote products derived from this software without
specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS `ÀS

IS’’ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
Copyright © 1990 by the Massachusetts Institute of Technology
Export of this software from the United States of America may require a specific
license from the United States Government. It is the responsibility of any person or
organization contemplating export to obtain such a license before exporting.
WITHIN THAT CONSTRAINT, permission to use, copy, modify, and distribute this
software and its documentation for any purpose and without fee is hereby granted,
provided that the above copyright notice appear in all copies and that both that
copyright notice and this permission notice appear in supporting documentation,
and that the name of M.I.T. not be used in advertising or publicity pertaining to
distribution of the software without specific, written prior permission. Furthermore
Notices 475
if you modify this software you must label your software as modified software and
not distribute it in such a fashion that it might be confused with the original M.I.T.
software. M.I.T. makes no representations about the suitability of this software for
any purpose. It is provided ″as is″ without express or implied warranty.
Copyright © 1998 by the FundsXpress, INC. All rights reserved.
Export of this software from the United States of America may require a specific
license from the United States Government. It is the responsibility of any person or
organization contemplating export to obtain such a license before exporting.
WITHIN THAT CONSTRAINT, permission to use, copy, modify, and distribute this
software and its documentation for any purpose and without fee is hereby granted,
provided that the above copyright notice appear in all copies and that both that
copyright notice and this permission notice appear in supporting documentation,
and that the name of FundsXpress not be used in advertising or publicity
pertaining to distribution of the software without specific, written prior
permission. FundsXpress makes no representations about the suitability of this
software for any purpose. It is provided ″as is″ without express or implied
warranty.
THIS SOFTWARE IS PROVIDED `ÀS IS’’ AND WITHOUT ANY EXPRESS OR

IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE.
Copyright © 1999, 2000 Internet Software Consortium.
Permission to use, copy, modify, and distribute this software for any purpose with
or without fee is hereby granted, provided that the above copyright notice and this
permission notice appear in all copies.
THE SOFTWARE IS PROVIDED ″AS IS″ AND INTERNET SOFTWARE

CONSORTIUM DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE CONSORTIUM
BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
Copyright © 1995-1998 Eric Young (eay@cryptsoft.com) All rights reserved.
This package is an SSL implementation written by Eric Young (eay@cryptsoft.com).

The implementation was written so as to conform with Netscape’s SSL.
This library is free for commercial and non-commercial use as long as the
following conditions are adhered to. The following conditions apply to all code
found in this distribution, be it the RC4, RSA, lhash, DES, etc., code; not just the
SSL code. The SSL documentation included with this distribution is covered by the
same copyright terms except that the holder is Tim Hudson (tjh@cryptsoft.com).
Copyright remains Eric Young’s, and as such any Copyright notices in the code are
not to be removed. If this package is used in a product, Eric Young should be

given attribution as the author of the parts of the library used. This can be in the
form of a textual message at program startup or in documentation (online or
textual) provided with the package.
1. Redistributions of source code must retain the copyright notice, this list of
conditions and the following disclaimer.
display the following acknowledgement: ″This product includes cryptographic
software written by Eric Young (eay@cryptsoft.com)″. The word ’cryptographic’
can be left out if the routines from the library being used are not cryptographic
related.
4. If you include any Windows specific code (or a derivative thereof) from the
apps directory (application code) you must include acknowledgement:
″This product includes software written by Tim Hudson (tjh@cryptsoft.com)″
THIS SOFTWARE IS PROVIDED BY ERIC YOUNG `ÀS IS’’ AND ANY EXPRESS
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGE.
The license and distribution terms for any publicly available version or derivative
of this code cannot be changed. i.e. this code cannot simply be copied and put
under another distribution license [including the GNU Public License.]
This product includes cryptographic software written by Eric Young.
Copyright © 1999, 2000 Internet Software Consortium.
Permission to use, copy, modify, and distribute this software for any purpose with
or without fee is hereby granted, provided that the above copyright notice and this
permission notice appear in all copies.
THE SOFTWARE IS PROVIDED ″AS IS″ AND INTERNET SOFTWARE

CONSORTIUM DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE CONSORTIUM
BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
Notices 477
Copyright © 2004 IBM Corporation and its licensors, including Sendmail, Inc., and
the Regents of the University of California. All rights reserved.
Copyright © 1999,2000,2001 Compaq Computer Corporation
Copyright © 1999,2000,2001 Hewlett-Packard Company
Copyright © 1999,2000,2001 IBM Corporation
Copyright © 1999,2000,2001 Hummingbird Communications Ltd.
Copyright © 1999,2000,2001 Silicon Graphics, Inc.
Copyright © 1999,2000,2001 Sun Microsystems, Inc.
Copyright © 1999,2000,2001 The Open Group
All rights reserved.
Permission is hereby granted, free of charge, to any person obtaining a copy of this
software and associated documentation files (the ″Software″), to deal in the
Software without restriction, including without limitation the rights to use, copy,
modify, merge, publish, distribute, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, provided that the
above copyright notice(s) and this permission notice appear in all copies of the
Software and that both the above copyright notice(s) and this permission notice
appear in supporting documentation.
THE SOFTWARE IS PROVIDED ″AS IS″, WITHOUT WARRANTY OF ANY KIND,

EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE
COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE BE LIABLE
FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL
DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
Except as contained in this notice, the name of a copyright holder shall not be used
in advertising or otherwise to promote the sale, use or other dealings in this
Software without prior written authorization of the copyright holder.
X Window System is a trademark of The Open Group.
If you are viewing this information softcopy, photographs and color illustrations
may not appear.
You can obtain softcopy from the z/OS Collection (SK3T-4269), which contains
BookManager and PDF formats.

Trademarks
The following terms are trademarks of the IBM Corporation in the United States or
other countries or both:
Advanced Peer-to-Peer Networking NetView

AFS Network Station
AD/Cycle Nways
AIX OfficeVision
AIX/ESA OS/2
AnyNet OS/390
APL2 Parallel Sysplex
AS/400 PROFS
BookManager pSeries
C/370 RACF
CICS Redbooks
CICS/ESA RETAIN
C Set ++ REXX
Common User Access RISC System/6000
CUA RMF
DB2 RS/6000
DFSMS S/370
DFSMSdfp S/390
DFSMShsm S/390 Parallel Enterprise Server
DPI SAA
ESCON SecureWay
eServer SET
ES/9000 SiteCheck
FFST SP
FICON System/360
First Failure Support Technology System/370
GDDM System/390
IBM System z
ibm.com System z9
IBMLink Tivoli
IMS Tivoli Enterprise Console
IMS/ESA VM/ESA
HiperSockets VSE/ESA
Language Environment VTAM
Micro Channel WebSphere
Multiprise z9
MVS z/Architecture
MVS/DFP z/OS
MVS/ESA z/VM
MVS/SP zSeries
400
The following terms are trademarks of other companies:
Notices 479
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the
United States, other countries, or both.
Linux is a trademark of Linus Torvalds in the United States, other countries, or

both.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation in

the United States, other countries, or both.
Intel is a registered trademark of Intel Corporation or its subsidiaries in the United

States and other countries.
PostScript is a registered trademark of Adobe Systems Incorporated in the United

States, other countries, or both.
Other company, product or service names may be trademarks or service marks of

others.

Bibliography
z/OS Communications Server information
This section contains descriptions of the documents in the z/OS Communications
Server library.
z/OS Communications Server documentation is available:

v Online at the z/OS Internet Library web page at http://www.ibm.com/servers/
eserver/zseries/zos/bkserv
v In softcopy on CD-ROM collections. See “Softcopy information” on page xxi.
z/OS Communications Server library

z/OS Communications Server documents are available on the CD-ROM
accompanying z/OS (SK3T-4269 or SK3T-4307). Unlicensed documents can be
viewed at the z/OS Internet library site.
Updates to documents are available on RETAIN® and in information APARs (info

APARs). See Appendix E, “Information APARs and technotes,” on page 465 for a
list of the documents and the info APARs associated with them.
Info APARs for z/OS documents are in the document called z/OS and z/OS.e DOC
APAR and PTF ++HOLD Documentation which can be found at
http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/ BOOKS/ZIDOCMST/
CCONTENTS.
Planning
Title Number Description
z/OS Communications Server: GC31-8771 This document is intended to help you plan for new IP for SNA
New Function Summary function, whether you are migrating from a previous version or
installing z/OS for the first time. It summarizes what is new in
the release and identifies the suggested and required
modifications needed to use the enhanced functions.
z/OS Communications Server: SC31-8885 This document is a high-level introduction to IPv6. It describes
IPv6 Network and Application concepts of z/OS Communications Server’s support of IPv6,
Design Guide coexistence with IPv4, and migration issues.
Resource definition, configuration, and tuning

z/OS Communications Server: IP SC31-8775 This document describes the major concepts involved in
Configuration Guide understanding and configuring an IP network. Familiarity with
the z/OS operating system, IP protocols, z/OS UNIX System
Services, and IBM Time Sharing Option (TSO) is recommended.
Use this document in conjunction with the z/OS Communications

z/OS Communications Server: IP SC31-8776 This document presents information for people who want to
Configuration Reference administer and maintain IP. Use this document in conjunction
with the z/OS Communications Server: IP Configuration Guide. The
information in this document includes:
v TCP/IP configuration data sets
v Configuration statements
v Translation tables
v SMF records
v Protocol number and port assignments
z/OS Communications Server: SC31-8777 This document presents the major concepts involved in
SNA Network Implementation implementing an SNA network. Use this document in
Guide conjunction with the z/OS Communications Server: SNA Resource
Definition Reference.
z/OS Communications Server: SC31-8778 This document describes each SNA definition statement, start
SNA Resource Definition Reference option, and macroinstruction for user tables. It also describes
NCP definition statements that affect SNA. Use this document in
conjunction with the z/OS Communications Server: SNA Network
Implementation Guide.
z/OS Communications Server: SC31-8836 This document contains sample definitions to help you
SNA Resource Definition Samples implement SNA functions in your networks, and includes
sample major node definitions.
z/OS Communications Server: IP SC31-8833 This document is for system programmers and network
Network Print Facility administrators who need to prepare their network to route SNA,
JES2, or JES3 printer output to remote printers using TCP/IP
Services.
Operation
z/OS Communications Server: IP SC31-8780 This document describes how to use TCP/IP applications. It
User’s Guide and Commands contains requests that allow a user to log on to a remote host
using Telnet, transfer data sets using FTP, send and receive
electronic mail, print on remote printers, and authenticate
network users.
z/OS Communications Server: IP SC31-8781 This document describes the functions and commands helpful in
System Administrator’s Commands configuring or monitoring your system. It contains system
administrator’s commands, such as TSO NETSTAT, PING,
TRACERTE and their UNIX counterparts. It also includes TSO
and MVS commands commonly used during the IP
configuration process.
z/OS Communications Server: SC31-8779 This document serves as a reference for programmers and
SNA Operation operators requiring detailed information about specific operator
commands.
z/OS Communications Server: SX75-0124 This document contains essential information about SNA and IP
Quick Reference commands.

Customization
z/OS Communications Server: SC31-6854 This document enables you to customize SNA, and includes the
SNA Customization following:
v Communication network management (CNM) routing table
v Logon-interpret routine requirements
v Logon manager installation-wide exit routine for the CLU
search exit
v TSO/SNA installation-wide exit routines
v SNA installation-wide exit routines
Writing application programs

z/OS Communications Server: IP SC31-8788 This document describes the syntax and semantics of program
Sockets Application Programming source code necessary to write your own application
Interface Guide and Reference programming interface (API) into TCP/IP. You can use this
interface as the communication base for writing your own client
or server application. You can also use this document to adapt
your existing applications to communicate with each other using
sockets over TCP/IP.
z/OS Communications Server: IP SC31-8807 This document is for programmers who want to set up, write
CICS Sockets Guide application programs for, and diagnose problems with the socket
interface for CICS® using z/OS TCP/IP.
z/OS Communications Server: IP SC31-8830 This document is for programmers who want application
IMS Sockets Guide programs that use the IMS™ TCP/IP application development
services provided by IBM’s TCP/IP Services.
z/OS Communications Server: IP SC31-8787 This document describes the syntax and semantics of a set of
Programmer’s Guide and Reference high-level application functions that you can use to program
your own applications in a TCP/IP environment. These
functions provide support for application facilities, such as user
authentication, distributed databases, distributed processing,
network management, and device sharing. Familiarity with the
z/OS operating system, TCP/IP protocols, and IBM Time
Sharing Option (TSO) is recommended.
z/OS Communications Server: SC31-8829 This document describes how to use SNA macroinstructions to
SNA Programming send data to and receive data from (1) a terminal in either the
same or a different domain, or (2) another application program
in either the same or a different domain.
z/OS Communications Server: SC31-8811 This document describes how to use the SNA LU 6.2 application
SNA Programmer’s LU 6.2 Guide programming interface for host application programs. This
document applies to programs that use only LU 6.2 sessions or
that use LU 6.2 sessions along with other session types. (Only
LU 6.2 sessions are covered in this document.)
z/OS Communications Server: SC31-8810 This document provides reference material for the SNA LU 6.2
SNA Programmer’s LU 6.2 programming interface for host application programs.
Reference
z/OS Communications Server: SC31-8808 This document describes how applications use the
CSM Guide communications storage manager.
Bibliography 483
z/OS Communications Server: SC31-8828 This document describes the Common Management Information
CMIP Services and Topology Protocol (CMIP) programming interface for application
Agent Guide programmers to use in coding CMIP application programs. The
document provides guide and reference information about CMIP
services and the SNA topology agent.
Diagnosis
z/OS Communications Server: IP GC31-8782 This document explains how to diagnose TCP/IP problems and
Diagnosis Guide how to determine whether a specific problem is in the TCP/IP
product code. It explains how to gather information for and
describe problems to the IBM Software Support Center.
z/OS Communications Server: These documents help you identify an SNA problem, classify it,
SNA Diagnosis Vol 1, Techniques GC31-6850 and collect information about it before you call the IBM Support
and Procedures and z/OS Center. The information collected includes traces, dumps, and
Communications Server: SNA GC31-6851 other problem documentation.
Diagnosis Vol 2, FFST Dumps and
the VIT
z/OS Communications Server: These documents describe SNA data areas and can be used to
SNA Data Areas Volume 1 and GC31-6852 read an SNA dump. They are intended for IBM programming
z/OS Communications Server: service representatives and customer personnel who are
SNA Data Areas Volume 2 GC31-6853 diagnosing problems with SNA.
Messages and codes

z/OS Communications Server: SC31-8790 This document describes the ELM, IKT, IST, IUT, IVT, and USS
SNA Messages messages. Other information in this document includes:
v Command and RU types in SNA messages
v Node and ID types in SNA messages
v Supplemental message-related information
z/OS Communications Server: IP SC31-8783 This volume contains TCP/IP messages beginning with EZA.
Messages Volume 1 (EZA)
z/OS Communications Server: IP SC31-8784 This volume contains TCP/IP messages beginning with EZB or
Messages Volume 2 (EZB, EZD) EZD.
z/OS Communications Server: IP SC31-8785 This volume contains TCP/IP messages beginning with EZY.
Messages Volume 3 (EZY)
z/OS Communications Server: IP SC31-8786 This volume contains TCP/IP messages beginning with EZZ and
Messages Volume 4 (EZZ, SNM) SNM.
z/OS Communications Server: IP SC31-8791 This document describes codes and other information that
and SNA Codes appear in z/OS Communications Server messages.

Index
Special characters ASAtrans parameter 274
ASCII
-d (RSH parameter) 413 ASCII control characters 22
-l (RSH parameter) 413 FTP JIS78KJ parameter 188
-s port (RSH parameter) 413 FTP JIS83KJ parameter 189, 191
! (FTP subcommand) 142 FTP subcommand 146
transferring binary data to EBCDIC 315
transferring text data to EBCDIC 315
Numerics AT host
3270 DBCS Transform mode conversion types LPQ parameter 364
DECKANJI 26 LPR parameter 368
EUCKANJI 26 LPRM parameter 379
HANGEUL 26 attached graphics cursor (GDDM/MVS) 386
JIS78KJ 26 authorizations for data and programs 6
JIS83KJ 26 AUTOMOUNT
KSC5601 26 FTP LOCSITE and SITE parameter 197, 274
SJISKANJI 26 AUTORECALL
TCHINESE 26 FTP LOCSITE and SITE parameter 198, 274
3270 DBCS Transform mode description 24 AYT (TELNET subcommand) 15
3270 DBCS Transform mode terminal types
TTY 26
VT100 26 B
VT282 26 B parameter
802.3 network protocol 2 FTP MODE 242
FTP TYPE 315
BATCH (SMTPNOTE parameter) 326
A batch commands
A (FTP TYPE parameter) 315 DATA 339
accessibility 469 EXPN 341
account_information (FTP ACCT parameter) 143 HELO 342
ACCT (FTP subcommand) 143 HELP 343
addresses MAIL FROM 344
class A network 7 NOOP 345
description 2, 3 QUEU 346
loopback 7 QUIT 348
path 336 RCPT TO 349
TCP/IP (idx4) 3 RSET 350
AIX files 433 STATS 331
all TICK 351
FTP HELP parameter 186 VERB 352
LPQ parameter 364 VRFY 353
allocating data sets batch SMTP examples 355
FTP input and output data sets 38 batch, submitting FTP requests in batch 98
new data sets 91 BIG5
alphanumeric cursor (GDDM/MVS) 386 FTP subcommand 148
ANFontn (GDDMXD option) 392 LPR parameter 368
AO (TELNET subcommand) 14 BINARY
APL2 Character Set keyboard 404, 435 FTP subcommand 150
APPEND (FTP subcommand) 144 LPR parameter 368
appending a local data set to a remote host 144 blinking character attribute (GDDM/MVS) 386
applications, functions, and protocols BLOCK (FTP subcommand) 151
File Transfer Protocol (FTP) 29, 53 block mode (FTP) 242
Graphical Data Display Manager Interface for X Windows BLocks (FTP LOCSITE and SITE parameter) 198, 274
(GDDMXD) 385 BLOCKSIZE
Network Database System (NDB) 421 FTP LOCSITE and SITE parameter 198, 274
OS/390 UNIX Remote Execution Protocol (orexec) 405, BRK (TELNET subcommand) 16
415 BUFNO
Remote Printing (LPR and LPD) 363 FTP LOCSITE and SITE parameter 275
Simple Mail Transfer Protocol (SMTP) 323 BURST (LPR parameter) 369
Telnet 9
AS/400 files 433

C creating
a directory on a foreign host 239
C (FTP MODE parameter) 242 a PDS on the local host 225
carriage return, suppressing (TELNET) 23 an input data set with the SQL query 130
CC CYLINDERS (FTP LOCSITE and SITE parameter) 201, 277
LPR parameter 369
SMTPNOTE parameter 325
CCTRANS (FTP.DATA parameter) 88
CD (FTP subcommand) 153 D
CDUP (FTP subcommand) 156 DATA (SMTP command) 339
changing data compression 242
directory of a VM FTP server 154 data sets
directory of an MVS FTP server 153 FTP input 38
directory on a foreign host 153 FTP output 38
local site defaults using FTP.DATA 70 NETRC.DATA 40, 408, 415
to the parent of the current directory 156 partitioned 429, 430
TSO user ID password 320 sequential 55, 429, 430
working directory 193 TSO 429
working level qualifier 193 data sets transfer
character display (GDDM/MVS) 386 using z/OS Communications Server xv
checkpointing 263, 275 data transfer
allow opening of data set 210 methods 55, 432
prevent opening of data set 207 types 55
restarting data transfer 263 data transfer type conversion
CHKPTInt (FTP LOCSITE and SITE parameter) 275 ASCII 146
class A network addresses 7 EBCDIC 175
class, LPR parameter 369 EUCKANJI 176
CLEAR (FTP subcommand) 158 HANGEUL 184
clearing the data path (TELNET) 21 IBMKANJI 187
client, description 2 image 150
CLOSE (FTP subcommand) 159 JIS78KJ 188
CMap (GDDMXD option) 393 JIS83KJ 189
codes KSC-5601 190
internal error 110 SJISKANJI 297
reply 109 TCHINESE 312
return 106 data_set (FTP LMKDIR parameter) 225
subcommand 107 data_set_name (LPR parameter) 369
color mixing (GDDM/MVS) 387 DATACLAS
command (RSH parameter) 413 FTP LOCSITE and SITE parameter 201, 277
command_line (TSO parameter) 314 DATASET (SMTPNOTE parameter) 326
command_name (SMTP HELP parameter) 343 DATASETMODE (FTP LOCSITE and SITE parameter) 46,
commands 202, 278
FTP 4, 5, 30 DATE (SMTP QUEU parameter) 346
GDDMXD 388 DB2
PROFILE 42 FTP LOCSITE and SITE parameter 202, 278
RECEIVE 5, 328 SQL queries with FTP 129
REXEC 5 subsystems in FTP 131
RSH 412, 413 DB2 database 129
SMSG (general user) 330 DBCS
SMSG (privileged user) 334 converting mail 357
TELNET 4, 10 DBCS support for FTP 87
communication media 1 DBCS support for SMTP 357
Communications Server for z/OS, commands 4 DBCS support for TELNET 24
Communications Server for z/OS, online information xxiii DBCS translation tables 87
Compr (GDDMXD option) 394 setting transfer type 88
COMPRESS (FTP subcommand) 160 DBCS subcommands
compressed mode (FTP) 242 QUOTE 259
computer networks 1 TYPE 315
connecting to a foreign host FTP server 41, 247 TYPE aliases 89
control characters, sending 22 DCBDSN
converting DBCS mail 357 FTP LOCSITE and SITE parameter 202, 278
COPIES (LPR parameter) 369 DEBUG
copying FTP subcommand 162
data sets to a foreign host 255 privileged user SMSG parameter 334
files from a foreign host 180 Telnet parameter 10
multiple data sets to a foreign host 243 Default Vector Symbol Set (GDDM/MVS) 386
multiple files from a foreign host 235 DELETE (FTP subcommand) 166

deleting Enter (GDDMXD option) 395
a job 118 establishing
files on a foreign host 166 a connection to a foreign host 41, 42
multiple files on a foreign host 232 default working directory 42
DELIMIT (FTP subcommand) 167 Ethernet protocol 2
DEST (FTP LOCSITE and SITE parameter) 281 EUC (Extended UNIX Code) 176
destination_file (FTP APPEND parameter) 144 EUCKANJI
detached graphics cursor (GDDM/MVS) 386 FTP subcommand 176
detectable fields (GDDM/MVS) 386 LPR parameter 368
determining a foreign host operating system 311 examples
DEV.NULL directory 154, 194 batch SMTP 355
devices, network 2 DEBUG command 334
DIR (FTP subcommand) 45, 46, 168, 170 Generation Data Group (GDG) 94, 96
directories JES 113
changing the directory of a VM FTP server 154 LPQ 365
changing the directory of an MVS FTP server 153 LPR 376
changing the directory on the foreign host 153 LPRM 380
changing the working directory 193 LPRSET 381
changing to the parent of the current directory 156 nondelivery note 328
creating a directory on a foreign host 239 preparing and sending mail 327
DEV.NULL 154, 194 SMTP STATS command 332
obtaining a list of directory entries 168 SQL query output 134
removing a directory from a foreign host 264 TELNET Help 17
transferring PDS directory information 432 TSO RECEIVE command 328
working with directories on the foreign host 44, 45 unknown recipient note 329
working with directories on the local host 49 using TELNET to log on to a foreign host 11
directory examples, FTP
FTP CD parameter 153 APPEND 144
FTP MKDIR parameter 239 differences between DIR and LS output 45, 46
FTP RMDIR parameter 264 establishing a connection 42
DIRECTORY FTP as a batch job 99
FTP LOCSITE and SITE parameter 203, 281 FTP EXEC 102
DIRECTORYMODE GET and MGET 56
FTP LOCSITE and SITE parameter 46, 203, 281 issuing subcommands from the EXEC interface 104
disability 469 LMKDIR 225
disconnecting from a host using FTP 159 MKDIR 239
DISK PUT and MPUT 62
FTP DIR parameter 168 showing the results of STATUS 301
FTP LS parameter 229 showing the results with and without DEBUG 162
displaying transferring data 55
FTP help information 186 working with foreign directories 45
local status information (FTP) 218 working with local directories 49
TELNET help information 17 EXEC interface usage 102
the current working directory 257 EXPIRE (privileged user SMSG parameter) 334
the current working level qualifier 228 EXPN (SMTP command) 341
the file name delimeter 167
the operating system name (FTP) 311
the status of an FTP job 114
DNS, online information xxiv
F
F
domain_namen SMTP HELO parameter 342
FTP STRUCT parameter 309
dotted decimal notation 3
FTP TYPE parameter 315
DUMP (FTP subcommand) 173
FEATure (FTP subcommand) 178
FILE (FTP subcommand) 179
file name
E delimiter 167
E (FTP TYPE parameter) 315 obtaining a list 229
EBCDIC specifying 429
FTP subcommand 175 file transfer types
transferring binary data to ASCII 315 ASCII 55, 146, 315, 432
transferring binary data to EBCDIC 315 EBCDIC 55, 175, 315, 317, 432
transferring text data to ASCII 315 image 55, 150, 315, 317, 432
transferring text data to EBCDIC 315 kanji 55, 315, 317, 432
electronic mail files
e-mail xv AIX 433
electronic mail (idx4) AS/400 433
sending and receiving 5 specifying 429
ending a TELNET session 20
Index 487
FILETYPE FTP subcommands (continued)
FTP LOCSITE and SITE parameter 204, 283 EUCKANJI 176
FILTER (LPR parameter) 370 FEATure 178
foreign_file FILE 179
FTP DELETE parameter 166 GET 180
FTP GET parameter 180 GLOB 182
FTP MDELETE parameter 232 HANGEUL 184
FTP MGET parameter 235 HELP 186
FTP PUT parameter 255 IBMKANJI 187
foreign_host JIS78KJ 188
FTP parameter 30 JIS83KJ 189
RSH parameter 413 KSC5601 190
TELNET parameter 10 LANGUAGE 192
format of batch SMTP command data sets 338 LCD 193
formatting batch SMTP command data sets 338 LMKDIR 225
FTP LOCSITE 195
command 4, 5, 30 LOCSTAT 218
data conversion 86 LPWD 228
data transfer methods 55, 432 LS 229
DB2 subsystems for SQL queries 131 MDELETE 232
DBCS support 87 MGET 235
ddname support 65 MKDIR 239
EXEC interface 102 MODE 242
EXIT return codes 106 MPUT 243
FTP-supplied DB2 column headings 132 NOOP 246
internal error codes 110 OPEN 247
issuing subcommands from a data set 102 PASS 248
logging on 36 PRIVATE 249
MBCS language support 90 PROMPT 250
parameters 34 PROTECT 251
reply codes 109 PROXY 252
restarting a failed data transfer 112 PUT 255
return codes 105 PWD 257
security considerations 50 QUIT 258
specifying data set attributes 91 QUOTE 259
subcommand codes 107 RECORD 261
transferring data 29, 53, 55 RENAME 262
user-level options 36, 71 RESTART 263
FTP Client, configuring for SOCKS server 72 RMDIR 264
FTP examples SCHINESE 266
FTP as a batch job 99 SENDPORT 268
FTP EXEC 102 SENDSITE 269
Generation Data Group (GDG) 94, 96 SITE 270
FTP format options SJISKANJI 297
NOSPREAD 132 SRestart 299
SPREAD 132 STATUS 301
SQLCOL 130 STREAM 308
FTP requests in batch, JCL for 98 STRUCTURE 309
FTP subcommands SUNIQUE 310
! 142 SYSTEM 311
ACCT 143 TCHINESE 312
APPEND 144 TSO 314
ASCII 146 TYPE 315
BIG5 148 UCS2 319
BINARY 150 USER 320
BLOCK 151 FTP-supported SQL data types
CD 153 CHAR 129
CDUP 156 DATE 129
CLEAR 158 DECIMAL 129
CLOSE 159 FLOAT 129
COMPRESS 160 INTEGER 129
DEBUG 162 LONG VARCHAR 129
DELETE 166 SMALLINT 129
DELIMIT 167 TIME 129
DIR 168 TIMESTAMP 129
DUMP 173 VARCHAR 129
EBCDIC 175 FTP.DATA data set 70, 72

function keys for TELNET 23 IBMKANJI (FTP subcommand) 187
identifier, SMTP TICK parameter 351
identifying
G the target display (GDDM/MVS) 389
yourself to a host 320
GColornn (GDDMXD option) 396
INDENT (LPR parameter) 371
GDDM
information APARs for IP-related documents 465
application limitations 385
information APARs for non- document information 466
displaying graphics on X Windows workstations xv
information APARs for SNA-related documents 466
GDDM display limitations 386
interfaces, EXEC 102
GDDMXD
interfacing with JES 113
CLIST 385, 387
internal error codes, FTP 110
Graphics Window 390
internet_address (XWINDOWS DISPLAY parameter) 389
GDDMXD/MVS
Internet, finding z/OS information online xxiii
APL2 character set keyboard 404, 435
interrupting, the current process (TELNET) 18
GDXAPLCS.MAP 404
IP (TELNET subcommand) 18
keyboard functions 403
IPv4/IPv6 addressing 3
overview 385
ISPFStats
target display, identifying 389
LOCSIte 204
TSO EXEC command 388
PDS member 94
usage 390
issuing FTP subcommands from a data set 102
using 385, 387
issuing FTP subcommands from the EXEC interface 104
X.DEFAULTS data set 390
GDDMXD/MVS user-specified options
ANFontn 392
CMap 393 J
Compr 394 JCL 98, 113
GColornn 396 JCL for submitting FTP requests in batch 98
Geometry 397 JES
GMCPnn 398 deleting a job 118
HostRast 399 description 5
XSync 401 displaying job status 114
ZWL 402 interfacing with 113
GDDMXD/MVS with X Windows 385 receiving spool output 117
Generation Data 94 submitting a job 113
Generation Data Group Support (GDG) 94 terminating access to 120
Geometry (GDDMXD option) 397 JESLRECL (SITE parameter) 283
GET FTP subcommand 56, 180 JESRECFM (SITE parameter) 283
getting started 1 JIS78KJ (FTP subcommand) 188
GLOB (FTP subcommand) 182 JIS83KJ (FTP subcommand) 189
GMCPnn (GDDMXD option) 398 JISROMAN
FTP JIS78KJ parameter 188
FTP JIS83KJ parameter 189, 191
H JNum (LPR parameter) 371
JOB (LPR parameter) 372
HANGEUL
Job Scheduler 113
FTP subcommand 184
JOB_ID
LPR parameter 371
LPQ parameter 364
HEADER, LPR parameter 371
LPRM parameter 379
HELO (SMTP command) 342
host
foreign 44
local 49 K
LPQ parameter 364 kanji
LPR parameter 371 EUCKANJI 176
LPRM parameter 379 IBMKANJI 187
names 6 SJISKANJI 297
remote 3, 9, 44, 153, 159, 239, 243, 255, 357, 379, 381, 434 keyboard 469
host_name (FTP OPEN parameter) 247 KEYCODE program 404
HostRast (GDDMXD option) 399 KSC5601
hosts, using other 5 FTP subcommand 190
how TCP/IP uses networks 2 LPR parameter 372
I L
I (FTP TYPE parameter) 315 LAN (local area network) 1
IBM 3179G device model 386 LANDSCAPE (LPR parameter) 372
IBM Software Support Center, contacting xvii LANGUAGE (FTP subcommand) 192
Index 489
LCD (FTP subcommand) 193 mailbox
leaving the FTP environment 258 SMTP EXPN parameter 341
license, patent, and copyright information 471 SMTP VRFY parameter 353
line feed, suppressing (TELNET) 23 mapping values 404, 435
Line Printer MBCS translation tables, and FTP 90
Client (LPR) 363 MDELETE (FTP subcommand) 232
Daemon (LPD) 363 message retrieval tool, LookAt xxv
LINECOUNT (LPR parameter) 372, 373 MGET (FTP subcommand) 56, 235
Linemode (TELNET parameter) 10, 23 MGMTCLAS
LMKDIR (FTP subcommand) 225 FTP LOCSITE and SITE parameter 205, 285
local host 49, 195, 225, 314 MIGRATEVOL
local node, description 2 FTP LOCSITE and SITE parameter 206, 286
local_data_set MKDIR (FTP subcommand) 239
FTP APPEND parameter 144 MODE (FTP subcommand) 242
FTP MPUT parameter 243 MPUT (FTP subcommand) 62, 243
FTP PUT parameter 255
local_file (FTP GET parameter) 180
LOCSITE (FTP subcommand) 195
LOCSITE parameters 195
N
NAME
LOCSTAT (FTP subcommand) 218
FTP DIR parameter 168
logging on
FTP LS parameter 229
to a host using Telnet 9
FTP STATUS parameter 301
to FTP 36
LPR parameter 373
to other hosts 4
name server, description 3
LookAt message retrieval tool xxv
names
LOOPBACK 7
host 6
LPD (line printer daemon) 363
network, description 3
LPQ (remote printing command)
printer 6
description 6, 364
NDB 421
examples 365
NETRC.DATA data set 40, 408
usage 365
network address format 2
LPR (remote printing command)
network devices 2
description 6, 366
network names 3
examples 376
network protocols
usage 377
802.3 2
LPRM (remote printing command)
Ethernet 2
description 6, 379
SNA 2
examples 380
token ring 2
usage 380
X.25 2
LPRSET (remote printing command)
networks
description 6, 381, 383
NJE 324
examples 381
TCP/IP 2
usage 382
new_name (FTP RENAME parameter) 262
LPWD (FTP subcommand) 228
NewLiner (GDDMXD option) 400
LRECL
NJE 323
FTP LOCSITE and SITE parameter 204, 284
NOASAtrans parameter 286
ls (FTP subcommand) 45, 46, 229
NOAUTOMOUNT (FTP LOCSITE and SITE parameter) 206,
286
NOAUTORECALL (FTP LOCSITE and SITE parameter) 206,
M 286
MAIL (LPR parameter) 373 NOBINARY (LPR parameter) 373
MAIL FROM (SMTP command) 344 NOBURST (LPR parameter) 369
mail transfer (SMTP) commands NOCC
DATA 339 LPR parameter 369
EXPN 341 SMTPNOTE parameter 325
HELO 342 nodebug, privileged user SMSG parameter 334
HELP 343 nodes, descriptions 1, 2
MAIL FROM 344 noheader, LPR parameter 369
NOOP 345 NOLinecount (LPR parameter) 371
QUEU 346 NOOP
QUIT 348 FTP subcommand 246
RCPT TO 349 SMTP command 345
RSET 350 NOPOSTSCRIPT (LPR parameter) 373
STATS 331 NORDW (FTP LOCSITE parameter) 207
TICK 351 NORESTGet (FTP LOCSITE parameter) 207
VERB 352 NOSPREAD
VRFY 353 FTP format option 132

NOSPREAD (continued) pixel spacing (GDDM/MVS) 386
FTP LOCSITE and SITE parameter 207, 287 port numbers, description 3
notation system, dotted decimal 3 port_number
NOTOPMARGIN (LPR parameter) 373 FTP OPEN parameter 247
NOTRACE (privileged user SMSG parameter) 334 FTP parameter 30
NOTRAILINGBLANKS (FTP SITE parameter) 287 TELNET parameter 10
NOTYPE ports, description 3
FTP EUCKANJI parameter 176 POSTSCRIPT (LPR parameter) 375
FTP HANGEUL parameter 184 preparing and sending mail 327
FTP IBMKANJI parameter 187 preparing the FTP environment 53
FTP JIS78KJ parameter 188 primary
FTP JIS83KJ parameter 189, 191 FTP LOCSITE and SITE parameter 209, 288
FTP KSC5601 parameter 191 printer
FTP SJISKANJI parameter 297 LPQ parameter 364
FTP TCHINESE parameter 312 LPR parameter 373
NOWRAPRECORD (FTP LOCSITE and SITE parameter) 208, LPRM parameter 379
287 names 6
printer_host (LPRSET parameter) 381
printing
O remote xv, 363
to or from other hosts 5
obtaining
PRIVATE (FTP subcommand) 249
a list of directory names 168
privileged user SMSG command 334
a list of file names 229
PROFILE command 42
status and system information 44
PROMPT (FTP subcommand) 250
OFF
PROTECT (FTP subcommand) 251
GDDMXD parameter 388
protocols
SMTP VERB parameter 352
description 2
ON
File Transfer Protocol 29, 53
GDDMXD parameter 388
OS/390 UNIX Remote Execution Protocol 405, 415
SMTP VERB parameter 352
Simple Mail Transfer Protocol 323
OPEN (FTP subcommand) 247
Telnet Protocol 9
original_name (FTP RENAME parameter) 262
X Window System Protocol 385
overviews
PROXY
differences between DIR and LS output 45
bounce attack 254
GDDMXD/MVS 385
FTP subcommand 252
security 254
PUT (FTP subcommand) 62, 255
P PWD (FTP subcommand) 42, 257
PA1 (TELNET subcommand) 19
parameter
FTP LOCSITE parameter 195
FTP SITE parameter 270
Q
Qdisk (FTP LOCSITE and SITE parameter) 209, 288
parameters, FTP
qualifier (FTP LCD parameter) 193
EXIT 30
query, LPRSET parameter 381
FOREIGN_HOST 30
querying a connection (TELNET) 15
PORT_NUMBER 30
querying SMTP delivery queues 355
TCP 30
QUEU (SMTP command) 346
TIMEOUT 30
queue resolution (SMTP)
TRACE 30
resolver completed 347
TRANSLATE 30
resolver error pending 347
parameters, SNALINK LU6.2 248
resolver process 347
passing TSO commands to your local host 314
resolver retry 347
password
resolver send 347
FTP PASS parameter 248
resolver wait 347
FTP USER parameter 320
retry (SMTP) 346
password, use with FTP
spool (SMTP) 346
ACCT 143
undeliverable (SMTP) 346
PASS 248
QUEUES (SMSG parameter) 331
USER 320
QUIT
path address (SMTP) 336
FTP subcommand 258
PDS 225, 429, 430, 432
SMTP command 348
performing a DB2 SQL query
TELNET subcommand 20
from an FTP client 133
QUOTE
from an FTP server 133
DBCS subcommand 259
with FTP 129
FTP subcommand 259
physical network, description 1
QUOtesoverride, FTP LOCSIte parameter 209
Index 491
R sending
ASCII control characters to a host in line mode 22
RACF 6, 42 break or attention keystroke to a host 16
RCPT TO (SMTP command) 349 data using the QUOTE subcommand 259
RDW electronic mail using OS/390 UNIX sendmail 359
FTP LOCSITE parameter 209 electronic mail using SMTP commands 5, 323
READTAPEFormat, FTP LOCSIte parameter 209 mail to a TCP network recipient 355
READTAPEFormat, FTP SIte parameter 288 PA1 keystroke to a host 19
RECEIVE command 5 site-specific information to a host 270
receiving mail 5 uninterpreted string of data 259
receiving spool output SENDPORT (FTP subcommand) 268
in a group 118 SENDSITE (FTP subcommand) 269
individually 117 sequential data sets 430
RECFM server
FTP LOCSITE and SITE parameter 210, 290 description 2
recipient (SMTPNOTE parameter) 325 FTP HELP parameter 186
recipient_path_address (SMTP RCPT TO parameter) 349 setting
RECORD (FTP subcommand) 261 characteristics for an SQL query 130
Record Descriptor Words (RDW) 207 data set or file structure 309
remote host logon xv data transfer mode 242
remote node, description 2 data transfer type 88, 315
remote printing 363 setting up tcpipv3r1.GDXAPLCS.MAP 404
remote printing commands shortcut keys 469
LPQ 364 SHUTDOWN (privileged user SMSG parameter) 334
LPR 366 SITE (FTP subcommand) 270
LPRM 379 SITE parameters 270
LPRSET 381, 383 SJISKANJI
removing a directory (FTP) 264 FTP subcommand 297
RENAME (FTP subcommand) 262 LPR parameter 373
renaming files on a foreign host 262 SMS 91, 198, 274
REPLACE SMSG command
FTP GET parameter 180 general user 330
FTP MGET parameter 235 privileged user 334
requests in batch, submitting FTP 98 SMSGAUTHLIST statement 334
resizing the GDDMXD graphics window 390 SMTP
responses, SMTP 354 DBCS support 357
RESTART (FTP subcommand) 263 description 5
restarting a checkpointed data transfer 263 Exit, Anti-Spamming 329
RESTGet (FTP LOCSITE parameter) 210 format of batch SMTP command data sets 338
RETPD monitoring the status of 330
FTP LOCSITE and SITE parameter 211, 290 responses 354
retrieving status information from a remote host 301 SMSG interface 330
return codes, FTP 106 SMTP electronic mail
REUSE (SMTPNOTE parameter) 326 nondelivery 328
REXEC 405, 415 preparing and sending 327
REXX command list language 34 receiving 328
RFC (request for comments) SMTP interfaces
accessing online xxiii interactively 323
list of 449 JES 323
RHOSTS.DATA data set 415 SMTPNOTE from your terminal 324
RMDIR (FTP subcommand) 264 SNA network protocol 2
RSCS 336 specifying
RSET (SMTP command) 350 column headings for an SQL query 131
RSH 412, 413 data sets and files 429
report format of your output data set 132
site information to the local host 195
S spreadsheet format of your output data set 132
S (FTP MODE parameter) 242 the DB2 subsystem to perform a query 131
sample FTP.DATA data set 72 values for new data sets 91
SBCS translation tables, and FTP 86, 88 SPREAD
SBTRANS (FTP.DATA parameter) 88 FTP LOCSITE and SITE parameter 132, 213, 292
SCHINESE SQL
FTP subcommand 266 FTP-supported data types 129
LPR parameter 373 imbedded statements 129
SECONDARY with FTP on the client 133
FTP LOCSITE and SITE parameter 213, 292 with FTP on the server 133
sender_path_address (SMTP MAIL FROM parameter) 344 SQL data type 129

SQLCOL TELNET examples (continued)
FTP LOCSITE and SITE parameter 213, 292 using Help 17
SRestart (FTP subcommand) 299 TELNET function keys
STATS (SMSG parameter) 331 in line mode 23
STATUS (FTP subcommand) 301 in transparent mode 23
status and system information 44 TELNET parameters
STORCLASS DEBUG 10
FTP LOCSITE and SITE parameter 214, 293 foreign_host 10
store command (STOR) 310 Help 10
STREAM (FTP subcommand) 308 Linemode 10
stream mode (FTP) 242 port_number 10
string (FTP QUOTE parameter) 259 TRANslate data_set_name 10
STRUCT (FTP subcommand) 309 Telnet Protocol 9
SUBCOMMAND (FTP HELP parameter) 186 TELNET subcommands
submitting AO 14
FTP requests in batch 98 AYT 15
job and automatically receiving output 118 BRK 16
job using FTP 113 HELP 17
requests without input and output data sets 101 IP 18
REXEC requests in batch 409 PA1 19
SQL query using FTP 133 QUIT 20
SUNIQUE (FTP subcommand) 310 SYNCH 21
supplying terminating
a password to a foreign host 248 access to JES 120
account information to a foreign host 143 output of TELNET information 14
suppressing carriage return and line feed 23 testing
SYNCH (TELNET subcommand) 21 commands with loopback 7
syntax diagram, how to read xviii FTP connection 246
SYSTEM (FTP subcommand) 311 throughput with *DEV.NULL 154, 194
TICK (SMTP command) 351
Timeout (FTP parameter) 30
T TITLE (LPR parameter) 374
TO (SMTPNOTE parameter) 325
tables
toggling
translation 87
internal debug options (FTP) 162
target display (GDDM/MVS) 389
sending of port information 268
target_screen (XWINDOWS DISPLAY parameter) 389
sending of site information 269
target_server (XWINDOWS DISPLAY parameter) 389
storage method 310
tasks
token ring network protocol 2
GDDMXD/MVS
TOPMARGIN (LPR parameter) 375
overview 385
TRACE
submitting a job
FTP parameter 30
steps for 113
LPQ parameter 364
submitting a job and automatically receiving output
LPR parameter 375
steps for 118
LPRM parameter 379
Using a DCBDSN model to create a new data set
LPRSET parameter 381
steps for 93
privileged user SMSG parameter 334
TCHINESE
TRACKS (FTP LOCSITE and SITE parameter) 214, 293
FTP subcommand 312
trademark information 479
LPR parameter 373
TRAILINGBLANKS, FTP SITE parameter 293
TCP, FTP parameter 30
transferring
TCP/IP
data sets between hosts 4
addresses 3
data using FTP 29, 53, 55
commands 4
DBCS data sets with FTP 87
description 1
PDS directory information 432
layers 2
networks 2
FTP parameter 30
online information xxiii
TELNET parameter 10
protocol specifications 449
TRANSLATETABLE (LPR parameter) 375
understanding 1
transparent mode 23
TELNET
TSO
3270 DBCS Transform Mode 24
entering TCP/IP commands 1
command 4, 10
FTP subcommand 314
supported display stations 12
Session Manager 390
TELNET examples
TSO commands
command format 10
EDIT 324, 327
logging on to a foreign host 11
PROFILE 42
logging onto a host using 9
Index 493
TSO commands (continued) XLATETABLE (LPR parameter) 375
RECEIVE 328 XSync (GDDMXD option) 401
TYPE
DBCS subcommand 315
FTP subcommand 315
LPQ parameter 365
Z
z/OS UNIX orexec/rexec 417
LPR parameter 375
z/OS UNIX orsh/rsh 419
LPRM parameter 379
z/OS UNIX REXEC
command 5, 405, 415
format 406, 417
requests, submitting in batch 409
U z/OS UNIX RSH
UCS2 (FTP subcommand) 319 command 5, 405, 415
undelivered notes 328 format 419
UNIT (FTP LOCSITE and SITE parameter) 216, 295 requests, submitting in batch 409
Unit of Work (UOW) 5 z/OS, documentation library listing 481
USCFXLATE (LPR parameter) 375 z/OS, listing of documentation available 465
user ZWL (GDDMXD option 402
ID 6
password 6
USER (FTP subcommand) 320
USER name (FTP parameter) 375
user_id (FTP USER parameter) 320
user-specified options (GDDM/MVS) 390
uses of TCP/IP
data transfer 4, 29, 53
electronic mail 5, 323
printing on other hosts 5, 363
remote login 4, 9
using other hosts 5, 405, 415
V
VERB (SMTP command) 352
VERSION
LPQ parameter 365
LPR parameter 375
LPRM parameter 379
visual appearance (GDDM/MVS) 386
VM files 434
VOLUME
VRFY (SMTP command) 353
VTAM 20
VTAM, online information xxiii
W
WAN (wide area network) 1
well-known ports, description 3
what you need to get started 6
WIDTH (LPR parameter) 375
working directory 42, 193
working with directories
on the foreign host 44, 45
on the local host 49
working-level qualifier 193, 228
WRAPRECORD
X
X Window System 385
X.25 network protocol 2

Communicating Your Comments to IBM
If you especially like or dislike anything about this document, please use one of
the methods listed below to send your comments to IBM. Whichever method you
choose, make sure you send your name, address, and telephone number if you
would like a reply.
Feel free to comment on specific errors or omissions, accuracy, organization, subject

matter, or completeness of this document. However, the comments you send
should pertain to only the information in this manual and the way in which the
information is presented. To request additional publications, or to ask questions or
make comments about the functions of IBM products or systems, you should talk
to your IBM representative or to your IBM authorized remarketer.
When you send comments to IBM, you grant IBM a nonexclusive right to use or
distribute your comments in any way it believes appropriate without incurring any
obligation to you.
Please send your comments to us in either of the following ways:

v If you prefer to send comments by FAX, use this number: 1+919-254-1258
v If you prefer to send comments electronically, use this address:
– comsvrcf@us.ibm.com
v If you prefer to send comments by post, use this address:
International Business Machines Corporation
Attn: z/OS Communications Server Information Development
P.O. Box 12195, 3039 Cornwallis Road
Department AKCA, Building 501
Make sure to include the following in your note:

v Title and publication number of this document
v Page number or topic to which your comment applies.


Program Number: 5694–A01
Printed in USA
SC31-8780-07
Spine information:
z/OS V1R9.0 Comm Svr: IP User’s Guide and Version 1

z/OS Communications Server Commands Release 9

FTP

Uploaded by

Copyright:

Available Formats

FTP

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

FTP

Uploaded by

Copyright:

Available Formats

z/OS Communications Server

IP User’s Guide and Commands

IP User’s Guide and Commands

Eighth Edition (September 2007)

About this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Summary of changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvii

Chapter 1. Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

© Copyright IBM Corp. 1990, 2007 iii

Chapter 2. Logging on to a host using TELNET . . . . . . . . . . . . . . . . . . . 9

Chapter 3. File Transfer Protocol (FTP) . . . . . . . . . . . . . . . . . . . . . . 29

Chapter 4. Transferring data using the File Transfer Protocol (FTP) . . . . . . . . . 53

iv z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

Chapter 5. FTP subcommands . . . . . . . . . . . . . . . . . . . . . . . . . 137

vi z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

Chapter 6. Sending electronic mail using SMTP commands . . . . . . . . . . . . 323

Chapter 7. Sending electronic mail using z/OS UNIX sendmail . . . . . . . . . . . 359

Chapter 8. Using remote printing . . . . . . . . . . . . . . . . . . . . . . . . 363

Chapter 9. Using GDDMXD/MVS with the X Window System . . . . . . . . . . . . 385

Chapter 10. Executing commands on a remote host . . . . . . . . . . . . . . . . 405

Chapter 11. Using the Network Database System . . . . . . . . . . . . . . . . . 421

Appendix A. Specifying data sets and files. . . . . . . . . . . . . . . . . . . . 429

Appendix B. Mapping values for the APL2 character set . . . . . . . . . . . . . . 435

Appendix C. TELNET extensions . . . . . . . . . . . . . . . . . . . . . . . . 441

Appendix D. Related protocol specifications . . . . . . . . . . . . . . . . . . . 449

Appendix E. Information APARs and technotes . . . . . . . . . . . . . . . . . . 465

Appendix F. Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

viii z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

Communicating Your Comments to IBM . . . . . . . . . . . . . . . . . . . . . 495

© Copyright IBM Corp. 1990, 2007 xi

© Copyright IBM Corp. 1990, 2007 xiii

A companion to this document is the z/OS Communications Server: IP System

Who should read this document

How this document is organized

© Copyright IBM Corp. 1990, 2007 xv

How to use this document

Determining whether a publication is current

xvi z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

How to contact IBM service

If you would like to provide feedback on this publication, see “Communicating

Conventions and terminology used in this document

The TPF logon manager, although shipped with VTAM®, is an application

About this document xvii

How to read a syntax diagram

Symbols and punctuation

xviii z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

Longer than one line

The continuation of the subcommands, parameters, or both

You must code required operands and values.

About this document xix

You can choose not to code optional operands and values.

Selecting more than one operand

OPERAND = ( 001 , 0.001 )

Blank spaces in syntax diagrams

OPERAND = ( 001 FIXED )

xx z/OS V1R9.0 Comm Svr: IP User’s Guide and Commands

1ST_OPERAND , 2ND_OPERAND , 3RD_OPERAND

Prerequisite and related information

About this document xxi

Relevant RFCs are listed in an appendix of the IP documents. Architectural