User's Guide

TRANFILE

Transfer files to a remote system

Function:

Transfer files to a remote system. Upon transmission, the file will be left in it's original directory, removed, or moved to a backup directory.

Parameters:

INFILE
Input files. File names matching this specification will be processed. Wild-card specifications are permitted.

OUTSYS
Output system. The remote system to which the files matching INFILE will be transferred.

OUTDIR
Output directory. The output directory on OUTSYS to which the files matching INFILE are to be transferred.

TRANSOPT("MOVE")
Transfer option. Describes how to handle the original files after they have been transferred to the remote system:

  = COPY    : Leave the original files intact
  = MOVE    : Remove the original files
  = BACKUP  : Move the original files to the BACKDIR directory

LOGFILE
Log file name. File where all processing messages will be logged. An extension of ;LOG is assumed.

BACKDIR(--)
Backup directory. If TRANSOPT is BACKUP, the original files will be moved to this directory after they have been successfully transmitted to the remote system. If TRANSOPT is not BACKUP, this parameter will be ignored.

Examples:

  1. LAS> tranfile infile=[dir1.dir2]ah*.arch outsys=edcsg1 outdir=[sg1.final.dir] transopt=backup logfile=mylog backdir=[my.backup.dir]

    All files matching "ah*.arch" in the directory "[dir1.dir2]" will be copied to "[sg1.final.dir]" on the remote system "edcsg1". Once each file has been successfully transmitted, it is moved to the directory "[my.backup.dir]". Messages are logged in "mylog;log".

  2. LAS> tranfile infile=[dir1.dir2]ah*.arch outsys=edcsg1 outdir=[sg1.final.dir] transopt=move logfile=mylog backdir=--

    All files matching "ah*.arch" in the directory "[dir1.dir2]" will be copied to "[sg1.final.dir]" on the remote system "edcsg1". Once each file has been successfully transmitted, it is removed from "[dir1.dir2]". Messages are logged in "mylog;log".

  3. LAS> tranfile infile=[dir1.dir2]ah*.arch outsys=edcsg1 outdir=[sg1.final.dir] transopt=copy logfile=mylog backdir=--

    All files matching "ah*.arch" in the directory "[dir1.dir2]" will be copied to "[sg1.final.dir]" on the remote system "edcsg1". The original files will be left in "[dir1.dir2]". Messages are logged in "mylog;log".

Description/Algorithm:

All of the files matching INFILE will be transmitted to OUTDIR on the remote system OUTSYS. Post-processing will be performed on the files matching INFILE based on the specified TRANSOPT option. Messages are logged in LOGFILE.

Nonfatal Error Messages:

Fatal Error Messages:

User Notes:

  1. The UNIX remote copy "rcp" utility is used to transfer files to the specified remote system.
  2. Files with the syntax "root;sufix1;sufix2" should not be processed using this routine.