Purpose
Used to return a block (group) of record keys for processing.
Arguments
Argument | Input/Output | Value |
CODE | Input | 8 |
| Output | unchanged |
BFS | Input | BFS List |
| Output | unchanged |
HANDLE | Input | file handle |
| Output | unchanged |
NAME | Input | select mode (1 or 2) |
| Output | if select mode is 1, returned unchanged; if select mode is 2, returned with null |
FMC | Input | if select mode is 1, passed the select pointer. If select mode is 2, the first call passes the sort field, and subsequent calls pass the select pointer. |
| Output | updated select pointer if a new key list is returned in RECORD, otherwise false |
RECORD | Input | if select mode is 1, pass null (first call) or the old key list (secondary call). If select mode is 2, pass the sort specification. |
| Output | key list delimited with @FM; unchanged from input if status is false |
STATUS | Input | false, or READNEXT direction if a secondary call |
| Output | true if a new list of keys is being returned in RECORD, false if no new keys are available |
Called by
BASIC+ READNEXT statement if no keys are currently available in the system list variable.