save Method

Class: Record

Description

This method saves a record to the database, invoking the applicable filer logic. Use this method (instead of Record<class>.bypassSave) when data changes require the execution of journals or firing of triggers to cause subsequent updates to the database.

image\msgs.gif

The setAuditFlag must be turned on in order to update the database using the save method.

To ensure high performance batch processing and transaction processing requirements where data integrity is controlled in the program procedural logic, use the Record<class>.bypassSave method.

Syntax

objectName.save("Filer qualifiers")

Parameters

Filer qualifiers

A list of / separated optional filer qualifiers available for use with this method. Valid qualifiers include:

INDEX

JOURNAL

TRIGAFT

TRIGBEF

UPDATE

VALDD

VALREQ

VALRI
 

Prefix any qualifier with NO to turn that qualifier off. Additional documentation on specific qualifiers appears in the filer documentation.

image\msgs.gif

By default, the save method will update journal files that may be associated with the table being updated. If you do not want to update the journal files, use the /NOJOURNAL parameter with the save method; for example,

do dep.save("/NOJOURNAL")

Returns

Void

When Became Available

Profile v6.4

Example

type Number CID

type String BOO=10

set CID=100000045

type Number AMT = 100.00

type RecordDEP dep=Db.getRecord(“DEP”,”CID=:CID”)

do dep.setAuditFlag(1)

set dep.bal=dep.bal+AMT

set dep.boo=BOO

do dep.save()         // Call DEP filer