Stub File Contents

Every file written to tape is described by a small stub file that resides on a network share accessible via the path /mss on supported machines.  The ownership and permission information of each file inside the tape library,  can be seen by issuing "ls -l " command on a corresponding stub file or a directory. Each stub file is a text file listing the tape file properties in newline-separated <tag>=<value> statements.

jcancel

Name
jcancel  - cancel jobs

Syntax  
jcancel -r request-index ...
jcancel -j job-index ...
jcancel -u user-name ...
jcancel -t tape-volser ...

Description
Cancel queued jasmine jobs (i.e. ones that have not transitioned into state Done, Cancelled, or Failed).  Only certain privileged users may cancel jobs that they don't own.

Options
-r
     Cancel jobs matching any of the supplied request identifiers

-j

jqueue

Name
jqueue  - display information about outstanding jasmine read and write jobs.

Syntax  
jqueue search-key search-value [all | field1 field2 ...]

Description
Display the status of queued jasmine jobs (i.e. ones that have not transitioned into state Done, Cancelled, or Failed).  You select the set of jobs to return by specifying a search key and a corresponding search value.  You can also specify a set of fields to display, or simply accept the default set.

Search Key & Display Fields

jget

Name
jget  - read files from tape

Syntax  
jget [options] stub dest
jget [options] stub1 stub2 ... dir
jget -m [options] stub1 dest1 stub2 dest2 ...
jget -r [options] stub-prefix local-prefix stub1 stub2 ...

Description
Fetch one or more files from the Jefferson Lab mass storage system tape library.  Use -m to designate a specific destination for each retrieved file.  Use -r to direct retrieved files to local files replacing stub-prefix with local-prefix.

jput

Name
jput  - write files to tape

Syntax  
jput [options] file stub-dir/
jput [options] file stub-file
jput [options] file1 file2 ... stub-dir
jput [options] -m file1 stub-dir1 file2 stub-dir2 ...
jput [options] -r local-prefix stub-prefix file1 file2 ...

Description
Write one or more files to the Jefferson Lab mass storage system tape library.  Use -m to designate a specific stub directory for each source file.  Use the -r to direct files to stubs replacing local-prefix with stub-prefix.

Command Reference

Reading from Tape

Data is read from tape most commonly via a command named jget.  The requirements for using this tool
are:

  1. a valid scientific computing
    certificate as described in "Getting
    Started",
  2. access to /site/bin/jget on a
    supported machine.

Files may also be read from
tape via other special-purpose tools documented elsewhere. 
Regardless of the the way that read requests are generated, the
ultimate process that jasmine uses to service those requests is as
follows:

Writing to Tape

Data is written to tape most commonly via a command named jput.  The requirements for using this tool are:

Organization of Tape Data

Jasmine maintains a directory hierarchy that uniquely names each file on tape. This stub filesystem allows users to organize files as though they existed within a conventional directory.  It also serves another important function: it maps each directory to a logical grouping, known as a volume set.  Files are stored on tape along with other files belonging to the same volume set.  Doing this simplifies auditing, permits efficiency gains on retrieval, and provides opportunity for physically moving tapes based upon their contents.

Mass Storage System

Jasmine

Jasmine is a collection of user programs and server processes that interface with the Jefferson Lab tape library and mass storage system.
 

Supported Systems

Jasmine client applications are supported on interactive user nodes and properly configured Red Hat Enterprise Linux 5 and 6, 32- and 64-bit machines.
 

Pages