Progress
ADM 2 Reference
clientSendRows (data.p)
Client-side routine called by sendRows when operating in n-tier mode (client, AppServer). Calls its counterpart routine (serverSendRows) on the AppServer to assemble and retrieve a batch of records.
Parameters:INPUT piStartRow AS INTEGER
The RowNum value of the record to start the batch to return. Typically piStartRow is ? as a flag to use pcRowIdent instead of piStartRow.
INPUT pcRowIdent AS CHARACTER
The RowIdent of the first record of the batch to return. Can also be
"
FIRST"
or"
LAST"
to force the retrieval of the first (or last) batch of RowObject records.INPUT plNext AS LOGICAL
TRUE if serverSendRows is to start on the NEXT record offset from piStartRow/piRowIdent. Ignored if pcRowIdent is
"
FIRST"
or"
LAST"
.INPUT piRowsToReturn AS INTEGER
The desired number of rows to return.
OUTPUT piRowsReturned AS INTEGER
The actual number of rows returned. This number will always be <= piRowsToReturn.
Returns: Nothing (procedure)Notes:
- All of the parameters are simply received from the caller and passed through to serverSendRows on the AppServer. If piStartRow is not 0 or ? then pcRowIdent is ignored. plNext is ignored if pcRowIdent is
"
FIRST"
or"
LAST"
.- The most common use of piRowsReturned is to indicate that the entire result list has been returned when it is less than piRowToReturn.
- Runs in the ASHandle if in an SBO.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |