1X2SYS_PUT(1)                 Generic Mapping Tools                X2SYS_PUT(1)
2
3
4

NAME

6       x2sys_put - Update x2sys track data bases
7

SYNOPSIS

9       x2sys_put [ info.tbf ] -TTAG [ -D ] [ -F ] [ -V ]
10

DESCRIPTION

12       x2sys_put  accepts  a track bin-index file created by x2sys_binlist and
13       adds this information about the data tracks to the relevant data  base.
14       You may chose to overwrite existing data with new information for older
15       tracks (-F) and even completely remove information for  certain  tracks
16       (-D).   The  x2sys TAG must match the tag encoded in the info.tbf file.
17       To inquire about tracks in the data base, use x2sys_get.
18
19       -T     Specify the x2sys TAG which tracks the attributes of  this  data
20              type.
21

OPTIONS

23       No space between the option flag and the associated arguments.
24
25       info.tbf
26              Name  of  a  single track bin file.  If not given, stdin will be
27              read.
28
29       -D     Delete all tracks found in the track bin file [Default will  try
30              to add them as new track entries].
31
32       -F     Replace  any existing database information for these tracks with
33              the new information in the track bin file  [Default  refuses  to
34              process tracks already in the database].
35
36       -V     Selects verbose mode, which will send progress reports to stderr
37              [Default runs "silently"].
38

EXAMPLES

40       To add the information stored in the track bin-index file latest.tbf to
41       the  track  data  bases  associated with the tag MGD77, and replace any
42       exiting information for these tracks, try
43
44       x2sys_put latest.tbf -F -V -TMGD77
45

X2SYS DATABASES

47       The x2sys_put utility adds new information to  the  x2sys  data  bases.
48       These  consists  of two files: The first file contains a listing of all
49       the tracks that have been added to the system; it is named TAG_tracks.d
50       and is in ASCII format.  The second file is named TAG_index.b and is in
51       native binary format.  It contains information on  which  tracks  cross
52       each  of  the bins, and what data sets were observed while crossing the
53       bin.  The bins  are  defined  by  the  -R  and  -I  options  passed  to
54       x2sys_init  when the TAG was first initiated.  Both data base files are
55       stored in the $X2SYS_HOME/TAG directory.  Do not attempt to edit  these
56       files by hand.
57

SEE ALSO

59       x2sys_binlist(1), x2sys_get(1)
60
61
62
63GMT 4.5.6                         10 Mar 2011                     X2SYS_PUT(1)
Impressum