Print Page as PDF
Classic FileMan API: Edit Data ICR (10018)

Classic FileMan API: Edit Data    ICR (10018)

Name Value
NUMBER 10018
IA # 10018
DATE CREATED 1998/11/17
CUSTODIAL PACKAGE VA FILEMAN
CUSTODIAL ISC San Francisco
USAGE Supported
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE DIE
NAME Classic FileMan API: Edit Data
ORIGINAL NUMBER 10018
GENERAL DESCRIPTION
This routine handles input of selected data elements
for a given file entry.
STATUS Active
ID DIE
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
DIE
This routine handles input of selected data elements
for a given file entry. You should use ^DIE only to edit existing records.
VARIABLES TYPE VARIABLES DESCRIPTION
DIE Input
(Required) The global root of the file.
DA Input
(Required) If you are editing an entry at the top
level of a file, set DA to the internal entry number of the file entry to be
edited.

If you are editing an entry in a subfile, set up DA as an array, where
DA=entry number in the subfile to edit, DA(1) is the entry number at the next
higher file level,...DA(n) is the entry number at the file's top level.
DR Input
(Required) A string specifying which data fields are
asked for the given entry. The fields specified by DR are asked whether or not
VA FileMan Write access security protection has been assigned to the fields.

You can include the following in the DR-string:

Field number Field with Default Value Stuff a Field Value (Validated) Stuff a
Field Value (Unvalidated) Placeholder for Branching MUMPS Code Combination
Input Template
DIE("NO") Input
Note the variable name is: DIE("NO^")

(Optional) Controls the use of the ^ in an edit session. If this variable does
not exist, unrestricted use of the ^ for jumping and exiting is allowed.

The variable may be set to one of the following:

"OUTOK"  Allows exiting and prevents all jumping. "BACK" Allows jumping back
to a previously edited field and does not allow exiting.  "BACKOUTOK"  Allows
jumping back to a previously edited field and allows exiting.  "Other value"
Prevents all jumping and does not allow exiting.
DIDEL Input
(Optional) Overrides the delete access on a file or
subfile.
DTOUT Output
Is set when a time-out has occurred.