| Contents: | Main | Chapter | See Also: | Getting Started Manual | Advanced User Manual | |||
| Reference Type | Category | ICR # |
|---|---|---|
| Supported | ScreenMan | 2610 |
You can use the PUT^DDSVALF API only within a ScreenMan form, in all places where M code can be placed on the form.
The PUT^DDSVALF API stuffs data into a Form-only field.
If, while a form is running, a call to PUT^DDSVALF fails, ScreenMan prints an error message in the Command Area.
PUT^DDSVALF(field,block,page,value[,flags],iens)
| field |
(Required) The Field Order number, Caption, or Unique Name of the Form-only 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 stuff into the Form-only field. If the flags parameter does not contain an I, the value must be in the form of a valid, unambiguous user response. |
|
| flags |
(Optional) Indicates whether the value parameter is in internal or external form, as shown below: |
|
| I | The value parameter is in Internal form; it is not validated. | |
| E (Default) | The value parameter is in External form. | |
| 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. |
|
Stuff the value 2940801 into a Form-only date field with the caption "DATE", as shown below:
D PUT^DDSVALF("DATE","","","AUG
1,1994")
The value passed is in external form (the default).
Reviewed/Updated: May 2026