Database Server (DBS) API

RECALL^DILFD( ): Recall Record Number

Description

The RECALL^DILFD API saves a record number for later retrieval using Spacebar Recall. While Classic VA FileMan has automatically performed this procedure for applications in the past, the VA FileMan DBS lookup calls cannot do so. The decision to perform this procedure can only be made by code that knows its context, which knows whether the selection taking place results from a user's selection or from some silent activity. In addition, VA FileMan often is inactive when a user selection occurs (e.g., when a user picks a single entry from a ListBox managed by the application). For these reasons, the maintenance of the Spacebar Recall feature is increasingly the responsibility of the applications.

Format

RECALL^DILFD(file,iens,user)

Input Parameters

Example

Figure 203: RECALL^DILFD API—Example: Input and Output

    >D RECALL^DILFD(19,"1,",9) W $G(DIERR) D ^%G <Enter>

    Global ^DISV(9,"^DIC(19,")
            DISV(9,"^DIC(19,")
    ^DISV(9,"^DIC(19,") = 1

Error Codes Returned

Table 67 lists the possible error codes returned with the RECALL^DILFD API:

Table 67: RECALL^DILFD API—Error Codes Returned

Reviewed/Updated: May 2026