HSI Keywords

The following keywords are available in almost every HSI command. They are set by one of the following mechanisms:


1. Setting a value for the session

 "set keyword=value" command.

Note: The "SET" command string  can optionally be omitted, as HSI assumes that any command of the form keyword = value is a "SET" command.


2. Setting a value for the current command

command keyword=value [options] ...


The following keywords, and their minimum abbreviation, are shown in the table below.


ba[ckup] = on | off  

    automatically renames existing file on get/put. Default is on.


col[umns] = numeric value  
    Specifies number of columns per line.
    This value is used by the ls command when determining the number 
    of entries per line to list.  It is changed whenever the screen 
    size changes.


copies = n
    number of copies to store. The default is set by the HPSS
    administrator in the server configuration file.


cos[id] = auto | cosid   
    class of services to use. Default is "auto", which automatically
    selects the class of service, based upon file size, etc. as 
    determined by the HPSS administrator. 
    Use the lscos command to see the classes of service defined for
    the site; be aware that these are highly site-dependent.


coslist = name     
    Class of Service list to use.  Default is none.
    Named Classes of Services are groups of COSs that are defined by 
    the HPSS administrator.
    Use "lscos -n" to display a list of named COSs for the current 
    active connection.


dcreate[mode] = octal_value  
    Octal mode to use when creating directories.
    This value is defined in the global or private hsirc file's     
    dcreate_mode setting, or to 0777 by default. The current umask 
    value is used in conjunction with the mode setting in order to 
    yield the effective permissions that are set.


dirn = pathname    
    is omitted(meaning dir0) or 0 to 9)
    (The default pathname is your HPSS home directory)
    dir0 or dir assigns the current working directory. 
    dirn sets up a shorthand name for the directory as n', which can

    then be used in place of the directory, for example:

        dir1 = /home/users/jane/projects

        ls 1'  

    which is equivalent to

        ls /home/users/jane/projects


family[id] = numeric_value   
    Set default file family ID to be used when creating new files.  
    The default is either 0, or the value defined in the global or 
    private .hsirc file "family_id" setting.  


fcreate[mode] = octal_value 
    Octal mode to use when creating files.

    This value is defined in the global or private hsirc file's    

    fcreate_mode setting, or to 0777 by default. The current umask 

    value is used in conjunction with the mode setting in order to 

    yield the effective permissions that are set.

 

iob[fusize] = numeric_value   
    I/O buffersize to use when transferring files.
    The default is set by the HPSS administrator when HSI is built, 
    normally 8MB.


    The numeric_value can optionally be followed by any of the 
    following multipliers, with no intervening whitespace:  
    "k", "kb", "m", "mb", "g","gb", "t", "tb", "p", "pb"
    for kilobytes/megabytes/gigabytes/terabytes/petabytes.  
    The maximum buffersize is normally 32MB, but is defined at build 
    time by the HPSS administrator.


lines = numeric_value
    Sets the number of lines per page for the terminal. This value was
    used for a curses-based help package for a previous version of 
    HSI, but is currently unused.
 
promptl[en] = numeric_value   
    Sets the prompt length in characters


promptd[irlen] = numeric_value
    Sets the maximum number of characters to use when
    expanding the \fI%w\fP metacharacter in the command prompt. This 
    is the number of directory components to include from the 
    righthand side of the pathname if the prompt must be truncated to 
    promptlen characters.


PS1 = "string"
    Specifies the prompt string to use for initial command prompting.
    See the "Prompt String" section for details on the options for 
    string

    The default setting for this value is "? " or the value of the 
    PS1 setting in the  global or private hsirc file.


PS2 = "string"
    Specifies the prompt string to use for continuation lines.
    See the "Prompt String" section for details on the options for 
    string.


    The default setting for this value is "> " or the value of the PS2    setting in the global or private hsirc file.


pwid[th] = numeric_value
    Sets the parallel stripe width to use when transferring files. HSI    automatically determines the optimum stripe width to use, so this 
    option is currently unused, and may be removed in a future release