BUFFER-TENANT-NAME attribute

The name of the tenant (as a character string) that owns the current record in the buffer specified by a buffer handle.

Data type:

CHARACTER

Access:

Read-only

Applies to:

Buffer object handle

If the buffer is not populated with a record, this attribute returns the Unknown value (?). If the buffer is for a shared table or a temp-table, this attribute returns the empty string ("").

If the buffer contains a record that belongs to a tenant group and the user is a super tenant, this attribute returns the tenant name of one of the members of the group. The tenant name returned is indeterminate, but is always the name of a tenant in the group.

For a regular tenant user, the record in the buffer always belongs to that tenant. So, the attribute always returns the user’s own tenant name. This is true even if the record belongs to a tenant group.

Notes:

This attribute can be used in a WHERE or TENANT-WHERE option as long as the specified buffer is not the same as the buffer of the query or FOR EACH statement.

See also:

BUFFER-TENANT-NAME function