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

Contents:

Main

Database Server (DBS) API

$$IENS^DILF(): Return IENS from a DA() Array Structure

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

Description

The $$IENS^DILF extrinsic function returns the IENS when passed an array in the traditional DA() structure.

Format

$$IENS^DILF(.da)

Input Parameter

.da

(Required) An array with the structure of the traditional VA FileMan DA() array [i.e., DA=lowest subfile record number, DA(1)=next highest subfile record number, etc.].

Output

A string of record numbers in the IENS format [i.e., "DA,DA(1),...DA(n),"].

NOTE: The string always ends with a comma (,). If the array passed by reference is empty, a 0 is returned.

Example

Figure 188: $$IENS^DILF API—Example: Input and Output

    >S NMSPDA=4,NMSPDA(1)=1,NMSPDA(2)=2,NMSPDA(3)=532 <Enter>

    >W $$IENS^DILF(.NMSPDA) <Enter>
    4,1,2,532,

Error Codes Returned

None.

Reviewed/Updated: May 2026