VA FileMan V. 22.2 Programmer Manual Banner


 

Main Chapter Getting Started Manual Advanced User Manual

Database Server (DBS) API


$$FLDNUM^DILFD( ): Field Number Retriever

Reference Type Category ICR #
Supported Database Server (DBS) 2055
Description

The $$FLDNUM^DILFD extrinsic function returns a field number when passed a file number and a field name.

Format
$$FLDNUM^DILFD(file,fieldname)
Input Parameters
file

(Required) The file number of the field's file or subfile.

fieldname

(Required) The full name of the field for which you want the number.

Output

The field number of the requested field is returned by this extrinsic function. If the field name does not exist or if there is more than one field with that name, a Zero (0) is returned.

Example

Figure 201: $$FLDNUM^DILFD API—Example: Input and Output

    >W $$FLDNUM^DILFD(200,"DUZ(0)") <Enter>
    3
Error Codes Returned

Table 66 lists the possible error codes returned with the $$FLDNUM^DILFD API:

Table 66: $$FLDNUM^DILFD API—Error Codes Returned

Code Description
401 The file does not exist.
501 The file does not contain the field.
505 More than one field has the name.

 


Reviewed/Updated: May 2026