Followthesesyntaxconventions whenyouusetheFile TransferProtocol(FTP)clientsubcommands.
UppercaseLetters
Lettersprintedinuppercase inthesyntaxdefinitionsforclientsubcommandsaretheminimum numberoflettersthatyoumust enter.YoucanenterFTPclientsubcommandsineitheruppercase orlowercase.
LowercaseWordsorHyphenatedTerms
Lowercasewordsorhyphenatedterms,likeremotefile andaccount-information,represent variablesthatyoumustsubstitute specificinformation.
Brackets[]
Youcanconsider words,symbols,orphrasesplacedwithinbracketstobe optional.
LeftParentheses (andAsterisks*
Youmust enterleftparenthesesandasterisksexactlyastheyappearninthesyntax definitions.
Braces{}
Bracesindicatea groupofparameters,values,orvariablesthatyoumayrepeat.
Ellipsis...
Ellipsesindicatethatyoucanincludezero ormorerepetitionsof thepreceding variableenclosed withinbrackets.
VerticalBar|
Avertical barbetweenparametersorvaluesindicatesthatyoucanspecifyoneortheother,but notboth,at onetime.Theverticalbarsarewithin setsofbracketsorbraces.
Related reference
“FileTransferProtocolclientsubcommands”onpage60
YouuseFileTransferProtocol(FTP)clientsubcommandstoestablisha connectionwitha remoteFTP server,navigatelibrariesanddirectories,createanddeletefiles,andtransferfiles.
“ACCT(SendAccountInformation)”onpage62
Some systemsrequire accountinformationtoenablecertainsystem functions.Theremote system promptsyouforsuchinformation.TheACCTi5/OSFTPclientsubcommandsendsauser’saccount informationtoa remotesystem.
“APPEND (Appenda LocalFile MembertoaRemoteFile)”onpage62
TheAPPENDi5/OSFTPclientsubcommand addsalocalfilemember,document,orotherfilesystem filetoa remotefile.
“ASCII(ChangeFileTypetoASCII)”onpage63
TheASCIIi5/OSFTPclientsubcommandsetsthefiletransfer typetoASCIIformat.
“BINARY(SetTransferType toImage)”onpage64
TheBINARYi5/OSFTPclient subcommandsetsthefiletransfertype toBINARYformat.
“CCC (ClearCommandChannel)”onpage64
TheCCCi5/OSFTPclientsubcommandchanges thetransmissionmodeinacontrolconnectionfrom theencryptedmodetotheclear-textmode.
“CD(ChangeWorkingDirectoryorLibrary)”onpage65
TheCDi5/OSFTPclientsubcommand changestheworkingdirectory,library,orfilegrouponthe remotesystem.
“CLOSE(EndanFTPSessionwiththeRemoteSystem)” onpage66
TheCLOSEi5/OSFTPclientsubcommandendsyour sessionwith theremotesystem andkeepsFTP activeonyour localsystem.
“DEBUG (CreateClientTraceandControlDisplayofServer SubcommandsSenttoRemoteSystem)”
onpage66
“DEBUG (ChangeClientTime-OutLimitValues)” onpage67
TheDEBUGi5/OSFTPclientsubcommandchanges theclienttimeoutlimitswhenthedefault timeoutvaluesarenotlongenoughfora datatransfertobe completedsuccessfully.Youonlyneedto changethesevaluesinsituationswherenetworktrafficorotherconditionscausetransfertimesto becomequitelarge.
“DELETE(Deletea FileonaRemoteSystem)”onpage67
TheDELETE i5/OSFTPclientsubcommand deletesafileordatabase filememberona remote system.Theremotesystem mightpromptyouforauthorizationtodeletea file.UsetheACCT(Send AccountInformation)subcommandtorespondtothatrequest.
“DIR(ListDirectoryEntries,Libraries,orFiles)”onpage68
TheDIRi5/OSFTPclientsubcommanddisplayslibrariesand theircontentsortheremotesystem’s listofdirectoriesanddirectory entries.
“EBCDIC(ChangeFileTypetoEBCDIC)”onpage69
TheEBCDICi5/OSFTPclientsubcommandsetsthefiletransfertype toEBCDICformat.TheEBCDIC transfer typeisusefulwhenyoutransferfiles toorfromanotherEBCDICsystem,becauseitavoids theneedtoconvertbetweenASCII andEBCDIConbothsystems.
“GET(Copya Filefroma RemoteSystemtotheLocalSystem)”onpage69
TheGETi5/OSFTPclientsubcommandcopiesafilefromtheremotesystemtothelocalsystem.
“HELP(GettingHelpforFTPSubcommands)”onpage70
TheHELPi5/OSFTPclientsubcommandprovidesinformationabouttheFTPsubcommandsthatthe localsystemand theremotesystemuse.
“LCD(ChangeWorkingLibrary orDirectoryonLocalSystem)”onpage71
TheLCD i5/OSFTPclientsubcommand changestheworkingdirectoryonthelocalsystem.
“LOCSITE(Specify LocalSiteInformation)”onpage72
TheLOCSITEi5/OSFTPclientsubcommandspecifiesinformationthatisusedbytheFTPclientto provideservices specifictotheclientsystem.
“LOCSTAT(DisplayLocalStatusInformation)” onpage73
TheLOCSTATi5/OSFTPclientsubcommanddisplays localstatusinformation.
“LS (ListRemoteFileNames)”onpage73
TheLSi5/OSFTPclientsubcommandlists thenamesoffiles inafilesetona remotesystem.
“LTYPE(LocalType)”onpage74
TheLTYPE i5/OSFTPclientsubcommand specifiesthefiletransfertypeortherepresentation in whichthetransferistotakeplaceonthelocalsystem.
“MDELETE(DeleteMultiple Filesona RemoteSystem)”onpage74
TheMDELETE i5/OSFTPclientsubcommanddeletesmultiplefiles ontheFTPserver.
“MGET (CopyMultipleFilesfroma RemoteSystemtotheLocalSystem)”onpage75
TheMGETi5/OSFTPclientsubcommandcopiesmultiplefilesfromtheremotesystem.
“MKDIR(MakeDirectory)” onpage76
TheMKDIRi5/OSFTPclientsubcommandcreatesa directoryorsubdirectory.
“MODE(Specify TransmissionModeofData)”onpage77
TheMODEi5/OSFTPclientsubcommandspecifiesa dataformatforfiletransfer.
“MPUT(SendMultipleFileMembersfromtheLocalSystemtoaRemoteSystem)”onpage77
TheMPUTi5/OSFTPclientsubcommandcopiesmultiplelocalfiles totheremote system.
“NAMEFMT(SelectFileNamingFormat)” onpage78
TheNAMEFMTi5/OSFTPclientsubcommandselectswhichfilenameformattouseonthelocal systemand theremotesystem.
“NULLFLDS(AllowTransferofFileswithNULLFields)”onpage79
TheNULLFLDS i5/OSFTPclientsubcommand determineswhethertoallowthetransfer ofdatabase filesthatcontainNULLfieldvaluesonthelocalsystemandtheremotesystem.
“OPEN(ConnecttoFTPServer onaRemoteSystem)”onpage79
“PASS(SendYourPassword)”onpage80
ThePASSi5/OSFTPclientsubcommandsendsa user’spasswordtotheFTPserver.
“PUT (CopyaFileMemberfromtheLocalSystemto aFileona RemoteSystem)”onpage80
ThePUTi5/OSFTPclientsubcommandcopiesalocalfilemembertotheremotesystem.
“PWD(Display CurrentDirectory,Folder,orLibrary)”onpage81
ThePWDi5/OSFTPclientsubcommanddisplaysthecurrentdirectoryoftheremotesystem.
“QUOTE(Senda SubcommandtoanFTPServer)”onpage81
TheQUOTE i5/OSFTPclientsubcommandsendsasubcommandtoanFTPserver.
“REINITIALIZE (ReinitializeSessionbetweenSystems)”onpage83
TheREINITIALIZEi5/OSFTPclientsubcommandrestartsasession onaremotesystem.
“RENAME(RenameaFile ona RemoteSystem)”onpage83
TheRENAMEi5/OSFTPclientsubcommandrenamesafileonaremote system.
“RESET(Reset)”onpage84
TheRESET i5/OSFTPclientsubcommand clearstheserverreply queue.Thissubcommand resynchronizes thesequencingoftheserversubcommandsandreplieswiththeremoteFTPserver. Resynchronizationmight benecessaryafter aviolationoftheFTPprotocolbytheremote system.
“RMDIR (RemoveDirectory)”onpage84
TheRMDIRi5/OSFTPclientsubcommandremovesa directoryontheremotesystem.
“SECData(SettingDataSecurityProtection)” onpage84
TheSECDatai5/OSFTPclientsubcommandspecifies theprotectionleveltobeusedforthedata connectionwhena securecontrolconnection isalreadyestablishedwith theremote system.
“SECOpen(SettingData SecurityProtection)”onpage85
TheSECOpen i5/OSFTPclientsubcommand opensasecurecontrolconnectiontoanFTPserver usingthespecifiedsecurityoption.
“SENDPASV (Specifywhethertosenda PASVSubcommand)”onpage86
TheSENDPASVi5/OSFTPclientsubcommandspecifies whethertosenda PASVsubcommandtothe FTPserverwhen youtransferdataorissue theDIRandLSsubcommands.
“SENDPORT(SpecifyWhethertoSendsa PORTSubcommand)”onpage87
TheSENDPORT i5/OSFTPclient subcommandspecifieswhethertosend aPORTsubcommand tothe FTPserverwhen youtransfera dataorissuetheDIRand LSsubcommands.
“SENDSITE(SpecifyWhethertoSendaSITESubcommand)” onpage88
TheSENDSITE i5/OSFTPclientsubcommand specifieswhetheraSITE subcommandwithrecord formatinformationisautomaticallysentwhenyoudoa PUToran MPUToperation.
“SITE(SendInformationUsed bya RemoteSystem)” onpage88
TheSITEi5/OSFTPclientsubcommand sendsinformationthatisusedbytheremotesystemto provideservices specifictotheremotesystem.
“STATUS(RetrieveStatusInformationfromaRemoteSystem)”onpage89
TheSTATUSi5/OSFTPclientsubcommand displaysstatusinformationofaremote system.
“STRUCT(SpecifyFile Structure)”onpage89
TheSTRUCT i5/OSFTPclientsubcommandspecifiesthestructureofthedatasentfora file.
“SUNIQUE(ControlOverwritingofFiles)”onpage89
TheSUNIQUEi5/OSFTPclientsubcommandcontrolsfilereplacement.SUNIQUEisa separate commandthathastobe issuedbefore thePUTorMPUTsubcommands.
“SYSCMD(PassaCLCommandtoYourLocalSystem)” onpage90
TheSYSCMDi5/OSFTPclientsubcommandenablesyoutorunacontrollanguage(CL)commandon your localsystemwithoutleavingtheFTPenvironment.
“TYPE(SpecifyFile TransferType)”onpage91
TheTYPE i5/OSFTPclientsubcommand specifiesthefile-transfertype,ortherepresentationin whichthetransferistotakeplace.
“USER(SendYourUserIDtotheRemoteSystem)”onpage92
TheUSERi5/OSFTPclientsubcommandsendsauser IDtoa remotesystem.Youcanalso sendthe passwordtogetherwiththeuser ID.
“VERBOSE (ControlofTextDisplayofErrorReplyMessages)”onpage92
TheVERBOSEi5/OSFTPclientsubcommandcontrolsthedisplayofFTPserverreplies.When verboseison,allFTPserverreplies,includingtheirreplycodes,are displayed.Whenverboseisoff, certainFTPserverrepliesandreplycodes arediscardedandare notdisplayed.