C-LANG Statements › REMOTENAME Statement—Specify a Remote File Name (Secure Copy and Secure FTP Jobs)

REMOTENAME Statement—Specify a Remote File Name (Secure Copy and Secure FTP Jobs)

The REMOTENAME statement specifies a file on a remote server to be downloaded or uploaded in a secure file transfer.

Supported Job Types

This statement is required for the Secure Copy job type.

This statement is optional for the Secure FTP job type.

Note: For Secure FTP jobs, the REMOTENAME statement is required if the LOCALNAME statement does not contain a wildcard.

Syntax

This statement has the following format:

REMOTENAME file_name

file_name

Specifies the file's source location (if downloading) or the file's destination (if uploading).

Limits: Up to 256 characters; case-sensitive

Notes:

• For uploads, you must specify the file name without wildcards.
• For downloads, you can use wildcards for the file name if you are using the Secure FTP job. You cannot use wildcards if you are using the Secure Copy job. The asterisk (*) is a wildcard for zero or more characters and the question mark (?) is a wildcard for a single character.
• You cannot rename files if wildcards are used.

Mainframe:

• By default, the data set high-level prefix is set to the user ID of the logged-on user.
• To specify a different high-level prefix, fully qualify the value and wrap double quotes around it, for example: "'SYS4.CA7.JCLLIB(CA07XX01)'".

Notes:

• Enclose values that contain delimiters (such as spaces) in single quotation marks.
• If a wildcard is used in a remote file name for download, the local file name (the target) must refer to a directory. A wildcard transfer is equivalent to an mget transfer using an FTP client.

Example: Download a File from a Remote Server to the Agent Computer

This example downloads the install.log1 file from the root directory on the chi-linux server using the Secure Copy Protocol (SCP):

AGENT WINAGENT
LOCALNAME C:\temp\install.log1
REMOTENAME install.log
REMOTEDIR /root
SERVERADDR chi-linux
SERVERPORT 22
TRANSFERDIRECTION DOWNLOAD
USER causer

Example: Upload a File from the Agent Computer to a Remote Server

This example uploads the logs.tar file to the /u/tmp directory on the hpsupport server. The job uses the Secure File Transfer Protocol (SFTP).

AGENT WINAGENT
TRANSFERDIRECTION UPLOAD
SERVERADDR hpsupport
REMOTEDIR /u/tmp
REMOTENAME logs.tar
LOCALNAME D:\temp\logs.tar
USER causer