Caché ObjectScript Reference - InterSystems Documentation

$ZREFERENCESET ^MyData(1)="fruit"SET ^MyData(1,1)="apples" ; Full global referenceSET ^(2)="oranges" ; Naked global reference,; implicitly ^MyData(1,2)WRITE !,$ZREFERENCE ; Returns "^MyData(1,2)"For further details on naked global references, see Using Caché Multi-Dimensional Storage(Globals) in Using Caché Multi-Dimensional Storage.If a command references a global variable using an extended global reference, the$ZREFERENCE value contains that extended global reference. Caché returns an extendedglobal reference in either of the following circumstances:• The current namespace differs from that of the last global reference.• The current global reference is a remote reference.For further details on global subscripts and extended global references, see Global Structurein Using Caché Multi-Dimensional Storage.Operations that Update $ZREFERENCEThe $ZREFERENCE special variable is initialized to the null string (""). Changing thecurrent namespace resets $ZREFERENCE to the null string.The following operations set $ZREFERENCE to the most recently referenced global:• A command or function that uses a global as an argument. If it uses multiple globals,$ZREFERENCE is set to the rightmost occurrence of a global.• A command that uses a global as a postconditional expression.• Following a ZWRITE, Caché sets $ZREFERENCE to the last listed subscript versionof the specified global reference.• A command or function that references an undefined global, and either generates an error, or, in the case of $INCREMENT, defines the global.Setting $ZREFERENCEYou can set this special variable using the SET command, as follows:• Set to the null string (""). Doing so deletes the naked indicator. If the next global referenceis a naked global reference, Caché issues a error.• Set to a valid global reference (defined or undefined). This causes subsequent nakedreferences to use the value you set as if it were the last actual global reference.Caché ObjectScript Reference 485