Third-Party Copy via Local zOS, from Windows to Windows

Third-Party Copy via Local z/OS, from Windows to Windows 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 Windows to Windows.

The standard error is read into the UMET utility to verify the existence of the input file. The last step copies standard error to the job log.

 

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

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

The UMETSTEP step executes the UMET utility. UMET is used to set the condition code field to a value based on message text. The SYSIN DD is the standard error of the first step and the TABLE DD is the table defining which condition code to be used when text is found.

Note

The UMET program is used because native Windows returns a 0 return (exit) code, even when the stdin does not exist. Therefore, the process would end with a 0, even if the input file did not exist. UMET will set the condition code to 8.

The IEBGENER step will copy the standard error file to SYSLOG if the process gets a non-zero condition code.

Parameters

The following parameters should be changed to match your information:

Parameter

Description

#USERIDNT

Encrypted userid and password member for sending Windows server

#USERIDNT2

Encrypted userid and password member for receiving Windows server

OUTPUTFILE

Path and filename of receiving file

INPUTFILE

Path and file name of sending file

NTHOST

IP address or hostname of sending Windows server

NT2HOST

IP address or hostname of receiving Windows server

TEMPNT2ID

Temporary file on the Windows sending server used to house the encrypted logon information for the Windows receiving server.

MODE

Mode of file transfer (binary / text). Default is set to text.

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 NTHOST.

-level

Sets the level of message information.

Components

Universal Command Manager for z/OS

Universal Command Manager for Windows

Universal Command Server for Windows

Universal Copy