PUT Command

HSI Version: 

2.7

Purpose: 

Saves or replaces a file. If the HPSS file does not exist, a new file is created; if the HPSS 

file exists, it is overwritten. 

Aliases: 

REPLACE, SEND, STORE

Command Format: 

put [-A "string"] [-B | -b] [-d] [-F on|off] [-h] 
[-M mode] [-n] [-P | -p] [-Q] [-R | -r] [-T on|off] [-t] 
[-U | -u]  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

Keywords: 

FAMILY BACKUP DIRn

Usage Notes: 

1. This command always overwrites existing files, in contrast to the CPUT command.

2. see the FTP Compatibility and Path Names pages for information on valid characters and renaming files on get and put commands

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

Example: 

put local_file_name : hpss_file_name

Related Command(s): 

CPUT, GET