Home

SLiKSFTP USER'S GUIDE

1. STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E sshconf u fred ssh new config userid fred ase com au cd home fred binary putzip ASE BACKUP INCRO1 backup incrOl zip exit See SAMPLIB member ZIPSFTP3 Copyright Australian Systems Engineering Pty Ltd 2014 Page 29 SLiIKSFTP User s Guide SS12 1012 6 Sample Output 1 The output of a typical SLIKSFTP job using SFTP protocol SLIKSFTP 1 0 Copyright ASE 2012 Mod level ASP1247 121012 1258 sftp gt Demokey 72A3ACE12D17E8 95CF4E5 4B1BCAEB821CE sftp gt userid peterm 192 168 3 129 logging on to server logon successful sftp gt cd home peterm cd ok sftp gt binary binary mode set sftp gt putzip ASE BACKUP INCRO1 big2 zip 20121012 172313 FRI Transfered 1080308 bytes 00036010 b s 20121012 172344 FRI Transfered 2119010 bytes 00034623 b s 20121012 172404 FRI Transfered 3166549 bytes 00055133 b s Transfered 4076707 bytes in 000000087 secs 00046858 b s rw r r 1 peterm users 4076707 Oct 12 17 25 big2 zip sftp gt chmod 644 big2 zip sftp gt exit Child process terminated SLIKSFTP terminating OpenSSH_3 5p1 SSH protocols 1 5 2 0 OpenSSL 0x0090702f debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 deb
2. SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E userid fred ase com au cd home fred binary getzip backup incrOl zip ASE BACKUP INCRO1 NEW exit See SAMPLIB member GETSFTP3 Copyright Australian Systems Engineering Pty Ltd 2014 Page 25 SLiIKSFTP User s Guide SS12 1012 6 12 Transfer a ZIP file from a remote machine UNZIP and decrypt SFTP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E userid fred ase com au cd home fred binary compopt password thisismypassword getzip backup incrOl zip ASE BACKUP INCRO1 NEW exit Es See SAMPLIB member GETSFTP4 13 ZIP amp transfer file using FTP protocol SFTP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E ftp open ase com au userid fred pass mypassword cd zipfiles binary putzip ASE BACKUP INCRO1 backup incrOl zip ls backup incr0l zip quit See SAMPLIB member ZIPFTP1 Copyright Australian Systems Engineering Pty Ltd 2
3. syst help Usage FTP mode only The free format string specified will be sent to the server as a command This allows custom commands not implemented by SLiKSFTP to be sent to the server Usage FTP mode only Displays a status response from the server Usage FTP mode only Displays the type of operation system at the server Usage FTP mode only Displays the help information from the server options option option2 Usage SFTP and FTP mode The OPTIONS statement or command supports the following keywords nostderr Messages normally written to ddname STDERR will be discarded mergeout Messages normally written to ddname STDERR will be written to STDOUT replace A PUT or PUTZIP operation will replace an existing file of the same name on the remote host If both REPLACE and NOREPLACE are omitted REPLACE is the default noreplace A PUT or PUTZIP operation will not replace an existing file of the same name on the remote host If both RESUME and NORESUME are omitted NORESUME is the default Copyright Australian Systems Engineering Pty Ltd 2014 Page 15 SLiIKSFTP User s Guide SS12 1012 6 e resume A PUT or PUTZIP operation will resume a previously interrupted transfer of the same file to the remote host If both RESUME and NORESUME are omitted NORESUME is the default e noresume A PUT or PUTZIP operation will not resume a previously interrupted transfer of the same file to the remote host The transfe
4. 2014 SS12 1012 6 SLiIKSFTP User s Guide SS12 1012 6 WC A dd dee dee 15 A E 15 R A T 15 E CNS A E EAT 16 MMOL EE 16 TE 16 GE ee EE 16 o EE nina ida 16 Me lt PIOAIP IIS OSes Gated dee Ee E 16 e TMI A A age 16 EE 16 gr A ts bacibuteda betta cazcswasnl sacs dheveaba S 16 E e EE 17 Keepa VAAN TN 17 6 gt JEY MNT EE 17 compopt option le EE EE 17 ET 17 e DIAN dd a 17 We CUT A E E O ES E em araasran 17 LK EE 18 REEL ee A e clung a i 18 o A A a 18 PASS WOLUDISS EE 18 CIES E 18 TOTS LACE wire rics NoMa A Ee 18 We SEIT EE 18 o MOSHI ee a otal Arcata dae rias 19 e cs ce cion EE EE 19 Nr ZE 19 FRU ee tt ee ee ee 19 OO WIAD teehee eine ie Sh Ree ee ee eRe ee A ee 19 Oe APOLO EAE 19 S Comment only TTS A EE 20 Sample JOB Et lO O Ek 20 1 Transfer file change file s mode on remote host c ooocicccionicocicnconocnnnancncnnnnnannnnnons 20 2 ZIP amp transfer file change file s mode on remote host eee eeeteeeeeeeeeeeeeees 21 3 ZIP encrypt amp transfer a file set file s mode on remote host eee eeeeeeeeeee 21 4 Translate file from EBCDIC to ASCII amp transfer it cooocnononicnnnnonicncnnononcnncnncnncnnons 22 5 Zip a file translating from EBCDIC to ASCII and transfer it eee 22 6 Retrieve a file from remote host anida dela EE 23 7 Retrieve a text file translating from ASCII to EBCDIC An 23 8 Translate file from EBCDIC to ASCI
5. Ltd 2014 Page 44 SLiIKSFTP User s Guide SS12 1012 6 Publication number SS12 1012 6 This manual serves as a reference source for users of the SLIKSFTP product Please use this form to comment on the publication in terms of its organization or content with the understanding that ASE may use or distribute the information that you supply in any way that it believes appropriate without incurring an obligation to you If you require further copies of this publication please order them through your ASE representative If you require assistance in the installation configuration or use of the SLIKSFTP product please contact ASE for support Suggested aspects that might be addressed by your comments include Clarity Accuracy Completeness Organization Examples Legibility Please give your name and address if you require a reply name email Address Occupation Comments Copyright Australian Systems Engineering Pty Ltd 2014 Page 45
6. Pty Ltd 2014 Page 22 SLiIKSFTP User s Guide SS12 1012 6 6 Retrieve a file from remote host SETP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DC Be RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E userid fred ase com au cd home fred binary get database backup ASE DATABASE BACKUP exit hf See SAMPLIB member GETSFTP1 7 Retrieve a text file translating from ASCII to EBCDIC SFTP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD 7 STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E userid fred ase com au cd home fred ascii get newreport txt ASE NEW REPORT exit See SAMPLIB member GETSFTP2 Copyright Australian Systems Engineering Pty Ltd 2014 Page 23 SLiIKSFTP User s Guide SS12 1012 6 8 Translate file from EBCDIC to ASCII without removing trailing blanks amp transfer it SFTP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E useri
7. Usage SFTP and FTP mode Remove directory dirname on the remote host rm remotefile Usage SFTP and FTP mode Remove file remotefile from the current directory on the remote host pwd Usage SFTP and FTP mode Print the name of the working or current directory on the remote host sshconf configfilename Usage SFTP mode only Specifies the name of an alternate ssh configuration file to be passed to ssh This will override the system ssh options This statement must occur before the USERID statement sshopt option Usage SFTP mode only Specifies an option to be passed to ssh This allows individual options in the ssh config file to be overridden This statement must occur before the USERID statement passive Usage FTP mode only Toggles the state of the passive transfer mode If passive mode is on then the server will listen on a data port and wait for a connection from the client rather than initiate a session on the receipt of a transfer command By default passive mode in on Passive mode is necessary if the client is located behind a firewall Normally the server will not be able to start a data session with the client if the session must pass through a firewall site siteoptions Usage FTP mode only The site command allows options that are unique to the server to be sent Copyright Australian Systems Engineering Pty Ltd 2014 Page 14 SLiIKSFTP User s Guide SS12 1012 6 quote string stat
8. b s 20130121 115048 MON Transfered 11564536 bytes 00117995 b s 20130121 115052 MON Transfered 12596688 bytes 00258038 b s 20130121 115100 MON Transfered 13660597 bytes 00132988 b s 20130121 115109 MON Transfered 14680137 bytes 00127442 b s 20130121 115117 MON Transfered 15757138 bytes 00134625 b s 20130121 115121 MON Transfered 16798132 bytes 00260248 b s 20130121 115131 MON Transfered 17827434 bytes 00114366 b s 20130121 115135 MON Transfered 18894351 bytes 00266729 b s 20130121 115144 MON Transfered 19935179 bytes 00115647 b s 20130121 115149 MON Transfered 20990781 bytes 00263900 b s 20130121 115157 MON Transfered 22026819 bytes 00129504 b s 20130121 115200 MON Transfered 23089149 bytes 00354110 b s 20130121 115209 MON Transfered 24134299 bytes 00130643 b s 20130121 115213 MON Transfered 25182256 bytes 00261989 b s 20130121 115221 MON Transfered 26217916 bytes 00129457 b s 20130121 115224 MON Transfered 27273057 bytes 00351713 b s 20130121 115231 MON Transfered 28330964 bytes 00176317 b s 20130121 115234 MON Transfered 29383508 bytes 00350848 b s 20130121 115238 MON Transfered 30432018 bytes 00262127 b s 20130121 115244 MON Transfered 31483741 bytes 00175287 b s 20130121 115247 MON Transfered 32532251 bytes 00349503 b s 20130121 115250 MON Transfered 33580888 bytes 00349545 b s 20130121 115258 MON Transfered 34604819 bytes 00146275 b s 20130121 115302 MON Transfered 35653998 bytes 00262294 b s 20130121 115310 MON Transfered 36728835 bytes 00134354
9. b s 20130121 115319 MON Transfered 37772411 bytes 00130447 b s 20130121 115324 MON Transfered 38808099 bytes 00207137 b s 20130121 115332 MON Transfered 39853610 bytes 00130688 b s 20130121 115341 MON Transfered 40922098 bytes 00133561 b s 20130121 115345 MON Transfered 41963063 bytes 00260241 b s 20130121 115355 MON Transfered 43023576 bytes 00117834 b s 20130121 115359 MON Transfered 44068662 bytes 00261271 b s Transfered 44415223 bytes in 000000354 secs 00125466 b s 226 File receive OK sftp gt ls d070802 t16 227 Entering Passive Mode 192 168 3 129 178 8 150 Here comes the directory listing rw r r 1 1000 100 44415223 Jan 21 00 57 d070802 t16 226 Directory send OK sftp gt quit 221 Goodbye SLIKSFTP terminating SLIKZIP 2 0 Copyright ASE 2012 Serial No Demo ZIP0007I levels P1225 121109 1319 P1225 121109 1319 P1225 121109 1319 ZIP0087I PARM demokey B405CDD5688B3 63DF3E1DD18E86AB8A7A3 CTLDD ZIP FROMDD SYS00008 TODD EXIT OVERWRITE ZIP0149I Control statement listing lt 1 2 3 statement area 5 6 7 gt ZIP0243I exits enabled PUMS OPEN CLOS WRIT ZIPO0213W WARNING License key expires today ZIP0091I mon 11 48 07 start ZIP todd EXIT ZIPO103I reading PS U dataset ASE DAILY REPORT D070802 T16 ZIPO178I options are ADD Member Ext_used I p size Strips to O p_size Save Path filename y 148483328 148483328 44415049 70 ASE DAILY REPORT D070802 T16 proce
10. site command failed Check any error messages correct problem and rerun the job ZIP621E quote command failed The quote command failed Check any error messages correct problem and rerun the job ZIP622E command failed The command failed Check any error messages correct problem and rerun the job ZIP623E sshconf must be before userid statement The sshconf statement is misplaced It must be before the userid statement ZIP624E sshopt must be before userid statement The sshopt statement is misplaced It must be before the userid statement ZIP625E pwd command failed The pwd command failed Check any error messages correct problem and rerun the job ZIP625E ftp mode not set SLiKSFTP is running in SFTP mode This control statement can only be used in FTP mode ZIP626E sftp command not supported in ftp mode SLiKSFTP is running in FTP mode This control statement can only be used in SFTP mode ZIP627E Child process terminated unexpectedly The SLiKSFTP USS process has ended unexpectedly ZIP628E select failed Copyright Australian Systems Engineering Pty Ltd 2014 Page 35 SLiIKSFTP User s Guide SS12 1012 6 The TCP select command failed Check error messages ZIP629E timeout The TCP select command timed out The connection to the server has failed ZIP633E read failed TCP read command failed ZIP635E message buffer too small The buffer to read messages into is too small Contact ASE support ZIP636E Unexpecte
11. size to use when transferring data The maximum value is 98304 This value should be larger than the record length of the file being transferred keepalive nnnn Sets the TCP_KeepAlive socket option to the value specified 1 2147460 seconds The default is the system tcp value This parameter allows you to override the system value if TCP sessions are timing out TCP will send a keep alive packet at the specified interval to keep the session active retry nnnn Sets the maximum number of times that SLIKSFTP will retry a transfer that has failed due to a network error The default is 5 compopt option1 optionz2 Usage SFTP and FTP mode This statement specifies options for the compress uncompress process when performing a PUTZIP or GET ZIP operation The following keywords are supported ascii During a PUTZIP operation every byte of the data to be transferred will be first translated from EBCDIC to ASCII During a GETZIP operation the decrypted and unzipped data will be translated from ASCII to EBCDIC Note that this differs from ASCII control statement above The ASCII control statement also appends a carriage return and line feed to each record This option just translates the record to ASCII you then must specify either LF or CRLF to append line terminator characters binary Perform a binary transfer The file being transferred is not to be subject to any form of translation If During a PUTZIP each record t
12. suitable BLKSIZE value e Specify BINARY during the transfers to prevent any translation Copyright Australian Systems Engineering Pty Ltd 2014 Page 6 SLiIKSFTP User s Guide SS12 1012 6 e Use the following JCL to RECEIVE the XMIT file TSO EXEC PGM IKJEFTO1 SYSTSPRT DD SYSOUT SYSTSIN DD DELETE SLIKS110 INSTALL RECEIVE INDA hlq SLIKS110 INSTALL XMIT DELETE SLIKS110 SFTPSAMP RECEIVE INDA SLIKS110 INSTALL SFTPSAMP DELETE SLIKS110 SFTPLOAD RECEIVE INDA SLIKS110 INSTALL SFTPLOAD This will create the load module library h lg SLIKS110 SFTPLOAD and the sample library hlq SLIKS110 SFTPSAMP Product Activation The copy of SLIKSFTP you download from the ASE website is a full function demo version Once installed you must obtain a key in order to use it A key good for the current day only may be obtained anonymously from the SLIKSFTP web site at http www ase com au sliksftp ssdemo htm Alternatively you may complete a Trial Agreement fax it to ASE and we will email you a key for a 30 day extended trial The key is a 34 character string that must be supplied to the demo version of SLiKZiP in a control statement so that the product will function The control statement will look like this demokey hnonnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn The string of n s represents the 34 character key If the key is invalid or has exp
13. the first two positions of a control statement line as this will be interpreted by z OS as an end of file indicator Sample Jobs 1 Transfer file change file s mode on remote host SLIKZ EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E userid fred ase com au cd home fred binary put ASE BACKUP INCRO1 backup incroOl chmod 644 backup incrol exit See SAMPLIB member PUTSFTP1 Copyright Australian Systems Engineering Pty Ltd 2014 Page 20 SLiIKSFTP User s Guide SS12 1012 6 2 ZIP amp transfer file change file s mode on remote host SETP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E userid fred ase com au cd home fred binary putzip ASE BACKUP INCRO1 backup incrOl zip chmod 644 backup incrO0l zip exit ES See SAMPLIB member ZIPSFTP1 3 ZIP encrypt transfer a file set file s mode on remote host SETP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSO
14. unzipped The selection mask can be generic e g Report dat e text During a PUTZIP operation every byte of the data to be transferred will be first translated from EBCDIC to ASCII and each record will have a carriage return and line feed characters appended During a GETZIP operation the decrypted and unzipped data will be translated from ASCII to EBCDIC and carriage return and line feed characters will be removed from each record e trunc During a GETZIP operation if the uncompressed record is longer than the logical record for the output dataset then the record will be truncated e wrap During a GETZIP operation if the uncompressed record is longer than the logical record for the output dataset then the record will be wrapped into multiple records This is the default e zip64 Specifies that the 64 bit zip file architectural option is to be used This option must be specified if there is a possibility that the z OS dataset contains 4GB or more of data Compliant unzip programs on the remote system will support the ZIP64 architecture Copyright Australian Systems Engineering Pty Ltd 2014 Page 19 SLiIKSFTP User s Guide SS12 1012 6 comment only lines A comment only line may be inserted at any point in the control statement file Note that at least the first position of a comment only line must be blank The first or left most non blank characters on a comment only line must be Do not place in
15. 014 Page 26 SLiIKSFTP User s Guide SS12 1012 6 14 ZIP encrypt transfer a file using FTP protocol SFTP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E ftp open ase com au userid fred pass mypassword binary cd zipfiles compopt password thisismypassword putzip ASE BACKUP INCRO1 backup incrOl zip quit See SAMPLIB member ZIPFTP2 15 ZIP selected members from a PDS translate to ascii append linefeed to each record and transfer the zip file using FTP protocol SFTP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E ftp open 192 168 3 129 user peterm pass password compopt select s dat t rpt ascii t lf putzip ASEPMD ASE CNTL work zip ls work zip quit See SAMPLIB member ZIPFTP3 Copyright Australian Systems Engineering Pty Ltd 2014 Page 27 SLiIKSFTP User s Guide SS12 1012 6 16 Use SLiKZIP control statements to ZIP multiple datasets translating to ascii append carriage return linefeed to each record remove trailing blanks a
16. 076559 90 1 members overall totals 40545344 40545344 4076559 90 1 members ZIPOO83I fri 17 24 12 end ZIP returned re 0000 cpu 69 4 sec ZIPO206I terminating with COND CODE 0000 2 The output of a typical SLIKSFTP job using FTP protocol SLIKSFTP 1 0 Copyright ASE 2013 Mod level ASP1284 130118 1842 sftp gt Demokey B405CDD5688B363DF3E1DD18E8 6AB8A7A3 sftp gt ftp ftp mode set sftp gt open haystak ase com au 220 Welcome to FTP service sftp gt user peterm 331 Please specify the password sftp gt password suppressed 230 Login successful sftp gt binary binary mode set sftp gt putzip ASE DAILY REPORT D070802 T16 d070802 t16 227 Entering Passive Mode 192 168 3 129 95 69 200 Switching to Binary mode 150 Ok to send data 20130121 114830 MON Transfered 1052724 bytes 00040489 b s 20130121 114853 MON Transfered 2097976 bytes 00047511 b s 20130121 114921 MON Transfered 3177880 bytes 00038568 b s Copyright Australian Systems Engineering Pty Ltd 2014 Page 31 SS12 1012 6 SLiIKSFTP User s Guide SS12 1012 6 20130121 114937 MON Transfered 4206286 bytes 00068560 b s 20130121 115002 MON Transfered 5253675 bytes 00041895 b s 20130121 115011 MON Transfered 6315918 bytes 00118027 b s 20130121 115016 MON Transfered 7360840 bytes 00208984 b s 20130121 115025 MON Transfered 8390173 bytes 00128666 b s 20130121 115033 MON Transfered 9448482 bytes 00132288 b s 20130121 115038 MON Transfered 10502579 bytes 00210819
17. 2013 Initial version 5 SLIKSFTP V1 0 Sep 2013 6 SLIKSFTP V11 Mar 2014 Support for GET GETZIP PUTZIP in FTP mode Related Publications None Published by Australian Systems Engineering Pty Ltd 126A Gillies Street FAIRFIELD Victoria 3078 Australia telephone 61 3 9419 4200 email help slikzip com Trademarks OS 390 and z OS are registered trademarks of IBM Corp PKZIP and PKUNZIP are registered trademarks of PKWARE Inc UNIX is a registered trademark of The Open Group Windows is a registered trademark of Microsoft Corporation WinZip is a registered trademark of WinZip Computing Inc Copyright Australian Systems Engineering Pty Ltd 2014 Page 2 SLiIKSFTP User s Guide Contents OverviewWw Tnstalling SLIKSFTP Rs Product AG E Installing SLIKSFTP license YAA Sap JCL aan AA Fame gea FTP Oia AN SEE SP TP Control ttm A An demokey KEY A ain AREE a R TARAS opet TH rare userid SEHR Eege EENS UE RE gl EE cd MEMO laa adios put mvsdsnidd ddinames remote tile ains putzip mvsdsn dd ddname remotefile cee eceseeeseeneeeeeeeeeeeeeeeeaeees Get remotefile mysdsn dd ddname nsnsnsnnnseseseseseseseeeesesesesesesessseee getzip mvsdsn dd ddname remotezmphle chmod mode remotefile ici es chorp ap remotas chown owner e E EXE CU expat assennaerenedansnnneasiiodiueaasaavenivimadaziecadassmmansvatauimnassionaanerincits IER A mkdir AMAS i EIERE Copyright Australian Systems Engineering Pty Ltd
18. I without removing trailing blanks amp e EE 24 9 Transfer an EBCDIC text file to another EBCDIC machine eee 24 Copyright Australian Systems Engineering Pty Ltd 2014 Page 4 SLiIKSFTP User s Guide SS12 1012 6 10 ZIP amp transfer file suppress Zip messages c cee eseeceseseeseescesceeceeseeseeseeeeneens 25 11 Transfer a ZIP file from a remote machine and UNZIP ss sssssssesesssssssseessesesese 25 12 Transfer a ZIP file from a remote machine UNZIP and decervpnt ee 26 13 ZIP amp transfer file using FTP protocol adidas 26 14 ZIP encrypt amp transfer a file using FTP protocol ooocnononicnnnicninninncnncnnncnncnnos 27 15 ZIP selected members from a PDS translate to ascii append linefeed to each record and transfer the zip file using FTP protocol oocococonidnocionionncnocnoncnnnanonconcnncnnnnnos 27 16 Use SLiKZIP control statements to ZIP multiple datasets translating to ascii append carriage return linefeed to each record remove trailing blanks and transfer the Ap Tile using ELP protol assoc ce aay tate agn ech aren n 28 II Transfer a ZIP file from a remote machine and UNZIP a selected member translating from ascii and removing the line feed from the end of each record 29 18 ZIP amp transfer file using an alternate ssh configuration 0 0 eset eeeeeeeeee 29 Sample Output bp ed ege 1 The output of a typical SLIKSFTP job using SFTP protocol erte 30 2 The output ofa Se SLI
19. KSFTP job using FTP protocol 0 0 cc eeeseereeeeeees 31 MES ts aio O Copyright Australian Systems Engineering Pty Ltd 2014 Page 5 SLiIKSFTP User s Guide SS12 1012 6 Overview SLIKSFTP is utility program that provides direct transfer of z OS mainframe MVS datasets to and from remote sites in compliance with the SFTP or FTP protocol SLiKSFTP operates as an SFTP or FTP client MVS datasets are transferred directly to remote sites There is no need to copy the data to the USS file system SLiKSFTP also has built in compression routines that enable it to convert an MVS dataset to a zip file on the fly When this option is chosen the compression and the transfer operations proceed in parallel Typically the transfer time will be significantly less than either the time required to transfer the MVS dataset uncompressed or the time required to first zip the MVS dataset and then transfer the resulting zip file ASE makes it easy for you to trial SLiKSFTP anonymously so you can decide for yourself if it will help your business computing be more effective Installing SLiKSFTP SLiKSFTP is installed by downloading the install SMIT file from the ASE website www ase com au sliksftp ssdemo htm e Download SLIKS110 INSTALL ZIP to your PC workstation e Extract file SLIKS110 INSTALL XMIT e Transfer file SLIKS110 INSTALL XMIT to a z OS dataset named hlg SLIKS110 INSTALL XMIT e Use dataset attributes RECFM FB LRECL 80 amp a
20. SZ12 1012 6 SLIKSFTP Industrial Grade Data Transfer for z OS platforms USER S GUIDE Version 1 Release 1 March 2014 Copyright Australian Systems Engineering Pty Ltd 2014 SLiIKSFTP User s Guide SS12 1012 6 LICENSED MATERIAL COPYRIGHT Australian Systems Engineering Pty Ltd 2012 2013 2014 This material always remains the property of Australian Systems Engineering Pty Ltd and must be used only in accordance with the terms of the agreement under which it is supplied Manual and Product identifiers This manual is identified by a publication number SZ121012 combined with a revision level number sometimes called a dash level 6 The licensed software product of which this manual is a part is identified by a Product Name or Product Acronym and an Edition Number Edition numbers are made up ofa Version number and a Release number within that version The material in this manual is intended to be used with SLIKSFTP Version 1 Release 1 The edition number may appear in licensed material in abbreviated forms like the following V1R1 and V1 1 From time to time ASE may issue replacements for or additions to the pages in this manual Each time the entire manual is replaced by a later version then the revision level the dash level part of the publication identifier will be increased by 1 Publication history Dash product ver rel GA date Highlights added features 4 SLIKSFTP V10 Apr
21. UT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E userid fred ase com au cd home fred binary compopt password thisismypassword putzip ASE BACKUP INCRO1 backup incrOl zip chmod 644 backup incrO0l zip exit See SAMPLIB member ENCSFTP1 Copyright Australian Systems Engineering Pty Ltd 2014 Page 21 SLiIKSFTP User s Guide SS12 1012 6 4 Translate file from EBCDIC to ASCII transfer it SFTP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E userid fred ase com au cd home fred ascii put ASE DAILY REPORT report txt chmod 644 report txt exit Ef See SAMPLIB member PUTSFTP2 5 Zip a file translating from EBCDIC to ASCII and transfer it SFTP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E userid fred ase com au cd home fred ascii putzip ASE DAILY REPORT report zip chmod 644 report txt exit See SAMPLIB member ZIPSFTP2 Copyright Australian Systems Engineering
22. ataset could not be opened Check the name is correct and that you have permission to open the dataset ZIP666E Packet size value too small The value specified for the size option is too small It needs to be at least two bytes larger than the record length of the file being transferred Z1P6671 Existing filepart found xxxxxxxxxxx bytes resuming transfer Copyright Australian Systems Engineering Pty Ltd 2014 Page 39 SLiIKSFTP User s Guide SS12 1012 6 An incomplete transfer file was found on the remote server The transfer will resume from the specified point ZIP6701 Transfered xxxxxxxxxxxx bytes in XXXXXXXXX SecS Xxxxxxxx b s This message lists the number of bytes transferred then time taken and the bytes per second ZIP674E attach failed for TESTSLIK The TESTSLIK program could not be attached Contact ASE for support ZIP675E attach failed for SLiKZiP SLIKZIP could not be attached Contact ASE for support ZIP676E No such file The file does not exist on the remote system ZIP680E Chmod failed The chmod command failed Check that you have permission to perform the operation ZIP682E directory already exists You attempted a mkdir command for a directory that already exists on the remote system ZIP683E mkdir failed The mkdir command failed Check that you have permission to perform the operation ZIP685E rm failed The mkdir command failed Check that you have permission to perform the operation Z1P6871 cd ok T
23. cified file failed Check preceding messages for the cause of the failure ZIP7331 CR LF will be appended to ASCII records Each record translated to ASCII will have a carriage return and line feed appended ZIP7341 renaming oldname to newname File oldname will be renamed to file newname Z1P7351 logon failed Logon to the remote server failed Check the correct logon id has been specified and correct ssh keys have been setup ZIP7361 Socket error retc xxxxxxxx reaSON XXXXXXXX An error occurred during a socket call The return code and reason code are listed ZIP7371 Wrong file offset This is an internal logic error Please report to ASE support ZIP7381 Repositioning File During a get operation the zip file on the remote machine needs to be reopened and positioned to an earlier position in the file ZIP7431 Connection error restarting connection An error has occurred with the connection to the remote machine causing the current transfer to fail An attempt will be made to restart the connection and complete the transfer Copyright Australian Systems Engineering Pty Ltd 2014 Page 43 SLiIKSFTP User s Guide SS12 1012 6 ZIP7441 Connection error Maximim retries reached aborting An error has occurred with the connection to the remote machine causing the current transfer to fail The connection will not be restarted because the maximum number of retries has been reached Copyright Australian Systems Engineering Pty
24. command failed The size of the file on the remote server cannot be determined ZIP655E Error during transfer size is wrong local xxxx remote xxxx The size of the file on the remote server differs from the number of bytes transferred The transfer has failed ZIP656I File size is correct The size of the file on the remote server agrees with the number of bytes transferred Copyright Australian Systems Engineering Pty Ltd 2014 Page 38 SLiIKSFTP User s Guide SS12 1012 6 Z1P6571 Deleting existing file The existing file on the remote server will be deleted prior to the newly transferred file being renamed ZIP658E dele command failed The delete command failed SLIKSFTP was unable to delete the existing file Check that you have permission to delete the file Z1P6591 Renaming filepart to correct name The temporary filepart name is being renamed to the correct file name ZIP660E rnfm command failed The ftp rename from command failed The file cannot be renamed ZIP661E rnto command failed The ftp rename to command failed The file cannot be renamed Check you have permission to rename the file Z1P6621 Transfer complete The file transfer has completed successfully ZIP664E File exists and noreplace specified transfer aborted The file to be transfered already exists on the remote server and the replace option has not be specified The file will not be transferred ZIP665E open failed for mvs dataset The mvs d
25. correct ssh keys have been setup ZIP648E allocation failed Allocation for the mvs dataset failed Check the correct dataset has n been specified ZIP644E Named pipe creation failed Creation of a named pipe failed ZIP645E Open failed for named pipe The named pipe could not be opened ZIP646E Error during compress operation An error occurred during the compress or uncompresses operation Check the messages from SLIKZIP for more details Copyright Australian Systems Engineering Pty Ltd 2014 Page 37 SLiIKSFTP User s Guide SS12 1012 6 ZIP647E Non zero return code during uncompress operation check listing An error occurred during the compress or uncompresses operation Check the messages from SLIKZIP for more details ZIP648E allocation failed for dsname The specified dataset could not be allocated Check that the correct name has been specified 71P6491 Checking for incomplete previous transfer SLiKSFTP will check on the server for a previous transfer that did not complete ZIP650E size command failed SLiKSFTP sent a SIZE command to the remote server The command failed ZIP6511 No incomplete previous transfer There was no incomplete previous transfer Z1P6521 Incomplete file found A previous transfer failed SLIKSFTP has found an incomplete file and will resume the transfer Z1P6531 checking file size is correct The size of the file on the remote server wil be compared ZIP654E SIZE command failed The ftp SIZE
26. d fred ase com au cd home fred ascii options nostrip put ASE DAILY REPORT report txt chmod 644 report txt exit G See SAMPLIB member PUTSFTP3 9 Transfer an EBCDIC text file to another EBCDIC machine SFTP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E userid fred ibm com au cd u fred ebcdic put ASE DAILY REPORT report txt chmod 644 report txt exit See SAMPLIB member PUTSFTP4 Copyright Australian Systems Engineering Pty Ltd 2014 Page 24 SLiIKSFTP User s Guide SS12 1012 6 10 ZIP transfer file suppress zip messages SFTP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E userid fred ase com au cd home fred binary options nozipmsgs putzip ASE BACKUP INCRO1 backup incr01l zip exit Lf See SAMPLIB member ZIPSFTP3 11 Transfer a ZIP file from a remote machine and UNZIP SETP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT
27. d message SLiKSFTP received an unexpected message from the server The message will be printed Contact ASE support ZIP637E TO pipe creation failed Creation of a UNIX pipe failed Contact ASE for support ZIP638E FROM pipe creation failed Creation of a UNIX pipe failed Contact ASE for support ZIP639E stderr pipe creation failed Creation of a UNIX pipe failed Contact ASE for support ZIP640E fentl getfl failed The fentl command failed Contact ASE for support ZIP641E fentl non blocking failed The fentl to make pipe non blocking failed Contact ASE for support ZIP642E fork failed Fork of child process failed Contact ASE for support ZIP06431 SSH failed Ret xxxx res xxxx Copyright Australian Systems Engineering Pty Ltd 2014 Page 36 SLiIKSFTP User s Guide SS12 1012 6 The call to SSH has failed This message lists the return and reason codes for the failure ZIP06431 FTP failed Ret xxxx res xxxx The call to FTP has failed This message lists the return and reason codes for the failure ZIP06441 child exit SLiKSFTP USS process has ended Z1P06451 logging on to server SLiKSFTP is attempting to logon to the remote server Z1P06461 attach failed for wait for child subtask The wait for child subtask could not be attached Contact ASE for support ZIP0648I logon successful Logon to the remote server was successful Z1P06491 logon failed Logon to the remote server failed Check the correct logon id has been specified and
28. e debugl got SSH2 MSG SERVICE_ACCEPT debugl authentications that can continue publickey keyboard interactive debugl next auth method to try is publickey debugl try pubkey u peterm ssh id_rsa debugl input_userauth_pk_ok pkalg ssh rsa blen 149 lastkey 1203e0a8 hint 0 debugl read PEM private key done type RSA debugl ssh userauth2 successful method publickey debugl fd 7 setting O NONBLOCK debugl fd 8 setting O NONBLOCK debugl fd 9 setting O NONBLOCK debug1 channel 0 new client session debugl send channel open 0 debugl Entering interactive session debugl ssh_session2 setup id 0 debug1 Sending subsystem sftp debug1 channel request 0 subsystem debug1 channel 0 open confirm rwindow 0 rmax 32768 SLIKZIP 2 0 Copyright ASE 2012 Serial No Demo ZIPOOO7I levels P1225 121012 0948 P1225 121012 0948 P1225 121012 0948 ZIP00871 PARM demokey 72A3ACE12D17E8 95CF4E54B1BCAEB821CE CTLDD ZIP FROMDD SYS00001 TODD EXIT OVERWRITE ZIP0149I Control statement listing lt 1 2 3 statement area 5 6 7 gt ZIP0243I exits enabled OPEN CLOS WRIT ZIP0213W WARNING License key expires today ZIPOO91I fri 17 22 45 start ZIP todd EXIT ZIPO103I reading PS U dataset ASE BACKUP INCRO1 ZIPO178I options are ADD Member Ext_used I p_size Strips_to O p_size Save Path filename 40545344 40545344 4076559 90 ASE BACKUP INCRO1 process totals 40545344 40545344 4
29. es or parentheses Note that fora PUTZIP operation password will be required at the remote system to unzip the file e replace During a GETZIP operation if the target MVS dataset is a PDS then existing members that are uncompressed will be replaced e noreplace During a GETZIP operation if the target MVS dataset is a PDS then existing members will are uncompressed will not be replaced This is the default e strip Removes trailing blanks from each text record before transferring the record during a PUT or PUTZIP operation Either ASCII or EBCDIC command must Copyright Australian Systems Engineering Pty Ltd 2014 Page 18 SLiIKSFTP User s Guide SS12 1012 6 also be specified This will reduce the amount of data transferred especially if the input file has RECFM FB This is the default for text files e nostrip Suppresses removal of trailing blanks from each text record before transferring the record during a PUT or PUTZIP operation e select selectionmask For a PUTZIP operation if the mvs dataset specifies a PDS then the selection mask is used to select members of the PDS to be added to the zip file The selection mask has the form member ext The member part is used to select the members of the PDS and can be generic e g D txt The ext part is appended to each member name selected to create the default name for the zip file member For a GETZIP operation the selection mask is used to select members of the zip file to be
30. g setsockopt so_keepalive failed The program was unable to set the TCP SO _KEEPALIVE socket option ZIP719E Invalid Demokey value The demokey value is incorrect Check that you have coded the correct value ZIP721E signal failed An attempt to send a USS signal failed 71P7221 testslik This message indicates that TESTSLIK is running ZIP7231 testslik ended This message indicates that TESTSLIK has ended 71P7241 Response This message documents the response to the previous command sent to the server 71P7251 SIZE command not supported restart disabled The SIZE command is not supported by the FTP server The restart facility cannot be used with this server ZIP726I No incomplete previous transfer SLiKSFTP did not find any incomplete transfer on the server SLIKSFTP will transfer the complete file ZIP727E Unable to get attributes of remote file filename SLiKSFTP was unable to read attributes for the specified file ZIP728E rename failed oldname to newname SLiKSFTP was unable to rename oldname to newname ZIP729E delete failed for filename SLiKSFTP was unable to delete the specified file Check that the user is authorized to delete the file Copyright Australian Systems Engineering Pty Ltd 2014 Page 42 SLiIKSFTP User s Guide SS12 1012 6 ZIP731E Open failed for filename The specified file could not be opened Check that the user is authorized to open the file 71P732E Transfer failed for filename The transfer of the spe
31. he cd command was completed successfully ZIP688E not a directory Copyright Australian Systems Engineering Pty Ltd 2014 Page 40 SLiIKSFTP User s Guide SS12 1012 6 The cd command cannot be completed as the specified file is not a directory ZIP689E read failed Sliksftp was unable to read from a named pipe failed ZIP690E unexpected return from select A TCP IP select command ended with an unexpected return code ZIP691E socket write with translation failed A write to a TCP IP socket failed ZIP692E Bad PASV SIZE SYST response The response to the PASV command was not in the expected format ZIP694E Error during socket write An error occurred while writing to a socket ZIP697E Unexpected message or message format The message was not expected or the format of the message differed from the expected format ZIP698E pasv command failed The PASV command did not return the response expected Z1P6991 Restarting transfer at offset xxxxxxxXxXxxxx An incomplete file transfer was found on the remote server The transfer will be resumed at the specified offset ZIP7071 YY YY MMDD HHMMSS DAY Transfered xxxxxxxxxx bytes xxxxxxxxx b s This is a transfer progress message It details the number of bytes transferred ZIP708E setting setsockopt tcp_keepalive failed The program was unable to set the TCP KEEPALIVE socket option Copyright Australian Systems Engineering Pty Ltd 2014 Page 41 SLiIKSFTP User s Guide SS12 1012 6 ZIP709E settin
32. ired you ll get this message and SLiKZiP will terminate immediately ZIPO207I DEMOKEY value missing or invalid for today s date terminating Installing SLiKSFTP license key Copyright Australian Systems Engineering Pty Ltd 2014 Page 7 SLiIKSFTP User s Guide SS12 1012 6 When you take out a license for SLIKSFTP from ASE you will not have to supply DEMOKEY statements to use the software Instead ASE will supply you with a 12 month key The key can be installed in the product by running the job in member LICENSE of the sample library During the duration of your license term ASE will automatically supply a replacement 12 month key 45 days prior to the expiry of the current key that you are using SLiKSFTP will automatically start warning users via message ZIP0213W when the current key is less than 31 days from expiring Copyright Australian Systems Engineering Pty Ltd 2014 Page 8 SLiIKSFTP User s Guide SS12 1012 6 Using SLiIKSFTP The program is designed to be used in z OS batch Sample JCL for running SLiKSFTP SLIKZ EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD control statements go here See SAMPLIB member RUNSFTP SSH Connection Authentication for SETP When running as a SFTP client the connection to the
33. nd transfer the zip file using FTP protocol SETP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E ftp open 192 168 3 129 user peterm pass password putzip work zip ls work zip quit SLIKCNTL DD zip OVERWRITE fromds ase ase cntl s s dat ascii Lf fromds asepmd ase cntl s s jcl ascii 1f todd exit See SAMPLIB member ZIPFTP4 Copyright Australian Systems Engineering Pty Ltd 2014 Page 28 SLiIKSFTP User s Guide SS12 1012 6 17 Transfer a ZIP file from a remote machine and UNZIP a selected member translating from ascii and removing the line feed from the end of each record SETP EXEC PGM SLIKSFTP REGION 4M STEPLIB DD DISP SHR DSN ASE SLIKSFTP LOAD STDOUT DD SYSOUT STDERR DD SYSOUT SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 SYSIN DD Demokey 4EE5D584A133FEC2569394A6375364E48E userid fred ase com au cd home fred binary compopt ascii 1lf select ssh2 jcl replace getzip work zip ASE UNZIP CNTL exit See SAMPLIB member GETSFTP5 18 ZIP amp transfer file using an alternate ssh configuration SFTP EXEC PGM SLIKSFTP REGION 4M
34. ord for the userid specified on the userid statement cd remotedir Usage SFTP and FTP mode Change directory on the remote host This command enables the user to identify where in the remote host s filesystem subsequent file amp directory management commands operate binary Usage SFTP and FTP mode Perform a binary transfer The file being transferred is not to be subject to any form of translation ascii Usage SFTP and FTP mode During a PUT or PUTZIP operation every byte of the data to be transferred will be first translated from EBCDIC to ASCII and LF sequences will be inserted as record terminators During a GET or GETZIP operation the decrypted and unzipped data will be translated from ASCII to EBCDIC LF or CRLF sequences will be removed from the end of each record crlf Usage SFTP and FTP mode During a PUT or PUTZIP operation a carriage return and line feed sequence will be inserted at the end of each record before it is processed Copyright Australian Systems Engineering Pty Ltd 2014 Page 11 SLiIKSFTP User s Guide SS12 1012 6 During a GET or GETZIP operation CRLF characters will be removed from the end of each record If Usage SFTP and FTP mode During a PUT or PUTZIP operation a line feed sequence will be inserted at the end of each record before it is processed During a GET or GETZIP operation line feed characters will be removed from the end of each record ebcdic Usage SFTP and FTP mode D
35. r will be restarted from the beginning of the file If both RESUME and NORESUME are omitted NORESUME is the default e progress Show progress messages during transfer If both PROGRESS and NOPROGRESS are omitted PROGRESS is the default e noprogress Do not show progress messages during transfer If both PROGRESS and NOPROGRESS are omitted PROGRESS is the default e zipmsgs Causes messages from the zip unzip program to be written to the SYSPRINT DD statement This will show compression statistics for PUTZIP and GETZIP operations This is the default e nozipmsgs Suppresses the printing of messages from the zip unzip program e mow nnnn Maximum outstanding writes For each write the server responds with a status message Performance is improved if these messages are processed in a group rather than individually The mow nnnn parameter specifies the number of write requests that will be performed before a status response is read from the server The default value is 1000 This parameter only affects SFTP transfers e ignorerr Causes errors reported by the FTP server to be ignored This can be used to avoid SLiKSFTP terminating if a command such as RM fails due to a non existent file e noignorerr Non zero return codes from FTP commands will cause SLIKSFTP to terminate This is the default Copyright Australian Systems Engineering Pty Ltd 2014 Page 16 SLiIKSFTP User s Guide SS12 1012 6 size nnnn Sets the maximum packet
36. ransferred will have a linefeed character appended as a record terminator before being compressed Copyright Australian Systems Engineering Pty Ltd 2014 Page 17 SLiIKSFTP User s Guide SS12 1012 6 During a GETZIP operation the end of each decrypted record will be determined by the presence of a linefeed character The linefeed character will be removed before writing the record to the output dataset e crlf During a PUTZIP each record transferred will have a carriage return and linefeed characters appended as a record terminator before being compressed During a GETZIP operation the end of each decrypted record will be determined by the presence of a carriage return linefeed pair The carriage return and linefeed characters will be removed before writing the record to the output dataset e member name Used when performing a PUTZIP operation to specify the member name in the zip file for the compressed mvs dataset e opt string Specifies a free format string of options to be passed to the compression program e password password For a PUTZIP operation the zip file member is to be encrypted using AES 128 192 256 bit encryption using password For a GETZIP operation if the zip file member is encrypted using AES 128 192 256 bit encryption decryption will be attempted using password Note that password may be up to 99 characters in length password must be enclosed in doublequotes if it contains spaces commas apostroph
37. remote site is established via SSH As SLiKSFTP runs as a batch job a non interactive authentication method such as public key authentication is required Refer to the Chapter 7 Getting ready to use OpenSSH in the IBM Ported Tools for z OS User s Guide SA22 7985 for details on how to configure SSH authentication Running as an FTP client By default SLIKSFTP runs as a SFTP client The FTP control statement can be used to run as FTP client The FTP statement must be the first statement in the control statement file or the first statement after the demokey statement SLiKSFTP Control Statements Control statements or commands are read via ddname SYSIN They have the format Verb operands Some statements can only be used in either SFTP mode or FTP mode Statements can be continued over multiple lines using the trailing plus syntax Copyright Australian Systems Engineering Pty Ltd 2014 Page 9 SLiIKSFTP User s Guide SS12 1012 6 compopt select s dat t rpt ascii t lf When a statement is to be continued make the last non blank character or the last non blank character prior to any a plus sign If the following line has any leading spaces they will be ignored This means that if the statement syntax requires a blank or space to separate two process options for example then at least one space must precede the Comments can be added to the end of any control statement Comment
38. s begin with the characters e g Demokey C96A98378CC7DA37572DB107CE9F6AFC31 Today s key The following commands are supported demokey key Usage SFTP and FTP mode Specifies the trial license key Key values current for today only may be obtained from the SLiIKSFTP page at http www ase com au sliks ftp ssdemo htm Trial users must provide a valid enabling key by placing a demokey statement as the first line in the control statement file Licensed users of SLIKSFTP are provided with a long term key which they install in the SLIKSFTP load module thus removing the need for the demokey statement ftp Usage FTP mode only Switch to FTP mode The FTP protocol will be used to transfer data to from the server The ftp statement should follow the demokey statement and precede all FTP commands open hostname port Usage FTP mode only Specifies the remote host to logon to Optionally you can specify a port number to override the default port 21 Copyright Australian Systems Engineering Pty Ltd 2014 Page 10 SLiIKSFTP User s Guide SS12 1012 6 userid username hostname Usage SFTP mode only Specifies the remote host to logon to and the user name to use A session is established with the remote host via ssh userid username Usage FTP mode only Specifies the username to use when logging on to the remote ftp server pass password Usage SFTP and FTP mode Specifies the passw
39. ss totals 148483328 148483328 44415049 70 1 members overall totals 148483328 148483328 44415049 70 1 members ZIP0083I mon 11 54 01 end ZIP returned rc 0000 cpu 320 2 sec ZIPO206I terminating with COND CODE 0000 Copyright Australian Systems Engineering Pty Ltd 2014 Page 32 SLiIKSFTP User s Guide SS12 1012 6 Messages ZIP601E Missing Continuation Card The end of the control statement file was reached before the expected continuation statement for the last statement was found The last statement ended with a character which indicates that the statement is continued on the next line Z1P6021 Child process terminated The UNIX System Services task attached by SLIKSFTP has ended ZIP6031 SLIKSFTP terminating rc SLIKSFTP is ending with the specified return code ZIP606E demokey statement required A demokey statement must appear be the first statement in the control statement file ZIP604E unknown control statement The control statement is not valid Check the statement for syntax errors ZIP605E user command failed The command failed Check any error messages correct problem and rerun the job ZIP607E cd command failed The cd command failed Check any error messages correct problem and rerun the job Z1P6081 binary mode set All data will be transferred as binary characters No translation will be performed Z1P6091 ascii mode set All data will be translated to from ASCII ZIP610I1 ebcdic mode set Copyright Aus
40. t is allocated dd ddname getzip mvsdsn dd ddname remotezipfile Usage SFTP and FTP mode Transfer file remotezipfile on the remote host unzipping it to create a z OS dataset Specify either a dataset name myvsdsn or a ddname to which the dataset is allocated dd ddname If the mvsdsn is specified as then the uncompression program will read control statements from the SLIKCNTL DD statement to determine the data to be uncompressed and the uncompression options This feature allows more advanced uncompress operations to be performed chmod mode remotefile Usage SFTP mode only Changes the permissions of the file remotefile to mode Mode must be an octal number chgrp grp remotefile Usage SFTP mode only Changes the group the file remotefile to grp grp must be a numeric GID chown owner remotefile Usage SFTP mode only Changes the owner of file remotefile to owner owner must be a numeric UID exit bye quit Usage SFTP and FTP mode Terminate the ssh session with the remote host ls remotefile Usage SFTP and FTP mode List statistics for file remotefile on the remote host Ifremotefile is a directory the contents of the directory are listed If directory is not specified the current working directory is listed mkdir dirname Usage SFTP and FTP mode Copyright Australian Systems Engineering Pty Ltd 2014 Page 13 SLiIKSFTP User s Guide SS12 1012 6 Make directory dirname on the remote host rmdir dirname
41. tralian Systems Engineering Pty Ltd 2014 Page 33 SLiIKSFTP User s Guide SS12 1012 6 All data will be translated to from EBCDIC All x 15 characters will be treated as end of record characters ZIP611E put command failed The put command failed Check any error messages correct problem and rerun the job ZIP612E get command failed The get command failed Check any error messages correct problem and rerun the job ZIP6131 debug mode set Diagnostic message will be issued ZIP614E mkd command failed The mkd command failed Check any error messages correct problem and rerun the job ZIP615E rmd command failed The rmd command failed Check any error messages correct problem and rerun the job ZIP616E rm command failed The rm command failed Check any error messages correct problem and rerun the job Z1P6171 ftp mode set SLiKSFTP will connect to the remote server as an ftp client ZIP618I1 passive mode off SLiKSFTP will not use passive mode to perform transfers The server will open a session with the client to transfer data This may not work if the client is behind a firewall In this case passive mode should be used Z1P6191 passive mode on Copyright Australian Systems Engineering Pty Ltd 2014 Page 34 SLiIKSFTP User s Guide SS12 1012 6 SLiKSFTP will use passive mode to perform all transfers In passive mode the client will initiate a data session with the server ZIP620E site command failed The
42. ug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 debug1 Reading configuration data etc ssh ssh_config Rhosts Authentication disabled originating port will not be trusted ssh_connect needpriv 0 Connecting to 192 168 3 129 192 168 3 129 port 22 Connection established identity file u peterm ssh id_rsa type 1 identity file u peterm ssh id_dsa type 1 Remote protocol version 1 99 remote software version OpenSSH 4 1 match OpenSSH 4 1 pat OpenSSH Enabling compatibility mode for protocol 2 0 Local version string SSH 2 0 OpenSSH 3 5p1 SSH2_MSG KEXINIT sent SSH2_MSG KEXINIT received kex server gt client aes128 cbc hmac md5 none kex client gt server aes128 cbc hmac md5 none SSH2_MSG KEX DH GEX REQUEST sent expecting SSH2 MSG KEX DH GEX_GROUP dh_gen_key priv key bits set 124 256 bits set 1022 2048 SSH2_MSG KEX DH GEX_INIT sent expecting SSH2_MSG KEX DH GEX REPLY Host 192 168 3 129 is known and matches the RSA host key Found key in u peterm ssh known_hosts 1 bits set 1022 2048 ssh_rsa_verify signature correct kex_derive_ keys newkeys mode 1 SSH2_MSG NEWKEYS sent waiting for SSH2 MSG NEWKEYS newkeys mode 0 SSH2_MSG NEWKEYS received done ssh_kex2 send SSH2_MSG SERVICE_REQUEST service accept ssh userauth Copyright Australian Systems Engineering Pty Ltd 2014 Page 30 SLiIKSFTP User s Guid
43. uring a PUT or PUTZIP a EBCDIC new line character x 15 will be inserted at the end of each record During a GET or GETZIP operation the EBCDIC new line character x 15 will mark the end of each logical record and will be removed The ebcdic option should be used when transferring text data between z OS systems put mvsdsn dd ddname remotefile Usage SFTP and FTP mode Transfer a z OS dataset to file remotefile on the remote host The file is not compressed Specify either a dataset name mvsdsn or a ddname to which the dataset is allocated dd ddname putzip mvsdsn dd ddname remotefile Usage SFTP and FTP mode Transfer z OS dataset to file remotefile on the remote host The z OS dataset content will be compressed on the fly and remotefile will be in the zip file format Specify either a dataset name mvsdsn or a ddname to which the dataset is allocated dd ddname If the mvsdsn is specified as then the compression program will read control statements from the SLIKCNTL DD statement to determine the data to be compressed and the compression options This feature allows more advanced zip files to be transferred to the remote system Get remotefile mvsdsn dd ddname Usage SFTP and FTP mode Copyright Australian Systems Engineering Pty Ltd 2014 Page 12 SLiIKSFTP User s Guide SS12 1012 6 Transfer file remotefile from remote host to a z OS dataset Specify either a dataset name mvsdsn or a ddname to which the datase

SLiKSFTP USER'S GUIDE

Contents

Download Pdf Manuals

Related Search

Related Contents