GLOP Data Attributes - Analytics Database - Teradata Vantage

SQL External Routine Programming

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
VMware
Product
Analytics Database
Teradata Vantage
Release Number
17.20
Published
June 2022
ft:locale
en-US
ft:lastEdition
2025-03-30
dita:mapPath
iiv1628111441820.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
dita:id
qnu1472247494689
lifecycle
latest
Product Category
Teradata Vantageā„¢

Certain attributes associated with GLOP data determine modification properties and how the GLOP set maps the GLOP data.

GLOP Modification Attributes

GLOP modification attributes determine whether the GLOP is read-only, read/write, globally modifiable, or disabled.

Attribute Description
Read-Only Used for GLOP data that never changes. The memory access is set to read-only. Any attempt to change the GLOP data causes a system reset when running in unprotected mode or a segmentation violation error result when running in protected or secure mode.
Read/Write Used for GLOP data that changes at run time. The memory can be read and written at any time. However, to prevent simultaneous updates from conflicting with each other for different external routines that may have the same GLOP data mapped, the best practice is to apply a write lock on the GLOP data by the writer and a read lock by the readers.
Globally Modifiable Used for GLOP data that may be globally modified at run time. Data is read/write GLOP data that can be changed on all vprocs on all nodes at once. If this mode is not set, the GLOP data cannot be updated in a global manner.
Disabled Used for GLOP data that is not to be mapped. One or more sets define the data but the access to the data has been turned off.

You set the modification attributes for GLOP data when you call the DBCExtension.GLOP_Add stored procedure to add GLOP data and GLOP mappings to a GLOP set. For details, see DBCExtension.GLOP_Add Stored Procedure.

GLOP Mapping Attributes

GLOP mapping attributes determine how a GLOP set maps GLOP data.

Attribute Description
Normal GLOP data is mapped as indicated by the GLOP type specifications.
Shared Overrides GLOP data mapping and maps one shared copy of GLOP data per vproc. Mapping mode attribute is associated with a GLOP set. If multiple GLOP sets have shared flag set for same GLOP data, those sets get the same logical address to the GLOP data. If an additional set for the same GLOP data has the normal mode set, that set gets a separate copy of GLOP data independent of the other shared one.
This setting is not relevant for read-only GLOP data because only one copy is ever mapped per node.

You set the mapping attributes for GLOP data when you call the DBCExtension.GLOP_Add stored procedure to add GLOP data and GLOP mappings to a GLOP set. For details, see DBCExtension.GLOP_Add Stored Procedure.

GLOP Data Ageing

Read-only GLOP data can be aged out of memory. The ageing timeout can be specified in the number of minutes of inactivity. This provides a way to reduce the use of memory and disk resources for unused GLOP mappings.

Read/write or globally modifiable GLOP data does not age out.

GLOP data that is session based is deleted when the session logs out, GLOP data that is transaction based is deleted when the transaction terminates, and GLOP data that is request based is deleted when the request ends.