VA FileMan V. 22.2 Programmer Manual Banner


 

Main Chapter Getting Started Manual Advanced User Manual

ScreenMan API


REQ^DDSUTL(): Change Required Property of a Field on a Form

Reference Type Category ICR #
Supported ScreenMan 10150

You can use the REQ^DDSUTL API only within a ScreenMan form, in all places where M code can be placed on the form.

The REQ^DDSUTL API changes the Required property of a field on the form.

Format
REQ^DDSUTL(field,block,page,value,iens)
Input Parameters
field

(Required) The Field Order number, Caption, or Unique Name of the field.

block

(Required at the page and form levels) The Block Order or Block Name. The default is the current block.

page

(Required at the form level) The Page Number or Page Name. The default is the current page.

value

(Required) The value to give the Required property, listed as follows:

"" Restore the Required property to the value defined in the BLOCK (#.404) file.
0 Make the field not required.
1 Make the field required.
iens

(Required at the page and form levels) The standard IENS that identifies the entry or subentry associated with the Form-only field. The default is the current entry or subentry.

REF: For a detailed description of IENS, see the "IENS: Identify Entries and Subentries" section in the "Database Server (DBS) API" section.

 


Reviewed/Updated: May 2026