PMDF Programmer's Reference Manual
PMDF-PRM-6.0

Previous | Contents

PMDF_mapping_load

Access a mapping table.

VMS FORMAT

status = PMDF_mapping_load (table, mapping)

argument information
Argument Data type Access Mechanism
table descriptor read reference
mapping signed longword write reference

C FORMAT

status = PMDFmappingLoad

(table, table_len, mapping)

argument information 
int PMDFmappingLoad (table, table_len, mapping) 
         char *table; 
         int   table_len; 
         int  *mapping;

ARGUMENTS

table

Name of the table to load. The length of the string may not exceed ALFA_SIZE bytes.

table_len

Length in bytes of the table name.

mapping

Reference to the loaded mapping table for use with PMDF_mapping_apply.

DESCRIPTION

Before a mapping table may be used to map input strings, it must first be loaded. This is accomplished with PMDF_mapping_load. Any number of tables may be loaded, one table per PMDF_mapping_load call. Once a mapping table is loaded, it may be used with PMDF_mapping_apply. There is no call to make to unload a table. PMDF_initialize must be called prior to the first call to PMDF_mapping_load. Failure to initialize PMDF first will result in a PMDF:NO error.
Return Values
PMDF__OK Normal, successful completion.
PMDF__INVSTRDES Invalid string descriptor for table: descriptor has an invalid value in its DSC$B_CLASS field. No table loaded.
PMDF__NO PMDF_initialize has not yet been called. No table loaded.
PMDF__NOMAPPING Cannot load specified mapping table; check to see if the mapping table exists. No table loaded.
PMDF__STRTRUERR Supplied table name is too long. No table loaded.

Previous | Next | Contents