parameters
Theparametersforthis subcommandarethesameasfortheADDPFMCLcommand. Forexample,toaddmemberBANANAtophysicalfileGEORGEinlibraryRLKAYS,enterthis:
ADDM FILE(RLKAYS/GEORGE) MBR(BANANA)
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol(FTP)serversubcommands.
ADDV
(AddPhysical
File
Variable
Length
Member)
TheADDVi5/OSFTPserversubcommandaddsavariable-lengthmembertoaphysical file.
FTPserver
subcommand
parameters
Theparametersforthis subcommandarethesameasfortheADDPVLMCLcommand. Forexample,toaddmemberPOLEBEANtophysicalfileGEORGEinlibraryRLKAYS,enterthis:
ADDMparameters
ADDV FILE(RLKAYS/GEORGE) MBR(POLEBEAN)
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol (FTP)serversubcommands.
APPE
(Appendto
Existing
File)
TheAPPEFTPserversubcommand acceptsthetransferred dataandstoresitinafileontheFTPserver. Ifthefilethatisspecifiedexists,thesubcommand appendsthedatatothatfile;otherwise,the
subcommandcreatesthespecifiedfile.
FTPserver
subcommand
filename
ThefilethatwillreceiveyourdataontheFTPserver.
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol (FTP)serversubcommands.
AUTH
(Authorization)
TheAUTHi5/OSFTPserversubcommanddefinestheauthenticationand securitymechanismthatis usedfor thecurrentFTPsession.
FTPserver
subcommand
Thesyntaxofthis subcommandis: AUTH[TLS-C|TLS-P|TLS |SSL]
Table1.Parametervalues:
Parametervalue Definition
TLS-C UtilizetheTransportLayerSecurity(TLS)protocolasthe
securitymechanism.Thesecuritysettingsforthedata connectionusetheRFC2228defaults;thatis,thereisno implicitprotectionofthedataconnection.
TLS-P UtilizetheTLSprotocolasthesecuritymechanism.Also,
implicitlyprotectthedataconnection(whichis equivalenttothecommandsequenceAUTHTLC-C, PBSZ0,PROTP).
TLS SynonymforTLS-C.
SSL SynonymforTLS-P.
TLS-C UtilizetheTransportLayerSecurity(TLS)protocolasthe
securitymechanism.Thesecuritysettingsforthedata connectionusetheRFC2228defaults;thatis,thereisno implicitprotectionofthedataconnection.
TLS-P UtilizetheTLSprotocolasthesecuritymechanism.Also,
implicitlyprotectthedataconnection(whichis equivalenttothecommandsequenceAUTHTLC-C, PBSZ0,PROTP)
TLS SynonymforTLS-C.
SSL SynonymforTLS-P.
Note: TheTLSprotocoliscompatiblewiththeSecureSockets Layer(SSL)protocol. Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol(FTP)serversubcommands.
CCC
(Clear
CommandChannel)
TheCCCi5/OSFTPserversubcommand changesthetransmissionmodeina controlconnectionfromthe encryptedmodetothecleartextmode.
FTPserver
subcommand
WhentheFTPserverreceivesa ClearCommandChannel(CCC)subcommand,itfirst checkswhetherthe currentuserhastheauthoritytoperform theCCCcommand.Iftheuser hastheauthority,itthenaccepts thecommandbysendinga confirmationmessagebacktotheFTPclientside.ThentheFTPserver changesthetransmissionmodeina controlconnection fromtheencryptedmodetothecleartextmode. Youcansecuresensitiveinformationincludingyouruser nameandpasswordbysendingtheminthe encryptedmodeinthecontrolconnection.Then,youcanusetheCCCsubcommandtochangethe transmissionmodetothecleartextmode, andthensend theportand IPinformation.
Comparedwith thefullencryptionofthecontrolconnection,somepotentialsecurityandintegrity exposuresexist whenyouusetheCCCsubcommand:
v Thismightresultinfileand directorynamesontheFTPservertobesubjecttointerception.Itis
possiblethatsuchnamesthemselvescontainsensitiveorconfidentialinformation.
v IPaddressandportinformationtransferred inthecontrolconnectioncanbeeasilyinterceptedby
hackers.
v OtherdirectTCPattacksonanFTPserverorusinganFTPservertoattackothersystemsare
completelyeliminatedwhenTLSisused.Some ofthoseattacksarenow againpossiblewhenthe controlconnectionrevertstotheclear-textmode.
Becauseoftheseconcerns,theuseof theCCCsubcommandiscontrolledusingthei5/OSFunctionUsage interface.ThedefaultsettingfortheCCCsubcommandis*DENIEDfortheFTPserver.
Youneedtospecify*ALLOWEDfortheQIBM_QTMF_SERVER_REQ_10functionthrough the
ApplicationAdministrationfolderiniSeriesNavigatororbyusingtheCHGFCNUSGcommandsothat youcanallowanindividualuser loggedontotheFTPservertousetheCCCsubcommand forending protectionof thecontrolconnection.
HereisanexampleofusingtheCHGFCNUSGcommand:
CHGFCNUSG FCNID(QIBM_QTMF_SERVER_REQ_10) USER(user) USAGE(*ALLOWED)
Related information
SecuringFTPwith TLS
CRTL(Create
Library)
TheCRTLi5/OSFTPserversubcommand createsalibrary.
CCC | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
FTPserver
subcommand
parameters
Theparametersforthis subcommandarethesameasfortheCRTLIBCLcommand. Forexample,tocreatea librarythatiscalledTESTTCP,enterthis:
CRTL TESTTCP
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol (FTP)serversubcommands.
CRTP(Create
Physical
File)
TheCRTPi5/OSFTPserversubcommandcreatesa physicalfile.
FTPserver
subcommand
parameters
Theparametersforthis subcommandarethesameasfortheCRTPFCLcommand.
Forexample,tocreatea physicalfilethatiscalledMYFILEwith arecordlength of80andnorestrictions onthenumber ofmembers,enterthis:
CRTP FILE(RLKAYS/MYFILE) RCDLEN(80) MAXMBRS(*NOMAX)
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol (FTP)serversubcommands.
CRTS
(Create
SourcePhysical
File)
TheCRTSi5/OSFTPserversubcommandcreatesa sourcephysicalfile.
FTPserver
subcommand
parameters
Theparametersforthis subcommandarethesameasfortheCRTSRCPFCLcommand. Forexample,tocreatea sourcephysical filethatiscalledGEORGEinlibraryRLKAYS,enterthis:
CRTS FILE(RLKAYS/GEORGE)
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol (FTP)serversubcommands.
CWD
(ChangeWorking
Directory
or
Library)
TheCWDi5/OSFTPserversubcommandchangestheworkingdirectory, library,orfilegroup.
CRTLparameters
CRTPparameters
FTPserver
subcommand
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol(FTP)serversubcommands.
DBUG
(Turnon
the
FTP
ServerTrace)
TheDBUGi5/OSFTPserversubcommand startsorends aservertrace.
FTPserver
subcommand
Note: UsetheFTPservertraceonlyforreportingsoftwareproblemstoIBM.Youmight affectsystem
performance byusingthisfunction.
IftheFTPservertraceisnotactive,theFTPserverstartsatrace.TheFTPservercontinuestorunatrace untilitreceivesanotherDBUGsubcommandora QUITsubcommand.WhentheFTPserverendsthe trace,theremight beasignificant delaywhiletheDBUGsubcommandisformattingthetracedata.
Related concepts
“TracingtheFTPserver”onpage154
TheFTPservercanbe tracedfromanysystem thatrunsTCP/IP.
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol(FTP)serversubcommands.
DELE
(DeleteFile
or
Document)
TheDELEi5/OSFTPserversubcommanddeletesafile,amember,ora document.
FTPserver
subcommand
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol(FTP)serversubcommands.
DLTF(Delete
File)
TheDLTFi5/OSFTPserversubcommanddeletesa file.
FTPserver
subcommand
parameters
Theparametersforthis subcommandarethesameasfortheDLTFCLcommand.
CWDdirectory
DBUG
DELEremotefile
Forexample,todeletefileMYFILEinlibraryRLKAYS,enterthis:
DLTF FILE(RLKAYS/MYFILE)
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol (FTP)serversubcommands.
DLTL(Delete
Library)
TheDLTLi5/OSFTPserversubcommanddeletesa library.
FTPserver
subcommand
parameters
Theparametersforthis subcommandarethesameasfortheDLTLIBCLcommand. Forexample,todeletealibrary,enterthis:
DLTL libname
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol (FTP)serversubcommands.
HELP(Getting
Help
from
a
Remote
System)
TheHELPi5/OSFTPserversubcommanddisplays informationaboutFTPserversubcommands.
FTPserver
subcommand
subcommand
Thenameoftheserversubcommandthat youwantinformationabout.Forexample,HELPADDM provideshelpinformationabouthowtoadda memberto aphysicalfileonthei5/OSoperating system.
Todeterminethesyntax oftheADDVsubcommand thatisusedbythesystem,usetheserver subcommand:
HELP ADDV
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol (FTP)serversubcommands.
LIST
(File
List)
TheLISTi5/OSFTPserversubcommanddisplaysa listofdirectoryentries,librarycontents,orfilesina filegroup.
FTPserver
subcommand
ItlistsonlythosefilesthatFTPcantransfer
DLTLparameters
HELP[subcommand]
Related tasks
“ConfiguringFTPservers forgraphicalFTPclients andWebtools”onpage8
FileTransfer Protocol(FTP)servers onthei5/OSoperatingsystemsupportgraphical FTPclients,Web browsers,and otherWebtools.BecausemostgraphicalFTPclients usetheUNIX-styleformatastheir listformatandpathfileastheirfilenameformat, youneedtoconfigureyour FTPservertosupport theseformats.
Related reference
“Fileanddirectoryentriesini5/OSformat”onpage9
Systemiclients supportlistingthefilesona FileTransferProtocol(FTP)serverinboththei5/OS formatandtheformatspecifictoUNIX.Thistopicdiscussesthei5/OSformat.
“Filesand directoryentriesinUNIX-style format”onpage10
Whenlistingfilesand directoriesona FileTransferProtocol(FTP)server,Systemiclients listthefiles inboththei5/OSformatandtheUNIX-styleformat. ThistopicdiscussestheUNIXformat.
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol(FTP)serversubcommands.
“SITE(SendInformationUsed bya ServerSystem)”onpage55
TheSITEi5/OSFTPserversubcommandsendsinformationorprovidesservices thatareusedbythe FTPserver.
MKD
(Make
Directory)
TheMKDi5/OSFTPserversubcommandcreates adirectory.
FTPserver
subcommand
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol(FTP)serversubcommands.
MODE
(Set
TransferMode)
TheMODEi5/OSFTPserversubcommandspecifies themodeordataformatinwhichyouwant transmitdata.
FTPserver
subcommand
B Specifiesblockmode. Inthis mode,dataisaseries ofdatablocks,precededbyoneormore headerbytes.
S Specifiesstreammode. Inthis mode,dataisastreamofbytes.Youcanuseanyrepresentation typewithstreammode. Thistransfer modeismoreefficientbecausetheFTPserverdoesnot transferanydatablockinformation.
Notes:
1. Streammodeisthedefaulttransfermodethatthesystemuses.Itisthepreferredmode.
2. Ifthereisnoparameter,theFTPserverreturnsa replythatindicatesthepresentsettingfor
MODE. Related reference MKDdirectoryname MODE[B|S] | | |
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol (FTP)serversubcommands.
NLST
(Name
List)
TheNLSTi5/OSFTPserversubcommanddisplays namesofmultiplefiles,a filegroup,a directory,ora library.
FTPserver
subcommand
ItlistsonlythosefilesthatFTPcantransfer.
Related tasks
“ConfiguringFTPservers forgraphicalFTPclients andWebtools”onpage8
FileTransfer Protocol(FTP)servers onthei5/OSoperatingsystemsupportgraphical FTPclients,Web browsers,and otherWeb tools.BecausemostgraphicalFTPclients usetheUNIX-styleformatastheir listformatandpathfileastheirfilenameformat, youneedtoconfigureyour FTPservertosupport these formats.
Related reference
“Fileanddirectoryentriesini5/OSformat”onpage9
Systemiclients supportlistingthefilesona FileTransferProtocol(FTP)serverinboththei5/OS formatandtheformatspecifictoUNIX.Thistopicdiscussesthei5/OSformat.
“Filesand directoryentriesinUNIX-style format”onpage10
Whenlistingfilesand directoriesona FileTransferProtocol(FTP)server,Systemi clientslistthefiles inboththei5/OSformatand theUNIX-styleformat. ThistopicdiscussestheUNIXformat.
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol (FTP)serversubcommands.
NOOP(Obtain
Server
Response)
TheNOOPi5/OSFTPserversubcommand checksif theFTPserverisconnected andresponding.Ifthe serverisresponding, theserversendsanOKreply totheclient.Thesubcommand doesnotaffectserver processingin anyotherway.
FTPserver
subcommand
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol (FTP)serversubcommands.
PASS(Password)
ThePASSi5/OSFTPserversubcommandsendsa passwordtotheFTPserver.
FTPserver
subcommand
password
Astringthatspecifiesyour passwordfortheserversystem.
NLST[directory|name]
NOOP
Note: TheUSERserversubcommandmust immediatelyprecedetheserversubcommandPASS
immediately.
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol(FTP)serversubcommands.
PASV(Use
Passive
Data
Connection)
ThePASVi5/OSFTPserversubcommand tellstheFTPservertopassivelyopenthenext dataconnection.
FTPserver
subcommand
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol(FTP)serversubcommands.
PBSZ
(ProtectionBuffer
Size)
ThePBSZi5/OSFTPserversubcommanddefinesthelargest buffersizetobeusedforapplication-level encodeddatasentorreceivedonthedataconnection.
FTPserver
subcommand
wherevalueisanASCIIcharacterstringrepresentinga decimalinteger.
Note: Youmustspecifya valueof’0’forthisparameter. Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol(FTP)serversubcommands.
PORT
(Data
Port)
ThePORTi5/OSFTPserversubcommandidentifies thedataportonwhichtheclientwilllistenfora connection.
FTPserver
subcommand
hn RepresentsthesystemIPaddressandisa characterstringthatisadecimalvalue between0and 255.
pn RepresentstheTCPportnumber andisacharacterstringthatisadecimal valuebetween0 and 255.
Toconvertthep1and p2valuestoa TCPportnumber,usethisformula:
port = ( p1 * 256 ) + p2
Forexample,inthisPORT subcommand:
PORT 9,180,128,180,4,8
PASV
PBSZvalue
theportnumber is1032and theIPaddress is9.180.128.180.
Note: Afteritclosestheconnection,theFTPservercannotconnecttothesameclientIPaddressand port
number untilatwo-minutetimedelayhasoccurredasspecifiedinTCP/IPRequestforComments (RFC)1122.TheFTPservercanmakea connectiontothesameclientIPaddressonadifferentport number withoutthisrestriction.
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol (FTP)serversubcommands.
PROT
(Data
ChannelProtection
Level)
ThePROTi5/OSFTPserversubcommanddefinestheprotectionusedforFTPdataconnections,which areusedtotransmitdirectorylistingsand filedata.
FTPserver
subcommand
Table2.Parametervalues:
Parametervalue Definition
C Clear.Thedataconnectioncarries″rawdata″ofthefile
transferwithnosecurityapplied.
P Private.ThedataconnectionwilluseTransportLayer
Security(TLS)orSecureSocketsLayer(SSL),which providesIntegrityandConfidentialityprotection.
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol (FTP)serversubcommands.
PWD
(Display
WorkingDirectory
or
Library)
ThePWDi5/OSFTPserversubcommanddisplays thenameofthecurrentdirectoryorlibrary.
FTPserver
subcommand
Related reference
“FileTransferProtocolserversyntax conventions”onpage141
Followthesesyntax conventionswhenyouusetheFileTransferProtocol (FTP)serversubcommands.
QUIT
(End
an
FTPServer
Session)
TheQUITi5/OSFTPserversubcommandlogs offfromtheclientuser andclosesthecontrolconnection. Ifafiletransfer isinprogress, theconnection remainsopenuntil thefiletransfer iscomplete, andthen theservercloses theconnection.