$Update

The $UPDATE function returns the name of the group update file (in group context) or the current file (in file context). If the file is remote, $UPDATE also returns the location of the file (in the form filename AT location). If no group update file is defined, $UPDATE returns a null (zero-length) string.

Syntax

The format of the $UPDATE function is:

$UPDATE [(name)]

where the name argument overrides the default file or group context for the function.

The format for this argument is:

$UPDATE can be used to indicate the name of the update file in the current group, but the name argument must not be specified. In addition to its use in arithmetic expressions and PRINT specifications, $UPDATE also can be used as the file name in an IN clause. $CURFILE and $UPDATE are described in further detail in Files, Groups, and Reference Context.

If the file name/group name argument is omitted or null, the default context is the context of the statement that contains the function.

Note: You cannot use an IN clause that includes both MEMBER and $UPDATE. See IN GROUP MEMBER clause for information.

$UPDATE compresses consecutive spaces to one space. For example,:

'OWNERS AT DALL'

returns:

'OWNERS AT DALLAS'