VA FileMan V. 22.2 Programmer Manual Banner


 

Main Chapter Getting Started Manual Advanced User Manual

Advanced File Definition

Special Lookup Programs


At times you can write a lookup program to respond to unique characteristics of a file. The Edit File [DIEDFILE] option on the Utility Functions [DIUTILIT] menu allows you to tell VA FileMan what this program is. The information is stored at ^DD(filenumber,0,"DIC"). The routine's name cannot begin with DI. These programs must respond to all the variables that ^DIC does.

REF: For additional information, see the description of ^DIC.

The calls to DO^DIC1, DQ^DICQ, and FILE^DICN can be quite useful to maintain VA FileMan compatibility. You can tell VA FileMan to ignore these special programs by including an I in DIC(0).

NOTE: Only the ^DIC call honors the special lookup routines. Those calls that allow the user to specify the indexes (IX^DIC and MIX^DIC1), and the Database Server calls FIND^DIC and $$FIND1^DIC ignore the Special Lookup Program. The Database Server calls FILE^DIE and UPDATE^DIE honor the Special Lookup Program if FLAGS contains "E"; otherwise, they ignore it.

REF: For assistance with special lookups, contact the VA FileMan developers.

 


Reviewed/Updated: May 2026