LOCALUSER Statement—Specify a User ID on the Agent Computer for the Downloaded File

C-LANG Statements › LOCALUSER Statement—Specify a User ID on the Agent Computer for the Downloaded File

LOCALUSER Statement—Specify a User ID on the Agent Computer for the Downloaded File

The LOCALUSER statement specifies a user ID on the computer where the agent is installed. This user ID determines the access permissions of a downloaded file on the agent computer. When the file is downloaded, the file is created with this user as the file owner.

Note: This statement only applies to CA WA Agent for UNIX or Linux. To set the owner of a downloaded file, the agent must run as root.

Supported Job Types

This statement is optional for the following job types:

Syntax

This statement has the following format:

LOCALUSER user_id

user_id

Specifies a user ID on the computer where the agent is installed.

Limits: Up to 128 characters; case-sensitive; cannot contain delimiters (such as spaces)

Notes:

This statement only applies to downloads (TRANSFERDIRECTION set to D or DOWNLOAD).
The local user ID does not require a password to be stored on the scheduling manager.
Your agent administrator can specify a default local user for all FTP, Secure Copy, and Secure FTP jobs by setting the ftp.download.owner parameter in the agent's agentparm.txt file.
The LOCALUSER statement overrides the default setting specified in the ftp.download.owner parameter in the agent's agentparm.txt.

Example: Change the Owner of a File Downloaded from a Remote Server

This example downloads the file_size8 file from the /ul/test/ftpdata directory on the simon server using the Secure Copy Protocol (SCP). After the file is downloaded, the agent computer contains a file named scp_file_size8_local_user in the /u1/causer/data directory. The owner of the file is test. The remote operating system type is UNIX.

AGENT UNIXAGENT
LOCALNAME /ul/causer/data/scp_file_size8_local_user
REMOTENAME file_size8
REMOTEDIR /u1/test/ftpdata
SERVERADDR simon
SERVERPORT 22
TRANSFERDIRECTION DOWNLOAD
USER causer
LOCALUSER test
TARGETOSTYPE UNIX