CPUT Command

HSI Version: 

All

Purpose: 

Conditionally stores a file if the HPSS file does not exist or the local file is newer

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.  This overrides the -U flag, and also overrides

the cput command.

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

[-X max] : set max concurrent transfers


Keywords: 

BACKUP DIRn 

Usage Notes: 

1. This command will overwrite an existing HPSS file if the local file has a more recent modification

timestamp.  Note that cput with '-t' does not take timestamps into account - it acts as an unconditional 

"retransmit" without checking to see if the local file is newer than the HPSS file.


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


See the Restricted TCP Ports and Restricted Hosts section for information on dealing with firewalls.


Example: 

 

Related Command(s): 

PUT, CGET, GET