For information on converting to InterSystems IRIS,
see the InterSystems IRIS Adoption Guide
and the InterSystems IRIS In-Place Conversion Guide,
both available on the WRC Distributions page (login required).
If a persistent class is GUIDENABLED then this method can be called to override the default GUID assignment.
This method accepts a guid value and returns the override value currently assigned. The return value will only
differ from the supplied value if the override is unsuccessful. It is only valid to call this method on a new object.
The guid value passed to this method is not validated. It is up to the user to make sure the guid is properly formed.
The guid assignment does not actually occur until the object is saved. If the object has already been assigned a GUID
or if the GUID override value has already been assigned to another object then the GUID override value will be discarded.
The check for GUID value uniqueness and a GUID value previously assigned is done only at the time the object is saved and is
not performed by this method.