Third-Party Copy via Local z/OS, from UNIX to UNIX

Third-Party Copy via Local z/OS, from UNIX to UNIX via Universal Copy

The following figure illustrates the third-party copying of a file from a local z/OS system, which executes a ucopy command from UNIX to UNIX.

//S1 EXEC UCMDPRC
//UNVIN    DD DSN=hlq.userid(useridunxr),DISP=SHR
//LOGONDD  DD DSN=hlq.userid(useridunxs),DISP=SHR
//SCRIPT   DD *
export UCOPYPATH=/opt/universal/bin
export UCMDPATH=/opt/universal/bin
export OUTPUTFILE=/outputfile
export INPUTFILE=/inputfile
export UNIXRHOST=receivinghostname
export TEMPUNIXRID=/tmp/unixid.tmp
export MODE=text
$UCOPYPATH/ucopy -output $TEMPUNIXRID
$UCMDPATH/ucmd \
 -cmd "$UCOPYPATH/ucopy -output $OUTPUTFILE" < $INPUTFILE \
 -host $UNIXRHOST -encryptedfile $TEMPUNIXRID -level info -stdin -mode $MODE
rc=$?
rm $TEMPUNIXRID
exit $rc
//SYSIN    DD *
 -script SCRIPT
 -encryptedfile LOGONDD
 -host unixshost
 -level info
/*

All error messages will be routed to the z/OS manager. The authentication information for both UNIX servers must reside on the z/OS.

The file is copied as a text file since the default transfer mode for standard files is text.

Parameters

The following parameters should be changed to match your information:

Parameter	Description
UCOPYPATH	Path pointing to the ucopy executable on the second UNIX server
UCMDPATH	Path pointing to the ucmd executable on the second UNIX server
OUTPUTFILE	Path and filename of receiving file
INPUTFILE	Path and file name of sending file
UNIXSHOST	IP address or hostname of sending UNIX server
UNIXRHOST	IP address or hostname of receiving UNIX server
TEMPUNIXRID	Temporary file on the sending UNIX server used to house the encrypted logon information for the receiving UNIX server.
MODE	Mode of file transfer (binary / text). Default is set to text.
USERUNXR	Points to the userid / password information for the receiving UNIX server.
USERUNXS	Points to the userid / password information for the sending UNIX server.

SYSIN Options

The SYSIN options used in this example are:

Option	Description
-script	DD from which to read a script file. The script file is sent to the remote system for execution.
-encryptedfile	DD from which to read an encrypted command options file.
-host	Directs the command to a computer with a host name of unixshost.
-level	Sets the level of message information.