This function prepares for a Z39.50 Scan Request.
Argument id specifies
connection. Starting term point for the scan is given by startterm. The form in which is
the starting term is specified is given by type. Currently type rpn is supported. The optional flags specifies additional
information to control the behaviour of the scan request.
Three indexes are currently read from the flags: number (number of terms requested), position (preferred position of term) and stepSize (preferred step size). To
actually tranfer the Scan Request to the target and receive
the Scan Response, yaz_wait() must be called. Upon completion
of
yaz_wait() call yaz_error() and
yaz_scan_result() to handle the response.
The syntax of
startterm is similar to the RPN query as described
in
yaz_search(). The startterm consists of zero or more
@attr-operator specifications, then
followed by exactly one token.