Skip to main content
Previous sectionNext section

RefInKind

Specify how $NAME and $QUERY handle extended global references.

Synopsis

[Miscellaneous]    RefInKind=n

n is either 1 (true) or 0 (false). The default value is 0.

Description

When RefInKind is enabled (n = 1), given an input that is an extended global reference, $NAME and $QUERY return only the global name without the extended reference. When this parameter is not enabled, the functions return an extended global reference.

Changing This Parameter

On the Compatibility page of the Management Portal (System Administration > Configuration > Additional Settings > Compatibility), in the RefInKind row, click Edit. Select RefInKind to enable this setting.

Instead of using the Management Portal, you can change RefInKind in the Config.Miscellanous class (as described in the class reference) or by editing the CPF in a text editor (as described in the Editing the Active CPF section of the “Introduction to the Configuration Parameter File” chapter in this book).

Note:

If you change the value of this parameter, the change applies to processes started after the change, but not for processes that were already running when you made the change.

To change this parameter for a single process only (as opposed to instance-wide), use the RefInKind() method of the %SYSTEM.Process class. See the class reference for details.