vtk_trace

Usage:         
vtk_trace <close|open|status|switchto> ...

Description:   
Procedure to control connection to the trace server. 

Examples: 
vtk_trace status 
connected 
vtk_trace close 
vtk_trace open $env(VOV_PROJECT_NAME) $env(VOV_HOST_NAME) 
vtk_trace switchto local 
vtk_trace switchto client 
vtk_trace status 
disconnected 
vtk_trace open $projectname $host [LOCAL | CLIENT ]

vtk_trace_checkall

Usage:         
vtk_trace_checkall primaryInputsOnlyFlag

Description:   
Check all places. If the flag is 1, only the primary inputs are checked.

Returns:       
Nothing

vtk_trace_dump_nodeset

Usage:         
vtk_trace_dump_nodeset setName/setId fileName [tcl|make|csh|ps]

Description:

vtk_trace_is_connected

Usage:         
vtk_trace_is_connected

Description:   

Returns:       
1 if the trace is connected to a server,  0  otherwise.

vtk_trace_list_places

Usage:         
vtk_trace_list_places regularExpression

Description:   

Returns:       
A list of places in the default format.

Note:
This is an obsolete procedure.  Use vtk_set_create instead to find places that match a given regular expression.

vtk_trace_list_sets

Usage:         
vtk_trace_list_sets [OPTIONS]

Description:   
List all sets in the trace. 
The following options are mutually exclusive 
* -ids   -- Show only the id's 
* -names -- Show only names (default) 
* -all   -- List pairs of (id,name) 
* -rx RX -- Limit list to sets that match the specified regular expression RX 
* -max N -- Limit number of items returned. Useful in cases where there is an overflow caused by too many sets 

Examples: 
vtk_trace_list_sets -ids 
00000002 00000003 00000004 01615042 01615043 01615049 
vtk_trace_list_sets -all 
{00000002 {System:nodes}} {00000003 {System:jobs}} ... 
vtk_trace_list_sets -all -rx System: 
{00000002 {System:nodes}} {00000003 {System:jobs}} ... 
vtk_trace_list_sets -max 1000 -rx abc 
...

vtk_trace_list_users

Usage:         
vtk_trace_list_users 

Description:   
List all users in the trace.

Returns:       
A list of id of users.

vtk_trace_rename

Usage:         
vtk_trace_rename setName oldString newString

Description:   
Replace all occurrences of oldString to newString for all nodes in the set with name setName. 


Example:
vtk_trace_rename System:jobs toolx tooly
Renaming means doing a string substitution
in the names of files and in the command lines
and cwd of tools:
Set Name     ""
Old String   "toolx"
New String   "tooly"
19777 nodes have been examined.
0 files have been modified.
2 tools have been modified.


Returns:       
A long and somewhat useless preformatted string.

vtk_trace_reopen

Usage:         
vtk_trace_reopen timeout

Description:   
This procedure is used to reconnect to a server after a crash.

vtk_trace_save

Usage:         
vtk_trace_save -dir savedir -nofork -time maxAllowedTime

Description:   
Send a request to the server to save the trace database to disk. The actual saving may take an unspecified amount of time depending on the size of the trace. If option -nofork is used, this procedure returns after the trace has been save, else the procedure returns immediately, meaning that upon return the trace has not yet been saved. 

Examples: 
vtk_trace_save
vtk_trace_save -nofork
vtk_trace_save -nofork  -time 5m
vtk_trace_save -time 5m -dir /tmp/foobar/savedir