HPSS also supports the site commands listed below (e.g., " site setcos 300 " or " quote site setcos 300 ").
Note: On some platforms, it may be necessary to specify quote site instead of site .
chown (valid only for "root" account)
setcos is used to specify a class of service and has the following format:
cos_id is the Class of Service identifier (used when creating a new HPSS file during a put operation.)
Class of Service is used as a means for specifying the amount of parallelism or stripe width for a file. See your HPSS system administrator for the Class of Service identifiers defined for your site. If a Class of Service is not specified, a default is used.
In the example below, the following commands might be entered to put a large file to HPSS with a Class of Service identifier of 4. In this example, 4 might designate 4-way striping to 3490 tape.
chgid is used to change the group ID of a file and has the following format:
gid is the new group ID of the file
The user must belong to the specified group and be the owner of the file, or be the root user.
Example: The following may be entered to change the group ID of myfile to group ID 210.
chgrp is used to change the group name of a file and has the following format:
quote site chgrp <group> <file>
group is the new group name of the file, and file is the name of the file.
The user must belong to the specified group and be the owner of the file, or be the root user.
Example: The following may be entered to change the group of myfile to group mygroup.
chmod is used to change the mode of a file and has the following format:
quote site chmod <mode> <file>
mode is the new octal mode number of the file
Mode is constructed from the OR of the following modes:
0100 execute (search in a directory) by owner
0010 execute (search in a directory) by group
0001 execute (search in a directory) by others
Note: The following mode values are not supported:
2000 set group ID on execution
Only the owner of the file or root user can change its mode.
Example: The following may be entered to change the mode of myfile to read, write by owner and group.
chown is used to change the owner of a file and has the following format:
quote site chown <owner> <file>
owner is the new owner of the file
Only the root user can change the owner of a file.
Example: The following may be entered to change the owner of /home/smith/myfile to jones.
chuid is used to change the uid of a file and has the following format:
uid is the new uid of the owner of the file
Only the root user can change the uid of a file.
Example: The following may be entered to change the uid of /home/smith/myfile to 201.
stage is used to initiate a stage of a migrated file (e.g. from tape to disk). The user can initiate the stage and then return at a later time to initiate the file transfer usin the FTP get or PFTP pget commands:
Example: The following may be entered to stage file /home/smith/myfile.
wait is used to notify the HPSS PFTP Daemon :
option is one of the following values:
-1 or inf(inite) - wait forever for the file to be staged. Do not return from the get / pget command to complete until the file has been transferred or a transfer error has occurred.
0 - do not wait for the file to be staged. If the file has been migrated, return the appropriate message and initiate the stage. The user will return later to reissue the get / pget command.
n (where n is an integer) - wait the specified period (in seconds) for the file requested by a get / pget command to complete. Either transfer the file if the file is staged within the specified period or return a reply to notify the user to try again later.
Example: The following may be entered to wait for fies to be staged.
The following table describes the behaviour the customer should expect from FTP when issuing the stage/wait commands. Note: ONLY Classes of service utilizing the "Stage on Background" will exhibit predictable results.
symlink is used to create a symbolic link.
quote site symlink <path/file> <link>
path/file refers to the destination
link refers to the local filename.
Example: The following may be entered to create a link names sys_passwd in the local directory pointing to /etc/passwd.
The quote allo64 command is used to specify the size of a file for space allocation.
size is a string representing the size of the file. The size may be a decimal number less than 264 or may be in the form 1MB (1048576). No spaces are allowed between the decimal number and the magnitude representation string. Accepted magnitude representation strings are:
TB (terabyte = 1099511627776),
PB (petabyte = 1125899906842624).
The magnitude representation string is case independent. The decimal component may contain up to two decimal points of precision. NOTE: 1005.03 will truncate to 1005 if no magnitude representation string is specified. Similar truncations will occur for excess precision specifications.
This command provides a 64-bit extension to the standard quote allo size command. NOTE: the quote allo size command only accepts decimal values for size. Both these commands are helpful for providing hints for non-parallel "put" commands.
Example: The following may be entered to specify the file size of 8 gigabytes.