VA FileMan V. 22.0 Programmer Manual Banner


 

Main Chapter Getting Started Manual Advanced User Manual

ScreenMan API


PUT^DDSVALF( )

You can use this entry point only within a ScreenMan form, in all places where M code can be placed on the form.

This procedure 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.

Format
PUT^DDSVALF(FIELD,BLOCK,PAGE,VALUE,FLAGS,IENS)
Input Parameters
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 FLAGS (described below) does not contain an I, the value must be in the form of a valid, unambiguous user response.

FLAGS

(Optional) Indicates whether VALUE is in internal or external form, as shown below:

I VALUE is in Internal form; it is not validated.
E VALUE is in External form (default).
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. For a detailed description of IENS, see "IENS - A New Way to Identify Entries and Subentries" in the Introduction to the "Database Server (DBS) API" chapter.

Example

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: March 4, 2007