Purpose

Used to set system parameters indicating that a select list is active. This information is used by subsequent READNEXT logic.

Arguments

Argument

Input/Output

Value

CODE

Input

7

 

Output

unchanged

BFS

Input

BFS List

 

Output

unchanged

HANDLE

Input

file handle

 

Output

unchanged

NAME

Input

extended selects pass first sort field, otherwise null

 

Output

unchanged

FMC

Input

null

 

Output

latent index sorts return first sort field, otherwise FMC contains the select pointer

RECORD

Input

0

 

Output

select mode

STATUS

Input

null

 

Output

returned true by non-index-based selects if the select initialization was successful.  Returns null for latent index selects.

Latent index selects, and argument values associated with these, are a function of SI.MFS, and not of the underlying BFS. For instance, the select mode value of 2 returned in the RECORD argument returns from SI.MFS.  To disable a SELECT (cause subsequent READNEXT operations to fall through ELSE branch), RECORD should be set to false.

Called by

BASIC+ SELECT statement

  • No labels