STAGE Command

HSI Version: 

All

Purpose: 

 Stage files from HPSS tape to disk cache

Aliases: 

 

Command Format: 

sta[ge] -A] [-c] [-i] [-m max] [-N] [-R] [-s] [-w] [path ...] [<<MARKER]

Options: 

-A: (default) enable tape mount optimization (autoscheduling)

-c : do not delay until all stages have completed (note 1)

-i : interactive notification when file(s) have been staged (note 1)

-m : max number of stages to issue in a single batch. Default=no limit

-N : disable optimization of stage requests by VV and position

-R : recursively traverse directories in the specified path(s)

-s : display background staging statistics (note 1)

-w : wait for each stage to complete (foreground stage). Default is to stage
in the background. Setting -w internally disables -A and enables -N.

MARKER : provides sh-style "here"-document syntax for specifying filenames.
Lines following the MARKER, which must be the last token on the line, contain one or
more pathnames (which may include wildcards).
The list is terminated by a line containing MARKER as the first token on the line.

Keywords: 

 

Usage Notes: 

  1. The -c, -i and -s options are available in HSI for HPSS 7.5.1 and beyond, in HSI versions 6.0.0.p10+ (HPSS 7.5.1) and 6.2.0.p0+ (HPSS 7.5.2)
  2. If -w is specified, it overrides -A, and disables optimization based on
    tape and position. Instead, HSI issues a foreground stage for each
    file as it is encountered in the list, and waits for it to complete before
    continuing with the next file in the list.
  3. The shell-style HERE-Document syntax can be used to specify an interactive list of paths, or can be used in an IN file:
    Interactive:

    stage file1 file2 << EOF
    FILENAMES: file3 file4
    FILENAMES: file5
    FILENAMES: EOF


    In File:

    hsi in stageInput

    Contents of file "stageInput"
    stage file1 file2 << EOF
    file3 file4
    file5
    EOF


Example: 

stage -w my_file

Related Command(s): 

MIGRATE, PURGE