Displays block numbers as part of the listing (-t option). This is normally used only for debugging.
Sets debug level (0 - N) for htar. 0 disables debug, 1 - n enable progressively higher levels of debug output. 5 is the highest level; anything > 5 is silently mapped to 5. 0 is the default debug level.
If present, specifies that a local file should be used for the file specified by the "-f Archive" option. If not specified, then the archive file will reside in HPSS.
Uses Archive as the name of archive to be read or written. Note: This is a required parameter for htar, unlike the standard tar utility, which uses a built-in default name.
If the Archive variable specified is - (minus sign), the tar command writes to standard output or reads from standard input. If you write to standard output, the -I option is mandatory, in order to specify an Index File, which is copied to HPSS if the Archive file is successfully written to standard output. [Note: this behavior is deferred - reading from or writing to pipes is not supported in the initial version of htar].
Forces the htar command to follow symbolic links as if they were normal files or directories. Normally, the tar command does not follow symbolic links.
Specifies the index file name or suffix. If the first character of the index_name is a period, then index_name is appended to the Archive name, e.g. "-f the_htar -I .xdnx" would create an index file called "the_htar.xndx". If the first character is not a period, then index_name is treated as a relative pathname for the index file (relative to the Archive file directory) if the pathname does not start with "/", or an absolute pathname otherwise.
The default directory for the Index file is the same as for the Archive file. If a relative Index file pathname is specifed, then it is appended to the directory path for the Archive file. For example, if the Archive file resides in HPSS in the directory "projects/prj/files.tar", then an Index file specification of "-I projects/prj/files.old.idx" would fail, because htar would look for the file in the directory "projects/prj/projects/prj". The correct specification in this case is "-I files.old.idx".
Writes the files and directories listed in the "InputList" file to the archive. Directories named in the InputList file are not treated recursively. For directory names contained in the InputList file, the tar command writes only the directory entry to the archive, not the files and subdirectories rooted in the directory. Note that "home directory" notation ("~") is not expanded for pathnames contained in the InputList file, nor are wildcard characters, such as "*" and "?".
Uses the time of extraction as the modification time. The default is to preserve the modification time of the files. Note that the modification time of directories is not guaranteed to be preserved, since the operating system may change the timestamp as the directory contents are changed by extracting other files and/or directories. htar will explicitly set the timestamp on directories that it extracts from the Archive, but not on intermediate directories that are created during the process of extracting files.
Provides backwards compatibility with older versions (non-AIX) of the tar command. When this flag is used for reading, it causes the extracted file to take on the User and Group ID (UID and GID) of the user running the program, rather than those on the archive. This is the default behavior for the ordinary user. If htar is being run as root, use of this option causes files to be owned by root rather than the original user.
Says to restore fields to their original modes, ignoring the present umask. The setuid, setgid, and tacky bit permissions are also restored to the user with root user authority.
Specifies the buffer size to use when reading or writing the HPSS tar file. The buffer size can be specified as a value, or as kilobytes by appending any of "k","K","kb", or "KB" to the value. It can also be specified as megabytes by appending any of "m" or "M" or "mb" or "MB" to the value, for example, 23mb.
Specifies the maximum number of threads to use when copying local member files to the Archive file. The default is defined when htar is built; the release value is 20. The maximum number of threads actually used is dependent upon the local file sizes, and the size of the I/O buffers. A good approximation is usually
(average file size) / (buffersize)
If the -v or -V option is specified, then the maximum number of local file threads used while writing the Archive file to HPSS is displayed when the transfer is complete.
"Slightly verbose" mode. If selected, file transfer progress will be displayed in interactive mode. This option should normally not be selected if verbose (-v) mode is enabled, as the outputs for the two different options are generated by separate threads, and may be intermixed on the output.
"Verbose" mode. For each file processed, displays a one-character operation flag, and lists the name of each file. The flag values displayed are:
"a" - file was added to the archive
"x" - file was extracted from the archive
"i" - index file entry was created (Build Index operation)
Displays the action to be taken, followed by the file name, and then waits for user confirmation. If the response is affirmative, the action is performed. If the response is not affirmative, the file is ignored.
-Y auto | [Archive CosID][:IndexCosID]
Specifies the HPSS Class of Service ID to use when creating a new Archive and/or Index file. If the keyword auto is specified, then the HPSS hints mechanism is used to select the archive COS, based upon the file size. If -Y cosID is specified, then cosID is the numeric COS ID to be used for the Archive File.
If -Y :IndexCosID is specified, then IndexCosID is the numeric COS ID to be used for the Index File. If both COS IDs are specified, the entire parameter must be specified as a single string with no embedded spaces, e.g. "-Y 40:30".