blob: 52c7a74dc79d43656cc9e3752ce5f99a2f750f71 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
.help regdb Mar12 votools
.ih
NAME
regdb -- Manage/Query a local VO Registry database
.ih
USAGE
regdb arg1 <arg2> <arg3>
.ih
PARAMETERS
.ls arg1, arg2, arg3
Command argument strings. The \fIarg1\fR parameter is in general the name
of an operation to be performed (see below), depending on its value the
additional \fIarg\fR parameters may or may not be required.
.le
.ls type = ""
Service type constraint term.
.le
.ls bandpass = ""
Bandpass constraint term.
.le
.ls verbose = no
Verbose output?
.le
.ls status = 0
Status value, a non-zero value indicates an error or no results found..
.le
.ls OUTPUT PARAMETERS
If a matching record is found, one or more of the following task parameters
may be updated with the record values:
.nf
(alias = "") Resource alias
(ivorn = "") Ivorn string
(sname = "") Short Name
(svctype = "") Resource type
(bpass = "") Bandpass
(url = "") Service URL
(desc = "") Description (Title string)
.fi
.ih
DESCRIPTION
The \fIREGDB\fR task is used to query or manage the local registry database
file defined by the VO package \fIresdb\fR parameter. A local registry
database allows tasks to use preferred resources without generating a
query to the VO Registry each time information about the resource is
needed (e.g. the service URL), or to refer to a resource by a user-defined
alias. The \fIarg1\fR parameter may be either a command to manage the
database, or a search term for the database, in all cases the results are
written to the standard output.
Searches may be constrained by setting the \fItype\fR or \fIbandpass\fR
parameter to match only those records meeting the constraints. This can
be used for example to select the image service in a registry database
containing multiple services with the same name alias.
.ih
COMMANDS
If the first argument to the task is not in the following list of allowed
commands, it is assumed to be a search term. Record searches are done
as case-insensitive substring matches against all the saved fields of
the record.
The following commands are supported:
.nf
list List the registry database records
resolve Resolve (search) for the \fIarg2\fR string
search Search for (resolve) the \fIarg2\fR string
type Print the service type for records matching \fIarg2\fR
alias Print the DB alias for records matching \fIarg2\fR
bpass Print the bandpass value for records matching \fIarg2\fR
ivorn Print the VO identifier for records matching \fIarg2\fR
sname Print the VO ShortName for records matching \fIarg2\fR
url Print the ServiceURL for records matching \fIarg2\fR
desc Print the Description for records matching \fIarg2\fR
add Add a record for the service
del Delete the record that matches the \fIarg2\fR string
update Do a new Registry query and update the local DB
rename Rename the local record alias
.fi
.ih
EXAMPLES
1) List the local resource database. Repeat but list only the image
services. Repeat again looking for radio catalog services.
.nf
votools> regdb list
votools> regdb list type="image"
votools> regdb list type="catalog" bandpass="radio"
.fi
2) Print the URL for the DSS service in the registry database.
.nf
votools> regdb url alias="dss"
.fi
3) Find the one X-Ray service in the registry database:
.nf
votools> regdb resolve bandpass="x-ray"
.fi
.ih
REVISIONS
.ih
SEE ALSO
mkregdb, registry
.endhelp
|
