From 5798dd6b5134415e5ce1fd8b8d0979d6827b66ce Mon Sep 17 00:00:00 2001 From: =?utf8?q?Zden=C4=9Bk=20=C5=A0ustr?= Date: Wed, 29 Aug 2012 08:33:53 +0000 Subject: [PATCH] - Explanation of the "flags" query string - Summary of all query strings started --- org.glite.lb.doc/src/LBUG-Tools.tex | 38 +++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/org.glite.lb.doc/src/LBUG-Tools.tex b/org.glite.lb.doc/src/LBUG-Tools.tex index defd905..778c7cb 100644 --- a/org.glite.lb.doc/src/LBUG-Tools.tex +++ b/org.glite.lb.doc/src/LBUG-Tools.tex @@ -153,11 +153,49 @@ Supported job state values (attribute \texttt{status}) are listed in Appendix~\r All queries result in a list of JobIDs of jobs that match the specified criteria. +This feature is supported since \LBver{3.3} + +\subsubsection{Applying Flags} +\label{HTML:flags} + +Query conditions explained in Section~\ref{HTML:queries} but also simple requests may be combined with flags supplied through the \texttt{?flags} query string. For instance, when querying for a colection status, the following use of flags will initiate thorough recalculation of child job state histogram and make sure that classad data (namely JDL) are retrieved. + +\begin{verbatim} +https://skurut68-2.cesnet.cz:9100/D1qbFGwvXLnd927JOcja1Q?flags=classadd+childhist_thorough +\end{verbatim} + +The following flags are supported in job and job status queries: +\texttt{classadd}, +\texttt{children}, +\texttt{childstat}, +\texttt{no\_jobs}, +\texttt{no\_states}, +\texttt{childhist\_fast}, +\texttt{childhist\_thorough}, +\texttt{anonymized}, and +\texttt{history}. + +This feature is supported since \LBver{3.3} + \input{https_configuration} \subsubsection{Summary of Applicable Query Strings} \label{HTML:querystrings} +\begin{tabularx}{\textwidth}{>{\tt}lX} +\texttt{?agu} & agu \\ +\texttt{?all} & Applies only to notifications. Makes sure notification registrations by all users are displayed if privileges suffice. Explained in Sect.\,\ref{simple}. \\ +\texttt{?configuration} & Displays various configuration properties of the server. Explained in Sect.\,\ref{s:findbroker}. \\ +\texttt{?flags} & Flags \\ +\texttt{?foreign} & Applies only to notifications. Makes sure notification registrations by all users but yourselves are displayed if privileges suffice. Explained in Sect.\,\ref{simple}. \\ +\texttt{?query} & Query \\ +\texttt{?stats} & Stats \\ +\texttt{?text} & Text \\ +\texttt{?types} & types \\ +\texttt{?version} & Version \\ +\texttt{?wsdl} & WSDL \\ +\end{tabularx} + \subsection{Job state changes as an RSS feed} The \LB includes an RSS interface allowing users to keep trace of their jobs in a very simple way using an RSS reader. The parameters of the RSS feeds are predefined, so no configuration is required. -- 1.8.2.3