FUNCTION xpxDefinePersistentAttrHashTableBNEx (schemaName     : STRING;
                                               entityNames    : AGGREGATE OF STRING;
                                               attributeName  : STRING;
                                               options        : INTEGER;
                                               hashTableWidth : INTEGER;
                                               stringLength   : INTEGER)
                                               status         : INTEGER;

Function to define an new EDMpersitentAttrHashTable. This function can also be used to delete or redefine an existing EDMpersitentAttrHashTable. This function has variable number of arguments, i.e., it can be invoked with minimum 3 arguments and maximum 6 arguments.

This xpxDefinePersistentAttrHashTableBNEx() function can define EDMpersitentAttrHashTables that are valid for a given set of entities (instance types). The fucnctions xpxDefinePersistentAttrHashTable() and xpxDefinePersistentAttrHashTableBN() can only define EDMpersitentAttrHashTables that are valid for one entity or one entity and all its subtypes.

Arguments

1	Type	Name	Comment
2	STRING	schemaName	The name of an EXPRESS schema in the EDMdatabase that locates the actual EDMpersitentAttrHashTable. The combination of the attributes "schemaName","entityNames" and "attributeName" uniquely identifies an EDMperistentAttrHashTable in an EDMdatabase.
3	AGGREGATE OF STRING	entityNames	An aggregate (aggregateId) with one or more entity names that defines the actual instance types for the actual EDMpersitentAttrHashTable. All these entities must be in a subtype/supertype relation with each other and they must all be defined in the EXPRESS schema specified in the"schemaName" argument.
4	STRING	attributeName	The name of an attribute that is common for all entities in the "entityNames" aggregate. This attribute must be an explicit attribute of data type STRING.
5	INTEGER	options	Optional value. Default value is INDETERMINATE (?)
6	INTEGER	hashTableWidth	Optional argument. Default value is INDETERMINATE (?). For future extension, i.e., currently a dummy argument.
7	INTEGER	stringLength	Optiona argument. Default value is INDETERMINATE (?). This argument sefines the fixed length or the maximum length of the string attributes in the actual EDMpersistentAttrHashTable. This argument must be specified when one of the options xpxFIXED_STRING_LENGTH or xpxMAX_STRING_LENGTH is set.

Return Value

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_r_XPX_Return_Value'.

Options

Option	Comment
xpxDELETE_ATTRIBUTE_HASH_TABLE	Delete the specified EDMpersistentAttrHashTable.
xpxREDEFINE_ATTRIBUTE_HASH_TABLE	If the actual EDMpersistentAttrHashTable already exists, it will be redefined with new properties according to the specification in the actual xpxDefinePersistentAttrHashTableBNEx() operation.
xpxSUBTYPES	The EDMpersistentAttrHashTable will be valid for all subtype instances of the given given entities in the "entityNames" argument.
xpxUNIQUE_ATTRIBUTE_VALUES	All values of the given attribute in the "attributeName" argument must be unique., i.e., no duplicated values are permitted.
xpxFIXED_STRING_LENGTH	All strings in the actual EDMpersistentAttrHashTable must have a fixed length. This length is specified in the "stringLength" argument. This options improve the performance of searching the actual EDMpersistentAttrHashTable.
xpxMAX_STRING_LENGTH	The length of all strings in the actual EDMpersistentAttrHashTable must be less or equal to the length specified in the "stringLength" argument. This options improve the performance of searching the actual EDMpersistentAttrHashTable.

Example

Arguments

Return Value

Options

Example

See also

Filter by label

Browser not supported