PUT Command

HSI Version: 

All

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] [-c on|off][-d] [-F on|off] [-H algorithm][-h] [-M mode] [-n] [-P | -p] [-Q] [-R | -r] [-T on|off] [-t] [-U | -u] [-X max] [-Y style] path

Options: 

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


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


-c on|off:: enable or disable creation of HPSS checksums, which are stored separately from the file data in HPSS. This option overrides both the default compile-time option, and the hsirc setting for enabling/disabling checksums. Checksums can also be created for existing HPSS files by using the HASHCREATE command, and .can be verified either by using the HASHVERIFY command, or by using the GET command with "-c on".


Important Note: Checksum generation is very CPU-intensive and can signifcantly impact file transfer performance. As much as 80% degradation in transfer rates has been observed during testing of this feature.


-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 algorithm : specifies checksum hashing algorithm to use when generating a checksum (-c on). The default algorithm is chosen by the HPSS administrator when HSI is built, and can be overridden in the global or private hsirc file(s). HSI is released with the default algorithm set to md5. Valid case-insensitive possible values for this option are: "none" (no checksum), "sha1", "sha224", "sha256", "sha384", "sha512", "md5" (default), "crc32", "adlier32"


-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 : [HSI 4.0.1.2+] set maximum concurrent transfers for this command. This may only be used to reduce, not increase, the value set by the HPSS administrator.


-Y style : [HSI 4.0.1.2+] specifies the style of checksum to search for when verifying an existing checksum (-c option). Valid colon-separated, case-insensitive options are: "hsi" (default), "vfs" or "hpsssum". If more than one style of checksum is specified, the precedence order is: 1 - HSI-style, 2-VFS-style, 3-HPSSSUM-style.

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. See Using PIPEs for Input/Output for information on piping files into HPSS from an operating system utility or iteractively from the TTY

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