<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [

    <!ENTITY dhtitle "User Manuals">
    <!ENTITY dhcommand "blah_job_registry_lkup">
    <!ENTITY dhsection "1">
    
    <!ENTITY dhfirstname "Massimo">
    <!ENTITY dhsurname "Mezzadri">
    <!ENTITY dhemail "Massimo.Mezzadri@mi.infn.it">
    <!ENTITY dhcontrib "Developer of the BLAHP suite">
    
]>



<refentry>

    <refentryinfo>
        <title>&dhtitle;</title>
        <productname>&dhcommand;</productname>
        <authorgroup>
            <author>
                <firstname>&dhfirstname;</firstname>
                <surname>&dhsurname;</surname>
                <contrib>&dhcontrib;</contrib>
                <address>
                    <email>&dhemail;</email>
                </address>
            </author>
        </authorgroup>
    </refentryinfo>

    <refmeta>
        <refentrytitle>&dhcommand;</refentrytitle>
        <manvolnum>&dhsection;</manvolnum>
    </refmeta>

    <refnamediv>
        <refname>&dhcommand;</refname>
        <refpurpose>Query the registry.</refpurpose>
    </refnamediv>

    <refsynopsisdiv>
        <cmdsynopsis>
            <command>&dhcommand;</command>
            <arg choice="opt"><option>options</option></arg>
            <arg choice="plain"><replaceable><![CDATA[<id>]]></replaceable></arg>
        </cmdsynopsis>
    </refsynopsisdiv>

    <refsect1>
    
        <title>DESCRIPTION</title>
        <para>The command <command>&dhcommand;</command> retrieves information from the registry.</para>
        
    </refsect1>

    <refsect1>
        <title>OPTIONS</title>
        <variablelist>

            <varlistentry>
                <term><option>-h</option></term>
                <listitem>
                    <para>Display information about this command</para>
                </listitem>
            </varlistentry>

            <varlistentry>
                <term><option>-w</option></term>
                <listitem>
                    <para>retrieve the worker node</para>
                </listitem>
            </varlistentry>

            <varlistentry>
                <term><option>-p</option></term>
                <listitem>
                    <para>retrieve the user proxy</para>
                </listitem>
            </varlistentry>
            
            <varlistentry>
                <term><option>-n</option></term>
                <listitem>
                    <para>retrieve the host and the port of the parser</para>
                </listitem>
            </varlistentry>
            
            <varlistentry>
                <term><option>-b</option></term>
                <listitem>
                    <para>look up for batch IDs</para>
                </listitem>
            </varlistentry>
            
        </variablelist>
    </refsect1>

    <refsect1>
        <title>EXIT STATUS</title>
        <para><command>&dhcommand;</command> exits with a status value of 0 (zero) upon success and >0 (greater than zero) upon failure.</para>
    </refsect1>

    <refsect1>
        <title>SEE ALSO</title>
        <para>
            <citerefentry>
                <refentrytitle>blah_job_registry_add</refentrytitle>
                <manvolnum>1</manvolnum>
            </citerefentry>,
            <citerefentry>
                <refentrytitle>blah_job_registry_dump</refentrytitle>
                <manvolnum>1</manvolnum>
            </citerefentry>,
            <citerefentry>
                <refentrytitle>blah_job_registry_scan_by_subject</refentrytitle>
                <manvolnum>1</manvolnum>
            </citerefentry>
        </para>
    </refsect1>

</refentry>

