C-LANG Statements › LOCALNAME Statement—Specify the Local File to Transfer (Secure Copy and Secure FTP Jobs)

LOCALNAME Statement—Specify the Local File to Transfer (Secure Copy and Secure FTP Jobs)

The LOCALNAME statement specifies a file on the agent computer to be downloaded or uploaded in a secure file transfer.

Supported Job Types

This statement is required for the following job types:

• Secure Copy
• Secure FTP

Syntax

This statement has the following format:

LOCALNAME file_name

file_name

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

Limits: Up to 256 characters; case-sensitive

Notes:

• For downloads, you must specify the full path and file name without wildcards.
• For uploads, 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.
• You cannot use wildcards in the path.

Notes:

• Enclose values that contain delimiters (such as spaces) in single quotation marks.
• If a wildcard is used in a local file name for upload, the REMOTENAME statement is not required. 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 Multiple Files from the Agent Computer to a Remote Server

This example uploads the files in the c:\temp\upload directory to the /u1/build/uploaded directory on the aixunix server. The job uses the Secure File Transfer Protocol (SFTP). Since the LOCALNAME statement contains a wildcard, the REMOTENAME statement is not specified.

AGENT WINAGENT
SERVERADDR aixunix
TRANSFERDIRECTION UPLOAD
USER causer
REMOTEDIR /u1/build/uploaded
LOCALNAME c:\temp\upload\*