Skip to content

Commit

Permalink
clarify that overflow is only defined for VOTable
Browse files Browse the repository at this point in the history
  • Loading branch information
pdowler committed Nov 27, 2023
1 parent 5860fd4 commit 83d040d
Showing 1 changed file with 9 additions and 6 deletions.
15 changes: 9 additions & 6 deletions DALI.tex
Original file line number Diff line number Diff line change
Expand Up @@ -1391,12 +1391,11 @@ \subsection{Use of VOTable}

\subsubsection{Overflow}
\label{sec:response-overflow}
If an overflow occurs (for example, result exceeds MAXREC), the service must include an
\xmlel{INFO}
element in the \xmlel{RESOURCE} with \verb|name="QUERY\_STATUS"| and the
\verb|value="OVERFLOW"|. If
the initial \xmlel{INFO} element (above) specified the overflow, no further elements are
needed, e.g.:
If an overflow occurs (for example, result exceeds MAXREC) and the output format
is VOTable, the service must include an \xmlel{INFO} element in the \xmlel{RESOURCE}
with \verb|name="QUERY\_STATUS"| and the \verb|value="OVERFLOW"|. If the initial
\xmlel{INFO} element (above) specified the overflow, no further elements are needed,
e.g.:

\begin{lstlisting}[language=XML]
<RESOURCE type="results">
Expand All @@ -1418,6 +1417,10 @@ \subsubsection{Overflow}
</RESOURCE>
\end{lstlisting}

There is no defined mechanism to indicate overflow (truncation) of output for formats
other than VOTable. Specifically, simple text formats like \verb|text/csv| and
\verb|text/tab-separated-values| do not support indicating overflow.

In general, services may truncate the output results when reaching a limit. A default or
user-specified value of the MAXREC parameter is a common mechanism that causes truncation
of results, but service providers may also impose limits in services that do not use
Expand Down

0 comments on commit 83d040d

Please sign in to comment.