<!-- Creator : groff version 1.19.2 --> <!-- CreationDate: Wed Jul 14 08:43:46 2010 --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta name="generator" content="groff -Thtml, see www.gnu.org"> <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> <meta name="Content-Style" content="text/css"> <style type="text/css"> p { margin-top: 0; margin-bottom: 0; } pre { margin-top: 0; margin-bottom: 0; } table { margin-top: 0; margin-bottom: 0; } </style> <title>X2SYS_PUT</title> </head> <body bgcolor="#ffffff"> <h1 align=center>X2SYS_PUT</h1> <a href="#NAME">NAME</a><br> <a href="#SYNOPSIS">SYNOPSIS</a><br> <a href="#DESCRIPTION">DESCRIPTION</a><br> <a href="#OPTIONS">OPTIONS</a><br> <a href="#EXAMPLES">EXAMPLES</a><br> <a href="#X2SYS DATABASES">X2SYS DATABASES</a><br> <a href="#SEE ALSO">SEE ALSO</a><br> <hr> <a name="NAME"></a> <h2>NAME</h2> <p style="margin-left:11%; margin-top: 1em">x2sys_put − Update x2sys track data bases</p> <a name="SYNOPSIS"></a> <h2>SYNOPSIS</h2> <p style="margin-left:11%; margin-top: 1em"><b>x2sys_put</b> [ <i>info.tbf</i> ] <b>−T</b><i>TAG</i> [ <b>−D</b> ] [ <b>−F</b> ] [ <b>−V</b> ]</p> <a name="DESCRIPTION"></a> <h2>DESCRIPTION</h2> <p style="margin-left:11%; margin-top: 1em"><b>x2sys_put</b> accepts a track bin-index file created by <b><A HREF="x2sys_binlist.html">x2sys_binlist</A></b> and adds this information about the data tracks to the relevant data base. You may chose to overwrite existing data with new information for older tracks (<b>−F</b>) and even completely remove information for certain tracks (<b>−D</b>). The x2sys <i>TAG</i> must match the tag encoded in the <i>info.tbf</i> file. To inquire about tracks in the data base, use <b><A HREF="x2sys_get.html">x2sys_get</A></b>.</p> <table width="100%" border=0 rules="none" frame="void" cellspacing="0" cellpadding="0"> <tr valign="top" align="left"> <td width="11%"></td> <td width="3%"> <p style="margin-top: 1em" valign="top"><b>−T</b></p> </td> <td width="8%"></td> <td width="78%"> <p style="margin-top: 1em" valign="top">Specify the x2sys <i>TAG</i> which tracks the attributes of this data type.</p> </td> </table> <a name="OPTIONS"></a> <h2>OPTIONS</h2> <p style="margin-left:11%; margin-top: 1em">No space between the option flag and the associated arguments. <i><br> info.tbf</i></p> <p style="margin-left:22%;">Name of a single track bin file. If not given, stdin will be read.</p> <table width="100%" border=0 rules="none" frame="void" cellspacing="0" cellpadding="0"> <tr valign="top" align="left"> <td width="11%"></td> <td width="3%"> <p style="margin-top: 1em" valign="top"><b>−D</b></p> </td> <td width="8%"></td> <td width="78%"> <p style="margin-top: 1em" valign="top">Delete all tracks found in the track bin file [Default will try to add them as new track entries].</p></td> <tr valign="top" align="left"> <td width="11%"></td> <td width="3%"> <p style="margin-top: 1em" valign="top"><b>−F</b></p> </td> <td width="8%"></td> <td width="78%"> <p style="margin-top: 1em" valign="top">Replace any existing database information for these tracks with the new information in the track bin file [Default refuses to process tracks already in the database].</p></td> <tr valign="top" align="left"> <td width="11%"></td> <td width="3%"> <p style="margin-top: 1em" valign="top"><b>−V</b></p> </td> <td width="8%"></td> <td width="78%"> <p style="margin-top: 1em" valign="top">Selects verbose mode, which will send progress reports to stderr [Default runs "silently"].</p></td> </table> <a name="EXAMPLES"></a> <h2>EXAMPLES</h2> <p style="margin-left:11%; margin-top: 1em">To add the information stored in the track bin-index file latest.tbf to the track data bases associated with the tag MGD77, and replace any exiting information for these tracks, try</p> <p style="margin-left:11%; margin-top: 1em"><b>x2sys_put</b> latest.tbf <b>−F −V −T</b>MGD77</p> <a name="X2SYS DATABASES"></a> <h2>X2SYS DATABASES</h2> <p style="margin-left:11%; margin-top: 1em">The <b>x2sys_put</b> utility adds new information to the x2sys data bases. These consists of two files: The first file contains a listing of all the tracks that have been added to the system; it is named <i>TAG</i>_tracks.d and is in ASCII format. The second file is named <i>TAG</i>_index.b and is in native binary format. It contains information on which tracks cross each of the bins, and what data sets were observed while crossing the bin. The bins are defined by the <b>−R</b> and <b>−I</b> options passed to <b><A HREF="x2sys_init.html">x2sys_init</A></b> when the <i>TAG</i> was first initiated. Both data base files are stored in the <b>$X2SYS_HOME</b>/<i>TAG</i> directory. Do not attempt to edit these files by hand.</p> <a name="SEE ALSO"></a> <h2>SEE ALSO</h2> <p style="margin-left:11%; margin-top: 1em"><i><A HREF="x2sys_binlist.html">x2sys_binlist</A></i>(1), <i><A HREF="x2sys_get.html">x2sys_get</A></i>(1)</p> <hr> </body> </html>