DFHOME - The Evaluated Default Home

The attribute is available on the any element, in addition to be used for distributed attributes, it may be used in a generic way.

When used specifically for distributed attributes evaluation

It takes the typename of a bindable noun/udet as qualifier. It evaluates the actual home element using current element as when evaluating the test expressions and returns a nulref or a ref to an XPIWLD element.

Note:
The evaluation finds the associated Distributed Attribute Default Home (DSXHOM) from the typename qualifier, after that processing is the same as for the generic case.

Using it for generic "find a default home" purposes

The DSXHOM reference passed as a qualifier is used to evaluate the expressions defined in the DSXTST/DSXDST of that DSXHOM. It returns a nulref of the ref of the ID value held in the DHTEXT attribute of the resulting DSXDST. The Current Element (CE) is passed to the expression for evaluation.

Example

-- distributed attributes, get the location to store distributed attributes of type process for CE.

Q DFHOME ( TYPENAME :PROCESS )

DFHOME /THEPROCESSWORLD

-- Generic example, get the reference that results of evaluation the DSXHOM /MyHomeSelector for /TESTTHIS.

Q DFHOME ( /MyHomeSelector ) OF /TESTTHIS

DFHOME /STOREITHERE