Show the History of a File or Job Within the Project

The command line program vsh reports on the history of a file or job with respect to the current project. It can be run to report on more than one file or job by listing multiple identifiers on the command line. You can use command line options to control the scope of the report, such as the number of levels of history to show, or if notes/annotations for the item should be shown.

You can pass in a name of a file or the VovId of a node as the item to report on.

When this is called to show the history of a file, you can see the jobs it was involved in either up or down the dependency graph by using the -backward or -forward options.

When this is called to show the history of a job by passing in the VovId of the job node, you can see the files it was involved in either up or down the dependency graph by using the -backward or -forward options.

The name of this program was created to be the acronym for "Vov Show History."

vsh

Show history of files in the dependency graph.


vsh: Usage Message

DESCRIPTION:
    Show history of files in the dependency graph.

USAGE:
    % vsh [options]  <id_or_file> ...

OPTIONS:
    -help                 -- Show this usage message.
    -level  <n>           -- Show up to <n> levels of history.
    -backward             -- (Default) look upstream 
    -forward              -- Look downstream (dependent nodes).
    -annotations          -- Show annotations.
    -files                -- Show files.
    -jobs                 -- Show jobs.
    -nodes                -- Show all nodes.
    -notes                -- Same as -annotations.

EXAMPLES:
     % vsh file_aa
     % vsh -level 10 -forward -files 00022345

Examples

% vsh bb.txt
${TOP}/bb.txt
VALID Mon Oct 20 14:37:10 2015

00000364 VALID vw cp aa.txt bb.txt

% vsh 000392
# -- Environment: DEFAULT
cd ${TOP}
   vw cp bb.txt cc.txt
# -- Started    : Tue Oct 13 07:21:39 2015
# -- Ended      : Tue Oct 13 07:21:40 2015
# -- Id         : 00000392
# -- Pid        : 205
# -- User       : johnX
# -- Host       : lucca
# -- Duration(expected): 1(1)
# -- Resources  : 
# -- Priority   : UNDEF
# -- Exit status: 0   Allowed: 0

00000392 VALID vw cp bb.txt cc9.txt
00000364 VALID vw cp aa.txt bb.txt