NDC comm CompuFax User Manual

Page 108

Advertising
background image

8 4

The effect of setting this parameter FALSE will be that any active lookups will be started from the beginning
each time the database is restarted. If it is set TRUE, the context of streams will be saved but the user code
must be capable of resuming interrupted streams. There is some runtime performance gain from setting it to
FALSE. If this is TRUE, the database will create and maintain the context in the file FDB$CONTEXT.
Save_context defaults to FALSE.

Return Value:
N one. Errors are signaled.

10.1.3.6 FDB_NOMATCH

This sends a "no more matches" response to the requestor for the specified database stream if there is an
unsatisfied lookup request outstanding for the stream. If there is no outstanding lookup request, no action is
taken.

This is done automatically if a request is received for a stream the user has closed by calling FDB_CLOSE.

Calling Sequence:
FDB_N OMATCH stream_id

Arguments
type: longword signed
access: read only
mechanism: by reference

This is the target database stream identifier.

Return Value:
FDB$_N ORMAL N ormal successful completion
FDB$_N OREQUEST If there is no lookup request outstanding, the warning status is returned

10.1.3.7 FDB_SAVE_CONTEXT

This function saves the user context associated with a database stream. It would normally be used after
processing a lookup request to save the context for the processing of the next request.

If context is being saved across runs (see FDB_INIT) then this function should be used to preserve the user
context.

Calling Sequence:
FDB_SAVE_CON TEXT stream_id, context, size

Arguments
name: stream_id
type: longword signed
access: read only
mechanism: by reference

The identifier of the stream for which context is to be saved.
name: context
type: userdefined access: read only
mechanism: by reference

Advertising