Using Caché Objects - InterSystems Documentation

Saving Objects
10.5 Saving Objects
You can save any persistent object using the following syntax:
Do oref.%Save()
where oref is the object reference of the object to save.
The %Save method returns a status code which you can examine to determine the success
or failure of the save:
Set sc=oref.%Save()
where sc is the status code returned by %Save and oref is the object reference of the object
to save.
The $$$ISOK macro returns 1 if the save was successful and 0 if it failed. Alternately, the
$$$ISERR macro returns 1 if the save failed and 0 if the save was successful.
If the save failed, the DisplayError^%apiOBJ call in the Caché Object Utility Library displays
the text of the error message.
The following syntax saves the object represented by oref and display any error messages if
the save fails:
Set sc = oref.%Save()
If $$$ISERR(sc) {
Do $System.Status.DisplayError(sc)
}
For example, the following code saves a Person object with OREFper and displays any errors
occurring during the save:
Set sc = per.%Save()
If $$$ISERR(sc) {
Do $System.Status.DisplayError(sc)
}
10.6 Deleting Objects
You can either delete a single object or all objects within an extent.
Using Caché Objects 81