VA FileMan Programmer Manual: $$VALUE1^DILF( )

Contents:

Main

Database Server (DBS) API

$$VALUE1^DILF(): FDA Value Retriever (Single)

Reference Type	Category	ICR #
Supported	Database Server (DBS)	2054

Description

The $$VALUE1^DILF extrinsic function returns the value associated with a particular file and field in a standard FDA. Only a single value is returned. If there is more than one node in the FDA array for the same field, the first value encountered by this function is returned. Use the VALUES^DILF(): FDA Values Retriever API if you want more than one value returned.

Format

$$VALUE1^DILF(file,field,fda_root)

Input Parameters

file	(Required) File or subfile number.
field	(Required) Field number for which data is being requested.
fda_root	(Required) The root of the FDA from which data is being requested.

Output

This function returns the value for the specified file and field that is stored in the FDA identified by fda_root:

If the field is a WORD-PROCESSING field, only the root at which word-processing data is stored is returned. No IENS information is returned.
If more than one value is associated with a particular field (e.g., in a subfile), only a single value is returned.
If there is no node in the FDA for a particular field, a caret (^) is returned.
If the node has a NULL value, NULL is returned.

Example

Figure 191: $$VALUE1^DILF API—Example: Input and Output

    >ZW MYFDA <Enter>
    MYFDA("DATA",16200,"33,",4)=FREE TEXT DATA
    MYFDA("DATA",16200.04,"1,33,",1)=16
    MYFDA("DATA",16200.04,"2,33,",1)=45

    >W $$VALUE1^DILF(16200,4,"MYFDA(""DATA"")") <Enter>
    FREE TEXT DATA

Error Codes Returned

None.

Reviewed/Updated: May 2026