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  - cancel jobs

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

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.

     Cancel jobs matching any of the supplied request identifiers



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

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

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  - read files from tape

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 ...


jput  - write files to tape

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 ...

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

  1. a valid scientific computing
    certificate as described in "Getting
  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

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 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.