CPUT Command

HSI Version: 

All

Purpose: 

Conditionally stores a file only if the HPSS file does not exist

Aliases: 

SAVE

Command Format: 

{cput[] | s[ave]} [-A "string"] [-B | -b] [-d] [-F on|off] [-h] 

[-M mode] [-n] [-P | -p] [-Q] [-R | -r] [-T on|off] [-t] 

[-U | -u] [-X max] [ path 


Options: 

-A : annotation string for HPSS file (type "annotate ?"for more details)

-B | -b : backup option. Renames existing HPSS file by appending "~"

-d : remove local files after success transfer to HPSS

-F on|off : enable or disable use of the HPSS Local File Mover, overriding any configuration settings in the HSIRC file(s)

-h : symlink option. If specified, create symlink in HPSS if local symlink. If not set, reads through local symlinks when copying files to HPSS

-M mode: specifies octal mode to use for file creations

-n days : only put files modified within last "days" number of days

-P : create intermediate HPSS subdirectories for the file(s) if they do not exist

-p : preserve timestamp. Attempts to copy local file's timestamp to HPSS file

-Q: if running as the HPSS "root" user, preserve the local owner/group for HPSS files and directories that are created

-R | -r : recursively store directories 

-T on|off : enable or disable use of the HPSS Transfer Agent, overriding any configuration settings in the HSIRC file(s)

-t : "re-put" operation. Restart a previously failed operation, using the size of the

existing HPSS file as the starting offset.

-U | -u : update option. Only copy file to HPSS if local file timestamp is newer

[-X max] : set max concurrent transfers


Keywords: 

BACKUP DIRn 

Usage Notes: 

This command never overwrites existing files, in contrast to the PUT command. 

The -R option may be specified to recursively CPUT a directory tree. In this case, HPSS subdirectories are automatically created as needed while traversing the local directory tree. 

Example: 

 

Related Command(s): 

PUT, CGET, GET