
<?xml version="1.0"?>
<?cocoon-process type="xslt"?>
<?xml-stylesheet href="dienst.xsl" type="text/xsl"?>
<!DOCTYPE SERVICE SYSTEM "dienst.dtd">
<SERVNAME>Collection Service</SERVNAME> <SERVDESC>
<P>The collection service provides information about the individual components that make up a collection.  For more information, please consult <A HREF="http://www.cs.cornell.edu/cdlrg/dienst/protocols/DienstProtocol.htm#4.4%20Collection%20Service">http://www.cs.cornell.edu/cdlrg/dienst/protocols/DienstProtocol.htm#4.4%20Collection%20Service</A>.</P>
</SERVDESC> <VERB> <VERBFUNC>Describe Verb</VERBFUNC> <VERBNAME>Describe-Verb</VERBNAME> 
<VERBVER>2.0</VERBVER> <NSF-DFG>req</NSF-DFG> <FIXEDARGS>value 
<!-- verb -->
</FIXEDARGS> <KEYWDARGS>none</KEYWDARGS> <MIMETYPE>text/xml</MIMETYPE> <STATUSCODES>200, 
400</STATUSCODES> <VERBDESC>
<P>Returns a structured response that contains a list, where each element of the 
list provides information on a version of the specified verb that is supported 
by this service. The following information may be provided at the verb or 
version level.</P>
<UL>
<LI><TT>description</TT>, description of the verb 
  or a specific version</LI>
<LI><TT>note</TT>, information pertaining to the 
  verb or a specific version </LI></UL>
<P>Each element of the list contains the following information:</P>
<UL>
<LI><TT>version number</TT> of the verb. </LI>
<LI><TT>arguments</TT>, a list of the names of the 
  <TT>fixed</TT> and <TT>keyword</TT><B> </B>arguments, if any, accepted by the verb <I>in that version</I>.</LI>
<LI><TT>example</TT> template of request to this 
  repository, with fixed argument indicated in brackets </LI>
<LI><TT>returns</TT><B>, </B>optional, contains 
  information about response format. </LI></UL>
<P>Note that a service may implement more than one version of a verb.</P></VERBDESC>
<EX-REQUEST>Protocol=Dienst;Service=Collection;ver=2.0;verb=Describe-Verb;value=Regions <!-- was:  /Dienst/Collection/2.0/Describe-Verb/Regions --></EX-REQUEST>
<EX-RESPONSE>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
  &lt;Describe-Verb version="2.0"&gt;
    &lt;Verb name="Regions"&gt;
      &lt;description&gt;List the regions for this collection.
      &lt;/description&gt;
      &lt;version id="1.0"&gt;
        &lt;example&gt;http://cs-tr.cs.cornell.edu:80/Dienst/Collection/1.0/Regions&lt;/example&gt;
      &lt;/version&gt;
    &lt;/Verb&gt;
  &lt;/Describe-Verb&gt;</EX-RESPONSE>
</VERB>
<VERB>
<VERBFUNC>List Verbs</VERBFUNC>
<VERBNAME>List-Verbs</VERBNAME>
<VERBVER>2.0</VERBVER>
<NSF-DFG>req</NSF-DFG>
<FIXEDARGS>none</FIXEDARGS>
<KEYWDARGS>none</KEYWDARGS>
<MIMETYPE>text/xml</MIMETYPE>
<STATUSCODES>200, 400</STATUSCODES>
<VERBDESC><P>Returns a structured response containing the name of the verbs defined by 
this service.</P></VERBDESC>
<EX-REQUEST>Protocol=Dienst;Service=Collection;ver=2.0;verb=List-Verbs <!-- was:  /Dienst/Collection/2.0/List-Verbs --></EX-REQUEST>
<EX-RESPONSE>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
  &lt;List-Verbs version="2.0"&gt;
    &lt;verb&gt;Regions&lt;/verb&gt;
    &lt;verb&gt;Publishers&lt;/verb&gt;
    &lt;verb&gt;QueryMediators&lt;/verb&gt;
    &lt;verb&gt;Indices&lt;/verb&gt;
    &lt;verb&gt;Repositories&lt;/verb&gt;
  &lt;/List-Verbs&gt;</EX-RESPONSE>
</VERB>
<VERB>
<VERBFUNC>Regions</VERBFUNC>
<VERBNAME>Regions</VERBNAME>
<VERBVER>1.0</VERBVER>
<NSF-DFG>opt</NSF-DFG>
<FIXEDARGS>none</FIXEDARGS>
<KEYWDARGS>none</KEYWDARGS>
<MIMETYPE>text/xml</MIMETYPE>
<STATUSCODES>200, 400</STATUSCODES>
<VERBDESC><P>Returns a structured response containing a list of regions.</P></VERBDESC>
<EX-REQUEST>Protocol=Dienst;Service=Collection;ver=1.0;verb=Regions <!-- was:  /Dienst/Collection/1.0/Regions --></EX-REQUEST>
<EX-RESPONSE>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
  &lt;Regions version="1.0"&gt;
    &lt;Region host="region1host.cs.yourinst.edu" port="9090"
      symbol="NA-EAST" name="North America - Eastern Region" /&gt;
    &lt;Region host="region2host.cs.yourinst.edu" port="9898"
      symbol="NA-WEST" name="North America - Western Region" /&gt;
  &lt;/Regions&gt;
</EX-RESPONSE>
</VERB>
<VERB>
<VERBFUNC>Collection</VERBFUNC>
<VERBNAME>Collection</VERBNAME>
<VERBVER>3.0</VERBVER>
<NSF-DFG>opt</NSF-DFG>
<FIXEDARGS>none</FIXEDARGS>
<KEYWDARGS>none</KEYWDARGS>
<MIMETYPE>text/xml</MIMETYPE>
<STATUSCODES>200, 400</STATUSCODES>
<VERBDESC><P>Returns a structured response containing information about the collection 
server. This request provides information about the verbs supported by the 
collection service.</P></VERBDESC>
<EX-REQUEST>Protocol=Dienst;Service=Collection;ver=1.0;verb=Collection <!-- was:  /Dienst/Collection/1.0/Collection --></EX-REQUEST>
<EX-RESPONSE>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
  &lt;Collection version="1.0"&gt;
    &lt;CollectionServer host="chost.cs.yourinst.edu" 
      port="9891" priority="1"&gt;
      &lt;Verbs&gt;
        &lt;Publishers&gt;
          &lt;version&gt;1.0&lt;/version&gt;
          &lt;version&gt;2.0&lt;/version&gt;
          &lt;version&gt;3.0&lt;/version&gt;
        &lt;/Publishers&gt;
        &lt;Repositories&gt;
          &lt;version&gt;2.0&lt;/version&gt;
          &lt;version&gt;3.0&lt;/version&gt;
          &lt;version&gt;3.0&lt;/version&gt;
        &lt;/Repositories&gt;
      &lt;/Verbs&gt;
    &lt;/CollectionServer&gt;
  &lt;/Collection&gt;
</EX-RESPONSE>
</VERB>
<VERB>
<VERBFUNC>Publishers</VERBFUNC>
<VERBNAME>Publishers</VERBNAME>
<VERBVER>3.0</VERBVER>
<NSF-DFG>req</NSF-DFG>
<FIXEDARGS>none</FIXEDARGS>
<KEYWDARGS>none</KEYWDARGS>
<MIMETYPE>text/xml</MIMETYPE>
<STATUSCODES>200, 400</STATUSCODES>
<VERBDESC><P>Returns a structured response containing the list of publishers that are 
represented in the collection. All documents in the collection are associated 
with a publisher.</P></VERBDESC>
<EX-REQUEST>Protocol=Dienst;Service=Collection;ver=3.0;verb=Publishers <!-- was:  /Dienst/Collection/3.0/Publishers --></EX-REQUEST>
<EX-RESPONSE>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
  &lt;Publishers version="3.0"&gt;
    &lt;publisher pretty="Cornell University Computer Science
      Department" authority="ncstrl.cornell" publisher="CORNELLCS"&gt;
    &lt;publisher pretty="CNR - Instituto di Cibernetica (Napoli)"
      authority="ercim.cnr.ic" publisher="ercim.cnr.ic"&gt;
  &lt;/Publshers&gt;</EX-RESPONSE>
</VERB>
<VERB>
<VERBFUNC>Query Mediators</VERBFUNC>
<VERBNAME>QueryMediators</VERBNAME>
<VERBVER>2.0</VERBVER>
<NSF-DFG>req</NSF-DFG>
<FIXEDARGS>none</FIXEDARGS>
<KEYWDARGS>none</KEYWDARGS>
<MIMETYPE>text/xml</MIMETYPE>
<STATUSCODES>200, 400</STATUSCODES>
<VERBDESC><P>Returns a structured response containing the name of the verbs defined by 
this service.</P></VERBDESC>
<EX-REQUEST>Protocol=Dienst;Service=Collection;ver=2.0;verb=QueryMediators <!-- was:  /Dienst/Collection/2.0/QueryMediators --></EX-REQUEST>
<EX-RESPONSE>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
  &lt;QueryMediators version="2.0"&gt;
    &lt;QueryMediator host="qmhost.cs.yourinst.edu" port="80"
      priority="1"&gt;
      &lt;Verbs&gt;
        &lt;Describe-Verb&gt;&lt;version&gt;2.0&lt;/version&gt;&lt;/Describe-Verb&gt;
        &lt;List-Verbs&gt;&lt;version&gt;2.0&lt;/version&gt;&lt;List-Verbs&gt;
        &lt;SearchBoolean&gt;
          &lt;version&gt;2.0&lt;/version&gt;&lt;version&gt;3.0&lt;/version&gt;
        &lt;SearchBoolean&gt;
      &lt;/Verbs&gt;
    &lt;/QueryMediator&gt;
  &lt;/QueryMediators&gt;</EX-RESPONSE>
</VERB>
<VERB>
<VERBFUNC>Indexers</VERBFUNC>
<VERBNAME>Indices</VERBNAME>
<VERBVER>4.0</VERBVER>
<NSF-DFG>req</NSF-DFG>
<FIXEDARGS>none</FIXEDARGS>
<KEYWDARGS>none</KEYWDARGS>
<MIMETYPE>text/xml</MIMETYPE>
<STATUSCODES>200, 400</STATUSCODES>
<VERBDESC><P>Returns a structured response containing the list of indexers that provide 
search services on a portion of the collection.</P></VERBDESC>
<EX-REQUEST>Protocol=Dienst;Service=Collection;ver=4.0;verb=Indices <!-- was:  /Dienst/Collection/4.0/Indices --></EX-REQUEST>
<EX-RESPONSE>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
  &lt;Indices version="4.0"&gt;
    &lt;Indexer host="ihost.cs.inst.edu" port="80" priority="1"&gt;
      &lt;Authorities&gt;
        &lt;authority name="ercim.cnr.ic" /&gt;
        &lt;authority name="ncstrl.cornell" /&gt;
      &lt;/Authorities&gt;
      &lt;Verbs&gt;
        &lt;Describe-Verb&gt;&lt;version&gt;1.0&lt;/version&gt;&lt;/Describe-Verb&gt;
        &lt;List-Verbs&gt;&lt;version&gt;1.0&lt;/version&gt;&lt;List-Verbs&gt;
        &lt;SearchBoolean&gt;
          &lt;version&gt;2.0&lt;/version&gt;&lt;version&gt;3.0&lt;/version&gt;
        &lt;SearchBoolean&gt;
      &lt;/Verbs&gt;
    &lt;/Indexer&gt;
  &lt;/Indices&gt;</EX-RESPONSE>
</VERB>
<VERB>
<VERBFUNC>Repositories</VERBFUNC>
<VERBNAME>Repositories</VERBNAME>
<VERBVER>4.0</VERBVER>
<NSF-DFG>req</NSF-DFG>
<NSF-DFG-NOTE>List Cornell, Gottingen, and Michigan here</NSF-DFG-NOTE>
<FIXEDARGS>none</FIXEDARGS>
<KEYWDARGS>none</KEYWDARGS>
<MIMETYPE>text/xml</MIMETYPE>
<STATUSCODES>200, 400</STATUSCODES>
<VERBDESC><P>Returns a structured response containing the list of repositories that store 
documents contained in the collection.</P></VERBDESC>
<EX-REQUEST>Protocol=Dienst;Service=Collection;ver=4.0;verb=Repositories <!-- was:  /Dienst/Collection/4.0/Repositories --></EX-REQUEST>
<EX-RESPONSE>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
  &lt;Repositories version="4.0"&gt;
    &lt;Repository host="rhost.cs.inst.edu" port="80" priority="1"&gt;
      &lt;Authorities&gt;
        &lt;authority name="ercim.cnr.ic" /&gt;
        &lt;authority name="ncstrl.cornell" /&gt;
      &lt;/Authorities&gt;
      &lt;Verbs&gt;
        &lt;Describe-Verb&gt;&lt;version&gt;1.0&lt;/version&gt;
          &lt;version&gt;2.0&lt;/version&gt;&lt;/Describe-Verb&gt;
        &lt;List-Verbs&gt;&lt;version&gt;1.0&lt;/version&gt;
          &lt;version&gt;2.0&lt;/version&gt;&lt;List-Verbs&gt;
        &lt;Structure&gt;&lt;version&gt;2.0&lt;/version&gt;&lt;version&gt;4.0&lt;/version&gt;
        &lt;/Structure&gt;
        &lt;Disseminate&gt;&lt;version&gt;3.0&lt;/version&gt;
        &lt;/Disseminate&gt;
        &lt;Formats&gt;&lt;version&gt;4.0&lt;/version&gt;
        &lt;/Formats&gt;
        &lt;List-Contents&gt;&lt;version&gt;2.0&lt;/version&gt;&lt;version&gt;4.0&lt;/version&gt;
        &lt;/List-Contents&gt;
      &lt;/Verbs&gt;
    &lt;Repository&gt;
  &lt;/Repositories&gt;
</EX-RESPONSE>
</VERB>
</BODY>

